@plumpslabs/kuma 2.3.32 → 2.3.33

package/dist/index.js

@@ -1427,7 +1427,7 @@ var init_sessionMemory = __esm({
               dependencyGraph: new Map(parsed.dependencyGraph || []),
               toolCalls: parsed.toolCalls || [],
               conventions: parsed.conventions,
-              recordings: parsed.recordings || { archFlows: 0, gotchas: 0, decisions: 0, researchSaves: 0, total: 0 },
+              recordings: parsed.recordings || { archFlows: 0, gotchas: 0, decisions: 0, researchSaves: 0, features: 0, total: 0 },
               metrics: parsed.metrics || { filesRead: 0, filesEdited: 0, researchTimeSaved: 0 }
             };
             this.initialized = true;
@@ -1447,7 +1447,7 @@ var init_sessionMemory = __esm({
           searchResults: /* @__PURE__ */ new Map(),
           dependencyGraph: /* @__PURE__ */ new Map(),
           toolCalls: [],
-          recordings: { archFlows: 0, gotchas: 0, decisions: 0, researchSaves: 0, total: 0 },
+          recordings: { archFlows: 0, gotchas: 0, decisions: 0, researchSaves: 0, features: 0, total: 0 },
           metrics: { filesRead: 0, filesEdited: 0, researchTimeSaved: 0 }
         };
         this.initialized = true;
@@ -1610,6 +1610,18 @@ No unresolved issues.`;
         this.state.currentGoal = goal;
         this.save();
       }
+      setGoalProgress(percentage, milestone) {
+        this.ensureInit();
+        this.state.goalProgress = {
+          percentage: Math.min(100, Math.max(0, percentage)),
+          milestone,
+          updatedAt: Date.now()
+        };
+        this.save();
+      }
+      getGoalProgress() {
+        return this.state.goalProgress || null;
+      }
       addCompletedStep(step) {
         this.ensureInit();
         if (!this.state.completedSteps.includes(step)) {
@@ -2031,6 +2043,9 @@ No unresolved issues.`;
           case "research_save":
             this.state.recordings.researchSaves++;
             break;
+          case "feature":
+            this.state.recordings.features++;
+            break;
         }
         this.state.recordings.total++;
         this.save();
@@ -2047,6 +2062,7 @@ No unresolved issues.`;
         if (r.gotchas === 0) missing.push("gotcha");
         if (r.decisions === 0) missing.push("decision");
         if (r.researchSaves === 0) missing.push("research_save");
+        if (r.features === 0) missing.push("feature");
         return {
           ...r,
           hasAnyRecordings: r.total > 0,
@@ -7465,6 +7481,102 @@ function mineSessionInsights() {
       }
     }
   }
+  const dirReads = {};
+  for (const call of toolCalls) {
+    if (call.toolName === "read" || call.toolName === "browser_read") {
+      const file = call.params.filePath || "";
+      if (file) {
+        const dir = file.split("/").slice(0, -1).join("/") || "root";
+        if (!dirReads[dir]) dirReads[dir] = [];
+        dirReads[dir].push(file.split("/").pop() || file);
+      }
+    }
+  }
+  for (const [dir, files] of Object.entries(dirReads)) {
+    if (files.length >= 3) {
+      const dirName = dir.split("/").pop() || dir;
+      insights.push({
+        type: "feature",
+        scope: dir,
+        content: `${dirName} \u2014 ${files.length} files explored: ${files.slice(0, 5).join(", ")}${files.length > 5 ? "..." : ""}`,
+        confidence: 0.6,
+        source: `directory_exploration:${files.length}_files`
+      });
+    }
+  }
+  for (let i = 0; i < toolCalls.length - 1; i++) {
+    const a = toolCalls[i];
+    const b = toolCalls[i + 1];
+    if (a.toolName === "test" && b.toolName === "edit") {
+      const file = b.params.filePath || "";
+      if (file) {
+        insights.push({
+          type: "gotcha",
+          scope: file,
+          content: `Test failed then ${file.split("/").pop()} was edited \u2014 likely a bug fix needed`,
+          confidence: 0.7,
+          source: `test_fail_fix`
+        });
+      }
+    }
+  }
+  const importChain = [];
+  for (const call of toolCalls) {
+    if (call.toolName === "read" || call.toolName === "browser_read") {
+      const file = call.params.filePath || "";
+      if (file && file.endsWith(".ts")) {
+        importChain.push(file);
+      }
+    }
+  }
+  if (importChain.length >= 4) {
+    const uniqueFiles = [...new Set(importChain)];
+    if (uniqueFiles.length >= 3) {
+      insights.push({
+        type: "arch_flow",
+        scope: uniqueFiles[0],
+        content: `Import chain traced: ${uniqueFiles.slice(0, 5).map((f) => f.split("/").pop() || f).join(" \u2192 ")}`,
+        confidence: 0.6,
+        source: `import_chain:${uniqueFiles.length}_files`
+      });
+    }
+  }
+  const routeFiles = [];
+  for (const call of toolCalls) {
+    if (call.toolName === "read" || call.toolName === "browser_read") {
+      const file = call.params.filePath || "";
+      if (file && (file.includes("route") || file.includes("api") || file.includes("controller"))) {
+        routeFiles.push(file.split("/").pop() || file);
+      }
+    }
+  }
+  if (routeFiles.length >= 2) {
+    insights.push({
+      type: "feature",
+      scope: "api",
+      content: `API routes explored: ${routeFiles.slice(0, 5).join(", ")}`,
+      confidence: 0.5,
+      source: `api_route_discovery`
+    });
+  }
+  const componentFiles = [];
+  for (const call of toolCalls) {
+    if (call.toolName === "read" || call.toolName === "browser_read") {
+      const file = call.params.filePath || "";
+      if (file && (file.includes("component") || file.includes(".tsx") || file.includes(".jsx"))) {
+        componentFiles.push(file.split("/").pop() || file);
+      }
+    }
+  }
+  if (componentFiles.length >= 3) {
+    insights.push({
+      type: "arch_flow",
+      scope: "ui",
+      content: `UI components explored: ${componentFiles.slice(0, 5).join(", ")}`,
+      confidence: 0.6,
+      source: `component_discovery:${componentFiles.length}_files`
+    });
+  }
   return insights;
 }
 function formatMinedInsights(insights) {
@@ -7480,12 +7592,12 @@ function formatMinedInsights(insights) {
   ];
   for (let i = 0; i < insights.length; i++) {
     const ins = insights[i];
-    const icon = ins.type === "gotcha" ? "\u26A0\uFE0F" : ins.type === "decision" ? "\u{1F4CC}" : "\u{1F500}";
+    const icon = ins.type === "gotcha" ? "\u26A0\uFE0F" : ins.type === "decision" ? "\u{1F4CC}" : ins.type === "feature" ? "\u2B50" : "\u{1F500}";
     const conf = Math.round(ins.confidence * 100);
     lines.push(`${i + 1}. ${icon} **${ins.type}** (${conf}% confidence)`);
     lines.push(`   Scope: ${ins.scope}`);
     lines.push(`   ${ins.content}`);
-    lines.push(`   \u2192 \`kuma_memory({ action: "${ins.type}", ${ins.type === "arch_flow" ? "content" : 'scope: \\"${ins.scope}\\", content'}: "${ins.content.substring(0, 60)}..." })\``);
+    lines.push(`   \u2192 \`kuma_memory({ action: "${ins.type}", ${ins.type === "arch_flow" ? "content" : ins.type === "feature" ? `title: "\${ins.scope.split('/').pop() || ins.scope}", content` : 'scope: \\"${ins.scope}\\", content'}: "${ins.content.substring(0, 60)}..." })\``);
     lines.push("");
   }
   lines.push("\u{1F4A1} Approve by recording the ones you agree with. Skip the rest.");
@@ -9858,8 +9970,9 @@ function handleQuickrefGeneration(root, results) {
     "1. `init` \u2192 `guard` \u2192 `research` \u2192 `impact` \u2192 edit \u2192 `record` \u2192 `verify` \u2192 `changes`",
     "",
     "## Record Rules",
-    "- **MUST:** decision, gotcha",
+    "- **MUST:** decision, gotcha, arch_flow, research_save, feature",
     "- **SKIP:** function, class, import, route",
+    "- **RELATIONSHIPS:** Every node MUST have edges. No orphan nodes.",
     "",
     "## Platform Tool Names",
     "- OpenCode / Antigravity: `kuma_kuma_*`",
@@ -11066,6 +11179,11 @@ var CONTEXT_ALIASES = {
   "init": "init",
   "start": "init",
   "load": "init",
+  // Resume synonyms
+  "resume": "resume",
+  "continue": "resume",
+  "restore": "resume",
+  "reload": "resume",
   "brief": "init",
   "project": "init",
   "summary": "init",
@@ -11147,9 +11265,77 @@ async function handleContext(params) {
       return handleDrift(params);
     case "progressive":
       return handleProgressive(params);
+    case "resume":
+      return handleResume(params);
     default:
-      return `Unknown action "${action}". Use: init, research, impact, navigate, changes, rollback, researches, health, sync, visualize, digest, drift, progressive`;
+      return `Unknown action "${action}". Use: init, research, impact, navigate, changes, rollback, researches, health, sync, visualize, digest, drift, progressive, resume`;
+  }
+}
+async function handleResume(_params) {
+  sessionMemory.recordToolCall("kuma_context_resume", {});
+  const lines = [
+    "\u{1F504} **Kuma \u2014 Session Resume**",
+    `\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501`,
+    ""
+  ];
+  try {
+    const db = await getDb();
+    const res = db.exec(
+      "SELECT goal, tool_calls, edits, rollbacks, failures, safety_score, started_at FROM sessions ORDER BY started_at DESC LIMIT 1"
+    );
+    if (res[0]?.values.length) {
+      const row = res[0].values[0];
+      const goal = row[0] || "no goal";
+      const calls = row[1] || 0;
+      const edits = row[2] || 0;
+      const rollbacks = row[3] || 0;
+      const failures2 = row[4] || 0;
+      const safety = row[5] == null ? null : row[5];
+      const time = new Date(row[6] * 1e3).toLocaleString();
+      lines.push("**Last Session**");
+      lines.push(`  \u{1F3AF} Goal: ${goal.substring(0, 80)}`);
+      lines.push(`  \u{1F550} ${time}`);
+      lines.push(`  \u{1F527} ${calls} calls \xB7 \u{1F4DD} ${edits} edits \xB7 \u21A9 ${rollbacks} rollbacks \xB7 \u274C ${failures2} failures${safety != null ? ` \xB7 \u{1F6E1} safety ${safety}` : ""}`);
+      lines.push("");
+    }
+  } catch {
+  }
+  const summary = sessionMemory.getSummary();
+  lines.push("**Current State**");
+  lines.push(`  \u{1F3AF} Goal: ${summary.currentGoal || "not set"}`);
+  const progress = sessionMemory.getGoalProgress();
+  if (progress) {
+    lines.push(`  \u{1F4CA} Progress: ${progress.percentage}%${progress.milestone ? ` \u2014 ${progress.milestone}` : ""}`);
+  }
+  lines.push(`  \u{1F4DD} Modified: ${summary.modifiedFiles?.length || 0} file(s)`);
+  lines.push(`  \u2705 Completed steps: ${summary.completedSteps?.length || 0}`);
+  lines.push(`  \u{1F6E0}\uFE0F Tool calls: ${summary.toolCallCount}`);
+  lines.push(`  \u23F1\uFE0F Session duration: ${summary.sessionDuration}`);
+  const failures = summary.unresolvedFailures;
+  if (failures?.length) {
+    lines.push(`  \u26A0\uFE0F Unresolved failures: ${failures.length}`);
+  }
+  lines.push("");
+  try {
+    const changes = await getChanges({ limit: 5 });
+    if (changes && !changes.startsWith("No changes")) {
+      lines.push("**Recent Changes**");
+      lines.push(changes);
+      lines.push("");
+    }
+  } catch {
+  }
+  const history = sessionMemory.getToolCallHistory(5);
+  if (history.length) {
+    lines.push("**Recent Tool Calls**");
+    for (const h of history) {
+      const action = h.params?.action || "";
+      lines.push(`  \u{1F6E0} ${h.toolName}${action ? ` (${action})` : ""}`);
+    }
+    lines.push("");
   }
+  lines.push("\u{1F4A1} Continue: kuma_context({ action: 'research', scope: '<area>' }) to pick up where you left off.");
+  return lines.join("\n");
 }
 async function handleInit(_params) {
   sessionMemory.setGoal(_params.goal || "Exploring project");
@@ -11781,6 +11967,8 @@ async function handleMemory(params) {
       return handleAddNode(params);
     case "feature":
       return handleFeature(params);
+    case "goal_progress":
+      return handleGoalProgress(params);
     case "delete_node":
       return handleDeleteNode(params);
     case "graph_health":
@@ -11792,8 +11980,6 @@ async function handleMemory(params) {
     }
     case "harvest":
       return handleHarvest(params);
-    case "mine":
-      return handleMine(params);
     case "session_mine":
       return handleSessionMine(params);
     case "noise_policy":
@@ -12347,13 +12533,22 @@ async function handleFeature(params) {
     tags,
     risk
   });
-  sessionMemory.recordMemoryAction("research_save");
+  sessionMemory.recordMemoryAction("feature");
   return `\u2705 **Feature "${params.title}" recorded** \u2014 ${result.nodeCount} node(s), ${result.edgeCount} edge(s)
 \u2B50 Level: feature
 \u{1F4C1} Files: ${files.length}
 \u{1F3F7}\uFE0F Tags: ${tags.length}
 \u26A0\uFE0F Risk: ${risk}`;
 }
+async function handleGoalProgress(params) {
+  const pct = params.confidence ?? 0;
+  const ms = params.content || params.title;
+  sessionMemory.setGoalProgress(pct, ms);
+  const p = sessionMemory.getGoalProgress();
+  if (!p) return "Error";
+  const bar = "\u2588".repeat(Math.floor(p.percentage / 10)) + "\u2591".repeat(10 - Math.floor(p.percentage / 10));
+  return `\u{1F4CA} ${bar} ${p.percentage}%${p.milestone ? " \u2014 " + p.milestone : ""}`;
+}
 async function handleGraphHealth(_params) {
   const { getDb: getDb2 } = await Promise.resolve().then(() => (init_kumaDb(), kumaDb_exports));
   const db = await getDb2();
@@ -13417,6 +13612,14 @@ async function handleKumaGuard(params) {
         suggestion: "After tracing a flow, record it:\nkuma_memory({ action: 'arch_flow', content: 'domain: <Name> | hops: <file1> \u2192 <file2> \u2192 <file3>' })"
       });
     }
+    if (readCalls >= 5 && recordingSummary.features === 0) {
+      warnings.push({
+        severity: "low",
+        pattern: "explore-without-feature",
+        message: `${readCalls} file reads but 0 features recorded. High-level module understanding helps future sessions.`,
+        suggestion: "After exploring a module/feature, record it:\nkuma_memory({ action: 'feature', title: '<FeatureName>', content: 'description', scope: 'file1.ts,file2.ts' })"
+      });
+    }
   }
   if (check === "context") {
     const snapshot = saveSnapshot(stats.goal);
@@ -13774,7 +13977,7 @@ async function handleVerify(params) {
   } else if (recordingSummary.total > 0) {
     recordingWarning = `
 
-\u2705 **Recordings:** ${recordingSummary.total} total (${recordingSummary.archFlows} arch_flow, ${recordingSummary.gotchas} gotcha, ${recordingSummary.decisions} decision, ${recordingSummary.researchSaves} research_save)`;
+\u2705 **Recordings:** ${recordingSummary.total} total (${recordingSummary.archFlows} arch_flow, ${recordingSummary.gotchas} gotcha, ${recordingSummary.decisions} decision, ${recordingSummary.researchSaves} research_save, ${recordingSummary.features} feature)`;
   }
   sessionMemory.recordToolCall("kuma_safety_verify", { scope: params.scope || params.filePath });
   const { runAutoVerification: runAutoVerification2 } = await Promise.resolve().then(() => (init_kumaVerifier(), kumaVerifier_exports));
@@ -13855,7 +14058,7 @@ function registerAllTools(server) {
     "kuma_context",
     "**Call FIRST every session.** Understand your project before making changes.\n\nWORKFLOW:\n\u2022 STEP 1 (ALWAYS): `init` \u2014 load project brief, restore session\n\u2022 STEP 3 (BEFORE edits): `research` \u2014 5-step pipeline (cache\u2192staleness\u2192graph\u2192impact\u2192decision)\n\u2022 STEP 8 (END of session): `changes` \u2014 review what you modified\n\nOther actions: impact (analyze changes), navigate (trace flow), health (score 0-100), digest (compact briefing), drift (detect staleness).",
     {
-      action: z.enum(["init", "research", "impact", "navigate", "changes", "health", "rollback", "researches", "sync", "visualize", "digest", "drift", "progressive"]).describe("Action: init=project brief, research=5-step research pipeline (REQUIRED before edits), impact=analyze change effects, navigate=trace code flow, changes=view change log, rollback=undo a change by ID, researches=list all cached research, sync=unified batch state, visualize=Mermaid knowledge graph diagram, digest=ultra-compact <500 token project briefing (Issue #18), drift=detect memory staleness & code drift (Issue #20), progressive=progressive context loading (Issue #25), health=project health score"),
+      action: z.enum(["init", "research", "impact", "navigate", "changes", "health", "rollback", "researches", "sync", "visualize", "digest", "drift", "progressive", "resume"]).describe("Action: init=project brief, research=5-step research pipeline (REQUIRED before edits), impact=analyze change effects, navigate=trace code flow, changes=view change log, rollback=undo a change by ID, researches=list all cached research, sync=unified batch state, visualize=Mermaid knowledge graph diagram, digest=ultra-compact <500 token project briefing (Issue #18), drift=detect memory staleness & code drift (Issue #20), progressive=progressive context loading (Issue #25), health=project health score, resume=load previous session context (goal, progress, changes)"),
       scope: z.string().optional().describe("Research scope for research/progressive action"),
       target: z.string().optional().describe("Target symbol/file for impact/navigate/changes"),
       goal: z.string().optional().describe("Current goal (for init/health)"),
@@ -13883,9 +14086,9 @@ function registerAllTools(server) {
   );
   server.tool(
     "kuma_memory",
-    "**Call after research/editing** (including research-only). Record what matters, skip what doesn't.\n\n\u{1F534} MUST RECORD \u2014 High Impact (saves agent time next session):\n\u2022 STEP 5: `research_save` \u2014 after exploring area (creates search cache).\n\u2022 STEP 6: `gotcha` \u2014 IMMEDIATELY when you discover bugs/quirks. No re-research.\n\u2022 STEP 7: `arch_flow` \u2014 AFTER tracing COMPLETE flow (max 5 core files).\n\u2022 STEP 8: `decision` \u2014 IMMEDIATELY when choosing between options. Preserves rationale.\n\n\u{1F7E2} SKIP using MCP (agent native tools are faster):\n\u2022 Function/class nodes \u2192 grep\n\u2022 Component/route nodes \u2192 glob or check directly\n\u2022 Import edges \u2192 read imports directly\n\u2022 Visual graph \u2192 for humans, not AI agents\n\nOther actions: session, heal, search, changes, benchmark, layers.",
+    "**Call after research/editing** (including research-only). Record what matters, skip what doesn't.\n\n\u{1F534} MUST RECORD \u2014 High Impact (saves agent time next session):\n\u2022 STEP 5: `research_save` \u2014 after exploring area (creates search cache).\n\u2022 STEP 6: `gotcha` \u2014 IMMEDIATELY when you discover bugs/quirks. No re-research.\n\u2022 STEP 7: `arch_flow` \u2014 AFTER tracing COMPLETE flow (max 5 core files).\n\u2022 STEP 8: `decision` \u2014 IMMEDIATELY when choosing between options. Preserves rationale.\n\u2022 STEP 9: `feature` \u2014 WHEN identifying a high-level feature/module (e.g. Auth, Billing). Creates owns edges to files.\n\n\u{1F7E2} SKIP using MCP (agent native tools are faster):\n\u2022 Function/class nodes \u2192 grep\n\u2022 Component/route nodes \u2192 glob or check directly\n\u2022 Import edges \u2192 read imports directly\n\u2022 Visual graph \u2192 for humans, not AI agents\n\nOther actions: session, heal, search, changes, benchmark, layers.",
     {
-      action: z.enum(["decision", "mine", "research_save", "session", "heal", "search", "changes", "todo", "context", "benchmark", "decision_log", "domain_rules", "arch_flow", "gotcha", "layers", "add_node", "delete_node", "clear", "feature"]).describe("Memory action: decision=ADR, mine=mine git log & comments, research_save=save (creates file + graph node), session=summary, heal=repair, search=search (now with task retrieval + impact analysis), changes=log, todo=manage todos, context=inject notes, benchmark=capture/diff, decision_log=manage decisions, domain_rules=Layer 1 business rules, arch_flow=Layer 2 architecture flow (now auto-creates affects edges), gotcha=Layer 3 known gotchas, layers=all 3 layers summary, add_node=manually create function/class/component structural nodes, delete_node=delete a specific node/gotcha/todo/decision by ID or scope+target, clear=wipe all nodes/edges/gotchas, feature=record high-level feature with owns edges to files"),
+      action: z.enum(["decision", "mine", "research_save", "session", "heal", "search", "changes", "todo", "context", "benchmark", "decision_log", "domain_rules", "arch_flow", "gotcha", "layers", "add_node", "delete_node", "clear", "feature", "goal_progress"]).describe("Memory action: decision=ADR, mine=mine git log & comments, research_save=save (creates file + graph node), session=summary, heal=repair, search=search (now with task retrieval + impact analysis), changes=log, todo=manage todos, context=inject notes, benchmark=capture/diff, decision_log=manage decisions, domain_rules=Layer 1 business rules, arch_flow=Layer 2 architecture flow (now auto-creates affects edges), gotcha=Layer 3 known gotchas, layers=all 3 layers summary, add_node=manually create function/class/component structural nodes, delete_node=delete a specific node/gotcha/todo/decision by ID or scope+target, clear=wipe all nodes/edges/gotchas, feature=record high-level feature with owns edges to files, goal_progress=update goal completion percentage"),
       scope: z.string().optional().describe("Scope for research_save/search/todo/context/mine"),
       query: z.string().optional().describe("Search query for search action"),
       content: z.string().optional().describe("Content/notes for research_save / context"),
@@ -14056,6 +14259,14 @@ If no flags specified, you'll be prompted to select files interactively.
 }
 async function main() {
   const args = process.argv.slice(2);
+  if (args[0] === "--version" || args[0] === "-v" || args[0] === "version") {
+    console.log(`\u{1F43B} Kuma v${SERVER_VERSION}`);
+    process.exit(0);
+  }
+  if (args[0] === "--help" || args[0] === "-h" || args[0] === "help") {
+    printHelp();
+    process.exit(0);
+  }
   if (args[0] === "stop" && (args[1] === "--force" || args[1] === "-f")) {
     console.error(`\u{1F43B} Kuma v${SERVER_VERSION} \u2014 Kill Switch`);
     console.error("");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plumpslabs/kuma",
-  "version": "2.3.32",
+  "version": "2.3.33",
   "description": "Safety-first context & orchestration engine for AI coding agents. MCP server with mandatory research pipeline, knowledge graph, impact analysis, decision memory, and safety guard — works with any MCP client.",
   "type": "module",
   "main": "dist/index.js",

package/packages/ide/studio/dist/index.js

@@ -11,6 +11,7 @@ import { spawn } from "child_process";
 import { Hono } from "hono";
 
 // src/db.ts
+import crypto from "crypto";
 import fs from "fs";
 import path from "path";
 import { createRequire } from "module";
@@ -18,7 +19,8 @@ var require2 = createRequire(import.meta.url);
 var sqlJs = null;
 async function getSqlJs() {
   if (!sqlJs) {
-    sqlJs = await require2("sql.js");
+    const initSqlJs = await require2("sql.js");
+    sqlJs = await initSqlJs();
   }
   return sqlJs;
 }
@@ -75,7 +77,7 @@ function detectStaleNodes(db, dbPath) {
   try {
     const root = projectRootFromDb(dbPath);
     const stmt = db.prepare(
-      `SELECT file_path, COUNT(*) as cnt FROM nodes
+      `SELECT id, file_path, metadata, COUNT(*) as cnt FROM nodes
        WHERE file_path IS NOT NULL AND file_path != '' AND file_path NOT LIKE '%::%'
        GROUP BY file_path ORDER BY cnt DESC LIMIT 500`
     );
@@ -85,11 +87,28 @@ function detectStaleNodes(db, dbPath) {
     while (stmt.step()) {
       const row = stmt.getAsObject();
       const fp = row.file_path;
+      const metadata = row.metadata || "{}";
       checked++;
-      if (!fs.existsSync(path.join(root, fp))) {
+      const fullPath = path.join(root, fp);
+      if (!fs.existsSync(fullPath)) {
         const count = Number(row.cnt ?? 1);
-        missing.push({ filePath: fp, nodeCount: count });
+        missing.push({ filePath: fp, nodeCount: count, reason: "file_missing" });
         staleNodes += count;
+      } else {
+        try {
+          const parsed = JSON.parse(metadata);
+          const storedHash = parsed.contentHash;
+          if (storedHash) {
+            const content = fs.readFileSync(fullPath, "utf-8");
+            const currentHash = crypto.createHash("md5").update(content).digest("hex");
+            if (currentHash !== storedHash) {
+              const count = Number(row.cnt ?? 1);
+              missing.push({ filePath: fp, nodeCount: count, reason: "content_changed" });
+              staleNodes += count;
+            }
+          }
+        } catch {
+        }
       }
     }
     stmt.free();
@@ -143,26 +162,26 @@ async function getDashboardData() {
       )
     };
     const nodes = jsonRows(
-      `SELECT json_group_array(json_object('id',id,'name',name,'type',type,'file_path',file_path,'severity',COALESCE(severity,'medium'),'confidence',COALESCE(confidence,0.8),'metadata',COALESCE(metadata,'{}'))) FROM nodes ORDER BY updated_at DESC`
+      `SELECT json_group_array(json_object('id',id,'name',name,'type',type,'file_path',file_path,'severity',COALESCE(severity,'medium'),'confidence',COALESCE(confidence,0.8),'metadata',COALESCE(metadata,'{}'))) FROM (SELECT * FROM nodes ORDER BY updated_at DESC)`
     );
     const edges = jsonRows(
       `SELECT json_group_array(json_object('source',source_id,'target',target_id,'relation',type,'weight',weight)) FROM edges`
     );
     const gotchas = jsonRows(
-      `SELECT json_group_array(json_object('id',id,'file_path',file_path,'description',REPLACE(REPLACE(description,char(10),' '),char(13),''),'severity',severity,'workaround',REPLACE(REPLACE(COALESCE(workaround,''),char(10),' '),char(13),''),'added_by',COALESCE(added_by,'agent'),'created_at',created_at)) FROM known_gotchas ORDER BY severity DESC`
+      `SELECT json_group_array(json_object('id',id,'file_path',file_path,'description',REPLACE(REPLACE(description,char(10),' '),char(13),''),'severity',severity,'workaround',REPLACE(REPLACE(COALESCE(workaround,''),char(10),' '),char(13),''),'added_by',COALESCE(added_by,'agent'),'created_at',created_at)) FROM (SELECT * FROM known_gotchas ORDER BY created_at DESC)`
     );
     const features = jsonRows(
-      `SELECT json_group_array(json_object('id',id,'name',name,'metadata',COALESCE(metadata,'{}'))) FROM nodes WHERE type = 'feature' ORDER BY name`
+      `SELECT json_group_array(json_object('id',id,'name',name,'metadata',COALESCE(metadata,'{}'))) FROM (SELECT * FROM nodes WHERE type = 'feature' ORDER BY updated_at DESC)`
     );
     const health = jsonRows(
-      `SELECT json_group_array(json_object('score',score,'summary',REPLACE(REPLACE(COALESCE(summary,''),char(10),' '),char(13),''),'risk_level',risk_level,'created_at',created_at)) FROM health_snapshots ORDER BY created_at DESC LIMIT 10`
+      `SELECT json_group_array(json_object('score',score,'summary',REPLACE(REPLACE(COALESCE(summary,''),char(10),' '),char(13),''),'risk_level',risk_level,'created_at',created_at)) FROM (SELECT * FROM health_snapshots ORDER BY created_at DESC LIMIT 10)`
     );
     const sessionMetrics = readSessionMetrics(dbPath);
     const verifTotal = first(`SELECT COUNT(*) as c FROM verifications`, "c");
     const verifPassed = first(`SELECT COUNT(*) as c FROM verifications WHERE passed = 1`, "c");
     const recentSessions = run(
       `SELECT started_at, COALESCE(goal,'') as goal, tool_calls, edits, rollbacks, failures, safety_score
-       FROM sessions ORDER BY started_at DESC LIMIT 8`
+       FROM (SELECT * FROM sessions ORDER BY started_at DESC LIMIT 8)`
     ).map((r) => ({
       startedAt: Number(r.started_at ?? 0),
       goal: r.goal || "",
@@ -175,11 +194,10 @@ async function getDashboardData() {
     const efficiency = {
       sessions: first(`SELECT COUNT(*) as c FROM sessions`, "c"),
       toolCalls: first(`SELECT COUNT(*) as c FROM tool_calls`, "c"),
-      totalEdits: first(`SELECT COALESCE(SUM(edits),0) as c FROM sessions`, "c"),
-      totalRollbacks: first(`SELECT COALESCE(SUM(rollbacks),0) as c FROM sessions`, "c"),
-      totalFailures: first(`SELECT COALESCE(SUM(failures),0) as c FROM sessions`, "c"),
+      gotchas: first(`SELECT COUNT(*) as c FROM known_gotchas`, "c"),
+      archFlows: sessionMetrics.recordings.archFlows,
+      decisions: first(`SELECT COUNT(*) as c FROM (SELECT id FROM decision_log UNION SELECT id FROM nodes WHERE type = 'decision')`, "c"),
       researchCacheScopes: first(`SELECT COUNT(*) as c FROM research_cache`, "c"),
-      decisions: first(`SELECT COUNT(*) as c FROM decision_log`, "c"),
       verifications: verifTotal,
       verificationPassRate: verifTotal > 0 ? Math.round(verifPassed / verifTotal * 100) : null,
       metrics: sessionMetrics.metrics,