saleor-commit

name: saleor-commit description: Commit changes in the Saleor codebase with pre-commit hook error handling. Use when asked to "commit", "commit changes", "make a commit", or any git commit task in the Saleor project. Handles virtual env activation, staging, commit message writing, and automatic resolution of pre-commit hook failures (ruff, mypy, schema, migrations).

Saleor Commit

Workflow

Activate virtual env: source .venv/bin/activate (look for .venv dir in project root)
Run git status and git diff (staged + unstaged) to understand all changes
Stage relevant files with git add (specific files, not git add -A)
Write a comprehensive commit message describing what changed and why
Run git commit
If pre-commit hooks fail, follow error resolution below and retry

Commit Message Format

Use a HEREDOC for the message:

git commit -m "$(cat <<'EOF'
Short summary of changes

Detailed description of what was changed and why.
List specific modifications when multiple files are affected.

EOF
)"

Pre-commit Hook Error Resolution

The project runs these hooks: trailing-whitespace, end-of-file-fixer, ruff (lint + format), mypy, deptry, semgrep, uv-lock, migrations-check, gql-schema-check.

Ruff errors (lint/format)

Ruff auto-fixes and auto-formats on commit. After a failure:

Stage the auto-formatted files: git add <files>
Retry the commit
If it fails again, read the error output — some issues require manual fixes (unused imports, type annotations, etc.)

Mypy errors

Read the error output carefully. Fix the typing issues in the reported files. Stage and retry.

Outdated GraphQL schema (`gql-schema-check`)

Regenerate the schema and stage it:

python manage.py get_graphql_schema > saleor/graphql/schema.graphql
git add saleor/graphql/schema.graphql

Missing migrations (`migrations-check`)

Create the missing migration:

python manage.py makemigrations
git add saleor/**/migrations/*.py

Other hooks

trailing-whitespace / end-of-file-fixer: Auto-fix applied. Stage changed files and retry.
deptry: Fix dependency issues in pyproject.toml.
semgrep: Read the finding, fix the flagged code pattern.
uv-lock: Stage the updated uv.lock file.