You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Every task callable via ./workflow.cmd <namespace>.<task>. Tasks are defined in _CI/tasks/<module>.py and registered in _CI/tasks/__init__.py.
Top-level shortcuts
The shortcuts below resolve to a namespace's default task (the one added with default=True).
Task
Default of
What it does
bootstrap
develop.bootstrap
First-run setup; idempotent. Pass --force to re-run.
format
format.ruff
Ruff format + import sort.
lint
lint.all
Runs ruff, pylint, ty, complexipy, commitizen.
test
test.all
pytest with coverage and xdist.
build
build.package
Security checks + uv build.
release
release
Validate, branch, bump, changelog, push, open PR/MR.
quality
quality.pyscn-analyze
pyscn static analysis with HTML report.
secure
secure.all
pip-audit + SBOM generate + (optional) DT upload.
document
document
properdocs build + view in browser.
container
container.publish
Build deps image; in CI pushes to the registry.
develop — local dev environment
Task
Args
What it does
develop.bootstrap
--force
Run all bootstrap steps. Idempotent.
develop.pre-commit
--install / --uninstall / --update
Manage pre-commit hooks.
develop.bump-uv
--version=<v>
Move every uv pin to the newest release at least 7 days old: the four version literals, the base image's tag and its re-resolved digest, and uv.lock. Warns when the bump crosses a minor version. --version takes a specific release, ignoring the cool-down. See Dependency groups.
format, lint, test, quality
Every task in this group that takes paths accepts --paths="<space-separated paths>", and
defaults to the whole project when it is omitted. The pre-commit hooks use it to check only
the staged files — see .pre-commit-config.yaml
for which hooks are scoped that way and which are deliberately not.
Task
What it does
format.ruff
ruff check --select I --fix + ruff format.
lint.ruff
ruff check.
lint.pylint
pylint src/ _CI/tasks/ tests/.
lint.ty
ty check src/ _CI/tasks/ tests/.
lint.complexipy
Cognitive complexity check on src/.
lint.commitizen
Validate commit messages since last tag.
test.pytest
pytest with coverage, xdist, HTML reports. Forward extra pytest args with --args="…" (e.g. --args="-k test_hello").
test.tox
Full multi-version tox matrix in parallel. Pass --env=py313 to run a single environment.
test.coverage
Print coverage report from the latest run.
test.view
Open HTML test + coverage reports in browser.
quality.pyscn-analyze
Full pyscn analysis with HTML report.
quality.pyscn-check
CI-friendly pass/fail quality gate.
release — versioning and publishing
Task
Args
What it does
release
-i <type>, --no-push
Full release flow: validate, branch, bump, changelog, push, open PR/MR.
release.validate
—
Working-tree-clean and in-sync-with-origin checks.
release.bump
-i <type>
cz bump with the given increment (major/minor/patch/alpha/beta/rc).
release.changelog
--write
Generate changelog. --write persists and commits, signing per commit.gpgsign.
release.push
—
git push + git push --tags.
release.dist
—
Clean and build into dist/, leaving the artifacts for inspection or attestation.
release.publish
--prebuilt
Build + uv publish + SBOM upload (if DT enabled). Invoked from CI on release-tag merge. --prebuilt publishes what release.dist already built instead of rebuilding.
release.clean
—
Remove dist/ and sbom.json.
secure — pip-audit, SBOM, Dependency Track
Task
Args
What it does
secure.audit
—
pip-audit honoring .security-overrides.
secure.sbom-extract
--write
Compose a CycloneDX 1.7 SBOM with metadata header (lifecycles, tools, supplier, authors), a two-level dependency graph (project → runtime + dev + build-environment; build-environment → vendored + pipeline), and per-component licence + hash + external-reference enrichment. Prints to stdout; with --write lands at src/<slug>/sbom.cdx.json so uv build ships it inside the wheel.
secure.sbom-validate
—
Validate the SBOM against the CycloneDX 1.7 JSON schema (runs the validator in a clean uv run python subprocess so the venv-installed jsonschema wins over the older vendored one). Re-runs sbom-extract first if the file is missing.
document — documentation site
Task
Args
What it does
document.build
—
properdocs build — generate the static site under site/.
document.serve
—
properdocs serve — serve the site locally with live reload (Ctrl-C to stop).
document.view
—
Open the rendered site in the default browser (skipped in CI).
document (aggregator)
—
Update badges, then build + view.
document.deploy-github
—
properdocs gh-deploy --force — build and publish to the gh-pages branch (consumed by the shipped Pages workflow). Only present when integrate_pages=true and git_hosting_service=github.
container — OCI deps image
Task
What it does
container.build
Build afas_mcp_server-deps:latest locally.
container.publish
In CI: push to the chosen host's registry. Locally: build only.
Shared helpers (not tasks)
Functions in _CI/tasks/shared.py (notably the @logged decorator, the IndentingStream plumbing, execute, run_steps) are used by tasks and not directly callable. See The _CI tasks architecture.
Host-specific helpers live in _CI/tasks/github.py and are imported by container.py and release.py via a Jinja-substituted import.