name: Conventional Commits PR title lint

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

permissions:
  contents: read
  pull-requests: read

jobs:
  commitlint:
    name: Lint PR title (Conventional Commits)
    runs-on: ubuntu-latest
    steps:
      - name: Check PR title follows Conventional Commits
        uses: amannn/action-semantic-pull-request@0723387faaf9b38adef4775cd42cfd5d98f25d3 # v5.5.3
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
        with:
          # Conventional Commits types allowed
          types: |
            feat
            fix
            docs
            style
            refactor
            perf
            test
            build
            ci
            chore
            revert
          # Require scope (optional but encouraged)
          requireScope: false
          # Disallow breaking change in title without BREAKING CHANGE footer
          subjectPattern: ^(?![A-Z]).+$
          subjectPatternError: |
            The subject "{subject}" does not match the required pattern.
            Please use lower-case for the subject.