Start Core Hub FastAPI replacement foundation

This commit is contained in:
2026-06-27 11:41:26 +02:00
parent 75963233b6
commit 1e87adbcbb
37 changed files with 3292 additions and 30 deletions

View File

@@ -4,7 +4,7 @@ type: workplan
title: "Freeze Core Hub contract and IR"
domain: infotech
repo: core-hub
status: ready
status: finished
owner: codex
topic_slug: custodian
created: "2026-06-27"
@@ -20,42 +20,42 @@ Extract the canonical framework contract from State Hub, Inter-Hub, ops-hub, act
```task
id: CORE-WP-0002-T01
status: todo
status: done
priority: high
state_hub_task_id: "20b45f1d-76af-4dde-903c-76be97e33169"
```
Inventory Inter-Hub routes, schemas, migrations, fixtures, registries, auth behavior, and current consumer expectations. Record the inventory under `docs/specs/` with links to source repos.
Result 2026-06-27: Added `docs/specs/interhub-legacy-inventory.md` covering the initial Inter-Hub route surface, protected/public split, known consumers, migration sources, and compatibility risk.
## Define Core Hub IR Artifacts
```task
id: CORE-WP-0002-T02
status: todo
status: done
priority: high
state_hub_task_id: "010604c8-b71e-4611-bd48-07eaaec50651"
```
Create initial OpenAPI, JSON Schema, event catalog, widget catalog, hub manifest schema, and fixture structure. The IR must be implementation-neutral and adapter-friendly.
Result 2026-06-27: Added `contracts/` with JSON Schema, event/widget/policy catalogs, fixtures, and generated OpenAPI snapshot. The FastAPI implementation now exposes the initial contract surface from code.
## Capture Compatibility Fixtures
```task
id: CORE-WP-0002-T03
status: todo
status: done
priority: high
state_hub_task_id: "819c2d8e-c232-4390-98b6-ff37df592c4c"
```
Create production-safe request/response fixtures for public and protected `/api/v2` surfaces used by ops-hub and activity-core. Include auth/error fixtures without secrets.
Result 2026-06-27: Added production-safe `/api/v2` fixtures for public hubs/manifests and protected unauthorized behavior. No secrets are stored in fixtures.
## Record Contract Governance
```task
id: CORE-WP-0002-T04
status: todo
status: done
priority: medium
state_hub_task_id: "327e086d-5d56-4f72-bfdf-ce3b66fff15e"
```
Document how contracts change, how compatibility notes are written, and how consumers are notified.
Result 2026-06-27: Added `docs/specs/contract-governance.md` with contract-change rules, compatibility note expectations, and regular self-optimization review guidance.