@orquentra/codebuddy 2.8.0 → 2.14.0

package/dist/{main-QUASSFP7.js → main-SFC5LV4E.js}

@@ -1,10 +1,16 @@
 import {
-  renderLeanBlock,
-  runLeanHookCommand
-} from "./chunk-UK6XTS2Y.js";
+  isDockerDaemonRunning,
+  tryStartDockerDesktop,
+  waitForDockerDaemon
+} from "./chunk-5UH3BEQR.js";
+import {
+  postgresDown,
+  postgresStatus,
+  postgresUp
+} from "./chunk-CSRD5OQA.js";
 import {
   runPreToolHookCommand
-} from "./chunk-EJQVGFH2.js";
+} from "./chunk-UOTKHSQ5.js";
 import {
   failSoft,
   readHookInput,
@@ -13,6 +19,7 @@ import {
 import {
   WORKFLOW_CLIENTS,
   clientDisplayName,
+  clientHookCapabilities,
   clientHooksInstalled,
   defaultRulesMode,
   detectClient,
@@ -29,10 +36,12 @@ import {
   removeCodexEntry,
   renderManagedBlock,
   renderWorkflowTemplate,
+  runBridgeHook,
+  runCodexHook,
   setHooks,
   uninstallClient,
   writeProjectMcpConfig
-} from "./chunk-J4T6HHI4.js";
+} from "./chunk-L6BRYZ6G.js";
 import {
   AUTOMATION_MODES,
   CLIENT_ADAPTERS,
@@ -42,19 +51,14 @@ import {
   parseClient,
   parseMode,
   supportedModes
-} from "./chunk-W7GAXL6C.js";
-import {
-  isDockerDaemonRunning,
-  tryStartDockerDesktop,
-  waitForDockerDaemon
-} from "./chunk-5UH3BEQR.js";
+} from "./chunk-V7PT6ER5.js";
 import {
-  postgresDown,
-  postgresStatus,
-  postgresUp
-} from "./chunk-CSRD5OQA.js";
+  renderLeanBlock,
+  runLeanHook
+} from "./chunk-LRQNPYCK.js";
 import {
   TELEMETRY_NOTICE,
+  findReuse,
   flushTelemetry,
   generateSuggestions,
   migrateMemoryToFiles,
@@ -65,15 +69,17 @@ import {
   telemetryBlocked,
   telemetryStatePath,
   telemetryUrl,
+  traceCliCommand,
   watchRepository,
   writeTelemetryState
-} from "./chunk-6DONJW3W.js";
+} from "./chunk-YJPCS2GP.js";
 import {
   DEFAULT_ZVEC_MODEL,
   buildZvecIndex,
   zvecStatus
-} from "./chunk-GXOML4UZ.js";
+} from "./chunk-LW75SKZR.js";
 import {
+  HookStagingStore,
   PlanFileStore,
   PlanLifecycle,
   ReviewStore,
@@ -82,28 +88,40 @@ import {
   assessRisk,
   buildBeforeEditContext,
   buildBootstrapContext,
+  findCodexRollouts,
+  forgetJournal,
+  importCodexRollout,
+  journalLag,
+  latestUnfinished,
+  listJournals,
   openHookSemantics,
+  readCheckpoint,
+  renderCheckpointNow,
   renderContextBlock,
   resolveRiskPaths,
   runCaptureHook,
+  runCheckpointHook,
   runContextHook,
   runResetHook,
+  runResumeHook,
   runStageHook,
-  runSyncHook
-} from "./chunk-ZNLSCV3J.js";
-import {
-  SessionCapsuleLedger,
-  detectTestCommand,
-  estimateTokens
-} from "./chunk-GKNYMNFM.js";
+  runSyncHook,
+  syncReuseVectors
+} from "./chunk-XSNW6Y3X.js";
 import {
   parseTraceLines,
   readTraces,
   tracePath
-} from "./chunk-XL2HLACE.js";
+} from "./chunk-YN7TEIUH.js";
+import {
+  SessionCapsuleLedger,
+  detectTestCommand,
+  estimateTokens
+} from "./chunk-4DKYKDHI.js";
 import {
   hookRoot
 } from "./chunk-TGFTKWOR.js";
+import "./chunk-GQKWUHMA.js";
 import "./chunk-DFV2SK6C.js";
 import {
   bootstrapDatabase,
@@ -116,11 +134,11 @@ import {
   pingDatabase,
   runDoctor,
   runMigrations
-} from "./chunk-NY2YXP3R.js";
+} from "./chunk-YWDH6DQ6.js";
 import {
   MemoryFileStore,
   VERSION
-} from "./chunk-6KGYAFG7.js";
+} from "./chunk-7QMHIJBA.js";
 import {
   computeFactHash,
   generateEntityId
@@ -133,25 +151,24 @@ import {
 import {
   loadLlmSummaries,
   summarizeRepository
-} from "./chunk-6NZEZJYD.js";
+} from "./chunk-ESC4Y3L7.js";
 import {
   chatJson,
   coolingDown,
   usageToday
 } from "./chunk-ESZXCZIN.js";
-import {
-  generateGraphifyGraph,
-  loadGraphifyMap,
-  setupGraphify,
-  syncFileVectors
-} from "./chunk-TLWGZVPC.js";
 import {
   buildArchitectureMap,
+  generateGraphifyGraph,
   indexRepository,
   loadFreshIndex,
+  loadGraphifyMap,
+  loadProjectArchitectureMap,
   neighbours,
-  queryMap
-} from "./chunk-ITQO632W.js";
+  queryMap,
+  setupGraphify,
+  syncFileVectors
+} from "./chunk-YNSTIMCF.js";
 import {
   extractSymbolTable,
   supportsSymbols
@@ -186,12 +203,14 @@ import {
   setZvecEnabled,
   writeConfigFile
 } from "./chunk-KNR2P2UY.js";
-import "./chunk-CG5B3LYG.js";
+import {
+  writeAtomic
+} from "./chunk-CG5B3LYG.js";
 import "./chunk-PZ5AY32C.js";
 
 // src/cli/main.ts
 import { Command } from "commander";
-import pc23 from "picocolors";
+import pc25 from "picocolors";
 
 // src/integrations/github.ts
 import { constants } from "fs";
@@ -769,6 +788,7 @@ var CONFORMANCE = {
     const servers = json(result.stdout);
     if (!Array.isArray(servers)) return [fail("mcp", "codex mcp list --json returned no JSON")];
     return [
+      await clientHooksInstalled(root, "codex") ? pass("hooks", ".codex/hooks.json is installed; review trust in Codex /hooks") : skip("hooks", "not installed in this repo"),
       servers.some((server) => server.name === name2) ? pass("mcp", `codex mcp list has ${name2}`) : skip("mcp", `no ${name2} entry (clients install codex --global adds it)`)
     ];
   },
@@ -862,7 +882,7 @@ function registerClientsCommands(program, runSafely2) {
       console.log(pc2.dim("Per-turn token cost per client: codebuddy clients cost"));
     });
   });
-  clients.command("install").argument("<client>", `One of: ${CLIENT_IDS.join(", ")}.`).requiredOption("--mode <mode>", `One of: ${AUTOMATION_MODES.join(", ")}.`).option("--namespace <name>", "Namespace for the MCP entry (defaults to config/folder).").option("--global", "Also add the MCP entry to the global config (Codex, Hermes).").description("Apply one automation mode: rules block, hooks, and MCP config.").action(
+  clients.command("install").argument("<client>", `One of: ${CLIENT_IDS.join(", ")}.`).requiredOption("--mode <mode>", `One of: ${AUTOMATION_MODES.join(", ")}.`).option("--namespace <name>", "Namespace for the MCP entry (defaults to config/folder).").option("--global", "Also add the MCP entry to the global config (Codex, Hermes).").option("--capture", "Capture turns into memory even in lean mode (Claude Code).").option("--no-capture", "Inject context without capturing turns (Claude Code).").description("Apply one automation mode: rules block, hooks, and MCP config.").action(
     async (client, opts) => {
       await runSafely2(async () => {
         const mode = parseMode(opts.mode);
@@ -870,7 +890,8 @@ function registerClientsCommands(program, runSafely2) {
           client: parseClient(client),
           mode,
           ...opts.namespace ? { namespace: opts.namespace } : {},
-          ...opts.global ? { global: true } : {}
+          ...opts.global ? { global: true } : {},
+          ...opts.capture !== void 0 ? { capture: opts.capture } : {}
         });
         printReport2(report, `${MODE_LABELS[mode]} mode`);
       });
@@ -982,6 +1003,30 @@ function registerContextCommands(program, runSafely2) {
       printBootstrap(result);
     });
   });
+  context.command("reuse").argument("<task...>", "What you are about to implement.").option("--json", "Print machine-readable JSON.").description(
+    "Existing helpers to reuse for a task: signature, a call site and the covering test."
+  ).action(async (taskParts, opts) => {
+    await runSafely2(async () => {
+      const root = process.cwd();
+      const { manifest } = await loadFreshIndex(root);
+      const picks = await findReuse(
+        root,
+        taskParts.join(" "),
+        manifest,
+        await loadProjectArchitectureMap(root, manifest)
+      );
+      if (opts.json) {
+        console.log(JSON.stringify(picks, null, 2));
+        return;
+      }
+      if (picks.length === 0) console.log(pc3.dim("no existing helper clearly matches"));
+      for (const pick of picks) {
+        console.log(`${pick.path}:${pick.startLine}-${pick.endLine}  ${pick.signature}`);
+        if (pick.usage) console.log(pc3.dim(`  used at ${pick.usage}`));
+        if (pick.test) console.log(pc3.dim(`  test ${pick.test}`));
+      }
+    });
+  });
   context.command("preview").argument("[task...]", "The task you are about to work on.").option("--paths <paths>", "Comma-separated repo-relative paths to target.").option("--plan <id>", "Resolve target files from a CodeBuddy plan.").option("--git", "Resolve target files from current git changes.").option("--json", "Print machine-readable JSON.").description("Show the context CodeBuddy would assemble before editing the given files.").action(
     async (taskParts, opts) => {
       await runSafely2(async () => {
@@ -1199,7 +1244,7 @@ th.n { text-align: right; }
 .chip { display: inline-block; font: 600 10px var(--mono); text-transform: uppercase; letter-spacing: .06em; padding: 2px 6px; border-radius: 4px; }
 .chip.recall { background: var(--recall-soft); color: var(--recall); }
 .chip.tool { background: var(--tool-soft); color: var(--tool); }
-.chip.capture, .chip.sync, .chip.guard, .chip.kw { background: var(--line); color: var(--capture); }
+.chip.capture, .chip.sync, .chip.guard, .chip.cli, .chip.kw { background: var(--line); color: var(--capture); }
 .chip.err { background: var(--bad-soft); color: var(--bad); }
 .feed { display: grid; gap: 10px; max-height: 520px; overflow: auto; }
 .prompt { border: 1px solid var(--line); border-radius: 8px; padding: 10px 12px; }
@@ -1719,15 +1764,22 @@ function registerGitHubCommands(program, runSafely2) {
 import { execFile as execFile2, spawn as spawn3 } from "child_process";
 import { relative as relative2 } from "path";
 import pc7 from "picocolors";
+
+// src/hooks/lean-command.ts
+async function runLeanHookCommand() {
+  await failSoft(async () => {
+    await runLeanHook(await readHookInput(), writeStdout);
+  });
+}
+
+// src/cli/commands/hooks.ts
 function registerHooksCommands(program, runSafely2) {
   const hooks = program.command("hooks").description("Enforce automatic recall/capture via client lifecycle hooks.");
   hooks.command("install").option(
     "--client <client>",
-    "Client with a CodeBuddy hook adapter (claude, opencode, hermes).",
+    "Client with a CodeBuddy hook adapter (claude, codex, opencode, hermes).",
     "claude"
-  ).description(
-    "Add CodeBuddy's recall/capture hooks (.claude/settings.json, .opencode/plugins/codebuddy.js or .hermes/plugins/codebuddy/)."
-  ).action(async (opts) => {
+  ).description("Add CodeBuddy's recall/capture hooks for the selected client.").action(async (opts) => {
     await runSafely2(async () => {
       const client = assertHookClient(opts.client);
       const step = await setHooks(process.cwd(), true, client);
@@ -1749,7 +1801,7 @@ function registerHooksCommands(program, runSafely2) {
   });
   hooks.command("uninstall").option(
     "--client <client>",
-    "Client with a CodeBuddy hook adapter (claude, opencode, hermes).",
+    "Client with a CodeBuddy hook adapter (claude, codex, opencode, hermes).",
     "claude"
   ).description("Remove CodeBuddy's hooks for a client (user hooks untouched).").action(async (opts) => {
     await runSafely2(async () => {
@@ -1763,14 +1815,43 @@ function registerHooksCommands(program, runSafely2) {
   });
   hooks.command("status").option(
     "--client <client>",
-    "Client with a CodeBuddy hook adapter (claude, opencode, hermes).",
+    "Client with a CodeBuddy hook adapter (claude, codex, opencode, hermes).",
     "claude"
-  ).description("Report whether CodeBuddy hooks are installed.").action(async (opts) => {
+  ).description("Report which CodeBuddy hooks are installed and what they do.").action(async (opts) => {
     await runSafely2(async () => {
-      const installed = await clientHooksInstalled(process.cwd(), parseClient(opts.client));
+      const caps = await clientHookCapabilities(process.cwd(), parseClient(opts.client));
+      if (!caps?.injection) {
+        console.log(pc7.dim("CodeBuddy hooks: not installed"));
+        return;
+      }
+      console.log(pc7.green("CodeBuddy hooks: installed"));
+      console.log(`  injection: ${caps.injection}`);
+      console.log(
+        `  capture: ${caps.capture ? "on (edits staged, turn end captured)" : "off (turns are not captured into memory)"}`
+      );
       console.log(
-        installed ? pc7.green("CodeBuddy hooks: installed") : pc7.dim("CodeBuddy hooks: not installed")
+        `  recovery: ${caps.recovery ? "on (pre-compaction checkpoint, unfinished-task resume)" : "off"}`
       );
+      console.log(`  compaction reset: ${caps.reset ? "on" : "off"}`);
+      console.log(`  read guard: ${caps.guard ? "on" : "off"}`);
+    });
+  });
+  hooks.command("codex").option("--injection <mode>", "full or lean", "full").option("--capture", "Capture visible lifecycle events", false).description("[hook] Native Codex event adapter (JSON output, no permission changes).").action(async (opts) => {
+    let result = {};
+    await failSoft(async () => {
+      if (opts.injection !== "full" && opts.injection !== "lean")
+        throw new Error("injection must be full or lean");
+      result = await runCodexHook(
+        await readHookInput(),
+        opts.injection,
+        opts.capture
+      );
+    });
+    await writeStdout(JSON.stringify(result));
+  });
+  hooks.command("bridge").description("[hook] Capture normalized host events and restore checkpoint context.").action(async () => {
+    await failSoft(async () => {
+      await runBridgeHook(await readHookInput(), writeStdout);
     });
   });
   hooks.command("context").description("[hook] Emit compact project context for injection at prompt submit.").action(async () => {
@@ -1823,6 +1904,16 @@ function registerHooksCommands(program, runSafely2) {
       await runResetHook(await readHookInput(), writeStdout);
     });
   });
+  hooks.command("checkpoint").description("[hook] Journal the transcript before compaction (PreCompact).").action(async () => {
+    await failSoft(async () => {
+      await runCheckpointHook(await readHookInput());
+    });
+  });
+  hooks.command("resume").description("[hook] Print another session's unfinished task checkpoint, if any.").action(async () => {
+    await failSoft(async () => {
+      await runResumeHook(await readHookInput(), writeStdout);
+    });
+  });
 }
 function assertHookClient(value) {
   const client = parseClient(value);
@@ -2009,9 +2100,21 @@ function registerIndexCommands(program, runSafely2) {
     await runSafely2(async () => {
       const result = await indexRepository({ ...opts.full ? { full: true } : {} });
       const local = opts.vectors && (await loadRuntimeConfig(process.cwd(), { requireDatabase: false }).catch(() => null))?.provider.type === "local";
+      const vectorStarted = Date.now();
       const vectors = local ? await syncFileVectors(process.cwd(), VECTOR_BUDGET_MS) : null;
+      const reuseVectors = local ? await syncReuseVectors(process.cwd(), VECTOR_BUDGET_MS - (Date.now() - vectorStarted)) : null;
       if (opts.json) {
-        console.log(JSON.stringify({ ...result, ...vectors ? { vectors } : {} }, null, 2));
+        console.log(
+          JSON.stringify(
+            {
+              ...result,
+              ...vectors ? { vectors } : {},
+              ...reuseVectors ? { reuseVectors } : {}
+            },
+            null,
+            2
+          )
+        );
         return;
       }
       printResult(result);
@@ -2201,8 +2304,59 @@ async function runInitWizard() {
   }
 }
 
-// src/cli/commands/learn.ts
+// src/cli/commands/journal.ts
 import pc10 from "picocolors";
+function registerJournalCommands(program, runSafely2) {
+  const journal = program.command("journal").description("Inspect or delete session journals and active-task checkpoints.");
+  journal.command("list", { isDefault: true }).description("List sessions with a checkpoint, newest first.").action(async () => {
+    await runSafely2(async () => {
+      const sessions = await listJournals(process.cwd());
+      if (sessions.length === 0) console.log(pc10.dim("no session journals yet"));
+      for (const { session, updatedAt } of sessions) console.log(`${updatedAt}  ${session}`);
+    });
+  });
+  journal.command("show").argument("<session>").description("Print a session's active-task checkpoint as JSON.").action(async (session) => {
+    await runSafely2(async () => {
+      const checkpoint = await readCheckpoint(process.cwd(), session);
+      console.log(checkpoint ? JSON.stringify(checkpoint, null, 2) : pc10.dim("no checkpoint"));
+    });
+  });
+  journal.command("resume").description("Print the newest unfinished task checkpoint (any session or agent).").action(async () => {
+    await runSafely2(async () => {
+      const checkpoint = await latestUnfinished(process.cwd(), void 0);
+      console.log(
+        checkpoint ? await renderCheckpointNow(
+          process.cwd(),
+          checkpoint,
+          `unfinished, from session ${checkpoint.session}`
+        ) : pc10.dim("no unfinished task in the last 3 days")
+      );
+    });
+  });
+  journal.command("import-codex").option("--all", "Import every Codex rollout for this repository, not only the newest.").description("Journal Codex rollouts (~/.codex/sessions) whose working directory is this repo.").action(async (opts) => {
+    await runSafely2(async () => {
+      const rollouts = await findCodexRollouts(process.cwd());
+      if (rollouts.length === 0) {
+        console.log(pc10.dim("no Codex rollout for this repository"));
+        return;
+      }
+      for (const rollout of opts.all ? rollouts : rollouts.slice(0, 1)) {
+        const result = await importCodexRollout(process.cwd(), rollout);
+        console.log(`codex-${rollout.id}: ${result ? `${result.added} new events` : "busy"}`);
+      }
+    });
+  });
+  journal.command("forget").argument("[session]").option("--all", "Delete every session's journal.").description("Delete a session's journal, cursor and checkpoint.").action(async (session, opts) => {
+    await runSafely2(async () => {
+      if (!session && !opts.all) throw new Error("Name a session or pass --all.");
+      await forgetJournal(process.cwd(), opts.all ? void 0 : session);
+      console.log(pc10.yellow(opts.all ? "deleted all session journals" : `deleted ${session}`));
+    });
+  });
+}
+
+// src/cli/commands/learn.ts
+import pc11 from "picocolors";
 
 // src/learning/outcomes.ts
 async function recordChangeOutcome(input) {
@@ -2263,15 +2417,15 @@ function registerLearnCommand(program, runSafely2) {
           ...opts.commit ? { commit: opts.commit } : {},
           ...opts.plan ? { planId: opts.plan } : {}
         });
-        console.log(`${pc10.green("recorded")} ${result.id} (${result.category})`);
-        console.log(pc10.dim(result.path));
+        console.log(`${pc11.green("recorded")} ${result.id} (${result.category})`);
+        console.log(pc11.dim(result.path));
       });
     }
   );
 }
 
 // src/cli/commands/map.ts
-import pc11 from "picocolors";
+import pc12 from "picocolors";
 function registerMapCommands(program, runSafely2) {
   const map = program.command("map").description("Query the lightweight architecture map.");
   map.command("build").description("Scan the current repository and summarize the module graph.").action(async () => {
@@ -2291,7 +2445,7 @@ function registerMapCommands(program, runSafely2) {
         return;
       }
       if (edges.length === 0) {
-        console.log(pc11.dim("no dependencies found"));
+        console.log(pc12.dim("no dependencies found"));
         return;
       }
       for (const edge of edges) console.log(`${edge.from} -> ${edge.to}`);
@@ -2306,7 +2460,7 @@ function registerMapCommands(program, runSafely2) {
         return;
       }
       if (result.edges.length === 0) {
-        console.log(pc11.dim("no dependents found"));
+        console.log(pc12.dim("no dependents found"));
         return;
       }
       for (const edge of result.edges) console.log(`${edge.from} -> ${edge.to}`);
@@ -2317,7 +2471,7 @@ function registerMapCommands(program, runSafely2) {
 // src/cli/commands/memory-review.ts
 import { spawn as spawn4 } from "child_process";
 import { relative as relative3 } from "path";
-import pc12 from "picocolors";
+import pc13 from "picocolors";
 function registerMemoryCommands(program, runSafely2) {
   const memory = program.command("memory").description("Inspect and curate CodeBuddy memory.");
   const review = memory.command("review").description("Review memory candidates captured automatically after turns.");
@@ -2329,11 +2483,11 @@ function registerMemoryCommands(program, runSafely2) {
         return;
       }
       if (items.length === 0) {
-        console.log(pc12.dim("no pending review items"));
+        console.log(pc13.dim("no pending review items"));
         return;
       }
       for (const item of items) console.log(renderRow(item));
-      console.log(pc12.dim(`
+      console.log(pc13.dim(`
 ${items.length} pending. approve <id> | reject <id> | show <id>`));
     });
   });
@@ -2347,7 +2501,7 @@ ${items.length} pending. approve <id> | reject <id> | show <id>`));
       const factId = await approveReviewItem(id, {
         ...opts.incident !== void 0 ? { incidentId: opts.incident } : {}
       });
-      console.log(`${pc12.green("approved")} ${id} \u2192 ${factId}`);
+      console.log(`${pc13.green("approved")} ${id} \u2192 ${factId}`);
     });
   });
   review.command("reject").argument("<id>").description("Discard a review candidate without saving it.").action(async (id) => {
@@ -2355,7 +2509,7 @@ ${items.length} pending. approve <id> | reject <id> | show <id>`));
       const store = new ReviewStore();
       await store.read(id);
       await store.delete(id);
-      console.log(`${pc12.yellow("rejected")} ${id}`);
+      console.log(`${pc13.yellow("rejected")} ${id}`);
     });
   });
   review.command("edit").argument("<id>").description("Open a review candidate in $EDITOR and re-validate on save.").action(async (id) => {
@@ -2364,44 +2518,44 @@ ${items.length} pending. approve <id> | reject <id> | show <id>`));
       const item = await store.read(id);
       await openEditor(item.path);
       await store.read(id);
-      console.log(pc12.dim("saved and validated"));
+      console.log(pc13.dim("saved and validated"));
     });
   });
 }
 function renderRow(item) {
-  const flag = item.sensitive ? pc12.red(" \u26A0 sensitive") : "";
-  return `${classColor(item.class)}  ${pc12.dim(item.id)}  ${truncate(item.content, 70)}${flag}`;
+  const flag = item.sensitive ? pc13.red(" \u26A0 sensitive") : "";
+  return `${classColor(item.class)}  ${pc13.dim(item.id)}  ${truncate(item.content, 70)}${flag}`;
 }
 function renderItem(item) {
   const lines = [
-    `${classColor(item.class)}  ${pc12.dim(item.id)}`,
-    `${pc12.bold("reason:")} ${item.reason}`,
-    `${pc12.bold("confidence:")} ${item.confidence.toFixed(2)}`,
-    `${pc12.bold("triple:")} ${item.subject} \xB7 ${item.predicate} \xB7 ${item.object}`
+    `${classColor(item.class)}  ${pc13.dim(item.id)}`,
+    `${pc13.bold("reason:")} ${item.reason}`,
+    `${pc13.bold("confidence:")} ${item.confidence.toFixed(2)}`,
+    `${pc13.bold("triple:")} ${item.subject} \xB7 ${item.predicate} \xB7 ${item.object}`
   ];
-  if (item.paths.length > 0) lines.push(`${pc12.bold("paths:")} ${item.paths.join(", ")}`);
-  if (item.severity) lines.push(`${pc12.bold("severity:")} ${item.severity}`);
+  if (item.paths.length > 0) lines.push(`${pc13.bold("paths:")} ${item.paths.join(", ")}`);
+  if (item.severity) lines.push(`${pc13.bold("severity:")} ${item.severity}`);
   if (item.resolvesIncidents) {
     lines.push(
-      `${pc12.bold("resolves:")} ${item.resolvesIncidents.join(", ") || "(no candidate; approve with --incident <id>)"}`
+      `${pc13.bold("resolves:")} ${item.resolvesIncidents.join(", ") || "(no candidate; approve with --incident <id>)"}`
     );
   }
-  if (item.sensitive) lines.push(pc12.red(`\u26A0 sensitive: ${item.sensitiveReasons.join(", ")}`));
-  lines.push("", item.content, "", pc12.dim(relative3(process.cwd(), item.path)));
+  if (item.sensitive) lines.push(pc13.red(`\u26A0 sensitive: ${item.sensitiveReasons.join(", ")}`));
+  lines.push("", item.content, "", pc13.dim(relative3(process.cwd(), item.path)));
   return lines.join("\n");
 }
 function classColor(memoryClass) {
   switch (memoryClass) {
     case "incident":
-      return pc12.red(memoryClass);
+      return pc13.red(memoryClass);
     case "decision":
-      return pc12.cyan(memoryClass);
+      return pc13.cyan(memoryClass);
     case "fact":
-      return pc12.green(memoryClass);
+      return pc13.green(memoryClass);
     case "note":
-      return pc12.yellow(memoryClass);
+      return pc13.yellow(memoryClass);
     default:
-      return pc12.dim(memoryClass);
+      return pc13.dim(memoryClass);
   }
 }
 function truncate(value, max) {
@@ -2421,7 +2575,7 @@ function openEditor(path) {
 import { existsSync } from "fs";
 import { join as join5 } from "path";
 import { spinner as spinner2 } from "@clack/prompts";
-import pc13 from "picocolors";
+import pc14 from "picocolors";
 
 // evals/fact-relevance.json
 var fact_relevance_default = {
@@ -2685,9 +2839,9 @@ async function calibrateEmbedder(embed) {
 var EMBEDDERS = ["local", "huggingface", "openrouter"];
 var RERANKERS = ["off", "local", "huggingface", "openrouter"];
 var KEY_ENV2 = { huggingface: "HF_TOKEN", openrouter: "OPENROUTER_API_KEY" };
-var ok = (text3) => `${pc13.green("\u2713")} ${text3}`;
-var warn = (text3) => `${pc13.yellow("!")} ${text3}`;
-var row = (label, value) => `  ${pc13.dim(label.padEnd(11))}${value}`;
+var ok = (text3) => `${pc14.green("\u2713")} ${text3}`;
+var warn = (text3) => `${pc14.yellow("!")} ${text3}`;
+var row = (label, value) => `  ${pc14.dim(label.padEnd(11))}${value}`;
 async function withSpinner(label, work, done) {
   const progress = spinner2();
   progress.start(label);
@@ -2696,7 +2850,7 @@ async function withSpinner(label, work, done) {
     progress.stop(done(value));
     return value;
   } catch (error) {
-    progress.error(pc13.red(`\u2717 ${label}`));
+    progress.error(pc14.red(`\u2717 ${label}`));
     throw error;
   }
 }
@@ -2735,8 +2889,8 @@ async function printStatus() {
   const model = provider.type === "local" ? LOCAL_EMBEDDING_MODEL.id : provider.model ?? DEFAULT_CLOUD_EMBEDDING_MODELS[provider.type];
   const floor = provider.relevanceFloor ?? getModelDefinition(model)?.relevanceFloor;
   const next = [];
-  console.log(pc13.bold("Embeddings"));
-  console.log(row("provider", `${provider.type}  ${pc13.dim(model)}`));
+  console.log(pc14.bold("Embeddings"));
+  console.log(row("provider", `${provider.type}  ${pc14.dim(model)}`));
   if (provider.type === "local" && !localRuntimeInstalled()) {
     console.log(
       row("runtime", warn("@huggingface/transformers is not installed: dense recall is off"))
@@ -2747,7 +2901,7 @@ async function printStatus() {
     console.log(
       row(
         "model",
-        ready ? ok(`downloaded ${pc13.dim(modelCacheDir())}`) : warn("not downloaded yet (~90 MB)")
+        ready ? ok(`downloaded ${pc14.dim(modelCacheDir())}`) : warn("not downloaded yet (~90 MB)")
       )
     );
     if (!ready) next.push("codebuddy models pull");
@@ -2764,21 +2918,21 @@ async function printStatus() {
   console.log(
     row(
       "floor",
-      floor !== void 0 ? `${floor} ${pc13.dim(provider.relevanceFloor !== void 0 ? "(calibrated for this project)" : "(built-in)")}` : warn("not calibrated: dense recall is off for this model")
+      floor !== void 0 ? `${floor} ${pc14.dim(provider.relevanceFloor !== void 0 ? "(calibrated for this project)" : "(built-in)")}` : warn("not calibrated: dense recall is off for this model")
     )
   );
   if (floor === void 0) next.push("codebuddy models calibrate");
   const rerank = file.rerank?.provider ?? "off";
-  console.log(pc13.bold("Reranker"));
+  console.log(pc14.bold("Reranker"));
   if (rerank === "off") {
     console.log(
-      row("provider", `off ${pc13.dim("(default: no reranker beat dense order in evals)")}`)
+      row("provider", `off ${pc14.dim("(default: no reranker beat dense order in evals)")}`)
     );
   } else {
     console.log(
       row(
         "provider",
-        `${rerank}  ${pc13.dim(file.rerank?.model ?? DEFAULT_RERANK_MODELS[rerank].id)}`
+        `${rerank}  ${pc14.dim(file.rerank?.model ?? DEFAULT_RERANK_MODELS[rerank].id)}`
       )
     );
     if (rerank !== "local") {
@@ -2791,7 +2945,7 @@ async function printStatus() {
       );
     }
   }
-  console.log(pc13.bold("Memory index"));
+  console.log(pc14.bold("Memory index"));
   if (process.env.CODEBUDDY_SEMANTIC === "0") {
     console.log(row("recall", warn("CODEBUDDY_SEMANTIC=0: lexical only")));
   }
@@ -2812,7 +2966,7 @@ async function printStatus() {
       console.log(
         row(
           "vectors",
-          `${counts.ready} ready` + (counts.pending ? `, ${counts.pending} pending` : "") + (counts.failed ? pc13.red(`, ${counts.failed} failed`) : "") + (counts.other ? pc13.yellow(`, ${counts.other} from another model`) : "")
+          `${counts.ready} ready` + (counts.pending ? `, ${counts.pending} pending` : "") + (counts.failed ? pc14.red(`, ${counts.failed} failed`) : "") + (counts.other ? pc14.yellow(`, ${counts.other} from another model`) : "")
         )
       );
       if (counts.pending || counts.other)
@@ -2821,9 +2975,9 @@ async function printStatus() {
   }
   console.log(
     next.length > 0 ? `
-${pc13.bold("Next")}
-${next.map((step) => `  ${pc13.cyan(step)}`).join("\n")}` : `
-${ok("Semantic recall is ready.")} ${pc13.dim('Try: codebuddy context preview "<task>"')}`
+${pc14.bold("Next")}
+${next.map((step) => `  ${pc14.cyan(step)}`).join("\n")}` : `
+${ok("Semantic recall is ready.")} ${pc14.dim('Try: codebuddy context preview "<task>"')}`
   );
 }
 function registerModelsCommands(program, runSafely2) {
@@ -2860,27 +3014,27 @@ Examples:
         ...opts.floor !== void 0 ? { relevanceFloor: opts.floor } : {}
       });
       const model = type === "local" ? LOCAL_EMBEDDING_MODEL.id : opts.model ?? DEFAULT_CLOUD_EMBEDDING_MODELS[type];
-      console.log(ok(`Embeddings: ${type} ${pc13.dim(model)}`));
+      console.log(ok(`Embeddings: ${type} ${pc14.dim(model)}`));
       const missingKey = type !== "local" && !keyPresent(type, current?.apiKey);
       if (missingKey) {
         console.log(
           warn(
-            `Set ${KEY_ENV2[type]} in your shell (keys are never stored in config), then run ${pc13.cyan("codebuddy hooks sync")}.`
+            `Set ${KEY_ENV2[type]} in your shell (keys are never stored in config), then run ${pc14.cyan("codebuddy hooks sync")}.`
           )
         );
-        console.log(pc13.dim("  Existing vectors keep working until the new model can embed."));
+        console.log(pc14.dim("  Existing vectors keep working until the new model can embed."));
       }
       if (opts.floor === void 0 && getModelDefinition(model)?.relevanceFloor === void 0) {
         console.log(
           warn(
-            `No floor for ${model} yet: run ${pc13.cyan("codebuddy models calibrate")} to turn on dense recall.`
+            `No floor for ${model} yet: run ${pc14.cyan("codebuddy models calibrate")} to turn on dense recall.`
           )
         );
       }
       if (!missingKey) {
         syncInBackground(process.cwd(), true);
         console.log(
-          pc13.dim("  Re-embedding existing memory in the background (codebuddy hooks sync).")
+          pc14.dim("  Re-embedding existing memory in the background (codebuddy hooks sync).")
         );
       }
     });
@@ -2907,13 +3061,13 @@ before keeping one on. A reranker never admits a fact, it only orders them.`
       }
       const reranker = choice;
       console.log(
-        ok(`Reranker: ${reranker} ${pc13.dim(opts.model ?? DEFAULT_RERANK_MODELS[reranker].id)}`)
+        ok(`Reranker: ${reranker} ${pc14.dim(opts.model ?? DEFAULT_RERANK_MODELS[reranker].id)}`)
       );
       if (reranker !== "local" && !keyPresent(reranker, (await readConfigFile()).provider?.apiKey)) {
         console.log(warn(`Set ${KEY_ENV2[reranker]}; without it reranking is skipped.`));
       }
       if (reranker === "local")
-        console.log(pc13.dim("  Run codebuddy models pull to download it now."));
+        console.log(pc14.dim("  Run codebuddy models pull to download it now."));
     });
   });
   models.command("pull").description("Download the local models now instead of on first use.").action(async () => {
@@ -2924,7 +3078,7 @@ before keeping one on. A reranker never admits a fact, it only orders them.`
       await withSpinner(
         `Downloading ${LOCAL_EMBEDDING_MODEL.id}`,
         () => new LocalModelProvider().embed({ input: "warm up" }),
-        () => ok(`${LOCAL_EMBEDDING_MODEL.id} ready ${pc13.dim(`${Date.now() - started} ms`)}`)
+        () => ok(`${LOCAL_EMBEDDING_MODEL.id} ready ${pc14.dim(`${Date.now() - started} ms`)}`)
       );
       if (file.rerank?.provider === "local") {
         const id = file.rerank.model ?? DEFAULT_RERANK_MODELS.local.id;
@@ -2933,10 +3087,10 @@ before keeping one on. A reranker never admits a fact, it only orders them.`
         await withSpinner(
           `Downloading ${id}`,
           () => rerankLocally({ id, ...revision ? { revision } : {} }, "warm", ["up"]),
-          () => ok(`${id} ready ${pc13.dim(`${Date.now() - started} ms`)}`)
+          () => ok(`${id} ready ${pc14.dim(`${Date.now() - started} ms`)}`)
         );
       }
-      console.log(pc13.dim(`  Cache: ${modelCacheDir()}`));
+      console.log(pc14.dim(`  Cache: ${modelCacheDir()}`));
     });
   });
   models.command("calibrate").option("--dry-run", "Measure only; do not save the floor.").description(
@@ -2954,19 +3108,19 @@ before keeping one on. A reranker never admits a fact, it only orders them.`
       console.log(
         row(
           "ranking",
-          `AUC ${result.auc.toFixed(3)} \xB7 right fact first ${pct(result.recallAt1)} ${pc13.dim("(held-out tasks)")}`
+          `AUC ${result.auc.toFixed(3)} \xB7 right fact first ${pct(result.recallAt1)} ${pc14.dim("(held-out tasks)")}`
         )
       );
       console.log(
         row(
           "floor",
-          `${result.best.floor}: precision ${pct(result.test.precision)}, recall ${pct(result.test.recall)}, silent on ${pct(result.test.abstain)} of unrelated tasks ${pc13.dim("(chosen on dev, measured on test)")}`
+          `${result.best.floor}: precision ${pct(result.test.precision)}, recall ${pct(result.test.recall)}, silent on ${pct(result.test.abstain)} of unrelated tasks ${pc14.dim("(chosen on dev, measured on test)")}`
         )
       );
       console.log(
         row(
           "recall floor",
-          `${result.recall.dev.floor}: precision ${pct(result.recall.test.precision)}, recall ${pct(result.recall.test.recall)} ` + pc13.dim("(explicit recall: best F2 on dev, measured on test)")
+          `${result.recall.dev.floor}: precision ${pct(result.recall.test.precision)}, recall ${pct(result.recall.test.recall)} ` + pc14.dim("(explicit recall: best F2 on dev, measured on test)")
         )
       );
       if (opts.dryRun) return;
@@ -2985,10 +3139,238 @@ before keeping one on. A reranker never admits a fact, it only orders them.`
   });
 }
 
-// src/cli/commands/plan.ts
+// src/cli/commands/output.ts
 import { spawn as spawn5 } from "child_process";
+import { constants as constants2 } from "os";
+import pc15 from "picocolors";
+
+// src/output/reduce.ts
+import { createHash } from "crypto";
+import { mkdir as mkdir2, readdir, readFile as readFile3, rm as rm2 } from "fs/promises";
+import { join as join6 } from "path";
+var OUTPUT_LIMITS = {
+  /** At or below either, output is never reduced. */
+  minLines: 80,
+  minBytes: 6e3,
+  head: 20,
+  tail: 30,
+  contextBefore: 2,
+  contextAfter: 4,
+  /** A reduction must save at least this share, or the original is printed. */
+  minSaving: 0.3,
+  /** Stored bytes per run; beyond this the stored copy says it was cut. */
+  storeBytes: 2e7,
+  retentionDays: 7,
+  /** Lines one `output show` may print. */
+  showLines: 400
+};
+var SIGNAL = /\b(error|errors|fail|failed|failure|failing|exception|traceback|panic|fatal|assert(?:ion)?|warn(?:ing)?|denied|not found|undefined|segfault|timeout|timed out)\b|✗|×|✖|FAIL|ERR!/i;
+function outputDir(root) {
+  return join6(root, ".codebuddy", "cache", "outputs");
+}
+var shape = (line) => line.replace(/\d+/g, "#").trim();
+function reduceOutput(text3, id) {
+  const lines = text3.split("\n");
+  if (lines.length <= OUTPUT_LIMITS.minLines || Buffer.byteLength(text3) <= OUTPUT_LIMITS.minBytes) {
+    return null;
+  }
+  if (text3.includes("\0")) return null;
+  const keep = /* @__PURE__ */ new Set();
+  for (let i = 0; i < Math.min(OUTPUT_LIMITS.head, lines.length); i++) keep.add(i);
+  for (let i = Math.max(0, lines.length - OUTPUT_LIMITS.tail); i < lines.length; i++) keep.add(i);
+  lines.forEach((line, index2) => {
+    if (!SIGNAL.test(line)) return;
+    const from = Math.max(0, index2 - OUTPUT_LIMITS.contextBefore);
+    const to = Math.min(lines.length - 1, index2 + OUTPUT_LIMITS.contextAfter);
+    for (let i = from; i <= to; i++) keep.add(i);
+  });
+  const out = [];
+  let index = 0;
+  while (index < lines.length) {
+    if (!keep.has(index)) {
+      const start = index;
+      while (index < lines.length && !keep.has(index)) index++;
+      out.push(
+        `\u2026 ${index - start} lines omitted (codebuddy output show ${id} --range ${start + 1}:${index})`
+      );
+      continue;
+    }
+    const line = lines[index];
+    const same = SIGNAL.test(line) ? (other) => other === line : (other) => shape(other) === shape(line);
+    let run = index + 1;
+    while (run < lines.length && keep.has(run) && same(lines[run])) run++;
+    out.push(line);
+    if (run - index > 2) {
+      out.push(
+        `\u2026 ${run - index - 1} similar lines (codebuddy output show ${id} --range ${index + 2}:${run})`
+      );
+      index = run;
+    } else index++;
+  }
+  const reduced = out.join("\n");
+  return Buffer.byteLength(reduced) <= Buffer.byteLength(text3) * (1 - OUTPUT_LIMITS.minSaving) ? reduced : null;
+}
+async function storeOutput(root, command, output, exitCode, now = /* @__PURE__ */ new Date()) {
+  const truncated = Buffer.byteLength(output) > OUTPUT_LIMITS.storeBytes;
+  const body = truncated ? `${output.slice(0, OUTPUT_LIMITS.storeBytes)}
+[codebuddy: stored copy cut at ${OUTPUT_LIMITS.storeBytes} bytes]` : output;
+  const id = createHash("sha256").update(`${command}\0${now.toISOString()}\0${body}`).digest("hex").slice(0, 12);
+  const meta = {
+    id,
+    command,
+    exitCode,
+    createdAt: now.toISOString(),
+    expiresAt: new Date(now.getTime() + OUTPUT_LIMITS.retentionDays * 864e5).toISOString(),
+    lines: body.split("\n").length,
+    bytes: Buffer.byteLength(body),
+    truncated
+  };
+  const dir = outputDir(root);
+  await mkdir2(dir, { recursive: true, mode: 448 });
+  await writeAtomic(join6(dir, `${id}.log`), body, { mode: 384 });
+  await writeAtomic(join6(dir, `${id}.json`), `${JSON.stringify(meta)}
+`, { mode: 384 });
+  await pruneOutputs(root, now).catch(() => void 0);
+  return meta;
+}
+async function pruneOutputs(root, now = /* @__PURE__ */ new Date()) {
+  const dir = outputDir(root);
+  let removed = 0;
+  for (const name2 of (await readdir(dir).catch(() => [])).filter(
+    (n) => n.endsWith(".json")
+  )) {
+    const meta = await readMeta(root, name2.slice(0, -5));
+    if (meta && Date.parse(meta.expiresAt) <= now.getTime()) {
+      await rm2(join6(dir, `${meta.id}.log`), { force: true });
+      await rm2(join6(dir, name2), { force: true });
+      removed++;
+    }
+  }
+  return removed;
+}
+async function readMeta(root, id) {
+  if (!/^[a-f0-9]{12}$/.test(id)) return null;
+  try {
+    return JSON.parse(await readFile3(join6(outputDir(root), `${id}.json`), "utf8"));
+  } catch {
+    return null;
+  }
+}
+async function showOutput(root, id, options = {}) {
+  const meta = await readMeta(root, id);
+  if (!meta) return { status: "missing", id };
+  if (Date.parse(meta.expiresAt) <= (options.now ?? /* @__PURE__ */ new Date()).getTime()) {
+    return { status: "expired", id };
+  }
+  const body = await readFile3(join6(outputDir(root), `${id}.log`), "utf8").catch(() => null);
+  if (body === null) return { status: "missing", id };
+  const lines = body.split("\n");
+  let picked;
+  if (options.grep) {
+    const pattern = new RegExp(options.grep, "i");
+    const set = /* @__PURE__ */ new Set();
+    lines.forEach((line, index) => {
+      if (!pattern.test(line)) return;
+      for (let i = Math.max(0, index - 2); i <= Math.min(lines.length - 1, index + 2); i++)
+        set.add(i);
+    });
+    picked = [...set].sort((a, b) => a - b);
+  } else {
+    const [from, to] = options.range ?? [1, lines.length];
+    picked = [];
+    for (let i = Math.max(1, from); i <= Math.min(lines.length, to); i++) picked.push(i - 1);
+  }
+  const shown = picked.slice(0, OUTPUT_LIMITS.showLines);
+  return {
+    status: "ok",
+    meta,
+    text: shown.map((i) => `${i + 1}: ${lines[i]}`).join("\n"),
+    more: picked.length > shown.length
+  };
+}
+async function listOutputs(root) {
+  const names = await readdir(outputDir(root)).catch(() => []);
+  const metas = await Promise.all(
+    names.filter((n) => n.endsWith(".json")).map((n) => readMeta(root, n.slice(0, -5)))
+  );
+  return metas.filter((meta) => meta !== null).sort((a, b) => b.createdAt.localeCompare(a.createdAt));
+}
+
+// src/cli/commands/output.ts
+function registerOutputCommands(program, runSafely2) {
+  program.command("run").argument("<command...>", "The command and its arguments (after --).").description(
+    "Run a command; print a reduced view of long output and keep the original for `codebuddy output show`."
+  ).action(async (parts) => {
+    await runSafely2(async () => {
+      const command = parts.join(" ");
+      const { output: output2, exitCode } = await capture(parts);
+      const root = process.cwd();
+      const provisional = reduceOutput(output2, "xxxxxxxxxxxx");
+      if (provisional === null) {
+        process.stdout.write(output2);
+      } else {
+        const stored = await storeOutput(root, command, output2, exitCode);
+        const reduced = reduceOutput(output2, stored.id) ?? output2;
+        process.stdout.write(`${reduced}
+`);
+        process.stdout.write(
+          `[codebuddy run: exit ${exitCode ?? "signal"}; ${stored.lines} lines shown as ${reduced.split("\n").length}; full output: codebuddy output show ${stored.id} [--grep RE | --range A:B], kept until ${stored.expiresAt.slice(0, 10)}]
+`
+        );
+      }
+      process.exitCode = exitCode ?? 1;
+    });
+  });
+  const output = program.command("output").description("Stored originals of `codebuddy run` output.");
+  output.command("list", { isDefault: true }).description("List stored outputs, newest first.").action(async () => {
+    await runSafely2(async () => {
+      const stored = await listOutputs(process.cwd());
+      if (stored.length === 0) console.log(pc15.dim("no stored outputs"));
+      for (const meta of stored) {
+        console.log(
+          `${meta.id}  exit ${meta.exitCode ?? "-"}  ${meta.lines} lines  until ${meta.expiresAt.slice(0, 10)}  ${meta.command.slice(0, 80)}`
+        );
+      }
+    });
+  });
+  output.command("show").argument("<id>").option("--range <a:b>", "1-based inclusive line range.").option("--grep <pattern>", "Lines matching a regular expression, with 2 lines of context.").description("Print exact stored lines (at most 400 per call).").action(async (id, opts) => {
+    await runSafely2(async () => {
+      const range = opts.range?.match(/^(\d+):(\d+)$/);
+      if (opts.range && !range) throw new Error("--range must look like 120:180");
+      const result = await showOutput(process.cwd(), id, {
+        ...range ? { range: [Number(range[1]), Number(range[2])] } : {},
+        ...opts.grep ? { grep: opts.grep } : {}
+      });
+      if (result.status !== "ok") {
+        throw new Error(`stored output ${id} is ${result.status}`);
+      }
+      console.log(result.text);
+      if (result.more) console.log(pc15.dim("\u2026 more lines; narrow --range or --grep"));
+    });
+  });
+}
+function capture(parts) {
+  return new Promise((resolve6, reject) => {
+    const [file, ...args] = parts;
+    const child = parts.length === 1 ? spawn5(file, { shell: true, stdio: ["inherit", "pipe", "pipe"] }) : spawn5(file, args, { stdio: ["inherit", "pipe", "pipe"] });
+    const chunks = [];
+    child.stdout.on("data", (chunk) => chunks.push(chunk));
+    child.stderr.on("data", (chunk) => chunks.push(chunk));
+    child.on("error", reject);
+    child.on(
+      "close",
+      (code, signal) => resolve6({
+        output: Buffer.concat(chunks).toString("utf8"),
+        exitCode: code ?? (signal ? 128 + (constants2.signals[signal] ?? 0) : null)
+      })
+    );
+  });
+}
+
+// src/cli/commands/plan.ts
+import { spawn as spawn6 } from "child_process";
 import { relative as relative4 } from "path";
-import pc14 from "picocolors";
+import pc16 from "picocolors";
 function makeLifecycle(cwd = process.cwd()) {
   const store = new PlanFileStore(cwd);
   return { store, lifecycle: new PlanLifecycle(store) };
@@ -2996,67 +3378,67 @@ function makeLifecycle(cwd = process.cwd()) {
 function statusColor(status) {
   switch (status) {
     case "draft":
-      return pc14.dim(status);
+      return pc16.dim(status);
     case "approved":
-      return pc14.cyan(status);
+      return pc16.cyan(status);
     case "executing":
-      return pc14.yellow(status);
+      return pc16.yellow(status);
     case "complete":
-      return pc14.green(status);
+      return pc16.green(status);
     case "abandoned":
-      return pc14.red(status);
+      return pc16.red(status);
   }
 }
 function renderPlan(plan) {
   const lines = [];
-  lines.push(`${pc14.bold(plan.title)}  ${statusColor(plan.status)}`);
-  lines.push(pc14.dim(plan.id));
+  lines.push(`${pc16.bold(plan.title)}  ${statusColor(plan.status)}`);
+  lines.push(pc16.dim(plan.id));
   lines.push("");
-  lines.push(`${pc14.bold("Brief:")} ${plan.brief}`);
+  lines.push(`${pc16.bold("Brief:")} ${plan.brief}`);
   if (plan.filesToTouch.length > 0) {
     lines.push("");
-    lines.push(pc14.bold("Files to touch:"));
+    lines.push(pc16.bold("Files to touch:"));
     for (const file of plan.filesToTouch) {
       lines.push(`  ${file.action.padEnd(6)} ${file.path}${file.notes ? `  \u2014 ${file.notes}` : ""}`);
     }
   }
   if (plan.testsToAdd.length > 0) {
     lines.push("");
-    lines.push(pc14.bold("Tests to add:"));
+    lines.push(pc16.bold("Tests to add:"));
     for (const test of plan.testsToAdd) {
       lines.push(`  ${test.path}${test.description ? `  \u2014 ${test.description}` : ""}`);
     }
   }
   if (plan.outOfScope.length > 0) {
     lines.push("");
-    lines.push(pc14.bold("Out of scope:"));
+    lines.push(pc16.bold("Out of scope:"));
     for (const item of plan.outOfScope) lines.push(`  - ${item}`);
   }
   if (plan.risks.length > 0) {
     lines.push("");
-    lines.push(pc14.bold("Risks:"));
+    lines.push(pc16.bold("Risks:"));
     for (const item of plan.risks) lines.push(`  - ${item}`);
   }
   if (plan.commitSha) {
     lines.push("");
-    lines.push(`${pc14.bold("Commit:")} ${plan.commitSha}`);
+    lines.push(`${pc16.bold("Commit:")} ${plan.commitSha}`);
   }
   lines.push("");
-  lines.push(pc14.dim("\u2500".repeat(40)));
+  lines.push(pc16.dim("\u2500".repeat(40)));
   lines.push(plan.body);
   return lines.join("\n");
 }
 function openEditor2(path) {
   const editor = process.env.EDITOR ?? process.env.VISUAL ?? "vi";
   return new Promise((resolve6, reject) => {
-    const child = spawn5(editor, [path], { stdio: "inherit" });
+    const child = spawn6(editor, [path], { stdio: "inherit" });
     child.on("error", reject);
     child.on("close", () => resolve6());
   });
 }
 function runGit(args) {
   return new Promise((resolve6, reject) => {
-    const child = spawn5("git", args, { stdio: ["ignore", "pipe", "pipe"] });
+    const child = spawn6("git", args, { stdio: ["ignore", "pipe", "pipe"] });
     let stdout = "";
     let stderr = "";
     child.stdout.on("data", (c) => {
@@ -3081,14 +3463,14 @@ function registerPlanCommands(program, runSafely2) {
         title: opts.title ?? brief,
         brief
       });
-      console.log(`${pc14.green("created")} ${created.id} (${statusColor(created.status)})`);
+      console.log(`${pc16.green("created")} ${created.id} (${statusColor(created.status)})`);
       if (opts.edit !== false && process.stdin.isTTY) {
         await openEditor2(created.path);
         const { store } = makeLifecycle();
         await store.readPlan(created.id);
-        console.log(pc14.dim("saved and validated"));
+        console.log(pc16.dim("saved and validated"));
       }
-      console.log(pc14.dim(relative4(process.cwd(), created.path)));
+      console.log(pc16.dim(relative4(process.cwd(), created.path)));
     });
   });
   plan.command("list").option("--status <status>", "Filter by status.").option("--all", "Include completed and abandoned plans.").description("List plans in the current namespace.").action(async (opts) => {
@@ -3100,11 +3482,11 @@ function registerPlanCommands(program, runSafely2) {
       else if (!opts.all)
         plans = plans.filter((p) => p.status !== "complete" && p.status !== "abandoned");
       if (plans.length === 0) {
-        console.log(pc14.dim("no plans"));
+        console.log(pc16.dim("no plans"));
         return;
       }
       for (const p of plans) {
-        console.log(`${statusColor(p.status).padEnd(20)} ${pc14.bold(p.title)}  ${pc14.dim(p.id)}`);
+        console.log(`${statusColor(p.status).padEnd(20)} ${pc16.bold(p.title)}  ${pc16.dim(p.id)}`);
       }
     });
   });
@@ -3120,7 +3502,7 @@ function registerPlanCommands(program, runSafely2) {
       const existing = await store.readPlan(id);
       await openEditor2(existing.path);
       await store.readPlan(id);
-      console.log(pc14.dim("saved and validated"));
+      console.log(pc16.dim("saved and validated"));
     });
   });
   plan.command("approve").argument("<id>").description("Promote a draft to approved (one active plan per namespace).").action(async (id) => {
@@ -3144,7 +3526,7 @@ function registerPlanCommands(program, runSafely2) {
         ...opts.commit ? { commitSha: opts.commit } : {},
         ...opts.notes ? { notes: opts.notes } : {}
       });
-      if (!opts.commit) console.log(pc14.yellow("note: no --commit supplied"));
+      if (!opts.commit) console.log(pc16.yellow("note: no --commit supplied"));
       console.log(`${next.id} \u2192 ${statusColor(next.status)}`);
     });
   });
@@ -3163,7 +3545,7 @@ function registerPlanCommands(program, runSafely2) {
       const args = ["diff", opts.from, ...opts.to ? [opts.to] : [], "--", relPath];
       const result = await runGit(args);
       if (result.stdout.trim().length === 0) {
-        console.log(pc14.dim("no changes"));
+        console.log(pc16.dim("no changes"));
       } else {
         process.stdout.write(result.stdout);
       }
@@ -3180,13 +3562,13 @@ function registerPlanCommands(program, runSafely2) {
         throw new Error(`Invalid policy "${mode}". Use one of: ${PLAN_POLICIES.join(", ")}.`);
       }
       await setPlanPolicy(mode);
-      console.log(`${pc14.green("plan policy")} = ${mode}`);
+      console.log(`${pc16.green("plan policy")} = ${mode}`);
     });
   });
 }
 
 // src/cli/commands/risk.ts
-import pc15 from "picocolors";
+import pc17 from "picocolors";
 function registerRiskCommands(program, runSafely2) {
   const risk = program.command("risk").description("Assess evidence-backed change risk.");
   risk.command("assess").option("--plan <id>", "Assess paths listed in a CodeBuddy plan.").option("--paths <paths>", "Comma-separated repo-relative paths to assess.").option("--git", "Assess staged, unstaged, and untracked git changes.").option("--limit <n>", "Maximum risk items to show.", Number).option("--json", "Print machine-readable JSON.").option("--explain", "Show evidence for each risk item.").description("Assess risk for a plan, explicit paths, or current git changes.").action(
@@ -3214,31 +3596,31 @@ function parsePaths3(value) {
 }
 function printAssessment(assessment, explain) {
   if (assessment.items.length === 0) {
-    console.log(pc15.dim("no risk evidence found"));
+    console.log(pc17.dim("no risk evidence found"));
     return;
   }
   for (const item of assessment.items) {
     console.log(
-      `${pc15.bold(item.path)}  score ${scoreColor2(item.score)}  category ${pc15.cyan(item.category)}`
+      `${pc17.bold(item.path)}  score ${scoreColor2(item.score)}  category ${pc17.cyan(item.category)}`
     );
     console.log(`  ${item.reason}`);
     if (explain) {
       for (const evidence of item.evidence) console.log(`  \u21B3 ${formatEvidence(evidence)}`);
     } else {
-      console.log(pc15.dim(`  ${item.evidence.length} evidence item(s)`));
+      console.log(pc17.dim(`  ${item.evidence.length} evidence item(s)`));
     }
   }
   console.log(
-    pc15.dim(
+    pc17.dim(
       `
 ${assessment.stats.itemsProduced} item(s), ${assessment.stats.signalsRun} signal(s), ${assessment.stats.pathsConsidered} path(s) considered`
     )
   );
 }
 function scoreColor2(score) {
-  if (score >= 75) return pc15.red(String(score));
-  if (score >= 50) return pc15.yellow(String(score));
-  return pc15.green(String(score));
+  if (score >= 75) return pc17.red(String(score));
+  if (score >= 50) return pc17.yellow(String(score));
+  return pc17.green(String(score));
 }
 function formatEvidence(evidence) {
   switch (evidence.kind) {
@@ -3260,7 +3642,7 @@ function truncate2(value, max) {
 
 // src/cli/commands/rules.ts
 import { relative as relative5 } from "path";
-import pc16 from "picocolors";
+import pc18 from "picocolors";
 async function resolveMode(client, value) {
   if (value) {
     const mode = parseMode(value);
@@ -3300,7 +3682,7 @@ function registerRulesCommands(program, runSafely2) {
         `${actionLabel(result.action)} ${clientDisplayName(client)} workflow in ${where}`
       );
       if (result.action !== "unchanged") {
-        console.log(pc16.dim("  managed block between codebuddy:workflow markers; safe to re-run"));
+        console.log(pc18.dim("  managed block between codebuddy:workflow markers; safe to re-run"));
       }
     });
   });
@@ -3308,20 +3690,20 @@ function registerRulesCommands(program, runSafely2) {
 function actionLabel(action) {
   switch (action) {
     case "created":
-      return pc16.green("created");
+      return pc18.green("created");
     case "added":
-      return pc16.green("added");
+      return pc18.green("added");
     case "updated":
-      return pc16.cyan("updated");
+      return pc18.cyan("updated");
     case "removed":
-      return pc16.yellow("removed");
+      return pc18.yellow("removed");
     default:
-      return pc16.dim("unchanged");
+      return pc18.dim("unchanged");
   }
 }
 
 // src/cli/commands/suggest.ts
-import pc17 from "picocolors";
+import pc19 from "picocolors";
 function parsePaths4(value) {
   return value.split(",").map((path) => path.trim()).filter(Boolean);
 }
@@ -3343,7 +3725,7 @@ function registerSuggestCommand(program, runSafely2) {
         }
         printSuggestions(result.suggestions);
         console.log(
-          pc17.dim(
+          pc19.dim(
             `
 ${result.stats.produced} suggestion(s) across ${result.stats.pathsConsidered} path(s)`
           )
@@ -3354,72 +3736,72 @@ ${result.stats.produced} suggestion(s) across ${result.stats.pathsConsidered} pa
 }
 function printSuggestions(suggestions) {
   if (suggestions.length === 0) {
-    console.log(pc17.dim("no suggestions \u2014 nothing high-signal to report"));
+    console.log(pc19.dim("no suggestions \u2014 nothing high-signal to report"));
     return;
   }
   for (const suggestion of suggestions) {
-    console.log(`${severityBadge2(suggestion.severity)} ${pc17.bold(suggestion.title)}`);
+    console.log(`${severityBadge2(suggestion.severity)} ${pc19.bold(suggestion.title)}`);
     console.log(`  ${suggestion.detail}`);
     for (const evidence of suggestion.evidence) {
-      console.log(pc17.dim(`  \u21B3 ${evidence.kind}: ${evidence.detail}`));
+      console.log(pc19.dim(`  \u21B3 ${evidence.kind}: ${evidence.detail}`));
     }
-    if (suggestion.commandHint) console.log(pc17.dim(`  \u2192 ${suggestion.commandHint}`));
+    if (suggestion.commandHint) console.log(pc19.dim(`  \u2192 ${suggestion.commandHint}`));
   }
 }
 function severityBadge2(severity) {
   switch (severity) {
     case "high":
-      return pc17.red("[high]");
+      return pc19.red("[high]");
     case "medium":
-      return pc17.yellow("[med ]");
+      return pc19.yellow("[med ]");
     case "low":
-      return pc17.cyan("[low ]");
+      return pc19.cyan("[low ]");
     default:
-      return pc17.dim("[info]");
+      return pc19.dim("[info]");
   }
 }
 
 // src/cli/commands/symbols.ts
-import { readFile as readFile3 } from "fs/promises";
+import { readFile as readFile4 } from "fs/promises";
 import { resolve as resolve5 } from "path";
-import pc18 from "picocolors";
+import pc20 from "picocolors";
 function registerSymbolsCommand(program, runSafely2) {
   program.command("symbols").argument("<path>", "Repo-relative or absolute path to a code file.").option("--json", "Print machine-readable JSON.").description("List a file's top-level symbols (functions, classes, types, exports).").action(async (path, opts) => {
     await runSafely2(async () => {
       if (!supportsSymbols(path)) {
-        console.log(pc18.dim(`no symbol extraction for ${path} (unsupported language)`));
+        console.log(pc20.dim(`no symbol extraction for ${path} (unsupported language)`));
         return;
       }
-      const content = await readFile3(resolve5(path), "utf8");
+      const content = await readFile4(resolve5(path), "utf8");
       const table = extractSymbolTable(content, path);
       if (opts.json) {
         console.log(JSON.stringify({ path, symbols: table }, null, 2));
         return;
       }
       if (table.length === 0) {
-        console.log(pc18.dim("no top-level symbols found"));
+        console.log(pc20.dim("no top-level symbols found"));
         return;
       }
       for (const symbol of table) {
-        const badge = symbol.exported ? pc18.green("export") : pc18.dim("local ");
+        const badge = symbol.exported ? pc20.green("export") : pc20.dim("local ");
         console.log(
-          `${badge} ${pc18.cyan(symbol.kind.padEnd(9))} ${pc18.bold(symbol.name)} ${pc18.dim(`L${symbol.startLine}-${symbol.endLine}`)}`
+          `${badge} ${pc20.cyan(symbol.kind.padEnd(9))} ${pc20.bold(symbol.name)} ${pc20.dim(`L${symbol.startLine}-${symbol.endLine}`)}`
         );
       }
-      console.log(pc18.dim(`
+      console.log(pc20.dim(`
 ${table.length} symbol(s)`));
     });
   });
 }
 
 // src/cli/commands/telemetry.ts
-import pc19 from "picocolors";
+import pc21 from "picocolors";
 
 // src/telemetry/collector.ts
-import { createHash, timingSafeEqual } from "crypto";
-import { appendFile, mkdir as mkdir2, readdir, readFile as readFile4 } from "fs/promises";
+import { createHash as createHash2, timingSafeEqual } from "crypto";
+import { appendFile, mkdir as mkdir3, readdir as readdir2, readFile as readFile5 } from "fs/promises";
 import { createServer as createServer2 } from "http";
-import { join as join6 } from "path";
+import { join as join7 } from "path";
 import { z as z2 } from "zod";
 
 // src/telemetry/admin-page.ts
@@ -3431,101 +3813,174 @@ var ADMIN_HTML = `<!doctype html>
 <title>CodeBuddy Usage</title>
 <style>
 :root {
-  --bg: #f4f4f2; --panel: #fcfcfb; --fg: #0b0b0b; --muted: #52514e; --line: #e2e1dc;
-  --bar: #2a78d6; --bar-soft: #e3edfa; --bad: #b42318;
+  --bg: #f4f4f2; --panel: #fcfcfb; --fg: #0b0b0b; --muted: #52514e; --faint: #8a8984; --line: #e4e3de;
+  --bar: #2a78d6; --bar-soft: #e3edfa; --hook: #eb6834; --cli: #1baf7a;
+  --good: #0a7d0a; --bad: #c23030; --bad-soft: #fbeaea;
   --sans: ui-sans-serif, -apple-system, "Segoe UI", Roboto, sans-serif;
   --mono: ui-monospace, "SF Mono", Menlo, Consolas, monospace;
 }
 @media (prefers-color-scheme: dark) { :root {
-  --bg: #121211; --panel: #1a1a19; --fg: #f0efec; --muted: #c3c2b7; --line: #2e2e2b;
-  --bar: #3987e5; --bar-soft: #1d2b3d; --bad: #f97066; color-scheme: dark } }
+  --bg: #111110; --panel: #1a1a19; --fg: #f0efec; --muted: #c3c2b7; --faint: #8f8e86; --line: #2e2e2b;
+  --bar: #3987e5; --bar-soft: #1d2b3d; --hook: #d95926; --cli: #199e70;
+  --good: #3fbf3f; --bad: #f07070; --bad-soft: #3a1a1a; color-scheme: dark } }
 * { box-sizing: border-box; }
 body { margin: 0; background: var(--bg); color: var(--fg); font: 14px/1.5 var(--sans); }
-.wrap { max-width: 1200px; margin: 0 auto; padding: 20px 16px 48px; display: grid; gap: 16px; }
+a { color: inherit; }
+.wrap { max-width: 1240px; margin: 0 auto; padding: 0 16px 56px; display: grid; gap: 16px; }
 .wrap > * { min-width: 0; }
-header { display: flex; flex-wrap: wrap; align-items: center; gap: 12px 20px; }
-h1 { font-size: 20px; margin: 0; letter-spacing: -.01em; }
-h1 small { font: 500 13px var(--mono); color: var(--muted); margin-left: 8px; }
-h2 { font-size: 13px; margin: 0 0 10px; text-transform: uppercase; letter-spacing: .08em; color: var(--muted); font-weight: 600; }
+.top { position: sticky; top: 0; z-index: 5; background: color-mix(in srgb, var(--bg) 88%, transparent); backdrop-filter: blur(8px); border-bottom: 1px solid var(--line); }
+.bar-inner { max-width: 1240px; margin: 0 auto; padding: 12px 16px; display: flex; flex-wrap: wrap; align-items: center; gap: 10px 18px; }
+.brand { display: flex; align-items: center; gap: 10px; font-weight: 650; font-size: 16px; letter-spacing: -.01em; }
+.mark { width: 22px; height: 22px; border-radius: 6px; background: var(--bar); display: grid; place-items: center; color: #fff; font: 700 12px var(--mono); }
+.updated { font: 12px var(--mono); color: var(--faint); }
+.tabs { display: flex; gap: 4px; }
+.tabs a { text-decoration: none; color: var(--muted); font-weight: 500; font-size: 13px; padding: 6px 10px; border-radius: 7px; }
+.tabs a[aria-current="page"] { background: var(--panel); color: var(--fg); box-shadow: inset 0 0 0 1px var(--line); }
+.tabs a:focus-visible, .seg button:focus-visible, .btn:focus-visible, input:focus-visible, th button:focus-visible, tr.link:focus-visible { outline: 2px solid var(--bar); outline-offset: 1px; }
 .spacer { flex: 1; }
 .seg { display: inline-flex; border: 1px solid var(--line); border-radius: 8px; overflow: hidden; background: var(--panel); }
-.seg button { border: 0; background: none; color: var(--muted); font: 500 12px var(--sans); padding: 6px 12px; cursor: pointer; }
+.seg button { border: 0; background: none; color: var(--muted); font: 500 12px var(--sans); padding: 6px 11px; cursor: pointer; }
 .seg button + button { border-left: 1px solid var(--line); }
 .seg button[aria-pressed="true"] { background: var(--fg); color: var(--bg); }
-.seg button:focus-visible { outline: 2px solid var(--bar); outline-offset: -2px; }
-.kpis { display: grid; grid-template-columns: repeat(auto-fit, minmax(160px, 1fr)); gap: 12px; }
-.kpi { background: var(--panel); border: 1px solid var(--line); border-radius: 10px; padding: 12px 14px; }
+h2 { font-size: 12px; margin: 0; text-transform: uppercase; letter-spacing: .08em; color: var(--muted); font-weight: 600; }
+.head { display: flex; align-items: baseline; flex-wrap: wrap; gap: 6px 12px; margin-bottom: 12px; }
+.head .note { font-size: 12px; color: var(--faint); }
+.hero { display: grid; grid-template-columns: repeat(auto-fit, minmax(min(190px, 100%), 1fr)); gap: 12px; padding-top: 16px; }
+.kpi { background: var(--panel); border: 1px solid var(--line); border-radius: 12px; padding: 14px 16px; }
 .kpi .label { font-size: 12px; color: var(--muted); }
-.kpi .value { font: 600 28px/1.2 var(--mono); font-variant-numeric: tabular-nums; margin-top: 4px; }
-.kpi .sub { font-size: 12px; color: var(--muted); margin-top: 2px; }
-.panel { background: var(--panel); border: 1px solid var(--line); border-radius: 10px; padding: 14px 16px; min-width: 0; position: relative; }
-.cols { display: grid; grid-template-columns: repeat(auto-fit, minmax(320px, 1fr)); gap: 16px; }
-.chart svg { display: block; width: 100%; height: 180px; }
-.chart rect.hit { fill: transparent; }
-.chart rect.hit:hover + rect.mark, .chart rect.mark:hover { opacity: .75; }
-svg text { fill: var(--muted); font: 11px var(--mono); }
-.tip { position: absolute; pointer-events: none; background: var(--fg); color: var(--bg); font: 12px var(--mono); padding: 4px 8px; border-radius: 6px; white-space: nowrap; display: none; z-index: 2; }
-.rows { display: grid; gap: 6px; }
-.row { display: grid; grid-template-columns: minmax(0, 1fr) auto; gap: 2px 12px; font-size: 13px; }
-.row .track { grid-column: 1 / -1; height: 6px; background: var(--bar-soft); border-radius: 3px; }
-.row .fill { height: 6px; background: var(--bar); border-radius: 3px; }
+.kpi .value { font: 650 32px/1.15 var(--mono); font-variant-numeric: tabular-nums; margin-top: 6px; letter-spacing: -.02em; }
+.kpi .sub { font-size: 12px; color: var(--muted); margin-top: 4px; }
+.up { color: var(--good); font-weight: 600; }
+.down { color: var(--bad); font-weight: 600; }
+.panel { background: var(--panel); border: 1px solid var(--line); border-radius: 12px; padding: 16px; min-width: 0; }
+.grid2 { display: grid; grid-template-columns: repeat(auto-fit, minmax(min(340px, 100%), 1fr)); gap: 16px; }
+.grid3 { display: grid; grid-template-columns: repeat(auto-fit, minmax(min(260px, 100%), 1fr)); gap: 16px; }
+.chart svg { display: block; width: 100%; height: 190px; overflow: visible; }
+svg text { fill: var(--faint); font: 11px var(--mono); }
+.hit { fill: transparent; cursor: crosshair; }
+.hit:hover { fill: color-mix(in srgb, var(--fg) 6%, transparent); }
+.tip { position: absolute; pointer-events: none; background: var(--fg); color: var(--bg); font: 12px var(--mono); padding: 5px 8px; border-radius: 6px; white-space: nowrap; display: none; z-index: 10; }
+.rows { display: grid; gap: 8px; }
+.row { display: grid; grid-template-columns: minmax(0, 1fr) auto; gap: 3px 12px; font-size: 13px; }
+.row .track { grid-column: 1 / -1; height: 8px; background: var(--bar-soft); border-radius: 4px; overflow: hidden; }
+.row .fill { height: 8px; background: var(--bar); border-radius: 4px; }
 .row .n { font-family: var(--mono); font-variant-numeric: tabular-nums; color: var(--muted); }
+.funnel .row { font-size: 14px; }
+.funnel .track { height: 22px; border-radius: 6px; }
+.funnel .fill { height: 22px; border-radius: 6px; }
 .scroll { overflow-x: auto; }
 table { width: 100%; border-collapse: collapse; font-size: 13px; }
 th { text-align: left; font: 600 11px var(--sans); text-transform: uppercase; letter-spacing: .06em; color: var(--muted); padding: 6px 8px; border-bottom: 1px solid var(--line); white-space: nowrap; }
-td { padding: 6px 8px; border-bottom: 1px solid var(--line); white-space: nowrap; }
+th button { all: unset; cursor: pointer; }
+th button::after { content: attr(data-dir); margin-left: 4px; color: var(--faint); }
+td { padding: 7px 8px; border-bottom: 1px solid var(--line); white-space: nowrap; }
 tr:last-child td { border-bottom: 0; }
 td.n, th.n { text-align: right; font-family: var(--mono); font-variant-numeric: tabular-nums; }
+tr.link { cursor: pointer; }
+tr.link:hover td { background: var(--bar-soft); }
+.inline { display: inline-block; height: 6px; background: var(--bar); border-radius: 3px; vertical-align: middle; margin-left: 8px; }
+.heat td { text-align: center; font: 12px var(--mono); padding: 6px 4px; border: 2px solid var(--panel); border-radius: 6px; min-width: 44px; }
+.heat td.lab { text-align: left; color: var(--muted); font-family: var(--sans); white-space: nowrap; }
+.heat td.empty { background: transparent; color: var(--faint); }
 .bad { color: var(--bad); }
 .muted { color: var(--muted); }
 .mono { font-family: var(--mono); }
-.btn { border: 1px solid var(--line); background: var(--panel); color: var(--fg); font: 500 12px var(--sans); padding: 6px 12px; border-radius: 8px; cursor: pointer; }
-.btn:focus-visible { outline: 2px solid var(--bar); outline-offset: 2px; }
-.users { max-height: 560px; overflow: auto; }
-.users thead th { position: sticky; top: 0; background: var(--panel); }
-.empty { padding: 32px 16px; text-align: center; color: var(--muted); }
+.empty-state { padding: 36px 16px; text-align: center; color: var(--muted); }
+.toolbar { display: flex; flex-wrap: wrap; gap: 10px; align-items: center; margin-bottom: 12px; }
+input[type="search"] { font: 13px var(--sans); padding: 7px 10px; border: 1px solid var(--line); border-radius: 8px; background: var(--bg); color: var(--fg); min-width: 0; flex: 1 1 200px; }
+.btn { border: 1px solid var(--line); background: var(--panel); color: var(--fg); font: 500 12px var(--sans); padding: 7px 12px; border-radius: 8px; cursor: pointer; text-decoration: none; }
+.chips { display: flex; flex-wrap: wrap; gap: 6px; }
+.chip { display: inline-flex; align-items: center; gap: 6px; font: 600 11px var(--mono); padding: 2px 8px; border-radius: 999px; background: var(--bar-soft); color: var(--fg); }
+.sw { width: 10px; height: 10px; border-radius: 3px; display: inline-block; }
+.sessions { display: grid; gap: 6px; max-height: 520px; overflow: auto; }
+.session { all: unset; display: grid; gap: 2px; padding: 8px 10px; border: 1px solid var(--line); border-radius: 8px; cursor: pointer; font-size: 12px; }
+.session[aria-pressed="true"] { border-color: var(--bar); box-shadow: inset 3px 0 0 var(--bar); }
+.session:focus-visible { outline: 2px solid var(--bar); }
+.split { display: grid; grid-template-columns: minmax(220px, 300px) minmax(0, 1fr); gap: 16px; }
+@media (max-width: 820px) { .split { grid-template-columns: 1fr; } .wf .step { grid-template-columns: 120px 52px minmax(0, 1fr) 56px; } }
+.wf { display: grid; gap: 3px; font-size: 12px; }
+.wf .step { display: grid; grid-template-columns: 170px 64px minmax(0, 1fr) 70px; gap: 10px; align-items: center; }
+.wf .lane { position: relative; height: 14px; background: var(--bg); border-radius: 3px; }
+.wf .seg-bar { position: absolute; top: 2px; height: 10px; min-width: 3px; border-radius: 3px; }
+.wf .name { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; font-family: var(--mono); }
+.wf .at { font-family: var(--mono); color: var(--faint); text-align: right; }
+.wf .t { text-align: right; font-family: var(--mono); color: var(--muted); }
+.legend { display: flex; gap: 14px; font-size: 12px; color: var(--muted); margin-bottom: 10px; flex-wrap: wrap; }
+.legend span { display: inline-flex; align-items: center; gap: 6px; }
+footer { font-size: 12px; color: var(--faint); }
+[hidden] { display: none !important; }
 </style>
 </head>
 <body>
+<div class="top"><div class="bar-inner">
+  <div class="brand"><span class="mark">cb</span>CodeBuddy usage</div>
+  <nav class="tabs" aria-label="Views">
+    <a href="#overview" data-view="overview">Overview</a>
+    <a href="#users" data-view="users">Users</a>
+    <a href="#events" data-view="events">Events</a>
+  </nav>
+  <span class="spacer"></span>
+  <span class="updated" id="updated">loading\u2026</span>
+  <div class="seg" role="group" aria-label="Time range" id="range">
+    <button data-days="7">7d</button><button data-days="30" aria-pressed="true">30d</button><button data-days="90">90d</button><button data-days="365">1y</button>
+  </div>
+</div></div>
+
 <div class="wrap">
-  <header>
-    <h1>CodeBuddy usage<small id="updated"></small></h1>
-    <span class="spacer"></span>
-    <div class="seg" role="group" aria-label="Time range" id="range">
-      <button data-days="7">7 days</button>
-      <button data-days="30" aria-pressed="true">30 days</button>
-      <button data-days="90">90 days</button>
-      <button data-days="365">1 year</button>
+  <section id="view-overview">
+    <div class="hero" id="hero" aria-label="Headline numbers"></div>
+    <div class="grid2" style="margin-top:16px">
+      <section class="panel"><div class="head"><h2>Total installs</h2><span class="note">all-time, by first-seen day</span></div><div class="chart" id="cumulative"></div></section>
+      <section class="panel"><div class="head"><h2>Daily active installs</h2><span class="note">installs that sent any event</span></div><div class="chart" id="active"></div></section>
     </div>
-  </header>
-  <section class="kpis" id="kpis" aria-label="Summary"></section>
-  <div class="cols">
-    <section class="panel"><h2>Daily active installs</h2><div class="chart" id="active"></div></section>
-    <section class="panel"><h2>npm downloads per day</h2><div class="chart" id="npm"></div></section>
-  </div>
-  <section class="panel"><h2>Feature usage</h2><div class="scroll" id="features"></div></section>
-  <div class="cols">
-    <section class="panel"><h2>Agent clients</h2><div class="rows" id="clients"></div></section>
-    <section class="panel"><h2>Versions</h2><div class="rows" id="versions"></div></section>
-    <section class="panel"><h2>Platforms</h2><div class="rows" id="platforms"></div></section>
-  </div>
-  <section class="panel">
-    <div style="display:flex;align-items:center;gap:12px;margin-bottom:10px"><h2 style="margin:0">Users</h2><span class="muted" id="userCount" style="font-size:12px"></span><span class="spacer"></span><button class="btn" id="csv">Download CSV</button></div>
-    <div class="scroll users" id="users"></div>
+    <div class="grid2" style="margin-top:16px">
+      <section class="panel"><div class="head"><h2>Activation</h2><span class="note">installs active in range reaching each step</span></div><div class="rows funnel" id="funnel"></div></section>
+      <section class="panel"><div class="head"><h2>Retention by weekly cohort</h2><span class="note">share of each week's new installs active in later weeks</span></div><div class="scroll" id="cohorts"></div></section>
+    </div>
+    <section class="panel" style="margin-top:16px"><div class="head"><h2>Feature usage</h2><span class="note">MCP tools, hook steps (recall, capture\u2026) and CLI commands</span></div><div class="scroll" id="features"></div></section>
+    <div class="grid3" style="margin-top:16px">
+      <section class="panel"><div class="head"><h2>Agent clients</h2></div><div class="rows" id="clients"></div></section>
+      <section class="panel"><div class="head"><h2>Versions</h2></div><div class="rows" id="versions"></div></section>
+      <section class="panel"><div class="head"><h2>Platforms</h2></div><div class="rows" id="platforms"></div></section>
+    </div>
+    <section class="panel" style="margin-top:16px"><div class="head"><h2>npm downloads per day</h2><span class="note" id="npmNote"></span></div><div class="chart" id="npm"></div></section>
+  </section>
+
+  <section id="view-users" class="panel" style="margin-top:16px" hidden>
+    <div class="toolbar">
+      <h2>Users</h2><span class="muted" id="userCount" style="font-size:12px"></span><span class="spacer"></span>
+      <input type="search" id="userSearch" placeholder="Filter by id, client, version, platform\u2026" aria-label="Filter users">
+      <button class="btn" id="csv">Download CSV</button>
+    </div>
+    <div class="scroll" id="users"></div>
   </section>
-  <section class="panel"><h2>Latest events</h2><div class="scroll" id="recent"></div></section>
-  <p class="muted" style="margin:0;font-size:12px">Anonymous telemetry from installs that did not opt out: random install ids, tool names, timings and versions. No prompts, code, paths or repository names are collected. Shares count each install once, from its latest batch.</p>
+
+  <section id="view-install" style="margin-top:16px" hidden></section>
+
+  <section id="view-events" class="panel" style="margin-top:16px" hidden>
+    <div class="toolbar"><h2>Latest events</h2><span class="spacer"></span><div class="chips" id="kindFilter"></div></div>
+    <div class="scroll" id="recent"></div>
+  </section>
+
+  <footer>Anonymous telemetry from installs that did not opt out: random install ids, tool and command names, timings, versions. No prompts, code, paths or repository names are collected. Shares count each install once, from its latest batch.</footer>
 </div>
-<div class="tip" id="tip"></div>
+<div class="tip" id="tip" role="status"></div>
 <script>
 (function () {
   var days = 30;
-  // Works at "/" and under a proxy mount such as "/admin" (with or without a trailing slash).
-  var base = location.pathname.replace(/\\/?$/, "/");
-  var summary = null;
-  var npm = null;
+  var summary = null, npm = null, install = null;
+  var userSort = { key: "lastSeen", dir: -1 };
+  var kindShown = "all";
+  var selectedSession = null;
+  var path = location.pathname;
+  var base = path.charAt(path.length - 1) === "/" ? path : path + "/";
   var tip = document.getElementById("tip");
+  var NL = String.fromCharCode(10);
+  var KIND_COLOR = { tool: "var(--bar)", cli: "var(--cli)" };
+  function kindColor(kind) { return KIND_COLOR[kind] || "var(--hook)"; }
+  function kindGroup(kind) { return kind === "tool" ? "MCP tool" : kind === "cli" ? "CLI command" : "hook step"; }
 
+  function $(id) { return document.getElementById(id); }
   function esc(value) {
     return String(value == null ? "" : value).replace(/[&<>"']/g, function (c) {
       return { "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;", "'": "&#39;" }[c];
@@ -3533,36 +3988,57 @@ td.n, th.n { text-align: right; font-family: var(--mono); font-variant-numeric:
   }
   function num(n) { return Math.round(n).toLocaleString(); }
   function compact(n) { return n >= 1e6 ? (n / 1e6).toFixed(1) + "M" : n >= 1e4 ? (n / 1e3).toFixed(1) + "k" : num(n); }
-  function pct(n) { return (n * 100).toFixed(n < 0.1 ? 1 : 0) + "%"; }
-  function ms(n) { return n >= 1000 ? (n / 1000).toFixed(1) + " s" : Math.round(n) + " ms"; }
+  function pct(n) { return (n * 100).toFixed(n > 0 && n < 0.1 ? 1 : 0) + "%"; }
+  function plural(n, word) { return num(n) + " " + word + (n === 1 ? "" : "s"); }
+  function offset(n) { var s = Math.round(n / 1000); return "+" + (s >= 60 ? Math.floor(s / 60) + "m " + (s % 60) + "s" : s + "s"); }
+  function ms(n) { return n >= 60000 ? (n / 60000).toFixed(1) + " min" : n >= 1000 ? (n / 1000).toFixed(1) + " s" : Math.round(n) + " ms"; }
+  function date(iso) { return new Date(iso).toLocaleDateString(undefined, { month: "short", day: "numeric" }); }
+  function ago(iso) {
+    var s = Math.max(0, (Date.now() - Date.parse(iso)) / 1000);
+    return s < 60 ? "just now" : s < 3600 ? Math.floor(s / 60) + "m ago" : s < 86400 ? Math.floor(s / 3600) + "h ago" : Math.floor(s / 86400) + "d ago";
+  }
+  function get(url) { return fetch(base + url).then(function (r) { return r.ok ? r.json() : null; }); }
 
   function kpi(label, value, sub) {
-    return '<div class="kpi"><div class="label">' + esc(label) + '</div><div class="value">' + esc(value) +
-      '</div><div class="sub">' + esc(sub || "") + "</div></div>";
+    return '<div class="kpi"><div class="label">' + esc(label) + '</div><div class="value">' + esc(value) + '</div><div class="sub">' + (sub || "") + "</div></div>";
+  }
+  function delta(now, before) {
+    if (!before) return now ? '<span class="up">\u25B2 new</span> vs previous 7 days' : "no activity yet";
+    var change = (now - before) / before;
+    return '<span class="' + (change >= 0 ? "up" : "down") + '">' + (change >= 0 ? "\u25B2 " : "\u25BC ") + pct(Math.abs(change)) + "</span> vs previous 7 days";
   }
 
-  /** Bars of one measure over days; hover shows the exact value. */
-  function bars(points, label) {
-    if (!points.length) return '<div class="empty">No data yet.</div>';
-    var w = 600, h = 180, top = 10, bottom = 22, left = 36;
+  /** Bars or a filled line over days, one measure; every point has a hover target. */
+  /** Draw into a container at its own pixel width, so labels never stretch. */
+  function draw(id, points, label, line) {
+    var el = $(id);
+    if (el) el.innerHTML = chart(points, label, line, el.clientWidth);
+  }
+  function chart(points, label, line, width) {
+    if (!points.length) return '<div class="empty-state">No data yet.</div>';
+    var w = Math.max(280, width || 640), h = 190, top = 10, bottom = 22, left = 40, plot = h - top - bottom;
     var max = Math.max.apply(null, points.map(function (p) { return p.value; }).concat([1]));
     var step = (w - left) / points.length;
-    var bw = Math.max(1, step - 2);
+    var y = function (v) { return top + plot * (1 - v / max); };
     var out = '<svg viewBox="0 0 ' + w + " " + h + '" preserveAspectRatio="none" role="img" aria-label="' + esc(label) + '">';
     [0, 0.5, 1].forEach(function (f) {
-      var y = top + (h - top - bottom) * (1 - f);
-      out += '<line x1="' + left + '" x2="' + w + '" y1="' + y + '" y2="' + y + '" stroke="var(--line)" stroke-width="1"/>';
-      out += '<text x="' + (left - 6) + '" y="' + (y + 4) + '" text-anchor="end">' + esc(compact(max * f)) + "</text>";
+      out += '<line x1="' + left + '" x2="' + w + '" y1="' + y(max * f) + '" y2="' + y(max * f) + '" stroke="var(--line)"/>';
+      out += '<text x="' + (left - 6) + '" y="' + (y(max * f) + 4) + '" text-anchor="end">' + esc(compact(max * f)) + "</text>";
     });
+    if (line) {
+      var pts = points.map(function (p, i) { return (left + i * step + step / 2).toFixed(1) + "," + y(p.value).toFixed(1); });
+      out += '<path d="M' + (left + step / 2) + "," + (top + plot) + " L" + pts.join(" L") + " L" + (left + (points.length - 0.5) * step) + "," + (top + plot) + ' Z" fill="var(--bar-soft)"/>';
+      out += '<polyline points="' + pts.join(" ") + '" fill="none" stroke="var(--bar)" stroke-width="2" vector-effect="non-scaling-stroke" stroke-linejoin="round"/>';
+    }
     points.forEach(function (p, i) {
-      var bh = (h - top - bottom) * (p.value / max);
-      var x = left + i * step + 1;
-      var tipText = esc(p.date + " \xB7 " + num(p.value) + " " + label);
-      out += '<rect class="hit" x="' + (left + i * step) + '" y="' + top + '" width="' + step + '" height="' + (h - top - bottom) + '" data-tip="' + tipText + '"/>';
-      out += '<rect class="mark" x="' + x + '" y="' + (h - bottom - bh) + '" width="' + bw + '" height="' + bh + '" rx="' + Math.min(2, bw / 2) + '" fill="var(--bar)" data-tip="' + tipText + '"/>';
+      var x = left + i * step;
+      if (!line) {
+        var bh = plot * (p.value / max), bw = Math.max(1, step - 2);
+        out += '<rect x="' + (x + 1) + '" y="' + (top + plot - bh) + '" width="' + bw + '" height="' + bh + '" rx="' + Math.min(2, bw / 2) + '" fill="var(--bar)"/>';
+      }
+      out += '<rect class="hit" x="' + x + '" y="' + top + '" width="' + step + '" height="' + plot + '" data-tip="' + esc(p.date + " \xB7 " + num(p.value) + " " + label) + '"/>';
     });
-    var first = points[0].date, last = points[points.length - 1].date;
-    out += '<text x="' + left + '" y="' + (h - 6) + '">' + esc(first) + '</text><text x="' + w + '" y="' + (h - 6) + '" text-anchor="end">' + esc(last) + "</text>";
+    out += '<text x="' + left + '" y="' + (h - 5) + '">' + esc(points[0].date) + '</text><text x="' + w + '" y="' + (h - 5) + '" text-anchor="end">' + esc(points[points.length - 1].date) + "</text>";
     return out + "</svg>";
   }
 
@@ -3570,85 +4046,230 @@ td.n, th.n { text-align: right; font-family: var(--mono); font-variant-numeric:
     if (!items.length) return '<div class="muted">No data yet.</div>';
     return items.slice(0, 8).map(function (item) {
       var share = total ? item.installs / total : 0;
-      return '<div class="row"><span>' + esc(item.label) + '</span><span class="n">' + num(item.installs) + " \xB7 " + pct(share) +
-        '</span><div class="track"><div class="fill" style="width:' + (share * 100).toFixed(1) + '%"></div></div></div>';
+      return '<div class="row"><span>' + esc(item.label) + '</span><span class="n">' + num(item.installs) + " \xB7 " + pct(share) + '</span><div class="track"><div class="fill" style="width:' + (share * 100).toFixed(1) + '%"></div></div></div>';
     }).join("");
   }
 
-  function npmPoints() {
-    if (!npm || !npm.downloads) return [];
-    return npm.downloads.slice(-Math.min(days, 365)).map(function (d) { return { date: d.day, value: d.downloads }; });
+  function renderOverview() {
+    var t = summary.totals;
+    var npm30 = npmTotal(30);
+    $("hero").innerHTML =
+      kpi("Weekly active installs", num(t.wau), delta(t.wau, t.wauPrevious)) +
+      kpi("Total installs", num(t.allTimeInstalls), "+" + num(t.newInRange) + " in the last " + summary.days + " days \xB7 " + num(t.newToday) + " today") +
+      kpi("Week-1 retention", t.week1Retention == null ? "\u2013" : pct(t.week1Retention), t.week1Retention == null ? "needs a cohort older than 7 days" : "new installs active again the next week") +
+      kpi("Agent sessions", compact(t.sessions), num(t.dau) + " installs active today \xB7 " + num(t.mau) + " this month") +
+      kpi("npm downloads \xB7 30 days", npm30 == null ? "\u2013" : num(npm30), npm && npm.error ? esc(npm.error) : num(npmTotal(365) || 0) + " in the last year");
+    draw("cumulative", summary.daily.map(function (d) { return { date: d.date, value: d.totalInstalls }; }), "total installs", true);
+    draw("active", summary.daily.map(function (d) { return { date: d.date, value: d.installs }; }), "active installs", false);
+
+    var active = summary.funnel[0] ? summary.funnel[0].installs : 0;
+    $("funnel").innerHTML = active ? summary.funnel.map(function (step) {
+      var share = active ? step.installs / active : 0;
+      return '<div class="row"><span>' + esc(step.label) + '</span><span class="n">' + num(step.installs) + " \xB7 " + pct(share) + '</span><div class="track"><div class="fill" style="width:' + (share * 100).toFixed(1) + '%"></div></div></div>';
+    }).join("") : '<div class="empty-state">No active installs in this range.</div>';
+
+    var cohorts = summary.cohorts.filter(function (c) { return c.size > 0; });
+    var weeks = summary.cohorts.length;
+    $("cohorts").innerHTML = cohorts.length
+      ? '<table class="heat"><thead><tr><th>Cohort</th><th class="n">Installs</th>' + Array.from({ length: weeks }, function (_, i) { return '<th class="n">W' + i + "</th>"; }).join("") + "</tr></thead><tbody>" +
+        cohorts.map(function (c) {
+          var cells = "";
+          for (var i = 0; i < weeks; i += 1) {
+            var v = c.weeks[i];
+            if (v == null) { cells += '<td class="empty">\xB7</td>'; continue; }
+            var strength = Math.round(12 + v * 88);
+            cells += '<td style="background:color-mix(in oklab, var(--bar) ' + strength + '%, var(--panel));color:' + (v > 0.5 ? "#fff" : "var(--fg)") + '" title="' + esc(c.start + " cohort, week " + i + ": " + pct(v)) + '">' + pct(v) + "</td>";
+          }
+          return '<tr><td class="lab">' + esc(date(c.start)) + '</td><td class="n">' + num(c.size) + "</td>" + cells + "</tr>";
+        }).join("") + "</tbody></table>"
+      : '<div class="empty-state">Cohorts appear once new installs report in.</div>';
+
+    var maxCalls = Math.max.apply(null, summary.features.map(function (f) { return f.calls; }).concat([1]));
+    $("features").innerHTML = summary.features.length
+      ? '<table><thead><tr><th>Feature</th><th class="n">Calls</th><th class="n">Installs</th><th class="n">Median</th><th class="n">p95</th><th class="n">Errors</th></tr></thead><tbody>' +
+        summary.features.map(function (f) {
+          return '<tr><td class="mono">' + esc(f.label) + '<span class="inline" style="width:' + Math.max(2, (f.calls / maxCalls) * 120).toFixed(0) + 'px"></span></td><td class="n">' + num(f.calls) + '</td><td class="n">' + num(f.installs) +
+            '</td><td class="n">' + ms(f.p50ms) + '</td><td class="n">' + ms(f.p95ms) + '</td><td class="n' + (f.errorRate > 0.05 ? " bad" : "") + '">' + pct(f.errorRate) + "</td></tr>";
+        }).join("") + "</tbody></table>"
+      : '<div class="empty-state">No events yet. Installs send a batch at most every 10 minutes.</div>';
+    var installs = summary.versions.reduce(function (sum, v) { return sum + v.installs; }, 0);
+    $("clients").innerHTML = rows(summary.clients, installs);
+    $("versions").innerHTML = rows(summary.versions, installs);
+    $("platforms").innerHTML = rows(summary.platforms, installs);
+    renderNpm();
   }
+
   function npmTotal(n) {
     if (!npm || !npm.downloads) return null;
     return npm.downloads.slice(-n).reduce(function (sum, d) { return sum + d.downloads; }, 0);
   }
+  function renderNpm() {
+    if (!npm) return;
+    if (npm.error) { $("npm").innerHTML = '<div class="empty-state">' + esc(npm.error) + "</div>"; return; }
+    $("npmNote").textContent = npm.package + " \xB7 public npm registry";
+    draw("npm", npm.downloads.slice(-Math.min(days, 365)).map(function (d) { return { date: d.day, value: d.downloads }; }), "downloads", false);
+  }
 
-  function render() {
-    if (!summary) return;
-    var t = summary.totals;
-    var npm30 = npmTotal(30), npm365 = npmTotal(365);
-    document.getElementById("updated").textContent = "updated " + new Date(summary.generatedAt).toLocaleTimeString();
-    document.getElementById("kpis").innerHTML =
-      kpi("Active installs \xB7 7 days", num(t.active7d), num(t.active1d) + " today") +
-      kpi("Active installs \xB7 30 days", num(t.active30d), num(t.newToday) + " new today") +
-      kpi("Installs in range", num(t.installs), num(t.projects) + " projects") +
-      kpi("Agent sessions", num(t.sessions), "in " + summary.days + " days") +
-      kpi("Events", compact(t.events), pct(1 - t.errorRate) + " succeeded") +
-      kpi("Tokens delivered", compact(t.tokensOut), "context sent to agents") +
-      kpi("npm downloads \xB7 30 days", npm30 == null ? "\u2013" : num(npm30), npm365 == null ? (npm && npm.error ? npm.error : "") : num(npm365) + " in the last year");
-    document.getElementById("active").innerHTML = bars(summary.daily.map(function (d) { return { date: d.date, value: d.installs }; }), "active installs");
-    document.getElementById("npm").innerHTML = npm && npm.error ? '<div class="empty">' + esc(npm.error) + "</div>" : bars(npmPoints(), "downloads");
-    document.getElementById("features").innerHTML = summary.features.length
-      ? "<table><thead><tr><th>Feature</th><th class=\\"n\\">Calls</th><th class=\\"n\\">Installs</th><th class=\\"n\\">Median</th><th class=\\"n\\">Errors</th></tr></thead><tbody>" +
-        summary.features.map(function (f) {
-          return "<tr><td class=\\"mono\\">" + esc(f.label) + '</td><td class="n">' + num(f.calls) + '</td><td class="n">' + num(f.installs) +
-            '</td><td class="n">' + ms(f.p50ms) + '</td><td class="n' + (f.errorRate > 0.05 ? " bad" : "") + '">' + pct(f.errorRate) + "</td></tr>";
-        }).join("") + "</tbody></table>"
-      : '<div class="empty">No events yet. Installs send a batch at most every 10 minutes.</div>';
-    var installs = summary.versions.reduce(function (sum, v) { return sum + v.installs; }, 0);
-    document.getElementById("clients").innerHTML = rows(summary.clients, installs);
-    document.getElementById("versions").innerHTML = rows(summary.versions, installs);
-    document.getElementById("platforms").innerHTML = rows(summary.platforms, installs);
-    document.getElementById("userCount").textContent = num(summary.users.length) + " installs seen in " + summary.days + " days";
-    document.getElementById("users").innerHTML = summary.users.length
-      ? "<table><thead><tr><th>Install</th><th>First seen</th><th>Last active</th><th class=\\"n\\">Events</th><th class=\\"n\\">Sessions</th><th class=\\"n\\">Projects</th><th>Client</th><th>Version</th><th>Platform</th><th>Top feature</th></tr></thead><tbody>" +
-        summary.users.map(function (u) {
-          return '<tr><td class="mono">' + esc(u.install) + "</td><td>" + esc(new Date(u.firstSeen).toLocaleDateString()) + "</td><td>" + esc(new Date(u.lastSeen).toLocaleString()) +
-            '</td><td class="n">' + num(u.events) + '</td><td class="n">' + num(u.sessions) + '</td><td class="n">' + num(u.projects) + "</td><td>" + esc(u.client) +
-            '</td><td class="mono">' + esc(u.version) + "</td><td>" + esc(u.platform) + '</td><td class="mono">' + esc(u.topFeature) + "</td></tr>";
+  var USER_COLS = [
+    ["install", "Install"], ["firstSeen", "First seen"], ["lastSeen", "Last active"], ["activeDays", "Active days", 1],
+    ["sessions", "Sessions", 1], ["events", "Events", 1], ["errors", "Errors", 1], ["client", "Client"], ["version", "Version"], ["platform", "Platform"], ["topFeature", "Top feature"]
+  ];
+  function filteredUsers() {
+    var q = $("userSearch").value.trim().toLowerCase();
+    return summary.users.filter(function (u) {
+      return !q || [u.install, u.client, u.version, u.platform, u.topFeature].join(" ").toLowerCase().indexOf(q) !== -1;
+    }).sort(function (a, b) {
+      var x = a[userSort.key], y = b[userSort.key];
+      return (x < y ? -1 : x > y ? 1 : 0) * userSort.dir;
+    });
+  }
+  function renderUsers() {
+    var list = filteredUsers();
+    $("userCount").textContent = num(summary.users.length) + " installs active in the last " + summary.days + " days";
+    $("users").innerHTML = list.length
+      ? "<table><thead><tr>" + USER_COLS.map(function (c) {
+          return "<th" + (c[2] ? ' class="n"' : "") + '><button data-sort="' + c[0] + '" data-dir="' + (userSort.key === c[0] ? (userSort.dir > 0 ? "\u2191" : "\u2193") : "") + '">' + c[1] + "</button></th>";
+        }).join("") + "</tr></thead><tbody>" +
+        list.map(function (u) {
+          return '<tr class="link" tabindex="0" data-install="' + esc(u.install) + '"><td class="mono">' + esc(u.install) + "</td><td>" + esc(date(u.firstSeen)) + "</td><td>" + esc(ago(u.lastSeen)) +
+            '</td><td class="n">' + num(u.activeDays) + '</td><td class="n">' + num(u.sessions) + '</td><td class="n">' + num(u.events) + '</td><td class="n' + (u.errors ? " bad" : "") + '">' + num(u.errors) +
+            "</td><td>" + esc(u.client) + '</td><td class="mono">' + esc(u.version) + "</td><td>" + esc(u.platform) + '</td><td class="mono">' + esc(u.topFeature) + "</td></tr>";
         }).join("") + "</tbody></table>"
-      : '<div class="empty">No users yet.</div>';
-    document.getElementById("recent").innerHTML = summary.recent.length
-      ? "<table><thead><tr><th>Received</th><th>Install</th><th>Kind</th><th>Name</th><th>Client</th><th>Version</th><th class=\\"n\\">Time</th><th>Result</th></tr></thead><tbody>" +
-        summary.recent.map(function (e) {
-          return "<tr><td>" + esc(new Date(e.receivedAt).toLocaleString()) + '</td><td class="mono">' + esc(e.install) + "</td><td>" + esc(e.kind) +
-            '</td><td class="mono">' + esc(e.name) + "</td><td>" + esc(e.client) + '</td><td class="mono">' + esc(e.version) +
-            '</td><td class="n">' + ms(e.ms) + '</td><td class="' + (e.ok ? "" : "bad") + '">' + (e.ok ? "ok" : "error") + "</td></tr>";
+      : '<div class="empty-state">' + (summary.users.length ? "No installs match this filter." : "No users yet.") + "</div>";
+  }
+
+  function renderInstall() {
+    var el = $("view-install");
+    if (!install) { el.innerHTML = '<div class="panel empty-state">Loading\u2026</div>'; return; }
+    if (install.missing) { el.innerHTML = '<div class="panel empty-state">No events for this install in the last 90 days. <a href="#users">Back to users</a></div>'; return; }
+    var errors = install.events.filter(function (e) { return !e.ok; }).length;
+    var perDay = {};
+    install.perDay.forEach(function (d) { perDay[d.date] = d.events; });
+    var points = [];
+    for (var i = 89; i >= 0; i -= 1) {
+      var d = new Date(Date.now() - i * 86400000).toISOString().slice(0, 10);
+      points.push({ date: d, value: perDay[d] || 0 });
+    }
+    if (!selectedSession || !install.sessions.some(function (s) { return s.id === selectedSession; })) selectedSession = install.sessions[0] ? install.sessions[0].id : null;
+    el.innerHTML =
+      '<div class="toolbar"><a class="btn" href="#users">\u2190 Users</a><h2 style="font-size:14px;color:var(--fg);text-transform:none;letter-spacing:0">Install <span class="mono">' + esc(install.install) + "</span></h2>" +
+      '<span class="chips"><span class="chip">' + esc(install.client) + '</span><span class="chip">v' + esc(install.version) + '</span><span class="chip">' + esc(install.platform) + '</span><span class="chip">node ' + esc(install.node) + "</span></span></div>" +
+      '<div class="hero" style="padding-top:0">' + kpi("Events \xB7 90 days", num(install.events.length), errors ? '<span class="bad">' + plural(errors, "error") + "</span>" : "no errors") +
+      kpi("Sessions", num(install.sessions.length), "agent sessions with CodeBuddy") + kpi("Active days", num(install.perDay.length), "in the last 90 days") + kpi("Projects", num(install.projects), "hashed, never named") + "</div>" +
+      '<section class="panel" style="margin-top:16px"><div class="head"><h2>Activity</h2><span class="note">events per day, last 90 days</span></div><div class="chart" id="installActivity"></div></section>' +
+      '<section class="panel" style="margin-top:16px"><div class="head"><h2>Session traces</h2><span class="note">each step ends at its recorded time; bar length is its duration</span></div>' +
+      '<div class="split"><div class="sessions" id="sessionList">' + install.sessions.map(function (s) {
+        return '<button class="session" data-session="' + esc(s.id) + '" aria-pressed="' + (s.id === selectedSession) + '"><strong class="mono">' + esc(s.id === "none" ? "no session id" : s.id.slice(0, 8)) + "</strong>" +
+          '<span class="muted">' + esc(new Date(s.start).toLocaleString()) + " \xB7 " + num(s.events) + " steps" + (s.errors ? ' \xB7 <span class="bad">' + plural(s.errors, "error") + "</span>" : "") + "</span></button>";
+      }).join("") + '</div><div id="waterfall"></div></div></section>';
+    draw("installActivity", points, "events", false);
+    renderWaterfall();
+  }
+
+  function renderWaterfall() {
+    var target = $("waterfall");
+    if (!target || !install) return;
+    var steps = install.events.filter(function (e) { return e.session === selectedSession; })
+      .sort(function (a, b) { return a.ts < b.ts ? -1 : a.ts > b.ts ? 1 : 0; }).slice(-200);
+    if (!steps.length) { target.innerHTML = '<div class="empty-state">Pick a session.</div>'; return; }
+    var start = Math.min.apply(null, steps.map(function (e) { return Date.parse(e.ts) - e.ms; }));
+    var end = Math.max.apply(null, steps.map(function (e) { return Date.parse(e.ts); }));
+    var span = Math.max(1, end - start);
+    target.innerHTML = '<div class="legend"><span><i class="sw" style="background:var(--bar)"></i>MCP tool</span><span><i class="sw" style="background:var(--hook)"></i>hook step</span><span><i class="sw" style="background:var(--cli)"></i>CLI command</span><span class="spacer"></span><span>' + esc(ms(span)) + " total</span></div>" +
+      '<div class="wf">' + steps.map(function (e) {
+        var s = Date.parse(e.ts) - e.ms;
+        var left = ((s - start) / span) * 100, width = Math.max(0.8, (e.ms / span) * 100);
+        return '<div class="step"><span class="name' + (e.ok ? "" : " bad") + '" title="' + esc(kindGroup(e.kind) + ": " + e.name) + '">' + (e.ok ? "" : "\u2715 ") + esc(e.feature) + '</span><span class="at">' + esc(offset(s - start)) + '</span><span class="lane"><span class="seg-bar" style="left:' + left.toFixed(2) + "%;width:" + width.toFixed(2) + "%;background:" + kindColor(e.kind) + '" data-tip="' + esc(e.feature + " \xB7 " + ms(e.ms) + (e.ok ? "" : " \xB7 error") + (e.tokensOut ? " \xB7 " + num(e.tokensOut) + " tokens out" : "")) + '"></span></span><span class="t">' + esc(ms(e.ms)) + "</span></div>";
+      }).join("") + "</div>";
+  }
+
+  function renderEvents() {
+    var kinds = ["all"];
+    summary.recent.forEach(function (e) { if (kinds.indexOf(e.kind) === -1) kinds.push(e.kind); });
+    $("kindFilter").innerHTML = '<div class="seg" role="group" aria-label="Event kind">' + kinds.map(function (k) {
+      return '<button data-kind="' + esc(k) + '" aria-pressed="' + (k === kindShown) + '">' + esc(k) + "</button>";
+    }).join("") + "</div>";
+    var list = summary.recent.filter(function (e) { return kindShown === "all" || e.kind === kindShown; });
+    $("recent").innerHTML = list.length
+      ? '<table><thead><tr><th>Received</th><th>Install</th><th>Kind</th><th>Name</th><th>Client</th><th>Version</th><th class="n">Time</th><th>Result</th></tr></thead><tbody>' +
+        list.map(function (e) {
+          return '<tr class="link" tabindex="0" data-install="' + esc(e.install) + '"><td>' + esc(new Date(e.receivedAt).toLocaleString()) + '</td><td class="mono">' + esc(e.install) + '</td><td><span class="sw" style="background:' + kindColor(e.kind) + '"></span> ' + esc(e.kind) +
+            '</td><td class="mono">' + esc(e.name) + "</td><td>" + esc(e.client) + '</td><td class="mono">' + esc(e.version) + '</td><td class="n">' + ms(e.ms) + '</td><td class="' + (e.ok ? "" : "bad") + '">' + (e.ok ? "ok" : "\u2715 error") + "</td></tr>";
         }).join("") + "</tbody></table>"
-      : '<div class="empty">No events yet.</div>';
+      : '<div class="empty-state">No events yet.</div>';
   }
 
-  function load() {
-    fetch(base + "api/summary?days=" + days).then(function (r) { return r.json(); }).then(function (s) { summary = s; render(); });
+  function route() {
+    var hash = location.hash.replace("#", "") || "overview";
+    var view = hash.indexOf("install/") === 0 ? "install" : ["overview", "users", "events"].indexOf(hash) !== -1 ? hash : "overview";
+    ["overview", "users", "install", "events"].forEach(function (v) { $("view-" + v).hidden = v !== view; });
+    document.querySelectorAll(".tabs a").forEach(function (a) {
+      var current = a.dataset.view === view || (view === "install" && a.dataset.view === "users");
+      if (current) a.setAttribute("aria-current", "page"); else a.removeAttribute("aria-current");
+    });
+    $("range").hidden = view === "install";
+    if (view === "install") {
+      var id = hash.slice(8);
+      if (!install || install.install !== id) {
+        install = null;
+        renderInstall();
+        get("api/install?id=" + encodeURIComponent(id)).then(function (data) { install = data || { install: id, missing: true }; renderInstall(); });
+      } else renderInstall();
+    } else render();
   }
-  fetch(base + "api/npm").then(function (r) { return r.json(); }).then(function (n) { npm = n; render(); });
 
-  document.getElementById("range").addEventListener("click", function (event) {
+  function render() {
+    if (!summary) return;
+    $("updated").textContent = "updated " + new Date(summary.generatedAt).toLocaleTimeString();
+    var hash = location.hash.replace("#", "") || "overview";
+    if (hash === "users") renderUsers();
+    else if (hash === "events") renderEvents();
+    else if (hash.indexOf("install/") !== 0) renderOverview();
+  }
+
+  function load() { get("api/summary?days=" + days).then(function (s) { if (s) { summary = s; render(); } }); }
+  get("api/npm").then(function (n) { npm = n; if (summary) render(); });
+
+  $("range").addEventListener("click", function (event) {
     var button = event.target.closest("button");
     if (!button) return;
     days = Number(button.dataset.days);
     document.querySelectorAll("#range button").forEach(function (b) { b.setAttribute("aria-pressed", String(b === button)); });
     load();
   });
-  document.getElementById("csv").addEventListener("click", function () {
+  $("userSearch").addEventListener("input", function () { if (summary) renderUsers(); });
+  document.addEventListener("click", function (event) {
+    var sort = event.target.closest("[data-sort]");
+    if (sort) {
+      var key = sort.dataset.sort;
+      userSort = { key: key, dir: userSort.key === key ? -userSort.dir : -1 };
+      renderUsers();
+      return;
+    }
+    var row = event.target.closest("tr[data-install]");
+    if (row) { location.hash = "install/" + row.dataset.install; return; }
+    var session = event.target.closest("[data-session]");
+    if (session) {
+      selectedSession = session.dataset.session;
+      document.querySelectorAll("#sessionList .session").forEach(function (b) { b.setAttribute("aria-pressed", String(b === session)); });
+      renderWaterfall();
+      return;
+    }
+    var kind = event.target.closest("[data-kind]");
+    if (kind) { kindShown = kind.dataset.kind; renderEvents(); }
+  });
+  document.addEventListener("keydown", function (event) {
+    var row = event.target.closest && event.target.closest("tr[data-install]");
+    if (row && (event.key === "Enter" || event.key === " ")) { event.preventDefault(); location.hash = "install/" + row.dataset.install; }
+  });
+  $("csv").addEventListener("click", function () {
     if (!summary) return;
-    var cols = ["install", "firstSeen", "lastSeen", "events", "sessions", "projects", "client", "version", "platform", "topFeature"];
-    var lines = [cols.join(",")].concat(summary.users.map(function (u) {
+    var cols = USER_COLS.map(function (c) { return c[0]; });
+    var lines = [cols.join(",")].concat(filteredUsers().map(function (u) {
       return cols.map(function (c) { return '"' + String(u[c]).replace(/"/g, '""') + '"'; }).join(",");
     }));
     var link = document.createElement("a");
-    link.href = URL.createObjectURL(new Blob([lines.join("\\n")], { type: "text/csv" }));
+    link.href = URL.createObjectURL(new Blob([lines.join(NL)], { type: "text/csv" }));
     link.download = "codebuddy-users-" + new Date().toISOString().slice(0, 10) + ".csv";
     link.click();
   });
@@ -3657,10 +4278,16 @@ td.n, th.n { text-align: right; font-family: var(--mono); font-variant-numeric:
     if (!text) { tip.style.display = "none"; return; }
     tip.textContent = text;
     tip.style.display = "block";
-    var x = Math.min(event.pageX + 12, document.documentElement.scrollWidth - tip.offsetWidth - 8);
-    tip.style.left = x + "px";
-    tip.style.top = (event.pageY - 32) + "px";
+    tip.style.left = Math.min(event.pageX + 12, document.documentElement.scrollWidth - tip.offsetWidth - 8) + "px";
+    tip.style.top = (event.pageY - 34) + "px";
+  });
+  var resizeTimer = 0;
+  window.addEventListener("resize", function () {
+    clearTimeout(resizeTimer);
+    resizeTimer = setTimeout(function () { if (location.hash.indexOf("#install/") === 0) renderInstall(); else render(); }, 150);
   });
+  window.addEventListener("hashchange", route);
+  route();
   load();
   setInterval(load, 60000);
 })();
@@ -3699,7 +4326,8 @@ var batchSchema = z2.object({
 });
 async function startCollector(options) {
   const { dataDir } = options;
-  await mkdir2(dataDir, { recursive: true });
+  await mkdir3(dataDir, { recursive: true });
+  const registry = await loadRegistry(dataDir);
   let summaryCache;
   let npmCache;
   const perInstall = /* @__PURE__ */ new Map();
@@ -3743,10 +4371,18 @@ async function startCollector(options) {
       return;
     }
     const receivedAt = (/* @__PURE__ */ new Date()).toISOString();
+    if (!registry.has(batch.installId)) {
+      registry.set(batch.installId, receivedAt);
+      await appendFile(
+        join7(dataDir, "installs.jsonl"),
+        `${JSON.stringify({ installId: batch.installId, firstSeen: receivedAt })}
+`
+      );
+    }
     const { events, ...meta } = batch;
     const lines = events.map((event) => JSON.stringify({ ...meta, ...event, receivedAt }));
     await appendFile(
-      join6(dataDir, `events-${receivedAt.slice(0, 10)}.jsonl`),
+      join7(dataDir, `events-${receivedAt.slice(0, 10)}.jsonl`),
       `${lines.join("\n")}
 `
     );
@@ -3790,12 +4426,29 @@ async function startCollector(options) {
         summaryCache = {
           at: Date.now(),
           days,
-          value: summarize(await readEvents(dataDir, days), days)
+          value: summarize(
+            await readEvents(dataDir, Math.max(days, COHORT_WEEKS * 7)),
+            days,
+            Date.now(),
+            registry
+          )
         };
       }
       json2(summaryCache.value);
       return;
     }
+    if (url.pathname === "/api/install") {
+      const trace = installTrace(
+        await readEvents(dataDir, 90),
+        (url.searchParams.get("id") ?? "").toLowerCase()
+      );
+      if (!trace) {
+        response.writeHead(404, { "content-type": "application/json" }).end("null");
+        return;
+      }
+      json2(trace);
+      return;
+    }
     if (url.pathname === "/api/npm") {
       if (!npmCache || Date.now() - npmCache.at > 36e5) {
         npmCache = { at: Date.now(), value: await npmDownloads(options.fetchImpl ?? fetch) };
@@ -3826,7 +4479,7 @@ function passwordMatches(request, password3) {
   if (!header.startsWith("Basic ")) return false;
   const decoded = Buffer.from(header.slice(6), "base64").toString("utf8");
   const given = decoded.slice(decoded.indexOf(":") + 1);
-  const digest = (value) => createHash("sha256").update(value).digest();
+  const digest = (value) => createHash2("sha256").update(value).digest();
   return timingSafeEqual(digest(given), digest(password3));
 }
 function readBody(request) {
@@ -3850,10 +4503,10 @@ function listen2(server, port) {
 }
 async function readEvents(dataDir, days, now = Date.now()) {
   const since = new Date(now - (days - 1) * 864e5).toISOString().slice(0, 10);
-  const files = (await readdir(dataDir).catch(() => [])).filter((file) => /^events-\d{4}-\d{2}-\d{2}\.jsonl$/.test(file) && file.slice(7, 17) >= since).sort();
+  const files = (await readdir2(dataDir).catch(() => [])).filter((file) => /^events-\d{4}-\d{2}-\d{2}\.jsonl$/.test(file) && file.slice(7, 17) >= since).sort();
   const events = [];
   for (const file of files) {
-    for (const line of (await readFile4(join6(dataDir, file), "utf8")).split("\n")) {
+    for (const line of (await readFile5(join7(dataDir, file), "utf8")).split("\n")) {
       if (!line) continue;
       try {
         events.push(JSON.parse(line));
@@ -3863,64 +4516,125 @@ async function readEvents(dataDir, days, now = Date.now()) {
   }
   return events;
 }
-function summarize(events, days, now = Date.now()) {
-  const day = (iso) => iso.slice(0, 10);
-  const today = day(new Date(now).toISOString());
-  const activeWithin = (window) => {
-    const since = day(new Date(now - (window - 1) * 864e5).toISOString());
-    return new Set(events.filter((e) => day(e.receivedAt) >= since).map((e) => e.installId)).size;
+var DAY_MS = 864e5;
+var dayOf = (iso) => iso.slice(0, 10);
+var dayNumber = (iso) => Math.floor(Date.parse(iso) / DAY_MS);
+var COHORT_WEEKS = 8;
+function featureOf(event) {
+  if (event.kind === "tool") return event.name;
+  if (event.kind === "cli") return `cli:${event.name}`;
+  return event.kind;
+}
+var GOT_CONTEXT = (e) => e.kind === "recall" || e.kind === "tool" && /^(context_(pack|bootstrap|before_edit)|recall)$/.test(e.name);
+var SAVED_MEMORY = (e) => e.kind === "capture" || e.kind === "tool" && /^(context_after_turn|remember)$/.test(e.name);
+function summarize(events, days, now = Date.now(), registry = /* @__PURE__ */ new Map()) {
+  const today = Math.floor(now / DAY_MS);
+  const rangeStart = today - days + 1;
+  const firstSeenOf = (install, fallback) => registry.get(install) ?? fallback;
+  const activeDays = /* @__PURE__ */ new Map();
+  for (const event of events) {
+    const set = activeDays.get(event.installId) ?? /* @__PURE__ */ new Set();
+    set.add(dayNumber(event.receivedAt));
+    activeDays.set(event.installId, set);
+  }
+  const activeBetween = (from, to) => {
+    let count = 0;
+    for (const set of activeDays.values()) {
+      for (const d of set) {
+        if (d >= from && d <= to) {
+          count += 1;
+          break;
+        }
+      }
+    }
+    return count;
   };
+  const inRange = events.filter((e) => dayNumber(e.receivedAt) >= rangeStart);
   const daily = /* @__PURE__ */ new Map();
-  for (let index = days - 1; index >= 0; index -= 1) {
-    daily.set(day(new Date(now - index * 864e5).toISOString()), {
-      installs: /* @__PURE__ */ new Set(),
-      events: 0
-    });
-  }
-  const firstSeen = /* @__PURE__ */ new Map();
-  const tools = /* @__PURE__ */ new Map();
-  const kinds = /* @__PURE__ */ new Map();
+  for (let d = rangeStart; d <= today; d += 1) daily.set(d, { installs: /* @__PURE__ */ new Set(), events: 0 });
+  const features = /* @__PURE__ */ new Map();
   const latest = /* @__PURE__ */ new Map();
   const users = /* @__PURE__ */ new Map();
+  const funnel = {
+    active: /* @__PURE__ */ new Set(),
+    context: /* @__PURE__ */ new Set(),
+    memory: /* @__PURE__ */ new Set()
+  };
   let errors = 0;
   let tokensOut = 0;
-  for (const event of events) {
-    const bucket = daily.get(day(event.receivedAt));
+  for (const event of inRange) {
+    const d = dayNumber(event.receivedAt);
+    const bucket = daily.get(d);
     if (bucket) {
       bucket.installs.add(event.installId);
       bucket.events += 1;
     }
-    const seen = firstSeen.get(event.installId);
-    if (!seen || event.receivedAt < seen) firstSeen.set(event.installId, event.receivedAt);
     latest.set(event.installId, event);
+    const feature = featureOf(event);
     const user = users.get(event.installId) ?? {
+      firstEvent: event.receivedAt,
       lastSeen: event.receivedAt,
       events: 0,
+      errors: 0,
       sessions: /* @__PURE__ */ new Set(),
       projects: /* @__PURE__ */ new Set(),
-      features: /* @__PURE__ */ new Map()
+      features: /* @__PURE__ */ new Map(),
+      days: /* @__PURE__ */ new Set()
     };
     if (event.receivedAt > user.lastSeen) user.lastSeen = event.receivedAt;
     user.events += 1;
+    if (!event.ok) user.errors += 1;
     if (event.session) user.sessions.add(event.session);
     user.projects.add(event.project);
-    const feature = event.kind === "tool" ? event.name : event.kind;
     user.features.set(feature, (user.features.get(feature) ?? 0) + 1);
+    user.days.add(d);
     users.set(event.installId, user);
-    kinds.set(event.kind, (kinds.get(event.kind) ?? 0) + 1);
+    funnel.active.add(event.installId);
+    if (GOT_CONTEXT(event)) funnel.context.add(event.installId);
+    if (SAVED_MEMORY(event)) funnel.memory.add(event.installId);
     if (!event.ok) errors += 1;
     tokensOut += event.tokensOut ?? 0;
-    const key = event.kind === "tool" ? event.name : `${event.kind}`;
-    const tool = tools.get(key) ?? { calls: 0, errors: 0, installs: /* @__PURE__ */ new Set(), ms: [] };
-    tool.calls += 1;
-    if (!event.ok) tool.errors += 1;
-    tool.installs.add(event.installId);
-    tool.ms.push(event.ms);
-    tools.set(key, tool);
+    const stats = features.get(feature) ?? { calls: 0, errors: 0, installs: /* @__PURE__ */ new Set(), ms: [] };
+    stats.calls += 1;
+    if (!event.ok) stats.errors += 1;
+    stats.installs.add(event.installId);
+    stats.ms.push(event.ms);
+    features.set(feature, stats);
+  }
+  const firstSeenDay = /* @__PURE__ */ new Map();
+  for (const [install, seen] of registry) firstSeenDay.set(install, dayNumber(seen));
+  for (const [install, user] of users) {
+    if (!firstSeenDay.has(install)) firstSeenDay.set(install, dayNumber(user.firstEvent));
+  }
+  for (const [install, set] of activeDays) {
+    if (!firstSeenDay.has(install)) firstSeenDay.set(install, Math.min(...set));
   }
   const newPerDay = /* @__PURE__ */ new Map();
-  for (const seen of firstSeen.values())
-    newPerDay.set(day(seen), (newPerDay.get(day(seen)) ?? 0) + 1);
+  for (const d of firstSeenDay.values()) newPerDay.set(d, (newPerDay.get(d) ?? 0) + 1);
+  let cumulative = [...firstSeenDay.values()].filter((d) => d < rangeStart).length;
+  const cohorts = [];
+  for (let age = COHORT_WEEKS - 1; age >= 0; age -= 1) {
+    const from = today - (age + 1) * 7 + 1;
+    const members = [...firstSeenDay].filter(([, d]) => d >= from && d < from + 7).map(([install]) => install);
+    const weeks = [];
+    for (let week = 0; week <= age; week += 1) {
+      const wFrom = from + week * 7;
+      const active = members.filter((install) => {
+        const set = activeDays.get(install);
+        if (!set) return week === 0;
+        for (const d of set) if (d >= wFrom && d < wFrom + 7) return true;
+        return false;
+      }).length;
+      weeks.push(members.length ? active / members.length : 0);
+    }
+    cohorts.push({
+      start: new Date(from * DAY_MS).toISOString().slice(0, 10),
+      size: members.length,
+      weeks
+    });
+  }
+  const week1 = cohorts.filter((c) => c.size > 0 && c.weeks.length > 1);
+  const week1Retention = week1.length ? week1.reduce((sum, c) => sum + (c.weeks[1] ?? 0) * c.size, 0) / week1.reduce((sum, c) => sum + c.size, 0) : null;
   const share = (pick) => {
     const counts = /* @__PURE__ */ new Map();
     for (const event of latest.values()) {
@@ -3932,47 +4646,72 @@ function summarize(events, days, now = Date.now()) {
     const sorted = [...values].sort((a, b) => a - b);
     return sorted[Math.floor(sorted.length / 2)] ?? 0;
   };
+  const p95 = (values) => {
+    const sorted = [...values].sort((a, b) => a - b);
+    return sorted[Math.min(sorted.length - 1, Math.floor(sorted.length * 0.95))] ?? 0;
+  };
+  const wau = activeBetween(today - 6, today);
+  const wauPrevious = activeBetween(today - 13, today - 7);
+  const returned = [...users.values()].filter((user) => user.days.size >= 2).length;
   return {
     generatedAt: new Date(now).toISOString(),
     days,
     totals: {
-      installs: firstSeen.size,
-      projects: new Set(events.map((e) => `${e.installId}:${e.project}`)).size,
-      sessions: new Set(events.filter((e) => e.session).map((e) => e.session)).size,
-      events: events.length,
-      errorRate: events.length ? errors / events.length : 0,
+      allTimeInstalls: firstSeenDay.size,
+      installs: users.size,
+      newInRange: [...firstSeenDay.values()].filter((d) => d >= rangeStart).length,
+      newToday: newPerDay.get(today) ?? 0,
+      projects: new Set(inRange.map((e) => `${e.installId}:${e.project}`)).size,
+      sessions: new Set(inRange.filter((e) => e.session).map((e) => e.session)).size,
+      events: inRange.length,
+      errorRate: inRange.length ? errors / inRange.length : 0,
       tokensOut,
-      active1d: activeWithin(1),
-      active7d: activeWithin(7),
-      active30d: activeWithin(30),
-      newToday: newPerDay.get(today) ?? 0
+      dau: activeBetween(today, today),
+      wau,
+      wauPrevious,
+      mau: activeBetween(today - 29, today),
+      week1Retention
     },
-    daily: [...daily].map(([date, bucket]) => ({
-      date,
-      installs: bucket.installs.size,
-      events: bucket.events,
-      newInstalls: newPerDay.get(date) ?? 0
-    })),
-    features: [...tools].map(([label, tool]) => ({
+    daily: [...daily].map(([d, bucket]) => {
+      cumulative += newPerDay.get(d) ?? 0;
+      return {
+        date: new Date(d * DAY_MS).toISOString().slice(0, 10),
+        installs: bucket.installs.size,
+        events: bucket.events,
+        newInstalls: newPerDay.get(d) ?? 0,
+        totalInstalls: cumulative
+      };
+    }),
+    /** Installs active in the range that reached each step. */
+    funnel: [
+      { label: "Active", installs: funnel.active.size },
+      { label: "Received context", installs: funnel.context.size },
+      { label: "Saved memory", installs: funnel.memory.size },
+      { label: "Came back another day", installs: returned }
+    ],
+    cohorts,
+    features: [...features].map(([label, stats]) => ({
       label,
-      calls: tool.calls,
-      installs: tool.installs.size,
-      errorRate: tool.errors / tool.calls,
-      p50ms: median(tool.ms)
-    })).sort((a, b) => b.calls - a.calls).slice(0, 20),
-    kinds: [...kinds].map(([label, count]) => ({ label, count })).sort((a, b) => b.count - a.count),
+      calls: stats.calls,
+      installs: stats.installs.size,
+      errorRate: stats.errors / stats.calls,
+      p50ms: median(stats.ms),
+      p95ms: p95(stats.ms)
+    })).sort((a, b) => b.calls - a.calls).slice(0, 25),
     clients: share((e) => e.clients.length ? e.clients : ["unknown"]),
     versions: share((e) => [e.version]),
     platforms: share((e) => [`${e.platform}/${e.arch}`]),
     nodes: share((e) => [`node ${e.node}`]),
-    /** One row per install, most recently active first. */
+    /** One row per install active in the range, most recently active first. */
     users: [...users].map(([installId, user]) => {
       const last = latest.get(installId);
       return {
         install: installId.slice(0, 8),
-        firstSeen: firstSeen.get(installId) ?? user.lastSeen,
+        firstSeen: firstSeenOf(installId, user.firstEvent),
         lastSeen: user.lastSeen,
+        activeDays: user.days.size,
         events: user.events,
+        errors: user.errors,
         sessions: user.sessions.size,
         projects: user.projects.size,
         client: last?.clients.join(",") || "unknown",
@@ -3981,7 +4720,7 @@ function summarize(events, days, now = Date.now()) {
         topFeature: [...user.features].sort((a, b) => b[1] - a[1])[0]?.[0] ?? ""
       };
     }).sort((a, b) => b.lastSeen.localeCompare(a.lastSeen)).slice(0, 1e3),
-    recent: events.slice(-50).reverse().map((e) => ({
+    recent: inRange.slice(-50).reverse().map((e) => ({
       receivedAt: e.receivedAt,
       install: e.installId.slice(0, 8),
       kind: e.kind,
@@ -3993,6 +4732,77 @@ function summarize(events, days, now = Date.now()) {
     }))
   };
 }
+function installTrace(events, prefix) {
+  const own = events.filter((e) => e.installId.startsWith(prefix));
+  const first = own[0];
+  if (!first || !/^[0-9a-f]{8}$/.test(prefix)) return null;
+  const sessions = /* @__PURE__ */ new Map();
+  const perDay = /* @__PURE__ */ new Map();
+  for (const event of own) {
+    perDay.set(dayOf(event.receivedAt), (perDay.get(dayOf(event.receivedAt)) ?? 0) + 1);
+    const key = event.session ?? "none";
+    const session = sessions.get(key) ?? {
+      start: event.ts,
+      end: event.ts,
+      events: 0,
+      errors: 0,
+      ms: 0,
+      features: /* @__PURE__ */ new Set()
+    };
+    if (event.ts < session.start) session.start = event.ts;
+    if (event.ts > session.end) session.end = event.ts;
+    session.events += 1;
+    if (!event.ok) session.errors += 1;
+    session.ms += event.ms;
+    session.features.add(featureOf(event));
+    sessions.set(key, session);
+  }
+  const last = own[own.length - 1] ?? first;
+  return {
+    install: prefix,
+    client: last.clients.join(",") || "unknown",
+    version: last.version,
+    platform: `${last.platform}/${last.arch}`,
+    node: last.node,
+    projects: new Set(own.map((e) => e.project)).size,
+    perDay: [...perDay].map(([date, count]) => ({ date, events: count })),
+    sessions: [...sessions].map(([id, session]) => ({ id, ...session, features: [...session.features] })).sort((a, b) => b.end.localeCompare(a.end)).slice(0, 50),
+    events: own.slice(-1e3).map((e) => ({
+      ts: e.ts,
+      kind: e.kind,
+      name: e.name,
+      feature: featureOf(e),
+      ms: e.ms,
+      ok: e.ok,
+      session: e.session ?? "none",
+      tokensOut: e.tokensOut ?? 0
+    }))
+  };
+}
+async function loadRegistry(dataDir) {
+  const registry = /* @__PURE__ */ new Map();
+  const path = join7(dataDir, "installs.jsonl");
+  const raw = await readFile5(path, "utf8").catch(() => null);
+  if (raw !== null) {
+    for (const line of raw.split("\n")) {
+      try {
+        const entry = JSON.parse(line);
+        if (!registry.has(entry.installId)) registry.set(entry.installId, entry.firstSeen);
+      } catch {
+      }
+    }
+    return registry;
+  }
+  for (const event of await readEvents(dataDir, 3650)) {
+    if (!registry.has(event.installId)) registry.set(event.installId, event.receivedAt);
+  }
+  const lines = [...registry].map(
+    ([installId, firstSeen]) => JSON.stringify({ installId, firstSeen })
+  );
+  await appendFile(path, lines.length ? `${lines.join("\n")}
+` : "");
+  return registry;
+}
 async function npmDownloads(fetchImpl) {
   const to = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
   const from = new Date(Date.now() - 364 * 864e5).toISOString().slice(0, 10);
@@ -4017,10 +4827,10 @@ function registerTelemetryCommands(program, runSafely2) {
       const state = await readTelemetryState();
       const blocked = telemetryBlocked(state);
       console.log(
-        blocked ? `${pc19.yellow("\u25CB")} telemetry off (${blocked})` : `${pc19.green("\u25CF")} telemetry on`
+        blocked ? `${pc21.yellow("\u25CB")} telemetry off (${blocked})` : `${pc21.green("\u25CF")} telemetry on`
       );
-      console.log(pc19.dim(`  install id ${state.installId} (${telemetryStatePath()})`));
-      if (telemetryUrl()) console.log(pc19.dim(`  collector ${telemetryUrl()}`));
+      console.log(pc21.dim(`  install id ${state.installId} (${telemetryStatePath()})`));
+      if (telemetryUrl()) console.log(pc21.dim(`  collector ${telemetryUrl()}`));
     });
   });
   telemetry.command("enable").description("Allow anonymous usage data from this machine.").action(async () => {
@@ -4031,7 +4841,7 @@ function registerTelemetryCommands(program, runSafely2) {
         noticeAt: state.noticeAt ?? (/* @__PURE__ */ new Date()).toISOString()
       });
       console.log(TELEMETRY_NOTICE);
-      console.log(pc19.green("Telemetry enabled."));
+      console.log(pc21.green("Telemetry enabled."));
     });
   });
   telemetry.command("disable").description("Stop sending anonymous usage data from this machine.").action(async () => {
@@ -4059,14 +4869,14 @@ function registerTelemetryCommands(program, runSafely2) {
         adminPort: opts.adminPort,
         ...process.env.CODEBUDDY_ADMIN_PASSWORD ? { adminPassword: process.env.CODEBUDDY_ADMIN_PASSWORD } : {}
       });
-      console.log(`${pc19.green("\u25CF")} ingest ${pc19.bold(collector.ingestUrl)}`);
-      console.log(`${pc19.green("\u25CF")} admin  ${pc19.bold(collector.adminUrl)}`);
+      console.log(`${pc21.green("\u25CF")} ingest ${pc21.bold(collector.ingestUrl)}`);
+      console.log(`${pc21.green("\u25CF")} admin  ${pc21.bold(collector.adminUrl)}`);
       console.log(
-        pc19.dim(
+        pc21.dim(
           process.env.CODEBUDDY_ADMIN_PASSWORD ? "  admin panel is password-protected (CODEBUDDY_ADMIN_PASSWORD)." : "  admin panel has no password: keep it private, or set CODEBUDDY_ADMIN_PASSWORD."
         )
       );
-      console.log(pc19.dim(`  events in ${opts.data}. Ctrl+C to stop.`));
+      console.log(pc21.dim(`  events in ${opts.data}. Ctrl+C to stop.`));
       await new Promise((resolve6) => {
         const stop = () => void collector.close().then(resolve6);
         process.once("SIGINT", stop);
@@ -4079,12 +4889,12 @@ function registerTelemetryCommands(program, runSafely2) {
 // src/cli/commands/use-command.ts
 import { basename as basename2 } from "path";
 import { confirm as confirm2, isCancel as isCancel2, log as log2, note as note2, password as password2, select, spinner as spinner3, text as text2 } from "@clack/prompts";
-import pc20 from "picocolors";
+import pc22 from "picocolors";
 
 // src/core/global-config.ts
-import { chmod, mkdir as mkdir3, readFile as readFile5, writeFile as writeFile3 } from "fs/promises";
+import { chmod, mkdir as mkdir4, readFile as readFile6, writeFile as writeFile3 } from "fs/promises";
 import { homedir } from "os";
-import { dirname as dirname3, join as join7 } from "path";
+import { dirname as dirname3, join as join8 } from "path";
 import { z as z3 } from "zod";
 var GLOBAL_DIR = ".codebuddy";
 var GLOBAL_FILE = "global.json";
@@ -4097,12 +4907,12 @@ var globalConfigSchema = z3.object({
   installPath: z3.string().optional()
 });
 function globalConfigPath(home = homedir()) {
-  return join7(home, GLOBAL_DIR, GLOBAL_FILE);
+  return join8(home, GLOBAL_DIR, GLOBAL_FILE);
 }
 async function readGlobalConfig(home = homedir()) {
   const path = globalConfigPath(home);
   try {
-    const raw = await readFile5(path, "utf8");
+    const raw = await readFile6(path, "utf8");
     return globalConfigSchema.parse(JSON.parse(raw));
   } catch (error) {
     if (error.code === "ENOENT") return {};
@@ -4111,7 +4921,7 @@ async function readGlobalConfig(home = homedir()) {
 }
 async function writeGlobalConfig(next, home = homedir()) {
   const path = globalConfigPath(home);
-  await mkdir3(dirname3(path), { recursive: true, mode: 448 });
+  await mkdir4(dirname3(path), { recursive: true, mode: 448 });
   await writeFile3(path, `${JSON.stringify(next, null, 2)}
 `, { mode: 384 });
   await chmod(path, 384);
@@ -4163,15 +4973,15 @@ async function runUseCommand(options = {}) {
       })
     ));
     note2(
-      `Project folder: ${pc20.bold(process.cwd())}
-Namespace:      ${pc20.bold(namespace)}`,
+      `Project folder: ${pc22.bold(process.cwd())}
+Namespace:      ${pc22.bold(namespace)}`,
       "codebuddy use"
     );
     const stored = await readGlobalConfig();
     const projectConfig = await readConfigFile();
     let embeddings = projectConfig.provider?.type;
     if (embeddings) {
-      log2.info(`Embeddings: ${embeddings} (change with ${pc20.cyan("codebuddy models use")}).`);
+      log2.info(`Embeddings: ${embeddings} (change with ${pc22.cyan("codebuddy models use")}).`);
     } else if (!interactive) {
       embeddings = "local";
     } else {
@@ -4212,7 +5022,7 @@ Namespace:      ${pc20.bold(namespace)}`,
       log2.info("Using HF_TOKEN from environment.");
     } else if (stored.hfToken) {
       hfToken = stored.hfToken;
-      log2.info(`Reusing saved Hugging Face token (${pc20.dim("~/.codebuddy/global.json")}).`);
+      log2.info(`Reusing saved Hugging Face token (${pc22.dim("~/.codebuddy/global.json")}).`);
     } else if (!interactive) {
       throw new Error(
         "Hugging Face embeddings need a token: set HF_TOKEN (no terminal to prompt for it)."
@@ -4346,7 +5156,7 @@ Namespace:      ${pc20.bold(namespace)}`,
           databaseUrl
         });
         log2.success(
-          `Registered ${pc20.bold(install.serverKey)} in Claude Desktop. Restart with \u2318Q to activate.`
+          `Registered ${pc22.bold(install.serverKey)} in Claude Desktop. Restart with \u2318Q to activate.`
         );
       } catch (error) {
         log2.warn(`Claude Desktop registration skipped: ${error.message}`);
@@ -4361,7 +5171,7 @@ Namespace:      ${pc20.bold(namespace)}`,
           databaseUrl
         });
         log2.success(
-          `Registered ${pc20.bold(install.serverKey)} in Codex. Restart Codex to activate.`
+          `Registered ${pc22.bold(install.serverKey)} in Codex. Restart Codex to activate.`
         );
       } catch (error) {
         log2.warn(`Codex registration skipped: ${error.message}`);
@@ -4369,24 +5179,24 @@ Namespace:      ${pc20.bold(namespace)}`,
     }
     note2(
       [
-        `${pc20.green("\u2713")} CodeBuddy is ready for ${pc20.bold(folderName)}.`,
-        `${pc20.green("\u2713")} Scaffolded ${pc20.cyan(".codebuddy/policies.yaml")} for project-specific guardrails.`,
-        `${pc20.green("\u2713")} ${graphifyMessage}`,
-        `${pc20.green("\u2713")} Added agent workflow instructions to ${pc20.cyan("CLAUDE.md")} and ${pc20.cyan("AGENTS.md")}.`,
+        `${pc22.green("\u2713")} CodeBuddy is ready for ${pc22.bold(folderName)}.`,
+        `${pc22.green("\u2713")} Scaffolded ${pc22.cyan(".codebuddy/policies.yaml")} for project-specific guardrails.`,
+        `${pc22.green("\u2713")} ${graphifyMessage}`,
+        `${pc22.green("\u2713")} Added agent workflow instructions to ${pc22.cyan("CLAUDE.md")} and ${pc22.cyan("AGENTS.md")}.`,
         ``,
         `Next:`,
         `  1. Restart Claude Desktop and Codex.`,
-        `  2. Ask Claude or Codex to use the ${pc20.cyan("context_pack")} tool for each coding task.`,
+        `  2. Ask Claude or Codex to use the ${pc22.cyan("context_pack")} tool for each coding task.`,
         `  3. Indexing, Graphify, Markdown memory import, and embeddings now update automatically while the MCP server is running.`,
-        `  4. Run ${pc20.cyan("codebuddy doctor")} or ${pc20.cyan("codebuddy db doctor")} if you want a full health check.`,
+        `  4. Run ${pc22.cyan("codebuddy doctor")} or ${pc22.cyan("codebuddy db doctor")} if you want a full health check.`,
         ``,
         `Manage:`,
-        `  codebuddy claude list           ${pc20.dim("# see every project wired up")}`,
-        `  codebuddy codex list            ${pc20.dim("# see Codex entries")}`,
-        `  codebuddy db test               ${pc20.dim("# quick Postgres connectivity check")}`,
+        `  codebuddy claude list           ${pc22.dim("# see every project wired up")}`,
+        `  codebuddy codex list            ${pc22.dim("# see Codex entries")}`,
+        `  codebuddy db test               ${pc22.dim("# quick Postgres connectivity check")}`,
         `  codebuddy claude remove codebuddy-${namespace}`,
         `  codebuddy codex remove codebuddy-${namespace}`,
-        `  codebuddy postgres down         ${pc20.dim("# stop the DB (data preserved)")}`
+        `  codebuddy postgres down         ${pc22.dim("# stop the DB (data preserved)")}`
       ].join("\n"),
       "Done"
     );
@@ -4397,7 +5207,7 @@ Namespace:      ${pc20.bold(namespace)}`,
 
 // src/cli/commands/worklog.ts
 import { relative as relative6 } from "path";
-import pc21 from "picocolors";
+import pc23 from "picocolors";
 function registerWorklogCommands(program, runSafely2) {
   const worklog = program.command("worklog").description("Inspect the cross-chat worklog of completed turns.");
   worklog.command("list", { isDefault: true }).option("--limit <n>", "Maximum entries to show.", "20").option("--json", "Print machine-readable JSON.").description("List worklog entries, newest first.").action(async (opts) => {
@@ -4408,7 +5218,7 @@ function registerWorklogCommands(program, runSafely2) {
         return;
       }
       if (entries.length === 0) {
-        console.log(pc21.dim("no worklog entries yet"));
+        console.log(pc23.dim("no worklog entries yet"));
         return;
       }
       for (const entry of entries) console.log(renderRow2(entry));
@@ -4422,36 +5232,36 @@ function registerWorklogCommands(program, runSafely2) {
   worklog.command("latest").description("Show the most recent worklog entry.").action(async () => {
     await runSafely2(async () => {
       const [entry] = await new WorklogStore().list();
-      console.log(entry ? renderEntry(entry) : pc21.dim("no worklog entries yet"));
+      console.log(entry ? renderEntry(entry) : pc23.dim("no worklog entries yet"));
     });
   });
 }
 function renderRow2(entry) {
   const summary = entry.summary.replace(/\s+/g, " ");
   const short2 = summary.length <= 70 ? summary : `${summary.slice(0, 69)}\u2026`;
-  return `${pc21.dim(entry.createdAt.slice(0, 16))}  ${pc21.dim(entry.id)}  ${short2}  ${pc21.dim(`(${entry.files.length} file(s))`)}`;
+  return `${pc23.dim(entry.createdAt.slice(0, 16))}  ${pc23.dim(entry.id)}  ${short2}  ${pc23.dim(`(${entry.files.length} file(s))`)}`;
 }
 function renderEntry(entry) {
-  const lines = [`${pc21.bold(entry.id)}  ${pc21.dim(entry.createdAt)}  ${pc21.dim(entry.namespace)}`];
-  if (entry.sourceSessionId) lines.push(`${pc21.bold("session:")} ${entry.sourceSessionId}`);
-  if (entry.sourcePlanId) lines.push(`${pc21.bold("plan:")} ${entry.sourcePlanId}`);
-  if (entry.commitSha) lines.push(`${pc21.bold("commit:")} ${entry.commitSha}`);
-  if (entry.files.length > 0) lines.push(`${pc21.bold("files:")} ${entry.files.join(", ")}`);
+  const lines = [`${pc23.bold(entry.id)}  ${pc23.dim(entry.createdAt)}  ${pc23.dim(entry.namespace)}`];
+  if (entry.sourceSessionId) lines.push(`${pc23.bold("session:")} ${entry.sourceSessionId}`);
+  if (entry.sourcePlanId) lines.push(`${pc23.bold("plan:")} ${entry.sourcePlanId}`);
+  if (entry.commitSha) lines.push(`${pc23.bold("commit:")} ${entry.commitSha}`);
+  if (entry.files.length > 0) lines.push(`${pc23.bold("files:")} ${entry.files.join(", ")}`);
   if (entry.verification.length > 0) {
-    lines.push(`${pc21.bold("verification:")}`, ...entry.verification.map((line) => `  - ${line}`));
+    lines.push(`${pc23.bold("verification:")}`, ...entry.verification.map((line) => `  - ${line}`));
   }
   if (entry.savedMemory.length > 0) {
-    lines.push(`${pc21.bold("saved memory:")} ${entry.savedMemory.join(", ")}`);
+    lines.push(`${pc23.bold("saved memory:")} ${entry.savedMemory.join(", ")}`);
   }
   if (entry.queuedForReview.length > 0) {
-    lines.push(`${pc21.bold("queued for review:")} ${entry.queuedForReview.join(", ")}`);
+    lines.push(`${pc23.bold("queued for review:")} ${entry.queuedForReview.join(", ")}`);
   }
-  lines.push("", entry.summary, "", pc21.dim(relative6(process.cwd(), entry.path)));
+  lines.push("", entry.summary, "", pc23.dim(relative6(process.cwd(), entry.path)));
   return lines.join("\n");
 }
 
 // src/cli/commands/zvec.ts
-import pc22 from "picocolors";
+import pc24 from "picocolors";
 function registerZvecCommands(program, runSafely2) {
   const zvec = program.command("zvec").description("Optional zvec-grep semantic file discovery for the context tools.");
   zvec.command("status", { isDefault: true }).option("--json", "Print machine-readable JSON.").description("Show whether zvec-grep is enabled, installed, supported and indexed.").action(async (opts) => {
@@ -4461,22 +5271,22 @@ function registerZvecCommands(program, runSafely2) {
         console.log(JSON.stringify(report, null, 2));
         return;
       }
-      const mark = (ok2) => ok2 ? pc22.green("yes") : pc22.yellow("no");
+      const mark = (ok2) => ok2 ? pc24.green("yes") : pc24.yellow("no");
       console.log(`enabled:      ${mark(report.enabled)}`);
       console.log(`binary:       ${report.binary}`);
       console.log(
-        `version:      ${report.version ?? pc22.yellow("not found")}${report.version && !report.supported ? pc22.yellow(" (unsupported; need 0.2.x)") : ""}`
+        `version:      ${report.version ?? pc24.yellow("not found")}${report.version && !report.supported ? pc24.yellow(" (unsupported; need 0.2.x)") : ""}`
       );
       console.log(`index ready:  ${mark(report.indexReady)}`);
       console.log(
-        `zg server:    ${report.server} ${pc22.dim("(running = faster queries; optional)")}`
+        `zg server:    ${report.server} ${pc24.dim("(running = faster queries; optional)")}`
       );
       console.log(`status:       ${report.reason}`);
-      if (!report.version) console.log(pc22.dim("install: npm install -g @zvec/zvec-grep"));
+      if (!report.version) console.log(pc24.dim("install: npm install -g @zvec/zvec-grep"));
       else if (report.supported && !report.indexReady)
-        console.log(pc22.dim("next: codebuddy zvec index"));
+        console.log(pc24.dim("next: codebuddy zvec index"));
       else if (report.indexReady && !report.enabled)
-        console.log(pc22.dim("next: codebuddy zvec enable"));
+        console.log(pc24.dim("next: codebuddy zvec enable"));
     });
   });
   zvec.command("index").option("--model <model>", "Embedding model for a new index.", DEFAULT_ZVEC_MODEL).option("--rebuild", "Rebuild the index from scratch (e.g. after changing model).").description("Build or refresh the zg index for this repository (explicit; never automatic).").action(async (opts) => {
@@ -4486,21 +5296,21 @@ function registerZvecCommands(program, runSafely2) {
         ...opts.rebuild ? { rebuild: true } : {}
       });
       if (code !== 0) throw new Error(`zg index exited with code ${code}`);
-      console.log(pc22.dim("next: codebuddy zvec enable (.zvec-grep/ ignores itself in git)"));
+      console.log(pc24.dim("next: codebuddy zvec enable (.zvec-grep/ ignores itself in git)"));
     });
   });
   zvec.command("enable").description("Use zvec-grep candidates in context_pack / context_before_edit.").action(async () => {
     await runSafely2(async () => {
       await setZvecEnabled(true);
       console.log(
-        `${pc22.green("enabled")} zvec-grep retrieval (falls back to keywords if unavailable)`
+        `${pc24.green("enabled")} zvec-grep retrieval (falls back to keywords if unavailable)`
       );
     });
   });
   zvec.command("disable").description("Stop using zvec-grep; keyword ranking only.").action(async () => {
     await runSafely2(async () => {
       await setZvecEnabled(false);
-      console.log(`${pc22.yellow("disabled")} zvec-grep retrieval`);
+      console.log(`${pc24.yellow("disabled")} zvec-grep retrieval`);
     });
   });
 }
@@ -4773,6 +5583,36 @@ function createCli() {
       console.log(JSON.stringify(await runtime.repository.getStats(), null, 2));
     });
   });
+  program.command("storage").option("--json", "Print machine-readable JSON.").description(
+    "Memory storage health: Markdown/database drift, backup coverage, embedding backlog and spaces, capture lag."
+  ).action(async (opts) => {
+    await runSafely(async () => {
+      const root = process.cwd();
+      const capture2 = {
+        stagedNotCaptured: await new HookStagingStore(root).pending(),
+        journalBehind: (await journalLag(root)).filter((entry) => entry.behindBytes !== 0)
+      };
+      let database;
+      try {
+        const runtime = await createRuntime(await loadRuntimeConfig());
+        try {
+          database = await runtime.memory.storageReport();
+        } finally {
+          await runtime.close();
+        }
+      } catch (error) {
+        database = { unavailable: error.message };
+      }
+      if (opts.json) {
+        console.log(JSON.stringify({ database, capture: capture2 }, null, 2));
+        return;
+      }
+      printStorage(database, capture2);
+      if ("unavailable" in database || database.markdownOnly.length + database.dbOnly.length > 0) {
+        process.exitCode = 1;
+      }
+    });
+  });
   program.command("doctor").description("Check CodeBuddy environment health.").option("--skip-model-check", "Do not call Hugging Face models.").action(async (opts) => {
     await runSafely(async () => {
       const report = await runDoctor({ skipModelCheck: opts.skipModelCheck ?? true });
@@ -4799,6 +5639,8 @@ function createCli() {
   registerLearnCommand(program, runSafely);
   registerMemoryCommands(program, runSafely);
   registerWorklogCommands(program, runSafely);
+  registerJournalCommands(program, runSafely);
+  registerOutputCommands(program, runSafely);
   registerZvecCommands(program, runSafely);
   registerLlmCommands(program, runSafely);
   registerSuggestCommand(program, runSafely);
@@ -4810,7 +5652,12 @@ function createCli() {
   registerGitHubCommands(program, runSafely);
   registerSymbolsCommand(program, runSafely);
   registerTelemetryCommands(program, runSafely);
-  program.hook("preAction", () => showTelemetryNoticeOnce());
+  let started = Date.now();
+  program.hook("preAction", () => {
+    started = Date.now();
+    return showTelemetryNoticeOnce();
+  });
+  program.hook("postAction", (_program, command) => traceCliCommand(command, started));
   program.action(async () => {
     await runSafely(() => runUseCommand());
   });
@@ -4821,7 +5668,20 @@ var HELP_GROUPS = [
   ["Get started:", ["use", "init", "doctor", "hooks", "clients", "models", "dashboard"]],
   [
     "Daily work:",
-    ["context", "plan", "change", "risk", "suggest", "memory", "worklog", "map", "symbols"]
+    [
+      "context",
+      "plan",
+      "change",
+      "risk",
+      "suggest",
+      "memory",
+      "worklog",
+      "journal",
+      "run",
+      "output",
+      "map",
+      "symbols"
+    ]
   ],
   ["Indexing and search:", ["index", "watch", "reindex", "zvec", "graphify", "llm"]],
   [
@@ -4831,6 +5691,7 @@ var HELP_GROUPS = [
       "db",
       "migrate",
       "stats",
+      "storage",
       "inspect",
       "namespaces",
       "list-facts",
@@ -4881,7 +5742,7 @@ async function runSafely(fn) {
   try {
     await fn();
   } catch (error) {
-    console.error(pc23.red(String(redactSecrets(error.message))));
+    console.error(pc25.red(String(redactSecrets(error.message))));
     process.exitCode = 1;
   }
 }
@@ -4895,9 +5756,9 @@ function parseDuration(value) {
   return amount * 60 * 1e3;
 }
 function printDoctor(report) {
-  const ok2 = pc23.green("ok");
-  const bad = pc23.red("fail");
-  const warn2 = pc23.yellow("warn");
+  const ok2 = pc25.green("ok");
+  const bad = pc25.red("fail");
+  const warn2 = pc25.yellow("warn");
   console.log(`scaffold root: ${report.scaffold.codebuddyDir.ok ? ok2 : bad}`);
   if (report.scaffold.codebuddyDir.warning)
     console.log(`  ${report.scaffold.codebuddyDir.warning}`);
@@ -4923,7 +5784,7 @@ function printDoctor(report) {
   );
   console.log(`estimated daily cap remaining: ${report.usage.estimatedDailyCapRemaining}`);
   if (report.usage.warning80Percent)
-    console.log(pc23.yellow("usage warning: daily cap is over 80% used"));
+    console.log(pc25.yellow("usage warning: daily cap is over 80% used"));
   console.log(
     `config permissions: ${report.config.exists ? report.config.mode : "missing"} ${report.config.ok ? ok2 : warn2}`
   );
@@ -4933,9 +5794,9 @@ function printDoctor(report) {
   }
 }
 function printDbDoctor(report) {
-  const ok2 = pc23.green("ok");
-  const bad = pc23.red("fail");
-  const warn2 = pc23.yellow("warn");
+  const ok2 = pc25.green("ok");
+  const bad = pc25.red("fail");
+  const warn2 = pc25.yellow("warn");
   console.log(`DB connectivity: ${report.db.ok ? ok2 : bad}`);
   if (report.db.postgresUrlSource) console.log(`  url source: ${report.db.postgresUrlSource}`);
   if (report.db.error) console.log(`  ${report.db.error}`);
@@ -4948,7 +5809,42 @@ function printDbDoctor(report) {
   }
   if (report.namespace.warning) console.log(`  ${report.namespace.warning}`);
 }
+function printStorage(database, capture2) {
+  if ("unavailable" in database) {
+    console.log(pc25.yellow(`database: unavailable (${database.unavailable})`));
+  } else {
+    const drift = database.markdownOnly.length + database.dbOnly.length;
+    console.log(
+      `facts: ${database.markdownFacts} Markdown, ${database.databaseFacts} database${database.invalidFiles > 0 ? `, ${database.invalidFiles} unreadable file(s)` : ""}`
+    );
+    console.log(
+      drift === 0 ? pc25.green("sync: Markdown and database agree") : pc25.yellow(
+        `sync: ${database.markdownOnly.length} file(s) not in the database, ${database.dbOnly.length} row(s) without a file (run \`codebuddy reindex\`)`
+      )
+    );
+    if (database.unbacked.length > 0) {
+      console.log(
+        pc25.yellow(
+          `backup: ${database.unbacked.length} database-only fact(s) have no Markdown copy`
+        )
+      );
+    }
+    const e = database.embeddings;
+    console.log(
+      `embeddings: ${e.ready} ready, ${e.pending} pending, ${e.processing} processing, ${e.failed} failed${database.oldestPendingAt ? ` (oldest pending ${database.oldestPendingAt})` : ""}`
+    );
+    for (const space of database.spaces) {
+      console.log(`  space ${space.model} ${space.space ?? "(legacy)"}: ${space.count}`);
+    }
+    if (database.spaces.length > 1) {
+      console.log(pc25.yellow("  more than one embedding space: run `codebuddy reindex --respace`"));
+    }
+  }
+  console.log(
+    capture2.stagedNotCaptured.length === 0 && capture2.journalBehind.length === 0 ? pc25.green("capture: nothing pending") : `capture: ${capture2.stagedNotCaptured.length} session(s) with uncaptured edits, ${capture2.journalBehind.length} journal(s) behind their transcript`
+  );
+}
 export {
   createCli
 };
-//# sourceMappingURL=main-QUASSFP7.js.map
+//# sourceMappingURL=main-SFC5LV4E.js.map