@plumpslabs/kuma 2.2.7 → 2.3.0

package/dist/{init-INY6XOQT.js → init-O4MBXFZL.js}

@@ -4,8 +4,8 @@ import {
   formatInitResults,
   generateInitMdContent,
   runInit
-} from "./chunk-IR6HFFDU.js";
-import "./chunk-T55NCW63.js";
+} from "./chunk-5A6AKUJZ.js";
+import "./chunk-IXMWW5WA.js";
 export {
   ALL_CONFIG_TYPES,
   CONFIG_LABELS,

package/dist/kumaDb-KN7Z4B5V.js

@@ -0,0 +1,19 @@
+import {
+  getChanges,
+  getDb,
+  getResearchCache,
+  recordChange,
+  saveDb,
+  saveHealthSnapshot,
+  saveResearchCache
+} from "./chunk-6NEMSUKP.js";
+import "./chunk-IXMWW5WA.js";
+export {
+  getChanges,
+  getDb,
+  getResearchCache,
+  recordChange,
+  saveDb,
+  saveHealthSnapshot,
+  saveResearchCache
+};

package/dist/kumaGraph-GW5SWOHQ.js

@@ -0,0 +1,36 @@
+import {
+  addEdge,
+  analyzeImpact,
+  buildFromSessionMemory,
+  formatFlow,
+  formatImpact,
+  getGraphStats,
+  queryGraph,
+  recordApiRoute,
+  recordFileDefinition,
+  recordFunctionCall,
+  recordImport,
+  recordTestRelation,
+  searchGraph,
+  traceFlow,
+  upsertNode
+} from "./chunk-IMO4QAFJ.js";
+import "./chunk-6NEMSUKP.js";
+import "./chunk-IXMWW5WA.js";
+export {
+  addEdge,
+  analyzeImpact,
+  buildFromSessionMemory,
+  formatFlow,
+  formatImpact,
+  getGraphStats,
+  queryGraph,
+  recordApiRoute,
+  recordFileDefinition,
+  recordFunctionCall,
+  recordImport,
+  recordTestRelation,
+  searchGraph,
+  traceFlow,
+  upsertNode
+};

package/dist/kumaMemory-IO7TVE7W.js

@@ -0,0 +1,16 @@
+import {
+  formatDecisionTemplate,
+  getProactiveMemories,
+  recordDecision,
+  scoreMemoryRelevance,
+  shouldRecordDecision
+} from "./chunk-OUPFJQKW.js";
+import "./chunk-TT37TE4P.js";
+import "./chunk-IXMWW5WA.js";
+export {
+  formatDecisionTemplate,
+  getProactiveMemories,
+  recordDecision,
+  scoreMemoryRelevance,
+  shouldRecordDecision
+};

package/dist/safetyScore-7FU7XSY5.js

@@ -0,0 +1,301 @@
+import {
+  getGitDiffStat,
+  getSessionStats,
+  getUnresolvedCount
+} from "./chunk-WP3WRPDC.js";
+import {
+  sessionMemory
+} from "./chunk-TT37TE4P.js";
+import "./chunk-IXMWW5WA.js";
+
+// src/engine/safetyScore.ts
+async function computeSafetyScore(inputGoal) {
+  const stats = getSessionStats(inputGoal);
+  const checks = [];
+  let totalScore = 0;
+  const maxScore = 100;
+  const gitStat = getGitDiffStat();
+  if (gitStat) {
+    const lines = gitStat.split("\n").filter(Boolean).length;
+    if (lines === 0) {
+      checks.push({
+        label: "Git Clean",
+        status: "pass",
+        message: "Working tree is clean",
+        weight: 20
+      });
+      totalScore += 20;
+    } else if (lines <= 3) {
+      checks.push({
+        label: "Git Clean",
+        status: "warn",
+        message: `${lines} file(s) modified`,
+        weight: 15
+      });
+      totalScore += 15;
+    } else {
+      checks.push({
+        label: "Git Clean",
+        status: "warn",
+        message: `${lines} file(s) modified \u2014 consider committing or stashing`,
+        weight: 10
+      });
+      totalScore += 10;
+    }
+  } else {
+    checks.push({
+      label: "Git Status",
+      status: "pass",
+      message: "Not a git repository or git unavailable",
+      weight: 20
+    });
+    totalScore += 20;
+  }
+  try {
+    const { getDb } = await import("./kumaDb-KN7Z4B5V.js");
+    const db = await getDb();
+    const nodeCount = db.exec("SELECT COUNT(*) as c FROM nodes")[0]?.values[0][0] ?? 0;
+    const edgeCount = db.exec("SELECT COUNT(*) as c FROM edges")[0]?.values[0][0] ?? 0;
+    if (nodeCount > 0) {
+      checks.push({
+        label: "Graph Health",
+        status: "pass",
+        message: `${nodeCount} nodes, ${edgeCount} edges`,
+        weight: 10
+      });
+      totalScore += 10;
+    } else {
+      checks.push({
+        label: "Graph Health",
+        status: "warn",
+        message: "Empty knowledge graph \u2014 run research first",
+        weight: 5
+      });
+      totalScore += 5;
+    }
+  } catch {
+    checks.push({
+      label: "Graph Health",
+      status: "warn",
+      message: "Could not check graph health",
+      weight: 5
+    });
+    totalScore += 5;
+  }
+  try {
+    const { getDb } = await import("./kumaDb-KN7Z4B5V.js");
+    const db = await getDb();
+    const researchCount = db.exec("SELECT COUNT(*) as c FROM research_cache")[0]?.values[0][0] ?? 0;
+    checks.push({
+      label: "Research Cached",
+      status: researchCount > 0 ? "pass" : "warn",
+      message: researchCount > 0 ? `${researchCount} research scope(s) cached` : "No research cached \u2014 run kuma_context research first",
+      weight: 10
+    });
+    totalScore += researchCount > 0 ? 10 : 5;
+  } catch {
+    checks.push({
+      label: "Research Cached",
+      status: "warn",
+      message: "Could not check research cache",
+      weight: 5
+    });
+    totalScore += 5;
+  }
+  const unresolvedCount = getUnresolvedCount(stats.failedFiles);
+  const allFailures = stats.failedFiles.flatMap((f) => f.failures);
+  const testFailures = allFailures.filter((f) => f.error.toLowerCase().includes("test") || f.error.toLowerCase().includes("fail"));
+  const hasRunTests = stats.hasRunTests;
+  if (!hasRunTests) {
+    checks.push({
+      label: "Tests Status",
+      status: "warn",
+      message: "No tests run yet this session",
+      weight: 10
+    });
+    totalScore += 10;
+  } else if (testFailures.length === 0 && unresolvedCount === 0) {
+    checks.push({
+      label: "Tests Status",
+      status: "pass",
+      message: "All tests passing",
+      weight: 15
+    });
+    totalScore += 15;
+  } else if (testFailures.length <= 2) {
+    checks.push({
+      label: "Tests Status",
+      status: "warn",
+      message: `${testFailures.length} test failure(s) \u2014 needs attention`,
+      weight: 8
+    });
+    totalScore += 8;
+  } else {
+    checks.push({
+      label: "Tests Status",
+      status: "fail",
+      message: `${testFailures.length} test failure(s) \u2014 fix before proceeding`,
+      weight: 3
+    });
+    totalScore += 3;
+  }
+  const modifiedCount = stats.modifiedFiles.length;
+  if (modifiedCount === 0) {
+    checks.push({
+      label: "Modified Files",
+      status: "pass",
+      message: "No files modified yet",
+      weight: 15
+    });
+    totalScore += 15;
+  } else if (modifiedCount <= 3) {
+    checks.push({
+      label: "Modified Files",
+      status: "warn",
+      message: `${modifiedCount} file(s) modified`,
+      weight: 12
+    });
+    totalScore += 12;
+  } else if (modifiedCount <= 8) {
+    checks.push({
+      label: "Modified Files",
+      status: "warn",
+      message: `${modifiedCount} file(s) modified \u2014 consider a checkpoint`,
+      weight: 8
+    });
+    totalScore += 8;
+  } else {
+    checks.push({
+      label: "Modified Files",
+      status: "fail",
+      message: `${modifiedCount} file(s) modified \u2014 consider committing`,
+      weight: 4
+    });
+    totalScore += 4;
+  }
+  const loop = sessionMemory.detectLoop();
+  if (loop.isLooping) {
+    checks.push({
+      label: "Loop Detection",
+      status: "fail",
+      message: loop.message || "Potential tool call loop detected",
+      weight: 0
+    });
+  } else {
+    checks.push({
+      label: "Loop Detection",
+      status: "pass",
+      message: "No loops detected",
+      weight: 10
+    });
+    totalScore += 10;
+  }
+  if (unresolvedCount === 0) {
+    checks.push({
+      label: "Unresolved Failures",
+      status: "pass",
+      message: "No unresolved failures",
+      weight: 10
+    });
+    totalScore += 10;
+  } else if (unresolvedCount <= 2) {
+    checks.push({
+      label: "Unresolved Failures",
+      status: "warn",
+      message: `${unresolvedCount} unresolved failure(s)`,
+      weight: 6
+    });
+    totalScore += 6;
+  } else {
+    checks.push({
+      label: "Unresolved Failures",
+      status: "fail",
+      message: `${unresolvedCount} unresolved failure(s) \u2014 fix before continuing`,
+      weight: 2
+    });
+    totalScore += 2;
+  }
+  const hasConventions = !!sessionMemory.getConventions();
+  if (hasConventions) {
+    checks.push({
+      label: "Project Detected",
+      status: "pass",
+      message: "Framework, test runner, and conventions detected",
+      weight: 5
+    });
+    totalScore += 5;
+  } else {
+    checks.push({
+      label: "Project Detected",
+      status: "warn",
+      message: "Run project_conventions() to detect stack",
+      weight: 2
+    });
+    totalScore += 2;
+  }
+  const goal = inputGoal || sessionMemory.getSummary().currentGoal || "";
+  if (goal) {
+    checks.push({
+      label: "Goal Set",
+      status: "pass",
+      message: `Current goal: "${goal.substring(0, 60)}"`,
+      weight: 5
+    });
+    totalScore += 5;
+  } else {
+    checks.push({
+      label: "Goal Set",
+      status: "warn",
+      message: "No goal set \u2014 use goal parameter or setGoal to track intent",
+      weight: 2
+    });
+    totalScore += 2;
+  }
+  let risk;
+  if (totalScore >= 85) risk = "LOW";
+  else if (totalScore >= 65) risk = "MEDIUM";
+  else if (totalScore >= 40) risk = "HIGH";
+  else risk = "CRITICAL";
+  const passCount = checks.filter((c) => c.status === "pass").length;
+  const warnCount = checks.filter((c) => c.status === "warn").length;
+  const failCount = checks.filter((c) => c.status === "fail").length;
+  const summaryParts = [];
+  if (passCount > 0) summaryParts.push(`${passCount} check(s) passed`);
+  if (warnCount > 0) summaryParts.push(`${warnCount} warning(s)`);
+  if (failCount > 0) summaryParts.push(`${failCount} failure(s)`);
+  return {
+    score: totalScore,
+    maxScore,
+    risk,
+    checks,
+    summary: summaryParts.join(", "),
+    timestamp: (/* @__PURE__ */ new Date()).toISOString()
+  };
+}
+function formatSafetyScore(report) {
+  const barLength = 20;
+  const filledBars = Math.round(report.score / report.maxScore * barLength);
+  const emptyBars = barLength - filledBars;
+  const bar = "\u2588".repeat(filledBars) + "\u2591".repeat(emptyBars);
+  const riskEmoji = report.risk === "LOW" ? "\u{1F7E2}" : report.risk === "MEDIUM" ? "\u{1F7E1}" : report.risk === "HIGH" ? "\u{1F7E0}" : "\u{1F534}";
+  const lines = [
+    `\u{1F6E1}\uFE0F **Safety Score: ${report.score}/${report.maxScore}** ${riskEmoji}`,
+    `   ${bar}`,
+    `   Risk: **${report.risk}** \u2014 ${report.summary}`,
+    "",
+    "**Checks:**"
+  ];
+  for (const check of report.checks) {
+    const icon = check.status === "pass" ? "\u2705" : check.status === "warn" ? "\u26A0\uFE0F" : "\u274C";
+    lines.push(`  ${icon} **${check.label}:** ${check.message}`);
+  }
+  lines.push(
+    "",
+    "\u{1F4A1} Run kuma_safety_score() at any time to re-evaluate project health."
+  );
+  return lines.join("\n");
+}
+export {
+  computeSafetyScore,
+  formatSafetyScore
+};

package/dist/sessionMemory-52ECPXZ6.js

@@ -0,0 +1,6 @@
+import {
+  sessionMemory
+} from "./chunk-TT37TE4P.js";
+export {
+  sessionMemory
+};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@plumpslabs/kuma",
-  "version": "2.2.7",
-  "description": "Zero-setup safety toolkit for AI coding agents. MCP server with code review, git analysis, file editing, session memory, and static analysis — works with Claude Code, Cursor, Gemini CLI.",
+  "version": "2.3.0",
+  "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",
   "types": "dist/index.d.ts",

package/dist/sessionMemory-LGQFVHHE.js

@@ -1,14 +0,0 @@
-import {
-  SessionMemory,
-  getSessionMemory,
-  handleWriteMemory,
-  searchSessionMemory,
-  sessionMemory
-} from "./chunk-QPVPFUCQ.js";
-export {
-  SessionMemory,
-  getSessionMemory,
-  handleWriteMemory,
-  searchSessionMemory,
-  sessionMemory
-};