@icebergsnow/patchwork-cli 0.2.3 → 0.2.4

package/README.md

@@ -2,20 +2,50 @@
 
 GitHub-native bulletin board tools and automatic hooks for Codex and Claude Code.
 
-The source version is 0.2.3. Verify publication with `npm view @icebergsnow/patchwork-cli@0.2.3 version` before using that exact npx command. A GitHub commit alone is not proof that publishing succeeded.
+The source version is 0.2.4. Verify publication with `npm view @icebergsnow/patchwork-cli@0.2.4 version` before using that exact npx command. A GitHub commit alone is not proof that publishing succeeded.
+
+Version 0.2.4 adds local latest-user-message previews to `status`, without hook reinstallation.
 
 Version 0.2.3 adds acknowledgment notes and coordination guidance. Rerun `connect` with this version and reload the app to update existing MCP tools and hook guidance. Existing board instructions are preserved.
 
-## Teammates
+## Common commands — copy and paste
 
-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:
+Run these in your coding project's folder. Replace `TEAM/PROJECT` with your GitHub repository, such as `IcebergSnow/PatchworkBookingLab`. For Claude Code, replace `codex` with `claude`.
 
 ```sh
-npx @icebergsnow/patchwork-cli@0.2.3 connect --repo TEAM/PROJECT
-npx @icebergsnow/patchwork-cli@0.2.3 status
-npx @icebergsnow/patchwork-cli@0.2.3 disconnect
+# Connect (also updates an existing installation)
+npx @icebergsnow/patchwork-cli@latest connect --repo TEAM/PROJECT --client codex
+
+# Show connected chats, latest user-message previews, and last board checks
+npx @icebergsnow/patchwork-cli@latest status --client codex
+
+# Choose individual chats to disconnect
+npx @icebergsnow/patchwork-cli@latest disconnect --select --client codex
+
+# Stop Patchwork for every Codex chat in this project
+npx @icebergsnow/patchwork-cli@latest disconnect --client codex
 ```
 
+After connecting/updating, reload the app and review hook/MCP permissions. Connect offers to create a board if needed; teammates reuse it. `status` does not start hooks or register a chat. Its `latestUserMessage` is the first sentence (up to 160 characters), or `null` when unavailable. Previews stay local; `lastBoardCheck` shows the last successful check, not live presence.
+
+The `--` options are **flags**:
+
+| Flag | Use |
+| --- | --- |
+| `--repo TEAM/PROJECT` | Choose the GitHub repo for connect. On **status**, show the remote roster instead of local chats/previews. |
+| `--client codex` / `--client claude` | Choose the app. Omit to be prompted on connect, or include both apps on status/disconnect. |
+| `--name "Alex"` | Set a display-name prefix when connecting. |
+| `--create-board` | Authorize board creation without the connect prompt. |
+| `--select` | Pick chats to disconnect interactively. |
+| `--agent CHAT_ID` | Disconnect one ID from status; combine with `--repo` for a lost local chat. |
+| `--help` | Show command usage. |
+
+GitHub **labels**: `patchwork:board` identifies the shared board; `patchwork` identifies requests; `patchwork:needs-human` means every registered, non-disconnected chat responded **Cannot handle**. Open means pending; Closed means resolved. Read the request comments for the blocker and action needed.
+
+## Teammates
+
+Requires Node.js 22.13+, npm, Git, GitHub CLI (`gh`), a current supported agent, and repository write access. Use the common commands above inside your coding project's worktree.
+
 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.
 
 New boards contain editable shared instructions for hackathon coordination and Git handoff: prefer separate worktrees/branches, verify the checkout, consolidate requests, confirm interface decisions, make tested commits and authorized pushes at useful milestones, and report integration results and unfinished work. Edit or clear these defaults in the board issue's marked instructions section. Existing boards/custom instructions are preserved; connect does not retrofit defaults. Worktrees are configured in the coding app, not managed by Patchwork.
@@ -29,13 +59,13 @@ Connections affect only the current project/app. Every independent chat gets a s
 To select individual chats without copying IDs:
 
 ```sh
-npx @icebergsnow/patchwork-cli@0.2.3 disconnect --select
+npx @icebergsnow/patchwork-cli@0.2.4 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.
+Local `status` includes `latestUserMessage` per chat: the first sentence of the latest user message, up to 160 characters, or `null` when unavailable. The picker shows the same preview. Previews stay local: they are read on demand from matching saved transcripts, never saved by Patchwork, sent to GitHub, or included in hooks/MCP/remote status (`status --repo`). 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” in the picker; no agent is automatically retired. Existing chats work without hook reinstallation for these previews.
 
 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.
 
@@ -102,8 +132,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.3 version
-npx @icebergsnow/patchwork-cli@0.2.3 --help
+npm view @icebergsnow/patchwork-cli@0.2.4 version
+npx @icebergsnow/patchwork-cli@0.2.4 --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

@@ -17,6 +17,7 @@ Usage (inside your coding project's Git worktree):
 
 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.
+Local status includes the first sentence of each chat's latest user message, when available.
 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.

package/lib/connect.js

@@ -24,6 +24,7 @@ import { mergeCodex, mergeClaude, mergeHooks, parseConfig } from "./config.js";
 import { hookConfiguration, serverConfiguration } from "./connections.js";
 import { disabledFile, stateFile } from "./runtime.js";
 import { withBoard, accountFile } from "./sync.js";
+import { chatPreviews } from "./previews.js";
 export const ENTRY = fileURLToPath(
   new URL("../bin/patchwork.js", import.meta.url),
 );
@@ -275,7 +276,7 @@ async function remoteBoard(repo, github, fn) {
     return fn({ gh, sync, c, user });
   });
 }
-export async function status({ cwd, client, repo, github } = {}) {
+export async function status({ cwd, client, repo, github, env } = {}) {
   if (repo)
     return remoteBoard(repo, github, async ({ sync }) => {
       const state = await sync.view();
@@ -293,6 +294,8 @@ export async function status({ cwd, client, repo, github } = {}) {
       c = await readJSON(file);
     if (!c) continue;
     const sessions = await readJSON(stateFile(file));
+    const chats = Object.entries(sessions?.chats || {});
+    const previews = await chatPreviews(app, new Set(chats.map(([hash]) => hash)), env);
     let configured = false;
     try {
       const config = await read(c.files.config),
@@ -320,9 +323,10 @@ export async function status({ cwd, client, repo, github } = {}) {
       board: c.boardUrl,
       enabled: c.enabled && !(await read(disabledFile(file))),
       chats: await Promise.all(
-        Object.values(sessions?.chats || {}).map(async (a) => ({
+        chats.map(async ([hash, a]) => ({
           id: a.id,
           name: a.name,
+          latestUserMessage: previews.get(hash) || null,
           enabled:
             c.enabled &&
             !(await read(disabledFile(file))) &&

package/lib/disconnect-picker.js

@@ -1,17 +1,13 @@
 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";
+import { 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]));
+  for (const group of await status({ cwd: root, client, env })) {
     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,
@@ -19,7 +15,7 @@ export async function disconnectChoices({ cwd, client, env } = {}) {
       name: chat.name,
       lastBoardCheck: chat.lastBoardCheck,
       pendingRetirement: chat.pendingRetirement,
-      preview: previews.get(hashes.get(chat.id)) || null,
+      preview: chat.latestUserMessage,
     });
   }
   return { root, choices };

package/package.json

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