CUST-WP-0055 T06/T07: workplan-first fabric source docs and archive notes
All checks were successful
CI Smoke / host-smoke (push) Successful in 2s
CI Smoke / container-smoke (push) Successful in 7s

Update catalog, integration docs, and fabric capability declarations to
use workplan terminology. Add archive grandfather notes.
This commit is contained in:
tegwick 2026-07-08 20:26:24 +02:00
parent 3fff3e4209
commit 0507b0861b
35 changed files with 65 additions and 9 deletions

View file

@ -186,7 +186,7 @@ spec:
- id: coordination-read-model - id: coordination-read-model
name: Coordination read model name: Coordination read model
lifecycle: active 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_criticality: high
default_data_classification: internal default_data_classification: internal
expected_interface_types: expected_interface_types:

View file

@ -88,7 +88,7 @@ responsibility move to another lord.
A view is a diagnostic or informational slice through the graph. A view is a diagnostic or informational slice through the graph.
Views can filter by repository, service, environment, machine, endpoint, tenant, 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. membership and should not mutate fabric boundaries.
Zone views are a special kind of view. They group the subgraph by deployment Zone views are a special kind of view. They group the subgraph by deployment

View file

@ -57,7 +57,7 @@ The registry service should not own:
- deployment orchestration - deployment orchestration
- service provisioning - service provisioning
- policy enforcement gates before the model has adoption - 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 - replacing a developer portal
## Initial Data Model ## Initial Data Model

View file

@ -166,7 +166,7 @@ secret roots rather than asking each repo to own all external relations.
## State Hub Handoff ## State Hub Handoff
State Hub is a read model for Fabric topology. It should ingest Fabric exports, 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. should not author ownership, fabric membership, or utility boundaries.
Until `STATE-WP-0051` is implemented: Until `STATE-WP-0051` is implemented:

View file

@ -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 | | 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 | | 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 | | 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: The flow is:
@ -235,8 +235,8 @@ State Hub should enrich graph nodes by matching:
- `node.repo` -> `managed_repos.slug` - `node.repo` -> `managed_repos.slug`
- `node.domain` -> `domains.slug` - `node.domain` -> `domains.slug`
- workplan source links -> `workstreams.slug` or file-backed workplan index - workplan source links -> `workplans.slug` or file-backed workplan index (legacy alias: `workstreams.slug`)
- progress events -> `repo_id` and related workstream/task when available - progress events -> `repo_id` and related workplan/task when available
These links are annotations on the read model. They should never overwrite the These links are annotations on the read model. They should never overwrite the
Fabric export or source evidence. Fabric export or source evidence.

View file

@ -9,7 +9,7 @@ metadata:
spec: spec:
lifecycle: active lifecycle: active
environments: [all] 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 capability_type: coordination-read-model
service_id: the-custodian.state-hub service_id: the-custodian.state-hub
interface_ids: interface_ids:

View file

@ -9,7 +9,7 @@ metadata:
spec: spec:
lifecycle: active lifecycle: active
environments: [all] 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 service_type: coordination-service
provides_capabilities: provides_capabilities:
- the-custodian.state-hub.coordination - the-custodian.state-hub.coordination

View file

@ -12,6 +12,8 @@ updated: "2026-05-21"
state_hub_workstream_id: "c5126722-3b6c-4a6a-b687-bc2ebfce5d58" 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 # ADHOC-2026-05-21 - Ad Hoc Fixes
## Collapse Duplicate Repository Icons ## Collapse Duplicate Repository Icons

View file

@ -12,6 +12,8 @@ updated: "2026-05-25"
state_hub_workstream_id: "77e80432-9548-4ac8-9654-7beb931741e4" 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 # ADHOC-2026-05-25 - Ad Hoc Fixes
## Add Zone Layout Algorithm Control ## Add Zone Layout Algorithm Control

View file

@ -12,6 +12,8 @@ updated: "2026-06-03"
state_hub_workstream_id: "c39b02dd-8074-4efd-ad18-add5595bf646" 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 # ADHOC-2026-06-03 - Ad Hoc Fixes
## Add Graph Explorer Make Target ## Add Graph Explorer Make Target

View file

@ -12,6 +12,8 @@ updated: "2026-06-06"
state_hub_workstream_id: "02426929-e247-4fbf-8072-ea05cac41e93" 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 # ADHOC-2026-06-06 - Ad Hoc Fixes
## Document Semantic Attractors ## Document Semantic Attractors

View file

@ -14,6 +14,8 @@ created: "2026-05-17"
updated: "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 # RAIL-FAB-WP-0001 - Railiance Ecosystem Graph Model
## Goal ## Goal

View file

@ -14,6 +14,8 @@ created: "2026-05-17"
updated: "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 # RAIL-FAB-WP-0002 - Railiance Ecosystem Registry Service
## Goal ## Goal

View file

@ -14,6 +14,8 @@ created: "2026-05-17"
updated: "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 # RAIL-FAB-WP-0003 - Registry Feed And Library Inventory
## Goal ## Goal

View file

@ -14,6 +14,8 @@ created: "2026-05-17"
updated: "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 # RAIL-FAB-WP-0004 - Registry Inventory And Drift Views
## Goal ## Goal

View file

@ -14,6 +14,8 @@ created: "2026-05-17"
updated: "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 # RAIL-FAB-WP-0005 - Registry Hardening
## Goal ## Goal

View file

@ -14,6 +14,8 @@ created: "2026-05-17"
updated: "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 # RAIL-FAB-WP-0006 - Multi-Repo Registry Onboarding
## Goal ## Goal

View file

@ -14,6 +14,8 @@ created: "2026-05-18"
updated: "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 # RAIL-FAB-WP-0007 - All Local Repo Onboarding
## Goal ## Goal

View file

@ -14,6 +14,8 @@ created: "2026-05-18"
updated: "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 # RAIL-FAB-WP-0008 - Interactive Fabric Map
## Goal ## Goal

View file

@ -14,6 +14,8 @@ updated: "2026-05-19"
state_hub_workstream_id: "1d797e74-bb26-4107-9221-db1248c2cb0e" 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 # RAIL-FAB-WP-0009 - Graph Explorer UI Refinement
## Goal ## Goal

View file

@ -14,6 +14,8 @@ updated: "2026-05-19"
state_hub_workstream_id: "ac88ac5e-7183-47ba-ac05-1a1b44cfd47e" 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 # RAIL-FAB-WP-0010 - Repo Reality Scanner
## Goal ## Goal

View file

@ -14,6 +14,8 @@ updated: "2026-05-19"
state_hub_workstream_id: "b6eb92ee-1aba-49b4-8580-ab15782cb970" 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 # RAIL-FAB-WP-0011 - Operational Rescan Loops
## Goal ## Goal

View file

@ -14,6 +14,8 @@ updated: "2026-05-20"
state_hub_workstream_id: "c7f85db5-59db-4f4b-bfe5-f984edb201f9" 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 # RAIL-FAB-WP-0012 - Baseline Rollout And Conflict Review
## Goal ## Goal

View file

@ -14,6 +14,8 @@ updated: "2026-05-20"
state_hub_workstream_id: "bf80900b-606c-442c-aa15-d6272d73a8d6" 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 # RAIL-FAB-WP-0013 - Path Scoped Duplicate Identity
## Goal ## Goal

View file

@ -14,6 +14,8 @@ updated: "2026-05-21"
state_hub_workstream_id: "9cb51719-3ef1-400a-916e-959b24c67b79" 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 # RAIL-FAB-WP-0014 - Runtime Topology Discovery
## Goal ## Goal

View file

@ -14,6 +14,8 @@ updated: "2026-05-21"
state_hub_workstream_id: "958559cc-c640-40d6-afe3-467ee0e9e973" 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 # RAIL-FAB-WP-0015 - Runtime Entity Taxonomy Refinement
## Goal ## Goal

View file

@ -16,6 +16,8 @@ depends_on_workplans:
state_hub_workstream_id: "4f776f2c-9a54-4658-8e30-eb0d3fc00b32" 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 # RAIL-FAB-WP-0016 - Canon-Aligned Graph Model Reset And Reingest
## Goal ## Goal

View file

@ -12,6 +12,8 @@ updated: "2026-05-24"
state_hub_workstream_id: "39cc363c-6e2a-46a2-bd19-cee7ff6fc149" 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 # RAIL-FAB-WP-0017 - Financial Fabric Model Reset
## Goal ## Goal

View file

@ -12,6 +12,8 @@ updated: "2026-05-24"
state_hub_workstream_id: "651185b5-83fe-4aef-b29d-617b2bc48c7a" 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 # RAIL-FAB-WP-0018 - Accountability Root Discovery And Update Loop
## Goal ## Goal

View file

@ -12,6 +12,8 @@ updated: "2026-05-24"
state_hub_workstream_id: "bc69549c-3cbc-4a7d-8766-b84added1133" 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 # RAIL-FAB-WP-0019 - Duplicate Repository Identity Review
## Goal ## Goal

View file

@ -12,6 +12,8 @@ updated: "2026-05-24"
state_hub_workstream_id: "e70820a9-d6f3-473d-a17c-b15fe3180773" 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 # RAIL-FAB-WP-0020 - Deployment Zone Discovery And Visualization
## Goal ## Goal

View file

@ -12,6 +12,8 @@ updated: "2026-05-24"
state_hub_workstream_id: "e9e2d47f-a965-4e2e-b65d-379dbb206a65" 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 # RAIL-FAB-WP-0021 - Zone Boundary Overlays
## Goal ## Goal

View file

@ -12,6 +12,8 @@ updated: "2026-05-24"
state_hub_workstream_id: "343f8383-ba5e-4d60-b55e-81611954d9b9" 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 # Promote Graph Zones To First-Class Visualization Entities
## Context ## Context

View file

@ -12,6 +12,8 @@ updated: "2026-06-05"
state_hub_workstream_id: "f02e14c5-e60f-4950-b1a2-682c38b30431" 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 # Improve Zone Labels And Dragging
## Context ## Context

View file

@ -12,6 +12,8 @@ updated: "2026-05-25"
state_hub_workstream_id: "63202459-2f73-409a-8881-307a5fc1835a" 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 # Stabilize Zone Containers And Layout Zone Subgraphs
## Context ## Context