Handbook
Release and support policy
Updated
Versioning
- Python package follows SemVer in
pyproject.toml. - Governed tasks use
task_id+ folder version (e.g.v1). Breaking schema changes require a new task version directory—see API compatibility.
Supported artifacts
| Artifact | Support expectation |
|---|---|
| Released git tags / pinned SHAs | Intended for consumers |
main branch |
Best-effort; CI should gate |
| Experimental branches | Unsupported |
Maintainer responsibilities
- Keep audits green (
audit_contract_docs.py,audit_docs_site.py). - Document known limitations (KNOWN-LIMITATIONS).
Consumer responsibilities
- Pin versions and run offline gates before rollout.
- Provide reproductions with redacted payloads for defects.