@rejacky/opencode-insights 0.1.3 → 0.1.5

package/dist/cli.js

@@ -1,7 +1,8 @@
 #!/usr/bin/env node
 import {
+  openDatabase,
   resolveCapturePath
-} from "./chunk-Q5ROKOOJ.js";
+} from "./chunk-PBX4AJCR.js";
 
 // src/cli.ts
 import { execFile as execFile2 } from "child_process";
@@ -48,12 +49,55 @@ async function readRecentCaptures(options = {}) {
   const records = parseJsonlRecords(await readFile(jsonlPath, "utf8"));
   return records.slice(-Math.max(1, options.limit ?? 20)).reverse();
 }
+async function readViewerCaptures(options = {}) {
+  const dbPath = resolveCapturePath(options);
+  const sqliteRecords = await readSqliteViewerCaptures(dbPath, options.limit ?? 5e3);
+  if (sqliteRecords) return sqliteRecords;
+  const jsonlPath = dbPath.endsWith(".sqlite") ? `${dbPath}.jsonl` : dbPath;
+  if (!existsSync(jsonlPath)) return [];
+  const records = parseJsonlRecords(await readFile(jsonlPath, "utf8"));
+  return records.filter((record) => isViewerCaptureKind(record.kind)).slice(-Math.max(1, options.limit ?? 5e3)).reverse();
+}
+async function readCaptureRecord(id, options = {}) {
+  const dbPath = resolveCapturePath(options);
+  if (!existsSync(dbPath)) return void 0;
+  try {
+    const db = await openDatabase(dbPath);
+    if (db) {
+      try {
+        const rows = db.all("select id, kind, timestamp, session_id, message_id, provider_id, model_id, payload_json from captures where id = ?", id);
+        const row = rows[0];
+        if (!row) return void 0;
+        return rowToCapture(row);
+      } finally {
+        db.close();
+      }
+    }
+  } catch {
+  }
+  try {
+    const escapedId = id.replace(/'/g, "'\\''");
+    const { stdout } = await execFileAsync("sqlite3", [
+      "-json",
+      dbPath,
+      `select id, kind, timestamp, session_id, message_id, provider_id, model_id, payload_json from captures where id = '${escapedId}'`
+    ], { maxBuffer: 128 * 1024 * 1024 });
+    if (!stdout.trim()) return void 0;
+    const rows = JSON.parse(stdout);
+    const row = rows[0];
+    if (!row) return void 0;
+    return rowToCapture(row);
+  } catch {
+    return void 0;
+  }
+}
 function buildRequestHistory(records) {
   const sessions = /* @__PURE__ */ new Map();
   const messages = /* @__PURE__ */ new Map();
   const responses = /* @__PURE__ */ new Map();
-  const responseByParent = /* @__PURE__ */ new Map();
+  const responsesByParent = /* @__PURE__ */ new Map();
   const requests = [];
+  const pendingSystemTransforms = [];
   const getSession = (sessionID) => {
     const existing = sessions.get(sessionID);
     if (existing) return existing;
@@ -84,7 +128,27 @@ function buildRequestHistory(records) {
     responses.set(key, created);
     return created;
   };
-  for (const record of records.slice().sort((a, b) => a.timestamp - b.timestamp)) {
+  const addRequest = (request) => {
+    requests.push(request);
+    if (request.sessionID) {
+      getSession(request.sessionID).requests.push(request);
+      if (request.messageID) getMessage(request.sessionID, request.messageID, "user").requests.push(request);
+    }
+  };
+  const addResponseByParent = (response) => {
+    if (!response.parentID) return;
+    const key = `${response.sessionID}:${response.parentID}`;
+    const parentResponses = responsesByParent.get(key) ?? [];
+    if (!parentResponses.includes(response)) parentResponses.push(response);
+    responsesByParent.set(key, parentResponses);
+  };
+  const updateSessionPath = (session, path) => {
+    if (!isRecord(path)) return;
+    session.cwd = optionalString(path.cwd) ?? session.cwd;
+    session.root = optionalString(path.root) ?? session.root;
+    session.project = projectName(session.root) ?? projectName(session.cwd) ?? session.project;
+  };
+  for (const record of records.slice().sort((a, b) => a.timestamp - b.timestamp || a.id.localeCompare(b.id))) {
     if (record.sessionID) getSession(record.sessionID);
     if (record.kind === "chat.message") {
       const message = historyMessageFromChatMessage(record);
@@ -99,10 +163,11 @@ function buildRequestHistory(records) {
       if (!request.messageID && request.sessionID) {
         request.messageID = latestUserMessageBefore(messages, request.sessionID, request.timestamp)?.id;
       }
-      requests.push(request);
-      if (request.sessionID) {
-        getSession(request.sessionID).requests.push(request);
-        if (request.messageID) getMessage(request.sessionID, request.messageID, "user").requests.push(request);
+      if (record.kind === "experimental.chat.system.transform") {
+        pendingSystemTransforms.push(request);
+      } else {
+        attachPendingSystemTransform(pendingSystemTransforms, request);
+        addRequest(request);
       }
     }
     if (record.kind === "chat.headers") {
@@ -118,8 +183,10 @@ function buildRequestHistory(records) {
       const sessionID = optionalString(info.id) ?? optionalString(properties.sessionID);
       if (!sessionID) continue;
       const session = getSession(sessionID);
+      session.parentID = optionalString(info.parentID) ?? session.parentID;
       session.title = optionalString(info.title) ?? session.title;
       session.updatedAt = numberFromPath(info.time, "updated") ?? session.updatedAt;
+      updateSessionPath(session, info.path);
       continue;
     }
     if (type === "message.updated") {
@@ -128,6 +195,7 @@ function buildRequestHistory(records) {
       const messageID = optionalString(info.id);
       if (!sessionID || !messageID) continue;
       const role = optionalString(info.role) ?? "unknown";
+      updateSessionPath(getSession(sessionID), info.path);
       if (role === "assistant") {
         const response = getResponse(sessionID, messageID, role);
         response.createdAt = numberFromPath(info.time, "created") ?? response.createdAt;
@@ -137,7 +205,7 @@ function buildRequestHistory(records) {
         response.cost = typeof info.cost === "number" ? info.cost : response.cost;
         response.finish = optionalString(info.finish) ?? response.finish;
         response.events.push(record.payload);
-        if (response.parentID) responseByParent.set(`${sessionID}:${response.parentID}`, response);
+        addResponseByParent(response);
         continue;
       }
       const message = getMessage(sessionID, messageID, role);
@@ -169,11 +237,18 @@ function buildRequestHistory(records) {
       message.text = text;
     }
   }
+  for (const request of pendingSystemTransforms) addRequest(request);
   for (const session of sessions.values()) {
     for (const message of session.messages) {
-      message.response = responseByParent.get(`${message.sessionID}:${message.id}`);
-      for (const request of message.requests) {
-        if (requestShouldOwnAssistantResponse(request)) request.response = message.response;
+      const messageResponses = (responsesByParent.get(`${message.sessionID}:${message.id}`) ?? []).sort(
+        (a, b) => (a.createdAt ?? 0) - (b.createdAt ?? 0)
+      );
+      message.response = messageResponses.at(-1);
+      let responseIndex = 0;
+      for (const request of message.requests.slice().sort((a, b) => a.timestamp - b.timestamp)) {
+        if (!requestShouldOwnAssistantResponse(request)) continue;
+        request.response = messageResponses[responseIndex] ?? message.response;
+        if (responseIndex < messageResponses.length) responseIndex += 1;
       }
     }
     session.messages.sort((a, b) => (a.createdAt ?? 0) - (b.createdAt ?? 0));
@@ -187,11 +262,10 @@ function buildRequestHistory(records) {
 async function readSqliteCaptures(path, limit) {
   if (!existsSync(path)) return void 0;
   try {
-    const mod = await import("bun:sqlite").catch(() => void 0);
-    if (!mod) return readSqliteCapturesWithCli(path, limit);
-    const db = new mod.Database(path, { readonly: true });
+    const db = await openDatabase(path);
+    if (!db) return readSqliteCapturesWithCli(path, limit);
     try {
-      const rows = db.query(recentCaptureSql(Math.max(1, limit))).all();
+      const rows = db.all(recentCaptureSql(Math.max(1, limit)));
       return dedupeRows(rows).map(rowToCapture);
     } finally {
       db.close();
@@ -212,18 +286,71 @@ async function readSqliteCapturesWithCli(path, limit) {
     return void 0;
   }
 }
+async function readSqliteViewerCaptures(path, limit) {
+  if (!existsSync(path)) return void 0;
+  try {
+    const db = await openDatabase(path);
+    if (!db) return readSqliteViewerCapturesWithCli(path, limit);
+    try {
+      const rows = db.all(viewerCaptureSql(Math.max(1, limit)));
+      return dedupeRows(rows).map(rowToCapture);
+    } finally {
+      db.close();
+    }
+  } catch {
+    return readSqliteViewerCapturesWithCli(path, limit);
+  }
+}
+async function readSqliteViewerCapturesWithCli(path, limit) {
+  if (!existsSync(path)) return void 0;
+  try {
+    const { stdout } = await execFileAsync("sqlite3", ["-json", path, viewerCaptureSql(Math.max(1, Math.trunc(limit)))], {
+      maxBuffer: 128 * 1024 * 1024
+    });
+    if (!stdout.trim()) return [];
+    return dedupeRows(JSON.parse(stdout)).map(rowToCapture);
+  } catch {
+    return void 0;
+  }
+}
 function recentCaptureSql(limit) {
   return `select id, kind, timestamp, session_id, message_id, provider_id, model_id, payload_json
           from captures
           where id in (
-            select id from captures order by timestamp desc limit ${limit}
+            select id from captures
+            where kind in (
+              'chat.params',
+              'chat.message',
+              'chat.headers',
+              'experimental.chat.messages.transform',
+              'experimental.chat.system.transform'
+            )
+            order by timestamp desc
+            limit ${limit}
           )
           or id in (
+            select id from captures
+            where kind = 'event'
+              and json_extract(payload_json, '$.event.type') in (
+                'message.updated',
+                'message.part.updated',
+                'message.part.delta',
+                'session.updated',
+                'session.created'
+              )
+            order by timestamp desc
+            limit ${limit}
+          )
+          order by timestamp desc`;
+}
+function viewerCaptureSql(limit) {
+  return `select id, kind, timestamp, session_id, message_id, provider_id, model_id, payload_json
+          from captures
+          where id in (
             select id from captures
             where kind in (
               'chat.params',
               'chat.message',
-              'experimental.chat.messages.transform',
               'experimental.chat.system.transform'
             )
             order by timestamp desc
@@ -232,12 +359,21 @@ function recentCaptureSql(limit) {
           or id in (
             select id from captures
             where kind = 'event'
-              and json_extract(payload_json, '$.event.type') in ('message.updated', 'message.part.updated', 'message.part.delta')
+              and json_extract(payload_json, '$.event.type') in (
+                'message.updated',
+                'message.part.updated',
+                'message.part.delta',
+                'session.updated',
+                'session.created'
+              )
             order by timestamp desc
             limit ${limit}
           )
           order by timestamp desc`;
 }
+function isViewerCaptureKind(kind) {
+  return kind === "chat.params" || kind === "chat.message" || kind === "experimental.chat.system.transform" || kind === "event";
+}
 function dedupeRows(rows) {
   const seen = /* @__PURE__ */ new Set();
   return rows.filter((row) => {
@@ -297,18 +433,21 @@ function agentFromCapture(record, input) {
   return optionalString(input.agent);
 }
 function messageIDForCapture(record, input) {
-  if (record.kind === "experimental.chat.messages.transform") {
-    return latestUserMessageIDFromTransform(record.payload.output) ?? record.messageID;
-  }
   return record.messageID ?? messageIDFromPayload(input.message);
 }
-function latestUserMessageIDFromTransform(output) {
-  if (!isRecord(output) || !Array.isArray(output.messages)) return void 0;
-  for (const message of output.messages.slice().reverse()) {
-    if (!isRecord(message) || !isRecord(message.info)) continue;
-    if (optionalString(message.info.role) === "user") return optionalString(message.info.id);
+function attachPendingSystemTransform(pendingSystemTransforms, request) {
+  let index = -1;
+  for (let candidateIndex = pendingSystemTransforms.length - 1; candidateIndex >= 0; candidateIndex -= 1) {
+    const candidate = pendingSystemTransforms[candidateIndex];
+    if (candidate && candidate.sessionID === request.sessionID && candidate.providerID === request.providerID && candidate.modelID === request.modelID && candidate.timestamp <= request.timestamp && request.timestamp - candidate.timestamp <= 5e3) {
+      index = candidateIndex;
+      break;
+    }
   }
-  return void 0;
+  if (index < 0) return;
+  const [system] = pendingSystemTransforms.splice(index, 1);
+  if (!system) return;
+  request.system = { id: system.id, timestamp: system.timestamp, payload: system.payload };
 }
 function latestUserMessageBefore(messages, sessionID, timestamp) {
   let latest;
@@ -373,6 +512,12 @@ function findFirstString(value, keys) {
   }
   return void 0;
 }
+function projectName(path) {
+  if (!path) return void 0;
+  const normalized = path.replace(/\/+$/, "");
+  if (!normalized) return void 0;
+  return normalized.split("/").filter(Boolean).at(-1) ?? normalized;
+}
 function numberFromPath(value, key) {
   if (!isRecord(value)) return void 0;
   const item = value[key];
@@ -381,6 +526,7 @@ function numberFromPath(value, key) {
 
 // src/viewer.ts
 import { createServer } from "http";
+var REQUEST_PATH_RE = /^\/api\/request\/(.+)$/;
 async function serveViewer(options = {}) {
   const host = options.host ?? "127.0.0.1";
   const port = options.port ?? 8765;
@@ -391,6 +537,21 @@ async function serveViewer(options = {}) {
       sendJson(response, history);
       return;
     }
+    const requestMatch = REQUEST_PATH_RE.exec(url.pathname);
+    if (requestMatch) {
+      const requestId = requestMatch[1];
+      if (!requestId) {
+        sendJson(response, { error: "not found" });
+        return;
+      }
+      const record = await readCaptureRecord(requestId, options);
+      if (!record) {
+        sendJson(response, { error: "not found" });
+        return;
+      }
+      sendJson(response, record.payload);
+      return;
+    }
     if (url.pathname === "/" || url.pathname === "/index.html") {
       sendHtml(response, renderViewerHtml(resolveCapturePath(options)));
       return;
@@ -416,8 +577,152 @@ async function readHistory(options = {}) {
     dbPath: options.dbPath,
     limit: options.limit ?? 5e3
   };
-  const records = await readRecentCaptures(readOptions);
-  return buildRequestHistory(records);
+  const records = await readViewerCaptures(readOptions);
+  const history = buildRequestHistory(records);
+  prepareHistoryForViewer(history);
+  stripPayloadsForViewer(history);
+  return history;
+}
+function prepareHistoryForViewer(history) {
+  for (const session of history.sessions) {
+    for (const message of session.messages) {
+      const viewerMessage = message;
+      viewerMessage.visibleSteps = buildViewerVisibleSteps(message);
+      viewerMessage.hiddenContexts = buildViewerHiddenContexts(message);
+    }
+  }
+}
+function stripPayloadsForViewer(history) {
+  history.requests = history.requests.map(viewerRequestSummary);
+  for (const session of history.sessions) {
+    session.requests = [];
+    for (const message of session.messages) {
+      message.requests = [];
+      message.response = void 0;
+    }
+  }
+}
+function buildViewerVisibleSteps(message) {
+  const steps = [];
+  for (const request of (message.requests || []).filter((item) => item.agent !== "title" && item.agent !== "messages.transform")) {
+    const label = [request.agent || "agent", request.providerID, request.modelID].filter(Boolean).join(" \xB7 ");
+    const response = request.response;
+    const reasoning = response?.reasoning;
+    const text = response?.text;
+    if (reasoning) {
+      steps.push({ label: `${label} thinking`, text: reasoning });
+    }
+    for (const tool of viewerToolSteps(response)) {
+      steps.push({ label: `${label} tool`, text: tool });
+    }
+    if (text && normalizeDisplayText(text) !== normalizeDisplayText(reasoning)) {
+      steps.push({ label: `${label} response`, text });
+    }
+    if (!reasoning && !text && viewerToolSteps(response).length === 0) {
+      steps.push({ label, text: "Model step captured, but no visible thinking or response text was recorded." });
+    }
+  }
+  return steps;
+}
+function buildViewerHiddenContexts(message) {
+  const contexts = /* @__PURE__ */ new Map();
+  for (const request of message.requests || []) {
+    const step = [request.agent || "agent", request.providerID, request.modelID].filter(Boolean).join(" \xB7 ");
+    if (request.system?.payload?.output) {
+      addHiddenContext(contexts, "System Transform Output", step, request.system.payload.output);
+    }
+    if (request.agent === "messages.transform" && request.payload) {
+      addHiddenContext(contexts, "Messages Transform Output", step, request.payload.output || request.payload);
+    }
+  }
+  return [...contexts.values()];
+}
+function addHiddenContext(contexts, title, step, value) {
+  const text = hiddenContextText(value);
+  if (!text) return;
+  const key = `${title}:${normalizeDisplayText(text)}`;
+  const existing = contexts.get(key);
+  if (existing) {
+    existing.count += 1;
+    if (!existing.step.split(", ").includes(step)) existing.step = `${existing.step}, ${step}`;
+    return;
+  }
+  contexts.set(key, {
+    title,
+    step,
+    preview: previewText(text, 180),
+    text,
+    count: 1
+  });
+}
+function hiddenContextText(value) {
+  if (typeof value === "string") return value;
+  if (Array.isArray(value)) return value.map(hiddenContextText).filter(Boolean).join("\n\n");
+  if (!isRecord2(value)) return value === void 0 || value === null ? "" : String(value);
+  if (value.system !== void 0) return hiddenContextText(value.system);
+  if (Array.isArray(value.messages)) {
+    return value.messages.map(messageContextText).filter(Boolean).join("\n\n");
+  }
+  const strings = collectStrings(value);
+  return strings.length ? strings.join("\n\n") : JSON.stringify(value, null, 2);
+}
+function messageContextText(value) {
+  if (!isRecord2(value)) return hiddenContextText(value);
+  const info = isRecord2(value.info) ? value.info : {};
+  const role = typeof info.role === "string" ? info.role : "message";
+  const parts = Array.isArray(value.parts) ? value.parts : [];
+  const text = parts.map(partText).filter(Boolean).join("\n");
+  return text ? `${role}: ${text}` : `${role}: ${hiddenContextText(value)}`;
+}
+function partText(value) {
+  if (!isRecord2(value)) return "";
+  return typeof value.text === "string" ? value.text : typeof value.content === "string" ? value.content : "";
+}
+function viewerToolSteps(response) {
+  const tools = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const wrapper of response?.events || []) {
+    const event = isRecord2(wrapper.event) ? wrapper.event : void 0;
+    const properties = isRecord2(event?.properties) ? event.properties : void 0;
+    const part = isRecord2(properties?.part) ? properties.part : void 0;
+    if (event?.type !== "message.part.updated" || part?.type !== "tool") continue;
+    const state = isRecord2(part.state) ? part.state : void 0;
+    const key = [part.id, part.tool, state?.status].filter(Boolean).join(":");
+    if (seen.has(key)) continue;
+    seen.add(key);
+    tools.push([part.tool || "tool", state?.status].filter(Boolean).join(" \xB7 "));
+  }
+  return tools;
+}
+function collectStrings(value) {
+  if (typeof value === "string") return [value];
+  if (Array.isArray(value)) return value.flatMap(collectStrings);
+  if (!isRecord2(value)) return [];
+  return Object.values(value).flatMap(collectStrings);
+}
+function previewText(value, size) {
+  const text = normalizeDisplayText(value);
+  return text.length > size ? `${text.slice(0, size - 1)}...` : text || "(empty)";
+}
+function normalizeDisplayText(value) {
+  return String(value || "").replace(/\s+/g, " ").trim();
+}
+function isRecord2(value) {
+  return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function viewerRequestSummary(request) {
+  return {
+    id: request.id,
+    sessionID: request.sessionID,
+    messageID: request.messageID,
+    timestamp: request.timestamp,
+    agent: request.agent,
+    purpose: request.purpose,
+    providerID: request.providerID,
+    modelID: request.modelID,
+    summary: request.summary,
+    payload: {}
+  };
 }
 function sendJson(response, value) {
   response.writeHead(200, { "content-type": "application/json; charset=utf-8" });
@@ -439,8 +744,11 @@ function renderViewerHtml(dbPath) {
     :root {
       color-scheme: dark;
       --bg: #101214;
+      --header: #0d0f11;
       --panel: #171a1d;
       --panel-2: #20242a;
+      --surface: #0b0d0f;
+      --field: #0d0f11;
       --line: #30363d;
       --text: #eef2f5;
       --muted: #9aa6b2;
@@ -448,6 +756,32 @@ function renderViewerHtml(dbPath) {
       --ok: #86efac;
       --warn: #fbbf24;
       --bad: #fca5a5;
+      --pill-text: #0d0f11;
+      --json-key: #bae6fd;
+      --json-string: #bbf7d0;
+      --json-number: #fde68a;
+      --json-boolean: #f0abfc;
+    }
+    body[data-theme="light"] {
+      color-scheme: light;
+      --bg: #f6f7f9;
+      --header: #ffffff;
+      --panel: #ffffff;
+      --panel-2: #edf2f7;
+      --surface: #ffffff;
+      --field: #ffffff;
+      --line: #d7dde5;
+      --text: #18212f;
+      --muted: #667085;
+      --accent: #2563eb;
+      --ok: #16a34a;
+      --warn: #b45309;
+      --bad: #dc2626;
+      --pill-text: #ffffff;
+      --json-key: #1d4ed8;
+      --json-string: #15803d;
+      --json-number: #a16207;
+      --json-boolean: #9333ea;
     }
     * { box-sizing: border-box; }
     body {
@@ -465,9 +799,35 @@ function renderViewerHtml(dbPath) {
       gap: 16px;
       padding: 0 18px;
       border-bottom: 1px solid var(--line);
-      background: #0d0f11;
+      background: var(--header);
     }
     h1 { margin: 0; font-size: 15px; font-weight: 700; }
+    .brand, .header-side {
+      display: flex;
+      align-items: center;
+      gap: 14px;
+      min-width: 0;
+    }
+    .header-meta { min-width: 0; }
+    .theme-toggle {
+      display: inline-flex;
+      gap: 2px;
+      padding: 3px;
+      border: 1px solid var(--line);
+      border-radius: 8px;
+      background: var(--panel);
+    }
+    .theme-toggle button {
+      padding: 5px 8px;
+      border: 0;
+      border-radius: 5px;
+      background: transparent;
+      color: var(--muted);
+    }
+    .theme-toggle button.active {
+      background: var(--panel-2);
+      color: var(--text);
+    }
     main {
       display: grid;
       grid-template-columns: 300px minmax(340px, 0.95fr) minmax(460px, 1.25fr);
@@ -486,15 +846,17 @@ function renderViewerHtml(dbPath) {
       border-bottom: 1px solid var(--line);
       z-index: 2;
     }
-    input {
+    input, select {
       width: 100%;
       border: 1px solid var(--line);
-      background: #0d0f11;
+      background: var(--field);
       color: var(--text);
       border-radius: 6px;
       padding: 8px 10px;
       font: inherit;
     }
+    select { cursor: pointer; }
+    .toolbar.stack { flex-direction: column; }
     button {
       border: 1px solid var(--line);
       background: var(--panel-2);
@@ -517,7 +879,7 @@ function renderViewerHtml(dbPath) {
       padding: 11px 12px;
     }
     .item:hover, .item.active { background: var(--panel-2); }
-    .request-item { padding-left: 28px; }
+    .session-child { padding-left: 28px; }
     .title { color: var(--text); white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
     .meta {
       margin-top: 4px;
@@ -528,7 +890,7 @@ function renderViewerHtml(dbPath) {
     }
     .muted { color: var(--muted); }
     .pill {
-      color: #0d0f11;
+      color: var(--pill-text);
       background: var(--accent);
       border-radius: 999px;
       padding: 1px 6px;
@@ -548,7 +910,7 @@ function renderViewerHtml(dbPath) {
       overflow: auto;
       white-space: pre-wrap;
       word-break: break-word;
-      background: #0b0d0f;
+      background: var(--surface);
       border: 1px solid var(--line);
       border-radius: 8px;
       min-height: 220px;
@@ -567,14 +929,45 @@ function renderViewerHtml(dbPath) {
       color: var(--text);
       font-weight: 700;
     }
+    .step {
+      margin: 0 0 10px;
+      padding: 12px;
+      border: 1px solid var(--line);
+      border-radius: 8px;
+      background: var(--surface);
+    }
+    .step-label {
+      color: var(--accent);
+      font-weight: 700;
+      margin-bottom: 6px;
+    }
+    .step-text { white-space: pre-wrap; word-break: break-word; }
+    details.hidden-context {
+      margin: 10px 0;
+      border: 1px solid var(--line);
+      border-radius: 8px;
+      background: var(--surface);
+    }
+    details.hidden-context summary {
+      cursor: pointer;
+      padding: 10px 12px;
+      color: var(--accent);
+    }
+    .hidden-body { padding: 0 12px 12px; }
+    .hidden-text {
+      margin: 0;
+      white-space: pre-wrap;
+      word-break: break-word;
+      color: var(--text);
+    }
     .json-tree { font-size: 12px; line-height: 1.55; }
     .json-tree details { margin-left: 14px; }
     .json-tree summary { cursor: pointer; color: var(--accent); }
     .json-tree .leaf { margin-left: 14px; }
-    .json-key { color: #bae6fd; }
-    .json-string { color: #bbf7d0; }
-    .json-number { color: #fde68a; }
-    .json-boolean { color: #f0abfc; }
+    .json-key { color: var(--json-key); }
+    .json-string { color: var(--json-string); }
+    .json-number { color: var(--json-number); }
+    .json-boolean { color: var(--json-boolean); }
     .json-null { color: var(--muted); }
     @media (max-width: 1000px) {
       main { grid-template-columns: 1fr; height: auto; }
@@ -582,38 +975,44 @@ function renderViewerHtml(dbPath) {
     }
   </style>
 </head>
-<body>
+<body data-theme="dark">
   <header>
-    <h1>OpenCode Insights</h1>
-    <div>
-      <div class="meta">${escapedDbPath}</div>
-      <div id="status" class="status">Loading history...</div>
+    <div class="brand">
+      <h1>OpenCode Insights</h1>
+      <div id="theme-toggle" class="theme-toggle" aria-label="Theme">
+        <button type="button" data-theme-option="dark">Dark</button>
+        <button type="button" data-theme-option="light">Light</button>
+      </div>
+    </div>
+    <div class="header-side">
+      <div class="header-meta">
+        <div class="meta">${escapedDbPath}</div>
+        <div id="status" class="status">Loading history...</div>
+      </div>
     </div>
   </header>
   <main>
     <section>
-      <div class="toolbar"><input id="session-filter" placeholder="Filter sessions"></div>
+      <div class="toolbar stack">
+        <select id="project-filter"><option value="">All projects</option></select>
+        <input id="session-filter" placeholder="Filter sessions">
+      </div>
       <div id="sessions"></div>
     </section>
     <section>
-      <div class="toolbar"><input id="timeline-filter" placeholder="Filter messages and hooks"></div>
+      <div class="toolbar"><input id="timeline-filter" placeholder="Filter conversation"></div>
       <div id="timeline"></div>
     </section>
     <section>
       <div class="toolbar">
-        <button id="copy">Copy JSON</button>
+        <button id="copy">Copy Summary</button>
         <button id="refresh">Refresh</button>
       </div>
       <div class="detail">
         <div class="tabs">
           <button data-tab="summary" class="active">Summary</button>
-          <button data-tab="request">Request</button>
-          <button data-tab="response">Response</button>
-          <button data-tab="raw">Raw</button>
-          <button id="expand-json" class="json-control">Expand All</button>
-          <button id="collapse-json" class="json-control">Collapse All</button>
         </div>
-        <div id="detail" class="panel">Select a message or request.</div>
+        <div id="detail" class="panel">Select a user message.</div>
       </div>
     </section>
   </main>
@@ -624,11 +1023,14 @@ function renderViewerHtml(dbPath) {
       messageID: null,
       requestID: null,
       tab: "summary",
+      project: "",
       loading: true,
       error: null,
-      loadedMs: 0
+      loadedMs: 0,
+      payloadCache: {}
     };
 
+    const THEME_KEY = "opencode-insights-theme";
     const qs = (id) => document.getElementById(id);
     const fmt = (ms) => ms ? new Date(ms).toLocaleString() : "-";
     const short = (value, size = 90) => {
@@ -636,11 +1038,20 @@ function renderViewerHtml(dbPath) {
       return text.length > size ? text.slice(0, size - 1) + "..." : text;
     };
 
+    function applyTheme(theme) {
+      const next = theme === "light" ? "light" : "dark";
+      document.body.dataset.theme = next;
+      localStorage.setItem(THEME_KEY, next);
+      for (const item of document.querySelectorAll("[data-theme-option]")) {
+        item.classList.toggle("active", item.dataset.themeOption === next);
+      }
+    }
+
     async function load() {
       state.loading = true;
       state.error = null;
       renderStatus();
-      qs("sessions").innerHTML = '<div class="empty">Loading sessions and hooks...</div>';
+      qs("sessions").innerHTML = '<div class="empty">Loading sessions...</div>';
       qs("timeline").innerHTML = '<div class="empty">Waiting for history data...</div>';
       try {
         const started = performance.now();
@@ -654,8 +1065,9 @@ function renderViewerHtml(dbPath) {
           state.messageID = null;
           state.requestID = null;
         }
+        renderProjectOptions();
         const session = selectedSession();
-        if (session && !state.messageID && session.messages[0]) state.messageID = session.messages[0].id;
+        if (session && !state.messageID) state.messageID = firstUserMessage(session)?.id || null;
       } catch (error) {
         state.error = error instanceof Error ? error.message : String(error);
       } finally {
@@ -673,17 +1085,8 @@ function renderViewerHtml(dbPath) {
       return session?.messages.find((message) => message.id === state.messageID) || null;
     }
 
-    function selectedRequest() {
-      const message = selectedMessage();
-      return message?.requests.find((request) => request.id === state.requestID)
-        || state.history.requests.find((request) => request.id === state.requestID)
-        || null;
-    }
-
-    function activeContext() {
-      const message = selectedMessage();
-      const request = selectedRequest();
-      return { message, request: request || message?.requests[0] || null };
+    function firstUserMessage(session) {
+      return session?.messages.find((message) => message.role === "user") || session?.messages[0] || null;
     }
 
     function render() {
@@ -704,33 +1107,67 @@ function renderViewerHtml(dbPath) {
       status.classList.toggle("error", Boolean(state.error));
       if (state.error) status.textContent = "Load failed";
       else if (state.loading) status.textContent = "Loading history...";
-      else status.textContent = state.history.sessions.length + " sessions \xB7 " + state.history.requests.length + " hooks \xB7 " + state.loadedMs + "ms";
+      else status.textContent = state.history.sessions.length + " sessions \xB7 " + state.history.requests.length + " model steps \xB7 " + state.loadedMs + "ms";
       qs("refresh").disabled = state.loading;
       qs("refresh").textContent = state.loading ? "Loading..." : "Refresh";
     }
 
+    function renderProjectOptions() {
+      const select = qs("project-filter");
+      const current = state.project;
+      const projects = [...new Set(state.history.sessions.map((session) => session.project || session.cwd || "Unknown").filter(Boolean))].sort();
+      select.innerHTML = '<option value="">All projects</option>' + projects.map((project) =>
+        '<option value="' + escapeAttr(project) + '">' + escapeHtml(project) + '</option>'
+      ).join("");
+      if (projects.includes(current)) select.value = current;
+      else state.project = "";
+    }
+
     function renderSessions() {
       const filter = qs("session-filter").value.toLowerCase();
-      const sessions = state.history.sessions.filter((session) =>
-        [session.id, session.title].filter(Boolean).join(" ").toLowerCase().includes(filter)
-      );
-      qs("sessions").innerHTML = sessions.length ? sessions.map((session) =>
-        '<button class="item ' + (session.id === state.sessionID ? "active" : "") + '" data-session="' + escapeAttr(session.id) + '">' +
-          '<div class="title">' + escapeHtml(session.title || session.id) + '</div>' +
-          '<div class="meta">' + session.messages.length + ' messages \xB7 ' + session.requests.length + ' hooks \xB7 ' + fmt(session.updatedAt) + '</div>' +
-        '</button>'
-      ).join("") : '<div class="empty">No sessions found.</div>';
+      const project = state.project;
+      const all = state.history.sessions;
+      const byParent = new Map();
+      const byId = new Map(all.map((session) => [session.id, session]));
+      for (const session of all) {
+        const parent = session.parentID && byId.has(session.parentID) ? session.parentID : "";
+        const list = byParent.get(parent) || [];
+        list.push(session);
+        byParent.set(parent, list);
+      }
+      for (const list of byParent.values()) list.sort((a, b) => (b.updatedAt || 0) - (a.updatedAt || 0));
+      const matches = (session) => {
+        const projectMatch = !project || (session.project || session.cwd || "Unknown") === project;
+        const text = [session.id, session.title, session.project, session.cwd].filter(Boolean).join(" ").toLowerCase();
+        return projectMatch && (!filter || text.includes(filter));
+      };
+      const renderNode = (session, depth = 0) => {
+        const children = byParent.get(session.id) || [];
+        const childHtml = children.map((child) => renderNode(child, depth + 1)).join("");
+        if (!matches(session) && !childHtml) return "";
+        const cls = "item" + (depth > 0 ? " session-child" : "") + (session.id === state.sessionID ? " active" : "");
+        return '<button class="' + cls + '" data-session="' + escapeAttr(session.id) + '">' +
+          '<div class="title">' + (depth > 0 ? "sub: " : "") + escapeHtml(session.title || session.id) + '</div>' +
+          '<div class="meta">' + escapeHtml(session.project || session.cwd || "Unknown project") + ' \xB7 ' + userMessages(session).length + ' messages \xB7 ' + fmt(session.updatedAt) + '</div>' +
+        '</button>' + childHtml;
+      };
+      const html = (byParent.get("") || []).map((session) => renderNode(session)).join("");
+      qs("sessions").innerHTML = html || '<div class="empty">No sessions found.</div>';
       for (const item of document.querySelectorAll("[data-session]")) {
         item.onclick = () => {
           state.sessionID = item.dataset.session;
           const session = selectedSession();
-          state.messageID = session?.messages[0]?.id || null;
+          state.messageID = firstUserMessage(session)?.id || null;
           state.requestID = null;
           render();
         };
       }
     }
 
+    function userMessages(session) {
+      return (session?.messages || []).filter((message) => message.role === "user");
+    }
+
     function renderTimeline() {
       const session = selectedSession();
       if (!session) {
@@ -739,79 +1176,71 @@ function renderViewerHtml(dbPath) {
       }
       const filter = qs("timeline-filter").value.toLowerCase();
       const blocks = [];
-      for (const message of session.messages) {
+      for (const message of userMessages(session)) {
         const searchable = JSON.stringify(message).toLowerCase();
         if (filter && !searchable.includes(filter)) continue;
         blocks.push(
-          '<button class="item ' + (message.id === state.messageID && !state.requestID ? "active" : "") + '" data-message="' + escapeAttr(message.id) + '">' +
-            '<div class="title"><span class="pill msg">MSG</span> ' + escapeHtml(message.role) + ' \xB7 ' + escapeHtml(short(message.text || message.id, 110)) + '</div>' +
-            '<div class="meta">' + message.requests.length + ' hooks \xB7 response ' + (message.response?.text ? "captured" : "missing") + ' \xB7 ' + fmt(message.createdAt) + '</div>' +
+          '<button class="item ' + (message.id === state.messageID ? "active" : "") + '" data-message="' + escapeAttr(message.id) + '">' +
+            '<div class="title"><span class="pill msg">USER</span> ' + escapeHtml(short(message.text || message.id, 130)) + '</div>' +
+            '<div class="meta">' + visibleSteps(message).length + ' visible steps \xB7 ' + hiddenContexts(message).length + ' hidden context items \xB7 ' + fmt(message.createdAt) + '</div>' +
           '</button>'
         );
-        for (const request of message.requests) {
-          blocks.push(
-            '<button class="item request-item ' + (request.id === state.requestID ? "active" : "") + '" data-message="' + escapeAttr(message.id) + '" data-request="' + escapeAttr(request.id) + '">' +
-              '<div class="title"><span class="pill">HOOK</span> ' + escapeHtml(request.agent || "agent") + ' \xB7 ' + escapeHtml([request.providerID, request.modelID].filter(Boolean).join("/") || "-") + '</div>' +
-              '<div class="meta">' + escapeHtml(short(request.summary, 120)) + ' \xB7 ' + (request.headers ? "headers" : "no headers") + ' \xB7 ' + (request.response?.text ? "response" : "no response") + '</div>' +
-            '</button>'
-          );
-        }
       }
-      qs("timeline").innerHTML = blocks.length ? blocks.join("") : '<div class="empty">No messages or hooks found.</div>';
+      qs("timeline").innerHTML = blocks.length ? blocks.join("") : '<div class="empty">No user messages found.</div>';
       for (const item of document.querySelectorAll("[data-message]")) {
         item.onclick = () => {
           state.messageID = item.dataset.message;
-          state.requestID = item.dataset.request || null;
+          state.requestID = null;
           render();
         };
       }
     }
 
     function renderDetail() {
-      const { message, request } = activeContext();
-      document.querySelector(".tabs").classList.toggle("json-mode", state.tab !== "summary");
-      if (!message && !request) {
-        qs("detail").textContent = "Select a message or request.";
+      const message = selectedMessage();
+      if (!message) {
+        qs("detail").textContent = "Select a user message.";
         return;
       }
 
-      if (state.tab === "summary") {
-        const response = request?.response || message?.response;
-        qs("detail").innerHTML = '<div class="kv">' +
-          kv("Message", message?.id || "-") +
-          kv("Message text", message?.text || "(no user text captured)") +
-          kv("Selected hook", request?.id || "-") +
-          kv("Agent", request?.agent || "-") +
-          kv("Purpose", request?.purpose || "-") +
-          kv("Provider/model", [request?.providerID, request?.modelID].filter(Boolean).join("/") || "-") +
-          kv("Request time", fmt(request?.timestamp)) +
-          kv("Headers hook", request?.headers ? "captured" : "empty / not captured") +
-          kv("Direct response", request?.response?.text ? "captured" : request ? "none for this hook" : "-") +
-          kv("Message response", response?.id || "-") +
-          kv("Response text", response?.text || "(no assistant text captured)") +
-          kv("Finish", response?.finish || "-") +
-          kv("Cost", response?.cost === undefined ? "-" : String(response.cost)) +
-        '</div>';
-        return;
-      }
+      const session = selectedSession();
+      const steps = visibleSteps(message);
+      const hidden = hiddenContexts(message);
+      qs("detail").innerHTML =
+        '<div class="kv">' +
+          kv("Session", session?.title || session?.id || "-") +
+          kv("Project", session?.project || session?.cwd || "Unknown") +
+          kv("User message", message.text || "(no user text captured)") +
+          kv("Visible steps", String(steps.length)) +
+          kv("Hidden context", hidden.length ? hidden.length + " item(s)" : "none captured") +
+        '</div>' +
+        '<div class="subhead">Agent Thinking / Response Sequence</div>' +
+        (steps.length ? steps.map(renderStep).join("") : '<div class="empty">No assistant thinking or response text captured for this message.</div>') +
+        '<div class="subhead">Hidden Context</div>' +
+        (hidden.length ? hidden.map(renderHiddenContext).join("") : '<div class="empty">No system prompt or hidden prompt-like context captured.</div>');
+    }
 
-      if (state.tab === "request") {
-        renderRequestDetail(request);
-        return;
-      }
+    function visibleSteps(message) {
+      return message.visibleSteps || [];
+    }
 
-      if (state.tab === "response") {
-        const response = state.requestID ? request?.response : message?.response;
-        renderJson(response || {
-          status: "missing",
-          note: request?.agent === "title"
-            ? "The title request does not produce the assistant reply. Select the build request or MSG row to inspect the conversation response."
-            : "No assistant response events were captured for this message yet."
-        });
-        return;
-      }
+    function hiddenContexts(message) {
+      return message.hiddenContexts || [];
+    }
 
-      renderJson({ message, request });
+    function renderStep(step) {
+      return '<div class="step">' +
+        '<div class="step-label">' + escapeHtml(step.label) + '</div>' +
+        '<div class="step-text">' + escapeHtml(step.text) + '</div>' +
+      '</div>';
+    }
+
+    function renderHiddenContext(item) {
+      const count = item.count > 1 ? ' \xB7 used by ' + item.count + ' model steps' : "";
+      return '<details class="hidden-context">' +
+        '<summary>' + escapeHtml(item.title) + ' \xB7 ' + escapeHtml(item.step || "-") + count + ' \xB7 ' + escapeHtml(item.preview) + '</summary>' +
+        '<div class="hidden-body"><pre class="hidden-text">' + escapeHtml(item.text) + '</pre></div>' +
+      '</details>';
     }
 
     function kv(key, value) {
@@ -827,12 +1256,22 @@ function renderViewerHtml(dbPath) {
         renderJson({ status: "missing", note: "Select a hook row to inspect hook details." });
         return;
       }
-      const payload = request.payload || {};
+      const cached = state.payloadCache[request.id];
+      if (cached === undefined || cached === null) {
+        qs("detail").innerHTML = '<div class="empty">Loading hook payload...</div>';
+        return;
+      }
+      if (cached.error) {
+        renderJson({ error: cached.error });
+        return;
+      }
+      const payload = cached;
       const hookInput = payload.input || {};
       const hookOutput = payload.output || {};
+      const systemOutput = request.system?.payload?.output || null;
       const headerOutput = request.headers?.payload?.output || null;
       qs("detail").innerHTML =
-        '<p class="explain">These are OpenCode plugin hook values, not a raw HTTP request. <b>Hook input</b> is the context OpenCode passed to the plugin before the model call. <b>Hook output</b> is the model settings returned by the plugin hook. <b>Headers output</b> is the provider headers hook result.</p>' +
+        '<p class="explain">These are OpenCode plugin hook values, not a raw HTTP request. <b>Hook input</b> is the context OpenCode passed to the plugin before the model call. <b>Hook output</b> is the model settings returned by the plugin hook. <b>System transform</b> is the system prompt OpenCode prepared for this same call. <b>Headers output</b> is the provider headers hook result.</p>' +
         '<div class="kv">' +
           kv("Hook id", request.id) +
           kv("Agent", request.agent || "-") +
@@ -845,10 +1284,12 @@ function renderViewerHtml(dbPath) {
         '<div class="json-tree">' + jsonNode(summarizeHookInput(hookInput), "hookInput", true) + '</div>' +
         '<div class="subhead">Hook Output: model-call settings</div>' +
         '<div class="json-tree">' + jsonNode(hookOutput, "hookOutput", true) + '</div>' +
+        '<div class="subhead">System Transform Output</div>' +
+        '<div class="json-tree">' + jsonNode(systemOutput, "systemOutput", true) + '</div>' +
         '<div class="subhead">Headers Hook Output</div>' +
         '<div class="json-tree">' + jsonNode(headerOutput, "headersOutput", true) + '</div>' +
         '<div class="subhead">Raw Full-Fidelity Payload</div>' +
-        '<div class="json-tree">' + jsonNode({ params: request.payload, headers: request.headers?.payload || null }, "raw", false) + '</div>';
+        '<div class="json-tree">' + jsonNode({ system: request.system?.payload || null, params: payload, headers: request.headers?.payload || null }, "raw", false) + '</div>';
     }
 
     function summarizeHookInput(input) {
@@ -915,16 +1356,23 @@ function renderViewerHtml(dbPath) {
     }
 
     qs("session-filter").oninput = render;
+    qs("project-filter").onchange = () => {
+      state.project = qs("project-filter").value;
+      render();
+    };
     qs("timeline-filter").oninput = render;
     qs("refresh").onclick = load;
-    qs("expand-json").onclick = () => setJsonExpanded(true);
-    qs("collapse-json").onclick = () => setJsonExpanded(false);
+    for (const item of document.querySelectorAll("[data-theme-option]")) {
+      item.onclick = () => applyTheme(item.dataset.themeOption);
+    }
     qs("copy").onclick = async () => {
-      const { message, request } = activeContext();
-      const value = state.tab === "request" ? { params: request?.payload || null, headers: request?.headers?.payload || null }
-        : state.tab === "response" ? (request?.response || message?.response || null)
-        : state.tab === "raw" ? { message, request }
-        : { messageID: message?.id, requestID: request?.id };
+      const message = selectedMessage();
+      const value = message ? {
+        messageID: message.id,
+        text: message.text,
+        steps: visibleSteps(message),
+        hiddenContext: hiddenContexts(message)
+      } : null;
       await navigator.clipboard.writeText(JSON.stringify(value, null, 2));
     };
     for (const tab of document.querySelectorAll("[data-tab]")) {
@@ -934,6 +1382,7 @@ function renderViewerHtml(dbPath) {
         renderDetail();
       };
     }
+    applyTheme(localStorage.getItem(THEME_KEY));
     load();
   </script>
 </body>
@@ -1090,10 +1539,16 @@ function parseOptions(args) {
       const value = args[index + 1];
       if (value) options.configDir = value;
       index += 1;
+    } else if (arg === "--retention-days") {
+      options.retentionDays = Number.parseFloat(args[index + 1] ?? "");
+      index += 1;
     }
   }
   if (!Number.isFinite(options.limit) || options.limit < 1) options.limit = DEFAULT_RECENT_LIMIT;
   if (options.port !== void 0 && (!Number.isFinite(options.port) || options.port < 1)) options.port = 8765;
+  if (options.retentionDays !== void 0 && (!Number.isFinite(options.retentionDays) || options.retentionDays < 0)) {
+    options.retentionDays = void 0;
+  }
   return options;
 }
 function parsePositionals(args) {
@@ -1102,7 +1557,7 @@ function parsePositionals(args) {
     const arg = args[index];
     if (!arg) continue;
     if (arg.startsWith("--")) {
-      if (["--db", "--data-dir", "--limit", "--host", "--port", "--output", "--config-dir"].includes(arg)) index += 1;
+      if (["--db", "--data-dir", "--limit", "--host", "--port", "--output", "--config-dir", "--retention-days"].includes(arg)) index += 1;
       continue;
     }
     if (arg === "-o") {
@@ -1234,7 +1689,7 @@ async function configureOpenCodeDebug(options) {
   }
   const opencodeConfig = await readJsonConfig(opencodePath, { plugin: [] });
   const tuiConfig = await readJsonConfig(tuiPath, { plugin: [] });
-  setSinglePluginSpec(opencodeConfig, SERVER_PLUGIN_SPEC, localServerEntry);
+  setSinglePluginSpec(opencodeConfig, SERVER_PLUGIN_SPEC, [localServerEntry, debugServerOptions(options)], localServerEntry);
   setSinglePluginSpec(tuiConfig, TUI_PLUGIN_SPEC, localTuiEntry);
   removePlugin(tuiConfig, SUBPATH_TUI_PLUGIN_SPEC);
   const lines = [
@@ -1323,6 +1778,11 @@ function stripJsonCommentsAndTrailingCommas(input) {
 function isJsonObject(value) {
   return !!value && typeof value === "object" && !Array.isArray(value);
 }
+function debugServerOptions(options) {
+  const serverOptions = {};
+  if (options.retentionDays !== void 0) serverOptions.retentionDays = options.retentionDays;
+  return serverOptions;
+}
 function addUniquePlugin(config, plugin) {
   const current = Array.isArray(config.plugin) ? config.plugin : [];
   if (current.includes(plugin)) {
@@ -1341,9 +1801,10 @@ function removePlugin(config, plugin) {
 function isPluginEntry(entry, plugin) {
   return entry === plugin || Array.isArray(entry) && entry[0] === plugin;
 }
-function setSinglePluginSpec(config, previousPlugin, nextPlugin) {
+function setSinglePluginSpec(config, previousPlugin, nextPlugin, nextPluginSpec) {
   const current = Array.isArray(config.plugin) ? config.plugin : [];
-  const next = current.filter((entry) => !isInsightsPluginEntry(entry, previousPlugin, nextPlugin));
+  const localPlugin = nextPluginSpec ?? (typeof nextPlugin === "string" ? nextPlugin : "");
+  const next = current.filter((entry) => !isInsightsPluginEntry(entry, previousPlugin, localPlugin));
   config.plugin = [...next, nextPlugin];
 }
 function isInsightsPluginEntry(entry, packagePlugin, localPlugin) {
@@ -1411,7 +1872,7 @@ async function writeJsonConfig(path, config) {
 function usage() {
   return [
     "Usage:",
-    "  opencode-insights debug [--config-dir DIR] [--dry-run]",
+    "  opencode-insights debug [--config-dir DIR] [--retention-days DAYS] [--dry-run]",
     "  opencode-insights uninstall [--config-dir DIR] [--db PATH] [--data-dir DIR] [--keep-data] [--dry-run]",
     "  opencode-insights recent [--db PATH] [--data-dir DIR] [--limit N] [--json]",
     "  opencode-insights sessions [--db PATH] [--data-dir DIR] [--limit N] [--json]",