Files
the-custodian/docs/core-hub-replacement-evidence.md

4.6 KiB

Core Hub Replacement Evidence Handoff

Date: 2026-06-27

Related workplans: CUST-WP-0052, CUST-WP-0025, CUST-WP-0047, CUST-WP-0049, CORE-WP-0008, CORE-WP-0004, CORE-WP-0005, CORE-WP-0007.

Current Evidence

Core Hub now has the API-first replacement lane needed to stop expanding the old Inter-Hub-first ops-hub path:

  • CORE-WP-0008-T02: repeatable deployed-smoke harness exists through make deployed-smoke. It probes health/readiness, OpenAPI compatibility, public catalogs, protected-route 401 behavior, operator auth, ops-hub bootstrap-equivalent creation, widget/event write, key-prefix evidence, and hub-registry visibility. It was verified against a disposable local HTTP Core Hub runtime, not a live staging endpoint.
  • CORE-WP-0008-T03: activity-core has a direct Core Hub core-hub-interaction-event sink, verified locally against a disposable Core Hub runtime. Deployed execution still needs CORE_HUB_BASE_URL, runtime key, and widget mapping from approved custody.
  • CORE-WP-0008-T04: staging deployment profile, Kubernetes manifests, migration job shape, secret references, health/readiness probes, rollback notes, and container build checks are documented.
  • CORE-WP-0008-T05: make operator-cli wraps the same API behavior for deployed smoke, ops-hub bootstrap status, migration validate/import, and cutover readiness summaries.
  • CORE-WP-0008-T06: the web UI is gated behind API/CLI readiness and has a compact whynot-aligned first-screen backlog. The UI should not start by recreating every old Inter-Hub screen.

No live deployed smoke report was available in this session. Therefore there are no deployed Core Hub smoke ids/counts to claim yet. The next live report should record only non-secret fields: runId, hub id/slug/status, manifest id/status, API consumer id/status/key prefix, widget count, interaction event id/type, and hub-registry containment booleans.

0047 And 0049 Decision

CUST-WP-0047-T05 should remain wait as the legacy Inter-Hub evidence record. Do not close it from local Core Hub evidence alone. It can close later through a Core Hub deployed compatibility/evidence smoke or an explicit supersede decision that states the legacy production widget activation is no longer required.

CUST-WP-0049-T06 should remain wait as the legacy/fallback access routine. Do not request Inter-Hub operator keys or new ops-warden work for the preferred replacement lane. Use it only if the operator deliberately chooses legacy Inter-Hub bootstrap or rollback validation.

CUST-WP-0025 Phase 3 Reset Recommendation

CUST-WP-0025-T13 through T19 should be rewritten before execution:

  • T13: replace "create standalone ops-hub repo" with Core Hub-owned API-first ops evidence and registry work. Defer any standalone ops-hub repo until after Core Hub cutover proves the boundary still needs a separate service.
  • T14: replace standalone ops-specific models with Core Hub resources and migration/read-model gaps, preserving CUST-WP-0047 service inventory as input evidence.
  • T15: replace MCP-first ops tools with API and CLI parity first. Any MCP layer should consume the proven Core Hub API later.
  • T16: route infrastructure evidence through activity-core probes and Core Hub interaction/deployment evidence, with credential ownership resolved through approved custody routes rather than chat or workplans.
  • T17: reframe cross-hub coupling around Core Hub events, State Hub progress, and activity-core evidence sinks. Keep NATS as a later transport decision.
  • T18: replace the old dashboard task with the whynot-aligned Core Hub operator UI backlog from CORE-WP-0008-T06.
  • T19: cancel or defer ops-hub MCP server registration until post-cutover demand proves it is needed.

This is enough to rewrite CUST-WP-0025 safely, but not enough to declare Core Hub production cutover complete.

Remaining Gates

  • Run make deployed-smoke or make operator-cli CLI_ARGS="deployed-smoke ..." against a real Core Hub staging URL with an approved operator token.
  • Import the approved Inter-Hub export bundle into a staging Core Hub database and keep dry-run reports visibly open until a reviewed non-dry-run import succeeds.
  • Run the deployed activity-core Core Hub sink smoke with approved runtime token and widget mapping.
  • Build a readiness-summary evidence report from deployed smoke, migration, activity-core, and optional legacy Inter-Hub reference evidence.
  • Keep CORE-WP-0007 Haskell retirement blocked until staging import, dual-run smokes, cutover, rollback notes, and operator approval are complete.