Implement canon conformance and maintenance optimizations
Assistant: codex Assistant-Model: gpt-6-astra Assistant-Session: 01a06e82-3e08-7042-a79d-438ac6eed8db
This commit is contained in:
parent
a2e7f22d8d
commit
b081d39da1
64 changed files with 4491 additions and 373 deletions
132
workplans/INFO-WP-0019-conformance-and-maintenance.md
Normal file
132
workplans/INFO-WP-0019-conformance-and-maintenance.md
Normal file
|
|
@ -0,0 +1,132 @@
|
|||
---
|
||||
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.
|
||||
Loading…
Add table
Add a link
Reference in a new issue