@plumpslabs/kuma 2.3.19 → 2.3.22

package/dist/kumaContractEngine-KX27T4N7.js

@@ -1,305 +0,0 @@
-import {
-  getProjectRoot
-} from "./chunk-E2KFPEBT.js";
-
-// src/engine/kumaContractEngine.ts
-import fs from "fs";
-import path from "path";
-var DEFAULT_CONTRACTS = {
-  version: 1,
-  contracts: [
-    {
-      id: "no-delete-tests-without-replacement",
-      description: "Test files should not be deleted without replacement",
-      appliesTo: ["*"],
-      preConditions: [],
-      postConditions: [
-        {
-          type: "not_contains",
-          target: "*/.test.*",
-          value: "test.skip",
-          description: "Tests should not be skipped without reason"
-        }
-      ],
-      severity: "warning"
-    },
-    {
-      id: "no-silent-empty-catch",
-      description: "Catch blocks must not be empty",
-      appliesTo: ["*"],
-      preConditions: [],
-      postConditions: [
-        {
-          type: "not_contains",
-          target: "*.ts",
-          value: "catch {}",
-          description: "Empty catch blocks suppress errors silently"
-        },
-        {
-          type: "not_contains",
-          target: "*.ts",
-          value: "catch (e) {}",
-          description: "Empty catch (e) {} suppresses errors silently"
-        }
-      ],
-      severity: "error"
-    },
-    {
-      id: "api-response-shape",
-      description: "API response shape must be preserved",
-      appliesTo: ["src/api/*", "src/routes/*"],
-      preConditions: [],
-      postConditions: [],
-      severity: "warning"
-    }
-  ]
-};
-function contractsDir() {
-  return path.join(getProjectRoot(), ".kuma", "contracts");
-}
-function ensureContractsDir() {
-  const dir = contractsDir();
-  if (!fs.existsSync(dir)) {
-    fs.mkdirSync(dir, { recursive: true });
-    const defaultPath = path.join(dir, "default.json");
-    if (!fs.existsSync(defaultPath)) {
-      fs.writeFileSync(
-        defaultPath,
-        JSON.stringify(DEFAULT_CONTRACTS, null, 2),
-        "utf-8"
-      );
-    }
-  }
-}
-function loadContracts() {
-  ensureContractsDir();
-  const dir = contractsDir();
-  const contracts = [];
-  try {
-    const files = fs.readdirSync(dir).filter((f) => f.endsWith(".json"));
-    for (const file of files) {
-      try {
-        const content = fs.readFileSync(path.join(dir, file), "utf-8");
-        const config = JSON.parse(content);
-        contracts.push(config);
-      } catch (err) {
-        console.error(`[ContractEngine] Failed to load ${file}: ${err}`);
-      }
-    }
-  } catch {
-  }
-  if (contracts.length === 0) {
-    contracts.push(DEFAULT_CONTRACTS);
-  }
-  return contracts;
-}
-function evaluatePreConditions(toolName, filePath) {
-  const contracts = loadContracts();
-  const verdicts = [];
-  for (const config of contracts) {
-    for (const contract of config.contracts) {
-      if (!appliesToContract(contract, toolName, filePath)) continue;
-      const violations = [];
-      for (const condition of contract.preConditions) {
-        const result = evaluateCondition(condition, filePath);
-        if (!result.passed) {
-          violations.push({
-            condition,
-            message: result.message,
-            severity: contract.severity
-          });
-        }
-      }
-      verdicts.push({
-        contractId: contract.id,
-        description: contract.description,
-        passed: violations.length === 0,
-        violations
-      });
-    }
-  }
-  return verdicts;
-}
-function evaluatePostConditions(toolName, filePath) {
-  const contracts = loadContracts();
-  const verdicts = [];
-  for (const config of contracts) {
-    for (const contract of config.contracts) {
-      if (!appliesToContract(contract, toolName, filePath)) continue;
-      const violations = [];
-      for (const condition of contract.postConditions) {
-        const result = evaluateCondition(condition, filePath);
-        if (!result.passed) {
-          violations.push({
-            condition,
-            message: result.message,
-            severity: contract.severity
-          });
-        }
-      }
-      verdicts.push({
-        contractId: contract.id,
-        description: contract.description,
-        passed: violations.length === 0,
-        violations
-      });
-    }
-  }
-  return verdicts;
-}
-function evaluateCondition(condition, contextPath) {
-  const root = getProjectRoot();
-  switch (condition.type) {
-    case "file_exists": {
-      const targetPath = resolveTarget(condition.target, contextPath, root);
-      const exists = targetPath.some((p) => fs.existsSync(p));
-      return {
-        passed: exists,
-        message: exists ? `\u2705 File exists: ${condition.target}` : `\u274C Required file not found: ${condition.target} (${condition.description})`
-      };
-    }
-    case "file_not_exists": {
-      const targetPath = resolveTarget(condition.target, contextPath, root);
-      const exists = targetPath.some((p) => fs.existsSync(p));
-      return {
-        passed: !exists,
-        message: !exists ? `\u2705 File does not exist: ${condition.target}` : `\u274C File should not exist: ${condition.target} (${condition.description})`
-      };
-    }
-    case "contains": {
-      if (!contextPath) return { passed: true, message: "\u26A0\uFE0F No file to check" };
-      const fullPath = path.resolve(root, contextPath);
-      if (!fs.existsSync(fullPath)) return { passed: true, message: "\u26A0\uFE0F File not found" };
-      const content = fs.readFileSync(fullPath, "utf-8");
-      const hasContent = condition.value ? content.includes(condition.value) : false;
-      return {
-        passed: hasContent,
-        message: hasContent ? `\u2705 Contains expected content` : `\u274C Missing expected content: "${condition.value}" (${condition.description})`
-      };
-    }
-    case "not_contains": {
-      if (!contextPath) return { passed: true, message: "\u26A0\uFE0F No file to check" };
-      const root2 = getProjectRoot();
-      const targets = resolveTarget(condition.target, contextPath, root2);
-      for (const t of targets) {
-        if (fs.existsSync(t)) {
-          const content = fs.readFileSync(t, "utf-8");
-          if (condition.value && content.includes(condition.value)) {
-            return {
-              passed: false,
-              message: `\u274C Found forbidden pattern "${condition.value}" in ${path.relative(root2, t)} (${condition.description})`
-            };
-          }
-        }
-      }
-      return { passed: true, message: "\u2705 No forbidden patterns found" };
-    }
-    case "has_test_file": {
-      if (!contextPath) return { passed: true, message: "\u26A0\uFE0F No file to check" };
-      const basename = path.basename(contextPath, path.extname(contextPath));
-      const dir = path.dirname(contextPath);
-      const possibleTests = [
-        path.join(dir, `${basename}.test.ts`),
-        path.join(dir, `${basename}.spec.ts`),
-        path.join(dir, `__tests__/${basename}.test.ts`),
-        path.join(dir, `__tests__/${basename}.spec.ts`)
-      ];
-      const hasTest = possibleTests.some((t) => fs.existsSync(t));
-      return {
-        passed: hasTest,
-        message: hasTest ? `\u2705 Test file exists` : `\u274C No test file found for ${contextPath} (${condition.description})`
-      };
-    }
-    default:
-      return { passed: true, message: `\u26A0\uFE0F Unknown condition type: ${condition.type}` };
-  }
-}
-function appliesToContract(contract, toolName, filePath) {
-  if (contract.appliesTo.includes("*")) return true;
-  if (contract.appliesTo.includes(toolName)) return true;
-  if (filePath) {
-    return contract.appliesTo.some((pattern) => {
-      return filePath.includes(pattern.replace("*", ""));
-    });
-  }
-  return false;
-}
-function resolveTarget(pattern, contextPath, root) {
-  const r = root || getProjectRoot();
-  if (pattern.startsWith("*")) {
-    if (contextPath) {
-      const dir = path.dirname(path.resolve(r, contextPath));
-      const suffix = pattern.replace("*", "");
-      try {
-        const files = fs.readdirSync(dir);
-        return files.filter((f) => f.endsWith(suffix) || f.includes(suffix)).map((f) => path.join(dir, f));
-      } catch {
-        return [path.join(dir, pattern.replace("*", ""))];
-      }
-    }
-    return [];
-  }
-  return [path.resolve(r, pattern)];
-}
-async function runContractChecks(toolName, filePath, phase = "pre") {
-  const verdicts = phase === "pre" ? evaluatePreConditions(toolName, filePath) : evaluatePostConditions(toolName, filePath);
-  if (verdicts.length === 0) {
-    return "\u2705 **No applicable contracts** for this action.";
-  }
-  const lines = [
-    `\u{1F4DC} **Contract Check** (${phase}-conditions)`,
-    `\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`,
-    ``
-  ];
-  let totalViolations = 0;
-  let errors = 0;
-  for (const v of verdicts) {
-    if (v.passed) {
-      lines.push(`  \u2705 **${v.description}** \u2014 passed`);
-    } else {
-      totalViolations += v.violations.length;
-      const errorCount = v.violations.filter((x) => x.severity === "error").length;
-      errors += errorCount;
-      lines.push(`  ${errorCount > 0 ? "\u{1F534}" : "\u{1F7E1}"} **${v.description}** \u2014 ${v.violations.length} violation(s)`);
-      for (const violation of v.violations) {
-        lines.push(`     ${violation.severity === "error" ? "\u{1F534}" : "\u{1F7E1}"} ${violation.message.substring(0, 120)}`);
-      }
-    }
-  }
-  lines.push("");
-  if (errors > 0) {
-    lines.push(`\u{1F534} **${errors} error(s)** \u2014 blocking. Resolve before proceeding.`);
-  } else if (totalViolations > 0) {
-    lines.push(`\u{1F7E1} **${totalViolations} warning(s)** \u2014 review recommended.`);
-  } else {
-    lines.push("\u2705 All contract checks passed.");
-  }
-  return lines.join("\n");
-}
-function listContracts() {
-  const configs = loadContracts();
-  const lines = [
-    "\u{1F4DC} **Active Contracts**",
-    "\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501",
-    ""
-  ];
-  for (const config of configs) {
-    for (const contract of config.contracts) {
-      const appliesTo = contract.appliesTo.join(", ");
-      lines.push(`  \u{1F4CC} **${contract.id}**`);
-      lines.push(`     ${contract.description}`);
-      lines.push(`     Applies to: ${appliesTo}`);
-      lines.push(`     Pre-conditions: ${contract.preConditions.length}`);
-      lines.push(`     Post-conditions: ${contract.postConditions.length}`);
-      lines.push("");
-    }
-  }
-  return lines.join("\n");
-}
-export {
-  evaluatePostConditions,
-  evaluatePreConditions,
-  listContracts,
-  loadContracts,
-  runContractChecks
-};

package/dist/kumaDb-4XZ5S2LH.js

@@ -1,65 +0,0 @@
-import {
-  addContextNote,
-  addSecurityFinding,
-  addTodo,
-  checkPortability,
-  ensureGitignore,
-  getBenchmarkDiff,
-  getChanges,
-  getDb,
-  getFileSummary,
-  getLatestVerifications,
-  getResearchCache,
-  getSecurityFindings,
-  listContextNotes,
-  listDecisionLog,
-  listResearchCache,
-  listTodos,
-  recordChange,
-  recordDecisionLog,
-  resetDbInstance,
-  rollbackChange,
-  runDoctor,
-  runGarbageCollection,
-  saveBenchmark,
-  saveDb,
-  saveFileSummary,
-  saveHealthSnapshot,
-  saveResearchCache,
-  saveVerification,
-  updateDecisionStatus,
-  updateTodoStatus
-} from "./chunk-3BRBJZ7P.js";
-import "./chunk-E2KFPEBT.js";
-export {
-  addContextNote,
-  addSecurityFinding,
-  addTodo,
-  checkPortability,
-  ensureGitignore,
-  getBenchmarkDiff,
-  getChanges,
-  getDb,
-  getFileSummary,
-  getLatestVerifications,
-  getResearchCache,
-  getSecurityFindings,
-  listContextNotes,
-  listDecisionLog,
-  listResearchCache,
-  listTodos,
-  recordChange,
-  recordDecisionLog,
-  resetDbInstance,
-  rollbackChange,
-  runDoctor,
-  runGarbageCollection,
-  saveBenchmark,
-  saveDb,
-  saveFileSummary,
-  saveHealthSnapshot,
-  saveResearchCache,
-  saveVerification,
-  updateDecisionStatus,
-  updateTodoStatus
-};

package/dist/kumaDriftDetector-TOORILSZ.js

@@ -1,237 +0,0 @@
-import {
-  getDb,
-  saveDb
-} from "./chunk-3BRBJZ7P.js";
-import {
-  getProjectRoot
-} from "./chunk-E2KFPEBT.js";
-
-// src/engine/kumaDriftDetector.ts
-import fs from "fs";
-import path from "path";
-import crypto from "crypto";
-function hashFile(filePath) {
-  try {
-    const root = getProjectRoot();
-    const fullPath = path.resolve(root, filePath);
-    if (!fs.existsSync(fullPath)) return null;
-    const content = fs.readFileSync(fullPath, "utf-8");
-    return crypto.createHash("sha256").update(content).digest("hex");
-  } catch {
-    return null;
-  }
-}
-async function detectDrift() {
-  const records = [];
-  const now = Math.floor(Date.now() / 1e3);
-  try {
-    const db = await getDb();
-    const rcStmt = db.prepare(
-      "SELECT id, scope, content_hash, updated_at FROM research_cache WHERE content_hash IS NOT NULL AND length(content_hash) > 0 LIMIT 100"
-    );
-    while (rcStmt.step()) {
-      const row = rcStmt.getAsObject();
-      const scope = row.scope;
-      const storedHash = row.content_hash;
-      const updatedAt = row.updated_at;
-      const age = Math.floor((now - updatedAt) / 86400);
-      const currentHash = computeScopeHash(scope);
-      const stale = currentHash && currentHash !== storedHash;
-      records.push({
-        id: row.id,
-        source: "research_cache",
-        description: scope,
-        filePath: null,
-        oldHash: storedHash,
-        currentHash: currentHash || "",
-        age: `${age}d`,
-        severity: !currentHash ? "fresh" : stale ? "stale" : age > 30 ? "warning" : "fresh"
-      });
-    }
-    rcStmt.free();
-    const fsStmt = db.prepare(
-      "SELECT id, file_path, content_hash FROM file_summaries WHERE content_hash IS NOT NULL AND length(content_hash) > 0 LIMIT 100"
-    );
-    while (fsStmt.step()) {
-      const row = fsStmt.getAsObject();
-      const filePath = row.file_path;
-      const storedHash = row.content_hash;
-      const currentHash = hashFile(filePath);
-      if (currentHash === null) {
-        records.push({
-          id: row.id,
-          source: "file_summaries",
-          description: filePath,
-          filePath,
-          oldHash: storedHash,
-          currentHash: "",
-          age: "\u2014",
-          severity: "missing"
-        });
-      } else if (currentHash !== storedHash) {
-        records.push({
-          id: row.id,
-          source: "file_summaries",
-          description: filePath,
-          filePath,
-          oldHash: storedHash,
-          currentHash,
-          age: "\u2014",
-          severity: "stale"
-        });
-      }
-    }
-    fsStmt.free();
-    const dlStmt = db.prepare(
-      "SELECT id, title, file_paths, created_at FROM decision_log WHERE file_paths IS NOT NULL ORDER BY created_at DESC LIMIT 50"
-    );
-    while (dlStmt.step()) {
-      const row = dlStmt.getAsObject();
-      const filePaths = [];
-      try {
-        filePaths.push(...JSON.parse(row.file_paths));
-      } catch {
-      }
-      let hasStaleFile = false;
-      for (const fp of filePaths) {
-        if (!fp) continue;
-        const fullPath = path.resolve(getProjectRoot(), fp);
-        if (!fs.existsSync(fullPath)) {
-          hasStaleFile = true;
-          break;
-        }
-      }
-      if (hasStaleFile) {
-        records.push({
-          id: row.id,
-          source: "decision_log",
-          description: row.title,
-          filePath: filePaths[0] || null,
-          oldHash: "",
-          currentHash: "",
-          age: "\u2014",
-          severity: "stale"
-        });
-      }
-    }
-    dlStmt.free();
-  } catch (err) {
-    console.error(`[DriftDetector] Error: ${err}`);
-  }
-  return records;
-}
-function computeScopeHash(scope) {
-  try {
-    const hash = crypto.createHash("sha256");
-    const root = getProjectRoot();
-    hash.update(scope);
-    let found = false;
-    try {
-      const files = fs.readdirSync(root);
-      for (const file of files) {
-        if (file.toLowerCase().includes(scope.toLowerCase())) {
-          try {
-            if (fs.statSync(path.join(root, file)).isFile()) {
-              const content = fs.readFileSync(path.join(root, file), "utf-8");
-              hash.update(file);
-              hash.update(content.substring(0, 1e4));
-              found = true;
-            }
-          } catch {
-          }
-        }
-      }
-    } catch {
-    }
-    const researchDir = path.join(root, ".kuma", "research");
-    if (fs.existsSync(researchDir)) {
-      const scopeFile = path.join(researchDir, `${scope}.json`);
-      if (fs.existsSync(scopeFile)) {
-        const content = fs.readFileSync(scopeFile, "utf-8");
-        hash.update(content);
-        found = true;
-      }
-    }
-    if (!found) return null;
-    return hash.digest("hex").substring(0, 16);
-  } catch {
-    return null;
-  }
-}
-async function flagStaleRecords() {
-  const staleRecords = await detectDrift();
-  let flagged = 0;
-  try {
-    const db = await getDb();
-    for (const record of staleRecords) {
-      if (record.severity !== "stale" && record.severity !== "missing") continue;
-      if (record.source === "research_cache") {
-        db.run(
-          `UPDATE research_cache SET confidence = MAX(confidence * 0.5, 0.1) WHERE id = ?`,
-          [record.id]
-        );
-        flagged++;
-      } else if (record.source === "file_summaries") {
-        db.run(
-          `UPDATE file_summaries SET content_hash = '' WHERE id = ?`,
-          [record.id]
-        );
-        flagged++;
-      } else if (record.source === "decision_log") {
-        db.run(
-          `UPDATE decision_log SET status = 'deprecated' WHERE id = ?`,
-          [record.id]
-        );
-        flagged++;
-      }
-    }
-    saveDb();
-  } catch (err) {
-    console.error(`[DriftDetector] Flag error: ${err}`);
-  }
-  return { flagged, total: staleRecords.length };
-}
-function formatDriftReport(records) {
-  if (records.length === 0) {
-    return "\u2705 **Drift Detection** \u2014 All memory records are fresh. No code drift detected.";
-  }
-  const fresh = records.filter((r) => r.severity === "fresh").length;
-  const warning = records.filter((r) => r.severity === "warning").length;
-  const stale = records.filter((r) => r.severity === "stale").length;
-  const missing = records.filter((r) => r.severity === "missing").length;
-  const lines = [
-    "\u{1F50D} **Code Drift Detection Report**",
-    "\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{1F4CA} ${records.length} total records checked: ${fresh} fresh, ${warning} aging, ${stale} stale, ${missing} missing`,
-    ""
-  ];
-  if (stale > 0 || missing > 0) {
-    lines.push("**Stale/Missing Records:**");
-    for (const r of records) {
-      if (r.severity === "stale" || r.severity === "missing") {
-        const icon = r.severity === "missing" ? "\u274C" : "\u26A0\uFE0F";
-        lines.push(`  ${icon} [${r.source}] ${r.description}`);
-        if (r.filePath) lines.push(`     \u{1F4CD} ${r.filePath}`);
-      }
-    }
-    lines.push("");
-    lines.push("\u{1F4A1} Run kuma_memory({ action: 'heal' }) to repair stale graph entries.");
-    lines.push("\u{1F4A1} Run kuma_context({ action: 'research', scope: '<stale-scope>' }) to refresh.");
-  }
-  return lines.join("\n");
-}
-async function getDriftSummary() {
-  const records = await detectDrift();
-  if (records.length === 0) return "\u2705 No code drift detected";
-  const staleCount = records.filter((r) => r.severity === "stale" || r.severity === "missing").length;
-  if (staleCount === 0) return "\u2705 All records fresh";
-  return `\u26A0\uFE0F ${staleCount} stale record(s) detected. Use kuma_memory({ action: 'heal' }) to repair.`;
-}
-export {
-  detectDrift,
-  flagStaleRecords,
-  formatDriftReport,
-  getDriftSummary,
-  hashFile
-};