CUST-WP-0055 T06/T07: workplan-first fabric source docs and archive notes

Update catalog, integration docs, and fabric capability declarations to use workplan terminology. Add archive grandfather notes.
2026-07-08 20:26:24 +02:00 · 2026-07-08 20:26:24 +02:00 · 0507b0861b
commit 0507b0861b
parent 3fff3e4209
35 changed files with 65 additions and 9 deletions
--- a/catalog/capability-types.yaml
+++ b/catalog/capability-types.yaml
@ -186,7 +186,7 @@ spec:
    - id: coordination-read-model
      name: Coordination read model
      lifecycle: active
-      description: Exposes coordination state for repos, workstreams, tasks, decisions, and progress.
+      description: Exposes coordination state for repos, workplans, tasks, decisions, and progress.
      default_criticality: high
      default_data_classification: internal
      expected_interface_types:
--- a/docs/FabricDiscoveryAndUpdate.md
+++ b/docs/FabricDiscoveryAndUpdate.md
@ -88,7 +88,7 @@ responsibility move to another lord.
 A view is a diagnostic or informational slice through the graph.

 Views can filter by repository, service, environment, machine, endpoint, tenant,
-workstream, deployment stack, or business capability. Views do not define fabric
+workplan, deployment stack, or business capability. Views do not define fabric
 membership and should not mutate fabric boundaries.

 Zone views are a special kind of view. They group the subgraph by deployment
--- a/docs/ecosystem-registry-service.md
+++ b/docs/ecosystem-registry-service.md
@ -57,7 +57,7 @@ The registry service should not own:
 - deployment orchestration
 - service provisioning
 - policy enforcement gates before the model has adoption
- replacing State Hub workstreams, tasks, progress, or planning state
+- replacing State Hub workplans, tasks, progress, or planning state
 - replacing a developer portal

 ## Initial Data Model
--- a/docs/financial-fabric-operator-guide.md
+++ b/docs/financial-fabric-operator-guide.md
@ -166,7 +166,7 @@ secret roots rather than asking each repo to own all external relations.
 ## State Hub Handoff

 State Hub is a read model for Fabric topology. It should ingest Fabric exports,
-link them to repos/workstreams/tasks, and expose dashboard/search views. It
+link them to repos/workplans/tasks, and expose dashboard/search views. It
 should not author ownership, fabric membership, or utility boundaries.

 Until `STATE-WP-0051` is implemented:
--- a/docs/state-hub-integration.md
+++ b/docs/state-hub-integration.md
@ -13,7 +13,7 @@ ownership, fabric membership, or cross-boundary utility relations.
 | Deployment/accountability roots | Durable evidence of infrastructure, deployment, ownership, utility, and payment responsibility | State Hub task state |
 | Participating repos | Self-description evidence such as code, manifests, API contracts, package metadata, and legacy `fabric/` declarations | All external deployment/fabric relations |
 | Railiance Fabric | Schemas, discovery, validation, graph construction, accepted snapshots, exports | State Hub tasks/progress/decisions |
-| State Hub | Read-model storage, links to repos/workstreams/tasks/progress, dashboard/search views | Editing Fabric topology or inventing ownership |
+| State Hub | Read-model storage, links to repos/workplans/tasks/progress, dashboard/search views | Editing Fabric topology or inventing ownership |

 The flow is:

@ -235,8 +235,8 @@ State Hub should enrich graph nodes by matching:

 - `node.repo` -> `managed_repos.slug`
 - `node.domain` -> `domains.slug`
- workplan source links -> `workstreams.slug` or file-backed workplan index
- progress events -> `repo_id` and related workstream/task when available
+- workplan source links -> `workplans.slug` or file-backed workplan index (legacy alias: `workstreams.slug`)
+- progress events -> `repo_id` and related workplan/task when available

 These links are annotations on the read model. They should never overwrite the
 Fabric export or source evidence.
--- a/fabric/capabilities/the-custodian-state-hub-coordination.yaml
+++ b/fabric/capabilities/the-custodian-state-hub-coordination.yaml
@ -9,7 +9,7 @@ metadata:
 spec:
  lifecycle: active
  environments: [all]
-  description: Exposes repo, workstream, task, decision, and progress state for coordination.
+  description: Exposes repo, workplan, task, decision, and progress state for coordination.
  capability_type: coordination-read-model
  service_id: the-custodian.state-hub
  interface_ids:
--- a/fabric/services/the-custodian-state-hub.yaml
+++ b/fabric/services/the-custodian-state-hub.yaml
@ -9,7 +9,7 @@ metadata:
 spec:
  lifecycle: active
  environments: [all]
-  description: Coordination read model for repos, workstreams, tasks, decisions, and progress.
+  description: Coordination read model for repos, workplans, tasks, decisions, and progress.
  service_type: coordination-service
  provides_capabilities:
    - the-custodian.state-hub.coordination
--- a/workplans/archived/260702-ADHOC-2026-05-21.md
+++ b/workplans/archived/260702-ADHOC-2026-05-21.md
@ -12,6 +12,8 @@ updated: "2026-05-21"
 state_hub_workstream_id: "c5126722-3b6c-4a6a-b687-bc2ebfce5d58"
 ---

+> **Terminology note:** Historical text in this archived workplan may use the legacy term "workstream". The fleet term is **workplan** (`canon/standards/workplan-terminology-fleet_v0.1.md`).
+
 # ADHOC-2026-05-21 - Ad Hoc Fixes

 ## Collapse Duplicate Repository Icons
--- a/workplans/archived/260702-ADHOC-2026-05-25.md
+++ b/workplans/archived/260702-ADHOC-2026-05-25.md
@ -12,6 +12,8 @@ updated: "2026-05-25"
 state_hub_workstream_id: "77e80432-9548-4ac8-9654-7beb931741e4"
 ---

+> **Terminology note:** Historical text in this archived workplan may use the legacy term "workstream". The fleet term is **workplan** (`canon/standards/workplan-terminology-fleet_v0.1.md`).
+
 # ADHOC-2026-05-25 - Ad Hoc Fixes

 ## Add Zone Layout Algorithm Control
--- a/workplans/archived/260702-ADHOC-2026-06-03.md
+++ b/workplans/archived/260702-ADHOC-2026-06-03.md
@ -12,6 +12,8 @@ updated: "2026-06-03"
 state_hub_workstream_id: "c39b02dd-8074-4efd-ad18-add5595bf646"
 ---

+> **Terminology note:** Historical text in this archived workplan may use the legacy term "workstream". The fleet term is **workplan** (`canon/standards/workplan-terminology-fleet_v0.1.md`).
+
 # ADHOC-2026-06-03 - Ad Hoc Fixes

 ## Add Graph Explorer Make Target
--- a/workplans/archived/260702-ADHOC-2026-06-06.md
+++ b/workplans/archived/260702-ADHOC-2026-06-06.md
@ -12,6 +12,8 @@ updated: "2026-06-06"
 state_hub_workstream_id: "02426929-e247-4fbf-8072-ea05cac41e93"
 ---

+> **Terminology note:** Historical text in this archived workplan may use the legacy term "workstream". The fleet term is **workplan** (`canon/standards/workplan-terminology-fleet_v0.1.md`).
+
 # ADHOC-2026-06-06 - Ad Hoc Fixes

 ## Document Semantic Attractors
--- a/workplans/archived/260702-RAIL-FAB-WP-0001-ecosystem-graph-model.md
+++ b/workplans/archived/260702-RAIL-FAB-WP-0001-ecosystem-graph-model.md
@ -14,6 +14,8 @@ created: "2026-05-17"
 updated: "2026-05-17"
 ---

+> **Terminology note:** Historical text in this archived workplan may use the legacy term "workstream". The fleet term is **workplan** (`canon/standards/workplan-terminology-fleet_v0.1.md`).
+
 # RAIL-FAB-WP-0001 - Railiance Ecosystem Graph Model

 ## Goal
--- a/workplans/archived/260702-RAIL-FAB-WP-0002-ecosystem-registry-service.md
+++ b/workplans/archived/260702-RAIL-FAB-WP-0002-ecosystem-registry-service.md
@ -14,6 +14,8 @@ created: "2026-05-17"
 updated: "2026-05-17"
 ---

+> **Terminology note:** Historical text in this archived workplan may use the legacy term "workstream". The fleet term is **workplan** (`canon/standards/workplan-terminology-fleet_v0.1.md`).
+
 # RAIL-FAB-WP-0002 - Railiance Ecosystem Registry Service

 ## Goal
--- a/workplans/archived/260702-RAIL-FAB-WP-0003-registry-feed-and-library-inventory.md
+++ b/workplans/archived/260702-RAIL-FAB-WP-0003-registry-feed-and-library-inventory.md
@ -14,6 +14,8 @@ created: "2026-05-17"
 updated: "2026-05-17"
 ---

+> **Terminology note:** Historical text in this archived workplan may use the legacy term "workstream". The fleet term is **workplan** (`canon/standards/workplan-terminology-fleet_v0.1.md`).
+
 # RAIL-FAB-WP-0003 - Registry Feed And Library Inventory

 ## Goal
--- a/workplans/archived/260702-RAIL-FAB-WP-0004-registry-inventory-and-drift.md
+++ b/workplans/archived/260702-RAIL-FAB-WP-0004-registry-inventory-and-drift.md
@ -14,6 +14,8 @@ created: "2026-05-17"
 updated: "2026-05-17"
 ---

+> **Terminology note:** Historical text in this archived workplan may use the legacy term "workstream". The fleet term is **workplan** (`canon/standards/workplan-terminology-fleet_v0.1.md`).
+
 # RAIL-FAB-WP-0004 - Registry Inventory And Drift Views

 ## Goal
--- a/workplans/archived/260702-RAIL-FAB-WP-0005-registry-hardening.md
+++ b/workplans/archived/260702-RAIL-FAB-WP-0005-registry-hardening.md
@ -14,6 +14,8 @@ created: "2026-05-17"
 updated: "2026-05-17"
 ---

+> **Terminology note:** Historical text in this archived workplan may use the legacy term "workstream". The fleet term is **workplan** (`canon/standards/workplan-terminology-fleet_v0.1.md`).
+
 # RAIL-FAB-WP-0005 - Registry Hardening

 ## Goal
--- a/workplans/archived/260702-RAIL-FAB-WP-0006-multi-repo-registry-onboarding.md
+++ b/workplans/archived/260702-RAIL-FAB-WP-0006-multi-repo-registry-onboarding.md
@ -14,6 +14,8 @@ created: "2026-05-17"
 updated: "2026-05-17"
 ---

+> **Terminology note:** Historical text in this archived workplan may use the legacy term "workstream". The fleet term is **workplan** (`canon/standards/workplan-terminology-fleet_v0.1.md`).
+
 # RAIL-FAB-WP-0006 - Multi-Repo Registry Onboarding

 ## Goal
--- a/workplans/archived/260702-RAIL-FAB-WP-0007-all-local-repo-onboarding.md
+++ b/workplans/archived/260702-RAIL-FAB-WP-0007-all-local-repo-onboarding.md
@ -14,6 +14,8 @@ created: "2026-05-18"
 updated: "2026-05-18"
 ---

+> **Terminology note:** Historical text in this archived workplan may use the legacy term "workstream". The fleet term is **workplan** (`canon/standards/workplan-terminology-fleet_v0.1.md`).
+
 # RAIL-FAB-WP-0007 - All Local Repo Onboarding

 ## Goal
--- a/workplans/archived/260702-RAIL-FAB-WP-0008-interactive-fabric-map.md
+++ b/workplans/archived/260702-RAIL-FAB-WP-0008-interactive-fabric-map.md
@ -14,6 +14,8 @@ created: "2026-05-18"
 updated: "2026-05-18"
 ---

+> **Terminology note:** Historical text in this archived workplan may use the legacy term "workstream". The fleet term is **workplan** (`canon/standards/workplan-terminology-fleet_v0.1.md`).
+
 # RAIL-FAB-WP-0008 - Interactive Fabric Map

 ## Goal
--- a/workplans/archived/260702-RAIL-FAB-WP-0009-graph-explorer-ui-refinement.md
+++ b/workplans/archived/260702-RAIL-FAB-WP-0009-graph-explorer-ui-refinement.md
@ -14,6 +14,8 @@ updated: "2026-05-19"
 state_hub_workstream_id: "1d797e74-bb26-4107-9221-db1248c2cb0e"
 ---

+> **Terminology note:** Historical text in this archived workplan may use the legacy term "workstream". The fleet term is **workplan** (`canon/standards/workplan-terminology-fleet_v0.1.md`).
+
 # RAIL-FAB-WP-0009 - Graph Explorer UI Refinement

 ## Goal
--- a/workplans/archived/260702-RAIL-FAB-WP-0010-repo-reality-scanner.md
+++ b/workplans/archived/260702-RAIL-FAB-WP-0010-repo-reality-scanner.md
@ -14,6 +14,8 @@ updated: "2026-05-19"
 state_hub_workstream_id: "ac88ac5e-7183-47ba-ac05-1a1b44cfd47e"
 ---

+> **Terminology note:** Historical text in this archived workplan may use the legacy term "workstream". The fleet term is **workplan** (`canon/standards/workplan-terminology-fleet_v0.1.md`).
+
 # RAIL-FAB-WP-0010 - Repo Reality Scanner

 ## Goal
--- a/workplans/archived/260702-RAIL-FAB-WP-0011-operational-rescan-loops.md
+++ b/workplans/archived/260702-RAIL-FAB-WP-0011-operational-rescan-loops.md
@ -14,6 +14,8 @@ updated: "2026-05-19"
 state_hub_workstream_id: "b6eb92ee-1aba-49b4-8580-ab15782cb970"
 ---

+> **Terminology note:** Historical text in this archived workplan may use the legacy term "workstream". The fleet term is **workplan** (`canon/standards/workplan-terminology-fleet_v0.1.md`).
+
 # RAIL-FAB-WP-0011 - Operational Rescan Loops

 ## Goal
--- a/workplans/archived/260702-RAIL-FAB-WP-0012-baseline-rollout-and-conflict-review.md
+++ b/workplans/archived/260702-RAIL-FAB-WP-0012-baseline-rollout-and-conflict-review.md
@ -14,6 +14,8 @@ updated: "2026-05-20"
 state_hub_workstream_id: "c7f85db5-59db-4f4b-bfe5-f984edb201f9"
 ---

+> **Terminology note:** Historical text in this archived workplan may use the legacy term "workstream". The fleet term is **workplan** (`canon/standards/workplan-terminology-fleet_v0.1.md`).
+
 # RAIL-FAB-WP-0012 - Baseline Rollout And Conflict Review

 ## Goal
--- a/workplans/archived/260702-RAIL-FAB-WP-0013-path-scoped-duplicate-identity.md
+++ b/workplans/archived/260702-RAIL-FAB-WP-0013-path-scoped-duplicate-identity.md
@ -14,6 +14,8 @@ updated: "2026-05-20"
 state_hub_workstream_id: "bf80900b-606c-442c-aa15-d6272d73a8d6"
 ---

+> **Terminology note:** Historical text in this archived workplan may use the legacy term "workstream". The fleet term is **workplan** (`canon/standards/workplan-terminology-fleet_v0.1.md`).
+
 # RAIL-FAB-WP-0013 - Path Scoped Duplicate Identity

 ## Goal
--- a/workplans/archived/260702-RAIL-FAB-WP-0014-runtime-topology-discovery.md
+++ b/workplans/archived/260702-RAIL-FAB-WP-0014-runtime-topology-discovery.md
@ -14,6 +14,8 @@ updated: "2026-05-21"
 state_hub_workstream_id: "9cb51719-3ef1-400a-916e-959b24c67b79"
 ---

+> **Terminology note:** Historical text in this archived workplan may use the legacy term "workstream". The fleet term is **workplan** (`canon/standards/workplan-terminology-fleet_v0.1.md`).
+
 # RAIL-FAB-WP-0014 - Runtime Topology Discovery

 ## Goal
--- a/workplans/archived/260702-RAIL-FAB-WP-0015-runtime-entity-taxonomy.md
+++ b/workplans/archived/260702-RAIL-FAB-WP-0015-runtime-entity-taxonomy.md
@ -14,6 +14,8 @@ updated: "2026-05-21"
 state_hub_workstream_id: "958559cc-c640-40d6-afe3-467ee0e9e973"
 ---

+> **Terminology note:** Historical text in this archived workplan may use the legacy term "workstream". The fleet term is **workplan** (`canon/standards/workplan-terminology-fleet_v0.1.md`).
+
 # RAIL-FAB-WP-0015 - Runtime Entity Taxonomy Refinement

 ## Goal
--- a/workplans/archived/260702-RAIL-FAB-WP-0016-canon-aligned-graph-model-reset-reingest.md
+++ b/workplans/archived/260702-RAIL-FAB-WP-0016-canon-aligned-graph-model-reset-reingest.md
@ -16,6 +16,8 @@ depends_on_workplans:
 state_hub_workstream_id: "4f776f2c-9a54-4658-8e30-eb0d3fc00b32"
 ---

+> **Terminology note:** Historical text in this archived workplan may use the legacy term "workstream". The fleet term is **workplan** (`canon/standards/workplan-terminology-fleet_v0.1.md`).
+
 # RAIL-FAB-WP-0016 - Canon-Aligned Graph Model Reset And Reingest

 ## Goal
--- a/workplans/archived/260702-RAIL-FAB-WP-0017-financial-fabric-model-reset.md
+++ b/workplans/archived/260702-RAIL-FAB-WP-0017-financial-fabric-model-reset.md
@ -12,6 +12,8 @@ updated: "2026-05-24"
 state_hub_workstream_id: "39cc363c-6e2a-46a2-bd19-cee7ff6fc149"
 ---

+> **Terminology note:** Historical text in this archived workplan may use the legacy term "workstream". The fleet term is **workplan** (`canon/standards/workplan-terminology-fleet_v0.1.md`).
+
 # RAIL-FAB-WP-0017 - Financial Fabric Model Reset

 ## Goal
--- a/workplans/archived/260702-RAIL-FAB-WP-0018-accountability-root-discovery-update-loop.md
+++ b/workplans/archived/260702-RAIL-FAB-WP-0018-accountability-root-discovery-update-loop.md
@ -12,6 +12,8 @@ updated: "2026-05-24"
 state_hub_workstream_id: "651185b5-83fe-4aef-b29d-617b2bc48c7a"
 ---

+> **Terminology note:** Historical text in this archived workplan may use the legacy term "workstream". The fleet term is **workplan** (`canon/standards/workplan-terminology-fleet_v0.1.md`).
+
 # RAIL-FAB-WP-0018 - Accountability Root Discovery And Update Loop

 ## Goal
--- a/workplans/archived/260702-RAIL-FAB-WP-0019-duplicate-repository-identity-review.md
+++ b/workplans/archived/260702-RAIL-FAB-WP-0019-duplicate-repository-identity-review.md
@ -12,6 +12,8 @@ updated: "2026-05-24"
 state_hub_workstream_id: "bc69549c-3cbc-4a7d-8766-b84added1133"
 ---

+> **Terminology note:** Historical text in this archived workplan may use the legacy term "workstream". The fleet term is **workplan** (`canon/standards/workplan-terminology-fleet_v0.1.md`).
+
 # RAIL-FAB-WP-0019 - Duplicate Repository Identity Review

 ## Goal
--- a/workplans/archived/260702-RAIL-FAB-WP-0020-deployment-zone-discovery-visualization.md
+++ b/workplans/archived/260702-RAIL-FAB-WP-0020-deployment-zone-discovery-visualization.md
@ -12,6 +12,8 @@ updated: "2026-05-24"
 state_hub_workstream_id: "e70820a9-d6f3-473d-a17c-b15fe3180773"
 ---

+> **Terminology note:** Historical text in this archived workplan may use the legacy term "workstream". The fleet term is **workplan** (`canon/standards/workplan-terminology-fleet_v0.1.md`).
+
 # RAIL-FAB-WP-0020 - Deployment Zone Discovery And Visualization

 ## Goal
--- a/workplans/archived/260702-RAIL-FAB-WP-0021-zone-boundary-overlays.md
+++ b/workplans/archived/260702-RAIL-FAB-WP-0021-zone-boundary-overlays.md
@ -12,6 +12,8 @@ updated: "2026-05-24"
 state_hub_workstream_id: "e9e2d47f-a965-4e2e-b65d-379dbb206a65"
 ---

+> **Terminology note:** Historical text in this archived workplan may use the legacy term "workstream". The fleet term is **workplan** (`canon/standards/workplan-terminology-fleet_v0.1.md`).
+
 # RAIL-FAB-WP-0021 - Zone Boundary Overlays

 ## Goal
--- a/workplans/archived/260702-RAIL-FAB-WP-0022-zone-entity-visualization-engine.md
+++ b/workplans/archived/260702-RAIL-FAB-WP-0022-zone-entity-visualization-engine.md
@ -12,6 +12,8 @@ updated: "2026-05-24"
 state_hub_workstream_id: "343f8383-ba5e-4d60-b55e-81611954d9b9"
 ---

+> **Terminology note:** Historical text in this archived workplan may use the legacy term "workstream". The fleet term is **workplan** (`canon/standards/workplan-terminology-fleet_v0.1.md`).
+
 # Promote Graph Zones To First-Class Visualization Entities

 ## Context
--- a/workplans/archived/260702-RAIL-FAB-WP-0023-zone-drag-interaction.md
+++ b/workplans/archived/260702-RAIL-FAB-WP-0023-zone-drag-interaction.md
@ -12,6 +12,8 @@ updated: "2026-06-05"
 state_hub_workstream_id: "f02e14c5-e60f-4950-b1a2-682c38b30431"
 ---

+> **Terminology note:** Historical text in this archived workplan may use the legacy term "workstream". The fleet term is **workplan** (`canon/standards/workplan-terminology-fleet_v0.1.md`).
+
 # Improve Zone Labels And Dragging

 ## Context
--- a/workplans/archived/260702-RAIL-FAB-WP-0024-stable-zone-containers-and-layout.md
+++ b/workplans/archived/260702-RAIL-FAB-WP-0024-stable-zone-containers-and-layout.md
@ -12,6 +12,8 @@ updated: "2026-05-25"
 state_hub_workstream_id: "63202459-2f73-409a-8881-307a5fc1835a"
 ---

+> **Terminology note:** Historical text in this archived workplan may use the legacy term "workstream". The fleet term is **workplan** (`canon/standards/workplan-terminology-fleet_v0.1.md`).
+
 # Stabilize Zone Containers And Layout Zone Subgraphs

 ## Context