## Stack

- **Language:** Python 3.12+ (`requires-python = ">=3.12"`)
- **Layout:** `pyproject.toml` + `src/user_engine/` + stdlib `unittest`
- **Runtime:** optional extras only — `psycopg[binary]` (Postgres store),
  `PyJWT[crypto]` (OIDC). Core domain and in-memory adapters have no
  third-party deps.
- **Entry point:** `user-engine-portal` → `user_engine.runtime:main`

## Dev Commands

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

# Tests and layer check
make test
make check-layer

# Optional extras
pip install -e ".[runtime]"

# After workplan or registry edits
statehub fix-consistency
```