@plumpslabs/kuma 2.4.17 → 2.4.20

package/dist/index.js

@@ -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;
 }
@@ -5771,6 +5800,7 @@ __export(kumaGraph_exports, {
   getGraphStats: () => getGraphStats,
   nodeId: () => nodeId,
   propagateImpact: () => propagateImpact,
+  pruneOrphans: () => pruneOrphans,
   queryGraph: () => queryGraph,
   recordAffects: () => recordAffects,
   recordApiRoute: () => recordApiRoute,
@@ -5847,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();
@@ -5961,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 = {};
@@ -11397,6 +11472,30 @@ 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",',
+    "  // NOTE: setup must return hooks synchronously \u2014 never an async",
+    "  // effect/event-loop. An async effect never resolves and hangs load.",
+    "  setup: () => kumaHooks,",
+    "};",
     ""
   ].join("\n");
 }
@@ -12935,6 +13034,14 @@ async function daemonTick(root) {
     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();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plumpslabs/kuma",
-  "version": "2.4.17",
+  "version": "2.4.20",
   "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.17",
+  "version": "2.4.20",
   "description": "Safety-first context & orchestration engine for AI coding agents. Shadow memory, gotcha lifecycle, blast radius impact analysis, and test verification.",
   "author": {
     "name": "plumpslabs",