coulomb/state-hub
4
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

docs(ecosystem): boundary alignment and route audit (STATE-WP-0074)
All checks were successful
CI Smoke / host-smoke (push) Successful in 0s
Details
CI Smoke / container-smoke (push) Successful in 3s
Details
Build and Publish Multi-Context Image / build-and-push (push) Successful in 1m53s
Details

Browse source 
Add ecosystem position to INTENT/SCOPE/README, publish hub-ecosystem-route-audit,
update workstream-coordinate capability relations, and record legacy-meter
weekly review evidence.
This commit is contained in:
tegwick 2026-07-11 01:26:53 +02:00
parent 54577cd847
commit 90447b4258
9 changed files with 2164 additions and 6 deletions
Download patch file Download diff file Expand all files Collapse all files

47
docs/hub-ecosystem-route-audit.md Normal file
View file

@ -0,0 +1,47 @@
# 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.