---
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: "7bddf82c-82bc-4abe-8060-046c62eefc23"
---

# 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: "4e028511-b1ec-472e-a34d-e0701c3281c2"
```

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: "609fa167-e3e0-486f-8c10-9d65c419ada0"
```

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: "4f2bbf15-bb0f-4224-b619-04db33a8fbab"
```

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: "a9c26e95-b5cb-4cda-9fd7-050dd195794c"
```

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: "047805fa-2302-4ad3-b2be-c2b0a48454df"
```

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.