chatroom-cli 1.80.1 → 1.82.0

package/dist/index.js

@@ -77473,6 +77473,7 @@ var init_unresolved_decisions = () => {};
 // ../../services/backend/prompts/utils/handoff-report-template-body.ts
 function getHandoffReportTemplateBody(roleGuidanceContext) {
   return `<handoff-overview>
+<!-- For informational tasks (summaries, feedback, Q&amp;A with no code changes): put the complete primary answer in Summary and What changed — the user only sees this handoff. -->
 ## Summary
 <what was accomplished, in plain terms — no references to prior messages>
 
@@ -77834,7 +77835,7 @@ function getNativeHandoffTurnEndGuidance(nextRole) {
   if (nextRole.toLowerCase() === "user") {
     lines.push("The system delivers the next chatroom task when the user sends one.");
   } else {
-    lines.push(`The system delivers \`${nextRole}\`'s handback when they finish — do not poll \`messages list\` or sleep waiting.`);
+    lines.push(`The system delivers \`${nextRole}\`'s handback when they finish — do not poll \`messages download\` while waiting. For history reconstruction tasks, \`messages download\` is the correct tool.`);
   }
   return lines.join(`
 `);
@@ -80525,29 +80526,19 @@ var init_skill = __esm(() => {
 
 // src/commands/messages/messages-fs-service.ts
 import * as nodeFs2 from "node:fs/promises";
-function buildMessageMarkdown(msg) {
+function messageFilename(msg) {
+  const sortPrefix = String(SORT_KEY_MAX - msg._creationTime).padStart(13, "0");
+  const receiver = msg.targetRole ?? "all";
+  return `${sortPrefix}_${msg.senderRole}-to-${receiver}_${msg._id}.md`;
+}
+function buildLinearMessageContent(msg) {
   const ts = new Date(msg._creationTime).toISOString();
-  const parts2 = [];
-  parts2.push("---");
-  parts2.push(`id: ${msg._id}`);
-  parts2.push(`createdAt: ${ts}`);
-  parts2.push(`senderRole: ${msg.senderRole}`);
-  parts2.push(`type: ${msg.type}`);
-  if (msg.targetRole)
-    parts2.push(`targetRole: ${msg.targetRole}`);
-  if (msg.classification)
-    parts2.push(`classification: ${msg.classification}`);
-  if (msg.taskStatus)
-    parts2.push(`taskStatus: ${msg.taskStatus}`);
-  if (msg.featureTitle)
-    parts2.push(`featureTitle: ${msg.featureTitle}`);
-  parts2.push("---");
-  parts2.push("");
-  parts2.push(msg.content);
-  return parts2.join(`
-`);
+  const receiver = msg.targetRole ? ` → ${msg.targetRole}` : "";
+  return `${ts} | ${msg.senderRole}${receiver}
+
+${msg.content}`;
 }
-var MessagesFsService, MessagesFsServiceLive;
+var MessagesFsService, MessagesFsServiceLive, SORT_KEY_MAX = 9999999999999;
 var init_messages_fs_service = __esm(() => {
   init_esm();
   MessagesFsService = class MessagesFsService extends exports_Context.Tag("MessagesFsService")() {
@@ -80560,10 +80551,186 @@ var init_messages_fs_service = __esm(() => {
     mkdir: (path3, opts) => exports_Effect.tryPromise({
       try: () => nodeFs2.mkdir(path3, opts),
       catch: (e) => e instanceof Error ? e : new Error(String(e))
+    }),
+    rm: (path3, opts) => exports_Effect.tryPromise({
+      try: () => nodeFs2.rm(path3, opts),
+      catch: (e) => e instanceof Error ? e : new Error(String(e))
     })
   });
 });
 
+// src/commands/messages/download.ts
+var exports_download = {};
+__export(exports_download, {
+  resolveDownloadOutputDir: () => resolveDownloadOutputDir,
+  downloadMessagesEffect: () => downloadMessagesEffect,
+  downloadMessages: () => downloadMessages
+});
+import * as nodePath2 from "node:path";
+function parseLimit(raw) {
+  const cap = raw ?? DEFAULT_LIMIT;
+  if (!Number.isFinite(cap) || cap < 1)
+    return DEFAULT_LIMIT;
+  return Math.min(Math.floor(cap), ABSOLUTE_MAX);
+}
+function resolveDownloadOutputDir(format4, cwd = process.cwd()) {
+  const downloadId = new Date().toISOString().replace(/[:.]/g, "-");
+  return nodePath2.resolve(cwd, ".chatroom", "downloads", "messages", format4, downloadId);
+}
+async function downloadMessages(chatroomId, options, deps) {
+  const { getSessionId: getSessionId2, getOtherSessionUrls: getOtherSessionUrls2 } = await Promise.resolve().then(() => (init_storage(), exports_storage));
+  const { getConvexClient: getConvexClient2, getConvexUrl: getConvexUrl2 } = await Promise.resolve().then(() => (init_client2(), exports_client));
+  const client4 = await getConvexClient2();
+  const actualDeps = deps ?? {
+    backend: {
+      mutation: (ep, args2) => client4.mutation(ep, args2),
+      query: (ep, args2) => client4.query(ep, args2)
+    },
+    session: { getSessionId: getSessionId2, getConvexUrl: getConvexUrl2, getOtherSessionUrls: getOtherSessionUrls2 }
+  };
+  const layer = commandServicesLayerFromDeps(actualDeps);
+  const handler = (err) => {
+    return exports_Effect.sync(() => {
+      if (err._tag === "NotAuthenticated") {
+        console.error(`❌ Not authenticated`);
+        process.exit(1);
+      } else if (err._tag === "InvalidChatroomId") {
+        console.error(`❌ Invalid chatroom ID`);
+        process.exit(1);
+      } else if (err._tag === "QueryFailed") {
+        console.error(`
+❌ Error fetching messages: ${err.cause.message}`);
+        process.exit(1);
+      } else if (err._tag === "OutputDirError") {
+        console.error(`
+❌ Failed to create output directory: ${err.cause.message}`);
+        process.exit(1);
+      } else if (err._tag === "WriteFailed") {
+        console.error(`
+❌ Failed to write ${err.path}: ${err.cause.message}`);
+        process.exit(1);
+      } else {
+        console.error(`
+❌ Download failed: ${err.message}`);
+        process.exit(1);
+      }
+    });
+  };
+  await exports_Effect.runPromise(downloadMessagesEffect(chatroomId, options).pipe(exports_Effect.catchAll(handler), exports_Effect.provide(exports_Layer.mergeAll(layer, MessagesFsServiceLive))));
+}
+var PAGE_SIZE = 50, ABSOLUTE_MAX = 5000, DEFAULT_LIMIT = 10, downloadMessagesEffect = (chatroomId, options) => exports_Effect.gen(function* () {
+  const backend2 = yield* BackendService;
+  const fs11 = yield* MessagesFsService;
+  const sessionId = yield* requireSessionIdEffect((a) => ({
+    _tag: "NotAuthenticated",
+    convexUrl: a.convexUrl,
+    otherUrls: a.otherUrls
+  }));
+  yield* validateChatroomIdEffect(chatroomId, (id3) => ({
+    _tag: "InvalidChatroomId",
+    id: id3
+  }));
+  const format4 = options.format ?? "linear";
+  const maxDownload = parseLimit(options.limit);
+  const outputDir = options.outputDir ?? resolveDownloadOutputDir(format4);
+  const absoluteOutputDir = nodePath2.resolve(outputDir);
+  const messages = [];
+  let truncated = false;
+  let hasMore = true;
+  const firstPageSize = Math.min(PAGE_SIZE, maxDownload);
+  const latest = yield* backend2.query(api.messageList.getLatestMessages, { sessionId, chatroomId, limit: firstPageSize });
+  messages.push(...latest.messages);
+  hasMore = latest.hasMore;
+  while (hasMore && messages.length < maxDownload) {
+    const oldest = messages[0];
+    if (!oldest) {
+      hasMore = false;
+      break;
+    }
+    const remaining = maxDownload - messages.length;
+    const pageSize = Math.min(PAGE_SIZE, remaining);
+    const batch = yield* backend2.query(api.messageList.listMessagesBefore, {
+      sessionId,
+      chatroomId,
+      before: oldest._creationTime,
+      limit: pageSize
+    });
+    if (batch.length === 0) {
+      hasMore = false;
+      break;
+    }
+    const space = maxDownload - messages.length;
+    const toPrepend = batch.slice(Math.max(0, batch.length - space));
+    for (let i2 = toPrepend.length - 1;i2 >= 0; i2--)
+      messages.unshift(toPrepend[i2]);
+    hasMore = batch.length >= pageSize && messages.length < maxDownload;
+    if (messages.length >= maxDownload && (batch.length >= pageSize || latest.hasMore))
+      truncated = true;
+    if (toPrepend.length < batch.length)
+      truncated = true;
+  }
+  const complete3 = !truncated && !hasMore;
+  yield* fs11.rm(outputDir, { recursive: true, force: true }).pipe(exports_Effect.catchAll(() => exports_Effect.void));
+  yield* fs11.mkdir(outputDir, { recursive: true }).pipe(exports_Effect.mapError((cause3) => ({ _tag: "OutputDirError", cause: cause3 })));
+  const manifestEntries = [];
+  for (const msg of messages) {
+    const file = messageFilename(msg);
+    const content = buildLinearMessageContent(msg);
+    const filePath = nodePath2.join(outputDir, file);
+    yield* fs11.writeFile(filePath, content).pipe(exports_Effect.mapError((cause3) => ({
+      _tag: "WriteFailed",
+      path: filePath,
+      cause: cause3
+    })));
+    manifestEntries.push({
+      id: msg._id,
+      file,
+      createdAt: new Date(msg._creationTime).toISOString(),
+      senderRole: msg.senderRole,
+      targetRole: msg.targetRole
+    });
+  }
+  const manifest = {
+    chatroomId,
+    downloadedAt: new Date().toISOString(),
+    count: messages.length,
+    complete: complete3,
+    truncated,
+    oldestDownloadedAt: messages[0] ? new Date(messages[0]._creationTime).toISOString() : null,
+    newestDownloadedAt: messages[messages.length - 1] ? new Date(messages[messages.length - 1]._creationTime).toISOString() : null,
+    messages: manifestEntries
+  };
+  const manifestPath = nodePath2.join(outputDir, "manifest.json");
+  yield* fs11.writeFile(manifestPath, JSON.stringify(manifest, null, 2)).pipe(exports_Effect.mapError((cause3) => ({
+    _tag: "WriteFailed",
+    path: manifestPath,
+    cause: cause3
+  })));
+  yield* exports_Effect.sync(() => {
+    console.log(`
+✅ Downloaded ${messages.length} messages to:`);
+    console.log(`   ${absoluteOutputDir}`);
+    console.log(`   complete=${complete3} truncated=${truncated}`);
+    console.log(`
+\uD83D\uDCA1 Read recent history:`);
+    console.log(`   ls "${absoluteOutputDir}/"`);
+    console.log(`   cat "${absoluteOutputDir}/manifest.json"`);
+    console.log(`   rg "pattern" "${absoluteOutputDir}/"`);
+    if (truncated) {
+      const nextLimit = Math.min(messages.length * 2, ABSOLUTE_MAX);
+      console.log(`
+\uD83D\uDCA1 Truncated — fetch more history by increasing --limit:`);
+      console.log(`   chatroom messages download --chatroom-id=${chatroomId} --role=${options.role} --format=linear --limit=${nextLimit}`);
+    }
+  });
+});
+var init_download = __esm(() => {
+  init_esm();
+  init_messages_fs_service();
+  init_api3();
+  init_services();
+});
+
 // src/commands/messages/index.ts
 var exports_messages = {};
 __export(exports_messages, {
@@ -80571,10 +80738,8 @@ __export(exports_messages, {
   listSinceMessage: () => listSinceMessage,
   listBySenderRoleEffect: () => listBySenderRoleEffect,
   listBySenderRole: () => listBySenderRole,
-  exportMessagesEffect: () => exportMessagesEffect,
-  exportMessages: () => exportMessages
+  downloadMessages: () => downloadMessages
 });
-import * as nodePath2 from "node:path";
 async function createDefaultDeps14() {
   const client4 = await getConvexClient();
   return {
@@ -80645,20 +80810,6 @@ async function listSinceMessage(chatroomId, options, deps) {
   const layer = commandServicesLayerFromDeps(d);
   await exports_Effect.runPromise(listSinceMessageEffect(chatroomId, options).pipe(exports_Effect.catchAll((err) => handleMessagesError(err)), exports_Effect.provide(layer)));
 }
-async function exportMessages(chatroomId, options, deps) {
-  const d = deps ?? await createDefaultDeps14();
-  const layer = commandServicesLayerFromDeps(d);
-  await exports_Effect.runPromise(exportMessagesEffect(chatroomId, options).pipe(exports_Effect.catchAll((err) => {
-    if ("_tag" in err) {
-      return handleMessagesError(err);
-    }
-    return exports_Effect.sync(() => {
-      console.error(`
-❌ Export failed: ${err.message}`);
-      process.exit(1);
-    });
-  }), exports_Effect.provide(exports_Layer.mergeAll(layer, MessagesFsServiceLive))));
-}
 var listBySenderRoleEffect = (chatroomId, options) => exports_Effect.gen(function* () {
   const backend2 = yield* BackendService;
   const sessionId = yield* requireSessionIdEffect((a) => ({
@@ -80749,63 +80900,14 @@ ${roleIndicator} ${message.senderRole}${message.targetRole ? ` → ${message.tar
 ` + "─".repeat(60));
     console.log(`\uD83D\uDCA1 Use --full to see complete message content`);
   });
-}), exportMessagesEffect = (chatroomId, options) => exports_Effect.gen(function* () {
-  const backend2 = yield* BackendService;
-  const fs11 = yield* MessagesFsService;
-  const sessionId = yield* requireSessionIdEffect((a) => ({
-    _tag: "NotAuthenticated",
-    convexUrl: a.convexUrl,
-    otherUrls: a.otherUrls
-  }));
-  yield* validateChatroomIdEffect(chatroomId, (id3) => ({
-    _tag: "InvalidChatroomId",
-    id: id3
-  }));
-  const messagesResult = yield* exports_Effect.either(backend2.query(api.messages.listBySenderRole, {
-    sessionId,
-    chatroomId,
-    senderRole: options.senderRole || "planner",
-    limit: options.limit
-  }));
-  if (messagesResult._tag === "Left") {
-    return yield* exports_Effect.fail({
-      _tag: "QueryFailed",
-      cause: messagesResult.left
-    });
-  }
-  const messages = messagesResult.right;
-  if (messages.length === 0) {
-    yield* exports_Effect.sync(() => console.log("No messages to export."));
-    return;
-  }
-  const dir = options.exportPath || `.chatroom/exports/messages/${chatroomId}`;
-  yield* fs11.mkdir(dir, { recursive: true });
-  const manifest = [];
-  for (const msg of messages) {
-    const filename = `${msg._creationTime}-${msg.senderRole}-${msg._id.slice(0, 8)}.md`;
-    const markdown = buildMessageMarkdown(msg);
-    yield* fs11.writeFile(nodePath2.join(dir, filename), markdown);
-    manifest.push({
-      id: msg._id,
-      senderRole: msg.senderRole,
-      createdAt: msg._creationTime,
-      filename
-    });
-  }
-  yield* fs11.writeFile(nodePath2.join(dir, "manifest.json"), JSON.stringify(manifest, null, 2));
-  yield* exports_Effect.sync(() => {
-    console.log(`
-\uD83D\uDCE8 Exported ${messages.length} messages to ${dir}`);
-    console.log(`   Manifest: ${dir}/manifest.json`);
-  });
 });
 var init_messages = __esm(() => {
   init_esm();
-  init_messages_fs_service();
   init_api3();
   init_storage();
   init_client2();
   init_services();
+  init_download();
 });
 
 // src/commands/context/format-new-context-error.ts
@@ -97229,7 +97331,7 @@ async function emitPhase(deps, event, phase, detail) {
   });
 }
 function sleep5(ms) {
-  return new Promise((resolve4) => setTimeout(resolve4, ms));
+  return new Promise((resolve5) => setTimeout(resolve5, ms));
 }
 async function waitForHarnessSessionId(deps, event, pid) {
   const initial = deps.agentMgr.getSlot(event.chatroomId, event.role);
@@ -97741,19 +97843,19 @@ class ProcessManager {
     this.pendingStops.clear();
   }
   waitForExit(runId, ms) {
-    return new Promise((resolve4) => {
+    return new Promise((resolve5) => {
       const interval = 100;
       let elapsed3 = 0;
       const timer = setInterval(() => {
         if (!this.runningProcesses.has(runId)) {
           clearInterval(timer);
-          resolve4(true);
+          resolve5(true);
           return;
         }
         elapsed3 += interval;
         if (elapsed3 >= ms) {
           clearInterval(timer);
-          resolve4(false);
+          resolve5(false);
         }
       }, interval);
     });
@@ -97884,7 +97986,7 @@ var init_log_observer_sync = __esm(() => {
 });
 
 // src/commands/machine/daemon-start/handlers/process/output-store.ts
-import { appendFile as appendFile2, mkdir as mkdir8, readFile as readFile6, rm } from "node:fs/promises";
+import { appendFile as appendFile2, mkdir as mkdir8, readFile as readFile6, rm as rm2 } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import { join as join17 } from "node:path";
 
@@ -97941,7 +98043,7 @@ class TempFileOutputStore {
   }
   async destroy() {
     try {
-      await rm(this.state.filePath, { force: true });
+      await rm2(this.state.filePath, { force: true });
     } catch {}
   }
 }
@@ -97957,7 +98059,7 @@ async function ensureTempDir() {
 }
 async function cleanOrphanTempFiles() {
   try {
-    await rm(TEMP_DIR, { recursive: true, force: true });
+    await rm2(TEMP_DIR, { recursive: true, force: true });
   } catch {}
 }
 var TAIL_WINDOW_BYTES, TEMP_DIR, RUN_ID_RE, MAX_TAIL_LINES_V2 = 50;
@@ -98323,8 +98425,8 @@ var init_command_runner = __esm(() => {
     }).catch((err) => {
       console.warn(`[${formatTimestamp()}] ⚠️ Failed to mark run as killed on shutdown: ${getErrorMessage(err)}`);
     })));
-    yield* exports_Effect.promise(() => new Promise((resolve4) => {
-      const t = setTimeout(resolve4, 3000);
+    yield* exports_Effect.promise(() => new Promise((resolve5) => {
+      const t = setTimeout(resolve5, 3000);
       t.unref?.();
     }));
     for (const [, tracked] of trackedEntries) {
@@ -98336,8 +98438,8 @@ var init_command_runner = __esm(() => {
     clearTrackedPids();
     yield* exports_Effect.promise(() => Promise.race([
       statusUpdates,
-      new Promise((resolve4) => {
-        const t = setTimeout(resolve4, 2000);
+      new Promise((resolve5) => {
+        const t = setTimeout(resolve5, 2000);
         t.unref?.();
       })
     ]));
@@ -98474,10 +98576,10 @@ function resolveWhichCommand(name) {
   return process.platform === "win32" ? `where ${name}` : `which ${name}`;
 }
 function isCliAvailable(cliName) {
-  return new Promise((resolve4) => {
+  return new Promise((resolve5) => {
     const child = spawn5(resolveWhichCommand(cliName), [], DETACHED_SHELL_SPAWN_OPTIONS);
-    child.on("error", () => resolve4(false));
-    child.on("close", (code2) => resolve4(code2 === 0));
+    child.on("error", () => resolve5(false));
+    child.on("close", (code2) => resolve5(code2 === 0));
     child.unref();
   });
 }
@@ -98762,7 +98864,7 @@ async function waitForLockOrTimeout(deadline, intervalMs, sleep6) {
 async function acquireLockWithRetry(options) {
   const intervalMs = options?.intervalMs ?? LOCK_RETRY_INTERVAL_MS;
   const maxWaitMs = options?.maxWaitMs ?? LOCK_RETRY_MAX_WAIT_MS;
-  const sleep6 = options?.sleep ?? ((ms) => new Promise((resolve4) => setTimeout(resolve4, ms)));
+  const sleep6 = options?.sleep ?? ((ms) => new Promise((resolve5) => setTimeout(resolve5, ms)));
   const deadline = Date.now() + maxWaitMs;
   if (await waitForLockOrTimeout(deadline, intervalMs, sleep6)) {
     return true;
@@ -99468,14 +99570,14 @@ var init_sse_event_buffer = __esm(() => {
     }
     _wake() {
       if (this._waiter) {
-        const resolve4 = this._waiter;
+        const resolve5 = this._waiter;
         this._waiter = null;
-        resolve4();
+        resolve5();
       }
     }
     _waitForData() {
-      return new Promise((resolve4) => {
-        this._waiter = resolve4;
+      return new Promise((resolve5) => {
+        this._waiter = resolve5;
       });
     }
     [Symbol.asyncIterator]() {
@@ -99530,8 +99632,8 @@ class OpencodeSdkSession {
   async prompt(input) {
     if (this.closed)
       throw new Error("Session is closed");
-    const idlePromise = new Promise((resolve4) => {
-      this._idleResolve = resolve4;
+    const idlePromise = new Promise((resolve5) => {
+      this._idleResolve = resolve5;
     });
     const IDLE_TIMEOUT_MS = 300000;
     const timeoutPromise = new Promise((_, reject) => {
@@ -99862,14 +99964,14 @@ class OpencodeSdkHarness {
     }
     this.sessionListeners.clear();
     this.childProcess.kill("SIGTERM");
-    await new Promise((resolve4) => {
+    await new Promise((resolve5) => {
       const timeout3 = setTimeout(() => {
         this.childProcess.kill("SIGKILL");
-        resolve4();
+        resolve5();
       }, 5000);
       this.childProcess.once("exit", () => {
         clearTimeout(timeout3);
-        resolve4();
+        resolve5();
       });
     });
   }
@@ -101303,10 +101405,10 @@ class BufferedJournalFactory {
     const waitForInProgress = () => {
       if (!flushInProgress)
         return Promise.resolve();
-      return new Promise((resolve4) => {
+      return new Promise((resolve5) => {
         const check4 = () => {
           if (!flushInProgress)
-            resolve4();
+            resolve5();
           else
             setTimeout(check4, 10);
         };
@@ -101866,11 +101968,11 @@ async function waitForEnhancerJobResolution(params) {
     outcome = "failed";
     onFailure("Agent process exited without completing enhancer job", false);
   });
-  await new Promise((resolve4) => {
+  await new Promise((resolve5) => {
     const check4 = setInterval(() => {
       if (outcome) {
         clearInterval(check4);
-        resolve4();
+        resolve5();
       }
     }, 100);
   });
@@ -102148,7 +102250,7 @@ var init_assert_registered_working_dir = __esm(() => {
 
 // src/infrastructure/services/workspace/workspace-path-security.ts
 import { realpath as realpath2 } from "node:fs/promises";
-import { basename, dirname as dirname8, isAbsolute, relative, resolve as resolve4, sep } from "node:path";
+import { basename, dirname as dirname8, isAbsolute, relative, resolve as resolve5, sep } from "node:path";
 import { gunzipSync as gunzipSync2 } from "node:zlib";
 function validateRelativePathSegments(filePath) {
   if (filePath.includes("\x00"))
@@ -102175,11 +102277,11 @@ async function resolvePathWithinWorkspace(workingDir, filePath) {
     return basic;
   let workspaceRoot;
   try {
-    workspaceRoot = await realpath2(resolve4(workingDir));
+    workspaceRoot = await realpath2(resolve5(workingDir));
   } catch {
     return { ok: false, error: "Working directory not found" };
   }
-  const candidate = resolve4(workspaceRoot, filePath);
+  const candidate = resolve5(workspaceRoot, filePath);
   if (!isPathInsideRoot(workspaceRoot, candidate)) {
     return { ok: false, error: "Path escapes workspace" };
   }
@@ -102201,7 +102303,7 @@ async function resolvePathWithinWorkspace(workingDir, filePath) {
         if (!isPathInsideRoot(workspaceRoot, parentReal)) {
           return { ok: false, error: "Path escapes workspace" };
         }
-        const resolved = resolve4(parentReal, basename(candidate));
+        const resolved = resolve5(parentReal, basename(candidate));
         if (!isPathInsideRoot(workspaceRoot, resolved)) {
           return { ok: false, error: "Path escapes workspace" };
         }
@@ -104125,7 +104227,7 @@ class NodeFsHandler {
         this._addToNodeFs(path6, initialAdd, wh, depth + 1);
       }
     }).on(EV.ERROR, this._boundHandleError);
-    return new Promise((resolve6, reject) => {
+    return new Promise((resolve7, reject) => {
       if (!stream4)
         return reject();
       stream4.once(STR_END, () => {
@@ -104134,7 +104236,7 @@ class NodeFsHandler {
           return;
         }
         const wasThrottled = throttler ? throttler.clear() : false;
-        resolve6(undefined);
+        resolve7(undefined);
         previous.getChildren().filter((item) => {
           return item !== directory && !current.has(item);
         }).forEach((item) => {
@@ -105352,8 +105454,8 @@ function createWorkspaceFsWatcher(options) {
     awaitWriteFinish: { stabilityThreshold: 150, pollInterval: 25 }
   });
   watcher.on("add", (filePath) => enqueue("add", filePath)).on("addDir", (filePath) => enqueue("addDir", filePath)).on("change", (filePath) => enqueue("change", filePath)).on("unlink", (filePath) => enqueue("unlink", filePath)).on("unlinkDir", (filePath) => enqueue("unlinkDir", filePath)).on("error", (error51) => options.onError?.(error51));
-  const ready = new Promise((resolve7) => {
-    watcher.once("ready", resolve7);
+  const ready = new Promise((resolve8) => {
+    watcher.once("ready", resolve8);
   });
   return {
     ready,
@@ -105978,7 +106080,7 @@ function unsupportedFileWriteOperationMessage(operation) {
 }
 
 // src/commands/machine/daemon-start/file-write-fulfillment.ts
-import { access as access4, mkdir as mkdir10, rename as rename4, rm as rm3, writeFile as writeFile9 } from "node:fs/promises";
+import { access as access4, mkdir as mkdir10, rename as rename4, rm as rm4, writeFile as writeFile9 } from "node:fs/promises";
 import { dirname as dirname11 } from "node:path";
 function isTerminalFileWriteError(errorMessage) {
   const terminalMessages = new Set([
@@ -106132,7 +106234,7 @@ async function fulfillOneFileWriteRequest(session2, request2) {
         });
         return;
       }
-      await rm3(resolved.absolutePath, { recursive: true, force: false });
+      await rm4(resolved.absolutePath, { recursive: true, force: false });
       await completeWriteRequest(session2, request2._id, { status: "done" });
       const elapsed4 = Date.now() - startTime;
       console.log(`[${formatTimestamp()}] ✏️  File delete fulfilled: ${filePath} (${elapsed4}ms)`);
@@ -109544,7 +109646,7 @@ function createDefaultDeps19() {
     },
     clock: {
       now: () => Date.now(),
-      delay: (ms) => new Promise((resolve7) => setTimeout(resolve7, ms))
+      delay: (ms) => new Promise((resolve8) => setTimeout(resolve8, ms))
     },
     spawning: new HarnessSpawningService({ rateLimiter: new SpawnRateLimiter }),
     agentProcessManager: null
@@ -110909,7 +111011,7 @@ var init_jsonc = __esm(() => {
 
 // src/infrastructure/services/workspace/workspace-resolver.ts
 import { readFile as readFile10, readdir as readdir3, stat as stat6 } from "node:fs/promises";
-import { join as join22, basename as basename4, resolve as resolve7 } from "node:path";
+import { join as join22, basename as basename4, resolve as resolve8 } from "node:path";
 async function resolveGlobPatternStar(rootDir, cleaned) {
   const parentDir = join22(rootDir, cleaned.slice(0, -2));
   try {
@@ -110919,7 +111021,7 @@ async function resolveGlobPatternStar(rootDir, cleaned) {
       if (!entry.isDirectory())
         continue;
       const dirPath = join22(parentDir, entry.name);
-      if (resolve7(dirPath).startsWith(resolve7(rootDir))) {
+      if (resolve8(dirPath).startsWith(resolve8(rootDir))) {
         dirs.push(dirPath);
       }
     }
@@ -110931,7 +111033,7 @@ async function resolveGlobPatternStar(rootDir, cleaned) {
 async function resolveLiteralPath(rootDir, cleaned) {
   const dir = join22(rootDir, cleaned);
   try {
-    if (!resolve7(dir).startsWith(resolve7(rootDir)))
+    if (!resolve8(dir).startsWith(resolve8(rootDir)))
       return [];
     const s = await stat6(dir);
     if (s.isDirectory())
@@ -111808,7 +111910,7 @@ var init_layers = __esm(() => {
   IntervalClock = class IntervalClock extends exports_Context.Tag("IntervalClock")() {
   };
   IntervalClockLive = exports_Layer.succeed(IntervalClock, {
-    sleep: (ms) => exports_Effect.promise(() => new Promise((resolve8) => setTimeout(resolve8, ms)))
+    sleep: (ms) => exports_Effect.promise(() => new Promise((resolve9) => setTimeout(resolve9, ms)))
   });
 });
 
@@ -112910,8 +113012,8 @@ var init_command_loop = __esm(() => {
     const withTimeout2 = async (p, ms) => {
       await Promise.race([
         Promise.resolve(p).catch(() => {}),
-        new Promise((resolve8) => {
-          const t = setTimeout(resolve8, ms);
+        new Promise((resolve9) => {
+          const t = setTimeout(resolve9, ms);
           t.unref?.();
         })
       ]);
@@ -113076,7 +113178,7 @@ async function daemonStop() {
   console.log(`Stopping daemon (PID: ${pid})...`);
   try {
     process.kill(pid, "SIGTERM");
-    await new Promise((resolve8) => setTimeout(resolve8, 8000));
+    await new Promise((resolve9) => setTimeout(resolve9, 8000));
     try {
       process.kill(pid, 0);
       console.log(`Process did not exit gracefully, forcing...`);
@@ -113645,7 +113747,7 @@ async function withRetry(fn2, opts) {
         return;
       }
       const delay3 = Math.min(baseDelayMs * 2 ** attempt, maxDelayMs);
-      await new Promise((resolve8) => setTimeout(resolve8, delay3));
+      await new Promise((resolve9) => setTimeout(resolve9, delay3));
     }
   }
   return;
@@ -114032,6 +114134,28 @@ messagesCommand.command("list").description("List messages by sender role or sin
     });
   }
 });
+messagesCommand.command("download").description("Download chatroom message history to local files for reading/grep").requiredOption("--chatroom-id <id>", "Chatroom identifier").requiredOption("--role <role>", "Your role").option("--format <format>", "Download format (default: linear)", "linear").option("--output-dir <path>", "Output directory (default: .chatroom/downloads/messages/linear/<download-id>)").option("--limit <n>", "Max messages to download (default: 10, max: 5000)").action(async (options) => {
+  await maybeRequireAuth();
+  if (options.format && options.format !== "linear") {
+    console.error("❌ Unsupported format. Only --format=linear is supported.");
+    process.exit(1);
+  }
+  let parsedLimit;
+  if (options.limit) {
+    parsedLimit = parseInt(options.limit, 10);
+    if (isNaN(parsedLimit) || parsedLimit < 1) {
+      console.error("❌ --limit must be a positive integer (1-5000)");
+      process.exit(1);
+    }
+  }
+  const { downloadMessages: downloadMessages2 } = await Promise.resolve().then(() => (init_download(), exports_download));
+  await downloadMessages2(options.chatroomId, {
+    role: options.role,
+    format: "linear",
+    outputDir: options.outputDir,
+    limit: parsedLimit
+  });
+});
 var contextCommand = program2.command("context").description("Manage chatroom context and state (explicit context management)");
 contextCommand.command("read").description("Read context for your role (conversation history, tasks, status)").requiredOption("--chatroom-id <id>", "Chatroom identifier").requiredOption("--role <role>", "Your role").action(async (options) => {
   await maybeRequireAuth();
@@ -114177,4 +114301,4 @@ program2.hook("preAction", async (_thisCommand, actionCommand) => {
 });
 program2.parse();
 
-//# debugId=DFC337C81483539964756E2164756E21
+//# debugId=7AA8EA8DC834B0AF64756E2164756E21