docs(ecosystem): boundary alignment and route audit (STATE-WP-0074)
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

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

View file

@ -1,12 +1,12 @@
{
"captured_at": "2026-07-10T08:41:39.545851+00:00",
"captured_at": "2026-07-10T14:00:04.095849+00:00",
"api_base": "http://127.0.0.1:8000",
"workplan": "STATE-WP-0070",
"retired_interfaces": [],
"weekly_review": {
"generated_at": "2026-07-10T08:41:39.539347Z",
"window_start": "2026-07-10T00:41:39.467344Z",
"window_end": "2026-07-10T08:41:39.467344Z",
"generated_at": "2026-07-10T14:00:04.090501Z",
"window_start": "2026-07-10T06:00:04.038834Z",
"window_end": "2026-07-10T14:00:04.038834Z",
"cadence": "weekly",
"activity_core_handoff": {
"activity_id": "statehub-legacy-interface-review",
@ -61,6 +61,237 @@
"retirement_candidate": false,
"retirement_reason": "already retired"
},
{
"interface": {
"id": "63ed90e3-42b4-431a-94db-e1254a52f9e2",
"interface_key": "mcp:create_workstream",
"interface_kind": "mcp_tool",
"legacy_since": "2026-07-10T13:19:44.205900Z",
"replacement_ref": "create_workplan",
"owner_component": "state-hub.mcp",
"status": "legacy",
"replacement_verified": true,
"manual_hold": false,
"hold_reason": null,
"notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
"retired_at": null,
"created_at": "2026-07-10T13:19:44.205900Z",
"updated_at": "2026-07-10T13:19:44.205900Z"
},
"all_time": {
"calls": 2,
"tenant_count": 1,
"user_count": 1,
"component_count": 1,
"tenants": {
"unknown": 2
},
"users": {
"unknown": 2
},
"components": {
"state-hub.mcp": 2
}
},
"window": {
"calls": 2,
"tenant_count": 1,
"user_count": 1,
"component_count": 1,
"tenants": {
"unknown": 2
},
"users": {
"unknown": 2
},
"components": {
"state-hub.mcp": 2
}
},
"last_seen_at": "2026-07-10T13:20:43.378546Z",
"retirement_candidate": false,
"retirement_reason": "2 call(s) in review window"
},
{
"interface": {
"id": "b6a5fe44-fb85-4ef7-a273-78d09da777af",
"interface_key": "mcp:list_workstreams",
"interface_kind": "mcp_tool",
"legacy_since": "2026-07-10T13:19:26.075491Z",
"replacement_ref": "list_workplans",
"owner_component": "state-hub.mcp",
"status": "legacy",
"replacement_verified": true,
"manual_hold": false,
"hold_reason": null,
"notes": null,
"retired_at": null,
"created_at": "2026-07-10T13:19:26.075491Z",
"updated_at": "2026-07-10T13:19:26.075491Z"
},
"all_time": {
"calls": 2,
"tenant_count": 1,
"user_count": 1,
"component_count": 1,
"tenants": {
"unknown": 2
},
"users": {
"unknown": 2
},
"components": {
"state-hub.mcp": 2
}
},
"window": {
"calls": 2,
"tenant_count": 1,
"user_count": 1,
"component_count": 1,
"tenants": {
"unknown": 2
},
"users": {
"unknown": 2
},
"components": {
"state-hub.mcp": 2
}
},
"last_seen_at": "2026-07-10T13:20:42.374940Z",
"retirement_candidate": false,
"retirement_reason": "2 call(s) in review window"
},
{
"interface": {
"id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
"interface_key": "mcp:update_workstream",
"interface_kind": "mcp_tool",
"legacy_since": "2026-07-10T13:19:44.255216Z",
"replacement_ref": "update_workplan",
"owner_component": "state-hub.mcp",
"status": "legacy",
"replacement_verified": true,
"manual_hold": false,
"hold_reason": null,
"notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
"retired_at": null,
"created_at": "2026-07-10T13:19:44.255216Z",
"updated_at": "2026-07-10T13:19:44.255216Z"
},
"all_time": {
"calls": 0,
"tenant_count": 0,
"user_count": 0,
"component_count": 0,
"tenants": {},
"users": {},
"components": {}
},
"window": {
"calls": 0,
"tenant_count": 0,
"user_count": 0,
"component_count": 0,
"tenants": {},
"users": {},
"components": {}
},
"last_seen_at": null,
"retirement_candidate": true,
"retirement_reason": "no measured usage in review window"
},
{
"interface": {
"id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
"interface_key": "mcp:update_workstream_status",
"interface_kind": "mcp_tool",
"legacy_since": "2026-07-10T13:19:44.303612Z",
"replacement_ref": "update_workplan_status",
"owner_component": "state-hub.mcp",
"status": "legacy",
"replacement_verified": true,
"manual_hold": false,
"hold_reason": null,
"notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
"retired_at": null,
"created_at": "2026-07-10T13:19:44.303612Z",
"updated_at": "2026-07-10T13:19:44.303612Z"
},
"all_time": {
"calls": 0,
"tenant_count": 0,
"user_count": 0,
"component_count": 0,
"tenants": {},
"users": {},
"components": {}
},
"window": {
"calls": 0,
"tenant_count": 0,
"user_count": 0,
"component_count": 0,
"tenants": {},
"users": {},
"components": {}
},
"last_seen_at": null,
"retirement_candidate": true,
"retirement_reason": "no measured usage in review window"
},
{
"interface": {
"id": "46900dc2-0893-405b-ba59-80f31fb6ebb1",
"interface_key": "state://workstreams/{topic_slug}",
"interface_kind": "mcp_tool",
"legacy_since": "2026-07-10T13:19:44.344493Z",
"replacement_ref": "state://workplans/{topic_slug}",
"owner_component": "state-hub.mcp",
"status": "legacy",
"replacement_verified": true,
"manual_hold": false,
"hold_reason": null,
"notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
"retired_at": null,
"created_at": "2026-07-10T13:19:44.344493Z",
"updated_at": "2026-07-10T13:19:44.344493Z"
},
"all_time": {
"calls": 1,
"tenant_count": 1,
"user_count": 1,
"component_count": 1,
"tenants": {
"unknown": 1
},
"users": {
"unknown": 1
},
"components": {
"state-hub.mcp": 1
}
},
"window": {
"calls": 1,
"tenant_count": 1,
"user_count": 1,
"component_count": 1,
"tenants": {
"unknown": 1
},
"users": {
"unknown": 1
},
"components": {
"state-hub.mcp": 1
}
},
"last_seen_at": "2026-07-10T13:20:34.491811Z",
"retirement_candidate": false,
"retirement_reason": "1 call(s) in review window"
},
{
"interface": {
"id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",
@ -654,6 +885,84 @@
}
],
"retirement_candidates": [
{
"interface": {
"id": "53c3372b-307d-4d6a-8ea4-bc36cacdcaf2",
"interface_key": "mcp:update_workstream",
"interface_kind": "mcp_tool",
"legacy_since": "2026-07-10T13:19:44.255216Z",
"replacement_ref": "update_workplan",
"owner_component": "state-hub.mcp",
"status": "legacy",
"replacement_verified": true,
"manual_hold": false,
"hold_reason": null,
"notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
"retired_at": null,
"created_at": "2026-07-10T13:19:44.255216Z",
"updated_at": "2026-07-10T13:19:44.255216Z"
},
"all_time": {
"calls": 0,
"tenant_count": 0,
"user_count": 0,
"component_count": 0,
"tenants": {},
"users": {},
"components": {}
},
"window": {
"calls": 0,
"tenant_count": 0,
"user_count": 0,
"component_count": 0,
"tenants": {},
"users": {},
"components": {}
},
"last_seen_at": null,
"retirement_candidate": true,
"retirement_reason": "no measured usage in review window"
},
{
"interface": {
"id": "bed4d08a-3471-48f5-9f0e-f9d550383a26",
"interface_key": "mcp:update_workstream_status",
"interface_kind": "mcp_tool",
"legacy_since": "2026-07-10T13:19:44.303612Z",
"replacement_ref": "update_workplan_status",
"owner_component": "state-hub.mcp",
"status": "legacy",
"replacement_verified": true,
"manual_hold": false,
"hold_reason": null,
"notes": "Registered by STATE-WP-0070 T03 \u2014 zero-window streak starts at registration",
"retired_at": null,
"created_at": "2026-07-10T13:19:44.303612Z",
"updated_at": "2026-07-10T13:19:44.303612Z"
},
"all_time": {
"calls": 0,
"tenant_count": 0,
"user_count": 0,
"component_count": 0,
"tenants": {},
"users": {},
"components": {}
},
"window": {
"calls": 0,
"tenant_count": 0,
"user_count": 0,
"component_count": 0,
"tenants": {},
"users": {},
"components": {}
},
"last_seen_at": null,
"retirement_candidate": true,
"retirement_reason": "no measured usage in review window"
},
{
"interface": {
"id": "cd9342fd-27e7-4a46-a1be-d41499e106a3",

File diff suppressed because it is too large Load diff

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.