ssm

Scaffold a new /api/v2 endpoint or resource end-to-end — Pydantic models + protected router + error codes + contract tests + frontend service/types + CHANGELOG. Use for any new API route, resource, or field exposed to the frontend.

Create and verify an Alembic migration for SSM. Use for ANY change to backend/src/ssm/db/models.py or the DB schema. Covers autogenerate review, the fresh/legacy/downgrade verification matrix, the Diesel legacy-DB trap, and same-commit packaging.

Package the current work into a correct SSM commit — pairing guards (model↔migration, backend↔frontend types), CHANGELOG entry, full verification, secrets hygiene, Conventional Commit message. Use whenever committing changes in this repo.

Cut a new SSM release via ./release.sh. Accepts patch|minor|major as $ARGUMENTS. Validates clean tree, bumps VERSION + backend/pyproject.toml, commits, tags, pushes (triggers GitHub Actions build).

Run full verification for SSM — backend pytest + ruff + mypy + frontend lint + type-check. Use before marking work done or pushing changes.