fix(ci): fetch-depth 2 for graph staleness, use python -m graphstack on Windows

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: MertCapkin

.github/workflows/ci.yml

@@ -37,7 +37,11 @@ jobs:
     runs-on: ${{ matrix.os }}
 
     steps:
+      # depth 2+ required: validate --fail-stale-graph matches graph commit to HEAD~1
+      # when graph artifacts land in a follow-up commit (v4.1 release pattern).
       - uses: actions/checkout@v4
+        with:
+          fetch-depth: 2
 
       - name: Set up Python
         uses: actions/setup-python@v5
@@ -120,10 +124,10 @@ jobs:
         run: python -m pytest scripts/graphstack/tests -v
 
       - name: Validate project layout (graphstack validate)
-        run: graphstack validate
+        run: python -m graphstack validate
 
       - name: Fail if knowledge graph is stale vs HEAD
-        run: graphstack validate --fail-stale-graph
+        run: python -m graphstack validate --fail-stale-graph
 
       - name: Board smoke test (Python module — cross-platform)
         shell: python

CHANGELOG.md

@@ -21,6 +21,7 @@ All notable changes to GraphStack are documented here.
 
 ### Fixed
 - **Graph staleness check** — `validate --fail-stale-graph` accepts `HEAD~1` when the graph was built before a dedicated graph-artifacts commit (common release workflow).
+- **CI validate job** — `actions/checkout` uses `fetch-depth: 2` (shallow clones hid `HEAD~1` and failed stale-graph checks); validate steps use `python -m graphstack` for Windows PATH reliability.
 
 ---
 

scripts/graphstack/validate.py

@@ -191,12 +191,27 @@ def _commit_matches_graph(graph_commit: str, ref: str) -> bool:
 
 
 def _refs_for_staleness_check() -> list[str]:
-    """HEAD and HEAD~1 — graph is often committed one commit after graphify runs."""
+    """HEAD, HEAD~1, and last commit that touched the graph report.
+
+    Graph is often built on HEAD~1 then committed on HEAD (release workflow).
+    GitHub Actions uses fetch-depth: 1 by default — without HEAD~1, fall back to
+    the commit that last modified GRAPH_REPORT.md (needs at least that commit).
+    """
     refs: list[str] = []
+    seen: set[str] = set()
     for arg in ("HEAD", "HEAD~1"):
         proc = run_git("rev-parse", arg)
         if proc.returncode == 0 and proc.stdout:
-            refs.append(proc.stdout.strip().lower())
+            ref = proc.stdout.strip().lower()
+            if ref not in seen:
+                seen.add(ref)
+                refs.append(ref)
+    proc = run_git("log", "-1", "--format=%H", "--", str(GRAPH_REPORT))
+    if proc.returncode == 0 and proc.stdout:
+        ref = proc.stdout.strip().lower()
+        if ref not in seen:
+            seen.add(ref)
+            refs.append(ref)
     return refs