# AI coding instructions

- This repository is a Python package.
- Use the project-local virtualenv at `.venv` for Python commands.
- Target Python version: >= 3.8 (flag compatibility issues with versions supported by `pyproject.toml`).
- Prefer pure functions and type hints.
- Do not introduce new dependencies unless explicitly asked.
- Follow existing style and naming conventions.
- Avoid large refactors unless requested.
- Add/update tests for behavior changes when practical.
