info-tech-canon/workplans/INFO-WP-0019-conformance-and-maintenance.md
tegwick 9de170ecf9
All checks were successful
CI Smoke / host-smoke (push) Successful in 0s
CI Smoke / container-smoke (push) Successful in 2s
Recheck the adoption gate and verify it is ready (INFO-WP-0019-T06)
No change in the evidence: feedback/ holds only the two 2026-08-15
resource-control reports, incoming/ only its README, and no inbox message is an
emission-cadence declaration. The sole declaration in the repository is still
the worked example, which the standard states is not source-owned.

What this repository owes the gate was re-tested rather than assumed.
emission-review validates an arbitrary source-owned declaration and reports
operational_truth_assessed false, so a submission cannot be read as observed
behaviour, and export-emission-contract produces a bundle whose manifest carries
the gate in words at digest 972c0b6701d1693f, which a source owner can pin to
today.

The blocker is not readiness but that no external source owner has been asked.
The contract came from the King's Guard taxonomy with evidence classes owned by
NetKingdom, which makes netkingdom the obvious first source owner and a second
one that must be independent of it. Soliciting them is an outward action this
workplan does not authorize, so T06 stays waiting on that decision.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

Assistant: claude-code
Assistant-Model: opus
Assistant-Process: 3588@bnt-lap001
Assistant-Session: 24b80f66-e5a7-4e61-99fe-2d422e6d17da
2026-09-20 23:59:17 +02:00

165 lines
6.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

---
id: INFO-WP-0019
type: workplan
title: "Conformance, reproducible consumption, and maintenance"
domain: infotech
repo: info-tech-canon
status: blocked
flavor: implementation
owner: codex
topic_slug: canon-optimization
created: "2026-09-05"
updated: "2026-09-09"
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.
2026-09-09 recheck: the inbox contains an InterfaceCanon semantic-boundary
review request, and `feedback/` still contains only the two resource-control
capability reports. Neither supplies independent emission-cadence declarations
or the required pinned consumer results. T06 remains waiting; boundary review
is handled separately in INFO-WP-0026.
2026-09-20 recheck: no change in the evidence, and the gate is verified ready.
`feedback/` still holds only the two 2026-08-15 resource-control capability
reports. `incoming/` holds only its README. The inbox carries eleven messages,
the most recent a 2026-06-27 concept contribution from ops-warden; none is an
emission-cadence declaration. The only declaration in the repository remains
`standards/emission-cadence/examples/qonto-assistant.yaml`, which the standard
itself states is not the source-owned declaration and makes no claim about live
emission.
What this repository owes the gate is in place and was re-tested rather than
assumed. `emission-review` validates an arbitrary source-owned declaration
against the named schema and reports `operational_truth_assessed: false`, so a
submission cannot be mistaken for observed behaviour.
`export-emission-contract` produces a content-addressed bundle whose manifest
carries the gate in words — "Two independent source-owned implementations
required; example does not count" — at digest `972c0b6701d1693f`. A source owner
can pin to that digest today.
The blocker is therefore not readiness. It is that no external source owner has
been asked. The contract came from the King's Guard taxonomy and the evidence
classes remain owned by NetKingdom, which makes `netkingdom` the obvious first
source owner; a second must be independent of it. Asking them is an outward
action this workplan does not authorize, so T06 stays `wait` until the operator
decides whether to solicit declarations, and from whom.
## Implementation notes
T01T04 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 T01T05 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.