From a4222473c3d95263b42bdbfed9e77bae334ebc70 Mon Sep 17 00:00:00 2001
From: carlos-alm <127798846+carlos-alm@users.noreply.github.com>
Date: Thu, 26 Mar 2026 22:08:33 -0600
Subject: [PATCH 1/3] fix(docs): sync README roadmap ordering with ROADMAP.md,
add cross-check to /release
---
.claude/skills/release/SKILL.md | 9 +++++++--
1 file changed, 7 insertions(+), 2 deletions(-)
diff --git a/.claude/skills/release/SKILL.md b/.claude/skills/release/SKILL.md
index 91fcdbf7..e262b41b 100644
--- a/.claude/skills/release/SKILL.md
+++ b/.claude/skills/release/SKILL.md
@@ -146,8 +146,13 @@ Read `README.md` and check if any new user-facing features from this release nee
2. **MCP tools table** — if new MCP tools were added, add them to the AI integration section
3. **Feature descriptions** — if a major new capability was added (new analysis type, new output format, etc.), add it to the relevant section
4. **Roadmap section** — if a phase status changed, update the roadmap summary at the bottom
-5. **Version references** — only update version-specific references (e.g., install commands). Historical milestone markers like "Complete (v3.0.0)" should stay as-is
-6. If nothing user-facing changed (pure refactors, bug fixes, internal improvements), no README update is needed
+5. **Roadmap ordering cross-check** — verify the README roadmap list matches `docs/roadmap/ROADMAP.md` in **phase order, phase names, and phase count**. ROADMAP.md is the source of truth. Specifically:
+ - Extract the phase sequence from both files
+ - If any phases are reordered, missing, renamed, or merged in README relative to ROADMAP.md, fix README to match
+ - Completed phases should keep their historical version markers (e.g., "Complete (v3.0.0)")
+ - This check runs every release, not only when phase status changes — drift accumulates silently
+6. **Version references** — only update version-specific references (e.g., install commands). Historical milestone markers like "Complete (v3.0.0)" should stay as-is
+7. If nothing user-facing changed (pure refactors, bug fixes, internal improvements), no README update is needed — **but still run the roadmap ordering cross-check (item 5)**
## Step 7: Verify package-lock.json
From 5324ec78e1d9cfd6010b5104cdd5c9083b96fdbc Mon Sep 17 00:00:00 2001
From: carlos-alm <127798846+carlos-alm@users.noreply.github.com>
Date: Thu, 26 Mar 2026 22:12:57 -0600
Subject: [PATCH 2/3] fix(docs): sync README roadmap phase ordering with
ROADMAP.md
---
README.md | 13 +++++++------
1 file changed, 7 insertions(+), 6 deletions(-)
diff --git a/README.md b/README.md
index 6d5a0390..8ddb23fc 100644
--- a/README.md
+++ b/README.md
@@ -773,12 +773,13 @@ See **[ROADMAP.md](docs/roadmap/ROADMAP.md)** for the full development roadmap a
6. ~~**Resolution Accuracy**~~ — **Complete** (v3.3.1) — type inference, receiver type tracking, dead role sub-categories, resolution benchmarks, `package.json` exports, monorepo workspace resolution
7. ~~**TypeScript Migration**~~ — **Complete** (v3.4.0) — all 271 source files migrated from JS to TS, zero `.js` remaining
8. **Native Analysis Acceleration** — **In Progress** (7 of 8 complete) — JS-only build phases moved to Rust, sub-100ms 1-file rebuilds remaining
-9. **Runtime & Extensibility** — event-driven pipeline, plugin system, query caching, pagination
-10. **Intelligent Embeddings** — LLM-generated descriptions, enhanced embeddings, module summaries
-11. **Natural Language Queries** — `codegraph ask` command, conversational sessions
-12. **Expanded Language Support** — 8 new languages (11 → 19)
-13. **GitHub Integration & CI** — reusable GitHub Action, LLM-enhanced PR review, SARIF output
-14. **Visualization & Advanced** — web UI, dead code detection, monorepo, agentic search
+9. **Expanded Language Support** — 8 new languages (11 → 19)
+10. **Runtime & Extensibility** — event-driven pipeline, plugin system, query caching, pagination
+11. **Quality, Security & Technical Debt** — supply-chain security (SBOM, SLSA), CI coverage gates, timer cleanup, tech debt kill list
+12. **Intelligent Embeddings** — LLM-generated descriptions, enhanced embeddings, module summaries
+13. **Natural Language Queries** — `codegraph ask` command, conversational sessions
+14. **GitHub Integration & CI** — reusable GitHub Action, LLM-enhanced PR review, SARIF output
+15. **Advanced Features** — dead code detection, monorepo support, agentic search
## 🤝 Contributing
From bc7ea7d364003734a86360c141ac9d5872232240 Mon Sep 17 00:00:00 2001
From: carlos-alm <127798846+carlos-alm@users.noreply.github.com>
Date: Thu, 26 Mar 2026 22:15:25 -0600
Subject: [PATCH 3/3] fix(docs): update Node badge from >=20 to >=22.6 to match
package.json engines
---
README.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/README.md b/README.md
index 8ddb23fc..28d2679e 100644
--- a/README.md
+++ b/README.md
@@ -12,7 +12,7 @@
- 
+ 