Propose interactive Fabric map workplan

README.md

@@ -74,6 +74,13 @@ onboarding manifest:
 railiance-fabric registry sync-manifest registry/railiance-repos.yaml
 ```
 
+To onboard every active State Hub repo with an available local checkout on this
+host:
+
+```bash
+railiance-fabric registry sync-manifest registry/local-repos.yaml
+```
+
 Ingest a CycloneDX SBOM as queryable library inventory:
 
 ```bash

docs/registry-onboarding.md

@@ -18,6 +18,12 @@ Sync the known local Railiance ecosystem repos:
 railiance-fabric registry sync-manifest registry/railiance-repos.yaml
 ```
 
+Sync every active State Hub repo that is available on this local host:
+
+```bash
+railiance-fabric registry sync-manifest registry/local-repos.yaml
+```
+
 Use `--json` for automation and `--strict` when unavailable repos or invalid
 inputs should fail the command.
 
@@ -64,3 +70,8 @@ The first Railiance manifest keeps the seed ecosystem graph in
 `railiance-fabric` and registers adjacent repos as known sources. As those repos
 adopt repo-local `fabric/` declarations, they can be synced without changing the
 registry API.
+
+`registry/local-repos.yaml` is a broader local-host manifest. It is generated
+from active State Hub repo records whose local path exists on the current WSL
+host. It registers cross-domain local repos into the Fabric registry while only
+syncing graph snapshots for repos that already have Fabric declarations.

registry/local-repos.yaml

@@ -0,0 +1,269 @@
+apiVersion: railiance.fabric/v1alpha1
+kind: RegistryOnboardingManifest
+registry_url: http://127.0.0.1:8765
+repositories:
+  - slug: repo-scoping
+    name: repo-scoping
+    domain: capabilities
+    path: /home/worsch/repo-scoping
+    default_branch: main
+    state_hub_repo_id: de749ff1-a4a4-42f5-8ed4-6b8c05b18bd9
+    remote_url: gitea-remote:coulomb/repo-scoping.git
+
+  - slug: vergabe-teilnahme
+    name: vergabe-teilnahme
+    domain: coulomb_social
+    path: /home/worsch/vergabe-teilnahme
+    default_branch: main
+    state_hub_repo_id: ff7b0754-9d54-4abf-a752-d342870f5993
+    remote_url: gitea-remote:coulomb/vergabe-teilnahme.git
+
+  - slug: activity-core
+    name: activity-core
+    domain: custodian
+    path: /home/worsch/activity-core
+    default_branch: main
+    state_hub_repo_id: 4296e38c-4eb4-4710-8e35-fb37009add0b
+
+  - slug: inter-hub
+    name: Interaction Hub Framework
+    domain: custodian
+    path: /home/worsch/inter-hub
+    default_branch: main
+    state_hub_repo_id: e9960194-f19e-4007-904a-4ac3ca202598
+    remote_url: ssh://git@92.205.130.254:30022/coulomb/inter-hub.git
+
+  - slug: issue-core
+    name: issue-core
+    domain: custodian
+    path: /home/worsch/issue-core
+    default_branch: main
+    state_hub_repo_id: e51fd6df-525e-457c-9ec0-924832b491bc
+
+  - slug: llm-connect
+    name: llm-connect
+    domain: custodian
+    path: /home/worsch/llm-connect
+    default_branch: main
+    state_hub_repo_id: 13094d7a-b978-4aa3-8a1d-0d05b824698d
+    remote_url: http://92.205.130.254:32166/coulomb/llm-connect.git
+
+  - slug: ops-bridge
+    name: ops-bridge
+    domain: custodian
+    path: /home/worsch/ops-bridge
+    default_branch: main
+    state_hub_repo_id: 1bf99f56-6e94-4379-a9ea-295a4c181889
+
+  - slug: ops-warden
+    name: ops-warden
+    domain: custodian
+    path: /home/worsch/ops-warden
+    default_branch: main
+    state_hub_repo_id: 74df727e-a756-42de-b776-11928b03bd1f
+    remote_url: gitea-remote:coulomb/ops-warden.git
+
+  - slug: state-hub
+    name: State Hub
+    domain: custodian
+    path: /home/worsch/state-hub
+    default_branch: main
+    state_hub_repo_id: 8e9ffb56-7abc-47b5-84b2-5ad392b37dcd
+    remote_url: gitea-remote:coulomb/state-hub.git
+
+  - slug: the-custodian
+    name: The Custodian
+    domain: custodian
+    path: /home/worsch/the-custodian
+    default_branch: main
+    state_hub_repo_id: 56ae522c-b47e-4748-8239-f61b332fe69d
+    remote_url: http://gitea.local/worsch/the-custodian
+
+  - slug: helix-forge
+    name: helix-forge
+    domain: helix_forge
+    path: /home/worsch/helix-forge
+    default_branch: main
+    state_hub_repo_id: c7a3dc03-d837-4577-a107-a190d6b00705
+    remote_url: gitea-remote:coulomb/helix-forge.git
+
+  - slug: guide-board
+    name: guide-board
+    domain: markitect
+    path: /home/worsch/guide-board
+    default_branch: main
+    state_hub_repo_id: 90918b55-6347-4e57-8086-db7b0454f73d
+    remote_url: gitea-remote:coulomb/guide-board.git
+
+  - slug: infospace-bench
+    name: infospace-bench
+    domain: markitect
+    path: /home/worsch/infospace-bench
+    default_branch: main
+    state_hub_repo_id: b7b3e7cc-cdde-4430-be43-e82343fdf1b0
+    remote_url: http://92.205.130.254:32166/coulomb/infospace-bench.git
+
+  - slug: kontextual-engine
+    name: kontextual-engine
+    domain: markitect
+    path: /home/worsch/kontextual-engine
+    default_branch: main
+    state_hub_repo_id: a7cea934-e38c-467c-b2ea-64fd3424a845
+    remote_url: http://92.205.130.254:32166/coulomb/kontextual-engine.git
+
+  - slug: markitect-filter
+    name: markitect-filter
+    domain: markitect
+    path: /home/worsch/markitect-filter
+    default_branch: main
+    state_hub_repo_id: 87f43c8e-01bd-465a-96ce-c0eee2ae7bcf
+
+  - slug: markitect-project
+    name: markitect-main
+    domain: markitect
+    path: /home/worsch/markitect-main
+    default_branch: main
+    state_hub_repo_id: b388326c-dfce-4e30-a364-cedd285370e5
+
+  - slug: markitect-quarkdown
+    name: markitect-quarkdown
+    domain: markitect
+    path: /home/worsch/markitect-quarkdown
+    default_branch: main
+    state_hub_repo_id: 2c72f2ad-d940-4a21-a71e-d490bd51cff2
+
+  - slug: markitect-tool
+    name: markitect-tool
+    domain: markitect
+    path: /home/worsch/markitect-tool
+    default_branch: main
+    state_hub_repo_id: ba599cd4-e8aa-430b-bbbe-e49f88536d70
+
+  - slug: open-cmis-tck
+    name: open-cmis-tck
+    domain: markitect
+    path: /home/worsch/open-cmis-tck
+    default_branch: main
+    state_hub_repo_id: b6b8dacd-4100-475a-8390-c326e1cebdec
+    remote_url: gitea-remote:coulomb/open-cmis-tck.git
+
+  - slug: phase-memory
+    name: phase-memory
+    domain: markitect
+    path: /home/worsch/phase-memory
+    default_branch: main
+    state_hub_repo_id: d56e0504-044d-4021-ae43-e9d706dbd087
+
+  - slug: domain-tree
+    name: domain-tree
+    domain: netkingdom
+    path: /home/worsch/domain-tree
+    default_branch: main
+    state_hub_repo_id: 146bcec9-59e8-481e-9996-f0b30ab28abb
+
+  - slug: flex-auth
+    name: flex-auth
+    domain: netkingdom
+    path: /home/worsch/flex-auth
+    default_branch: main
+    state_hub_repo_id: fda8ad85-a7d7-4055-8f21-902a533e59df
+
+  - slug: key-cape
+    name: KeyCape
+    domain: netkingdom
+    path: /home/worsch/key-cape
+    default_branch: main
+    state_hub_repo_id: 8a99bb74-1ec0-4478-ac70-35a7cddb0e3c
+
+  - slug: net-kingdom
+    name: NetKingdom
+    domain: netkingdom
+    path: /home/worsch/net-kingdom
+    default_branch: main
+    state_hub_repo_id: 4589488d-625b-4ffe-b8f0-48744d7b1498
+    remote_url: http://92.205.130.254:32166/coulomb/net-kingdom.git
+
+  - slug: railiance-apps
+    name: railiance-apps
+    domain: railiance
+    path: /home/worsch/railiance-apps
+    default_branch: main
+    state_hub_repo_id: cb06310e-4381-428b-b8f3-d3ea8ac2f70d
+    remote_url: http://92.205.130.254:32166/coulomb/railiance-apps.git
+
+  - slug: railiance-cluster
+    name: railiance-cluster
+    domain: railiance
+    path: /home/worsch/railiance-cluster
+    default_branch: main
+    state_hub_repo_id: c3fd0dd2-a0de-415c-8e3a-e37406f4b8f8
+    remote_url: http://92.205.130.254:32166/coulomb/railiance-cluster.git
+
+  - slug: railiance-enablement
+    name: railiance-enablement
+    domain: railiance
+    path: /home/worsch/railiance-enablement
+    default_branch: main
+    state_hub_repo_id: bc978be9-ca72-42bb-a451-d4737b779c5b
+    remote_url: http://92.205.130.254:32166/coulomb/railiance-enablement.git
+
+  - slug: railiance-fabric
+    name: railiance-fabric
+    domain: railiance
+    path: /home/worsch/railiance-fabric
+    default_branch: main
+    state_hub_repo_id: 2c0de614-e468-4eb6-8157-470649ac8c05
+    declaration_paths:
+      - /home/worsch/railiance-fabric
+
+  - slug: railiance-hosts
+    name: railiance-hosts
+    domain: railiance
+    path: /home/worsch/railiance-infra
+    default_branch: main
+    state_hub_repo_id: 2db668cf-6c52-4965-951f-0d5e617de9e3
+
+  - slug: railiance-infra
+    name: railiance-infra
+    domain: railiance
+    path: /home/worsch/railiance-infra
+    default_branch: main
+    state_hub_repo_id: 485187c0-4fad-42f7-984c-5e317a66c5de
+    remote_url: http://92.205.130.254:32166/coulomb/railiance-infra.git
+
+  - slug: railiance-platform
+    name: railiance-platform
+    domain: railiance
+    path: /home/worsch/railiance-platform
+    default_branch: main
+    state_hub_repo_id: 5115e0c5-009f-4168-b155-9943fe2ab9a7
+    remote_url: http://92.205.130.254:32166/coulomb/railiance-platform.git
+
+  - slug: artifact-store
+    name: artifact-store
+    domain: stack
+    path: /home/worsch/artifact-store
+    default_branch: main
+    state_hub_repo_id: e1575e7c-e1b0-4b46-98be-78bd49e06318
+    remote_url: gitea-remote:coulomb/artifact-store.git
+
+  - slug: ihp-railiance-probe
+    name: ihp-railiance-probe
+    domain: stack
+    path: /home/worsch/ihp-railiance-probe
+    default_branch: main
+    state_hub_repo_id: 69b69830-af7f-496f-9af2-cbc23a83cd42
+
+  - slug: open-reuse
+    name: open-reuse
+    domain: stack
+    path: /home/worsch/open-reuse
+    default_branch: main
+    state_hub_repo_id: d416fd6f-3c9d-4ba7-a5ca-f7543940ee6a
+
+  - slug: vergabe_teilnahme
+    name: vergabe-teilnahme
+    domain: vergabe_teilnahme
+    path: /home/worsch/vergabe-teilnahme
+    default_branch: main
+    state_hub_repo_id: 46d9338e-d079-4953-b174-0ea64761be5c

workplans/RAIL-FAB-WP-0007-all-local-repo-onboarding.md

@@ -0,0 +1,57 @@
+---
+id: RAIL-FAB-WP-0007
+type: workplan
+title: "All Local Repo Onboarding"
+domain: railiance
+repo: railiance-fabric
+status: completed
+owner: codex
+topic_slug: railiance
+planning_priority: medium
+planning_order: 7
+state_hub_workstream_id: "80aba270-4d1d-49b7-8649-61594eed2fcb"
+created: "2026-05-18"
+updated: "2026-05-18"
+---
+
+# RAIL-FAB-WP-0007 - All Local Repo Onboarding
+
+## Goal
+
+Onboard every active State Hub repository with an available local checkout into
+the local Railiance Fabric registry.
+
+## Tasks
+
+### T01 - Local Repo Inventory Manifest
+
+```task
+id: RAIL-FAB-WP-0007-T01
+status: done
+priority: high
+state_hub_task_id: "29f4527c-e69b-4a2b-90ac-5a78d4e96095"
+```
+
+Generate and commit the all-local State Hub repo onboarding manifest.
+
+### T02 - Registry Onboarding Run
+
+```task
+id: RAIL-FAB-WP-0007-T02
+status: done
+priority: high
+state_hub_task_id: "4890ecac-3199-4684-9262-c5775e4f3ec9"
+```
+
+Run the all-local manifest against the local Fabric registry.
+
+### T03 - Verification And Documentation
+
+```task
+id: RAIL-FAB-WP-0007-T03
+status: done
+priority: medium
+state_hub_task_id: "dffa7d56-875f-4198-a59b-f6ab0ef3d82e"
+```
+
+Verify registry counts and document how to rerun the all-local onboarding.

workplans/RAIL-FAB-WP-0008-interactive-fabric-map.md

@@ -0,0 +1,159 @@
+---
+id: RAIL-FAB-WP-0008
+type: workplan
+title: "Interactive Fabric Map"
+domain: railiance
+repo: railiance-fabric
+status: proposed
+owner: codex
+topic_slug: railiance
+planning_priority: high
+planning_order: 8
+state_hub_workstream_id: "0018ee65-dd90-4162-8837-c72d71f0dc9e"
+created: "2026-05-18"
+updated: "2026-05-18"
+---
+
+# RAIL-FAB-WP-0008 - Interactive Fabric Map
+
+## Goal
+
+Build a clever interactive auto-layouting map over the registered Fabric
+entities so humans and agents can orient inside the infrastructure graph.
+
+The current repo has static graph exports through JSON and Mermaid. That is
+useful for snapshots and docs, but it does not yet provide a navigable
+orientation surface for the registered ecosystem.
+
+## Design Direction
+
+The first map should be an operational tool, not a landing page. It should open
+directly into the graph and make the current infrastructure legible through
+stable grouping, filtering, and drill-down.
+
+The map should support:
+
+- force or layered auto-layout with stable seeded positions
+- grouping by domain, repo, service, capability, interface, dependency, and
+  unresolved status
+- search across repo slugs, graph ids, names, capabilities, interfaces, and
+  library names
+- quick filters for active services, external interfaces, missing declarations,
+  unresolved dependencies, blast radius, and dependency path
+- hover and selection detail panels with links back to registry endpoints,
+  State Hub repo ids, workplans, and source files where available
+- shareable map state through URL query parameters or a copied state blob
+- graceful handling of registered-only repos that do not yet have local
+  `fabric/` declarations
+
+## Architecture Notes
+
+Keep the registry as the data source. The UI should consume registry exports and
+queries rather than reloading repo files directly.
+
+Likely implementation path:
+
+- add a map-oriented projection endpoint or CLI export that preserves existing
+  graph ids while adding visual facets
+- serve a small local web UI from the registry service or a separate lightweight
+  static bundle
+- use a proven browser graph/layout library instead of hand-rolling physics
+- keep layout state client-side first; persist only after the workflows prove
+  useful
+
+## Tasks
+
+### T01 - Map UX And Information Architecture
+
+```task
+id: RAIL-FAB-WP-0008-T01
+status: todo
+priority: high
+state_hub_task_id: "9844a9a7-f285-4523-a8d6-4ca62008ce08"
+```
+
+Define map views, entity visual grammar, navigation behaviors, and orientation
+affordances.
+
+Acceptance notes:
+
+- Decide initial visual grammar for repos, services, capabilities, interfaces,
+  dependencies, bindings, libraries, and registered-only repos.
+- Decide default grouping and default filters for first load.
+- Decide whether the first implementation uses a force-directed, layered, or
+  hybrid layout.
+
+### T02 - Layout-Ready Graph Projection
+
+```task
+id: RAIL-FAB-WP-0008-T02
+status: todo
+priority: high
+state_hub_task_id: "cb0cc9f1-5225-47e5-8b47-a945c92e7168"
+```
+
+Add or shape registry exports for map-friendly nodes, edges, groups, facets, and
+stable identifiers.
+
+Acceptance notes:
+
+- Include registered repositories even when they have no graph snapshot yet.
+- Include node type, domain, repo, lifecycle, unresolved flags, and edge type.
+- Preserve stable ids so layout state and deep links do not churn.
+
+### T03 - Interactive Auto-Layout Map UI
+
+```task
+id: RAIL-FAB-WP-0008-T03
+status: todo
+priority: high
+state_hub_task_id: "ecd967fc-05ed-4cda-bca2-cf74e26e60b3"
+```
+
+Build a local interactive map with layout controls, filtering, search, zoom,
+pan, and detail panels.
+
+Acceptance notes:
+
+- The first screen is the actual map.
+- Users can search, select, expand/collapse groups, and inspect details without
+  leaving the page.
+- The map remains useful with the current sparse state where many repos are
+  registered-only.
+
+### T04 - Operational Orientation Workflows
+
+```task
+id: RAIL-FAB-WP-0008-T04
+status: todo
+priority: medium
+state_hub_task_id: "75c1f234-026c-44ed-9c88-db39653b81e0"
+```
+
+Add workflows for blast-radius exploration, dependency paths, unresolved gaps,
+repo grouping, and current selection sharing.
+
+Acceptance notes:
+
+- Selecting an interface can show consumers and blast radius.
+- Selecting a service can show its dependency path and provider chain.
+- Registered-only repos are visible as onboarding gaps rather than noise.
+
+### T05 - Verification And Documentation
+
+```task
+id: RAIL-FAB-WP-0008-T05
+status: todo
+priority: medium
+state_hub_task_id: "64fe53f1-fbea-4624-8f52-1b5e2a27cf67"
+```
+
+Verify the map against seeded registry data, document usage, and capture
+follow-on data quality gaps.
+
+Acceptance notes:
+
+- Verify against the local registry after `registry/local-repos.yaml` onboarding.
+- Include at least one automated projection/API test and one UI smoke test.
+- Document how to launch the map and how to refresh the underlying registry
+  data.