tegwick
0709262ffd
Import slugify_or_default from hub-core, add contract tests, vendor hub-core in Docker/Forgejo CI, document metadata isolation and pagination deferral, and align INTENT/SCOPE with three-repo stack.
135 lines
4.6 KiB
Markdown
135 lines
4.6 KiB
Markdown
---
|
|
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.
|