Thanks for your interest in contributing! Full contributor workflow lives at:
docs/development/contributing.md (canonical).
- Fork and clone the repo.
- Install dev dependencies:
uv sync --group dev - Install both pre-commit hook stages:
pre-commit install --hook-type pre-commit --hook-type pre-push
- See
docs/development/contributing.mdfor branch naming, testing, PR review process.
PR titles MUST use one of these prefixes (release-please uses them to generate changelogs):
feat:— new functionality (Features section)fix:— bug fix (Bug Fixes section)refactor:— code refactoring (Code Refactoring section)docs:— documentation onlychore:— maintenance / dependencies (hidden from changelog)perf:— performance improvements
Without a recognized prefix, the change ships but won't appear in release notes.
See SECURITY.md — please use private vulnerability reporting, NOT public issues.