pr-title-check.yml

name: Validate PR Title

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

permissions:
  pull-requests: read

jobs:
  validate:
    runs-on: ubuntu-latest
    steps:
      - name: Validate PR title format
        env:
          PR_TITLE: ${{ github.event.pull_request.title }}
        run: |
          set -euo pipefail

          if [ -z "${PR_TITLE:-}" ]; then
            echo "PR title is missing from event payload"
            exit 1
          fi

          REGEX='^(feat|enhance|fix|perf|refactor|docs|test|chore|ci|build|repo)\((repo|docs|demo|core|fields|builder|renderer|renderer-standalone|renderer-blaze|adapters)\): .+$'

          if [[ "$PR_TITLE" =~ $REGEX ]]; then
            echo "PR title is valid: $PR_TITLE"
            exit 0
          fi

          cat <<'EOF'
          PR title must follow conventional commits format:
            feat(scope): descriptionP
            enhance(scope): description
            fix(scope): description
            perf(scope): description
            refactor(scope): description
            docs(scope): description
            test(scope): description
            chore(scope): description
            ci(scope): description
            build(scope): description
            repo(scope): description

          Allowed tags:
            feat, enhance, fix, perf, refactor, docs, test, chore, ci, build, repo

          Allowed scopes:
            repo, docs, demo, core, fields, builder, renderer, renderer-standalone, renderer-blaze, adapters

          Examples:
            repo(repo): update CI workflow
            chore(repo): update ci workflow
            docs(docs): add quickstart links
            enhance(renderer): improve empty state
            fix(renderer): handle empty schema
          EOF

          exit 1