coulomb/state-hub
4
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
state-hub/SCOPE.md
tegwick 90447b4258
All checks were successful
CI Smoke / host-smoke (push) Successful in 0s
Details
CI Smoke / container-smoke (push) Successful in 3s
Details
Build and Publish Multi-Context Image / build-and-push (push) Successful in 1m53s
Details
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

2.1 KiB
Raw Blame History

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:

/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.