@plumpslabs/kuma 2.3.20 → 2.3.23

package/dist/chunk-3BRBJZ7P.js

@@ -1,1055 +0,0 @@
-import {
-  getKumaDir
-} from "./chunk-E2KFPEBT.js";
-
-// src/engine/kumaDb.ts
-import initSqlJs from "sql.js";
-import fs from "fs";
-import path from "path";
-var DB_FILENAME = "kuma.db";
-var dbInstance = null;
-var initPromise = null;
-function resetDbInstance() {
-  dbInstance = null;
-  initPromise = null;
-}
-async function getDb() {
-  if (dbInstance) return dbInstance;
-  if (initPromise) return initPromise;
-  initPromise = initDb();
-  return initPromise;
-}
-async function initDb() {
-  const SQL = await initSqlJs();
-  const kumaDir = getKumaDir();
-  const dbPath = path.join(kumaDir, DB_FILENAME);
-  if (!fs.existsSync(kumaDir)) {
-    fs.mkdirSync(kumaDir, { recursive: true });
-  }
-  let db;
-  if (fs.existsSync(dbPath)) {
-    const buffer = fs.readFileSync(dbPath);
-    db = new SQL.Database(buffer);
-  } else {
-    db = new SQL.Database();
-  }
-  db.run("PRAGMA journal_mode=WAL");
-  db.run("PRAGMA synchronous=NORMAL");
-  createSchema(db);
-  saveDb(db);
-  dbInstance = db;
-  return db;
-}
-var _saveTimeout = null;
-var _pendingDb = null;
-var SAVE_DEBOUNCE_MS = 100;
-function saveDb(db) {
-  const d = db ?? dbInstance;
-  if (!d) return;
-  _pendingDb = d;
-  if (_saveTimeout) return;
-  _saveTimeout = setTimeout(() => {
-    _saveTimeout = null;
-    const targetDb = _pendingDb;
-    _pendingDb = null;
-    if (!targetDb) return;
-    try {
-      const kumaDir = getKumaDir();
-      const dbPath = path.join(kumaDir, DB_FILENAME);
-      const data = targetDb.export();
-      const buffer = Buffer.from(data);
-      fs.writeFileSync(dbPath, buffer);
-    } catch (err) {
-      console.error(`[KumaDB] Failed to save database: ${err}`);
-    }
-  }, SAVE_DEBOUNCE_MS);
-}
-function createSchema(db) {
-  db.run(`CREATE TABLE IF NOT EXISTS nodes (
-    id TEXT PRIMARY KEY,
-    type TEXT NOT NULL,
-    name TEXT NOT NULL,
-    file_path TEXT,
-    metadata TEXT DEFAULT '{}',
-    created_at INTEGER NOT NULL DEFAULT (strftime('%s','now')),
-    updated_at INTEGER NOT NULL DEFAULT (strftime('%s','now'))
-  )`);
-  db.run(`CREATE TABLE IF NOT EXISTS edges (
-    id INTEGER PRIMARY KEY AUTOINCREMENT,
-    source_id TEXT NOT NULL REFERENCES nodes(id),
-    target_id TEXT NOT NULL REFERENCES nodes(id),
-    type TEXT NOT NULL CHECK(type IN ('calls','imports','defines','tests','routes','implements','extends','depends_on','owns','modified_by','contains','composes','flows_through','triggers','syncs_with')),
-    weight REAL DEFAULT 1.0,
-    metadata TEXT DEFAULT '{}',
-    created_at INTEGER NOT NULL DEFAULT (strftime('%s','now')),
-    UNIQUE(source_id, target_id, type)
-  )`);
-  try {
-    const schema = db.exec(`SELECT sql FROM sqlite_master WHERE type='table' AND name='edges'`);
-    const edgeSql = schema[0]?.values?.[0]?.[0] || "";
-    if (edgeSql.includes("flows_through") === false) {
-      db.run(`ALTER TABLE edges RENAME TO edges_old`);
-      db.run(`CREATE TABLE IF NOT EXISTS edges (
-        id INTEGER PRIMARY KEY AUTOINCREMENT,
-        source_id TEXT NOT NULL REFERENCES nodes(id),
-        target_id TEXT NOT NULL REFERENCES nodes(id),
-        type TEXT NOT NULL CHECK(type IN ('calls','imports','defines','tests','routes','implements','extends','depends_on','owns','modified_by','contains','composes','flows_through','triggers','syncs_with')),
-        weight REAL DEFAULT 1.0,
-        metadata TEXT DEFAULT '{}',
-        created_at INTEGER NOT NULL DEFAULT (strftime('%s','now')),
-        UNIQUE(source_id, target_id, type)
-      )`);
-      db.run(`INSERT OR IGNORE INTO edges SELECT * FROM edges_old`);
-      db.run(`DROP TABLE edges_old`);
-    }
-  } catch {
-  }
-  db.run(`CREATE TABLE IF NOT EXISTS sessions (
-    id INTEGER PRIMARY KEY AUTOINCREMENT,
-    started_at INTEGER NOT NULL,
-    ended_at INTEGER,
-    goal TEXT,
-    tool_calls INTEGER DEFAULT 0,
-    edits INTEGER DEFAULT 0,
-    rollbacks INTEGER DEFAULT 0,
-    failures INTEGER DEFAULT 0,
-    safety_score INTEGER
-  )`);
-  db.run(`CREATE TABLE IF NOT EXISTS tool_calls (
-    id INTEGER PRIMARY KEY AUTOINCREMENT,
-    session_id INTEGER REFERENCES sessions(id),
-    tool_name TEXT NOT NULL,
-    params TEXT,
-    success INTEGER DEFAULT 1,
-    duration_ms INTEGER,
-    created_at INTEGER NOT NULL DEFAULT (strftime('%s','now'))
-  )`);
-  db.run(`CREATE TABLE IF NOT EXISTS experiences (
-    id INTEGER PRIMARY KEY AUTOINCREMENT,
-    tool_name TEXT NOT NULL,
-    params_hash TEXT NOT NULL,
-    success INTEGER NOT NULL DEFAULT 1,
-    duration_ms INTEGER,
-    error_pattern TEXT,
-    context_file TEXT,
-    context_action TEXT,
-    created_at INTEGER NOT NULL DEFAULT (strftime('%s','now'))
-  )`);
-  db.run(`CREATE TABLE IF NOT EXISTS experience_patterns (
-    id INTEGER PRIMARY KEY AUTOINCREMENT,
-    antecedent_tool TEXT NOT NULL,
-    antecedent_hash TEXT NOT NULL,
-    consequent_tool TEXT NOT NULL,
-    confidence REAL DEFAULT 0.0,
-    count INTEGER DEFAULT 1,
-    avg_duration_ms INTEGER DEFAULT 0,
-    success_rate REAL DEFAULT 1.0,
-    last_seen_at INTEGER NOT NULL DEFAULT (strftime('%s','now')),
-    UNIQUE(antecedent_tool, antecedent_hash, consequent_tool)
-  )`);
-  db.run(`CREATE TABLE IF NOT EXISTS research_cache (
-    id INTEGER PRIMARY KEY AUTOINCREMENT,
-    scope TEXT NOT NULL UNIQUE,
-    version INTEGER DEFAULT 1,
-    confidence REAL DEFAULT 0.0,
-    content_hash TEXT,
-    record TEXT NOT NULL,
-    created_at INTEGER NOT NULL DEFAULT (strftime('%s','now')),
-    updated_at INTEGER NOT NULL DEFAULT (strftime('%s','now'))
-  )`);
-  db.run(`CREATE TABLE IF NOT EXISTS change_log (
-    id INTEGER PRIMARY KEY AUTOINCREMENT,
-    session_id INTEGER REFERENCES sessions(id),
-    file_path TEXT NOT NULL,
-    change_type TEXT NOT NULL CHECK(change_type IN ('modified','created','deleted','renamed')),
-    symbol TEXT,
-    diff_summary TEXT,
-    git_commit_hash TEXT,
-    previous_content TEXT DEFAULT NULL,
-    current_content TEXT DEFAULT NULL,
-    created_at INTEGER NOT NULL DEFAULT (strftime('%s','now'))
-  )`);
-  db.run(`CREATE TABLE IF NOT EXISTS health_snapshots (
-    id INTEGER PRIMARY KEY AUTOINCREMENT,
-    score INTEGER NOT NULL,
-    risk_level TEXT NOT NULL DEFAULT 'low',
-    checks TEXT DEFAULT '[]',
-    summary TEXT,
-    created_at INTEGER NOT NULL DEFAULT (strftime('%s','now'))
-  )`);
-  try {
-    db.run(`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 '{}'
-    )`);
-  } catch {
-  }
-  db.run(`CREATE TABLE IF NOT EXISTS todos (
-    id INTEGER PRIMARY KEY AUTOINCREMENT,
-    title TEXT NOT NULL,
-    description TEXT DEFAULT '',
-    scope TEXT DEFAULT '',
-    deps TEXT DEFAULT '[]',
-    success_criteria TEXT DEFAULT '',
-    status TEXT NOT NULL DEFAULT 'pending' CHECK(status IN ('pending','active','done','cancelled')),
-    session_id INTEGER,
-    file_paths TEXT DEFAULT '[]',
-    created_at INTEGER NOT NULL DEFAULT (strftime('%s','now')),
-    updated_at INTEGER NOT NULL DEFAULT (strftime('%s','now'))
-  )`);
-  db.run(`CREATE TABLE IF NOT EXISTS security_findings (
-    id INTEGER PRIMARY KEY AUTOINCREMENT,
-    file_path TEXT NOT NULL,
-    line_number INTEGER,
-    pattern TEXT NOT NULL,
-    severity TEXT NOT NULL DEFAULT 'medium' CHECK(severity IN ('low','medium','high','critical')),
-    message TEXT NOT NULL,
-    suggestion TEXT,
-    created_at INTEGER NOT NULL DEFAULT (strftime('%s','now'))
-  )`);
-  db.run(`CREATE TABLE IF NOT EXISTS api_endpoints (
-    id INTEGER PRIMARY KEY AUTOINCREMENT,
-    method TEXT NOT NULL,
-    path TEXT NOT NULL,
-    params TEXT DEFAULT '{}',
-    returns TEXT DEFAULT '{}',
-    auth TEXT,
-    handler_file TEXT,
-    created_at INTEGER NOT NULL DEFAULT (strftime('%s','now')),
-    UNIQUE(method, path)
-  )`);
-  db.run(`CREATE TABLE IF NOT EXISTS patterns (
-    id INTEGER PRIMARY KEY AUTOINCREMENT,
-    pattern_type TEXT NOT NULL,
-    before_code TEXT,
-    after_code TEXT,
-    description TEXT,
-    file_path TEXT,
-    matched_files TEXT DEFAULT '[]',
-    created_at INTEGER NOT NULL DEFAULT (strftime('%s','now'))
-  )`);
-  db.run(`CREATE TABLE IF NOT EXISTS context_notes (
-    id INTEGER PRIMARY KEY AUTOINCREMENT,
-    source TEXT NOT NULL,
-    content TEXT NOT NULL,
-    scope TEXT DEFAULT '',
-    file_paths TEXT DEFAULT '[]',
-    created_at INTEGER NOT NULL DEFAULT (strftime('%s','now'))
-  )`);
-  db.run(`CREATE TABLE IF NOT EXISTS benchmarks (
-    id INTEGER PRIMARY KEY AUTOINCREMENT,
-    label TEXT NOT NULL,
-    timestamp INTEGER NOT NULL,
-    metrics TEXT NOT NULL DEFAULT '{}',
-    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'))
-  )`);
-  db.run(`CREATE TABLE IF NOT EXISTS file_summaries (
-    id INTEGER PRIMARY KEY AUTOINCREMENT,
-    file_path TEXT NOT NULL UNIQUE,
-    summary TEXT,
-    exports TEXT DEFAULT '[]',
-    imports TEXT DEFAULT '[]',
-    content_hash TEXT,
-    file_size INTEGER DEFAULT 0,
-    created_at INTEGER NOT NULL DEFAULT (strftime('%s','now')),
-    updated_at INTEGER NOT NULL DEFAULT (strftime('%s','now'))
-  )`);
-  db.run(`CREATE TABLE IF NOT EXISTS otel_config (
-    id INTEGER PRIMARY KEY AUTOINCREMENT,
-    endpoint TEXT,
-    service_name TEXT DEFAULT 'kuma',
-    enabled INTEGER DEFAULT 0,
-    created_at INTEGER NOT NULL DEFAULT (strftime('%s','now'))
-  )`);
-  db.run(`CREATE TABLE IF NOT EXISTS cost_tracking (
-    id INTEGER PRIMARY KEY AUTOINCREMENT,
-    session_id INTEGER REFERENCES sessions(id),
-    tool_name TEXT NOT NULL,
-    token_estimate INTEGER DEFAULT 0,
-    cost_estimate REAL DEFAULT 0.0,
-    budget_limit REAL DEFAULT 0.0,
-    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,
-    runner TEXT NOT NULL,
-    test_command TEXT NOT NULL,
-    passed INTEGER NOT NULL,
-    output TEXT,
-    duration_ms INTEGER,
-    created_at INTEGER NOT NULL DEFAULT (strftime('%s','now'))
-  )`);
-  db.exec(`
-    CREATE TABLE IF NOT EXISTS blackboard_events (
-      id INTEGER PRIMARY KEY AUTOINCREMENT,
-      type TEXT NOT NULL,
-      source TEXT NOT NULL,
-      topic TEXT NOT NULL,
-      payload TEXT NOT NULL DEFAULT '{}',
-      severity TEXT NOT NULL DEFAULT 'info'
-        CHECK(severity IN ('info','warning','critical')),
-      tags TEXT DEFAULT '[]',
-      created_at INTEGER NOT NULL DEFAULT (strftime('%s','now'))
-    );
-  `);
-  db.exec(`CREATE INDEX IF NOT EXISTS idx_bb_type ON blackboard_events(type)`);
-  db.exec(`CREATE INDEX IF NOT EXISTS idx_bb_topic ON blackboard_events(topic)`);
-  db.exec(`CREATE INDEX IF NOT EXISTS idx_bb_severity ON blackboard_events(severity)`);
-  db.exec(`CREATE INDEX IF NOT EXISTS idx_bb_created ON blackboard_events(created_at)`);
-  db.exec(`
-    CREATE TABLE IF NOT EXISTS known_gotchas (
-      id INTEGER PRIMARY KEY AUTOINCREMENT,
-      file_path TEXT NOT NULL,
-      description TEXT NOT NULL,
-      severity TEXT NOT NULL DEFAULT 'medium'
-        CHECK(severity IN ('low','medium','high','critical')),
-      workaround TEXT,
-      added_by TEXT DEFAULT 'agent',
-      created_at INTEGER NOT NULL DEFAULT (strftime('%s','now')),
-      updated_at INTEGER NOT NULL DEFAULT (strftime('%s','now'))
-    );
-  `);
-  db.exec(`CREATE INDEX IF NOT EXISTS idx_gotchas_file ON known_gotchas(file_path)`);
-  db.exec(`CREATE INDEX IF NOT EXISTS idx_gotchas_severity ON known_gotchas(severity)`);
-  db.exec(`
-    CREATE TABLE IF NOT EXISTS trajectories (
-      id INTEGER PRIMARY KEY AUTOINCREMENT,
-      goal TEXT NOT NULL,
-      steps TEXT NOT NULL DEFAULT '[]',
-      total_duration_ms INTEGER DEFAULT 0,
-      success_rate REAL DEFAULT 0.0,
-      complexity INTEGER DEFAULT 0,
-      created_at INTEGER NOT NULL DEFAULT (strftime('%s','now'))
-    );
-  `);
-  db.exec(`CREATE INDEX IF NOT EXISTS idx_traj_goal ON trajectories(goal)`);
-  db.exec(`CREATE INDEX IF NOT EXISTS idx_traj_complexity ON trajectories(complexity)`);
-  db.exec(`CREATE INDEX IF NOT EXISTS idx_traj_created ON trajectories(created_at)`);
-  db.exec(`
-    CREATE TABLE IF NOT EXISTS distilled_skills (
-      id INTEGER PRIMARY KEY AUTOINCREMENT,
-      name TEXT NOT NULL UNIQUE,
-      description TEXT NOT NULL,
-      pattern TEXT NOT NULL,
-      parameters TEXT DEFAULT '[]',
-      success_count INTEGER DEFAULT 1,
-      avg_duration_ms INTEGER DEFAULT 0,
-      source_trajectory_id INTEGER,
-      last_used_at INTEGER,
-      created_at INTEGER NOT NULL DEFAULT (strftime('%s','now'))
-    );
-  `);
-  db.exec(`CREATE INDEX IF NOT EXISTS idx_skills_name ON distilled_skills(name)`);
-  db.exec(`CREATE INDEX IF NOT EXISTS idx_skills_used ON distilled_skills(last_used_at)`);
-  db.run(`CREATE TABLE IF NOT EXISTS portability_entries (
-    id INTEGER PRIMARY KEY AUTOINCREMENT,
-    entry_type TEXT NOT NULL,
-    relative_path TEXT NOT NULL,
-    absolute_path TEXT,
-    status TEXT DEFAULT 'ok',
-    created_at INTEGER NOT NULL DEFAULT (strftime('%s','now'))
-  )`);
-  try {
-    db.run(`CREATE VIRTUAL TABLE IF NOT EXISTS nodes_fts USING fts5(
-      name, metadata, content='nodes', content_rowid='rowid'
-    )`);
-  } catch {
-    console.warn("[KumaDB] FTS5 not available, full-text search disabled");
-  }
-  db.run(`CREATE INDEX IF NOT EXISTS idx_nodes_type ON nodes(type)`);
-  db.run(`CREATE INDEX IF NOT EXISTS idx_nodes_name ON nodes(name)`);
-  db.run(`CREATE INDEX IF NOT EXISTS idx_nodes_updated ON nodes(updated_at)`);
-  db.run(`CREATE INDEX IF NOT EXISTS idx_edges_source ON edges(source_id)`);
-  db.run(`CREATE INDEX IF NOT EXISTS idx_edges_target ON edges(target_id)`);
-  db.run(`CREATE INDEX IF NOT EXISTS idx_edges_type ON edges(type)`);
-  db.run(`CREATE INDEX IF NOT EXISTS idx_edges_updated ON edges(created_at)`);
-  db.run(`CREATE INDEX IF NOT EXISTS idx_tool_calls_session ON tool_calls(session_id)`);
-  db.run(`CREATE INDEX IF NOT EXISTS idx_tool_calls_created ON tool_calls(created_at)`);
-  db.run(`CREATE INDEX IF NOT EXISTS idx_experiences_tool ON experiences(tool_name)`);
-  db.run(`CREATE INDEX IF NOT EXISTS idx_experiences_hash ON experiences(params_hash)`);
-  db.run(`CREATE INDEX IF NOT EXISTS idx_experiences_created ON experiences(created_at)`);
-  db.run(`CREATE INDEX IF NOT EXISTS idx_patterns_antecedent ON experience_patterns(antecedent_tool)`);
-  db.run(`CREATE INDEX IF NOT EXISTS idx_patterns_confidence ON experience_patterns(confidence DESC)`);
-  db.run(`CREATE INDEX IF NOT EXISTS idx_research_scope ON research_cache(scope)`);
-  db.run(`CREATE INDEX IF NOT EXISTS idx_research_updated ON research_cache(updated_at)`);
-  db.run(`CREATE INDEX IF NOT EXISTS idx_change_log_session ON change_log(session_id)`);
-  db.run(`CREATE INDEX IF NOT EXISTS idx_change_log_file ON change_log(file_path)`);
-  db.run(`CREATE INDEX IF NOT EXISTS idx_change_log_created ON change_log(created_at)`);
-  db.run(`CREATE INDEX IF NOT EXISTS idx_health_created ON health_snapshots(created_at)`);
-  db.run(`CREATE INDEX IF NOT EXISTS idx_todos_status ON todos(status)`);
-  db.run(`CREATE INDEX IF NOT EXISTS idx_todos_scope ON todos(scope)`);
-  db.run(`CREATE INDEX IF NOT EXISTS idx_security_file ON security_findings(file_path)`);
-  db.run(`CREATE INDEX IF NOT EXISTS idx_security_severity ON security_findings(severity)`);
-  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)`);
-  db.run(`CREATE INDEX IF NOT EXISTS idx_audit_risk ON safety_audit(risk_level)`);
-  db.run(`CREATE INDEX IF NOT EXISTS idx_audit_allowed ON safety_audit(allowed)`);
-}
-async function getResearchCache(scope) {
-  try {
-    const db = await getDb();
-    const stmt = db.prepare("SELECT record, content_hash, updated_at FROM research_cache WHERE scope = ?");
-    stmt.bind([scope]);
-    if (stmt.step()) {
-      const row = stmt.getAsObject();
-      stmt.free();
-      return row.record;
-    }
-    stmt.free();
-    return null;
-  } catch {
-    return null;
-  }
-}
-async function saveResearchCache(scope, record, contentHash, confidence) {
-  try {
-    const db = await getDb();
-    const stmt = db.prepare("SELECT id FROM research_cache WHERE scope = ?");
-    stmt.bind([scope]);
-    const hasExisting = stmt.step();
-    stmt.free();
-    if (hasExisting) {
-      db.run(
-        `UPDATE research_cache SET record = ?, content_hash = COALESCE(?, content_hash), confidence = COALESCE(?, confidence), version = version + 1, updated_at = strftime('%s','now') WHERE scope = ?`,
-        [record, contentHash || null, confidence ?? null, scope]
-      );
-    } else {
-      db.run(
-        `INSERT INTO research_cache (scope, record, content_hash, confidence, version) VALUES (?, ?, ?, ?, 1)`,
-        [scope, record, contentHash || null, confidence ?? null]
-      );
-    }
-    saveDb();
-  } catch (err) {
-    console.error(`[KumaDB] Failed to save research cache: ${err}`);
-  }
-}
-async function listResearchCache() {
-  try {
-    const db = await getDb();
-    const stmt = db.prepare(`SELECT scope, version, confidence, created_at, updated_at FROM research_cache ORDER BY updated_at DESC`);
-    const results = [];
-    while (stmt.step()) results.push(stmt.getAsObject());
-    stmt.free();
-    if (results.length === 0) return "\u{1F4DA} **Research Cache** \u2014 No cached research found.";
-    const lines = [`\u{1F4DA} **Research Cache** \u2014 ${results.length} scope(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\u2501\u2501\u2501
-`];
-    for (const r of results) {
-      const conf = (r.confidence || 0) * 100;
-      const updatedAt = new Date(r.updated_at * 1e3);
-      const ageDays = Math.floor((Date.now() - updatedAt.getTime()) / 864e5);
-      const ageStr = ageDays > 0 ? `${ageDays}d ago` : `${Math.floor((Date.now() - updatedAt.getTime()) / 36e5)}h ago`;
-      const freshness = ageDays > 7 ? "\u{1F7E1}" : ageDays > 1 ? "\u{1F7E2}" : "\u{1F195}";
-      lines.push(`  ${freshness} **${r.scope}** (v${r.version}) \u2014 ${conf.toFixed(0)}% | ${ageStr}`);
-    }
-    return lines.join("\n");
-  } catch (err) {
-    return `Error: ${err}`;
-  }
-}
-async function recordChange(entry) {
-  try {
-    const db = await getDb();
-    const root = process.cwd();
-    const fullPath = path.resolve(root, entry.filePath);
-    let previousContent = null;
-    if (entry.changeType === "modified" && fs.existsSync(fullPath)) {
-      try {
-        previousContent = fs.readFileSync(fullPath, "utf-8");
-      } catch {
-      }
-    } else if (entry.changeType === "created") {
-      previousContent = "";
-    }
-    db.run(
-      `INSERT INTO change_log (session_id, file_path, change_type, symbol, diff_summary, git_commit_hash, previous_content) VALUES (?, ?, ?, ?, ?, ?, ?)`,
-      [entry.sessionId ?? null, entry.filePath, entry.changeType, entry.symbol ?? null, entry.diffSummary ?? null, entry.gitCommitHash ?? null, previousContent]
-    );
-    saveDb();
-  } catch (err) {
-    console.error(`[KumaDB] Failed to record change: ${err}`);
-  }
-}
-async function rollbackChange(changeId) {
-  try {
-    const db = await getDb();
-    const stmt = db.prepare("SELECT * FROM change_log WHERE id = ?");
-    stmt.bind([changeId]);
-    if (!stmt.step()) {
-      stmt.free();
-      return `\u274C Change #${changeId} not found.`;
-    }
-    const row = stmt.getAsObject();
-    stmt.free();
-    const filePath = row.file_path;
-    const changeType = row.change_type;
-    const previousContent = row.previous_content;
-    const root = process.cwd();
-    const fullPath = path.resolve(root, filePath);
-    if (changeType === "deleted") {
-      if (previousContent === null) return `\u274C Cannot rollback deletion \u2014 no content stored.`;
-      const dir = path.dirname(fullPath);
-      if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
-      fs.writeFileSync(fullPath, previousContent, "utf-8");
-      await recordChange({ filePath, changeType: "created", diffSummary: `Rollback of #${changeId} (was deleted)` });
-      return `\u2705 Rollback \u2014 restored deleted file "${filePath}" (#${changeId})`;
-    }
-    if (previousContent === null) return `\u274C Cannot rollback #${changeId} \u2014 no content captured.`;
-    if (!fs.existsSync(fullPath) && changeType === "modified") return `\u274C File "${filePath}" no longer exists.`;
-    if (changeType === "created" && previousContent === "") {
-      if (fs.existsSync(fullPath)) fs.unlinkSync(fullPath);
-      await recordChange({ filePath, changeType: "deleted", diffSummary: `Rollback of #${changeId} (was created)` });
-      return `\u2705 Rollback \u2014 deleted "${filePath}" (#${changeId})`;
-    }
-    fs.writeFileSync(fullPath, previousContent, "utf-8");
-    await recordChange({ filePath, changeType, diffSummary: `Rollback of #${changeId} (restored previous content)` });
-    return `\u2705 Rollback \u2014 reverted "${filePath}" to state before #${changeId}`;
-  } catch (err) {
-    return `\u274C Rollback failed: ${err}`;
-  }
-}
-async function getChanges(params) {
-  try {
-    const db = await getDb();
-    const { sessionId, filePath, since, limit = 50 } = params;
-    let sql = `SELECT cl.*, s.goal FROM change_log cl LEFT JOIN sessions s ON s.id = cl.session_id WHERE 1=1`;
-    const bind = [];
-    if (sessionId) {
-      sql += ` AND cl.session_id = ?`;
-      bind.push(sessionId);
-    }
-    if (filePath) {
-      sql += ` AND cl.file_path LIKE ?`;
-      bind.push(`%${filePath}%`);
-    }
-    if (since) {
-      sql += ` AND cl.created_at >= ?`;
-      bind.push(since);
-    }
-    sql += ` ORDER BY cl.created_at DESC LIMIT ?`;
-    bind.push(limit);
-    const stmt = db.prepare(sql);
-    stmt.bind(bind);
-    const results = [];
-    while (stmt.step()) results.push(stmt.getAsObject());
-    stmt.free();
-    if (results.length === 0) return "No changes found.";
-    const lines = [`\u{1F4CB} Change Log \u2014 ${results.length} change(s)`];
-    for (const r of results) {
-      const icon = r.change_type === "deleted" ? "\u274C" : r.change_type === "created" ? "\u2728" : "\u{1F4DD}";
-      lines.push(`  ${icon} [#${r.id}] ${r.file_path} (${r.change_type})${r.previous_content ? " \u{1F504}" : ""}`);
-      if (r.symbol) lines.push(`     Symbol: ${r.symbol}`);
-      if (r.goal) lines.push(`     Goal: ${r.goal}`);
-    }
-    return lines.join("\n");
-  } catch (err) {
-    return `Error: ${err}`;
-  }
-}
-async function addTodo(params) {
-  try {
-    const db = await getDb();
-    db.run(
-      `INSERT INTO todos (title, description, scope, deps, success_criteria) VALUES (?, ?, ?, ?, ?)`,
-      [params.title, params.description || "", params.scope || "", params.deps || "[]", params.successCriteria || ""]
-    );
-    saveDb();
-    return `\u2705 Todo added: "${params.title}"`;
-  } catch (err) {
-    return `\u274C Failed to add todo: ${err}`;
-  }
-}
-async function listTodos(scope, status) {
-  try {
-    const db = await getDb();
-    let sql = `SELECT * FROM todos WHERE 1=1`;
-    const bind = [];
-    if (scope) {
-      sql += ` AND scope = ?`;
-      bind.push(scope);
-    }
-    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 todos found.`;
-    const lines = [`\u{1F4CB} Todo List \u2014 ${results.length} item(s)
-`];
-    for (const t of results) {
-      const icon = t.status === "done" ? "\u2705" : t.status === "active" ? "\u{1F504}" : t.status === "cancelled" ? "\u274C" : "\u23F3";
-      lines.push(`  ${icon} [#${t.id}] ${t.title} (${t.status})`);
-      if (t.scope) lines.push(`     Scope: ${t.scope}`);
-      if (t.success_criteria) lines.push(`     Success: ${t.success_criteria}`);
-    }
-    return lines.join("\n");
-  } catch (err) {
-    return `Error: ${err}`;
-  }
-}
-async function updateTodoStatus(id, status) {
-  try {
-    const db = await getDb();
-    db.run(`UPDATE todos SET status = ?, updated_at = strftime('%s','now') WHERE id = ?`, [status, id]);
-    saveDb();
-    return `\u2705 Todo #${id} updated to "${status}"`;
-  } catch (err) {
-    return `\u274C Failed: ${err}`;
-  }
-}
-async function addSecurityFinding(finding) {
-  try {
-    const db = await getDb();
-    db.run(
-      `INSERT INTO security_findings (file_path, line_number, pattern, severity, message, suggestion) VALUES (?, ?, ?, ?, ?, ?)`,
-      [finding.filePath, finding.lineNumber || null, finding.pattern, finding.severity, finding.message, finding.suggestion || null]
-    );
-    saveDb();
-  } catch {
-  }
-}
-async function getSecurityFindings() {
-  try {
-    const db = await getDb();
-    const stmt = db.prepare(`SELECT * FROM security_findings ORDER BY severity DESC, created_at DESC LIMIT 50`);
-    const results = [];
-    while (stmt.step()) results.push(stmt.getAsObject());
-    stmt.free();
-    if (results.length === 0) return "\u{1F512} No security findings.";
-    const lines = [`\u{1F512} Security Findings \u2014 ${results.length}
-`];
-    for (const f of results) {
-      const icon = f.severity === "critical" ? "\u{1F534}" : f.severity === "high" ? "\u{1F7E0}" : f.severity === "medium" ? "\u{1F7E1}" : "\u{1F7E2}";
-      lines.push(`  ${icon} [${f.severity}] ${f.message} \u2014 ${f.file_path}${f.line_number ? `:${f.line_number}` : ""}`);
-    }
-    return lines.join("\n");
-  } catch (err) {
-    return `Error: ${err}`;
-  }
-}
-async function addContextNote(note) {
-  try {
-    const db = await getDb();
-    db.run(
-      `INSERT INTO context_notes (source, content, scope, file_paths) VALUES (?, ?, ?, ?)`,
-      [note.source, note.content, note.scope || "", note.filePaths || "[]"]
-    );
-    saveDb();
-    return `\u2705 Context note added from "${note.source}"`;
-  } catch (err) {
-    return `\u274C Failed: ${err}`;
-  }
-}
-async function listContextNotes(scope) {
-  try {
-    const db = await getDb();
-    let sql = `SELECT * FROM context_notes WHERE 1=1`;
-    const bind = [];
-    if (scope) {
-      sql += ` AND scope = ?`;
-      bind.push(scope);
-    }
-    sql += ` ORDER BY created_at DESC LIMIT 20`;
-    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{1F4DD} No context notes.";
-    const lines = [`\u{1F4DD} Context Notes \u2014 ${results.length}
-`];
-    for (const n of results) {
-      lines.push(`  \u{1F4CC} From: ${n.source} | Scope: ${n.scope || "general"}`);
-      lines.push(`     ${n.content.substring(0, 200)}`);
-    }
-    return lines.join("\n");
-  } catch (err) {
-    return `Error: ${err}`;
-  }
-}
-async function saveBenchmark(label, metrics) {
-  try {
-    const db = await getDb();
-    db.run(
-      `INSERT INTO benchmarks (label, timestamp, metrics) VALUES (?, ?, ?)`,
-      [label, Math.floor(Date.now() / 1e3), JSON.stringify(metrics)]
-    );
-    saveDb();
-    return `\u2705 Benchmark "${label}" saved.`;
-  } catch (err) {
-    return `\u274C Failed: ${err}`;
-  }
-}
-async function getBenchmarkDiff(labelA, labelB) {
-  try {
-    const db = await getDb();
-    const stmt = db.prepare(`SELECT * FROM benchmarks WHERE label = ? ORDER BY timestamp DESC LIMIT 1`);
-    stmt.bind([labelA]);
-    if (!stmt.step()) {
-      stmt.free();
-      return `\u274C Benchmark "${labelA}" not found.`;
-    }
-    const a = stmt.getAsObject();
-    stmt.free();
-    const metricsA = JSON.parse(a.metrics || "{}");
-    let diffLines = [`\u{1F4CA} Benchmark: ${labelA}
-`];
-    for (const [key, val] of Object.entries(metricsA)) {
-      diffLines.push(`  ${key}: ${val}`);
-    }
-    if (labelB) {
-      const stmt2 = db.prepare(`SELECT * FROM benchmarks WHERE label = ? ORDER BY timestamp DESC LIMIT 1`);
-      stmt2.bind([labelB]);
-      if (stmt2.step()) {
-        const b = stmt2.getAsObject();
-        const metricsB = JSON.parse(b.metrics || "{}");
-        diffLines.push(`
-\u{1F4CA} Diff: ${labelA} \u2192 ${labelB}
-`);
-        for (const key of Object.keys({ ...metricsA, ...metricsB })) {
-          const va = metricsA[key];
-          const vb = metricsB[key];
-          if (va !== void 0 && vb !== void 0 && typeof va === "number") {
-            const change = ((vb - va) / va * 100).toFixed(1);
-            const icon = parseFloat(change) > 0 ? "\u{1F4C8}" : parseFloat(change) < 0 ? "\u{1F4C9}" : "\u27A1\uFE0F";
-            diffLines.push(`  ${icon} ${key}: ${va} \u2192 ${vb} (${change}%)`);
-          }
-        }
-      }
-      stmt2.free();
-    }
-    return diffLines.join("\n");
-  } catch (err) {
-    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();
-    const stmt = db.prepare("SELECT summary, exports, imports, content_hash FROM file_summaries WHERE file_path = ?");
-    stmt.bind([filePath]);
-    if (stmt.step()) {
-      const row = stmt.getAsObject();
-      stmt.free();
-      return JSON.stringify(row);
-    }
-    stmt.free();
-    return null;
-  } catch {
-    return null;
-  }
-}
-async function saveFileSummary(params) {
-  try {
-    const db = await getDb();
-    db.run(
-      `INSERT OR REPLACE INTO file_summaries (file_path, summary, exports, imports, content_hash, file_size, updated_at) VALUES (?, ?, ?, ?, ?, ?, strftime('%s','now'))`,
-      [params.filePath, params.summary, params.exports || "[]", params.imports || "[]", params.contentHash || "", params.fileSize || 0]
-    );
-    saveDb();
-  } catch {
-  }
-}
-async function runGarbageCollection() {
-  try {
-    const db = await getDb();
-    let removed = 0;
-    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;
-    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')`);
-    try {
-      db.exec("VACUUM");
-    } catch {
-    }
-    saveDb();
-    return `\u{1F9F9} GC complete. Removed orphaned data. Database vacuumed.`;
-  } catch (err) {
-    return `\u274C GC failed: ${err}`;
-  }
-}
-async function runDoctor() {
-  try {
-    const db = await getDb();
-    const checks = [
-      "\u{1FA7A} **Kuma Doctor 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`,
-      ""
-    ];
-    try {
-      const integrity = db.exec("PRAGMA integrity_check");
-      const result = integrity[0]?.values[0]?.[0] || "ok";
-      checks.push(`**Database Integrity**: ${result === "ok" ? "\u2705" : "\u274C " + result}`);
-    } 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", "health_snapshots", "tool_calls", "experiences", "experience_patterns", "patterns", "api_endpoints", "otel_config", "cost_tracking", "scratch_entries", "portability_entries", "blackboard_events", "known_gotchas", "trajectories", "distilled_skills"];
-    let existing = 0;
-    for (const t of allTables) {
-      try {
-        if (db.exec(`SELECT name FROM sqlite_master WHERE type='table' AND name='${t}'`)[0]?.values?.length) existing++;
-      } catch {
-      }
-    }
-    const schemaHealth = existing === allTables.length ? "\u2705" : existing >= allTables.length * 0.8 ? "\u26A0\uFE0F" : "\u274C";
-    checks.push(`**Schema Health**: ${schemaHealth} ${existing}/${allTables.length} tables present`);
-    try {
-      const verifStmt = db.exec("SELECT scope, passed, created_at, duration_ms FROM verifications ORDER BY created_at DESC LIMIT 5");
-      if (verifStmt[0]?.values?.length) {
-        checks.push("");
-        checks.push("**Recent Verifications:**");
-        for (const v of verifStmt[0].values) {
-          const icon = v[1] ? "\u2705" : "\u{1F534}";
-          const time = new Date(v[2] * 1e3).toLocaleTimeString();
-          checks.push(`  ${icon} ${v[0]} (${v[3]}ms) \u2014 ${time}`);
-        }
-      }
-    } catch {
-    }
-    try {
-      const { execSync } = await import("child_process");
-      const psOutput = execSync(
-        `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();
-      if (psOutput) {
-        const processes = psOutput.split("\n").filter(Boolean);
-        checks.push("");
-        checks.push(`**Running Test Processes**: ${processes.length} found`);
-        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");
-      } else {
-        checks.push("");
-        checks.push("**Running Test Processes**: \u2705 None detected");
-      }
-    } catch {
-      checks.push("");
-      checks.push("**Running Test Processes**: \u26A0\uFE0F Could not check");
-    }
-    try {
-      const hourAgo = Math.floor((Date.now() - 36e5) / 1e3);
-      const recentVerifs = db.exec(`SELECT COUNT(*) as c FROM verifications WHERE created_at > ${hourAgo}`);
-      const count = recentVerifs[0]?.values[0]?.[0] || 0;
-      if (count > 10) {
-        checks.push("");
-        checks.push(`\u26A0\uFE0F **High Verification Rate**: ${count} verifications in the last hour \u2014 this is abnormal.`);
-        checks.push(`  \u{1F4A1} If you didn't request these, run \`pkill -f "pnpm test"\` to kill orphaned processes.`);
-      } else if (count > 0) {
-        checks.push("");
-        checks.push(`**Verification Rate**: ${count} verifications in the last hour (normal)`);
-      }
-    } catch {
-    }
-    return checks.join("\n");
-  } catch (err) {
-    return `\u274C Doctor failed: ${err}`;
-  }
-}
-async function checkPortability() {
-  try {
-    const root = process.cwd();
-    const issues = [];
-    const db = await getDb();
-    try {
-      const stmt = db.prepare(`SELECT id, file_path FROM change_log WHERE file_path LIKE ? LIMIT 10`);
-      stmt.bind([`${root}%`]);
-      if (stmt.step()) {
-        issues.push("\u26A0\uFE0F Change log contains absolute paths (migration needed)");
-      }
-      stmt.free();
-    } catch {
-    }
-    issues.push(`\u2705 All paths relative to: ${root.split("/").pop()}`);
-    return issues.join("\n");
-  } catch (err) {
-    return `\u274C Portability check failed: ${err}`;
-  }
-}
-async function ensureGitignore() {
-  try {
-    const root = process.cwd();
-    const gitignorePath = path.join(root, ".gitignore");
-    const kumaEntry = ".kuma/";
-    if (fs.existsSync(gitignorePath)) {
-      const content = fs.readFileSync(gitignorePath, "utf-8");
-      if (content.includes(kumaEntry)) {
-        return "\u2705 .kuma/ already in .gitignore";
-      }
-      fs.writeFileSync(gitignorePath, content.trimEnd() + "\n" + kumaEntry + "\n", "utf-8");
-    } else {
-      fs.writeFileSync(gitignorePath, kumaEntry + "\n", "utf-8");
-    }
-    return "\u2705 Added .kuma/ to .gitignore";
-  } catch (err) {
-    return `\u274C Failed: ${err}`;
-  }
-}
-async function saveHealthSnapshot(score, riskLevel, checks, summary) {
-  try {
-    const db = await getDb();
-    db.run(
-      `INSERT INTO health_snapshots (score, risk_level, checks, summary) VALUES (?, ?, ?, ?)`,
-      [score, riskLevel, checks, summary]
-    );
-    saveDb();
-  } catch (err) {
-    console.error(`[KumaDB] Failed to save health snapshot: ${err}`);
-  }
-}
-async function saveVerification(scope, runner, command, passed, output, durationMs = 0) {
-  try {
-    const db = await getDb();
-    db.run(
-      `INSERT INTO verifications (scope, runner, test_command, passed, output, duration_ms) VALUES (?, ?, ?, ?, ?, ?)`,
-      [scope, runner, command, passed ? 1 : 0, output, durationMs]
-    );
-    saveDb();
-  } catch (err) {
-    console.error(`[KumaDB] Failed to save verification: ${err}`);
-  }
-}
-async function getLatestVerifications(limit = 10) {
-  try {
-    const db = await getDb();
-    const res = db.exec(`SELECT id, scope, runner, test_command, passed, output, duration_ms, created_at FROM verifications ORDER BY created_at DESC LIMIT ${limit}`);
-    if (!res[0] || !res[0].values) return [];
-    return res[0].values.map((row) => ({
-      id: row[0],
-      scope: row[1],
-      runner: row[2],
-      test_command: row[3],
-      passed: Boolean(row[4]),
-      output: row[5],
-      duration_ms: row[6],
-      created_at: row[7]
-    }));
-  } catch (err) {
-    console.error(`[KumaDB] Failed to get verifications: ${err}`);
-    return [];
-  }
-}
-
-export {
-  resetDbInstance,
-  getDb,
-  saveDb,
-  getResearchCache,
-  saveResearchCache,
-  listResearchCache,
-  recordChange,
-  rollbackChange,
-  getChanges,
-  addTodo,
-  listTodos,
-  updateTodoStatus,
-  addSecurityFinding,
-  getSecurityFindings,
-  addContextNote,
-  listContextNotes,
-  saveBenchmark,
-  getBenchmarkDiff,
-  recordDecisionLog,
-  listDecisionLog,
-  updateDecisionStatus,
-  getFileSummary,
-  saveFileSummary,
-  runGarbageCollection,
-  runDoctor,
-  checkPortability,
-  ensureGitignore,
-  saveHealthSnapshot,
-  saveVerification,
-  getLatestVerifications
-};