core-hub/.claude/rules/stack-and-commands.md

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

# 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.