Codex agents working in this repository should follow these guidelines:
- Use Conventional Commits where reasonable (
feat:,fix:,refactor:,docs:, etc.) - Keep them short and present tense
- Describe the change clearly
- Run
ruff formatandruff checkon Python files before committing. - Run the unit tests with
uv run pytestor by activating the venv and runningpytest.
- Always add type annotations to function parameters
- Add return type annotations to public API functions
- Follow selective annotation guidelines (see CLAUDE.md for details)
- Run mypy to check type consistency before committing
- Mention relevant file paths when describing changes.
- Include test output or note why tests were skipped.