CI/CD Workflows¶
ci.yml¶
Runs on push to feat/**, bug/**, claude/** and PRs to staging/integration.
| Job | Description |
|---|---|
auto-label |
Assigns PR author and derives label from branch prefix |
backend-tests |
Runs uv run pytest tests/ -v |
backend-smoke |
Builds wheel and verifies import |
frontend-checks |
TypeScript type check + ESLint |
docker-build |
Builds all Docker Compose services (PR only) |
docs-build |
Strict MkDocs build |
docs.yml¶
Runs on push to staging/integration and PRs touching docs/ or mkdocs.yml.
| Job | Description |
|---|---|
build |
MkDocs strict build |
deploy |
Deploy to GitHub Pages (integration push only) |
generate |
Auto-generate capability + patch note entries via Claude API |
integration.yml¶
Runs on push to integration.
| Job | Description |
|---|---|
prune |
Delete branches that have been merged into integration |
release.yml¶
Runs on push to release/** branches.
| Job | Description |
|---|---|
backend-tests |
Full backend test suite |
frontend-checks |
TypeScript + lint |
docker-build |
Docker Compose build |
build-and-release |
Create GitHub Release (depends on all above) |