From 1df777b586726a88b874cea82b8089c8ecb55799 Mon Sep 17 00:00:00 2001 From: codex Date: Sun, 6 Sep 2026 01:03:22 +0200 Subject: [PATCH] Publish federation governance interface and consistency residual --- README.md | 5 ++ WORK-RECORDS.md | 4 ++ canon/interfaces/README.md | 19 ++++++ canon/interfaces/federation.yaml | 59 ++++++++++++++++++ intakes.md | 28 +++++++++ workplans/THE-WP-0001-federation-interface.md | 61 +++++++++++++++++++ 6 files changed, 176 insertions(+) create mode 100644 canon/interfaces/README.md create mode 100644 canon/interfaces/federation.yaml create mode 100644 workplans/THE-WP-0001-federation-interface.md diff --git a/README.md b/README.md index 0e8ff36..cd23437 100644 --- a/README.md +++ b/README.md @@ -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. diff --git a/WORK-RECORDS.md b/WORK-RECORDS.md index 243e412..11b169f 100644 --- a/WORK-RECORDS.md +++ b/WORK-RECORDS.md @@ -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 | diff --git a/canon/interfaces/README.md b/canon/interfaces/README.md new file mode 100644 index 0000000..25e03c8 --- /dev/null +++ b/canon/interfaces/README.md @@ -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 .. +``` diff --git a/canon/interfaces/federation.yaml b/canon/interfaces/federation.yaml new file mode 100644 index 0000000..97a4e4a --- /dev/null +++ b/canon/interfaces/federation.yaml @@ -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. diff --git a/intakes.md b/intakes.md index bd4356a..93ff713 100644 --- a/intakes.md +++ b/intakes.md @@ -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" +``` diff --git a/workplans/THE-WP-0001-federation-interface.md b/workplans/THE-WP-0001-federation-interface.md new file mode 100644 index 0000000..a169202 --- /dev/null +++ b/workplans/THE-WP-0001-federation-interface.md @@ -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.