@plumpslabs/kuma 2.4.16 → 2.4.19

package/dist/index.js

@@ -1220,8 +1220,8 @@ async function runDoctor() {
     } catch {
     }
     try {
-      const { execSync: execSync10 } = await import("child_process");
-      const psOutput = execSync10(
+      const { execSync: execSync11 } = await import("child_process");
+      const psOutput = execSync11(
         `ps -eo pid,ppid,command | grep -E "(jest|pnpm test|npm test|yarn test)" | grep -v grep | head -10`,
         { encoding: "utf-8", timeout: 5e3 }
       ).trim();
@@ -3366,6 +3366,33 @@ async function scanCodebase(options = {}) {
     }
   }
   const db = await getDb();
+  const ensureFileNode = async (relPath) => {
+    const fid = nodeId("file", relPath);
+    try {
+      const chk = db.prepare(`SELECT 1 FROM nodes WHERE id = ? LIMIT 1`);
+      chk.bind([fid]);
+      const exists = chk.step();
+      chk.free();
+      if (!exists) {
+        await upsertNode({ id: fid, type: "file", name: relPath, filePath: relPath, metadata: { backbone: true } });
+        result.nodeCount++;
+      }
+    } catch {
+    }
+    return fid;
+  };
+  const nodeExists = (id) => {
+    try {
+      const chk = db.prepare(`SELECT 1 FROM nodes WHERE id = ? LIMIT 1`);
+      chk.bind([id]);
+      const exists = chk.step();
+      chk.free();
+      return exists;
+    } catch {
+      return false;
+    }
+  };
+  const pendingCalls = [];
   for (const parsed of parsedFiles) {
     const { filePath, symbols, imports, calledSymbols, isTest } = parsed;
     const fileId = nodeId("file", filePath);
@@ -3421,14 +3448,16 @@ async function scanCodebase(options = {}) {
       if (sym.extends) {
         const parentFile = symbolMap.get(sym.extends) || filePath;
         const parentId = `class::${parentFile}::${sym.extends}`;
-        await addEdge({ sourceId: symId, targetId: parentId, type: "extends" });
-        result.edgeCount++;
+        if (nodeExists(parentId)) {
+          await addEdge({ sourceId: symId, targetId: parentId, type: "extends" });
+          result.edgeCount++;
+        }
       }
     }
     for (const imp of imports) {
       const resolved = resolveImportPath(filePath, imp.source, root);
       if (resolved) {
-        const targetFileId = nodeId("file", resolved);
+        const targetFileId = await ensureFileNode(resolved);
         await addEdge({
           sourceId: fileId,
           targetId: targetFileId,
@@ -3449,17 +3478,17 @@ async function scanCodebase(options = {}) {
     for (const callee of calledSymbols) {
       const calleeFile = symbolMap.get(callee);
       if (calleeFile && calleeFile !== filePath) {
-        const calleeId = `function::${calleeFile}::${callee}`;
-        await addEdge({
-          sourceId: fileId,
-          targetId: calleeId,
-          type: "calls"
-        });
-        result.edgeCount++;
+        pendingCalls.push({ fileId, callee, calleeFile, filePath });
       }
     }
     result.filesScanned++;
   }
+  for (const p of pendingCalls) {
+    const calleeId = `function::${p.calleeFile}::${p.callee}`;
+    if (!nodeExists(calleeId)) continue;
+    await addEdge({ sourceId: p.fileId, targetId: calleeId, type: "calls" });
+    result.edgeCount++;
+  }
   saveDb(db);
   return result;
 }
@@ -3957,13 +3986,18 @@ var init_kumaSelfHeal = __esm({
 // src/engine/kumaDriftDetector.ts
 var kumaDriftDetector_exports = {};
 __export(kumaDriftDetector_exports, {
+  DRIFT_REPORT_FILE: () => DRIFT_REPORT_FILE,
+  DRIFT_REPORT_MAX_ITEMS: () => DRIFT_REPORT_MAX_ITEMS,
   computeProjectHash: () => computeProjectHash,
   computeScopeHash: () => computeScopeHash,
   detectDrift: () => detectDrift,
   flagStaleRecords: () => flagStaleRecords,
   formatDriftReport: () => formatDriftReport,
   getDriftSummary: () => getDriftSummary,
-  hashFile: () => hashFile
+  hashFile: () => hashFile,
+  readDriftReport: () => readDriftReport,
+  toDriftActionItem: () => toDriftActionItem,
+  writeDriftReport: () => writeDriftReport
 });
 import fs7 from "fs";
 import path9 from "path";
@@ -4184,13 +4218,51 @@ async function getDriftSummary() {
   if (staleCount === 0) return "\u2705 All records fresh";
   return `\u26A0\uFE0F ${staleCount} stale record(s) detected. Use kuma_memory({ action: 'heal' }) to repair.`;
 }
-var computeProjectHash;
+function toDriftActionItem(r) {
+  const stale = r.severity === "stale";
+  const missing = r.severity === "missing";
+  const action = r.source === "research_cache" ? `re-run kuma_context({ action: 'research', scope: '${r.description}' })` : r.filePath ? `rescan '${r.filePath}' (touch via any context call) or run heal` : `run kuma_memory({ action: 'heal' }) to repair`;
+  return {
+    id: `${r.source}#${r.id}`,
+    kind: r.source,
+    target: r.filePath || r.description,
+    reason: missing ? "source gone (file/record missing)" : `content hash mismatch vs current (age ${r.age})`,
+    action: stale || missing ? action : "monitor"
+  };
+}
+async function writeDriftReport(maxItems = DRIFT_REPORT_MAX_ITEMS) {
+  const fp = path9.join(getProjectRoot(), DRIFT_REPORT_FILE);
+  const records = await detectDrift();
+  const actionable = records.filter((r) => r.severity === "stale" || r.severity === "missing");
+  const items = actionable.slice(0, maxItems).map(toDriftActionItem);
+  try {
+    fs7.writeFileSync(
+      fp,
+      JSON.stringify({ generatedAt: (/* @__PURE__ */ new Date()).toISOString(), count: actionable.length, items }, null, 2),
+      "utf-8"
+    );
+  } catch {
+  }
+  return { items: items.length, path: fp };
+}
+function readDriftReport() {
+  try {
+    const fp = path9.join(getProjectRoot(), DRIFT_REPORT_FILE);
+    if (!fs7.existsSync(fp)) return null;
+    return JSON.parse(fs7.readFileSync(fp, "utf-8"));
+  } catch {
+    return null;
+  }
+}
+var computeProjectHash, DRIFT_REPORT_FILE, DRIFT_REPORT_MAX_ITEMS;
 var init_kumaDriftDetector = __esm({
   "src/engine/kumaDriftDetector.ts"() {
     "use strict";
     init_kumaDb();
     init_pathValidator();
     computeProjectHash = (scope) => computeScopeHash(scope) || Date.now().toString(16);
+    DRIFT_REPORT_FILE = ".kuma/drift.json";
+    DRIFT_REPORT_MAX_ITEMS = 20;
   }
 });
 
@@ -4598,12 +4670,17 @@ __export(mapBackbone_exports, {
   ensureMapped: () => ensureMapped,
   extractImportSources: () => extractImportSources,
   formatBackbone: () => formatBackbone,
+  getWorktreeChangedFiles: () => getWorktreeChangedFiles,
   isMapEmpty: () => isMapEmpty,
-  readMapMeta: () => readMapMeta
+  isWorktreeDirty: () => isWorktreeDirty,
+  readMapMeta: () => readMapMeta,
+  readWorktreeDirty: () => readWorktreeDirty,
+  updateWorktreeDirty: () => updateWorktreeDirty
 });
 import fs9 from "fs";
 import path11 from "path";
 import fastGlob3 from "fast-glob";
+import { execSync as execSync4 } from "child_process";
 function extractImportSources(line) {
   const out = [];
   const t = line.trim();
@@ -4743,6 +4820,52 @@ async function ensureBackbone() {
 function formatBackbone(r) {
   return `\u{1F5FA}\uFE0F Backbone: ${r.files} file(s)${r.capped ? ` (capped at ${BACKBONE_MAX_FILES})` : ""}, ${r.edges} import edge(s) in ${r.ms}ms (~${r.filesPerSec} files/s) \u2014 approximate tier, symbols fill in on demand.`;
 }
+function getWorktreeChangedFiles(root, cap = WORKTREE_CAP) {
+  const out = [];
+  try {
+    const cwd = root || getProjectRoot();
+    const porcelain = execSync4("git status --porcelain --untracked-files=all", {
+      cwd,
+      encoding: "utf-8",
+      timeout: 5e3,
+      stdio: ["pipe", "pipe", "pipe"]
+    });
+    if (!porcelain.trim()) return out;
+    for (const rawLine of porcelain.split("\n")) {
+      if (out.length >= cap) break;
+      const line = rawLine.replace(/\s+$/, "");
+      if (!line) continue;
+      const m = line.match(/^(.{2})\s+(.+)$/);
+      if (!m) continue;
+      const code = m[1];
+      let p = m[2].trim();
+      const arrow = p.indexOf(" -> ");
+      if (arrow >= 0) p = p.slice(arrow + 4).trim();
+      p = p.replace(/^"|"$/g, "");
+      if (!p) continue;
+      const ext = p.slice(p.lastIndexOf(".")).toLowerCase();
+      if (!WORKTREE_EXTS.has(ext)) continue;
+      const untracked = code[0] === "?" || code[1] === "?";
+      out.push({ file: p, state: untracked ? "untracked" : "modified" });
+    }
+  } catch {
+  }
+  return out;
+}
+function updateWorktreeDirty(files, root) {
+  writeMapMeta({ worktreeDirty: [...new Set(files)].slice(0, WORKTREE_CAP), worktreeDirtyAt: Date.now() }, root);
+}
+function readWorktreeDirty(root) {
+  const meta = readMapMeta(root);
+  return Array.isArray(meta.worktreeDirty) ? meta.worktreeDirty.filter((f) => typeof f === "string") : [];
+}
+function isWorktreeDirty(target, root) {
+  const norm = target.replace(/\\/g, "/");
+  return readWorktreeDirty(root).some((f) => {
+    const nf = f.replace(/\\/g, "/");
+    return nf === norm || nf.endsWith(`/${norm}`) || norm.endsWith(`/${nf}`);
+  });
+}
 async function ensureMapped(files) {
   const targets = [...new Set(files.map((f) => f.trim()).filter(Boolean))].slice(0, 10);
   if (targets.length === 0) return { filled: 0 };
@@ -4773,7 +4896,7 @@ async function ensureMapped(files) {
     return { filled: 0 };
   }
 }
-var BACKBONE_MAX_FILES, MAP_META, IMPORT_RES;
+var BACKBONE_MAX_FILES, MAP_META, IMPORT_RES, WORKTREE_CAP, WORKTREE_EXTS;
 var init_mapBackbone = __esm({
   "src/engine/mapBackbone.ts"() {
     "use strict";
@@ -4788,6 +4911,31 @@ var init_mapBackbone = __esm({
       /(?:from)\s+["']?([a-zA-Z0-9_./-]+)["']?\s+import\s+/g,
       /require\s*\(\s*['"]([^'"]+)['"]\s*\)/g
     ];
+    WORKTREE_CAP = 50;
+    WORKTREE_EXTS = /* @__PURE__ */ new Set([
+      ".ts",
+      ".tsx",
+      ".js",
+      ".jsx",
+      ".mjs",
+      ".cjs",
+      ".py",
+      ".go",
+      ".rs",
+      ".java",
+      ".rb",
+      ".php",
+      ".swift",
+      ".kt",
+      ".cs",
+      ".vue",
+      ".svelte",
+      ".json",
+      ".yml",
+      ".yaml",
+      ".toml",
+      ".md"
+    ]);
   }
 });
 
@@ -4799,7 +4947,7 @@ __export(symbolReach_exports, {
 });
 import fs10 from "fs";
 import path12 from "path";
-import { execSync as execSync4 } from "child_process";
+import { execSync as execSync5 } from "child_process";
 async function graphReach(symbol, limit) {
   const rows = [];
   try {
@@ -4851,7 +4999,7 @@ async function graphReach(symbol, limit) {
 function ripgrepReach(symbol, root, limit) {
   const rows = [];
   try {
-    const out = execSync4(
+    const out = execSync5(
       `grep -rn -F --include="*.ts" --include="*.tsx" --include="*.js" --include="*.jsx" --include="*.py" --include="*.go" --include="*.rs" "${symbol.replace(/"/g, "")}" . 2>/dev/null | grep -v node_modules | grep -v "/dist/" | grep -v "/.git/" | grep -v "/.kuma/" | head -40`,
       { cwd: root, encoding: "utf-8", timeout: 8e3, maxBuffer: 256 * 1024 }
     ).trim();
@@ -5026,7 +5174,7 @@ __export(impactAnalysis_exports, {
 });
 import fs11 from "fs";
 import path13 from "path";
-import { execSync as execSync5 } from "child_process";
+import { execSync as execSync6 } from "child_process";
 import fastGlob4 from "fast-glob";
 function extOf(target) {
   const base = path13.basename(target);
@@ -5047,7 +5195,7 @@ function classifyDiffShape(target, root) {
   }
   try {
     const cwd = root || getProjectRoot();
-    const diff = execSync5(`git diff --unified=0 -- "${target}"`, {
+    const diff = execSync6(`git diff --unified=0 -- "${target}"`, {
       cwd,
       encoding: "utf-8",
       timeout: 4e3,
@@ -5313,6 +5461,14 @@ async function calculateBlastRadius(target, options = {}) {
     const rev = getReverseDependencies(owningPackage.name, wsInfo);
     downstreamPackages.push(...rev.map((p) => p.name));
   }
+  let worktreeNote = "";
+  try {
+    const { isWorktreeDirty: isWorktreeDirty2 } = await Promise.resolve().then(() => (init_mapBackbone(), mapBackbone_exports));
+    if (targetType === "file" && isWorktreeDirty2(target, root)) {
+      worktreeNote = "\u{1F4DD} Uncommitted worktree changes on this target \u2014 map reflects work in progress, not committed state";
+    }
+  } catch {
+  }
   if (targetType === "file") {
     try {
       const { ensureMapped: ensureMapped2 } = await Promise.resolve().then(() => (init_mapBackbone(), mapBackbone_exports));
@@ -5380,6 +5536,7 @@ async function calculateBlastRadius(target, options = {}) {
     `\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\u2501`,
     `\u26A0\uFE0F **Risk Level: ${risk.toUpperCase()}**`,
     `\u{1F4D0} Diff shape: \`${diffShape}\` (${shapeDetail})`,
+    ...worktreeNote ? [worktreeNote] : [],
     owningPackage ? `\u{1F4E6} Owning package: \`${owningPackage.name}\` (${owningPackage.path})` : ""
   ];
   if (riskFlags.length > 0) {
@@ -5643,6 +5800,7 @@ __export(kumaGraph_exports, {
   getGraphStats: () => getGraphStats,
   nodeId: () => nodeId,
   propagateImpact: () => propagateImpact,
+  pruneOrphans: () => pruneOrphans,
   queryGraph: () => queryGraph,
   recordAffects: () => recordAffects,
   recordApiRoute: () => recordApiRoute,
@@ -5719,6 +5877,48 @@ async function pruneGraphIfNeeded() {
     return { pruned: false, removedNodes: 0, removedEdges: 0 };
   }
 }
+async function pruneOrphans(opts = {}) {
+  const olderThanSec = opts.olderThanSec ?? 3600;
+  const dryRun = opts.dryRun ?? false;
+  let orphanNodes = 0;
+  let danglingEdges = 0;
+  try {
+    const db = await getDb();
+    const cutoff = Math.floor(Date.now() / 1e3) - olderThanSec;
+    const dangling = db.exec(`
+      SELECT COUNT(*) FROM edges e
+      WHERE NOT EXISTS (SELECT 1 FROM nodes n WHERE n.id = e.target_id)
+         OR NOT EXISTS (SELECT 1 FROM nodes n WHERE n.id = e.source_id)
+    `);
+    danglingEdges = Number(dangling[0]?.values?.[0]?.[0]) || 0;
+    if (!dryRun && danglingEdges > 0) {
+      db.exec(`
+        DELETE FROM edges
+        WHERE NOT EXISTS (SELECT 1 FROM nodes n WHERE n.id = edges.target_id)
+           OR NOT EXISTS (SELECT 1 FROM nodes n WHERE n.id = edges.source_id)
+      `);
+    }
+    const orphans = db.exec(`
+      SELECT COUNT(*) FROM nodes n
+      WHERE n.type IN ('file','function','class','method','interface','test','feature_domain','arch_flow')
+        AND n.updated_at < ${cutoff}
+        AND NOT EXISTS (SELECT 1 FROM edges e WHERE e.source_id = n.id OR e.target_id = n.id)
+    `);
+    orphanNodes = Number(orphans[0]?.values?.[0]?.[0]) || 0;
+    if (!dryRun && orphanNodes > 0) {
+      db.exec(`
+        DELETE FROM nodes
+        WHERE type IN ('file','function','class','method','interface','test','feature_domain','arch_flow')
+          AND updated_at < ${cutoff}
+          AND id NOT IN (SELECT source_id FROM edges UNION SELECT target_id FROM edges)
+      `);
+    }
+    if (!dryRun && (orphanNodes > 0 || danglingEdges > 0)) saveDb(db);
+  } catch (err) {
+    console.error(`[KumaGraph] pruneOrphans failed: ${err}`);
+  }
+  return { orphanNodes, danglingEdges };
+}
 async function upsertNode(node) {
   try {
     const db = await getDb();
@@ -5833,6 +6033,9 @@ async function recordApiRoute(route, handler) {
 async function recordDomainFlow(params) {
   let nodeCount = 0;
   let edgeCount = 0;
+  if (!params.hops || params.hops.length === 0) {
+    return { nodeCount, edgeCount };
+  }
   try {
     const domainId = nodeId("feature_domain", params.domain);
     let fileHashes = {};
@@ -6712,9 +6915,9 @@ ${summary}`;
 }
 async function codebaseImpactFallback(target) {
   try {
-    const { execSync: execSync10 } = await import("child_process");
+    const { execSync: execSync11 } = await import("child_process");
     const root = process.cwd();
-    const grepResult = execSync10(
+    const grepResult = execSync11(
       `grep -rn ${grepIncludeFlags()} --include="*.json" --include="*.md" -l "${target.replace(/"/g, '\\"')}" . 2>/dev/null | grep -v node_modules | grep -v .git | grep -v dist | grep -v .kuma | head -50`,
       { cwd: root, encoding: "utf-8", timeout: 5e3, maxBuffer: 256 * 1024 }
     ).trim();
@@ -6860,7 +7063,7 @@ __export(kumaShared_exports, {
   isReadTool: () => isReadTool,
   isTestTool: () => isTestTool
 });
-import { execSync as execSync6 } from "child_process";
+import { execSync as execSync7 } from "child_process";
 import fs12 from "fs";
 import path14 from "path";
 function isEditTool(toolName) {
@@ -6900,7 +7103,7 @@ function getSessionStats(inputGoal) {
 function getGitDiffStat(timeout = 3e3) {
   try {
     const root = getProjectRoot();
-    return execSync6("git diff --stat", {
+    return execSync7("git diff --stat", {
       cwd: root,
       encoding: "utf-8",
       timeout
@@ -6913,13 +7116,16 @@ function getUncommittedFiles(timeout = 3e3) {
   const files = /* @__PURE__ */ new Set();
   try {
     const root = getProjectRoot();
-    const porcelain = execSync6("git status --porcelain", {
+    const porcelain = execSync7("git status --porcelain", {
       cwd: root,
       encoding: "utf-8",
       timeout,
       stdio: ["pipe", "pipe", "pipe"]
-    }).trim();
-    for (const line of porcelain.split("\n")) {
+    });
+    if (!porcelain.trim()) return files;
+    for (const rawLine of porcelain.split("\n")) {
+      const line = rawLine.replace(/\s+$/, "");
+      if (!line) continue;
       const m = line.match(/^.{3}(.+?)(?:\s+->\s+.+)?$/);
       if (m && m[1]) files.add(m[1].trim().replace(/^"|"$/g, ""));
     }
@@ -6932,17 +7138,17 @@ function getBranchCommittedFiles(timeout = 5e3) {
   let base = "";
   try {
     const root = getProjectRoot();
-    const branch = execSync6("git rev-parse --abbrev-ref HEAD", {
+    const branch = execSync7("git rev-parse --abbrev-ref HEAD", {
       cwd: root,
       encoding: "utf-8",
       timeout,
       stdio: ["pipe", "pipe", "pipe"]
     }).trim();
-    const baseRef = execSync6(
+    const baseRef = execSync7(
       `git symbolic-ref refs/remotes/origin/HEAD 2>/dev/null || echo origin/${branch === "main" || branch === "master" ? "HEAD" : "main"}`,
       { cwd: root, encoding: "utf-8", timeout, stdio: ["pipe", "pipe", "pipe"] }
     ).trim().replace("refs/remotes/", "");
-    const mergeBase = execSync6(`git merge-base HEAD ${baseRef} 2>/dev/null || git rev-list --max-parents=0 HEAD`, {
+    const mergeBase = execSync7(`git merge-base HEAD ${baseRef} 2>/dev/null || git rev-list --max-parents=0 HEAD`, {
       cwd: root,
       encoding: "utf-8",
       timeout,
@@ -6950,7 +7156,7 @@ function getBranchCommittedFiles(timeout = 5e3) {
     }).trim().split("\n")[0];
     base = baseRef;
     if (mergeBase) {
-      const out = execSync6(`git diff --name-only ${mergeBase} HEAD`, {
+      const out = execSync7(`git diff --name-only ${mergeBase} HEAD`, {
         cwd: root,
         encoding: "utf-8",
         timeout,
@@ -7074,7 +7280,7 @@ function detectTestWeakening(files, root) {
   for (const f of files) {
     if (!TEST_FILE_PATTERN.test(f)) continue;
     try {
-      const diff = execSync6(`git diff --unified=0 -- "${f}"`, {
+      const diff = execSync7(`git diff --unified=0 -- "${f}"`, {
         cwd,
         encoding: "utf-8",
         timeout: 4e3,
@@ -10307,7 +10513,7 @@ __export(docDrift_exports, {
 });
 import fs29 from "fs";
 import path32 from "path";
-import { execSync as execSync9 } from "child_process";
+import { execSync as execSync10 } from "child_process";
 function collectDocFiles(root) {
   const cwd = root || getProjectRoot();
   const out = [];
@@ -10366,7 +10572,7 @@ function codeContainsBatch(root, needles) {
     const chunk = clean.slice(i, i + 50);
     try {
       const args = chunk.map((n) => `-e "${n}"`).join(" ");
-      const out = execSync9(
+      const out = execSync10(
         `grep -rn --include="*.ts" --include="*.js" --include="*.tsx" --include="*.jsx" --include="*.py" --include="*.go" --include="*.rs" --include="*.json" --include="*.yml" --include="*.yaml" --include="*.toml" --include=".env*" -F ${args} . 2>/dev/null | grep -v node_modules | grep -v "/dist/" | grep -v "/.git/" | grep -v "/.kuma/" | head -100`,
         { cwd: root, encoding: "utf-8", timeout: 8e3, maxBuffer: 256 * 1024 }
       ).trim();
@@ -10570,14 +10776,14 @@ async function createCheckpoint(label, description) {
     let gitHead;
     let isGitClean = false;
     try {
-      const { execSync: execSync10 } = await import("child_process");
-      gitHead = execSync10("git rev-parse HEAD", {
+      const { execSync: execSync11 } = await import("child_process");
+      gitHead = execSync11("git rev-parse HEAD", {
         cwd: root,
         encoding: "utf-8",
         timeout: 3e3,
         stdio: ["pipe", "pipe", "pipe"]
       }).trim();
-      const statusOut = execSync10("git status --porcelain", {
+      const statusOut = execSync11("git status --porcelain", {
         cwd: root,
         encoding: "utf-8",
         timeout: 3e3,
@@ -10588,8 +10794,8 @@ async function createCheckpoint(label, description) {
     }
     const candidatePaths = /* @__PURE__ */ new Set();
     try {
-      const { execSync: execSync10 } = await import("child_process");
-      const gitOut = execSync10("git status --porcelain", {
+      const { execSync: execSync11 } = await import("child_process");
+      const gitOut = execSync11("git status --porcelain", {
         cwd: root,
         encoding: "utf-8",
         timeout: 4e3,
@@ -10718,8 +10924,8 @@ ${listCheckpoints()}`;
     }
     if (manifest.files.length === 0 && manifest.gitHead) {
       try {
-        const { execSync: execSync10 } = await import("child_process");
-        execSync10(`git checkout ${manifest.gitHead} -- .`, {
+        const { execSync: execSync11 } = await import("child_process");
+        execSync11(`git checkout ${manifest.gitHead} -- .`, {
           cwd: root,
           encoding: "utf-8",
           timeout: 8e3,
@@ -11266,6 +11472,29 @@ function opencodePluginTemplate() {
     "    },",
     "  };",
     "};",
+    "",
+    "// Server-runtime definition (required by newer OpenCode server).",
+    "// Reuses the same hooks via the named export above.",
+    "const kumaHooks = {",
+    '  "tool.execute.before": async (input, output) => {',
+    "    const hooks = await KumaPlugin();",
+    '    return hooks["tool.execute.before"](input, output);',
+    "  },",
+    '  "file.edited": async (input) => {',
+    "    const hooks = await KumaPlugin();",
+    '    return hooks["file.edited"](input);',
+    "  },",
+    '  "experimental.session.compacting": async (input, output) => {',
+    "    const hooks = await KumaPlugin();",
+    '    return hooks["experimental.session.compacting"](input, output);',
+    "  },",
+    "};",
+    "",
+    "export default {",
+    '  id: "kuma",',
+    "  setup: async () => kumaHooks,",
+    "  effect: async () => kumaHooks,",
+    "};",
     ""
   ].join("\n");
 }
@@ -12769,6 +12998,20 @@ async function daemonTick(root) {
   } catch (err) {
     notes.push(`map: skipped (${err})`);
   }
+  try {
+    const { getWorktreeChangedFiles: getWorktreeChangedFiles2, updateWorktreeDirty: updateWorktreeDirty2 } = await Promise.resolve().then(() => (init_mapBackbone(), mapBackbone_exports));
+    const { scanCodebase: scanCodebase2 } = await Promise.resolve().then(() => (init_kumaCodeScanner(), kumaCodeScanner_exports));
+    const dirty = getWorktreeChangedFiles2(r, 50);
+    if (dirty.length > 0) {
+      const res = await scanCodebase2({ include: dirty.map((d) => d.file), force: true, maxFiles: dirty.length });
+      updateWorktreeDirty2(dirty.map((d) => d.file), r);
+      notes.push(`worktree: ${dirty.length} dirty forced (${res.filesScanned} scanned)`);
+    } else {
+      updateWorktreeDirty2([], r);
+    }
+  } catch (err) {
+    notes.push(`worktree: skipped (${err})`);
+  }
   try {
     const { refreshPackageBriefs: refreshPackageBriefs2 } = await Promise.resolve().then(() => (init_packageBriefs(), packageBriefs_exports));
     const { count } = await refreshPackageBriefs2();
@@ -12784,6 +13027,20 @@ async function daemonTick(root) {
   } catch {
     notes.push("drift: skipped");
   }
+  try {
+    const { writeDriftReport: writeDriftReport2 } = await Promise.resolve().then(() => (init_kumaDriftDetector(), kumaDriftDetector_exports));
+    const { items } = await writeDriftReport2();
+    notes.push(`drift-report: ${items} item(s) \u2192 .kuma/drift.json`);
+  } catch {
+  }
+  try {
+    const { pruneOrphans: pruneOrphans2 } = await Promise.resolve().then(() => (init_kumaGraph(), kumaGraph_exports));
+    const { orphanNodes, danglingEdges } = await pruneOrphans2({ olderThanSec: 3600 });
+    if (orphanNodes > 0 || danglingEdges > 0) {
+      notes.push(`orphans: -${orphanNodes}n/-${danglingEdges}e pruned`);
+    }
+  } catch {
+  }
   try {
     const { clearDirty: clearDirty2 } = await Promise.resolve().then(() => (init_cacheFreshness(), cacheFreshness_exports));
     clearDirty2();
@@ -14023,10 +14280,10 @@ async function handleHistory(params) {
       lines.push(traceFormatted);
     } else {
       try {
-        const { execSync: execSync10 } = await import("child_process");
+        const { execSync: execSync11 } = await import("child_process");
         const { getProjectRoot: getProjectRoot2 } = await Promise.resolve().then(() => (init_pathValidator(), pathValidator_exports));
         const root = getProjectRoot2();
-        const gitHistory = execSync10(
+        const gitHistory = execSync11(
           `git log -n 5 --pretty=format:"  \u2022 %h (%ad) %s" --date=short -- "${target}"`,
           { cwd: root, encoding: "utf-8", timeout: 3e3, stdio: ["pipe", "pipe", "pipe"] }
         ).trim();
@@ -14457,7 +14714,7 @@ init_sessionMemory();
 init_kumaShared();
 import fs26 from "fs";
 import path29 from "path";
-import { execSync as execSync7 } from "child_process";
+import { execSync as execSync8 } from "child_process";
 var SCRIPT_PATCH_PATTERNS = [
   "writeFileSync",
   "writeFile",
@@ -14551,7 +14808,7 @@ function scanRecentFiles(projectRoot) {
 function detectGitPatchScripts(projectRoot) {
   const warnings = [];
   try {
-    const statusStdout = execSync7("git status --porcelain", {
+    const statusStdout = execSync8("git status --porcelain", {
       cwd: projectRoot,
       encoding: "utf-8",
       timeout: 3e3
@@ -14584,7 +14841,7 @@ function detectGitPatchScripts(projectRoot) {
         }
       }
     }
-    const deletedStdout = execSync7("git diff --name-only --diff-filter=D HEAD", {
+    const deletedStdout = execSync8("git diff --name-only --diff-filter=D HEAD", {
       cwd: projectRoot,
       encoding: "utf-8",
       timeout: 3e3
@@ -14656,7 +14913,7 @@ init_sessionMemory();
 init_pathValidator();
 import fs27 from "fs";
 import path30 from "path";
-import { execSync as execSync8 } from "child_process";
+import { execSync as execSync9 } from "child_process";
 var SNAPSHOT_DIR = "context-snapshots";
 function snapshotDir() {
   return path30.join(getProjectRoot(), ".kuma", SNAPSHOT_DIR);
@@ -14728,7 +14985,7 @@ function formatSnapshot(snapshot) {
 function getGitDiffStat2() {
   try {
     const root = getProjectRoot();
-    const stdout = execSync8("git diff --stat", {
+    const stdout = execSync9("git diff --stat", {
       cwd: root,
       encoding: "utf-8",
       timeout: 3e3
@@ -15513,25 +15770,25 @@ async function main() {
     } catch {
     }
     try {
-      const { execSync: execSync10 } = await import("child_process");
+      const { execSync: execSync11 } = await import("child_process");
       try {
-        execSync10("pkill -f 'jest' 2>/dev/null || true");
+        execSync11("pkill -f 'jest' 2>/dev/null || true");
       } catch {
       }
       try {
-        execSync10("pkill -f 'jest-worker' 2>/dev/null || true");
+        execSync11("pkill -f 'jest-worker' 2>/dev/null || true");
       } catch {
       }
       try {
-        execSync10("pkill -f 'pnpm test' 2>/dev/null || true");
+        execSync11("pkill -f 'pnpm test' 2>/dev/null || true");
       } catch {
       }
       try {
-        execSync10("pkill -f 'npm test' 2>/dev/null || true");
+        execSync11("pkill -f 'npm test' 2>/dev/null || true");
       } catch {
       }
       try {
-        execSync10("pkill -f 'yarn test' 2>/dev/null || true");
+        execSync11("pkill -f 'yarn test' 2>/dev/null || true");
       } catch {
       }
       console.error("\u2705 Killed orphaned test processes");
@@ -15680,6 +15937,12 @@ ${context}` : "";
         await refreshPackageBriefs2();
       } catch {
       }
+      try {
+        const { getWorktreeChangedFiles: getWorktreeChangedFiles2, updateWorktreeDirty: updateWorktreeDirty2 } = await Promise.resolve().then(() => (init_mapBackbone(), mapBackbone_exports));
+        const { getProjectRoot: getProjectRoot2 } = await Promise.resolve().then(() => (init_pathValidator(), pathValidator_exports));
+        updateWorktreeDirty2(getWorktreeChangedFiles2(getProjectRoot2(), 50).map((d) => d.file), getProjectRoot2());
+      } catch {
+      }
       try {
         const { clearDirty: clearDirty2 } = await Promise.resolve().then(() => (init_cacheFreshness(), cacheFreshness_exports));
         clearDirty2();
@@ -15757,8 +16020,8 @@ ${line}
       } catch {
       }
       try {
-        const { execSync: execSync10 } = await import("child_process");
-        const branch = execSync10("git rev-parse --abbrev-ref HEAD", {
+        const { execSync: execSync11 } = await import("child_process");
+        const branch = execSync11("git rev-parse --abbrev-ref HEAD", {
           cwd: root,
           encoding: "utf-8",
           timeout: 2e3,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plumpslabs/kuma",
-  "version": "2.4.16",
+  "version": "2.4.19",
   "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/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://antigravity.google/schemas/v1/plugin.json",
   "name": "kuma",
-  "version": "2.4.16",
+  "version": "2.4.19",
   "description": "Safety-first context & orchestration engine for AI coding agents. Shadow memory, gotcha lifecycle, blast radius impact analysis, and test verification.",
   "author": {
     "name": "plumpslabs",