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.
|
||||
|
|
@ -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
|
||||
|
|
|
|||
80
workplans/ITC-WP-0018-emission-cadence-contract.md
Normal file
80
workplans/ITC-WP-0018-emission-cadence-contract.md
Normal 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 King’s 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.
|
||||
|
|
@ -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
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue