Code Quality

Run formatting and validation before pushing changes to ensure code quality.

Format

Format the codebase using ruff:

./scripts/format.sh

ruff format .

Lint and type-check using ruff and mypy:

./scripts/validate.sh

ruff check .

mypy .

Configuration is in pyproject.toml. Run both scripts before every commit.

# 1. Format
./scripts/format.sh

# 2. Validate
./scripts/validate.sh

# 3. If both pass, commit
git add .
git commit -m "your message"

Issue	Solution
`ruff` not found	Run `uv pip install ruff`
`mypy` not found	Run `uv pip install mypy`
Type errors	Fix the types or add `# type: ignore` comment
Import sorting	Run `ruff check --fix .` to auto-fix