@plumpslabs/kuma 2.3.20 → 2.3.23

package/dist/safetyScore-TMMRD2MV.js

@@ -1,333 +0,0 @@
-import {
-  getGitDiffStat,
-  getSessionStats,
-  getUnresolvedCount
-} from "./chunk-3OHYYXYN.js";
-import {
-  sessionMemory
-} from "./chunk-LVKOGXLC.js";
-import "./chunk-E2KFPEBT.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 && gitStat !== "clean") {
-    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 if (gitStat === "clean") {
-    checks.push({
-      label: "Git Clean",
-      status: "pass",
-      message: "Working tree is clean",
-      weight: 20
-    });
-    totalScore += 20;
-  } 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-4XZ5S2LH.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-4XZ5S2LH.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;
-  let latestVerif = null;
-  try {
-    const { getLatestVerifications } = await import("./kumaDb-4XZ5S2LH.js");
-    const verifs = await getLatestVerifications(1);
-    if (verifs.length > 0) latestVerif = verifs[0];
-  } catch {
-  }
-  if (!hasRunTests && !latestVerif) {
-    checks.push({
-      label: "Tests Status",
-      status: "warn",
-      message: "No tests run yet this session \u2014 run kuma_safety({ action: 'verify' })",
-      weight: 10
-    });
-    totalScore += 10;
-  } else if (latestVerif) {
-    if (latestVerif.passed) {
-      checks.push({
-        label: "Tests Status",
-        status: "pass",
-        message: `Auto-verified passed (${latestVerif.scope})`,
-        weight: 15
-      });
-      totalScore += 15;
-    } else {
-      checks.push({
-        label: "Tests Status",
-        status: "fail",
-        message: `Auto-verification failed (${latestVerif.scope}) \u2014 fix before shipping`,
-        weight: 0
-      });
-    }
-  } 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-YPKVIOMV.js

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

package/dist/skillGenerator-PWEJKZNX.js

@@ -1,304 +0,0 @@
-// src/utils/skillGenerator.ts
-var BOOTSTRAP = [
-  "Kuma MCP tools are available (kuma_context, kuma_memory, kuma_safety).",
-  '**Before coding, call `kuma_context({ action: "init" })`** to load project context and session memory.',
-  "Project knowledge persists in `.kuma/memories/*.md` across sessions.",
-  "",
-  "\u26A0\uFE0F **MANDATORY WORKFLOW** \u2014 Follow in order every session (including research-only):",
-  "",
-  '  1. `kuma_context({ action: "init" })`                     \u2014 Load context (START HERE)',
-  '  2. `kuma_safety({ action: "guard" })`                     \u2014 Safety check before work',
-  '  3. `kuma_context({ action: "research", scope: "<area>" })` \u2014 Research before editing',
-  "  4. *(edit/read using native tools)*",
-  '  5. `kuma_memory({ action: "research_save", ... })`        \u2014 After exploring area (creates search cache)',
-  '  6. `kuma_memory({ action: "gotcha" })`                    \u2014 \u{1F525} IMMEDIATELY when bug found (exponential value)',
-  '  7. `kuma_memory({ action: "arch_flow" })`                 \u2014 \u{1F525} IMMEDIATELY after each flow hop (exponential value)',
-  '  8. `kuma_memory({ action: "decision" })`                  \u2014 When choosing between options (preserves rationale)',
-  '  9. `kuma_safety({ action: "verify", ... })`               \u2014 Run tests / confirm nothing broken',
-  ' 10. `kuma_context({ action: "changes" })`                  \u2014 Review session activity',
-  "",
-  "\u{1F525} **Power Curve:** `arch_flow` + `gotcha` are EXPONENTIAL \u2014 each record saves 5-10 files next session.",
-  "   The more you record, the more overpowered the agent becomes. These are the highest-value actions.",
-  "\u{1F7E2} **SKIP** recording function/class/component nodes \u2014 grep/glob is faster.",
-  "\u{1F9E0} Knowledge graph is persistent \u2014 nodes/edges accumulate across sessions, getting richer over time.",
-  "",
-  "\u26D4 Do NOT skip steps 5-10 after research \u2014 even if no code was changed.",
-  "\u{1F4D6} Full rules: `.kuma/init.md`",
-  "\u{1F9E0} Tools: `kuma_context` | `kuma_memory` | `kuma_safety`"
-].join("\n");
-function generateSkill(type) {
-  switch (type) {
-    case "claude":
-      return generateClaudeSkill();
-    case "cursor":
-      return generateCursorSkill();
-    case "cline":
-      return generateClineSkill();
-    case "antigravity":
-      return generateAntigravitySkill();
-    case "codex":
-      return generateCodexSkill();
-    case "opencode":
-      return generateOpencodeSkill();
-    case "aider":
-      return generateAiderSkill();
-    case "windsurf":
-      return generateWindsurfSkill();
-    case "copilot":
-      return generateCopilotSkill();
-    case "qwen":
-      return generateQwenSkill();
-    case "kiro":
-      return generateKiroSkill();
-    case "openclaw":
-      return generateOpenclawSkill();
-    case "codewhale":
-      return generateCodewhaleSkill();
-  }
-}
-function getSecondaryFiles(type) {
-  switch (type) {
-    case "antigravity":
-      return [{ path: ".agents/mcp_config.json", content: generateAntigravityMcpConfig() }];
-    case "codex":
-      return [{ path: ".codex/config.toml", content: generateCodexConfigToml() }];
-    case "qwen":
-      return [{ path: "settings.json", content: generateQwenSettings() }];
-    case "aider":
-      return [{ path: ".aider.conf.yml", content: generateAiderConfig() }];
-    case "codewhale":
-      return [{ path: ".codewhale/mcp.json", content: generateCodewhaleMcpConfig() }];
-    default:
-      return [];
-  }
-}
-function generateClaudeSkill() {
-  return [
-    "---",
-    "name: kuma-mcp",
-    "description: Kuma MCP \u2014 safety toolkit for AI coding agents",
-    "---",
-    "",
-    BOOTSTRAP,
-    "",
-    "\u{1F4D6} **Usage:**",
-    '  \u2022 `kuma_context({ action: "init" })` \u2014 load project context (call first)',
-    '  \u2022 `kuma_safety({ action: "guard" })` \u2014 safety check before risky ops',
-    '  \u2022 `kuma_safety({ action: "verify", scope: "<area>" })` \u2014 verify after edits',
-    "  \u2022 `.kuma/init.md` \u2014 full behavioral rules",
-    "  \u2022 `.kuma/memories/` \u2014 persistent project knowledge"
-  ].join("\n");
-}
-function generateCursorSkill() {
-  return [
-    "---",
-    "description: Kuma MCP \u2014 safety and context runtime for AI agents",
-    "alwaysApply: true",
-    "---",
-    "",
-    BOOTSTRAP,
-    "",
-    "\u{1F4D6} **Usage:**",
-    '  \u2022 `kuma_context({ action: "init" })` \u2014 load project context (call first)',
-    '  \u2022 `kuma_safety({ action: "guard" })` \u2014 safety check before risky ops',
-    '  \u2022 `kuma_safety({ action: "verify", scope: "<area>" })` \u2014 verify after edits',
-    "  \u2022 `.kuma/init.md` \u2014 full behavioral rules",
-    "  \u2022 `.kuma/memories/` \u2014 persistent project knowledge"
-  ].join("\n");
-}
-function generateClineSkill() {
-  return [
-    "---",
-    "description: Kuma MCP \u2014 safety toolkit for AI coding agents",
-    "paths:",
-    '  - "*"',
-    "---",
-    "",
-    BOOTSTRAP,
-    "",
-    "\u{1F4D6} **Usage:**",
-    '  \u2022 `kuma_context({ action: "init" })` \u2014 load project context (call first)',
-    '  \u2022 `kuma_safety({ action: "guard" })` \u2014 safety check before risky ops',
-    '  \u2022 `kuma_safety({ action: "verify", scope: "<area>" })` \u2014 verify after edits',
-    "  \u2022 `.kuma/init.md` \u2014 full behavioral rules"
-  ].join("\n");
-}
-function generateAntigravitySkill() {
-  return [
-    "---",
-    "name: kuma-mcp",
-    "description: Kuma MCP \u2014 safety toolkit for AI coding agents",
-    "---",
-    "",
-    BOOTSTRAP,
-    "",
-    "\u{1F4D6} **Usage:**",
-    '  \u2022 `kuma_context({ action: "init" })` \u2014 load project context (call first)',
-    '  \u2022 `kuma_safety({ action: "guard" })` \u2014 safety check',
-    '  \u2022 `kuma_safety({ action: "verify", scope: "<area>" })` \u2014 verify after edits',
-    "  \u2022 `.kuma/init.md` \u2014 full behavioral rules"
-  ].join("\n");
-}
-function generateAntigravityMcpConfig() {
-  return JSON.stringify({
-    mcpServers: {
-      kuma: {
-        command: "npx",
-        args: ["-y", "@plumpslabs/kuma"],
-        env: {}
-      }
-    }
-  }, null, 2) + "\n";
-}
-function generateCodexSkill() {
-  return generateAntigravitySkill();
-}
-function generateCodexConfigToml() {
-  return [
-    "# Generated by Kuma MCP - https://github.com/plumpslabs/kuma",
-    "# Kuma MCP server config for Codex CLI",
-    "",
-    "[mcp_servers.kuma]",
-    'command = "npx"',
-    'args = ["-y", "@plumpslabs/kuma"]',
-    ""
-  ].join("\n");
-}
-function generateOpencodeSkill() {
-  return [
-    "---",
-    "name: kuma-mcp",
-    "description: Kuma MCP \u2014 safety toolkit for AI coding agents. Research, memory, and safety guard.",
-    "---",
-    "",
-    "\u26A0\uFE0F **OpenCode platform note:** Tool names use `kuma_kuma_*` prefix",
-    "   (server name `kuma` + already-prefixed `kuma_context`).",
-    '   Example: `kuma_kuma_context({ action: "init" })`',
-    "",
-    BOOTSTRAP,
-    "",
-    "\u{1F4D6} Read `.kuma/init.md` for detailed rules."
-  ].join("\n");
-}
-function generateAiderSkill() {
-  return [
-    "# Kuma MCP \u2014 Aider Conventions",
-    "",
-    BOOTSTRAP,
-    "",
-    "\u{1F4D6} **Usage:**",
-    '  \u2022 `kuma_context({ action: "init" })` \u2014 load project context (call first)',
-    '  \u2022 `kuma_safety({ action: "guard" })` \u2014 safety check',
-    '  \u2022 `kuma_safety({ action: "verify", scope: "<area>" })` \u2014 verify after edits',
-    "  \u2022 `.kuma/init.md` \u2014 full behavioral rules"
-  ].join("\n");
-}
-function generateAiderConfig() {
-  return [
-    "# Generated by Kuma MCP - https://github.com/plumpslabs/kuma",
-    "# Aider will read CONVENTIONS.md for coding conventions",
-    "",
-    "read: CONVENTIONS.md",
-    ""
-  ].join("\n");
-}
-function generateWindsurfSkill() {
-  return [
-    "# Kuma MCP \u2014 Windsurf",
-    "",
-    BOOTSTRAP,
-    "",
-    "Also auto-detected via `.windsurf/skills/` and `.agents/skills/`."
-  ].join("\n");
-}
-function generateCopilotSkill() {
-  return [
-    "---",
-    "name: kuma-mcp",
-    "description: Kuma MCP \u2014 safety toolkit for AI coding agents",
-    "---",
-    "",
-    BOOTSTRAP,
-    "",
-    "\u{1F4D6} **Usage:**",
-    '  \u2022 `kuma_context({ action: "init" })` \u2014 load project context (call first)',
-    '  \u2022 `kuma_safety({ action: "guard" })` \u2014 safety check',
-    '  \u2022 `kuma_safety({ action: "verify", scope: "<area>" })` \u2014 verify after edits',
-    "  \u2022 `.kuma/init.md` \u2014 full behavioral rules"
-  ].join("\n");
-}
-function generateQwenSkill() {
-  return [
-    "## Kuma MCP",
-    "",
-    BOOTSTRAP,
-    "",
-    "\u{1F4D6} **Usage:**",
-    '  \u2022 `kuma_context({ action: "init" })` \u2014 load project context (call first)',
-    '  \u2022 `kuma_safety({ action: "guard" })` \u2014 safety check',
-    '  \u2022 `kuma_safety({ action: "verify", scope: "<area>" })` \u2014 verify after edits',
-    "  \u2022 `.kuma/init.md` \u2014 full behavioral rules"
-  ].join("\n");
-}
-function generateQwenSettings() {
-  return JSON.stringify({
-    mcpServers: {
-      kuma: {
-        command: "npx",
-        args: ["-y", "@plumpslabs/kuma"],
-        env: {}
-      }
-    }
-  }, null, 2) + "\n";
-}
-function generateKiroSkill() {
-  return [
-    "---",
-    "name: kuma-mcp",
-    "description: Kuma MCP \u2014 safety toolkit for AI coding agents",
-    "inclusion: always",
-    "---",
-    "",
-    BOOTSTRAP,
-    "",
-    "\u{1F4D6} **Usage:**",
-    '  \u2022 `kuma_context({ action: "init" })` \u2014 load project context (call first)',
-    '  \u2022 `kuma_safety({ action: "guard" })` \u2014 safety check',
-    '  \u2022 `kuma_safety({ action: "verify", scope: "<area>" })` \u2014 verify after edits',
-    "  \u2022 `.kuma/init.md` \u2014 full behavioral rules"
-  ].join("\n");
-}
-function generateOpenclawSkill() {
-  return [
-    "---",
-    "name: kuma-mcp",
-    "description: Kuma MCP \u2014 safety toolkit for AI coding agents",
-    "---",
-    "",
-    BOOTSTRAP,
-    "",
-    "\u{1F4D6} **Usage:**",
-    '  \u2022 `kuma_context({ action: "init" })` \u2014 load project context (call first)',
-    '  \u2022 `kuma_safety({ action: "guard" })` \u2014 safety check',
-    '  \u2022 `kuma_safety({ action: "verify", scope: "<area>" })` \u2014 verify after edits',
-    "  \u2022 `.kuma/init.md` \u2014 full behavioral rules"
-  ].join("\n");
-}
-function generateCodewhaleSkill() {
-  return generateOpenclawSkill();
-}
-function generateCodewhaleMcpConfig() {
-  return JSON.stringify({
-    mcpServers: {
-      kuma: {
-        command: "npx",
-        args: ["-y", "@plumpslabs/kuma"],
-        env: {}
-      }
-    }
-  }, null, 2) + "\n";
-}
-export {
-  generateSkill,
-  getSecondaryFiles
-};