---
id: capability.infotech.core-hub
name: Core Hub Production Interaction Framework
summary: Contract-first framework for cross-domain state, agent coordination, evidence, registries, workplans, and operator interaction surfaces.
owner: core-hub
status: draft
domain: infotech
tags:
  - interaction-framework
  - state-hub
  - inter-hub-successor
  - agent-coordination
  - registry
  - api

maturity:
  discovery:
    current: D3
    target: D5
    confidence: medium
    rationale: >
      Intent, scope, lineage research, and initial specs are documented. Detailed
      API and data contracts are planned but not yet implemented.
  availability:
    current: A1
    target: A5
    confidence: medium
    rationale: >
      Early FastAPI/Postgres scaffold exists under src/core_hub/ (app, /api/v2 module,
      migrations, operator CLI) with a pytest suite, but production cutover and Inter-Hub
      compatibility evidence are not yet complete.

external_evidence:
  completeness:
    level: C1
    confidence: medium
    basis: initial_spec_seed
    satisfied_expectations:
      - intent and scope documents
      - lineage and platform reset research artifact
      - specification map
      - staged workplans
      - early FastAPI scaffold (src/core_hub/) and pytest suite
    broken_expectations:
      - production cutover and Inter-Hub /api/v2 compatibility evidence not yet complete
    out_of_scope_expectations:
      - direct secret custody
      - owning every downstream domain hub implementation
  reliability:
    level: R1
    confidence: medium
    basis: early_scaffold_not_cutover
    known_reliability_risks:
      - Inter-Hub compatibility must be proven before cutover
      - data migration and API auth semantics require careful operator evidence
      - Haskell retirement must wait until replacement runtime is live

discovery:
  intent: >
    Provide the third-generation production interaction substrate for Coulomb,
    preserving the valuable State Hub and Inter-Hub semantics while replacing the
    Haskell/IHP implementation path with a lighter contract-first platform.
  includes:
    - framework contract and IR documentation
    - API and event model specs
    - early FastAPI /api/v2 scaffold (src/core_hub/)
    - workplan, progress, task, message, and decision coordination model
    - operator UI and component surface planning
    - migration and compatibility planning
  excludes:
    - direct credential vending
    - unrelated downstream app runtimes
    - retiring Inter-Hub before compatible replacement evidence exists
  assumptions:
    - existing consumers can tolerate stable `/api/v2` compatibility during transition
    - State Hub remains available while Core Hub is built
    - workplans remain canonical in repo files until Core Hub intentionally changes that model
  use_cases:
    - publish domain hub manifests and capabilities
    - emit interaction and evidence events
    - coordinate agent-visible workplans and progress
    - expose operator console surfaces
  research_memos:
    - docs/research/2026-06-27-core-hub-lineage-and-platform-reset.md

availability:
  current_level: A1
  target_level: A5
  current_artifacts:
    - INTENT.md
    - SCOPE.md
    - docs/specs/README.md
    - workplans/
    - src/core_hub/ (FastAPI app, /api/v2, migrations, operator CLI)
  consumption_modes:
    - informational
    - planning
    - cli

relations:
  depends_on:
    - capability.infotech.hub-core-library
  supports:
    - capability.registry.register
  related_to:
    - capability.infotech.hub-core-library
    - capability.statehub.workstream-coordinate
    - capability.infotech.interaction-hub-framework
    - capability.design.whynot-system

evidence:
  documentation:
    - INTENT.md
    - SCOPE.md
    - docs/research/2026-06-27-core-hub-lineage-and-platform-reset.md
    - docs/specs/README.md
  tests:
    - tests/ (22 tests collected 2026-07-07)

consumer_guidance:
  recommended_for:
    - planning new domain hub integrations
    - replacing Inter-Hub Haskell/IHP consumers through a compatibility layer
    - centralizing agent/operator interaction contracts
  not_recommended_for:
    - production cutover before compatibility and migration evidence exists
    - secret custody or credential handoff flows
  known_limitations:
    - production cutover and Inter-Hub compatibility not proven yet (early scaffold only)
    - compatibility contract is seeded but not frozen
---

# Core Hub Production Interaction Framework

Core Hub is the third-generation interaction framework for Coulomb / Helixforge. It keeps the State Hub and Inter-Hub lessons while moving the implementation path to a practical contract-first platform.