133 lines
4.7 KiB
Markdown
133 lines
4.7 KiB
Markdown
|
---
|
|||
|
|
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.
|