pr-title.yml

name: Lint PR Title

# Validate that PR titles follow Conventional Commits format.
# Since we squash merge PRs, the PR title becomes the merge commit message,
# which Python Semantic Release uses to determine version bumps.
#
# This avoids burdening external contributors with conventional commit enforcement
# on every individual commit. See: https://www.conventionalcommits.org/en/v1.0.0/
#
# NOTE: pull_request_target is used instead of pull_request because it runs in the
# context of the base branch and has reliable access to the GITHUB_TOKEN for reading
# PR metadata.

on:
  pull_request_target:
    types:
      - opened
      - edited
      - reopened

jobs:
  main:
    name: Validate PR title
    runs-on: ubuntu-latest
    permissions:
      pull-requests: read
    steps:
      - uses: amannn/action-semantic-pull-request@v6
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}