pr-title-check.yml

name: PR Title Check

on:
  pull_request_target:
    types: [opened, edited, reopened, synchronize]

permissions:
  pull-requests: read

concurrency:
  group: pr-title-${{ github.event.pull_request.number }}
  cancel-in-progress: true

jobs:
  validate:
    runs-on: ubuntu-latest
    steps:
      - name: Validate PR title follows Conventional Commits
        env:
          PR_TITLE: ${{ github.event.pull_request.title }}
        run: |
          # type(scope): summary  — scope optional, `!` marks a breaking change.
          # Keep types in sync with what the PR formatter is allowed to emit.
          PATTERN='^(feat|fix|chore|docs|refactor|perf|test|ci|build|style|revert)(\([a-z0-9 _/-]+\))?!?: .+'

          if echo "$PR_TITLE" | grep -qE "$PATTERN"; then
            echo "PR title is valid."
            exit 0
          fi

          echo "::error title=Invalid PR title::'$PR_TITLE' must follow Conventional Commits — 'type(scope): summary' (scope optional). Allowed types: feat, fix, chore, docs, refactor, perf, test, ci, build, style, revert."
          exit 1