docs: ADR 0033 (listing verification) + profile-grader integration spec#312
Open
ckrough wants to merge 2 commits into
Open
docs: ADR 0033 (listing verification) + profile-grader integration spec#312ckrough wants to merge 2 commits into
ckrough wants to merge 2 commits into
Conversation
…ion spec Record two planning artifacts that back GitHub-native epics filed for the Evermore workflow: - ADR 0033: read-only `listings` service that verifies published adoption listings (Petfinder, Adopt-a-Pet) against the source-of-truth Composition and reports per-animal, per-channel sync status. Read-only; publishing is a future non-goal. Reads via official APIs first, SMS-side read via Pet Data. Backs epic #302 (V1-V9, #303-311). - docs/planning/profile-grader-integration-spec.md: the integration spec for porting the profile-grader prototype into the `grader` service and view. Backs epic #292 (T1-T9, #293-301); issue bodies link this path. No service code; scaffolds and tickets are tracked in the linked epics.
- ADR 0033 status accepted -> proposed (awaiting ratification on merge). - Grader integration spec: fold in the prototype's rubric v1.1 change (profile-grader inferential topic coverage). section_completeness (dim 7) is now judged from per-topic topic_coverage (covered/brief/absent), not deterministic label-counting; missing_struggles is judged from topic_coverage; RUBRIC_VERSION is 1.1. The API contract (schema.py) is unchanged. Adapter (T3): coverage is content-judged from body_text, so the 8-vs-5 section mapping no longer gates scoring. View (T7): jump-to dropdown sorts alphabetically; section_completeness renders the per-topic coverage map.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Adds two planning artifacts backing GitHub-native epics for the Evermore ingest -> grade -> verify workflow. Docs only; no service code.
What's here
docs/adr/0033-listing-sync-verification.md) + index line: a read-onlylistingsservice that verifies published adoption listings (Petfinder, Adopt-a-Pet) against the source-of-truth Composition and reports per-animal, per-channel sync status. Read-only (publishing is a future non-goal); official APIs first with scrape fallback; the Composition -> SMS hop reads through Pet Data (no second SMS connector).docs/planning/profile-grader-integration-spec.md): the spec for porting the profile-grader prototype into thegraderservice and view.Backed epics (already filed)
graderservice and view #292, tickets T1-T9 = T1: Scaffoldservices/grader/to the tech-stack standard #293-301.listingsservice) #302, tickets V1-V9 = V1: Scaffoldservices/listings/to the tech-stack standard #303-311. V3/V4/V5 (V3: Channel-adapter interface + Petfinder API v2 read adapter #305/V4: Adopt-a-Pet feed/API read adapter #306/V5: Composition -> SMS drift check via Pet Data #307) areblockedon external API access (Petfinder, Adopt-a-Pet, SMS).Notes
docs/planning/sits againstdocs/CLAUDE.md's "no plans directory" note; included by owner decision as a durable reference the grader issue bodies link to.accepted; flip toproposedif you'd rather ratify on merge.