xtrm-tools 0.5.24 → 0.5.26

package/cli/dist/index.cjs

@@ -36342,14 +36342,14 @@ var Temp = {
     }
   },
   truncate: (filePath) => {
-    const basename = import_node_path2.default.basename(filePath);
-    if (basename.length <= LIMIT_BASENAME_LENGTH)
+    const basename2 = import_node_path2.default.basename(filePath);
+    if (basename2.length <= LIMIT_BASENAME_LENGTH)
       return filePath;
-    const truncable = /^(\.?)(.*?)((?:\.[^.]+)?(?:\.tmp-\d{10}[a-f0-9]{6})?)$/.exec(basename);
+    const truncable = /^(\.?)(.*?)((?:\.[^.]+)?(?:\.tmp-\d{10}[a-f0-9]{6})?)$/.exec(basename2);
     if (!truncable)
       return filePath;
-    const truncationLength = basename.length - LIMIT_BASENAME_LENGTH;
-    return `${filePath.slice(0, -basename.length)}${truncable[1]}${truncable[2].slice(0, -truncationLength)}${truncable[3]}`;
+    const truncationLength = basename2.length - LIMIT_BASENAME_LENGTH;
+    return `${filePath.slice(0, -basename2.length)}${truncable[1]}${truncable[2].slice(0, -truncationLength)}${truncable[3]}`;
   }
 };
 node_default(Temp.purgeSyncAll);
@@ -40962,6 +40962,14 @@ function isDoltInstalled() {
     return false;
   }
 }
+function isDeepwikiInstalled() {
+  try {
+    (0, import_child_process2.execSync)("deepwiki --version", { stdio: "ignore" });
+    return true;
+  } catch {
+    return false;
+  }
+}
 async function needsSettingsSync(repoRoot, target) {
   const normalizedTarget = target.replace(/\\/g, "/").toLowerCase();
   if (normalizedTarget.includes(".agents/skills")) return false;
@@ -41115,13 +41123,15 @@ async function installPlugin(repoRoot, dryRun) {
     await installOfficialClaudePlugins(true);
     return;
   }
-  (0, import_child_process3.spawnSync)("claude", ["plugin", "marketplace", "add", repoRoot, "--scope", "user"], { stdio: "pipe" });
+  const xtrmPkgRoot = import_path11.default.resolve(__dirname, "..", "..");
+  (0, import_child_process3.spawnSync)("claude", ["plugin", "marketplace", "add", xtrmPkgRoot, "--scope", "user"], { stdio: "pipe" });
   const listResult = (0, import_child_process3.spawnSync)("claude", ["plugin", "list"], { encoding: "utf8", stdio: "pipe" });
   if (listResult.stdout?.includes("xtrm-tools@xtrm-tools")) {
     (0, import_child_process3.spawnSync)("claude", ["plugin", "uninstall", "xtrm-tools@xtrm-tools"], { stdio: "inherit" });
   }
   (0, import_child_process3.spawnSync)("claude", ["plugin", "install", "xtrm-tools@xtrm-tools", "--scope", "user"], { stdio: "inherit" });
   console.log(t.success("  \u2713 xtrm-tools plugin installed"));
+  console.log(t.warning("  \u21BB Restart Claude Code for the new plugin hooks to take effect"));
   await cleanStalePrePluginFiles(repoRoot, dryRun);
   await installOfficialClaudePlugins(false);
 }
@@ -41194,6 +41204,31 @@ function createInstallCommand() {
         }
       }
     }
+    if (!backport) {
+      console.log(t.bold("\n  \u2699  deepwiki  (AI-powered repo documentation)"));
+      const deepwikiOk = isDeepwikiInstalled();
+      if (deepwikiOk) {
+        console.log(t.success("  \u2713 deepwiki already installed\n"));
+      } else {
+        let doInstall = effectiveYes;
+        if (!effectiveYes) {
+          const { install } = await (0, import_prompts.default)({
+            type: "confirm",
+            name: "install",
+            message: "Install @seflless/deepwiki?",
+            initial: true
+          });
+          doInstall = install;
+        }
+        if (doInstall) {
+          console.log(t.muted("\n  Installing @seflless/deepwiki..."));
+          (0, import_child_process3.spawnSync)("npm", ["install", "-g", "@seflless/deepwiki"], { stdio: "inherit" });
+          console.log(t.success("  \u2713 deepwiki installed\n"));
+        } else {
+          console.log(t.muted("  \u2139 Skipped.\n"));
+        }
+      }
+    }
     if (!backport) {
       for (const _claudeTarget of claudeTargets) {
         await installPlugin(repoRoot, dryRun);
@@ -41303,14 +41338,15 @@ function resolveStatuslineScript() {
   const pluginsFile = import_node_path5.default.join((0, import_node_os5.homedir)(), ".claude", "plugins", "installed_plugins.json");
   try {
     const plugins = JSON.parse((0, import_node_fs4.readFileSync)(pluginsFile, "utf8"));
-    const entries = plugins?.plugins?.["xtrm-tools@xtrm-tools"];
-    if (entries?.length > 0) {
-      return import_node_path5.default.join(entries[0].installPath, "hooks", "statusline.mjs");
+    for (const [key, entries] of Object.entries(plugins?.plugins ?? {})) {
+      if (!key.startsWith("xtrm-tools@") || !entries?.length) continue;
+      const p = import_node_path5.default.join(entries[0].installPath, "hooks", "statusline.mjs");
+      if ((0, import_node_fs4.existsSync)(p)) return p;
     }
   } catch {
   }
   const fallback = import_node_path5.default.join((0, import_node_os5.homedir)(), ".claude", "hooks", "statusline.mjs");
-  return fallback;
+  return (0, import_node_fs4.existsSync)(fallback) ? fallback : null;
 }
 async function launchWorktreeSession(opts) {
   const { runtime, name } = opts;
@@ -55983,11 +56019,12 @@ var import_path18 = __toESM(require("path"), 1);
 var import_fs_extra17 = __toESM(require_lib2(), 1);
 var HOOK_CATALOG = [
   { file: "using-xtrm-reminder.mjs", event: "SessionStart", desc: "Injects using-xtrm session operating manual into system prompt" },
-  { file: "serena-workflow-reminder.py", event: "SessionStart", desc: "Injects Serena semantic editing workflow reminder" },
   { file: "gitnexus/gitnexus-hook.cjs", event: "PostToolUse", desc: "Adds GitNexus context for search and Serena tooling" },
-  { file: "branch-state.mjs", event: "UserPromptSubmit", desc: "Injects current git branch into prompt context" },
   { file: "quality-check.cjs", event: "PostToolUse", desc: "Runs JS/TS quality checks on mutating edits" },
   { file: "quality-check.py", event: "PostToolUse", desc: "Runs Python quality checks on mutating edits" },
+  { file: "quality-check-env.mjs", event: "SessionStart", desc: "Warns if tsc/ruff/eslint are missing at session start" },
+  { file: "worktree-boundary.mjs", event: "PreToolUse", desc: "Blocks edits outside .xtrm/worktrees when in worktree session" },
+  { file: "statusline.mjs", event: "statusLine", desc: "Renders 2-line status: XTRM model branch + claim/open issues" },
   { file: "beads-edit-gate.mjs", event: "PreToolUse", desc: "Blocks file edits if no beads issue is claimed", beads: true },
   { file: "beads-commit-gate.mjs", event: "PreToolUse", desc: "Blocks commits when no beads issue is in progress", beads: true },
   { file: "beads-stop-gate.mjs", event: "Stop", desc: "Blocks stop when there is an unclosed in_progress claim", beads: true },
@@ -56009,22 +56046,6 @@ async function readSkillsFromDir(dir) {
   }
   return skills;
 }
-async function readProjectSkillsFromDir(dir) {
-  if (!await import_fs_extra17.default.pathExists(dir)) return [];
-  const entries = await import_fs_extra17.default.readdir(dir);
-  const skills = [];
-  for (const name of entries.sort()) {
-    const readme = import_path18.default.join(dir, name, "README.md");
-    if (!await import_fs_extra17.default.pathExists(readme)) continue;
-    const content = await import_fs_extra17.default.readFile(readme, "utf8");
-    const descLine = content.split("\n").find((line) => {
-      const trimmed = line.trim();
-      return Boolean(trimmed) && !trimmed.startsWith("#") && !trimmed.startsWith("[") && !trimmed.startsWith("<");
-    }) || "";
-    skills.push({ name, desc: descLine.replace(/[*_`]/g, "").trim() });
-  }
-  return skills;
-}
 function resolvePkgRootFallback() {
   const candidates = [
     import_path18.default.resolve(__dirname, "../.."),
@@ -56048,9 +56069,7 @@ function createHelpCommand() {
     }
     const pkgRoot = resolvePkgRootFallback();
     const skillsRoot = repoRoot || pkgRoot || "";
-    const projectSkillsRoot = repoRoot || pkgRoot || "";
     const skills = skillsRoot ? await readSkillsFromDir(import_path18.default.join(skillsRoot, "skills")) : [];
-    const projectSkills = projectSkillsRoot ? await readProjectSkillsFromDir(import_path18.default.join(projectSkillsRoot, "project-skills")) : [];
     const W = 80;
     const hr = kleur_default.dim("-".repeat(W));
     const section = (title) => `
@@ -56059,24 +56078,11 @@ ${hr}`;
     const installSection = [
       section("INSTALL COMMANDS"),
       "",
-      `  ${kleur_default.bold("xtrm install all")}`,
-      `    ${kleur_default.dim("Global install: skills + all hooks (including beads gates) + MCP servers.")}`,
+      `  ${kleur_default.bold("xtrm install")}`,
+      `    ${kleur_default.dim("Install plugin + skills + hooks + MCP servers.")}`,
       `    ${kleur_default.dim("Checks for beads+dolt and prompts to install if missing.")}`,
       "",
-      `  ${kleur_default.bold("xtrm install basic")}`,
-      `    ${kleur_default.dim("Global install: skills + general hooks + MCP servers.")}`,
-      `    ${kleur_default.dim("No beads dependency -- safe to run with zero external deps.")}`,
-      "",
-      `  ${kleur_default.bold("xtrm install project")} ${kleur_default.dim("<tool-name | all>")}`,
-      `    ${kleur_default.dim("Project-scoped install into .claude/ of current git root.")}`,
-      `    ${kleur_default.dim("Run xtrm install project list to see available project skills.")}`,
-      "",
-      `  ${kleur_default.dim("Default target directories:")}`,
-      `    ${kleur_default.dim("~/.claude/hooks     (global hook scripts)")}`,
-      `    ${kleur_default.dim("~/.claude/skills    (global Claude skills)")}`,
-      `    ${kleur_default.dim("~/.agents/skills    (agents skills cache mirror)")}`,
-      "",
-      `  ${kleur_default.dim("Flags (all profiles): --dry-run  --yes / -y  --no-mcp  --force  --prune  --backport")}`
+      `  ${kleur_default.dim("Flags: --dry-run  --yes / -y  --no-mcp  --force  --prune  --backport")}`
     ].join("\n");
     const general = HOOK_CATALOG.filter((h) => !h.beads && !h.sessionFlow);
     const beads = HOOK_CATALOG.filter((h) => h.beads);
@@ -56106,23 +56112,14 @@ ${hr}`;
       "",
       skills.length ? skillRows : kleur_default.dim("  (none found -- run from repo root to see skills)")
     ].join("\n");
-    const psRows = projectSkills.map(
-      (s) => `  ${kleur_default.white(col(s.name, 30))}${kleur_default.dim(s.desc)}`
-    ).join("\n");
-    const psSection = [
-      section("PROJECT SKILLS + HOOKS"),
-      "",
-      projectSkills.length ? psRows : kleur_default.dim("  (none found in package)"),
-      "",
-      `  ${kleur_default.dim("Install: xtrm install project <name>  |  xtrm install project list")}`,
-      `  ${kleur_default.dim("Each project skill can install .claude/skills plus project hooks/settings.")}`
-    ].join("\n");
     const otherSection = [
       section("OTHER COMMANDS"),
       "",
       `  ${kleur_default.bold("xtrm status")}          ${kleur_default.dim("Show pending changes without applying them")}`,
       `  ${kleur_default.bold("xtrm clean")}           ${kleur_default.dim("Remove orphaned hooks and skills not in canonical repo")}`,
       `  ${kleur_default.bold("xtrm init")}            ${kleur_default.dim("Initialize project data (beads, gitnexus, service-registry)")}`,
+      `  ${kleur_default.bold("xtrm docs show")}       ${kleur_default.dim("Display frontmatter for README, CHANGELOG, docs/*.md")}`,
+      `  ${kleur_default.bold("xtrm debug")}           ${kleur_default.dim("Watch xtrm hook and bd lifecycle events in real time")}`,
       `  ${kleur_default.bold("xtrm reset")}           ${kleur_default.dim("Clear saved preferences and start fresh")}`,
       `  ${kleur_default.bold("xtrm end")}             ${kleur_default.dim("Close worktree session: rebase, push, PR, link issues, cleanup")}`,
       `  ${kleur_default.bold("xtrm worktree list")}   ${kleur_default.dim("List all active xt/* worktrees with status")}`,
@@ -56138,7 +56135,7 @@ ${hr}`;
       `  ${kleur_default.dim("Run 'xtrm <command> --help' for command-specific options.")}`,
       ""
     ].join("\n");
-    console.log([installSection, hooksSection, skillsSection, psSection, otherSection, resourcesSection].join("\n"));
+    console.log([installSection, hooksSection, skillsSection, otherSection, resourcesSection].join("\n"));
   });
 }
 
@@ -56908,30 +56905,66 @@ var import_node_child_process8 = require("child_process");
 var import_node_fs5 = require("fs");
 var import_node_path6 = require("path");
 var KIND_LABELS = {
-  "hook.edit_gate.allow": { label: "EDIT+", color: kleur_default.green },
-  "hook.edit_gate.block": { label: "EDIT-", color: kleur_default.red },
-  "hook.commit_gate.allow": { label: "CMIT+", color: kleur_default.green },
-  "hook.commit_gate.block": { label: "CMIT-", color: kleur_default.red },
-  "hook.stop_gate.allow": { label: "STOP+", color: kleur_default.green },
-  "hook.stop_gate.block": { label: "STOP-", color: kleur_default.red },
-  "hook.memory_gate.acked": { label: "MEMO+", color: kleur_default.green },
-  "hook.memory_gate.triggered": { label: "MEMO-", color: kleur_default.yellow },
-  "hook.worktree_boundary.block": { label: "WTRE-", color: kleur_default.red },
+  "session.start": { label: "SESS+", color: kleur_default.green },
+  "session.end": { label: "SESS-", color: kleur_default.white },
+  "gate.edit.allow": { label: "EDIT+", color: kleur_default.green },
+  "gate.edit.block": { label: "EDIT-", color: kleur_default.red },
+  "gate.commit.allow": { label: "CMIT+", color: kleur_default.green },
+  "gate.commit.block": { label: "CMIT-", color: kleur_default.red },
+  "gate.stop.block": { label: "STOP-", color: kleur_default.red },
+  "gate.memory.triggered": { label: "MEMO-", color: kleur_default.yellow },
+  "gate.memory.acked": { label: "MEMO+", color: kleur_default.green },
+  "gate.worktree.block": { label: "WTRE-", color: kleur_default.red },
   "bd.claimed": { label: "CLMD ", color: kleur_default.cyan },
   "bd.closed": { label: "CLSD ", color: kleur_default.green },
-  "bd.auto_committed": { label: "ACMT+", color: kleur_default.cyan }
+  "bd.committed": {
+    label: (outcome) => outcome === "error" ? "ACMT-" : "ACMT+",
+    color: (outcome) => outcome === "error" ? kleur_default.red : kleur_default.cyan
+  }
+};
+var TOOL_ABBREVS = {
+  Bash: "BASH",
+  bash: "BASH",
+  execute_shell_command: "BASH",
+  Read: "READ",
+  Write: "WRIT",
+  Edit: "EDIT",
+  MultiEdit: "EDIT",
+  NotebookEdit: "NTED",
+  Glob: "GLOB",
+  Grep: "GREP",
+  WebFetch: "WBFT",
+  WebSearch: "WSRC",
+  Agent: "AGNT",
+  Task: "TASK",
+  LSP: "LSP "
 };
-function getLabel(kind, outcome) {
-  const def = KIND_LABELS[kind];
+function toolAbbrev(toolName) {
+  if (TOOL_ABBREVS[toolName]) return TOOL_ABBREVS[toolName];
+  if (toolName.startsWith("mcp__serena__")) return "SRNA";
+  if (toolName.startsWith("mcp__gitnexus__")) return "GTNX";
+  if (toolName.startsWith("mcp__deepwiki__")) return "WIKI";
+  if (toolName.startsWith("mcp__")) return "MCP ";
+  return toolName.slice(0, 4).toUpperCase();
+}
+function getLabel(event) {
+  if (event.kind === "tool.call") {
+    const abbrev = toolAbbrev(event.tool_name ?? "").padEnd(5);
+    return event.outcome === "error" ? kleur_default.red(abbrev) : kleur_default.dim(abbrev);
+  }
+  const def = KIND_LABELS[event.kind];
   if (!def) {
-    const short = (kind.split(".").pop() ?? "UNKN").slice(0, 4).toUpperCase();
-    const label = `${short}${outcome === "block" ? "-" : "+"}`.padEnd(5);
-    return outcome === "block" ? kleur_default.red(label) : kleur_default.green(label);
+    const seg = (event.kind.split(".").pop() ?? "UNKN").slice(0, 4).toUpperCase();
+    const label = `${seg}${event.outcome === "block" ? "-" : "+"}`.padEnd(5);
+    return event.outcome === "block" ? kleur_default.red(label) : kleur_default.dim(label);
   }
-  if (kind === "bd.auto_committed") {
-    return outcome === "block" ? kleur_default.red("ACMT-") : kleur_default.cyan("ACMT+");
+  if (event.kind === "bd.committed") {
+    const label = event.outcome === "error" ? "ACMT-" : "ACMT+";
+    return event.outcome === "error" ? kleur_default.red(label) : kleur_default.cyan(label);
   }
-  return def.color(def.label);
+  return def.color(
+    def.label
+  );
 }
 var SESSION_COLORS = [
   kleur_default.blue,
@@ -56940,7 +56973,7 @@ var SESSION_COLORS = [
   kleur_default.cyan,
   kleur_default.magenta
 ];
-function buildSessionColorMap(events) {
+function buildColorMap(events) {
   const map2 = /* @__PURE__ */ new Map();
   for (const ev of events) {
     if (!map2.has(ev.session_id)) {
@@ -56949,194 +56982,123 @@ function buildSessionColorMap(events) {
   }
   return map2;
 }
-function extendSessionColorMap(map2, events) {
+function extendColorMap(map2, events) {
   for (const ev of events) {
     if (!map2.has(ev.session_id)) {
       map2.set(ev.session_id, SESSION_COLORS[map2.size % SESSION_COLORS.length]);
     }
   }
 }
-function fmtTime(created_at) {
-  try {
-    const d = new Date(created_at);
-    if (isNaN(d.getTime())) return created_at.slice(11, 19) || "??:??:??";
-    return d.toLocaleTimeString("en-GB", { hour12: false });
-  } catch {
-    return created_at.slice(11, 19) || "??:??:??";
-  }
+function fmtTime(ts) {
+  return new Date(ts).toLocaleTimeString("en-GB", { hour12: false });
 }
 function buildDetail(event) {
   const parts = [];
-  if (event.tool_name) parts.push(kleur_default.dim(`tool=${event.tool_name}`));
-  if (event.issue_id) parts.push(kleur_default.yellow(`issue=${event.issue_id}`));
-  if (event.worktree) parts.push(kleur_default.dim(`wt=${event.worktree}`));
+  let d = null;
+  if (event.data) {
+    try {
+      d = JSON.parse(event.data);
+    } catch {
+    }
+  }
+  if (event.kind === "tool.call") {
+    if (d?.cmd) parts.push(kleur_default.dim(d.cmd.slice(0, 72)));
+    if (d?.file) parts.push(kleur_default.dim((0, import_node_path6.basename)(d.file)));
+    if (d?.pattern) parts.push(kleur_default.dim(`/${d.pattern}/`));
+    if (d?.url) parts.push(kleur_default.dim(d.url.slice(0, 72)));
+    if (d?.query) parts.push(kleur_default.dim(d.query.slice(0, 72)));
+    if (d?.prompt) parts.push(kleur_default.dim(d.prompt.slice(0, 72)));
+  } else {
+    if (event.issue_id) parts.push(kleur_default.yellow(event.issue_id));
+    if (d?.file) parts.push(kleur_default.dim((0, import_node_path6.basename)(d.file)));
+    if (d?.reason_code) parts.push(kleur_default.dim(`[${d.reason_code}]`));
+    if (event.worktree) parts.push(kleur_default.dim(`wt:${event.worktree}`));
+  }
   return parts.join("  ") || kleur_default.dim("\u2014");
 }
-function formatEventLine(event, colorMap) {
-  const time3 = kleur_default.dim(fmtTime(event.created_at));
+function formatLine(event, colorMap) {
+  const time3 = kleur_default.dim(fmtTime(event.ts));
   const colorFn = colorMap.get(event.session_id) ?? kleur_default.white;
   const session = colorFn(event.session_id.slice(0, 8));
-  const label = getLabel(event.kind, event.outcome);
+  const label = getLabel(event);
   const detail = buildDetail(event);
-  return `${time3}  ${session}  ${label}  ${detail}`;
-}
-function printHeader() {
-  const h = kleur_default.dim;
-  console.log(`  ${h("TIME      ")}  ${h("SESSION ")}  ${h("LABEL")}  ${h("DETAIL")}`);
-  console.log(`  ${kleur_default.dim("\u2500".repeat(72))}`);
+  return `${time3} ${label} ${session}  ${detail}`;
 }
-function findProjectRoot(cwd) {
+function findDbPath(cwd) {
   let dir = cwd;
   for (let i = 0; i < 10; i++) {
-    if ((0, import_node_fs5.existsSync)((0, import_node_path6.join)(dir, ".beads"))) return dir;
+    if ((0, import_node_fs5.existsSync)((0, import_node_path6.join)(dir, ".beads"))) return (0, import_node_path6.join)(dir, ".xtrm", "debug.db");
     const parent = (0, import_node_path6.join)(dir, "..");
     if (parent === dir) break;
     dir = parent;
   }
   return null;
 }
-function parseBdTable(output, columns2) {
-  const lines = output.split("\n").map((l) => l.trim()).filter(Boolean);
-  const sepIdx = lines.findIndex((l) => /^[-+\s]+$/.test(l) && l.includes("-"));
-  if (sepIdx < 1) return [];
-  return lines.slice(sepIdx + 1).filter((l) => !l.startsWith("(")).map((line) => {
-    const cells = line.split("|").map((c) => c.trim());
-    const row = {};
-    columns2.forEach((col2, i) => {
-      row[col2] = cells[i] ?? "";
-    });
-    return row;
-  });
-}
-var COLS = "seq, id, created_at, runtime, session_id, worktree, layer, kind, outcome, tool_name, issue_id";
-var COL_NAMES = ["seq", "id", "created_at", "runtime", "session_id", "worktree", "layer", "kind", "outcome", "tool_name", "issue_id"];
-var ADD_SEQ_SQL = `ALTER TABLE xtrm_events ADD COLUMN seq INT NOT NULL AUTO_INCREMENT, ADD UNIQUE KEY uk_seq (seq)`;
-function queryEvents(cwd, where, limit) {
-  const sql = `SELECT ${COLS} FROM xtrm_events${where ? ` WHERE ${where}` : ""} ORDER BY seq ASC LIMIT ${limit}`;
-  let result = (0, import_node_child_process8.spawnSync)("bd", ["sql", sql], {
-    cwd,
-    stdio: ["pipe", "pipe", "pipe"],
-    encoding: "utf8",
-    timeout: 8e3
-  });
-  if (result.status !== 0) {
-    (0, import_node_child_process8.spawnSync)("bd", ["sql", ADD_SEQ_SQL], {
-      cwd,
-      stdio: ["pipe", "pipe", "pipe"],
-      encoding: "utf8",
-      timeout: 5e3
-    });
-    result = (0, import_node_child_process8.spawnSync)("bd", ["sql", sql], {
-      cwd,
-      stdio: ["pipe", "pipe", "pipe"],
-      encoding: "utf8",
-      timeout: 8e3
-    });
-  }
-  if (result.status !== 0) return [];
-  return parseBdTable(result.stdout, COL_NAMES).map((r) => ({
-    seq: parseInt(r.seq, 10) || 0,
-    id: r.id,
-    created_at: r.created_at,
-    runtime: r.runtime,
-    session_id: r.session_id,
-    worktree: r.worktree === "<nil>" || !r.worktree ? null : r.worktree,
-    layer: r.layer,
-    kind: r.kind,
-    outcome: r.outcome,
-    tool_name: r.tool_name === "<nil>" || !r.tool_name ? null : r.tool_name,
-    issue_id: r.issue_id === "<nil>" || !r.issue_id ? null : r.issue_id
-  }));
-}
-function buildWhere(opts, baseClause) {
+function buildWhere(opts, base) {
   const clauses = [];
-  if (baseClause) clauses.push(baseClause);
+  if (base) clauses.push(base);
   if (opts.session) {
     const s = opts.session.replace(/'/g, "''");
     clauses.push(`session_id LIKE '${s}%'`);
   }
   if (opts.type) {
-    const layer = opts.type.replace(/'/g, "''");
-    clauses.push(`layer = '${layer}'`);
-  }
-  return clauses.join(" AND ");
-}
-function follow(cwd, opts) {
-  const fiveMinsAgo = new Date(Date.now() - 5 * 60 * 1e3).toISOString().replace("T", " ").slice(0, 19);
-  const initial = queryEvents(cwd, buildWhere(opts, `created_at >= '${fiveMinsAgo}'`), 200);
-  const colorMap = buildSessionColorMap(initial);
-  let lastSeq = 0;
-  if (initial.length > 0) {
-    for (const ev of initial) {
-      if (ev.seq > lastSeq) lastSeq = ev.seq;
-      if (opts.json) {
-        console.log(JSON.stringify(ev));
-      } else {
-        console.log("  " + formatEventLine(ev, colorMap));
-      }
-    }
-  } else if (!opts.json) {
-    console.log(kleur_default.dim("  (no recent events \u2014 waiting for new ones)\n"));
+    const t3 = opts.type.replace(/'/g, "''");
+    clauses.push(`kind LIKE '${t3}.%' OR kind = '${t3}'`);
+  }
+  return clauses.length ? clauses.join(" AND ") : "";
+}
+function queryEvents(dbPath, where, limit) {
+  const sql = `SELECT id,ts,session_id,runtime,worktree,kind,tool_name,outcome,issue_id,duration_ms,data FROM events${where ? ` WHERE ${where}` : ""} ORDER BY id ASC LIMIT ${limit}`;
+  const result = (0, import_node_child_process8.spawnSync)("sqlite3", [dbPath, "-json", sql], {
+    stdio: ["pipe", "pipe", "pipe"],
+    encoding: "utf8",
+    timeout: 5e3
+  });
+  if (result.status !== 0 || !result.stdout.trim()) return [];
+  try {
+    return JSON.parse(result.stdout);
+  } catch {
+    return [];
+  }
+}
+function follow(dbPath, opts) {
+  const sinceTs = Date.now() - 5 * 60 * 1e3;
+  const initial = queryEvents(dbPath, buildWhere(opts, `ts >= ${sinceTs}`), 200);
+  const colorMap = buildColorMap(initial);
+  let lastId = 0;
+  for (const ev of initial) {
+    if (ev.id > lastId) lastId = ev.id;
+    opts.json ? console.log(JSON.stringify(ev)) : console.log(formatLine(ev, colorMap));
   }
   const interval = setInterval(() => {
-    const events = queryEvents(cwd, buildWhere(opts, `seq > ${lastSeq}`), 50);
+    const events = queryEvents(dbPath, buildWhere(opts, `id > ${lastId}`), 50);
     if (events.length > 0) {
-      extendSessionColorMap(colorMap, events);
+      extendColorMap(colorMap, events);
       for (const ev of events) {
-        if (ev.seq > lastSeq) lastSeq = ev.seq;
-        if (opts.json) {
-          console.log(JSON.stringify(ev));
-        } else {
-          console.log("  " + formatEventLine(ev, colorMap));
-        }
+        if (ev.id > lastId) lastId = ev.id;
+        opts.json ? console.log(JSON.stringify(ev)) : console.log(formatLine(ev, colorMap));
       }
     }
   }, 2e3);
   process.on("SIGINT", () => {
     clearInterval(interval);
-    if (!opts.json) console.log(kleur_default.dim("\n  stopped\n"));
     process.exit(0);
   });
 }
 function createDebugCommand() {
-  return new Command("debug").description("Watch xtrm hook and bd lifecycle events in real time").option("-f, --follow", "Follow new events (default when no other mode set)", false).option("--all", "Show full history and exit", false).option("--session <id>", "Filter by session ID (prefix match)").option("--type <layer>", "Filter by layer: gate | bd").option("--json", "Output raw JSON lines", false).action((opts) => {
+  return new Command("debug").description("Watch xtrm events: tool calls, gate decisions, bd lifecycle").option("-f, --follow", "Follow new events (default)", false).option("--all", "Show full history and exit", false).option("--session <id>", "Filter by session ID (prefix match)").option("--type <domain>", "Filter by domain: tool | gate | bd | session").option("--json", "Output raw JSON lines", false).action((opts) => {
     const cwd = process.cwd();
-    const root = findProjectRoot(cwd);
-    if (!root) {
-      console.error(kleur_default.red("\n  \u2717 No beads project found (.beads directory missing)\n"));
-      console.error(kleur_default.dim("  Run from inside an xtrm project.\n"));
-      process.exit(1);
-    }
-    if (!opts.json) {
-      console.log(kleur_default.bold("\n  xtrm event log"));
-      if (opts.all) {
-        console.log(kleur_default.dim("  Showing full history\n"));
-      } else {
-        console.log(kleur_default.dim("  Following events \u2014 Ctrl+C to stop\n"));
-      }
-      printHeader();
-    }
+    const dbPath = findDbPath(cwd);
+    if (!dbPath || !(0, import_node_fs5.existsSync)(dbPath)) return;
     if (opts.all) {
-      const events = queryEvents(root, buildWhere(opts, ""), 200);
-      if (events.length === 0) {
-        if (!opts.json) {
-          console.log(kleur_default.dim("\n  No events recorded yet."));
-          console.log(kleur_default.dim("  Events appear here as hooks fire and bd lifecycle runs.\n"));
-        }
-      } else {
-        const colorMap = buildSessionColorMap(events);
-        for (const ev of events) {
-          if (opts.json) {
-            console.log(JSON.stringify(ev));
-          } else {
-            console.log("  " + formatEventLine(ev, colorMap));
-          }
-        }
-        if (!opts.json) console.log("");
+      const events = queryEvents(dbPath, buildWhere(opts, ""), 1e3);
+      const colorMap = buildColorMap(events);
+      for (const ev of events) {
+        opts.json ? console.log(JSON.stringify(ev)) : console.log(formatLine(ev, colorMap));
       }
       return;
     }
-    follow(root, opts);
+    follow(dbPath, opts);
   });
 }
 
@@ -57359,8 +57321,9 @@ process.on("unhandledRejection", (reason) => {
   process.exit(1);
 });
 var isHelpOrVersion = process.argv.some((a) => a === "--help" || a === "-h" || a === "--version" || a === "-V");
+var isViewerCommand = ["debug", "status"].includes(process.argv[2] ?? "");
 (async () => {
-  if (!isHelpOrVersion) {
+  if (!isHelpOrVersion && !isViewerCommand) {
     await printBanner(version2);
   }
   program2.parseAsync(process.argv);