flatbread-cli 0.3.0 → 0.3.2

package/THIRD-PARTY-NOTICES.md

@@ -2,9 +2,11 @@
 
 ## deja-vu
 
-`src/adapters/antigravity.ts` reads conversations the way deja-vu reads Windsurf trajectories
-(`internal/sources/windsurf.go`), and `test/fixtures/antigravity/*.pb` are its fixtures
-(`fixtures/registry/windsurf/cascade/`).
+`src/adapters/antigravity.ts` reads `.pb` conversations the way deja-vu reads Windsurf trajectories
+(`internal/sources/windsurf.go`) and transcripts the way it reads Antigravity's
+(`internal/sources/antigravity.go`). `test/fixtures/antigravity/` holds its fixtures
+(`fixtures/registry/windsurf/cascade/`, `fixtures/registry/antigravity/`) and transcripts from
+`internal/sources/antigravity_toolcalls_test.go`.
 
 ```
 MIT License

package/dist/flatbread.mjs

@@ -4307,6 +4307,73 @@ function tallyFailures(loops) {
   };
 }
 
+// ../schema/src/harness.ts
+var HARNESS_INFO = {
+  "claude-code": {
+    id: "claude-code",
+    label: "Claude Code",
+    formatLabel: "session JSONL (~/.claude/projects)",
+    confidence: "observed",
+    implemented: true,
+    humanTest: "A1",
+    toolResults: "measured",
+    note: "Built from real observed logs. Anthropic publishes no format guarantee, so watch the unknown-type counter."
+  },
+  cursor: {
+    id: "cursor",
+    label: "Cursor",
+    formatLabel: "state.vscdb SQLite (cursorDiskKV + ItemTable)",
+    confidence: "documented",
+    implemented: true,
+    humanTest: "A5",
+    toolResults: "unavailable",
+    note: "Reads composerData:/bubbleId: from cursorDiskKV (modern) and aiService.prompts from ItemTable (legacy). Cursor publishes no schema and has moved these keys between releases."
+  },
+  opencode: {
+    id: "opencode",
+    label: "OpenCode",
+    formatLabel: "SQLite opencode.db (1.3+) or storage/ JSON tree (1.0.x)",
+    confidence: "documented",
+    implemented: true,
+    humanTest: "A4",
+    toolResults: "measured",
+    note: "Two layouts. 1.3+ keeps sessions in an SQLite opencode.db (schema read off a real 1.3.17 install); 1.0.x kept a session/message/part JSON tree. OpenCode publishes no schema and its migrations have moved this once already, so a version bump can move it again."
+  },
+  antigravity: {
+    id: "antigravity",
+    label: "Google Antigravity",
+    formatLabel: "app brain/<id>/.system_generated/logs/transcript.jsonl, or IDE conversations/<id>.pb",
+    confidence: "documented",
+    implemented: true,
+    humanTest: "A6",
+    toolResults: "unavailable",
+    note: "Both stores measured on one machine. The app's transcript is read the way deja-vu reads it: prompts, replies and the planner's tool calls, not tool output. The IDE's .pb is read the way deja-vu reads Windsurf: prompts and replies only."
+  },
+  terminal: {
+    id: "terminal",
+    label: "Terminal / PTY recording",
+    formatLabel: "asciinema cast v2, or a plain text transcript",
+    confidence: "spec",
+    implemented: true,
+    humanTest: "A3",
+    toolResults: "unavailable",
+    note: "Cast format is specified. Segmenting a raw terminal stream into prompts and replies is heuristic and will misread unfamiliar prompts."
+  },
+  otel: {
+    id: "otel",
+    label: "OpenTelemetry",
+    formatLabel: "OTLP/JSON spans with GenAI semantic conventions",
+    confidence: "spec",
+    implemented: true,
+    humanTest: "A2",
+    toolResults: "measured",
+    note: "Both the wire format and the gen_ai.* attribute names are specified. Unproven: that real instrumentation populates them."
+  }
+};
+function failuresRecorded(harness) {
+  return HARNESS_INFO[harness].toolResults === "measured";
+}
+
 // ../schema/src/brief.ts
 var MUTATING_TOOL_NAMES = /* @__PURE__ */ new Set([
   "write",
@@ -4642,14 +4709,15 @@ function runDiagnostics(trace) {
     if (hit) waste.push({ kind: "repeated-search", label, steps: hit, windowMinutes: WASTE_RULES.repeatedSearch.windowMinutes });
   }
   const stats = trace.stats;
+  const recorded = failuresRecorded(trace.source.harness);
   return {
     counts: {
       steps: steps.length,
       agentSteps: steps.length - prompts.length,
       humanPrompts: prompts.length,
       toolCalls: stats.toolCallCount,
-      failures: steps.filter((step) => step.type === "error_recovery").length,
-      recoveries: loops.filter((loop) => loop.outcome === "recovered").length
+      failures: recorded ? steps.filter((step) => step.type === "error_recovery").length : null,
+      recoveries: recorded ? loops.filter((loop) => loop.outcome === "recovered").length : null
     },
     tokens: {
       input: stats.inputTokens,
@@ -4778,64 +4846,6 @@ function buildExecutionBrief(trace) {
   };
 }
 
-// ../schema/src/harness.ts
-var HARNESS_INFO = {
-  "claude-code": {
-    id: "claude-code",
-    label: "Claude Code",
-    formatLabel: "session JSONL (~/.claude/projects)",
-    confidence: "observed",
-    implemented: true,
-    humanTest: "A1",
-    note: "Built from real observed logs. Anthropic publishes no format guarantee, so watch the unknown-type counter."
-  },
-  cursor: {
-    id: "cursor",
-    label: "Cursor",
-    formatLabel: "state.vscdb SQLite (cursorDiskKV + ItemTable)",
-    confidence: "documented",
-    implemented: true,
-    humanTest: "A5",
-    note: "Reads composerData:/bubbleId: from cursorDiskKV (modern) and aiService.prompts from ItemTable (legacy). Cursor publishes no schema and has moved these keys between releases."
-  },
-  opencode: {
-    id: "opencode",
-    label: "OpenCode",
-    formatLabel: "SQLite opencode.db (1.3+) or storage/ JSON tree (1.0.x)",
-    confidence: "documented",
-    implemented: true,
-    humanTest: "A4",
-    note: "Two layouts. 1.3+ keeps sessions in an SQLite opencode.db (schema read off a real 1.3.17 install); 1.0.x kept a session/message/part JSON tree. OpenCode publishes no schema and its migrations have moved this once already, so a version bump can move it again."
-  },
-  antigravity: {
-    id: "antigravity",
-    label: "Google Antigravity",
-    formatLabel: "IDE conversations/<id>.pb (Windsurf's encrypted trajectory)",
-    confidence: "documented",
-    implemented: true,
-    humanTest: "A6",
-    note: "The IDE only, prompts and replies only. Read the way deja-vu reads Windsurf, which held on all nine IDE 1.23.2 conversations measured. Tool calls are undocumented and not read; the standalone Antigravity app is not read yet."
-  },
-  terminal: {
-    id: "terminal",
-    label: "Terminal / PTY recording",
-    formatLabel: "asciinema cast v2, or a plain text transcript",
-    confidence: "spec",
-    implemented: true,
-    humanTest: "A3",
-    note: "Cast format is specified. Segmenting a raw terminal stream into prompts and replies is heuristic and will misread unfamiliar prompts."
-  },
-  otel: {
-    id: "otel",
-    label: "OpenTelemetry",
-    formatLabel: "OTLP/JSON spans with GenAI semantic conventions",
-    confidence: "spec",
-    implemented: true,
-    humanTest: "A2",
-    note: "Both the wire format and the gen_ai.* attribute names are specified. Unproven: that real instrumentation populates them."
-  }
-};
-
 // ../schema/src/capsule.ts
 var CAPSULE_LIMITS = {
   /** Diff lines across every patch. Past it the rest is counted, never silently dropped. */
@@ -6000,7 +6010,7 @@ function buildTrace(input) {
   const title = titleFromPrompt(firstPrompt?.content ?? "");
   const filesChanged = input.capabilities.filesChanged === "measured" ? changedFiles.size : null;
   const filesPhrase = filesChanged === null ? "an unrecorded number of files changed" : `${plural2(filesChanged, "file")} changed`;
-  const summary = `${plural2(steps.length, "step")}, ${plural2(toolCallCount, "tool call")}, ${filesPhrase}, ${plural2(errorCount, "tool error")} over ${Math.round(durationSeconds)}s.`;
+  const summary = `${plural2(steps.length, "step")}, ${plural2(toolCallCount, "tool call")}, ${filesPhrase}, ${failuresRecorded(input.harness) ? plural2(errorCount, "tool error") : "tool errors not recorded"} over ${Math.round(durationSeconds)}s.`;
   const tokensMeasured = input.capabilities.tokens === "measured";
   const provenance = {
     id: input.harness,
@@ -6052,11 +6062,12 @@ import fs3 from "node:fs";
 import os2 from "node:os";
 import path3 from "node:path";
 import { fileURLToPath } from "node:url";
-var ANTIGRAVITY_ADAPTER_VERSION = 1;
+var ANTIGRAVITY_ADAPTER_VERSION = 2;
 var KEY = Buffer.from("safeCodeiumworldKeYsecretBalloon");
 var NONCE = 12;
 var TAG = 16;
 var CONVERSATION = /[\\/]\.gemini[\\/]antigravity[^\\/]*[\\/]conversations[\\/][^\\/]+\.pb$/i;
+var TRANSCRIPT = /[\\/]\.gemini[\\/]antigravity[^\\/]*[\\/]brain[\\/][^\\/]+[\\/]\.system_generated[\\/]logs[\\/]transcript\.jsonl$/i;
 var PB_VARINT = 0;
 var PB_FIXED64 = 1;
 var PB_BYTES = 2;
@@ -6214,6 +6225,82 @@ function decodeTrajectory2(plain) {
 function homeOf(env) {
   return (process.platform === "win32" ? env.USERPROFILE : env.HOME) || os2.homedir();
 }
+var USER_BLOCKS = [/<ADDITIONAL_METADATA>[\s\S]*?<\/ADDITIONAL_METADATA>/g, /<USER_SETTINGS_CHANGE>[\s\S]*?<\/USER_SETTINGS_CHANGE>/g];
+var ARTIFACT_COMMENT = /^Comments on artifact URI:.*$|^The user has (?:approved|rejected) this document\.$/gm;
+var REQUEST_TAG = /[ \t]*\n?\s*<\/?USER_REQUEST>\s*/g;
+function cleanUserContent(text2) {
+  let out = text2;
+  for (const block of USER_BLOCKS) out = out.replace(block, "");
+  out = out.replace(ARTIFACT_COMMENT, "");
+  return out.replace(REQUEST_TAG, "\n").trim();
+}
+function decodeArg(value) {
+  if (typeof value !== "string" || !value.startsWith('"')) return value;
+  try {
+    return JSON.parse(value);
+  } catch {
+    return value;
+  }
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function decodeTranscript(text2) {
+  const events = [];
+  const unread = /* @__PURE__ */ new Map();
+  let cwd;
+  let steps = 0;
+  let line = 0;
+  for (const raw of text2.replace(/\r\n/g, "\n").split("\n")) {
+    line++;
+    if (raw.trim() === "") continue;
+    let record;
+    try {
+      record = JSON.parse(raw);
+    } catch {
+      tally(unread, "malformed line");
+      continue;
+    }
+    if (!isRecord(record)) {
+      tally(unread, "malformed line");
+      continue;
+    }
+    steps++;
+    const source = typeof record["source"] === "string" ? record["source"] : "";
+    const type = typeof record["type"] === "string" ? record["type"] : "";
+    const content = typeof record["content"] === "string" ? record["content"] : "";
+    const created = typeof record["created_at"] === "string" && !Number.isNaN(Date.parse(record["created_at"])) ? record["created_at"] : void 0;
+    const at = created ? { timestamp: created } : {};
+    if (source === "USER_EXPLICIT") {
+      const prompt2 = cleanUserContent(content);
+      if (prompt2) events.push({ kind: "prompt", ...at, text: prompt2 });
+      continue;
+    }
+    if (source !== "MODEL") {
+      tally(unread, type ? `${source || "no"} source, type ${type}` : `${source || "no"} source`);
+      continue;
+    }
+    if (type !== "" && type !== "PLANNER_RESPONSE") {
+      tally(unread, `tool step ${type}`);
+      continue;
+    }
+    if (content.trim()) events.push({ kind: "text", ...at, text: content.trim() });
+    const calls = Array.isArray(record["tool_calls"]) ? record["tool_calls"] : [];
+    calls.forEach((call, k) => {
+      if (!isRecord(call) || typeof call["name"] !== "string") return;
+      const args = {};
+      if (isRecord(call["args"])) for (const [key, value] of Object.entries(call["args"])) args[key] = decodeArg(value);
+      if (cwd === void 0 && call["name"] === "run_command" && typeof args["Cwd"] === "string" && args["Cwd"]) cwd = args["Cwd"];
+      const step = typeof record["step_index"] === "number" ? record["step_index"] : `line${line}`;
+      events.push({ kind: "tool_call", ...at, id: `${step}.${k}`, name: call["name"], input: args });
+    });
+  }
+  if (cwd !== void 0) events.unshift({ kind: "meta", cwd });
+  return { events, steps, unread };
+}
+function transcriptId(file) {
+  return path3.basename(path3.dirname(path3.dirname(path3.dirname(file))));
+}
 function listConversations(env = process.env) {
   const gemini = path3.join(homeOf(env), ".gemini");
   let roots;
@@ -6222,29 +6309,71 @@ function listConversations(env = process.env) {
   } catch {
     return [];
   }
-  const found = [];
-  for (const root of roots) {
-    const dir = path3.join(gemini, root, "conversations");
-    let names;
+  const statFile = (file) => {
     try {
-      names = fs3.readdirSync(dir);
+      const stat = fs3.statSync(file);
+      return stat.isFile() ? stat : null;
     } catch {
-      continue;
+      return null;
     }
-    for (const name of names) {
-      if (!name.toLowerCase().endsWith(".pb")) continue;
-      const file = path3.join(dir, name);
-      try {
-        const stat = fs3.statSync(file);
-        if (stat.isFile()) found.push({ file, mtime: stat.mtimeMs });
-      } catch {
-        continue;
-      }
+  };
+  const readNames = (dir) => {
+    try {
+      return fs3.readdirSync(dir);
+    } catch {
+      return [];
     }
-  }
-  return found.sort((a, b) => b.mtime - a.mtime).map((entry) => entry.file);
+  };
+  const pb = /* @__PURE__ */ new Map();
+  const transcripts = /* @__PURE__ */ new Map();
+  for (const root of roots) {
+    const conversations = path3.join(gemini, root, "conversations");
+    for (const name of readNames(conversations)) {
+      if (!name.toLowerCase().endsWith(".pb")) continue;
+      const file = path3.join(conversations, name);
+      const stat = statFile(file);
+      if (stat === null) continue;
+      const id = name.slice(0, -".pb".length).toLowerCase();
+      const kept = pb.get(id);
+      if (kept === void 0 || stat.size > kept.size) pb.set(id, { file, mtime: stat.mtimeMs, size: stat.size });
+    }
+    const brain = path3.join(gemini, root, "brain");
+    for (const name of readNames(brain)) {
+      const file = path3.join(brain, name, ".system_generated", "logs", "transcript.jsonl");
+      const stat = statFile(file);
+      if (stat === null) continue;
+      const id = name.toLowerCase();
+      const kept = transcripts.get(id);
+      if (kept === void 0 || stat.size > kept.size) transcripts.set(id, { file, mtime: stat.mtimeMs, size: stat.size });
+    }
+  }
+  for (const id of transcripts.keys()) pb.delete(id);
+  return [...pb.values(), ...transcripts.values()].sort((a, b) => b.mtime - a.mtime).map((entry) => entry.file);
 }
 var REFUSAL_TEST = "A6";
+async function readTranscript(file) {
+  const trajectory = decodeTranscript(await fs3.promises.readFile(file, "utf8"));
+  const id = transcriptId(file);
+  const said = trajectory.events.filter((e) => e.kind === "prompt" || e.kind === "text").length;
+  if (said === 0) {
+    return {
+      refused: true,
+      reason: `${id}'s transcript has ${trajectory.steps} record(s) and no prompt or reply this reader knows.`,
+      humanTest: REFUSAL_TEST
+    };
+  }
+  return {
+    events: trajectory.events,
+    capabilities: { tokens: "unavailable", filesChanged: "unavailable" },
+    sessionId: id,
+    unreadFields: [...trajectory.unread].sort((a, b) => b[1] - a[1]).map(([field, count]) => `${field} x${count}`),
+    notes: [
+      `${trajectory.steps} record(s), ${said} prompt/reply event(s)`,
+      "tool steps' bodies and checkpoints are not read; tool calls come from the planner's tool_calls",
+      "CONFIDENCE: documented (deja-vu's transcript reader, measured on app 2.24.0). See HUMAN-TESTS.md A6."
+    ]
+  };
+}
 var antigravityAdapter = {
   id: "antigravity",
   version: ANTIGRAVITY_ADAPTER_VERSION,
@@ -6252,9 +6381,13 @@ var antigravityAdapter = {
     if (CONVERSATION.test(input.path)) {
       return { score: 85, reason: "a conversations/<id>.pb under ~/.gemini/antigravity" };
     }
-    return { score: 0, reason: "not an Antigravity conversations/<id>.pb" };
+    if (TRANSCRIPT.test(input.path)) {
+      return { score: 85, reason: "a brain/<id>/.system_generated/logs/transcript.jsonl under ~/.gemini/antigravity" };
+    }
+    return { score: 0, reason: "not an Antigravity conversations/<id>.pb or brain transcript" };
   },
   async read(input) {
+    if (input.path.toLowerCase().endsWith(".jsonl")) return readTranscript(input.path);
     const plain = openConversation(await fs3.promises.readFile(input.path));
     if (plain === null) {
       return {
@@ -6305,6 +6438,18 @@ var antigravityAdapter = {
     const target = files[0];
     if (target === void 0) return lines2;
     lines2.push("", `inspecting ${target}`);
+    if (target.toLowerCase().endsWith(".jsonl")) {
+      try {
+        const trajectory = decodeTranscript(await fs3.promises.readFile(target, "utf8"));
+        lines2.push(`  records: ${trajectory.steps}, events: ${trajectory.events.filter((e) => e.kind !== "meta").length}`);
+        for (const [field, count] of [...trajectory.unread].sort((a, b) => b[1] - a[1]).slice(0, 15)) {
+          lines2.push(`    ${String(count).padStart(6)}  ${field}`);
+        }
+      } catch (error) {
+        lines2.push(`  unreadable: ${error instanceof Error ? error.message : String(error)}`);
+      }
+      return lines2;
+    }
     let plain;
     try {
       plain = openConversation(await fs3.promises.readFile(target));
@@ -10069,7 +10214,7 @@ function renderReviewPage(input) {
   <h1>${marked("title", trace.title)}</h1>
   <div class="meta">
     <b>${escapeHtml(trace.model)}</b> &middot; ${plural2(trace.steps.length, "step")} &middot; ${plural2(toolCalls, "tool call")} &middot;
-    ${trace.stats.filesChanged === null ? `${formatCount(null)} files` : plural2(trace.stats.filesChanged, "file")} changed &middot; ${plural2(trace.stats.errorCount, "error")} &middot;
+    ${trace.stats.filesChanged === null ? `${formatCount(null)} files` : plural2(trace.stats.filesChanged, "file")} changed &middot; ${failuresRecorded(trace.source.harness) ? plural2(trace.stats.errorCount, "error") : `${formatCount(null)} errors`} &middot;
     ${Math.round(trace.stats.durationSeconds)}s &middot; <b>${matches.length}</b> redaction match${matches.length === 1 ? "" : "es"}
   </div>
   <div class="meta path">${escapeHtml(sessionPath)}</div>
@@ -10651,7 +10796,7 @@ function diagnosticsLines(diagnostics) {
   const { counts, tokens } = diagnostics;
   const out = [
     `${plural3(counts.steps, "step")}: ${counts.agentSteps.toLocaleString("en-US")} by the agent, ${plural3(counts.humanPrompts, "prompt")} from a person`,
-    `${plural3(counts.toolCalls, "tool call")}, ${plural3(counts.failures, "failure")}, ${plural3(counts.recoveries, "recovery", "recoveries")} by the agent`
+    counts.failures === null || counts.recoveries === null ? `${plural3(counts.toolCalls, "tool call")}; failures not recorded by this harness` : `${plural3(counts.toolCalls, "tool call")}, ${plural3(counts.failures, "failure")}, ${plural3(counts.recoveries, "recovery", "recoveries")} by the agent`
   ];
   const recorded = [];
   if (tokens.input !== null) recorded.push(["in", tokens.input]);
@@ -10934,7 +11079,7 @@ function logCapture(dir, line, now = (/* @__PURE__ */ new Date()).toISOString())
 
 // src/mcp.ts
 var MCP_PROTOCOL_VERSIONS = ["2025-06-18", "2025-03-26", "2024-11-05"];
-var MCP_SERVER_VERSION = "0.3.0";
+var MCP_SERVER_VERSION = "0.3.2";
 function defaultMcpDeps(storeDir2, bucketDir2) {
   return {
     storeDir: storeDir2,
@@ -12597,7 +12742,7 @@ function report(result, outputPath) {
   lines2.push(`  tool calls   ${formatInt(trace.stats.toolCallCount)}`);
   lines2.push(`  tools used   ${result.toolNames.length > 0 ? result.toolNames.join(", ") : "(none)"}`);
   lines2.push(`  files changed ${formatCount(trace.stats.filesChanged)}`);
-  lines2.push(`  tool errors  ${formatInt(trace.stats.errorCount)}`);
+  lines2.push(`  tool errors  ${failuresRecorded(trace.source.harness) ? formatInt(trace.stats.errorCount) : formatCount(null)}`);
   lines2.push("");
   lines2.push(
     `  tokens       in ${formatCount(trace.stats.inputTokens)} / out ${formatCount(trace.stats.outputTokens)} / cache read ${formatCount(trace.stats.cacheReadTokens)} / cache write ${formatCount(trace.stats.cacheCreationTokens)}`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "flatbread-cli",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "Flatbread: read a coding agent's session off disk, redact it, share it, and pull a run's Context Capsule into another agent.",
   "type": "module",
   "bin": {