commit-lint.yml

name: Commit Lint

on:
  pull_request:
    branches: [main]

concurrency:
  group: commit-lint-${{ github.ref }}
  cancel-in-progress: true

jobs:
  lint-commits:
    name: Validate Commit Messages
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v6
        with:
          fetch-depth: 0

      - name: Check commit messages
        run: |
          ERRORS=0
          while IFS= read -r sha; do
            msg=$(git log --format=%s -n 1 "$sha")
            if echo "$msg" | grep -qE '^Merge '; then
              continue
            fi
            if ! echo "$msg" | grep -qE '^(feat|fix|docs|chore|refactor|test|ci): .+'; then
              echo "BAD: $msg"
              echo "     Commit $sha does not follow Conventional Commits format."
              ERRORS=$((ERRORS + 1))
            fi
            if [ ${#msg} -gt 72 ]; then
              echo "LONG: $msg"
              echo "      Commit $sha first line is ${#msg} chars (max 72)."
              ERRORS=$((ERRORS + 1))
            fi
          done < <(git rev-list origin/main..HEAD)

          if [ "$ERRORS" -gt 0 ]; then
            echo ""
            echo "Required format: <type>: <short description>"
            echo "Allowed types: feat, fix, docs, chore, refactor, test, ci"
            exit 1
          fi
          echo "All commit messages OK."