@plumpslabs/kuma 2.3.17 → 2.3.19

package/dist/{contextDigest-5JXLH56Z.js → contextDigest-QB5XHPXE.js}

@@ -1,12 +1,12 @@
 import {
   getActiveGotchas
-} from "./chunk-Q2444HWO.js";
+} from "./chunk-FKRSI5U5.js";
 import {
   sessionMemory
-} from "./chunk-R6B3VUSB.js";
+} from "./chunk-LVKOGXLC.js";
 import {
   getDb
-} from "./chunk-3TX6Q37T.js";
+} from "./chunk-3BRBJZ7P.js";
 import {
   getProjectRoot
 } from "./chunk-E2KFPEBT.js";

package/dist/{domainRules-ED6EOFVY.js → domainRules-QLPAQASB.js}

@@ -6,8 +6,8 @@ import {
   getLayersSummary,
   readLayer,
   writeLayer
-} from "./chunk-Q2444HWO.js";
-import "./chunk-R6B3VUSB.js";
+} from "./chunk-FKRSI5U5.js";
+import "./chunk-LVKOGXLC.js";
 import "./chunk-E2KFPEBT.js";
 export {
   appendToLayer,

package/dist/index.js

@@ -3,27 +3,27 @@ import {
   auditStats,
   queryAudit,
   recordAudit
-} from "./chunk-RI3DKY62.js";
+} from "./chunk-GFLSAXAH.js";
 import {
   ALL_CONFIG_TYPES,
   formatInitResults,
   runInit
-} from "./chunk-AJ7HHUDW.js";
+} from "./chunk-ABKE45T4.js";
 import {
   formatDecisionTemplate,
   getProactiveMemories,
   recordDecision,
   scoreMemoryRelevance
-} from "./chunk-OJALFQ4H.js";
+} from "./chunk-L7F67KUP.js";
 import {
   buildDriftMessages,
   getGitDiffStat,
   getSessionStats,
   getUnresolvedCount
-} from "./chunk-SPHI2BOO.js";
+} from "./chunk-3OHYYXYN.js";
 import {
   sessionMemory
-} from "./chunk-R6B3VUSB.js";
+} from "./chunk-LVKOGXLC.js";
 import {
   analyzeImpact,
   autoHeal,
@@ -34,7 +34,7 @@ import {
   getGraphStats,
   searchGraph,
   traceFlow
-} from "./chunk-ZKDYTYMS.js";
+} from "./chunk-PRUTTZBS.js";
 import {
   addContextNote,
   addSecurityFinding,
@@ -59,7 +59,7 @@ import {
   saveResearchCache,
   updateDecisionStatus,
   updateTodoStatus
-} from "./chunk-3TX6Q37T.js";
+} from "./chunk-3BRBJZ7P.js";
 import {
   getProjectRoot,
   validateFilePath
@@ -240,8 +240,8 @@ async function handleInit(_params) {
   lines.push(`  \u{1F4DD} Modified: ${summary.modifiedFiles?.length || 0} file(s)`);
   lines.push(`  \u{1F6E0}\uFE0F Tool calls: ${summary.toolCallCount}`);
   try {
-    const { computeSafetyScore, formatSafetyScore } = await import("./safetyScore-WU27EOG4.js");
-    const { saveHealthSnapshot: saveHealthSnapshot2 } = await import("./kumaDb-IC7UX7PU.js");
+    const { computeSafetyScore, formatSafetyScore } = await import("./safetyScore-TMMRD2MV.js");
+    const { saveHealthSnapshot: saveHealthSnapshot2 } = await import("./kumaDb-4XZ5S2LH.js");
     const score = await computeSafetyScore(_params.goal);
     const checksStr = JSON.stringify(score.checks);
     await saveHealthSnapshot2(score.score, score.risk, checksStr, score.summary);
@@ -336,7 +336,7 @@ async function handleResearch(params) {
     lines.push("  \u26A0\uFE0F Graph query failed");
   }
   try {
-    const { scanCodebase } = await import("./kumaCodeScanner-QYQUL4W6.js");
+    const { scanCodebase } = await import("./kumaCodeScanner-J6B2EHGI.js");
     const scanResult = await scanCodebase({ scope, maxFiles: 100 });
     if (scanResult.nodeCount > 0 || scanResult.edgeCount > 0) {
       lines.push(`  \u{1F52C} Auto-scanned ${scanResult.filesScanned} files \u2192 ${scanResult.nodeCount} nodes, ${scanResult.edgeCount} edges`);
@@ -422,8 +422,8 @@ async function handleResearches(_params) {
 async function handleHealth(_params) {
   sessionMemory.recordToolCall("kuma_context_health", {});
   try {
-    const { computeSafetyScore, formatSafetyScore } = await import("./safetyScore-WU27EOG4.js");
-    const { saveHealthSnapshot: saveHealthSnapshot2 } = await import("./kumaDb-IC7UX7PU.js");
+    const { computeSafetyScore, formatSafetyScore } = await import("./safetyScore-TMMRD2MV.js");
+    const { saveHealthSnapshot: saveHealthSnapshot2 } = await import("./kumaDb-4XZ5S2LH.js");
     const score = await computeSafetyScore();
     const checksStr = JSON.stringify(score.checks);
     await saveHealthSnapshot2(score.score, score.risk, checksStr, score.summary);
@@ -450,8 +450,8 @@ async function handleSync(params) {
   lines.push(`  \u{1F6E0}\uFE0F Tool calls: ${summary.toolCallCount}`);
   lines.push("");
   try {
-    const { computeSafetyScore, formatSafetyScore } = await import("./safetyScore-WU27EOG4.js");
-    const { saveHealthSnapshot: saveHealthSnapshot2 } = await import("./kumaDb-IC7UX7PU.js");
+    const { computeSafetyScore, formatSafetyScore } = await import("./safetyScore-TMMRD2MV.js");
+    const { saveHealthSnapshot: saveHealthSnapshot2 } = await import("./kumaDb-4XZ5S2LH.js");
     const score = await computeSafetyScore(params.goal);
     const checksStr = JSON.stringify(score.checks);
     await saveHealthSnapshot2(score.score, score.risk, checksStr, score.summary);
@@ -462,14 +462,14 @@ async function handleSync(params) {
   }
   lines.push("");
   try {
-    const { getGraphStats: getGraphStats2 } = await import("./kumaGraph-GUQM75WL.js");
+    const { getGraphStats: getGraphStats2 } = await import("./kumaGraph-UMXZNGYF.js");
     lines.push("**Knowledge Graph**");
     lines.push(await getGraphStats2());
   } catch {
   }
   lines.push("");
   try {
-    const { getProactiveMemories: getProactiveMemories2 } = await import("./kumaMemory-FMOWIODH.js");
+    const { getProactiveMemories: getProactiveMemories2 } = await import("./kumaMemory-FBJMV77G.js");
     const memories = getProactiveMemories2();
     if (memories) {
       lines.push("**Relevant Memories**");
@@ -483,7 +483,7 @@ async function handleSync(params) {
 }
 async function handleVisualize(params) {
   const scope = params.scope;
-  const { generateVisualizeReport } = await import("./kumaVisualize-AFL7STLL.js");
+  const { generateVisualizeReport } = await import("./kumaVisualize-264OEBGJ.js");
   return await generateVisualizeReport({
     scope,
     type: "flowchart",
@@ -493,11 +493,11 @@ async function handleVisualize(params) {
 async function handleDigest(_params) {
   sessionMemory.recordToolCall("kuma_context_digest", {});
   try {
-    const { generateContextDigest } = await import("./contextDigest-5JXLH56Z.js");
+    const { generateContextDigest } = await import("./contextDigest-QB5XHPXE.js");
     return await generateContextDigest();
   } catch (err) {
     try {
-      const { generateDigest } = await import("./domainRules-ED6EOFVY.js");
+      const { generateDigest } = await import("./domainRules-QLPAQASB.js");
       return generateDigest();
     } catch {
       return `Error generating digest: ${err}`;
@@ -507,7 +507,7 @@ async function handleDigest(_params) {
 async function handleDrift(_params) {
   sessionMemory.recordToolCall("kuma_context_drift", {});
   try {
-    const { detectDrift, formatDriftReport, flagStaleRecords } = await import("./kumaDriftDetector-QBY6OJOO.js");
+    const { detectDrift, formatDriftReport, flagStaleRecords } = await import("./kumaDriftDetector-TOORILSZ.js");
     await flagStaleRecords();
     const records = await detectDrift();
     return formatDriftReport(records);
@@ -518,7 +518,7 @@ async function handleDrift(_params) {
 async function handleProgressive(params) {
   sessionMemory.recordToolCall("kuma_context_progressive", { scope: params.scope, section: params.section });
   try {
-    const { getProgressiveContext, loadSection } = await import("./kumaProgressiveContext-CVSNPY3W.js");
+    const { getProgressiveContext, loadSection } = await import("./kumaProgressiveContext-MWEDRXOH.js");
     if (params.section) {
       const validSections = ["domain_rules", "architecture", "gotchas", "decisions", "graph", "changes", "health"];
       if (!validSections.includes(params.section)) {
@@ -670,7 +670,13 @@ var MEMORY_ALIASES = {
   // Skills synonyms
   "skills": "skills",
   "distilled-skills": "skills",
-  "skill-list": "skills"
+  "skill-list": "skills",
+  // Add node synonyms
+  "add_node": "add_node",
+  "add-node": "add_node",
+  "node": "add_node",
+  "create-node": "add_node",
+  "record-node": "add_node"
 };
 async function handleMemory(params) {
   const rawAction = params.action || "session";
@@ -716,6 +722,8 @@ async function handleMemory(params) {
       return handleTrajectoryList(params);
     case "skills":
       return handleSkillsList(params);
+    case "add_node":
+      return handleAddNode(params);
     default:
       return `Unknown action "${action}".`;
   }
@@ -726,7 +734,7 @@ async function handleDecision(params) {
     case "template":
       return formatDecisionTemplate();
     case "suggest": {
-      const { shouldRecordDecision } = await import("./kumaMemory-FMOWIODH.js");
+      const { shouldRecordDecision } = await import("./kumaMemory-FBJMV77G.js");
       const check = shouldRecordDecision();
       return check.worth ? `\u{1F4A1} Decision suggested: "${check.title}"
 Use kuma_memory({ action: 'decision', title: '...', context: '...', rationale: '...', outcome: '...' }) to record.` : "\u2705 No decision needed at this time.";
@@ -754,6 +762,17 @@ async function handleResearchSave(params) {
     validatedAt: (/* @__PURE__ */ new Date()).toISOString()
   });
   await saveResearchCache(scope, record, void 0, params.confidence);
+  try {
+    const { upsertNode, nodeId } = await import("./kumaGraph-UMXZNGYF.js");
+    await upsertNode({ id: nodeId("file", scope), type: "file", name: scope });
+    await upsertNode({
+      id: `research::${scope}`,
+      type: "variable",
+      name: `research:${scope}`,
+      metadata: { confidence: params.confidence || 0.8 }
+    });
+  } catch {
+  }
   try {
     const researchDir = path2.join(getProjectRoot(), ".kuma", "research");
     if (!fs2.existsSync(researchDir)) fs2.mkdirSync(researchDir, { recursive: true });
@@ -804,11 +823,11 @@ async function handleSearch(params) {
   if (!query) return "\u26A0\uFE0F query or scope parameter required.";
   const limit = params.limit || 20;
   const memResults = sessionMemory.searchMemory(query, limit);
-  const { searchGraph: searchGraph2 } = await import("./kumaGraph-GUQM75WL.js");
+  const { searchGraph: searchGraph2 } = await import("./kumaGraph-UMXZNGYF.js");
   const graphResults = await searchGraph2(query, Math.min(limit, 10));
   let hybridResults = "";
   try {
-    const { hybridSearch, formatHybridResults } = await import("./kumaSearch-B5WVYHHD.js");
+    const { hybridSearch, formatHybridResults } = await import("./kumaSearch-PV4QTKE7.js");
     const semanticResults = await hybridSearch(query, 8);
     if (semanticResults.length > 0) {
       hybridResults = "\n" + formatHybridResults(query, semanticResults);
@@ -892,7 +911,7 @@ async function handleDecisionLog(params) {
 }
 async function handleMine(params) {
   sessionMemory.recordToolCall("kuma_memory_mine", { scope: params.scope });
-  const { mineHistoricalDecisions } = await import("./kumaMiner-3RXEOCBP.js");
+  const { mineHistoricalDecisions } = await import("./kumaMiner-XJETL7TL.js");
   return await mineHistoricalDecisions({
     scope: params.scope,
     since: typeof params.since === "string" ? params.since : void 0,
@@ -901,7 +920,45 @@ async function handleMine(params) {
   });
 }
 async function handleLayerAction(layer, params) {
-  const { readLayer, writeLayer } = await import("./domainRules-ED6EOFVY.js");
+  const { readLayer, writeLayer } = await import("./domainRules-QLPAQASB.js");
+  if (layer === "arch_flow" && params.content) {
+    const content = params.content;
+    const domainMatch = content.match(/domain\s*[:]\s*([^|\n]+)/i);
+    const hopsMatch = content.match(/hops\s*[:]\s*([^|\n]+)/i);
+    const gotchasMatch = content.match(/gotchas?\s*[:]\s*([^|\n]+)/i);
+    const decisionsMatch = content.match(/decisions?\s*[:]\s*([^|\n]+)/i);
+    const filesMatch = content.match(/files?\s*[:]\s*([^|\n]+)/i);
+    if (domainMatch) {
+      const domain = domainMatch[1].trim();
+      const hopsStr = hopsMatch ? hopsMatch[1].trim() : "";
+      const gotchasStr = gotchasMatch ? gotchasMatch[1].trim() : "";
+      const decisionsStr = decisionsMatch ? decisionsMatch[1].trim() : "";
+      const filesStr = filesMatch ? filesMatch[1].trim() : "";
+      const hops = hopsStr ? hopsStr.split("\u2192").map((h) => h.trim()).filter(Boolean).map((h, i, arr) => ({
+        from: i === 0 ? domain : arr[i - 1],
+        to: h,
+        relation: "flows",
+        description: h
+      })) : [];
+      const gotchas = gotchasStr ? gotchasStr.split(",").map((g) => g.trim()).filter(Boolean) : [];
+      const decisions = decisionsStr ? decisionsStr.split(",").map((d) => d.trim()).filter(Boolean) : [];
+      const filePaths = filesStr ? filesStr.split(",").map((f) => f.trim()).filter(Boolean) : [];
+      try {
+        const { recordDomainFlow } = await import("./kumaGraph-UMXZNGYF.js");
+        const flow = await recordDomainFlow({ domain, hops, gotchas, decisions, filePaths });
+        await writeLayer("arch_flow", content);
+        return `\u2705 Domain flow "${domain}" recorded \u2014 ${flow.nodeCount} nodes, ${flow.edgeCount} edges created.
+\u{1F3DB}\uFE0F **Domain Anchor:** ${domain}
+\u{1F504} **Hops:** ${hops.length}
+\u26A0\uFE0F **Gotchas:** ${gotchas.length}
+\u{1F4C1} **Files:** ${filePaths.length}`;
+      } catch (err) {
+        await writeLayer("arch_flow", content);
+        return `\u2705 Architecture flow saved (text only). Graph recording failed: ${err}`;
+      }
+    }
+    return writeLayer("arch_flow", content);
+  }
   if (params.content) {
     return writeLayer(layer, params.content);
   }
@@ -909,7 +966,7 @@ async function handleLayerAction(layer, params) {
 }
 async function handleGotchaAction(params) {
   if (params.content && params.scope) {
-    const { addGotcha } = await import("./kumaGotchas-5HODT5RI.js");
+    const { addGotcha } = await import("./kumaGotchas-XRGFFBTA.js");
     return await addGotcha({
       filePath: params.scope,
       description: params.content,
@@ -917,7 +974,7 @@ async function handleGotchaAction(params) {
       workaround: params.description
     });
   }
-  const { listGotchas, syncGotchasToDb } = await import("./kumaGotchas-5HODT5RI.js");
+  const { listGotchas, syncGotchasToDb } = await import("./kumaGotchas-XRGFFBTA.js");
   await syncGotchasToDb();
   return await listGotchas({
     filePath: params.scope,
@@ -927,10 +984,10 @@ async function handleGotchaAction(params) {
 async function handleFederated(params) {
   sessionMemory.recordToolCall("kuma_memory_federated", { scope: params.scope, uri: params.uri });
   if (params.uri) {
-    const { resolveFederatedNode } = await import("./kumaGraph-GUQM75WL.js");
+    const { resolveFederatedNode } = await import("./kumaGraph-UMXZNGYF.js");
     return await resolveFederatedNode(params.uri);
   }
-  const { listFederatedReferences } = await import("./kumaGraph-GUQM75WL.js");
+  const { listFederatedReferences } = await import("./kumaGraph-UMXZNGYF.js");
   return await listFederatedReferences();
 }
 async function handleGenTest(params) {
@@ -938,25 +995,58 @@ async function handleGenTest(params) {
   if (params.target) {
     const id = parseInt(params.target, 10);
     if (!isNaN(id)) {
-      const { generateTestFromTrajectoryId } = await import("./kumaTrajectory-T6DXGOG4.js");
+      const { generateTestFromTrajectoryId } = await import("./kumaTrajectory-7NOAVNG2.js");
       return await generateTestFromTrajectoryId(id);
     }
   }
-  const { listGeneratedTests } = await import("./kumaTrajectory-T6DXGOG4.js");
+  const { listGeneratedTests } = await import("./kumaTrajectory-7NOAVNG2.js");
   return await listGeneratedTests();
 }
 async function handleTrajectoryList(params) {
   sessionMemory.recordToolCall("kuma_memory_trajectory", {});
-  const { listTrajectories } = await import("./kumaTrajectory-T6DXGOG4.js");
+  const { listTrajectories } = await import("./kumaTrajectory-7NOAVNG2.js");
   return await listTrajectories(params.limit || 10);
 }
 async function handleSkillsList(_params) {
   sessionMemory.recordToolCall("kuma_memory_skills", {});
-  const { listDistilledSkills } = await import("./kumaTrajectory-T6DXGOG4.js");
+  const { listDistilledSkills } = await import("./kumaTrajectory-7NOAVNG2.js");
   return await listDistilledSkills();
 }
+async function handleAddNode(params) {
+  const type = params.title;
+  const name = params.content;
+  const filePath = params.scope;
+  if (!type || !name) {
+    return "\u26A0\uFE0F `title` (node type: function/class/component/file/api_route/test) and `content` (node name) required.\nExample: kuma_memory({ action: 'add_node', title: 'function', content: 'sendMessage', scope: 'ChatService.ts' })";
+  }
+  const validTypes = ["function", "class", "component", "file", "api_route", "test"];
+  if (!validTypes.includes(type)) {
+    return `\u26A0\uFE0F Invalid type "${type}". Valid types: ${validTypes.join(", ")}`;
+  }
+  try {
+    const { upsertNode, nodeId, addEdge } = await import("./kumaGraph-UMXZNGYF.js");
+    const nodeIdStr = filePath ? `${type}::${filePath}::${name}` : nodeId(type, name);
+    await upsertNode({
+      id: nodeIdStr,
+      type,
+      name,
+      filePath
+    });
+    if (filePath) {
+      const fileNodeId = nodeId("file", filePath);
+      await upsertNode({ id: fileNodeId, type: "file", name: filePath });
+      try {
+        await addEdge({ sourceId: fileNodeId, targetId: nodeIdStr, type: "contains" });
+      } catch {
+      }
+    }
+    return `\u2705 Node created: **${name}** (${type})${filePath ? ` \u2014 ${filePath}` : ""}`;
+  } catch (err) {
+    return `\u274C Failed to create node: ${err}`;
+  }
+}
 async function handleLayersSummary(_params) {
-  const { getLayersSummary } = await import("./domainRules-ED6EOFVY.js");
+  const { getLayersSummary } = await import("./domainRules-QLPAQASB.js");
   return getLayersSummary();
 }
 
@@ -1956,7 +2046,7 @@ async function handleLock(params) {
 }
 async function handleHealth2(_params) {
   try {
-    const { computeSafetyScore, formatSafetyScore } = await import("./safetyScore-WU27EOG4.js");
+    const { computeSafetyScore, formatSafetyScore } = await import("./safetyScore-TMMRD2MV.js");
     const score = await computeSafetyScore();
     await saveHealthSnapshot(score.score, score.risk, JSON.stringify(score.checks), score.summary);
     return formatSafetyScore(score);
@@ -2063,7 +2153,7 @@ async function handleClean(_params) {
 async function handlePolicy(params) {
   sessionMemory.recordToolCall("kuma_safety_policy", {});
   if (params.command) {
-    const { evaluateCommand, evaluateFilePath } = await import("./kumaPolicyEngine-ORBWL5PT.js");
+    const { evaluateCommand, evaluateFilePath } = await import("./kumaPolicyEngine-2QDJDLM7.js");
     const commandVerdict = evaluateCommand(params.command);
     const lines = [];
     lines.push(`\u{1F4DC} **Policy Check**: ${commandVerdict.allowed ? "\u2705 Allowed" : "\u26D4 Blocked"}`);
@@ -2090,7 +2180,7 @@ async function handlePolicy(params) {
     }
     return lines.join("\n");
   }
-  const { formatPolicyStatus } = await import("./kumaPolicyEngine-ORBWL5PT.js");
+  const { formatPolicyStatus } = await import("./kumaPolicyEngine-2QDJDLM7.js");
   return formatPolicyStatus();
 }
 async function handleAstValidation(params) {
@@ -2109,18 +2199,18 @@ async function handleAstValidation(params) {
 async function handleCheckpoint(params) {
   sessionMemory.recordToolCall("kuma_safety_checkpoint", { label: params.label });
   if (!params.label) return "\u26A0\uFE0F label parameter required. Example: kuma_safety({ action: 'checkpoint', label: 'pre-feature-x' })";
-  const { createCheckpoint } = await import("./kumaCheckpoint-XIQWRMGV.js");
+  const { createCheckpoint } = await import("./kumaCheckpoint-J2LDQMEO.js");
   return await createCheckpoint(params.label, params.description);
 }
 async function handleRollbackLabel(params) {
   sessionMemory.recordToolCall("kuma_safety_rollback_label", { label: params.label });
   if (!params.label) return "\u26A0\uFE0F label parameter required. Example: kuma_safety({ action: 'rollback_label', label: 'pre-feature-x' })";
-  const { rollbackToCheckpoint } = await import("./kumaCheckpoint-XIQWRMGV.js");
+  const { rollbackToCheckpoint } = await import("./kumaCheckpoint-J2LDQMEO.js");
   return await rollbackToCheckpoint(params.label);
 }
 async function handleCheckpointList(_params) {
   sessionMemory.recordToolCall("kuma_safety_checkpoint_list", {});
-  const { listCheckpoints } = await import("./kumaCheckpoint-XIQWRMGV.js");
+  const { listCheckpoints } = await import("./kumaCheckpoint-J2LDQMEO.js");
   return listCheckpoints();
 }
 async function handleContract(params) {
@@ -2149,7 +2239,7 @@ async function handleVerify(params) {
   }
   _lastVerifyCall = now;
   sessionMemory.recordToolCall("kuma_safety_verify", { scope: params.scope || params.filePath });
-  const { runAutoVerification } = await import("./kumaVerifier-6NTJQU7B.js");
+  const { runAutoVerification } = await import("./kumaVerifier-6YEGC77M.js");
   return await runAutoVerification({
     scope: params.scope || params.filePath,
     force: params.force,
@@ -2190,9 +2280,9 @@ function registerAllTools(server) {
   );
   server.tool(
     "kuma_memory",
-    "**Call AFTER research/editing every session** (including research-only). Record INLINE as you work.\n\nRECORD INLINE (call IMMEDIATELY during research):\n\u2022 STEP 5: `research_save` \u2014 every read/grep that finds new files/functions. Don't wait!\n\u2022 STEP 6: `gotcha` \u2014 IMMEDIATELY when you discover bugs/quirks. Record INLINE, not at the end.\n\u2022 STEP 7: `arch_flow` \u2014 IMMEDIATELY after EACH flow hop trace. Record before next task.\n\u2022 STEP 8: `decision` \u2014 IMMEDIATELY when choosing between options or finding architecture patterns.\n\nON DISCOVERY (when you encounter something):\n\u2022 `domain_rules` \u2014 uncovered business rules? Save them!\n\u2022 `context` \u2014 need to inject extra notes? Use this!\n\u2022 `todo` \u2014 create persistent task items\n\u2022 `mine` \u2014 extract historical context from git log\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 every read/grep that finds new files. Creates searchable cache.\n\u2022 STEP 6: `gotcha` \u2014 IMMEDIATELY when you discover bugs/quirks. No re-research.\n\u2022 STEP 7: `arch_flow` \u2014 IMMEDIATELY after EACH flow hop. Saves reading 5-10 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.",
     {
-      action: z.enum(["decision", "mine", "research_save", "session", "heal", "search", "changes", "todo", "context", "benchmark", "decision_log", "domain_rules", "arch_flow", "gotcha", "layers", "federated", "gen_test", "trajectory", "skills"]).describe("Memory action: decision=ADR, mine=mine git log & comments, research_save=save, session=summary, heal=repair, search=search, changes=log, todo=manage todos, context=inject notes, benchmark=capture/diff, decision_log=manage decisions, domain_rules=Layer 1 business rules (Issue #17), arch_flow=Layer 2 architecture flow (Issue #17), gotcha=Layer 3 known gotchas (Issue #17/#21), layers=all 3 layers summary, federated=resolve federated kuma:// URI (Issue #27), gen_test=generate test from trajectory (Issue #28), trajectory=list trajectories, skills=list distilled skills"),
+      action: z.enum(["decision", "mine", "research_save", "session", "heal", "search", "changes", "todo", "context", "benchmark", "decision_log", "domain_rules", "arch_flow", "gotcha", "layers", "federated", "gen_test", "trajectory", "skills", "add_node"]).describe("Memory action: decision=ADR, mine=mine git log & comments, research_save=save (creates file + graph node), session=summary, heal=repair, search=search, changes=log, todo=manage todos, context=inject notes, benchmark=capture/diff, decision_log=manage decisions, domain_rules=Layer 1 business rules (Issue #17), arch_flow=Layer 2 architecture flow (Issue #17), gotcha=Layer 3 known gotchas (Issue #17/#21), layers=all 3 layers summary, federated=resolve federated kuma:// URI (Issue #27), gen_test=generate test from trajectory (Issue #28), trajectory=list trajectories, skills=list distilled skills, add_node=manually create function/class/component structural nodes"),
       scope: z.string().optional().describe("Scope for research_save/search/todo/context/mine/federated"),
       query: z.string().optional().describe("Search query for search action"),
       content: z.string().optional().describe("Content/notes for research_save / context"),
@@ -2362,7 +2452,7 @@ async function main() {
     console.error("");
     let killedCount = 0;
     try {
-      const { getRunningVerificationPid } = await import("./kumaVerifier-6NTJQU7B.js");
+      const { getRunningVerificationPid } = await import("./kumaVerifier-6YEGC77M.js");
       const pid = getRunningVerificationPid();
       if (pid) {
         try {
@@ -2571,7 +2661,7 @@ async function main() {
   });
   (async () => {
     try {
-      const { generateInitMdContent } = await import("./init-BC7FG4C2.js");
+      const { generateInitMdContent } = await import("./init-PL4XL662.js");
       const fs7 = await import("fs");
       const path7 = await import("path");
       const initMdPath = path7.resolve(process.cwd(), ".kuma/init.md");
@@ -2588,7 +2678,7 @@ async function main() {
   (async () => {
     try {
       const { detectAgent, getSkillPath, getAgentLabel } = await import("./agentDetector-YOWQVJFR.js");
-      const { generateSkill, getSecondaryFiles } = await import("./skillGenerator-GYEDLFZP.js");
+      const { generateSkill, getSecondaryFiles } = await import("./skillGenerator-PWEJKZNX.js");
       const fs7 = await import("fs");
       const path7 = await import("path");
       const detection = detectAgent();
@@ -2629,7 +2719,7 @@ async function main() {
         console.error(`[${SERVER_NAME}] \u2705 Restored session (${sessionInfo.toolCallCount} previous tool calls)`);
       }
       try {
-        const { buildFromSessionMemory } = await import("./kumaGraph-GUQM75WL.js");
+        const { buildFromSessionMemory } = await import("./kumaGraph-UMXZNGYF.js");
         const edgeCount = await buildFromSessionMemory();
         if (edgeCount > 0) {
           console.error(`[${SERVER_NAME}] \u2705 Graph auto-populated with ${edgeCount} entries from session memory`);
@@ -2649,7 +2739,7 @@ async function main() {
         console.error(`[${SERVER_NAME}] \u26A0\uFE0F Scratch directory setup: ${err}`);
       }
       try {
-        const { getDb: getDb2, saveDb } = await import("./kumaDb-IC7UX7PU.js");
+        const { getDb: getDb2, saveDb } = await import("./kumaDb-4XZ5S2LH.js");
         const db = await getDb2();
         db.run(
           `INSERT INTO sessions (started_at, goal, tool_calls) VALUES (?, ?, ?)`,
@@ -2689,7 +2779,7 @@ fi
         console.error(`[${SERVER_NAME}] \u26A0\uFE0F Auto-capture hook setup: ${err}`);
       }
       try {
-        const { buildSearchVectors } = await import("./kumaSearch-B5WVYHHD.js");
+        const { buildSearchVectors } = await import("./kumaSearch-PV4QTKE7.js");
         const vectors = await buildSearchVectors();
         if (vectors.length > 0) {
           console.error(`[${SERVER_NAME}] \u2705 Search vector cache pre-warmed (${vectors.length} documents)`);

package/dist/{init-BC7FG4C2.js → init-PL4XL662.js}

@@ -4,7 +4,7 @@ import {
   formatInitResults,
   generateInitMdContent,
   runInit
-} from "./chunk-AJ7HHUDW.js";
+} from "./chunk-ABKE45T4.js";
 import "./chunk-E2KFPEBT.js";
 export {
   ALL_CONFIG_TYPES,

package/dist/{kumaCheckpoint-XIQWRMGV.js → kumaCheckpoint-J2LDQMEO.js}

@@ -1,10 +1,10 @@
 import {
   sessionMemory
-} from "./chunk-R6B3VUSB.js";
+} from "./chunk-LVKOGXLC.js";
 import {
   getDb,
   resetDbInstance
-} from "./chunk-3TX6Q37T.js";
+} from "./chunk-3BRBJZ7P.js";
 import {
   getProjectRoot
 } from "./chunk-E2KFPEBT.js";

package/dist/{kumaCodeScanner-QYQUL4W6.js → kumaCodeScanner-J6B2EHGI.js}

@@ -2,8 +2,8 @@ import {
   addEdge,
   nodeId,
   upsertNode
-} from "./chunk-ZKDYTYMS.js";
-import "./chunk-3TX6Q37T.js";
+} from "./chunk-PRUTTZBS.js";
+import "./chunk-3BRBJZ7P.js";
 import {
   getProjectRoot
 } from "./chunk-E2KFPEBT.js";
@@ -27,11 +27,12 @@ var CLASS_RE = /(?:export\s+)?(?:abstract\s+)?class\s+(\w+)(?:\s+extends\s+(\w+)
 var IMPORT_RE = /import\s+(?:\{([^}]*)\}\s+from\s+)?(?:\w+\s+from\s+)?(?:\*\s+as\s+\w+\s+from\s+)?['"]([^'"]+)['"]/g;
 var JSX_RETURN_RE = /return\s*\(?\s*</;
 var JSX_ELEMENT_RE = /<([A-Z]\w+)[\s/>]/g;
+var JSX_IMPLICIT_RE = /=>\s*(?:\(\s*)?</;
 var EXPRESS_ROUTE_RE = /\.(get|post|put|delete|patch)\s*\(\s*['"]([^'"]+)['"]\s*,\s*(\w+)/g;
 var HONO_ROUTE_RE = /c\.(get|post|put|delete|patch)\s*\(\s*['"]([^'"]+)['"]/g;
-var TEST_PATTERNS = [".test.", ".spec.", "__tests__", "/test/"];
 var EXPORT_RE = /export\s+(?:default\s+)?(\w+)/g;
 var CALL_RE = /(\w+)\s*\(/g;
+var TEST_PATTERNS = [".test.", ".spec.", "__tests__", "/test/"];
 var knownComponents = /* @__PURE__ */ new Set();
 var knownFunctions = /* @__PURE__ */ new Set();
 var symbolLocations = /* @__PURE__ */ new Map();
@@ -236,11 +237,9 @@ function parseFile(filePath, content) {
       }
     }
   }
-  const JSX_IMPLICIT_RE = /=>\s*(?:\(\s*)?</;
   if (hasJSX) {
     for (const fn of [...result.functions]) {
       const fnStartLine = fn.line - 1;
-      const fnLine = lines[fnStartLine];
       const endLine = Math.min(fnStartLine + 50, lines.length);
       let isComponent = false;
       for (let i = fnStartLine; i < endLine; i++) {
@@ -249,12 +248,10 @@ function parseFile(filePath, content) {
           break;
         }
       }
-      if (!isComponent && JSX_IMPLICIT_RE.test(fnLine)) isComponent = true;
-      if (!isComponent && fnLine.includes("=>") && fnStartLine + 1 < endLine) {
+      if (!isComponent && JSX_IMPLICIT_RE.test(lines[fnStartLine])) isComponent = true;
+      if (!isComponent && fnStartLine + 1 < endLine) {
         const nextLine = lines[fnStartLine + 1].trim();
-        if (nextLine.startsWith("<") || nextLine.startsWith("(") || nextLine.startsWith("<>")) {
-          isComponent = true;
-        }
+        if (nextLine.startsWith("<") || nextLine.startsWith("(") || nextLine.startsWith("<>")) isComponent = true;
       }
       if (isComponent) {
         result.components.push({ name: fn.name, line: fn.line });

package/dist/{kumaDb-IC7UX7PU.js → kumaDb-4XZ5S2LH.js}

@@ -29,7 +29,7 @@ import {
   saveVerification,
   updateDecisionStatus,
   updateTodoStatus
-} from "./chunk-3TX6Q37T.js";
+} from "./chunk-3BRBJZ7P.js";
 import "./chunk-E2KFPEBT.js";
 export {
   addContextNote,

package/dist/{kumaDriftDetector-QBY6OJOO.js → kumaDriftDetector-TOORILSZ.js}

@@ -1,7 +1,7 @@
 import {
   getDb,
   saveDb
-} from "./chunk-3TX6Q37T.js";
+} from "./chunk-3BRBJZ7P.js";
 import {
   getProjectRoot
 } from "./chunk-E2KFPEBT.js";

package/dist/{kumaGotchas-5HODT5RI.js → kumaGotchas-XRGFFBTA.js}

@@ -2,14 +2,14 @@ import {
   appendToLayer,
   checkFileGotchas,
   getActiveGotchas
-} from "./chunk-Q2444HWO.js";
+} from "./chunk-FKRSI5U5.js";
 import {
   sessionMemory
-} from "./chunk-R6B3VUSB.js";
+} from "./chunk-LVKOGXLC.js";
 import {
   getDb,
   saveDb
-} from "./chunk-3TX6Q37T.js";
+} from "./chunk-3BRBJZ7P.js";
 import "./chunk-E2KFPEBT.js";
 
 // src/engine/kumaGotchas.ts

package/dist/{kumaGraph-GUQM75WL.js → kumaGraph-UMXZNGYF.js}

@@ -9,6 +9,7 @@ import {
   nodeId,
   queryGraph,
   recordApiRoute,
+  recordDomainFlow,
   recordFileDefinition,
   recordFunctionCall,
   recordImport,
@@ -17,8 +18,8 @@ import {
   searchGraph,
   traceFlow,
   upsertNode
-} from "./chunk-ZKDYTYMS.js";
-import "./chunk-3TX6Q37T.js";
+} from "./chunk-PRUTTZBS.js";
+import "./chunk-3BRBJZ7P.js";
 import "./chunk-E2KFPEBT.js";
 export {
   addEdge,
@@ -31,6 +32,7 @@ export {
   nodeId,
   queryGraph,
   recordApiRoute,
+  recordDomainFlow,
   recordFileDefinition,
   recordFunctionCall,
   recordImport,