@sma1lboy/rove 0.9.243 → 0.9.245

package/dist/cli/pty-host-node.mjs

@@ -1395,6 +1395,170 @@ function clearFrozenSessions(dir = defaultPtyFreezeDir()) {
   } catch {}
 }
 
+// ../rove-daemon/src/daemon/osc-signals.ts
+import { StringDecoder as StringDecoder2 } from "node:string_decoder";
+function createOscSignals() {
+  return { carry: "", decoder: new StringDecoder2("utf8"), records: new Map, contexts: [] };
+}
+function freeText(raw, encodedLimit, decodedLimit) {
+  if (raw === undefined)
+    return;
+  if (raw.length > encodedLimit || !/^[A-Za-z0-9+/]*={0,2}$/.test(raw) || raw.replace(/=+$/, "").length % 4 === 1)
+    throw new Error("Invalid base64");
+  const bytes = Buffer.from(raw, "base64");
+  if (bytes.length > decodedLimit)
+    throw new Error("Text exceeds limit");
+  const text = new TextDecoder("utf-8", { fatal: true }).decode(bytes);
+  if (/[\x00-\x1f\x7f-\x9f]/u.test(text))
+    throw new Error("Control character");
+  return text;
+}
+function applyProgramStatus(signals, body, now) {
+  if (Buffer.byteLength(body) + 10 > 4096)
+    return;
+  const pairs = Object.create(null);
+  for (const pair of body.split(":")) {
+    const split = pair.indexOf("=");
+    if (split < 1)
+      continue;
+    const key = pair.slice(0, split).trim();
+    const value = pair.slice(split + 1).trim();
+    if (key.length > 16)
+      return;
+    if (/^[a-z]+$/.test(key) && /^[A-Za-z0-9_.,+/=-]*$/.test(value))
+      pairs[key] = value;
+  }
+  const id = pairs.id ?? "";
+  if (pairs.id !== undefined && (id.length > 128 || id.split("/").length > 8 || !/^[A-Za-z0-9_.+-]{1,32}(\/[A-Za-z0-9_.+-]{1,32})*$/.test(id)))
+    return;
+  const state = pairs.state;
+  if (!["idle", "working", "done", "blocked", "error", "clear"].includes(state ?? ""))
+    return;
+  let msg;
+  let title;
+  try {
+    msg = freeText(pairs.msg, 2732, 2048);
+    title = freeText(pairs.title, 256, 192);
+  } catch {
+    return;
+  }
+  if (pairs.app !== undefined && pairs.app.length > 32)
+    return;
+  if (state === "clear") {
+    for (const key of signals.records.keys())
+      if (!id || key === id || key.startsWith(`${id}/`))
+        signals.records.delete(key);
+    return;
+  }
+  if (state !== "idle" && state !== "working" && state !== "done" && state !== "blocked" && state !== "error")
+    return;
+  const kind = pairs.kind === "permission" || pairs.kind === "question" || pairs.kind === "auth" ? pairs.kind : undefined;
+  const progress = pairs.progress !== undefined && /^\d{1,3}$/.test(pairs.progress) && Number(pairs.progress) <= 100 ? Number(pairs.progress) : undefined;
+  signals.records.delete(id);
+  signals.records.set(id, {
+    id,
+    state,
+    at: now,
+    ...msg !== undefined ? { msg } : {},
+    ...title !== undefined ? { title } : {},
+    ...pairs.app && /^[A-Za-z0-9_.+-]{1,32}$/.test(pairs.app) ? { app: pairs.app } : {},
+    ...state === "blocked" && kind ? { kind } : {},
+    ...(state === "working" || state === "blocked") && progress !== undefined ? { progress } : {}
+  });
+  if (signals.records.size > 64) {
+    const first = signals.records.keys().next().value;
+    if (first !== undefined)
+      signals.records.delete(first);
+  }
+}
+function applyContext(signals, body) {
+  if (Buffer.byteLength(body) > 4096 || /[\x00-\x1f\x7f]/.test(body))
+    return;
+  const [head = "", ...fields] = body.split(";");
+  const split = head.indexOf("=");
+  const operation = head.slice(0, split);
+  const decodeContextField = (text) => text.replace(/\\x(3b|5c)/g, (_, hex) => hex === "3b" ? ";" : "\\");
+  const id = decodeContextField(head.slice(split + 1));
+  if (operation !== "start" && operation !== "end" || !/^[ -~]{1,64}$/.test(id))
+    return;
+  const index = signals.contexts.findIndex((c) => c.id === id);
+  if (operation === "end") {
+    if (index !== -1)
+      signals.contexts.splice(index);
+    return;
+  }
+  if (index !== -1)
+    signals.contexts.splice(index);
+  if (signals.contexts.length >= 32)
+    return;
+  const metadata = Object.create(null);
+  for (const field of fields) {
+    const i = field.indexOf("=");
+    if (i > 0)
+      metadata[field.slice(0, i)] = decodeContextField(field.slice(i + 1));
+  }
+  signals.contexts.push({ id, metadata });
+}
+function clearTransientStatuses(signals) {
+  for (const [id, record] of signals.records) {
+    if (record.state === "working" || record.state === "blocked" || record.state === "idle")
+      signals.records.delete(id);
+  }
+}
+function scanOscSignals(signals, bytes, now = Date.now(), onRootChange) {
+  const text = signals.carry + signals.decoder.write(bytes);
+  signals.carry = "";
+  let queries = 0;
+  for (let i = 0;i < text.length; i++) {
+    if (text[i] !== "\x1B")
+      continue;
+    if (i === text.length - 1) {
+      signals.carry = "\x1B";
+      break;
+    }
+    if (text[i + 1] === "c") {
+      const hadRoot = signals.records.has("");
+      signals.records.clear();
+      if (hadRoot)
+        onRootChange?.(null);
+      signals.contexts = [];
+      i++;
+      continue;
+    }
+    if (text[i + 1] !== "]")
+      continue;
+    const begin = i;
+    i += 2;
+    let end = i;
+    while (end < text.length && text[end] !== "\x07" && text[end] !== "\x1B")
+      end++;
+    if (end === text.length || text[end] === "\x1B" && end + 1 === text.length) {
+      if (text.length - begin <= 8192)
+        signals.carry = text.slice(begin);
+      break;
+    }
+    if (text[end] === "\x1B" && text[end + 1] !== "\\") {
+      i = end - 1;
+      continue;
+    }
+    const before = signals.records.get("");
+    const body = text.slice(i, end);
+    if (body === "7501;?")
+      queries++;
+    else if (body.startsWith("7501;"))
+      applyProgramStatus(signals, body.slice(5), now);
+    else if (body.startsWith("3008;"))
+      applyContext(signals, body.slice(5));
+    else if (body === "133;A" || body.startsWith("133;A;"))
+      clearTransientStatuses(signals);
+    const after = signals.records.get("");
+    if (before !== after)
+      onRootChange?.(after ?? null);
+    i = end + (text[end] === "\x1B" ? 1 : 0);
+  }
+  return queries;
+}
+
 // ../rove-daemon/src/daemon/pty-child-controller.ts
 import { randomUUID as randomUUID6 } from "node:crypto";
 
@@ -1476,7 +1640,7 @@ function embeddedTerminalEnv(base, overrides = {}) {
 
 // ../rove-daemon/src/daemon/pty-host-types.ts
 import { randomUUID as randomUUID5 } from "node:crypto";
-import { StringDecoder as StringDecoder2 } from "node:string_decoder";
+import { StringDecoder as StringDecoder3 } from "node:string_decoder";
 function freshSessionState(key, spec, argv) {
   return {
     key,
@@ -1492,7 +1656,7 @@ function freshSessionState(key, spec, argv) {
     command: argv,
     title: "",
     titleCarry: "",
-    titleDecoder: new StringDecoder2("utf8"),
+    titleDecoder: new StringDecoder3("utf8"),
     colorQueryCarry: "",
     defaultColors: parseTerminalDefaultColors(spec.defaultColors) ?? DEFAULT_TERMINAL_COLORS,
     modes: freshModeTrack(),
@@ -1517,6 +1681,9 @@ function sessionInfo(s) {
     pid: s.proc?.pid ?? null,
     command: s.command,
     title: s.title,
+    programStatusEvent: s.programStatusEvent,
+    programStatus: s.oscSignals?.records.get(""),
+    contexts: s.oscSignals?.contexts,
     totalBytes: s.totalBytes,
     parked: s.parked,
     parkedScreenBytes: s.parkedScreenBytes,
@@ -1672,6 +1839,9 @@ class PtyChildController {
   }
   startChild(session) {
     session.generation = randomUUID6();
+    session.oscSignals = undefined;
+    session.programStatusEvent = undefined;
+    this.reportStatus(session, null);
     try {
       session.proc = (this.deps.driver ?? bunTerminalDriver())({
         argv: [...session.command],
@@ -1708,6 +1878,12 @@ class PtyChildController {
     if (!session.alive)
       return;
     session.alive = false;
+    if (session.oscSignals) {
+      const before = session.oscSignals.records.get("");
+      clearTransientStatuses(session.oscSignals);
+      if (before !== session.oscSignals.records.get(""))
+        this.reportStatus(session, null);
+    }
     const sessionExit = {
       code: exit?.code ?? null,
       signal: exit?.signal ?? null,
@@ -1719,12 +1895,27 @@ class PtyChildController {
     } catch {}
     this.deps.onExit?.(session, sessionExit);
   }
+  reportStatus(session, status) {
+    const event = {
+      key: session.key,
+      generation: session.generation,
+      revision: (session.programStatusEvent?.revision ?? 0) + 1,
+      at: Date.now(),
+      status
+    };
+    session.programStatusEvent = event;
+    this.deps.onProgramStatus?.(event);
+  }
   onData(session, data) {
     const buf = typeof data === "string" ? Buffer.from(data, "utf8") : Buffer.from(data);
     const text = buf.toString("latin1");
+    session.oscSignals ??= createOscSignals();
+    const queries = scanOscSignals(session.oscSignals, buf, Date.now(), (status) => this.reportStatus(session, status));
     const colorQueries = foldDefaultColorQueries(session.colorQueryCarry, text);
     session.colorQueryCarry = colorQueries.carry;
     const replies = colorQueries.slots.map((slot) => formatDefaultColorReply(slot, session.defaultColors));
+    for (let i = 0;i < Math.min(queries, 16); i++)
+      replies.push("\x1B]7501;?\x1B\\");
     const modeReplies = scanTerminalModes(session.modes, text);
     if (session.emulatorSinks.size === 0)
       replies.push(...modeReplies);
@@ -1833,6 +2024,7 @@ class PtyHost {
     this.scrollbackCap = opts.scrollbackCap ?? DEFAULT_SCROLLBACK_CAP;
     this.childController = new PtyChildController({
       driver: opts.driver,
+      onProgramStatus: (event) => this.opts.onProgramStatus?.(event),
       scrollbackCap: this.scrollbackCap,
       onSessionStart: (spare) => {
         if (!spare)
@@ -1983,6 +2175,12 @@ class PtyHost {
       return false;
     this.sessions.delete(from);
     session.key = to;
+    if (session.programStatusEvent) {
+      const previous = session.programStatusEvent;
+      this.opts.onProgramStatus?.({ ...previous, revision: previous.revision + 1, at: Date.now(), status: null });
+      session.programStatusEvent = { ...previous, key: to, revision: previous.revision + 1, at: Date.now() };
+      this.opts.onProgramStatus?.(session.programStatusEvent);
+    }
     this.sessions.set(to, session);
     this.opts.freeze?.drop(from);
     this.maybeFreeze(session, true);
@@ -2093,7 +2291,7 @@ import { dirname as dirname6 } from "node:path";
 
 // ../rove-daemon/src/client/index.ts
 import { connect } from "node:net";
-import { StringDecoder as StringDecoder3 } from "node:string_decoder";
+import { StringDecoder as StringDecoder4 } from "node:string_decoder";
 
 // ../rove-daemon/src/client/client-log.ts
 import { appendFile, mkdir as mkdir3, rename as rename2, stat } from "node:fs/promises";
@@ -2362,7 +2560,7 @@ class RoveDaemonClient {
       };
       socket.once("connect", onConnect);
       socket.once("error", onError);
-      const decoder = new StringDecoder3("utf8");
+      const decoder = new StringDecoder4("utf8");
       this.buffer = "";
       socket.on("data", (chunk) => this.onData(decoder.write(chunk)));
       socket.on("close", () => this.onSocketClose(socket));
@@ -2684,6 +2882,13 @@ function dispatchPtyRequest(req, client, deps) {
         ptys.detach(requireString(payload, "key"), client, payload.parked === true, typeof payload.parkedScreenBytes === "number" ? payload.parkedScreenBytes : 0);
       }
       return {};
+    case "pty.watchStatus":
+      client.watchProgramStatus = true;
+      for (const session of ptys.list()) {
+        if (session.programStatusEvent)
+          deps.writeFrame(client, { type: "event", name: "pty.programStatus", payload: session.programStatusEvent });
+      }
+      return { supported: true };
     case "pty.list":
       return {
         pid: process.pid,
@@ -2804,6 +3009,12 @@ async function startPtyHostServer(options = {}) {
   }, orphanCheckMs);
   orphanTimer.unref?.();
   const ptys = new PtyHost({
+    onProgramStatus: (event) => {
+      for (const client of clients) {
+        if (client.watchProgramStatus)
+          writeFrame(client, { type: "event", name: "pty.programStatus", payload: event });
+      }
+    },
     onSessionStart: cancelIdle,
     onSessionEnd: () => {
       if (ptys.liveCount() === 0)

package/dist/cli/rove.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import{join as n}from"node:path";import{createInterface as a}from"node:readline/promises";import{pathToFileURL as ss}from"node:url";import{spawnSync as Q}from"node:child_process";import{constants as d,accessSync as R}from"node:fs";import{homedir as I}from"node:os";import{basename as U,delimiter as o,dirname as _,join as k}from"node:path";import{fileURLToPath as T}from"node:url";var H={$schema:"https://json.schemastore.org/package.json",name:"@sma1lboy/rove",version:"0.9.243",description:"Rove — the agent multiplexer for your terminal. Run coding agents on parallel tasks with isolated worktrees and persistent sessions.",keywords:["terminal","tui","cli","multiplexer","ai-agents","coding-agent","ai-coding-assistant","agentic-ai","parallel-agents","git-worktree","claude-code","codex","llm","developer-tools"],type:"module",packageManager:"bun@1.3.13",bin:{rove:"dist/cli/rove.js"},files:["dist/cli","dist/completions","dist/web-ui","dist/skills","dist/*.wav","README.md","LICENSE"],publishConfig:{access:"public"},repository:{type:"git",url:"git+https://github.com/Sma1lboy/rove.git"},homepage:"https://rove.run",bugs:{url:"https://github.com/Sma1lboy/rove/issues"},engines:{bun:">=1.3.11"},scripts:{dev:"ROVE_DEV=1 bun --conditions=browser ./src/cli/rove.ts","dev:mock":"ROVE_DEV=1 bun ./src/tui-react/mock/host.tsx","dev:sandbox":"bun run scripts/dev-sandbox.ts run","dev:sandbox:reset":"bun run scripts/dev-sandbox.ts reset",build:"bun run scripts/build.ts","build:rubric":"bun run scripts/build-tier-rubric.ts",compile:"bun run scripts/compile.ts",typecheck:"tsc --noEmit","check-i18n":"bun run scripts/check-i18n.ts",test:"bun run test:fast && bun run test:socket","perf:golden":"bun scripts/perf-golden.ts","pty:soak":"bun scripts/pty-soak.ts","test:fast":"vitest run --passWithNoTests --minWorkers=1 --maxWorkers=8","test:socket":"ROVE_INCLUDE_SOCKET=1 vitest run test/daemon --pool forks --minWorkers=1 --maxWorkers=4 --passWithNoTests","test:socket:coverage":"ROVE_INCLUDE_SOCKET=1 ROVE_COVERAGE_DAEMON=1 vitest run test/daemon --coverage --pool forks --minWorkers=1 --maxWorkers=4 --passWithNoTests","test:behavior":"ROVE_INCLUDE_BEHAVIOR=1 vitest run test/behavior --pool forks --minWorkers=1 --maxWorkers=1 --retry=2 --passWithNoTests","test:render":"bun scripts/render-track.mjs",coverage:"vitest run --coverage --passWithNoTests",bench:"vitest bench --run",lint:"biome check .",knip:"knip-bun",postinstall:"bun run scripts/check-preview-deps.ts || true",prepublishOnly:"bun run typecheck && bun run build","plugin-sandbox":"bun run scripts/plugin-sandbox.ts"},"//":"biome.json + bunfig.toml live at the monorepo root since they apply repo-wide; bun.lock also lives at root (workspace-shared).",dependencies:{"@ansi-tools/parser":"^1.0.15","@opentui/core":"0.4.3","@opentui/react":"0.4.3","@xterm/addon-serialize":"^0.14.0","@xterm/addon-unicode11":"^0.9.0","@xterm/headless":"^6.0.0","node-pty":"^1.1.0",react:"^19.2.8","smol-toml":"^1.7.1",ws:"^8.21.3"},devDependencies:{"@biomejs/biome":"1.9.4","@sma1lboy/rove-daemon":"0.7.20","@tsconfig/bun":"1.0.11","@types/bun":"1.3.14","@types/node":"25.6.2","@types/react":"^19.2.0","@vitest/coverage-v8":"2.1.9",knip:"^6.14.2","react-devtools-core":"^7.0.1","rove-weixin":"0.0.4",typescript:"5.8.2",vitest:"2.1.9"},trustedDependencies:[]};var q="rove";var i=q;var z="ROVE_BUN",e="ROVE_NO_BUN_BOOTSTRAP",F="ROVE_SKIP_BUN_CHECK",$=H.engines.bun.match(/\d+\.\d+\.\d+/)?.[0]??"0.0.0",L=(s)=>{try{return R(s,d.X_OK),!0}catch{return!1}},B=(s)=>s==="win32"?"bun.exe":"bun",f=(s)=>{let t=Q(s,["--version"],{encoding:"utf8",timeout:5000});if(t.error||t.status!==0)return null;return t.stdout?.split(`
+import{join as n}from"node:path";import{createInterface as a}from"node:readline/promises";import{pathToFileURL as ss}from"node:url";import{spawnSync as Q}from"node:child_process";import{constants as d,accessSync as R}from"node:fs";import{homedir as I}from"node:os";import{basename as U,delimiter as o,dirname as _,join as k}from"node:path";import{fileURLToPath as T}from"node:url";var H={$schema:"https://json.schemastore.org/package.json",name:"@sma1lboy/rove",version:"0.9.245",description:"Rove — the agent multiplexer for your terminal. Run coding agents on parallel tasks with isolated worktrees and persistent sessions.",keywords:["terminal","tui","cli","multiplexer","ai-agents","coding-agent","ai-coding-assistant","agentic-ai","parallel-agents","git-worktree","claude-code","codex","llm","developer-tools"],type:"module",packageManager:"bun@1.3.13",bin:{rove:"dist/cli/rove.js"},files:["dist/cli","dist/completions","dist/web-ui","dist/skills","dist/*.wav","README.md","LICENSE"],publishConfig:{access:"public"},repository:{type:"git",url:"git+https://github.com/Sma1lboy/rove.git"},homepage:"https://rove.run",bugs:{url:"https://github.com/Sma1lboy/rove/issues"},engines:{bun:">=1.3.11"},scripts:{dev:"ROVE_DEV=1 bun --conditions=browser ./src/cli/rove.ts","dev:mock":"ROVE_DEV=1 bun ./src/tui-react/mock/host.tsx","dev:sandbox":"bun run scripts/dev-sandbox.ts run","dev:sandbox:reset":"bun run scripts/dev-sandbox.ts reset",build:"bun run scripts/build.ts","build:rubric":"bun run scripts/build-tier-rubric.ts",compile:"bun run scripts/compile.ts",typecheck:"tsc --noEmit","check-i18n":"bun run scripts/check-i18n.ts",test:"bun run test:fast && bun run test:socket","perf:golden":"bun scripts/perf-golden.ts","pty:soak":"bun scripts/pty-soak.ts","test:fast":"vitest run --passWithNoTests --minWorkers=1 --maxWorkers=8","test:socket":"ROVE_INCLUDE_SOCKET=1 vitest run test/daemon --pool forks --minWorkers=1 --maxWorkers=4 --passWithNoTests","test:socket:coverage":"ROVE_INCLUDE_SOCKET=1 ROVE_COVERAGE_DAEMON=1 vitest run test/daemon --coverage --pool forks --minWorkers=1 --maxWorkers=4 --passWithNoTests","test:behavior":"ROVE_INCLUDE_BEHAVIOR=1 vitest run test/behavior --pool forks --minWorkers=1 --maxWorkers=1 --retry=2 --passWithNoTests","test:render":"bun scripts/render-track.mjs",coverage:"vitest run --coverage --passWithNoTests",bench:"vitest bench --run",lint:"biome check .",knip:"knip-bun",postinstall:"bun run scripts/check-preview-deps.ts || true",prepublishOnly:"bun run typecheck && bun run build","plugin-sandbox":"bun run scripts/plugin-sandbox.ts"},"//":"biome.json + bunfig.toml live at the monorepo root since they apply repo-wide; bun.lock also lives at root (workspace-shared).",dependencies:{"@ansi-tools/parser":"^1.0.15","@opentui/core":"0.4.3","@opentui/react":"0.4.3","@xterm/addon-serialize":"^0.14.0","@xterm/addon-unicode11":"^0.9.0","@xterm/headless":"^6.0.0","node-pty":"^1.1.0",react:"^19.2.8","smol-toml":"^1.7.1",ws:"^8.21.3"},devDependencies:{"@biomejs/biome":"1.9.4","@sma1lboy/rove-daemon":"0.7.20","@tsconfig/bun":"1.0.11","@types/bun":"1.3.14","@types/node":"25.6.2","@types/react":"^19.2.0","@vitest/coverage-v8":"2.1.9",knip:"^6.14.2","react-devtools-core":"^7.0.1","rove-weixin":"0.0.6",typescript:"5.8.2",vitest:"2.1.9"},trustedDependencies:[]};var q="rove";var i=q;var z="ROVE_BUN",e="ROVE_NO_BUN_BOOTSTRAP",F="ROVE_SKIP_BUN_CHECK",$=H.engines.bun.match(/\d+\.\d+\.\d+/)?.[0]??"0.0.0",L=(s)=>{try{return R(s,d.X_OK),!0}catch{return!1}},B=(s)=>s==="win32"?"bun.exe":"bun",f=(s)=>{let t=Q(s,["--version"],{encoding:"utf8",timeout:5000});if(t.error||t.status!==0)return null;return t.stdout?.split(`
 `)[0]?.trim()??""};function J(s){return s.trim().match(/^v?(\d+\.\d+\.\d+)/)?.[1]??null}function X(s,t=$){let c=J(s),b=J(t);if(!c||!b)return!0;let W=c.split(".").map(Number),g=b.split(".").map(Number);for(let x=0;x<3;x++){let y=W[x]??0,r=g[x]??0;if(y!==r)return y>r}return!0}function Y(s=process.env){return s[F]==="1"}function A(s={}){let t=s.env??process.env,c=s.platform??process.platform,b=s.home??t.HOME??t.USERPROFILE??I(),W=B(c),g=[],x=t[z]?.trim();if(x)g.push(x);for(let G of(t.PATH??t.Path??"").split(o))if(G)g.push(k(G,W));let y=t.BUN_INSTALL?.trim();if(y)g.push(k(y,"bin",W));if(b)g.push(k(b,".bun","bin",W));let r=s.launcherDir;if(r)g.push(k(r,"..","..","node_modules","bun","bin",W)),g.push(k(r,"..","..","..","bun","bin",W));return g}function N(s={}){let t=s.isExecutable??L;return A(s).find((c)=>t(c))??null}function Z(s={}){let t=s.isExecutable??L,c=s.bunVersionOf??f;if(Y(s.env??process.env))return{bun:N(s),stale:null,unusable:null};let b=null,W=null;for(let g of A(s)){if(!t(g))continue;let x=c(g);if(x===null){W??=g;continue}if(X(x))return{bun:g,stale:b,unusable:W};b??={path:g,version:J(x)??x}}return{bun:null,stale:b,unusable:W}}function h(s){return _(T(s))}function C(s){return U(T(s)).replace(/\.[cm]?[jt]s$/,"")}function u(s=process.platform){return s==="win32"?["powershell","-NoProfile","-Command","irm bun.sh/install.ps1 | iex"]:["bash","-c","curl -fsSL https://bun.sh/install | bash"]}function D(s=i,t=process.platform){let c=t==="win32"?'powershell -c "irm bun.sh/install.ps1 | iex"':"curl -fsSL https://bun.sh/install | bash";return[`${s}: Rove runs on the Bun runtime, and no Bun was found on this machine.`,"","Install Bun, then run this command again:",`  ${c}`,"  npm install -g bun          # any platform, if you already have npm","","Or install Bun and Rove together in one step:","  curl -fsSL https://rove.run/install.sh | sh","",`Already have Bun somewhere unusual? Point Rove at it: ${z}=/path/to/bun`,""].join(`
 `)}function j(s,t,c=i){return[`${c}: this machine's Bun is too old for Rove — found ${t} at ${s}, need ${$} or newer.`,"","Rove's terminals are built on Bun's PTY API. An older Bun ignores it silently,","so every terminal and engine tab would open empty and stay empty.","","Upgrade Bun, then run this command again:","  bun upgrade                 # Bun installed itself (~/.bun)","  brew upgrade bun            # Homebrew","  npm install -g bun@latest   # npm-managed Bun","",`Have a newer Bun elsewhere? Point Rove at it: ${z}=/path/to/bun`,`Run on this one anyway (unsupported, terminals will be blank): ${F}=1`,""].join(`
 `)}function v(s,t=i){return[`${t}: the Bun at ${s} could not be run — \`${s} --version\` failed or never returned.`,"","Rove skipped it rather than starting through it, which would hang or fail","with a message from that binary instead of this one.","","Reinstall Bun, then run this command again:","  curl -fsSL https://bun.sh/install | bash","",`Have a working Bun elsewhere? Point Rove at it: ${z}=/path/to/bun`,""].join(`

package/dist/completions/rove.bash

@@ -12,7 +12,7 @@ _rove() {
     fi
     if [[ ${COMP_CWORD} -eq 2 ]]; then
         case "${prev}" in
-            api) COMPREPLY=( $(compgen -W "schema engine-list list get-task pty-list collect context digest agent-turns inspect read-output watch add send dispatch interrupt note note-list note-delete pane-open pane-close pane-graphics tab-close notify prompt engine-report row-token set-active feedback issue-list issue-create issue-set-status issue-update issue-delete routine-list routine-create routine-update routine-set-enabled routine-delete routine-run-now routine-respond routine-runs workitem-list workitem-start rename set-branch set-command set-effort set-model set-status pin land delete ensure-worktree remove-worktree discover-adoptable adopt" -- "${cur}") ) ;;
+            api) COMPREPLY=( $(compgen -W "schema engine-list list get-task pty-list collect context digest agent-turns inspect read-output watch add send dispatch interrupt note note-list note-delete pane-open pane-close pane-graphics tab-close notify prompt engine-report row-token set-active feedback issue-list issue-create issue-update issue-delete routine-list routine-create routine-update routine-delete routine-run-now routine-respond routine-runs workitem-list workitem-start update land delete ensure-worktree remove-worktree discover-adoptable adopt" -- "${cur}") ) ;;
             daemon) COMPREPLY=( $(compgen -W "status start stop restart" -- "${cur}") ) ;;
             machine) COMPREPLY=( $(compgen -W "add remove list" -- "${cur}") ) ;;
             plugin) COMPREPLY=( $(compgen -W "install link list search outdated update enable disable unlink uninstall config-dir log action pane" -- "${cur}") ) ;;

package/dist/completions/rove.fish

@@ -19,7 +19,7 @@ complete -c rove -f -n __fish_use_subcommand -a skill
 complete -c rove -f -n __fish_use_subcommand -a plugin
 complete -c rove -f -n __fish_use_subcommand -a feedback
 complete -c rove -f -n __fish_use_subcommand -a update
-complete -c rove -f -n "__fish_seen_subcommand_from api" -a "schema engine-list list get-task pty-list collect context digest agent-turns inspect read-output watch add send dispatch interrupt note note-list note-delete pane-open pane-close pane-graphics tab-close notify prompt engine-report row-token set-active feedback issue-list issue-create issue-set-status issue-update issue-delete routine-list routine-create routine-update routine-set-enabled routine-delete routine-run-now routine-respond routine-runs workitem-list workitem-start rename set-branch set-command set-effort set-model set-status pin land delete ensure-worktree remove-worktree discover-adoptable adopt"
+complete -c rove -f -n "__fish_seen_subcommand_from api" -a "schema engine-list list get-task pty-list collect context digest agent-turns inspect read-output watch add send dispatch interrupt note note-list note-delete pane-open pane-close pane-graphics tab-close notify prompt engine-report row-token set-active feedback issue-list issue-create issue-update issue-delete routine-list routine-create routine-update routine-delete routine-run-now routine-respond routine-runs workitem-list workitem-start update land delete ensure-worktree remove-worktree discover-adoptable adopt"
 complete -c rove -f -n "__fish_seen_subcommand_from daemon" -a "status start stop restart"
 complete -c rove -f -n "__fish_seen_subcommand_from machine" -a "add remove list"
 complete -c rove -f -n "__fish_seen_subcommand_from plugin" -a "install link list search outdated update enable disable unlink uninstall config-dir log action pane"

package/dist/completions/rove.zsh

@@ -13,7 +13,7 @@ _rove() {
 
     verbs=()
     case "${words[2]}" in
-        api) verbs=("schema" "engine-list" "list" "get-task" "pty-list" "collect" "context" "digest" "agent-turns" "inspect" "read-output" "watch" "add" "send" "dispatch" "interrupt" "note" "note-list" "note-delete" "pane-open" "pane-close" "pane-graphics" "tab-close" "notify" "prompt" "engine-report" "row-token" "set-active" "feedback" "issue-list" "issue-create" "issue-set-status" "issue-update" "issue-delete" "routine-list" "routine-create" "routine-update" "routine-set-enabled" "routine-delete" "routine-run-now" "routine-respond" "routine-runs" "workitem-list" "workitem-start" "rename" "set-branch" "set-command" "set-effort" "set-model" "set-status" "pin" "land" "delete" "ensure-worktree" "remove-worktree" "discover-adoptable" "adopt") ;;
+        api) verbs=("schema" "engine-list" "list" "get-task" "pty-list" "collect" "context" "digest" "agent-turns" "inspect" "read-output" "watch" "add" "send" "dispatch" "interrupt" "note" "note-list" "note-delete" "pane-open" "pane-close" "pane-graphics" "tab-close" "notify" "prompt" "engine-report" "row-token" "set-active" "feedback" "issue-list" "issue-create" "issue-update" "issue-delete" "routine-list" "routine-create" "routine-update" "routine-delete" "routine-run-now" "routine-respond" "routine-runs" "workitem-list" "workitem-start" "update" "land" "delete" "ensure-worktree" "remove-worktree" "discover-adoptable" "adopt") ;;
         daemon) verbs=("status" "start" "stop" "restart") ;;
         machine) verbs=("add" "remove" "list") ;;
         plugin) verbs=("install" "link" "list" "search" "outdated" "update" "enable" "disable" "unlink" "uninstall" "config-dir" "log" "action" "pane") ;;

package/dist/skills/rove/SKILL.md

@@ -3,7 +3,7 @@ name: rove
 description: Use when controlling Rove tasks, parallel coding attempts, hosted agent sessions, task lifecycle, or the daemon-owned issue tracker from a shell. Also the ONLY channel for messaging another agent session on this machine — `rove api send`, never a peer/MCP side channel.
 ---
 
-<!-- rove-skill-version: 54 — bump in lockstep with ROVE_SKILL_VERSION (src/lib/skill-install.ts). -->
+<!-- rove-skill-version: 56 — bump in lockstep with ROVE_SKILL_VERSION (src/lib/skill-install.ts). -->
 
 # Rove shell control
 
@@ -278,8 +278,9 @@ get-task --task-id(REQ)          list  (no flags)
 collect  --group <groupId> | --task-ids <csv> | --repo
 ```
 
-Four names that have actually been guessed wrong here: `add --vendor` is
-`--command`; `read-output --task` is `--task-id`; `dispatch --text` is
+Names that have actually been guessed wrong here: `add --vendor` is
+`--command`; `read-output --task` is `--task-id`; per-field verbs
+(`set-<field>`, `rename`, `pin`) are all `update --<field>`; `dispatch --text` is
 `--prompt` (`--text` belongs to `note`); `issue-list` has no `--state` at all
 — filter its JSON yourself.
 
@@ -348,7 +349,7 @@ rove api send --task-id <id> --tab tab-3 --prompt "<turn>"  # exact alive tab
 rove api send --task-id <id> --tab new --prompt "<turn>"    # fresh engine tab
 # Same worktree, DIFFERENT agent — the API twin of the TUI's ctrl+e pick. The
 # engine is pinned to that tab (survives restarts, unaffected by a later
-# set-command) and the task's own engine is left alone. --tab new only.
+# update --command) and the task's own engine is left alone. --tab new only.
 rove api send --task-id <id> --tab new --command codex --prompt "<turn>"
 
 rove api get-task --task-id <id>
@@ -423,11 +424,7 @@ logs, dashboards), don't scatter panes for work `add` should own.
 
 | Verb | Purpose |
 |---|---|
-| `rename --task-id ID --title T` | Rename a task |
-| `set-branch --task-id ID --branch B` | Rename its branch |
-| `set-command --task-id ID --command CMD` | Change the engine launch command for the next launch |
-| `set-status --task-id ID --status S` | Set the lifecycle LABEL (`backlog`/`in_progress`/`in_review`/`done`/`canceled`/`error`). Cosmetic: the row, its Worktree, its branch and its engine all stay. `canceled` does NOT close or clean up anything |
-| `pin --task-id ID [--pinned=false]` | Pin/unpin |
+| `update --task-id ID [--title T] [--branch B] [--command CMD] [--model M] [--effort L] [--pinned true\|false] [--status S] [--report-branch B --report-pr N --report-summary TEXT]` | Change any combination of fields in one call: validated first, applied branch → command → model/effort → title → pinned → status; not atomic (a mid-way failure reports `applied`). `--command` takes effect on the next launch; `--tab tab-N` with `--title` renames that tab. `--status` sets the lifecycle LABEL (`backlog`/`in_progress`/`in_review`/`done`/`canceled`/`error`) — cosmetic: the row, its Worktree, its branch and its engine all stay, and `canceled` does NOT close or clean up anything. `--report-*` (need `--status`) record what you delivered: `update --task-id "$ROVE_TASK_ID" --status in_review --report-pr N` |
 | `set-active --task-id ID` / `--none` | Change shared active task |
 | `ensure-worktree --task-id ID` | Materialize without starting an engine |
 | `land --task-id ID [--strategy merge\|squash] [--delete-branch] [--remove-worktree=false]` | Merge the task's branch into the base repo's current branch; the Worktree is removed by default (`--remove-worktree=false` keeps it). The branch always stays; dirty/self/base removals are refused, outcome in the result's `worktree` field |
@@ -438,7 +435,7 @@ logs, dashboards), don't scatter panes for work `add` should own.
 ### "Close this task" means `delete`
 
 `delete` is the ONLY verb that ends a task: it removes the row and its
-Worktree, and the git branch survives as the durable record. `set-status
+Worktree, and the git branch survives as the durable record. `update --status
 canceled` is a label — the row, Worktree, branch and engine all stay, so a
 "close" done that way changes nothing the user can see. Reach for `delete`
 whether or not the work merged; an unmerged branch is still on disk
@@ -458,7 +455,7 @@ Issues are daemon-owned, not repo files:
 ```bash
 rove api issue-list --repo "$PWD" --pretty
 rove api issue-create --repo "$PWD" --title "title" --body "context"
-rove api issue-set-status --repo "$PWD" --id <n> --status done
+rove api issue-update --repo "$PWD" --id <n> --status done
 rove api issue-update --repo "$PWD" --id <n> --title "new" --body "body"
 rove api issue-update --repo "$PWD" --id <n> --task <taskId>   # link; `--task none` unlinks
 ```
@@ -467,7 +464,7 @@ rove api issue-update --repo "$PWD" --id <n> --task <taskId>   # link; `--task n
 
 The TUI and web render issues as a Backlog / In progress / Done board whose
 columns derive from the issue's own lifecycle — do NOT move cards with
-`issue-set-status doing`:
+`issue-update --status doing`:
 
 - **In progress** = the issue has a linked task; `issue-update --task <taskId>`
   IS the move (typical flow: `issue-create` → `add` a task → link them).
@@ -569,7 +566,7 @@ party who knows what the work turned out to be. Once the shape is clear,
 rename it to a short descriptive name in this repo's own convention:
 
 ```bash
-rove api set-branch --task-id "$ROVE_TASK_ID" --branch <descriptive-slug>
+rove api update --task-id "$ROVE_TASK_ID" --branch <descriptive-slug>
 ```
 
 Do this while you work, not at the end — the branch name is what the user
@@ -625,7 +622,7 @@ None of these mean a task is finished:
 | the worker said "done" | a message; it has no verb to remove itself |
 | its PR is MERGED | the code landed; the task did not move |
 | its issue is `status done` | a field in a different store |
-| `set-status canceled` | a label — see Lifecycle above |
+| `update --status canceled` | a label — see Lifecycle above |
 
 **The only evidence is that `rove api list` no longer shows it.** Check the
 task, not the paperwork:

package/dist/skills/rove/references/api-flags.md

@@ -50,7 +50,14 @@ Four flag names that have actually been guessed wrong here, and what they are:
 | `fan-out` | `add --count N` / `add --agents claude:2,codex:1` |
 | `task-list` | `list` |
 | `send-tab` | `send --tab tab-N` |
-| `set-vendor` | `set-command` (an engine id from `engine-list`, or a full command line) |
+| `set-vendor` | `update --command` (an engine id from `engine-list`, or a full command line) |
+| `rename` | `update --title` (`update --tab tab-N --title` for a tab) |
+| `set-branch` / `set-command` / `set-model` | `update --branch` / `--command` / `--model` |
+| `set-effort --level` | `update --effort` |
+| `set-status` | `update --status` (+ `--report-*`) |
+| `pin` | `update --pinned true\|false` |
+| `issue-set-status` | `issue-update --status` |
+| `routine-set-enabled` | `routine-update --enabled true\|false` |
 
 Seeing one of these in guidance means that guidance predates the rename —
 `rove api schema` is the tiebreak.
@@ -64,7 +71,7 @@ see both.
 
 <!-- generated:begin read -->
 ```text
-list         (none)
+list         --repo --status <S1,S2> --activity <A1,A2>
 get-task     --task-id(REQ)
 pty-list     (none)
 collect      --task-ids <a,b,c> --group --repo
@@ -72,7 +79,7 @@ context      --repo(REQ) --limit(20) --text
 digest       --repo(REQ) --since-days(7)
 agent-turns  --task-id --repo --since-days(7) --limit(200)
 inspect      --task-id
-read-output  --task-id --tab --source{auto|history|terminal}(auto) --cursor --limit(40)
+read-output  --task-id --tab --source{auto|history|terminal}(auto) --cursor --limit
 watch        --task-ids <a,b,c> --group --until(REQ) <STATE[,STATE]> --timeout
 ```
 <!-- generated:end -->
@@ -86,10 +93,14 @@ the wider diagnostic — daemon activity, a pty walk, and every tab snapshot.
 disagree, it is the ground truth for what is actually alive — key, alive, pid,
 command, OSC title.
 
-`read-output --limit` maxes at 50. `--tab` is terminal-only — it cannot combine
-with `--source history`. The cursor is pinned to one source/session/tab; a
-moved target returns `SOURCE_CHANGED` rather than silently paging something
-else.
+`read-output` opens on the NEWEST page: the last `--limit` messages (history,
+default 40, max 50) or terminal lines (default 40, max 200). Its `cursor` pages
+forward and, once caught up, is the poll point — re-read with it to get only
+what the session wrote since (`watch` tells you when). `olderCursor` pages back
+through history. `--tab tab-N` reads that tab's own conversation when it is an
+engine tab with a pinned session, else its terminal. A cursor is pinned to one
+source/session/tab; a moved target returns `SOURCE_CHANGED` rather than
+silently paging something else.
 
 `digest` and `agent-turns` are the measurement reads — `digest` aggregates a
 repo's recent task + routine activity, `agent-turns` is per-turn telemetry
@@ -164,28 +175,26 @@ clear the shared active task.
 
 <!-- generated:begin create,edit,lifecycle -->
 ```text
-add          --repo(REQ) --title --branch --base-branch --worktree-name --command --effort
-             --tier{swift|standard|deep|auto} --model --count --agents <claude:2,codex:1>
-             --status{backlog|in_progress|in_review|done|canceled|error}(backlog) --pin
-             --activate(false) --prompt|--prompt-file
-rename       --task-id(REQ) --title(REQ) --tab
-set-branch   --task-id(REQ) --branch(REQ)
-set-command  --task-id(REQ) --command(REQ)
-set-effort   --task-id(REQ) --level(REQ)
-set-model    --task-id(REQ) --model(REQ)
-set-status   --task-id(REQ)
-             --status{backlog|in_progress|in_review|done|canceled|error}(REQ)
-             --report-branch --report-pr --report-summary
-pin          --task-id(REQ) --pinned(true)
-land         --task-id(REQ) --dry-run --strategy{merge|squash}(merge) --delete-branch
-             --remove-worktree(true)
-delete       --task-id --group --force --delete-branch --delete-remote --wait
+add     --repo(REQ) --title --branch --base-branch --worktree-name --command --effort
+        --tier{swift|standard|deep|auto} --model --count --agents <claude:2,codex:1>
+        --status{backlog|in_progress|in_review|done|canceled|error}(backlog) --pin
+        --activate(false) --prompt|--prompt-file
+update  --task-id(REQ) --title --tab --branch --command --model --effort --pinned
+        --status{backlog|in_progress|in_review|done|canceled|error} --report-branch
+        --report-pr --report-summary
+land    --task-id(REQ) --dry-run --strategy{merge|squash}(merge) --delete-branch
+        --remove-worktree(true)
+delete  --task-id --group --force --delete-branch --delete-remote --wait
 ```
 <!-- generated:end -->
 
-`set-command` takes effect on the NEXT launch only. `set-effort --level` is
-engine-owned — the levels a vendor accepts come from its registry entry, so
-check `engine-list` rather than guessing.
+`update` takes any mix of its fields in one call. It validates all of them
+before writing anything, then applies branch → command → model/effort →
+title → pinned → status; a refusal mid-way returns `applied` (what already
+landed). `--command`/`--model`/`--effort` take effect on the NEXT launch only.
+Effort levels are engine-owned — the levels a vendor accepts come from its
+registry entry, so check `engine-list` rather than guessing. `--report-*`
+needs `--status`. With `--tab`, only `--title` is allowed.
 
 Task `--status` and issue `--status` are DIFFERENT enums — a task is
 `backlog|in_progress|in_review|done|canceled|error`, an issue is
@@ -214,17 +223,16 @@ adopt               --repo(REQ) --worktree(REQ) --branch --command --title
 
 <!-- generated:begin issues -->
 ```text
-issue-list        --repo(REQ)
-issue-create      --repo(REQ) --title(REQ) --body
-issue-set-status  --repo(REQ) --id(REQ) --status{open|doing|hold|done}(REQ)
-issue-update      --repo(REQ) --id(REQ) --title --body --task
-issue-delete      --repo(REQ) --id(REQ)
+issue-list    --repo(REQ)
+issue-create  --repo(REQ) --title(REQ) --body
+issue-update  --repo(REQ) --id(REQ) --title --body --task --status{open|doing|hold|done}
+issue-delete  --repo(REQ) --id(REQ)
 ```
 <!-- generated:end -->
 
 `--id` is an int, not the ULID a task uses. `issue-update --task <taskId>` is
 the kanban "move to In progress"; `--task none` unlinks. Kanban semantics are
-in SKILL.md — do not move cards with `issue-set-status doing`.
+in SKILL.md — do not move cards with `issue-update --status doing`.
 
 ## workitems (GitHub, through `gh`)
 
@@ -256,19 +264,18 @@ it fires with no TUI attached.
 
 <!-- generated:begin routine -->
 ```text
-routine-list         (none)
-routine-create       --repo(REQ) --name(REQ) --prompt|--prompt-file(REQ) --schedule(REQ)
-                     --vendor{claude|codex|copilot|kimi|pi|omp|bob} --base-branch
-                     --precheck --precheck-timeout(120) --grace(60) --persistent-session
-                     --target-task --target-tab --disabled
-routine-update       --id(REQ) --name --prompt|--prompt-file --schedule --vendor
-                     --base-branch --precheck --precheck-timeout(120) --grace(60)
-                     --persistent-session --target-task --target-tab
-routine-set-enabled  --id(REQ) --enabled(REQ)
-routine-delete       --id(REQ)
-routine-run-now      --id(REQ)
-routine-respond      --run(REQ) --text --prompt-file
-routine-runs         --id(REQ)
+routine-list     (none)
+routine-create   --repo(REQ) --name(REQ) --prompt|--prompt-file(REQ) --schedule(REQ)
+                 --vendor{claude|codex|copilot|kimi|pi|omp|bob} --base-branch --precheck
+                 --precheck-timeout(120) --grace(60) --persistent-session --target-task
+                 --target-tab --disabled
+routine-update   --id(REQ) --name --prompt|--prompt-file --schedule --vendor --base-branch
+                 --precheck --precheck-timeout(120) --grace(60) --persistent-session
+                 --target-task --target-tab --enabled
+routine-delete   --id(REQ)
+routine-run-now  --id(REQ)
+routine-respond  --run(REQ) --text --prompt-file
+routine-runs     --id(REQ)
 ```
 <!-- generated:end -->
 
@@ -292,8 +299,8 @@ the daemon respawns it in the SAME worktree — files and branch carry over, the
 conversation does not — and records that run as `revived`, not `dispatched`.
 
 A bare `--enabled` means true, so pausing a routine is
-`routine-set-enabled --id <id> --enabled=false` (the same `=false` spelling
-`pin --pinned=false` uses).
+`routine-update --id <id> --enabled=false` (the same `=false` spelling
+`update --pinned=false` uses).
 
 `routine-update --schedule` re-anchors the next run. `--precheck ''` clears it.
 `routine-run-now` skips the precheck deliberately (asking for it IS the answer)