This repository has been archived on 2026-07-08. You can view files and clone it. You cannot open issues or pull requests or push a commit.
Files
core-hub/workplans/CORE-WP-0002-contract-ir-freeze.md

62 lines
1.8 KiB
Markdown

---
id: CORE-WP-0002
type: workplan
title: "Freeze Core Hub contract and IR"
domain: infotech
repo: core-hub
status: finished
owner: codex
topic_slug: custodian
created: "2026-06-27"
updated: "2026-06-27"
state_hub_workstream_id: "d3f0f41e-5029-4064-8f0b-26f2f36d883b"
---
# Freeze Core Hub contract and IR
Extract the canonical framework contract from State Hub, Inter-Hub, ops-hub, activity-core, and whynot-design lessons before implementing runtime code.
## Inventory Legacy Contracts
```task
id: CORE-WP-0002-T01
status: done
priority: high
state_hub_task_id: "20b45f1d-76af-4dde-903c-76be97e33169"
```
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: done
priority: high
state_hub_task_id: "010604c8-b71e-4611-bd48-07eaaec50651"
```
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: done
priority: high
state_hub_task_id: "819c2d8e-c232-4390-98b6-ff37df592c4c"
```
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: done
priority: medium
state_hub_task_id: "327e086d-5d56-4f72-bfdf-ce3b66fff15e"
```
Result 2026-06-27: Added `docs/specs/contract-governance.md` with contract-change rules, compatibility note expectations, and regular self-optimization review guidance.