generated from coulomb/repo-seed
37 lines
1019 B
Markdown
37 lines
1019 B
Markdown
## 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
|
|
|
|
```bash
|
|
# 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.
|