From 83e16a4a9ea473ba068c43c0577c4479ea56923f Mon Sep 17 00:00:00 2001
From: sehkone <sehkone@cluml.com>
Date: Sat, 17 Jan 2026 10:19:58 +0900
Subject: [PATCH] Skip test suite on docs-only changes

- Add a change filter job to detect docs-only edits.
- Gate the Test Suite job so it skips when only docs change.
- Keep Quality Check running for all changes.

Closes #128
---
 .github/workflows/ci.yml | 41 +++++++++++++++++++++++++++++++++++++++-
 1 file changed, 40 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 6c56c80..0c2bb8a 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -12,6 +12,44 @@ env:
   CARGO_TERM_COLOR: always
 
 jobs:
+  changes:
+    name: Change Filter
+    runs-on: ubuntu-latest
+    outputs:
+      docs_only: ${{ steps.decide.outputs.docs_only }}
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Filter Paths
+        id: filter
+        uses: dorny/paths-filter@v3
+        with:
+          filters: |
+            docs:
+              - "docs/**"
+              - "**/*.md"
+              - "mkdocs.yml"
+              - ".markdownlint*"
+            code:
+              - "src/**"
+              - "tests/**"
+              - "scripts/**"
+              - "Cargo.toml"
+              - "Cargo.lock"
+              - "docker-compose.yml"
+              - "Dockerfile*"
+              - "responder.toml.example"
+              - ".github/workflows/**"
+
+      - name: Decide Docs-Only
+        id: decide
+        run: |
+          if [ "${{ steps.filter.outputs.docs }}" = "true" ] && [ "${{ steps.filter.outputs.code }}" != "true" ]; then
+            echo "docs_only=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "docs_only=false" >> "$GITHUB_OUTPUT"
+          fi
+
   check:
     name: Quality Check
     runs-on: ubuntu-latest
@@ -59,7 +97,8 @@ jobs:
 
   test:
     name: Test Suite
-    needs: check
+    needs: [check, changes]
+    if: needs.changes.outputs.docs_only != 'true'
     runs-on: ubuntu-latest
     timeout-minutes: 20
     steps: