## Stack

- **Language:** Python (FastAPI target under `/src`; prototypes in `/prototype-*`)
- **Key deps:** See `prototype-chatgpt5/pyproject.toml` and `docs/openapi.yaml`

## Dev Commands

```bash
# Production codebase (src/)
python3 -m venv .venv && .venv/bin/pip install -e ".[dev]"
.venv/bin/pytest -q tests/unit
.venv/bin/pytest -q tests/acceptance   # routing-rules tests fail until implemented

# Orient on architecture and migration plan
cat INTENT.md
cat docs/WORKPLAN_MainCodebase_Integration.md

# Prototype reference (chatgpt5)
cd prototype-chatgpt5 && pip install -e . && pytest -q

# After workplan edits
statehub fix-consistency
```
