Split docs validation from Rust fast CI

Author: jayhack

.github/workflows/docs-validate.yml

@@ -0,0 +1,45 @@
+name: Docs Validate
+
+on:
+  pull_request:
+    branches:
+      - "develop"
+    paths:
+      - ".github/workflows/docs-validate.yml"
+      - "docs/**"
+      - "rust-rewrite/docs-site-strategy.md"
+      - "rust-rewrite/docs-site-vercel-plan.md"
+  push:
+    branches:
+      - "develop"
+      - "rust-rewrite"
+    paths:
+      - ".github/workflows/docs-validate.yml"
+      - "docs/**"
+      - "rust-rewrite/docs-site-strategy.md"
+      - "rust-rewrite/docs-site-vercel-plan.md"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  mintlify:
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "22"
+
+      - name: Validate Mintlify build
+        working-directory: docs
+        run: npx --yes mintlify@latest validate
+
+      - name: Check Mintlify links
+        working-directory: docs
+        run: npx --yes mintlify@latest broken-links

.github/workflows/rust-rewrite-fast.yml

@@ -9,7 +9,10 @@ on:
       - "Cargo.lock"
       - "Cargo.toml"
       - "crates/**"
-      - "rust-rewrite/**"
+      - "rust-rewrite/golden/**"
+      - "rust-rewrite/p0-parity-coverage.json"
+      - "rust-rewrite/supported-subset.json"
+      - "rust-rewrite/tools/**"
       - "src/graph_sitter/codebase/**"
       - "src/graph_sitter/configs/models/codebase.py"
       - "src/graph_sitter/core/codebase.py"
@@ -29,7 +32,10 @@ on:
       - "Cargo.lock"
       - "Cargo.toml"
       - "crates/**"
-      - "rust-rewrite/**"
+      - "rust-rewrite/golden/**"
+      - "rust-rewrite/p0-parity-coverage.json"
+      - "rust-rewrite/supported-subset.json"
+      - "rust-rewrite/tools/**"
       - "src/graph_sitter/codebase/**"
       - "src/graph_sitter/configs/models/codebase.py"
       - "src/graph_sitter/core/codebase.py"

rust-rewrite/docs-site-strategy.md

@@ -267,5 +267,5 @@ Rules:
 
 - [ ] Ensure PyPI package metadata points to the final docs and landing URLs. owner: unclaimed.
 - [ ] Ensure the public setup path does not claim `uvx graph-sitter ...` until clean package validation passes. owner: unclaimed.
-- [ ] Add a docs validation CI or release gate for `mintlify validate`. owner: unclaimed.
+- [x] Add a docs validation CI or release gate for `mintlify validate`. owner: codex. Result: `.github/workflows/docs-validate.yml` runs Mintlify validate and broken-link checks for docs changes.
 - [ ] Add a site build CI or release gate for `npm --prefix site ci && npm --prefix site run build`. owner: unclaimed.

rust-rewrite/strategy.md

@@ -154,6 +154,7 @@ Recommended task format:
 - [x] Add a minimal debug API returning engine version and enabled features. owner: Beauvoir. Result: added Rust `Engine::debug_info` and feature-gated PyO3 bindings.
 - [x] Add CI job that builds the Rust extension on supported Python versions. owner: codex. Result: `.github/workflows/rust-rewrite-extension.yml` builds/tests the PyO3 extension on Python 3.12 and 3.13 across Linux/macOS, imports `graph_sitter_py`, runs a compact Python indexing smoke, then builds a wheel and proves `uvx --from dist/<wheel>.whl graph-sitter parse --backend rust --fallback error`.
 - [x] Add fast Rust rewrite PR CI lane. owner: codex. Result: `.github/workflows/rust-rewrite-fast.yml` runs `rust-rewrite/tools/check_fast.sh` for full ruff, Rust fmt/tests, PyO3 binding checks, live Python/Rust fixture parity, focused py_compile, and focused Rust-backend pytest without running large pinned repo benchmarks.
+- [x] Keep docs-only work out of the Rust fast lane. owner: codex. Result: `.github/workflows/docs-validate.yml` validates Mintlify docs and broken links, while `rust-rewrite-fast.yml` now watches Rust/code/proof inputs instead of all `rust-rewrite/**` markdown ledgers.
 - [x] Add tiny CLI smoke CI lane for the `uvx graph-sitter` surface. owner: codex. Result: `.github/workflows/rust-rewrite-cli-smoke.yml` runs `rust-rewrite/tools/check_cli_smoke.sh` for focused ruff/py_compile, command help, and parse/run/transform unit tests when CLI files change.
 - [x] Harden Linux PyO3 CI against missing uv libpython loader paths. owner: codex. Result: `check_fast.sh` and `check_extension_build.sh` export the active Python `LIBDIR` through `LD_LIBRARY_PATH` before running linked PyO3 test binaries.
 - [x] Fix large-repo workflow validation before job startup. owner: codex. Result: moved `runner.temp`-derived pinned-check env vars from job-level env to the run step where the runner context is valid.
@@ -596,3 +597,4 @@ Default-backend promotion criteria:
 - [x] 2026-06-19: Added installed-wheel registered run proof. owner: codex. Notes: the wheel smoke now runs target-owned registered codemods through `uvx --from dist/<wheel>.whl` in strict Rust `--check`, `--write`, and scoped `--subdir --check` modes.
 - [x] 2026-06-19: Documented setup and `uvx` workflows. owner: codex. Notes: added `docs/cli/uvx.mdx`, linked it from CLI nav, modernized installation quickstart around `graph-sitter`, and kept PyPI-backed Rust claims blocked on published-package validation.
 - [x] 2026-06-19: Published benchmark and correctness docs. owner: codex. Notes: added docs pages for pinned Airflow/Next.js benchmark evidence and parity status, linked them from `uvx` and the overview, and softened broad correctness claims in public copy.
+- [x] 2026-06-19: Split docs validation from Rust fast CI. owner: codex. Notes: added a lightweight Mintlify validate/broken-links workflow and narrowed Rust fast-check path filters so docs/strategy-only edits no longer spend the full Rust check budget.