coulomb/core-hub
4
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
core-hub/README.md
tegwick f6758b91ce
Some checks failed
CI Smoke / host-smoke (push) Successful in 0s
Details
CI Smoke / pytest-smoke (push) Failing after 2s
Details
Build and Publish Container Image / build-and-push (push) Successful in 19s
Details
feat: add migration export and write fencing
2026-08-21 17:07:53 +02:00

2.9 KiB
Raw Blame History

Core Hub

Core Hub is the 3rd-generation Production Interaction Framework for Coulomb / Helixforge.

Hub stack glossary

Name Role
hub-core Shared library — hub_core utils, models, router factories
state-hub Dev coordination — file-first workplans, agent MCP
core-hub This repo — production /api/v2 framework

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

It carries forward the lessons from State Hub and Inter-Hub: workplans and progress need to be durable, domains need typed ways to publish state and evidence, operators need a coherent console, and agents need APIs that are predictable enough to automate against. The rebuild moves that intent onto a lighter production platform.

Generations

  • Gen 1: state-hub - file-backed workplans, tasks, progress, messages, and read-model synchronization.
  • Gen 2: inter-hub - the integrated hub framework idea: manifests, widgets, registries, events, API consumers, and a shared UI, implemented in Haskell/IHP.
  • Gen 3: core-hub - the same framework ambition rebuilt contract-first on the natural Coulomb stack.

Initial Stack Direction

  • Python 3.12
  • FastAPI and Pydantic v2
  • SQLAlchemy async, Alembic, asyncpg, Postgres
  • pytest and contract fixtures
  • OpenAPI and JSON Schema for public contracts
  • whynot-design aligned UI components/adapters where operator UI is needed
  • Docker/Kubernetes/ArgoCD on the normal Railiance platform path

Key Documentation

  • INTENT.md - purpose, lineage, principles, and platform direction
  • STATE.md - current production truth, open work, and known conditions
  • SCOPE.md - repo boundary
  • Research artifact - what we learned from State Hub, Inter-Hub, Haskell/IHP, and whynot-design
  • Specs index - contract and implementation specification map
  • Workplans - staged implementation plan using ADR-001 workplan files

Current Work

The contract, FastAPI/Postgres foundation, Inter-Hub migration, Haskell/IHP retirement, and relocation from CoulombCore to railiance01 are complete. CORE-WP-0011 is finished. The only open local workplan is runtime absorption and eventual archive (CORE-WP-0010). Its dual-run design is recorded and S0 is active against published hub-core revision 7e1ec03, building the durable backend and internal candidate before any public traffic changes.

Operational migration bundles are emitted without raw key material:

core-hub-ops migration export --source-revision "$(git rev-parse HEAD)" \
  --output core-hub-export.json

CORE_HUB_V2_WRITE_GROUPS controls legacy write authority for registry, credentials, interaction, and deferred. The deployment package must remove a group here before enabling the matching hub-core writer.