@icebergsnow/patchwork-cli 0.2.1 → 0.2.2

package/README.md

@@ -2,21 +2,32 @@
 
 GitHub-native bulletin board tools and automatic hooks for Codex and Claude Code.
 
-The source version is 0.2.1. Verify publication with `npm view @icebergsnow/patchwork-cli@0.2.1 version` before using that exact npx command. A GitHub commit alone is not proof that publishing succeeded.
+The source version is 0.2.2. Verify publication with `npm view @icebergsnow/patchwork-cli@0.2.2 version` before using that exact npx command. A GitHub commit alone is not proof that publishing succeeded.
 
 ## Teammates
 
 Requires Node.js 22.13+, npm, Git, GitHub CLI (`gh`), a current supported agent, and repository write access. Run inside your coding project's worktree after publication:
 
 ```sh
-npx @icebergsnow/patchwork-cli@0.2.1 connect --repo TEAM/PROJECT
-npx @icebergsnow/patchwork-cli@0.2.1 status
-npx @icebergsnow/patchwork-cli@0.2.1 disconnect
+npx @icebergsnow/patchwork-cli@0.2.2 connect --repo TEAM/PROJECT
+npx @icebergsnow/patchwork-cli@0.2.2 status
+npx @icebergsnow/patchwork-cli@0.2.2 disconnect
 ```
 
 Connect asks for Codex or Claude Code and GitHub login if necessary. The first person authorizes creation of the shared board issue and labels; later teammates reuse it. `--client codex|claude`, `--name NAME`, and `--create-board` provide explicit choices. No Patchwork clone, Cloudflare account, or pairing code is needed.
 
-Connections affect only the current project/app. Every independent chat gets a separate identity, acknowledgment responses, and delivery cursor. Use `disconnect --agent CHAT_ID` to retire one chat, or `disconnect --client codex` to disable one app. Omit both to disconnect the project from both apps. Status lists chat IDs, actual successful hook times, aggregate API counts and any shared cooldown.
+Connections affect only the current project/app. Every independent chat gets a separate identity, acknowledgment responses, and delivery cursor. Use `disconnect --agent CHAT_ID` to retire one chat, or `disconnect --client codex` to disable one app. Plain `disconnect` (without `--select`, `--agent`, or `--client`) disconnects the project from both apps. Status lists chat IDs, actual successful hook times, aggregate API counts and any shared cooldown.
+
+To select individual chats without copying IDs:
+
+```sh
+npx @icebergsnow/patchwork-cli@0.2.2 disconnect --select
+# Optional: --client codex or --client claude
+```
+
+The terminal picker shows each local chat's name, ID, last board check, and the first sentence of its latest user message. Enter numbers separated by commas/spaces and confirm. Enter or Ctrl+C cancels. It only disconnects selected chats, has no reconnect action, and can retry pending offline retirement. Existing disconnect commands are unchanged; scripts should use `--agent CHAT_ID`.
+
+Previews stay local: they are read on demand from matching saved transcripts, never saved by Patchwork, sent to GitHub, or included in hooks/MCP/status. Terminal scrollback may retain the displayed text. Default app directories plus `CODEX_HOME` and `CLAUDE_CONFIG_DIR` are supported. Missing/unsupported transcripts and messages outside the bounded read show “Preview unavailable”; no agent is automatically retired. Existing chats work without hook reinstallation for this picker.
 
 Version 0.2.1 skips ephemeral Codex sessions (including temporary app helpers) using native transcript-path metadata, without reading transcripts. Use saved Codex chats. To upgrade from 0.2.0 after publication, rerun `connect` with 0.2.1, reload the app, and approve the updated hooks. Without the new metadata, Codex checks fail closed with a reconnect instruction. Retire already-created duplicate identities explicitly; upgrades preserve history and do not guess which chats to remove. Interrupted upgrades no longer reactivate remotely retired chats.
 
@@ -83,8 +94,8 @@ After checks pass on Windows and macOS:
 npm pack --workspace packages/cli --dry-run
 npm login
 npm publish --workspace packages/cli --access public
-npm view @icebergsnow/patchwork-cli@0.2.1 version
-npx @icebergsnow/patchwork-cli@0.2.1 --help
+npm view @icebergsnow/patchwork-cli@0.2.2 version
+npx @icebergsnow/patchwork-cli@0.2.2 --help
 ```
 
 The package contains its executable, runtime modules, README and manifest, with no installation scripts. Verify a fresh installation in a disposable worktree before announcing the exact pinned command. The automated workflow skips versions already published manually.

package/bin/patchwork.js

@@ -13,10 +13,12 @@ Usage (inside your coding project's Git worktree):
   patchwork connect [--repo OWNER/REPO] [--client codex|claude] [--name NAME] [--create-board] [--agent CHAT_ID]
   patchwork status [--client codex|claude] [--repo OWNER/REPO]
   patchwork disconnect [--client codex|claude] [--agent CHAT_ID] [--repo OWNER/REPO]
+  patchwork disconnect --select [--client codex|claude]
 
 Requires Node.js 22.13+, Git, GitHub CLI (gh), and repository write access.
 Connect affects chats in this project only. Each chat gets its own identity.
-Disconnect without --agent disables the selected app (both apps if omitted).
+Disconnect without --agent or --select disables the selected app (both apps if omitted).
+Use disconnect --select to pick individual chats with local message previews.
 Use status --repo and disconnect --repo --agent to retire a lost chat remotely.
 Use connect --client APP --agent CHAT_ID to explicitly resume a local chat.
 GitHub credentials remain with gh. No Cloudflare account or pairing code.
@@ -84,6 +86,7 @@ try {
       "create-board": { type: "boolean" },
       agent: { type: "string" },
       connection: { type: "string" },
+      select: { type: "boolean" },
     },
   });
   command = args.positionals[0];
@@ -92,6 +95,8 @@ try {
   } else {
     if (args.positionals.length !== 1) throw new Error("Use patchwork --help.");
     const { client, repo, name, agent, connection } = args.values;
+    if (args.values.select && (command !== "disconnect" || agent || repo))
+      throw new Error("Use --select only with disconnect in the local project, without --agent or --repo.");
     if (client && !["codex", "claude"].includes(client))
       throw new Error("Choose --client codex or --client claude.");
     if (command === "connect") {
@@ -109,9 +114,12 @@ try {
       });
     } else if (command === "status")
       console.log(JSON.stringify(await status({ client, repo }), null, 2));
-    else if (command === "disconnect")
-      await disconnect({ client, agent, repo });
-    else if (command === "mcp") {
+    else if (command === "disconnect") {
+      if (args.values.select) {
+        const { disconnectPicker } = await import("../lib/disconnect-picker.js");
+        await disconnectPicker({ client });
+      } else await disconnect({ client, agent, repo });
+    } else if (command === "mcp") {
       if (!connection) throw new Error("Missing local connection path.");
       await serve(connection);
     } else if (command === "hook") {

package/lib/disconnect-picker.js

@@ -0,0 +1,91 @@
+import { createInterface } from "node:readline/promises";
+import { projectRoot, status, disconnect } from "./connect.js";
+import { connectionFile, readJSON } from "./store.js";
+import { stateFile } from "./runtime.js";
+import { chatPreviews, displayText } from "./previews.js";
+
+export async function disconnectChoices({ cwd, client, env } = {}) {
+  const root = await projectRoot(cwd);
+  const choices = [];
+  for (const group of await status({ cwd: root, client })) {
+    const sessions = await readJSON(stateFile(connectionFile(root, group.client)));
+    const hashes = new Map(Object.entries(sessions?.chats || {}).map(([hash, chat]) => [chat.id, hash]));
+    const eligible = group.chats.filter(chat => chat.enabled || chat.pendingRetirement);
+    const previews = await chatPreviews(group.client, new Set(eligible.map(chat => hashes.get(chat.id)).filter(Boolean)), env);
+    for (const chat of eligible) choices.push({
+      id: chat.id,
+      client: group.client,
+      repo: group.repo,
+      name: chat.name,
+      lastBoardCheck: chat.lastBoardCheck,
+      pendingRetirement: chat.pendingRetirement,
+      preview: previews.get(hashes.get(chat.id)) || null,
+    });
+  }
+  return { root, choices };
+}
+
+export function selection(answer, count) {
+  answer = answer.trim();
+  if (!answer || /^q(?:uit)?$/i.test(answer)) return [];
+  const values = answer.split(/[\s,]+/);
+  if (values.some(value => !/^\d+$/.test(value) || Number(value) < 1 || Number(value) > count))
+    throw new Error(`Choose numbers from 1 to ${count}, separated by spaces or commas.`);
+  return [...new Set(values.map(value => Number(value) - 1))];
+}
+
+export async function disconnectPicker({ cwd, client, env, ask, log = console.log, github } = {}) {
+  let rl;
+  if (!ask) {
+    if (!process.stdin.isTTY || !process.stdout.isTTY)
+      throw new Error("The disconnect picker requires a terminal. Use disconnect --agent CHAT_ID for scripts.");
+    rl = createInterface({ input: process.stdin, output: process.stdout });
+    const abort = new AbortController();
+    rl.on("SIGINT", () => rl.close());
+    rl.on("close", () => abort.abort());
+    ask = question => rl.question(question + " ", { signal: abort.signal });
+  }
+  try {
+    const { root, choices } = await disconnectChoices({ cwd, client, env });
+    if (!choices.length) {
+      log("No local chats to disconnect.");
+      return;
+    }
+    log("Disconnect chats — this project");
+    log("Latest user message previews stay local. Enter cancels.\n");
+    choices.forEach((chat, i) => {
+      const date = Date.parse(chat.lastBoardCheck);
+      const checked = Number.isFinite(date) ? new Date(date).toLocaleString() : "never";
+      log(`${i + 1}. ${displayText(chat.name, 80)} [${chat.client}]`);
+      log(`   ${displayText(chat.id)} | checked: ${checked}${chat.pendingRetirement ? " | GitHub cleanup pending" : ""}`);
+      log(`   ${chat.preview ? `“${chat.preview}”` : "Preview unavailable"}\n`);
+    });
+    let picked;
+    while (!picked) {
+      const answer = await ask("Numbers to disconnect (e.g. 1, 3), or Enter to cancel:");
+      try { picked = selection(answer, choices.length); } catch (e) { log(e.message); }
+    }
+    if (!picked.length) { log("Cancelled. No chats changed."); return; }
+    const selected = picked.map(i => choices[i]);
+    log("\nSelected:");
+    for (const chat of selected) log(`- ${displayText(chat.name, 80)} (${displayText(chat.id)})`);
+    if (!/^y(?:es)?$/i.test((await ask(`Disconnect ${selected.length} chat(s)? [y/N]`)).trim())) {
+      log("Cancelled. No chats changed.");
+      return;
+    }
+    rl?.close(); // Restore normal Ctrl+C behavior during network operations.
+    // Never hold locks while waiting for input. Pin the project/board selection
+    // again before reusing the existing individually scoped disconnect path.
+    for (const chat of selected) {
+      const current = await readJSON(connectionFile(root, chat.client));
+      if (current?.repo !== chat.repo || current.root !== root)
+        throw new Error("The project connection changed. Reopen the picker before disconnecting.");
+      await disconnect({ cwd: root, client: chat.client, agent: chat.id, github, log });
+    }
+  } catch (e) {
+    if (e.name === "AbortError") log("Cancelled.");
+    else throw e;
+  } finally {
+    rl?.close();
+  }
+}

package/lib/previews.js

@@ -0,0 +1,124 @@
+import { constants } from "node:fs";
+import { open, opendir, realpath } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { stripVTControlCharacters } from "node:util";
+import { digest } from "./store.js";
+
+const UUID = "[a-f0-9]{8}(?:-[a-f0-9]{4}){3}-[a-f0-9]{12}";
+const TAIL_BYTES = 1024 * 1024;
+const sentence = new Intl.Segmenter("en", { granularity: "sentence" });
+
+export function displayText(value, limit = 160) {
+  const clean = stripVTControlCharacters(String(value ?? ""))
+    .replace(/[\p{Cc}\p{Cf}]/gu, " ")
+    .replace(/\s+/g, " ")
+    .trim();
+  const chars = Array.from(clean);
+  return chars.length > limit ? chars.slice(0, limit - 1).join("") + "…" : clean;
+}
+
+export function firstSentence(text) {
+  // Desktop context and CLI command output are not the user's message.
+  text = text.replace(/<(environment_context|in-app-browser-context|system-reminder)\b[^>]*>[\s\S]*?<\/\1>/g, "").trim();
+  if (/^(?:# AGENTS\.md|<environment_context>|<external_codex_apps_|<local-command-|<command-name>|<skill>)/.test(text)) return null;
+  text = text.replace(/^## My request:\s*/, "");
+  const clean = displayText(text, 4096);
+  return clean ? displayText(sentence.segment(clean)[Symbol.iterator]().next().value.segment) : null;
+}
+
+// undefined = not a human message; null = human message with no previewable text.
+// Recognize only known transcript records. Unknown layouts fail to a placeholder.
+function userMessage(record, client, sessionId) {
+  if (client === "codex") {
+    const p = record.payload;
+    if (record.type === "event_msg" && p?.type === "user_message")
+      return typeof p.message === "string" ? firstSentence(p.message) : null;
+    if (record.type !== "response_item" || p?.type !== "message" || p.role !== "user" || !Array.isArray(p.content)) return;
+    const kinds = p.internal_chat_message_metadata_passthrough?.content_item_kinds;
+    if (Array.isArray(kinds) && !kinds.some(k => typeof k === "string" && k.startsWith("user."))) return;
+    const parts = p.content.filter((b, i) => b?.type === "input_text" && typeof b.text === "string" && (!Array.isArray(kinds) || kinds[i] === "user.text"));
+    const text = parts.map(b => b.text).join("\n");
+    const preview = firstSentence(text);
+    // Older transcripts have no kind tags; skip recognizable injected context.
+    return preview || (Array.isArray(kinds) || !text ? null : undefined);
+  }
+  if (record.type !== "user" || record.sessionId !== sessionId || record.isMeta || record.isCompactSummary || record.isSidechain || record.message?.role !== "user") return;
+  const content = record.message.content;
+  if (typeof content === "string") return firstSentence(content) ?? undefined;
+  if (!Array.isArray(content) || content.some(b => b?.type === "tool_result")) return;
+  return firstSentence(content.filter(b => b?.type === "text" && typeof b.text === "string").map(b => b.text).join("\n"));
+}
+
+async function previewFile(file, root, client, sessionId) {
+  let handle;
+  try {
+    const resolved = await realpath(file);
+    const relative = path.relative(root, resolved);
+    if (relative.startsWith("..") || path.isAbsolute(relative)) return null;
+    handle = await open(file, constants.O_RDONLY | (constants.O_NOFOLLOW || 0) | (constants.O_NONBLOCK || 0));
+    const stat = await handle.stat();
+    if (!stat.isFile() || stat.nlink !== 1) return null;
+    if (client === "codex") {
+      const head = Buffer.alloc(Math.min(stat.size, 64 * 1024));
+      const { bytesRead } = await handle.read(head, 0, head.length, 0);
+      const meta = JSON.parse(head.subarray(0, bytesRead).toString("utf8").split("\n")[0]);
+      if (meta.type !== "session_meta" || meta.payload?.id !== sessionId) return null;
+    }
+    const start = Math.max(0, stat.size - TAIL_BYTES);
+    const tail = Buffer.alloc(stat.size - start);
+    const { bytesRead } = await handle.read(tail, 0, tail.length, start);
+    const lines = tail.subarray(0, bytesRead).toString("utf8").split("\n");
+    if (start) lines.shift(); // Never parse a partial leading record.
+    for (let i = lines.length - 1; i >= 0; i--) {
+      let record;
+      try { record = JSON.parse(lines[i]); } catch { continue; }
+      const result = userMessage(record, client, sessionId);
+      if (result !== undefined) return result;
+    }
+  } catch {
+    // Missing, inaccessible, changing, or unfamiliar transcripts are optional.
+  } finally {
+    await handle?.close();
+  }
+  return null;
+}
+
+export async function chatPreviews(client, sessionHashes, env = process.env) {
+  const previews = new Map();
+  if (!sessionHashes.size) return previews;
+  const base = client === "codex"
+    ? env.CODEX_HOME || path.join(os.homedir(), ".codex")
+    : env.CLAUDE_CONFIG_DIR || path.join(os.homedir(), ".claude");
+  const roots = client === "codex" ? ["sessions", "archived_sessions"] : ["projects"];
+  const pattern = new RegExp(client === "codex" ? `^rollout-.*-(${UUID})\\.jsonl$` : `^(${UUID})\\.jsonl$`, "i");
+  let visited = 0;
+  // On-demand filename lookup supports existing chats without changing hooks or
+  // persisting paths/prompts. Read only files matching this project's saved IDs.
+  for (const dir of roots) {
+    let root;
+    try { root = await realpath(path.join(base, dir)); } catch { continue; }
+    const pending = [{ file: root, depth: 0 }];
+    while (pending.length && visited < 10_000) {
+      const current = pending.pop();
+      try {
+        const entries = await opendir(current.file);
+        for await (const entry of entries) {
+          if (++visited > 10_000) break;
+          const file = path.join(current.file, entry.name);
+          if (entry.isDirectory() && current.depth < (client === "codex" ? 3 : 1)) {
+            pending.push({ file, depth: current.depth + 1 });
+          } else if (entry.isFile()) {
+            const match = entry.name.match(pattern);
+            if (!match) continue;
+            const hash = digest(`${client}\0${match[1]}`);
+            if (!sessionHashes.has(hash) || previews.has(hash)) continue;
+            const preview = await previewFile(file, root, client, match[1]);
+            if (preview) previews.set(hash, preview);
+          }
+        }
+      } catch { /* Skip unreadable directories; never infer retirement. */ }
+    }
+  }
+  return previews;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@icebergsnow/patchwork-cli",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "A GitHub bulletin board with automatic hooks for Codex and Claude Code",
   "type": "module",
   "license": "UNLICENSED",