--- id: INFO-WP-0019 type: workplan title: "Conformance, reproducible consumption, and maintenance" domain: infotech repo: info-tech-canon status: blocked owner: codex topic_slug: canon-optimization created: "2026-09-05" updated: "2026-09-05" state_hub_workstream_id: "b29261ba-c1e4-5533-8185-ab2d5b433685" --- # Conformance, reproducible consumption, and maintenance Implements the optimization recommendations in `history/2026-09-05_002437+0200-scope-against-intent.md`. Reviewed against the current working tree; authorized by the operator on 2026-09-05. Uses the AGENTS.md INFO-WP file convention. ## Reusable conformance and coverage ```task id: INFO-WP-0019-T01 status: done priority: high state_hub_task_id: "abc0ed79-009f-5254-a2bf-4dcedd1925e9" ``` Extract shared schema validation and emission-cadence semantics into contract modules. Expose arbitrary declaration validation and explicit coverage through the CLI. Reject unsupported versions, malformed declarations, and duplicate source IDs. Enforce explicit ownership conflicts. Preserve all existing tests. ## Reproducible contract bundle and adoption gate ```task id: INFO-WP-0019-T02 status: done priority: high state_hub_task_id: "1ec85dc5-5775-50b6-8066-ac839fd252c9" ``` Provide deterministic, content-addressed export of the cadence contract, schema, and example; refuse overwriting different contents. Define owner-authored adoption evidence requirements and keep draft promotion contingent on two independent implementations. Local examples must not count as adoption evidence. ## Freshness and evidence ```task id: INFO-WP-0019-T03 status: done priority: high state_hub_task_id: "e4171772-50bf-58f6-9c87-8eddbef1caa5" ``` Add non-mutating generated-asset checks, reproducible scope inventory, and revision/time/source-digest evidence on validation reports. Refresh work-record projections via State Hub. Check stale and missing generated assets with tests. ## Portable consumption ```task id: INFO-WP-0019-T04 status: done priority: medium state_hub_task_id: "e258d84d-d969-5032-baef-ae1060843319" ``` Remove hardcoded workstation dependency paths. Resolve an installed bench distribution and an explicit external corpus root. Prove wheel installation and commands from an unrelated directory. Document upstream packaging limits without changing sibling repositories. ## Measure performance and verify implementation ```task id: INFO-WP-0019-T05 status: done priority: medium state_hub_task_id: "09a585e8-4c67-5143-bc3a-ae47623547ea" ``` Measure repeated reads before deciding whether caching is justified. Run all tests, canon/profile validation, generated freshness checks, and the clean installation proof. Update SCOPE/README and record evidence. Avoid speculative models or runtime expansion. ## Independent consumer adoption ```task id: INFO-WP-0019-T06 status: wait priority: high state_hub_task_id: "b33aeb8c-ba7c-5094-9902-85565c1e721b" ``` Requires two source owners to provide independently implemented declarations and consumer results pinned to the contract digest. This repo can validate submitted evidence but cannot manufacture source ownership or deployed proof. No external messages or consumer changes are authorized by this workplan. Promotion remains blocked until that evidence arrives. ## Implementation notes T01–T04 implemented in `contracts.py`, `maintenance.py`, `paths.py`, CLI, service integration, and `docs/canon-consumption.md`. Explicit mapping schema bindings and ownership checks improve coverage without claiming exhaustive semantic validation. The normal bench initializer imports unrelated database integrations; installed-module discovery retains the narrow adapter. Clean wheel consumption uses the documented explicit-dependency installation until the upstream owner separates reference-data packaging. Registration: State Hub workstream `b29261ba-c1e4-5533-8185-ab2d5b433685`. The consistency tool reports an INFO-WP/ITC-WP prefix advisory: this plan follows the explicit INFO-WP convention in AGENTS.md; existing plans and the registry use ITC-WP. This naming inconsistency does not prevent registration. ## Verification — 2026-09-05 `make check`: 36 tests passed (22.42 seconds); all 77 generated assets current; canon validation passed (76 artifacts, 315 relationships); Small-SaaS passed (15 payloads). Installed-wheel inspect, validation, and emission review passed from an unrelated directory with PYTHONPATH unset and a copied corpus. Ten uncached inspections measured median 788.05 ms, maximum 1241.92 ms; caching remains deferred pending a workload/latency requirement. Local implementation T01–T05 is complete. Overall status is blocked only on T06's independent owner evidence. See `history/2026-09-05_optimization-implementation.md` for artifacts and limitations.