commit-convention.yml

name: Commit Convention Check

on:
  pull_request:
    branches:
      - master
  push:
    branches:
      - master

permissions:
  contents: read

concurrency:
  group: commit-convention-${{ github.event.pull_request.number || github.ref }}
  cancel-in-progress: true

jobs:
  conventional-commits:
    name: Commit Convention
    runs-on: ubuntu-latest
    timeout-minutes: 10
    steps:
      - name: Checkout
        uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3
        with:
          fetch-depth: 0

      - name: Validate commit messages
        shell: bash
        run: |
          set -euo pipefail
          CONVENTIONAL_REGEX='^(feat|fix|chore|docs|refactor|perf|build|ci|test|revert)(\([^)]+\))?(!)?: .+'

          if [[ "${{ github.event_name }}" == "pull_request" ]]; then
            BASE_SHA="${{ github.event.pull_request.base.sha }}"
            HEAD_SHA="${{ github.event.pull_request.head.sha }}"
          else
            BASE_SHA="${{ github.event.before }}"
            HEAD_SHA="${{ github.sha }}"
          fi

          echo "Checking commits in range: ${BASE_SHA}..${HEAD_SHA}"

          # First push on repo may have all-zero before SHA.
          if [[ "$BASE_SHA" == "0000000000000000000000000000000000000000" ]]; then
            COMMITS=$(git rev-list --max-count=1 "$HEAD_SHA")
          else
            COMMITS=$(git rev-list "${BASE_SHA}..${HEAD_SHA}")
          fi

          if [[ -z "$COMMITS" ]]; then
            echo "No commits to validate."
            exit 0
          fi

          FAIL=0
          while IFS= read -r COMMIT; do
            SUBJECT=$(git log -1 --pretty=%s "$COMMIT")

            # Ignore merge commits created by GitHub.
            if [[ "$SUBJECT" =~ ^Merge\ pull\ request\  ]] || [[ "$SUBJECT" =~ ^Merge\ branch\  ]]; then
              continue
            fi

            if [[ ! "$SUBJECT" =~ $CONVENTIONAL_REGEX ]]; then
              echo "Invalid commit: $COMMIT"
              echo "Subject: $SUBJECT"
              FAIL=1
            fi
          done <<< "$COMMITS"

          if [[ "$FAIL" -ne 0 ]]; then
            echo ""
            echo "Use Conventional Commits:"
            echo "  feat: description"
            echo "  fix: description"
            echo "  chore: description"
            exit 1
          fi

          echo "All commit messages are valid."