## Stack

Current repo state: Markdown/specification-first planning repo. Implementation workplans target the following stack once source code is added:

- Python 3.12
- FastAPI, Pydantic v2
- SQLAlchemy async, Alembic, asyncpg, Postgres
- httpx for service clients
- pytest for unit, API, contract, and migration tests
- OpenAPI and JSON Schema for public contracts
- whynot-design aligned UI components/adapters where operator UI is needed

## Dev Commands

```bash
# Orient
cat .custodian-brief.md
cat INTENT.md
cat SCOPE.md
ls workplans/

# Review core docs
cat docs/specs/README.md
cat docs/research/2026-06-27-core-hub-lineage-and-platform-reset.md

# After workplan edits, from ~/state-hub
make fix-consistency REPO=core-hub

# Sanity-check markdown/registry edits
git diff --check

# Registry validation, from a checkout with reuse-surface CLI available
reuse-surface validate --root .
```

Add concrete `install`, `test`, `lint`, `build`, and `run` commands in this file when the FastAPI implementation lands.