@plumpslabs/kuma 2.4.1 → 2.4.3

package/dist/index.js

@@ -234,11 +234,9 @@ __export(kumaDb_exports, {
   getResearchCache: () => getResearchCache,
   getSecurityFindings: () => getSecurityFindings,
   listContextNotes: () => listContextNotes,
-  listDecisionLog: () => listDecisionLog,
   listResearchCache: () => listResearchCache,
   rebuildFtsIndex: () => rebuildFtsIndex,
   recordChange: () => recordChange,
-  recordDecisionLog: () => recordDecisionLog,
   resetDbInstance: () => resetDbInstance,
   rollbackChange: () => rollbackChange,
   runDoctor: () => runDoctor,
@@ -247,8 +245,7 @@ __export(kumaDb_exports, {
   saveDb: () => saveDb,
   saveFileSummary: () => saveFileSummary,
   saveResearchCache: () => saveResearchCache,
-  saveVerification: () => saveVerification,
-  updateDecisionStatus: () => updateDecisionStatus
+  saveVerification: () => saveVerification
 });
 import initSqlJs from "sql.js";
 import fs2 from "fs";
@@ -516,17 +513,10 @@ function createSchema(db) {
     comparison_with TEXT,
     created_at INTEGER NOT NULL DEFAULT (strftime('%s','now'))
   )`);
-  db.run(`CREATE TABLE IF NOT EXISTS decision_log (
-    id INTEGER PRIMARY KEY AUTOINCREMENT,
-    title TEXT NOT NULL,
-    context TEXT,
-    rationale TEXT,
-    outcome TEXT,
-    status TEXT NOT NULL DEFAULT 'active' CHECK(status IN ('active','superseded','deprecated','proposed')),
-    superseded_by INTEGER,
-    file_paths TEXT DEFAULT '[]',
-    created_at INTEGER NOT NULL DEFAULT (strftime('%s','now'))
-  )`);
+  try {
+    db.exec(`DROP TABLE IF EXISTS decision_log`);
+  } catch {
+  }
   db.run(`CREATE TABLE IF NOT EXISTS file_summaries (
     id INTEGER PRIMARY KEY AUTOINCREMENT,
     file_path TEXT NOT NULL UNIQUE,
@@ -555,12 +545,6 @@ function createSchema(db) {
     escalated INTEGER DEFAULT 0,
     created_at INTEGER NOT NULL DEFAULT (strftime('%s','now'))
   )`);
-  db.run(`CREATE TABLE IF NOT EXISTS scratch_entries (
-    id INTEGER PRIMARY KEY AUTOINCREMENT,
-    file_path TEXT NOT NULL,
-    reason TEXT,
-    created_at INTEGER NOT NULL DEFAULT (strftime('%s','now'))
-  )`);
   db.run(`CREATE TABLE IF NOT EXISTS verifications (
     id INTEGER PRIMARY KEY AUTOINCREMENT,
     scope TEXT NOT NULL,
@@ -696,7 +680,6 @@ function createSchema(db) {
   db.run(`CREATE INDEX IF NOT EXISTS idx_api_path ON api_endpoints(path)`);
   db.run(`CREATE INDEX IF NOT EXISTS idx_context_notes_scope ON context_notes(scope)`);
   db.run(`CREATE INDEX IF NOT EXISTS idx_benchmarks_label ON benchmarks(label)`);
-  db.run(`CREATE INDEX IF NOT EXISTS idx_decision_status ON decision_log(status)`);
   db.run(`CREATE INDEX IF NOT EXISTS idx_file_summaries_path ON file_summaries(file_path)`);
   db.run(`CREATE INDEX IF NOT EXISTS idx_audit_timestamp ON safety_audit(timestamp)`);
   db.run(`CREATE INDEX IF NOT EXISTS idx_audit_tool ON safety_audit(tool_name)`);
@@ -989,57 +972,6 @@ async function getBenchmarkDiff(labelA, labelB) {
     return `Error: ${err}`;
   }
 }
-async function recordDecisionLog(entry) {
-  try {
-    const db = await getDb();
-    db.run(
-      `INSERT INTO decision_log (title, context, rationale, outcome, status) VALUES (?, ?, ?, ?, ?)`,
-      [entry.title, entry.context || "", entry.rationale || "", entry.outcome || "", entry.status || "active"]
-    );
-    saveDb();
-    return `\u2705 Decision "${entry.title}" logged as ${entry.status || "active"}.`;
-  } catch (err) {
-    return `\u274C Failed: ${err}`;
-  }
-}
-async function listDecisionLog(status) {
-  try {
-    const db = await getDb();
-    let sql = `SELECT * FROM decision_log WHERE 1=1`;
-    const bind = [];
-    if (status) {
-      sql += ` AND status = ?`;
-      bind.push(status);
-    }
-    sql += ` ORDER BY created_at DESC LIMIT 50`;
-    const stmt = db.prepare(sql);
-    stmt.bind(bind);
-    const results = [];
-    while (stmt.step()) results.push(stmt.getAsObject());
-    stmt.free();
-    if (results.length === 0) return "\u{1F4CB} No decisions logged.";
-    const lines = [`\u{1F4CB} Decision Log \u2014 ${results.length}
-`];
-    for (const d of results) {
-      const icon = d.status === "active" ? "\u2705" : d.status === "superseded" ? "\u{1F504}" : d.status === "deprecated" ? "\u274C" : "\u{1F4DD}";
-      lines.push(`  ${icon} ${d.title} (${d.status})`);
-      if (d.context) lines.push(`     Context: ${d.context.substring(0, 150)}`);
-    }
-    return lines.join("\n");
-  } catch (err) {
-    return `Error: ${err}`;
-  }
-}
-async function updateDecisionStatus(id, status) {
-  try {
-    const db = await getDb();
-    db.run(`UPDATE decision_log SET status = ? WHERE id = ?`, [status, id]);
-    saveDb();
-    return `\u2705 Decision #${id} updated to "${status}"`;
-  } catch (err) {
-    return `\u274C Failed: ${err}`;
-  }
-}
 async function getFileSummary(filePath) {
   try {
     const db = await getDb();
@@ -1081,7 +1013,7 @@ async function runGarbageCollection() {
     };
     const orphanResult = db.exec(`DELETE FROM nodes WHERE id NOT IN (SELECT source_id FROM edges UNION SELECT target_id FROM edges) AND file_path IS NULL AND updated_at < strftime('%s','now','-30 days')`);
     removed += orphanResult[0]?.values?.length || 0;
-    const staleEdges = db.exec(`DELETE FROM edges WHERE weight < 0.1 AND updated_at < strftime('%s','now','-30 days')`);
+    const staleEdges = db.exec(`DELETE FROM edges WHERE weight < 0.1 AND created_at < strftime('%s','now','-30 days')`);
     removed += staleEdges[0]?.values?.length || 0;
     db.exec(`DELETE FROM tool_calls WHERE created_at < strftime('%s','now','-90 days')`);
     db.exec(`DELETE FROM experiences WHERE created_at < strftime('%s','now','-90 days')`);
@@ -1095,7 +1027,7 @@ async function runGarbageCollection() {
     }
     const auditCount = getCount("SELECT COUNT(*) FROM safety_audit");
     if (auditCount > 200) {
-      db.exec(`DELETE FROM safety_audit WHERE id IN (SELECT id FROM safety_audit ORDER BY created_at ASC LIMIT ${auditCount - 200})`);
+      db.exec(`DELETE FROM safety_audit WHERE id IN (SELECT id FROM safety_audit ORDER BY timestamp ASC LIMIT ${auditCount - 200})`);
     }
     db.exec(`DELETE FROM research_cache WHERE updated_at < strftime('%s','now','-60 days')`);
     const secCount = getCount("SELECT COUNT(*) FROM security_findings");
@@ -1110,12 +1042,7 @@ async function runGarbageCollection() {
     if (benchCount > 100) {
       db.exec(`DELETE FROM benchmarks WHERE id IN (SELECT id FROM benchmarks ORDER BY created_at ASC LIMIT ${benchCount - 100})`);
     }
-    const decCount = getCount("SELECT COUNT(*) FROM decision_log");
-    if (decCount > 200) {
-      db.exec(`DELETE FROM decision_log WHERE id IN (SELECT id FROM decision_log ORDER BY created_at ASC LIMIT ${decCount - 200})`);
-    }
     db.exec(`DELETE FROM known_gotchas WHERE file_path NOT IN (SELECT DISTINCT file_path FROM nodes WHERE file_path IS NOT NULL) AND file_path NOT LIKE '%::%'`);
-    db.exec(`DELETE FROM scratch_entries WHERE created_at < strftime('%s','now','-7 days')`);
     const costCount = getCount("SELECT COUNT(*) FROM cost_tracking");
     if (costCount > 500) {
       db.exec(`DELETE FROM cost_tracking WHERE id IN (SELECT id FROM cost_tracking ORDER BY created_at ASC LIMIT ${costCount - 500})`);
@@ -1149,7 +1076,7 @@ async function runDoctor() {
     } catch {
       checks.push("**Database Integrity**: \u274C check failed");
     }
-    const allTables = ["nodes", "edges", "sessions", "research_cache", "change_log", "safety_audit", "todos", "security_findings", "context_notes", "benchmarks", "decision_log", "file_summaries", "verifications", "tool_calls", "experiences", "experience_patterns", "patterns", "api_endpoints", "otel_config", "cost_tracking", "scratch_entries", "portability_entries", "blackboard_events", "known_gotchas", "trajectories", "distilled_skills"];
+    const allTables = ["nodes", "edges", "sessions", "research_cache", "change_log", "safety_audit", "todos", "security_findings", "context_notes", "benchmarks", "file_summaries", "verifications", "tool_calls", "experiences", "experience_patterns", "patterns", "api_endpoints", "otel_config", "cost_tracking", "portability_entries", "blackboard_events", "known_gotchas", "trajectories", "distilled_skills"];
     let existing = 0;
     for (const t of allTables) {
       try {
@@ -1173,8 +1100,8 @@ async function runDoctor() {
     } catch {
     }
     try {
-      const { execSync: execSync7 } = await import("child_process");
-      const psOutput = execSync7(
+      const { execSync: execSync6 } = await import("child_process");
+      const psOutput = execSync6(
         `ps -eo pid,ppid,command | grep -E "(jest|pnpm test|npm test|yarn test)" | grep -v grep | head -10`,
         { encoding: "utf-8", timeout: 5e3 }
       ).trim();
@@ -1185,7 +1112,7 @@ async function runDoctor() {
         for (const p of processes) {
           checks.push(`  \u26A1 ${p.substring(0, 120)}`);
         }
-        checks.push("  \u{1F4A1} Run `kuma_safety({ action: 'gc' })` to clean up stale processes");
+        checks.push("  \u{1F4A1} Stale test processes may slow down test runs.");
       } else {
         checks.push("");
         checks.push("**Running Test Processes**: \u2705 None detected");
@@ -2106,12 +2033,6 @@ No unresolved issues.`;
 });
 
 // src/engine/kumaSelfHeal.ts
-var kumaSelfHeal_exports = {};
-__export(kumaSelfHeal_exports, {
-  formatGotchaStalenessReport: () => formatGotchaStalenessReport,
-  healOnQuery: () => healOnQuery,
-  verifyGotchaStaleness: () => verifyGotchaStaleness
-});
 import { execSync as execSync2 } from "child_process";
 import fs4 from "fs";
 import path4 from "path";
@@ -2172,73 +2093,6 @@ async function healOnQuery(filePaths) {
     return { healed: 0 };
   }
 }
-async function verifyGotchaStaleness() {
-  const db = await getDb();
-  const stale = [];
-  try {
-    const rows = db.exec(`
-      SELECT id, metadata FROM nodes WHERE type = 'gotcha'
-    `);
-    if (rows.length === 0) return stale;
-    const columns = rows[0].columns;
-    const filePathIdx = columns.indexOf("metadata");
-    for (const row of rows[0].values) {
-      const nodeId2 = row[0];
-      let metadata = {};
-      try {
-        metadata = JSON.parse(row[filePathIdx]);
-      } catch {
-      }
-      const filePath = metadata.file_path;
-      if (!filePath || filePath.startsWith("search::") || filePath.startsWith("api_route::")) continue;
-      const fullPath = path4.join(getProjectRoot(), filePath);
-      if (!fs4.existsSync(fullPath)) {
-        stale.push({ gotchaId: nodeId2, file_path: filePath, issue: "file_missing" });
-      } else {
-        const desc = metadata.description || "";
-        const symbolMatch = desc.match(/\b(function|class|method|const|let|var|export)\s+(\w+)/i);
-        if (symbolMatch) {
-          const symbolName = symbolMatch[2];
-          try {
-            const content = fs4.readFileSync(fullPath, "utf-8");
-            if (!content.includes(symbolName)) {
-              stale.push({ gotchaId: nodeId2, file_path: filePath, issue: "symbol_missing" });
-            }
-          } catch {
-          }
-        }
-      }
-    }
-  } catch {
-  }
-  return stale;
-}
-function formatGotchaStalenessReport(stale) {
-  if (stale.length === 0) {
-    return "\u2705 **Gotcha Staleness Check** \u2014 All gotcha references are valid.";
-  }
-  const fileMissing = stale.filter((s) => s.issue === "file_missing");
-  const symbolMissing = stale.filter((s) => s.issue === "symbol_missing");
-  const lines = [
-    `\u26A0\uFE0F **Gotcha Staleness 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`,
-    "",
-    `\u{1F4CA} ${stale.length} stale gotcha${stale.length > 1 ? "s" : ""} found`,
-    fileMissing.length > 0 ? `  \u{1F5D1}\uFE0F ${fileMissing.length} reference${fileMissing.length > 1 ? "s" : ""} deleted file` : "",
-    symbolMissing.length > 0 ? `  \u{1F50D} ${symbolMissing.length} reference${symbolMissing.length > 1 ? "s" : ""} missing symbol` : "",
-    ""
-  ];
-  for (const s of fileMissing.slice(0, 5)) {
-    lines.push(`  \u{1F5D1}\uFE0F \`${s.gotchaId}\` \u2192 file missing: \`${s.file_path}\``);
-  }
-  for (const s of symbolMissing.slice(0, 5)) {
-    lines.push(`  \u{1F50D} \`${s.gotchaId}\` \u2192 symbol missing in \`${s.file_path}\``);
-  }
-  if (stale.length > 5) lines.push(`  ... and ${stale.length - 5} more`);
-  lines.push("");
-  lines.push("\u{1F4A1} Use `kuma_memory({ action: 'delete_node', target: '<gotchaId>' })` to remove obsolete gotchas.");
-  return lines.join("\n");
-}
 var init_kumaSelfHeal = __esm({
   "src/engine/kumaSelfHeal.ts"() {
     "use strict";
@@ -2517,39 +2371,6 @@ async function detectDrift() {
       }
     }
     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 = path6.resolve(getProjectRoot(), fp);
-        if (!fs5.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}`);
   }
@@ -2612,12 +2433,6 @@ async function flagStaleRecords() {
           [record.id]
         );
         flagged++;
-      } else if (record.source === "decision_log") {
-        db.run(
-          `UPDATE decision_log SET status = 'deprecated' WHERE id = ?`,
-          [record.id]
-        );
-        flagged++;
       }
     }
     saveDb();
@@ -3327,7 +3142,7 @@ Try kuma_context({ action: 'research', scope: '<term>' }) to build related graph
       const parts = query.split("\u2192").map((s) => s.trim());
       if (parts.length !== 2) {
         return `\u26A0\uFE0F For path queries, use format: "sourceNodeID \u2192 targetNodeID"
-Example: kuma_context({ action: 'impact', target: 'login' }) \u2192 traces connections between nodes.`;
+Example: kuma_context({ action: 'research', scope: 'login' }) \u2192 traces connections between nodes.`;
       }
       const [sourceId, targetId] = parts;
       const visited = /* @__PURE__ */ new Set();
@@ -3567,27 +3382,27 @@ async function codebaseSearchFallback(query, limit = 20) {
         if (results.length >= limit || depth > MAX_WALK_DEPTH) return;
         let entries = [];
         try {
-          entries = fs28.readdirSync(dir);
+          entries = fs24.readdirSync(dir);
         } catch {
           return;
         }
         for (const entry of entries) {
           if (entry.startsWith(".") || entry === "node_modules" || entry === "dist" || entry === "build") continue;
-          const full = path29.join(dir, entry);
+          const full = path25.join(dir, entry);
           try {
-            const stat = fs28.statSync(full);
+            const stat = fs24.statSync(full);
             if (stat.isDirectory()) {
               walk2(full, depth + 1);
             } else if (entry.toLowerCase().includes(query.toLowerCase())) {
-              results.push(path29.relative(root, full));
+              results.push(path25.relative(root, full));
             }
           } catch {
           }
         }
       };
       var walk = walk2;
-      const fs28 = await import("fs");
-      const path29 = await import("path");
+      const fs24 = await import("fs");
+      const path25 = await import("path");
       const root = process.cwd();
       const results = [];
       const MAX_WALK_DEPTH = 8;
@@ -3727,9 +3542,9 @@ async function analyzeImpact(target) {
 }
 async function codebaseImpactFallback(target) {
   try {
-    const { execSync: execSync7 } = await import("child_process");
+    const { execSync: execSync6 } = await import("child_process");
     const root = process.cwd();
-    const grepResult = execSync7(
+    const grepResult = execSync6(
       `grep -rn ${grepIncludeFlags()} --include="*.json" --include="*.md" -l "${target.replace(/"/g, '\\"')}" . 2>/dev/null | grep -v node_modules | grep -v .git | grep -v dist | grep -v .kuma | head -50`,
       { cwd: root, encoding: "utf-8", timeout: 5e3, maxBuffer: 256 * 1024 }
     ).trim();
@@ -4142,9 +3957,7 @@ var domainRules_exports = {};
 __export(domainRules_exports, {
   appendToLayer: () => appendToLayer,
   checkFileGotchas: () => checkFileGotchas,
-  generateDigest: () => generateDigest,
   getActiveGotchas: () => getActiveGotchas,
-  getLayersSummary: () => getLayersSummary,
   readLayer: () => readLayer,
   writeLayer: () => writeLayer
 });
@@ -4156,7 +3969,7 @@ function layerFilePath(layer) {
 function ensureLayerFile(layer) {
   const fp = layerFilePath(layer);
   if (!fs7.existsSync(fp)) {
-    const template = layer === "domain_rules" ? DOMAIN_RULES_TEMPLATE : layer === "arch_flow" ? ARCH_FLOW_TEMPLATE : GOTCHAS_TEMPLATE;
+    const template = layer === "arch_flow" ? ARCH_FLOW_TEMPLATE : GOTCHAS_TEMPLATE;
     const dir = path8.dirname(fp);
     if (!fs7.existsSync(dir)) fs7.mkdirSync(dir, { recursive: true });
     fs7.writeFileSync(fp, template, "utf-8");
@@ -4194,27 +4007,6 @@ function appendToLayer(layer, entry) {
     return `\u274C Failed to append: ${err}`;
   }
 }
-function getLayersSummary() {
-  const lines = ["\u{1F4DA} **3-Layer Memory Engine**", "\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"];
-  for (const layer of ["domain_rules", "arch_flow", "gotcha"]) {
-    const fp = layerFilePath(layer);
-    const exists = fs7.existsSync(fp);
-    const label = LAYER_FILES[layer].label;
-    if (exists) {
-      try {
-        const content = fs7.readFileSync(fp, "utf-8");
-        const lineCount = content.split("\n").length;
-        const sizeKB = Math.round(Buffer.byteLength(content) / 1024);
-        lines.push(`  ${layer === "domain_rules" ? "\u{1F4CB}" : layer === "arch_flow" ? "\u{1F3D7}\uFE0F" : "\u26A0\uFE0F"} **${label}** \u2014 ${lineCount} lines, ${sizeKB}KB`);
-      } catch {
-        lines.push(`  \u2753 **${label}** \u2014 could not read`);
-      }
-    } else {
-      lines.push(`  \u{1F4C4} **${label}** \u2014 not yet created`);
-    }
-  }
-  return lines.join("\n");
-}
 function getActiveGotchas() {
   const results = [];
   try {
@@ -4259,106 +4051,19 @@ function checkFileGotchas(filePath) {
   }
   return warnings;
 }
-function generateDigest() {
-  const lines = [
-    "\u{1F4CB} **Kuma Project Digest**",
-    "\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",
-    ""
-  ];
-  try {
-    const fp1 = ensureLayerFile("domain_rules");
-    const content = fs7.readFileSync(fp1, "utf-8");
-    const rules = [];
-    const workflows = [];
-    for (const line of content.split("\n")) {
-      const r = line.match(/^- Rule \d+:?\s*(.+)/);
-      if (r) rules.push(r[1].substring(0, 60));
-      const w = line.match(/^\d+\.\s*(.+)/);
-      if (w) workflows.push(w[1].substring(0, 60));
-    }
-    if (rules.length > 0) lines.push(`\u{1F4CB} **Domain Rules** (${rules.length}): ${rules.slice(0, 3).join("; ")}`);
-    if (workflows.length > 0) lines.push(`\u{1F504} **Workflows**: ${workflows.slice(0, 3).join(" \u2192 ")}`);
-  } catch {
-    lines.push("\u{1F4CB} **Domain Rules**: not set");
-  }
-  try {
-    const fp2 = ensureLayerFile("arch_flow");
-    const content = fs7.readFileSync(fp2, "utf-8");
-    const chains = [];
-    for (const line of content.split("\n")) {
-      if (line.includes("->") && line.includes("[")) chains.push(line.trim());
-    }
-    if (chains.length > 0) lines.push(`\u{1F3D7}\uFE0F **Architecture**: ${chains[0].substring(0, 80)}`);
-    else lines.push("\u{1F3D7}\uFE0F **Architecture**: see .kuma/ARCHITECTURE_FLOW.md");
-  } catch {
-    lines.push("\u{1F3D7}\uFE0F **Architecture**: not documented");
-  }
-  const gotchas = getActiveGotchas();
-  if (gotchas.length > 0) {
-    const highCount = gotchas.filter((g) => g.severity === "high" || g.severity === "critical").length;
-    lines.push(`\u26A0\uFE0F **Gotchas**: ${gotchas.length} active (${highCount} high/critical)`);
-    for (const g of gotchas.slice(0, 3)) {
-      lines.push(`  \u2022 ${g.filePath}: ${g.description.substring(0, 60)}`);
-    }
-  } else {
-    lines.push("\u26A0\uFE0F **Gotchas**: none recorded");
-  }
-  const summary = sessionMemory.getSummary();
-  lines.push(`\u{1F3AF} **Goal**: ${summary.currentGoal?.substring(0, 60) || "not set"}`);
-  lines.push(`\u{1F4DD} **Modified**: ${summary.modifiedFiles?.length || 0} files | \u{1F6E0}\uFE0F ${summary.toolCallCount} calls`);
-  return lines.join("\n");
-}
-var LAYER_FILES, DOMAIN_RULES_TEMPLATE, ARCH_FLOW_TEMPLATE, GOTCHAS_TEMPLATE;
+var LAYER_FILES, ARCH_FLOW_TEMPLATE, GOTCHAS_TEMPLATE;
 var init_domainRules = __esm({
   "src/engine/domainRules.ts"() {
     "use strict";
     init_pathValidator();
     init_sessionMemory();
     LAYER_FILES = {
-      domain_rules: { filename: "DOMAIN_RULES.md", label: "Domain & Business Rules" },
       arch_flow: { filename: "ARCHITECTURE_FLOW.md", label: "Architecture & Sequence Flow" },
       gotcha: { filename: "KNOWN_GOTCHAS.md", label: "Known Code Gotchas" }
     };
-    DOMAIN_RULES_TEMPLATE = `# Domain & Business Rules (Layer 1)
-
-Auto-generated by Kuma 3-Layer Memory Engine.
-Update this file with core business logic, workflows, and boundary rules.
-
-## Who
-<!-- Who are the users/actors? -->
-
-## What
-<!-- What are the core features and business capabilities? -->
-
-## When
-<!-- What are the time-based rules, schedules, deadlines? -->
-
-## Where
-<!-- Where does the business operate (environments, regions)? -->
-
-## Why
-<!-- Why were key architectural decisions made? -->
-
-## How
-<!-- How do core workflows execute? -->
-
-## Business Rules
-<!-- Critical business logic constraints -->
-- Rule 1:
-- Rule 2:
+    ARCH_FLOW_TEMPLATE = `# Architecture & Sequence Flow Map
 
-## Workflows
-<!-- Ordered sequence of operations -->
-1.
-2.
-
-## Boundary Conditions
-<!-- Edge cases, error states, validation rules -->
--
-`;
-    ARCH_FLOW_TEMPLATE = `# Architecture & Sequence Flow Map (Layer 2)
-
-Auto-generated by Kuma 3-Layer Memory Engine.
+Auto-generated by Kuma Memory Engine.
 Document execution call chains and architectural dependencies.
 
 ## System Overview
@@ -4391,9 +4096,9 @@ Request Flow:
 <!-- External services, APIs, databases -->
 - 
 `;
-    GOTCHAS_TEMPLATE = `# Known Code Gotchas (Layer 3)
+    GOTCHAS_TEMPLATE = `# Known Code Gotchas
 
-Auto-generated by Kuma 3-Layer Memory Engine.
+Auto-generated by Kuma Memory Engine.
 Catalog of fragile legacy contracts, edge cases, and unexpected framework quirks.
 
 ## How to Add a Gotcha
@@ -5816,7 +5521,7 @@ function formatScanResult(result) {
   lines.push(
     "",
     "\u{1F4A1} The knowledge graph now has richer code structure data.",
-    "\u{1F4A1} Use kuma_context({ action: 'digest' }) to see the graph overview."
+    "\u{1F4A1} Use kuma_context({ action: 'research', scope: '<area>' }) to see the graph overview."
   );
   return lines.join("\n");
 }
@@ -5997,181 +5702,6 @@ var init_kumaFlowCache = __esm({
   }
 });
 
-// src/engine/contextDigest.ts
-var contextDigest_exports = {};
-__export(contextDigest_exports, {
-  generateContextDigest: () => generateContextDigest,
-  generateDigest: () => generateContextDigest
-});
-import fs14 from "fs";
-import path15 from "path";
-function detectTechStack() {
-  const root = getProjectRoot();
-  const stack = {
-    languages: [],
-    framework: null,
-    database: null,
-    testRunner: null,
-    packageManager: null,
-    monorepo: false
-  };
-  try {
-    const pkgPath = path15.join(root, "package.json");
-    if (fs14.existsSync(pkgPath)) {
-      const pkg = JSON.parse(fs14.readFileSync(pkgPath, "utf-8"));
-      const deps = { ...pkg.dependencies, ...pkg.devDependencies };
-      if (fs14.existsSync(path15.join(root, "pnpm-lock.yaml"))) stack.packageManager = "pnpm";
-      else if (fs14.existsSync(path15.join(root, "yarn.lock"))) stack.packageManager = "yarn";
-      else stack.packageManager = "npm";
-      stack.monorepo = !!pkg.workspaces;
-      if (deps.next) stack.framework = "Next.js";
-      else if (deps.react) stack.framework = "React";
-      else if (deps.vue) stack.framework = "Vue";
-      else if (deps.express) stack.framework = "Express";
-      else if (deps.fastify) stack.framework = "Fastify";
-      else if (deps.nest) stack.framework = "NestJS";
-      else if (deps["@remix-run/react"]) stack.framework = "Remix";
-      else if (deps.svelte) stack.framework = "Svelte";
-      else if (deps.angular) stack.framework = "Angular";
-      if (deps.prisma) stack.database = "Prisma";
-      else if (deps.typeorm) stack.database = "TypeORM";
-      else if (deps.mongoose) stack.database = "MongoDB";
-      else if (deps.pg || deps["@neondatabase/serverless"]) stack.database = "PostgreSQL";
-      else if (deps.redis) stack.database = "Redis";
-      else if (deps.better || deps.drizzle) stack.database = "Drizzle";
-      if (deps.jest || deps["@jest/core"]) stack.testRunner = "Jest";
-      else if (deps.vitest) stack.testRunner = "Vitest";
-      else if (deps.mocha) stack.testRunner = "Mocha";
-      else if (deps.playwright) stack.testRunner = "Playwright";
-      else if (deps.cypress) stack.testRunner = "Cypress";
-      if (fs14.existsSync(path15.join(root, "tsconfig.json"))) stack.languages.push("TypeScript");
-      if (deps.typescript) stack.languages.push("TypeScript");
-      if (fs14.existsSync(path15.join(root, "jsconfig.json"))) stack.languages.push("JavaScript");
-      if (fs14.existsSync(path15.join(root, "go.mod"))) stack.languages.push("Go");
-      if (fs14.existsSync(path15.join(root, "Cargo.toml"))) stack.languages.push("Rust");
-      if (fs14.existsSync(path15.join(root, "pyproject.toml"))) stack.languages.push("Python");
-      if (fs14.existsSync(path15.join(root, "Gemfile"))) stack.languages.push("Ruby");
-      if (stack.languages.length === 0) stack.languages.push("JavaScript");
-    }
-  } catch {
-  }
-  return stack;
-}
-function detectEntryPoints() {
-  const root = getProjectRoot();
-  const entryPoints = [];
-  const candidates = [
-    "src/index.ts",
-    "src/index.js",
-    "src/app.ts",
-    "src/app.js",
-    "index.ts",
-    "index.js",
-    "src/main.ts",
-    "src/main.js",
-    "src/server.ts",
-    "src/server.js",
-    "app.ts",
-    "app.js",
-    "pages/index.tsx",
-    "pages/index.jsx",
-    "src/App.tsx",
-    "src/App.js",
-    "lib/main.ts",
-    "lib/index.ts"
-  ];
-  for (const c of candidates) {
-    if (fs14.existsSync(path15.join(root, c))) {
-      entryPoints.push(c);
-    }
-  }
-  try {
-    const pkg = JSON.parse(fs14.readFileSync(path15.join(root, "package.json"), "utf-8"));
-    if (pkg.main && fs14.existsSync(path15.join(root, pkg.main))) {
-      if (!entryPoints.includes(pkg.main)) entryPoints.push(pkg.main);
-    }
-  } catch {
-  }
-  return entryPoints;
-}
-async function getActiveADRs() {
-  try {
-    const db = await getDb();
-    const stmt = db.prepare(
-      "SELECT title FROM decision_log WHERE status = 'active' ORDER BY created_at DESC LIMIT 5"
-    );
-    const results = [];
-    while (stmt.step()) {
-      const row = stmt.getAsObject();
-      results.push(row.title);
-    }
-    stmt.free();
-    return results;
-  } catch {
-    return [];
-  }
-}
-async function generateContextDigest() {
-  const stack = detectTechStack();
-  const entryPoints = detectEntryPoints();
-  const adrs = await getActiveADRs();
-  const gotchas = getActiveGotchas();
-  const summary = sessionMemory.getSummary();
-  const lines = [
-    "\u{1F4CB} **Kuma Digest** \u2014 <500 token briefing",
-    "\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",
-    ""
-  ];
-  const langStr = stack.languages.join("/");
-  const frameworkStr = stack.framework || "\u2014";
-  const dbStr = stack.database || "\u2014";
-  const testStr = stack.testRunner || "\u2014";
-  const pmStr = stack.packageManager || "\u2014";
-  lines.push(`\u{1F527} **Stack**: ${langStr} | ${frameworkStr} | ${dbStr} | ${testStr} | ${pmStr}${stack.monorepo ? " (monorepo)" : ""}`);
-  lines.push(`\u{1F4C1} **Root**: ${getProjectRoot().split("/").pop() || "?"}`);
-  if (entryPoints.length > 0) {
-    lines.push(`\u{1F6AA} **Entry**: ${entryPoints.slice(0, 3).join(", ")}`);
-  }
-  try {
-    const ruleFile = path15.join(getProjectRoot(), ".kuma", "DOMAIN_RULES.md");
-    if (fs14.existsSync(ruleFile)) {
-      const content = fs14.readFileSync(ruleFile, "utf-8");
-      const rules = content.split("\n").filter((l) => /^- Rule \d+:?\s*/i.test(l)).map((l) => l.replace(/^- Rule \d+:?\s*/i, "").trim()).filter(Boolean);
-      if (rules.length > 0) {
-        lines.push(`\u{1F4CB} **Rules**: ${rules.slice(0, 5).join(" | ")}`);
-      }
-    }
-  } catch {
-  }
-  if (gotchas.length > 0) {
-    const critical = gotchas.filter((g) => g.severity === "critical" || g.severity === "high");
-    if (critical.length > 0) {
-      lines.push(`\u26A0\uFE0F **Gotchas**: ${critical.length} high/critical \u2014 ${critical.slice(0, 3).map((g) => g.filePath).join(", ")}`);
-    } else {
-      lines.push(`\u26A0\uFE0F **Gotchas**: ${gotchas.length} recorded`);
-    }
-  }
-  if (adrs.length > 0) {
-    lines.push(`\u{1F4DD} **ADRs**: ${adrs.slice(0, 3).join(" | ")}`);
-  }
-  lines.push(`\u{1F3AF} **Goal**: ${summary.currentGoal?.substring(0, 80) || "not set"}`);
-  const text = lines.join("\n");
-  const estimatedTokens = Math.ceil(text.length / 4);
-  if (estimatedTokens > 450) {
-    lines.push(`\u{1F4CA} *~${estimatedTokens} tokens, fits under 500 limit*`);
-  }
-  return lines.join("\n") + "\n\n\u{1F4A1} Use kuma_context({ action: 'digest' }) for the full state.";
-}
-var init_contextDigest = __esm({
-  "src/engine/contextDigest.ts"() {
-    "use strict";
-    init_pathValidator();
-    init_sessionMemory();
-    init_kumaDb();
-    init_domainRules();
-  }
-});
-
 // src/engine/kumaSearch.ts
 var kumaSearch_exports = {};
 __export(kumaSearch_exports, {
@@ -6184,8 +5714,8 @@ __export(kumaSearch_exports, {
   formatHybridResults: () => formatHybridResults,
   hybridSearch: () => hybridSearch
 });
-import fs16 from "fs";
-import path17 from "path";
+import fs15 from "fs";
+import path16 from "path";
 function expandQueryTerms(query) {
   const terms = query.toLowerCase().split(/[\s_-]+/).filter((t) => t.length > 2);
   const expanded = /* @__PURE__ */ new Map();
@@ -6248,13 +5778,13 @@ async function buildSearchVectors() {
   }
   try {
     const root = getProjectRoot();
-    const memDir = path17.join(root, ".kuma", "memories");
-    if (fs16.existsSync(memDir)) {
-      const files = fs16.readdirSync(memDir).filter((f) => f.endsWith(".md")).slice(0, SCALE_LIMITS.maxMemoryFiles);
+    const memDir = path16.join(root, ".kuma", "memories");
+    if (fs15.existsSync(memDir)) {
+      const files = fs15.readdirSync(memDir).filter((f) => f.endsWith(".md")).slice(0, SCALE_LIMITS.maxMemoryFiles);
       for (const file of files) {
         try {
-          const fullPath = path17.join(memDir, file);
-          const content = fs16.readFileSync(fullPath, "utf-8");
+          const fullPath = path16.join(memDir, file);
+          const content = fs15.readFileSync(fullPath, "utf-8");
           const text = content.toLowerCase();
           const rawTerms = extractTerms(text);
           const termCounts = /* @__PURE__ */ new Map();
@@ -6265,7 +5795,7 @@ async function buildSearchVectors() {
             terms: termCounts,
             source: file.replace(/\.md$/, ""),
             sourceType: "memory",
-            recency: recencyScore(Math.floor(fs16.statSync(fullPath).mtimeMs / 1e3))
+            recency: recencyScore(Math.floor(fs15.statSync(fullPath).mtimeMs / 1e3))
           });
         } catch {
         }
@@ -6575,368 +6105,45 @@ var init_kumaSearch = __esm({
   }
 });
 
-// src/engine/kumaMiner.ts
-var kumaMiner_exports = {};
-__export(kumaMiner_exports, {
-  mineHistoricalDecisions: () => mineHistoricalDecisions
+// src/engine/kumaCheckpoint.ts
+var kumaCheckpoint_exports = {};
+__export(kumaCheckpoint_exports, {
+  createCheckpoint: () => createCheckpoint,
+  listCheckpoints: () => listCheckpoints,
+  pruneCheckpoints: () => pruneCheckpoints,
+  rollbackToCheckpoint: () => rollbackToCheckpoint
 });
-import fs17 from "fs";
-import path18 from "path";
-import { execSync as execSync4 } from "child_process";
-import fastGlob2 from "fast-glob";
-async function mineHistoricalDecisions(options = {}) {
-  const root = process.cwd();
-  const limit = options.limit || 15;
-  const candidates = [];
+import fs19 from "fs";
+import path20 from "path";
+async function createCheckpoint(label, description) {
   try {
-    const sinceFlag = options.since ? `--since="${options.since}"` : `--since="1 year"`;
-    const gitCmd = `git log ${sinceFlag} -n 100 --pretty=format:"%h|%an|%ad|%s" --date=short`;
-    const gitOutput = execSync4(gitCmd, { cwd: root, encoding: "utf-8", timeout: 15e3 });
-    const keywords = ["fix", "revert", "hack", "workaround", "urgent", "hotfix", "don't touch", "temporary", "deprecated", "workaround"];
-    const lines = gitOutput.split("\n").filter(Boolean);
-    const matchingHashes = [];
-    for (const line of lines) {
-      const parts = line.split("|");
-      if (parts.length < 4) continue;
-      const [hash, author, date, subject] = parts;
-      const lowerSubj = subject.toLowerCase();
-      const matchedKeyword = keywords.find((kw) => lowerSubj.includes(kw));
-      if (matchedKeyword) {
-        matchingHashes.push({ hash, author, date, subject, keyword: matchedKeyword });
-        if (matchingHashes.length >= limit) break;
-      }
-    }
-    let changedFilesMap = /* @__PURE__ */ new Map();
-    if (matchingHashes.length > 0) {
-      try {
-        const hashesStr = matchingHashes.map((h) => h.hash).join(" ");
-        const batchOutput = execSync4(
-          `git show --name-only --oneline ${hashesStr} 2>/dev/null | head -200`,
-          { cwd: root, encoding: "utf-8", timeout: 1e4, maxBuffer: 256 * 1024 }
-        );
-        let currentHash = "";
-        const files = [];
-        for (const line of batchOutput.split("\n")) {
-          if (matchingHashes.find((h) => line.startsWith(h.hash))) {
-            if (currentHash && files.length > 0) {
-              changedFilesMap.set(currentHash, files.slice(0, 3).join(", "));
-            }
-            currentHash = line.split(" ")[0];
-            files.length = 0;
-          } else if (line.trim() && !line.startsWith("diff")) {
-            files.push(line.trim());
-          }
-        }
-        if (currentHash && files.length > 0) {
-          changedFilesMap.set(currentHash, files.slice(0, 3).join(", "));
-        }
-      } catch {
-      }
-    }
-    for (const { hash, author, date, subject, keyword: matchedKeyword } of matchingHashes) {
-      let changedFiles = changedFilesMap.get(hash) || "";
-      if (!changedFiles) {
-        try {
-          changedFiles = execSync4(`git show --name-only --oneline ${hash}`, { cwd: root, encoding: "utf-8", timeout: 5e3 }).split("\n").slice(1).filter(Boolean).slice(0, 3).join(", ");
-        } catch {
-        }
-        candidates.push({
-          id: `git-${hash}`,
-          type: "git_commit",
-          title: `[Git Commit] ${subject}`,
-          context: `Commit ${hash} by ${author} on ${date}.${changedFiles ? ` Files touched: ${changedFiles}` : ""}`,
-          rationale: `Historical signal pattern "${matchedKeyword}" found in commit message.`,
-          commitHash: hash,
-          pattern: matchedKeyword
-        });
-        if (candidates.length >= limit) break;
-      }
+    const root = getProjectRoot();
+    const cpDir = path20.join(root, CHECKPOINT_DIR, sanitizeLabel(label));
+    if (fs19.existsSync(cpDir)) {
+      return `\u26A0\uFE0F Checkpoint "${label}" already exists. Use a different label or remove it first.`;
     }
-  } catch {
-  }
-  if (candidates.length < limit) {
-    try {
-      const scopePattern = options.scope ? `**/*${options.scope}*.*` : `**/*.{${SOURCE_EXT_GLOB.slice(1, -1)},md}`;
-      const files = await fastGlob2(scopePattern, {
-        cwd: root,
-        ignore: ["node_modules/**", "dist/**", ".kuma/**", ".git/**", "coverage/**"],
-        onlyFiles: true
-      });
-      const commentPatterns = [
-        { tag: "HACK", regex: /\/\/\s*HACK:?\s*(.*)|#\s*HACK:?\s*(.*)/i },
-        { tag: "FIXME", regex: /\/\/\s*FIXME:?\s*(.*)|#\s*FIXME:?\s*(.*)/i },
-        { tag: "TODO", regex: /\/\/\s*TODO:?\s*(.*)|#\s*TODO:?\s*(.*)/i },
-        { tag: "XXX", regex: /\/\/\s*XXX:?\s*(.*)|#\s*XXX:?\s*(.*)/i },
-        { tag: "WARNING", regex: /\/\/\s*WARNING:?\s*(.*)|#\s*WARNING:?\s*(.*)/i }
-      ];
-      for (const file of files.slice(0, 50)) {
-        if (candidates.length >= limit) break;
-        const fullPath = path18.join(root, file);
-        if (!fs17.existsSync(fullPath)) continue;
-        const content = fs17.readFileSync(fullPath, "utf-8");
-        const lines = content.split("\n");
-        for (let i = 0; i < lines.length; i++) {
-          const l = lines[i];
-          for (const cp of commentPatterns) {
-            const match = cp.regex.exec(l);
-            if (match) {
-              const text = (match[1] || match[2] || l).trim();
-              candidates.push({
-                id: `comment-${file}-${i + 1}`,
-                type: "inline_comment",
-                title: `[${cp.tag}] ${file}:${i + 1}`,
-                context: `Inline comment marker "${cp.tag}" found in file "${file}" at line ${i + 1}.`,
-                rationale: text || l.trim(),
-                filePath: file,
-                lineNumber: i + 1,
-                pattern: cp.tag
-              });
-              if (candidates.length >= limit) break;
-            }
-          }
-          if (candidates.length >= limit) break;
-        }
-      }
-    } catch {
-    }
-  }
-  if (options.confirm && candidates.length > 0) {
-    let recordedCount = 0;
-    for (const c of candidates) {
-      await recordDecision({
-        title: c.title,
-        context: c.context,
-        options: [],
-        rationale: c.rationale,
-        outcome: `Mined from ${c.type}`,
-        timestamp: (/* @__PURE__ */ new Date()).toISOString()
-      });
-      recordedCount++;
-    }
-    return `\u26CF\uFE0F **Mined & Recorded ${recordedCount} Decisions** into decision log & graph.
-Use \`kuma_memory({ action: 'decision_log' })\` to view all active & proposed decisions.`;
-  }
-  if (candidates.length === 0) {
-    return "\u26CF\uFE0F **Decision Mining**: No significant historical decision markers (HACK/FIXME/git fix) found for the requested scope.";
-  }
-  const report = [
-    `\u26CF\uFE0F **Decision Mining Candidates** (${candidates.length} candidate(s) found)`,
-    "\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\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501",
-    "Review these draft historical decisions mined from git history & inline comments:",
-    ""
-  ];
-  candidates.forEach((c, idx) => {
-    report.push(`**${idx + 1}. ${c.title}**`);
-    report.push(`  \u2022 **Type**: \`${c.type}\` | **Signal**: \`${c.pattern}\``);
-    report.push(`  \u2022 **Context**: ${c.context}`);
-    report.push(`  \u2022 **Rationale**: ${c.rationale}`);
-    report.push("");
-  });
-  report.push("\u{1F4A1} *To accept and record these mined decisions into knowledge graph & decision.md:*");
-  report.push(`Run: \`kuma_memory({ action: 'mine', confirm: true${options.scope ? `, scope: '${options.scope}'` : ""} })\``);
-  return report.join("\n");
-}
-var init_kumaMiner = __esm({
-  "src/engine/kumaMiner.ts"() {
-    "use strict";
-    init_kumaMemory();
-    init_languageSupport();
-  }
-});
-
-// src/engine/kumaAstValidator.ts
-var kumaAstValidator_exports = {};
-__export(kumaAstValidator_exports, {
-  formatValidationFindings: () => formatValidationFindings,
-  validateCodeContent: () => validateCodeContent,
-  validateDiff: () => validateDiff,
-  validateFile: () => validateFile
-});
-import fs22 from "fs";
-import path23 from "path";
-function loadImportWhitelist() {
-  try {
-    const root = getProjectRoot();
-    const whitelistPath = path23.join(root, ".kuma", "import-whitelist.json");
-    if (fs22.existsSync(whitelistPath)) {
-      return JSON.parse(fs22.readFileSync(whitelistPath, "utf-8"));
-    }
-  } catch {
-  }
-  return {
-    allowed: [],
-    blocked: ["sql.js", "better-sqlite3", "mysql", "mssql"]
-    // dangerous native deps
-  };
-}
-function validateCodeContent(code, filePath) {
-  const findings = [];
-  const lines = code.split("\n");
-  const whitelist = loadImportWhitelist();
-  for (let i = 0; i < lines.length; i++) {
-    const line = lines[i];
-    const lineNum = i + 1;
-    if (/\/\/\s*(expect|assert|should|test|it\.)\s*\(/.test(line) || /(\/\*[\s\S]*?\*\/)/.test(line) && /(expect|assert|should|test)/.test(line)) {
-      findings.push({
-        line: lineNum,
-        severity: "error",
-        category: "assertion-deletion",
-        message: `Test assertion appears to be commented out on line ${lineNum}`,
-        suggestion: "Restore the assertion or write an equivalent test for the new behavior"
-      });
-    }
-    const emptyCatch = /catch\s*\([^)]*\)\s*\{\s*\}/.test(line) || /catch\s*\([^)]*\)\s*\{/.test(line) && lines[i + 1]?.trim() === "}" || // Python: bare/empty except blocks (except:, except Exception: pass)
-    /except\s*([^:]*)\s*:\s*(pass|\.\.\.)\s*(#.*)?$/.test(line) || /except\s*([^:]*)\s*:\s*$/.test(line) && /^pass(\s*#.*)?$/.test(lines[i + 1]?.trim() ?? "");
-    if (emptyCatch) {
-      findings.push({
-        line: lineNum,
-        severity: "error",
-        category: "exception-swallowing",
-        message: `Empty catch block on line ${lineNum} \u2014 exceptions are being swallowed`,
-        suggestion: "Handle the error: log it, throw a meaningful error, or add a comment explaining why it's safe to ignore"
-      });
-    }
-    if (isTestFile(filePath || "")) {
-      if (/\breturn\s+(true|false|null|undefined|0|""|'')\s*;/.test(line) || /\breturn\s+\d+\s*;/.test(line) || /\breturn\s+(True|False|None)\b/.test(line) || /\breturn\s+0\b/.test(line) || /\bPromise\.resolve\s*\(\s*(true|false|null|undefined|0|""|'')\s*\)/.test(line)) {
-        findings.push({
-          line: lineNum,
-          severity: "warning",
-          category: "reward-hacking",
-          message: `Possible hardcoded return in test file on line ${lineNum}: ${line.trim().substring(0, 60)}`,
-          suggestion: "Implement the actual logic instead of returning a hardcoded value to pass tests"
-        });
-      }
-    }
-    if (!isTestFile(filePath || "") && /\breturn\s+(true|false|null)\s*;/.test(line) && ((lines[i - 1] || "").includes("TODO") || (lines[i - 1] || "").includes("FIXME") || (lines[i - 1] || "").includes("HACK"))) {
-      findings.push({
-        line: lineNum,
-        severity: "warning",
-        category: "hardcoded-return",
-        message: `Hardcoded return value on line ${lineNum} (possibly temporary/hack)`,
-        suggestion: "Implement proper logic or add a clear comment explaining why this is correct"
-      });
-    }
-    const imported = matchImportPath(line);
-    if (imported && whitelist.blocked.some((b) => imported.includes(b))) {
-      findings.push({
-        line: lineNum,
-        severity: "error",
-        category: "import-violation",
-        message: `Blocked import: "${imported}" is not allowed per security whitelist`,
-        suggestion: `Remove or replace the import. Allowed packages: ${whitelist.allowed.slice(0, 5).join(", ") || "(none specified)"}`
-      });
-    }
-  }
-  return findings;
-}
-function validateFile(filePath) {
-  try {
-    const root = getProjectRoot();
-    const fullPath = path23.resolve(root, filePath);
-    if (!fs22.existsSync(fullPath)) return [];
-    const content = fs22.readFileSync(fullPath, "utf-8");
-    return validateCodeContent(content, filePath);
-  } catch {
-    return [];
-  }
-}
-function formatValidationFindings(findings, filePath) {
-  if (findings.length === 0) {
-    return "\u2705 **AST Validation** \u2014 No structural issues found.";
-  }
-  const errors = findings.filter((f) => f.severity === "error");
-  const warnings = findings.filter((f) => f.severity === "warning");
-  const lines = [
-    "\u{1F52C} **AST Code Validation 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",
-    "",
-    `${findings.length} finding(s): ${errors.length} errors, ${warnings.length} warnings`,
-    filePath ? `\u{1F4C4} ${filePath}` : "",
-    ""
-  ];
-  for (const f of findings) {
-    const icon = f.severity === "error" ? "\u{1F534}" : f.severity === "warning" ? "\u{1F7E1}" : "\u{1F7E2}";
-    lines.push(`${icon} L${f.line} [${f.category}]`);
-    lines.push(`   ${f.message}`);
-    lines.push(`   \u{1F4A1} ${f.suggestion}`);
-    lines.push("");
-  }
-  return lines.join("\n");
-}
-function validateDiff(oldContent, newContent, filePath) {
-  const findings = [];
-  const oldFindings = validateCodeContent(oldContent, filePath);
-  const newFindings = validateCodeContent(newContent, filePath);
-  const oldAssertions = oldFindings.filter((f) => f.category === "assertion-deletion");
-  const newAssertions = newFindings.filter((f) => f.category === "assertion-deletion");
-  for (const oldAssertion of oldAssertions) {
-    if (!newAssertions.some((f) => f.line === oldAssertion.line && f.message === oldAssertion.message)) {
-      continue;
-    }
-  }
-  const oldLines = oldContent.split("\n");
-  const newLines = newContent.split("\n");
-  for (let i = 0; i < newLines.length; i++) {
-    if (i >= oldLines.length || newLines[i] !== oldLines[i]) {
-      const changedLineFindings = validateCodeContent(newLines[i], filePath);
-      for (const f of changedLineFindings) {
-        findings.push({
-          ...f,
-          line: i + 1,
-          message: `[NEW] ${f.message}`
-        });
-      }
-    }
-  }
-  return findings;
-}
-var init_kumaAstValidator = __esm({
-  "src/engine/kumaAstValidator.ts"() {
-    "use strict";
-    init_pathValidator();
-    init_languageSupport();
-  }
-});
-
-// src/engine/kumaCheckpoint.ts
-var kumaCheckpoint_exports = {};
-__export(kumaCheckpoint_exports, {
-  createCheckpoint: () => createCheckpoint,
-  listCheckpoints: () => listCheckpoints,
-  pruneCheckpoints: () => pruneCheckpoints,
-  rollbackToCheckpoint: () => rollbackToCheckpoint
-});
-import fs23 from "fs";
-import path24 from "path";
-async function createCheckpoint(label, description) {
-  try {
-    const root = getProjectRoot();
-    const cpDir = path24.join(root, CHECKPOINT_DIR, sanitizeLabel(label));
-    if (fs23.existsSync(cpDir)) {
-      return `\u26A0\uFE0F Checkpoint "${label}" already exists. Use a different label or remove it first.`;
-    }
-    fs23.mkdirSync(cpDir, { recursive: true });
-    const db = await getDb();
-    const filesStmt = db.prepare(
-      "SELECT DISTINCT file_path FROM change_log ORDER BY id DESC LIMIT 100"
-    );
-    const files = [];
-    while (filesStmt.step()) {
-      const row = filesStmt.getAsObject();
-      const fp = row.file_path;
-      const fullPath = path24.resolve(root, fp);
-      if (fs23.existsSync(fullPath)) {
-        const content = fs23.readFileSync(fullPath, "utf-8");
-        const hash = simpleHash2(content);
-        const fileDir = path24.dirname(path24.join(cpDir, "files", fp));
-        if (!fs23.existsSync(fileDir)) fs23.mkdirSync(fileDir, { recursive: true });
-        fs23.writeFileSync(path24.join(cpDir, "files", fp), content, "utf-8");
-        files.push({ path: fp, hash });
+    fs19.mkdirSync(cpDir, { recursive: true });
+    const db = await getDb();
+    const filesStmt = db.prepare(
+      "SELECT DISTINCT file_path FROM change_log ORDER BY id DESC LIMIT 100"
+    );
+    const files = [];
+    while (filesStmt.step()) {
+      const row = filesStmt.getAsObject();
+      const fp = row.file_path;
+      const fullPath = path20.resolve(root, fp);
+      if (fs19.existsSync(fullPath)) {
+        const content = fs19.readFileSync(fullPath, "utf-8");
+        const hash = simpleHash2(content);
+        const fileDir = path20.dirname(path20.join(cpDir, "files", fp));
+        if (!fs19.existsSync(fileDir)) fs19.mkdirSync(fileDir, { recursive: true });
+        fs19.writeFileSync(path20.join(cpDir, "files", fp), content, "utf-8");
+        files.push({ path: fp, hash });
       }
     }
     filesStmt.free();
     const dbData = db.export();
-    fs23.writeFileSync(path24.join(cpDir, "kuma.db"), Buffer.from(dbData));
+    fs19.writeFileSync(path20.join(cpDir, "kuma.db"), Buffer.from(dbData));
     const manifest = {
       label,
       timestamp: Date.now(),
@@ -6944,8 +6151,8 @@ async function createCheckpoint(label, description) {
       dbSnapshot: true,
       description
     };
-    fs23.writeFileSync(
-      path24.join(cpDir, "manifest.json"),
+    fs19.writeFileSync(
+      path20.join(cpDir, "manifest.json"),
       JSON.stringify(manifest, null, 2),
       "utf-8"
     );
@@ -6961,7 +6168,7 @@ async function createCheckpoint(label, description) {
       `\u{1F5C4}\uFE0F  **Database** snapshotted`,
       `\u{1F4CD} ${cpDir}`,
       ``,
-      `\u{1F4A1} To restore: kuma_safety({ action: 'rollback', label: '${label}' })`,
+      `\u{1F4A1} To restore: kuma_safety({ action: 'rollback_label', label: '${label}' })`,
       description ? `\u{1F4DD} ${description}` : ""
     ].filter(Boolean).join("\n");
   } catch (err) {
@@ -6971,37 +6178,39 @@ async function createCheckpoint(label, description) {
 async function rollbackToCheckpoint(label) {
   try {
     const root = getProjectRoot();
-    const cpDir = path24.join(root, CHECKPOINT_DIR, sanitizeLabel(label));
-    const manifestPath = path24.join(cpDir, "manifest.json");
-    if (!fs23.existsSync(manifestPath)) {
-      return `\u274C Checkpoint "${label}" not found. Use kuma_safety({ action: 'checkpoint_list' }) to see available checkpoints.`;
+    const cpDir = path20.join(root, CHECKPOINT_DIR, sanitizeLabel(label));
+    const manifestPath = path20.join(cpDir, "manifest.json");
+    if (!fs19.existsSync(manifestPath)) {
+      return `\u274C Checkpoint "${label}" not found. Available checkpoints:
+
+${listCheckpoints()}`;
     }
     const manifest = JSON.parse(
-      fs23.readFileSync(manifestPath, "utf-8")
+      fs19.readFileSync(manifestPath, "utf-8")
     );
     let restored = 0;
     let failed = 0;
     for (const f of manifest.files) {
-      const snapshotPath = path24.join(cpDir, "files", f.path);
-      if (fs23.existsSync(snapshotPath)) {
+      const snapshotPath = path20.join(cpDir, "files", f.path);
+      if (fs19.existsSync(snapshotPath)) {
         try {
-          const content = fs23.readFileSync(snapshotPath, "utf-8");
-          const targetPath = path24.resolve(root, f.path);
-          const targetDir = path24.dirname(targetPath);
-          if (!fs23.existsSync(targetDir)) fs23.mkdirSync(targetDir, { recursive: true });
-          fs23.writeFileSync(targetPath, content, "utf-8");
+          const content = fs19.readFileSync(snapshotPath, "utf-8");
+          const targetPath = path20.resolve(root, f.path);
+          const targetDir = path20.dirname(targetPath);
+          if (!fs19.existsSync(targetDir)) fs19.mkdirSync(targetDir, { recursive: true });
+          fs19.writeFileSync(targetPath, content, "utf-8");
           restored++;
         } catch {
           failed++;
         }
       }
     }
-    const dbSnapshotPath = path24.join(cpDir, "kuma.db");
-    if (fs23.existsSync(dbSnapshotPath)) {
-      const kumaDir = path24.join(root, ".kuma");
-      const dbPath = path24.join(kumaDir, "kuma.db");
-      const snapshotData = fs23.readFileSync(dbSnapshotPath);
-      fs23.writeFileSync(dbPath, snapshotData);
+    const dbSnapshotPath = path20.join(cpDir, "kuma.db");
+    if (fs19.existsSync(dbSnapshotPath)) {
+      const kumaDir = path20.join(root, ".kuma");
+      const dbPath = path20.join(kumaDir, "kuma.db");
+      const snapshotData = fs19.readFileSync(dbSnapshotPath);
+      fs19.writeFileSync(dbPath, snapshotData);
       resetDbInstance();
     }
     sessionMemory.recordToolCall("kuma_checkpoint_rollback", {
@@ -7026,18 +6235,18 @@ async function rollbackToCheckpoint(label) {
 function listCheckpoints() {
   try {
     const root = getProjectRoot();
-    const cpDir = path24.join(root, CHECKPOINT_DIR);
-    if (!fs23.existsSync(cpDir)) {
+    const cpDir = path20.join(root, CHECKPOINT_DIR);
+    if (!fs19.existsSync(cpDir)) {
       return "\u{1F4ED} No checkpoints found. Use kuma_safety({ action: 'checkpoint', label: 'pre-feature-x' }) to create one.";
     }
-    const entries = fs23.readdirSync(cpDir);
+    const entries = fs19.readdirSync(cpDir);
     const checkpoints = [];
     for (const entry of entries) {
-      const manifestPath = path24.join(cpDir, entry, "manifest.json");
-      if (fs23.existsSync(manifestPath)) {
+      const manifestPath = path20.join(cpDir, entry, "manifest.json");
+      if (fs19.existsSync(manifestPath)) {
         try {
           const manifest = JSON.parse(
-            fs23.readFileSync(manifestPath, "utf-8")
+            fs19.readFileSync(manifestPath, "utf-8")
           );
           checkpoints.push({ label: entry, manifest });
         } catch {
@@ -7069,12 +6278,12 @@ function listCheckpoints() {
 function pruneCheckpoints(keep = 5) {
   try {
     const root = getProjectRoot();
-    const cpDir = path24.join(root, CHECKPOINT_DIR);
-    if (!fs23.existsSync(cpDir)) return "\u{1F4ED} No checkpoints to prune.";
-    const entries = fs23.readdirSync(cpDir).map((e) => ({ name: e, time: fs23.statSync(path24.join(cpDir, e)).mtimeMs })).sort((a, b) => b.time - a.time);
+    const cpDir = path20.join(root, CHECKPOINT_DIR);
+    if (!fs19.existsSync(cpDir)) return "\u{1F4ED} No checkpoints to prune.";
+    const entries = fs19.readdirSync(cpDir).map((e) => ({ name: e, time: fs19.statSync(path20.join(cpDir, e)).mtimeMs })).sort((a, b) => b.time - a.time);
     let removed = 0;
     for (let i = keep; i < entries.length; i++) {
-      fs23.rmSync(path24.join(cpDir, entries[i].name), { recursive: true, force: true });
+      fs19.rmSync(path20.join(cpDir, entries[i].name), { recursive: true, force: true });
       removed++;
     }
     return removed > 0 ? `\u{1F9F9} Pruned **${removed} old checkpoint(s)**. Kept ${Math.min(keep, entries.length)} most recent.` : "\u2705 No checkpoints needed pruning.";
@@ -7115,16 +6324,16 @@ __export(kumaAutoGotcha_exports, {
   saveAutoGotchaState: () => saveAutoGotchaState,
   trackVerificationResult: () => trackVerificationResult
 });
-import fs24 from "fs";
-import path25 from "path";
+import fs20 from "fs";
+import path21 from "path";
 function statePath() {
-  return path25.join(getProjectRoot(), STATE_FILE);
+  return path21.join(getProjectRoot(), STATE_FILE);
 }
 function loadAutoGotchaState() {
   try {
     const fp = statePath();
-    if (fs24.existsSync(fp)) {
-      const parsed = JSON.parse(fs24.readFileSync(fp, "utf-8"));
+    if (fs20.existsSync(fp)) {
+      const parsed = JSON.parse(fs20.readFileSync(fp, "utf-8"));
       return {
         failures: parsed?.failures ?? {},
         lastRecorded: parsed?.lastRecorded ?? {}
@@ -7137,9 +6346,9 @@ function loadAutoGotchaState() {
 function saveAutoGotchaState(state) {
   try {
     const fp = statePath();
-    const dir = path25.dirname(fp);
-    if (!fs24.existsSync(dir)) fs24.mkdirSync(dir, { recursive: true });
-    fs24.writeFileSync(fp, JSON.stringify(state, null, 2), "utf-8");
+    const dir = path21.dirname(fp);
+    if (!fs20.existsSync(dir)) fs20.mkdirSync(dir, { recursive: true });
+    fs20.writeFileSync(fp, JSON.stringify(state, null, 2), "utf-8");
   } catch {
   }
 }
@@ -7222,37 +6431,37 @@ __export(kumaVerifier_exports, {
   getRunningVerificationPid: () => getRunningVerificationPid,
   runAutoVerification: () => runAutoVerification
 });
-import fs25 from "fs";
-import path26 from "path";
+import fs21 from "fs";
+import path22 from "path";
 import { exec } from "child_process";
 function getLockDir(root = process.cwd()) {
-  return path26.resolve(root, LOCK_DIR_NAME);
+  return path22.resolve(root, LOCK_DIR_NAME);
 }
 function getPidFile(root = process.cwd()) {
-  return path26.join(getLockDir(root), "pid");
+  return path22.join(getLockDir(root), "pid");
 }
 function acquireFileLock(root) {
   const lockDir = getLockDir(root);
   try {
-    fs25.mkdirSync(lockDir, { recursive: false });
-    fs25.writeFileSync(getPidFile(root), String(process.pid), "utf-8");
+    fs21.mkdirSync(lockDir, { recursive: false });
+    fs21.writeFileSync(getPidFile(root), String(process.pid), "utf-8");
     return true;
   } catch {
     try {
-      if (fs25.existsSync(getPidFile(root))) {
-        const pid = parseInt(fs25.readFileSync(getPidFile(root), "utf-8"), 10);
+      if (fs21.existsSync(getPidFile(root))) {
+        const pid = parseInt(fs21.readFileSync(getPidFile(root), "utf-8"), 10);
         try {
           process.kill(pid, 0);
           return false;
         } catch {
-          fs25.rmSync(lockDir, { recursive: true, force: true });
+          fs21.rmSync(lockDir, { recursive: true, force: true });
           return acquireFileLock(root);
         }
       }
     } catch {
     }
     try {
-      fs25.rmSync(lockDir, { recursive: true, force: true });
+      fs21.rmSync(lockDir, { recursive: true, force: true });
       return acquireFileLock(root);
     } catch {
       return false;
@@ -7261,7 +6470,7 @@ function acquireFileLock(root) {
 }
 function releaseFileLock(root) {
   try {
-    fs25.rmSync(getLockDir(root), { recursive: true, force: true });
+    fs21.rmSync(getLockDir(root), { recursive: true, force: true });
   } catch {
   }
 }
@@ -7284,36 +6493,36 @@ function getRunningVerificationPid() {
   return _currentProcess?.pid ?? null;
 }
 function detectTestRunner(root = process.cwd()) {
-  const pkgPath = path26.join(root, "package.json");
-  if (fs25.existsSync(pkgPath)) {
+  const pkgPath = path22.join(root, "package.json");
+  if (fs21.existsSync(pkgPath)) {
     try {
-      const pkg = JSON.parse(fs25.readFileSync(pkgPath, "utf-8"));
+      const pkg = JSON.parse(fs21.readFileSync(pkgPath, "utf-8"));
       if (pkg.scripts && pkg.scripts.test) {
-        if (fs25.existsSync(path26.join(root, "pnpm-lock.yaml"))) return { runner: "pnpm", baseCommand: "pnpm test" };
-        if (fs25.existsSync(path26.join(root, "yarn.lock"))) return { runner: "yarn", baseCommand: "yarn test" };
+        if (fs21.existsSync(path22.join(root, "pnpm-lock.yaml"))) return { runner: "pnpm", baseCommand: "pnpm test" };
+        if (fs21.existsSync(path22.join(root, "yarn.lock"))) return { runner: "yarn", baseCommand: "yarn test" };
         return { runner: "npm", baseCommand: "npm test" };
       }
     } catch {
     }
   }
-  if (fs25.existsSync(path26.join(root, "pytest.ini")) || fs25.existsSync(path26.join(root, "pyproject.toml"))) return { runner: "pytest", baseCommand: "pytest" };
-  if (fs25.existsSync(path26.join(root, "Cargo.toml"))) return { runner: "cargo", baseCommand: "cargo test" };
-  if (fs25.existsSync(path26.join(root, "go.mod"))) return { runner: "go", baseCommand: "go test ./..." };
-  if (fs25.existsSync(path26.join(root, "Makefile"))) {
+  if (fs21.existsSync(path22.join(root, "pytest.ini")) || fs21.existsSync(path22.join(root, "pyproject.toml"))) return { runner: "pytest", baseCommand: "pytest" };
+  if (fs21.existsSync(path22.join(root, "Cargo.toml"))) return { runner: "cargo", baseCommand: "cargo test" };
+  if (fs21.existsSync(path22.join(root, "go.mod"))) return { runner: "go", baseCommand: "go test ./..." };
+  if (fs21.existsSync(path22.join(root, "Makefile"))) {
     try {
-      const makefileContent = fs25.readFileSync(path26.join(root, "Makefile"), "utf-8");
+      const makefileContent = fs21.readFileSync(path22.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 (fs25.existsSync(path26.join(root, "package.json"))) {
+  if (fs21.existsSync(path22.join(root, "package.json"))) {
     try {
-      const pkg = JSON.parse(fs25.readFileSync(path26.join(root, "package.json"), "utf-8"));
+      const pkg = JSON.parse(fs21.readFileSync(path22.join(root, "package.json"), "utf-8"));
       if (pkg.dependencies || pkg.devDependencies) {
-        if (fs25.existsSync(path26.join(root, "tsconfig.json"))) return { runner: "tsc", baseCommand: "npx tsc --noEmit" };
-        const srcDir = path26.join(root, "src");
-        if (fs25.existsSync(srcDir)) return { runner: "node", baseCommand: `node -c "${srcDir}/**/*.js" 2>/dev/null || node --check $(find src -name '*.js' 2>/dev/null | head -5)` };
+        if (fs21.existsSync(path22.join(root, "tsconfig.json"))) return { runner: "tsc", baseCommand: "npx tsc --noEmit" };
+        const srcDir = path22.join(root, "src");
+        if (fs21.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 {
     }
@@ -7432,7 +6641,7 @@ async function runAutoVerification(options = {}) {
       const heartbeatTimer = setInterval(() => {
         if (getLockDir(root)) {
           try {
-            fs25.writeFileSync(getPidFile(root), String(process.pid), "utf-8");
+            fs21.writeFileSync(getPidFile(root), String(process.pid), "utf-8");
           } catch {
           }
         }
@@ -7552,8 +6761,8 @@ __export(init_exports, {
   generateInitMdContent: () => generateInitMdContent,
   runInit: () => runInit
 });
-import fs26 from "fs";
-import path27 from "path";
+import fs22 from "fs";
+import path23 from "path";
 function configFilePath(type) {
   switch (type) {
     case "claude":
@@ -7595,7 +6804,7 @@ function claudeTemplate() {
     "   \u26A0\uFE0F Requires `kuma` on PATH (global install). A silent hook means no gotchas for that file.",
     "",
     "\u{1F4D6} Rules: `.kuma/init.md`",
-    "\u{1F9E0} Memories: `.kuma/memories/*.md`"
+    "\u{1F4C2} Readable state: `.kuma/KNOWN_GOTCHAS.md` (gotchas) \xB7 `.kuma/memories/decisions.md` (decisions)"
   ].join("\n");
 }
 function cursorRulesTemplate() {
@@ -7617,7 +6826,7 @@ function windsurfRulesTemplate() {
     "Windsurf Cascade agent: Kuma MCP tools are installed.",
     "All behavioral rules are in `.kuma/init.md`.",
     '**Before coding, call `kuma_context({ action: "init" })`** to load project context and session memory.',
-    "Project knowledge persists in `.kuma/memories/*.md` across sessions.",
+    "Project knowledge persists across sessions (`.kuma/` \u2014 kuma.db + markdown layers).",
     "",
     "Also auto-detected as SKILL.md in `.windsurf/skills/` and `.agents/skills/`."
   ].join("\n");
@@ -7654,12 +6863,22 @@ function opencodeAgentsMdTemplate() {
     "Kuma MCP tools: kuma_kuma_context, kuma_kuma_memory, kuma_kuma_safety.",
     "Record what matters, skip what doesn't.",
     "",
+    "<kuma_obedience>",
+    "## \u{1F512} Obedience (non-negotiable)",
+    '- MUST call `kuma_kuma_context({ action: "init" })` at session start.',
+    "- MUST record gotchas IMMEDIATELY when a bug/quirk is found.",
+    '- MUST call `kuma_kuma_safety({ action: "verify" })` after edits.',
+    "- MUST NOT call actions outside the 13 core actions.",
+    "</kuma_obedience>",
+    "",
+    "<kuma_workflow>",
     '\u{1F9E0} **Before coding:** `kuma_kuma_context({ action: "init" })`',
     '\u{1F52C} **Unfamiliar code:** `kuma_kuma_context({ action: "research", scope: "<area>" })`',
     '\u{1F41B} **Found a bug/quirk:** `kuma_kuma_memory({ action: "gotcha" })` (IMMEDIATELY)',
     '\u{1F9ED} **Chose between options:** `kuma_kuma_memory({ action: "decision" })`',
     '\u{1F500} **Traced a flow:** `kuma_kuma_memory({ action: "arch_flow" })` (max 5 files)',
     '\u{1F6E1}\uFE0F **Before risky work / after edits:** `kuma_kuma_safety({ action: "guard" | "verify" })`',
+    "</kuma_workflow>",
     "",
     "\u26A0\uFE0F **OpenCode note:** Tool names use `kuma_kuma_*` prefix.",
     ""
@@ -7736,7 +6955,7 @@ function openclawSkillTemplate() {
     KUMA_CORE_INSTRUCTIONS,
     "",
     "\u{1F4D6} Read `.kuma/init.md` for detailed rules.",
-    "\u{1F9E0} Memories: `.kuma/memories/*.md`"
+    "\u{1F4C2} Readable state: `.kuma/KNOWN_GOTCHAS.md` (gotchas) \xB7 `.kuma/memories/decisions.md` (decisions)"
   ].join("\n");
 }
 function codewhaleTemplate() {
@@ -7749,7 +6968,7 @@ function codewhaleTemplate() {
     KUMA_CORE_INSTRUCTIONS,
     "",
     "\u{1F4D6} Read `.kuma/init.md` for detailed rules.",
-    "\u{1F9E0} Memories: `.kuma/memories/*.md`"
+    "\u{1F4C2} Readable state: `.kuma/KNOWN_GOTCHAS.md` (gotchas) \xB7 `.kuma/memories/decisions.md` (decisions)"
   ].join("\n");
 }
 function antigravitySkillTemplate() {
@@ -7762,7 +6981,7 @@ function antigravitySkillTemplate() {
     KUMA_CORE_INSTRUCTIONS,
     "",
     "\u{1F4D6} Read `.kuma/init.md` for detailed rules.",
-    "\u{1F9E0} Memories: `.kuma/memories/*.md`"
+    "\u{1F4C2} Readable state: `.kuma/KNOWN_GOTCHAS.md` (gotchas) \xB7 `.kuma/memories/decisions.md` (decisions)"
   ].join("\n");
 }
 function antigravityMcpConfigTemplate() {
@@ -7791,16 +7010,36 @@ function generateInitMdContent() {
     "",
     "---",
     "",
+    "<kuma_obedience>",
+    "## \u{1F512} OBEDIENCE (non-negotiable)",
+    "",
+    '1. **MUST call `kuma_context({ action: "init" })`** at session start \u2014 before any code edit.',
+    '2. **MUST record gotchas IMMEDIATELY** when a bug/quirk is found (`kuma_memory({ action: "gotcha" })`).',
+    '3. **MUST call `kuma_safety({ action: "verify" })`** after code edits.',
+    "4. **MUST NOT call actions outside the 13 core actions** in this file \u2014 anything else is rejected by the MCP schema.",
+    "5. If a Kuma call fails or returns an error, **re-read this file and retry** \u2014 do not silently continue.",
+    "",
+    "> These rules are enforced: the MCP schema rejects unknown actions, and Claude Code hooks inject gotchas before every edit.",
+    "</kuma_obedience>",
+    "",
+    "---",
+    "",
+    "<kuma_workflow>",
     "## SESSION WORKFLOW",
     "",
-    "### 6 Core Actions",
+    "### Core Actions (13)",
     "",
     '\u{1F9E0} **Before coding:** `kuma_context({ action: "init" })`',
     '\u{1F52C} **Unfamiliar code:** `kuma_context({ action: "research", scope: "<area>" })`',
+    '\u{1F570}\uFE0F **Why this file?** `kuma_context({ action: "history", target: "<file>" })`',
+    '\u{1F5C2}\uFE0F **Read a flow:** `kuma_context({ action: "flow", target: "<domain>" })`',
     '\u{1F41B} **Found a bug/quirk:** `kuma_memory({ action: "gotcha" })` (IMMEDIATELY)',
     '\u{1F9ED} **Chose between options:** `kuma_memory({ action: "decision" })`',
     '\u{1F500} **Traced a flow:** `kuma_memory({ action: "arch_flow" })` (max 5 files)',
+    '\u{1F4BE} **Saved findings:** `kuma_memory({ action: "research_save" })` \xB7 \u{1F50D} **Quick lookup:** `kuma_memory({ action: "search" })`',
     '\u{1F6E1}\uFE0F **Before risky work / after edits:** `kuma_safety({ action: "guard" | "verify" })`',
+    '\u{1F4F8} **Rollback (one mechanism):** `kuma_safety({ action: "checkpoint", label: "pre-x" })` \u2192 `rollback_label` to restore',
+    "</kuma_workflow>",
     "",
     "### Recording Rules",
     "",
@@ -7838,7 +7077,7 @@ function generateInitMdContent() {
     "",
     "## \u26A0\uFE0F HONEST LIMITATIONS",
     "",
-    "- **Node IDs are text-based** \u2014 same file recorded with slightly different paths can create duplicates. Use `delete_node` to clean up.",
+    "- **Node IDs are text-based** \u2014 same file recorded with slightly different paths can create duplicates.",
     "- **Metadata is JSON** \u2014 format varies per node type. Studio displays all fields dynamically.",
     "- **Gotchas have 2 stores** \u2014 `known_gotchas` table + `nodes` graph. `syncGotchasGraph()` keeps them in sync.",
     "- **Edge weights are static** \u2014 `contains`=2.0, `flows_through`=1.0. Dynamic ranking not yet implemented.",
@@ -7852,15 +7091,9 @@ function generateInitMdContent() {
     "| Action | Description |",
     "|--------|-------------|",
     "| `init` | Lean project brief, restore session |",
+    "| `research` | 5-step pipeline before editing unfamiliar code |",
     "| `history` | Why is this file written this way (cross-session trace) |",
-    "| `flow` | Hash-verified derived flow cache (F13) |",
-    "| `impact` | Analyze change effects |",
-    "| `navigate` | Trace code flow |",
-    "| `changes` | View session change log |",
-    "| `digest` | Ultra-compact project briefing |",
-    "| `drift` | Detect memory staleness |",
-    "| `rollback` | Undo a change by change ID |",
-    "| `resume` | Load previous session context |",
+    "| `flow` | Read a recorded architecture flow |",
     "",
     "### kuma_memory \u2014 Knowledge Recording",
     "",
@@ -7870,11 +7103,7 @@ function generateInitMdContent() {
     "| `arch_flow` | Record architecture flow (max 5 core files) |",
     "| `decision` | Record ADR / decision rationale |",
     "| `research_save` | Cache research findings |",
-    "| `search` | Search knowledge graph |",
-    "| `session` | Session summary |",
-    "| `mine` | Mine decisions from git history |",
-    "| `delete_node` | Remove node + graph + table entries |",
-    "| `goal_progress` | Track goal completion |",
+    "| `search` | Quick lookup of memory + knowledge graph |",
     "",
     "### kuma_safety \u2014 Safety & Verification",
     "",
@@ -7882,12 +7111,31 @@ function generateInitMdContent() {
     "|--------|-------------|",
     "| `guard` | Anti-pattern detection before edits |",
     "| `verify` | Auto-run scoped tests after edits |",
-    "| `check` | Pre-execution safety check |",
-    "| `audit` | Query audit trail |",
-    "| `security` | Security leak scanner |",
-    "| `gc` | Garbage collection |",
-    "| `ast`/`validate` | AST-based code validation |",
-    "| `checkpoint` | Atomic snapshot before refactors |",
+    "| `checkpoint` | Labeled snapshot before risky work |",
+    "| `rollback_label` | Restore a labeled snapshot |",
+    "",
+    "---",
+    "",
+    "<kuma_storage>",
+    "## \u{1F4C2} What Kuma Stores (.kuma/)",
+    "",
+    "Kuma persists project knowledge in `.kuma/`. You can READ these files directly ",
+    "(no MCP call needed) \u2014 but never edit them by hand; record via the actions instead.",
+    "",
+    "| File | Contents | Read via |",
+    "|------|----------|----------|",
+    "| `init.md` | This file \u2014 behavioral rules | read directly |",
+    '| `KNOWN_GOTCHAS.md` | Gotchas (human-readable) | `kuma_context({ action: "history" })` or read directly |',
+    '| `ARCHITECTURE_FLOW.md` | Recorded flows | `kuma_context({ action: "flow" })` or read directly |',
+    '| `memories/decisions.md` | Decision log (ADR-style) | `kuma_context({ action: "history" })` or read directly |',
+    '| `kuma.db` | SQLite graph (nodes, edges, research cache) | `kuma_memory({ action: "search" })` |',
+    '| `memory.json` | Session memory (internal) | `kuma_context({ action: "init" })` auto-restores |',
+    "| `auto-gotcha.json` | Loop auto-capture state (internal) | \u2014 |",
+    "",
+    "> Rules of thumb: `gotcha`/`arch_flow`/`decision` are the WRITE paths; `init`/`history`/",
+    "> `flow`/`search` are the READ paths. Keep recordings small and high-signal \u2014 each one",
+    "> is re-injected on future sessions.",
+    "</kuma_storage>",
     "",
     "---",
     "",
@@ -7916,27 +7164,16 @@ function generateInitMdContent() {
     "",
     "---",
     "",
-    "## \u{1F5D1}\uFE0F Graph Management",
-    "",
-    '**Delete:** `kuma_memory({ action: "delete_node", target: "<node_id_or_type>" })`',
-    "- Deletes from graph nodes, edges, AND known_gotchas table (unified delete)",
-    "",
-    '**Clear entire graph:** `kuma_memory({ action: "clear" })`',
-    "",
-    '**Self-heal:** `kuma_safety({ action: "gotcha_staleness" })`',
-    "- Verifies gotcha file/symbol references still exist",
-    "- Removes obsolete gotchas (deleted files)",
-    "",
     "---",
     "",
     "_Generated by Kuma MCP_"
   ].join("\n");
 }
 function handleOpencodeSecondary(root, results) {
-  const skillPath = path27.resolve(root, ".agents", "skills", "kuma", "SKILL.md");
+  const skillPath = path23.resolve(root, ".agents", "skills", "kuma", "SKILL.md");
   if (results.some((r) => r.filePath === ".agents/skills/kuma/SKILL.md")) return;
   try {
-    const dir = path27.dirname(skillPath);
+    const dir = path23.dirname(skillPath);
     const content = [
       "---",
       "name: kuma-mcp",
@@ -7946,29 +7183,39 @@ function handleOpencodeSecondary(root, results) {
       "Kuma MCP tools: kuma_kuma_context, kuma_kuma_memory, kuma_kuma_safety.",
       "Record what matters, skip what doesn't.",
       "",
+      "<kuma_obedience>",
+      "## \u{1F512} Obedience (non-negotiable)",
+      '- MUST call `kuma_kuma_context({ action: "init" })` at session start.',
+      "- MUST record gotchas IMMEDIATELY when a bug/quirk is found.",
+      '- MUST call `kuma_kuma_safety({ action: "verify" })` after edits.',
+      "- MUST NOT call actions outside the 13 core actions.",
+      "</kuma_obedience>",
+      "",
+      "<kuma_workflow>",
       '\u{1F9E0} **Before coding:** `kuma_kuma_context({ action: "init" })`',
       '\u{1F52C} **Unfamiliar code:** `kuma_kuma_context({ action: "research", scope: "<area>" })`',
       '\u{1F41B} **Found a bug/quirk:** `kuma_kuma_memory({ action: "gotcha" })` (IMMEDIATELY)',
       '\u{1F9ED} **Chose between options:** `kuma_kuma_memory({ action: "decision" })`',
       '\u{1F500} **Traced a flow:** `kuma_kuma_memory({ action: "arch_flow" })` (max 5 files)',
       '\u{1F6E1}\uFE0F **Before risky work / after edits:** `kuma_kuma_safety({ action: "guard" | "verify" })`',
+      "</kuma_workflow>",
       "",
       "\u26A0\uFE0F **OpenCode note:** Tool names use `kuma_kuma_*` prefix.",
       "",
       "\u{1F4D6} Full rules: `.kuma/init.md`"
     ].join("\n");
-    if (fs26.existsSync(skillPath)) {
-      const existing = fs26.readFileSync(skillPath, "utf-8");
+    if (fs22.existsSync(skillPath)) {
+      const existing = fs22.readFileSync(skillPath, "utf-8");
       if (existing.includes("kuma-mcp")) {
         results.push({ type: "opencode", filePath: ".agents/skills/kuma/SKILL.md", action: "skipped" });
         return;
       }
       const newContent = existing.trimEnd() + "\n\n---\n\n" + content;
-      fs26.writeFileSync(skillPath, newContent, "utf-8");
+      fs22.writeFileSync(skillPath, newContent, "utf-8");
       results.push({ type: "opencode", filePath: ".agents/skills/kuma/SKILL.md", action: "appended" });
     } else {
-      if (!fs26.existsSync(dir)) fs26.mkdirSync(dir, { recursive: true });
-      fs26.writeFileSync(skillPath, content, "utf-8");
+      if (!fs22.existsSync(dir)) fs22.mkdirSync(dir, { recursive: true });
+      fs22.writeFileSync(skillPath, content, "utf-8");
       results.push({ type: "opencode", filePath: ".agents/skills/kuma/SKILL.md", action: "created" });
     }
   } catch (err) {
@@ -7981,21 +7228,21 @@ function handleOpencodeSecondary(root, results) {
   }
 }
 function handleCodexSecondary(root, results) {
-  const tomlPath = path27.resolve(root, ".codex/config.toml");
+  const tomlPath = path23.resolve(root, ".codex/config.toml");
   if (results.some((r) => r.filePath === ".codex/config.toml")) return;
   try {
-    const dir = path27.dirname(tomlPath);
-    if (!fs26.existsSync(dir)) fs26.mkdirSync(dir, { recursive: true });
-    if (fs26.existsSync(tomlPath)) {
-      const existingContent = fs26.readFileSync(tomlPath, "utf-8");
+    const dir = path23.dirname(tomlPath);
+    if (!fs22.existsSync(dir)) fs22.mkdirSync(dir, { recursive: true });
+    if (fs22.existsSync(tomlPath)) {
+      const existingContent = fs22.readFileSync(tomlPath, "utf-8");
       if (existingContent.includes("kuma")) {
         results.push({ type: "codex", filePath: ".codex/config.toml", action: "skipped" });
         return;
       }
-      fs26.writeFileSync(tomlPath, existingContent.trimEnd() + "\n\n" + codexConfigTomlTemplate(), "utf-8");
+      fs22.writeFileSync(tomlPath, existingContent.trimEnd() + "\n\n" + codexConfigTomlTemplate(), "utf-8");
       results.push({ type: "codex", filePath: ".codex/config.toml", action: "appended" });
     } else {
-      fs26.writeFileSync(tomlPath, codexConfigTomlTemplate(), "utf-8");
+      fs22.writeFileSync(tomlPath, codexConfigTomlTemplate(), "utf-8");
       results.push({ type: "codex", filePath: ".codex/config.toml", action: "created" });
     }
   } catch (err) {
@@ -8008,11 +7255,11 @@ function handleCodexSecondary(root, results) {
   }
 }
 function handleQwenSecondary(root, results) {
-  const settingsPath = path27.resolve(root, "settings.json");
+  const settingsPath = path23.resolve(root, "settings.json");
   if (results.some((r) => r.filePath === "settings.json")) return;
   try {
-    if (fs26.existsSync(settingsPath)) {
-      const existingContent = fs26.readFileSync(settingsPath, "utf-8");
+    if (fs22.existsSync(settingsPath)) {
+      const existingContent = fs22.readFileSync(settingsPath, "utf-8");
       if (existingContent.includes("kuma")) {
         if (!existingContent.includes("_Generated by Kuma MCP_")) {
           try {
@@ -8020,7 +7267,7 @@ function handleQwenSecondary(root, results) {
             parsed.mcpServers = parsed.mcpServers || {};
             if (!parsed.mcpServers.kuma) {
               parsed.mcpServers.kuma = { command: "npx", args: ["-y", "@plumpslabs/kuma"], env: {} };
-              fs26.writeFileSync(settingsPath, JSON.stringify(parsed, null, 2) + "\n", "utf-8");
+              fs22.writeFileSync(settingsPath, JSON.stringify(parsed, null, 2) + "\n", "utf-8");
               results.push({ type: "qwen", filePath: "settings.json", action: "appended" });
               return;
             }
@@ -8035,13 +7282,13 @@ function handleQwenSecondary(root, results) {
         parsed.mcpServers = parsed.mcpServers || {};
         if (!parsed.mcpServers.kuma) {
           parsed.mcpServers.kuma = { command: "npx", args: ["-y", "@plumpslabs/kuma"], env: {} };
-          fs26.writeFileSync(settingsPath, JSON.stringify(parsed, null, 2) + "\n", "utf-8");
+          fs22.writeFileSync(settingsPath, JSON.stringify(parsed, null, 2) + "\n", "utf-8");
           results.push({ type: "qwen", filePath: "settings.json", action: "appended" });
         }
       } catch {
       }
     } else {
-      fs26.writeFileSync(settingsPath, qwenSettingsTemplate(), "utf-8");
+      fs22.writeFileSync(settingsPath, qwenSettingsTemplate(), "utf-8");
       results.push({ type: "qwen", filePath: "settings.json", action: "created" });
     }
   } catch (err) {
@@ -8063,16 +7310,28 @@ function getCombinedAgentsMd(selectedTypes) {
     "",
     "## SESSION WORKFLOW",
     "",
-    "### 6 Core Actions",
+    "<kuma_obedience>",
+    "## \u{1F512} Obedience (non-negotiable)",
+    '- MUST call `[kuma_]context({ action: "init" })` at session start.',
+    "- MUST record gotchas IMMEDIATELY when a bug/quirk is found.",
+    '- MUST call `[kuma_]safety({ action: "verify" })` after edits.',
+    "- MUST NOT call actions outside the 13 core actions.",
+    "</kuma_obedience>",
+    "",
+    "<kuma_workflow>",
+    "### Core Actions (13)",
     "",
     '\u{1F9E0} **Before coding:** `[kuma_]context({ action: "init" })`',
     '\u{1F52C} **Unfamiliar code:** `[kuma_]context({ action: "research", scope: "<area>" })`',
+    '\u{1F570}\uFE0F **Why this file?** `[kuma_]context({ action: "history", target: "<file>" })`',
+    '\u{1F5C2}\uFE0F **Read a flow:** `[kuma_]context({ action: "flow", target: "<domain>" })`',
     '\u{1F41B} **Found a bug/quirk:** `[kuma_]memory({ action: "gotcha" })` (IMMEDIATELY)',
     '\u{1F9ED} **Chose between options:** `[kuma_]memory({ action: "decision" })`',
     '\u{1F500} **Traced a flow:** `[kuma_]memory({ action: "arch_flow" })` (max 5 files)',
+    '\u{1F4BE} **Saved findings:** `[kuma_]memory({ action: "research_save" })` \xB7 \u{1F50D} **Quick lookup:** `[kuma_]memory({ action: "search" })`',
     '\u{1F6E1}\uFE0F **Before risky work / after edits:** `[kuma_]safety({ action: "guard" | "verify" })`',
-    "",
-    "\u{1F5D1}\uFE0F **Delete/Clear:** `delete_node` (delete node/gotcha/todo/decision) | `clear` (wipe entire graph)",
+    '\u{1F4F8} **Rollback:** `[kuma_]safety({ action: "checkpoint", label: "pre-x" })` \u2192 `rollback_label` to restore',
+    "</kuma_workflow>",
     "",
     "Replace `[kuma_]` with the correct prefix for your platform (see below).",
     "",
@@ -8093,7 +7352,7 @@ function getCombinedAgentsMd(selectedTypes) {
       '| Research | `kuma_kuma_context({ action: "research", scope: "..." })` |',
       '| Save | `kuma_kuma_memory({ action: "research_save", ... })` |',
       '| Verify | `kuma_kuma_safety({ action: "verify", ... })` |',
-      '| Changes | `kuma_kuma_context({ action: "changes" })` |',
+      '| Checkpoint | `kuma_kuma_safety({ action: "checkpoint", label: "pre-x" })` |',
       "",
       "\u{1F4D6} Skill: `.agents/skills/kuma/SKILL.md`",
       "",
@@ -8117,7 +7376,7 @@ function getCombinedAgentsMd(selectedTypes) {
       '| Research | `kuma_context({ action: "research", scope: "..." })` |',
       '| Save | `kuma_memory({ action: "research_save", ... })` |',
       '| Verify | `kuma_safety({ action: "verify", ... })` |',
-      '| Changes | `kuma_context({ action: "changes" })` |',
+      '| Checkpoint | `kuma_safety({ action: "checkpoint", label: "pre-x" })` |',
       "",
       "---",
       ""
@@ -8125,38 +7384,35 @@ function getCombinedAgentsMd(selectedTypes) {
   }
   lines.push(
     "\u{1F4D6} Rules: `.kuma/init.md`",
-    "\u{1F9E0} Memories: `.kuma/memories/*.md`",
+    "\u{1F4C2} Readable state: `.kuma/KNOWN_GOTCHAS.md` (gotchas) \xB7 `.kuma/memories/decisions.md` (decisions)",
     "",
     "_Generated by Kuma MCP - https://github.com/plumpslabs/kuma_"
   );
   return lines.join("\n");
 }
 function handleAntigravityMcpConfig(root, results) {
-  const mcpPath = path27.resolve(root, ".agents/mcp_config.json");
+  const mcpPath = path23.resolve(root, ".agents/mcp_config.json");
   if (results.some((r) => r.filePath === ".agents/mcp_config.json")) return;
   try {
-    const mcpDir = path27.dirname(mcpPath);
-    if (fs26.existsSync(mcpPath)) {
-      const existingContent = fs26.readFileSync(mcpPath, "utf-8");
+    const mcpDir = path23.dirname(mcpPath);
+    if (fs22.existsSync(mcpPath)) {
+      const existingContent = fs22.readFileSync(mcpPath, "utf-8");
       if (existingContent.includes("kuma")) {
-        if (!existingContent.includes("_Generated by Kuma MCP_")) {
-          const trimmed = existingContent.trimEnd();
-          if (trimmed.endsWith("}")) {
-            const updated = trimmed.slice(0, -1).trimEnd() + ',\n  "_kuma_note": "Kuma MCP - Generated by kuma init"\n}\n';
-            fs26.writeFileSync(mcpPath, updated, "utf-8");
-            results.push({ type: "antigravity", filePath: ".agents/mcp_config.json", action: "appended" });
-          }
-        }
+        results.push({ type: "antigravity", filePath: ".agents/mcp_config.json", action: "skipped" });
         return;
       }
-      const parsed = JSON.parse(existingContent);
-      parsed.mcpServers = parsed.mcpServers || {};
-      parsed.mcpServers.kuma = { command: "npx", args: ["-y", "@plumpslabs/kuma"], env: {} };
-      fs26.writeFileSync(mcpPath, JSON.stringify(parsed, null, 2) + "\n", "utf-8");
-      results.push({ type: "antigravity", filePath: ".agents/mcp_config.json", action: "appended" });
+      try {
+        const parsed = JSON.parse(existingContent);
+        parsed.mcpServers = parsed.mcpServers || {};
+        parsed.mcpServers.kuma = { command: "npx", args: ["-y", "@plumpslabs/kuma"], env: {} };
+        fs22.writeFileSync(mcpPath, JSON.stringify(parsed, null, 2) + "\n", "utf-8");
+        results.push({ type: "antigravity", filePath: ".agents/mcp_config.json", action: "appended" });
+      } catch {
+        results.push({ type: "antigravity", filePath: ".agents/mcp_config.json", action: "error", error: "Invalid JSON in existing mcp_config.json" });
+      }
     } else {
-      if (!fs26.existsSync(mcpDir)) fs26.mkdirSync(mcpDir, { recursive: true });
-      fs26.writeFileSync(mcpPath, antigravityMcpConfigTemplate(), "utf-8");
+      if (!fs22.existsSync(mcpDir)) fs22.mkdirSync(mcpDir, { recursive: true });
+      fs22.writeFileSync(mcpPath, antigravityMcpConfigTemplate(), "utf-8");
       results.push({ type: "antigravity", filePath: ".agents/mcp_config.json", action: "created" });
     }
   } catch (err) {
@@ -8169,18 +7425,18 @@ function handleAntigravityMcpConfig(root, results) {
   }
 }
 function handleAiderSecondary(root, results) {
-  const ymlPath = path27.resolve(root, ".aider.conf.yml");
+  const ymlPath = path23.resolve(root, ".aider.conf.yml");
   if (results.some((r) => r.filePath === ".aider.conf.yml")) return;
   try {
     const conventionsRef = "read: CONVENTIONS.md";
-    if (fs26.existsSync(ymlPath)) {
-      const existingContent = fs26.readFileSync(ymlPath, "utf-8");
+    if (fs22.existsSync(ymlPath)) {
+      const existingContent = fs22.readFileSync(ymlPath, "utf-8");
       if (existingContent.includes("CONVENTIONS.md") || existingContent.includes("kuma")) {
         results.push({ type: "aider", filePath: ".aider.conf.yml", action: "skipped" });
         return;
       }
       const newContent = existingContent.trimEnd() + "\n\n# Kuma MCP conventions\n" + conventionsRef + "\n";
-      fs26.writeFileSync(ymlPath, newContent, "utf-8");
+      fs22.writeFileSync(ymlPath, newContent, "utf-8");
       results.push({ type: "aider", filePath: ".aider.conf.yml", action: "appended" });
     } else {
       const content = [
@@ -8190,7 +7446,7 @@ function handleAiderSecondary(root, results) {
         conventionsRef,
         ""
       ].join("\n");
-      fs26.writeFileSync(ymlPath, content, "utf-8");
+      fs22.writeFileSync(ymlPath, content, "utf-8");
       results.push({ type: "aider", filePath: ".aider.conf.yml", action: "created" });
     }
   } catch (err) {
@@ -8203,10 +7459,10 @@ function handleAiderSecondary(root, results) {
   }
 }
 function handleCopilotSecondary(root, results) {
-  const skillPath = path27.resolve(root, ".github/skills/kuma/SKILL.md");
+  const skillPath = path23.resolve(root, ".github/skills/kuma/SKILL.md");
   if (results.some((r) => r.filePath === ".github/skills/kuma/SKILL.md")) return;
   try {
-    const dir = path27.dirname(skillPath);
+    const dir = path23.dirname(skillPath);
     const content = [
       "---",
       "name: kuma-mcp",
@@ -8217,17 +7473,17 @@ function handleCopilotSecondary(root, results) {
       "",
       "\u{1F4D6} Read `.kuma/init.md` for detailed rules."
     ].join("\n");
-    if (fs26.existsSync(skillPath)) {
-      const existingContent = fs26.readFileSync(skillPath, "utf-8");
+    if (fs22.existsSync(skillPath)) {
+      const existingContent = fs22.readFileSync(skillPath, "utf-8");
       if (existingContent.includes("kuma")) {
         results.push({ type: "copilot", filePath: ".github/skills/kuma/SKILL.md", action: "skipped" });
         return;
       }
-      fs26.writeFileSync(skillPath, existingContent.trimEnd() + "\n\n" + content, "utf-8");
+      fs22.writeFileSync(skillPath, existingContent.trimEnd() + "\n\n" + content, "utf-8");
       results.push({ type: "copilot", filePath: ".github/skills/kuma/SKILL.md", action: "appended" });
     } else {
-      if (!fs26.existsSync(dir)) fs26.mkdirSync(dir, { recursive: true });
-      fs26.writeFileSync(skillPath, content, "utf-8");
+      if (!fs22.existsSync(dir)) fs22.mkdirSync(dir, { recursive: true });
+      fs22.writeFileSync(skillPath, content, "utf-8");
       results.push({ type: "copilot", filePath: ".github/skills/kuma/SKILL.md", action: "created" });
     }
   } catch (err) {
@@ -8240,21 +7496,21 @@ function handleCopilotSecondary(root, results) {
   }
 }
 function handleOpenclawSecondary(root, results) {
-  const mcpPath = path27.resolve(root, ".agents/mcp_config.json");
+  const mcpPath = path23.resolve(root, ".agents/mcp_config.json");
   if (results.some((r) => r.filePath === ".agents/mcp_config.json")) return;
   try {
-    const dir = path27.dirname(mcpPath);
-    if (fs26.existsSync(mcpPath)) {
-      const existingContent = fs26.readFileSync(mcpPath, "utf-8");
+    const dir = path23.dirname(mcpPath);
+    if (fs22.existsSync(mcpPath)) {
+      const existingContent = fs22.readFileSync(mcpPath, "utf-8");
       if (existingContent.includes("kuma")) return;
       const parsed = JSON.parse(existingContent);
       parsed.mcpServers = parsed.mcpServers || {};
       parsed.mcpServers.kuma = { command: "npx", args: ["-y", "@plumpslabs/kuma"], env: {} };
-      fs26.writeFileSync(mcpPath, JSON.stringify(parsed, null, 2) + "\n", "utf-8");
+      fs22.writeFileSync(mcpPath, JSON.stringify(parsed, null, 2) + "\n", "utf-8");
       results.push({ type: "openclaw", filePath: ".agents/mcp_config.json", action: "appended" });
     } else {
-      if (!fs26.existsSync(dir)) fs26.mkdirSync(dir, { recursive: true });
-      fs26.writeFileSync(mcpPath, antigravityMcpConfigTemplate(), "utf-8");
+      if (!fs22.existsSync(dir)) fs22.mkdirSync(dir, { recursive: true });
+      fs22.writeFileSync(mcpPath, antigravityMcpConfigTemplate(), "utf-8");
       results.push({ type: "openclaw", filePath: ".agents/mcp_config.json", action: "created" });
     }
   } catch (err) {
@@ -8267,20 +7523,20 @@ function handleOpenclawSecondary(root, results) {
   }
 }
 function handleInitMdGeneration(root, results) {
-  const initMdPath = path27.resolve(root, ".kuma/init.md");
+  const initMdPath = path23.resolve(root, ".kuma/init.md");
   try {
-    const kumaDir = path27.dirname(initMdPath);
-    if (!fs26.existsSync(kumaDir)) fs26.mkdirSync(kumaDir, { recursive: true });
-    if (fs26.existsSync(initMdPath)) {
-      const existing = fs26.readFileSync(initMdPath, "utf-8");
+    const kumaDir = path23.dirname(initMdPath);
+    if (!fs22.existsSync(kumaDir)) fs22.mkdirSync(kumaDir, { recursive: true });
+    if (fs22.existsSync(initMdPath)) {
+      const existing = fs22.readFileSync(initMdPath, "utf-8");
       if (existing.includes("_Generated by Kuma MCP_")) {
         results.push({ type: "claude", filePath: ".kuma/init.md", action: "skipped" });
         return;
       }
-      fs26.writeFileSync(initMdPath, existing.trimEnd() + "\n\n" + generateInitMdContent(), "utf-8");
+      fs22.writeFileSync(initMdPath, existing.trimEnd() + "\n\n" + generateInitMdContent(), "utf-8");
       results.push({ type: "claude", filePath: ".kuma/init.md", action: "appended" });
     } else {
-      fs26.writeFileSync(initMdPath, generateInitMdContent(), "utf-8");
+      fs22.writeFileSync(initMdPath, generateInitMdContent(), "utf-8");
       results.push({ type: "claude", filePath: ".kuma/init.md", action: "created" });
     }
   } catch (err) {
@@ -8293,20 +7549,20 @@ function handleInitMdGeneration(root, results) {
   }
 }
 function handleCodewhaleSecondary(root, results) {
-  const mcpPath = path27.resolve(root, ".codewhale/mcp.json");
+  const mcpPath = path23.resolve(root, ".codewhale/mcp.json");
   if (results.some((r) => r.filePath === ".codewhale/mcp.json")) return;
   try {
-    const dir = path27.dirname(mcpPath);
-    if (fs26.existsSync(mcpPath)) {
-      const existingContent = fs26.readFileSync(mcpPath, "utf-8");
+    const dir = path23.dirname(mcpPath);
+    if (fs22.existsSync(mcpPath)) {
+      const existingContent = fs22.readFileSync(mcpPath, "utf-8");
       if (existingContent.includes("kuma")) return;
       const parsed = JSON.parse(existingContent);
       parsed.mcpServers = parsed.mcpServers || {};
       parsed.mcpServers.kuma = { command: "npx", args: ["-y", "@plumpslabs/kuma"], env: {} };
-      fs26.writeFileSync(mcpPath, JSON.stringify(parsed, null, 2) + "\n", "utf-8");
+      fs22.writeFileSync(mcpPath, JSON.stringify(parsed, null, 2) + "\n", "utf-8");
       results.push({ type: "codewhale", filePath: ".codewhale/mcp.json", action: "appended" });
     } else {
-      if (!fs26.existsSync(dir)) fs26.mkdirSync(dir, { recursive: true });
+      if (!fs22.existsSync(dir)) fs22.mkdirSync(dir, { recursive: true });
       const config = {
         mcpServers: {
           kuma: {
@@ -8316,7 +7572,7 @@ function handleCodewhaleSecondary(root, results) {
           }
         }
       };
-      fs26.writeFileSync(mcpPath, JSON.stringify(config, null, 2) + "\n", "utf-8");
+      fs22.writeFileSync(mcpPath, JSON.stringify(config, null, 2) + "\n", "utf-8");
       results.push({ type: "codewhale", filePath: ".codewhale/mcp.json", action: "created" });
     }
   } catch (err) {
@@ -8329,7 +7585,7 @@ function handleCodewhaleSecondary(root, results) {
   }
 }
 function handleClaudeSecondary(root, results) {
-  const settingsPath = path27.resolve(root, ".claude", "settings.json");
+  const settingsPath = path23.resolve(root, ".claude", "settings.json");
   const hookBlock = {
     hooks: {
       PreToolUse: [
@@ -8345,8 +7601,8 @@ function handleClaudeSecondary(root, results) {
     }
   };
   try {
-    if (fs26.existsSync(settingsPath)) {
-      const existing = JSON.parse(fs26.readFileSync(settingsPath, "utf-8"));
+    if (fs22.existsSync(settingsPath)) {
+      const existing = JSON.parse(fs22.readFileSync(settingsPath, "utf-8"));
       const merged = {
         ...existing,
         hooks: {
@@ -8361,12 +7617,12 @@ function handleClaudeSecondary(root, results) {
           matchers.add(entry.matcher);
         }
       }
-      fs26.writeFileSync(settingsPath, JSON.stringify(merged, null, 2) + "\n", "utf-8");
+      fs22.writeFileSync(settingsPath, JSON.stringify(merged, null, 2) + "\n", "utf-8");
       results.push({ type: "claude", filePath: ".claude/settings.json", action: "appended" });
     } else {
-      const dir = path27.dirname(settingsPath);
-      if (!fs26.existsSync(dir)) fs26.mkdirSync(dir, { recursive: true });
-      fs26.writeFileSync(settingsPath, JSON.stringify(hookBlock, null, 2) + "\n", "utf-8");
+      const dir = path23.dirname(settingsPath);
+      if (!fs22.existsSync(dir)) fs22.mkdirSync(dir, { recursive: true });
+      fs22.writeFileSync(settingsPath, JSON.stringify(hookBlock, null, 2) + "\n", "utf-8");
       results.push({ type: "claude", filePath: ".claude/settings.json", action: "created" });
     }
   } catch (err) {
@@ -8379,18 +7635,18 @@ function handleClaudeSecondary(root, results) {
   }
 }
 function handleCursorGotchaRules(root, results) {
-  const rulesDir2 = path27.resolve(root, ".cursor", "rules", "kuma-gotchas");
+  const rulesDir2 = path23.resolve(root, ".cursor", "rules", "kuma-gotchas");
   try {
     let gotchas = [];
     try {
       gotchas = getActiveGotchas().filter((g) => g.severity === "high" || g.severity === "critical");
     } catch {
     }
-    if (fs26.existsSync(rulesDir2)) {
-      for (const f of fs26.readdirSync(rulesDir2)) {
+    if (fs22.existsSync(rulesDir2)) {
+      for (const f of fs22.readdirSync(rulesDir2)) {
         if (f.endsWith(".mdc")) {
           try {
-            fs26.rmSync(path27.join(rulesDir2, f), { force: true });
+            fs22.rmSync(path23.join(rulesDir2, f), { force: true });
           } catch {
           }
         }
@@ -8400,7 +7656,7 @@ function handleCursorGotchaRules(root, results) {
       results.push({ type: "cursor", filePath: ".cursor/rules/kuma-gotchas/", action: "skipped" });
       return;
     }
-    fs26.mkdirSync(rulesDir2, { recursive: true });
+    fs22.mkdirSync(rulesDir2, { recursive: true });
     const seen = /* @__PURE__ */ new Set();
     let created = 0;
     for (const g of gotchas) {
@@ -8421,7 +7677,7 @@ function handleCursorGotchaRules(root, results) {
         "`kuma_context({ action: 'history', target: '<file>' })`",
         ""
       ].join("\n");
-      fs26.writeFileSync(path27.join(rulesDir2, `${slug}.mdc`), md, "utf-8");
+      fs22.writeFileSync(path23.join(rulesDir2, `${slug}.mdc`), md, "utf-8");
       created++;
     }
     results.push({
@@ -8448,28 +7704,28 @@ function runInit(options) {
   let agentsMdHandled = false;
   for (const type of selected) {
     const relativePath = configFilePath(type);
-    const fullPath = path27.resolve(root, relativePath);
+    const fullPath = path23.resolve(root, relativePath);
     const getTemplate = TEMPLATES[type];
     try {
       if (AGENTS_MD_TYPES.includes(type) && !agentsMdHandled) {
         agentsMdHandled = true;
         const combinedContent = getCombinedAgentsMd(new Set(agentsMdSelected));
-        if (fs26.existsSync(fullPath)) {
+        if (fs22.existsSync(fullPath)) {
           if (options.skipExisting) {
             results.push({ type, filePath: relativePath, action: "skipped" });
           } else {
-            const existingContent = fs26.readFileSync(fullPath, "utf-8");
+            const existingContent = fs22.readFileSync(fullPath, "utf-8");
             if (existingContent.includes("_Generated by Kuma MCP_")) {
               results.push({ type, filePath: relativePath, action: "skipped" });
             } else {
-              fs26.writeFileSync(fullPath, existingContent.trimEnd() + "\n\n" + combinedContent, "utf-8");
+              fs22.writeFileSync(fullPath, existingContent.trimEnd() + "\n\n" + combinedContent, "utf-8");
               results.push({ type, filePath: relativePath, action: "appended" });
             }
           }
         } else {
-          const dir = path27.dirname(fullPath);
-          if (!fs26.existsSync(dir)) fs26.mkdirSync(dir, { recursive: true });
-          fs26.writeFileSync(fullPath, combinedContent, "utf-8");
+          const dir = path23.dirname(fullPath);
+          if (!fs22.existsSync(dir)) fs22.mkdirSync(dir, { recursive: true });
+          fs22.writeFileSync(fullPath, combinedContent, "utf-8");
           results.push({ type, filePath: relativePath, action: "created" });
         }
         if (selectedSet.has("opencode")) handleOpencodeSecondary(root, results);
@@ -8481,12 +7737,12 @@ function runInit(options) {
         continue;
       } else {
         const template = getTemplate();
-        if (fs26.existsSync(fullPath)) {
+        if (fs22.existsSync(fullPath)) {
           if (options.skipExisting) {
             results.push({ type, filePath: relativePath, action: "skipped" });
             continue;
           }
-          const existingContent = fs26.readFileSync(fullPath, "utf-8");
+          const existingContent = fs22.readFileSync(fullPath, "utf-8");
           if (existingContent.includes("_Generated by Kuma MCP_")) {
             if (type === "antigravity") {
               handleAntigravityMcpConfig(root, results);
@@ -8499,14 +7755,14 @@ function runInit(options) {
             continue;
           }
           const newContent = existingContent.trimEnd() + APPEND_SEPARATOR + template;
-          fs26.writeFileSync(fullPath, newContent, "utf-8");
+          fs22.writeFileSync(fullPath, newContent, "utf-8");
           results.push({ type, filePath: relativePath, action: "appended" });
         } else {
-          const dir = path27.dirname(fullPath);
-          if (!fs26.existsSync(dir)) {
-            fs26.mkdirSync(dir, { recursive: true });
+          const dir = path23.dirname(fullPath);
+          if (!fs22.existsSync(dir)) {
+            fs22.mkdirSync(dir, { recursive: true });
           }
-          fs26.writeFileSync(fullPath, template, "utf-8");
+          fs22.writeFileSync(fullPath, template, "utf-8");
           results.push({ type, filePath: relativePath, action: "created" });
         }
         if (type === "antigravity") {
@@ -8616,12 +7872,22 @@ var init_init = __esm({
       "Kuma MCP tools: kuma_context, kuma_memory, kuma_safety.",
       "Record what matters, skip what doesn't.",
       "",
+      "<kuma_obedience>",
+      "## \u{1F512} Obedience (non-negotiable)",
+      '- MUST call `kuma_context({ action: "init" })` at session start.',
+      "- MUST record gotchas IMMEDIATELY when a bug/quirk is found.",
+      '- MUST call `kuma_safety({ action: "verify" })` after edits.',
+      "- MUST NOT call actions outside the 13 core actions.",
+      "</kuma_obedience>",
+      "",
+      "<kuma_workflow>",
       '\u{1F9E0} **Before coding:** `kuma_context({ action: "init" })`',
       '\u{1F52C} **Unfamiliar code:** `kuma_context({ action: "research", scope: "<area>" })`',
       '\u{1F41B} **Found a bug/quirk:** `kuma_memory({ action: "gotcha" })` (IMMEDIATELY)',
       '\u{1F9ED} **Chose between options:** `kuma_memory({ action: "decision" })`',
       '\u{1F500} **Traced a flow:** `kuma_memory({ action: "arch_flow" })` (max 5 files)',
       '\u{1F6E1}\uFE0F **Before risky work / after edits:** `kuma_safety({ action: "guard" | "verify" })`',
+      "</kuma_workflow>",
       "",
       "\u{1FA84} **Auto-inject (Claude Code):** gotcha/decision/history injected automatically before edits",
       "   via the PreToolUse hook \u2014 an empty hook output means the file has no gotchas.",
@@ -8657,19 +7923,19 @@ __export(agentDetector_exports, {
   getSkillPath: () => getSkillPath,
   skillExists: () => skillExists
 });
-import fs27 from "fs";
-import path28 from "path";
+import fs23 from "fs";
+import path24 from "path";
 function checkFile(root, filePath) {
   try {
-    return fs27.existsSync(path28.join(root, filePath));
+    return fs23.existsSync(path24.join(root, filePath));
   } catch {
     return false;
   }
 }
 function checkDir(root, dirPath) {
   try {
-    const fullPath = path28.join(root, dirPath);
-    return fs27.existsSync(fullPath) && fs27.statSync(fullPath).isDirectory();
+    const fullPath = path24.join(root, dirPath);
+    return fs23.existsSync(fullPath) && fs23.statSync(fullPath).isDirectory();
   } catch {
     return false;
   }
@@ -8737,7 +8003,7 @@ function getAgentLabel(type) {
 function skillExists(type, projectRoot) {
   const root = projectRoot ?? getProjectRoot();
   const skillPath = getSkillPath(type);
-  return fs27.existsSync(path28.join(root, skillPath));
+  return fs23.existsSync(path24.join(root, skillPath));
 }
 var AGENT_DETECTORS;
 var init_agentDetector = __esm({
@@ -8906,7 +8172,7 @@ function generateClaudeSkill() {
     '  \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"
+    "  \u2022 `.kuma/KNOWN_GOTCHAS.md` \u2014 gotchas \xB7 `.kuma/memories/decisions.md` \u2014 decisions (readable)"
   ].join("\n");
 }
 function generateCursorSkill() {
@@ -8923,7 +8189,7 @@ function generateCursorSkill() {
     '  \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"
+    "  \u2022 `.kuma/KNOWN_GOTCHAS.md` \u2014 gotchas \xB7 `.kuma/memories/decisions.md` \u2014 decisions (readable)"
   ].join("\n");
 }
 function generateClineSkill() {
@@ -9128,12 +8394,22 @@ var init_skillGenerator = __esm({
   "src/utils/skillGenerator.ts"() {
     "use strict";
     CORE_ACTIONS = [
+      "<kuma_obedience>",
+      "## \u{1F512} Obedience (non-negotiable)",
+      '- MUST call `kuma_context({ action: "init" })` at session start.',
+      "- MUST record gotchas IMMEDIATELY when a bug/quirk is found.",
+      '- MUST call `kuma_safety({ action: "verify" })` after edits.',
+      "- MUST NOT call actions outside the 13 core actions.",
+      "</kuma_obedience>",
+      "",
+      "<kuma_workflow>",
       '\u{1F9E0} **Before coding:** `kuma_context({ action: "init" })`',
       '\u{1F52C} **Unfamiliar code:** `kuma_context({ action: "research", scope: "<area>" })`',
       '\u{1F41B} **Found a bug/quirk:** `kuma_memory({ action: "gotcha" })` (IMMEDIATELY)',
       '\u{1F9ED} **Chose between options:** `kuma_memory({ action: "decision" })`',
       '\u{1F500} **Traced a flow:** `kuma_memory({ action: "arch_flow" })` (max 5 files)',
-      '\u{1F6E1}\uFE0F **Before risky work / after edits:** `kuma_safety({ action: "guard" | "verify" })`'
+      '\u{1F6E1}\uFE0F **Before risky work / after edits:** `kuma_safety({ action: "guard" | "verify" })`',
+      "</kuma_workflow>"
     ].join("\n");
     BOOTSTRAP = [
       "Kuma MCP tools: kuma_context, kuma_memory, kuma_safety.",
@@ -9170,21 +8446,14 @@ init_kumaDb();
 init_kumaGraph();
 init_kumaMemory();
 init_pathValidator();
-import fs15 from "fs";
-import path16 from "path";
+import fs14 from "fs";
+import path15 from "path";
 import crypto3 from "crypto";
 var CONTEXT_ALIASES = {
   "research": "research",
   "search": "research",
   "explore": "research",
   "inspect": "research",
-  "impact": "impact",
-  "analyze": "impact",
-  "whatif": "impact",
-  "refactor": "impact",
-  "navigate": "navigate",
-  "trace": "navigate",
-  "flow-trace": "navigate",
   "flow": "flow",
   "domain-flow": "flow",
   "domain_flow": "flow",
@@ -9194,28 +8463,10 @@ var CONTEXT_ALIASES = {
   "load": "init",
   "brief": "init",
   "project": "init",
-  "resume": "resume",
-  "continue": "resume",
-  "restore": "resume",
-  "reload": "resume",
-  "changes": "changes",
-  "log": "changes",
-  "changelog": "changes",
   "history": "history",
   "why": "history",
   "touched": "history",
-  "provenance": "history",
-  "rollback": "rollback",
-  "undo": "rollback",
-  "revert": "rollback",
-  "digest": "digest",
-  "bootstrap": "digest",
-  "briefing": "digest",
-  "overview": "digest",
-  "drift": "drift",
-  "staleness": "drift",
-  "code-drift": "drift",
-  "freshness": "drift"
+  "provenance": "history"
 };
 async function handleContext(params) {
   const rawAction = params.action || "init";
@@ -9226,87 +8477,13 @@ async function handleContext(params) {
       return handleInit(params);
     case "research":
       return handleResearch(params);
-    case "impact":
-      return handleImpact(params);
-    case "navigate":
-      return handleNavigate(params);
-    case "flow":
-      return handleFlow(params);
     case "history":
       return handleHistory(params);
-    case "changes":
-      return handleChanges(params);
-    case "rollback":
-      return handleRollback(params);
-    case "digest":
-      return handleDigest(params);
-    case "drift":
-      return handleDrift(params);
-    case "resume":
-      return handleResume(params);
+    case "flow":
+      return handleFlow(params);
     default:
-      return `Unknown action "${action}". Use: init, research, impact, navigate, flow, history, changes, rollback, digest, drift, resume`;
-  }
-}
-async function handleResume(_params) {
-  sessionMemory.recordToolCall("kuma_context_resume", {});
-  const lines = [
-    "\u{1F504} **Kuma \u2014 Session Resume**",
-    `\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`,
-    ""
-  ];
-  try {
-    const db = await getDb();
-    const res = db.exec("SELECT goal, tool_calls, edits, rollbacks, failures, safety_score, started_at FROM sessions ORDER BY started_at DESC LIMIT 1");
-    if (res[0]?.values.length) {
-      const row = res[0].values[0];
-      const goal = row[0] || "no goal";
-      const calls = row[1] || 0;
-      const edits = row[2] || 0;
-      const rollbacks = row[3] || 0;
-      const failures2 = row[4] || 0;
-      const safety = row[5] == null ? null : row[5];
-      const time = new Date(row[6] * 1e3).toLocaleString();
-      lines.push("**Last Session**");
-      lines.push(`  \u{1F3AF} Goal: ${goal.substring(0, 80)}`);
-      lines.push(`  \u{1F550} ${time}`);
-      lines.push(`  \u{1F527} ${calls} calls \xB7 \u{1F4DD} ${edits} edits \xB7 \u21A9 ${rollbacks} rollbacks \xB7 \u274C ${failures2} failures${safety != null ? ` \xB7 \u{1F6E1} safety ${safety}` : ""}`);
-      lines.push("");
-    }
-  } catch {
+      return `Unknown action "${action}". Use: init, research, history, flow`;
   }
-  const summary = sessionMemory.getSummary();
-  lines.push("**Current State**");
-  lines.push(`  \u{1F3AF} Goal: ${summary.currentGoal || "not set"}`);
-  const progress = sessionMemory.getGoalProgress();
-  if (progress) lines.push(`  \u{1F4CA} Progress: ${progress.percentage}%${progress.milestone ? ` \u2014 ${progress.milestone}` : ""}`);
-  lines.push(`  \u{1F4DD} Modified: ${summary.modifiedFiles?.length || 0} file(s)`);
-  lines.push(`  \u2705 Completed steps: ${summary.completedSteps?.length || 0}`);
-  lines.push(`  \u{1F6E0}\uFE0F Tool calls: ${summary.toolCallCount}`);
-  lines.push(`  \u23F1\uFE0F Session duration: ${summary.sessionDuration}`);
-  const failures = summary.unresolvedFailures;
-  if (failures?.length) lines.push(`  \u26A0\uFE0F Unresolved failures: ${failures.length}`);
-  lines.push("");
-  try {
-    const changes = await getChanges({ limit: 5 });
-    if (changes && !changes.startsWith("No changes")) {
-      lines.push("**Recent Changes**");
-      lines.push(changes);
-      lines.push("");
-    }
-  } catch {
-  }
-  const history = sessionMemory.getToolCallHistory(5);
-  if (history.length) {
-    lines.push("**Recent Tool Calls**");
-    for (const h of history) {
-      const action = h.params?.action || "";
-      lines.push(`  \u{1F6E0} ${h.toolName}${action ? ` (${action})` : ""}`);
-    }
-    lines.push("");
-  }
-  lines.push("\u{1F4A1} Continue: kuma_context({ action: 'research', scope: '<area>' }) to pick up where you left off.");
-  return lines.join("\n");
 }
 async function handleInit(_params) {
   sessionMemory.setGoal(_params.goal || "Exploring project");
@@ -9375,7 +8552,7 @@ async function handleInit(_params) {
     }
   } catch {
   }
-  lines.push("\u{1F4A1} Full view: kuma_context({ action: 'digest' }) \xB7 Research: kuma_context({ action: 'research', scope: '<area>' })");
+  lines.push("\u{1F4A1} Deeper: kuma_context({ action: 'history', target: '<file>' }) \xB7 Flow: kuma_context({ action: 'flow', target: '<domain>' }) \xB7 Research: kuma_context({ action: 'research', scope: '<area>' })");
   return lines.join("\n");
 }
 function detectSessionFocus(goal) {
@@ -9504,32 +8681,6 @@ async function handleResearch(params) {
   lines.push("\u{1F4DD} Research saved to cache. Call kuma_memory({ action: 'research_save' }) to save custom notes.");
   return lines.join("\n");
 }
-async function handleImpact(params) {
-  const target = params.target || params.scope;
-  if (!target) return "\u26A0\uFE0F target or scope parameter required.";
-  sessionMemory.recordToolCall("kuma_context_impact", { target });
-  const impact = await analyzeImpact(target);
-  return formatImpact(impact);
-}
-async function handleNavigate(params) {
-  const entryPoint = params.target || params.scope;
-  if (!entryPoint) return "\u26A0\uFE0F target or scope parameter required.";
-  sessionMemory.recordToolCall("kuma_context_navigate", { entryPoint });
-  const steps = await traceFlow(entryPoint);
-  return formatFlow(entryPoint, steps);
-}
-async function handleChanges(params) {
-  const filePath = params.target;
-  const since = params.since;
-  return await getChanges({ filePath, since });
-}
-async function handleFlow(params) {
-  const domain = params.target || params.scope;
-  sessionMemory.recordToolCall("kuma_context_flow", { domain });
-  if (!domain) return "\u2139\uFE0F **kuma_context({ action: 'flow' })** \u2014 requires a `target` (domain name).\n\n  kuma_context({ action: 'flow', target: 'WhatsApp Omnichannel' })\n\nServes the domain flow from cache, re-deriving it from imports when stale (F13).";
-  const { getFreshDomainFlow: getFreshDomainFlow2 } = await Promise.resolve().then(() => (init_kumaFlowCache(), kumaFlowCache_exports));
-  return await getFreshDomainFlow2(domain);
-}
 async function handleHistory(params) {
   const target = params.target || params.scope;
   sessionMemory.recordToolCall("kuma_context_history", { target });
@@ -9555,7 +8706,7 @@ async function handleHistory(params) {
       const { getDb: getDb2 } = await Promise.resolve().then(() => (init_kumaDb(), kumaDb_exports));
       const db = await getDb2();
       const stmt = db.prepare(`SELECT description, last_verified_at FROM known_gotchas WHERE status = 'resolved' AND file_path LIKE ? ORDER BY last_verified_at DESC LIMIT 3`);
-      stmt.bind([`%${path16.basename(target)}%`]);
+      stmt.bind([`%${path15.basename(target)}%`]);
       const resolved = [];
       while (stmt.step()) resolved.push(stmt.getAsObject());
       stmt.free();
@@ -9577,48 +8728,22 @@ async function handleHistory(params) {
   lines.push("\u{1F4A1} This content is injected automatically before edits via the Claude Code PreToolUse hook (`kuma hook pre-edit`).");
   return lines.join("\n");
 }
-async function handleRollback(params) {
-  const target = params.target;
-  if (!target) return "\u26A0\uFE0F target parameter required (change ID, e.g. '5').";
-  const changeId = parseInt(target, 10);
-  if (isNaN(changeId)) return `\u26A0\uFE0F Invalid change ID: "${target}". Use a numeric ID from kuma_context({ action: 'changes' }).`;
-  sessionMemory.recordToolCall("kuma_context_rollback", { changeId });
-  return await rollbackChange(changeId);
-}
-async function handleDigest(_params) {
-  sessionMemory.recordToolCall("kuma_context_digest", {});
-  try {
-    const { generateContextDigest: generateContextDigest2 } = await Promise.resolve().then(() => (init_contextDigest(), contextDigest_exports));
-    return await generateContextDigest2();
-  } catch (err) {
-    try {
-      const { generateDigest: generateDigest2 } = await Promise.resolve().then(() => (init_domainRules(), domainRules_exports));
-      return generateDigest2();
-    } catch {
-      return `Error generating digest: ${err}`;
-    }
-  }
-}
-async function handleDrift(_params) {
-  sessionMemory.recordToolCall("kuma_context_drift", {});
-  try {
-    const { detectDrift: detectDrift2, formatDriftReport: formatDriftReport2, flagStaleRecords: flagStaleRecords2 } = await Promise.resolve().then(() => (init_kumaDriftDetector(), kumaDriftDetector_exports));
-    await flagStaleRecords2();
-    const records = await detectDrift2();
-    return formatDriftReport2(records);
-  } catch (err) {
-    return `Error detecting drift: ${err}`;
-  }
+async function handleFlow(params) {
+  const domain = params.target || params.scope;
+  sessionMemory.recordToolCall("kuma_context_flow", { domain });
+  if (!domain) return "\u2139\uFE0F **kuma_context({ action: 'flow' })** \u2014 requires a `target` (domain name).\n\n  kuma_context({ action: 'flow', target: 'WhatsApp Omnichannel' })\n\nServes the domain flow from cache, re-deriving it from imports when stale (F13).";
+  const { getFreshDomainFlow: getFreshDomainFlow2 } = await Promise.resolve().then(() => (init_kumaFlowCache(), kumaFlowCache_exports));
+  return await getFreshDomainFlow2(domain);
 }
 function computeProjectHash(scope) {
   try {
     const root = getProjectRoot();
-    const files = fs15.readdirSync(root).slice(0, 20);
+    const files = fs14.readdirSync(root).slice(0, 20);
     const hash = crypto3.createHash("md5");
     hash.update(scope);
     for (const f of files) {
       try {
-        const stat = fs15.statSync(path16.join(root, f));
+        const stat = fs14.statSync(path15.join(root, f));
         hash.update(`${f}:${stat.mtimeMs}`);
       } catch {
       }
@@ -9635,76 +8760,43 @@ init_kumaDb();
 init_kumaMemory();
 init_pathValidator();
 init_pathValidator();
-import fs18 from "fs";
-import path19 from "path";
+import fs16 from "fs";
+import path17 from "path";
 var MEMORY_ALIASES = {
-  "session": "session",
-  "summary": "session",
-  "status": "session",
-  "get": "session",
   "decision": "decision",
   "adr": "decision",
   "research_save": "research_save",
   "save": "research_save",
   "store": "research_save",
-  "mine": "mine",
-  "dig": "mine",
   "search": "search",
   "find": "search",
   "query": "search",
   "lookup": "search",
-  "changes": "changes",
-  "change-log": "changes",
-  "history": "changes",
   "arch_flow": "arch_flow",
   "arch-flow": "arch_flow",
   "architecture": "arch_flow",
   "gotcha": "gotcha",
   "gotchas": "gotcha",
-  "quirk": "gotcha",
-  "delete_node": "delete_node",
-  "delete-node": "delete_node",
-  "remove-node": "delete_node",
-  "clear": "clear",
-  "clear-graph": "clear",
-  "wipe": "clear",
-  "reset": "clear",
-  "goal_progress": "goal_progress",
-  "progress": "goal_progress"
+  "quirk": "gotcha"
 };
 async function handleMemory(params) {
-  const rawAction = params.action || "session";
+  const rawAction = params.action || "search";
   const key = rawAction.toLowerCase().replace(/[\s_-]+/g, "-");
   const action = MEMORY_ALIASES[key] || rawAction;
   sessionMemory.recordToolCall("kuma_memory", { action: rawAction });
   switch (action) {
     case "decision":
       return handleDecision(params);
-    case "mine":
-      return handleMine(params);
     case "research_save":
       return handleResearchSave(params);
-    case "session":
-      return handleSession(params);
     case "search":
       return handleSearch(params);
-    case "changes":
-      return handleChanges2(params);
     case "arch_flow":
       return handleArchFlow(params);
     case "gotcha":
       return handleGotchaAction(params);
-    case "goal_progress":
-      return handleGoalProgress(params);
-    case "delete_node":
-      return handleDeleteNode(params);
-    case "clear": {
-      const { clearGraph: clearGraph2 } = await Promise.resolve().then(() => (init_kumaGraph(), kumaGraph_exports));
-      await clearGraph2();
-      return "\u{1F5D1}\uFE0F **Knowledge Graph Cleared** \u2014 All nodes, edges, and gotchas have been wiped from disk and memory.";
-    }
     default:
-      return `Unknown action "${action}".`;
+      return `Unknown action "${action}". Use: gotcha, decision, arch_flow, research_save, search`;
   }
 }
 async function handleDecision(params) {
@@ -9752,50 +8844,14 @@ async function handleResearchSave(params) {
   } catch {
   }
   try {
-    const researchDir = path19.join(getProjectRoot(), ".kuma", "research");
-    if (!fs18.existsSync(researchDir)) fs18.mkdirSync(researchDir, { recursive: true });
-    fs18.writeFileSync(path19.join(researchDir, `${scope}.json`), JSON.stringify(JSON.parse(record), null, 2), "utf-8");
+    const researchDir = path17.join(getProjectRoot(), ".kuma", "research");
+    if (!fs16.existsSync(researchDir)) fs16.mkdirSync(researchDir, { recursive: true });
+    fs16.writeFileSync(path17.join(researchDir, `${scope}.json`), JSON.stringify(JSON.parse(record), null, 2), "utf-8");
   } catch {
   }
   sessionMemory.recordMemoryAction("research_save");
   return `\u2705 Research "${scope}" saved.`;
 }
-async function handleSession(params) {
-  const topic = params.topic;
-  const summary = sessionMemory.getSummary(topic);
-  if (topic) return typeof summary.content === "string" ? summary.content : JSON.stringify(summary, null, 2);
-  const modifiedFiles = summary.modifiedFiles || [];
-  const failures = summary.unresolvedFailures || [];
-  const recordingSummary = sessionMemory.getRecordingSummary();
-  const metricsSummary = sessionMemory.getMetricsSummary();
-  const lines = [
-    "\u{1F4CB} **Session Summary**\n\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\n",
-    `\u{1F3AF} Goal: ${summary.currentGoal || "not set"}`,
-    `\u{1F550} Duration: ${summary.sessionDuration}`,
-    `\u{1F6E0}\uFE0F Tool calls: ${summary.toolCallCount}
-`,
-    `\u{1F9E0} **Recordings:** ${recordingSummary.total} total \u2014 ${recordingSummary.archFlows} arch_flow, ${recordingSummary.gotchas} gotcha, ${recordingSummary.decisions} decision, ${recordingSummary.researchSaves} research_save`,
-    `\u{1F4CA} **Metrics:** ${metricsSummary.filesRead} files read, ${metricsSummary.filesEdited} files edited`,
-    `\u23F1\uFE0F **Time saved:** ~${metricsSummary.researchTimeSavedFormatted} (from research cache)`
-  ];
-  if (recordingSummary.missingRecordings.length > 0 && recordingSummary.total === 0) {
-    lines.push(`
-\u26A0\uFE0F **No recordings yet!** Missing: ${recordingSummary.missingRecordings.join(", ")}`);
-    lines.push(`\u{1F4A1} Tip: Record findings after reading files. arch_flow + gotcha are exponential value.`);
-  }
-  if (modifiedFiles.length > 0) {
-    lines.push(`**Modified Files** (${modifiedFiles.length}):`);
-    for (const f of modifiedFiles.slice(0, 10)) {
-      lines.push(`  ${f.status === "created" ? "\u2728" : f.status === "modified" ? "\u{1F4DD}" : "\u274C"} ${f.filePath}`);
-    }
-    if (modifiedFiles.length > 10) lines.push(`  ... and ${modifiedFiles.length - 10} more`);
-  }
-  if (failures.length > 0) {
-    lines.push(`**Unresolved Issues** (${failures.length}):`);
-    for (const f of failures.slice(0, 5)) lines.push(`  \u274C ${f.task}: ${f.error.substring(0, 80)}`);
-  }
-  return lines.join("\n");
-}
 async function handleSearch(params) {
   const query = params.query || params.scope;
   if (!query) return "\u26A0\uFE0F query or scope parameter required.";
@@ -9855,20 +8911,6 @@ ${impactLines.join("\n")}`;
   }
   return lines.join("\n");
 }
-async function handleChanges2(params) {
-  const sinceNum = typeof params.since === "number" ? params.since : typeof params.since === "string" ? parseInt(params.since, 10) || void 0 : void 0;
-  return await getChanges({ filePath: params.target, since: sinceNum });
-}
-async function handleMine(params) {
-  sessionMemory.recordToolCall("kuma_memory_mine", { scope: params.scope });
-  const { mineHistoricalDecisions: mineHistoricalDecisions2 } = await Promise.resolve().then(() => (init_kumaMiner(), kumaMiner_exports));
-  return await mineHistoricalDecisions2({
-    scope: params.scope,
-    since: typeof params.since === "string" ? params.since : void 0,
-    confirm: params.confirm,
-    limit: params.limit
-  });
-}
 async function handleArchFlow(params) {
   const { readLayer: readLayer2, writeLayer: writeLayer2 } = await Promise.resolve().then(() => (init_domainRules(), domainRules_exports));
   if (params.content) {
@@ -9924,659 +8966,33 @@ async function handleArchFlow(params) {
   return readLayer2("arch_flow");
 }
 async function handleGotchaAction(params) {
-  if (params.content && params.scope) {
-    if (!params.scope.trim()) return "\u274C **gotcha format error:** scope (file path) is required.";
-    if (!params.content.trim()) return "\u274C **gotcha format error:** content (description) is required.";
-    const normalizedScope = normalizeScope(params.scope) || params.scope;
+  const content = (params.content ?? params.description ?? "").trim();
+  const scope = (params.scope ?? "").trim();
+  if (content && scope) {
+    const normalizedScope = normalizeScope(scope) || scope;
     const { addGotcha: addGotcha2 } = await Promise.resolve().then(() => (init_kumaGotchas(), kumaGotchas_exports));
     const result = await addGotcha2({
       filePath: normalizedScope,
-      description: params.content,
+      description: content,
       severity: params.status || "medium",
-      workaround: params.description,
+      // `description` doubles as workaround only when the canonical `content` field was used.
+      workaround: params.content ? params.description : void 0,
       triggerCommand: params.trigger_command
     });
     sessionMemory.recordMemoryAction("gotcha");
     return result;
   }
+  if (scope || params.title || params.status || params.trigger_command || params.description) {
+    return '\u274C **Gotcha NOT saved** \u2014 missing `content` (bug description).\n\u2705 Use: kuma_memory({ action: "gotcha", scope: "<file_path>", content: "<what went wrong>", status: "high" })\n- `scope` \u2014 file path where the bug was found\n- `content` \u2014 bug description (required to save)\n- `status` \u2014 low | medium | high | critical';
+  }
   const { listGotchas: listGotchas2, syncGotchasToDb: syncGotchasToDb2 } = await Promise.resolve().then(() => (init_kumaGotchas(), kumaGotchas_exports));
   await syncGotchasToDb2();
   return await listGotchas2({ filePath: params.scope, severity: params.status });
 }
-async function handleDeleteNode(params) {
-  sessionMemory.recordToolCall("kuma_memory_delete", { scope: params.scope, target: params.target });
-  const { getDb: getDb2, saveDb: saveDb2 } = await Promise.resolve().then(() => (init_kumaDb(), kumaDb_exports));
-  const db = await getDb2();
-  if (params.scope && params.target) {
-    const id = parseInt(params.target, 10);
-    if (isNaN(id)) return `\u26A0\uFE0F target "${params.target}" is not a valid numeric ID.`;
-    switch (params.scope) {
-      case "gotcha":
-      case "gotchas": {
-        const gotchaRow = db.prepare("SELECT file_path, description FROM known_gotchas WHERE id = ?");
-        gotchaRow.bind([id]);
-        let gotchaFilePath = "", gotchaDesc = "";
-        if (gotchaRow.step()) {
-          const row = gotchaRow.getAsObject();
-          gotchaFilePath = row.file_path;
-          gotchaDesc = row.description;
-        }
-        gotchaRow.free();
-        db.run("DELETE FROM known_gotchas WHERE id = ?", [id]);
-        if (gotchaFilePath && gotchaDesc) {
-          const gotchaNodeId = `gotcha::${gotchaFilePath}::${gotchaDesc.substring(0, 30)}`;
-          db.run("DELETE FROM edges WHERE source_id = ? OR target_id = ?", [gotchaNodeId, gotchaNodeId]);
-          db.run("DELETE FROM nodes WHERE id = ?", [gotchaNodeId]);
-        }
-        saveDb2(db);
-        return `\u{1F5D1}\uFE0F **Gotcha #${id} deleted** (table + graph).`;
-      }
-      default:
-        return `\u26A0\uFE0F Unknown scope "${params.scope}". Supported: gotcha`;
-    }
-  }
-  if (params.target || params.scope) {
-    const { flushDb: flushDb2 } = await Promise.resolve().then(() => (init_kumaDb(), kumaDb_exports));
-    const targetStr = params.target || "";
-    const targetId = params.scope && !targetStr.includes("::") ? `${targetStr}::${params.scope}` : targetStr;
-    if (targetId && (targetId.includes("::") || targetId.includes(":") || targetId.includes("-") || isNaN(parseInt(targetId, 10)))) {
-      try {
-        if (targetId.startsWith("feature_domain::")) {
-          const domainName = targetId.replace("feature_domain::", "");
-          db.run("DELETE FROM nodes WHERE id LIKE ? OR id LIKE ? OR id LIKE ?", [`feature_domain::${domainName}`, `cross_service_link::${domainName}::%`, `gotcha::${domainName}::%`]);
-          db.run("DELETE FROM edges WHERE source_id LIKE ? OR target_id LIKE ?", [`%${domainName}%`, `%${domainName}%`]);
-        } else if (targetId.startsWith("gotcha::")) {
-          db.run("DELETE FROM edges WHERE source_id = ? OR target_id = ?", [targetId, targetId]);
-          db.run("DELETE FROM nodes WHERE id = ?", [targetId]);
-          const parts = targetId.split("::");
-          if (parts.length >= 3) {
-            db.run("DELETE FROM known_gotchas WHERE file_path = ? AND description LIKE ?", [parts[1], `${parts.slice(2).join("::")}%`]);
-          }
-        } else {
-          db.run("DELETE FROM edges WHERE source_id = ? OR target_id = ?", [targetId, targetId]);
-          db.run("DELETE FROM nodes WHERE id = ?", [targetId]);
-        }
-        flushDb2(db);
-        return `\u{1F5D1}\uFE0F **Node & relations deleted:** ${targetId}`;
-      } catch (err) {
-        return `\u274C Failed to delete node: ${err}`;
-      }
-    }
-    const id = parseInt(targetId, 10);
-    if (!isNaN(id)) {
-      db.run("DELETE FROM nodes WHERE rowid = ?", [id]);
-      flushDb2(db);
-      return `\u{1F5D1}\uFE0F **Node #${id} deleted.**`;
-    }
-  }
-  return "\u26A0\uFE0F Provide `target` (node ID) to delete.\n\nExamples:\n- `delete_node`, target: 'function::sendMessage'\n- `delete_node`, scope: 'gotcha', target: '42'";
-}
-async function handleGoalProgress(params) {
-  const pct = params.confidence ?? 0;
-  const ms = params.content || params.title;
-  sessionMemory.setGoalProgress(pct, ms);
-  const p = sessionMemory.getGoalProgress();
-  if (!p) return "Error";
-  const bar = "\u2588".repeat(Math.floor(p.percentage / 10)) + "\u2591".repeat(10 - Math.floor(p.percentage / 10));
-  return `\u{1F4CA} ${bar} ${p.percentage}%${p.milestone ? " \u2014 " + p.milestone : ""}`;
-}
 
 // src/tools/kumaSafetyTool.ts
 init_sessionMemory();
 
-// src/engine/kumaSafetyLayer.ts
-init_kumaDb();
-init_sessionMemory();
-
-// src/engine/safetyAudit.ts
-init_kumaDb();
-var SCHEMA_SQL = `
-  CREATE TABLE IF NOT EXISTS safety_audit (
-    id INTEGER PRIMARY KEY AUTOINCREMENT,
-    timestamp INTEGER NOT NULL,
-    tool_name TEXT NOT NULL,
-    action TEXT NOT NULL,
-    file_path TEXT,
-    risk_level TEXT NOT NULL DEFAULT 'low',
-    policy_violations INTEGER DEFAULT 0,
-    allowed INTEGER NOT NULL DEFAULT 1,
-    duration_ms INTEGER DEFAULT 0,
-    metadata TEXT DEFAULT '{}'
-  );
-  CREATE INDEX IF NOT EXISTS idx_audit_timestamp ON safety_audit(timestamp);
-  CREATE INDEX IF NOT EXISTS idx_audit_tool ON safety_audit(tool_name);
-  CREATE INDEX IF NOT EXISTS idx_audit_risk ON safety_audit(risk_level);
-  CREATE INDEX IF NOT EXISTS idx_audit_allowed ON safety_audit(allowed);
-`;
-var schemaEnsured = false;
-async function ensureSchema() {
-  if (schemaEnsured) return;
-  try {
-    const db = await getDb();
-    db.exec(SCHEMA_SQL);
-    saveDb();
-    schemaEnsured = true;
-  } catch (err) {
-    console.error(`[SafetyAudit] Failed to ensure schema: ${err}`);
-  }
-}
-async function recordAudit(entry) {
-  try {
-    await ensureSchema();
-    const db = await getDb();
-    db.run(`
-      INSERT INTO safety_audit (timestamp, tool_name, action, file_path, risk_level, policy_violations, allowed, duration_ms, metadata)
-      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
-    `, [
-      entry.timestamp,
-      entry.toolName,
-      entry.action,
-      entry.filePath || null,
-      entry.riskLevel,
-      entry.policyViolations,
-      entry.allowed ? 1 : 0,
-      entry.durationMs,
-      JSON.stringify(entry.metadata || {})
-    ]);
-    saveDb();
-  } catch (err) {
-    console.error(`[SafetyAudit] Failed to record audit: ${err}`);
-  }
-}
-async function queryAudit(params) {
-  try {
-    await ensureSchema();
-    const db = await getDb();
-    const { toolName, riskLevel, allowed, limit = 20, since } = params;
-    let sql = "SELECT * FROM safety_audit WHERE 1=1";
-    const bindParams = [];
-    if (toolName) {
-      sql += " AND tool_name = ?";
-      bindParams.push(toolName);
-    }
-    if (riskLevel) {
-      sql += " AND risk_level = ?";
-      bindParams.push(riskLevel);
-    }
-    if (allowed !== void 0) {
-      sql += " AND allowed = ?";
-      bindParams.push(allowed ? 1 : 0);
-    }
-    if (since) {
-      sql += " AND timestamp >= ?";
-      bindParams.push(since);
-    }
-    sql += " ORDER BY timestamp DESC LIMIT ?";
-    bindParams.push(limit);
-    const stmt = db.prepare(sql);
-    stmt.bind(bindParams);
-    const results = [];
-    while (stmt.step()) {
-      results.push(stmt.getAsObject());
-    }
-    stmt.free();
-    if (results.length === 0) {
-      return "\u{1F4CB} **Safety Audit** \u2014 No records found for the given filters.";
-    }
-    const lines = [
-      `\u{1F4CB} **Safety Audit** \u2014 ${results.length} record(s)`,
-      `\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`,
-      ""
-    ];
-    for (const r of results) {
-      const riskIcon = r.risk_level === "critical" ? "\u{1F534}" : r.risk_level === "high" ? "\u{1F7E0}" : r.risk_level === "medium" ? "\u{1F7E1}" : "\u{1F7E2}";
-      const allowIcon = r.allowed ? "\u2705" : "\u26D4";
-      const time = new Date(r.timestamp * 1e3).toLocaleTimeString();
-      lines.push(`${allowIcon} ${riskIcon} **${r.tool_name}** \u2014 ${r.action}`);
-      if (r.file_path) lines.push(`   \u{1F4CD} ${r.file_path}`);
-      lines.push(`   \u{1F550} ${time} | ${r.duration_ms}ms | ${r.policy_violations} policy violation(s)`);
-      lines.push("");
-    }
-    return lines.join("\n");
-  } catch (err) {
-    return `Error querying audit: ${err}`;
-  }
-}
-async function auditStats() {
-  try {
-    await ensureSchema();
-    const db = await getDb();
-    const total = db.exec("SELECT COUNT(*) as c FROM safety_audit")[0]?.values[0][0] ?? 0;
-    const blocked = db.exec("SELECT COUNT(*) as c FROM safety_audit WHERE allowed = 0")[0]?.values[0][0] ?? 0;
-    const critical = db.exec("SELECT COUNT(*) as c FROM safety_audit WHERE risk_level IN ('high','critical')")[0]?.values[0][0] ?? 0;
-    let topBlocked = [];
-    try {
-      const stmt = db.prepare("SELECT tool_name, COUNT(*) as cnt FROM safety_audit WHERE allowed = 0 GROUP BY tool_name ORDER BY cnt DESC LIMIT 5");
-      while (stmt.step()) {
-        topBlocked.push(stmt.getAsObject());
-      }
-      stmt.free();
-    } catch {
-    }
-    const lines = [
-      `\u{1F4CA} **Safety Audit Stats**`,
-      `\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{1F4DD} Total operations: ${total}`,
-      `\u26D4 Blocked: ${blocked} (${total > 0 ? (blocked / total * 100).toFixed(1) : 0}%)`,
-      `\u{1F534} High/Critical risk: ${critical}`,
-      ""
-    ];
-    if (topBlocked.length > 0) {
-      lines.push("**Most blocked tools:**");
-      for (const t of topBlocked) {
-        lines.push(`  \u2022 ${t.tool_name}: ${t.cnt}x blocked`);
-      }
-    }
-    return lines.join("\n");
-  } catch (err) {
-    return `Error getting audit stats: ${err}`;
-  }
-}
-
-// src/tools/kumaPolicy.ts
-init_pathValidator();
-import fs19 from "fs";
-import path20 from "path";
-var DEFAULT_POLICY = {
-  never_touch: [
-    ".env",
-    ".env.local",
-    ".env.production",
-    ".env.development",
-    "package-lock.json",
-    "yarn.lock",
-    "pnpm-lock.yaml",
-    "node_modules/**"
-  ],
-  block_commands: [
-    "rm -rf",
-    "rm -fr",
-    "git push --force",
-    "git push -f",
-    "npm publish",
-    "yarn publish",
-    "pnpm publish",
-    "curl | bash",
-    "curl | sh"
-  ]
-};
-function loadPolicy() {
-  const root = getProjectRoot();
-  const ymlPath = path20.join(root, ".kuma", "policy.yml");
-  const yamlPath = path20.join(root, ".kuma", "policy.yaml");
-  let policyContent = null;
-  let policyPath = null;
-  if (fs19.existsSync(ymlPath)) {
-    policyContent = fs19.readFileSync(ymlPath, "utf-8");
-    policyPath = ymlPath;
-  } else if (fs19.existsSync(yamlPath)) {
-    policyContent = fs19.readFileSync(yamlPath, "utf-8");
-    policyPath = yamlPath;
-  }
-  if (!policyContent) {
-    return { ...DEFAULT_POLICY };
-  }
-  try {
-    return parseSimpleYaml(policyContent);
-  } catch (err) {
-    console.error(`[Policy] Failed to parse ${policyPath}: ${err}. Using defaults.`);
-    return { ...DEFAULT_POLICY };
-  }
-}
-function parseSimpleYaml(content) {
-  const policy = {};
-  const lines = content.split("\n");
-  let currentKey = null;
-  let currentArray = [];
-  for (const rawLine of lines) {
-    const line = rawLine.trim();
-    if (!line || line.startsWith("#")) continue;
-    const keyMatch = line.match(/^(\w[\w_-]*):\s*(.*)/);
-    if (keyMatch) {
-      if (currentKey && currentArray.length > 0) {
-        setPolicyValue(policy, currentKey, currentArray);
-        currentArray = [];
-      }
-      currentKey = keyMatch[1];
-      const value = keyMatch[2].trim();
-      if (value === "" || value === "|") {
-        currentArray = [];
-      } else {
-        if (value.startsWith("[") && value.endsWith("]")) {
-          const items = value.slice(1, -1).split(",").map((s) => s.trim().replace(/^['"]|['"]$/g, ""));
-          setPolicyValue(policy, currentKey, items);
-        } else {
-          setPolicyValue(policy, currentKey, value.replace(/^['"]|['"]$/g, ""));
-        }
-        currentKey = null;
-      }
-    } else if (currentKey && line.startsWith("- ")) {
-      currentArray.push(line.slice(2).trim().replace(/^['"]|['"]$/g, ""));
-    }
-  }
-  if (currentKey && currentArray.length > 0) {
-    setPolicyValue(policy, currentKey, currentArray);
-  }
-  return policy;
-}
-function setPolicyValue(policy, key, value) {
-  switch (key) {
-    case "never_touch":
-      policy.never_touch = value;
-      break;
-    case "require_review":
-      policy.require_review = value;
-      break;
-    case "require_tests":
-      policy.require_tests = value;
-      break;
-    case "max_file_size":
-      policy.max_file_size = Number(value);
-      break;
-    case "block_commands":
-      policy.block_commands = value;
-      break;
-  }
-}
-function matchesGlob(pattern, filePath) {
-  const normalizedPattern = pattern.replace(/\\/g, "/");
-  const normalizedPath = filePath.replace(/\\/g, "/");
-  let regexStr = "^";
-  for (let i = 0; i < normalizedPattern.length; i++) {
-    const ch = normalizedPattern[i];
-    if (ch === "*" && normalizedPattern[i + 1] === "*" && normalizedPattern[i + 2] === "/") {
-      regexStr += "(.+/)?";
-      i += 2;
-    } else if (ch === "*") {
-      regexStr += "[^/]*";
-    } else if (ch === "?") {
-      regexStr += "[^/]";
-    } else {
-      regexStr += ch.replace(/[.+^${}()|[\]\\]/g, "\\$&");
-    }
-  }
-  regexStr += "$";
-  try {
-    return new RegExp(regexStr).test(normalizedPath);
-  } catch {
-    return false;
-  }
-}
-function checkFilePathPolicy(filePath, policy) {
-  const violations = [];
-  const warnings = [];
-  if (policy.never_touch) {
-    for (const pattern of policy.never_touch) {
-      if (matchesGlob(pattern, filePath)) {
-        violations.push({
-          rule: "never_touch",
-          pattern,
-          message: `File "${filePath}" matches never_touch pattern "${pattern}"`,
-          severity: "error"
-        });
-      }
-    }
-  }
-  if (policy.max_file_size && policy.max_file_size > 0) {
-    try {
-      const root = getProjectRoot();
-      const fullPath = path20.join(root, filePath);
-      if (fs19.existsSync(fullPath)) {
-        const sizeKB = fs19.statSync(fullPath).size / 1024;
-        if (sizeKB > policy.max_file_size) {
-          violations.push({
-            rule: "max_file_size",
-            pattern: `${policy.max_file_size}KB`,
-            message: `File "${filePath}" is ${Math.round(sizeKB)}KB, exceeds max_file_size of ${policy.max_file_size}KB`,
-            severity: "error"
-          });
-        }
-      }
-    } catch {
-    }
-  }
-  if (policy.require_review) {
-    for (const pattern of policy.require_review) {
-      if (matchesGlob(pattern, filePath)) {
-        warnings.push({
-          rule: "require_review",
-          message: `File "${filePath}" requires review (matches "${pattern}")`
-        });
-      }
-    }
-  }
-  return { violations, warnings };
-}
-
-// src/engine/kumaSafetyProxy.ts
-init_pathValidator();
-init_sessionMemory();
-init_kumaDb();
-async function preCheck(_toolName, params, opts = {}) {
-  const messages = [];
-  let policyViolations = 0;
-  let highestRisk = "low";
-  const blockThreshold = opts.blockRiskThreshold || "high";
-  const filePath = opts.extractFilePath?.(params);
-  if (filePath) {
-    const validation = validateFilePath(filePath);
-    if (!validation.valid) {
-      messages.push(`\u{1F6AB} Path blocked: ${validation.error.message}`);
-      policyViolations++;
-      highestRisk = "critical";
-    }
-  }
-  const policy = loadPolicy();
-  if (filePath) {
-    const { violations, warnings } = checkFilePathPolicy(filePath, policy);
-    policyViolations += violations.length;
-    for (const v of violations) {
-      messages.push(`\u{1F4DC} Policy violation (${v.rule}): ${v.message}`);
-      highestRisk = "critical";
-    }
-    for (const w of warnings) {
-      messages.push(`\u26A0\uFE0F Policy warning (${w.rule}): ${w.message}`);
-      if (highestRisk === "low") highestRisk = "medium";
-    }
-  }
-  const command = opts.extractCommand?.(params);
-  if (command) {
-    const dangerousPatterns = [
-      "rm -rf",
-      "rm -fr",
-      "git push",
-      "git commit",
-      "npm publish",
-      "yarn publish",
-      "pnpm publish",
-      "| bash",
-      "| sh",
-      "eval ",
-      "exec ",
-      "mkfs",
-      "dd if=",
-      "shred"
-    ];
-    const matched = dangerousPatterns.find((p) => command.toLowerCase().includes(p));
-    if (matched) {
-      messages.push(`\u{1F6AB} Command blocked: contains dangerous pattern "${matched}"`);
-      policyViolations++;
-      highestRisk = "critical";
-    }
-  }
-  try {
-    const db = await getDb();
-    const researchCount = db.exec("SELECT COUNT(*) as c FROM research_cache")[0]?.values[0][0] ?? 0;
-    const action = params.action || "";
-    if (researchCount === 0 && (action === "edit" || action === "impact" || action === "navigate")) {
-      messages.push("\u{1F4A1} No research cached \u2014 run kuma_context({ action: 'research', scope: '...' }) first");
-      if (highestRisk === "low") highestRisk = "medium";
-    }
-  } catch {
-  }
-  try {
-    const summary = sessionMemory.getSummary();
-    const goal = summary.currentGoal;
-    if (!goal) {
-      messages.push("\u{1F4A1} No goal set \u2014 kuma_context({ action: 'init' }) sets one automatically");
-    }
-  } catch {
-  }
-  const riskLevel = highestRisk;
-  const thresholdLevels = ["low", "medium", "high", "critical"];
-  const thresholdIndex = thresholdLevels.indexOf(blockThreshold);
-  const riskIndex = thresholdLevels.indexOf(riskLevel);
-  const allowed = opts.blockOnViolation !== false ? riskIndex < thresholdIndex : policyViolations === 0;
-  return { allowed, riskLevel, policyViolations, messages };
-}
-
-// src/engine/kumaSafetyLayer.ts
-async function safetyCheck(action, filePath, command) {
-  try {
-    const checks = [];
-    const db = await getDb();
-    let changes = 0;
-    try {
-      const summary = sessionMemory.getSummary();
-      const modified = summary.modifiedFiles?.length || 0;
-      changes = modified;
-      checks.push({
-        name: "Uncommitted Changes",
-        passed: changes < 10,
-        detail: changes > 0 ? `\u{1F4DD} ${changes} uncommitted change(s)` : "\u2705 Clean working tree"
-      });
-    } catch {
-      checks.push({ name: "Uncommitted Changes", passed: true, detail: "\u2705 Could not check" });
-    }
-    if (action && filePath) {
-      const verdict = await preCheck(action, { filePath, action }, {
-        extractFilePath: (p) => p.filePath
-      });
-      checks.push({
-        name: "Policy & Path Safety",
-        passed: verdict.allowed,
-        detail: verdict.allowed ? `\u2705 ${verdict.policyViolations} violations` : `\u274C ${verdict.policyViolations} violation(s) \u2014 ${verdict.messages[0] || "blocked"}`
-      });
-    }
-    let recentChanges = 0;
-    try {
-      const changeResult = db.exec("SELECT COUNT(*) as c FROM change_log WHERE created_at > strftime('%s','now','-1 hour')");
-      recentChanges = changeResult[0]?.values[0][0] || 0;
-    } catch {
-    }
-    checks.push({
-      name: "Recent Changes",
-      passed: recentChanges < 20,
-      detail: recentChanges > 0 ? `\u{1F4DD} ${recentChanges} change(s) in last hour` : "\u2705 No recent changes"
-    });
-    try {
-      const nodeCount = db.exec("SELECT COUNT(*) as c FROM nodes")[0]?.values[0][0] || 0;
-      checks.push({
-        name: "Knowledge Graph Health",
-        passed: nodeCount > 0,
-        detail: nodeCount > 0 ? `\u2705 ${nodeCount} nodes in graph` : "\u26A0\uFE0F Empty knowledge graph"
-      });
-    } catch {
-      checks.push({ name: "Knowledge Graph Health", passed: true, detail: "\u26A0\uFE0F Could not check" });
-    }
-    if (filePath) {
-      try {
-        const fs28 = await import("fs");
-        const path29 = await import("path");
-        const root = process.cwd();
-        const fullPath = path29.resolve(root, filePath);
-        if (fs28.existsSync(fullPath)) {
-          const stat = fs28.statSync(fullPath);
-          const sizeKB = Math.round(stat.size / 1024);
-          if (sizeKB > 500) {
-            checks.push({
-              name: "File Size Warning",
-              passed: false,
-              detail: `\u{1F4CF} File is ${sizeKB}KB \u2014 large file edits are risky`
-            });
-          }
-          if (filePath.endsWith(".ts") || filePath.endsWith(".js")) {
-            const baseName = path29.basename(filePath, path29.extname(filePath));
-            const testPatterns = [
-              filePath.replace(/\.(ts|js)$/, ".test.$1"),
-              filePath.replace(/\.(ts|js)$/, ".spec.$1"),
-              filePath.replace(/^src\//, "tests/").replace(/\.(ts|js)$/, ".test.$1"),
-              `**/__tests__/**/${baseName}.test.${path29.extname(filePath).slice(1)}`
-            ];
-            let hasTests = false;
-            const fg = await import("fast-glob");
-            for (const pattern of testPatterns) {
-              const matches = await fg.default(pattern, { cwd: root, ignore: ["**/node_modules/**"] });
-              if (matches.length > 0) {
-                hasTests = true;
-                break;
-              }
-            }
-            if (!hasTests) {
-              checks.push({
-                name: "Tests Check",
-                passed: true,
-                // Not a blocker, just informative
-                detail: `\u{1F9EA} No test file found for "${path29.basename(filePath)}" \u2014 consider adding tests`
-              });
-            } else {
-              checks.push({
-                name: "Tests Check",
-                passed: true,
-                detail: "\u2705 Test file found"
-              });
-            }
-          }
-        }
-      } catch {
-      }
-    }
-    const failed = checks.filter((c) => !c.passed);
-    const riskLevel = failed.length >= 3 ? "critical" : failed.length >= 2 ? "high" : failed.length >= 1 ? "medium" : "low";
-    const allowed = failed.length === 0;
-    const recommendation = allowed ? "\u{1F7E2} All checks passed \u2014 proceed safely." : riskLevel === "critical" ? "\u{1F534} Critical \u2014 Do not proceed without resolving all issues." : riskLevel === "high" ? "\u{1F7E0} High risk \u2014 Resolve issues before proceeding." : "\u{1F7E1} Medium risk \u2014 Proceed with caution.";
-    const result = { action, filePath, allowed, checks, riskLevel, recommendation };
-    await recordAudit({
-      timestamp: Math.floor(Date.now() / 1e3),
-      toolName: "kuma_safety_check",
-      action,
-      filePath,
-      riskLevel,
-      policyViolations: failed.length,
-      allowed,
-      durationMs: 0,
-      metadata: { checkType: "full" }
-    });
-    return formatSafetyCheck(result, command);
-  } catch (err) {
-    return `Error in safety check: ${err}`;
-  }
-}
-function formatSafetyCheck(r, command) {
-  const emoji = r.riskLevel === "critical" ? "\u{1F534}" : r.riskLevel === "high" ? "\u{1F7E0}" : r.riskLevel === "medium" ? "\u{1F7E1}" : "\u{1F7E2}";
-  const lines = [
-    `${emoji} **Safety AI Layer** \u2014 ${r.allowed ? "\u2705 Allowed" : "\u26D4 Blocked"}`,
-    `\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{1F3AF} Action: \`${r.action}\``,
-    r.filePath ? `\u{1F4C4} File: \`${r.filePath}\`` : "",
-    command ? `\u{1F4BB} Command: \`${command}\`` : "",
-    `\u26A0\uFE0F Risk Level: **${r.riskLevel.toUpperCase()}**`,
-    "",
-    r.recommendation,
-    "",
-    "**Checks:**"
-  ].filter(Boolean);
-  for (const c of r.checks) {
-    lines.push(`  ${c.passed ? "\u2705" : "\u274C"} **${c.name}**: ${c.detail}`);
-  }
-  return lines.join("\n");
-}
-
-// src/tools/kumaSafetyTool.ts
-init_kumaDb();
-
 // src/tools/kumaGuard.ts
 init_sessionMemory();
 
@@ -10584,9 +9000,9 @@ init_sessionMemory();
 init_pathValidator();
 init_sessionMemory();
 init_kumaShared();
-import fs20 from "fs";
-import path21 from "path";
-import { execSync as execSync5 } from "child_process";
+import fs17 from "fs";
+import path18 from "path";
+import { execSync as execSync4 } from "child_process";
 var SCRIPT_PATCH_PATTERNS = [
   "writeFileSync",
   "writeFile",
@@ -10612,20 +9028,20 @@ function findPatchScripts(projectRoot) {
   const warnings = [];
   const recentFiles = scanRecentFiles(projectRoot);
   for (const file of recentFiles) {
-    const ext = path21.extname(file).toLowerCase();
+    const ext = path18.extname(file).toLowerCase();
     if (!SCRIPT_EXTENSIONS.includes(ext)) continue;
-    const relativePath = path21.relative(projectRoot, file);
+    const relativePath = path18.relative(projectRoot, file);
     if (relativePath.startsWith("src") || relativePath.startsWith("test") || relativePath.startsWith("node_modules") || relativePath.startsWith(".") || relativePath.startsWith(".kuma/scratch")) {
       continue;
     }
     try {
-      const content = fs20.readFileSync(file, "utf-8").toLowerCase();
+      const content = fs17.readFileSync(file, "utf-8").toLowerCase();
       const matchedPattern = SCRIPT_PATCH_PATTERNS.find((p) => content.includes(p.toLowerCase()));
       if (matchedPattern) {
         warnings.push({
           severity: "high",
           pattern: "script-patching",
-          message: `Created script file that modifies other files: ${path21.basename(file)}`,
+          message: `Created script file that modifies other files: ${path18.basename(file)}`,
           suggestion: "Use your native edit tools instead \u2014 targeted edits with auto-backup and rollback",
           evidence: `File: ${relativePath} contains '${matchedPattern}'`,
           filePath: relativePath
@@ -10659,15 +9075,15 @@ function detectBashGrepUsage() {
 function scanRecentFiles(projectRoot) {
   const recent = [];
   try {
-    const entries = fs20.readdirSync(projectRoot, { withFileTypes: true });
+    const entries = fs17.readdirSync(projectRoot, { withFileTypes: true });
     const now = Date.now();
     const recentThreshold = 30 * 60 * 1e3;
     for (const entry of entries) {
       if (!entry.isFile()) continue;
       try {
-        const stat = fs20.statSync(path21.join(projectRoot, entry.name));
+        const stat = fs17.statSync(path18.join(projectRoot, entry.name));
         if (now - stat.mtimeMs < recentThreshold || now - stat.ctimeMs < recentThreshold) {
-          recent.push(path21.join(projectRoot, entry.name));
+          recent.push(path18.join(projectRoot, entry.name));
         }
       } catch {
         continue;
@@ -10680,7 +9096,7 @@ function scanRecentFiles(projectRoot) {
 function detectGitPatchScripts(projectRoot) {
   const warnings = [];
   try {
-    const statusStdout = execSync5("git status --porcelain", {
+    const statusStdout = execSync4("git status --porcelain", {
       cwd: projectRoot,
       encoding: "utf-8",
       timeout: 3e3
@@ -10691,14 +9107,14 @@ function detectGitPatchScripts(projectRoot) {
         const prefix = line.substring(0, 2);
         if (prefix !== "??" && prefix !== "A ") continue;
         const file = line.substring(3).trim();
-        const ext = path21.extname(file).toLowerCase();
+        const ext = path18.extname(file).toLowerCase();
         if (!SCRIPT_EXTENSIONS.includes(ext)) continue;
         const isRootLevel = !file.includes("/");
         const isScriptsDir = file.startsWith("scripts/") || file.startsWith("patches/");
         if (!isRootLevel && !isScriptsDir) continue;
-        const fullPath = path21.join(projectRoot, file);
-        if (fs20.existsSync(fullPath)) {
-          const content = fs20.readFileSync(fullPath, "utf-8").toLowerCase();
+        const fullPath = path18.join(projectRoot, file);
+        if (fs17.existsSync(fullPath)) {
+          const content = fs17.readFileSync(fullPath, "utf-8").toLowerCase();
           const matchedPattern = SCRIPT_PATCH_PATTERNS.find((p) => content.includes(p.toLowerCase()));
           if (matchedPattern) {
             warnings.push({
@@ -10713,7 +9129,7 @@ function detectGitPatchScripts(projectRoot) {
         }
       }
     }
-    const deletedStdout = execSync5("git diff --name-only --diff-filter=D HEAD", {
+    const deletedStdout = execSync4("git diff --name-only --diff-filter=D HEAD", {
       cwd: projectRoot,
       encoding: "utf-8",
       timeout: 3e3
@@ -10721,7 +9137,7 @@ function detectGitPatchScripts(projectRoot) {
     if (deletedStdout) {
       const deletedFiles = deletedStdout.split("\n").filter(Boolean);
       for (const file of deletedFiles) {
-        const ext = path21.extname(file).toLowerCase();
+        const ext = path18.extname(file).toLowerCase();
         if (SCRIPT_EXTENSIONS.includes(ext)) {
           warnings.push({
             severity: "high",
@@ -10783,21 +9199,21 @@ function detectAllAntiPatterns() {
 // src/engine/contextSnapshot.ts
 init_sessionMemory();
 init_pathValidator();
-import fs21 from "fs";
-import path22 from "path";
-import { execSync as execSync6 } from "child_process";
+import fs18 from "fs";
+import path19 from "path";
+import { execSync as execSync5 } from "child_process";
 var SNAPSHOT_DIR = "context-snapshots";
 function snapshotDir() {
-  return path22.join(getProjectRoot(), ".kuma", SNAPSHOT_DIR);
+  return path19.join(getProjectRoot(), ".kuma", SNAPSHOT_DIR);
 }
 function ensureSnapshotDir() {
   const dir = snapshotDir();
-  if (!fs21.existsSync(dir)) {
-    fs21.mkdirSync(dir, { recursive: true });
+  if (!fs18.existsSync(dir)) {
+    fs18.mkdirSync(dir, { recursive: true });
   }
 }
 function snapshotFilePath(timestamp) {
-  return path22.join(snapshotDir(), `${timestamp}.json`);
+  return path19.join(snapshotDir(), `${timestamp}.json`);
 }
 function saveSnapshot(goal) {
   try {
@@ -10818,7 +9234,7 @@ function saveSnapshot(goal) {
     hasConventions: !!summary.hasConventions
   };
   try {
-    fs21.writeFileSync(snapshotFilePath(Date.now()), JSON.stringify(snapshot, null, 2), "utf-8");
+    fs18.writeFileSync(snapshotFilePath(Date.now()), JSON.stringify(snapshot, null, 2), "utf-8");
   } catch {
   }
   sessionMemory.recordToolCall("kuma_context", { action: "save", goal: snapshot.goal });
@@ -10857,7 +9273,7 @@ function formatSnapshot(snapshot) {
 function getGitDiffStat2() {
   try {
     const root = getProjectRoot();
-    const stdout = execSync6("git diff --stat", {
+    const stdout = execSync5("git diff --stat", {
       cwd: root,
       encoding: "utf-8",
       timeout: 3e3
@@ -11033,27 +9449,12 @@ async function handleSafety(params) {
       return handleGuard(params);
     case "verify":
       return handleVerify(params);
-    case "check":
-      return handleCheck(params);
-    case "audit":
-      return handleAudit(params);
-    case "security":
-      return handleSecurity(params);
-    case "gc":
-      return handleGc(params);
-    case "ast":
-    case "validate":
-      return handleAstValidation(params);
     case "checkpoint":
       return handleCheckpoint(params);
     case "rollback_label":
       return handleRollbackLabel(params);
-    case "checkpoint_list":
-      return handleCheckpointList(params);
-    case "gotcha_staleness":
-      return handleGotchaStaleness(params);
     default:
-      return `Unknown action "${action}".`;
+      return `Unknown action "${action}". Use: guard, verify, checkpoint, rollback_label`;
   }
 }
 async function handleGuard(params) {
@@ -11062,73 +9463,6 @@ async function handleGuard(params) {
     check: params.guardCheck || "all"
   });
 }
-async function handleCheck(params) {
-  return await safetyCheck("check", params.filePath, params.command);
-}
-async function handleAudit(params) {
-  if (params.limit === 0) return await auditStats();
-  return await queryAudit({
-    toolName: params.toolName,
-    riskLevel: params.riskLevel,
-    allowed: params.allowed,
-    limit: params.limit || 20,
-    since: params.since
-  });
-}
-async function handleSecurity(params) {
-  sessionMemory.recordToolCall("kuma_safety_security", {});
-  if (params.filePath) {
-    try {
-      const fs28 = await import("fs");
-      const path29 = await import("path");
-      const root = process.cwd();
-      const fullPath = path29.resolve(root, params.filePath);
-      if (fs28.existsSync(fullPath) && fs28.statSync(fullPath).isFile()) {
-        const content = fs28.readFileSync(fullPath, "utf-8");
-        const lines = content.split("\n");
-        const findings = [];
-        for (let i = 0; i < lines.length; i++) {
-          const line = lines[i];
-          const lc = line.toLowerCase();
-          if (lc.includes("credentials: true")) {
-            findings.push({ line: i + 1, pattern: "credentials-leak", severity: "high", message: "`credentials: true` in Prisma select may leak sensitive fields" });
-          }
-          if (lc.includes("console.log") && (lc.includes("token") || lc.includes("secret") || lc.includes("key") || lc.includes("password"))) {
-            findings.push({ line: i + 1, pattern: "console-log-secret", severity: "high", message: "Potential secret logged to console" });
-          }
-          if (lc.includes("process.env") && (lc.includes("api_key") || lc.includes("secret") || lc.includes("token"))) {
-            findings.push({ line: i + 1, pattern: "env-in-code", severity: "medium", message: "process.env.KEY referenced in code \u2014 ensure not in client bundle" });
-          }
-        }
-        for (const f of findings) {
-          await addSecurityFinding({ filePath: params.filePath, lineNumber: f.line, pattern: f.pattern, severity: f.severity, message: f.message });
-        }
-        if (findings.length === 0) return `\u{1F512} No security issues found in "${params.filePath}".`;
-        return `\u{1F512} **Security Scan** \u2014 ${findings.length} finding(s) in "${params.filePath}":
-${findings.map((f) => `  ${f.severity === "high" ? "\u{1F534}" : "\u{1F7E1}"} L${f.line}: ${f.message}`).join("\n")}`;
-      }
-    } catch {
-    }
-  }
-  return await getSecurityFindings();
-}
-async function handleGc(_params) {
-  sessionMemory.recordToolCall("kuma_safety_gc", {});
-  return await runGarbageCollection();
-}
-async function handleAstValidation(params) {
-  sessionMemory.recordToolCall("kuma_safety_ast", { scope: params.scope });
-  const { validateCodeContent: validateCodeContent2, validateFile: validateFile2, formatValidationFindings: formatValidationFindings2 } = await Promise.resolve().then(() => (init_kumaAstValidator(), kumaAstValidator_exports));
-  if (params.command) {
-    const findings = validateCodeContent2(params.command, params.scope);
-    return formatValidationFindings2(findings, params.scope);
-  }
-  if (params.scope) {
-    const findings = validateFile2(params.scope);
-    return formatValidationFindings2(findings, params.scope);
-  }
-  return "\u26A0\uFE0F Provide a scope (file path) or command (code content) to validate.";
-}
 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' })";
@@ -11141,11 +9475,6 @@ async function handleRollbackLabel(params) {
   const { rollbackToCheckpoint: rollbackToCheckpoint2 } = await Promise.resolve().then(() => (init_kumaCheckpoint(), kumaCheckpoint_exports));
   return await rollbackToCheckpoint2(params.label);
 }
-async function handleCheckpointList(_params) {
-  sessionMemory.recordToolCall("kuma_safety_checkpoint_list", {});
-  const { listCheckpoints: listCheckpoints2 } = await Promise.resolve().then(() => (init_kumaCheckpoint(), kumaCheckpoint_exports));
-  return listCheckpoints2();
-}
 var _lastVerifyCall = 0;
 var VERIFY_COOLDOWN_MS = 3e4;
 async function handleVerify(params) {
@@ -11171,20 +9500,15 @@ async function handleVerify(params) {
 
 \u2705 **Recordings:** ${recordingSummary.total} total (${recordingSummary.archFlows} arch_flow, ${recordingSummary.gotchas} gotcha, ${recordingSummary.decisions} decision, ${recordingSummary.researchSaves} research_save)`;
   }
-  sessionMemory.recordToolCall("kuma_safety_verify", { scope: params.scope || params.filePath });
+  sessionMemory.recordToolCall("kuma_safety_verify", { scope: params.scope });
   const { runAutoVerification: runAutoVerification2 } = await Promise.resolve().then(() => (init_kumaVerifier(), kumaVerifier_exports));
   const verifyResult = await runAutoVerification2({
-    scope: params.scope || params.filePath,
+    scope: params.scope,
     force: params.force,
     timeoutMs: 3e4
   });
   return verifyResult + recordingWarning;
 }
-async function handleGotchaStaleness(_params) {
-  const { verifyGotchaStaleness: verifyGotchaStaleness2, formatGotchaStalenessReport: formatGotchaStalenessReport2 } = await Promise.resolve().then(() => (init_kumaSelfHeal(), kumaSelfHeal_exports));
-  const stale = await verifyGotchaStaleness2();
-  return formatGotchaStalenessReport2(stale);
-}
 
 // src/engine/kumaAutoInit.ts
 init_sessionMemory();
@@ -11249,15 +9573,14 @@ var CORE_NOTE = "\n\nCORE ACTIONS (use these): ";
 function registerAllTools(server) {
   server.tool(
     "kuma_context",
-    "Context & memory recall. Call FIRST each session. Lean \u2014 each call returns only what you need." + CORE_NOTE + "`init` (start of session: project brief + session state), `research` (before editing unfamiliar code), `history` (why is this file written this way). Other actions are internal: flow, impact, navigate, digest, drift, rollback, changes, resume.",
+    "Context & memory recall. Call FIRST each session. Lean \u2014 each call returns only what you need." + CORE_NOTE + "`init` (start of session: project brief + session state), `research` (before editing unfamiliar code), `history` (why is this file written this way), `flow` (read a recorded architecture flow).",
     {
-      action: z.enum(["init", "research", "impact", "navigate", "flow", "history", "changes", "rollback", "digest", "drift", "resume"]).describe(
-        "init=project brief + session restore (CORE), research=research pipeline (CORE), history=file rationale + fresh gotchas (CORE); internal (avoid unless needed): impact, navigate, flow, changes, rollback, digest, drift, resume"
+      action: z.enum(["init", "research", "history", "flow"]).describe(
+        "init=project brief + session restore, research=research pipeline, history=file rationale + fresh gotchas, flow=read recorded domain flow"
       ),
       scope: z.string().optional().describe("Research scope for research action"),
-      target: z.string().optional().describe("Target symbol/file for impact/navigate/changes/history"),
-      goal: z.string().optional().describe("Current goal (for init)"),
-      since: z.number().optional().describe("Unix timestamp filter for changes")
+      target: z.string().optional().describe("Target symbol/file for history/flow"),
+      goal: z.string().optional().describe("Current goal (for init)")
     },
     async (params) => {
       try {
@@ -11266,8 +9589,7 @@ function registerAllTools(server) {
           action: params.action,
           scope: params.scope,
           target: params.target,
-          goal: params.goal,
-          since: params.since
+          goal: params.goal
         });
         return { content: [{ type: "text", text }] };
       } catch (err) {
@@ -11277,28 +9599,24 @@ function registerAllTools(server) {
   );
   server.tool(
     "kuma_memory",
-    "Persistent knowledge. Record what matters, skip what doesn't. This is what saves time in future sessions. Don't record what grep/glob answers faster (functions, imports, types, components)." + CORE_NOTE + "`gotcha` (IMMEDIATELY when you find a bug/quirk), `decision` (when choosing between options), `arch_flow` (after tracing a complete flow, max 5 core files), `research_save` (after exploring an area). Other actions are internal: session, search, changes, mine, delete_node, clear, goal_progress.",
+    "Persistent knowledge. Record what matters, skip what doesn't. This is what saves time in future sessions. Don't record what grep/glob answers faster (functions, imports, types, components)." + CORE_NOTE + "`gotcha` (IMMEDIATELY when you find a bug/quirk), `decision` (when choosing between options), `arch_flow` (after tracing a complete flow, max 5 core files), `research_save` (after exploring an area), `search` (quick lookup of memory + knowledge graph).",
     {
-      action: z.enum(["decision", "mine", "research_save", "session", "search", "changes", "arch_flow", "gotcha", "delete_node", "clear", "goal_progress"]).describe(
-        "gotcha=record bug/quirk (CORE), decision=ADR (CORE), arch_flow=record architecture flow (CORE), research_save=save findings (CORE); internal (avoid unless needed): mine, session, search, changes, delete_node, clear, goal_progress"
+      action: z.enum(["gotcha", "decision", "arch_flow", "research_save", "search"]).describe(
+        "gotcha=record bug/quirk, decision=ADR, arch_flow=record architecture flow, research_save=save findings, search=quick memory+graph lookup"
       ),
-      scope: z.string().optional().describe("Scope for research_save/search/mine \u2014 or file path for gotcha/delete_node"),
-      trigger_command: z.string().optional().describe("Gotcha trigger: shell command that hits this gotcha. Injected by the Bash PreToolUse hook"),
+      scope: z.string().optional().describe("File path for gotcha \u2014 or scope for research_save/search"),
+      trigger_command: z.string().optional().describe("Gotcha trigger: shell command that hits this gotcha"),
       query: z.string().optional().describe("Search query for search action"),
       content: z.string().optional().describe("Content/notes for research_save / gotcha description / arch_flow record"),
       record: z.string().optional().describe("JSON record string for research_save"),
       confidence: z.number().min(0).max(1).optional().describe("Confidence for research_save (0-1)"),
-      confirm: z.boolean().optional().describe("Confirm and record candidates automatically for mine action"),
       title: z.string().optional().describe("Decision title (required for decision)"),
       context: z.string().optional().describe("Decision context"),
       rationale: z.string().optional().describe("Decision rationale (required for decision)"),
       outcome: z.string().optional().describe("Decision outcome (default: implemented)"),
       status: z.string().optional().describe("Gotcha severity (low|medium|high|critical)"),
       description: z.string().optional().describe("Gotcha workaround"),
-      topic: z.string().optional().describe("Memory topic for session action"),
-      limit: z.number().min(1).max(100).optional().describe("Result limit for search/mine"),
-      target: z.string().optional().describe("File path for changes / node ID for delete_node"),
-      since: z.number().optional().describe("Timestamp filter for changes/mine")
+      limit: z.number().min(1).max(100).optional().describe("Result limit for search")
     },
     async (params) => {
       try {
@@ -11310,15 +9628,11 @@ function registerAllTools(server) {
           content: params.content,
           record: params.record,
           confidence: params.confidence,
-          confirm: params.confirm,
           title: params.title,
           context: params.context,
           rationale: params.rationale,
           outcome: params.outcome,
-          topic: params.topic,
           limit: params.limit,
-          target: params.target,
-          since: params.since,
           status: params.status,
           description: params.description,
           trigger_command: params.trigger_command
@@ -11331,28 +9645,16 @@ function registerAllTools(server) {
   );
   server.tool(
     "kuma_safety",
-    "Safety & verification. Use at task boundaries, not on every edit." + CORE_NOTE + "`guard` (before risky work: anti-patterns, drift, loops), `verify` (after edits: scoped tests + validation). Other actions are internal/deprecated: check, audit, security, gc, ast, validate, checkpoint, rollback_label, checkpoint_list, gotcha_staleness.",
+    "Safety & verification. Use at task boundaries, not on every edit." + CORE_NOTE + "`guard` (before risky work: anti-patterns, drift, loops), `verify` (after edits: scoped tests + validation), `checkpoint` + `rollback_label` (the one rollback mechanism: snapshot before risky work, restore after).",
     {
-      action: z.enum(["guard", "verify", "check", "audit", "security", "gc", "ast", "validate", "checkpoint", "rollback_label", "checkpoint_list", "gotcha_staleness"]).describe(
-        "guard=anti-patterns/drift/loops before risky work (CORE), verify=scoped tests after edits (CORE); internal/deprecated (avoid unless needed): check, audit, security, gc, ast, validate, checkpoint, rollback_label, checkpoint_list, gotcha_staleness"
+      action: z.enum(["guard", "verify", "checkpoint", "rollback_label"]).describe(
+        "guard=anti-patterns/drift/loops before risky work, verify=scoped tests after edits, checkpoint=labeled snapshot before risky work, rollback_label=restore a labeled snapshot"
       ),
-      // Verify params
-      scope: z.string().optional().describe("Scope for verify/ast/validate (e.g. 'auth', file path)"),
-      // Guard params
+      scope: z.string().optional().describe("Scope for verify (e.g. 'auth', file path)"),
+      force: z.boolean().optional().describe("Force re-run even if cache is fresh (verify)"),
       guardGoal: z.string().optional().describe("Goal for guard check"),
       guardCheck: z.enum(["all", "anti-pattern", "loop", "drift", "context"]).optional().describe("Guard check type"),
-      // Check params
-      filePath: z.string().optional().describe("File path for check/security scan"),
-      command: z.string().optional().describe("Command for check"),
-      // Audit params
-      toolName: z.string().optional().describe("Filter audit by tool name"),
-      riskLevel: z.string().optional().describe("Filter audit by risk level"),
-      allowed: z.boolean().optional().describe("Filter audit by allowed/blocked"),
-      limit: z.number().min(1).max(100).optional().describe("Audit result limit"),
-      since: z.number().optional().describe("Timestamp filter for audit"),
-      force: z.boolean().optional().describe("Force re-run even if cache is fresh (verify)"),
-      // Checkpoint params
-      label: z.string().optional().describe("Checkpoint label for checkpoint/rollback_label actions"),
+      label: z.string().optional().describe("Checkpoint label for checkpoint/rollback_label"),
       description: z.string().optional().describe("Description for checkpoint")
     },
     async (params) => {
@@ -11362,14 +9664,7 @@ function registerAllTools(server) {
           action: params.action,
           guardGoal: params.guardGoal,
           guardCheck: params.guardCheck,
-          filePath: params.filePath,
           scope: params.scope,
-          command: params.command,
-          toolName: params.toolName,
-          riskLevel: params.riskLevel,
-          allowed: params.allowed,
-          limit: params.limit,
-          since: params.since,
           force: params.force,
           label: params.label,
           description: params.description
@@ -11380,7 +9675,7 @@ function registerAllTools(server) {
       }
     }
   );
-  console.error("[Manifest] Registered 3 coarse-grained tools (kuma_context, kuma_memory, kuma_safety).");
+  console.error("[Manifest] Registered 3 coarse-grained tools with 13 core actions (init/research/history/flow \xB7 gotcha/decision/arch_flow/research_save/search \xB7 guard/verify/checkpoint/rollback_label).");
   console.error("[Manifest] Auto-init hooks installed on all tools.");
   console.error("[Manifest] Namespace aliases active (kuma_kuma_* \u2192 kuma_*, context \u2192 kuma_context).");
 }
@@ -11459,14 +9754,14 @@ async function main() {
     } catch {
     }
     try {
-      const path29 = await import("path");
-      const fs28 = await import("fs");
-      const lockDir = path29.resolve(process.cwd(), ".kuma/verifier.lock");
-      if (fs28.existsSync(lockDir)) {
-        const pidFile = path29.join(lockDir, "pid");
-        if (fs28.existsSync(pidFile)) {
+      const path25 = await import("path");
+      const fs24 = await import("fs");
+      const lockDir = path25.resolve(process.cwd(), ".kuma/verifier.lock");
+      if (fs24.existsSync(lockDir)) {
+        const pidFile = path25.join(lockDir, "pid");
+        if (fs24.existsSync(pidFile)) {
           try {
-            const pid = parseInt(fs28.readFileSync(pidFile, "utf-8"), 10);
+            const pid = parseInt(fs24.readFileSync(pidFile, "utf-8"), 10);
             if (pid && pid !== process.pid) {
               try {
                 process.kill(-pid, "SIGKILL");
@@ -11482,7 +9777,7 @@ async function main() {
           } catch {
           }
         }
-        fs28.rmSync(lockDir, { recursive: true, force: true });
+        fs24.rmSync(lockDir, { recursive: true, force: true });
       }
       if (killedCount === 0) {
         console.error("\u2705 No running verifications found to kill.");
@@ -11490,25 +9785,25 @@ async function main() {
     } catch {
     }
     try {
-      const { execSync: execSync7 } = await import("child_process");
+      const { execSync: execSync6 } = await import("child_process");
       try {
-        execSync7("pkill -f 'jest' 2>/dev/null || true");
+        execSync6("pkill -f 'jest' 2>/dev/null || true");
       } catch {
       }
       try {
-        execSync7("pkill -f 'jest-worker' 2>/dev/null || true");
+        execSync6("pkill -f 'jest-worker' 2>/dev/null || true");
       } catch {
       }
       try {
-        execSync7("pkill -f 'pnpm test' 2>/dev/null || true");
+        execSync6("pkill -f 'pnpm test' 2>/dev/null || true");
       } catch {
       }
       try {
-        execSync7("pkill -f 'npm test' 2>/dev/null || true");
+        execSync6("pkill -f 'npm test' 2>/dev/null || true");
       } catch {
       }
       try {
-        execSync7("pkill -f 'yarn test' 2>/dev/null || true");
+        execSync6("pkill -f 'yarn test' 2>/dev/null || true");
       } catch {
       }
       console.error("\u2705 Killed orphaned test processes");
@@ -11681,23 +9976,23 @@ async function main() {
     });
     const output = formatInitResults(results);
     console.log(output);
-    const fs28 = await import("fs");
-    const path29 = await import("path");
-    const matchaSkills = path29.resolve(process.cwd(), "skills/matcha/SKILL.md");
-    const matchaAgents = path29.resolve(
+    const fs24 = await import("fs");
+    const path25 = await import("path");
+    const matchaSkills = path25.resolve(process.cwd(), "skills/matcha/SKILL.md");
+    const matchaAgents = path25.resolve(
       process.cwd(),
       ".agents/skills/matcha/SKILL.md"
     );
-    const matchaRootSkills = path29.resolve(
+    const matchaRootSkills = path25.resolve(
       process.cwd(),
       "skills/matcha/SKILL.md"
     );
-    const matchaAgentsMd = path29.resolve(process.cwd(), "AGENTS.md");
-    const matchaWindsurfRules = path29.resolve(
+    const matchaAgentsMd = path25.resolve(process.cwd(), "AGENTS.md");
+    const matchaWindsurfRules = path25.resolve(
       process.cwd(),
       ".windsurf"
     );
-    if (fs28.existsSync(matchaSkills) || fs28.existsSync(matchaAgents) || fs28.existsSync(matchaRootSkills) || fs28.existsSync(matchaAgentsMd) || fs28.existsSync(matchaWindsurfRules)) {
+    if (fs24.existsSync(matchaSkills) || fs24.existsSync(matchaAgents) || fs24.existsSync(matchaRootSkills) || fs24.existsSync(matchaAgentsMd) || fs24.existsSync(matchaWindsurfRules)) {
       console.error(
         "\n\u{1F375} Hey, I see matcha is installed \u2014 they pair well together!"
       );
@@ -11711,13 +10006,13 @@ async function main() {
   (async () => {
     try {
       const { generateInitMdContent: generateInitMdContent2 } = await Promise.resolve().then(() => (init_init(), init_exports));
-      const fs28 = await import("fs");
-      const path29 = await import("path");
-      const initMdPath = path29.resolve(process.cwd(), ".kuma/init.md");
-      if (!fs28.existsSync(initMdPath)) {
-        const kumaDir = path29.dirname(initMdPath);
-        if (!fs28.existsSync(kumaDir)) fs28.mkdirSync(kumaDir, { recursive: true });
-        fs28.writeFileSync(initMdPath, generateInitMdContent2(), "utf-8");
+      const fs24 = await import("fs");
+      const path25 = await import("path");
+      const initMdPath = path25.resolve(process.cwd(), ".kuma/init.md");
+      if (!fs24.existsSync(initMdPath)) {
+        const kumaDir = path25.dirname(initMdPath);
+        if (!fs24.existsSync(kumaDir)) fs24.mkdirSync(kumaDir, { recursive: true });
+        fs24.writeFileSync(initMdPath, generateInitMdContent2(), "utf-8");
         console.error(`[${SERVER_NAME}] Auto-generated .kuma/init.md`);
       }
     } catch (err) {
@@ -11728,8 +10023,8 @@ async function main() {
     try {
       const { detectAgent: detectAgent2, getSkillPath: getSkillPath2, getAgentLabel: getAgentLabel2 } = await Promise.resolve().then(() => (init_agentDetector(), agentDetector_exports));
       const { generateSkill: generateSkill2, getSecondaryFiles: getSecondaryFiles2 } = await Promise.resolve().then(() => (init_skillGenerator(), skillGenerator_exports));
-      const fs28 = await import("fs");
-      const path29 = await import("path");
+      const fs24 = await import("fs");
+      const path25 = await import("path");
       const detection = detectAgent2();
       if (!detection.primary) {
         console.error(`[${SERVER_NAME}] No AI agent detected \u2014 skipping auto-skill creation`);
@@ -11737,22 +10032,22 @@ async function main() {
       }
       const agentType = detection.primary;
       const skillPath = getSkillPath2(agentType);
-      const fullPath = path29.resolve(process.cwd(), skillPath);
-      if (fs28.existsSync(fullPath)) {
+      const fullPath = path25.resolve(process.cwd(), skillPath);
+      if (fs24.existsSync(fullPath)) {
         console.error(`[${SERVER_NAME}] Skill exists for ${getAgentLabel2(agentType)} \u2014 skipping`);
         return;
       }
-      const dir = path29.dirname(fullPath);
-      if (!fs28.existsSync(dir)) fs28.mkdirSync(dir, { recursive: true });
-      fs28.writeFileSync(fullPath, generateSkill2(agentType), "utf-8");
+      const dir = path25.dirname(fullPath);
+      if (!fs24.existsSync(dir)) fs24.mkdirSync(dir, { recursive: true });
+      fs24.writeFileSync(fullPath, generateSkill2(agentType), "utf-8");
       console.error(`[${SERVER_NAME}] Auto-created ${skillPath} for ${getAgentLabel2(agentType)}`);
       const secondaryFiles = getSecondaryFiles2(agentType);
       for (const sf of secondaryFiles) {
-        const sfPath = path29.resolve(process.cwd(), sf.path);
-        const sfDir = path29.dirname(sfPath);
-        if (!fs28.existsSync(sfPath)) {
-          if (!fs28.existsSync(sfDir)) fs28.mkdirSync(sfDir, { recursive: true });
-          fs28.writeFileSync(sfPath, sf.content, "utf-8");
+        const sfPath = path25.resolve(process.cwd(), sf.path);
+        const sfDir = path25.dirname(sfPath);
+        if (!fs24.existsSync(sfPath)) {
+          if (!fs24.existsSync(sfDir)) fs24.mkdirSync(sfDir, { recursive: true });
+          fs24.writeFileSync(sfPath, sf.content, "utf-8");
           console.error(`[${SERVER_NAME}] Auto-created ${sf.path}`);
         }
       }
@@ -11776,17 +10071,6 @@ async function main() {
       } catch (err) {
         console.error(`[${SERVER_NAME}] \u26A0\uFE0F Graph auto-population: ${err}`);
       }
-      try {
-        const fs28 = await import("fs");
-        const path29 = await import("path");
-        const scratchDir = path29.resolve(process.cwd(), ".kuma", "scratch");
-        if (!fs28.existsSync(scratchDir)) {
-          fs28.mkdirSync(scratchDir, { recursive: true });
-          console.error(`[${SERVER_NAME}] \u2705 Created .kuma/scratch/ for temporary debug artifacts`);
-        }
-      } catch (err) {
-        console.error(`[${SERVER_NAME}] \u26A0\uFE0F Scratch directory setup: ${err}`);
-      }
       try {
         const { getDb: getDb2, saveDb: saveDb2 } = await Promise.resolve().then(() => (init_kumaDb(), kumaDb_exports));
         const db = await getDb2();
@@ -11839,22 +10123,7 @@ async function main() {
     `[${SERVER_NAME}] Session started: ${(/* @__PURE__ */ new Date()).toISOString()}`
   );
   console.error(
-    `[${SERVER_NAME}] Kuma v2.0 \u2014 Zero-Overhead Autonomous Brain Engine`
-  );
-  console.error(
-    `[${SERVER_NAME}] \u26A1 Auto-init: no manual init needed (Pilar 1)`
-  );
-  console.error(
-    `[${SERVER_NAME}] \u{1F4DB} Namespace normalized: kuma_kuma_* \u2192 kuma_* (Pilar 2)`
-  );
-  console.error(
-    `[${SERVER_NAME}] \u{1F9F9} Noise filter: AST node types rejected (Pilar 4)`
-  );
-  console.error(
-    `[${SERVER_NAME}] \u{1F419} Git auto-harvester installed (Pilar 5)`
-  );
-  console.error(
-    `[${SERVER_NAME}] \u{1F6E1}\uFE0F 3 coarse-grained tools: kuma_context, kuma_memory, kuma_safety`
+    `[${SERVER_NAME}] \u{1F6E1}\uFE0F 3 coarse-grained tools: kuma_context, kuma_memory, kuma_safety \u2014 13 core actions`
   );
   await server.connect(transport);
   console.error(