2026-06-27 08:22:42 +00:00
|
|
|
## Stack
|
|
|
|
|
|
2026-06-27 11:41:26 +02:00
|
|
|
Core Hub now has a runnable FastAPI foundation.
|
2026-06-27 11:00:12 +02:00
|
|
|
|
|
|
|
|
- Python 3.12
|
|
|
|
|
- FastAPI, Pydantic v2
|
|
|
|
|
- SQLAlchemy async, Alembic, asyncpg, Postgres
|
2026-06-27 11:41:26 +02:00
|
|
|
- httpx and uvicorn for HTTP/runtime support
|
|
|
|
|
- pytest and ruff for verification
|
2026-06-27 11:00:12 +02:00
|
|
|
- OpenAPI and JSON Schema for public contracts
|
|
|
|
|
- whynot-design aligned UI components/adapters where operator UI is needed
|
2026-06-27 08:22:42 +00:00
|
|
|
|
|
|
|
|
## Dev Commands
|
|
|
|
|
|
|
|
|
|
```bash
|
2026-06-27 11:00:12 +02:00
|
|
|
# Orient
|
2026-06-27 08:22:42 +00:00
|
|
|
cat .custodian-brief.md
|
2026-06-27 11:00:12 +02:00
|
|
|
cat INTENT.md
|
2026-06-27 08:22:42 +00:00
|
|
|
cat SCOPE.md
|
|
|
|
|
ls workplans/
|
|
|
|
|
|
2026-06-27 11:41:26 +02:00
|
|
|
# Install/sync dependencies
|
|
|
|
|
make install
|
|
|
|
|
|
|
|
|
|
# Verify implementation
|
|
|
|
|
make test
|
|
|
|
|
make lint
|
|
|
|
|
|
|
|
|
|
# Run locally
|
|
|
|
|
make run
|
|
|
|
|
|
|
|
|
|
# Regenerate OpenAPI snapshot
|
|
|
|
|
make openapi
|
|
|
|
|
|
2026-06-27 11:00:12 +02:00
|
|
|
# Review core docs
|
|
|
|
|
cat docs/specs/README.md
|
|
|
|
|
cat docs/research/2026-06-27-core-hub-lineage-and-platform-reset.md
|
2026-06-27 08:22:42 +00:00
|
|
|
|
2026-06-27 11:00:12 +02:00
|
|
|
# After workplan edits, from ~/state-hub
|
|
|
|
|
make fix-consistency REPO=core-hub
|
2026-06-27 08:22:42 +00:00
|
|
|
|
2026-06-27 11:41:26 +02:00
|
|
|
# Sanity-check markdown/registry/code edits
|
2026-06-27 08:22:42 +00:00
|
|
|
git diff --check
|
2026-06-27 11:00:12 +02:00
|
|
|
|
|
|
|
|
# Registry validation, from a checkout with reuse-surface CLI available
|
|
|
|
|
reuse-surface validate --root .
|
2026-06-27 08:22:42 +00:00
|
|
|
```
|
