remem-mcp 0.6.8 → 0.7.3

package/dist/index.js

@@ -1,45 +1,48 @@
 #!/usr/bin/env node
 import {
-  LocalEmbedder,
   Memory,
-  SQLiteBackend,
   classifyGlobalContent,
   findOutdatedPages,
   getWikiPage,
   ingestDirectory,
   ingestFile,
-  init_local,
-  local_exports,
   redact,
-  searchWiki,
-  stripQueryProperNouns
-} from "./chunk-X4ECGLYH.js";
+  searchWiki
+} from "./chunk-ITMR6THY.js";
 import {
   engine_exports,
   findCallees,
   findCallers,
-  generateId,
   impactAnalysis,
   indexDirectory,
   indexFile,
   init_engine,
-  init_ulid,
   listSymbols,
   searchSymbols
-} from "./chunk-FA324IBN.js";
+} from "./chunk-YU7WBJU5.js";
+import {
+  LocalEmbedder,
+  SQLiteBackend,
+  init_local,
+  local_exports,
+  stripQueryProperNouns
+} from "./chunk-4WCDAEPP.js";
+import {
+  generateId,
+  init_ulid
+} from "./chunk-XJGDYQ34.js";
 import {
   __dirname,
-  __require,
   __toCommonJS,
   init_esm_shims
-} from "./chunk-XK4Y53J2.js";
+} from "./chunk-ONQHLUGM.js";
 
 // src/index.ts
 init_esm_shims();
 import { createHash as createHash6 } from "crypto";
-import { existsSync as existsSync15, readdirSync, readFileSync as readFileSync12, statSync as statSync2 } from "fs";
-import { homedir as homedir12 } from "os";
-import { dirname as dirname10, join as join15 } from "path";
+import { existsSync as existsSync16, readdirSync as readdirSync2, readFileSync as readFileSync13, statSync as statSync3 } from "fs";
+import { homedir as homedir13 } from "os";
+import { dirname as dirname10, join as join16 } from "path";
 import { fileURLToPath as fileURLToPath4 } from "url";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import Database13 from "better-sqlite3";
@@ -47,6 +50,7 @@ import * as sqliteVec4 from "sqlite-vec";
 
 // src/artifact.ts
 init_esm_shims();
+init_ulid();
 import { createHash } from "crypto";
 import { appendFileSync, existsSync, mkdirSync, readFileSync } from "fs";
 import { dirname, join } from "path";
@@ -167,8 +171,8 @@ function importArtifact(dbPath, projectRoot) {
   const transaction = db.transaction(() => {
     for (const row of rows) {
       const result = insertStmt.run(
-        row.id,
-        row.session_key,
+        row.id ?? generateId(),
+        row.session_key ?? "import",
         row.agent_id,
         row.type,
         row.content,
@@ -190,7 +194,7 @@ function importArtifact(dbPath, projectRoot) {
   transaction();
   db.close();
   if (inserted > 0) {
-    console.log(
+    console.error(
       `[remem-mcp] Imported ${inserted} captures from team artifact (${skipped} already exist).`
     );
   }
@@ -718,6 +722,9 @@ async function demoCodegraph() {
   const distDir = dirname3(fileURLToPath2(import.meta.url));
   const indexPath = join3(distDir, "index.js");
   const cleanDb = new Database2(dbPath);
+  cleanDb.exec(`CREATE TABLE IF NOT EXISTS symbols (id TEXT PRIMARY KEY, repo_path TEXT NOT NULL, file_path TEXT NOT NULL, name TEXT NOT NULL, kind TEXT NOT NULL, line INTEGER, end_line INTEGER, created_at INTEGER NOT NULL)`);
+  cleanDb.exec(`CREATE TABLE IF NOT EXISTS calls (id TEXT PRIMARY KEY, repo_path TEXT NOT NULL, caller_id TEXT NOT NULL, callee_name TEXT NOT NULL, callee_id TEXT, call_line INTEGER, created_at INTEGER NOT NULL)`);
+  cleanDb.exec(`CREATE TABLE IF NOT EXISTS imports (id TEXT PRIMARY KEY, repo_path TEXT NOT NULL, file_path TEXT NOT NULL, module_path TEXT NOT NULL, imported_names TEXT, created_at INTEGER NOT NULL)`);
   cleanDb.exec("DELETE FROM calls");
   cleanDb.exec("DELETE FROM symbols");
   cleanDb.exec("DELETE FROM imports");
@@ -1004,7 +1011,7 @@ function extractRuleBasedFacts(content, type2) {
       if (fact.length > 10) facts.push({ text: fact, confidence: 0.85 });
     }
     const useMatch = text.match(/use\s+\S+\s+for\s+\S+/i);
-    if (useMatch && facts.length < 3) {
+    if (useMatch && useMatch.index !== void 0 && facts.length < 3) {
       const fact = text.slice(useMatch.index, useMatch.index + useMatch[0].length);
       if (fact.length > 10) facts.push({ text: fact, confidence: 0.8 });
     }
@@ -1125,7 +1132,9 @@ async function extractCommand(dbPath, flags) {
       captures = entry ? [entry] : [];
     } else {
       const allCaptures = await storage.listAll(limit, 0);
-      captures = allCaptures.filter((e) => ["decision", "learning", "error", "conversation"].includes(e.type));
+      captures = allCaptures.filter(
+        (e) => ["decision", "learning", "error", "conversation"].includes(e.type)
+      );
     }
     if (captures.length === 0) {
       console.log("No captures to extract atoms from.");
@@ -1175,8 +1184,10 @@ async function extractCommand(dbPath, flags) {
         console.error(`  ${capture.id}: FAILED \u2014 ${err}`);
       }
     }
-    console.log(`
-Done. Extracted ${totalAtoms} atom(s) from ${captures.length - skipped} capture(s).`);
+    console.log(
+      `
+Done. Extracted ${totalAtoms} atom(s) from ${captures.length - skipped} capture(s).`
+    );
     if (skipped > 0) console.log(`${skipped} capture(s) already had atoms (skipped).`);
     if (errors2 > 0) console.log(`${errors2} capture(s) failed.`);
   } finally {
@@ -1282,7 +1293,9 @@ async function personaCommand(dbPath, flags) {
     }
     const db = new Database3(dbPath, { readonly: true });
     try {
-      const row = db.prepare("SELECT content FROM persona WHERE team_id = ? AND user_id = ? ORDER BY updated_at DESC LIMIT 1").get(teamId, userId);
+      const row = db.prepare(
+        "SELECT content FROM persona WHERE team_id = ? AND user_id = ? ORDER BY updated_at DESC LIMIT 1"
+      ).get(teamId, userId);
       if (!row || !row.content) {
         console.log('No persona set. Use --set "trait: value" to add one.');
         return;
@@ -1521,7 +1534,7 @@ async function runPipelineWorker(opts, embedder) {
           type: cap.type,
           tags: cap.tags ? JSON.parse(cap.tags) : [],
           sessionKey: cap.session_key,
-          teamId: cap.team_id,
+          teamId: cap.team_id ?? void 0,
           userId: cap.user_id ?? void 0
         };
         const output2 = await pipeline.process(input, ctx);
@@ -1542,9 +1555,7 @@ async function runPipelineWorker(opts, embedder) {
       groups.get(key).push(a);
     }
     const existingScenarios = await storage.listScenarios({ limit: 100 });
-    const existingTopics = new Set(
-      existingScenarios.flatMap((s) => s.personaTags ?? [])
-    );
+    const existingTopics = new Set(existingScenarios.flatMap((s) => s.personaTags ?? []));
     for (const [topic, groupAtoms] of groups) {
       if (groupAtoms.length < consolidateThreshold) continue;
       if (existingTopics.has(topic)) continue;
@@ -1675,7 +1686,7 @@ function loadConfig() {
     model: model ?? "gpt-4o-mini"
   } : void 0;
   const fileSecurity = file?.security ?? {};
-  return {
+  const cfg = {
     storage: env.REMEM_STORAGE ?? file?.storage ?? "sqlite",
     pipeline: env.REMEM_PIPELINE ?? file?.pipeline ?? "noop",
     dbPath: env.REMEM_DB_PATH ?? file?.dbPath ?? defaultDbPath4,
@@ -1699,8 +1710,20 @@ function loadConfig() {
         fileSecurity.maxContentLength ?? 5e4
       ),
       auditLog: parseBool(env.REMEM_AUDIT_LOG, fileSecurity.auditLog ?? true)
-    }
+    },
+    offloadEnabled: parseBool(env.REMEM_OFFLOAD_ENABLED, false)
   };
+  if (env.REMEM_FLOW === "full") {
+    if (!env.REMEM_OFFLOAD_ENABLED) {
+      process.env.REMEM_OFFLOAD_ENABLED = "true";
+      cfg.offloadEnabled = true;
+    }
+    if (!env.REMEM_PIPELINE) {
+      process.env.REMEM_PIPELINE = "skill";
+      cfg.pipeline = "skill";
+    }
+  }
+  return cfg;
 }
 
 // src/doctor.ts
@@ -1861,7 +1884,7 @@ function errors(dbPath = defaultDbPath2()) {
   try {
     db = new Database5(dbPath, { readonly: true });
   } catch {
-    console.error("Error: Could not open database at", dbPath);
+    console.log("No database found. Run `remem-mcp setup` to get started.");
     process.exit(1);
   }
   console.log("remem-mcp errors \u2014 Error Learning Dashboard\n");
@@ -1980,7 +2003,7 @@ function errorsRetro(dbPath = defaultDbPath2()) {
   try {
     db = new Database5(dbPath, { readonly: true });
   } catch {
-    console.error("Error: Could not open database at", dbPath);
+    console.log("No database found. Run `remem-mcp setup` to get started.");
     process.exit(1);
   }
   console.log("remem-mcp errors retro \u2014 Session Retrospective\n");
@@ -2335,7 +2358,7 @@ function errorsDrift(dbPath = defaultDbPath2()) {
   try {
     db = new Database5(dbPath, { readonly: true });
   } catch {
-    console.error("Error: Could not open database at", dbPath);
+    console.log("No database found. Run `remem-mcp setup` to get started.");
     process.exit(1);
   }
   console.log("remem-mcp errors drift \u2014 Drift Detection Report\n");
@@ -2446,7 +2469,7 @@ function errorsLineage(dbPath = defaultDbPath2()) {
   try {
     db = new Database5(dbPath, { readonly: true });
   } catch {
-    console.error("Error: Could not open database at", dbPath);
+    console.log("No database found. Run `remem-mcp setup` to get started.");
     process.exit(1);
   }
   console.log("remem-mcp errors lineage \u2014 Fix Lineage Chains\n");
@@ -2615,7 +2638,7 @@ function errorsByGoal(dbPath = defaultDbPath2()) {
   try {
     db = new Database5(dbPath, { readonly: true });
   } catch {
-    console.error("Error: Could not open database at", dbPath);
+    console.log("No database found. Run `remem-mcp setup` to get started.");
     process.exit(1);
   }
   console.log("remem-mcp errors by-goal \u2014 Goal-Linked Error Report\n");
@@ -2672,7 +2695,7 @@ function errorsActions(dbPath = defaultDbPath2()) {
   try {
     db = new Database5(dbPath, { readonly: true });
   } catch {
-    console.error("Error: Could not open database at", dbPath);
+    console.log("No database found. Run `remem-mcp setup` to get started.");
     process.exit(1);
   }
   console.log("remem-mcp errors actions \u2014 Action Item Tracker\n");
@@ -2793,7 +2816,7 @@ function errorsSeverity(dbPath = defaultDbPath2()) {
   try {
     db = new Database5(dbPath, { readonly: true });
   } catch {
-    console.error("Error: Could not open database at", dbPath);
+    console.log("No database found. Run `remem-mcp setup` to get started.");
     process.exit(1);
   }
   console.log("remem-mcp errors severity \u2014 Impact Classification\n");
@@ -2904,7 +2927,7 @@ function errorsTemplates(dbPath = defaultDbPath2()) {
   try {
     db = new Database5(dbPath, { readonly: true });
   } catch {
-    console.error("Error: Could not open database at", dbPath);
+    console.log("No database found. Run `remem-mcp setup` to get started.");
     process.exit(1);
   }
   console.log("remem-mcp errors templates \u2014 Fix Template Extraction\n");
@@ -2976,7 +2999,7 @@ function errorsCorrelations(dbPath = defaultDbPath2()) {
   try {
     db = new Database5(dbPath, { readonly: true });
   } catch {
-    console.error("Error: Could not open database at", dbPath);
+    console.log("No database found. Run `remem-mcp setup` to get started.");
     process.exit(1);
   }
   console.log("remem-mcp errors correlations \u2014 Sequential Error Patterns\n");
@@ -3057,7 +3080,7 @@ function errorsPlaybooks(dbPath = defaultDbPath2()) {
   try {
     db = new Database5(dbPath, { readonly: true });
   } catch {
-    console.error("Error: Could not open database at", dbPath);
+    console.log("No database found. Run `remem-mcp setup` to get started.");
     process.exit(1);
   }
   console.log("remem-mcp errors playbooks \u2014 Recovery Pattern Library\n");
@@ -3125,7 +3148,7 @@ function errorsStale(dbPath = defaultDbPath2()) {
   try {
     db = new Database5(dbPath, { readonly: true });
   } catch {
-    console.error("Error: Could not open database at", dbPath);
+    console.log("No database found. Run `remem-mcp setup` to get started.");
     process.exit(1);
   }
   console.log("remem-mcp errors stale \u2014 Fix Staleness Report\n");
@@ -3203,7 +3226,7 @@ function errorsEscalations(dbPath = defaultDbPath2()) {
   try {
     db = new Database5(dbPath, { readonly: true });
   } catch {
-    console.error("Error: Could not open database at", dbPath);
+    console.log("No database found. Run `remem-mcp setup` to get started.");
     process.exit(1);
   }
   console.log("remem-mcp errors escalations \u2014 Escalation Policy Report\n");
@@ -3297,7 +3320,7 @@ function errorsContext(dbPath = defaultDbPath2()) {
   try {
     db = new Database5(dbPath, { readonly: true });
   } catch {
-    console.error("Error: Could not open database at", dbPath);
+    console.log("No database found. Run `remem-mcp setup` to get started.");
     process.exit(1);
   }
   console.log("remem-mcp errors context \u2014 Error Context Enrichment\n");
@@ -3371,7 +3394,7 @@ function errorsInherited(dbPath = defaultDbPath2()) {
   try {
     db = new Database5(dbPath, { readonly: true });
   } catch {
-    console.error("Error: Could not open database at", dbPath);
+    console.log("No database found. Run `remem-mcp setup` to get started.");
     process.exit(1);
   }
   console.log("remem-mcp errors inherited \u2014 Cross-Project Fix Inheritance\n");
@@ -3444,7 +3467,7 @@ function errorsProvenance(dbPath = defaultDbPath2()) {
   try {
     db = new Database5(dbPath, { readonly: true });
   } catch {
-    console.error("Error: Could not open database at", dbPath);
+    console.log("No database found. Run `remem-mcp setup` to get started.");
     process.exit(1);
   }
   console.log("remem-mcp errors provenance \u2014 Fix Provenance Chain\n");
@@ -3520,7 +3543,7 @@ function errorsPersona(dbPath = defaultDbPath2()) {
   try {
     db = new Database5(dbPath, { readonly: true });
   } catch {
-    console.error("Error: Could not open database at", dbPath);
+    console.log("No database found. Run `remem-mcp setup` to get started.");
     process.exit(1);
   }
   console.log("remem-mcp errors persona \u2014 Error Profile per Project\n");
@@ -3640,7 +3663,7 @@ function decisionsDashboard(dbPath = defaultDbPath2()) {
   try {
     db = new Database5(dbPath, { readonly: true });
   } catch {
-    console.error("Error: Could not open database at", dbPath);
+    console.log("No database found. Run `remem-mcp setup` to get started.");
     process.exit(1);
   }
   console.log("remem-mcp decisions \u2014 Decision Learning Dashboard\n");
@@ -3707,7 +3730,7 @@ function decisionsRetro(dbPath = defaultDbPath2()) {
   try {
     db = new Database5(dbPath, { readonly: true });
   } catch {
-    console.error("Error: Could not open database at", dbPath);
+    console.log("No database found. Run `remem-mcp setup` to get started.");
     process.exit(1);
   }
   console.log("remem-mcp decisions retro \u2014 Decision Retrospective\n");
@@ -3768,7 +3791,7 @@ function patternsDashboard(dbPath = defaultDbPath2()) {
   try {
     db = new Database5(dbPath, { readonly: true });
   } catch {
-    console.error("Error: Could not open database at", dbPath);
+    console.log("No database found. Run `remem-mcp setup` to get started.");
     process.exit(1);
   }
   console.log("remem-mcp patterns \u2014 Pattern Learning Dashboard\n");
@@ -3843,7 +3866,7 @@ function patternsRetro(dbPath = defaultDbPath2()) {
   try {
     db = new Database5(dbPath, { readonly: true });
   } catch {
-    console.error("Error: Could not open database at", dbPath);
+    console.log("No database found. Run `remem-mcp setup` to get started.");
     process.exit(1);
   }
   console.log("remem-mcp patterns retro \u2014 Pattern Retrospective\n");
@@ -3897,7 +3920,7 @@ function decisionsConflicts(dbPath = defaultDbPath2()) {
   try {
     db = new Database5(dbPath, { readonly: true });
   } catch {
-    console.error("Error: Could not open database at", dbPath);
+    console.log("No database found. Run `remem-mcp setup` to get started.");
     process.exit(1);
   }
   console.log("remem-mcp decisions conflicts \u2014 Decision Conflict Report\n");
@@ -3941,7 +3964,7 @@ function decisionsInherited(dbPath = defaultDbPath2()) {
   try {
     db = new Database5(dbPath, { readonly: true });
   } catch {
-    console.error("Error: Could not open database at", dbPath);
+    console.log("No database found. Run `remem-mcp setup` to get started.");
     process.exit(1);
   }
   console.log("remem-mcp decisions inherited \u2014 Cross-Project Decision Inheritance\n");
@@ -3984,7 +4007,7 @@ function patternsConflicts(dbPath = defaultDbPath2()) {
   try {
     db = new Database5(dbPath, { readonly: true });
   } catch {
-    console.error("Error: Could not open database at", dbPath);
+    console.log("No database found. Run `remem-mcp setup` to get started.");
     process.exit(1);
   }
   console.log("remem-mcp patterns conflicts \u2014 Pattern Conflict Report\n");
@@ -4029,7 +4052,7 @@ function patternsTemplates(dbPath = defaultDbPath2()) {
   try {
     db = new Database5(dbPath, { readonly: true });
   } catch {
-    console.error("Error: Could not open database at", dbPath);
+    console.log("No database found. Run `remem-mcp setup` to get started.");
     process.exit(1);
   }
   console.log("remem-mcp patterns templates \u2014 Pattern Template Extraction\n");
@@ -4081,7 +4104,7 @@ function patternsInherited(dbPath = defaultDbPath2()) {
   try {
     db = new Database5(dbPath, { readonly: true });
   } catch {
-    console.error("Error: Could not open database at", dbPath);
+    console.log("No database found. Run `remem-mcp setup` to get started.");
     process.exit(1);
   }
   console.log("remem-mcp patterns inherited \u2014 Cross-Project Pattern Inheritance\n");
@@ -4273,11 +4296,58 @@ function exportMarkdown(dbPath, outputPath, filters) {
 init_esm_shims();
 import { execSync as execSync2, spawn as spawn2 } from "child_process";
 import { createHash as createHash3 } from "crypto";
-import { appendFileSync as appendFileSync2, existsSync as existsSync7, mkdirSync as mkdirSync4, readFileSync as readFileSync5, writeFileSync as writeFileSync4 } from "fs";
-import { homedir as homedir6, tmpdir as tmpdir2 } from "os";
-import { dirname as dirname4, join as join8 } from "path";
+import { appendFileSync as appendFileSync2, existsSync as existsSync8, mkdirSync as mkdirSync5, readFileSync as readFileSync6, writeFileSync as writeFileSync5 } from "fs";
+import { homedir as homedir7, tmpdir as tmpdir2 } from "os";
+import { dirname as dirname4, join as join9 } from "path";
 import Database8 from "better-sqlite3";
+
+// src/storage/refs.ts
+init_esm_shims();
+import {
+  existsSync as existsSync7,
+  mkdirSync as mkdirSync4,
+  readdirSync,
+  readFileSync as readFileSync5,
+  rmSync as rmSync2,
+  statSync as statSync2,
+  writeFileSync as writeFileSync4
+} from "fs";
+import { homedir as homedir6 } from "os";
+import { join as join8 } from "path";
+function defaultRefsDir() {
+  const xdgData = process.env.XDG_DATA_HOME;
+  if (xdgData) return join8(xdgData, "remem-mcp", "refs");
+  return join8(homedir6(), ".local", "share", "remem-mcp", "refs");
+}
+function getRefsDir() {
+  return process.env.REMEM_REFS_DIR ?? defaultRefsDir();
+}
+function getSessionRefsDir(sessionKey) {
+  return join8(getRefsDir(), sessionKey);
+}
+function sanitizeSessionKey(sessionKey) {
+  return sessionKey.replace(/[^a-zA-Z0-9_-]/g, "_");
+}
+function sanitizeNodeId(nodeId) {
+  return nodeId.replace(/[^a-zA-Z0-9_-]/g, "_");
+}
+function writeRef(sessionKey, nodeId, content) {
+  const dir = getSessionRefsDir(sanitizeSessionKey(sessionKey));
+  if (!existsSync7(dir)) mkdirSync4(dir, { recursive: true });
+  const filePath = join8(dir, `${sanitizeNodeId(nodeId)}.md`);
+  writeFileSync4(filePath, content, "utf-8");
+  return filePath;
+}
+
+// src/hook-handlers.ts
+init_ulid();
 var SHOW_FEEDBACK = process.env.REMEM_QUIET !== "1";
+function isOffloadEnabled() {
+  return process.env.REMEM_OFFLOAD_ENABLED === "true" || process.env.REMEM_OFFLOAD_ENABLED === "1" || process.env.REMEM_FLOW === "full";
+}
+function isSkillPipelineEnabled() {
+  return process.env.REMEM_PIPELINE === "skill" || process.env.REMEM_FLOW === "full";
+}
 function feedback(emoji, message) {
   if (SHOW_FEEDBACK) {
     process.stderr.write(`
@@ -4287,12 +4357,12 @@ function feedback(emoji, message) {
   }
 }
 function defaultLogPath() {
-  return process.env.REMEM_HOOK_LOG_PATH ?? join8(homedir6(), ".local", "share", "remem-mcp", "session.log");
+  return process.env.REMEM_HOOK_LOG_PATH ?? join9(homedir7(), ".local", "share", "remem-mcp", "session.log");
 }
 function logToFile(text) {
   try {
     const logPath = defaultLogPath();
-    mkdirSync4(dirname4(logPath), { recursive: true });
+    mkdirSync5(dirname4(logPath), { recursive: true });
     const ts = (/* @__PURE__ */ new Date()).toISOString();
     appendFileSync2(logPath, `[${ts}] ${text}
 `);
@@ -4309,11 +4379,11 @@ function safeParseTags(raw) {
   }
 }
 function driftFilePath(sessionKey) {
-  return join8(tmpdir2(), `remem-drift-${sessionKey}.jsonl`);
+  return join9(tmpdir2(), `remem-drift-${sessionKey}.jsonl`);
 }
 function logInjectionDrift(sessionKey, captureType, captureId, command) {
   try {
-    const path = join8(tmpdir2(), `remem-drift-${sessionKey}.jsonl`);
+    const path = join9(tmpdir2(), `remem-drift-${sessionKey}.jsonl`);
     const record = JSON.stringify({
       type: captureType,
       content_hash: captureId,
@@ -4472,8 +4542,8 @@ function logDriftInjection(sessionKey, contentHash, errorId, command) {
 function checkDriftInjection(sessionKey, contentHash) {
   try {
     const path = driftFilePath(sessionKey);
-    if (!existsSync7(path)) return null;
-    const content = readFileSync5(path, "utf-8");
+    if (!existsSync8(path)) return null;
+    const content = readFileSync6(path, "utf-8");
     const lines = content.trim().split("\n").filter(Boolean);
     const now = Date.now();
     const maxAge = 30 * 60 * 1e3;
@@ -4492,7 +4562,7 @@ function checkDriftInjection(sessionKey, contentHash) {
       }
     }
     if (recent.length !== lines.length) {
-      writeFileSync4(path, recent.join("\n") + (recent.length > 0 ? "\n" : ""));
+      writeFileSync5(path, recent.join("\n") + (recent.length > 0 ? "\n" : ""));
     }
     return match;
   } catch {
@@ -4502,8 +4572,8 @@ function checkDriftInjection(sessionKey, contentHash) {
 function checkAllDriftInjections(sessionKey) {
   try {
     const path = driftFilePath(sessionKey);
-    if (!existsSync7(path)) return [];
-    const content = readFileSync5(path, "utf-8");
+    if (!existsSync8(path)) return [];
+    const content = readFileSync6(path, "utf-8");
     const lines = content.trim().split("\n").filter(Boolean);
     const now = Date.now();
     const maxAge = 30 * 60 * 1e3;
@@ -4520,7 +4590,7 @@ function checkAllDriftInjections(sessionKey) {
       }
     }
     if (recent.length !== lines.length) {
-      writeFileSync4(path, recent.join("\n") + (recent.length > 0 ? "\n" : ""));
+      writeFileSync5(path, recent.join("\n") + (recent.length > 0 ? "\n" : ""));
     }
     return results;
   } catch {
@@ -4595,7 +4665,9 @@ function hookRecall(dbPath) {
         lines.push(`- (${row.type}${tagStr}) ${date}: ${content}`);
       }
       try {
-        const personaRow = db.prepare("SELECT content FROM persona WHERE team_id = ? AND user_id = ? ORDER BY updated_at DESC LIMIT 1").get("default", "default");
+        const personaRow = db.prepare(
+          "SELECT content FROM persona WHERE team_id = ? AND user_id = ? ORDER BY updated_at DESC LIMIT 1"
+        ).get("default", "default");
         if (personaRow && personaRow.content) {
           lines.push("");
           lines.push(`## Persona (L3)`);
@@ -4662,11 +4734,20 @@ function extractUpdateFact(prompt2) {
   if (p.length < 15) return null;
   const updatePatterns = [
     // "remember that ..." / "nhớ là ..." / "đừng quên ..."
-    { re: /^(?:remember that|remember|don't forget|dont forget|note that|for future reference)\s*:?\s*(.+)/i, type: "learning" },
+    {
+      re: /^(?:remember that|remember|don't forget|dont forget|note that|for future reference)\s*:?\s*(.+)/i,
+      type: "learning"
+    },
     { re: /^(?:nhớ là|nhớ rằng|đừng quên|ghi nhớ)\s*:?\s*(.+)/i, type: "learning" },
     // "we use/chose/decided ..." / "mình dùng/chọn/quyết định ..."
-    { re: /^(?:we use|we chose|we decided|we prefer|we always|our convention|our standard)\s*:?\s*(.+)/i, type: "decision" },
-    { re: /^(?:mình dùng|mình chọn|mình quyết định|chúng ta dùng|chúng ta chọn)\s*:?\s*(.+)/i, type: "decision" },
+    {
+      re: /^(?:we use|we chose|we decided|we prefer|we always|our convention|our standard)\s*:?\s*(.+)/i,
+      type: "decision"
+    },
+    {
+      re: /^(?:mình dùng|mình chọn|mình quyết định|chúng ta dùng|chúng ta chọn)\s*:?\s*(.+)/i,
+      type: "decision"
+    },
     // "update X to Y" / "change X to Y" / "sửa X thành Y"
     { re: /^(?:update|change|set|configure)\s+.+\s+(?:to|as|=\s*)\s*(.+)/i, type: "decision" },
     { re: /^(?:sửa|đổi|cập nhật)\s+.+\s+(?:thành|sang|=\s*)\s*(.+)/i, type: "decision" },
@@ -4729,6 +4810,7 @@ function hookUserPromptSubmit(dbPath) {
       let db;
       try {
         db = new Database8(dbPath);
+        ensureSchema2(db);
       } catch {
         try {
           db = new Database8(dbPath, { readonly: true });
@@ -4846,7 +4928,9 @@ ${scenarioLines.join("\n")}`;
       } catch {
       }
       try {
-        const personaRow = db.prepare("SELECT content FROM persona WHERE team_id = ? AND user_id = ? ORDER BY updated_at DESC LIMIT 1").get("default", "default");
+        const personaRow = db.prepare(
+          "SELECT content FROM persona WHERE team_id = ? AND user_id = ? ORDER BY updated_at DESC LIMIT 1"
+        ).get("default", "default");
         if (personaRow && personaRow.content) {
           if (recallContext) {
             recallContext += `
@@ -4863,7 +4947,9 @@ ${personaRow.content}`;
       try {
         const skills = db.prepare("SELECT name, description FROM skills ORDER BY updated_at DESC LIMIT 3").all();
         if (skills.length > 0) {
-          const skillLines = skills.map((s) => `- ${s.name}: ${(s.description || "").slice(0, 80)}`);
+          const skillLines = skills.map(
+            (s) => `- ${s.name}: ${(s.description || "").slice(0, 80)}`
+          );
           if (recallContext) {
             recallContext += `
 
@@ -4941,9 +5027,12 @@ function hookStop(dbPath) {
     if (dbPath && input.session_id) {
       const sid = input.session_id;
       const tpath = input.transcript_path ?? null;
-      if (tpath && existsSync7(tpath)) {
+      if (tpath && existsSync8(tpath)) {
         void captureSessionTranscript(dbPath, sid, tpath, input.cwd).then((capId) => {
           logToFile(`Stop: direct capture for session ${sid}, id=${capId ?? "skipped"}`);
+          if (capId && isSkillPipelineEnabled()) {
+            void extractSkillFromCapture(dbPath, capId).then(() => logToFile(`Stop: skill extraction done for ${capId}`)).catch((err) => logToFile(`Stop: skill extraction error - ${err}`));
+          }
         }).catch((err) => {
           logToFile(`Stop: capture error - ${err}`);
         });
@@ -4958,11 +5047,10 @@ function hookStop(dbPath) {
         logToFile(`Stop: spawned background capture for session ${sid}`);
       }
       const scriptPath = process.argv[1];
-      const workerChild = spawn2(
-        process.execPath,
-        [scriptPath, "worker-run", dbPath],
-        { detached: true, stdio: "ignore" }
-      );
+      const workerChild = spawn2(process.execPath, [scriptPath, "worker-run", dbPath], {
+        detached: true,
+        stdio: "ignore"
+      });
       workerChild.unref();
       logToFile(`Stop: spawned background pipeline worker for session ${sid}`);
     }
@@ -4972,9 +5060,9 @@ function hookStop(dbPath) {
     }
     const isTrivial = (() => {
       const tpath = input.transcript_path;
-      if (!tpath || !existsSync7(tpath)) return false;
+      if (!tpath || !existsSync8(tpath)) return false;
       try {
-        const lines = readFileSync5(tpath, "utf-8").trim().split("\n");
+        const lines = readFileSync6(tpath, "utf-8").trim().split("\n");
         let userCount = 0;
         let hasEdit = false;
         for (const line2 of lines) {
@@ -5031,9 +5119,23 @@ function hookPostToolUse(dbPath) {
       const isBash = toolName === "Bash" || toolName === "exec";
       const isWriteEdit = toolName === "Write" || toolName === "Edit" || toolName === "MultiEdit";
       if (!isBash && !isWriteEdit) {
+        if (isOffloadEnabled()) {
+          try {
+            offloadToolOutput(dbPath, toolName, toolInput, toolResponse, input.cwd);
+          } catch (e) {
+            logToFile(`PostToolUse: offload failed: ${e}`);
+          }
+        }
         process.stdout.write(JSON.stringify({}));
         return;
       }
+      if (isOffloadEnabled()) {
+        try {
+          offloadToolOutput(dbPath, toolName, toolInput, toolResponse, input.cwd);
+        } catch (e) {
+          logToFile(`PostToolUse: offload failed: ${e}`);
+        }
+      }
       if (isWriteEdit) {
         const writeEditCwd = input.cwd ?? toolInput.workdir ?? process.cwd();
         const ignorePatterns = loadCaptureExclusions(writeEditCwd);
@@ -5048,6 +5150,7 @@ function hookPostToolUse(dbPath) {
         }
         try {
           const db2 = new Database8(dbPath);
+          ensureSchema2(db2);
           const sessionKey2 = hashPath(writeEditCwd);
           const pattern = detectPattern(toolName, toolInput);
           if (pattern) {
@@ -5149,6 +5252,7 @@ function hookPostToolUse(dbPath) {
             const driftRecords = checkAllDriftInjections(sessionKey2);
             if (driftRecords.length > 0 && pattern) {
               const driftDb = new Database8(dbPath);
+              ensureSchema2(driftDb);
               for (const dr of driftRecords) {
                 if (dr.type === "pattern") {
                   const injectedPat = driftDb.prepare("SELECT id, metadata FROM captures WHERE id = ?").get(dr.content_hash);
@@ -5206,6 +5310,7 @@ function hookPostToolUse(dbPath) {
       let db;
       try {
         db = new Database8(dbPath);
+        ensureSchema2(db);
       } catch {
         process.stdout.write(JSON.stringify({}));
         return;
@@ -5588,6 +5693,7 @@ Error (${errorType}): ${normalizedError}`;
       logToFile(`PostToolUse: auto-captured ${errorType} error. id=${id}`);
       try {
         const corrDb = new Database8(dbPath);
+        ensureSchema2(corrDb);
         const recentErrors = corrDb.prepare(
           `SELECT id, json_extract(metadata, '$.error_type') as etype, json_extract(metadata, '$.title') as title
              FROM captures
@@ -5661,6 +5767,7 @@ function hookPreToolUse(dbPath) {
   });
   process.stdin.on("end", () => {
     clearTimeout(stdinTimeout);
+    const contextBlocks = [];
     try {
       const raw = Buffer.concat(chunks).toString("utf-8");
       if (!raw.trim()) {
@@ -5671,17 +5778,28 @@ function hookPreToolUse(dbPath) {
       const toolName = input.tool_name ?? "";
       const toolInput = input.tool_input ?? {};
       const command = toolInput.command ?? "";
+      if (isOffloadEnabled()) {
+        try {
+          const canvasContext = getCanvasContext(dbPath, input.cwd ?? process.cwd());
+          if (canvasContext) {
+            contextBlocks.push(canvasContext);
+          }
+        } catch (e) {
+          logToFile(`PreToolUse: canvas injection failed: ${e}`);
+        }
+      }
+      try {
+        const skillContext = getSkillContext(dbPath, command || toolName);
+        if (skillContext) {
+          contextBlocks.push(skillContext);
+        }
+      } catch (e) {
+        logToFile(`PreToolUse: skill injection failed: ${e}`);
+      }
       const dangerWarning = checkDangerousCommand(command);
       if (dangerWarning) {
-        const output3 = {
-          hookSpecificOutput: {
-            hookEventName: "PreToolUse",
-            additionalContext: dangerWarning
-          }
-        };
+        contextBlocks.push(dangerWarning);
         logToFile(`PreToolUse: DANGER warning for: ${command.slice(0, 80)}`);
-        process.stdout.write(JSON.stringify(output3));
-        return;
       }
       if (toolName === "Write" || toolName === "Edit" || toolName === "MultiEdit") {
         const filePath = toolInput.file_path ?? toolInput.path ?? "";
@@ -5824,12 +5942,29 @@ function hookPreToolUse(dbPath) {
           } catch {
           }
         }
-        process.stdout.write(JSON.stringify({}));
+        if (contextBlocks.length > 0) {
+          process.stdout.write(JSON.stringify({
+            hookSpecificOutput: {
+              hookEventName: "PreToolUse",
+              additionalContext: contextBlocks.join("\n\n")
+            }
+          }));
+        } else {
+          process.stdout.write(JSON.stringify({}));
+        }
         return;
       }
-      const isRelevantCommand = /^(npm|npx|yarn|pnpm|biome|eslint|tsc|cargo|make|pytest|vitest|jest)\b/.test(command) || /\b(lint|test|build|typecheck|check|format)\b/.test(command);
-      if (!isRelevantCommand) {
-        process.stdout.write(JSON.stringify({}));
+      if (!isRelevantBuildCommand(command) && !isDecisionLearningCommand(command)) {
+        if (contextBlocks.length > 0) {
+          process.stdout.write(JSON.stringify({
+            hookSpecificOutput: {
+              hookEventName: "PreToolUse",
+              additionalContext: contextBlocks.join("\n\n")
+            }
+          }));
+        } else {
+          process.stdout.write(JSON.stringify({}));
+        }
         return;
       }
       const cwd = input.cwd ?? toolInput.workdir ?? process.cwd();
@@ -5838,7 +5973,16 @@ function hookPreToolUse(dbPath) {
       try {
         db = new Database8(dbPath, { readonly: true });
       } catch {
-        process.stdout.write(JSON.stringify({}));
+        if (contextBlocks.length > 0) {
+          process.stdout.write(JSON.stringify({
+            hookSpecificOutput: {
+              hookEventName: "PreToolUse",
+              additionalContext: contextBlocks.join("\n\n")
+            }
+          }));
+        } else {
+          process.stdout.write(JSON.stringify({}));
+        }
         return;
       }
       const globalErrors = process.env.REMEM_GLOBAL_ERRORS === "1";
@@ -5887,7 +6031,8 @@ function hookPreToolUse(dbPath) {
             provenance: m.fix_provenance ?? "auto_captured",
             inherited: r.session_key !== sessionKey,
             rollbackPlan: m.rollback_plan ?? null,
-            autoNotes: m.auto_notes ?? []
+            autoNotes: m.auto_notes ?? [],
+            failedCommand: m.command ?? ""
           };
         });
         if (resolvedFixes.length < 2) {
@@ -5913,14 +6058,20 @@ function hookPreToolUse(dbPath) {
               provenance: "inherited",
               inherited: true,
               rollbackPlan: m.rollback_plan ?? null,
-              autoNotes: m.auto_notes ?? []
+              autoNotes: m.auto_notes ?? [],
+              failedCommand: m.command ?? ""
             });
           }
         }
         rDb.close();
       } catch {
       }
-      if (errors2.length === 0 && resolvedFixes.length === 0) {
+      const relevantErrors = errors2.filter((err) => {
+        const meta = err.metadata ? JSON.parse(err.metadata) : {};
+        return isErrorRelevantToCommand(command, meta);
+      });
+      const relevantFixes = resolvedFixes;
+      if (relevantErrors.length === 0 && relevantFixes.length === 0) {
         try {
           const decDb = new Database8(dbPath, { readonly: true });
           const lowerCmd = command.toLowerCase();
@@ -6009,19 +6160,19 @@ function hookPreToolUse(dbPath) {
         process.stdout.write(JSON.stringify({}));
         return;
       }
-      const validErrors = errors2.filter((err) => {
-        const meta = JSON.parse(err.metadata);
+      const validErrors = relevantErrors.filter((err) => {
+        const meta = err.metadata ? JSON.parse(err.metadata) : {};
         const filesInError = extractFilePaths(err.content);
         if (filesInError.length === 0) return true;
-        return filesInError.some((f) => existsSync7(join8(cwd, f)));
+        return filesInError.some((f) => existsSync8(join9(cwd, f)));
       });
-      if (validErrors.length === 0 && resolvedFixes.length === 0) {
+      if (validErrors.length === 0 && relevantFixes.length === 0) {
         logToFile("PreToolUse: all past errors are stale and no proven fixes");
         process.stdout.write(JSON.stringify({}));
         return;
       }
       const decayed = validErrors.map((err) => {
-        const meta = JSON.parse(err.metadata);
+        const meta = err.metadata ? JSON.parse(err.metadata) : {};
         const base = meta.confidence ?? 2;
         const decayed2 = applyConfidenceDecay(base, err.created_at, meta.last_recurred);
         return { err, meta, decayedConfidence: decayed2 };
@@ -6054,12 +6205,12 @@ function hookPreToolUse(dbPath) {
           }
         }
       }
-      if (resolvedFixes.length > 0) {
+      if (relevantFixes.length > 0) {
         lines.push("");
         lines.push("Proven fixes from past resolved errors:");
         const stalenessDays = Number(process.env.REMEM_FIX_STALENESS_DAYS ?? 180);
         const stalenessMs = stalenessDays * 864e5;
-        for (const fix of resolvedFixes) {
+        for (const fix of relevantFixes) {
           const fixAgeMs = Date.now() - new Date(fix.resolvedAt).getTime();
           const isStale = fixAgeMs > stalenessMs;
           const staleTag = isStale ? " [STALE \u2014 verify before applying]" : "";
@@ -6155,7 +6306,7 @@ function hookPreToolUse(dbPath) {
         }
       } catch {
       }
-      const context = lines.join("\n");
+      let context = lines.join("\n");
       const k = decayed.length;
       logToFile(
         `PreToolUse: injected ${k} past error(s) (k=${k}, decayed confidence, ${resolvedFixes.length} fixes) before: ${command.slice(0, 60)}`
@@ -6170,6 +6321,9 @@ function hookPreToolUse(dbPath) {
           logDriftInjection(sessionKey, err.content_hash, err.id, command);
         }
       }
+      if (contextBlocks.length > 0) {
+        context = contextBlocks.join("\n\n") + (context ? "\n\n" + context : "");
+      }
       const output2 = {
         hookSpecificOutput: {
           hookEventName: "PreToolUse",
@@ -6181,7 +6335,16 @@ function hookPreToolUse(dbPath) {
       process.stderr.write(`[remem-mcp hook-pre-tool-use] Error: ${err}
 `);
       logToFile(`PreToolUse: error - ${err}`);
-      process.stdout.write(JSON.stringify({}));
+      if (contextBlocks.length > 0) {
+        process.stdout.write(JSON.stringify({
+          hookSpecificOutput: {
+            hookEventName: "PreToolUse",
+            additionalContext: contextBlocks.join("\n\n")
+          }
+        }));
+      } else {
+        process.stdout.write(JSON.stringify({}));
+      }
     }
   });
 }
@@ -6206,9 +6369,9 @@ function loadCaptureExclusions(cwd) {
   try {
     let dir = cwd;
     for (let i = 0; i < MAX_ANCESTORS; i++) {
-      const markerPath = join8(dir, ".remem.toml");
-      if (existsSync7(markerPath)) {
-        const content = readFileSync5(markerPath, "utf-8");
+      const markerPath = join9(dir, ".remem.toml");
+      if (existsSync8(markerPath)) {
+        const content = readFileSync6(markerPath, "utf-8");
         patterns = parseCaptureExclusions(content);
         break;
       }
@@ -6230,7 +6393,8 @@ function shouldExcludePath(filePath, ignorePatterns) {
       if (normalized.endsWith(pattern.slice(1))) return true;
       continue;
     }
-    if (segments.includes(pattern)) return true;
+    const stripped = pattern.replace(/\/\*.*$/, "").replace(/\*.*$/, "");
+    if (stripped && segments.includes(stripped)) return true;
   }
   return false;
 }
@@ -6259,6 +6423,98 @@ function isNoiseCommand(command) {
   if (/git\s+diff\s+.*--exit-code/.test(lower)) return true;
   return false;
 }
+var COMMAND_INTENTS = {
+  biome: "check",
+  build: "build",
+  cargo: "build",
+  check: "check",
+  eslint: "lint",
+  format: "format",
+  jest: "test",
+  lint: "lint",
+  make: "build",
+  mvn: "build",
+  mypy: "typecheck",
+  pytest: "test",
+  ruff: "lint",
+  tsc: "typecheck",
+  typecheck: "typecheck",
+  vitest: "test"
+};
+function getCommandIntent(command) {
+  for (const segment of command.split(/&&|\|\||[;|]/)) {
+    let part = segment.trim();
+    if (!part) continue;
+    while (/^[A-Za-z_][A-Za-z0-9_]*=(?:"[^"]*"|'[^']*'|\S*)\s+/.test(part)) {
+      part = part.replace(/^[A-Za-z_][A-Za-z0-9_]*=(?:"[^"]*"|'[^']*'|\S*)\s+/, "");
+    }
+    const tokens = part.split(/\s+/).filter(Boolean);
+    if (tokens.length === 0) continue;
+    while (tokens[0] === "sudo" || tokens[0] === "time") tokens.shift();
+    const executable = (tokens[0] ?? "").split("/").pop() ?? "";
+    if (["cd", "pushd", "popd"].includes(executable)) continue;
+    if (["npm", "pnpm", "yarn"].includes(executable)) {
+      const args = tokens.slice(1);
+      const runAt = args.findIndex((arg) => arg === "run" || arg === "exec");
+      const action = runAt >= 0 ? args[runAt + 1] : args.find((arg) => !arg.startsWith("-"));
+      if (action && COMMAND_INTENTS[action]) return COMMAND_INTENTS[action];
+      continue;
+    }
+    if (executable === "python" && tokens[1] === "-m") {
+      const module = (tokens[2] ?? "").split("/").pop() ?? "";
+      if (COMMAND_INTENTS[module]) return COMMAND_INTENTS[module];
+      continue;
+    }
+    if (COMMAND_INTENTS[executable]) return COMMAND_INTENTS[executable];
+    if (["cargo", "dotnet", "go", "gradle", "mvn"].includes(executable)) {
+      const action = (tokens[1] ?? "").toLowerCase();
+      if (action === "test") return "test";
+      if (action === "fmt") return "format";
+      if (["build", "vet", "clippy"].includes(action)) return "check";
+    }
+  }
+  return null;
+}
+function isRelevantBuildCommand(command) {
+  return getCommandIntent(command) !== null;
+}
+function isDecisionLearningCommand(command) {
+  return /\b(?:npm|pnpm|yarn)\s+(?:install|i|add)\b/.test(command) || /\b(?:pip|uv)\s+install\b/.test(command) || /\bcargo\s+add\b/.test(command) || /\bgit\s+commit\b/.test(command);
+}
+function isErrorRelevantToCommand(command, meta) {
+  const intent = getCommandIntent(command);
+  if (!intent) return false;
+  const failedCommand = typeof meta.command === "string" ? meta.command : "";
+  if (failedCommand) {
+    if (getCommandIntent(failedCommand) === intent) return true;
+    const genericWords = /* @__PURE__ */ new Set([
+      "and",
+      "error",
+      "failed",
+      "false",
+      "npm",
+      "npx",
+      "pnpm",
+      "run",
+      "the",
+      "true",
+      "yarn"
+    ]);
+    const words = (text) => new Set(
+      text.toLowerCase().split(/[^a-z0-9@/_-]+/).filter(
+        (word) => word.length >= 3 && !genericWords.has(word)
+      )
+    );
+    const currentWords = words(command);
+    const failedWords = words(failedCommand);
+    for (const word of currentWords) {
+      if (failedWords.has(word)) return true;
+    }
+    return false;
+  }
+  const errorType = typeof meta.error_type === "string" ? meta.error_type.toLowerCase() : "";
+  return !errorType || errorType === intent || intent === "check";
+}
 function checkDangerousCommand(command) {
   const lower = command.toLowerCase();
   if (/git\s+push\s+(--force|-f)(?!\S)/.test(lower)) {
@@ -6630,13 +6886,118 @@ function extractFilePaths(content) {
 function hashPath(path) {
   return createHash3("sha256").update(path).digest("hex").slice(0, 16);
 }
+function ensureSchema2(db) {
+  db.exec(`CREATE TABLE IF NOT EXISTS captures (
+    id TEXT PRIMARY KEY,
+    session_key TEXT NOT NULL,
+    team_id TEXT,
+    agent_id TEXT,
+    user_id TEXT,
+    type TEXT NOT NULL,
+    content TEXT NOT NULL,
+    tags TEXT,
+    metadata TEXT,
+    content_hash TEXT,
+    created_at INTEGER NOT NULL,
+    deleted_at INTEGER,
+    trust_state TEXT DEFAULT 'trusted',
+    rejection_reason TEXT,
+    superseded_by TEXT,
+    access_count INTEGER DEFAULT 0,
+    last_accessed_at INTEGER,
+    bayesian_alpha REAL DEFAULT 1.0,
+    bayesian_beta REAL DEFAULT 1.0,
+    fix_validated INTEGER,
+    fix_validated_at INTEGER,
+    escalation_level INTEGER DEFAULT 0
+  )`);
+  db.exec(`CREATE TABLE IF NOT EXISTS error_patterns (
+    id TEXT PRIMARY KEY,
+    session_key TEXT NOT NULL,
+    command TEXT NOT NULL,
+    error_type TEXT,
+    error_message TEXT,
+    content_hash TEXT,
+    confidence REAL DEFAULT 2.0,
+    occurrences INTEGER DEFAULT 1,
+    first_seen INTEGER NOT NULL,
+    last_seen INTEGER NOT NULL,
+    resolved_at INTEGER,
+    fix_command TEXT,
+    fix_approach TEXT,
+    fix_validated INTEGER,
+    fix_recorded_at INTEGER,
+    escalation_level INTEGER DEFAULT 0,
+    root_cause TEXT,
+    auto_notes TEXT,
+    deleted_at INTEGER
+  )`);
+  db.exec(`CREATE TABLE IF NOT EXISTS decisions (
+    id TEXT PRIMARY KEY,
+    session_key TEXT NOT NULL,
+    title TEXT NOT NULL,
+    choice TEXT NOT NULL,
+    rationale TEXT,
+    context TEXT,
+    created_at INTEGER NOT NULL
+  )`);
+  db.exec(`CREATE TABLE IF NOT EXISTS persona (
+    team_id TEXT NOT NULL,
+    user_id TEXT NOT NULL,
+    content TEXT NOT NULL,
+    updated_at INTEGER NOT NULL,
+    PRIMARY KEY (team_id, user_id)
+  )`);
+  db.exec(`CREATE TABLE IF NOT EXISTS skills (
+    id TEXT PRIMARY KEY,
+    team_id TEXT NOT NULL,
+    agent_id TEXT,
+    name TEXT NOT NULL,
+    description TEXT,
+    content TEXT,
+    version INTEGER DEFAULT 1,
+    created_at INTEGER NOT NULL,
+    updated_at INTEGER NOT NULL,
+    trigger_conditions TEXT,
+    steps TEXT,
+    validation_rules TEXT,
+    source_capture_ids TEXT,
+    archived INTEGER DEFAULT 0
+  )`);
+  db.exec(`CREATE TABLE IF NOT EXISTS atoms (
+    id TEXT PRIMARY KEY,
+    capture_id TEXT NOT NULL,
+    fact TEXT NOT NULL,
+    confidence REAL NOT NULL DEFAULT 1.0,
+    created_at INTEGER NOT NULL,
+    team_id TEXT,
+    agent_id TEXT,
+    user_id TEXT
+  )`);
+  db.exec(`CREATE TABLE IF NOT EXISTS scenarios (
+    id TEXT PRIMARY KEY,
+    atom_ids TEXT NOT NULL,
+    summary TEXT,
+    created_at INTEGER NOT NULL,
+    team_id TEXT
+  )`);
+  db.exec(`CREATE TABLE IF NOT EXISTS schema_version (version INTEGER NOT NULL)`);
+  db.exec(`CREATE INDEX IF NOT EXISTS idx_captures_session ON captures(session_key)`);
+  db.exec(`CREATE INDEX IF NOT EXISTS idx_captures_type ON captures(type)`);
+  db.exec(`CREATE INDEX IF NOT EXISTS idx_errors_session ON error_patterns(session_key)`);
+  db.exec(`CREATE INDEX IF NOT EXISTS idx_atoms_capture ON atoms(capture_id)`);
+}
 function defaultTranscriptDir() {
-  return process.env.DEVIN_TRANSCRIPTS_DIR ?? join8(homedir6(), ".local", "share", "devin", "cli", "transcripts");
+  return process.env.DEVIN_TRANSCRIPTS_DIR ?? join9(homedir7(), ".local", "share", "devin", "cli", "transcripts");
 }
 function generateId2() {
-  const ts = Date.now().toString(36).toUpperCase();
-  const rand = Math.random().toString(36).slice(2, 12).toUpperCase();
-  return `01${ts}${rand}`;
+  try {
+    return generateId();
+  } catch {
+    const ts = Date.now().toString(36).toUpperCase();
+    const rand = Math.random().toString(36).slice(2, 12).toUpperCase();
+    return `01${ts}${rand}`;
+  }
 }
 async function captureSessionTranscript(dbPath, sessionId, transcriptPath, cwd) {
   const sid = sessionId ?? "unknown";
@@ -6648,13 +7009,13 @@ async function captureSessionTranscript(dbPath, sessionId, transcriptPath, cwd)
   if (transcriptPath) {
     filePath = transcriptPath;
   } else {
-    filePath = join8(defaultTranscriptDir(), `${sid}.json`);
+    filePath = join9(defaultTranscriptDir(), `${sid}.json`);
   }
-  if (!existsSync7(filePath)) {
+  if (!existsSync8(filePath)) {
     logToFile(`Stop: transcript not found at ${filePath}`);
     return null;
   }
-  const raw = readFileSync5(filePath, "utf-8");
+  const raw = readFileSync6(filePath, "utf-8");
   const userMessages = [];
   const assistantMessages = [];
   const trimmed = raw.trim();
@@ -6721,6 +7082,7 @@ Task: ${taskText}
 Outcome: ${outcomeText}`;
   const contentHash = createHash3("sha256").update(content).digest("hex");
   const db = new Database8(dbPath);
+  ensureSchema2(db);
   try {
     const sqliteVec5 = await import("sqlite-vec");
     sqliteVec5.load(db);
@@ -6828,19 +7190,19 @@ async function waitAndCapture(dbPath, sessionId, transcriptPath) {
   if (transcriptPath) {
     filePath = transcriptPath;
   } else {
-    filePath = join8(defaultTranscriptDir(), `${sessionId}.json`);
+    filePath = join9(defaultTranscriptDir(), `${sessionId}.json`);
   }
   const maxWait = 1e4;
   const interval = 500;
   const start = Date.now();
   while (Date.now() - start < maxWait) {
-    if (existsSync7(filePath)) {
+    if (existsSync8(filePath)) {
       await sleep2(500);
       break;
     }
     await sleep2(interval);
   }
-  if (!existsSync7(filePath)) {
+  if (!existsSync8(filePath)) {
     logToFile(`Stop: transcript never appeared at ${filePath} after 10s`);
     return;
   }
@@ -6858,8 +7220,8 @@ function sleep2(ms) {
 }
 async function hookPostCommit(dbPath) {
   try {
-    const { execSync: execSync3 } = await import("child_process");
-    const output2 = execSync3("git diff-tree --no-commit-id --name-only -r HEAD", {
+    const { execSync: execSync4 } = await import("child_process");
+    const output2 = execSync4("git diff-tree --no-commit-id --name-only -r HEAD", {
       encoding: "utf-8",
       stdio: ["pipe", "pipe", "pipe"]
     });
@@ -6869,18 +7231,19 @@ async function hookPostCommit(dbPath) {
       process.stdout.write(JSON.stringify({}));
       return;
     }
-    const { readFileSync: readFileSync13 } = await import("fs");
-    const { join: join16, dirname: dirname11 } = await import("path");
+    const { readFileSync: readFileSync14 } = await import("fs");
+    const { join: join17, dirname: dirname11 } = await import("path");
     const { fileURLToPath: fileURLToPath5 } = await import("url");
     const sqliteVec5 = await import("sqlite-vec");
-    const { indexFile: indexFile2 } = await import("./engine-LVKGZHBY.js");
+    const { indexFile: indexFile2 } = await import("./engine-S47HHGAO.js");
     const db = new Database8(dbPath);
+    ensureSchema2(db);
     try {
       db.pragma("journal_mode = WAL");
       sqliteVec5.load(db);
-      const schemaPath = join16(dirname11(fileURLToPath5(import.meta.url)), "storage", "schema.sql");
+      const schemaPath = join17(dirname11(fileURLToPath5(import.meta.url)), "storage", "schema.sql");
       try {
-        const schema = readFileSync13(schemaPath, "utf-8");
+        const schema = readFileSync14(schemaPath, "utf-8");
         db.exec(schema);
       } catch {
       }
@@ -6904,7 +7267,7 @@ async function hookPostCommit(dbPath) {
       ];
       let indexed = 0;
       let skipped = 0;
-      const repoRoot = execSync3("git rev-parse --show-toplevel", { encoding: "utf-8" }).trim();
+      const repoRoot = execSync4("git rev-parse --show-toplevel", { encoding: "utf-8" }).trim();
       for (const file of files) {
         const ext = file.slice(file.lastIndexOf(".")).toLowerCase();
         if (!SUPPORTED_EXT.includes(ext)) {
@@ -6912,7 +7275,7 @@ async function hookPostCommit(dbPath) {
           continue;
         }
         try {
-          const fullPath = join16(repoRoot, file);
+          const fullPath = join17(repoRoot, file);
           await indexFile2(db, fullPath, repoRoot, null);
           indexed++;
         } catch {
@@ -6948,6 +7311,7 @@ function hookPreCompact(dbPath) {
       const trigger = input.trigger ?? "unknown";
       const sessionKey = hashPath(input.cwd ?? process.cwd());
       const db = new Database8(dbPath);
+      ensureSchema2(db);
       let transcriptNote = "";
       try {
         db.pragma("journal_mode = WAL");
@@ -6958,9 +7322,9 @@ function hookPreCompact(dbPath) {
         }
         try {
           const { fileURLToPath: fileURLToPath5 } = await import("url");
-          const schemaPath = join8(dirname4(fileURLToPath5(import.meta.url)), "storage", "schema.sql");
-          if (existsSync7(schemaPath)) {
-            db.exec(readFileSync5(schemaPath, "utf-8"));
+          const schemaPath = join9(dirname4(fileURLToPath5(import.meta.url)), "storage", "schema.sql");
+          if (existsSync8(schemaPath)) {
+            db.exec(readFileSync6(schemaPath, "utf-8"));
           }
         } catch {
         }
@@ -6983,9 +7347,9 @@ function hookPreCompact(dbPath) {
           "remem-mcp-hook",
           Date.now()
         );
-        if (input.transcript_path && existsSync7(input.transcript_path)) {
+        if (input.transcript_path && existsSync8(input.transcript_path)) {
           try {
-            const transcript = readFileSync5(input.transcript_path, "utf-8");
+            const transcript = readFileSync6(input.transcript_path, "utf-8");
             const recent = transcript.slice(-2e3);
             const transcriptId = `txcpt-${createHash3("sha256").update(sessionKey + "transcript" + Date.now()).digest("hex").slice(0, 12)}`;
             db.prepare(
@@ -7056,7 +7420,7 @@ function hookPostCompaction(dbPath) {
       const sessionKey = hashPath(input.cwd ?? process.cwd());
       const globalKey = process.env.REMEM_GLOBAL_SESSION_KEY ?? null;
       const { fileURLToPath: fileURLToPath5 } = await import("url");
-      const schemaPath = join8(dirname4(fileURLToPath5(import.meta.url)), "storage", "schema.sql");
+      const schemaPath = join9(dirname4(fileURLToPath5(import.meta.url)), "storage", "schema.sql");
       const db = new Database8(dbPath, { readonly: true });
       const cutoff = Date.now() - 24 * 60 * 60 * 1e3;
       const sessionKeys = globalKey ? [sessionKey, globalKey] : [sessionKey];
@@ -7107,23 +7471,365 @@ function hookPostCompaction(dbPath) {
     }
   });
 }
+function offloadToolOutput(dbPath, toolName, toolInput, toolResponse, cwd) {
+  const sessionKey = hashPath(cwd ?? process.cwd());
+  const nodeId = generateId2();
+  const label = buildToolLabel(toolName, toolInput);
+  const rawContent = buildRawRefContent(toolName, toolInput, toolResponse);
+  writeRef(sessionKey, nodeId, rawContent);
+  const db = new Database8(dbPath);
+  ensureSchema2(db);
+  try {
+    db.exec(`CREATE TABLE IF NOT EXISTS canvases (
+      id TEXT PRIMARY KEY,
+      session_key TEXT NOT NULL,
+      mermaid_text TEXT,
+      node_count INTEGER DEFAULT 0,
+      created_at INTEGER NOT NULL,
+      updated_at INTEGER NOT NULL,
+      team_id TEXT
+    )`);
+    db.exec(`CREATE TABLE IF NOT EXISTS canvas_nodes (
+      id TEXT PRIMARY KEY,
+      canvas_id TEXT NOT NULL,
+      node_id TEXT NOT NULL,
+      label TEXT NOT NULL,
+      capture_id TEXT,
+      seq INTEGER NOT NULL,
+      created_at INTEGER NOT NULL,
+      FOREIGN KEY (canvas_id) REFERENCES canvases(id)
+    )`);
+    db.exec(`CREATE TABLE IF NOT EXISTS canvas_edges (
+      id TEXT PRIMARY KEY,
+      canvas_id TEXT NOT NULL,
+      from_node_id TEXT NOT NULL,
+      to_node_id TEXT NOT NULL,
+      label TEXT,
+      created_at INTEGER NOT NULL,
+      FOREIGN KEY (canvas_id) REFERENCES canvases(id)
+    )`);
+    db.exec(`CREATE INDEX IF NOT EXISTS idx_canvases_session ON canvases(session_key)`);
+    db.exec(`CREATE INDEX IF NOT EXISTS idx_canvas_nodes_canvas ON canvas_nodes(canvas_id)`);
+    const now = Date.now();
+    let canvasRow = db.prepare("SELECT id FROM canvases WHERE session_key = ? ORDER BY updated_at DESC LIMIT 1").get(sessionKey);
+    if (!canvasRow) {
+      const canvasId = generateId2();
+      db.prepare(
+        "INSERT INTO canvases (id, session_key, mermaid_text, node_count, created_at, updated_at, team_id) VALUES (?, ?, NULL, 0, ?, ?, NULL)"
+      ).run(canvasId, sessionKey, now, now);
+      canvasRow = { id: canvasId };
+    }
+    const maxSeq = db.prepare("SELECT MAX(seq) as max_seq FROM canvas_nodes WHERE canvas_id = ?").get(canvasRow.id);
+    const seq = (maxSeq?.max_seq ?? -1) + 1;
+    db.prepare(
+      "INSERT INTO canvas_nodes (id, canvas_id, node_id, label, capture_id, seq, created_at) VALUES (?, ?, ?, ?, NULL, ?, ?)"
+    ).run(generateId2(), canvasRow.id, nodeId, label, seq, now);
+    if (seq > 0) {
+      const prevNode = db.prepare("SELECT node_id FROM canvas_nodes WHERE canvas_id = ? ORDER BY seq DESC LIMIT 1 OFFSET 1").get(canvasRow.id);
+      if (prevNode) {
+        db.prepare(
+          "INSERT INTO canvas_edges (id, canvas_id, from_node_id, to_node_id, label, created_at) VALUES (?, ?, ?, ?, ?, ?)"
+        ).run(generateId2(), canvasRow.id, prevNode.node_id, nodeId, inferEdgeLabel(toolName), now);
+      }
+    }
+    const nodeCount = db.prepare("SELECT COUNT(*) as count FROM canvas_nodes WHERE canvas_id = ?").get(canvasRow.id);
+    const mermaidText = renderCanvasMermaid(db, canvasRow.id);
+    db.prepare("UPDATE canvases SET node_count = ?, updated_at = ?, mermaid_text = ? WHERE id = ?").run(
+      nodeCount.count,
+      now,
+      mermaidText,
+      canvasRow.id
+    );
+  } finally {
+    db.close();
+  }
+}
+function buildToolLabel(toolName, toolInput) {
+  if (toolName === "Bash" || toolName === "exec") {
+    const cmd = toolInput.command ?? "";
+    return truncateLabel(cmd.replace(/\n/g, " ").trim(), 40);
+  }
+  if (toolName === "Write" || toolName === "Edit" || toolName === "MultiEdit") {
+    const fp = toolInput.file_path ?? "";
+    return truncateLabel(fp, 40);
+  }
+  if (toolName === "Read") {
+    const fp = toolInput.file_path ?? "";
+    return truncateLabel(`read ${fp}`, 40);
+  }
+  if (toolName === "grep" || toolName === "search") {
+    const pattern = toolInput.pattern ?? toolInput.query ?? "";
+    return truncateLabel(`search: ${pattern}`, 40);
+  }
+  return truncateLabel(toolName, 40);
+}
+function buildRawRefContent(toolName, toolInput, toolResponse) {
+  const lines = [
+    `# Tool: ${toolName}`,
+    `## Input`,
+    "```json",
+    JSON.stringify(toolInput, null, 2),
+    "```",
+    `## Output`
+  ];
+  if (typeof toolResponse === "string") {
+    lines.push("```", toolResponse, "```");
+  } else if (toolResponse && typeof toolResponse === "object") {
+    const resp = toolResponse;
+    if (resp.content && Array.isArray(resp.content)) {
+      for (const c of resp.content) {
+        if (c.type === "text" && c.text) {
+          lines.push("```", c.text, "```");
+        }
+      }
+    } else {
+      lines.push("```json", JSON.stringify(toolResponse, null, 2), "```");
+    }
+  } else {
+    lines.push("(no output)");
+  }
+  return lines.join("\n");
+}
+function inferEdgeLabel(toolName) {
+  if (toolName === "Bash" || toolName === "exec") return "ran";
+  if (toolName === "Write" || toolName === "Edit" || toolName === "MultiEdit") return "edited";
+  if (toolName === "Read") return "read";
+  if (toolName === "grep" || toolName === "search") return "searched";
+  return "next";
+}
+function truncateLabel(s, maxLen) {
+  if (s.length <= maxLen) return s;
+  return s.slice(0, maxLen - 3) + "...";
+}
+async function extractSkillFromCapture(dbPath, captureId) {
+  const db = new Database8(dbPath, { readonly: true });
+  try {
+    const row = db.prepare("SELECT id, content, type, tags, team_id, agent_id FROM captures WHERE id = ? AND deleted_at IS NULL").get(captureId);
+    if (!row || row.type !== "task") return;
+    const tags = row.tags ? JSON.parse(row.tags) : [];
+    const steps = extractStepsFromContent(row.content);
+    if (steps.length < 2) return;
+    const triggers = extractTriggersFromContent(row.content, tags);
+    const skillName = extractSkillNameFromContent(row.content) ?? `skill-${captureId.slice(-8)}`;
+    const description = row.content.split(/[.!]\s/)[0].slice(0, 120);
+    const existing = db.prepare("SELECT id, version, created_at FROM skills WHERE name = ? ORDER BY version DESC LIMIT 1").get(skillName);
+    const skillId = existing?.id ?? generateId2();
+    const version = (existing?.version ?? 0) + 1;
+    const now = Date.now();
+    db.close();
+    const writeDb = new Database8(dbPath);
+    ensureSchema2(writeDb);
+    try {
+      writeDb.prepare(
+        `INSERT INTO skills (id, team_id, agent_id, name, description, content, version, created_at, updated_at, trigger_conditions, steps, validation_rules, source_capture_ids, archived)
+           VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, 0)
+           ON CONFLICT(id) DO UPDATE SET
+             version = excluded.version, updated_at = excluded.updated_at,
+             trigger_conditions = excluded.trigger_conditions, steps = excluded.steps,
+             source_capture_ids = excluded.source_capture_ids`
+      ).run(
+        skillId,
+        row.team_id ?? "default",
+        row.agent_id ?? "pipeline",
+        skillName,
+        description,
+        row.content,
+        version,
+        existing?.created_at ?? now,
+        now,
+        JSON.stringify(triggers),
+        JSON.stringify(steps),
+        null,
+        JSON.stringify([captureId])
+      );
+      logToFile(`Stop: extracted skill "${skillName}" v${version} from capture ${captureId}`);
+    } finally {
+      writeDb.close();
+    }
+  } finally {
+    if (db.open) db.close();
+  }
+}
+function extractStepsFromContent(content) {
+  const steps = [];
+  const numberedMatch = content.match(/(?:^|\n)\s*(\d+)[.)]\s+(.+)/g);
+  if (numberedMatch) {
+    for (const match of numberedMatch) {
+      const step = match.replace(/(?:^|\n)\s*\d+[.)]\s+/, "").trim();
+      if (step.length > 5 && step.length < 200) steps.push(step);
+    }
+  }
+  if (steps.length === 0) {
+    const bulletMatch = content.match(/(?:^|\n)\s*[-*]\s+(.+)/g);
+    if (bulletMatch) {
+      for (const match of bulletMatch) {
+        const step = match.replace(/(?:^|\n)\s*[-*]\s+/, "").trim();
+        if (step.length > 5 && step.length < 200) steps.push(step);
+      }
+    }
+  }
+  return steps.slice(0, 10);
+}
+function extractTriggersFromContent(content, tags) {
+  const triggers = /* @__PURE__ */ new Set();
+  for (const tag of tags) {
+    if (tag.length > 2 && tag !== "task") triggers.add(tag);
+  }
+  const firstWords = content.slice(0, 200).split(/\s+/).filter((w) => w.length > 4);
+  for (const word of firstWords.slice(0, 5)) {
+    triggers.add(word.toLowerCase().replace(/[^a-z0-9]/g, ""));
+  }
+  return Array.from(triggers).slice(0, 8);
+}
+function extractSkillNameFromContent(content) {
+  const firstLine = content.split("\n")[0].trim();
+  if (firstLine.length > 5 && firstLine.length < 60) {
+    return firstLine.replace(/[^a-zA-Z0-9\s-]/g, "").trim().toLowerCase().replace(/\s+/g, "-");
+  }
+  return null;
+}
+function getCanvasContext(dbPath, cwd) {
+  const sessionKey = hashPath(cwd);
+  const db = new Database8(dbPath, { readonly: true });
+  try {
+    const row = db.prepare("SELECT mermaid_text, node_count FROM canvases WHERE session_key = ? ORDER BY updated_at DESC LIMIT 1").get(sessionKey);
+    if (!row || !row.mermaid_text || row.node_count === 0) return null;
+    return `## Task Canvas (${row.node_count} steps)
+
+\`\`\`mermaid
+${row.mermaid_text}
+\`\`\`
+
+Drill down: call ref_read(node_id) to get raw output for any node.`;
+  } finally {
+    db.close();
+  }
+}
+function getSkillContext(dbPath, query) {
+  const db = new Database8(dbPath, { readonly: true });
+  try {
+    const archived = db.prepare(
+      "SELECT name, description, steps FROM skills WHERE archived = 1 ORDER BY updated_at DESC LIMIT 3"
+    ).all();
+    const allSkills = db.prepare(
+      "SELECT name, description, steps, trigger_conditions FROM skills WHERE archived = 0 ORDER BY updated_at DESC LIMIT 20"
+    ).all();
+    const matched = [];
+    const queryLower = query.toLowerCase();
+    for (const skill of allSkills) {
+      if (!skill.trigger_conditions) continue;
+      const triggers = JSON.parse(skill.trigger_conditions);
+      if (triggers.some((t) => queryLower.includes(t.toLowerCase()))) {
+        matched.push(skill);
+      }
+    }
+    if (archived.length === 0 && matched.length === 0) return null;
+    const lines = [];
+    if (archived.length > 0) {
+      lines.push("## Archived Skills (always available)");
+      for (const s of archived) {
+        const steps = s.steps ? JSON.parse(s.steps) : [];
+        const stepStr = steps.length > 0 ? `
+  Steps: ${steps.slice(0, 3).join(" \u2192 ")}` : "";
+        lines.push(`- **${s.name}**: ${s.description ?? ""}${stepStr}`);
+      }
+    }
+    if (matched.length > 0) {
+      lines.push("## Matched Skills");
+      for (const s of matched.slice(0, 2)) {
+        const steps = s.steps ? JSON.parse(s.steps) : [];
+        const stepStr = steps.length > 0 ? `
+  Steps: ${steps.slice(0, 3).join(" \u2192 ")}` : "";
+        lines.push(`- **${s.name}**: ${s.description ?? ""}${stepStr}`);
+      }
+    }
+    return lines.join("\n");
+  } finally {
+    db.close();
+  }
+}
+function renderCanvasMermaid(db, canvasId) {
+  const nodeRows = db.prepare("SELECT * FROM canvas_nodes WHERE canvas_id = ? ORDER BY seq ASC").all(canvasId);
+  const edgeRows = db.prepare("SELECT * FROM canvas_edges WHERE canvas_id = ? ORDER BY created_at ASC").all(canvasId);
+  const lines = ["graph LR"];
+  for (const node of nodeRows) {
+    const safeLabel = node.label.replace(/"/g, "'");
+    lines.push(`  ${node.node_id}["${safeLabel}"]`);
+  }
+  for (const edge of edgeRows) {
+    if (edge.label) {
+      const safeLabel = edge.label.replace(/"/g, "'");
+      lines.push(`  ${edge.from_node_id} -->|${safeLabel}| ${edge.to_node_id}`);
+    } else {
+      lines.push(`  ${edge.from_node_id} --> ${edge.to_node_id}`);
+    }
+  }
+  return lines.join("\n");
+}
 
 // src/hooks.ts
 init_esm_shims();
 import { execFileSync as execFileSync2 } from "child_process";
-import { existsSync as existsSync8, mkdirSync as mkdirSync5, readFileSync as readFileSync6, writeFileSync as writeFileSync5 } from "fs";
-import { homedir as homedir7 } from "os";
-import { dirname as dirname5, join as join9 } from "path";
+import { existsSync as existsSync9, mkdirSync as mkdirSync6, readFileSync as readFileSync7, writeFileSync as writeFileSync6 } from "fs";
+import { homedir as homedir8 } from "os";
+import { dirname as dirname5, join as join10 } from "path";
 function hookCommand(subcommand) {
   try {
     const binPath = execFileSync2("which", ["remem-mcp"], { encoding: "utf-8" }).trim();
-    if (binPath && existsSync8(binPath)) {
+    if (binPath && existsSync9(binPath)) {
       return `${binPath} ${subcommand}`;
     }
   } catch {
   }
   return `npx --prefer-offline -y remem-mcp ${subcommand}`;
 }
+var CODEX_HOOK_SUBCOMMANDS = [
+  "hook-recall",
+  "hook-pre-tool-use",
+  "hook-post-tool-use",
+  "hook-post-compaction",
+  "hook-user-prompt",
+  "hook-stop",
+  "hook-session-end"
+];
+function hasCodexRememHooks(content) {
+  return CODEX_HOOK_SUBCOMMANDS.some((subcommand) => content.includes(` ${subcommand}"`));
+}
+function removeCodexHooksFromToml(content) {
+  const lines = content.split(/\r?\n/);
+  const output2 = [];
+  let index = 0;
+  while (index < lines.length) {
+    const match = lines[index].match(/^\[\[hooks\.([A-Za-z]+)\]\]\s*$/);
+    if (!match) {
+      output2.push(lines[index]);
+      index++;
+      continue;
+    }
+    const event = match[1];
+    const nestedPrefix = `[[hooks.${event}.hooks]]`;
+    let end = index + 1;
+    while (end < lines.length) {
+      const line2 = lines[end];
+      if (line2.startsWith(nestedPrefix)) {
+        end++;
+        continue;
+      }
+      if (/^\[./.test(line2)) break;
+      end++;
+    }
+    const block = lines.slice(index, end);
+    if (CODEX_HOOK_SUBCOMMANDS.some((subcommand) => block.includes(` ${subcommand}"`))) {
+      while (output2.length > 0 && (output2[output2.length - 1].trim() === "" || /^\s*#/.test(output2[output2.length - 1]) && output2[output2.length - 1].includes("remem-mcp"))) {
+        output2.pop();
+      }
+    } else {
+      output2.push(...block);
+    }
+    index = end;
+  }
+  return output2.join("\n").replace(/\n{3,}/g, "\n\n").trimEnd();
+}
 var HOOKS_CONFIG = {
   SessionStart: [
     {
@@ -7214,17 +7920,17 @@ var HOOKS_CONFIG = {
   ]
 };
 function readJsonConfig(path) {
-  if (!existsSync8(path)) return {};
+  if (!existsSync9(path)) return {};
   try {
-    return JSON.parse(readFileSync6(path, "utf-8"));
+    return JSON.parse(readFileSync7(path, "utf-8"));
   } catch {
     return {};
   }
 }
 function writeJsonConfig(path, data) {
   const dir = dirname5(path);
-  if (!existsSync8(dir)) mkdirSync5(dir, { recursive: true });
-  writeFileSync5(path, `${JSON.stringify(data, null, 2)}
+  if (!existsSync9(dir)) mkdirSync6(dir, { recursive: true });
+  writeFileSync6(path, `${JSON.stringify(data, null, 2)}
 `, "utf-8");
 }
 function mergeHooks(config, hooks) {
@@ -7245,8 +7951,8 @@ function mergeHooks(config, hooks) {
   };
 }
 function installDevinHooks() {
-  const configPath = join9(homedir7(), ".config", "devin", "config.json");
-  if (!existsSync8(dirname5(configPath))) {
+  const configPath = join10(homedir8(), ".config", "devin", "config.json");
+  if (!existsSync9(dirname5(configPath))) {
     return false;
   }
   const config = readJsonConfig(configPath);
@@ -7256,9 +7962,9 @@ function installDevinHooks() {
   return true;
 }
 function installClaudeCodeHooks() {
-  const settingsPath = join9(homedir7(), ".claude", "settings.json");
-  const claudeDir = join9(homedir7(), ".claude");
-  if (!existsSync8(claudeDir)) {
+  const settingsPath = join10(homedir8(), ".claude", "settings.json");
+  const claudeDir = join10(homedir8(), ".claude");
+  if (!existsSync9(claudeDir)) {
     return false;
   }
   const { PostCompaction: _omit, ...baseWithoutPostCompaction } = HOOKS_CONFIG;
@@ -7294,12 +8000,12 @@ function installClaudeCodeHooks() {
   return true;
 }
 function installCodexHooks() {
-  const configPath = join9(homedir7(), ".codex", "config.toml");
-  if (!existsSync8(configPath)) {
+  const configPath = join10(homedir8(), ".codex", "config.toml");
+  if (!existsSync9(configPath)) {
     return false;
   }
-  let content = readFileSync6(configPath, "utf-8");
-  if (content.includes(">>> remem-mcp SessionStart >>>")) {
+  let content = readFileSync7(configPath, "utf-8");
+  if (hasCodexRememHooks(content)) {
     console.log(`  Codex CLI: Hooks already installed in ${configPath}`);
     return true;
   }
@@ -7371,7 +8077,7 @@ timeout = 10
 # <<< remem-mcp SessionEnd <<<
 `;
   content = content.trimEnd() + "\n" + hooksToml;
-  writeFileSync5(configPath, content, "utf-8");
+  writeFileSync6(configPath, content, "utf-8");
   console.log(`  Codex CLI: Hooks wired into ${configPath}`);
   console.log(`    Note: Set sandbox_mode = "danger-full-access" for MCP tools to work.`);
   return true;
@@ -7416,8 +8122,8 @@ async function uninstallHooks() {
     "PostCompaction",
     "UserPromptSubmit"
   ];
-  const devinPath = join9(homedir7(), ".config", "devin", "config.json");
-  if (existsSync8(devinPath)) {
+  const devinPath = join10(homedir8(), ".config", "devin", "config.json");
+  if (existsSync9(devinPath)) {
     const config = readJsonConfig(devinPath);
     if (config.hooks) {
       const hooks = config.hooks;
@@ -7441,8 +8147,8 @@ async function uninstallHooks() {
       removed++;
     }
   }
-  const claudePath = join9(homedir7(), ".claude", "settings.json");
-  if (existsSync8(claudePath)) {
+  const claudePath = join10(homedir8(), ".claude", "settings.json");
+  if (existsSync9(claudePath)) {
     const config = readJsonConfig(claudePath);
     if (config.hooks) {
       const hooks = config.hooks;
@@ -7466,12 +8172,13 @@ async function uninstallHooks() {
       removed++;
     }
   }
-  const codexPath = join9(homedir7(), ".codex", "config.toml");
-  if (existsSync8(codexPath)) {
-    let content = readFileSync6(codexPath, "utf-8");
-    if (content.includes(">>> remem-mcp")) {
-      content = content.replace(/\n?# >>> remem-mcp[\s\S]*?# <<< remem-mcp[^<]*<<<\n?/g, "\n");
-      writeFileSync5(codexPath, content.trimEnd() + "\n", "utf-8");
+  const codexPath = join10(homedir8(), ".codex", "config.toml");
+  if (existsSync9(codexPath)) {
+    let content = readFileSync7(codexPath, "utf-8");
+    const cleaned = removeCodexHooksFromToml(content);
+    if (cleaned !== content) {
+      content = cleaned;
+      writeFileSync6(codexPath, content.trimEnd() + "\n", "utf-8");
       console.log(`  Codex CLI: Hooks removed from ${codexPath}`);
       removed++;
     }
@@ -7487,22 +8194,22 @@ Hooks removed from ${removed} agent(s).`);
 // src/import.ts
 init_esm_shims();
 init_ulid();
-import { existsSync as existsSync9, readFileSync as readFileSync7 } from "fs";
-import { dirname as dirname6, join as join10 } from "path";
+import { existsSync as existsSync10, readFileSync as readFileSync8 } from "fs";
+import { dirname as dirname6, join as join11 } from "path";
 import { fileURLToPath as fileURLToPath3 } from "url";
 import Database9 from "better-sqlite3";
 import * as sqliteVec3 from "sqlite-vec";
 var __dirname3 = dirname6(fileURLToPath3(import.meta.url));
-function ensureSchema2(db) {
+function ensureSchema3(db) {
   const candidates = [
-    join10(__dirname3, "storage", "schema.sql"),
-    join10(__dirname3, "schema.sql"),
-    join10(__dirname3, "..", "storage", "schema.sql")
+    join11(__dirname3, "storage", "schema.sql"),
+    join11(__dirname3, "schema.sql"),
+    join11(__dirname3, "..", "storage", "schema.sql")
   ];
   let schema = null;
   for (const path of candidates) {
     try {
-      schema = readFileSync7(path, "utf-8");
+      schema = readFileSync8(path, "utf-8");
       break;
     } catch {
     }
@@ -7513,11 +8220,11 @@ function ensureSchema2(db) {
   db.exec(schema);
 }
 function importData(dbPath, inputPath) {
-  if (!existsSync9(inputPath)) {
+  if (!existsSync10(inputPath)) {
     console.error(`Error: File not found: ${inputPath}`);
     process.exit(1);
   }
-  const raw = readFileSync7(inputPath, "utf-8");
+  const raw = readFileSync8(inputPath, "utf-8");
   let data;
   try {
     data = JSON.parse(raw);
@@ -7533,7 +8240,7 @@ function importData(dbPath, inputPath) {
   db.pragma("journal_mode = WAL");
   db.pragma("synchronous = NORMAL");
   sqliteVec3.load(db);
-  ensureSchema2(db);
+  ensureSchema3(db);
   let inserted = 0;
   let skipped = 0;
   let messagesInserted = 0;
@@ -7591,9 +8298,9 @@ function importData(dbPath, inputPath) {
 
 // src/install-mcp.ts
 init_esm_shims();
-import { existsSync as existsSync10, mkdirSync as mkdirSync6, readFileSync as readFileSync8, writeFileSync as writeFileSync6 } from "fs";
-import { homedir as homedir8 } from "os";
-import { dirname as dirname7, join as join11 } from "path";
+import { existsSync as existsSync11, mkdirSync as mkdirSync7, readFileSync as readFileSync9, writeFileSync as writeFileSync7 } from "fs";
+import { homedir as homedir9 } from "os";
+import { dirname as dirname7, join as join12 } from "path";
 var MCP_SERVER_ENTRY = {
   command: "npx",
   args: ["-y", "remem-mcp"]
@@ -7608,26 +8315,26 @@ var MCP_SERVER_ENTRY_WITH_GLOBAL = {
 var JSON_TARGETS = [
   {
     name: "Claude Code",
-    path: join11(homedir8(), ".claude.json"),
+    path: join12(homedir9(), ".claude.json"),
     key: "mcpServers"
   },
   {
     name: "Devin CLI",
-    path: join11(homedir8(), ".config", "devin", "mcp_config.json"),
+    path: join12(homedir9(), ".config", "devin", "mcp_config.json"),
     key: "mcpServers",
     useGlobal: true
   },
   {
     name: "Cursor",
-    path: join11(homedir8(), ".cursor", "mcp.json"),
+    path: join12(homedir9(), ".cursor", "mcp.json"),
     key: "mcpServers"
   }
 ];
 function registerJsonServer(target) {
   let config = {};
-  if (existsSync10(target.path)) {
+  if (existsSync11(target.path)) {
     try {
-      config = JSON.parse(readFileSync8(target.path, "utf-8"));
+      config = JSON.parse(readFileSync9(target.path, "utf-8"));
     } catch {
       console.log(`  ${target.name}: Config file unreadable, skipping.`);
       return false;
@@ -7642,10 +8349,10 @@ function registerJsonServer(target) {
   servers["remem-mcp"] = entry;
   config[target.key] = servers;
   const dir = dirname7(target.path);
-  if (!existsSync10(dir)) {
-    mkdirSync6(dir, { recursive: true });
+  if (!existsSync11(dir)) {
+    mkdirSync7(dir, { recursive: true });
   }
-  writeFileSync6(target.path, JSON.stringify(config, null, 2) + "\n", "utf-8");
+  writeFileSync7(target.path, JSON.stringify(config, null, 2) + "\n", "utf-8");
   console.log(`  ${target.name}: MCP server registered.`);
   return true;
 }
@@ -7654,12 +8361,12 @@ async function installMcpServer() {
   let count = 0;
   for (const target of JSON_TARGETS) {
     const agentDir = dirname7(target.path);
-    if (!existsSync10(agentDir)) {
+    if (!existsSync11(agentDir)) {
       if (target.name === "Cursor") {
         const cursorApp = "/Applications/Cursor.app";
-        const cursorAppHome = join11(homedir8(), "Library", "Application Support", "Cursor");
-        if (existsSync10(cursorApp) || existsSync10(cursorAppHome)) {
-          mkdirSync6(agentDir, { recursive: true });
+        const cursorAppHome = join12(homedir9(), "Library", "Application Support", "Cursor");
+        if (existsSync11(cursorApp) || existsSync11(cursorAppHome)) {
+          mkdirSync7(agentDir, { recursive: true });
         } else {
           continue;
         }
@@ -7671,9 +8378,9 @@ async function installMcpServer() {
       count++;
     }
   }
-  const codexConfig = join11(homedir8(), ".codex", "config.toml");
-  if (existsSync10(codexConfig)) {
-    const content = readFileSync8(codexConfig, "utf-8");
+  const codexConfig = join12(homedir9(), ".codex", "config.toml");
+  if (existsSync11(codexConfig)) {
+    const content = readFileSync9(codexConfig, "utf-8");
     if (content.includes("[mcp_servers.remem-mcp]")) {
       console.log("  Codex CLI: Already registered.");
       count++;
@@ -7686,7 +8393,7 @@ args = ["-y", "remem-mcp"]
 [mcp_servers.remem-mcp.env]
 REMEM_GLOBAL_SESSION_KEY = "global"
 `;
-      writeFileSync6(codexConfig, content + tomlEntry, "utf-8");
+      writeFileSync7(codexConfig, content + tomlEntry, "utf-8");
       console.log("  Codex CLI: MCP server registered.");
       count++;
     }
@@ -7702,18 +8409,18 @@ MCP server registered in ${count} agent config(s).`);
 
 // src/install-skill.ts
 init_esm_shims();
-import { existsSync as existsSync11, mkdirSync as mkdirSync7, readFileSync as readFileSync9, writeFileSync as writeFileSync7 } from "fs";
-import { homedir as homedir9 } from "os";
-import { dirname as dirname8, join as join12 } from "path";
+import { existsSync as existsSync12, mkdirSync as mkdirSync8, readFileSync as readFileSync10, writeFileSync as writeFileSync8 } from "fs";
+import { homedir as homedir10 } from "os";
+import { dirname as dirname8, join as join13 } from "path";
 function loadSkillContent() {
   const candidates = [
-    join12(process.cwd(), "skills", "remem-mcp", "SKILL.md"),
-    join12(__dirname, "..", "skills", "remem-mcp", "SKILL.md"),
-    join12(__dirname, "skills", "remem-mcp", "SKILL.md")
+    join13(process.cwd(), "skills", "remem-mcp", "SKILL.md"),
+    join13(__dirname, "..", "skills", "remem-mcp", "SKILL.md"),
+    join13(__dirname, "skills", "remem-mcp", "SKILL.md")
   ];
   for (const path of candidates) {
     try {
-      return readFileSync9(path, "utf-8");
+      return readFileSync10(path, "utf-8");
     } catch {
     }
   }
@@ -7724,19 +8431,19 @@ function loadSkillContent() {
 var SKILL_TARGETS = [
   {
     name: "Devin CLI",
-    path: join12(homedir9(), ".config", "devin", "skills", "remem-mcp", "SKILL.md")
+    path: join13(homedir10(), ".config", "devin", "skills", "remem-mcp", "SKILL.md")
   },
   {
     name: "Claude Code",
-    path: join12(homedir9(), ".claude", "skills", "remem-mcp", "SKILL.md")
+    path: join13(homedir10(), ".claude", "skills", "remem-mcp", "SKILL.md")
   },
   {
     name: "Codex CLI",
-    path: join12(homedir9(), ".codex", "skills", "remem-mcp", "SKILL.md")
+    path: join13(homedir10(), ".codex", "skills", "remem-mcp", "SKILL.md")
   },
   {
     name: "Generic (.agents)",
-    path: join12(homedir9(), ".agents", "skills", "remem-mcp", "SKILL.md")
+    path: join13(homedir10(), ".agents", "skills", "remem-mcp", "SKILL.md")
   }
 ];
 async function installSkill() {
@@ -7744,15 +8451,15 @@ async function installSkill() {
   let installed = 0;
   for (const target of SKILL_TARGETS) {
     const dir = dirname8(target.path);
-    if (!existsSync11(dir)) {
-      mkdirSync7(dir, { recursive: true });
+    if (!existsSync12(dir)) {
+      mkdirSync8(dir, { recursive: true });
     }
-    if (existsSync11(target.path)) {
+    if (existsSync12(target.path)) {
       console.log(`  ${target.name}: Already installed. Updated.`);
     } else {
       console.log(`  ${target.name}: Installed.`);
     }
-    writeFileSync7(target.path, skillContent, "utf-8");
+    writeFileSync8(target.path, skillContent, "utf-8");
     installed++;
   }
   console.log(`
@@ -7765,47 +8472,268 @@ Skill installed to ${installed} location(s).`);
   console.log("  - Forget only on explicit user request");
 }
 
-// src/security/audit.ts
+// src/pipeline/mermaid.ts
 init_esm_shims();
-import { createHash as createHash4 } from "crypto";
-import { appendFileSync as appendFileSync3, existsSync as existsSync12, mkdirSync as mkdirSync8 } from "fs";
-import { dirname as dirname9 } from "path";
-var AuditLogger = class {
-  logPath;
-  enabled;
-  constructor(logPath, enabled) {
-    this.logPath = logPath;
-    this.enabled = enabled;
-    if (enabled) {
-      const dir = dirname9(logPath);
-      if (!existsSync12(dir)) mkdirSync8(dir, { recursive: true });
-    }
-  }
-  /** Log a tool call. */
-  log(entry) {
-    if (!this.enabled) return;
-    const fullEntry = {
-      ts: Date.now(),
-      ...entry
+init_ulid();
+var MermaidPipeline = class {
+  name = "mermaid";
+  requiresLLM = false;
+  async process(input, ctx) {
+    const nodeId = generateId();
+    const label = extractNodeLabel(input);
+    const node = {
+      id: nodeId,
+      label,
+      captureId: input.id
     };
-    const line2 = JSON.stringify(fullEntry);
+    const edges = [];
     try {
-      appendFileSync3(this.logPath, `${line2}
-`);
-    } catch (err) {
-      console.error(`[remem-mcp] Audit log write failed: ${err}`);
+      const prevNode = await ctx.storage.getLatestCanvasNode(input.sessionKey);
+      if (prevNode) {
+        edges.push({
+          from: prevNode.id,
+          to: nodeId,
+          label: inferEdgeLabel2(prevNode, input)
+        });
+      }
+    } catch {
     }
-  }
-  /** Hash the arguments for the audit log. The log does not store raw arguments. */
-  static hashArgs(args) {
-    const json = JSON.stringify(args);
-    return createHash4("sha256").update(json).digest("hex");
+    try {
+      await ctx.storage.appendCanvasNode(input.sessionKey, node, edges);
+    } catch {
+    }
+    try {
+      await ctx.storage.writeRef(input.sessionKey, nodeId, input.content);
+    } catch {
+    }
+    const canvas = { nodes: [node], edges };
+    return { canvas };
+  }
+};
+var LLMMermaidPipeline = class {
+  constructor(llm) {
+    this.llm = llm;
+  }
+  llm;
+  name = "mermaid-llm";
+  requiresLLM = true;
+  async process(input, ctx) {
+    const nodeId = generateId();
+    let label = extractNodeLabel(input);
+    try {
+      const prompt2 = `Summarize this ${input.type} in max 40 characters. Output ONLY the summary, no quotes:
+
+${input.content.slice(0, 500)}`;
+      const response = await this.llm.complete(prompt2);
+      label = response.trim().slice(0, 40);
+    } catch {
+    }
+    const node = { id: nodeId, label, captureId: input.id };
+    const edges = [];
+    try {
+      const prevNode = await ctx.storage.getLatestCanvasNode(input.sessionKey);
+      if (prevNode) {
+        let edgeLabel = inferEdgeLabel2(prevNode, input);
+        try {
+          const edgePrompt = `In one word, describe the transition from "${prevNode.label}" to "${label}". Output ONLY the word:`;
+          const edgeResp = await this.llm.complete(edgePrompt);
+          edgeLabel = edgeResp.trim().slice(0, 20);
+        } catch {
+        }
+        edges.push({ from: prevNode.id, to: nodeId, label: edgeLabel });
+      }
+    } catch {
+    }
+    try {
+      await ctx.storage.appendCanvasNode(input.sessionKey, node, edges);
+    } catch {
+    }
+    try {
+      await ctx.storage.writeRef(input.sessionKey, nodeId, input.content);
+    } catch {
+    }
+    return { canvas: { nodes: [node], edges } };
+  }
+};
+function extractNodeLabel(input) {
+  const content = input.content.trim();
+  if (input.type === "error") {
+    const errorMatch = content.match(/Error[:\s]+(.+)/i);
+    if (errorMatch) return truncate(errorMatch[1].trim(), 40);
+  }
+  if (input.type === "decision") {
+    const firstSentence = content.split(/[.!]\s/)[0];
+    return truncate(firstSentence, 40);
+  }
+  if (input.type === "task") {
+    return truncate(content.split("\n")[0], 40);
+  }
+  const firstLine = content.split("\n").find((l) => l.trim().length > 0);
+  return truncate(firstLine ?? "untitled", 40);
+}
+function inferEdgeLabel2(prev, current) {
+  if (current.type === "error") return "failed";
+  if (current.type === "decision") return "decided";
+  if (current.type === "task") return "executed";
+  if (current.type === "learning") return "learned";
+  return "next";
+}
+function truncate(s, maxLen) {
+  if (s.length <= maxLen) return s;
+  return s.slice(0, maxLen - 3) + "...";
+}
+
+// src/pipeline/skill.ts
+init_esm_shims();
+init_ulid();
+var SkillExtractionPipeline = class {
+  name = "skill";
+  requiresLLM = false;
+  async process(input, ctx) {
+    if (input.type !== "task") return {};
+    const steps = extractSteps(input.content);
+    const triggers = extractTriggers(input.content, input.tags);
+    const validation = extractValidationRules(input.content);
+    if (steps.length < 2) return {};
+    const skillName = extractSkillName(input.content) ?? `skill-${input.id.slice(-8)}`;
+    const description = extractDescription(input.content);
+    let skillId = null;
+    try {
+      const now = Date.now();
+      skillId = generateId();
+      await ctx.storage.putSkill({
+        id: skillId,
+        teamId: input.teamId ?? "default",
+        agentId: "pipeline",
+        name: skillName,
+        description,
+        content: input.content,
+        version: 1,
+        createdAt: now,
+        updatedAt: now,
+        triggerConditions: triggers,
+        steps,
+        validationRules: validation,
+        sourceCaptureIds: [input.id],
+        archived: false
+      });
+    } catch (e) {
+      return {};
+    }
+    return { skill: { id: skillId, name: skillName, steps, triggers, validation } };
+  }
+};
+function extractSteps(content) {
+  const steps = [];
+  const numberedMatch = content.match(/(?:^|\n)\s*(\d+)[.)]\s+(.+)/g);
+  if (numberedMatch) {
+    for (const match of numberedMatch) {
+      const step = match.replace(/(?:^|\n)\s*\d+[.)]\s+/, "").trim();
+      if (step.length > 5 && step.length < 200) steps.push(step);
+    }
+  }
+  if (steps.length === 0) {
+    const bulletMatch = content.match(/(?:^|\n)\s*[-*]\s+(.+)/g);
+    if (bulletMatch) {
+      for (const match of bulletMatch) {
+        const step = match.replace(/(?:^|\n)\s*[-*]\s+/, "").trim();
+        if (step.length > 5 && step.length < 200) steps.push(step);
+      }
+    }
+  }
+  if (steps.length === 0) {
+    const stepMatch = content.match(/(?:^|\n)\s*Step\s+\d+:\s*(.+)/gi);
+    if (stepMatch) {
+      for (const match of stepMatch) {
+        const step = match.replace(/(?:^|\n)\s*Step\s+\d+:\s*/i, "").trim();
+        if (step.length > 5 && step.length < 200) steps.push(step);
+      }
+    }
+  }
+  return steps.slice(0, 10);
+}
+function extractTriggers(content, tags) {
+  const triggers = /* @__PURE__ */ new Set();
+  for (const tag of tags) {
+    if (tag.length > 2 && tag !== "task") triggers.add(tag);
+  }
+  const firstWords = content.slice(0, 200).split(/\s+/).filter((w) => w.length > 4);
+  for (const word of firstWords.slice(0, 5)) {
+    triggers.add(word.toLowerCase().replace(/[^a-z0-9]/g, ""));
+  }
+  return Array.from(triggers).slice(0, 8);
+}
+function extractValidationRules(content) {
+  const rules = [];
+  const patterns = [
+    /(?:verify|check|validate|confirm)\s+[^.]+/gi,
+    /(?:success|succeeded|passed)\s+[^.]+/gi,
+    /(?:expected|should)\s+[^.]+/gi
+  ];
+  for (const pattern of patterns) {
+    const matches = content.match(pattern);
+    if (matches) {
+      for (const match of matches.slice(0, 3)) {
+        rules.push(match.trim());
+      }
+    }
+  }
+  return rules.slice(0, 5);
+}
+function extractSkillName(content) {
+  const firstLine = content.split("\n")[0].trim();
+  if (firstLine.length > 5 && firstLine.length < 60) {
+    return firstLine.replace(/[^a-zA-Z0-9\s-]/g, "").trim().toLowerCase().replace(/\s+/g, "-");
+  }
+  return null;
+}
+function extractDescription(content) {
+  const firstSentence = content.split(/[.!]\s/)[0];
+  return firstSentence.slice(0, 120);
+}
+
+// src/security/audit.ts
+init_esm_shims();
+import { createHash as createHash4 } from "crypto";
+import { appendFileSync as appendFileSync3, existsSync as existsSync13, mkdirSync as mkdirSync9 } from "fs";
+import { dirname as dirname9 } from "path";
+var AuditLogger = class {
+  logPath;
+  enabled;
+  constructor(logPath, enabled) {
+    this.logPath = logPath;
+    this.enabled = enabled;
+    if (enabled) {
+      const dir = dirname9(logPath);
+      if (!existsSync13(dir)) mkdirSync9(dir, { recursive: true });
+    }
+  }
+  /** Log a tool call. */
+  log(entry) {
+    if (!this.enabled) return;
+    const fullEntry = {
+      ts: Date.now(),
+      ...entry
+    };
+    const line2 = JSON.stringify(fullEntry);
+    try {
+      appendFileSync3(this.logPath, `${line2}
+`);
+    } catch (err) {
+      console.error(`[remem-mcp] Audit log write failed: ${err}`);
+    }
+  }
+  /** Hash the arguments for the audit log. The log does not store raw arguments. */
+  static hashArgs(args) {
+    const json = JSON.stringify(args);
+    return createHash4("sha256").update(json).digest("hex");
   }
 };
 
 // src/server.ts
 init_esm_shims();
 init_engine();
+import { execSync as execSync3 } from "child_process";
 import { createHash as createHash5 } from "crypto";
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import {
@@ -7869,6 +8797,7 @@ function formatResults(results) {
 
 // src/server.ts
 init_ulid();
+var indexingStatus = /* @__PURE__ */ new Map();
 function defaultSessionKey() {
   if (process.env.REMEM_SESSION_KEY) return process.env.REMEM_SESSION_KEY;
   const cwd = process.cwd();
@@ -8056,6 +8985,29 @@ var TOOLS = [
       }
     }
   },
+  {
+    name: "feedback",
+    description: "Record a quality signal for a recalled memory. Call this AFTER using a recall result: use 'helpful' if the memory answered your question, 'not_helpful' if it was irrelevant, 'stale' if the information is outdated, or 'wrong' if it is incorrect. This creates a feedback flywheel \u2014 useful memories rise, unhelpful ones fade. Do not call this for memories you have not actually used.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        capture_id: {
+          type: "string",
+          description: "The capture ID from a recall/search result."
+        },
+        signal: {
+          type: "string",
+          enum: ["helpful", "not_helpful", "stale", "wrong"],
+          description: "helpful = memory was useful (salience +0.1, max 2.0). not_helpful = memory was irrelevant (salience -0.1, min 0.1). stale = information is outdated (salience floored at 0.3). wrong = information is incorrect (salience floored at 0.1)."
+        },
+        reason: {
+          type: "string",
+          description: "Optional explanation for the feedback signal."
+        }
+      },
+      required: ["capture_id", "signal"]
+    }
+  },
   {
     name: "search",
     description: "Search memory by keyword or by semantic similarity. Use this tool when recall is too broad and you need specific facts. Automatically searches both project and global cross-project memory when REMEM_GLOBAL_SESSION_KEY is configured.",
@@ -8099,6 +9051,11 @@ var TOOLS = [
           enum: ["text", "json"],
           default: "text",
           description: "The response format. Use 'json' for structured data (e.g. benchmarks). Defaults to 'text'."
+        },
+        explain: {
+          type: "boolean",
+          default: false,
+          description: "When true, attach per-hit score_details explaining ranking (BM25 rank, vector score, entity matches, authority multiplier, feedback salience, link provenance). Useful for debugging search quality."
         }
       },
       required: ["query"]
@@ -8492,7 +9449,7 @@ var TOOLS = [
   },
   {
     name: "codegraph_search",
-    description: "Search for code symbols by name. Returns matching functions, classes, methods, etc. with file paths and line numbers. Use this INSTEAD of grep when looking for function/class/method definitions. If the codebase hasn't been indexed yet, this auto-indexes src/ (or cwd) on first use \u2014 no manual setup needed.",
+    description: "Search for code symbols by name. Returns matching functions, classes, methods, etc. with file paths and line numbers. Use this INSTEAD of grep when looking for function/class/method definitions. If the codebase hasn't been indexed yet, this starts background indexing and asks you to retry in a few seconds \u2014 non-blocking, so you can continue working while indexing runs.",
     inputSchema: {
       type: "object",
       properties: {
@@ -8597,6 +9554,20 @@ var TOOLS = [
       required: ["repo_path"]
     }
   },
+  {
+    name: "codegraph_stats",
+    description: "Return indexed CodeGraph statistics: total symbols, calls, resolved calls, imports, and file counts. Optionally scoped to a repo_path. Use this to check indexing coverage before searching.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        repo_path: {
+          type: "string",
+          description: "Optional: scope stats to this repository root path."
+        },
+        team_id: { type: "string", description: "The team ID for isolation." }
+      }
+    }
+  },
   // ─── Wiki tools ───
   {
     name: "wiki_ingest",
@@ -8870,6 +9841,96 @@ var TOOLS = [
       type: "object",
       properties: {}
     }
+  },
+  {
+    name: "canvas_get",
+    description: "Get the Mermaid task canvas for the current session. The canvas is a symbolic graph of tool calls and state transitions \u2014 it replaces verbose tool logs in your context with a compact Mermaid diagram. Use this to see the task structure without re-reading full tool outputs. Requires REMEM_OFFLOAD_ENABLED=true and pipeline=mermaid.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        session_key: {
+          type: "string",
+          description: "The session key. Defaults to hash(cwd). Use this to get the canvas from a different session."
+        },
+        format: {
+          type: "string",
+          enum: ["mermaid", "json"],
+          default: "mermaid",
+          description: "Output format. 'mermaid' returns the Mermaid graph text. 'json' returns structured nodes/edges."
+        }
+      }
+    }
+  },
+  {
+    name: "ref_read",
+    description: "Read the raw tool output for a specific canvas node by node_id. Use this to drill down from the Mermaid canvas to the full output when you need details. Requires REMEM_OFFLOAD_ENABLED=true and pipeline=mermaid.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        node_id: {
+          type: "string",
+          description: "The node_id from the Mermaid canvas (e.g., '01M0FFZKQT540SVZPAZ4EZVE4G')."
+        }
+      },
+      required: ["node_id"]
+    }
+  },
+  {
+    name: "skill_create",
+    description: "Create a reusable skill (SOP) from a successful task or conversation. Skills are injected into recall when matching trigger conditions are met. Use this after completing a non-trivial task to capture the workflow for reuse.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        name: {
+          type: "string",
+          description: "Short name for the skill (e.g., 'deploy-to-vercel')."
+        },
+        description: {
+          type: "string",
+          description: "One-line description of what the skill does."
+        },
+        content: {
+          type: "string",
+          description: "Full SOP content in markdown. Include steps, commands, and validation."
+        },
+        trigger_conditions: {
+          type: "array",
+          items: { type: "string" },
+          description: "Keywords or patterns that trigger this skill (e.g., ['deploy', 'vercel', 'production'])."
+        },
+        steps: {
+          type: "array",
+          items: { type: "string" },
+          description: "Ordered execution steps."
+        },
+        validation_rules: {
+          type: "array",
+          items: { type: "string" },
+          description: "How to verify the skill succeeded (e.g., ['curl returns 200', 'no errors in logs'])."
+        },
+        source_capture_ids: {
+          type: "array",
+          items: { type: "string" },
+          description: "Capture IDs that this skill was extracted from (for traceability)."
+        },
+        ...TENANT_PARAMS
+      },
+      required: ["name", "content"]
+    }
+  },
+  {
+    name: "skill_archive",
+    description: "Archive a skill \u2014 forces it to always be injected into recall, even when the query doesn't strongly match. Use this for critical SOPs that must always be available.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        id: {
+          type: "string",
+          description: "The skill ID to archive."
+        }
+      },
+      required: ["id"]
+    }
   }
 ];
 var CORE_TOOL_NAMES = /* @__PURE__ */ new Set([
@@ -9004,6 +10065,8 @@ function createServer(opts) {
         return handleRecall(args, opts);
       case "capture":
         return handleCapture(args, opts);
+      case "feedback":
+        return handleFeedback(args, opts);
       case "search":
         return handleSearch(args, opts);
       case "related":
@@ -9050,6 +10113,8 @@ function createServer(opts) {
         return handleCodegraphList(args, opts);
       case "codegraph_detect_changes":
         return handleCodegraphDetectChanges(args, opts);
+      case "codegraph_stats":
+        return handleCodegraphStats(args, opts);
       case "wiki_ingest":
         return handleWikiIngest(args, opts);
       case "wiki_search":
@@ -9082,6 +10147,14 @@ function createServer(opts) {
         return handleSessionCheckpoint(args, opts);
       case "health":
         return handleHealth(args, opts);
+      case "canvas_get":
+        return handleCanvasGet(args, opts);
+      case "ref_read":
+        return handleRefRead(args, opts);
+      case "skill_create":
+        return handleSkillCreate(args, opts);
+      case "skill_archive":
+        return handleSkillArchive(args, opts);
       default:
         return {
           content: [{ type: "text", text: `Error: Unknown tool "${name}".` }],
@@ -9099,6 +10172,12 @@ function extractTenant(args) {
     taskId: args.task_id
   };
 }
+function textResult(text) {
+  return { content: [{ type: "text", text }] };
+}
+function errorResult(text) {
+  return { content: [{ type: "text", text }], isError: true };
+}
 async function handleRecall(args, opts) {
   const query = args.query;
   const sessionKey = args.session_key ?? defaultSessionKey();
@@ -9187,7 +10266,10 @@ async function handleRecall(args, opts) {
       trust_state: r.entry.trustState ?? "candidate"
     }));
     const jsonText = JSON.stringify(
-      vectorDegraded ? { results: jsonResults, _meta: { vector_degraded: true, channels_run: ["keyword"] } } : { results: jsonResults, _meta: { channels_run: mode === "vector" ? ["vector"] : ["keyword", "vector"] } }
+      vectorDegraded ? { results: jsonResults, _meta: { vector_degraded: true, channels_run: ["keyword"] } } : {
+        results: jsonResults,
+        _meta: { channels_run: mode === "vector" ? ["vector"] : ["keyword", "vector"] }
+      }
     );
     opts.audit.log({
       tool: "recall",
@@ -9234,9 +10316,7 @@ ${wikiLines.join("\n")}`;
       limit: 3
     });
     if (scenarios.length > 0) {
-      const scenarioLines = scenarios.map(
-        (s) => `  ${s.summary}`
-      );
+      const scenarioLines = scenarios.map((s) => `  ${s.summary}`);
       text += `
 
 ## Scenarios (L2 summaries)
@@ -9258,6 +10338,27 @@ ${text}`;
   });
   return { content: [{ type: "text", text: finalText }] };
 }
+async function handleFeedback(args, opts) {
+  const captureId = String(args.capture_id ?? "");
+  const signal = String(args.signal ?? "");
+  const reason = args.reason ? String(args.reason) : void 0;
+  if (!captureId || !signal) {
+    return errorResult("capture_id and signal are required");
+  }
+  const validSignals = ["helpful", "not_helpful", "stale", "wrong"];
+  if (!validSignals.includes(signal)) {
+    return errorResult(`signal must be one of: ${validSignals.join(", ")}`);
+  }
+  const storage = opts.storage;
+  const entry = await storage.get(captureId);
+  if (!entry) {
+    return errorResult(`capture not found: ${captureId}`);
+  }
+  storage.recordFeedback(captureId, signal, reason, opts.agentId ?? detectAgentId());
+  return textResult(
+    `Recorded feedback: ${signal} for capture ${captureId.slice(-8)}. Salience multiplier adjusted. This memory will ${signal === "helpful" ? "rank higher" : signal === "not_helpful" ? "rank lower" : signal === "stale" ? "be deprioritized as outdated" : "be deprioritized as incorrect"} in future searches.`
+  );
+}
 async function handleCapture(args, opts) {
   const type2 = args.type ?? "conversation";
   const tags = args.tags ?? [];
@@ -9353,7 +10454,15 @@ async function handleCapture(args, opts) {
   } else {
     opts.audit.log({
       tool: "capture",
-      argsHash: AuditLogger.hashArgs({ type: type2, tags, sessionKey, overrideReason, teamId, userId, taskId }),
+      argsHash: AuditLogger.hashArgs({
+        type: type2,
+        tags,
+        sessionKey,
+        overrideReason,
+        teamId,
+        userId,
+        taskId
+      }),
       resultLen: 0,
       quotaHit: false,
       redacted: wasRedacted
@@ -9417,12 +10526,14 @@ async function handleCapture(args, opts) {
   };
   try {
     await opts.storage.put(entry);
-  } catch {
+  } catch (err) {
+    const errMsg = err instanceof Error ? err.message : String(err);
+    const isBusy = /busy|locked|SQLITE_BUSY/i.test(errMsg);
     return {
       content: [
         {
           type: "text",
-          text: `Error: Database is read-only (sandbox restriction). Capture failed. Set sandbox_mode to "danger-full-access" or add the DB directory to writable roots.`
+          text: isBusy ? `Error: Database is temporarily locked (concurrent write). Retry the capture.` : `Error: Database is read-only (sandbox restriction). Capture failed. Set sandbox_mode to "danger-full-access" or add the DB directory to writable roots.`
         }
       ],
       isError: true
@@ -9550,6 +10661,7 @@ async function handleSearch(args, opts) {
   const query = args.query;
   const mode = args.mode ?? "hybrid";
   const format = args.format ?? "text";
+  const explain = args.explain ?? false;
   const filters = args.filters;
   const limit = Math.min(args.limit ?? 20, 500);
   let queryEmbedding = null;
@@ -9585,7 +10697,8 @@ async function handleSearch(args, opts) {
       limit: projectLimit,
       offset: 0,
       mode,
-      filters: searchFilters
+      filters: searchFilters,
+      explain
     });
     let globalResults = [];
     try {
@@ -9594,7 +10707,8 @@ async function handleSearch(args, opts) {
         limit: reservedGlobal,
         offset: 0,
         mode,
-        filters: searchFilters
+        filters: searchFilters,
+        explain
       });
     } catch {
     }
@@ -9607,7 +10721,8 @@ async function handleSearch(args, opts) {
       limit,
       offset: 0,
       mode,
-      filters: searchFilters
+      filters: searchFilters,
+      explain
     });
   }
   results = dedupByContentPrefix(results, 60);
@@ -9638,7 +10753,10 @@ async function handleSearch(args, opts) {
       trust_state: r.entry.trustState ?? "candidate"
     }));
     const jsonText = JSON.stringify(
-      vectorDegraded ? { results: jsonResults, _meta: { vector_degraded: true, channels_run: ["keyword"] } } : { results: jsonResults, _meta: { channels_run: mode === "vector" ? ["vector"] : ["keyword", "vector"] } }
+      vectorDegraded ? { results: jsonResults, _meta: { vector_degraded: true, channels_run: ["keyword"] } } : {
+        results: jsonResults,
+        _meta: { channels_run: mode === "vector" ? ["vector"] : ["keyword", "vector"] }
+      }
     );
     opts.audit.log({
       tool: "search",
@@ -10368,6 +11486,7 @@ async function handleConfirm(args, opts) {
   }
   try {
     db.prepare("UPDATE captures SET confirmations = confirmations + 1 WHERE id = ?").run(captureId);
+    opts.storage.recordFeedback(captureId, "helpful", "auto: confirmed by agent", opts.agentId ?? detectAgentId());
   } catch (err) {
     return { content: [{ type: "text", text: `Error: ${err}` }], isError: true };
   }
@@ -10378,7 +11497,7 @@ async function handleConfirm(args, opts) {
     content: [
       {
         type: "text",
-        text: `Confirmed capture ${captureId}. Confidence: ${confidence.toFixed(2)} (${row.confirmations + 1} confirmations, ${row.corrections} corrections).`
+        text: `Confirmed capture ${captureId}. Confidence: ${confidence.toFixed(2)} (${row.confirmations + 1} confirmations, ${row.corrections} corrections). Feedback salience boosted.`
       }
     ]
   };
@@ -10407,6 +11526,7 @@ async function handleCorrect(args, opts) {
     if (reason) {
       db.prepare("UPDATE captures SET rejection_reason = ? WHERE id = ?").run(reason, captureId);
     }
+    opts.storage.recordFeedback(captureId, "wrong", reason ? `auto: ${reason}` : "auto: corrected by agent", opts.agentId ?? detectAgentId());
   } catch (err) {
     return { content: [{ type: "text", text: `Error: ${err}` }], isError: true };
   }
@@ -11071,6 +12191,12 @@ async function handleKnowledgeList(args, opts) {
 }
 async function handleKnowledgeDelete(args, opts) {
   const knowledgeIds = args.knowledge_ids;
+  if (!Array.isArray(knowledgeIds) || knowledgeIds.length === 0) {
+    return {
+      content: [{ type: "text", text: "Error: knowledge_ids (non-empty array) is required." }],
+      isError: true
+    };
+  }
   let count;
   try {
     count = await opts.storage.deleteKnowledge(knowledgeIds);
@@ -11096,10 +12222,16 @@ async function handleScenarioConsolidate(args, opts) {
     return { content: [{ type: "text", text: "Error: atom_ids is required." }], isError: true };
   }
   if (!summary || summary.trim().length < 10) {
-    return { content: [{ type: "text", text: "Error: summary must be at least 10 characters." }], isError: true };
+    return {
+      content: [{ type: "text", text: "Error: summary must be at least 10 characters." }],
+      isError: true
+    };
   }
   if (atomIds.length > 20) {
-    return { content: [{ type: "text", text: "Error: Maximum 20 atom_ids per consolidation." }], isError: true };
+    return {
+      content: [{ type: "text", text: "Error: Maximum 20 atom_ids per consolidation." }],
+      isError: true
+    };
   }
   const id = generateId();
   const scenario = {
@@ -11139,11 +12271,14 @@ async function handlePersonaUpdate(args, opts) {
   const { teamId, userId } = extractTenant(args);
   const agentId = args.agent_id ?? detectAgentId();
   if (!trait || !value) {
-    return { content: [{ type: "text", text: "Error: trait and value are required." }], isError: true };
+    return {
+      content: [{ type: "text", text: "Error: trait and value are required." }],
+      isError: true
+    };
   }
   const tid = teamId ?? "default";
   const uid = userId ?? "default";
-  let existing = await opts.storage.readPersona(tid, agentId, uid);
+  const existing = await opts.storage.readPersona(tid, agentId, uid);
   let content;
   if (existing) {
     const lines = existing.content.split("\n").filter((l) => l.trim());
@@ -11232,10 +12367,10 @@ async function handleCodegraphIndex(args, opts) {
     return { content: [{ type: "text", text: "Error: path is required." }], isError: true };
   }
   const db = getDb(opts);
-  const { statSync: statSync3 } = await import("fs");
+  const { statSync: statSync4 } = await import("fs");
   let stat;
   try {
-    stat = statSync3(path);
+    stat = statSync4(path);
   } catch {
     return { content: [{ type: "text", text: `Error: path not found: ${path}` }], isError: true };
   }
@@ -11283,41 +12418,80 @@ async function handleCodegraphSearch(args, opts) {
   let symbols = searchSymbols(db, query, { teamId, kind, language, limit, repoPath });
   if (symbols.length === 0) {
     const cwd = process.cwd();
-    const { existsSync: existsSync16 } = await import("fs");
+    const { existsSync: existsSync17 } = await import("fs");
     let indexPath;
     let repoRoot;
     if (customPath) {
       indexPath = customPath;
       repoRoot = customPath;
     } else {
-      indexPath = existsSync16(`${cwd}/src`) ? `${cwd}/src` : cwd;
+      indexPath = existsSync17(`${cwd}/src`) ? `${cwd}/src` : cwd;
       repoRoot = cwd;
     }
-    try {
-      const results = await indexDirectory(db, indexPath, repoRoot, teamId, 500);
-      const indexed = results.filter((r) => !r.skipped);
-      if (indexed.length > 0) {
-        symbols = searchSymbols(db, query, { teamId, kind, language, limit, repoPath: repoRoot });
-      }
+    const statusKey = `${repoRoot}:${teamId ?? "default"}`;
+    const status2 = indexingStatus.get(statusKey);
+    if (!status2 || status2.state === "error") {
+      indexingStatus.set(statusKey, {
+        state: "indexing",
+        startedAt: Date.now()
+      });
+      indexDirectory(db, indexPath, repoRoot, teamId, 1e4).then((results) => {
+        const indexed = results.filter((r) => !r.skipped);
+        const totalSymbols = indexed.reduce((s, r) => s + r.symbols, 0);
+        indexingStatus.set(statusKey, {
+          state: "done",
+          startedAt: status2?.startedAt ?? Date.now(),
+          finishedAt: Date.now(),
+          fileCount: indexed.length,
+          symbolCount: totalSymbols
+        });
+        console.error(
+          `[remem-mcp] background index complete: ${indexed.length} files, ${totalSymbols} symbols from ${indexPath}`
+        );
+      }).catch((err) => {
+        indexingStatus.set(statusKey, {
+          state: "error",
+          startedAt: status2?.startedAt ?? Date.now(),
+          finishedAt: Date.now(),
+          error: String(err)
+        });
+        console.error(`[remem-mcp] background index failed: ${err}`);
+      });
+      return {
+        content: [
+          {
+            type: "text",
+            text: `No symbols found yet. Background indexing started for ${indexPath}.
+Retry codegraph_search in ~10-30s (large repos may take longer).
+You can continue working \u2014 indexing runs in the background.`
+          }
+        ]
+      };
+    } else if (status2.state === "indexing") {
+      const elapsed = Math.round((Date.now() - status2.startedAt) / 1e3);
+      return {
+        content: [
+          {
+            type: "text",
+            text: `No symbols found yet. Indexing in progress (${elapsed}s elapsed).
+Retry codegraph_search in a few seconds.
+Meanwhile, use grep/glob for immediate code navigation.`
+          }
+        ]
+      };
+    } else if (status2.state === "done") {
+      symbols = searchSymbols(db, query, { teamId, kind, language, limit, repoPath: repoRoot });
       if (symbols.length === 0) {
         return {
           content: [
             {
               type: "text",
-              text: `No symbols found. Auto-indexed ${indexed.length} files from ${indexPath} \u2014 try a different search term, or call codegraph_index with a specific path.`
+              text: `No symbols found for "${query}". Indexing completed: ${status2.fileCount} files, ${status2.symbolCount} symbols.
+Try a different search term, or call codegraph_index with a specific path.`
             }
           ]
         };
       }
-    } catch {
-      return {
-        content: [
-          {
-            type: "text",
-            text: "No symbols found. Call codegraph_index with a path to index your codebase first."
-          }
-        ]
-      };
     }
   }
   const lines = symbols.map(
@@ -11425,7 +12599,6 @@ function handleCodegraphDetectChanges(args, opts) {
   const db = getDb(opts);
   let changedFiles;
   try {
-    const { execSync: execSync3 } = __require("child_process");
     const output2 = execSync3("git diff --name-only HEAD", {
       cwd: repoPath,
       encoding: "utf-8",
@@ -11488,9 +12661,15 @@ function handleCodegraphDetectChanges(args, opts) {
     } catch {
     }
   }
-  const lines = [`Changed files: ${changedFiles.length}`, `Affected symbols: ${changedSymbols.length}`, ""];
+  const lines = [
+    `Changed files: ${changedFiles.length}`,
+    `Affected symbols: ${changedSymbols.length}`,
+    ""
+  ];
   for (const r of results) {
-    lines.push(`[${r.risk.toUpperCase()}] ${r.symbol.kind} ${r.symbol.name} (${r.symbol.file}:${r.symbol.line})`);
+    lines.push(
+      `[${r.risk.toUpperCase()}] ${r.symbol.kind} ${r.symbol.name} (${r.symbol.file}:${r.symbol.line})`
+    );
     if (r.callers.length > 0) {
       lines.push(`  Callers (${r.callers.length} shown):`);
       for (const c of r.callers) {
@@ -11504,6 +12683,49 @@ function handleCodegraphDetectChanges(args, opts) {
     content: [{ type: "text", text: lines.join("\n") }]
   };
 }
+function handleCodegraphStats(args, opts) {
+  const repoPath = args.repo_path ?? void 0;
+  const teamId = args.team_id ?? void 0;
+  const db = getDb(opts);
+  const repoClause = repoPath ? "AND repo_path IS ?" : "";
+  const repoParams = repoPath ? [repoPath] : [];
+  const teamClause = teamId !== void 0 ? "AND team_id IS ?" : "";
+  const teamParams = teamId !== void 0 ? [teamId] : [];
+  const filter = `${repoClause} ${teamClause}`.trim();
+  const symbolCount = db.prepare(`SELECT COUNT(*) as c FROM symbols WHERE 1=1 ${filter}`).get(...repoParams, ...teamParams);
+  const callCount = db.prepare(
+    `SELECT COUNT(*) as c FROM calls AS c
+       JOIN symbols AS caller ON caller.id = c.caller_id
+       WHERE 1=1 ${filter}`
+  ).get(...repoParams, ...teamParams);
+  const resolvedCount = db.prepare(
+    `SELECT COUNT(*) as c FROM calls AS c
+       JOIN symbols AS caller ON caller.id = c.caller_id
+       WHERE c.callee_id IS NOT NULL ${filter}`
+  ).get(...repoParams, ...teamParams);
+  const importCount = db.prepare(`SELECT COUNT(*) as c FROM imports WHERE 1=1 ${filter}`).get(...repoParams, ...teamParams);
+  const fileCount = db.prepare(`SELECT COUNT(DISTINCT file_path) as c FROM symbols WHERE 1=1 ${filter}`).get(...repoParams, ...teamParams);
+  const byKind = db.prepare(
+    `SELECT kind, COUNT(*) as c FROM symbols WHERE 1=1 ${filter} GROUP BY kind ORDER BY c DESC`
+  ).all(...repoParams, ...teamParams);
+  const lines = [
+    `CodeGraph Statistics${repoPath ? ` (repo: ${repoPath})` : ""}`,
+    `  files:    ${fileCount.c}`,
+    `  symbols:  ${symbolCount.c}`,
+    `  calls:    ${callCount.c} (${resolvedCount.c} resolved, ${callCount.c - resolvedCount.c} unresolved)`,
+    `  imports:  ${importCount.c}`,
+    ""
+  ];
+  if (byKind.length > 0) {
+    lines.push("By kind:");
+    for (const k of byKind) {
+      lines.push(`  ${k.kind.padEnd(12)} ${k.c}`);
+    }
+  }
+  return {
+    content: [{ type: "text", text: lines.join("\n") }]
+  };
+}
 async function handleWikiIngest(args, opts) {
   const path = args.path;
   const repoPath = args.repo_path ?? path;
@@ -11513,10 +12735,10 @@ async function handleWikiIngest(args, opts) {
     return { content: [{ type: "text", text: "Error: path is required." }], isError: true };
   }
   const db = getDb(opts);
-  const { statSync: statSync3 } = await import("fs");
+  const { statSync: statSync4 } = await import("fs");
   let stat;
   try {
-    stat = statSync3(path);
+    stat = statSync4(path);
   } catch {
     return { content: [{ type: "text", text: `Error: path not found: ${path}` }], isError: true };
   }
@@ -11612,6 +12834,158 @@ ${lines.join("\n")}` }
     ]
   };
 }
+async function handleCanvasGet(args, opts) {
+  const sessionKey = args.session_key ?? defaultSessionKey();
+  const format = args.format ?? "mermaid";
+  try {
+    const mermaidText = await opts.storage.getCanvasMermaidText(sessionKey);
+    if (!mermaidText) {
+      return {
+        content: [
+          {
+            type: "text",
+            text: "No canvas found for this session. Enable REMEM_OFFLOAD_ENABLED=true and pipeline=mermaid to start building a task canvas."
+          }
+        ]
+      };
+    }
+    if (format === "json") {
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify(
+              {
+                sessionKey,
+                mermaid: mermaidText,
+                tokenEstimate: Math.ceil(mermaidText.length / 4)
+              },
+              null,
+              2
+            )
+          }
+        ]
+      };
+    }
+    return {
+      content: [
+        {
+          type: "text",
+          text: `## Task Canvas (Mermaid)
+
+\`\`\`mermaid
+${mermaidText}
+\`\`\`
+
+Drill down: call ref_read(node_id) to get the raw output for any node.`
+        }
+      ]
+    };
+  } catch (err) {
+    return {
+      content: [{ type: "text", text: `Error reading canvas: ${err}` }]
+    };
+  }
+}
+async function handleRefRead(args, opts) {
+  const nodeId = args.node_id;
+  if (!nodeId) {
+    return {
+      content: [{ type: "text", text: "Error: node_id is required." }]
+    };
+  }
+  try {
+    const content = await opts.storage.readRef(nodeId);
+    if (!content) {
+      return {
+        content: [
+          {
+            type: "text",
+            text: `No ref found for node_id "${nodeId}". The ref file may have been cleaned up (REMEM_REFS_RETENTION_HOURS) or offloading is not enabled.`
+          }
+        ]
+      };
+    }
+    return {
+      content: [{ type: "text", text: content }]
+    };
+  } catch (err) {
+    return {
+      content: [{ type: "text", text: `Error reading ref: ${err}` }]
+    };
+  }
+}
+async function handleSkillCreate(args, opts) {
+  const name = args.name;
+  const content = args.content;
+  if (!name || !content) {
+    return {
+      content: [{ type: "text", text: "Error: name and content are required." }]
+    };
+  }
+  const tenant = extractTenant(args);
+  const teamId = tenant.teamId ?? "default";
+  const agentId = tenant.agentId ?? "default";
+  const existing = await opts.storage.searchSkills(teamId, agentId, name, 1);
+  let version = 1;
+  let skillId = generateId();
+  if (existing.length > 0 && existing[0].name === name) {
+    version = existing[0].version + 1;
+    skillId = existing[0].id;
+  }
+  const now = Date.now();
+  await opts.storage.putSkill({
+    id: skillId,
+    teamId,
+    agentId,
+    name,
+    description: args.description,
+    content,
+    version,
+    createdAt: existing.length > 0 ? existing[0].createdAt : now,
+    updatedAt: now,
+    triggerConditions: args.trigger_conditions,
+    steps: args.steps,
+    validationRules: args.validation_rules,
+    sourceCaptureIds: args.source_capture_ids,
+    archived: false
+  });
+  return {
+    content: [
+      {
+        type: "text",
+        text: `Skill "${name}" created (v${version}, id: ${skillId}). It will be injected into recall when trigger conditions match.`
+      }
+    ]
+  };
+}
+async function handleSkillArchive(args, opts) {
+  const id = args.id;
+  if (!id) {
+    return {
+      content: [{ type: "text", text: "Error: id is required." }]
+    };
+  }
+  const skill = await opts.storage.getSkill(id);
+  if (!skill) {
+    return {
+      content: [{ type: "text", text: `Error: Skill "${id}" not found.` }]
+    };
+  }
+  await opts.storage.putSkill({
+    ...skill,
+    archived: true,
+    updatedAt: Date.now()
+  });
+  return {
+    content: [
+      {
+        type: "text",
+        text: `Skill "${skill.name}" archived. It will now always be injected into recall.`
+      }
+    ]
+  };
+}
 
 // src/stats.ts
 init_esm_shims();
@@ -11743,9 +13117,9 @@ Knowledge assets: ${knowledgeCount.count}`);
 
 // src/token-stats.ts
 init_esm_shims();
-import { existsSync as existsSync13, readFileSync as readFileSync10 } from "fs";
-import { homedir as homedir10 } from "os";
-import { join as join13 } from "path";
+import { existsSync as existsSync14, readFileSync as readFileSync11 } from "fs";
+import { homedir as homedir11 } from "os";
+import { join as join14 } from "path";
 import Database11 from "better-sqlite3";
 import { encode } from "gpt-tokenizer";
 function countTokens(text) {
@@ -11753,7 +13127,7 @@ function countTokens(text) {
   return encode(text).length;
 }
 function tokenStats(dbPath) {
-  const logPath = process.env.REMEM_HOOK_LOG_PATH ?? join13(homedir10(), ".local", "share", "remem-mcp", "session.log");
+  const logPath = process.env.REMEM_HOOK_LOG_PATH ?? join14(homedir11(), ".local", "share", "remem-mcp", "session.log");
   const db = new Database11(dbPath, { readonly: true });
   const totalCaptures = db.prepare("SELECT COUNT(*) as count FROM captures").get();
   const captures = db.prepare("SELECT id, type, content, tags, created_at FROM captures ORDER BY created_at ASC").all();
@@ -11768,8 +13142,8 @@ function tokenStats(dbPath) {
   let _noMemoryCount = 0;
   let captureCount = 0;
   const recallBlocks = [];
-  if (existsSync13(logPath)) {
-    const log = readFileSync10(logPath, "utf-8");
+  if (existsSync14(logPath)) {
+    const log = readFileSync11(logPath, "utf-8");
     const lines = log.split("\n");
     let inBlock = false;
     let blockText = [];
@@ -11905,10 +13279,10 @@ function printReactExample(fmt, _countTok) {
 // src/viewer.ts
 init_esm_shims();
 init_engine();
-import { existsSync as existsSync14, readFileSync as readFileSync11 } from "fs";
+import { existsSync as existsSync15, readFileSync as readFileSync12 } from "fs";
 import { createServer as createHttpServer } from "http";
-import { homedir as homedir11 } from "os";
-import { join as join14 } from "path";
+import { homedir as homedir12 } from "os";
+import { join as join15 } from "path";
 import Database12 from "better-sqlite3";
 function startViewer(dbPath, port) {
   const db = new Database12(dbPath);
@@ -12184,7 +13558,7 @@ function startViewer(dbPath, port) {
     }
     if (url.pathname === "/api/token-stats") {
       try {
-        const logPath = process.env.REMEM_HOOK_LOG_PATH ?? join14(homedir11(), ".local", "share", "remem-mcp", "session.log");
+        const logPath = process.env.REMEM_HOOK_LOG_PATH ?? join15(homedir12(), ".local", "share", "remem-mcp", "session.log");
         const captures = db.prepare("SELECT content FROM captures ORDER BY created_at ASC").all();
         const sessions = db.prepare("SELECT COUNT(DISTINCT session_key) as count FROM captures").get();
         const totalStored = captures.reduce(
@@ -12194,8 +13568,8 @@ function startViewer(dbPath, port) {
         let recallCount = 0;
         let totalInjected = 0;
         let captureCount = 0;
-        if (existsSync14(logPath)) {
-          const log = readFileSync11(logPath, "utf-8");
+        if (existsSync15(logPath)) {
+          const log = readFileSync12(logPath, "utf-8");
           const lines = log.split("\n");
           let inBlock = false;
           let blockChars = 0;
@@ -13629,7 +15003,7 @@ function renderPage() {
 
 // src/index.ts
 function defaultDbPath3() {
-  return process.env.REMEM_DB_PATH ?? join15(homedir12(), ".local", "share", "remem-mcp", "memory.db");
+  return process.env.REMEM_DB_PATH ?? join16(homedir13(), ".local", "share", "remem-mcp", "memory.db");
 }
 function openDbWithSchema(dbPath) {
   const db = new Database13(dbPath);
@@ -13640,13 +15014,13 @@ function openDbWithSchema(dbPath) {
   if (!hasSymbols) {
     const distDir = dirname10(fileURLToPath4(import.meta.url));
     const candidates = [
-      join15(distDir, "storage", "schema.sql"),
-      join15(distDir, "schema.sql"),
-      join15(process.cwd(), "src", "storage", "schema.sql")
+      join16(distDir, "storage", "schema.sql"),
+      join16(distDir, "schema.sql"),
+      join16(process.cwd(), "src", "storage", "schema.sql")
     ];
     for (const p of candidates) {
       try {
-        db.exec(readFileSync12(p, "utf-8"));
+        db.exec(readFileSync13(p, "utf-8"));
         break;
       } catch {
       }
@@ -13671,25 +15045,25 @@ function parseFlags(argv) {
 }
 function detectPackageManager() {
   const cwd = process.cwd();
-  if (existsSync15(join15(cwd, "pnpm-lock.yaml"))) return "pnpm";
-  if (existsSync15(join15(cwd, "bun.lockb")) || existsSync15(join15(cwd, "bun.lock"))) return "bun";
-  if (existsSync15(join15(cwd, "yarn.lock"))) return "yarn";
-  if (existsSync15(join15(cwd, "package-lock.json"))) return "npm";
-  if (existsSync15(join15(cwd, "Cargo.toml"))) return "cargo";
-  if (existsSync15(join15(cwd, "go.mod"))) return "go";
-  if (existsSync15(join15(cwd, "pom.xml")) || existsSync15(join15(cwd, "build.gradle"))) return "maven";
-  if (existsSync15(join15(cwd, "build.gradle.kts"))) return "gradle";
-  if (existsSync15(join15(cwd, "Gemfile"))) return "bundle";
-  if (existsSync15(join15(cwd, "requirements.txt")) || existsSync15(join15(cwd, "pyproject.toml")))
+  if (existsSync16(join16(cwd, "pnpm-lock.yaml"))) return "pnpm";
+  if (existsSync16(join16(cwd, "bun.lockb")) || existsSync16(join16(cwd, "bun.lock"))) return "bun";
+  if (existsSync16(join16(cwd, "yarn.lock"))) return "yarn";
+  if (existsSync16(join16(cwd, "package-lock.json"))) return "npm";
+  if (existsSync16(join16(cwd, "Cargo.toml"))) return "cargo";
+  if (existsSync16(join16(cwd, "go.mod"))) return "go";
+  if (existsSync16(join16(cwd, "pom.xml")) || existsSync16(join16(cwd, "build.gradle"))) return "maven";
+  if (existsSync16(join16(cwd, "build.gradle.kts"))) return "gradle";
+  if (existsSync16(join16(cwd, "Gemfile"))) return "bundle";
+  if (existsSync16(join16(cwd, "requirements.txt")) || existsSync16(join16(cwd, "pyproject.toml")))
     return "pip";
   return null;
 }
 function detectPackageScripts() {
   const cwd = process.cwd();
-  const pkgPath = join15(cwd, "package.json");
-  if (!existsSync15(pkgPath)) return {};
+  const pkgPath = join16(cwd, "package.json");
+  if (!existsSync16(pkgPath)) return {};
   try {
-    const pkg = JSON.parse(readFileSync12(pkgPath, "utf-8"));
+    const pkg = JSON.parse(readFileSync13(pkgPath, "utf-8"));
     const scripts = pkg.scripts ?? {};
     const important = {};
     for (const key of ["build", "test", "lint", "format", "dev", "start", "typecheck", "check"]) {
@@ -13702,14 +15076,14 @@ function detectPackageScripts() {
 }
 function detectFramework() {
   const cwd = process.cwd();
-  const pkgPath = join15(cwd, "package.json");
-  if (!existsSync15(pkgPath)) {
+  const pkgPath = join16(cwd, "package.json");
+  if (!existsSync16(pkgPath)) {
     const fw = detectNonJsFramework(cwd);
     if (fw) return fw;
     return null;
   }
   try {
-    const pkg = JSON.parse(readFileSync12(pkgPath, "utf-8"));
+    const pkg = JSON.parse(readFileSync13(pkgPath, "utf-8"));
     const deps = { ...pkg.dependencies ?? {}, ...pkg.devDependencies ?? {} };
     if (deps.next) return "Next.js";
     if (deps["react-scripts"]) return "Create React App";
@@ -13731,10 +15105,10 @@ function detectFramework() {
   }
 }
 function detectNonJsFramework(cwd) {
-  const pyPath = join15(cwd, "pyproject.toml");
-  if (existsSync15(pyPath)) {
+  const pyPath = join16(cwd, "pyproject.toml");
+  if (existsSync16(pyPath)) {
     try {
-      const content = readFileSync12(pyPath, "utf-8");
+      const content = readFileSync13(pyPath, "utf-8");
       if (/\bdjango\b/i.test(content)) return "Django";
       if (/\bfastapi\b/i.test(content)) return "FastAPI";
       if (/\bflask\b/i.test(content)) return "Flask";
@@ -13750,20 +15124,20 @@ function detectNonJsFramework(cwd) {
     } catch {
     }
   }
-  if (existsSync15(join15(cwd, "requirements.txt"))) {
+  if (existsSync16(join16(cwd, "requirements.txt"))) {
     try {
-      const content = readFileSync12(join15(cwd, "requirements.txt"), "utf-8");
+      const content = readFileSync13(join16(cwd, "requirements.txt"), "utf-8");
       if (/^\s*django\b/im.test(content)) return "Django";
       if (/^\s*fastapi\b/im.test(content)) return "FastAPI";
       if (/^\s*flask\b/im.test(content)) return "Flask";
     } catch {
     }
   }
-  if (existsSync15(join15(cwd, "manage.py")) && existsSync15(join15(cwd, "wsgi.py"))) return "Django";
-  const cargoPath = join15(cwd, "Cargo.toml");
-  if (existsSync15(cargoPath)) {
+  if (existsSync16(join16(cwd, "manage.py")) && existsSync16(join16(cwd, "wsgi.py"))) return "Django";
+  const cargoPath = join16(cwd, "Cargo.toml");
+  if (existsSync16(cargoPath)) {
     try {
-      const content = readFileSync12(cargoPath, "utf-8");
+      const content = readFileSync13(cargoPath, "utf-8");
       if (/\baxum\b/i.test(content)) return "Axum";
       if (/\bactix-web\b/i.test(content)) return "Actix Web";
       if (/\bwarp\b/i.test(content)) return "Warp";
@@ -13778,10 +15152,10 @@ function detectNonJsFramework(cwd) {
     } catch {
     }
   }
-  const goModPath = join15(cwd, "go.mod");
-  if (existsSync15(goModPath)) {
+  const goModPath = join16(cwd, "go.mod");
+  if (existsSync16(goModPath)) {
     try {
-      const content = readFileSync12(goModPath, "utf-8");
+      const content = readFileSync13(goModPath, "utf-8");
       if (/\bgin-gin\b/i.test(content)) return "Gin";
       if (/\becho\b/i.test(content)) return "Echo";
       if (/\bfiber\b/i.test(content)) return "Fiber";
@@ -13792,10 +15166,10 @@ function detectNonJsFramework(cwd) {
     } catch {
     }
   }
-  const gemfilePath = join15(cwd, "Gemfile");
-  if (existsSync15(gemfilePath)) {
+  const gemfilePath = join16(cwd, "Gemfile");
+  if (existsSync16(gemfilePath)) {
     try {
-      const content = readFileSync12(gemfilePath, "utf-8");
+      const content = readFileSync13(gemfilePath, "utf-8");
       if (/\brails\b/i.test(content)) return "Rails";
       if (/\bsinatra\b/i.test(content)) return "Sinatra";
       if (/\bhanami\b/i.test(content)) return "Hanami";
@@ -13805,9 +15179,9 @@ function detectNonJsFramework(cwd) {
     } catch {
     }
   }
-  if (existsSync15(join15(cwd, "pom.xml"))) {
+  if (existsSync16(join16(cwd, "pom.xml"))) {
     try {
-      const content = readFileSync12(join15(cwd, "pom.xml"), "utf-8");
+      const content = readFileSync13(join16(cwd, "pom.xml"), "utf-8");
       if (/\bspring-boot\b/i.test(content)) return "Spring Boot";
       if (/\bspring-webflux\b/i.test(content)) return "Spring WebFlux";
       if (/\bquarkus\b/i.test(content)) return "Quarkus";
@@ -13820,10 +15194,10 @@ function detectNonJsFramework(cwd) {
     } catch {
     }
   }
-  if (existsSync15(join15(cwd, "build.gradle")) || existsSync15(join15(cwd, "build.gradle.kts"))) {
+  if (existsSync16(join16(cwd, "build.gradle")) || existsSync16(join16(cwd, "build.gradle.kts"))) {
     try {
-      const content = readFileSync12(
-        existsSync15(join15(cwd, "build.gradle.kts")) ? join15(cwd, "build.gradle.kts") : join15(cwd, "build.gradle"),
+      const content = readFileSync13(
+        existsSync16(join16(cwd, "build.gradle.kts")) ? join16(cwd, "build.gradle.kts") : join16(cwd, "build.gradle"),
         "utf-8"
       );
       if (/\bspring-boot\b/i.test(content)) return "Spring Boot";
@@ -13834,9 +15208,9 @@ function detectNonJsFramework(cwd) {
     }
   }
   try {
-    const dotnetFiles = readdirSync(cwd).filter((f) => f.endsWith(".csproj") || f.endsWith(".sln"));
+    const dotnetFiles = readdirSync2(cwd).filter((f) => f.endsWith(".csproj") || f.endsWith(".sln"));
     if (dotnetFiles.length > 0) {
-      const content = readFileSync12(join15(cwd, dotnetFiles[0]), "utf-8");
+      const content = readFileSync13(join16(cwd, dotnetFiles[0]), "utf-8");
       if (/\bMicrosoft\.NET\.Sdk\.Web\b/i.test(content)) return "ASP.NET Core";
       if (/\bMicrosoft\.NET\.Sdk\b/i.test(content)) return ".NET";
       return ".NET";
@@ -13847,10 +15221,10 @@ function detectNonJsFramework(cwd) {
 }
 function detectLintTool() {
   const cwd = process.cwd();
-  const pkgPath = join15(cwd, "package.json");
-  if (existsSync15(pkgPath)) {
+  const pkgPath = join16(cwd, "package.json");
+  if (existsSync16(pkgPath)) {
     try {
-      const pkg = JSON.parse(readFileSync12(pkgPath, "utf-8"));
+      const pkg = JSON.parse(readFileSync13(pkgPath, "utf-8"));
       const deps = { ...pkg.dependencies ?? {}, ...pkg.devDependencies ?? {} };
       if (deps.biome) return "Biome";
       if (deps.eslint) return "ESLint";
@@ -13860,23 +15234,23 @@ function detectLintTool() {
     } catch {
     }
   }
-  if (existsSync15(join15(cwd, "biome.json")) || existsSync15(join15(cwd, "biome.jsonc"))) return "Biome";
-  if (existsSync15(join15(cwd, ".eslintrc")) || existsSync15(join15(cwd, ".eslintrc.js")) || existsSync15(join15(cwd, ".eslintrc.json")) || existsSync15(join15(cwd, "eslint.config.js")) || existsSync15(join15(cwd, "eslint.config.mjs")))
+  if (existsSync16(join16(cwd, "biome.json")) || existsSync16(join16(cwd, "biome.jsonc"))) return "Biome";
+  if (existsSync16(join16(cwd, ".eslintrc")) || existsSync16(join16(cwd, ".eslintrc.js")) || existsSync16(join16(cwd, ".eslintrc.json")) || existsSync16(join16(cwd, "eslint.config.js")) || existsSync16(join16(cwd, "eslint.config.mjs")))
     return "ESLint";
-  if (existsSync15(join15(cwd, ".prettierrc")) || existsSync15(join15(cwd, ".prettierrc.json")))
+  if (existsSync16(join16(cwd, ".prettierrc")) || existsSync16(join16(cwd, ".prettierrc.json")))
     return "Prettier";
-  if (existsSync15(join15(cwd, "rustfmt.toml"))) return "rustfmt";
-  if (existsSync15(join15(cwd, ".rustfmt.toml"))) return "rustfmt";
-  if (existsSync15(join15(cwd, ".gofmt"))) return "gofmt";
-  if (existsSync15(join15(cwd, ".golangci.yml")) || existsSync15(join15(cwd, ".golangci.yaml")))
+  if (existsSync16(join16(cwd, "rustfmt.toml"))) return "rustfmt";
+  if (existsSync16(join16(cwd, ".rustfmt.toml"))) return "rustfmt";
+  if (existsSync16(join16(cwd, ".gofmt"))) return "gofmt";
+  if (existsSync16(join16(cwd, ".golangci.yml")) || existsSync16(join16(cwd, ".golangci.yaml")))
     return "golangci-lint";
-  if (existsSync15(join15(cwd, ".ruff.toml")) || existsSync15(join15(cwd, "ruff.toml"))) return "Ruff";
-  if (existsSync15(join15(cwd, ".flake8")) || existsSync15(join15(cwd, "setup.cfg")) || existsSync15(join15(cwd, "tox.ini")))
+  if (existsSync16(join16(cwd, ".ruff.toml")) || existsSync16(join16(cwd, "ruff.toml"))) return "Ruff";
+  if (existsSync16(join16(cwd, ".flake8")) || existsSync16(join16(cwd, "setup.cfg")) || existsSync16(join16(cwd, "tox.ini")))
     return "Flake8";
-  if (existsSync15(join15(cwd, ".pylintrc")) || existsSync15(join15(cwd, "pyproject.toml"))) {
+  if (existsSync16(join16(cwd, ".pylintrc")) || existsSync16(join16(cwd, "pyproject.toml"))) {
     try {
-      if (existsSync15(join15(cwd, "pyproject.toml"))) {
-        const content = readFileSync12(join15(cwd, "pyproject.toml"), "utf-8");
+      if (existsSync16(join16(cwd, "pyproject.toml"))) {
+        const content = readFileSync13(join16(cwd, "pyproject.toml"), "utf-8");
         if (/\bruff\b/i.test(content)) return "Ruff";
         if (/\bblack\b/i.test(content)) return "Black";
         if (/\bflake8\b/i.test(content)) return "Flake8";
@@ -13886,15 +15260,15 @@ function detectLintTool() {
     } catch {
     }
   }
-  if (existsSync15(join15(cwd, ".black")) || existsSync15(join15(cwd, "black-config.toml"))) return "Black";
-  if (existsSync15(join15(cwd, ".rubocop.yml")) || existsSync15(join15(cwd, ".rubocop.yaml")))
+  if (existsSync16(join16(cwd, ".black")) || existsSync16(join16(cwd, "black-config.toml"))) return "Black";
+  if (existsSync16(join16(cwd, ".rubocop.yml")) || existsSync16(join16(cwd, ".rubocop.yaml")))
     return "RuboCop";
-  if (existsSync15(join15(cwd, ".standard.yml")) || existsSync15(join15(cwd, ".standard.yaml")))
+  if (existsSync16(join16(cwd, ".standard.yml")) || existsSync16(join16(cwd, ".standard.yaml")))
     return "Standard";
-  if (existsSync15(join15(cwd, ".checkstyle"))) return "Checkstyle";
-  if (existsSync15(join15(cwd, "spotbugs-exclude.xml"))) return "SpotBugs";
+  if (existsSync16(join16(cwd, ".checkstyle"))) return "Checkstyle";
+  if (existsSync16(join16(cwd, "spotbugs-exclude.xml"))) return "SpotBugs";
   try {
-    const dotnetFiles = readdirSync(cwd).filter((f) => f.endsWith(".editorconfig"));
+    const dotnetFiles = readdirSync2(cwd).filter((f) => f.endsWith(".editorconfig"));
     if (dotnetFiles.length > 0) return "EditorConfig";
   } catch {
   }
@@ -13903,10 +15277,10 @@ function detectLintTool() {
 function detectTestCommand(pkgManager) {
   const cwd = process.cwd();
   const pm = pkgManager ?? "npm";
-  const pkgPath = join15(cwd, "package.json");
-  if (existsSync15(pkgPath)) {
+  const pkgPath = join16(cwd, "package.json");
+  if (existsSync16(pkgPath)) {
     try {
-      const pkg = JSON.parse(readFileSync12(pkgPath, "utf-8"));
+      const pkg = JSON.parse(readFileSync13(pkgPath, "utf-8"));
       const scripts = pkg.scripts ?? {};
       if (scripts.test && scripts.test !== 'echo "Error: no test specified" && exit 1') {
         return `${pm} run test`;
@@ -13919,32 +15293,32 @@ function detectTestCommand(pkgManager) {
     } catch {
     }
   }
-  if (existsSync15(join15(cwd, "Cargo.toml"))) return "cargo test";
-  if (existsSync15(join15(cwd, "go.mod"))) return "go test ./...";
-  if (existsSync15(join15(cwd, "pytest.ini")) || existsSync15(join15(cwd, "conftest.py"))) return "pytest";
-  if (existsSync15(join15(cwd, "pyproject.toml"))) {
+  if (existsSync16(join16(cwd, "Cargo.toml"))) return "cargo test";
+  if (existsSync16(join16(cwd, "go.mod"))) return "go test ./...";
+  if (existsSync16(join16(cwd, "pytest.ini")) || existsSync16(join16(cwd, "conftest.py"))) return "pytest";
+  if (existsSync16(join16(cwd, "pyproject.toml"))) {
     try {
-      const content = readFileSync12(join15(cwd, "pyproject.toml"), "utf-8");
+      const content = readFileSync13(join16(cwd, "pyproject.toml"), "utf-8");
       if (/\bpytest\b/i.test(content)) return "pytest";
       if (/\bunittest\b/i.test(content)) return "python -m unittest";
     } catch {
     }
   }
-  if (existsSync15(join15(cwd, "tox.ini"))) return "tox";
-  if (existsSync15(join15(cwd, "Gemfile"))) {
+  if (existsSync16(join16(cwd, "tox.ini"))) return "tox";
+  if (existsSync16(join16(cwd, "Gemfile"))) {
     try {
-      const content = readFileSync12(join15(cwd, "Gemfile"), "utf-8");
+      const content = readFileSync13(join16(cwd, "Gemfile"), "utf-8");
       if (/\brspec\b/i.test(content)) return "bundle exec rspec";
       if (/\bminitest\b/i.test(content)) return "bundle exec rake test";
     } catch {
     }
     return "bundle exec rspec";
   }
-  if (existsSync15(join15(cwd, "pom.xml"))) return "mvn test";
-  if (existsSync15(join15(cwd, "build.gradle")) || existsSync15(join15(cwd, "build.gradle.kts")))
+  if (existsSync16(join16(cwd, "pom.xml"))) return "mvn test";
+  if (existsSync16(join16(cwd, "build.gradle")) || existsSync16(join16(cwd, "build.gradle.kts")))
     return "gradle test";
   try {
-    const dotnetFiles = readdirSync(cwd).filter(
+    const dotnetFiles = readdirSync2(cwd).filter(
       (f) => f.endsWith(".csproj") || f.endsWith(".fsproj")
     );
     if (dotnetFiles.length > 0) return "dotnet test";
@@ -13959,6 +15333,10 @@ async function main() {
     return;
   }
   if (arg === "init") {
+    try {
+      new SQLiteBackend(defaultDbPath3());
+    } catch {
+    }
     console.log(`remem-mcp init
 
 This command tells your agent to activate long-term memory for this session.
@@ -14051,7 +15429,7 @@ After that, the agent follows the rules automatically.`);
     if (captured > 0) {
       console.log(`  Captured ${captured} project basics.`);
     } else {
-      const hasProjectFiles = existsSync15(join15(process.cwd(), "package.json")) || existsSync15(join15(process.cwd(), "Cargo.toml")) || existsSync15(join15(process.cwd(), "go.mod")) || existsSync15(join15(process.cwd(), "pyproject.toml"));
+      const hasProjectFiles = existsSync16(join16(process.cwd(), "package.json")) || existsSync16(join16(process.cwd(), "Cargo.toml")) || existsSync16(join16(process.cwd(), "go.mod")) || existsSync16(join16(process.cwd(), "pyproject.toml"));
       if (hasProjectFiles) {
         console.log("  Project basics already captured (no changes since last setup).");
       } else {
@@ -14086,7 +15464,13 @@ After that, the agent follows the rules automatically.`);
   }
   if (arg === "recent" || arg === "list") {
     const limit = parseInt(process.argv[3] ?? "20", 10);
-    const db = new Database13(defaultDbPath3(), { readonly: true });
+    let db;
+    try {
+      db = new Database13(defaultDbPath3(), { readonly: true });
+    } catch {
+      console.log("No captures found.");
+      return;
+    }
     const rows = db.prepare(
       `SELECT id, type, content, tags, created_at FROM captures WHERE deleted_at IS NULL ORDER BY created_at DESC LIMIT ?`
     ).all(limit);
@@ -14176,7 +15560,7 @@ ${sorted.length} unique tag(s).`);
     ).get();
     const oldest = db.prepare("SELECT MIN(created_at) as ts FROM captures WHERE deleted_at IS NULL").get();
     const newest = db.prepare("SELECT MAX(created_at) as ts FROM captures WHERE deleted_at IS NULL").get();
-    const dbSize = statSync2(defaultDbPath3()).size;
+    const dbSize = statSync3(defaultDbPath3()).size;
     console.log("remem-mcp stats\n");
     console.log(`  Total captures: ${total}`);
     console.log(
@@ -14367,13 +15751,13 @@ ${sorted.length} unique tag(s).`);
     return;
   }
   if (arg === "viewer") {
-    const port = Number(process.argv[4] ?? process.env.REMEM_VIEWER_PORT ?? 7331);
+    const port = Number(process.argv[3] ?? process.env.REMEM_VIEWER_PORT ?? 7331);
     startViewer(defaultDbPath3(), port);
     return;
   }
   if (arg === "backup") {
     const dbPath = defaultDbPath3();
-    const auditPath = process.env.REMEM_AUDIT_LOG_PATH ?? join15(dirname10(dbPath), "audit.jsonl");
+    const auditPath = process.env.REMEM_AUDIT_LOG_PATH ?? join16(dirname10(dbPath), "audit.jsonl");
     const outputDir = process.argv[3] ?? "-";
     backup(dbPath, auditPath, outputDir);
     return;
@@ -14394,7 +15778,7 @@ ${sorted.length} unique tag(s).`);
     }
     return;
   }
-  if (arg === "hook-recall") {
+  if (arg === "hook-recall" || arg === "hook-session-start") {
     hookRecall(defaultDbPath3());
     return;
   }
@@ -14437,6 +15821,45 @@ ${sorted.length} unique tag(s).`);
     hookPostCompaction(defaultDbPath3());
     return;
   }
+  if (arg === "proxy") {
+    const { loadProxyConfig, startProxyServer } = await import("./server-5PWQTRGZ.js");
+    const proxyConfig = loadProxyConfig();
+    if (!proxyConfig.dbPath) {
+      proxyConfig.dbPath = defaultDbPath3();
+    }
+    await startProxyServer(proxyConfig);
+    return;
+  }
+  if (arg === "skill-extract") {
+    const dbPath = defaultDbPath3();
+    const db = new Database13(dbPath);
+    sqliteVec4.load(db);
+    const storage2 = new SQLiteBackend(dbPath);
+    const pipeline2 = new SkillExtractionPipeline();
+    const taskCaptures = db.prepare(
+      "SELECT id, content, type, tags, team_id, agent_id FROM captures WHERE type = 'task' AND deleted_at IS NULL"
+    ).all();
+    console.log(`Found ${taskCaptures.length} task capture(s) to extract skills from.`);
+    let extracted = 0;
+    for (const row of taskCaptures) {
+      const tags = row.tags ? JSON.parse(row.tags) : [];
+      const input = {
+        id: row.id,
+        content: row.content,
+        type: row.type,
+        tags,
+        sessionKey: "default",
+        teamId: row.team_id ?? "default",
+        agentId: row.agent_id ?? "default"
+      };
+      const ctx = { storage: storage2, embedder: new LocalEmbedder(), sessionKey: "default" };
+      const result = await pipeline2.process(input, ctx);
+      if (Object.keys(result).length > 0) extracted++;
+    }
+    console.log(`Extracted ${extracted} skill(s) from ${taskCaptures.length} task capture(s).`);
+    db.close();
+    return;
+  }
   if (arg === "index") {
     const flags = parseFlags(process.argv.slice(3));
     const path = flags.path ?? flags.p ?? process.cwd();
@@ -14673,8 +16096,8 @@ ${sorted.length} unique tag(s).`);
   }
   if (arg === "version" || arg === "--version" || arg === "-v") {
     try {
-      const pkgPath = join15(dirname10(fileURLToPath4(import.meta.url)), "..", "package.json");
-      const pkg = JSON.parse(readFileSync12(pkgPath, "utf-8"));
+      const pkgPath = join16(dirname10(fileURLToPath4(import.meta.url)), "..", "package.json");
+      const pkg = JSON.parse(readFileSync13(pkgPath, "utf-8"));
       console.log(`remem-mcp v${pkg.version}`);
     } catch {
       console.log("remem-mcp (version unknown)");
@@ -14845,6 +16268,17 @@ To install the skill (Devin CLI only):
     });
     pipeline = new AtomPipeline();
     pipeline._llmClient = llmClient;
+  } else if (config.pipeline === "mermaid" && config.llm) {
+    const llmClient = new OpenAILLMClient({
+      apiKey: config.llm.apiKey,
+      baseUrl: config.llm.baseUrl,
+      model: config.llm.model
+    });
+    pipeline = new LLMMermaidPipeline(llmClient);
+  } else if (config.pipeline === "mermaid") {
+    pipeline = new MermaidPipeline();
+  } else if (config.pipeline === "skill") {
+    pipeline = new SkillExtractionPipeline();
   } else {
     pipeline = new RuleBasedAtomPipeline();
   }
@@ -14902,8 +16336,8 @@ async function verifyMemory(dbPath, query) {
     storage.close();
     return;
   }
-  const { statSync: statSync3, readdirSync: readdirSync2 } = await import("fs");
-  const { join: join16, extname } = await import("path");
+  const { statSync: statSync4, readdirSync: readdirSync3 } = await import("fs");
+  const { join: join17, extname } = await import("path");
   const codeExts = [
     ".ts",
     ".tsx",
@@ -14925,16 +16359,16 @@ async function verifyMemory(dbPath, query) {
       if (depth > 2 || fileCount > 50) return;
       let entries;
       try {
-        entries = readdirSync2(dir);
+        entries = readdirSync3(dir);
       } catch {
         return;
       }
       for (const name of entries) {
         if (name.startsWith(".") || name === "node_modules" || name === "dist" || name === "build")
           continue;
-        const full = join16(dir, name);
+        const full = join17(dir, name);
         try {
-          const stat = statSync3(full);
+          const stat = statSync4(full);
           if (stat.isDirectory()) {
             scanDir(full, depth + 1);
           } else if (codeExts.includes(extname(name))) {