@macintacos/caret 0.8.2 → 0.10.0

package/dist/cli.js

@@ -1990,7 +1990,7 @@ var require_indexes = __commonJS((exports, module) => {
 
 // node_modules/.bun/thread-stream@4.2.0/node_modules/thread-stream/index.js
 var require_thread_stream = __commonJS((exports, module) => {
-  var __dirname = "/Users/juliantorres/GitLocal/Play/caret/node_modules/.bun/thread-stream@4.2.0/node_modules/thread-stream";
+  var __dirname = "/Users/juliantorres/GitLocal/Play/caret/trunk/node_modules/.bun/thread-stream@4.2.0/node_modules/thread-stream";
   var { version: version2 } = require_package();
   var { EventEmitter } = __require("events");
   var { Worker } = __require("worker_threads");
@@ -2506,7 +2506,7 @@ var require_thread_stream = __commonJS((exports, module) => {
 
 // node_modules/.bun/pino@10.3.1/node_modules/pino/lib/transport.js
 var require_transport = __commonJS((exports, module) => {
-  var __dirname = "/Users/juliantorres/GitLocal/Play/caret/node_modules/.bun/pino@10.3.1/node_modules/pino/lib";
+  var __dirname = "/Users/juliantorres/GitLocal/Play/caret/trunk/node_modules/.bun/pino@10.3.1/node_modules/pino/lib";
   var { createRequire } = __require("module");
   var { existsSync: existsSync4 } = __require("fs");
   var getCallers = require_caller();
@@ -5803,8 +5803,8 @@ __export(exports_dist, {
 });
 import { styleText as styleText2, stripVTControlCharacters } from "util";
 import process$1 from "process";
-import { existsSync as existsSync10, lstatSync, readdirSync as readdirSync6 } from "fs";
-import { dirname as dirname8, join as join13 } from "path";
+import { existsSync as existsSync10, lstatSync, readdirSync as readdirSync5 } from "fs";
+import { dirname as dirname8, join as join14 } from "path";
 function isUnicodeSupported() {
   if (process$1.platform !== "win32") {
     return process$1.env.TERM !== "linux";
@@ -6517,8 +6517,8 @@ ${n3}
         let i;
         existsSync10(t2) ? lstatSync(t2).isDirectory() && (!e.directory || t2.endsWith("/")) ? i = t2 : i = dirname8(t2) : i = dirname8(t2);
         const c2 = t2.length > 1 && t2.endsWith("/") ? t2.slice(0, -1) : t2;
-        return readdirSync6(i).map((r2) => {
-          const n3 = join13(i, r2), m3 = lstatSync(n3);
+        return readdirSync5(i).map((r2) => {
+          const n3 = join14(i, r2), m3 = lstatSync(n3);
           return {
             name: r2,
             path: n3,
@@ -24178,6 +24178,63 @@ config(en_default());
 var DEFAULT_PORT = 42718;
 var VANITY_HOST = "caret.localhost";
 var HOOK_TIMEOUT_S = 3900;
+var EXCERPT_RADIUS = 30;
+var KNOWN_FILE_EXTENSIONS = new Set([
+  "ts",
+  "tsx",
+  "mts",
+  "cts",
+  "js",
+  "jsx",
+  "mjs",
+  "cjs",
+  "svelte",
+  "vue",
+  "json",
+  "jsonc",
+  "css",
+  "scss",
+  "less",
+  "html",
+  "htm",
+  "xml",
+  "svg",
+  "md",
+  "mdx",
+  "py",
+  "rb",
+  "rs",
+  "go",
+  "java",
+  "kt",
+  "c",
+  "h",
+  "cc",
+  "cpp",
+  "hpp",
+  "sh",
+  "bash",
+  "zsh",
+  "toml",
+  "yaml",
+  "yml",
+  "ini",
+  "sql",
+  "graphql",
+  "gql",
+  "php",
+  "swift",
+  "dart",
+  "txt",
+  "lock",
+  "cfg",
+  "conf"
+]);
+function hasKnownFileExtension(path) {
+  const base = path.split("/").pop() ?? "";
+  const dot = base.lastIndexOf(".");
+  return dot > 0 && KNOWN_FILE_EXTENSIONS.has(base.slice(dot + 1).toLowerCase());
+}
 var BUN_SOCKET_IDLE_CAP_S = 255;
 var IDLE_TIMEOUT_HEADROOM_S = 5;
 var MAX_HEARTBEAT_MS = (BUN_SOCKET_IDLE_CAP_S - IDLE_TIMEOUT_HEADROOM_S) * 1000;
@@ -24294,7 +24351,7 @@ async function loadUiAssets() {
 // package.json
 var package_default = {
   name: "@macintacos/caret",
-  version: "0.8.2",
+  version: "0.10.0",
   license: "MIT",
   type: "module",
   description: "A Claude Code plugin that replaces the terminal plan-approval prompt with a local web UI for inline review, annotation, and approval.",
@@ -24323,7 +24380,7 @@ var package_default = {
     ".claude-plugin/plugin.json"
   ],
   scripts: {
-    test: "bun test --conditions browser",
+    test: "bun test --conditions browser --timeout 30000",
     lint: "mise run lint",
     format: "mise run format",
     build: "mise run build"
@@ -24359,6 +24416,7 @@ var package_default = {
     "@lezer/highlight": "^1.2.3",
     "@opencode-ai/plugin": "^1.16.2",
     "@pierre/diffs": "1.2.7",
+    "@pierre/trees": "1.0.0-beta.6",
     "bits-ui": "^2.18.1",
     clsx: "^2.1.1",
     commander: "^15.0.0",
@@ -25160,9 +25218,10 @@ var PlanInputSchema = exports_external.object({
   cwd: exports_external.string().optional(),
   title: exports_external.string().optional(),
   plan: exports_external.string().optional(),
-  planFilePath: exports_external.string().optional()
+  planFilePath: exports_external.string().optional(),
+  cmux: exports_external.object({ workspaceId: exports_external.string().min(1), surfaceId: exports_external.string().min(1) }).optional().catch(undefined)
 }).catch({});
-var MAX_FILE_REFS = 200;
+var MAX_FILE_REFS = 1000;
 var FileRefsBodySchema = exports_external.object({ paths: exports_external.array(exports_external.string()).catch([]) }).catch({ paths: [] });
 var BehaviorSchema = exports_external.enum(["allow", "deny"]);
 var ResolveBodySchema = exports_external.object({
@@ -25226,12 +25285,41 @@ async function parseBody(req, schema) {
   return schema.parse(await req.json().catch(() => ({})));
 }
 
+// src/lib/cmux.ts
+function readCmuxPane(env = process.env) {
+  const workspaceId = env.CMUX_WORKSPACE_ID;
+  const surfaceId = env.CMUX_SURFACE_ID;
+  if (!workspaceId || !surfaceId)
+    return;
+  return { workspaceId, surfaceId };
+}
+function markPaneRead(pane, deps = {}) {
+  const spawn = deps.spawn ?? Bun.spawn;
+  const log = deps.log ?? noopLogger;
+  try {
+    spawn([
+      "cmux",
+      "mark-notification-read",
+      "--workspace",
+      pane.workspaceId,
+      "--surface",
+      pane.surfaceId
+    ], { stdio: ["ignore", "ignore", "ignore"] }).unref();
+  } catch (err) {
+    log.warn("spawn", "unread mark clear failed", { reason: String(err) });
+  }
+}
+
+// src/plan/directory.ts
+import { readdir as readdir2 } from "fs/promises";
+import { join as join8, relative as relative3, sep as sep2 } from "path";
+
 // src/plan/excerpt.ts
-import { readdirSync as readdirSync3, readFileSync as readFileSync7, realpathSync, statSync as statSync2 } from "fs";
+import { readFileSync as readFileSync7 } from "fs";
+import { readdir, realpath, stat } from "fs/promises";
 import { extname, isAbsolute, join as join7, relative as relative2, resolve, sep } from "path";
-var EXCERPT_RADIUS = 6;
-var EXCERPT_HEAD_LINES = 13;
-var MAX_EXCERPT_BYTES = 2 * 1024 * 1024;
+var EXCERPT_HEAD_LINES = 60;
+var MAX_EXCERPT_BYTES = 10 * 1024 * 1024;
 var MAX_SCAN_ENTRIES = 5000;
 var SKIP_DIRS = new Set(["node_modules", "dist", "build", "coverage", "out"]);
 var EXT_LANGUAGE = {
@@ -25285,36 +25373,32 @@ function languageForPath(path) {
   return EXT_LANGUAGE[extname(path).toLowerCase()] ?? "text";
 }
 function safeRealpath(path) {
-  try {
-    return realpathSync(path);
-  } catch {
-    return null;
-  }
+  return realpath(path).catch(() => null);
 }
-function containedFile(cwdReal, abs) {
-  const real = safeRealpath(abs);
+function safeStat(path) {
+  return stat(path).catch(() => null);
+}
+async function contained(cwdReal, abs) {
+  const real = await safeRealpath(abs);
   if (real === null)
     return null;
   if (real !== cwdReal && !real.startsWith(cwdReal + sep))
     return null;
-  try {
-    if (!statSync2(real).isFile())
-      return null;
-  } catch {
+  const stats = await safeStat(real);
+  if (stats === null)
     return null;
-  }
-  return real;
+  if (stats.isFile())
+    return { path: real, kind: "file" };
+  return stats.isDirectory() ? { path: real, kind: "directory" } : null;
 }
-function basenameSearch(cwdReal, name) {
-  if (name === "")
-    return null;
+async function basenameSearch(cwdReal, name) {
   let scanned = 0;
   const queue = [cwdReal];
   while (queue.length > 0) {
     const currentDir = queue.shift();
     let entries;
     try {
-      entries = readdirSync3(currentDir, { withFileTypes: true });
+      entries = await readdir(currentDir, { withFileTypes: true });
     } catch {
       continue;
     }
@@ -25331,49 +25415,73 @@ function basenameSearch(cwdReal, name) {
   }
   return null;
 }
-function resolveFileInCwd(cwd, candidate) {
+async function resolveInCwd(cwd, candidate) {
   if (cwd === "" || !isAbsolute(cwd))
     return null;
-  const cwdReal = safeRealpath(cwd);
+  const cwdReal = await safeRealpath(cwd);
   if (cwdReal === null)
     return null;
   const cleaned = candidate.trim();
   if (cleaned === "")
     return null;
-  const direct = containedFile(cwdReal, resolve(cwdReal, cleaned));
+  const direct = await contained(cwdReal, resolve(cwdReal, cleaned));
   if (direct !== null)
     return direct;
-  const name = cleaned.split("/").pop() ?? "";
-  return basenameSearch(cwdReal, name);
-}
-function readFileExcerpt(cwd, candidate, line) {
-  const abs = resolveFileInCwd(cwd, candidate);
-  if (abs === null)
-    return null;
-  let size;
-  try {
-    size = statSync2(abs).size;
-  } catch {
-    return null;
-  }
-  if (size > MAX_EXCERPT_BYTES)
+  if (cleaned.includes("/") || !hasKnownFileExtension(cleaned))
     return null;
+  const found = await basenameSearch(cwdReal, cleaned);
+  return found === null ? null : { path: found, kind: "file" };
+}
+async function isFileTooLargeToPreview(cwd, candidate) {
+  const hit = await resolveInCwd(cwd, candidate);
+  if (hit === null || hit.kind !== "file")
+    return false;
+  const stats = await safeStat(hit.path);
+  return stats !== null && stats.size > MAX_EXCERPT_BYTES;
+}
+var memo = null;
+function statIdentity(stats) {
+  return `${stats.size}:${stats.mtimeMs}:${stats.ino}`;
+}
+function splitLines(content) {
+  const lines = content.split(`
+`);
+  if (lines.length > 1 && lines[lines.length - 1] === "")
+    lines.pop();
+  return lines;
+}
+function readLines(abs, stats) {
+  const identity = statIdentity(stats);
+  if (memo !== null && memo.path === abs && memo.identity === identity)
+    return memo.lines;
   let content;
   try {
     content = readFileSync7(abs, "utf-8");
   } catch {
     return null;
   }
-  if (content.includes("\x00"))
+  const lines = content.includes("\x00") ? null : splitLines(content);
+  memo = { path: abs, identity, lines };
+  return lines;
+}
+async function readFileExcerpt(cwd, candidate, line, range) {
+  const hit = await resolveInCwd(cwd, candidate);
+  if (hit === null || hit.kind !== "file")
+    return null;
+  const abs = hit.path;
+  const stats = await safeStat(abs);
+  if (stats === null || stats.size > MAX_EXCERPT_BYTES)
+    return null;
+  const allLines = readLines(abs, stats);
+  if (allLines === null)
     return null;
-  const allLines = content.split(`
-`);
-  if (allLines.length > 1 && allLines[allLines.length - 1] === "")
-    allLines.pop();
   const totalLines = allLines.length;
   let startLine;
   let endLine;
-  if (line !== undefined && line >= 1) {
+  if (range !== undefined) {
+    startLine = Math.min(Math.max(1, range.start), totalLines);
+    endLine = Math.min(totalLines, Math.max(range.end, startLine));
+  } else if (line !== undefined && line >= 1) {
     const target = Math.min(line, totalLines);
     startLine = Math.max(1, target - EXCERPT_RADIUS);
     endLine = Math.min(totalLines, target + EXCERPT_RADIUS);
@@ -25381,7 +25489,7 @@ function readFileExcerpt(cwd, candidate, line) {
     startLine = 1;
     endLine = Math.min(totalLines, EXCERPT_HEAD_LINES);
   }
-  const cwdReal = safeRealpath(cwd) ?? cwd;
+  const cwdReal = await safeRealpath(cwd) ?? cwd;
   return {
     path: relative2(cwdReal, abs),
     language: languageForPath(abs),
@@ -25392,6 +25500,62 @@ function readFileExcerpt(cwd, candidate, line) {
   };
 }
 
+// src/plan/directory.ts
+var MAX_DIR_ENTRIES = 500;
+var MAX_DIR_DEPTH = 10;
+function byKindThenName(a, b) {
+  if (a.kind !== b.kind)
+    return a.kind === "directory" ? -1 : 1;
+  return a.name < b.name ? -1 : a.name > b.name ? 1 : 0;
+}
+function entryFor(name, kind) {
+  if (kind === "file")
+    return { name, kind };
+  return SKIP_DIRS.has(name) || name.startsWith(".") ? { name, kind, skipped: true } : { name, kind };
+}
+async function listDirectory(cwd, root, path) {
+  const rootHit = await resolveInCwd(cwd, root);
+  if (rootHit === null || rootHit.kind !== "directory")
+    return null;
+  const target = path === "" ? rootHit : await resolveInCwd(cwd, path);
+  if (target === null || target.kind !== "directory")
+    return null;
+  const rel = relative3(rootHit.path, target.path);
+  if (rel === ".." || rel.startsWith(`..${sep2}`))
+    return null;
+  if (rel !== "" && rel.split(sep2).length > MAX_DIR_DEPTH)
+    return null;
+  let dirents;
+  try {
+    dirents = await readdir2(target.path, { withFileTypes: true });
+  } catch {
+    return null;
+  }
+  const entries = [];
+  const links = [];
+  for (const d of dirents) {
+    if (d.isFile())
+      entries.push(entryFor(d.name, "file"));
+    else if (d.isDirectory())
+      entries.push(entryFor(d.name, "directory"));
+    else if (d.isSymbolicLink())
+      links.push(d);
+  }
+  const targets = await Promise.all(links.map((d) => resolveInCwd(cwd, join8(target.path, d.name))));
+  targets.forEach((hit, i) => {
+    const link = links[i];
+    if (hit !== null && link !== undefined)
+      entries.push(entryFor(link.name, hit.kind));
+  });
+  entries.sort(byKindThenName);
+  const cwdReal = await safeRealpath(cwd) ?? cwd;
+  return {
+    path: relative3(cwdReal, target.path),
+    entries: entries.slice(0, MAX_DIR_ENTRIES),
+    total: entries.length
+  };
+}
+
 // src/review/decisions.ts
 function createDecisions(log = noopLogger) {
   const pending = new Map;
@@ -25438,12 +25602,12 @@ function createDecisions(log = noopLogger) {
 import { randomBytes } from "crypto";
 
 // src/plan/canonical-file.ts
-import { appendFileSync, existsSync as existsSync4, statSync as statSync3, writeFileSync as writeFileSync2 } from "fs";
+import { appendFileSync, existsSync as existsSync4, statSync as statSync2, writeFileSync as writeFileSync2 } from "fs";
 function guardedPlanFileWrite(planFilePath, log, failMsg, write) {
   try {
     if (!planFilePath.endsWith(".md"))
       return;
-    if (!existsSync4(planFilePath) || !statSync3(planFilePath).isFile())
+    if (!existsSync4(planFilePath) || !statSync2(planFilePath).isFile())
       return;
     write(planFilePath);
   } catch (err) {
@@ -25468,24 +25632,24 @@ import { createHash as createHash2 } from "crypto";
 import { chmodSync as chmodSync2, existsSync as existsSync5, mkdirSync as mkdirSync2, renameSync, writeFileSync as writeFileSync3 } from "fs";
 import { mkdtemp, rm } from "fs/promises";
 import { tmpdir } from "os";
-import { dirname as dirname5, join as join8 } from "path";
-var RUMDL_VERSION = "0.2.37";
+import { dirname as dirname5, join as join9 } from "path";
+var RUMDL_VERSION = "0.2.47";
 var ASSETS = {
   "darwin-arm64": {
     url: `https://github.com/rvben/rumdl/releases/download/v${RUMDL_VERSION}/rumdl-v${RUMDL_VERSION}-aarch64-apple-darwin.tar.gz`,
-    sha256: "ac5f31077c492c3303d27264d8d8840b1279cb5a8cd62f863a2045e1427a6c79"
+    sha256: "10dc23e994327ecc6e98d285802fcad1174608f203062cb18bac55b51976e0cb"
   },
   "darwin-x64": {
     url: `https://github.com/rvben/rumdl/releases/download/v${RUMDL_VERSION}/rumdl-v${RUMDL_VERSION}-x86_64-apple-darwin.tar.gz`,
-    sha256: "7cdfbc6ac896bfe433938a050e0f7b4dfc9ebc78d17ec8f4f872580b1fe06eba"
+    sha256: "9a2bf0c692310e0469fdc66fa83f74579cf0331cc1f9b306b25849cffd146c0f"
   },
   "linux-arm64": {
     url: `https://github.com/rvben/rumdl/releases/download/v${RUMDL_VERSION}/rumdl-v${RUMDL_VERSION}-aarch64-unknown-linux-musl.tar.gz`,
-    sha256: "2cee94dbc4e577c54869723245be548589e80a5e5a93fe25a3cc535d51e1ac6d"
+    sha256: "b5ab4207b92c0bf0ea6d8946f15545c787e8cf6ecf2176d9e7f26c43aead86a8"
   },
   "linux-x64": {
     url: `https://github.com/rvben/rumdl/releases/download/v${RUMDL_VERSION}/rumdl-v${RUMDL_VERSION}-x86_64-unknown-linux-musl.tar.gz`,
-    sha256: "0999d31c6f1429f0b3b5ed86d3ebb2768e5b4a16b373a51a41a7af2d7eb43b7c"
+    sha256: "bd4049763e93d6c25420ec086dee6690af31efc85af463c3ecf5d686a5fcf762"
   }
 };
 function rumdlAsset(platform = process.platform, arch = process.arch) {
@@ -25501,6 +25665,8 @@ code-blocks = false
 tables      = false
 reflow      = true
 reflow-mode = "normalize"
+reflow-length-exemptions = true
+ignore-link-urls = true
 `;
 async function downloadRumdl(binPath, asset, fetchImpl = fetch) {
   const res = await fetchImpl(asset.url);
@@ -25509,14 +25675,14 @@ async function downloadRumdl(binPath, asset, fetchImpl = fetch) {
   if (actual !== asset.sha256) {
     throw new Error(`rumdl: checksum mismatch for ${asset.url} (expected ${asset.sha256}, got ${actual})`);
   }
-  const work = await mkdtemp(join8(tmpdir(), "caret-rumdl-"));
+  const work = await mkdtemp(join9(tmpdir(), "caret-rumdl-"));
   try {
-    const archive = join8(work, "rumdl.tar.gz");
+    const archive = join9(work, "rumdl.tar.gz");
     await Bun.write(archive, bytes);
     const tar = Bun.spawn(["tar", "-xzf", archive, "-C", work], { stderr: "pipe" });
     if (await tar.exited !== 0)
       throw new Error(`rumdl: failed to extract ${asset.url}`);
-    const extracted = join8(work, "rumdl");
+    const extracted = join9(work, "rumdl");
     if (!existsSync5(extracted))
       throw new Error(`rumdl: binary not found in ${asset.url}`);
     mkdirSync2(dirname5(binPath), { recursive: true });
@@ -25549,8 +25715,9 @@ async function ensureRumdl(install = installPinnedRumdl) {
   const config2 = rumdlConfig();
   writeFileSync3(config2, RUMDL_CONFIG);
   const override = process.env.CARET_RUMDL_BIN?.trim();
-  if (override)
+  if (override && await installedVersion(override) === RUMDL_VERSION) {
     return { bin: override, config: config2, installed: false };
+  }
   const bin = rumdlBin();
   if (await installedVersion(bin) === RUMDL_VERSION)
     return { bin, config: config2, installed: false };
@@ -25633,6 +25800,7 @@ async function routeIncomingPlan(input, store, log = noopLogger) {
     await store.update(latest.id, (r) => {
       r.versions.push({ version: version2, plan, annotations: [], createdAt: now });
       r.status = "pending";
+      r.cmux = input.cmux ?? r.cmux;
       r.decision = undefined;
     });
     log.info("review", `review appended: ${shortId(latest.id)} v${version2}`, {
@@ -25659,6 +25827,7 @@ async function routeIncomingPlan(input, store, log = noopLogger) {
     title: input.title?.trim() || deriveTitle(plan),
     status: "pending",
     planEpoch,
+    cmux: input.cmux,
     versions: [{ version: 1, plan, annotations: [], createdAt: now }],
     createdAt: now,
     updatedAt: now
@@ -25745,10 +25914,11 @@ function resolveOptions(opts) {
     approveVariants: opts.approveVariants,
     source: opts.source,
     diagnostics: opts.diagnostics,
+    markPaneRead: opts.markPaneRead ?? ((pane) => markPaneRead(pane, { log: opts.log })),
     log: opts.log ?? noopLogger
   };
 }
-var ID_ROUTE_RE = /^\/api\/reviews\/([^/]+)(\/decision|\/resolve|\/draft|\/expire|\/file-refs|\/file)?$/;
+var ID_ROUTE_RE = /^\/api\/reviews\/([^/]+)(\/decision|\/resolve|\/draft|\/expire|\/seen|\/file-refs|\/file|\/dir)?$/;
 function matchIdRoute(path) {
   const m = path.match(ID_ROUTE_RE);
   if (!m)
@@ -25807,6 +25977,9 @@ function createServer(opts) {
   function notFound() {
     return new Response("not found", { status: 404 });
   }
+  function tooLarge() {
+    return new Response("too large", { status: 413 });
+  }
   function handleHealth() {
     const body = {
       ...IDENTITY,
@@ -25911,27 +26084,59 @@ function createServer(opts) {
       return notFound();
     const { paths } = await parseBody(req, FileRefsBodySchema);
     const seen = new Set;
-    const resolved = [];
-    for (const p of paths.slice(0, MAX_FILE_REFS)) {
+    const unique = [];
+    for (const p of paths) {
       if (seen.has(p))
         continue;
       seen.add(p);
-      if (resolveFileInCwd(r.cwd, p) !== null)
-        resolved.push(p);
+      if (unique.push(p) === MAX_FILE_REFS)
+        break;
     }
-    log.debug("request", `file-refs resolved: ${resolved.length}/${seen.size}`, { reviewId: id });
+    const entries = await Promise.all(unique.map(async (p) => {
+      const hit = await resolveInCwd(r.cwd, p);
+      return hit === null ? null : [p, hit.kind];
+    }));
+    const resolved = Object.fromEntries(entries.filter((e) => e !== null));
+    log.debug("request", `file-refs resolved: ${Object.keys(resolved).length}/${unique.length}`, {
+      reviewId: id,
+      requested: paths.length,
+      directories: Object.values(resolved).filter((k) => k === "directory").length
+    });
     return Response.json({ resolved });
   }
-  function handleFileExcerpt(req, id) {
+  async function handleFileExcerpt(req, id) {
     const r = store.get(id);
     if (!r)
       return notFound();
     const params = new URL(req.url).searchParams;
     const path = params.get("path") ?? "";
-    const lineRaw = params.get("line");
-    const line = lineRaw !== null && /^\d+$/.test(lineRaw) ? Number(lineRaw) : undefined;
-    const excerpt = readFileExcerpt(r.cwd, path, line);
-    return excerpt ? Response.json(excerpt) : notFound();
+    const num = (key) => {
+      const raw = params.get(key);
+      return raw !== null && /^\d+$/.test(raw) ? Number(raw) : undefined;
+    };
+    const line = num("line");
+    const start = num("start");
+    const end = num("end");
+    const range = start !== undefined && end !== undefined ? { start, end } : undefined;
+    const excerpt = await readFileExcerpt(r.cwd, path, line, range);
+    if (excerpt)
+      return Response.json(excerpt);
+    return await isFileTooLargeToPreview(r.cwd, path) ? tooLarge() : notFound();
+  }
+  async function handleDirListing(req, id) {
+    const r = store.get(id);
+    if (!r)
+      return notFound();
+    const params = new URL(req.url).searchParams;
+    const listing = await listDirectory(r.cwd, params.get("root") ?? "", params.get("path") ?? "");
+    if (listing === null)
+      return notFound();
+    log.debug("request", "dir listed", {
+      reviewId: id,
+      total: listing.total,
+      returned: listing.entries.length
+    });
+    return Response.json(listing);
   }
   async function handleDecision(id) {
     const inMem = store.get(id);
@@ -25989,6 +26194,10 @@ function createServer(opts) {
     await store.update(id, (r) => {
       r.decision = decision;
       r.status = decision.behavior === "allow" ? "approved" : "rejected";
+      const general = r.generalCommentDraft?.trim();
+      if (general && decision.behavior === "deny" && decision.feedback?.includes(general)) {
+        currentVersion(r).generalComment = general;
+      }
       r.generalCommentDraft = "";
       currentVersion(r).composerScratches = [];
     });
@@ -26001,6 +26210,8 @@ function createServer(opts) {
         });
       }
     }
+    if (existing.cmux)
+      cfg.markPaneRead(existing.cmux);
     setTimeout(() => resolveDecision(id, decision), 0);
     log.info("resolve", `review ${shortId(id)} resolved: ${decision.behavior}`, {
       reviewId: id,
@@ -26021,6 +26232,14 @@ function createServer(opts) {
     });
     return Response.json({ ok: true });
   }
+  function handleSeen(id) {
+    const existing = store.get(id);
+    if (!existing)
+      return notFound();
+    if (existing.cmux)
+      cfg.markPaneRead(existing.cmux);
+    return new Response(null, { status: 204 });
+  }
   async function dispatch(req, method, path) {
     if (method === "GET" && path === "/api/health")
       return handleHealth();
@@ -26047,6 +26266,8 @@ function createServer(opts) {
         return handleGetReview(id);
       if (method === "GET" && sub === "/file")
         return handleFileExcerpt(req, id);
+      if (method === "GET" && sub === "/dir")
+        return handleDirListing(req, id);
       if (method === "POST" && sub === "/file-refs")
         return handleFileRefs(req, id);
       if (method === "GET" && sub === "/decision")
@@ -26057,6 +26278,8 @@ function createServer(opts) {
         return handleResolve(req, id);
       if (method === "POST" && sub === "/expire")
         return handleExpire(id);
+      if (method === "POST" && sub === "/seen")
+        return handleSeen(id);
     }
     if (method === "GET") {
       const asset = handleAsset(path);
@@ -26138,8 +26361,8 @@ function createServer(opts) {
 }
 
 // src/review/store.ts
-import { readdir, readFile as readFile3, writeFile as writeFile2 } from "fs/promises";
-import { join as join9 } from "path";
+import { readdir as readdir3, readFile as readFile3, writeFile as writeFile2 } from "fs/promises";
+import { join as join10 } from "path";
 function createStore(dir, log = noopLogger) {
   const reviews = new Map;
   const epochs = new Map;
@@ -26148,7 +26371,7 @@ function createStore(dir, log = noopLogger) {
     const prev = writeChains.get(review.id) ?? Promise.resolve();
     const next = prev.catch(() => {}).then(async () => {
       ensureStateDir(dir);
-      await writeFile2(join9(dir, `${review.id}.json`), JSON.stringify(review, null, 2), {
+      await writeFile2(join10(dir, `${review.id}.json`), JSON.stringify(review, null, 2), {
         mode: 384
       });
       log.debug("store", `review persisted: ${shortId(review.id)}`, { reviewId: review.id });
@@ -26198,7 +26421,7 @@ function createStore(dir, log = noopLogger) {
       return review;
     },
     async persisted(id) {
-      return await readJsonFile(join9(dir, `${id}.json`)) ?? undefined;
+      return await readJsonFile(join10(dir, `${id}.json`)) ?? undefined;
     },
     size() {
       return reviews.size;
@@ -26215,7 +26438,7 @@ function createStore(dir, log = noopLogger) {
     async rehydrate() {
       let files;
       try {
-        files = await readdir(dir);
+        files = await readdir3(dir);
       } catch {
         log.debug("store", "no reviews dir; nothing to rehydrate");
         return;
@@ -26225,7 +26448,7 @@ function createStore(dir, log = noopLogger) {
         if (!file2.endsWith(".json"))
           continue;
         try {
-          const review = JSON.parse(await readFile3(join9(dir, file2), "utf-8"));
+          const review = JSON.parse(await readFile3(join10(dir, file2), "utf-8"));
           if (isUnresolved(review.status)) {
             reviews.set(review.id, review);
             loaded++;
@@ -26324,8 +26547,8 @@ import { existsSync as existsSync7 } from "fs";
 import { release } from "os";
 
 // src/discovery.ts
-import { readdirSync as readdirSync4, statSync as statSync4 } from "fs";
-import { basename as basename2, join as join10 } from "path";
+import { readdirSync as readdirSync3, statSync as statSync3 } from "fs";
+import { basename as basename2, join as join11 } from "path";
 var CARET_BIN = "caret-native";
 async function safe(build) {
   try {
@@ -26525,7 +26748,7 @@ function listReviewFiles() {
   const dir = reviewsDir();
   let files;
   try {
-    files = readdirSync4(dir);
+    files = readdirSync3(dir);
   } catch {
     return [];
   }
@@ -26535,7 +26758,7 @@ function listReviewFiles() {
       continue;
     if (out.length >= 5000)
       break;
-    const raw = readJsonFileSync(join10(dir, file2));
+    const raw = readJsonFileSync(join11(dir, file2));
     if (raw && typeof raw.id === "string" && typeof raw.status === "string") {
       out.push({ id: raw.id, status: raw.status });
     }
@@ -26546,7 +26769,7 @@ var TAIL_BYTES = 256 * 1024;
 async function logStats(path) {
   let size;
   try {
-    size = statSync4(path).size;
+    size = statSync3(path).size;
   } catch {
     return { path, exists: false, size: 0, errors: 0, warns: 0 };
   }
@@ -26639,33 +26862,33 @@ import {
   existsSync as existsSync9,
   mkdirSync as mkdirSync3,
   rmSync as rmSync2,
-  statSync as statSync5,
+  statSync as statSync4,
   symlinkSync,
   writeFileSync as writeFileSync5
 } from "fs";
-import { join as join12, resolve as resolve2 } from "path";
+import { join as join13, resolve as resolve2 } from "path";
 
 // src/adapters/opencode/packaging.ts
-import { existsSync as existsSync8, readdirSync as readdirSync5, readFileSync as readFileSync8 } from "fs";
-import { dirname as dirname7, join as join11 } from "path";
+import { existsSync as existsSync8, readdirSync as readdirSync4, readFileSync as readFileSync8 } from "fs";
+import { dirname as dirname7, join as join12 } from "path";
 function resolveCaretRoot() {
   const candidates = [];
   const script = process.argv[1];
   if (script)
-    candidates.push(join11(dirname7(script), ".."));
-  candidates.push(join11(dirname7(process.execPath), ".."));
+    candidates.push(join12(dirname7(script), ".."));
+  candidates.push(join12(dirname7(process.execPath), ".."));
   for (const root of candidates) {
-    if (existsSync8(join11(root, "opencode", "caret.plugin.ts")))
+    if (existsSync8(join12(root, "opencode", "caret.plugin.ts")))
       return root;
   }
   throw new Error(`caret OpenCode packaging not found (no opencode/caret.plugin.ts under: ${candidates.join(", ") || "(none)"}). The OpenCode plugin source must ship with caret.`);
 }
 function loadOpencodePackaging(root = resolveCaretRoot()) {
-  const binPath = join11(root, "bin", "caret");
-  const commandsDir = join11(root, "opencode", "commands");
+  const binPath = join12(root, "bin", "caret");
+  const commandsDir = join12(root, "opencode", "commands");
   let commands = [];
   try {
-    commands = readdirSync5(commandsDir).filter((f) => f.endsWith(".md")).sort().map((f) => ({ name: f, contents: readFileSync8(join11(commandsDir, f), "utf-8") }));
+    commands = readdirSync4(commandsDir).filter((f) => f.endsWith(".md")).sort().map((f) => ({ name: f, contents: readFileSync8(join12(commandsDir, f), "utf-8") }));
   } catch {
     commands = [];
   }
@@ -26674,17 +26897,17 @@ function loadOpencodePackaging(root = resolveCaretRoot()) {
 
 // src/commands/install/local.ts
 function devMarketplaceDir() {
-  return join12(stateDir(), "dev-marketplace");
+  return join13(stateDir(), "dev-marketplace");
 }
 function resolveLocalCheckout(opts = {}, deps = {}) {
   const repoDir = resolve2(caretRoot(deps));
-  if (!existsSync9(join12(repoDir, ".claude-plugin", "marketplace.json"))) {
+  if (!existsSync9(join13(repoDir, ".claude-plugin", "marketplace.json"))) {
     throw new Error(`--from-local must run from a caret checkout (no .claude-plugin/marketplace.json at ${repoDir}). A published caret installs with a plain \`caret install\`.`);
   }
   if (opts.requireArtifacts !== false) {
     const missing = [
-      isExecutable(join12(repoDir, "bin", "caret-native")) ? null : "bin/caret-native",
-      isDirectory(join12(repoDir, "bin", "ui")) ? null : "bin/ui"
+      isExecutable(join13(repoDir, "bin", "caret-native")) ? null : "bin/caret-native",
+      isDirectory(join13(repoDir, "bin", "ui")) ? null : "bin/ui"
     ].filter((m) => m !== null);
     if (missing.length > 0) {
       throw new Error(`--from-local reuses the build artifacts bin/caret-native + bin/ui, and ${repoDir} is missing ${missing.join(" + ")} \u2014 run \`mise run build\` first.`);
@@ -26703,9 +26926,9 @@ function caretRoot(deps) {
 }
 function writeDevMarketplace(repoDir, outDir) {
   rmSync2(outDir, { recursive: true, force: true });
-  mkdirSync3(join12(outDir, ".claude-plugin"), { recursive: true });
-  symlinkSync(resolve2(repoDir), join12(outDir, "caret"));
-  writeFileSync5(join12(outDir, ".claude-plugin", "marketplace.json"), `${JSON.stringify({
+  mkdirSync3(join13(outDir, ".claude-plugin"), { recursive: true });
+  symlinkSync(resolve2(repoDir), join13(outDir, "caret"));
+  writeFileSync5(join13(outDir, ".claude-plugin", "marketplace.json"), `${JSON.stringify({
     name: "caret",
     description: "Local caret dev build (generated by caret install --from-local).",
     owner: { name: "macintacos" },
@@ -26716,20 +26939,20 @@ function writeDevMarketplace(repoDir, outDir) {
 async function prewarmLocalBuild(repoDir, deps = {}) {
   const spawn = deps.spawn ?? runCaptured;
   try {
-    await spawn([join12(repoDir, "bin", "caret-native"), "prewarm"]);
+    await spawn([join13(repoDir, "bin", "caret-native"), "prewarm"]);
   } catch {}
 }
 function isExecutable(path) {
   try {
     accessSync(path, constants.X_OK);
-    return statSync5(path).isFile();
+    return statSync4(path).isFile();
   } catch {
     return false;
   }
 }
 function isDirectory(path) {
   try {
-    return statSync5(path).isDirectory();
+    return statSync4(path).isDirectory();
   } catch {
     return false;
   }
@@ -26991,7 +27214,7 @@ async function runInstallClaudeTarget(opts, deps = {}) {
 
 // src/commands/install/opencode.ts
 import { existsSync as existsSync13, readFileSync as readFileSync9, writeFileSync as writeFileSync7 } from "fs";
-import { basename as basename3, join as join14 } from "path";
+import { basename as basename3, join as join15 } from "path";
 
 // src/adapters/opencode/deploy.ts
 import { existsSync as existsSync11, mkdirSync as mkdirSync4, rmSync as rmSync3, writeFileSync as writeFileSync6 } from "fs";
@@ -27094,7 +27317,7 @@ async function promptUpgrade(verdict, clack) {
 
 // src/commands/install/opencode.ts
 function isCaretCheckout(dir) {
-  return existsSync13(join14(dir, "opencode", "caret.plugin.ts"));
+  return existsSync13(join15(dir, "opencode", "caret.plugin.ts"));
 }
 function caretEntries(text2, isCheckout) {
   return pluginEntries(text2).filter((entry) => {
@@ -27120,7 +27343,7 @@ async function runInstallOpencodeTarget(opts, deps = {}) {
   const ui = deps.ui ?? silentUI;
   const isCheckout = deps.isCheckout ?? isCaretCheckout;
   const configFile2 = resolveConfigFile(dir);
-  const commandPaths = pkg.commands.map((c3) => join14(commandDir(dir), namespacedCommandFilename(c3.name)));
+  const commandPaths = pkg.commands.map((c3) => join15(commandDir(dir), namespacedCommandFilename(c3.name)));
   const legacy = existingLegacyInstallFiles(dir);
   const specifier = opts.local ? localPluginSpecifier(opts.local.repoDir) : CARET_PACKAGE;
   if (opts.dryRun) {
@@ -27143,7 +27366,7 @@ async function runInstallOpencodeTarget(opts, deps = {}) {
     await upgradeStep(configFile2, opts, deps, ui);
   await sweepLegacy(legacy, dir, ui);
   const files = pkg.commands.map((c3) => ({
-    path: join14(commandDir(dir), namespacedCommandFilename(c3.name)),
+    path: join15(commandDir(dir), namespacedCommandFilename(c3.name)),
     contents: renderPlugin(c3.contents, { version: VERSION, binPath: pkg.binPath })
   }));
   await ui.step("Deploying the /caret:* command files", async () => deployFiles(files, { dryRun: false }), (deployed) => `Deployed ${deployed.paths.length} command file(s) to ${dir}`);
@@ -28813,7 +29036,10 @@ async function runReview(stdin2, deps) {
     step = "ensureDaemon";
     baseUrl = await deps.ensureDaemon();
     step = "postReview";
-    const { id, hasLiveClient } = await deps.postReview(baseUrl, input);
+    const { id, hasLiveClient } = await deps.postReview(baseUrl, {
+      ...input,
+      cmux: deps.readPane?.()
+    });
     ctx.reviewId = id;
     deps.onPosted?.(baseUrl, id);
     logDebug("review", `review created: ${shortId(id)}`, { ...ctx });
@@ -28880,6 +29106,7 @@ function prodReviewDeps(s, adapter) {
     postReview,
     longPoll,
     openBrowser,
+    readPane: readCmuxPane,
     timeoutMs: reviewTimeoutMs(s),
     expire: expireReview
   };