---
id: STATE-WP-0074
type: workplan
title: "Hub ecosystem boundary alignment"
domain: infotech
repo: state-hub
status: finished
owner: codex
topic_slug: infotech
created: "2026-07-09"
updated: "2026-07-11"
state_hub_workstream_id: "3977ba44-f470-56df-bc03-7d4201cba1ac"
---

# Hub ecosystem boundary alignment

Parent: `~/the-custodian/workplans/CUST-WP-0057-hub-ecosystem-consolidation.md`

## Goal

Document State Hub's role in the three-repo stack and prevent route/model drift
toward core-hub framework surfaces.

## Route audit

```task
id: STATE-WP-0074-T01
status: done
priority: high
state_hub_task_id: "3b4c32ce-4f0b-5f04-a165-556db062a3ca"
```

Publish `docs/hub-ecosystem-route-audit.md` classifying hub-core factory vs
dev-hub-only vs core-hub-exclusive routes.

Done 2026-07-09.

## Cross-hub read API decision

```task
id: STATE-WP-0074-T02
status: done
priority: medium
state_hub_task_id: "cfd81160-1c40-5922-9124-0b4c39c95030"
```

Record deferral: core-hub does not duplicate progress/message tables in
CUST-WP-0057 initial slice. Future ingestion via authenticated read APIs if
operator console needs live dev coordination data.

Decision documented in route audit and `hub-ecosystem-architecture.md`.

## Ecosystem docs in INTENT/SCOPE

```task
id: STATE-WP-0074-T03
status: done
priority: high
state_hub_task_id: "2e790571-c183-5b95-aec0-38840ed4e151"
```

Add ecosystem position sections to `INTENT.md` and `SCOPE.md`.

Done 2026-07-09.

## Confirm no /api/v2 growth

```task
id: STATE-WP-0074-T04
status: done
priority: high
state_hub_task_id: "10c1cd9b-27af-5a74-ac36-88843900a7a3"
```

Verify `api/main.py` does not mount Inter-Hub `/api/v2` routes. Document in
route audit.

Done 2026-07-09: no `/api/v2` in state-hub.

## Cross-repo smoke documentation

```task
id: STATE-WP-0074-T05
status: done
priority: medium
state_hub_task_id: "2e417a49-dff4-5b0c-a8f3-c9297683e2ea"
```

Add `make ecosystem-regression` target or README pointer to
`the-custodian/scripts/hub-ecosystem-regression.sh`.

Done 2026-07-09: README glossary and regression script pointer added.