state-hub/docs/hub-ecosystem-route-audit.md

47 lines
1.8 KiB
Markdown
Raw Permalink Normal View History

# 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.