engrm 0.4.0 → 0.4.3

package/dist/hooks/stop.js

@@ -2,6 +2,100 @@
 import { createRequire } from "node:module";
 var __require = /* @__PURE__ */ createRequire(import.meta.url);
 
+// src/capture/retrospective.ts
+function extractRetrospective(observations, sessionId, projectId, userId) {
+  if (observations.length === 0)
+    return null;
+  const request = extractRequest(observations);
+  const investigated = extractInvestigated(observations);
+  const learned = extractLearned(observations);
+  const completed = extractCompleted(observations);
+  const nextSteps = extractNextSteps(observations);
+  if (!request && !investigated && !learned && !completed && !nextSteps) {
+    return null;
+  }
+  return {
+    session_id: sessionId,
+    project_id: projectId,
+    user_id: userId,
+    request,
+    investigated,
+    learned,
+    completed,
+    next_steps: nextSteps
+  };
+}
+function extractRequest(observations) {
+  const first = observations[0];
+  if (!first)
+    return null;
+  return first.title;
+}
+function extractInvestigated(observations) {
+  const discoveries = observations.filter((o) => o.type === "discovery");
+  if (discoveries.length === 0)
+    return null;
+  return discoveries.slice(0, 5).map((o) => {
+    const facts = extractTopFacts(o, 2);
+    return facts ? `- ${o.title}
+${facts}` : `- ${o.title}`;
+  }).join(`
+`);
+}
+function extractLearned(observations) {
+  const learnTypes = new Set(["bugfix", "decision", "pattern"]);
+  const learned = observations.filter((o) => learnTypes.has(o.type));
+  if (learned.length === 0)
+    return null;
+  return learned.slice(0, 5).map((o) => {
+    const facts = extractTopFacts(o, 2);
+    return facts ? `- ${o.title}
+${facts}` : `- ${o.title}`;
+  }).join(`
+`);
+}
+function extractCompleted(observations) {
+  const completeTypes = new Set(["change", "feature", "refactor"]);
+  const completed = observations.filter((o) => completeTypes.has(o.type));
+  if (completed.length === 0)
+    return null;
+  return completed.slice(0, 5).map((o) => {
+    const files = o.files_modified ? parseJsonArray(o.files_modified) : [];
+    const fileCtx = files.length > 0 ? ` (${files.slice(0, 2).map((f) => f.split("/").pop()).join(", ")})` : "";
+    return `- ${o.title}${fileCtx}`;
+  }).join(`
+`);
+}
+function extractNextSteps(observations) {
+  if (observations.length < 2)
+    return null;
+  const lastQuarterStart = Math.floor(observations.length * 0.75);
+  const lastQuarter = observations.slice(lastQuarterStart);
+  const unresolved = lastQuarter.filter((o) => o.type === "bugfix" && o.narrative && /error|fail|exception/i.test(o.narrative));
+  if (unresolved.length === 0)
+    return null;
+  return unresolved.map((o) => `- Investigate: ${o.title}`).slice(0, 3).join(`
+`);
+}
+function extractTopFacts(obs, n) {
+  const facts = parseJsonArray(obs.facts);
+  if (facts.length === 0)
+    return null;
+  return facts.slice(0, n).map((f) => `    ${f}`).join(`
+`);
+}
+function parseJsonArray(json) {
+  if (!json)
+    return [];
+  try {
+    const parsed = JSON.parse(json);
+    if (Array.isArray(parsed)) {
+      return parsed.filter((f) => typeof f === "string" && f.length > 0);
+    }
+  } catch {}
+  return [];
+}
+
 // src/config.ts
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { homedir, hostname, networkInterfaces } from "node:os";
@@ -699,8 +793,8 @@ class MemDatabase {
     return this.db.query("SELECT * FROM projects WHERE id = ?").get(id) ?? null;
   }
   insertObservation(obs) {
-    const now = Math.floor(Date.now() / 1000);
-    const createdAt = new Date().toISOString();
+    const now = obs.created_at_epoch ?? Math.floor(Date.now() / 1000);
+    const createdAt = obs.created_at ?? new Date(now * 1000).toISOString();
     const result = this.db.query(`INSERT INTO observations (
           session_id, project_id, type, title, narrative, facts, concepts,
           files_read, files_modified, quality, lifecycle, sensitivity,
@@ -717,11 +811,14 @@ class MemDatabase {
   getObservationById(id) {
     return this.db.query("SELECT * FROM observations WHERE id = ?").get(id) ?? null;
   }
-  getObservationsByIds(ids) {
+  getObservationsByIds(ids, userId) {
     if (ids.length === 0)
       return [];
     const placeholders = ids.map(() => "?").join(",");
-    return this.db.query(`SELECT * FROM observations WHERE id IN (${placeholders}) ORDER BY created_at_epoch DESC`).all(...ids);
+    const visibilityClause = userId ? " AND (sensitivity != 'personal' OR user_id = ?)" : "";
+    return this.db.query(`SELECT * FROM observations
+         WHERE id IN (${placeholders})${visibilityClause}
+         ORDER BY created_at_epoch DESC`).all(...ids, ...userId ? [userId] : []);
   }
   getRecentObservations(projectId, sincEpoch, limit = 50) {
     return this.db.query(`SELECT * FROM observations
@@ -729,8 +826,9 @@ class MemDatabase {
         ORDER BY created_at_epoch DESC
         LIMIT ?`).all(projectId, sincEpoch, limit);
   }
-  searchFts(query, projectId, lifecycles = ["active", "aging", "pinned"], limit = 20) {
+  searchFts(query, projectId, lifecycles = ["active", "aging", "pinned"], limit = 20, userId) {
     const lifecyclePlaceholders = lifecycles.map(() => "?").join(",");
+    const visibilityClause = userId ? " AND (o.sensitivity != 'personal' OR o.user_id = ?)" : "";
     if (projectId !== null) {
       return this.db.query(`SELECT o.id, observations_fts.rank
           FROM observations_fts
@@ -738,33 +836,39 @@ class MemDatabase {
           WHERE observations_fts MATCH ?
             AND o.project_id = ?
             AND o.lifecycle IN (${lifecyclePlaceholders})
+            ${visibilityClause}
           ORDER BY observations_fts.rank
-          LIMIT ?`).all(query, projectId, ...lifecycles, limit);
+          LIMIT ?`).all(query, projectId, ...lifecycles, ...userId ? [userId] : [], limit);
     }
     return this.db.query(`SELECT o.id, observations_fts.rank
         FROM observations_fts
         JOIN observations o ON o.id = observations_fts.rowid
         WHERE observations_fts MATCH ?
           AND o.lifecycle IN (${lifecyclePlaceholders})
+          ${visibilityClause}
         ORDER BY observations_fts.rank
-        LIMIT ?`).all(query, ...lifecycles, limit);
+        LIMIT ?`).all(query, ...lifecycles, ...userId ? [userId] : [], limit);
   }
-  getTimeline(anchorId, projectId, depthBefore = 3, depthAfter = 3) {
-    const anchor = this.getObservationById(anchorId);
+  getTimeline(anchorId, projectId, depthBefore = 3, depthAfter = 3, userId) {
+    const visibilityClause = userId ? " AND (sensitivity != 'personal' OR user_id = ?)" : "";
+    const anchor = this.db.query(`SELECT * FROM observations WHERE id = ?${visibilityClause}`).get(anchorId, ...userId ? [userId] : []) ?? null;
     if (!anchor)
       return [];
     const projectFilter = projectId !== null ? "AND project_id = ?" : "";
     const projectParams = projectId !== null ? [projectId] : [];
+    const visibilityParams = userId ? [userId] : [];
     const before = this.db.query(`SELECT * FROM observations
         WHERE created_at_epoch < ? ${projectFilter}
           AND lifecycle IN ('active', 'aging', 'pinned')
+          ${visibilityClause}
         ORDER BY created_at_epoch DESC
-        LIMIT ?`).all(anchor.created_at_epoch, ...projectParams, depthBefore);
+        LIMIT ?`).all(anchor.created_at_epoch, ...projectParams, ...visibilityParams, depthBefore);
     const after = this.db.query(`SELECT * FROM observations
         WHERE created_at_epoch > ? ${projectFilter}
           AND lifecycle IN ('active', 'aging', 'pinned')
+          ${visibilityClause}
         ORDER BY created_at_epoch ASC
-        LIMIT ?`).all(anchor.created_at_epoch, ...projectParams, depthAfter);
+        LIMIT ?`).all(anchor.created_at_epoch, ...projectParams, ...visibilityParams, depthAfter);
     return [...before.reverse(), anchor, ...after];
   }
   pinObservation(id, pinned) {
@@ -878,11 +982,12 @@ class MemDatabase {
       return;
     this.db.query("DELETE FROM vec_observations WHERE observation_id = ?").run(observationId);
   }
-  searchVec(queryEmbedding, projectId, lifecycles = ["active", "aging", "pinned"], limit = 20) {
+  searchVec(queryEmbedding, projectId, lifecycles = ["active", "aging", "pinned"], limit = 20, userId) {
     if (!this.vecAvailable)
       return [];
     const lifecyclePlaceholders = lifecycles.map(() => "?").join(",");
     const embeddingBlob = new Uint8Array(queryEmbedding.buffer);
+    const visibilityClause = userId ? " AND (o.sensitivity != 'personal' OR o.user_id = ?)" : "";
     if (projectId !== null) {
       return this.db.query(`SELECT v.observation_id, v.distance
            FROM vec_observations v
@@ -891,7 +996,7 @@ class MemDatabase {
              AND k = ?
              AND o.project_id = ?
              AND o.lifecycle IN (${lifecyclePlaceholders})
-             AND o.superseded_by IS NULL`).all(embeddingBlob, limit, projectId, ...lifecycles);
+             AND o.superseded_by IS NULL` + visibilityClause).all(embeddingBlob, limit, projectId, ...lifecycles, ...userId ? [userId] : []);
     }
     return this.db.query(`SELECT v.observation_id, v.distance
          FROM vec_observations v
@@ -899,7 +1004,7 @@ class MemDatabase {
          WHERE v.embedding MATCH ?
            AND k = ?
            AND o.lifecycle IN (${lifecyclePlaceholders})
-           AND o.superseded_by IS NULL`).all(embeddingBlob, limit, ...lifecycles);
+           AND o.superseded_by IS NULL` + visibilityClause).all(embeddingBlob, limit, ...lifecycles, ...userId ? [userId] : []);
   }
   getUnembeddedCount() {
     if (!this.vecAvailable)
@@ -1018,98 +1123,58 @@ class MemDatabase {
   }
 }
 
-// src/capture/retrospective.ts
-function extractRetrospective(observations, sessionId, projectId, userId) {
-  if (observations.length === 0)
-    return null;
-  const request = extractRequest(observations);
-  const investigated = extractInvestigated(observations);
-  const learned = extractLearned(observations);
-  const completed = extractCompleted(observations);
-  const nextSteps = extractNextSteps(observations);
-  if (!request && !investigated && !learned && !completed && !nextSteps) {
-    return null;
+// src/hooks/common.ts
+var c = {
+  dim: "\x1B[2m",
+  yellow: "\x1B[33m",
+  reset: "\x1B[0m"
+};
+async function readStdin() {
+  const chunks = [];
+  for await (const chunk of process.stdin) {
+    chunks.push(typeof chunk === "string" ? chunk : Buffer.from(chunk).toString());
   }
-  return {
-    session_id: sessionId,
-    project_id: projectId,
-    user_id: userId,
-    request,
-    investigated,
-    learned,
-    completed,
-    next_steps: nextSteps
-  };
-}
-function extractRequest(observations) {
-  const first = observations[0];
-  if (!first)
-    return null;
-  return first.title;
+  return chunks.join("");
 }
-function extractInvestigated(observations) {
-  const discoveries = observations.filter((o) => o.type === "discovery");
-  if (discoveries.length === 0)
+async function parseStdinJson() {
+  const raw = await readStdin();
+  if (!raw.trim())
     return null;
-  return discoveries.slice(0, 5).map((o) => {
-    const facts = extractTopFacts(o, 2);
-    return facts ? `- ${o.title}
-${facts}` : `- ${o.title}`;
-  }).join(`
-`);
-}
-function extractLearned(observations) {
-  const learnTypes = new Set(["bugfix", "decision", "pattern"]);
-  const learned = observations.filter((o) => learnTypes.has(o.type));
-  if (learned.length === 0)
+  try {
+    return JSON.parse(raw);
+  } catch {
     return null;
-  return learned.slice(0, 5).map((o) => {
-    const facts = extractTopFacts(o, 2);
-    return facts ? `- ${o.title}
-${facts}` : `- ${o.title}`;
-  }).join(`
-`);
+  }
 }
-function extractCompleted(observations) {
-  const completeTypes = new Set(["change", "feature", "refactor"]);
-  const completed = observations.filter((o) => completeTypes.has(o.type));
-  if (completed.length === 0)
+function bootstrapHook(hookName) {
+  if (!configExists()) {
+    warnUser(hookName, "Engrm not configured. Run: npx engrm init");
     return null;
-  return completed.slice(0, 5).map((o) => {
-    const files = o.files_modified ? parseJsonArray(o.files_modified) : [];
-    const fileCtx = files.length > 0 ? ` (${files.slice(0, 2).map((f) => f.split("/").pop()).join(", ")})` : "";
-    return `- ${o.title}${fileCtx}`;
-  }).join(`
-`);
-}
-function extractNextSteps(observations) {
-  if (observations.length < 2)
+  }
+  let config;
+  try {
+    config = loadConfig();
+  } catch (err) {
+    warnUser(hookName, `Config error: ${err instanceof Error ? err.message : String(err)}`);
     return null;
-  const lastQuarterStart = Math.floor(observations.length * 0.75);
-  const lastQuarter = observations.slice(lastQuarterStart);
-  const unresolved = lastQuarter.filter((o) => o.type === "bugfix" && o.narrative && /error|fail|exception/i.test(o.narrative));
-  if (unresolved.length === 0)
+  }
+  let db;
+  try {
+    db = new MemDatabase(getDbPath());
+  } catch (err) {
+    warnUser(hookName, `Database error: ${err instanceof Error ? err.message : String(err)}`);
     return null;
-  return unresolved.map((o) => `- Investigate: ${o.title}`).slice(0, 3).join(`
-`);
+  }
+  return { config, db };
 }
-function extractTopFacts(obs, n) {
-  const facts = parseJsonArray(obs.facts);
-  if (facts.length === 0)
-    return null;
-  return facts.slice(0, n).map((f) => `    ${f}`).join(`
-`);
+function warnUser(hookName, message) {
+  console.error(`${c.yellow}engrm ${hookName}:${c.reset} ${c.dim}${message}${c.reset}`);
 }
-function parseJsonArray(json) {
-  if (!json)
-    return [];
-  try {
-    const parsed = JSON.parse(json);
-    if (Array.isArray(parsed)) {
-      return parsed.filter((f) => typeof f === "string" && f.length > 0);
-    }
-  } catch {}
-  return [];
+function runHook(hookName, fn) {
+  fn().catch((err) => {
+    warnUser(hookName, `Unexpected error: ${err instanceof Error ? err.message : String(err)}`);
+    process.exit(0);
+  });
 }
 
 // src/capture/risk-score.ts
@@ -1400,6 +1465,8 @@ function buildVectorDocument(obs, config, project) {
       files_modified: obs.files_modified ? JSON.parse(obs.files_modified) : [],
       session_id: obs.session_id,
       created_at_epoch: obs.created_at_epoch,
+      created_at: obs.created_at,
+      sensitivity: obs.sensitivity,
       local_id: obs.id
     }
   };
@@ -1689,7 +1756,24 @@ function detectStacks(filePaths) {
 }
 
 // src/telemetry/beacon.ts
-function buildBeacon(db, config, sessionId) {
+import { existsSync as existsSync2, readFileSync as readFileSync2 } from "node:fs";
+import { join as join3 } from "node:path";
+import { homedir as homedir2 } from "node:os";
+function readObserverState(sessionId) {
+  try {
+    const statePath = join3(homedir2(), ".engrm", "observer-sessions", `${sessionId}.json`);
+    if (!existsSync2(statePath))
+      return { eventCount: 0, saveCount: 0 };
+    const state = JSON.parse(readFileSync2(statePath, "utf-8"));
+    return {
+      eventCount: typeof state.eventCount === "number" ? state.eventCount : 0,
+      saveCount: typeof state.saveCount === "number" ? state.saveCount : 0
+    };
+  } catch {
+    return { eventCount: 0, saveCount: 0 };
+  }
+}
+function buildBeacon(db, config, sessionId, metrics) {
   const session = db.getSessionMetrics(sessionId);
   if (!session)
     return null;
@@ -1716,6 +1800,28 @@ function buildBeacon(db, config, sessionId) {
     const row = db.getSessionMetrics(sessionId);
     riskScore = typeof row?.risk_score === "number" ? row.risk_score : 0;
   } catch {}
+  let configHash;
+  let configChanged;
+  let configFingerprintDetail;
+  try {
+    const fpPath = join3(homedir2(), ".engrm", "config-fingerprint.json");
+    if (existsSync2(fpPath)) {
+      const fp = JSON.parse(readFileSync2(fpPath, "utf-8"));
+      configHash = fp.config_hash;
+      configChanged = fp.config_changed;
+      configFingerprintDetail = JSON.stringify({
+        claude_md_hash: fp.claude_md_hash,
+        memory_md_hash: fp.memory_md_hash,
+        engrm_json_hash: fp.engrm_json_hash,
+        memory_file_count: fp.memory_file_count,
+        client_version: fp.client_version
+      });
+    }
+  } catch {}
+  const observerState = readObserverState(sessionId);
+  const observerEvents = observerState.eventCount;
+  const observerObservations = observerState.saveCount;
+  const observerSkips = Math.max(0, observerEvents - observerObservations);
   return {
     device_id: config.device_id,
     agent: session.agent ?? "claude-code",
@@ -1725,13 +1831,22 @@ function buildBeacon(db, config, sessionId) {
     tool_calls_count: session.tool_calls_count ?? 0,
     files_touched_count: session.files_touched_count ?? 0,
     searches_performed: session.searches_performed ?? 0,
-    observer_events: 0,
-    observer_observations: 0,
-    observer_skips: 0,
+    observer_events: observerEvents,
+    observer_observations: observerObservations,
+    observer_skips: observerSkips,
     sentinel_used: false,
     risk_score: riskScore,
     stacks_detected: stacks,
-    client_version: "0.4.0"
+    client_version: "0.4.0",
+    context_observations_injected: metrics?.contextObsInjected ?? 0,
+    context_total_available: metrics?.contextTotalAvailable ?? 0,
+    recall_attempts: metrics?.recallAttempts ?? 0,
+    recall_hits: metrics?.recallHits ?? 0,
+    search_count: metrics?.searchCount ?? 0,
+    search_results_total: metrics?.searchResultsTotal ?? 0,
+    config_hash: configHash,
+    config_changed: configChanged,
+    config_fingerprint_detail: configFingerprintDetail
   };
 }
 async function sendBeacon(config, beacon) {
@@ -1753,8 +1868,8 @@ async function sendBeacon(config, beacon) {
 
 // src/storage/projects.ts
 import { execSync } from "node:child_process";
-import { existsSync as existsSync2, readFileSync as readFileSync2 } from "node:fs";
-import { basename as basename2, join as join3 } from "node:path";
+import { existsSync as existsSync3, readFileSync as readFileSync3 } from "node:fs";
+import { basename as basename2, join as join4 } from "node:path";
 function normaliseGitRemoteUrl(remoteUrl) {
   let url = remoteUrl.trim();
   url = url.replace(/^(?:https?|ssh|git):\/\//, "");
@@ -1809,11 +1924,11 @@ function getGitRemoteUrl(directory) {
   }
 }
 function readProjectConfigFile(directory) {
-  const configPath = join3(directory, ".engrm.json");
-  if (!existsSync2(configPath))
+  const configPath = join4(directory, ".engrm.json");
+  if (!existsSync3(configPath))
     return null;
   try {
-    const raw = readFileSync2(configPath, "utf-8");
+    const raw = readFileSync3(configPath, "utf-8");
     const parsed = JSON.parse(raw);
     if (typeof parsed["project_id"] !== "string" || !parsed["project_id"]) {
       return null;
@@ -1856,9 +1971,9 @@ function detectProject(directory) {
 }
 
 // src/capture/transcript.ts
-import { readFileSync as readFileSync3, existsSync as existsSync3 } from "node:fs";
-import { join as join4 } from "node:path";
-import { homedir as homedir2 } from "node:os";
+import { readFileSync as readFileSync4, existsSync as existsSync4 } from "node:fs";
+import { join as join5 } from "node:path";
+import { homedir as homedir3 } from "node:os";
 
 // src/tools/save.ts
 import { relative, isAbsolute } from "node:path";
@@ -2025,6 +2140,12 @@ function scoreQuality(input) {
     case "digest":
       score += 0.3;
       break;
+    case "standard":
+      score += 0.25;
+      break;
+    case "message":
+      score += 0.1;
+      break;
   }
   if (input.narrative && input.narrative.length > 50) {
     score += 0.15;
@@ -2182,9 +2303,9 @@ function mergeConceptsFromBoth(obs1, obs2) {
       try {
         const parsed = JSON.parse(obs.concepts);
         if (Array.isArray(parsed)) {
-          for (const c of parsed) {
-            if (typeof c === "string")
-              concepts.add(c);
+          for (const c2 of parsed) {
+            if (typeof c2 === "string")
+              concepts.add(c2);
           }
         }
       } catch {}
@@ -2428,17 +2549,19 @@ function toRelativePath(filePath, projectRoot) {
 }
 
 // src/capture/transcript.ts
-function resolveTranscriptPath(sessionId, cwd) {
+function resolveTranscriptPath(sessionId, cwd, transcriptPath) {
+  if (transcriptPath)
+    return transcriptPath;
   const encodedCwd = cwd.replace(/\//g, "-");
-  return join4(homedir2(), ".claude", "projects", encodedCwd, `${sessionId}.jsonl`);
+  return join5(homedir3(), ".claude", "projects", encodedCwd, `${sessionId}.jsonl`);
 }
-function readTranscript(sessionId, cwd) {
-  const path = resolveTranscriptPath(sessionId, cwd);
-  if (!existsSync3(path))
+function readTranscript(sessionId, cwd, transcriptPath) {
+  const path = resolveTranscriptPath(sessionId, cwd, transcriptPath);
+  if (!existsSync4(path))
     return [];
   let raw;
   try {
-    raw = readFileSync3(path, "utf-8");
+    raw = readFileSync4(path, "utf-8");
   } catch {
     return [];
   }
@@ -2586,31 +2709,15 @@ function printRetrospective(summary) {
 `));
 }
 async function main() {
-  const chunks = [];
-  for await (const chunk of process.stdin) {
-    chunks.push(typeof chunk === "string" ? chunk : Buffer.from(chunk).toString());
-  }
-  const raw = chunks.join("");
-  if (!raw.trim())
-    process.exit(0);
-  let event;
-  try {
-    event = JSON.parse(raw);
-  } catch {
+  const event = await parseStdinJson();
+  if (!event)
     process.exit(0);
-  }
   if (event.stop_hook_active)
     process.exit(0);
-  if (!configExists())
-    process.exit(0);
-  let config;
-  let db;
-  try {
-    config = loadConfig();
-    db = new MemDatabase(getDbPath());
-  } catch {
+  const boot = bootstrapHook("stop");
+  if (!boot)
     process.exit(0);
-  }
+  const { config, db } = boot;
   try {
     if (event.session_id) {
       db.completeSession(event.session_id);
@@ -2662,7 +2769,7 @@ async function main() {
     }
     if (config.transcript_analysis?.enabled && event.session_id) {
       try {
-        const messages = readTranscript(event.session_id, event.cwd);
+        const messages = readTranscript(event.session_id, event.cwd, event.transcript_path);
         if (messages.length > 10) {
           const transcript = truncateTranscript(messages);
           const results = await analyzeTranscript(config, transcript, event.session_id);
@@ -2679,7 +2786,8 @@ async function main() {
     await pushOnce(db, config);
     try {
       if (event.session_id) {
-        const beacon = buildBeacon(db, config, event.session_id);
+        const metrics = readSessionMetrics(event.session_id);
+        const beacon = buildBeacon(db, config, event.session_id, metrics);
         if (beacon) {
           await sendBeacon(config, beacon);
         }
@@ -2751,9 +2859,9 @@ ${bullets}`);
       try {
         const parsed = JSON.parse(obs.concepts);
         if (Array.isArray(parsed)) {
-          for (const c of parsed) {
-            if (typeof c === "string" && c.length > 0)
-              allConcepts.add(c);
+          for (const c2 of parsed) {
+            if (typeof c2 === "string" && c2.length > 0)
+              allConcepts.add(c2);
           }
         }
       } catch {}
@@ -2803,6 +2911,53 @@ function detectUnsavedPlans(message) {
   }
   return hints;
 }
-main().catch(() => {
-  process.exit(0);
-});
+function readSessionMetrics(sessionId) {
+  const { existsSync: existsSync5, readFileSync: readFileSync5, unlinkSync } = __require("node:fs");
+  const { join: join6 } = __require("node:path");
+  const { homedir: homedir4 } = __require("node:os");
+  const result = {};
+  try {
+    const obsPath = join6(homedir4(), ".engrm", "observer-sessions", `${sessionId}.json`);
+    if (existsSync5(obsPath)) {
+      const state = JSON.parse(readFileSync5(obsPath, "utf-8"));
+      if (typeof state.recallAttempts === "number")
+        result.recallAttempts = state.recallAttempts;
+      if (typeof state.recallHits === "number")
+        result.recallHits = state.recallHits;
+    }
+  } catch {}
+  try {
+    const hookPath = join6(homedir4(), ".engrm", "hook-session-metrics.json");
+    if (existsSync5(hookPath)) {
+      const hookMetrics = JSON.parse(readFileSync5(hookPath, "utf-8"));
+      if (typeof hookMetrics.contextObsInjected === "number")
+        result.contextObsInjected = hookMetrics.contextObsInjected;
+      if (typeof hookMetrics.contextTotalAvailable === "number")
+        result.contextTotalAvailable = hookMetrics.contextTotalAvailable;
+      try {
+        unlinkSync(hookPath);
+      } catch {}
+    }
+  } catch {}
+  try {
+    const mcpPath = join6(homedir4(), ".engrm", "mcp-session-metrics.json");
+    if (existsSync5(mcpPath)) {
+      const metrics = JSON.parse(readFileSync5(mcpPath, "utf-8"));
+      if (typeof metrics.contextObsInjected === "number" && metrics.contextObsInjected > 0) {
+        result.contextObsInjected = metrics.contextObsInjected;
+      }
+      if (typeof metrics.contextTotalAvailable === "number" && metrics.contextTotalAvailable > 0) {
+        result.contextTotalAvailable = metrics.contextTotalAvailable;
+      }
+      if (typeof metrics.searchCount === "number")
+        result.searchCount = metrics.searchCount;
+      if (typeof metrics.searchResultsTotal === "number")
+        result.searchResultsTotal = metrics.searchResultsTotal;
+      try {
+        unlinkSync(mcpPath);
+      } catch {}
+    }
+  } catch {}
+  return result;
+}
+runHook("stop", main);