@plumpslabs/kuma 2.3.19 → 2.3.22

package/dist/kumaVerifier-6YEGC77M.js

@@ -1,265 +0,0 @@
-import {
-  sessionMemory
-} from "./chunk-LVKOGXLC.js";
-import {
-  getLatestVerifications,
-  saveVerification
-} from "./chunk-3BRBJZ7P.js";
-import "./chunk-E2KFPEBT.js";
-
-// src/engine/kumaVerifier.ts
-import fs from "fs";
-import path from "path";
-import { exec } from "child_process";
-var LOCK_DIR_NAME = ".kuma/verifier.lock";
-function getLockDir(root = process.cwd()) {
-  return path.resolve(root, LOCK_DIR_NAME);
-}
-function getPidFile(root = process.cwd()) {
-  return path.join(getLockDir(root), "pid");
-}
-function acquireFileLock(root) {
-  const lockDir = getLockDir(root);
-  try {
-    fs.mkdirSync(lockDir, { recursive: false });
-    fs.writeFileSync(getPidFile(root), String(process.pid), "utf-8");
-    return true;
-  } catch {
-    try {
-      if (fs.existsSync(getPidFile(root))) {
-        const pid = parseInt(fs.readFileSync(getPidFile(root), "utf-8"), 10);
-        try {
-          process.kill(pid, 0);
-          return false;
-        } catch {
-          fs.rmSync(lockDir, { recursive: true, force: true });
-          return acquireFileLock(root);
-        }
-      }
-    } catch {
-    }
-    try {
-      fs.rmSync(lockDir, { recursive: true, force: true });
-      return acquireFileLock(root);
-    } catch {
-      return false;
-    }
-  }
-}
-function releaseFileLock(root) {
-  try {
-    fs.rmSync(getLockDir(root), { recursive: true, force: true });
-  } catch {
-  }
-}
-var _localRunning = false;
-var _currentProcess = null;
-var STALE_RESULT_MS = 3e5;
-var DEFAULT_TIMEOUT_MS = 3e4;
-var RUNAWAY_WINDOW_MS = 3e5;
-var RUNAWAY_MAX_CALLS = 3;
-var _verifyCallTimestamps = [];
-function checkRunaway() {
-  const now = Date.now();
-  while (_verifyCallTimestamps.length > 0 && _verifyCallTimestamps[0] < now - RUNAWAY_WINDOW_MS) {
-    _verifyCallTimestamps.shift();
-  }
-  if (_verifyCallTimestamps.length >= RUNAWAY_MAX_CALLS) {
-    const oldestInWindow = _verifyCallTimestamps[0];
-    const waitMs = RUNAWAY_WINDOW_MS - (now - oldestInWindow);
-    const waitSec = Math.ceil(waitMs / 1e3);
-    return `\u26D4 **Runaway protection active** \u2014 ${RUNAWAY_MAX_CALLS}+ verify calls in the last 5 minutes. Please wait ${waitSec}s before trying again.
-\u{1F4A1} This prevents resource exhaustion (CPU/RAM) from uncontrolled test spawning.`;
-  }
-  _verifyCallTimestamps.push(now);
-  return null;
-}
-function getRunningVerificationPid() {
-  return _currentProcess?.pid ?? null;
-}
-function detectTestRunner(root = process.cwd()) {
-  const pkgPath = path.join(root, "package.json");
-  if (fs.existsSync(pkgPath)) {
-    try {
-      const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
-      if (pkg.scripts && pkg.scripts.test) {
-        if (fs.existsSync(path.join(root, "pnpm-lock.yaml"))) return { runner: "pnpm", baseCommand: "pnpm test" };
-        if (fs.existsSync(path.join(root, "yarn.lock"))) return { runner: "yarn", baseCommand: "yarn test" };
-        return { runner: "npm", baseCommand: "npm test" };
-      }
-    } catch {
-    }
-  }
-  if (fs.existsSync(path.join(root, "pytest.ini")) || fs.existsSync(path.join(root, "pyproject.toml"))) return { runner: "pytest", baseCommand: "pytest" };
-  if (fs.existsSync(path.join(root, "Cargo.toml"))) return { runner: "cargo", baseCommand: "cargo test" };
-  if (fs.existsSync(path.join(root, "go.mod"))) return { runner: "go", baseCommand: "go test ./..." };
-  if (fs.existsSync(path.join(root, "Makefile"))) {
-    try {
-      const makefileContent = fs.readFileSync(path.join(root, "Makefile"), "utf-8");
-      const hasTestTarget = /^test:/m.test(makefileContent) || /^\s+test:/.test(makefileContent);
-      if (hasTestTarget) return { runner: "make", baseCommand: "make test" };
-    } catch {
-    }
-  }
-  if (fs.existsSync(path.join(root, "package.json"))) {
-    try {
-      const pkg = JSON.parse(fs.readFileSync(path.join(root, "package.json"), "utf-8"));
-      if (pkg.dependencies || pkg.devDependencies) {
-        if (fs.existsSync(path.join(root, "tsconfig.json"))) return { runner: "tsc", baseCommand: "npx tsc --noEmit" };
-        const srcDir = path.join(root, "src");
-        if (fs.existsSync(srcDir)) return { runner: "node", baseCommand: `node -c "${srcDir}/**/*.js" 2>/dev/null || node --check $(find src -name '*.js' 2>/dev/null | head -5)` };
-      }
-    } catch {
-    }
-  }
-  return { runner: "unknown", baseCommand: "npm test || echo 'No test runner configured'" };
-}
-function checkAllowed(root) {
-  if (_localRunning) return "\u23F3 Verification already in progress (this instance).";
-  if (!acquireFileLock(root)) return "\u23F3 Another Kuma instance is running verification.";
-  return null;
-}
-async function checkStaleness(scope) {
-  if (scope !== "session-impact" && scope !== void 0) return null;
-  try {
-    const recent = await getLatestVerifications(1);
-    if (recent.length === 0) return null;
-    const age = Date.now() - recent[0].created_at * 1e3;
-    if (age >= STALE_RESULT_MS) return null;
-    const ageSeconds = Math.floor(age / 1e3);
-    return [
-      `\u23E9 **Using cached verification** (${ageSeconds}s old, < 5 min threshold)`,
-      `\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`,
-      "",
-      `\u{1F6E0}\uFE0F Runner: \`${recent[0].runner}\``,
-      `\u{1F4BB} Command: \`${recent[0].test_command}\``,
-      `\u{1F3AF} Scope: \`${recent[0].scope}\``,
-      `\u23F1\uFE0F Original duration: ${recent[0].duration_ms}ms`,
-      "",
-      recent[0].passed ? "\u2705 **Result: PASSED** (served from cache)" : "\u{1F534} **Result: FAILED** (served from cache)",
-      "",
-      "\u{1F4A1} Use `force: true` to bypass cache and run tests again."
-    ].join("\n");
-  } catch {
-    return null;
-  }
-}
-async function runAutoVerification(options = {}) {
-  const startTime = Date.now();
-  const root = process.cwd();
-  const scope = options.scope || "session-impact";
-  const timeoutMs = options.timeoutMs || DEFAULT_TIMEOUT_MS;
-  const denial = checkAllowed(root);
-  if (denial) return denial;
-  const runawayBlock = checkRunaway();
-  if (runawayBlock) {
-    releaseFileLock(root);
-    return runawayBlock;
-  }
-  try {
-    if (!options.force) {
-      const cached = await checkStaleness(scope);
-      if (cached) {
-        releaseFileLock(root);
-        return cached;
-      }
-    }
-    _localRunning = true;
-    const { runner, baseCommand } = detectTestRunner(root);
-    let testFiles = [];
-    const modified = sessionMemory.getModifiedFiles().map((f) => f.filePath);
-    if (options.scope) {
-      const term = options.scope.toLowerCase();
-      testFiles = modified.filter((f) => f.toLowerCase().includes(term));
-      if (testFiles.length === 0) {
-        try {
-          const { default: glob } = await import("fast-glob");
-          testFiles = await glob([`**/*${term}*test*.*`, `**/*test*/*${term}*.*`], { cwd: root, ignore: ["node_modules/**", "dist/**"] });
-        } catch {
-        }
-      }
-    } else {
-      testFiles = modified.filter((f) => f.includes(".test.") || f.includes(".spec.") || f.includes("_test."));
-    }
-    let fullCommand = baseCommand;
-    if (testFiles.length > 0 && runner === "npm") {
-      fullCommand = `${baseCommand} -- ${testFiles.map((f) => `"${f}"`).join(" ")}`;
-    }
-    return await new Promise((resolve) => {
-      const killTimer = setTimeout(() => {
-        if (_currentProcess && !_currentProcess.killed) {
-          try {
-            const childPid = _currentProcess.pid;
-            if (childPid) {
-              try {
-                process.kill(-childPid, "SIGKILL");
-              } catch {
-              }
-              try {
-                _currentProcess.kill("SIGKILL");
-              } catch {
-              }
-            }
-          } catch {
-          }
-        }
-      }, timeoutMs + 5e3);
-      const heartbeatTimer = setInterval(() => {
-        if (getLockDir(root)) {
-          try {
-            fs.writeFileSync(getPidFile(root), String(process.pid), "utf-8");
-          } catch {
-          }
-        }
-      }, 15e3);
-      const child = exec(fullCommand, { cwd: root, timeout: timeoutMs }, async (error, stdout, stderr) => {
-        const durationMs = Date.now() - startTime;
-        const rawOutput = (stdout + "\n" + stderr).trim();
-        const passed = !error;
-        const truncatedOutput = rawOutput.length > 2e3 ? rawOutput.substring(rawOutput.length - 2e3) : rawOutput;
-        await saveVerification(scope, runner, fullCommand, passed, truncatedOutput, durationMs);
-        _localRunning = false;
-        _currentProcess = null;
-        releaseFileLock(root);
-        clearInterval(heartbeatTimer);
-        const statusSymbol = passed ? "\u2705" : "\u{1F534}";
-        const lines = [
-          `${statusSymbol} **Verification ${passed ? "PASSED" : "FAILED"}**`,
-          `\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`,
-          "",
-          `\u{1F6E0}\uFE0F **Runner**: \`${runner}\``,
-          `\u{1F4BB} **Command**: \`${fullCommand}\``,
-          `\u{1F3AF} **Scope**: \`${scope}\`${testFiles.length > 0 ? ` (${testFiles.length} file(s) matched)` : ""}`,
-          `\u23F1\uFE0F **Duration**: ${durationMs}ms`,
-          ""
-        ];
-        if (!passed) {
-          lines.push("\u26A0\uFE0F **Verification failed!** Please fix test failures before shipping.");
-          if (error && error.killed) {
-            lines.push(`\u23F0 **Process was killed after ${timeoutMs}ms timeout**`);
-          }
-          lines.push("```text", rawOutput.substring(0, 1500), "```");
-        } else {
-          lines.push("\u{1F389} All scoped tests passed!");
-          if (rawOutput) lines.push("```text", rawOutput.substring(0, 800), "```");
-        }
-        resolve(lines.join("\n"));
-      });
-      _currentProcess = child;
-      _localRunning = true;
-      child.on("close", () => {
-        clearTimeout(killTimer);
-      });
-    });
-  } catch (err) {
-    releaseFileLock(root);
-    _localRunning = false;
-    _currentProcess = null;
-    return `\u274C Verification failed with error: ${err}`;
-  }
-}
-export {
-  detectTestRunner,
-  getRunningVerificationPid,
-  runAutoVerification
-};

package/dist/kumaVisualize-264OEBGJ.js

@@ -1,264 +0,0 @@
-import {
-  getDb
-} from "./chunk-3BRBJZ7P.js";
-import "./chunk-E2KFPEBT.js";
-
-// src/engine/kumaVisualize.ts
-async function visualizeGraph(options = {}) {
-  const {
-    type = "flowchart",
-    scope,
-    maxNodes = 30,
-    // depth unused: kept for API consistency
-    format = "mermaid"
-  } = options;
-  try {
-    const db = await getDb();
-    let nodeSql = `SELECT id, type, name, file_path FROM nodes WHERE 1=1`;
-    const nodeBind = [];
-    if (scope) {
-      nodeSql += ` AND (name LIKE ? OR file_path LIKE ? OR id LIKE ?)`;
-      nodeBind.push(`%${scope}%`, `%${scope}%`, `%${scope}%`);
-    }
-    nodeSql += ` ORDER BY updated_at DESC LIMIT ?`;
-    nodeBind.push(maxNodes);
-    const nodeStmt = db.prepare(nodeSql);
-    nodeStmt.bind(nodeBind);
-    const nodes = [];
-    while (nodeStmt.step()) {
-      nodes.push(nodeStmt.getAsObject());
-    }
-    nodeStmt.free();
-    if (nodes.length === 0) {
-      return format === "mermaid" ? "```mermaid\nflowchart TD\n  Start[Empty Graph \u2014 No nodes found]\n```" : "\u{1F4ED} **Empty Graph** \u2014 No nodes found to visualize.";
-    }
-    const nodeIds = nodes.map((n) => n.id);
-    const edgeSql = `
-      SELECT e.source_id, e.target_id, e.type, e.weight,
-        sn.name AS source_name, tn.name AS target_name
-      FROM edges e
-      JOIN nodes sn ON sn.id = e.source_id
-      JOIN nodes tn ON tn.id = e.target_id
-      WHERE (e.source_id IN (${nodeIds.map(() => "?").join(",")})
-         OR e.target_id IN (${nodeIds.map(() => "?").join(",")}))
-        AND e.source_id != e.target_id
-      ORDER BY e.weight DESC
-      LIMIT 100
-    `;
-    const edgeBind = [...nodeIds, ...nodeIds];
-    const edgeStmt = db.prepare(edgeSql);
-    edgeStmt.bind(edgeBind);
-    const edges = [];
-    while (edgeStmt.step()) {
-      edges.push(edgeStmt.getAsObject());
-    }
-    edgeStmt.free();
-    switch (type) {
-      case "flowchart":
-        return formatFlowchart(nodes, edges, format);
-      case "dependency":
-        return formatDependencyGraph(nodes, edges, format);
-      case "mindmap":
-        return formatMindMap(nodes, edges, format);
-      default:
-        return formatFlowchart(nodes, edges, format);
-    }
-  } catch (err) {
-    return `Error generating visualization: ${err}`;
-  }
-}
-function formatFlowchart(nodes, edges, _format) {
-  void _format;
-  const lines = ["```mermaid", "flowchart TD"];
-  for (const node of nodes) {
-    const id = sanitizeId(node.id);
-    const name = truncate(node.name, 30);
-    const nodeType = node.type;
-    const shape = getNodeShape(nodeType);
-    if (shape) {
-      lines.push(`  ${id}${shape}${name}${reverseShape(shape)}`);
-    } else {
-      lines.push(`  ${id}[${name}]`);
-    }
-  }
-  for (const edge of edges) {
-    const sourceId = sanitizeId(edge.source_id);
-    const targetId = sanitizeId(edge.target_id);
-    const edgeType = edge.type;
-    void edge.weight;
-    const label = truncate(edgeType, 15);
-    const edgeStyle = getEdgeStyle(edgeType);
-    lines.push(`  ${sourceId}${edgeStyle}|${label}|${targetId}`);
-  }
-  lines.push("```");
-  return lines.join("\n");
-}
-function formatDependencyGraph(nodes, edges, _format) {
-  void _format;
-  const lines = ["```mermaid", "flowchart LR"];
-  const grouped = /* @__PURE__ */ new Map();
-  for (const node of nodes) {
-    const type = node.type || "unknown";
-    if (!grouped.has(type)) grouped.set(type, []);
-    grouped.get(type).push(node);
-  }
-  let subgraphIndex = 0;
-  for (const [type, typeNodes] of grouped) {
-    if (typeNodes.length < 1) continue;
-    lines.push(`  subgraph ${type.toUpperCase()}[${type.toUpperCase()}]`);
-    for (const node of typeNodes) {
-      const id = sanitizeId(node.id);
-      const name = truncate(node.name, 25);
-      lines.push(`    ${id}(${name})`);
-    }
-    lines.push("  end");
-    subgraphIndex++;
-  }
-  for (const edge of edges) {
-    const sourceId = sanitizeId(edge.source_id);
-    const targetId = sanitizeId(edge.target_id);
-    const edgeType = edge.type;
-    const style = getEdgeStyle(edgeType);
-    lines.push(`  ${sourceId}${style}|${edgeType}|${targetId}`);
-  }
-  lines.push("```");
-  return lines.join("\n");
-}
-function formatMindMap(nodes, edges, _format) {
-  void _format;
-  const lines = ["```mermaid", "mindmap"];
-  const hasIncoming = /* @__PURE__ */ new Set();
-  for (const edge of edges) {
-    hasIncoming.add(edge.target_id);
-  }
-  const roots = nodes.filter((n) => !hasIncoming.has(n.id));
-  if (roots.length === 0 && nodes.length > 0) {
-    const root = nodes[0];
-    lines.push(`  root((${truncate(root.name, 25)}))`);
-    for (const node of nodes.slice(1)) {
-      lines.push(`    ${sanitizeId(node.id)}(${truncate(node.name, 25)})`);
-    }
-  } else {
-    for (const root of roots.slice(0, 3)) {
-      lines.push(`  root((${truncate(root.name, 25)}))`);
-    }
-    const others = nodes.filter((n) => !roots.includes(n));
-    for (const node of others.slice(0, 10)) {
-      const parent = edges.find((e) => e.source_id === node.id || e.target_id === node.id);
-      const indent = parent ? "    " : "  ";
-      lines.push(`${indent}${sanitizeId(node.id)}(${truncate(node.name, 25)})`);
-    }
-  }
-  lines.push("```");
-  return lines.join("\n");
-}
-function sanitizeId(id) {
-  const safe = id.replace(/[^a-zA-Z0-9_]/g, "_").replace(/^(\d)/, "n$1").substring(0, 40);
-  return safe || "n0";
-}
-function truncate(str, maxLen) {
-  if (str.length <= maxLen) return str;
-  return str.substring(0, maxLen - 3) + "...";
-}
-function getNodeShape(type) {
-  switch (type) {
-    case "function":
-      return "([";
-    case "file":
-      return "[";
-    case "test":
-      return "{";
-    case "api_route":
-      return "[[";
-    case "db_table":
-      return ">";
-    // database shape approximation
-    case "class":
-      return "[";
-    case "interface":
-      return "(";
-    case "module":
-      return "[";
-    case "variable":
-      return "(";
-    // Domain Flow shapes (V4)
-    case "feature_domain":
-      return "[";
-    // box with rounded corners
-    case "workflow":
-      return "([";
-    // stadium shape
-    case "cross_service_link":
-      return "[";
-    default:
-      return "[";
-  }
-}
-function reverseShape(shape) {
-  const map = {
-    "([": "])",
-    "[": "]",
-    "{": "}",
-    "[[": "]]",
-    ">": "<]",
-    "(": ")"
-  };
-  return map[shape] || "]";
-}
-function getEdgeStyle(type) {
-  switch (type) {
-    case "calls":
-      return " ==> ";
-    case "imports":
-      return " -.-> ";
-    case "defines":
-      return " --- ";
-    case "tests":
-      return " -.-> ";
-    case "routes":
-      return " ==> ";
-    case "implements":
-      return " -.-> ";
-    case "extends":
-      return " ==> ";
-    case "depends_on":
-      return " -.-> ";
-    case "owns":
-      return " --- ";
-    case "modified_by":
-      return " -.-> ";
-    // Domain Flow edge styles (V4)
-    case "flows_through":
-      return " ==> ";
-    case "triggers":
-      return " -.-> ";
-    case "syncs_with":
-      return " <==> ";
-    default:
-      return " --- ";
-  }
-}
-async function generateVisualizeReport(options = {}) {
-  const diagram = await visualizeGraph(options);
-  const lines = [
-    "\u{1F3A8} **Knowledge Graph Visualization**",
-    "\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",
-    "",
-    diagram,
-    "",
-    "\u{1F4CB} **Rendering Instructions:**",
-    "- Paste the Mermaid code above into any Mermaid-compatible viewer",
-    "- GitHub: Mermaid code blocks render automatically",
-    "- VS Code: Install 'Markdown Preview Mermaid Support' extension",
-    "- Online: https://mermaid.live",
-    "",
-    "\u{1F4A1} Use `kuma_visualize({ type: 'dependency' })` for clustered view",
-    "\u{1F4A1} Use `kuma_visualize({ type: 'mindmap' })` for overview",
-    "\u{1F4A1} Use `kuma_visualize({ scope: 'auth' })` to filter by topic"
-  ];
-  return lines.join("\n");
-}
-export {
-  generateVisualizeReport,
-  visualizeGraph
-};

package/dist/pathValidator-V4DC6U6Z.js

@@ -1,22 +0,0 @@
-import {
-  ensureBackupDir,
-  getBackupPath,
-  getKumaBackupsDir,
-  getKumaDir,
-  getProjectRoot,
-  isReadable,
-  isWritable,
-  validateFileExtension,
-  validateFilePath
-} from "./chunk-E2KFPEBT.js";
-export {
-  ensureBackupDir,
-  getBackupPath,
-  getKumaBackupsDir,
-  getKumaDir,
-  getProjectRoot,
-  isReadable,
-  isWritable,
-  validateFileExtension,
-  validateFilePath
-};

package/dist/safetyAudit-O45SPNTS.js

@@ -1,12 +0,0 @@
-import {
-  auditStats,
-  queryAudit,
-  recordAudit
-} from "./chunk-GFLSAXAH.js";
-import "./chunk-3BRBJZ7P.js";
-import "./chunk-E2KFPEBT.js";
-export {
-  auditStats,
-  queryAudit,
-  recordAudit
-};