From 18121700f756d7b6cf26c75e3120177085b68642 Mon Sep 17 00:00:00 2001 From: tegwick Date: Mon, 31 Aug 2026 22:18:48 +0200 Subject: [PATCH] docs: correct fabric authority disposition Assistant: codex Assistant-Model: gpt-5.6-sol Assistant-Session: 01a053ff-1d6f-7fe2-ac1c-a6eb40a42a0c --- architecture/child-workplan-map_v0.1.md | 11 +-- architecture/hub-extension-contract_v0.1.yaml | 4 +- architecture/information-model_v0.1.md | 4 +- architecture/information-model_v0.1.yaml | 4 +- inventory/README.md | 9 +-- inventory/capabilities.yaml | 10 +-- inventory/datasets.yaml | 25 +++---- inventory/routes.yaml | 55 +++++++-------- inventory/state-hub-disposition.yaml | 67 ++++++++++--------- 9 files changed, 97 insertions(+), 92 deletions(-) diff --git a/architecture/child-workplan-map_v0.1.md b/architecture/child-workplan-map_v0.1.md index 83f511a..8c1cd3c 100644 --- a/architecture/child-workplan-map_v0.1.md +++ b/architecture/child-workplan-map_v0.1.md @@ -38,7 +38,7 @@ Parent foundation: **SHR-WP-0001**. Architecture freeze inputs: **SHR-ARCH-IA-00 | S4 State Hub strangler | `state-hub` | **STATE-WP-0079** | proposed | Compatibility adapters; disposition execution; freeze growth | | S5 activity-core ports | `activity-core` | **ACTIVITY-WP-0029** | proposed | Schedule/sink alignment to hub ports | | S6 ops-hub extension | `ops-hub` | **OPS-WP-0003** | proposed | Manifest + extension contract conformance | -| S7 fin-hub fabric boundary | `fin-hub` | **FIN-WP-0003** | proposed | Fabric authority; optional hub projection | +| S7 fin-hub fabric boundary | `fin-hub` + `railiance-fabric` | **FIN-WP-0003** | finished | Specialized Fabric authority; executable parity gate; hub projection deferred | | S8 Project gates (evidence) | `prj-state-hub-retirement` | **SHR-WP-0001-T06** | todo | Baseline counts + retirement gates | Secondary / support (no new WP required yet): @@ -135,12 +135,13 @@ HUB-WP-0004 port/schema freeze. - **Depends on:** HUB-WP-0004 Tier 1; CORE-WP-0010 dual-run as needed - **Predecessors:** OPS-WP-0001/0002 archived (bootstrap history) -### S7 — FIN-WP-0003 (fin-hub) +### S7 — FIN-WP-0003 (fin-hub + railiance-fabric) - **Path:** `fin-hub/workplans/FIN-WP-0003-fabric-authority-boundary.md` -- **Outcome:** Fabric graph authority retained; hub projection optional; State Hub - fabric routes disposition executed with owner -- **Depends on:** SHR-INV fabric-graph; HUB-WP-0004 if projection via hub +- **Outcome:** Fabric graph authority retained in the specialized engine; State + Hub routes have explicit replacements and an executable parity gate; hub-core + projection deferred +- **Depends on:** SHR-INV fabric-graph - **Predecessors:** FIN-WP-0001 finished ### S8 — SHR-WP-0001-T06 (this project) diff --git a/architecture/hub-extension-contract_v0.1.yaml b/architecture/hub-extension-contract_v0.1.yaml index 5439166..8e86794 100644 --- a/architecture/hub-extension-contract_v0.1.yaml +++ b/architecture/hub-extension-contract_v0.1.yaml @@ -256,8 +256,8 @@ inventory_port_map: owner: ops-hub notes: domain_hub_data_plus_registry_manifest - capability: fabric-graph - owner: fin-hub - notes: authoritative_specialized_with_hub_projection_optional + owner: railiance-fabric + notes: specialized_authority_fin_hub_accountable_hub_projection_deferred migration_stack_map: hub-core_library: grows_into_sdk_of_surviving_runtime diff --git a/architecture/information-model_v0.1.md b/architecture/information-model_v0.1.md index 95c4087..419b845 100644 --- a/architecture/information-model_v0.1.md +++ b/architecture/information-model_v0.1.md @@ -269,7 +269,7 @@ publish outcomes. | --- | --- | | Identity, credentials | identity / OpenBao | | Authorization decisions | flex-auth (or successor) | -| Fabric graph | fin-hub | +| Fabric graph | railiance-fabric (fin-hub is the accountable financial-domain consumer) | | Ops runs / schedules | activity-core | | Issues (non-repo) | issue-core | | Forge repos/PRs | Forgejo | @@ -408,7 +408,7 @@ Selected capability → information kind → target owner (from SHR-INV-0001): | `state-projections`, `hub-projection-ui` | signal + read model | hub-core | | `capability-catalog` | knowledge + request | hub-core | | `service-catalog` | entity/knowledge | ops-hub | -| `fabric-graph` | knowledge + relation | fin-hub | +| `fabric-graph` | knowledge + relation | railiance-fabric | | `task-flow-engine`, `workplan-execution-queue` | request + work execution | activity-core | | `suggestion-backlog`, `work-records-workplan-legacy` | — | archive / retire | | `legacy-meter` | telemetry/signal | state-hub-until-cutover → retire | diff --git a/architecture/information-model_v0.1.yaml b/architecture/information-model_v0.1.yaml index 66d214d..0b658dc 100644 --- a/architecture/information-model_v0.1.yaml +++ b/architecture/information-model_v0.1.yaml @@ -155,7 +155,7 @@ entities: authority: policy-service - id: fabric_node kind: entity - authority: fin-hub + authority: railiance-fabric - id: ops_run kind: entity authority: activity-core @@ -313,7 +313,7 @@ inventory_capability_map: owner: ops-hub - capability: fabric-graph kinds: [entity, relation, knowledge] - owner: fin-hub + owner: railiance-fabric - capability: task-flow-engine kinds: [request, work] owner: activity-core diff --git a/inventory/README.md b/inventory/README.md index 623d26c..aa9f28e 100644 --- a/inventory/README.md +++ b/inventory/README.md @@ -2,7 +2,7 @@ **Workplan task:** [SHR-WP-0001-T02](../workplans/SHR-WP-0001-foundation.md) **Inventory ID:** `SHR-INV-0001` -**Version:** 0.1 (initial, 2026-08-09) +**Version:** 0.1.2 (authority correction, 2026-08-31) Machine-readable disposition of State Hub surfaces for the retirement program. Every item has an initial **owner** and **keep / move / replace / retire** @@ -38,7 +38,8 @@ implementation workplans (T05). | `repo-manager` | Repository representation, file-backed work-record index, consistency, governed control | | `activity-core` | Schedulers, ops-run execution, event-triggered maintenance | | `ops-hub` | Service catalog / operational catalogs | -| `fin-hub` | Fabric / financial graph authority | +| `railiance-fabric` | Specialized Fabric graph and accepted-snapshot authority | +| `fin-hub` | Financial-domain accountability and joins; no Fabric authority tables | | `ops-bridge` | Private tunnel connectivity (transport only) | | `the-custodian` | Kaizen agent personas and durable canon | | `archive` | Explicitly terminated surfaces (e.g. suggestions, workstream aliases) | @@ -59,9 +60,9 @@ implementation workplans (T05). | ops dependencies | 9 | | **total items** | **425** | -**By disposition:** move 269 · replace 66 · keep 48 · retire 42 +**By disposition:** move 259 · replace 76 · keep 48 · retire 42 -**By primary owner volume:** repo-manager 167 · hub-core 128 · state-hub-until-cutover 55 · archive 30 · activity-core 18 · ops-hub 13 · fin-hub 10 · ops-bridge 2 · the-custodian 2 +**By primary owner volume:** repo-manager 167 · hub-core 128 · state-hub-until-cutover 55 · archive 30 · activity-core 18 · ops-hub 13 · railiance-fabric 10 · ops-bridge 2 · the-custodian 2 ## Baseline counts (orientation) diff --git a/inventory/capabilities.yaml b/inventory/capabilities.yaml index a209f16..416f46c 100644 --- a/inventory/capabilities.yaml +++ b/inventory/capabilities.yaml @@ -1,6 +1,6 @@ inventory_id: SHR-INV-0001-capabilities title: State Hub capability rollup -version: 0.1.1 +version: 0.1.2 created: '2026-08-09' parent: inventory/state-hub-disposition.yaml capabilities: @@ -155,12 +155,12 @@ capabilities: mcp_tool: 4 - id: fabric-graph item_count: 10 - primary_owner: fin-hub - primary_disposition: move + primary_owner: railiance-fabric + primary_disposition: replace owners: - fin-hub: 10 + railiance-fabric: 10 dispositions: - move: 10 + replace: 10 kinds: route: 7 dataset: 3 diff --git a/inventory/datasets.yaml b/inventory/datasets.yaml index 0c8fdaa..2722b6c 100644 --- a/inventory/datasets.yaml +++ b/inventory/datasets.yaml @@ -1,11 +1,11 @@ inventory_id: SHR-INV-0001 title: State Hub capability disposition inventory -version: 0.1.1 +version: 0.1.2 created: '2026-08-09' -updated: '2026-08-09' +updated: '2026-08-31' workplan_task: SHR-WP-0001-T02 source_repo: state-hub -source_revision_note: Inventory generated from live OpenAPI, source tree, and docs on 2026-08-09 +source_revision_note: Initial live inventory plus FIN-WP-0003 Fabric authority correction on 2026-08-31 disposition_values: - keep - move @@ -18,6 +18,7 @@ owner_values: - issue-core - ops-hub - fin-hub +- railiance-fabric - ops-bridge - the-custodian - archive @@ -175,8 +176,8 @@ items: - FabricGraphNode - FabricGraphEdge capability: fabric-graph - owner: fin-hub - disposition: move + owner: railiance-fabric + disposition: replace confidence: initial notes: SQLAlchemy model; migration history under state-hub/migrations/versions - id: table:fabric_graph_nodes @@ -189,8 +190,8 @@ items: - FabricGraphNode - FabricGraphEdge capability: fabric-graph - owner: fin-hub - disposition: move + owner: railiance-fabric + disposition: replace confidence: initial notes: SQLAlchemy model; migration history under state-hub/migrations/versions - id: table:fabric_graph_edges @@ -203,8 +204,8 @@ items: - FabricGraphNode - FabricGraphEdge capability: fabric-graph - owner: fin-hub - disposition: move + owner: railiance-fabric + disposition: replace confidence: initial notes: SQLAlchemy model; migration history under state-hub/migrations/versions - id: table:intakes @@ -642,13 +643,13 @@ items: summary: item_count: 44 by_disposition: - move: 35 + move: 32 retire: 7 - replace: 2 + replace: 5 by_owner: hub-core: 12 repo-manager: 16 - fin-hub: 3 + railiance-fabric: 3 state-hub-until-cutover: 2 ops-hub: 5 archive: 5 diff --git a/inventory/routes.yaml b/inventory/routes.yaml index da3518b..fafe5d4 100644 --- a/inventory/routes.yaml +++ b/inventory/routes.yaml @@ -1,11 +1,11 @@ inventory_id: SHR-INV-0001 title: State Hub capability disposition inventory -version: 0.1.1 +version: 0.1.2 created: '2026-08-09' -updated: '2026-08-09' +updated: '2026-08-31' workplan_task: SHR-WP-0001-T02 source_repo: state-hub -source_revision_note: Inventory generated from live OpenAPI, source tree, and docs on 2026-08-09 +source_revision_note: Initial live inventory plus FIN-WP-0003 Fabric authority correction on 2026-08-31 disposition_values: - keep - move @@ -18,6 +18,7 @@ owner_values: - issue-core - ops-hub - fin-hub +- railiance-fabric - ops-bridge - the-custodian - archive @@ -631,9 +632,9 @@ items: tags: - fabric capability: fabric-graph - owner: fin-hub - disposition: move - notes: Financial fabric read model; specialized authority + owner: railiance-fabric + disposition: replace + notes: Replaced by authoritative Fabric registry/export/query surfaces; FIN-WP-0003 confidence: initial - id: route:GET:/fabric/graph-exports kind: route @@ -643,9 +644,9 @@ items: tags: - fabric capability: fabric-graph - owner: fin-hub - disposition: move - notes: Financial fabric read model; specialized authority + owner: railiance-fabric + disposition: replace + notes: Replaced by authoritative Fabric registry/export/query surfaces; FIN-WP-0003 confidence: initial - id: route:GET:/fabric/graph-exports/latest kind: route @@ -655,9 +656,9 @@ items: tags: - fabric capability: fabric-graph - owner: fin-hub - disposition: move - notes: Financial fabric read model; specialized authority + owner: railiance-fabric + disposition: replace + notes: Replaced by authoritative Fabric registry/export/query surfaces; FIN-WP-0003 confidence: initial - id: route:POST:/fabric/graph-exports/pull kind: route @@ -667,9 +668,9 @@ items: tags: - fabric capability: fabric-graph - owner: fin-hub - disposition: move - notes: Financial fabric read model; specialized authority + owner: railiance-fabric + disposition: replace + notes: Replaced by authoritative Fabric registry/export/query surfaces; FIN-WP-0003 confidence: initial - id: route:GET:/fabric/graph/edges kind: route @@ -679,9 +680,9 @@ items: tags: - fabric capability: fabric-graph - owner: fin-hub - disposition: move - notes: Financial fabric read model; specialized authority + owner: railiance-fabric + disposition: replace + notes: Replaced by authoritative Fabric registry/export/query surfaces; FIN-WP-0003 confidence: initial - id: route:GET:/fabric/graph/nodes kind: route @@ -691,9 +692,9 @@ items: tags: - fabric capability: fabric-graph - owner: fin-hub - disposition: move - notes: Financial fabric read model; specialized authority + owner: railiance-fabric + disposition: replace + notes: Replaced by authoritative Fabric registry/export/query surfaces; FIN-WP-0003 confidence: initial - id: route:GET:/fabric/graph/summary kind: route @@ -703,9 +704,9 @@ items: tags: - fabric capability: fabric-graph - owner: fin-hub - disposition: move - notes: Financial fabric read model; specialized authority + owner: railiance-fabric + disposition: replace + notes: Replaced by authoritative Fabric registry/export/query surfaces; FIN-WP-0003 confidence: initial - id: route:GET:/flows/definitions kind: route @@ -2311,14 +2312,14 @@ items: summary: item_count: 187 by_disposition: - move: 143 - replace: 20 + move: 136 + replace: 27 retire: 24 by_owner: hub-core: 63 repo-manager: 80 activity-core: 10 - fin-hub: 7 + railiance-fabric: 7 state-hub-until-cutover: 7 ops-hub: 3 archive: 17 diff --git a/inventory/state-hub-disposition.yaml b/inventory/state-hub-disposition.yaml index 267fd06..b608e97 100644 --- a/inventory/state-hub-disposition.yaml +++ b/inventory/state-hub-disposition.yaml @@ -1,11 +1,11 @@ inventory_id: SHR-INV-0001 title: State Hub capability disposition inventory -version: 0.1.1 +version: 0.1.2 created: '2026-08-09' -updated: '2026-08-09' +updated: '2026-08-31' workplan_task: SHR-WP-0001-T02 source_repo: state-hub -source_revision_note: Inventory generated from live OpenAPI, source tree, and docs on 2026-08-09 +source_revision_note: Initial live inventory plus FIN-WP-0003 Fabric authority correction on 2026-08-31 disposition_values: - keep - move @@ -18,6 +18,7 @@ owner_values: - issue-core - ops-hub - fin-hub +- railiance-fabric - ops-bridge - the-custodian - archive @@ -64,13 +65,13 @@ summary: route: 187 by_disposition: keep: 48 - move: 269 - replace: 66 + move: 259 + replace: 76 retire: 42 by_owner: activity-core: 18 archive: 30 - fin-hub: 10 + railiance-fabric: 10 hub-core: 128 ops-bridge: 2 ops-hub: 13 @@ -663,9 +664,9 @@ items: tags: - fabric capability: fabric-graph - owner: fin-hub - disposition: move - notes: Financial fabric read model; specialized authority + owner: railiance-fabric + disposition: replace + notes: Replaced by authoritative Fabric registry/export/query surfaces; FIN-WP-0003 confidence: initial - id: route:GET:/fabric/graph-exports kind: route @@ -675,9 +676,9 @@ items: tags: - fabric capability: fabric-graph - owner: fin-hub - disposition: move - notes: Financial fabric read model; specialized authority + owner: railiance-fabric + disposition: replace + notes: Replaced by authoritative Fabric registry/export/query surfaces; FIN-WP-0003 confidence: initial - id: route:GET:/fabric/graph-exports/latest kind: route @@ -687,9 +688,9 @@ items: tags: - fabric capability: fabric-graph - owner: fin-hub - disposition: move - notes: Financial fabric read model; specialized authority + owner: railiance-fabric + disposition: replace + notes: Replaced by authoritative Fabric registry/export/query surfaces; FIN-WP-0003 confidence: initial - id: route:POST:/fabric/graph-exports/pull kind: route @@ -699,9 +700,9 @@ items: tags: - fabric capability: fabric-graph - owner: fin-hub - disposition: move - notes: Financial fabric read model; specialized authority + owner: railiance-fabric + disposition: replace + notes: Replaced by authoritative Fabric registry/export/query surfaces; FIN-WP-0003 confidence: initial - id: route:GET:/fabric/graph/edges kind: route @@ -711,9 +712,9 @@ items: tags: - fabric capability: fabric-graph - owner: fin-hub - disposition: move - notes: Financial fabric read model; specialized authority + owner: railiance-fabric + disposition: replace + notes: Replaced by authoritative Fabric registry/export/query surfaces; FIN-WP-0003 confidence: initial - id: route:GET:/fabric/graph/nodes kind: route @@ -723,9 +724,9 @@ items: tags: - fabric capability: fabric-graph - owner: fin-hub - disposition: move - notes: Financial fabric read model; specialized authority + owner: railiance-fabric + disposition: replace + notes: Replaced by authoritative Fabric registry/export/query surfaces; FIN-WP-0003 confidence: initial - id: route:GET:/fabric/graph/summary kind: route @@ -735,9 +736,9 @@ items: tags: - fabric capability: fabric-graph - owner: fin-hub - disposition: move - notes: Financial fabric read model; specialized authority + owner: railiance-fabric + disposition: replace + notes: Replaced by authoritative Fabric registry/export/query surfaces; FIN-WP-0003 confidence: initial - id: route:GET:/flows/definitions kind: route @@ -2464,8 +2465,8 @@ items: - FabricGraphNode - FabricGraphEdge capability: fabric-graph - owner: fin-hub - disposition: move + owner: railiance-fabric + disposition: replace confidence: initial notes: SQLAlchemy model; migration history under state-hub/migrations/versions - id: table:fabric_graph_nodes @@ -2478,8 +2479,8 @@ items: - FabricGraphNode - FabricGraphEdge capability: fabric-graph - owner: fin-hub - disposition: move + owner: railiance-fabric + disposition: replace confidence: initial notes: SQLAlchemy model; migration history under state-hub/migrations/versions - id: table:fabric_graph_edges @@ -2492,8 +2493,8 @@ items: - FabricGraphNode - FabricGraphEdge capability: fabric-graph - owner: fin-hub - disposition: move + owner: railiance-fabric + disposition: replace confidence: initial notes: SQLAlchemy model; migration history under state-hub/migrations/versions - id: table:intakes