engramx 1.0.1 → 2.0.0

package/dist/cli.js

@@ -1,15 +1,24 @@
 #!/usr/bin/env node
+import {
+  ESTIMATED_TOKENS_PER_READ_DENY,
+  formatHudStatus,
+  formatStatsSummary,
+  getComponentStatus,
+  summarizeHookLog
+} from "./chunk-533LR4I7.js";
+import {
+  readConfig
+} from "./chunk-22INHMKB.js";
 import {
   logHookEvent,
-  readConfig,
   readHookLog
-} from "./chunk-CEAANHHX.js";
+} from "./chunk-KL6NSPVA.js";
 import {
   autogen,
   install,
   status,
   uninstall
-} from "./chunk-QOG4K427.js";
+} from "./chunk-C6GBUOAL.js";
 import {
   benchmark,
   computeKeywordIDF,
@@ -26,24 +35,24 @@ import {
   renderFileStructure,
   stats,
   toPosixPath
-} from "./chunk-6SFMVYUN.js";
-import "./chunk-SBHGK5WA.js";
+} from "./chunk-SJT7VS2G.js";
+import "./chunk-PEH54LYC.js";
 
 // src/cli.ts
 import { Command } from "commander";
 import chalk2 from "chalk";
 import {
-  existsSync as existsSync10,
-  readFileSync as readFileSync6,
-  writeFileSync as writeFileSync3,
+  existsSync as existsSync9,
+  readFileSync as readFileSync5,
+  writeFileSync as writeFileSync2,
   mkdirSync,
   unlinkSync,
   copyFileSync,
   renameSync as renameSync2
 } from "fs";
-import { dirname as dirname4, join as join10, resolve as pathResolve } from "path";
+import { dirname as dirname4, join as join9, resolve as pathResolve } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
-import { homedir as homedir2 } from "os";
+import { homedir } from "os";
 
 // src/intercept/safety.ts
 import { existsSync } from "fs";
@@ -408,8 +417,13 @@ function findGrammarWasm(lang) {
   const candidates = [];
   try {
     const here = dirname2(fileURLToPath(import.meta.url));
-    candidates.push(join3(here, "..", "..", "node_modules", pkg, wasmName));
     candidates.push(join3(here, "..", "grammars", wasmName));
+    candidates.push(join3(here, "grammars", wasmName));
+  } catch {
+  }
+  try {
+    const here = dirname2(fileURLToPath(import.meta.url));
+    candidates.push(join3(here, "..", "..", "node_modules", pkg, wasmName));
   } catch {
   }
   try {
@@ -1325,7 +1339,7 @@ var lspProvider = {
 };
 
 // src/providers/resolver.ts
-var ALL_PROVIDERS = [
+var BUILTIN_PROVIDERS = [
   astProvider,
   structureProvider,
   mistakesProvider,
@@ -1335,12 +1349,26 @@ var ALL_PROVIDERS = [
   obsidianProvider,
   lspProvider
 ];
+var BUILTIN_NAMES = new Set(BUILTIN_PROVIDERS.map((p) => p.name));
+async function getAllProviders() {
+  const { getLoadedPlugins } = await import("./plugin-loader-FCOMVOX7.js");
+  const { loaded } = await getLoadedPlugins();
+  const safePlugins = loaded.filter((p) => !BUILTIN_NAMES.has(p.name));
+  return [...BUILTIN_PROVIDERS, ...safePlugins];
+}
+var ALL_PROVIDERS = BUILTIN_PROVIDERS;
 function estimateTokens(text) {
   return Math.ceil(text.length / 4);
 }
 async function resolveRichPacket(filePath, context, enabledProviders) {
   const start = Date.now();
-  const providers = ALL_PROVIDERS.filter((p) => {
+  let allProviders;
+  try {
+    allProviders = await getAllProviders();
+  } catch {
+    allProviders = BUILTIN_PROVIDERS;
+  }
+  const providers = allProviders.filter((p) => {
     if (enabledProviders && !enabledProviders.includes(p.name)) return false;
     return true;
   });
@@ -1372,7 +1400,7 @@ async function resolveRichPacket(filePath, context, enabledProviders) {
     if (totalTokens + sectionTokens > budget) {
       break;
     }
-    const provider = ALL_PROVIDERS.find((p) => p.name === result.provider);
+    const provider = allProviders.find((p) => p.name === result.provider);
     const label = provider?.label ?? result.provider.toUpperCase();
     const cacheTag = result.cached ? ", cached" : "";
     sections.push(`${label} (${result.provider}${cacheTag}):
@@ -1406,7 +1434,7 @@ async function warmAllProviders(projectRoot, enabledProviders) {
       try {
         const result = await withTimeout2(p.warmup(projectRoot), 5e3);
         if (result && result.entries.length > 0) {
-          const { getStore: getStore2 } = await import("./core-77MHT3QV.js");
+          const { getStore: getStore2 } = await import("./core-6IY5L6II.js");
           const store = await getStore2(projectRoot);
           try {
             store.warmCache(
@@ -2314,98 +2342,6 @@ function watchProject(projectRoot, options = {}) {
 import chalk from "chalk";
 import { existsSync as existsSync7, statSync as statSync3 } from "fs";
 import { join as join7, resolve as resolve6, basename as basename4 } from "path";
-
-// src/intercept/stats.ts
-var ESTIMATED_TOKENS_PER_READ_DENY = 1200;
-function summarizeHookLog(entries) {
-  const byEvent = {};
-  const byTool = {};
-  const byDecision = {};
-  let readDenyCount = 0;
-  let firstEntryTs = null;
-  let lastEntryTs = null;
-  for (const entry of entries) {
-    const event = entry.event ?? "unknown";
-    byEvent[event] = (byEvent[event] ?? 0) + 1;
-    const tool = entry.tool ?? "unknown";
-    byTool[tool] = (byTool[tool] ?? 0) + 1;
-    if (entry.decision) {
-      byDecision[entry.decision] = (byDecision[entry.decision] ?? 0) + 1;
-    }
-    if (event === "PreToolUse" && tool === "Read" && entry.decision === "deny") {
-      readDenyCount += 1;
-    }
-    const ts = entry.ts;
-    if (typeof ts === "string") {
-      if (firstEntryTs === null || ts < firstEntryTs) firstEntryTs = ts;
-      if (lastEntryTs === null || ts > lastEntryTs) lastEntryTs = ts;
-    }
-  }
-  return {
-    totalInvocations: entries.length,
-    byEvent: Object.freeze(byEvent),
-    byTool: Object.freeze(byTool),
-    byDecision: Object.freeze(byDecision),
-    readDenyCount,
-    estimatedTokensSaved: readDenyCount * ESTIMATED_TOKENS_PER_READ_DENY,
-    firstEntry: firstEntryTs,
-    lastEntry: lastEntryTs
-  };
-}
-function formatStatsSummary(summary) {
-  if (summary.totalInvocations === 0) {
-    return "engram hook stats: no log entries yet.\n\nRun engram install-hook in a project, then use Claude Code to see interceptions.";
-  }
-  const lines = [];
-  lines.push(`engram hook stats (${summary.totalInvocations} invocations)`);
-  lines.push("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500");
-  if (summary.firstEntry && summary.lastEntry) {
-    lines.push(`Time range: ${summary.firstEntry} \u2192 ${summary.lastEntry}`);
-    lines.push("");
-  }
-  lines.push("By event:");
-  const eventEntries = Object.entries(summary.byEvent).sort(
-    (a, b) => b[1] - a[1]
-  );
-  for (const [event, count] of eventEntries) {
-    const pct = (count / summary.totalInvocations * 100).toFixed(1);
-    lines.push(`  ${event.padEnd(18)} ${String(count).padStart(5)} (${pct}%)`);
-  }
-  lines.push("");
-  lines.push("By tool:");
-  const toolEntries = Object.entries(summary.byTool).filter(([k]) => k !== "unknown").sort((a, b) => b[1] - a[1]);
-  for (const [tool, count] of toolEntries) {
-    lines.push(`  ${tool.padEnd(18)} ${String(count).padStart(5)}`);
-  }
-  if (toolEntries.length === 0) {
-    lines.push("  (no tool-tagged entries)");
-  }
-  lines.push("");
-  const decisionEntries = Object.entries(summary.byDecision);
-  if (decisionEntries.length > 0) {
-    lines.push("PreToolUse decisions:");
-    for (const [decision, count] of decisionEntries.sort(
-      (a, b) => b[1] - a[1]
-    )) {
-      lines.push(`  ${decision.padEnd(18)} ${String(count).padStart(5)}`);
-    }
-    lines.push("");
-  }
-  if (summary.readDenyCount > 0) {
-    lines.push(
-      `Estimated tokens saved: ~${summary.estimatedTokensSaved.toLocaleString()}`
-    );
-    lines.push(
-      `  (${summary.readDenyCount} Read denies \xD7 ${ESTIMATED_TOKENS_PER_READ_DENY} tok/deny avg)`
-    );
-  } else {
-    lines.push("Estimated tokens saved: 0");
-    lines.push("  (no PreToolUse:Read denies recorded yet)");
-  }
-  return lines.join("\n");
-}
-
-// src/dashboard.ts
 var AMBER = chalk.hex("#d97706");
 var DIM = chalk.dim;
 var GREEN = chalk.green;
@@ -2736,116 +2672,15 @@ function formatInstallDiff(before, after) {
   return lines.length > 0 ? lines.join("\n") : "(no changes)";
 }
 
-// src/intercept/component-status.ts
-import { existsSync as existsSync8, readFileSync as readFileSync4, writeFileSync } from "fs";
-import { join as join8 } from "path";
-import { tmpdir as tmpdir2, homedir } from "os";
-function statusPath(projectRoot) {
-  return join8(projectRoot, ".engram", "component-status.json");
-}
-function readCachedStatus(projectRoot) {
-  const path2 = statusPath(projectRoot);
-  if (!existsSync8(path2)) return null;
-  try {
-    const raw = JSON.parse(readFileSync4(path2, "utf-8"));
-    if (Date.now() - raw.generatedAt > 3e4) return null;
-    return raw;
-  } catch {
-    return null;
-  }
-}
-function checkHttp(projectRoot) {
-  return existsSync8(join8(projectRoot, ".engram", "http-server.pid"));
-}
-function checkLsp(projectRoot) {
-  if (existsSync8(join8(projectRoot, ".engram", "lsp-available"))) return true;
-  const tmp = tmpdir2();
-  const candidates = [
-    join8(tmp, "tsserver.sock"),
-    join8(tmp, "typescript-language-server.sock")
-  ];
-  return candidates.some((c) => existsSync8(c));
-}
-function checkAst(projectRoot) {
-  const grammarsDir = join8(projectRoot, "node_modules", "web-tree-sitter");
-  return existsSync8(grammarsDir);
-}
-function countIdeAdapters(projectRoot) {
-  let count = 0;
-  if (existsSync8(join8(projectRoot, ".cursor", "rules", "engram-context.mdc"))) {
-    count += 1;
-  }
-  const continueConfig = join8(homedir(), ".continue", "config.json");
-  if (existsSync8(continueConfig)) {
-    try {
-      const cfg = readFileSync4(continueConfig, "utf-8");
-      if (cfg.includes("engram")) count += 1;
-    } catch {
-    }
-  }
-  const zedSettings = join8(homedir(), ".config", "zed", "settings.json");
-  if (existsSync8(zedSettings)) {
-    try {
-      const cfg = readFileSync4(zedSettings, "utf-8");
-      if (cfg.includes("engram")) count += 1;
-    } catch {
-    }
-  }
-  const claudeSettings = join8(projectRoot, ".claude", "settings.local.json");
-  if (existsSync8(claudeSettings)) {
-    try {
-      const cfg = readFileSync4(claudeSettings, "utf-8");
-      if (cfg.includes("engram")) count += 1;
-    } catch {
-    }
-  }
-  return count;
-}
-function refreshComponentStatus(projectRoot) {
-  const now = Date.now();
-  const components = [
-    { name: "http", available: checkHttp(projectRoot), checkedAt: now },
-    { name: "lsp", available: checkLsp(projectRoot), checkedAt: now },
-    { name: "ast", available: checkAst(projectRoot), checkedAt: now }
-  ];
-  const ideCount = countIdeAdapters(projectRoot);
-  const report = {
-    components,
-    ideCount,
-    generatedAt: now
-  };
-  try {
-    writeFileSync(statusPath(projectRoot), JSON.stringify(report), "utf-8");
-  } catch {
-  }
-  return report;
-}
-function getComponentStatus(projectRoot) {
-  const cached = readCachedStatus(projectRoot);
-  if (cached) return cached;
-  return refreshComponentStatus(projectRoot);
-}
-function formatHudStatus(report) {
-  const parts = [];
-  for (const c of report.components) {
-    const icon = c.available ? "\u2713" : "\u2717";
-    parts.push(`${c.name.toUpperCase()} ${icon}`);
-  }
-  if (report.ideCount > 0) {
-    parts.push(`${report.ideCount} IDE${report.ideCount > 1 ? "s" : ""}`);
-  }
-  return parts.join(" | ");
-}
-
 // src/intercept/memory-md.ts
 import {
-  existsSync as existsSync9,
-  readFileSync as readFileSync5,
-  writeFileSync as writeFileSync2,
+  existsSync as existsSync8,
+  readFileSync as readFileSync4,
+  writeFileSync,
   renameSync,
   statSync as statSync4
 } from "fs";
-import { join as join9 } from "path";
+import { join as join8 } from "path";
 var ENGRAM_MARKER_START = "<!-- engram:structural-facts:start -->";
 var ENGRAM_MARKER_END = "<!-- engram:structural-facts:end -->";
 var MAX_MEMORY_FILE_BYTES = 1e6;
@@ -2916,19 +2751,19 @@ function writeEngramSectionToMemoryMd(projectRoot, engramSection) {
   if (engramSection.length > MAX_ENGRAM_SECTION_BYTES) {
     return false;
   }
-  const memoryPath = join9(projectRoot, "MEMORY.md");
+  const memoryPath = join8(projectRoot, "MEMORY.md");
   try {
     let existing = "";
-    if (existsSync9(memoryPath)) {
+    if (existsSync8(memoryPath)) {
       const st = statSync4(memoryPath);
       if (st.size > MAX_MEMORY_FILE_BYTES) {
         return false;
       }
-      existing = readFileSync5(memoryPath, "utf-8");
+      existing = readFileSync4(memoryPath, "utf-8");
     }
     const updated = upsertEngramSection(existing, engramSection);
     const tmpPath = memoryPath + ".engram-tmp";
-    writeFileSync2(tmpPath, updated);
+    writeFileSync(tmpPath, updated);
     renameSync(tmpPath, memoryPath);
     return true;
   } catch {
@@ -2948,10 +2783,14 @@ program.name("engram").description(
 program.command("init").description("Scan codebase and build knowledge graph (zero LLM cost)").argument("[path]", "Project directory", ".").option(
   "--with-skills [dir]",
   "Also index Claude Code skills from ~/.claude/skills/ or a given path"
-).option("--from-ccs", "Import .context/index.md (CCS) into graph after init").action(async (projectPath, opts) => {
-  console.log(chalk2.dim("\u{1F50D} Scanning codebase..."));
+).option("--from-ccs", "Import .context/index.md (CCS) into graph after init").option(
+  "--incremental",
+  "Skip unchanged files (mtime-based). Dramatically faster on re-index of large repos."
+).action(async (projectPath, opts) => {
+  console.log(chalk2.dim(opts.incremental ? "\u{1F50D} Scanning changed files..." : "\u{1F50D} Scanning codebase..."));
   const result = await init(projectPath, {
-    withSkills: opts.withSkills
+    withSkills: opts.withSkills,
+    incremental: opts.incremental
   });
   console.log(
     chalk2.green("\u{1F333} AST extraction complete") + chalk2.dim(` (${result.timeMs}ms, 0 tokens used)`)
@@ -2959,6 +2798,9 @@ program.command("init").description("Scan codebase and build knowledge graph (ze
   console.log(
     `   ${chalk2.bold(String(result.nodes))} nodes, ${chalk2.bold(String(result.edges))} edges from ${chalk2.bold(String(result.fileCount))} files (${result.totalLines.toLocaleString()} lines)`
   );
+  if (result.incremental && result.skippedFiles && result.skippedFiles > 0) {
+    console.log(chalk2.dim(`   ${result.skippedFiles} unchanged files skipped (incremental mode)`));
+  }
   if (result.skillCount && result.skillCount > 0) {
     console.log(
       chalk2.cyan(`   ${chalk2.bold(String(result.skillCount))} skills indexed`)
@@ -2977,9 +2819,9 @@ program.command("init").description("Scan codebase and build knowledge graph (ze
   console.log(chalk2.green("\n\u2705 Ready. Your AI now has persistent memory."));
   console.log(chalk2.dim("   Graph stored in .engram/graph.db"));
   const resolvedProject = pathResolve(projectPath);
-  const localSettings = join10(resolvedProject, ".claude", "settings.local.json");
-  const projectSettings = join10(resolvedProject, ".claude", "settings.json");
-  const hasHooks = existsSync10(localSettings) && readFileSync6(localSettings, "utf-8").includes("engram intercept") || existsSync10(projectSettings) && readFileSync6(projectSettings, "utf-8").includes("engram intercept");
+  const localSettings = join9(resolvedProject, ".claude", "settings.local.json");
+  const projectSettings = join9(resolvedProject, ".claude", "settings.json");
+  const hasHooks = existsSync9(localSettings) && readFileSync5(localSettings, "utf-8").includes("engram intercept") || existsSync9(projectSettings) && readFileSync5(projectSettings, "utf-8").includes("engram intercept");
   if (!hasHooks) {
     console.log(
       chalk2.yellow("\n\u{1F4A1} Next step: ") + chalk2.white("engram install-hook") + chalk2.dim(
@@ -2993,7 +2835,7 @@ program.command("init").description("Scan codebase and build knowledge graph (ze
     );
   }
   if (opts.fromCcs) {
-    const { importCcs } = await import("./importer-LU2YFZDY.js");
+    const { importCcs } = await import("./importer-V62NGZRK.js");
     const resolvedProjectPath = pathResolve(projectPath);
     const ccsResult = await importCcs(resolvedProjectPath);
     if (ccsResult.nodesCreated > 0) {
@@ -3035,8 +2877,8 @@ program.command("watch").description("Watch project for file changes and re-inde
 });
 program.command("dashboard").alias("hud").description("Live terminal dashboard showing hook activity and token savings").argument("[path]", "Project directory", ".").action(async (projectPath) => {
   const resolvedPath = pathResolve(projectPath);
-  const dbPath = join10(resolvedPath, ".engram", "graph.db");
-  if (!existsSync10(dbPath)) {
+  const dbPath = join9(resolvedPath, ".engram", "graph.db");
+  if (!existsSync9(dbPath)) {
     console.error(
       chalk2.red("No engram graph found at ") + chalk2.white(resolvedPath)
     );
@@ -3056,7 +2898,7 @@ program.command("hud-label").description("Output JSON label for Claude HUD --ext
   let resolvedPath = pathResolve(projectPath);
   let found = false;
   for (let depth = 0; depth < 20; depth++) {
-    if (existsSync10(join10(resolvedPath, ".engram", "graph.db"))) {
+    if (existsSync9(join9(resolvedPath, ".engram", "graph.db"))) {
       found = true;
       break;
     }
@@ -3068,8 +2910,8 @@ program.command("hud-label").description("Output JSON label for Claude HUD --ext
     console.log('{"label":""}');
     return;
   }
-  const logPath = join10(resolvedPath, ".engram", "hook-log.jsonl");
-  if (!existsSync10(logPath)) {
+  const logPath = join9(resolvedPath, ".engram", "hook-log.jsonl");
+  if (!existsSync9(logPath)) {
     console.log('{"label":"\u26A1engram \u2591\u2591\u2591\u2591\u2591\u2591\u2591\u2591\u2591\u2591 ready"}');
     return;
   }
@@ -3223,7 +3065,7 @@ program.command("gen").description("Generate CLAUDE.md / .cursorrules section fr
   }
 );
 program.command("gen-mdc").description("Generate .cursor/rules/engram-context.mdc from knowledge graph").option("-p, --project <path>", "Project directory", ".").option("--watch", "Regenerate on graph changes").action(async (opts) => {
-  const { generateCursorMdc } = await import("./cursor-mdc-HWVUZUZH.js");
+  const { generateCursorMdc } = await import("./cursor-mdc-GJ7E5LDD.js");
   const result = await generateCursorMdc(opts.project);
   console.log(
     chalk2.green(
@@ -3244,7 +3086,7 @@ program.command("gen-mdc").description("Generate .cursor/rules/engram-context.md
   }
 });
 program.command("gen-ccs").description("Export knowledge graph as .context/index.md (CCS format)").option("-p, --project <path>", "Project directory", ".").action(async (opts) => {
-  const { exportCcs } = await import("./exporter-A3VSLS4U.js");
+  const { exportCcs } = await import("./exporter-GWU2GF23.js");
   const result = await exportCcs(pathResolve(opts.project));
   console.log(
     chalk2.green(
@@ -3253,7 +3095,7 @@ program.command("gen-ccs").description("Export knowledge graph as .context/index
   );
 });
 program.command("gen-aider").description("Generate .aider-context.md from knowledge graph").option("-p, --project <path>", "Project directory", ".").option("--watch", "Regenerate on graph changes").action(async (opts) => {
-  const { generateAiderContext } = await import("./aider-context-TNGSXMVY.js");
+  const { generateAiderContext } = await import("./aider-context-BC5R2ZTA.js");
   const result = await generateAiderContext(pathResolve(opts.project));
   console.log(
     chalk2.green(
@@ -3273,15 +3115,36 @@ program.command("gen-aider").description("Generate .aider-context.md from knowle
     });
   }
 });
+program.command("gen-windsurfrules").description("Generate .windsurfrules from knowledge graph (Windsurf IDE)").option("-p, --project <path>", "Project directory", ".").option("--watch", "Regenerate on graph changes").action(async (opts) => {
+  const { generateWindsurfRules } = await import("./windsurf-rules-C7SVDHBL.js");
+  const result = await generateWindsurfRules(pathResolve(opts.project));
+  console.log(
+    chalk2.green(
+      `\u2705 Generated ${result.filePath} (${result.sections} sections, ${result.nodes} nodes)`
+    )
+  );
+  if (opts.watch) {
+    watchProject(pathResolve(opts.project), {
+      onReindex: async () => {
+        const r = await generateWindsurfRules(opts.project);
+        console.log(chalk2.dim(`  \u21BB Regenerated .windsurfrules (${r.nodes} nodes)`));
+      },
+      onError: (err) => console.error(chalk2.red(err.message)),
+      onReady: () => console.log(chalk2.dim("  Watching for changes..."))
+    });
+    await new Promise(() => {
+    });
+  }
+});
 function resolveSettingsPath(scope, projectPath) {
   const absProject = pathResolve(projectPath);
   switch (scope) {
     case "local":
-      return join10(absProject, ".claude", "settings.local.json");
+      return join9(absProject, ".claude", "settings.local.json");
     case "project":
-      return join10(absProject, ".claude", "settings.json");
+      return join9(absProject, ".claude", "settings.json");
     case "user":
-      return join10(homedir2(), ".claude", "settings.json");
+      return join9(homedir(), ".claude", "settings.json");
     default:
       return null;
   }
@@ -3375,9 +3238,9 @@ program.command("install-hook").description("Install engram hook entries into Cl
       process.exit(1);
     }
     let existing = {};
-    if (existsSync10(settingsPath)) {
+    if (existsSync9(settingsPath)) {
       try {
-        const raw = readFileSync6(settingsPath, "utf-8");
+        const raw = readFileSync5(settingsPath, "utf-8");
         existing = raw.trim() ? JSON.parse(raw) : {};
       } catch (err) {
         console.error(
@@ -3423,13 +3286,13 @@ program.command("install-hook").description("Install engram hook entries into Cl
     }
     try {
       mkdirSync(dirname4(settingsPath), { recursive: true });
-      if (existsSync10(settingsPath)) {
+      if (existsSync9(settingsPath)) {
         const backupPath = `${settingsPath}.engram-backup-${(/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-")}.bak`;
         copyFileSync(settingsPath, backupPath);
         console.log(chalk2.dim(`   Backup: ${backupPath}`));
       }
       const tmpPath = settingsPath + ".engram-tmp";
-      writeFileSync3(
+      writeFileSync2(
         tmpPath,
         JSON.stringify(result.updated, null, 2) + "\n"
       );
@@ -3474,7 +3337,7 @@ program.command("uninstall-hook").description("Remove engram hook entries from C
     console.error(chalk2.red(`Unknown scope: ${opts.scope}`));
     process.exit(1);
   }
-  if (!existsSync10(settingsPath)) {
+  if (!existsSync9(settingsPath)) {
     console.log(
       chalk2.yellow(`No settings file at ${settingsPath} \u2014 nothing to remove.`)
     );
@@ -3482,7 +3345,7 @@ program.command("uninstall-hook").description("Remove engram hook entries from C
   }
   let existing;
   try {
-    const raw = readFileSync6(settingsPath, "utf-8");
+    const raw = readFileSync5(settingsPath, "utf-8");
     existing = raw.trim() ? JSON.parse(raw) : {};
   } catch (err) {
     console.error(
@@ -3502,7 +3365,7 @@ program.command("uninstall-hook").description("Remove engram hook entries from C
     const backupPath = `${settingsPath}.engram-backup-${(/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-")}.bak`;
     copyFileSync(settingsPath, backupPath);
     const tmpPath = settingsPath + ".engram-tmp";
-    writeFileSync3(tmpPath, JSON.stringify(result.updated, null, 2) + "\n");
+    writeFileSync2(tmpPath, JSON.stringify(result.updated, null, 2) + "\n");
     renameSync2(tmpPath, settingsPath);
     if (result.removed.length > 0) {
       console.log(
@@ -3597,9 +3460,9 @@ program.command("hook-disable").description("Disable engram hooks via kill switc
     console.error(chalk2.dim("Run 'engram init' first."));
     process.exit(1);
   }
-  const flagPath = join10(projectRoot, ".engram", "hook-disabled");
+  const flagPath = join9(projectRoot, ".engram", "hook-disabled");
   try {
-    writeFileSync3(flagPath, (/* @__PURE__ */ new Date()).toISOString());
+    writeFileSync2(flagPath, (/* @__PURE__ */ new Date()).toISOString());
     console.log(
       chalk2.green(`\u2705 engram hooks disabled for ${projectRoot}`)
     );
@@ -3621,8 +3484,8 @@ program.command("hook-enable").description("Re-enable engram hooks (remove kill
     console.error(chalk2.red(`Not an engram project: ${absProject}`));
     process.exit(1);
   }
-  const flagPath = join10(projectRoot, ".engram", "hook-disabled");
-  if (!existsSync10(flagPath)) {
+  const flagPath = join9(projectRoot, ".engram", "hook-disabled");
+  if (!existsSync9(flagPath)) {
     console.log(
       chalk2.yellow(`engram hooks already enabled for ${projectRoot}`)
     );
@@ -3664,9 +3527,9 @@ program.command("memory-sync").description(
     }
     let branch = null;
     try {
-      const headPath = join10(projectRoot, ".git", "HEAD");
-      if (existsSync10(headPath)) {
-        const content = readFileSync6(headPath, "utf-8").trim();
+      const headPath = join9(projectRoot, ".git", "HEAD");
+      if (existsSync9(headPath)) {
+        const content = readFileSync5(headPath, "utf-8").trim();
         const m = content.match(/^ref:\s+refs\/heads\/(.+)$/);
         if (m) branch = m[1];
       }
@@ -3692,7 +3555,7 @@ program.command("memory-sync").description(
 \u{1F4DD} engram memory-sync`)
     );
     console.log(
-      chalk2.dim(`   Target: ${join10(projectRoot, "MEMORY.md")}`)
+      chalk2.dim(`   Target: ${join9(projectRoot, "MEMORY.md")}`)
     );
     if (opts.dryRun) {
       console.log(chalk2.cyan("\n   Section to write (dry-run):\n"));
@@ -3736,29 +3599,69 @@ program.command("stress-test").description("Run stress tests: memory, concurrenc
   if (opts.replay) args.push("--replay", opts.replay);
   if (opts.limit) args.push("--limit", String(opts.limit));
   try {
-    execFileSync2("npx", ["tsx", ...args], { stdio: "inherit", shell: true, cwd: join10(dirname4(fileURLToPath2(import.meta.url)), "..") });
+    execFileSync2("npx", ["tsx", ...args], { stdio: "inherit", shell: true, cwd: join9(dirname4(fileURLToPath2(import.meta.url)), "..") });
   } catch {
     process.exit(1);
   }
 });
 program.command("server").description("Start engram HTTP REST server (binds to 127.0.0.1 only)").option("--http", "Enable HTTP server (default)").option("--port <port>", "HTTP port", "7337").option("-p, --project <path>", "Project directory", ".").action(async (opts) => {
-  const { startHttpServer } = await import("./server-I3C74ZLB.js");
+  const { startHttpServer } = await import("./server-VBRTTECZ.js");
   await startHttpServer(pathResolve(opts.project), parseInt(opts.port, 10));
 });
+program.command("ui").description("Open the web dashboard (auto-starts HTTP server if needed)").option("--port <port>", "HTTP port", "7337").option("-p, --project <path>", "Project directory", ".").option("--no-open", "Don't launch browser, just print the URL").action(async (opts) => {
+  const port = parseInt(opts.port, 10);
+  const url = `http://127.0.0.1:${port}/ui`;
+  const projectRoot = pathResolve(opts.project);
+  const { existsSync: existsSync10, readFileSync: readFileSync6 } = await import("fs");
+  const pidPath = join9(projectRoot, ".engram", "http-server.pid");
+  let alreadyRunning = false;
+  if (existsSync10(pidPath)) {
+    try {
+      const pid = parseInt(readFileSync6(pidPath, "utf-8"), 10);
+      process.kill(pid, 0);
+      alreadyRunning = true;
+    } catch {
+    }
+  }
+  if (alreadyRunning) {
+    console.log(chalk2.dim(`engram server already running \u2014 opening ${url}`));
+  } else {
+    console.log(chalk2.dim(`Starting engram server on ${url}...`));
+    const { spawn } = await import("child_process");
+    const child = spawn(
+      process.argv[0],
+      [process.argv[1], "server", "--port", String(port), "-p", projectRoot],
+      { detached: true, stdio: "ignore" }
+    );
+    child.unref();
+    await new Promise((r) => setTimeout(r, 500));
+  }
+  console.log(chalk2.green(`\u2713 Dashboard: ${url}`));
+  if (opts.open !== false) {
+    const { platform } = process;
+    const opener = platform === "darwin" ? "open" : platform === "win32" ? "start" : "xdg-open";
+    try {
+      const { execFile: execFile4 } = await import("child_process");
+      execFile4(opener, [url], { shell: platform === "win32" }, () => {
+      });
+    } catch {
+    }
+  }
+});
 program.command("context-server").description("Start Zed-compatible context server (JSON-RPC over stdio)").action(async () => {
   const { execFileSync: execFileSync2 } = await import("child_process");
   try {
     execFileSync2("npx", ["tsx", "adapters/zed/index.ts"], {
       stdio: "inherit",
       shell: true,
-      cwd: join10(dirname4(fileURLToPath2(import.meta.url)), "..")
+      cwd: join9(dirname4(fileURLToPath2(import.meta.url)), "..")
     });
   } catch {
     process.exit(1);
   }
 });
 program.command("tune").description("Analyze hook-log and propose provider config changes").option("-p, --project <path>", "Project directory", ".").option("--dry-run", "Show proposed changes without applying (default)").option("--apply", "Apply proposed changes to .engram/config.json").action(async (opts) => {
-  const { analyzeTuning, applyTuning } = await import("./tuner-2LVIEE5V.js");
+  const { analyzeTuning, applyTuning } = await import("./tuner-KFNNGKG3.js");
   const proposal = analyzeTuning(pathResolve(opts.project));
   if (proposal.changes.length === 0) {
     console.log(
@@ -3789,8 +3692,8 @@ program.command("tune").description("Analyze hook-log and propose provider confi
 });
 var dbCmd = program.command("db").description("Database management");
 dbCmd.command("status").description("Show schema version and migration status").option("-p, --project <path>", "Project directory", ".").action(async (opts) => {
-  const { getStore: getStore2 } = await import("./core-77MHT3QV.js");
-  const { CURRENT_SCHEMA_VERSION, getSchemaVersion } = await import("./migrate-5ZJWF2HD.js");
+  const { getStore: getStore2 } = await import("./core-6IY5L6II.js");
+  const { CURRENT_SCHEMA_VERSION, getSchemaVersion } = await import("./migrate-UKCO6BUU.js");
   const store = await getStore2(pathResolve(opts.project));
   try {
     const version = getSchemaVersion(store.db);
@@ -3806,11 +3709,11 @@ dbCmd.command("status").description("Show schema version and migration status").
   }
 });
 dbCmd.command("migrate").description("Run pending schema migrations").option("-p, --project <path>", "Project directory", ".").action(async (opts) => {
-  const { getStore: getStore2 } = await import("./core-77MHT3QV.js");
-  const { runMigrations } = await import("./migrate-5ZJWF2HD.js");
+  const { getStore: getStore2 } = await import("./core-6IY5L6II.js");
+  const { runMigrations } = await import("./migrate-UKCO6BUU.js");
   const store = await getStore2(pathResolve(opts.project));
   try {
-    const dbPath = join10(pathResolve(opts.project), ".engram", "graph.db");
+    const dbPath = join9(pathResolve(opts.project), ".engram", "graph.db");
     const result = runMigrations(
       store.db,
       dbPath
@@ -3830,4 +3733,223 @@ dbCmd.command("migrate").description("Run pending schema migrations").option("-p
     store.close();
   }
 });
+dbCmd.command("rollback").description("Roll back to an earlier schema version (DESTRUCTIVE \u2014 always backs up first)").option("-p, --project <path>", "Project directory", ".").option("--to <version>", "Target schema version (0 drops all tables)").option("--yes", "Skip confirmation prompt").action(async (opts) => {
+  if (opts.to === void 0) {
+    console.error(chalk2.red("Required: --to <version>"));
+    console.log(chalk2.dim("Run 'engram db status' to see current version."));
+    process.exit(1);
+  }
+  const target = parseInt(opts.to, 10);
+  if (isNaN(target)) {
+    console.error(chalk2.red(`Invalid version: ${opts.to}`));
+    process.exit(1);
+  }
+  const { getStore: getStore2 } = await import("./core-6IY5L6II.js");
+  const { rollback, getSchemaVersion } = await import("./migrate-UKCO6BUU.js");
+  const store = await getStore2(pathResolve(opts.project));
+  try {
+    const dbPath = join9(pathResolve(opts.project), ".engram", "graph.db");
+    const current = getSchemaVersion(
+      store.db
+    );
+    if (target === current) {
+      console.log(chalk2.green(`Already at v${target}.`));
+      return;
+    }
+    if (target > current) {
+      console.error(
+        chalk2.red(`Cannot roll back to v${target}: current is v${current}.`)
+      );
+      console.log(chalk2.dim("Use 'engram db migrate' to move forward."));
+      process.exit(1);
+    }
+    if (!opts.yes) {
+      console.log(
+        chalk2.yellow(
+          `\u26A0  This will roll back from v${current} \u2192 v${target}.`
+        )
+      );
+      console.log(
+        chalk2.yellow(
+          `   Tables created after v${target} will be DROPPED (data loss).`
+        )
+      );
+      console.log(chalk2.dim(`   A backup will be saved to ${dbPath}.bak-v${current}`));
+      console.log(chalk2.dim(`   Re-run with --yes to confirm.`));
+      process.exit(1);
+    }
+    const result = rollback(
+      store.db,
+      dbPath,
+      target
+    );
+    store.save();
+    console.log(
+      chalk2.green(
+        `\u2713 Rolled back v${result.fromVersion} \u2192 v${result.toVersion} (${result.migrationsReverted} migrations reverted)`
+      )
+    );
+    if (result.backedUp) {
+      console.log(chalk2.dim(`  Backup: ${dbPath}.bak-v${result.fromVersion}`));
+    }
+  } finally {
+    store.close();
+  }
+});
+var pluginCmd = program.command("plugin").description("Manage context provider plugins");
+pluginCmd.command("list").description("List installed provider plugins").action(async () => {
+  const { loadPlugins, PLUGINS_DIR, ensurePluginsDir } = await import("./plugin-loader-FCOMVOX7.js");
+  ensurePluginsDir();
+  const { loaded, failed } = await loadPlugins();
+  if (loaded.length === 0 && failed.length === 0) {
+    console.log(chalk2.dim(`No plugins installed.`));
+    console.log(chalk2.dim(`Install with: engram plugin install <file.mjs>`));
+    console.log(chalk2.dim(`Plugins directory: ${PLUGINS_DIR}`));
+    return;
+  }
+  if (loaded.length > 0) {
+    console.log(chalk2.bold(`Installed plugins (${loaded.length})`));
+    console.log(chalk2.dim("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+    for (const p of loaded) {
+      const tierLabel = p.tier === 1 ? "internal" : "external";
+      const descr = p.description ? ` \u2014 ${p.description}` : "";
+      console.log(
+        `  ${chalk2.green("\u25CF")} ${chalk2.bold(p.name)} ${chalk2.dim(`v${p.version}`)} ` + chalk2.dim(`[${tierLabel}, ${p.tokenBudget}tok budget]`)
+      );
+      if (descr) console.log(`    ${chalk2.dim(descr.trim())}`);
+    }
+  }
+  if (failed.length > 0) {
+    console.log();
+    console.log(chalk2.yellow(`Failed to load (${failed.length}):`));
+    for (const f of failed) {
+      console.log(`  ${chalk2.red("\u2717")} ${f.file} ${chalk2.dim(`\u2014 ${f.reason}`)}`);
+    }
+  }
+});
+pluginCmd.command("install").description("Install a plugin by copying its .mjs file into ~/.engram/plugins/").argument("<file>", "Path to plugin .mjs file").action(async (file) => {
+  const { copyFileSync: copyFileSync2, statSync: statSync5 } = await import("fs");
+  const { basename: basename6 } = await import("path");
+  const { PLUGINS_DIR, ensurePluginsDir, validatePlugin } = await import("./plugin-loader-FCOMVOX7.js");
+  const { pathToFileURL } = await import("url");
+  const absPath = pathResolve(file);
+  if (!existsSync9(absPath)) {
+    console.error(chalk2.red(`File not found: ${absPath}`));
+    process.exit(1);
+  }
+  if (!statSync5(absPath).isFile()) {
+    console.error(chalk2.red(`Not a file: ${absPath}`));
+    process.exit(1);
+  }
+  if (!absPath.endsWith(".mjs") && !absPath.endsWith(".js")) {
+    console.error(chalk2.red(`Plugin must be .mjs or .js (got ${absPath})`));
+    process.exit(1);
+  }
+  try {
+    const mod = await import(pathToFileURL(absPath).href);
+    const { plugin, reason } = validatePlugin(mod);
+    if (!plugin) {
+      console.error(chalk2.red(`Invalid plugin: ${reason}`));
+      process.exit(1);
+    }
+    console.log(
+      chalk2.dim(`Validated ${plugin.name} v${plugin.version} (tier ${plugin.tier})`)
+    );
+  } catch (e) {
+    console.error(chalk2.red(`Failed to load plugin: ${e.message}`));
+    process.exit(1);
+  }
+  ensurePluginsDir();
+  const destName = basename6(absPath);
+  const destPath = join9(PLUGINS_DIR, destName);
+  copyFileSync2(absPath, destPath);
+  console.log(chalk2.green(`\u2713 Installed: ${destPath}`));
+});
+pluginCmd.command("remove").description("Remove an installed plugin by filename").argument("<filename>", "Plugin filename (e.g., my-provider.mjs)").action(async (filename) => {
+  const { PLUGINS_DIR } = await import("./plugin-loader-FCOMVOX7.js");
+  const target = join9(PLUGINS_DIR, filename);
+  if (!existsSync9(target)) {
+    console.error(chalk2.red(`No such plugin: ${filename}`));
+    console.log(chalk2.dim(`Plugins directory: ${PLUGINS_DIR}`));
+    process.exit(1);
+  }
+  unlinkSync(target);
+  console.log(chalk2.green(`\u2713 Removed: ${filename}`));
+});
+var cacheCmd = program.command("cache").description("Inspect and manage the context cache");
+cacheCmd.command("stats").description("Show cache hit rate, entries, and LRU sizes").option("-p, --project <path>", "Project directory", ".").action(async (opts) => {
+  const { getStore: getStore2 } = await import("./core-6IY5L6II.js");
+  const { getContextCache, ContextCache } = await import("./cache-AK6CF3BC.js");
+  const store = await getStore2(pathResolve(opts.project));
+  try {
+    ContextCache.ensureTables(store);
+    const cache = getContextCache();
+    const s = cache.getStats(store);
+    const hitRatePct = (s.hitRate * 100).toFixed(1);
+    const totalOps = s.totalHits + s.totalMisses;
+    console.log(chalk2.bold("Cache stats"));
+    console.log(chalk2.dim("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+    console.log(
+      `  ${chalk2.dim("Hit rate")}      ${chalk2.green(chalk2.bold(hitRatePct + "%"))}  ${chalk2.dim(
+        `(${s.totalHits} hits / ${totalOps} ops)`
+      )}`
+    );
+    console.log(
+      `  ${chalk2.dim("Query cache")}   ${chalk2.bold(String(s.queryEntries))} entries, ${chalk2.green(
+        String(s.queryHits)
+      )} hits, ${chalk2.dim(String(s.queryMisses) + " miss")}`
+    );
+    console.log(
+      `  ${chalk2.dim("Pattern cache")} ${chalk2.bold(String(s.patternEntries))} entries, ${chalk2.green(
+        String(s.patternHits)
+      )} hits, ${chalk2.dim(String(s.patternMisses) + " miss")}`
+    );
+    console.log(
+      `  ${chalk2.dim("Hot files")}     ${chalk2.bold(String(s.hotFileCount))} warmed`
+    );
+  } finally {
+    store.close();
+  }
+});
+cacheCmd.command("clear").description("Flush all cache layers (query, pattern, hot files)").option("-p, --project <path>", "Project directory", ".").action(async (opts) => {
+  const { getStore: getStore2 } = await import("./core-6IY5L6II.js");
+  const { getContextCache, ContextCache } = await import("./cache-AK6CF3BC.js");
+  const store = await getStore2(pathResolve(opts.project));
+  try {
+    ContextCache.ensureTables(store);
+    const cache = getContextCache();
+    const before = cache.getStats(store);
+    cache.clearAll(store);
+    store.save();
+    console.log(
+      chalk2.green(
+        `\u2713 Cleared ${before.queryEntries} query entries, ${before.patternEntries} pattern entries`
+      )
+    );
+  } finally {
+    store.close();
+  }
+});
+cacheCmd.command("warm").description("Pre-warm hot file cache from access frequency (top-N)").option("-p, --project <path>", "Project directory", ".").option("-n, --limit <n>", "Number of files to warm", "20").action(async (opts) => {
+  const { getStore: getStore2 } = await import("./core-6IY5L6II.js");
+  const { getContextCache, ContextCache } = await import("./cache-AK6CF3BC.js");
+  const store = await getStore2(pathResolve(opts.project));
+  try {
+    ContextCache.ensureTables(store);
+    const cache = getContextCache();
+    const topN = parseInt(opts.limit, 10) || 20;
+    const count = cache.warmHotFiles(store, pathResolve(opts.project), topN);
+    if (count === 0) {
+      console.log(
+        chalk2.dim(
+          "No files to warm. Cache is empty \u2014 run a few Read-intercepted sessions first."
+        )
+      );
+    } else {
+      console.log(chalk2.green(`\u2713 Warmed ${count} hot file${count === 1 ? "" : "s"} into LRU`));
+    }
+  } finally {
+    store.close();
+  }
+});
 program.parse();