generated from coulomb/repo-seed
Start Core Hub FastAPI replacement foundation
This commit is contained in:
@@ -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.
|
||||
|
||||
@@ -4,7 +4,7 @@ type: workplan
|
||||
title: "Build FastAPI/Postgres foundation"
|
||||
domain: infotech
|
||||
repo: core-hub
|
||||
status: ready
|
||||
status: finished
|
||||
owner: codex
|
||||
topic_slug: custodian
|
||||
created: "2026-06-27"
|
||||
@@ -20,42 +20,42 @@ Create the first Core Hub runtime on the natural Coulomb stack.
|
||||
|
||||
```task
|
||||
id: CORE-WP-0003-T01
|
||||
status: todo
|
||||
status: done
|
||||
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.
|
||||
Result 2026-06-27: Added `pyproject.toml`, `uv.lock`, `Makefile`, `src/core_hub/`, `tests/`, and dependency declarations for FastAPI, Pydantic v2, SQLAlchemy async, Alembic, asyncpg, httpx, uvicorn, pytest, ruff, and aiosqlite test support.
|
||||
|
||||
## Add Health and OpenAPI Baseline
|
||||
|
||||
```task
|
||||
id: CORE-WP-0003-T02
|
||||
status: todo
|
||||
status: done
|
||||
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.
|
||||
Result 2026-06-27: Implemented `/healthz`, `/readyz`, generated OpenAPI, `/api/v2/openapi.json`, `/api/v2/openapi.yaml`, and an OpenAPI export script.
|
||||
|
||||
## Add Database Foundation
|
||||
|
||||
```task
|
||||
id: CORE-WP-0003-T03
|
||||
status: todo
|
||||
status: done
|
||||
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.
|
||||
Result 2026-06-27: Added SQLAlchemy base/session wiring, initial models for hubs, capability manifests, and API consumers, Alembic configuration, first migration, and async sqlite test fixture proving metadata creation.
|
||||
|
||||
## Add CI-Ready Checks
|
||||
|
||||
```task
|
||||
id: CORE-WP-0003-T04
|
||||
status: todo
|
||||
status: done
|
||||
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.
|
||||
Result 2026-06-27: Added `make test`, `make lint`, `make run`, and `make openapi`. Verification passed with `uv run --extra dev pytest` and `uv run --extra dev ruff check .`.
|
||||
|
||||
@@ -20,23 +20,23 @@ Preserve the Inter-Hub `/api/v2` behavior required by current consumers while Co
|
||||
|
||||
```task
|
||||
id: CORE-WP-0004-T01
|
||||
status: todo
|
||||
status: progress
|
||||
priority: high
|
||||
state_hub_task_id: "4e24ab14-d5cf-4466-8287-21eaf075cb44"
|
||||
```
|
||||
|
||||
Implement public read compatibility for hubs, manifests, catalogs, OpenAPI, and docs endpoints.
|
||||
2026-06-27: Implemented seed-backed public compatibility endpoints for hubs, manifests, catalogs, OpenAPI JSON/YAML, and docs redirect. Tests prove route presence and response status. This remains `progress` until legacy Inter-Hub fixture comparison is captured.
|
||||
|
||||
## Protected Bootstrap Compatibility
|
||||
|
||||
```task
|
||||
id: CORE-WP-0004-T02
|
||||
status: todo
|
||||
status: progress
|
||||
priority: high
|
||||
state_hub_task_id: "87073ee7-0213-4eed-881a-b18ab764ae65"
|
||||
```
|
||||
|
||||
Implement protected compatibility for API consumers, token flow, widgets, interaction events, hub registry, annotations, and evidence records. Preserve auth-before-business-logic behavior.
|
||||
2026-06-27: Implemented protected placeholder routes for API consumers, widgets, interaction events, annotations, requirement candidates, decisions, deployments, outcome signals, hub registry, and token route. Tests prove unauthenticated requests fail before business logic. This remains `progress` until authenticated create/read behavior is backed by persistence and fixtures.
|
||||
|
||||
## ops-hub Smoke
|
||||
|
||||
@@ -47,7 +47,7 @@ priority: high
|
||||
state_hub_task_id: "2d18f575-135b-4ba8-9537-6920d0c61e1b"
|
||||
```
|
||||
|
||||
Run ops-hub bootstrap/gate probes against Core Hub using approved credential routing. No secrets in logs, workplans, or chat.
|
||||
Waiting on a deployed Core Hub runtime plus approved credential routing. No secrets in logs, workplans, or chat.
|
||||
|
||||
## activity-core Smoke
|
||||
|
||||
@@ -58,4 +58,4 @@ priority: medium
|
||||
state_hub_task_id: "c3d1c153-0059-470c-bb2d-0b14f2d77b94"
|
||||
```
|
||||
|
||||
Run the activity-core Inter-Hub sink smoke against Core Hub or explicitly record State Hub fallback as the transition path.
|
||||
Waiting on a deployed Core Hub runtime or an explicit State Hub fallback decision for the transition path.
|
||||
|
||||
Reference in New Issue
Block a user