Semantic Version and Commit Message Advisor

Advisory only. Never create commits, modify the git index, create or push tags.

Workflow

1. Get baseline version: git describe --tags --abbrev=0 --match "v[0-9]*.[0-9]*.[0-9]*" 2>/dev/null || echo "v0.0.0"
2. Collect all unmerged changes (avoid double-counting):
   • git diff HEAD --stat — staged + unstaged working-tree changes
   • git log origin/main..HEAD --oneline — branch commits not yet in main
   • git diff origin/main...HEAD --stat — combined diff from merge base
3. Group changed files by functional area.
4. Classify each group — see CLASSIFICATION.md.
5. Select the highest-impact classification: major > minor > patch > none.
6. Calculate candidate version (see table below).
7. Generate one conventional commit message for the dominant change.
8. Flag mixed-purpose changes that should be split into separate commits.

Candidate Version Calculation