frontend-patterns/workplans/FEP-WP-0010-reference-consumption.md

id	type	title	domain	repo	status	owner	topic_slug	created	updated	state_hub_workstream_id
FEP-WP-0010	workplan	Close local reference-consumption gaps	infotech	frontend-patterns	ready	codex	canon	2026-10-04	2026-10-04	c46b02ca-26a8-5313-b0f2-eb0385ff820c

Close local reference-consumption gaps

Requested in the October 4 scope-versus-intent review. Reviewed against 07f1f37, the immutable 0.1 validator/export and activity-core's schema-v1 consumer event contract. Assessment ranks the remaining gaps. This plan implements a finite local consumption bridge; it does not claim real usefulness, independent validation, canonical export or autonomous operation.

Reconcile actual capabilities and ranked gaps

id: FEP-WP-0010-T01
status: done
priority: high
state_hub_task_id: "e2a595b9-2a46-59e1-96a0-58793968c011"

Update SCOPE.md from actual artifacts and record a timestamped assessment against INTENT. Distinguish 18 live hypotheses from the frozen 17-record preview, developed core paths from stubs, reporting from improvement and development checks from independent/held-out evidence. Name existing owners for the most relevant gaps.

Implement verified pinned lookup and citation

id: FEP-WP-0010-T02
status: todo
priority: high
state_hub_task_id: "52e73505-dadc-52b9-aedb-4ba0889e580c"

Add a small stdlib CLI to filter the verified candidate preview by explicit IDs, improving forces and responsibilities. Carry force costs, evidence limits and conditional relations without inferring compatibility or applicability. Empty or unknown constraints must clarify/abstain honestly. Provide commit-specific corpus and packaging locators; never silently read moving candidate prose. Reuse the existing release validation and fail on tampering or unavailable pins.

Prepare immutable consumer closeout receipts

id: FEP-WP-0010-T03
status: todo
priority: high
state_hub_task_id: "08762144-141e-5f13-ab58-2054da04a221"

Accept an explicit consumer decision/provenance input and prepare a schema-v1 event with verified release pins, considered/selected IDs, unchanged unknown outcomes and exact file digest/index entry. Write new files exclusively; refuse overwrite and unsafe source-relative paths. Validate inputs before writes. Real versus synthetic is explicit; no consumer enrollment, fabricated real outcome, arbitrary feedback execution or producer claim of verified collector origin. Match activity-core's existing event contract instead of creating a second collection service.

Verify the bridge and hand remaining gaps to live owners

id: FEP-WP-0010-T04
status: todo
priority: high
state_hub_task_id: "7efb810a-d6f8-540c-90a5-3c333e0bdbea"

Run disclosed synthetic lookup/citation/receipt cases, including unsupported/no-match, missing context, unknown IDs, changed live research, tampered release, invalid provenance, selection/action mismatch, delayed follow-up and duplicate writes. Verify generated receipts with the actual activity-core validator and document exact owner revision. Provide consumer commands in existing entry points. No model call or production mutation is required. Run repository checks and record limitations.

Before finishing, link delivered bridge and residual acceptance to existing WP-0008 T01/T02 (real consumer/template/enrollment/outcomes), WP-0009 (human/fresh validation), WP-0003/0004 (broader/gated applicability) and WP-0006 (comparable windows). Add live record references there. This plan may finish its local deliverable while the empirical owners remain open; do not claim those gaps closed or leave actionable residuals only in prose/history.