@davesheffer/hunch 1.2.2 → 1.2.3

package/README.md

@@ -44,6 +44,8 @@ guards, troubleshooting. This README is the tour. Jump to:
 [CLI reference](https://hunch-pi.vercel.app/docs#cli) ·
 [Troubleshooting](https://hunch-pi.vercel.app/docs#doctor)
 
+> 🆕 **v1.2.2** — the [component wiki + specs ledger](https://hunch-pi.vercel.app/docs#wiki): Hunch takes over your stale docs — graded deterministically, adopted into a graph-healed wiki copy, never rewriting your originals — with staleness drift-gated in CI. Plus honest auto-commit reporting, a friendly Node < 22.13 gate, and churn-free reindexing. [Full changelog →](https://hunch-pi.vercel.app/changelog)
+
 ## The problem
 
 Every AI coding session starts from zero. The model re-reads your code, re-guesses the

package/dist/cli/index.js

@@ -150,11 +150,17 @@ program
     else {
         console.log("  ⚠ not a git repo — skipped hooks (run `git init` to enable the learning loop)");
     }
-    const mcp = writeMcpJson(root, inv.mcp);
     // .mcp.json is the CANONICAL registration: Claude Code resolves it by file path,
     // so it's immune to the Windows ~/.claude.json drive-letter case-split that a
-    // global `claude mcp add` is prone to (see `hunch doctor`).
-    console.log(`  ✓ wrote ${rel(root, mcp)} (registers the Hunch MCP server — canonical, path-keyed; prefer over a global \`claude mcp add\`)`);
+    // global `claude mcp add` is prone to (see `hunch doctor`). An unparseable
+    // existing file is refused (con_8460b6770f) — warn and continue, never clobber.
+    try {
+        const mcp = writeMcpJson(root, inv.mcp);
+        console.log(`  ✓ wrote ${rel(root, mcp)} (registers the Hunch MCP server — canonical, path-keyed; prefer over a global \`claude mcp add\`)`);
+    }
+    catch (e) {
+        console.log(`  ⚠ skipped .mcp.json: ${e.message}`);
+    }
     const cmds = writeSlashCommands(root);
     console.log(`  ✓ wrote ${cmds.length} slash commands (/hunch-why, /hunch-fix, /hunch-fragile)`);
     const cmd = updateClaudeMd(root, store);

package/dist/extractors/indexer.js

@@ -191,7 +191,11 @@ export function indexRepo(store, root, opts = {}) {
 // ---- helpers --------------------------------------------------------------
 function listCodeFiles(root) {
     if (isGitRepo(root)) {
-        const tracked = trackedFiles(root, CODE_EXTS).map((f) => join(root, f));
+        // Apply SKIP_DIRS to the git-tracked list too: a repo that (accidentally)
+        // tracks node_modules/ or dist/ must not flood the graph with vendored symbols.
+        const tracked = trackedFiles(root, CODE_EXTS)
+            .filter((f) => !f.split(/[\\/]/).some((seg) => SKIP_DIRS.has(seg)))
+            .map((f) => join(root, f));
         if (tracked.length > 0)
             return tracked; // else fall through (nothing committed yet)
     }

package/dist/integrations/scaffold.js

@@ -5,16 +5,25 @@
  */
 import { readFileSync, writeFileSync, existsSync, mkdirSync } from "node:fs";
 import { join, dirname } from "node:path";
-/** Merge a `hunch` server entry into .mcp.json, preserving other servers. */
+/** Merge a `hunch` server entry into .mcp.json, preserving other servers.
+ *  A non-empty file we cannot parse THROWS instead of being silently replaced
+ *  (con_8460b6770f — it may hold the user's other MCP servers); the caller
+ *  degrades that to a warning. */
 export function writeMcpJson(root, inv) {
     const file = join(root, ".mcp.json");
     let json = {};
     if (existsSync(file)) {
-        try {
-            json = JSON.parse(readFileSync(file, "utf8"));
-        }
-        catch {
-            json = {};
+        const raw = readFileSync(file, "utf8");
+        if (raw.trim()) {
+            try {
+                const v = JSON.parse(raw);
+                if (!v || typeof v !== "object" || Array.isArray(v))
+                    throw new Error("not a JSON object");
+                json = v;
+            }
+            catch (e) {
+                throw new Error(`refusing to overwrite ${file}: could not parse it (${e.message}). Fix or remove it, then re-run.`);
+            }
         }
     }
     json.mcpServers = json.mcpServers ?? {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@davesheffer/hunch",
-  "version": "1.2.2",
+  "version": "1.2.3",
   "license": "Apache-2.0",
   "author": "Dave Sheffer <dave.sheffer1@gmail.com>",
   "description": "Architectural Conformance for AI-generated code: a git-native graph that deterministically blocks AI changes which break your architecture — the semantic invariants (layering, must-reach, dependency direction) pattern-SAST can't express — grounded in the decisions and bugs behind each rule, across any MCP assistant (Claude Code, Cursor, Copilot, Windsurf, Codex).",