tegwick
b081d39da1
Assistant: codex Assistant-Model: gpt-6-astra Assistant-Session: 01a06e82-3e08-7042-a79d-438ac6eed8db
132 lines
4.7 KiB
Markdown
132 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.
|