engramx 2.0.2 → 3.0.0

package/dist/{chunk-PEH54LYC.js → chunk-645NBY6L.js}

@@ -1,7 +1,12 @@
 // src/db/migrate.ts
 import { existsSync, copyFileSync } from "fs";
-var CURRENT_SCHEMA_VERSION = 7;
+var CURRENT_SCHEMA_VERSION = 8;
 var DOWN_MIGRATIONS = {
+  // v3.0: bi-temporal mistake validity. SQLite only added DROP COLUMN in
+  // 3.35 (2021); older sql.js builds may not support it. We don't depend
+  // on the columns being absent — leaving them in place is safe. The index
+  // CAN be dropped cleanly.
+  8: `DROP INDEX IF EXISTS idx_nodes_validity;`,
   7: `DROP TABLE IF EXISTS query_cache; DROP TABLE IF EXISTS pattern_cache;`,
   6: `DROP TABLE IF EXISTS engram_config;`,
   5: `DROP TABLE IF EXISTS provider_cache;`,
@@ -14,6 +19,13 @@ var DOWN_MIGRATIONS = {
   // 1 → 0 drops the entire schema. We require `engram init` for that.
   1: `DROP TABLE IF EXISTS stats; DROP TABLE IF EXISTS edges; DROP TABLE IF EXISTS nodes;`
 };
+function addColumnIfMissing(db, table, column, ddl) {
+  const result = db.exec(`PRAGMA table_info(${table})`);
+  const existing = (result[0]?.values ?? []).map((row) => row[1]);
+  if (!existing.includes(column)) {
+    db.exec(`ALTER TABLE ${table} ADD COLUMN ${ddl}`);
+  }
+}
 var MIGRATIONS = {
   // v0.1.0: Initial schema
   1: `
@@ -85,7 +97,28 @@ CREATE TABLE IF NOT EXISTS pattern_cache (
   graph_version INTEGER NOT NULL,
   hit_count INTEGER NOT NULL DEFAULT 0
 );
-CREATE INDEX IF NOT EXISTS idx_query_cache_file ON query_cache(file_path);`
+CREATE INDEX IF NOT EXISTS idx_query_cache_file ON query_cache(file_path);`,
+  // v3.0.0: Bi-temporal validity for mistake nodes (and any other node kind
+  // that wants it). `valid_until` is the unix-ms timestamp after which the
+  // mistake should NO LONGER surface in context (e.g. the referenced code
+  // was refactored away). NULL = still valid (back-compat default for all
+  // existing rows). `invalidated_by_commit` records the git SHA that caused
+  // the invalidation, for audit + future "explain why this mistake stopped
+  // firing" UX. Index is partial — only mistakes with an explicit validity
+  // window pay storage cost.
+  //
+  // Function-based because ALTER TABLE ADD COLUMN isn't idempotent in
+  // SQLite — re-running on a db that already has the columns throws
+  // 'duplicate column name'. We pre-check via PRAGMA table_info.
+  8: (db) => {
+    addColumnIfMissing(db, "nodes", "valid_until", "valid_until INTEGER");
+    addColumnIfMissing(db, "nodes", "invalidated_by_commit", "invalidated_by_commit TEXT");
+    db.exec(`
+      CREATE INDEX IF NOT EXISTS idx_nodes_validity
+        ON nodes(kind, valid_until)
+        WHERE kind = 'mistake' AND valid_until IS NOT NULL;
+    `);
+  }
 };
 function getSchemaVersion(db) {
   try {
@@ -116,9 +149,13 @@ function runMigrations(db, dbPath) {
   );
   let migrationsRun = 0;
   for (let v = fromVersion + 1; v <= CURRENT_SCHEMA_VERSION; v++) {
-    const sql = MIGRATIONS[v];
-    if (sql) {
-      db.exec(sql);
+    const step = MIGRATIONS[v];
+    if (step) {
+      if (typeof step === "string") {
+        db.exec(step);
+      } else {
+        step(db);
+      }
       migrationsRun++;
     }
   }

package/dist/chunk-73IBCRFI.js

@@ -0,0 +1,215 @@
+import {
+  applyArgTemplate
+} from "./chunk-ZUC6OXSL.js";
+
+// src/providers/mcp-client.ts
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
+function estimateTokens(text) {
+  return Math.ceil(text.length / 4);
+}
+var McpClientWrapper = class {
+  constructor(config) {
+    this.config = config;
+  }
+  config;
+  client = null;
+  transport = null;
+  connectingPromise = null;
+  shutdownRegistered = false;
+  lastErrorAt = 0;
+  errorBackoffMs = 3e4;
+  /**
+   * Connect once (idempotent). Concurrent callers share one promise so
+   * we never spawn the server twice. On failure we set a backoff window
+   * so the next Read doesn't re-try spawn immediately.
+   */
+  async connect() {
+    if (this.client) return;
+    if (this.connectingPromise) return this.connectingPromise;
+    if (Date.now() - this.lastErrorAt < this.errorBackoffMs) {
+      throw new Error(
+        `[mcp] ${this.config.name}: in error backoff (last failure ${Math.round(
+          (Date.now() - this.lastErrorAt) / 1e3
+        )}s ago)`
+      );
+    }
+    this.connectingPromise = this.doConnect().catch((err) => {
+      this.lastErrorAt = Date.now();
+      this.client = null;
+      this.transport = null;
+      throw err;
+    }).finally(() => {
+      this.connectingPromise = null;
+    });
+    return this.connectingPromise;
+  }
+  async doConnect() {
+    if (this.config.transport !== "stdio") {
+      throw new Error(
+        `[mcp] ${this.config.name}: http transport not yet implemented`
+      );
+    }
+    const transport = new StdioClientTransport({
+      command: this.config.command,
+      args: this.config.args ? [...this.config.args] : void 0,
+      env: this.config.env ? { ...this.config.env } : void 0,
+      cwd: this.config.cwd,
+      // Pipe stderr so a chatty server doesn't spam the parent's stderr
+      // during normal operation. Re-enable "inherit" for debugging.
+      stderr: "pipe"
+    });
+    const client = new Client(
+      { name: "engramx", version: "3.0.0" },
+      { capabilities: {} }
+    );
+    await client.connect(transport);
+    this.transport = transport;
+    this.client = client;
+    if (!this.shutdownRegistered) {
+      this.registerShutdown();
+      this.shutdownRegistered = true;
+    }
+  }
+  /**
+   * Call a single tool with a timeout. Returns null on error (never
+   * throws). Caller is responsible for aggregating multiple tool results.
+   */
+  async callTool(toolName, args, timeoutMs) {
+    try {
+      await this.connect();
+    } catch {
+      return null;
+    }
+    if (!this.client) return null;
+    const abort = new AbortController();
+    const timer = setTimeout(() => abort.abort(), timeoutMs);
+    try {
+      const result = await this.client.callTool(
+        { name: toolName, arguments: args },
+        void 0,
+        { signal: abort.signal, timeout: timeoutMs }
+      );
+      clearTimeout(timer);
+      const blocks = Array.isArray(result?.content) ? result.content : [];
+      const text = blocks.map((b) => {
+        const block = b;
+        if (block.type === "text" && typeof block.text === "string") {
+          return block.text;
+        }
+        return `[${block.type ?? "unknown"} block]`;
+      }).join("\n").trim();
+      if (text.length === 0) return null;
+      return { content: text };
+    } catch {
+      return null;
+    } finally {
+      clearTimeout(timer);
+    }
+  }
+  /** Close the connection. Safe to call on an unconnected client. */
+  async disconnect() {
+    const client = this.client;
+    const transport = this.transport;
+    this.client = null;
+    this.transport = null;
+    try {
+      await client?.close();
+    } catch {
+    }
+    try {
+      await transport?.close();
+    } catch {
+    }
+  }
+  registerShutdown() {
+    const shutdown = () => {
+      void this.disconnect();
+    };
+    process.once("SIGTERM", shutdown);
+    process.once("SIGINT", shutdown);
+    process.once("beforeExit", shutdown);
+  }
+};
+function createMcpProvider(config) {
+  const wrapper = new McpClientWrapper(config);
+  const tokenBudget = config.tokenBudget ?? 200;
+  const timeoutMs = config.timeoutMs ?? 2e3;
+  const enabled = config.enabled ?? true;
+  return {
+    name: config.name,
+    label: config.label,
+    // Tier 2 — external process/HTTP with cache support. Matches
+    // context7/obsidian tier semantics in the existing resolver.
+    tier: 2,
+    tokenBudget,
+    timeoutMs,
+    async isAvailable() {
+      if (!enabled) return false;
+      if (config.tools.length === 0) return false;
+      return true;
+    },
+    async resolve(filePath, context) {
+      try {
+        const results = await Promise.allSettled(
+          config.tools.map((tool) => callSingleTool(wrapper, tool, filePath, context, timeoutMs))
+        );
+        const sections = [];
+        let highestConfidence = 0;
+        for (const outcome of results) {
+          if (outcome.status === "fulfilled" && outcome.value) {
+            sections.push(outcome.value.content);
+            highestConfidence = Math.max(
+              highestConfidence,
+              outcome.value.confidence
+            );
+          }
+        }
+        if (sections.length === 0) return null;
+        let combined = sections.join("\n\n");
+        const budget = tokenBudget;
+        if (estimateTokens(combined) > budget) {
+          const lines = combined.split("\n");
+          const kept = [];
+          let used = 0;
+          for (const line of lines) {
+            const lineTokens = estimateTokens(line) + 1;
+            if (used + lineTokens > budget) break;
+            kept.push(line);
+            used += lineTokens;
+          }
+          combined = kept.join("\n") + "\n\u2026 [truncated to fit budget]";
+        }
+        return {
+          provider: config.name,
+          content: combined,
+          confidence: highestConfidence,
+          cached: false
+        };
+      } catch {
+        return null;
+      }
+    }
+  };
+}
+async function callSingleTool(wrapper, tool, filePath, context, timeoutMs) {
+  const args = applyArgTemplate(tool.args, {
+    filePath,
+    projectRoot: context.projectRoot,
+    imports: context.imports
+  });
+  const result = await wrapper.callTool(tool.name, args, timeoutMs);
+  if (!result) return null;
+  return {
+    content: result.content,
+    confidence: tool.confidence ?? 0.75
+  };
+}
+var __internalsForTesting = {
+  McpClientWrapper
+};
+
+export {
+  createMcpProvider,
+  __internalsForTesting
+};

package/dist/{chunk-SJT7VS2G.js → chunk-B4UOE64J.js}

@@ -1,6 +1,6 @@
 import {
   runMigrations
-} from "./chunk-PEH54LYC.js";
+} from "./chunk-645NBY6L.js";
 
 // src/core.ts
 import { join as join4, resolve as resolve2, relative as relative2 } from "path";
@@ -98,8 +98,8 @@ var GraphStore = class _GraphStore {
   }
   upsertNode(node) {
     this.db.run(
-      `INSERT OR REPLACE INTO nodes (id, label, kind, source_file, source_location, confidence, confidence_score, last_verified, query_count, metadata)
-       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
+      `INSERT OR REPLACE INTO nodes (id, label, kind, source_file, source_location, confidence, confidence_score, last_verified, query_count, metadata, valid_until, invalidated_by_commit)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`,
       [
         node.id,
         node.label,
@@ -110,7 +110,9 @@ var GraphStore = class _GraphStore {
         node.confidenceScore,
         node.lastVerified,
         node.queryCount,
-        JSON.stringify(node.metadata)
+        JSON.stringify(node.metadata),
+        node.validUntil ?? null,
+        node.invalidatedByCommit ?? null
       ]
     );
   }
@@ -147,6 +149,19 @@ var GraphStore = class _GraphStore {
       throw e;
     }
   }
+  countBySourceFile(sourceFile) {
+    const stmt = this.db.prepare(
+      "SELECT COUNT(*) AS n FROM nodes WHERE source_file = ?"
+    );
+    stmt.bind([sourceFile]);
+    let count = 0;
+    if (stmt.step()) {
+      const row = stmt.getAsObject();
+      count = Number(row.n) || 0;
+    }
+    stmt.free();
+    return count;
+  }
   bulkUpsert(nodes, edges) {
     this.db.run("BEGIN TRANSACTION");
     for (const node of nodes) this.upsertNode(node);
@@ -489,6 +504,8 @@ var GraphStore = class _GraphStore {
     this.db.close();
   }
   rowToNode(row) {
+    const validUntilRaw = row.valid_until;
+    const invalidatedByRaw = row.invalidated_by_commit;
     return {
       id: row.id,
       label: row.label,
@@ -499,7 +516,9 @@ var GraphStore = class _GraphStore {
       confidenceScore: row.confidence_score ?? 1,
       lastVerified: row.last_verified ?? 0,
       queryCount: row.query_count ?? 0,
-      metadata: JSON.parse(row.metadata || "{}")
+      metadata: JSON.parse(row.metadata || "{}"),
+      validUntil: validUntilRaw === null || validUntilRaw === void 0 ? void 0 : validUntilRaw,
+      invalidatedByCommit: invalidatedByRaw === null || invalidatedByRaw === void 0 ? void 0 : invalidatedByRaw
     };
   }
   rowToEdge(row) {
@@ -535,6 +554,9 @@ function truncateGraphemeSafe(s, max) {
   if (code >= 55296 && code <= 56319) cut--;
   return s.slice(0, cut) + "\u2026";
 }
+function formatThousands(n) {
+  return n.toString().replace(/\B(?=(\d{3})+(?!\d))/g, ",");
+}
 
 // src/graph/query.ts
 var MISTAKE_SCORE_BOOST = 2.5;
@@ -1230,6 +1252,7 @@ function getPatterns(lang) {
       return { classes: [], functions: [], imports: [], exports: [] };
   }
 }
+var MAX_DEPTH = 100;
 var DEFAULT_SKIP_DIRS = /* @__PURE__ */ new Set([
   "node_modules",
   "dist",
@@ -1281,7 +1304,8 @@ function extractDirectory(dirPath, rootDir, options = {}) {
     if (ignorePatterns.has(name)) return true;
     return false;
   }
-  function walk(dir) {
+  function walk(dir, depth) {
+    if (depth > MAX_DEPTH) return;
     let realDir;
     try {
       realDir = realpathSync(dir);
@@ -1290,12 +1314,17 @@ function extractDirectory(dirPath, rootDir, options = {}) {
     }
     if (visitedDirs.has(realDir)) return;
     visitedDirs.add(realDir);
-    const entries = readdirSync(dir, { withFileTypes: true });
+    let entries;
+    try {
+      entries = readdirSync(dir, { withFileTypes: true });
+    } catch {
+      return;
+    }
     for (const entry of entries) {
       const fullPath = join(dir, entry.name);
       if (entry.isDirectory()) {
         if (shouldSkipDir(entry.name)) continue;
-        walk(fullPath);
+        walk(fullPath, depth + 1);
         continue;
       }
       if (!entry.isFile()) continue;
@@ -1321,7 +1350,7 @@ function extractDirectory(dirPath, rootDir, options = {}) {
       options.onProgress?.(fileCount, skippedCount, relPath);
     }
   }
-  walk(dirPath);
+  walk(dirPath, 0);
   return { nodes: allNodes, edges: allEdges, fileCount, totalLines, mtimes, skippedCount };
 }
 
@@ -1368,6 +1397,8 @@ function mineGitHistory(projectRoot, maxCommits = 200) {
   const fileChangeCount = /* @__PURE__ */ new Map();
   const authorMap = /* @__PURE__ */ new Map();
   const commitBlocks = log.split("\n\n").filter(Boolean);
+  const SKIP_PREFIXES = ["dist/", "build/", "node_modules/", ".venv/", "target/", "coverage/"];
+  const MAX_FILES_PER_COMMIT = 50;
   for (const block of commitBlocks) {
     const lines = block.split("\n").filter(Boolean);
     if (lines.length === 0) continue;
@@ -1375,9 +1406,12 @@ function mineGitHistory(projectRoot, maxCommits = 200) {
     const parts = header.split("|");
     if (parts.length < 3) continue;
     const author = parts[1];
-    const files = fileLines.filter(
-      (f) => f.length > 0 && !f.includes("|") && !f.startsWith(" ") && f.includes(".")
+    let files = fileLines.filter(
+      (f) => f.length > 0 && !f.includes("|") && !f.startsWith(" ") && f.includes(".") && !SKIP_PREFIXES.some((p) => f.startsWith(p))
     );
+    if (files.length > MAX_FILES_PER_COMMIT) {
+      files = files.slice(0, MAX_FILES_PER_COMMIT);
+    }
     for (const file of files) {
       fileChangeCount.set(file, (fileChangeCount.get(file) ?? 0) + 1);
       if (!authorMap.has(file)) authorMap.set(file, /* @__PURE__ */ new Set());
@@ -2163,6 +2197,7 @@ export {
   GraphStore,
   sliceGraphemeSafe,
   truncateGraphemeSafe,
+  formatThousands,
   MAX_MISTAKE_LABEL_CHARS,
   queryGraph,
   shortestPath,

package/dist/chunk-FKY6HIT2.js

@@ -0,0 +1,99 @@
+import {
+  formatThousands
+} from "./chunk-B4UOE64J.js";
+
+// 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: ~${formatThousands(summary.estimatedTokensSaved)}`
+    );
+    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");
+}
+
+export {
+  ESTIMATED_TOKENS_PER_READ_DENY,
+  summarizeHookLog,
+  formatStatsSummary
+};

package/dist/{chunk-533LR4I7.js → chunk-G4U3QOOW.js}

@@ -1,93 +1,3 @@
-// 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/intercept/component-status.ts
 import { existsSync, readFileSync, writeFileSync } from "fs";
 import { join, dirname } from "path";
@@ -112,10 +22,16 @@ function checkHttp(projectRoot) {
 }
 function checkLsp(projectRoot) {
   if (existsSync(join(projectRoot, ".engram", "lsp-available"))) return true;
+  const uid = typeof process.getuid === "function" ? process.getuid() : 0;
   const tmp = tmpdir();
   const candidates = [
-    join(tmp, "tsserver.sock"),
-    join(tmp, "typescript-language-server.sock")
+    join(tmp, `tsserver-${uid}.sock`),
+    join(tmp, "lsp-server.sock"),
+    join(tmp, "typescript-language-server.sock"),
+    join(tmp, `pyright-${uid}.sock`),
+    join(tmp, "rust-analyzer.sock"),
+    // Legacy name kept for back-compat with older tsserver installs.
+    join(tmp, "tsserver.sock")
   ];
   return candidates.some((c) => existsSync(c));
 }
@@ -123,10 +39,12 @@ function checkAst(projectRoot) {
   try {
     const here = dirname(fileURLToPath(import.meta.url));
     const candidates = [
+      join(here, "grammars"),
+      // flattened bundle
       join(here, "..", "grammars"),
-      // from dist/intercept/
+      // nested bundle
       join(here, "..", "..", "dist", "grammars")
-      // from src/intercept/ dev
+      // dev-time
     ];
     for (const dir of candidates) {
       if (existsSync(dir)) return true;
@@ -212,9 +130,7 @@ function formatHudStatus(report) {
 }
 
 export {
-  ESTIMATED_TOKENS_PER_READ_DENY,
-  summarizeHookLog,
-  formatStatsSummary,
+  refreshComponentStatus,
   getComponentStatus,
   formatHudStatus
 };