docs(tui): say what Alt-V opens with nothing selected

CW-7087. docs/KEYBINDINGS.md (and the Chinese copy) promised that Alt-V
with nothing selected opens "the live inspector of the newest running
shell". f7264f7d72 removed that rule, so the docs and the code disagreed.
They now describe the current rule (newest visible error, else the first
visible card with details, else the most recent one) and say that
clicking a card keeps Alt-V on it while newer cards arrive, which the
2026-10-18 reproduction confirmed. Whether that default should change is
recorded on CW-7087.

Also corrects the detect_tool_runs doc comment, which said successful
command cells can group. Command and MCP cells are collapse guards
(ToolCell::is_collapsible_guard), so shell cards never group.

web/data/agent-docs.generated.json is regenerated because it embeds
KEYBINDINGS.md.

Verified: web check-facts OK and check-docs OK after npm run prebuild;
cargo fmt --check clean. Documentation and comment changes only.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Claude-Session: https://claude.ai/code/session_01NBKbhx19BRbZtvWK8rVKjz

crates/tui/src/tui/history/tool_run.rs

@@ -52,11 +52,10 @@ impl ToolRunActivitySummary {
 
 /// Detect contiguous runs of successful, low-risk tool cells.
 ///
-/// Failed, running, patch, review, diff, and plan-update cells split runs so
-/// important state never disappears into a summary row. Successful command
-/// cells can join dense runs; `v` / expansion keeps their raw details
-/// available without making routine verifier/shell work dominate the default
-/// transcript.
+/// Failed, running, command, MCP, patch, review, diff, and plan-update cells
+/// split runs so important state never disappears into a summary row
+/// (`ToolCell::is_collapsible_guard`); `v` / expansion keeps the grouped
+/// cells' raw details available.
 #[cfg(test)]
 pub fn detect_tool_runs(history: &[HistoryCell], min_size: usize) -> Vec<ToolRun> {
     detect_tool_runs_from_slices(history, &[], min_size)

docs/KEYBINDINGS.md

@@ -25,7 +25,7 @@ Global key chords are not yet user-configurable — tracked for a future release
 | `Ctrl-L`             | Compact the conversation context (status line shows progress; no-op while a compaction is already running) |
 | `Ctrl-O`             | Open the reasoning detail for the selected or current turn, regardless of composer contents |
 | `Ctrl-Alt-O`         | Open the whole-turn Turn Inspector, regardless of composer contents |
-| `Alt-V` / `Option-V` (macOS) | Open the details pager for the selected tool/sub-agent card; with nothing selected, the live inspector of the newest running shell, else the visible or most recent card; terminals that emit the legacy Option-V glyph are also handled |
+| `Alt-V` / `Option-V` (macOS) | Open the details pager for the selected tool/sub-agent card; with nothing selected, the newest visible error, else the first visible card with details, else the most recent one. Click a card first to keep Alt-V on it while newer cards arrive. Terminals that emit the legacy Option-V glyph are also handled |
 | `Ctrl-Shift-E` / `Cmd-Shift-E` | Toggle the file tree in the workbar                   |
 | `Ctrl-]` or `Ctrl-Tab` | Cycle the pet view while the pet main view is showing; otherwise cycle the work dock: TODO → Agents → Jobs → Background. `Ctrl-]` is portable; `Ctrl-Tab` requires the kitty keyboard protocol. Terminal.app uses it to switch terminal tabs |
 | `Ctrl-Shift-Tab`     | Cycle the pet view or work dock backwards where the terminal sends the kitty keyboard chord. Terminal.app uses it to switch terminal tabs |

docs/zh_hans/KEYBINDINGS.md

@@ -27,7 +27,7 @@
 | `Ctrl-L` | 压缩对话上下文（状态行显示进度；压缩已在运行时不执行任何操作） |
 | `Ctrl-O` | 打开所选或当前回合的思考详情，与输入框内容无关 |
 | `Ctrl-Alt-O` | 打开整个回合的 Turn Inspector，与输入框内容无关 |
-| `Alt-V` / `Option-V`（macOS） | 为所选的工具/智能体卡片打开详情分页器；未选择时，打开最新正在运行的 shell 的实时检查器，否则打开可见或最近的卡片；发出传统 Option-V 字符的终端也会被处理 |
+| `Alt-V` / `Option-V`（macOS） | 为所选的工具/智能体卡片打开详情分页器；未选择时，打开最新的可见错误，否则打开第一个有详情的可见卡片，再否则打开最近的一张。先点击某张卡片，新卡片出现时 Alt-V 仍会停留在它上面。发出传统 Option-V 字符的终端也会被处理 |
 | `Ctrl-Shift-E` / `Cmd-Shift-E` | 在任务面板（workbar）中切换文件树 |
 | `Ctrl-]` 或 `Ctrl-Tab` | Pet 主视图显示时循环切换 Pet 视图；其他时候循环切换 work dock：TODO → Agents → Jobs → Background。`Ctrl-]` 可移植；`Ctrl-Tab` 需要 kitty 键盘协议。Terminal.app 用它切换终端标签页 |
 | `Ctrl-Shift-Tab` | 终端能发送 kitty 键盘组合键时，反向循环切换 Pet 视图或 work dock。Terminal.app 用它切换终端标签页 |

web/data/agent-docs.generated.json

@@ -21,8 +21,8 @@
       },
       {
         "path": "docs/KEYBINDINGS.md",
-        "sha256": "eff02d51baae0e1f51a55df9c79a7d1571cb3cd809ba6a6fb0d95afa8d9f36d4",
-        "content": "# Keybindings\n\n> 阅读简体中文版：[zh_hans/KEYBINDINGS.md](zh_hans/KEYBINDINGS.md)\n\nThis is the source-of-truth catalog of every keyboard shortcut the TUI recognizes. Bindings are grouped by **context** — the focus or modal state they fire in. A binding listed under \"Composer\" only takes effect when the composer is focused; one under \"Transcript\" only when the transcript has focus; and so on.\n\nGlobal key chords are not yet user-configurable — tracked for a future release (#436, #437). Hotbar slot actions are configurable with `[[hotbar]]` and `/hotbar`; the Hotbar activation chord remains `Alt-1` through `Alt-8`.\n\n## Global (any context)\n\n| Chord                | Action                                                        |\n|----------------------|---------------------------------------------------------------|\n| `/help`, `F1` or `Ctrl-/` | Toggle the help overlay. `/help` is what the chrome advertises: it is the one route every terminal delivers, where `F1` is eaten by tmux and some emulators and `Ctrl-/` encoding varies |\n| `F2`                 | Toggle the typed Settings editor                              |\n| `F3`                 | Open the provider/model picker (same as `/provider`)          |\n| `Ctrl-K`             | Open the command palette (slash-command finder)                |\n| `Ctrl-C`             | Cancel current turn / dismiss modal / arm-then-confirm quit    |\n| `Ctrl-B`             | Release the current shell wait so the turn can continue; foreground commands move into `/jobs`, and background tasks keep running. Use `/jobs` or `Bash` with `action: \"wait\"` to inspect output |\n| `Ctrl-D`             | Quit (only when the composer is empty)                         |\n| `Tab`                | When the composer is empty, cycle TUI mode: Plan → Work → Operate → Plan |\n| `Shift+Tab`          | Cycle permission posture: Ask → Auto-Review → Full Access. Live regardless of composer contents or whether a turn is running (suppressed only while a modal other than Config is open) |\n| `Ctrl-T`             | Cycle reasoning effort for the active model. Walks the same ladder as `/model` and `/effort` (catalog or documented route dialect). Always-thinking models omit `off`; Grok 4.6 includes `xhigh`. |\n| `Ctrl-Shift-T`       | Toggle live transcript overlay (sticky-tail auto-scroll)                       |\n| `Ctrl-R`             | Open the resume-session picker                                 |\n| `Ctrl-L`             | Compact the conversation context (status line shows progress; no-op while a compaction is already running) |\n| `Ctrl-O`             | Open the reasoning detail for the selected or current turn, regardless of composer contents |\n| `Ctrl-Alt-O`         | Open the whole-turn Turn Inspector, regardless of composer contents |\n| `Alt-V` / `Option-V` (macOS) | Open the details pager for the selected tool/sub-agent card; with nothing selected, the live inspector of the newest running shell, else the visible or most recent card; terminals that emit the legacy Option-V glyph are also handled |\n| `Ctrl-Shift-E` / `Cmd-Shift-E` | Toggle the file tree in the workbar                   |\n| `Ctrl-]` or `Ctrl-Tab` | Cycle the pet view while the pet main view is showing; otherwise cycle the work dock: TODO → Agents → Jobs → Background. `Ctrl-]` is portable; `Ctrl-Tab` requires the kitty keyboard protocol. Terminal.app uses it to switch terminal tabs |\n| `Ctrl-Shift-Tab`     | Cycle the pet view or work dock backwards where the terminal sends the kitty keyboard chord. Terminal.app uses it to switch terminal tabs |\n| `Alt-G` / `Alt-Shift-G` | Scroll transcript to top / bottom when the composer is empty |\n| `Alt-1`-`Alt-8`      | Dispatch Hotbar slots 1-8 when no modal or inline picker is open |\n| `Alt-!` / `Alt-@` / `Alt-#` / `Alt-$` | Select the workbar panel: Tasks / Agents / Context / Files |\n| `Ctrl-Alt-0`         | Toggle the workbar off / back to the bottom placement          |\n| `Alt-L`              | Open the pager for the last message (composer empty)             |\n| `Alt-P` / `Alt-A` / `Alt-Y` | Jump to Plan / Work, or request Full Access (`Alt-Y` is the legacy permission channel — Work + Full Access — not a separate mode; it honors a locked approval policy) |\n| `Ctrl-X` (Activity workbar) | Cancel all running background shell jobs                  |\n| `Esc`                | Close topmost modal · cancel slash menu · dismiss toast. During a compact that is serving an in-flight turn, Esc stops the turn (the compact is collateral). |\n\n## Composer\n\nEditing the message you're about to send.\n\n| Chord                       | Action                                                  |\n|-----------------------------|---------------------------------------------------------|\n| `Enter`                     | Send when idle; queue while busy; with an empty composer, send the next queued follow-up now |\n| `Shift-ELine truncated
+        "sha256": "4fa7172b61c15ddd4e4adc3da8d3bdb59fce2ff72e493937191f6c9d0a063464",
+        "content": "# Keybindings\n\n> 阅读简体中文版：[zh_hans/KEYBINDINGS.md](zh_hans/KEYBINDINGS.md)\n\nThis is the source-of-truth catalog of every keyboard shortcut the TUI recognizes. Bindings are grouped by **context** — the focus or modal state they fire in. A binding listed under \"Composer\" only takes effect when the composer is focused; one under \"Transcript\" only when the transcript has focus; and so on.\n\nGlobal key chords are not yet user-configurable — tracked for a future release (#436, #437). Hotbar slot actions are configurable with `[[hotbar]]` and `/hotbar`; the Hotbar activation chord remains `Alt-1` through `Alt-8`.\n\n## Global (any context)\n\n| Chord                | Action                                                        |\n|----------------------|---------------------------------------------------------------|\n| `/help`, `F1` or `Ctrl-/` | Toggle the help overlay. `/help` is what the chrome advertises: it is the one route every terminal delivers, where `F1` is eaten by tmux and some emulators and `Ctrl-/` encoding varies |\n| `F2`                 | Toggle the typed Settings editor                              |\n| `F3`                 | Open the provider/model picker (same as `/provider`)          |\n| `Ctrl-K`             | Open the command palette (slash-command finder)                |\n| `Ctrl-C`             | Cancel current turn / dismiss modal / arm-then-confirm quit    |\n| `Ctrl-B`             | Release the current shell wait so the turn can continue; foreground commands move into `/jobs`, and background tasks keep running. Use `/jobs` or `Bash` with `action: \"wait\"` to inspect output |\n| `Ctrl-D`             | Quit (only when the composer is empty)                         |\n| `Tab`                | When the composer is empty, cycle TUI mode: Plan → Work → Operate → Plan |\n| `Shift+Tab`          | Cycle permission posture: Ask → Auto-Review → Full Access. Live regardless of composer contents or whether a turn is running (suppressed only while a modal other than Config is open) |\n| `Ctrl-T`             | Cycle reasoning effort for the active model. Walks the same ladder as `/model` and `/effort` (catalog or documented route dialect). Always-thinking models omit `off`; Grok 4.6 includes `xhigh`. |\n| `Ctrl-Shift-T`       | Toggle live transcript overlay (sticky-tail auto-scroll)                       |\n| `Ctrl-R`             | Open the resume-session picker                                 |\n| `Ctrl-L`             | Compact the conversation context (status line shows progress; no-op while a compaction is already running) |\n| `Ctrl-O`             | Open the reasoning detail for the selected or current turn, regardless of composer contents |\n| `Ctrl-Alt-O`         | Open the whole-turn Turn Inspector, regardless of composer contents |\n| `Alt-V` / `Option-V` (macOS) | Open the details pager for the selected tool/sub-agent card; with nothing selected, the newest visible error, else the first visible card with details, else the most recent one. Click a card first to keep Alt-V on it while newer cards arrive. Terminals that emit the legacy Option-V glyph are also handled |\n| `Ctrl-Shift-E` / `Cmd-Shift-E` | Toggle the file tree in the workbar                   |\n| `Ctrl-]` or `Ctrl-Tab` | Cycle the pet view while the pet main view is showing; otherwise cycle the work dock: TODO → Agents → Jobs → Background. `Ctrl-]` is portable; `Ctrl-Tab` requires the kitty keyboard protocol. Terminal.app uses it to switch terminal tabs |\n| `Ctrl-Shift-Tab`     | Cycle the pet view or work dock backwards where the terminal sends the kitty keyboard chord. Terminal.app uses it to switch terminal tabs |\n| `Alt-G` / `Alt-Shift-G` | Scroll transcript to top / bottom when the composer is empty |\n| `Alt-1`-`Alt-8`      | Dispatch Hotbar slots 1-8 when no modal or inline picker is open |\n| `Alt-!` / `Alt-@` / `Alt-#` / `Alt-$` | Select the workbar panel: Tasks / Agents / Context / Files |\n| `Ctrl-Alt-0`         | Toggle the workbar off / back to the bottom placement          |\n| `Alt-L`              | Open the pager for the last message (composer empty)             |\n| `Alt-P` / `Alt-A` / `Alt-Y` | Jump to Plan / Work, or request Full Access (`Alt-Y` is the legacy permission channel — Work + Full Access — not a separate mode; it honors a locked approval policy) |\n| `Ctrl-X` (Activity workbar) | Cancel all running background shell jobs                  |\n| `Esc`                | Close topmost modal · cancel slash menu · dismiss toast. During a compact that is serving an in-flight turn, Esc stops the turn (the compact is collateral). |\n\n## Composer\n\nEditing the message you're about to send.\n\n| Chord                       | Action                                                  |\n|-----------------------------|---------------------------------------------------------|\n| `Enter`                     | Send when idle; queue while busy;Line truncated
       }
     ]
   },