@coderook/cli 0.41.2 → 0.42.0

package/.claude-plugin/plugin.json

@@ -2,7 +2,7 @@
   "name": "coderook",
   "displayName": "CodeRook",
   "description": "Save, browse and restore whole-snapshot versions of a project on CodeRook, with cbx or plain git, from Claude Code.",
-  "version": "0.41.2",
+  "version": "0.42.0",
   "author": {
     "name": "ACCA Gaming Productions",
     "url": "https://coderook.com"

package/dist/cli/src/cli.js

@@ -24,6 +24,7 @@ const node_fs_1 = require("node:fs");
 const node_path_1 = __importDefault(require("node:path"));
 const node_process_1 = __importDefault(require("node:process"));
 const workspace_command_js_1 = require("./workspace_command.js");
+const workspace_threads_js_1 = require("./workspace_threads.js");
 const api_js_1 = require("./api.js");
 const registry_js_1 = require("./registry.js");
 const help_js_1 = require("./help.js");
@@ -2755,9 +2756,9 @@ const SPECS = [
         name: "workspace",
         group: "Workspaces",
         summary: "edit, save and run a private project remotely without a checkout",
-        usage: "workspace <usage|open|list|show|read|files|search|diff|patch|save|run|logs|cancel|deploy|preview|handoff|close|recipe|assign|assignments|unassign|checkout> <project> [workspace] [job] | workspace push [folder]",
+        usage: "workspace | workspace <usage|open|list|show|read|files|search|diff|patch|save|run|logs|cancel|deploy|preview|handoff|close|recipe|assign|assignments|unassign|checkout|say|thread|mute|unmute> <project> [workspace] [job] | workspace push [folder]",
         brief: "workspace <action> <project>",
-        detail: "Works on CodeRook's durable remote draft, never the current local folder. Use --data-file for structured edits or recipe configuration. Mutations need the reviewed --revision and a unique --key; reuse the same key and request when retrying. Recipes reference existing project workflows. Usage reads the shared workspace credits and separate PR allowance without a draft ID. Saving and deploying are separate operations.",
+        detail: "Works on CodeRook's durable remote draft, never the current local folder. Use --data-file for structured edits or recipe configuration. Mutations need the reviewed --revision and a unique --key; reuse the same key and request when retrying. Recipes reference existing project workflows. Usage reads the shared workspace credits and separate PR allowance without a draft ID. Saving and deploying are separate operations. Run on its own at a terminal, it lists your open workspaces with their unread messages: choose one to see its changes and what is being discussed, and reply, save, run checks, hand it over or close it with one key. say and thread post to and read a workspace's discussion as JSON; a machine signed in to your account can name itself with --as (or CBX_NAME) so its messages and unread count are its own.",
         options: [
             { flags: "--data-file <path>", description: "read an operation's JSON from this local file" },
             { flags: "--name <name>", description: "name a new workspace" },
@@ -2778,8 +2779,12 @@ const SPECS = [
             { flags: "--days <number>", description: "assign: how long the handed-over token lasts (1-90, default 14)" },
             { flags: "--save", description: "push: save the draft after sending the changes" },
             { flags: "--dry-run", description: "push: list what would be sent, send nothing" },
+            { flags: "--as <name>", description: "say/thread/list/save: post and read as this machine name (or set CBX_NAME)" },
+            { flags: "--unread", description: "thread: only messages this reader has not read" },
+            { flags: "--peek", description: "thread: read without marking anything read" },
+            { flags: "--after <time>", description: "thread: continue from the next page's time" },
         ],
-        examples: ["cbx workspace open my-project --name \"Laptop work\" --key laptop-open-001", "cbx workspace list my-project", "cbx workspace assign my-project <draft> --name Laptop", "cbx workspace checkout my-project <draft>", "cbx workspace push --save -m \"Fix the export dialog\""],
+        examples: ["cbx workspace open my-project --name \"Laptop work\" --key laptop-open-001", "cbx workspace list my-project", "cbx workspace assign my-project <draft> --name Laptop", "cbx workspace checkout my-project <draft>", "cbx workspace push --save -m \"Fix the export dialog\"", "cbx workspace", "cbx workspace say my-project <draft> -m \"Tests updated\" --as GrokBot", "cbx workspace thread my-project <draft> --unread"],
         run: workspace_command_js_1.commandWorkspace,
     },
     {
@@ -3831,6 +3836,7 @@ const SPECS = [
                 description: "everything, versions, issues, releases, ignore",
             },
             { flags: "--email [off]", description: "include it in the daily email" },
+            { flags: "--discussions <all|off>", description: "whether workspace messages reach your notifications" },
         ],
         run: service_commands_js_1.commandWatch,
     },
@@ -4135,7 +4141,11 @@ async function main(argv) {
     if (spec.deprecatedBy) {
         console.error(dim(`"${name}" is now "${spec.deprecatedBy}". The old name still works.`));
     }
-    return spec.run(parse(rest, spec));
+    const parsed = parse(rest, spec);
+    const code = await spec.run(parsed);
+    /* One line when a workspace thread has unread messages: terminals only, at most every few minutes. */
+    await (0, workspace_threads_js_1.unreadReminder)(name, parsed);
+    return code;
 }
 /**
  * Set the status and let Node wind down on its own.

package/dist/cli/src/service_commands.js

@@ -421,6 +421,23 @@ async function commandWatch(parsed) {
     if (parsed.flags.has("email")) {
         change.emailDigest = parsed.flags.get("email") !== "off";
     }
+    /* Workspace discussions are their own switch (workspace_threads.ts). */
+    const discussions = parsed.flags.get("discussions");
+    if (discussions !== undefined) {
+        if (discussions !== "all" && discussions !== "off") {
+            console.error((0, colour_js_1.red)("--discussions must be all or off"));
+            return 1;
+        }
+        await (0, api_js_1.callApi)(`/v1/repositories/${encodeURIComponent(project.id)}/workspace-discussions/watch`, {
+            method: "PUT",
+            body: { level: discussions },
+        });
+        console.log((0, colour_js_1.green)(discussions === "all"
+            ? `Workspace discussions in ${project.name}: new messages reach your notifications.`
+            : `Workspace discussions in ${project.name}: off. Threads still show unread counts.`));
+        if (!Object.keys(change).length)
+            return 0;
+    }
     if (Object.keys(change).length) {
         await (0, api_js_1.setWatch)(project.id, change);
         console.log((0, colour_js_1.green)(`Updated what reaches you about ${project.name}.`));

package/dist/cli/src/workspace_command.js

@@ -7,16 +7,26 @@ const node_readline_1 = require("node:readline");
 const api_js_1 = require("./api.js");
 const config_js_1 = require("./config.js");
 const workspace_machine_js_1 = require("./workspace_machine.js");
+const workspace_threads_js_1 = require("./workspace_threads.js");
 async function commandWorkspace(parsed) {
     const [operation, projectRef, workspace, runId] = parsed.positional;
     if (operation && workspace_machine_js_1.MACHINE_OPERATIONS.has(operation))
         return (0, workspace_machine_js_1.commandWorkspaceMachine)(parsed);
+    /* On its own at a terminal: choose a workspace and see what is being discussed. Scripts get the usage line as before. */
+    if (!operation && process.stdin.isTTY && process.stdout.isTTY)
+        return (0, workspace_threads_js_1.interactiveWorkspaces)(parsed);
     if (!operation || !projectRef)
         throw new Error("Use cbx workspace <operation> <project> [workspace]. See cbx help workspace.");
     const project = await (0, api_js_1.findProject)(projectRef);
     if (!project)
         throw new Error(`No accessible project ${projectRef}`);
     const root = `/v1/repositories/${encodeURIComponent(project.id)}`;
+    if (workspace_threads_js_1.THREAD_OPERATIONS.has(operation)) {
+        if (!workspace)
+            throw new Error("Supply the workspace ID after the project");
+        return (0, workspace_threads_js_1.commandWorkspaceThread)(operation, root, workspace, parsed);
+    }
+    const named = (0, workspace_threads_js_1.authorName)(parsed);
     const flag = (name) => {
         const value = parsed.flags.get(name);
         return typeof value === "string" ? value : undefined;
@@ -41,7 +51,11 @@ async function commandWorkspace(parsed) {
     const key = flag("key") ?? data.operationKey;
     const revision = integer("revision") ?? data.expectedRevision;
     let path = `${root}/workspaces`, method = "GET", body;
-    if (operation === "usage") {
+    if (operation === "list") {
+        if (named)
+            path += `?as=${encodeURIComponent(named)}`;
+    }
+    else if (operation === "usage") {
         path = `${root}/workspace-usage`;
     }
     else if (operation === "open") {
@@ -95,6 +109,7 @@ async function commandWorkspace(parsed) {
                 operationKey: key,
                 expectedRevision: revision,
                 message: flag("message") ?? flag("m") ?? data.message,
+                ...(named ? { as: named } : {}),
             };
         }
         else if (operation === "run" ||

package/dist/cli/src/workspace_threads.js

@@ -0,0 +1,339 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.THREAD_OPERATIONS = void 0;
+exports.authorName = authorName;
+exports.commandWorkspaceThread = commandWorkspaceThread;
+exports.unreadReminder = unreadReminder;
+exports.interactiveWorkspaces = interactiveWorkspaces;
+/**
+ * Workspace discussions in the terminal (approved concept, 2026-11-05).
+ *
+ *   cbx workspace                    at a terminal: choose a workspace, see what is
+ *                                    being discussed, and act on it with one key
+ *   cbx workspace say <p> <w> -m …   post to a workspace's thread (JSON)
+ *   cbx workspace thread <p> <w>     read it (JSON); --unread, --peek
+ *   cbx workspace mute|unmute <p> <w>
+ *
+ * A machine signed in to the account can name itself with --as or CBX_NAME, so
+ * its messages read as its own ("GrokBot · your account") and it keeps its own
+ * read point. A machine a draft was handed to is named by its handover already.
+ *
+ * Any other command ends with one line when something is unread (unreadReminder),
+ * at most every few minutes and only at a terminal, so scripts never see it.
+ */
+const node_crypto_1 = require("node:crypto");
+const promises_1 = require("node:fs/promises");
+const node_path_1 = __importDefault(require("node:path"));
+const node_readline_1 = __importDefault(require("node:readline"));
+const api_js_1 = require("./api.js");
+const colour_js_1 = require("./colour.js");
+const config_js_1 = require("./config.js");
+exports.THREAD_OPERATIONS = new Set(["say", "thread", "mute", "unmute"]);
+/** The name this machine posts and reads as, if it gave one. */
+function authorName(parsed) {
+    const flag = parsed.flags.get("as");
+    const name = typeof flag === "string" ? flag : process.env.CBX_NAME;
+    return name?.trim() || undefined;
+}
+const asQuery = (name) => (name ? `as=${encodeURIComponent(name)}` : "");
+const join = (...parts) => {
+    const query = parts.filter(Boolean).join("&");
+    return query ? `?${query}` : "";
+};
+/** say, thread, mute and unmute: plain JSON, like every other workspace operation. */
+async function commandWorkspaceThread(operation, root, workspaceId, parsed) {
+    const name = authorName(parsed);
+    const base = `${root}/workspaces/${encodeURIComponent(workspaceId)}/messages`;
+    let result;
+    if (operation === "say") {
+        const message = parsed.flags.get("message") ?? parsed.flags.get("m");
+        if (typeof message !== "string" || !message.trim())
+            throw new Error('Write the message with -m "…"');
+        result = await (0, api_js_1.callApi)(base, { method: "POST", body: { body: message, ...(name ? { as: name } : {}) } });
+    }
+    else if (operation === "thread") {
+        const after = parsed.flags.get("after");
+        result = await (0, api_js_1.callApi)(base +
+            join(asQuery(name), parsed.flags.has("unread") ? "unread=true" : "", parsed.flags.has("peek") ? "peek=true" : "", typeof after === "string" ? `after=${encodeURIComponent(after)}` : ""));
+    }
+    else {
+        result = await (0, api_js_1.callApi)(`${base}/mute`, {
+            method: "PUT",
+            body: { muted: operation === "mute", ...(name ? { as: name } : {}) },
+        });
+    }
+    console.log(JSON.stringify(result, null, 2));
+    return 0;
+}
+/* ----------------------------------------------------------- the reminder */
+const REMIND_EVERY_MS = 5 * 60_000;
+/**
+ * One line after a command when a workspace thread has unread messages. Only
+ * at a terminal, at most every five minutes, never slower than 1.5 s, and
+ * silent on any failure: it must not change what a command does or prints in
+ * a script.
+ */
+async function unreadReminder(command, parsed) {
+    if (!process.stdout.isTTY || process.env.CODEROOK_NO_REMINDERS)
+        return;
+    if (["workspace", "sign-in", "sign-out", "help", "mcp"].includes(command))
+        return;
+    const stamp = node_path_1.default.join((0, config_js_1.configDirectory)(), "discussions-checked");
+    try {
+        const last = Number((await (0, promises_1.readFile)(stamp, "utf8")).trim());
+        if (Date.now() - last < REMIND_EVERY_MS)
+            return;
+    }
+    catch {
+        /* Never checked on this machine. */
+    }
+    try {
+        await (0, promises_1.mkdir)(node_path_1.default.dirname(stamp), { recursive: true });
+        await (0, promises_1.writeFile)(stamp, String(Date.now()));
+        const found = await Promise.race([
+            (0, api_js_1.callApi)(`/v1/account/workspace-threads${join(asQuery(authorName(parsed)))}`),
+            new Promise((resolve) => setTimeout(() => resolve(null), 1500).unref()),
+        ]);
+        const waiting = found?.workspaces.filter((w) => w.unread > 0) ?? [];
+        if (!waiting.length)
+            return;
+        const total = waiting.reduce((n, w) => n + w.unread, 0);
+        const where = waiting.length === 1 ? `in ${waiting[0].name}` : `in ${waiting.length} workspaces`;
+        console.log(`\n${(0, colour_js_1.accent)("●")} ${(0, colour_js_1.bold)(`${total} new message${total === 1 ? "" : "s"}`)} ${(0, colour_js_1.dim)(where)} ${(0, colour_js_1.dim)("· cbx workspace")}`);
+    }
+    catch {
+        /* A reminder is never worth an error. */
+    }
+}
+/* ----------------------------------------------------------- the picker */
+const when = (iso) => {
+    const date = new Date(iso);
+    const today = new Date();
+    if (date.toDateString() === today.toDateString())
+        return date.toLocaleTimeString(undefined, { hour: "2-digit", minute: "2-digit" });
+    const yesterday = new Date(today.valueOf() - 86_400_000);
+    if (date.toDateString() === yesterday.toDateString())
+        return "yesterday";
+    return date.toLocaleDateString(undefined, { day: "numeric", month: "short" });
+};
+const pad = (text, width) => (text.length > width ? `${text.slice(0, width - 1)}…` : text.padEnd(width));
+function who(message) {
+    const label = message.author.label;
+    if (message.author.kind === "person")
+        return (0, colour_js_1.accent)("You");
+    if (message.author.kind === "named")
+        return `${(0, colour_js_1.bold)(label)} ${(0, colour_js_1.dim)("· your account")}`;
+    return `${(0, colour_js_1.bold)(label)} ${(0, colour_js_1.dim)("· handed over by you")}`;
+}
+function renderMessage(message) {
+    const time = (0, colour_js_1.dim)(when(message.createdAt));
+    if (message.kind === "event")
+        return `  ${(0, colour_js_1.green)("✓")} ${(0, colour_js_1.dim)(message.body)} ${(0, colour_js_1.dim)("·")} ${time}`;
+    const body = message.deleted ? (0, colour_js_1.dim)("(deleted)") : message.body.split("\n").map((line) => `    ${line}`).join("\n");
+    return `  ${who(message)} ${(0, colour_js_1.dim)("·")} ${time}${message.editedAt ? (0, colour_js_1.dim)(" · edited") : ""}\n${body}`;
+}
+/** Read one key at a terminal. */
+function key() {
+    return new Promise((resolve) => {
+        const handler = (sequence, info) => {
+            process.stdin.off("keypress", handler);
+            resolve({ name: info?.name ?? sequence, sequence, ctrl: Boolean(info?.ctrl) });
+        };
+        process.stdin.on("keypress", handler);
+    });
+}
+function raw(on) {
+    if (process.stdin.isTTY)
+        process.stdin.setRawMode(on);
+    if (on)
+        process.stdin.resume();
+    else
+        process.stdin.pause();
+}
+/** Ask for a line of text, out of raw mode. */
+async function ask(prompt) {
+    raw(false);
+    const lines = node_readline_1.default.createInterface({ input: process.stdin, output: process.stdout });
+    try {
+        return (await new Promise((resolve) => lines.question(prompt, resolve))).trim();
+    }
+    finally {
+        lines.close();
+    }
+}
+const clear = () => process.stdout.write("\x1b[2J\x1b[H");
+/** `cbx workspace` on its own at a terminal. */
+async function interactiveWorkspaces(parsed) {
+    const name = authorName(parsed);
+    node_readline_1.default.emitKeypressEvents(process.stdin);
+    let selected = 0;
+    let filter = "";
+    try {
+        for (;;) {
+            const listed = await (0, api_js_1.callApi)(`/v1/account/workspace-threads${join(asQuery(name))}`);
+            const shown = listed.workspaces.filter((w) => `${w.project} ${w.name}`.toLowerCase().includes(filter.toLowerCase()));
+            selected = Math.min(selected, Math.max(0, shown.length - 1));
+            clear();
+            console.log(`${(0, colour_js_1.dim)("Open workspaces")}${name ? (0, colour_js_1.dim)(`  as ${name}`) : ""}  ${(0, colour_js_1.dim)("·  ↑↓ choose  ·  Enter open  ·  / filter  ·  q quit")}\n`);
+            if (!shown.length)
+                console.log((0, colour_js_1.dim)(filter ? `  Nothing matches "${filter}".` : "  No open workspaces. Start one with cbx workspace open <project> --name …"));
+            shown.forEach((w, index) => {
+                const count = w.unread ? (0, colour_js_1.accent)(pad(`${w.unread} new`, 7)) : (0, colour_js_1.dim)(pad("read", 7));
+                const line = ` ${index === selected ? (0, colour_js_1.accent)("›") : " "} ${pad(w.project, 14)} ${pad(w.name, 40)} ${count} ${(0, colour_js_1.dim)(when(w.activeAt))}`;
+                console.log(index === selected ? (0, colour_js_1.bold)(line) : line);
+            });
+            console.log((0, colour_js_1.dim)(`\n${shown.length} open${filter ? ` matching "${filter}"` : ""} · ${listed.archived} archived (cbx workspace list <project> shows them)`));
+            raw(true);
+            const pressed = await key();
+            if (pressed.ctrl && pressed.name === "c")
+                return 0;
+            if (pressed.name === "q" || pressed.name === "escape")
+                return 0;
+            if (pressed.name === "up")
+                selected = Math.max(0, selected - 1);
+            else if (pressed.name === "down")
+                selected = Math.min(shown.length - 1, selected + 1);
+            else if (pressed.sequence === "/") {
+                filter = await ask("filter › ");
+                selected = 0;
+            }
+            else if (pressed.name === "return" && shown[selected]) {
+                const done = await openWorkspace(shown[selected], name);
+                if (done)
+                    return 0;
+            }
+        }
+    }
+    finally {
+        raw(false);
+    }
+}
+/** One workspace: what changed, what is being said, and what to do. Returns true to leave cbx. */
+async function openWorkspace(listed, name) {
+    const root = `/v1/repositories/${encodeURIComponent(listed.projectId)}/workspaces/${encodeURIComponent(listed.id)}`;
+    let notice = "";
+    for (;;) {
+        const shown = await (0, api_js_1.callApi)(root);
+        const thread = await (0, api_js_1.callApi)(`${root}/messages${join(asQuery(name))}`);
+        const w = shown.workspace;
+        clear();
+        console.log(`${(0, colour_js_1.bold)(w.name)}  ${(0, colour_js_1.dim)(`${listed.project} · ${w.track} · revision ${w.revision}${w.archived ? " · archived" : ""}`)}`);
+        const files = shown.changes;
+        console.log(files.length
+            ? `${(0, colour_js_1.dim)(`${files.length} file${files.length === 1 ? "" : "s"} changed`)}  ${(0, colour_js_1.dim)(files.slice(0, 3).map((f) => f.path).join(" · "))}${files.length > 3 ? (0, colour_js_1.dim)(" …") : ""}`
+            : (0, colour_js_1.dim)("No changes yet"));
+        if (thread.pinned)
+            console.log(`\n${(0, colour_js_1.accent)("PINNED")}  ${(0, colour_js_1.dim)("handoff note")}\n  ${thread.pinned.split("\n").slice(0, 4).join("\n  ")}`);
+        const recent = thread.messages.slice(-6);
+        console.log(`\n${(0, colour_js_1.dim)("Discussion")}${listed.unread ? `  ${(0, colour_js_1.accent)(`${listed.unread} new`)}` : ""}${thread.muted ? (0, colour_js_1.dim)("  · muted") : ""}`);
+        console.log(recent.length ? recent.map(renderMessage).join("\n") : (0, colour_js_1.dim)("  Nothing said yet. Press r to start."));
+        if (thread.messages.length > recent.length || thread.next)
+            console.log((0, colour_js_1.dim)("  … earlier messages: press t"));
+        listed.unread = 0;
+        console.log((0, colour_js_1.dim)("\n────────────────────────────────────────────────────────────"));
+        console.log(` ${(0, colour_js_1.accent)("r")} reply   ${(0, colour_js_1.accent)("t")} whole thread   ${(0, colour_js_1.accent)("f")} files   ${(0, colour_js_1.accent)("u")} run checks\n` +
+            ` ${(0, colour_js_1.accent)("s")} save as a version   ${(0, colour_js_1.accent)("h")} hand over   ${(0, colour_js_1.accent)("m")} ${thread.muted ? "unmute" : "mute"}   ${(0, colour_js_1.accent)("c")} close   ${(0, colour_js_1.accent)("q")} back`);
+        if (notice)
+            console.log(`\n${notice}`);
+        notice = "";
+        raw(true);
+        const pressed = await key();
+        if (pressed.ctrl && pressed.name === "c")
+            return true;
+        if (pressed.name === "q" || pressed.name === "escape")
+            return false;
+        try {
+            if (pressed.name === "r") {
+                const text = await ask((0, colour_js_1.accent)("reply › "));
+                if (text) {
+                    await (0, api_js_1.callApi)(`${root}/messages`, { method: "POST", body: { body: text, ...(name ? { as: name } : {}) } });
+                    notice = (0, colour_js_1.green)("Sent.");
+                }
+            }
+            else if (pressed.name === "t") {
+                await wholeThread(root, name);
+            }
+            else if (pressed.name === "f") {
+                clear();
+                console.log((0, colour_js_1.bold)(`${w.name} · changes`));
+                console.log(files.length ? files.map((f) => `  ${f.removed ? (0, colour_js_1.red)("removed") : (0, colour_js_1.green)("changed")}  ${f.path}`).join("\n") : (0, colour_js_1.dim)("  No changes yet"));
+                await pause();
+            }
+            else if (pressed.name === "m") {
+                await (0, api_js_1.callApi)(`${root}/messages/mute`, { method: "PUT", body: { muted: !thread.muted, ...(name ? { as: name } : {}) } });
+                notice = (0, colour_js_1.green)(thread.muted ? "Unmuted." : "Muted. New messages here no longer notify you.");
+            }
+            else if (pressed.name === "s") {
+                const message = await ask("describe the version › ");
+                if (message) {
+                    const saved = await (0, api_js_1.callApi)(`${root}/save`, {
+                        method: "POST",
+                        body: { expectedRevision: w.revision, operationKey: `picker-${(0, node_crypto_1.randomUUID)()}`, message, ...(name ? { as: name } : {}) },
+                    });
+                    notice = (0, colour_js_1.green)(`Saved${saved.version?.sequence ? ` as v${saved.version.sequence}` : ""}${saved.review ? ` on ${saved.review.line}, for review` : ""}.`);
+                }
+            }
+            else if (pressed.name === "u") {
+                const checks = shown.recipes.filter((one) => one.kind === "check");
+                if (!checks.length)
+                    notice = (0, colour_js_1.dim)("This project has no check recipes. cbx workspace recipe sets one up.");
+                else {
+                    const pick = await ask(`recipe (${checks.map((one) => one.name).join(", ")}) › `);
+                    const recipe = checks.find((one) => one.name === pick) ?? (checks.length === 1 && !pick ? checks[0] : undefined);
+                    if (recipe) {
+                        const run = await (0, api_js_1.callApi)(`${root}/runs`, {
+                            method: "POST",
+                            body: { expectedRevision: w.revision, operationKey: `picker-${(0, node_crypto_1.randomUUID)()}`, recipe: recipe.name },
+                        });
+                        notice = (0, colour_js_1.green)(`Started ${recipe.name}.`) + (0, colour_js_1.dim)(run.runId ? ` cbx workspace logs ${listed.project} ${listed.id} ${run.runId}` : "");
+                    }
+                    else
+                        notice = (0, colour_js_1.dim)("No such recipe; nothing started.");
+                }
+            }
+            else if (pressed.name === "h") {
+                const machine = await ask("machine name › ");
+                if (machine) {
+                    const made = await (0, api_js_1.callApi)(`${root}/assignments`, {
+                        method: "POST",
+                        body: { name: machine },
+                    });
+                    clear();
+                    console.log(`${(0, colour_js_1.bold)(`Handed to ${machine}`)}\n\n  ${made.token}\n\n${(0, colour_js_1.dim)("Shown once. On that machine: cbx workspace checkout " + listed.project + " " + listed.id + " (with CODEROOK_TOKEN set to it).")}`);
+                    await pause();
+                }
+            }
+            else if (pressed.name === "c") {
+                const sure = await ask(`archive "${w.name}"? every machine it was handed to loses access (y/N) › `);
+                if (sure.toLowerCase() === "y") {
+                    await (0, api_js_1.callApi)(root, { method: "PATCH", body: { expectedRevision: w.revision, archived: true } });
+                    return false;
+                }
+            }
+        }
+        catch (error) {
+            notice = (0, colour_js_1.red)(error instanceof Error ? error.message : String(error));
+        }
+    }
+}
+async function wholeThread(root, name) {
+    clear();
+    let after = null;
+    do {
+        const page = await (0, api_js_1.callApi)(`${root}/messages${join(asQuery(name), after ? `after=${encodeURIComponent(after)}` : "")}`);
+        if (!after && page.pinned)
+            console.log(`${(0, colour_js_1.accent)("PINNED")}  ${(0, colour_js_1.dim)("handoff note")}\n  ${page.pinned.split("\n").join("\n  ")}\n`);
+        for (const message of page.messages)
+            console.log(renderMessage(message));
+        after = page.next;
+    } while (after);
+    await pause();
+}
+async function pause() {
+    console.log((0, colour_js_1.dim)("\npress any key"));
+    raw(true);
+    await key();
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coderook/cli",
-  "version": "0.41.2",
+  "version": "0.42.0",
   "description": "The command line for CodeRook (coderook.com): version control and project hosting for projects of any size. Every save is a compressed snapshot, private or public, never used to train AI.",
   "license": "Apache-2.0",
   "homepage": "https://coderook.com",