Record Core Hub replacement evidence handoff
This commit is contained in:
91
docs/core-hub-replacement-evidence.md
Normal file
91
docs/core-hub-replacement-evidence.md
Normal file
@@ -0,0 +1,91 @@
|
||||
# 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.
|
||||
|
||||
Reference in New Issue
Block a user