# SCOPE

## One-Liner

State Hub is the local-first coordination service for repo-anchored workplans,
tasks, decisions, progress events, repo classification and metadata, MCP
tooling, and dashboard telemetry.

## In Scope

- State Hub FastAPI service
- PostgreSQL schema and Alembic migrations
- FastMCP server and tool reference
- Observable dashboard
- repo registration (classification-driven) and consistency synchronization
- repo classification spine (14 market domains, `.repo-classification.yaml`)
- task-flow engine and flow definitions
- SBOM, contribution, capability, demand-weighted suggestion backlog, TPSC, DoI,
  token, and interface-change tracking
- State Hub tests, operational docs, policies, prompts, and local infra

## Ecosystem position

| Repo | Role |
| --- | --- |
| `hub-core` | Shared library — State Hub mounts router factories and MCP from `hub_core` |
| `state-hub` | This repo — dev coordination host, workplan file authority |
| `core-hub` | Production framework — `/api/v2` at `hub.coulomb.social`; does not replace State Hub dev MCP |

Canon: `/home/worsch/the-custodian/docs/hub-ecosystem-architecture.md`

State Hub does **not** implement Inter-Hub `/api/v2` routes; those belong to core-hub.

## Out Of Scope

- Custodian canon and constitution content
- Inter-Hub `/api/v2` framework routes (owned by `core-hub`)
- non-State-Hub domain implementation work
- external publication or legal/financial commitments
- plaintext secrets
- generic hub-core extraction unless a dedicated workplan owns it
- renaming State Hub to Dev Hub unless a dedicated workplan owns it

## Extraction Note

This repo is the standalone State Hub home. It was extracted under
`CUST-WP-0043` from:

```text
/home/worsch/the-custodian/state-hub
```

This repository is authoritative for State Hub implementation work. The
embedded path in `the-custodian` is now a pointer only.

## Workplan Convention

New State Hub-local workplans use `STATE-WP-####`.

Migrated legacy State Hub workplans may temporarily retain `CUST-WP-####`
identifiers when preserving existing State Hub workstream and task IDs is the
least confusing path.
