ci: skip python tests, lint, and type checks on docs-only PRs

.github/workflows/tests.yml

@@ -1,12 +1,16 @@
 name: Run Tests
 
-on: [pull_request]
+on:
+  pull_request:
+    paths-ignore:
+      - 'docs/**'
+      - '**/*.md'
 
 permissions:
   contents: read
 
 jobs:
-  tests:
+  tests-matrix:
     name: tests (${{ matrix.python-version }})
     runs-on: ubuntu-latest
     timeout-minutes: 15
@@ -98,3 +102,19 @@ jobs:
             ~/.local/share/uv
             .venv
           key: uv-main-py${{ matrix.python-version }}-${{ hashFiles('uv.lock') }}
+
+  # Summary job to provide single status for branch protection
+  tests:
+    name: tests
+    runs-on: ubuntu-latest
+    needs: tests-matrix
+    if: always()
+    steps:
+      - name: Check matrix results
+        run: |
+          if [ "${{ needs.tests-matrix.result }}" == "success" ] || [ "${{ needs.tests-matrix.result }}" == "skipped" ]; then
+            echo "All tests passed"
+          else
+            echo "Tests failed"
+            exit 1
+          fi