pr-validation.yaml

name: PR validation

on:
  pull_request:
    types: [opened, edited, synchronize]
    branches: [develop, main]

permissions:
  contents: read
  pull-requests: read

jobs:
  pr-title:
    name: Validate PR title
    runs-on: ubuntu-latest
    steps:
      - uses: amannn/action-semantic-pull-request@v6
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
        with:
          types: |
            feat
            fix
            docs
            style
            refactor
            perf
            test
            chore
            ci
            build
          requireScope: false
          subjectPattern: ^[a-z].+[^.]$
          subjectPatternError: |
            The subject "{subject}" must start lowercase and not end with a period.

  commit-messages:
    name: Validate commit messages
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v7
        with:
          fetch-depth: 0
      - name: Check each commit against docs/git-commits.md
        env:
          BASE: ${{ github.event.pull_request.base.sha }}
          HEAD: ${{ github.event.pull_request.head.sha }}
        run: |
          types='feat|fix|docs|style|refactor|perf|test|chore|ci|build'
          pattern="^(${types})(\([a-z0-9-]+\))?!?: [a-z].{0,70}$"
          fail=0
          while read -r sha; do
            subj=$(git log -1 --format=%s "$sha")
            case "$subj" in
              "Merge "*|"Revert "*) continue ;;
            esac
            if ! echo "$subj" | grep -qE "$pattern"; then
              echo "::error::invalid commit subject: $subj"
              fail=1
            fi
          done < <(git rev-list "$BASE..$HEAD")
          exit $fail

  issue-reference:
    name: Check issue reference
    runs-on: ubuntu-latest
    steps:
      - name: Verify PR references an issue
        if: github.event.pull_request.base.ref == 'develop'
        env:
          PR_BODY: ${{ github.event.pull_request.body }}
          PR_TITLE: ${{ github.event.pull_request.title }}
        run: |
          if echo "$PR_TITLE" | grep -qiE '^(chore|style)\b'; then
            echo "Trivial PR (chore/style) — issue reference not required."
            exit 0
          fi
          if echo "$PR_BODY" | grep -qiE '(close[sd]?|fix(e[sd])?|resolve[sd]?)\s+#[0-9]+'; then
            echo "Issue reference found."
            exit 0
          fi
          echo "::error::PR must reference a GitHub issue in the body (e.g. 'Closes #12'). See docs/git-workflow.md."
          exit 1