Thank you for contributing.
- Python 3.11+
uvinstalled (pip install uv)
uv sync --group dev
uv run pre-commit installRun the same checks used in CI:
make checkOr run them individually:
make lint
make typecheck
make test
make secrets- Branch from
main. - Keep changes focused and include tests for behavior changes.
- Update docs (
README.md, this file) when usage/workflow changes. - Update
CHANGELOG.mdfor user-facing changes. - Open a PR using the provided template and complete the checklist.
CODEOWNERS is enabled for source, tests, and release/config paths.
Open an issue with:
- clear title and expected behavior
- reproduction steps
- environment details (Python version, OS)
- logs or stack traces when available
Do not report vulnerabilities in public issues. See SECURITY.md.
By contributing, you agree that your contributions are licensed under MIT.