ci: enforce semantic commit conventions for releases

.commitlintrc.yaml

@@ -0,0 +1,34 @@
+extends:
+  - '@commitlint/config-conventional'
+
+rules:
+  type-enum:
+    - 2
+    - always
+    - - feat
+      - fix
+      - docs
+      - style
+      - refactor
+      - perf
+      - test
+      - build
+      - ci
+      - chore
+      - revert
+  subject-case:
+    - 2
+    - never
+    - - upper-case
+      - pascal-case
+      - start-case
+  subject-empty:
+    - 2
+    - never
+  type-empty:
+    - 2
+    - never
+  scope-case:
+    - 2
+    - always
+    - lower-case

.github/workflows/ci.yml

@@ -13,6 +13,39 @@ concurrency:
   cancel-in-progress: true
 
 jobs:
+  validate-pr-title:
+    name: Validate PR Title
+    if: github.event_name == 'pull_request'
+    runs-on: ubuntu-latest
+    permissions:
+      pull-requests: read
+    steps:
+      - uses: amannn/action-semantic-pull-request@0723387faaf9b38adef4775cd42cfd5155ed6017 # v5.5.3
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        with:
+          types: |
+            feat
+            fix
+            docs
+            style
+            refactor
+            perf
+            test
+            build
+            ci
+            chore
+            revert
+          requireScope: false
+          subjectPattern: ^(?![A-Z]).+$
+          subjectPatternError: |
+            The subject "{subject}" found in the pull request title "{title}"
+            didn't match the configured pattern. Please ensure that the subject
+            doesn't start with an uppercase character.
+          wip: false
+          validateSingleCommit: false
+          validateSingleCommitMatchesPrTitle: false
+
   build:
     name: test with ${{ matrix.py }} on ${{ matrix.os }}
     runs-on: ${{ matrix.os }}

.pre-commit-config.yaml

@@ -58,6 +58,12 @@ repos:
     rev: v8.30.0
     hooks:
       - id: gitleaks
+  - repo: https://github.com/compilerla/conventional-pre-commit
+    rev: v3.6.0
+    hooks:
+      - id: conventional-pre-commit
+        stages: [commit-msg]
+        args: [--strict]
   - repo: local
     hooks:
       - id: print_statement