From 3e2c2b07a1edeed515b88a1ad7bf61f5006c61c2 Mon Sep 17 00:00:00 2001
From: Joe Blau <1218847+joeblau@users.noreply.github.com>
Date: Tue, 20 Oct 2026 17:33:56 -0700
Subject: [PATCH] ci: skip verify and docs build on PRs that don't touch their
 inputs

---
 .github/workflows/docs.yml  | 34 +++++++++++++++++++++++++++++++-
 .github/workflows/tests.yml | 39 ++++++++++++++++++++++++++++++++++++-
 2 files changed, 71 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index 324ae41..f69d9e7 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -10,10 +10,42 @@ concurrency:
   group: docs-${{ github.ref }}
   cancel-in-progress: ${{ github.event_name == 'pull_request' }}
 jobs:
-  build:
+  changes:
     # Security: never run fork PR code on the self-hosted runner.
     if: github.event_name != 'pull_request' || github.event.pull_request.head.repo.full_name == github.repository
     runs-on: [self-hosted, macOS, ARM64]
+    timeout-minutes: 5
+    permissions:
+      contents: read
+      pull-requests: read
+    outputs:
+      code: ${{ github.event_name != 'pull_request' && 'true' || steps.filter.outputs.code }}
+    steps:
+      # Only filter PRs; main pushes and manual runs keep all existing checks.
+      - uses: dorny/paths-filter@ceb8a2b8f2d89434be7ff52d3de7ec3738c5cc9d # v4.0.3
+        if: github.event_name == 'pull_request'
+        id: filter
+        with:
+          predicate-quantifier: some-with-excludes
+          filters: |
+            # Skip PRs outside the docs build, library and install/browser inputs.
+            code:
+              - 'apps/docs/**'
+              - 'packages/haptic/**'
+              - 'vendor/**'
+              - 'package.json'
+              - '**/package.json'
+              - '**/package-lock.json'
+              - '**/npm-shrinkwrap.json'
+              - '**/.npmrc'
+              - '.github/actions/playwright-browsers/**'
+              - '.github/workflows/docs.yml'
+  build:
+    needs: changes
+    # Skip irrelevant PRs while preserving the required check name.
+    # Security: never run fork PR code on the self-hosted runner.
+    if: needs.changes.outputs.code == 'true' && (github.event_name != 'pull_request' || github.event.pull_request.head.repo.full_name == github.repository)
+    runs-on: [self-hosted, macOS, ARM64]
     timeout-minutes: 20
     env:
       NEXT_PUBLIC_BASE_PATH: /haptic
diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml
index 22c083b..4f6cb22 100644
--- a/.github/workflows/tests.yml
+++ b/.github/workflows/tests.yml
@@ -10,10 +10,47 @@ concurrency:
   group: tests-${{ github.ref }}
   cancel-in-progress: ${{ github.event_name == 'pull_request' }}
 jobs:
-  verify:
+  changes:
     # Security: never run fork PR code on the self-hosted runner.
     if: github.event_name != 'pull_request' || github.event.pull_request.head.repo.full_name == github.repository
     runs-on: [self-hosted, macOS, ARM64]
+    timeout-minutes: 5
+    permissions:
+      contents: read
+      pull-requests: read
+    outputs:
+      code: ${{ github.event_name != 'pull_request' && 'true' || (steps.filter.outputs.code == 'true' || steps.filter.outputs.checked_docs == 'true') && 'true' || 'false' }}
+    steps:
+      # Only filter PRs; main pushes and manual runs keep all existing checks.
+      - uses: dorny/paths-filter@ceb8a2b8f2d89434be7ff52d3de7ec3738c5cc9d # v4.0.3
+        if: github.event_name == 'pull_request'
+        id: filter
+        with:
+          predicate-quantifier: some-with-excludes
+          filters: |
+            # Skip prose-only PRs, except documentation consumed by checks below.
+            code:
+              - '**'
+              - '!**/*.md'
+              - '!**/*.mdx'
+              - '!LICENSE'
+              - '!.github/ISSUE_TEMPLATE/**'
+              - '!.github/pull_request_template.md'
+              - '!**/CODEOWNERS'
+              - '!CODEOWNERS'
+            # Keep package file checks and built/typechecked docs in verification.
+            checked_docs:
+              - 'packages/haptic/README.md'
+              - 'packages/haptic/CHANGELOG.md'
+              - 'packages/haptic/LICENSE'
+              - 'apps/docs/**/*.md'
+              - 'apps/docs/**/*.mdx'
+  verify:
+    needs: changes
+    # Skip irrelevant PRs while preserving the required check name.
+    # Security: never run fork PR code on the self-hosted runner.
+    if: needs.changes.outputs.code == 'true' && (github.event_name != 'pull_request' || github.event.pull_request.head.repo.full_name == github.repository)
+    runs-on: [self-hosted, macOS, ARM64]
     timeout-minutes: 20
     steps:
       - uses: actions/checkout@v7