core-hub/workplans/CORE-WP-0002-contract-ir-freeze.md

---
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.