state-hub/SCOPE.md

# 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.
docs: establish state hub baseline 2026-05-17 18:54:57 +02:00			`# SCOPE`

			`## One-Liner`

feat(classification-spine): implement STATE-WP-0065 repo-anchored model Replace the ad-hoc coordination-domain spine with the Repo Classification Standard: 14 market domains, classification columns on managed_repos, and workplans anchored by repo_id (topic_id optional). - Add Alembic migration d8e9f0a1b2c3 with data backfill and workstream→workplan rename - Add api/classification.py validation and register-from-classification tooling - Expose workplan-first REST/MCP surface with legacy workstream aliases - Add C-24 consistency rule and legacy domain frontmatter mapping - Update dashboard repos page with category/capability/stake filters - Update orientation docs; mark STATE-WP-0065 finished 2026-06-22 13:52:13 +02:00			`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.`
docs: establish state hub baseline 2026-05-17 18:54:57 +02:00
			`## In Scope`

			`- State Hub FastAPI service`
			`- PostgreSQL schema and Alembic migrations`
			`- FastMCP server and tool reference`
			`- Observable dashboard`
feat(classification-spine): implement STATE-WP-0065 repo-anchored model Replace the ad-hoc coordination-domain spine with the Repo Classification Standard: 14 market domains, classification columns on managed_repos, and workplans anchored by repo_id (topic_id optional). - Add Alembic migration d8e9f0a1b2c3 with data backfill and workstream→workplan rename - Add api/classification.py validation and register-from-classification tooling - Expose workplan-first REST/MCP surface with legacy workstream aliases - Add C-24 consistency rule and legacy domain frontmatter mapping - Update dashboard repos page with category/capability/stake filters - Update orientation docs; mark STATE-WP-0065 finished 2026-06-22 13:52:13 +02:00			`- repo registration (classification-driven) and consistency synchronization`
			- repo classification spine (14 market domains, `.repo-classification.yaml`)
docs: establish state hub baseline 2026-05-17 18:54:57 +02:00			`- task-flow engine and flow definitions`
Finish CUST-WP-0011 and implement STATE-WP-0061 suggestion backlog. Add persisted Suggestion entities with WSJF ranking, relevance bumps, REST/MCP write surfaces, /suggestions dashboard page, and daily triage digest integration. Document the cluster operating model, archive the completed migration workplan, and seed WARDEN-WP-0012 routing scenarios. 2026-07-06 10:52:49 +02:00			`- SBOM, contribution, capability, demand-weighted suggestion backlog, TPSC, DoI,`
			`token, and interface-change tracking`
docs: establish state hub baseline 2026-05-17 18:54:57 +02:00			`- State Hub tests, operational docs, policies, prompts, and local infra`

docs(ecosystem): boundary alignment and route audit (STATE-WP-0074) Add ecosystem position to INTENT/SCOPE/README, publish hub-ecosystem-route-audit, update workstream-coordinate capability relations, and record legacy-meter weekly review evidence. 2026-07-11 01:26:53 +02:00			`## 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.

docs: establish state hub baseline 2026-05-17 18:54:57 +02:00			`## Out Of Scope`

			`- Custodian canon and constitution content`
docs(ecosystem): boundary alignment and route audit (STATE-WP-0074) Add ecosystem position to INTENT/SCOPE/README, publish hub-ecosystem-route-audit, update workstream-coordinate capability relations, and record legacy-meter weekly review evidence. 2026-07-11 01:26:53 +02:00			- Inter-Hub `/api/v2` framework routes (owned by `core-hub`)
docs: establish state hub baseline 2026-05-17 18:54:57 +02:00			`- 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`

docs: clarify state hub intent 2026-05-17 21:37:02 +02:00			`## Extraction Note`
docs: establish state hub baseline 2026-05-17 18:54:57 +02:00
docs: clarify state hub intent 2026-05-17 21:37:02 +02:00			`This repo is the standalone State Hub home. It was extracted under`
			`CUST-WP-0043` from:
docs: establish state hub baseline 2026-05-17 18:54:57 +02:00
			```text
			`/home/worsch/the-custodian/state-hub`
			```

docs: clarify state hub intent 2026-05-17 21:37:02 +02:00			`This repository is authoritative for State Hub implementation work. The`
			embedded path in `the-custodian` is now a pointer only.
docs: establish state hub baseline 2026-05-17 18:54:57 +02:00
			`## Workplan Convention`

Normalize workplan IDs and activate parents on task start 2026-05-23 16:31:28 +02:00			New State Hub-local workplans use `STATE-WP-####`.
docs: establish state hub baseline 2026-05-17 18:54:57 +02:00
			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.`