Publish federation governance interface and consistency residual
All checks were successful
CI Smoke / host-smoke (push) Successful in 0s
CI Smoke / container-smoke (push) Successful in 2s

This commit is contained in:
codex 2026-09-06 01:03:22 +02:00
parent f895d2d0ab
commit 1df777b586
6 changed files with 176 additions and 0 deletions

View file

@ -189,3 +189,8 @@ All canon changes carry provenance metadata. Episodic memory is append-only.
- **Safety by design** — Custodian is co-creator, not authority; humans approve irreversible decisions
- **Targeted information processing** — narrow, high-leverage work over general intelligence
- **Long timescale stewardship** — designed for multi-year and eventual multi-generational continuity
## Canon federation
[Published interface card](canon/interfaces/federation.yaml) declares exports, imports, authority,
source-of-truth boundaries and reciprocal canon references.

View file

@ -69,6 +69,7 @@
| workplan | CUST-WP-0067 | finished | — | workplans/CUST-WP-0067-hub-authority-target-resolution.md |
| workplan | CUST-WP-0068 | finished | — | workplans/CUST-WP-0068-cache-only-work-record-recovery.md |
| workplan | CUST-WP-0070 | finished | — | workplans/CUST-WP-0070-publication-repo-category.md |
| workplan | THE-WP-0001 | finished | — | workplans/THE-WP-0001-federation-interface.md |
| task | CUST-WP-ADHOC-2026-05-02-T01 | done | — | workplans/ADHOC-2026-05-02.md |
| task | CUST-WP-ADHOC-2026-07-02-T01 | done | — | workplans/ADHOC-2026-07-02.md |
| task | CUST-WP-ADHOC-2026-08-25-T01 | done | — | workplans/ADHOC-2026-08-25.md |
@ -446,6 +447,8 @@
| task | CUST-WP-0070-T01 | done | — | workplans/CUST-WP-0070-publication-repo-category.md |
| task | CUST-WP-0070-T02 | done | — | workplans/CUST-WP-0070-publication-repo-category.md |
| task | CUST-WP-0070-T03 | done | — | workplans/CUST-WP-0070-publication-repo-category.md |
| task | THE-WP-0001-T01 | done | — | workplans/THE-WP-0001-federation-interface.md |
| task | THE-WP-0001-T02 | done | — | workplans/THE-WP-0001-federation-interface.md |
| intake | CUST-IN-0001 | closed | green | intake-legacy-suggestions-migration.md |
| intake | CUST-IN-0002 | closed | green | intake-legacy-suggestions-migration.md |
| intake | CUST-IN-0003 | closed | green | intake-legacy-suggestions-migration.md |
@ -462,3 +465,4 @@
| intake | CUST-IN-0014 | closed | blue | intakes.md |
| intake | CUST-IN-0015 | open | blue | intakes.md |
| intake | CUST-IN-0016 | open | green | intakes.md |
| intake | CUST-IN-0017 | open | green | intakes.md |

View file

@ -0,0 +1,19 @@
# Canon federation interface
The [interface card](federation.yaml) publishes this canon's federation boundary
under [accepted ADR-006](../architecture/adr-006-canon-federation-concept-ownership.md).
- [info-tech-canon interface](../../../info-tech-canon/infospace/interfaces/federation.yaml)
- [commerce-canon interface](../../../commerce-canon/infospace/interfaces/federation.yaml)
Each export names its source document and current maturity. Imports identify
actual dependencies; reciprocal navigation does not imply reciprocal semantic
imports. Custodian supplies ecosystem governance, InfoTechCanon information-
processing semantics, and CommerceCanon commercial semantics. Family remains
seeded, not authored. The card scope is this federation, not every repo artifact.
Reproduce G7 from the adjacent project checkout:
```bash
python3 tools/validate_interfaces.py --workspace ..
```

View file

@ -0,0 +1,59 @@
id: the-custodian/federation-interface
title: the-custodian Canon Federation Interface Card
consumer: the-custodian
canon_surfaces:
- CUST-ADR-006
status: published
version: 0.1.0
owner: the-custodian
scope: CFED-WP-0001 federation boundary; not a complete inventory of the repository or a runtime adoption
claim
schema_source:
repository: info-tech-canon
path: infospace/schemas/interface-card.schema.yaml
authority:
repository: the-custodian
artifact: CUST-ADR-006
path: canon/architecture/adr-006-canon-federation-concept-ownership.md
revision: accepted-1
source_commit: f895d2d0ab49aab2f278f63388d9a683ecac6c63
sha256: a454df0e1d227f99ebb36c4abd45c76cc12579086d34f0c0ccfccfd7f4790823
peers:
- repository: info-tech-canon
card: infospace/interfaces/federation.yaml
relationship: governed domain canon
- repository: commerce-canon
card: infospace/interfaces/federation.yaml
relationship: governed domain canon
exports:
- artifact: CUST-ADR-006
kind: ecosystem-governance
path: canon/architecture/adr-006-canon-federation-concept-ownership.md
status: accepted
concepts: []
governs:
- info-tech-canon
- commerce-canon
revision: accepted-1
imports: []
source_of_truth:
governance: the-custodian/CUST-ADR-006
ownership_assignment: prj-canon-federation/ledger/concept-ownership.json
definitions: exporting canon model documents; seed areas carry no authored domain model
mapping_rules:
- Import a concept from its declared owner; do not copy a definition as a competing local root.
- Identifier stays itc-ident; Registry Identifier and Proxy Commercial Identifier are Commerce specializations.
- Evidence assertions and Evidence Source containers stay distinct under itc-evid.
- Identity Assurance Level, governance AssuranceCase/AssuranceConclusion, and Counterparty Assurance Gradient
stay distinct.
- Family is a separate seed; Community and Household are itc-org draft social collectives.
known_deviations:
- This card uses the existing JSON Schema string consumer / array canon_surfaces shape; richer Core section
24 fields are additive.
- Exports describe availability, not proof of adoption. No reverse Commerce domain import by InfoTechCanon
or Custodian is asserted.
- Custodian governs both domain canons but owns none of their domain semantics.
expectations:
- Validate reciprocal cards and pinned sources with prj-canon-federation/tools/validate_interfaces.py.
- Review changed source versions explicitly and retain earlier import manifests.
- Fleet reference acceptance remains CFED-WP-0001-T09; demand-driven residuals remain T10.

View file

@ -128,3 +128,31 @@ notes: >-
Forgejo source-read token for scheduled Policy Nexus builds.
state_hub_intake_id: "01a07331-68e8-739f-b7c3-9cca28feb5e5"
```
## Review consistency findings observed during federation interface publication
```yaml
id: CUST-IN-0017
title: "Review Custodian historical bindings and agent workplan-prefix conflict"
lane: green
status: open
origin: residual
origin_ref: THE-WP-0001
notes: >-
CFED-WP-0001-T08 session-close fix-consistency on 2026-09-06 indexed
THE-WP-0001 and both tasks successfully but returned 13 existing assessment
failures: ten missing archived CUST-WP-0054 task UUIDs, missing workplan
UUIDs for archived CUST-WP-0057 and CUST-WP-0058, and active orphan
adhoc-2026-08-25@retired-20260827. Review against CUST-WP-0068 recovery
evidence and current primary projection before changing any identity.
Do not rewrite finished provenance, replace UUIDs, or delete retired records
merely to silence the checker. Also resolve generated AGENTS.md disagreement:
header/database prefix CUST-WP vs explicit file convention THE-WP caused the
new native plan's warning; InfoTechCanon has the analogous ITC-WP/INFO-WP
conflict. Reconcile instruction generation and registry authority for future
plans, preserving already assigned ids. Route implementation after triage;
acceptance is an evidence-backed disposition of each failure and a consistent
new-workplan convention. G7 card/schema/ownership/provenance checks pass and
do not claim fleet-wide State Hub consistency.
state_hub_intake_id: "01a073cf-51ca-7fa7-a432-658ba3718382"
```

View file

@ -0,0 +1,61 @@
---
id: THE-WP-0001
type: workplan
title: "Publish the the-custodian federation interface"
domain: infotech
repo: the-custodian
status: finished
owner: codex
topic_slug: canon-federation
created: "2026-09-06"
updated: "2026-09-06"
state_hub_workstream_id: "ebcbcd9d-7a52-584e-b272-9d6b3e781e7c"
---
# Federation interface publication
Native implementation of CFED-WP-0001-T08, authorized by the user's continuation
of the accepted federation plan. Review uses CUST-ADR-006 accepted-1 and the
completed model placements; no governance amendment or domain promotion.
## Publish the interface and reciprocal navigation
```task
id: THE-WP-0001-T01
status: done
priority: medium
state_hub_task_id: "de9d44f0-97bc-571b-bc04-0addb8ebef91"
```
Publish [the-custodian's card](../canon/interfaces/federation.yaml) with actual imports, available exports,
source authority, maturity and both peer references. Custodian has no domain
semantics. Commerce reviews and preserves the prior Counterparty import pin.
## Verify and publish evidence
```task
id: THE-WP-0001-T02
status: done
priority: medium
state_hub_task_id: "9c24853a-d9e4-5ed1-a528-01ec15b317a6"
```
Pass schema, reciprocal-edge, ledger ownership, pinned-source and navigation
checks in the project G7 validator. For InfoTechCanon also regenerate discovery
surfaces and run make check. Publish and synchronize this native record.
## Remaining scope
CFED-WP-0001-T09 already owns fleet references; T10 owns demand-driven residual
review. This card creates no runtime adoption, Family authoring or service work.
## Result — 2026-09-06
Published card and reciprocal navigation pass the project G7 validator.
[Consolidated evidence](../../prj-canon-federation/docs/evidence/2026-09-06-interface-cards.md)
records three valid cards, six reciprocal links, unchanged import concepts and
verified historical sources. InfoTechCanon make check passes (46 tests, current
generated surfaces and small-saas proof). Session-close consistency discovered historical projection failures and a
header/file-convention prefix conflict. Live [CUST-IN-0017](../intakes.md)
(origin residual, origin_ref THE-WP-0001) owns their triage before final closure;
CFED-WP-0001-T09/T10 retain the remaining project scope.