fix: commitlint force push behaviour

Author: krsche

.github/workflows/ci.yaml

@@ -14,24 +14,26 @@ jobs:
           fetch-depth: 0
       - uses: actions/setup-node@v6
         with:
-          node-version: "22"
-      - run: sudo npm install --global @commitlint/{config-conventional,cli}@20
+          node-version: "lts/*"
+      # Local node_modules so "@..." in .commitlintrc.json resolves (global install does not).
+      - name: Install commitlint
+        run: npm install --no-package-lock @commitlint/cli@17 @commitlint/config-conventional@17
       - if: github.event_name == 'pull_request'
         name: commitlint (pr)
-        run: commitlint -V --from HEAD~${{ github.event.pull_request.commits }} 
+        run: npx commitlint -V --from HEAD~${{ github.event.pull_request.commits }}
       - if: github.event_name == 'push' && !startsWith(github.ref, 'refs/tags')
         name: commitlint (push)
-        # use .before instead of HEAD~1 so that pushes with multiple commits are completely covered as well
-        # --from is not inclusive, so HEAD~1 will only analyze HEAD
-        # BUT:
-        # check if commit exists first (e.g. it doesn't if it was force pushed) 
-        # or fall back to HEAD~1
+        # Prefer github.event.before so multi-commit pushes are all checked; if that ref is gone
+        # (force push, or all-zero before on new branch), fall back to HEAD~1.
         run: |
-          git cat-file -t ${{ github.event.before }} > /dev/null || COMMIT_NOT_FOUND=true
-          if [[ -z "$COMMIT_NOT_FOUND" ]]; then 
-            commitlint -V --from ${{ github.event.before }}
+          set -euo pipefail
+          BEFORE="${{ github.event.before }}"
+          if [[ "$BEFORE" =~ ^0+$ ]]; then
+            npx commitlint -V --from HEAD~1
+          elif git rev-parse --verify "${BEFORE}^{commit}" >/dev/null 2>&1; then
+            npx commitlint -V --from "$BEFORE"
           else
-            commitlint -V --from HEAD~1
+            npx commitlint -V --from HEAD~1
           fi
   
   release: