core-hub/SCOPE.md

SCOPE

Boundary for agents and contributors working in Core Hub.

One-Liner

Core Hub is the 3rd-generation production interaction framework for Coulomb / Helixforge.

Core Idea

Core Hub replaces the Haskell/IHP Inter-Hub implementation with a contract-first Python/FastAPI/Postgres framework for cross-domain state, agent coordination, evidence, registry facts, workplans, and operator interaction surfaces.

In Scope

• Core Hub intent, research, specs, and implementation workplans
• Contract/IR definition for hubs, manifests, widgets, events, tasks, progress, messages, decisions, and registry facts
• FastAPI/Postgres implementation planning and eventual service code
• Inter-Hub /api/v2 compatibility where existing consumers depend on it
• Data migration and production cutover planning from Inter-Hub
• Operator UI and whynot-design aligned component/adaptor planning
• Haskell/IHP retirement planning after replacement evidence exists

Out of Scope

• Continuing to act as a generic repo template
• Owning every downstream domain hub implementation
• Storing or vending secrets directly
• Rewriting unrelated consumers before the Core Hub compatibility contract exists
• Retiring production Inter-Hub before migration and smoke evidence exists

Non-Goals

• Recreate IHP abstractions in Python
• Bind the UI contract to React or any single frontend framework
• Make State Hub disappear before Core Hub proves a compatible replacement path