Set up Core Hub framework planning

workplans/CORE-WP-0001-statehub-bootstrap.md

@@ -0,0 +1,50 @@
+---
+id: CORE-WP-0001
+type: workplan
+title: "Bootstrap Core Hub repository identity"
+domain: infotech
+repo: core-hub
+status: finished
+owner: codex
+topic_slug: custodian
+created: "2026-06-27"
+updated: "2026-06-27"
+state_hub_workstream_id: "f20d57e6-6b3f-49d0-81d6-75325a869599"
+---
+
+# Bootstrap Core Hub repository identity
+
+Core Hub is the 3rd-generation production interaction and coordination framework for Coulomb / Helixforge, intended to rebuild the useful goals of State Hub and Inter-Hub on a practical production stack.
+
+## Review Generated Integration Files
+
+```task
+id: CORE-WP-0001-T01
+status: done
+priority: high
+state_hub_task_id: "25445710-84c1-4f19-8003-c0bfbd349154"
+```
+
+Result 2026-06-27: Rebound `INTENT.md`, `SCOPE.md`, `README.md`, `AGENTS.md`, Claude rules, registry metadata, and capability index from repo-seed identity to Core Hub identity.
+
+## Verify Local Developer Workflow
+
+```task
+id: CORE-WP-0001-T02
+status: done
+priority: high
+state_hub_task_id: "ae7cb4ba-c6d9-466b-834f-d349900eca09"
+```
+
+Result 2026-06-27: Documented the current markdown/specification workflow and the intended implementation stack in `.claude/rules/stack-and-commands.md`. Concrete install/test/lint/build/run commands will be added by the FastAPI foundation workplan once runtime code exists.
+
+## Seed First Real Workplan
+
+```task
+id: CORE-WP-0001-T03
+status: done
+priority: medium
+state_hub_task_id: "09ee5a5a-e754-4217-9850-d07179562a75"
+```
+
+Result 2026-06-27: Seeded Core Hub implementation workplans for contract extraction, FastAPI/Postgres foundation, Inter-Hub compatibility, data migration/cutover, operator UI, and Haskell retirement.

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

@@ -0,0 +1,61 @@
+---
+id: CORE-WP-0002
+type: workplan
+title: "Freeze Core Hub contract and IR"
+domain: infotech
+repo: core-hub
+status: ready
+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: todo
+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.
+
+## Define Core Hub IR Artifacts
+
+```task
+id: CORE-WP-0002-T02
+status: todo
+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.
+
+## Capture Compatibility Fixtures
+
+```task
+id: CORE-WP-0002-T03
+status: todo
+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.
+
+## Record Contract Governance
+
+```task
+id: CORE-WP-0002-T04
+status: todo
+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.

workplans/CORE-WP-0003-fastapi-postgres-foundation.md

@@ -0,0 +1,61 @@
+---
+id: CORE-WP-0003
+type: workplan
+title: "Build FastAPI/Postgres foundation"
+domain: infotech
+repo: core-hub
+status: ready
+owner: codex
+topic_slug: custodian
+created: "2026-06-27"
+updated: "2026-06-27"
+state_hub_workstream_id: "ef913c8c-2a50-4970-9a9d-0cb65dc996cd"
+---
+
+# Build FastAPI/Postgres foundation
+
+Create the first Core Hub runtime on the natural Coulomb stack.
+
+## Scaffold Python Project
+
+```task
+id: CORE-WP-0003-T01
+status: todo
+priority: high
+state_hub_task_id: "3db032d8-7ac6-424e-8bbe-3debd332241b"
+```
+
+Add Python packaging, app layout, dependency declaration, local dev commands, and test runner. Target Python 3.12, FastAPI, Pydantic v2, SQLAlchemy async, Alembic, asyncpg, httpx, and pytest.
+
+## Add Health and OpenAPI Baseline
+
+```task
+id: CORE-WP-0003-T02
+status: todo
+priority: high
+state_hub_task_id: "d01d6169-a0c6-4689-b986-49ea6cd218b9"
+```
+
+Implement health/readiness endpoints and generated OpenAPI. Ensure local run/test commands are documented in agent rules.
+
+## Add Database Foundation
+
+```task
+id: CORE-WP-0003-T03
+status: todo
+priority: high
+state_hub_task_id: "23c57f3e-425e-47d8-9fb5-9cc6366f2167"
+```
+
+Create SQLAlchemy base models, Alembic configuration, initial migrations, async database session wiring, and test database fixtures.
+
+## Add CI-Ready Checks
+
+```task
+id: CORE-WP-0003-T04
+status: todo
+priority: medium
+state_hub_task_id: "a1790376-3f63-4eed-8f2f-c059eb1304db"
+```
+
+Add formatting/lint/test commands suitable for the normal platform workflow. Avoid Haskell/Nix/devenv dependencies.