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

Stack

Core Hub now has a runnable FastAPI foundation.

• Python 3.12
• FastAPI, Pydantic v2
• SQLAlchemy async, Alembic, asyncpg, Postgres
• httpx and uvicorn for HTTP/runtime support
• pytest and ruff for verification
• 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/

# Install/sync dependencies
make install

# Verify implementation
make test
make lint

# Run locally
make run

# Regenerate OpenAPI snapshot
make openapi

# 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/code edits
git diff --check

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