@sma1lboy/rove 0.9.252 → 0.9.253

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 V,accessSync as R}from"node:fs";import{homedir as e}from"node:os";import{basename as I,delimiter as U,dirname as o,join as y}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.252",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","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.22","@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-bridge":"0.0.13","rove-weixin":"0.0.13",typescript:"5.8.2",vitest:"2.1.9"},trustedDependencies:[]};var q="rove";var k=q;var z="ROVE_BUN",_="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,V.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 V,accessSync as R}from"node:fs";import{homedir as e}from"node:os";import{basename as I,delimiter as U,dirname as o,join as y}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.253",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","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.22","@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-bridge":"0.0.14","rove-weixin":"0.0.14",typescript:"5.8.2",vitest:"2.1.9"},trustedDependencies:[]};var q="rove";var k=q;var z="ROVE_BUN",_="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,V.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),W=J(t);if(!c||!W)return!0;let b=c.split(".").map(Number),g=W.split(".").map(Number);for(let x=0;x<3;x++){let i=b[x]??0,r=g[x]??0;if(i!==r)return i>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,W=s.home??t.HOME??t.USERPROFILE??e(),b=B(c),g=[],x=t[z]?.trim();if(x)g.push(x);for(let G of(t.PATH??t.Path??"").split(U))if(G)g.push(y(G,b));let i=t.BUN_INSTALL?.trim();if(i)g.push(y(i,"bin",b));if(W)g.push(y(W,".bun","bin",b));let r=s.launcherDir;if(r)g.push(y(r,"..","..","node_modules","bun","bin",b)),g.push(y(r,"..","..","..","bun","bin",b));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 W=null,b=null;for(let g of A(s)){if(!t(g))continue;let x=c(g);if(x===null){b??=g;continue}if(X(x))return{bun:g,stale:W,unusable:b};W??={path:g,version:J(x)??x}}return{bun:null,stale:W,unusable:b}}function h(s){return o(T(s))}function C(s){return I(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=k,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=k){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=k){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 tab-new tab-split 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}") ) ;;
+            api) COMPREPLY=( $(compgen -W "schema engine-list list get-task pty-list collect context digest agent-turns inspect read-output watch deliveries add send dispatch interrupt note note-list note-delete pane-open pane-close pane-graphics tab-close tab-new tab-split notify prompt engine-report row-token set-active report gate-raise gate-answer gate-withdraw gates 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 doctor 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 tab-new tab-split 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 api" -a "schema engine-list list get-task pty-list collect context digest agent-turns inspect read-output watch deliveries add send dispatch interrupt note note-list note-delete pane-open pane-close pane-graphics tab-close tab-new tab-split notify prompt engine-report row-token set-active report gate-raise gate-answer gate-withdraw gates 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 doctor 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" "tab-new" "tab-split" "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") ;;
+        api) verbs=("schema" "engine-list" "list" "get-task" "pty-list" "collect" "context" "digest" "agent-turns" "inspect" "read-output" "watch" "deliveries" "add" "send" "dispatch" "interrupt" "note" "note-list" "note-delete" "pane-open" "pane-close" "pane-graphics" "tab-close" "tab-new" "tab-split" "notify" "prompt" "engine-report" "row-token" "set-active" "report" "gate-raise" "gate-answer" "gate-withdraw" "gates" "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" "doctor" "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: 61 — bump in lockstep with ROVE_SKILL_VERSION (src/lib/skill-install.ts). -->
+<!-- rove-skill-version: 63 — bump in lockstep with ROVE_SKILL_VERSION (src/lib/skill-install.ts). -->
 
 # Rove shell control
 
@@ -273,7 +273,7 @@ turn either. These five carry almost all traffic:
 
 ```text
 add      --repo(REQ) --prompt --title --command --count --agents --activate
-send     --prompt|--prompt-file(REQ) --task-id --tab --command --plain
+send     --prompt|--prompt-file(REQ) --task-id --tab --command --plain --expect-report
 get-task --task-id(REQ)          list  (no flags)
 collect  --group <groupId> | --task-ids <csv> | --repo
 ```
@@ -294,6 +294,7 @@ Find your section by what you were ASKED, not by Rove's noun for it:
 | track work in Rove's own backlog, move a kanban card | issues |
 | remember this for the repo, leave a field note / 记一笔 | drive |
 | what did the agent do, per-turn cost, read its screen | read |
+| a prompt ends `[ROVE] … report with: rove api report`; tick a task unattended and want proof it reported | drive (`report`, `send --expect-report`) / read (`deliveries`) |
 | make / rename / retarget / land / close a task | create / edit / lifecycle |
 | materialize or adopt a checkout | worktree |
 | which engines exist, send Rove product feedback | discover / feedback |
@@ -420,6 +421,17 @@ below the minimum usable size (20×6 cells) falls back to a tab.
 Panes land in the USER'S live workspace — open them when asked (monitors,
 logs, dashboards), don't scatter panes for work `add` should own.
 
+## Asking the owner (decision gates)
+
+A question only the owner can answer goes through a gate, not a MEMO line or the tail of a long report. Raise it, then stop and wait; the answer is pasted back into your tab as `[ROVE GATE g-N answered] …`.
+
+| Verb | Purpose |
+|---|---|
+| `gate-raise --task-id "$ROVE_TASK_ID" --question TEXT [--option KEY=LABEL]… [--recommend KEY] [--context TEXT]` | Open a decision gate (≤ 6 options, empty = free text). It shows in the owner's Inbox as `decision_needed`; `--tab` defaults to the tab you run in |
+| `gate-answer --gate g-N [--option KEY] [--text TEXT]` | Answer a gate (owner/coordinator). Saved first, then pasted into the gate's tab; no live engine → `delivered:false`, and the next `send`/routine into that tab carries it |
+| `gate-withdraw --gate g-N` | Drop a question that went moot |
+| `gates [--repo PATH] [--task-id ID] [--status open\|answered\|withdrawn\|all]` | List gates (default open); `context` also carries the repo's open gates |
+
 ## Lifecycle
 
 | Verb | Purpose |
@@ -609,6 +621,42 @@ worker died (it may be mid-turn or stuck on a permission prompt): peek with
 `collect`/`get-task`, nudge with `send`, and never mark a silent task failed
 or auto-retry it.
 
+### Reports: close a delivered prompt with `report`
+
+A completion `send` is a message. For work that runs unattended — a routine,
+a standing session, a scheduler ticking a task — Rove can also ask for a
+**report** and notice when it never comes.
+
+**Receiving side.** A prompt that ends with `[ROVE] When this turn ends,
+report: rove api report --delivery d-<n> …` (or opens with a
+`[ROVE ROUTINE] … report with: rove api report --delivery d-<n> …` line)
+is an armed delivery. Make `report` the LAST step of the turn, before you
+stop:
+
+```bash
+rove api report --delivery d-41 --outcome done \
+  --summary "<what you did, conclusion first>" \
+  --evidence "<commit, PR url, test result, path>" --evidence "…" \
+  --next "<what the next tick should do>"
+```
+
+`--outcome` is `done`, `partial`, `blocked` (you need the owner or an
+outside fix) or `failed` (you tried and could not). A turn that ends with no
+report is flagged `report_missing` in the owner's Inbox, and the delivery is
+marked `missing`. Reporting again replaces the report; a late report clears
+the flag. For text with quotes or backticks use `--json -` (stdin) with
+`{delivery, outcome, summary, evidence?, next?}`. `routine-respond` is the
+same report as `--outcome done`.
+
+**Sending side.** Arm the prompt you send: `rove api send --expect-report
+…` (the reply carries `deliveryId`), or set it once with
+`add --require-report` / `update --require-report on` so every `send` to that
+task is armed. Read what recent ticks did with `rove api deliveries
+--task-id <id> --limit 5` (newest first: outcome, summary, evidence, next,
+or why it went missing) instead of a growing notes file. Silence still never
+proves a worker is dead — `missing` says the turn ended or the engine died
+without a report; look before you act on it.
+
 ### A task is finished when it is GONE
 
 The dispatcher closes tasks. A worker cannot delete itself, so when it reports

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

@@ -81,6 +81,8 @@ 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
 watch        --task-ids <a,b,c> --group --until(REQ) <STATE[,STATE]> --timeout
+deliveries   --task-id(REQ) --limit
+gates        --repo --task-id --status{open|answered|withdrawn|all}(open)
 ```
 <!-- generated:end -->
 
@@ -89,6 +91,12 @@ watch        --task-ids <a,b,c> --group --until(REQ) <STATE[,STATE]> --timeout
 (what `add --count` returned), a `--task-ids` csv, or a `--repo`; `inspect` is
 the wider diagnostic — daemon activity, a pty walk, and every tab snapshot.
 
+`deliveries --task-id` is the task's report log, newest first: for each armed
+prompt its `status` (`awaiting`, `reported`, `missing`), the report
+(`outcome`, `summary`, `evidence`, `next`) or why it went missing (`cause`,
+`note`). A loop that wakes a task reads `deliveries --limit 5` for what the
+last ticks did, instead of a growing notes file.
+
 `pty-list` is what `NO_ENGINE_TAB`'s hint points at: when `.tabs[]` and reality
 disagree, it is the ground truth for what is actually alive — key, alive, pid,
 command, OSC title.
@@ -112,7 +120,7 @@ needs numbers, not when you want to know what a task is doing.
 <!-- generated:begin drive -->
 ```text
 send           --task-id --prompt|--prompt-file(REQ) --tab --command --respawn --plain
-               --allow-empty
+               --allow-empty --expect-report
 dispatch       --task-id(REQ) --prompt|--prompt-file(REQ) --tab
 interrupt      --task-id(REQ) --tab
 note           --task-id(REQ) --text(REQ)
@@ -124,7 +132,7 @@ pane-close     --task-id --title(REQ) --tab
 pane-graphics  --task-id --tab(REQ) --image-id
 tab-close      --task-id(REQ) --tab(REQ)
 tab-new        --task-id(REQ) --kind{shell|engine|editor|pane|viewport}(REQ) --command
-               --file --pane --tab --view-task
+               --file --line --pane --tab --view-task
 tab-split      --task-id(REQ) --tab(REQ) --action{open|close|rename|reset}(REQ)
                --direction{right|down}(right) --leaf --title --cols --rows
 notify         --title(REQ) --body --kind(done) --task-id --source
@@ -135,6 +143,11 @@ engine-report  --task-id
 row-token      --task-id(REQ) --text --ttl(60) --key(default)
                --tone{info|success|warning|error|muted} --clear
 set-active     --task-id --none
+report         --delivery --outcome{done|partial|blocked|failed} --summary --evidence
+               --next --json
+gate-raise     --task-id(REQ) --tab --question(REQ) --option --recommend --context
+gate-answer    --gate(REQ) --option --text
+gate-withdraw  --gate(REQ)
 ```
 <!-- generated:end -->
 
@@ -153,6 +166,19 @@ a resolved gotcha; an issue is for work that still needs doing.
 that legitimately produced no commits (an investigation, a review, a question
 answered); without it such a report is refused with `EMPTY_SUCCESS_REPORT`.
 
+**`send --expect-report` asks for a report.** The reply carries `deliveryId`
+(`d-<n>`) and the pasted prompt ends with a `[ROVE] When this turn ends,
+report: rove api report --delivery d-<n> …` line. A task added with
+`add --require-report` (or `update --require-report on`) arms every `send`
+to it. When YOU receive a prompt with that line, finish the turn with
+`report --delivery d-<n> --outcome done|partial|blocked|failed --summary "…"`
+(repeat `--evidence` for commits, PR urls, test results, paths; `--next` for
+what the next tick should do; `--json -` for text with quotes). Run it as the
+last step, before you stop. A turn that ends without it raises a
+`report_missing` Inbox row for the owner. Reporting again replaces the
+report; a late one clears the flag. `outcome` is `blocked` when you need the
+owner, `failed` when you tried and could not. Summary max 32,000 characters.
+
 `notify --kind` styles the toast: `done`, `needs_input`, `error` get severity
 treatment and an unread mark, anything else renders neutrally.
 
@@ -182,8 +208,9 @@ clear the shared active task.
 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
+        --require-report --expect-report --activate(false) --prompt|--prompt-file
 update  --task-id(REQ) --title --tab --branch --command --model --effort --pinned
+        --require-report{on|off}
         --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
@@ -313,10 +340,13 @@ and does not shift the schedule. `routine-delete` leaves already-created tasks
 alone.
 
 A delivered routine prompt starts with `[ROVE ROUTINE] "<name>" run #<n> — when
-done, report with: … routine-respond --run <runId> --prompt-file -`. When you
-received one, finish by answering THAT run: lead with the conclusion, markdown
-welcome, 32,000 characters max. Responding again replaces the answer. Nothing
-is inferred if you skip it; the run just shows "no response".
+done, report with: … rove api report --delivery d-<n> …`. When you received
+one, finish by reporting THAT delivery (`report --outcome done|partial|blocked|failed
+--summary …`): lead with the conclusion, markdown welcome, 32,000 characters
+max. Reporting again replaces the answer. `routine-respond --run <runId>
+--text …` still works; it is `report --outcome done` on the same delivery.
+Nothing is inferred if you skip it; the run shows "no response" and the
+delivery goes `missing`.
 
 Run statuses from `routine-runs`: `dispatched`, `revived` (standing session
 respawned — files kept, conversation did not), `skipped_precheck` (nothing to do),
@@ -350,6 +380,7 @@ Errors go to stderr as `{"error":{"message","code",...}}`. Most carry `hint`
 |---|---|---|
 | `BAD_FLAG` | flag not on that verb | check the table above, then `schema --verb <v>` |
 | `TASK_NOT_FOUND` | id deleted or mistyped | `rove api list` |
+| `DELIVERY_NOT_FOUND` | `report --delivery` names no delivery | copy the id from the prompt's `[ROVE]` line; `deliveries --task-id <id>` |
 | `DIRTY_WORKTREE` | `delete` on a worktree with uncommitted files | send the worker back to commit, or `delete --force` to discard |
 | `ISSUE_NOT_FOUND` | no issue with that number in this repo | `rove api issue-list --repo <path>` |
 | `NO_ENGINE_TAB` | live tabs exist, none is an engine | `--tab tab-N` from `pty-list`, or `--tab new` |