state-hub/docs/hub-ecosystem-route-audit.md
tegwick 90447b4258
All checks were successful
CI Smoke / host-smoke (push) Successful in 0s
CI Smoke / container-smoke (push) Successful in 3s
Build and Publish Multi-Context Image / build-and-push (push) Successful in 1m53s
docs(ecosystem): boundary alignment and route audit (STATE-WP-0074)
Add ecosystem position to INTENT/SCOPE/README, publish hub-ecosystem-route-audit,
update workstream-coordinate capability relations, and record legacy-meter
weekly review evidence.
2026-07-11 01:26:53 +02:00

1.8 KiB

Hub Ecosystem Route Audit

Updated: 2026-07-09
Workplan: STATE-WP-0074-T01


hub-core factory routes (shared primitives)

Mounted from hub_core.routers with State Hub models injected:

Router module Prefix / paths Owner
domains /domains/ hub-core factory
repos /repos/ (registry subset) hub-core factory
messages /messages/ hub-core factory
progress /progress/ hub-core factory
capability_requests /capability-requests/ (catalog + read; write via factory) hub-core factory
tpsc /tpsc/ hub-core factory
policy /policy/ hub-core factory

state-hub-only routes (dev coordination)

Router module Domain
topics, workstreams, tasks, decisions Workplan coordination
workstream_dependencies Workplan graph
consistency_sweep, reconciliation File sync
contributions, sbom, token_events Engineering telemetry
suggestions, flows, execution Task factory / triage
domain_goals, repo_goals, extension_points, technical_debt Planning
interface_changes, fabric, legacy_meter Spine / metering
state, recently_on_scope Dashboard loaders
services Service catalog (beyond TPSC)

Not in state-hub (core-hub exclusive)

Inter-Hub /api/v2 surfaces: hubs, hub-capability-manifests, api-consumers, widgets, interaction-events, operator console.

State Hub must not grow these routes; ops-hub and activity-core consumers target hub.coulomb.social (core-hub).

Future cross-hub read APIs (deferred, STATE-WP-0074-T02)

Optional authenticated read endpoints for core-hub to ingest progress/messages without duplicating tables. Not implemented in CUST-WP-0057 initial slice.