Implement canon conformance and maintenance optimizations
All checks were successful
CI Smoke / host-smoke (push) Successful in 0s
CI Smoke / container-smoke (push) Successful in 3s

Assistant: codex
Assistant-Model: gpt-6-astra
Assistant-Session: 01a06e82-3e08-7042-a79d-438ac6eed8db
This commit is contained in:
tegwick 2026-09-05 00:50:09 +02:00
parent a2e7f22d8d
commit b081d39da1
64 changed files with 4491 additions and 373 deletions

View 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
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.

View file

@ -8,7 +8,7 @@ repo: info-tech-canon
status: finished
priority: medium
created: "2026-08-14"
updated: "2026-08-15"
updated: "2026-09-04"
depends_on_workplans:
- ITC-WP-0003
- ITC-WP-0006
@ -102,7 +102,7 @@ entry per source/target pair, registered as `mapping/capability-anchors`.
```task
id: ITC-WP-0014-T04
status: todo
status: done
priority: medium
depends_on: [T02]
state_hub_task_id: "a4621991-fea8-5f74-b0fd-e5e606ea32a7"
@ -113,6 +113,12 @@ small-saas profile (coordinate with ITC-WP-0004). Useful in-repo illustration.
**No longer the promotion gate** — §10.3 now accepts a consumer record that
validates against the live catalog (T11).
**Done 2026-09-04:** Added
`profiles/small-saas/artifacts/capability-requirements.yaml`, covering
authorization, transactional persistence, API exposure, and observability.
All four requirements have profile-owned provisions and evidence and meet their
declared maturity floors through the live capability-review surface.
### T05 — Landscape and kernel-map revision
```task

View file

@ -0,0 +1,80 @@
---
id: ITC-WP-0018
type: workplan
title: "EmissionCadenceDeclaration semantic contract"
domain: infotech
repo: info-tech-canon
status: finished
owner: codex
topic_slug: emission-cadence
priority: high
created: "2026-09-04"
updated: "2026-09-04"
spec_refs:
- infospace/assimilation/emission-cadence/ASSIMILATION.md
- infospace/standards/emission-cadence/InfoTechCanonEmissionCadenceStandard.md
- infospace/schemas/emission-cadence.schema.yaml
state_hub_workstream_id: "78f879cf-f097-5ee5-8f6a-15e34209822d"
---
# ITC-WP-0018 — EmissionCadenceDeclaration Semantic Contract
## Goal
Adopt the Kings Guard handover as the ecosystem-wide, versioned semantic
contract for declaring expected stream emission, while leaving NetKingdom
security obligations in the importing NetKingdom profile.
## T01 — Review ownership and assimilate the handover
```task
id: ITC-WP-0018-T01
status: done
priority: high
state_hub_task_id: "b6cba288-1edf-557c-b692-cd24058fb9d6"
```
Preserve the handed-over draft, compare its concepts with the existing
Observability and Governance models, and record the authorized `adapt`
disposition from `GH-DEC-2026-004`.
## T02 — Publish the generic contract and validation schema
```task
id: ITC-WP-0018-T02
status: done
priority: high
state_hub_task_id: "cca8a6e6-03fe-50a1-9f0d-84cbc8b92cac"
```
Publish the generic forms, fields, validation semantics, compatibility rules,
and a non-authoritative worked example. Do not encode the NetKingdom rule that
rare load-bearing classes require heartbeat plus reconciliation.
## T03 — Register, retrieve, validate, and announce
```task
id: ITC-WP-0018-T03
status: done
priority: high
state_hub_task_id: "9df9fd50-26e0-531e-a0a2-9f92eed5f2b3"
```
Register the artifact and schema, regenerate retrieval assets, run the full
validation and test suite, and notify the handing-over and deciding repositories.
## Acceptance
- InfoTechCanon is the sole owner of `EmissionCadenceDeclaration` semantics.
- The schema validates both generic forms and rejects incomplete form payloads.
- NetKingdom-specific evidence classes and MUST/SHOULD policy are not defined here.
- The artifact is discoverable through the CLI/JSON/API retrieval surfaces.
- Generated assets, validation, tests, work records, and State Hub agree.
## Result
Completed 2026-09-04 in canon 0.7.0. The handed-over draft was adapted into the
generic standard and schema, the security-profile boundary was preserved, the
worked example and structural validation were published, and all retrieval
assets were regenerated. `make validate` reports 0 errors and 0 warnings;
`make test` passes 29 tests.

View file

@ -2,7 +2,7 @@ repository: info-tech-canon
type: workplan-registry
status: active
created: "2026-05-23"
updated: "2026-06-08"
updated: "2026-09-05"
implementation_decisions:
infospace_root: infospace/
@ -16,6 +16,17 @@ implementation_decisions:
consumer_workplans_live_in_consumer_repos: true
workplans:
- id: INFO-WP-0019
title: Conformance, reproducible consumption, and maintenance
status: blocked
priority: high
path: workplans/INFO-WP-0019-conformance-and-maintenance.md
depends_on: [ITC-WP-0018]
produces:
- reusable declaration validation and coverage
- deterministic contract bundles
- freshness checks and portable consumption
- id: ITC-WP-0001
title: Infospace Scaffold And Seed Placement
status: finished
@ -231,3 +242,35 @@ workplans:
- models/governance/evidence-basis.yaml
- EvidenceBasis section in ITC-GOV
- CAP-R10 on CapabilityConsumption
- id: ITC-WP-0016
title: PracticePattern language and InterfaceDeprecationStrangler
status: finished
priority: high
path: workplans/ITC-WP-0016-practice-pattern-language.md
depends_on: []
produces:
- PracticePattern scheme
- InterfaceDeprecationStrangler pattern
- id: ITC-WP-0017
title: AgenticDrivesFunctional PracticePattern
status: finished
priority: medium
path: workplans/ITC-WP-0017-agentic-drives-functional.md
depends_on:
- ITC-WP-0016
produces:
- AgenticDrivesFunctional pattern
- id: ITC-WP-0018
title: EmissionCadenceDeclaration semantic contract
status: finished
priority: high
path: workplans/ITC-WP-0018-emission-cadence-contract.md
depends_on: []
produces:
- Emission Cadence Standard
- EmissionCadenceDeclaration schema
- qonto-assistant worked example
- emission-cadence assimilation record