move-panel-shortcut — WorksGood live mirror

Metadata

Status	done
Assigned	`agent-901`
Agent identity	`8b579312a7ee512b4a8484518eff16ecdb36de1c9cf52fdb5e7f566586fa5d18`
Created	2026-07-26T10:30:44.128123095+00:00
Started	2026-07-26T21:02:02.340805592+00:00
Completed	2026-07-26T21:34:34.884284267+00:00
Tokens	10776653 in / 30124 out

Description

User-visible bugs

The existing Help content is good and should be preserved, but its interaction model is broken:

The task bar persistently advertises Ctrl+O→p Panel, which is visually garish. Remove that hint from the task bar and keep the shortcut in Help.
When Help opens, it does not acquire modal input/focus correctly. Mouse wheel/trackpad scrolling, touch-derived scroll events, PageUp/PageDown, Up/Down arrows, Home/End, and pointer interaction do not scroll its content.
Clicking outside the Help surface does not dismiss it. Escape is effectively the only exit.

Required behavior

Clicking the visible question-mark control or using the keyboard Help shortcut opens the same scrollable Help overlay/view. Preserve the existing high-quality shortcut content; reorganize only as needed for interaction and first-viewport essentials.
Help acquires modal focus/input ownership while open. Supported keyboard navigation and terminal mouse/trackpad wheel events scroll Help—not the underlying task list/panel.
PageUp/PageDown and Up/Down work; Home/End jump predictably; scrolling clamps at boundaries and exposes a visible position/scroll affordance where consistent with the TUI.
A click inside Help interacts only with Help. A click outside its bounds dismisses Help and must not leak through to activate/change the underlying target. Escape also dismisses it.
On dismissal, restore focus, task selection, panel state, and prior scroll position exactly. Resizing while open remains legible and clamps scroll safely.
The first viewport immediately shows essential navigation, including Panel access (Ctrl+O, then p), move/activate/close, and Help scrolling controls; advanced combinations remain below the fold.
Task bar remains clean at wide and narrow widths with no replacement clutter.
Shortcut labels and behavior match authoritative key bindings where feasible.

Validation

Live main-branch tmux/PTY reproducer demonstrates: persistent Panel hint; Help wheel/PageUp/arrows do not scroll; outside click does not close.
Real TUI flow clicks the actual question-mark hit target and proves Help receives modal focus.
Driven Up/Down, PageUp/PageDown, Home/End, mouse wheel, and trackpad-equivalent terminal events visibly move through below-fold content and clamp correctly.
Real outside click dismisses Help without changing the underlying task selection/view; inside clicks do not leak through; Escape remains supported.
Close restores prior focus/selection/panel/scroll state, including after a resize.
Representative narrow/wide snapshots prove the task-bar hint is absent and first-viewport Help remains legible.
Add a permanent real human-flow scenario under tests/smoke/scenarios/ and grow-only owner entry in tests/smoke/manifest.toml; use tmux/PTY mouse sequences and wg tui-dump/screenshots as evidence.
Focused tests, cargo fmt --check, cargo clippy, and build pass.

## User-visible bugs
The existing Help content is good and should be preserved, but its interaction model is broken:

1. The task bar persistently advertises `Ctrl+O→p Panel`, which is visually garish. Remove that hint from the task bar and keep the shortcut in Help.
2. When Help opens, it does not acquire modal input/focus correctly. Mouse wheel/trackpad scrolling, touch-derived scroll events, PageUp/PageDown, Up/Down arrows, Home/End, and pointer interaction do not scroll its content.
3. Clicking outside the Help surface does not dismiss it. Escape is effectively the only exit.

## Required behavior
- Clicking the visible question-mark control or using the keyboard Help shortcut opens the same scrollable Help overlay/view. Preserve the existing high-quality shortcut content; reorganize only as needed for interaction and first-viewport essentials.
- Help acquires modal focus/input ownership while open. Supported keyboard navigation and terminal mouse/trackpad wheel events scroll Help—not the underlying task list/panel.
- PageUp/PageDown and Up/Down work; Home/End jump predictably; scrolling clamps at boundaries and exposes a visible position/scroll affordance where consistent with the TUI.
- A click inside Help interacts only with Help. A click outside its bounds dismisses Help and must not leak through to activate/change the underlying target. Escape also dismisses it.
- On dismissal, restore focus, task selection, panel state, and prior scroll position exactly. Resizing while open remains legible and clamps scroll safely.
- The first viewport immediately shows essential navigation, including Panel access (`Ctrl+O`, then `p`), move/activate/close, and Help scrolling controls; advanced combinations remain below the fold.
- Task bar remains clean at wide and narrow widths with no replacement clutter.
- Shortcut labels and behavior match authoritative key bindings where feasible.

## Validation
- [ ] Live main-branch tmux/PTY reproducer demonstrates: persistent Panel hint; Help wheel/PageUp/arrows do not scroll; outside click does not close.
- [ ] Real TUI flow clicks the actual question-mark hit target and proves Help receives modal focus.
- [ ] Driven Up/Down, PageUp/PageDown, Home/End, mouse wheel, and trackpad-equivalent terminal events visibly move through below-fold content and clamp correctly.
- [ ] Real outside click dismisses Help without changing the underlying task selection/view; inside clicks do not leak through; Escape remains supported.
- [ ] Close restores prior focus/selection/panel/scroll state, including after a resize.
- [ ] Representative narrow/wide snapshots prove the task-bar hint is absent and first-viewport Help remains legible.
- [ ] Add a permanent real human-flow scenario under `tests/smoke/scenarios/` and grow-only owner entry in `tests/smoke/manifest.toml`; use tmux/PTY mouse sequences and `wg tui-dump`/screenshots as evidence.
- [ ] Focused tests, `cargo fmt --check`, `cargo clippy`, and build pass.

Depends on

Required by

done prototype-clearer-tui

✉ Messages 2 messages (2 unread)

#1user2026-07-26T10:31:45.758957988+00:00delivered

User clarified that Help content itself is already good. Preserve it; the primary bugs are modal focus/input ownership, wheel/trackpad/touch + keyboard scrolling, outside-click dismissal without click-through, Escape fallback, and exact focus/selection restoration.

#2move-panel-shortcut2026-07-26T21:02:09.654960637+00:00read

Acknowledged — I will preserve the existing Help content and focus on modal ownership, complete keyboard/wheel scrolling, outside-click dismissal without click-through, Escape, and exact state restoration.

Log

2026-07-26T16:44:18.473647503+00:00 Spawn failed (attempt 2/5): spawn transaction for agent-894 rolled back (task remains dispatchable; rollback diagnostics: task claim: refused to roll back task 'move-panel-shortcut' because claim ownership changed from agent-894). exec_mode=default, executor=pi
2026-07-26T16:44:21.231104838+00:00 Reconciliation: stale-claim cleared (was Open, agent: agent-894)
2026-07-26T16:44:22.922512588+00:00 Spawn failed (attempt 3/5): spawn transaction for agent-894 rolled back (task remains dispatchable; rollback diagnostics: task claim: refused to roll back task 'move-panel-shortcut' because claim ownership changed from agent-894). exec_mode=default, executor=pi
2026-07-26T16:44:23.625395727+00:00 Reconciliation: stale-claim cleared (was Open, agent: agent-894)
2026-07-26T16:44:25.915391190+00:00 Spawn failed (attempt 4/5): spawn transaction for agent-894 rolled back (task remains dispatchable; rollback diagnostics: task claim: refused to roll back task 'move-panel-shortcut' because claim ownership changed from agent-894). exec_mode=default, executor=pi
2026-07-26T16:44:28.632305925+00:00 Reconciliation: stale-claim cleared (was Open, agent: agent-894)
2026-07-26T16:44:30.319766566+00:00 Spawn failed (attempt 5/5): spawn transaction for agent-894 rolled back (task remains dispatchable; rollback diagnostics: task claim: refused to roll back task 'move-panel-shortcut' because claim ownership changed from agent-894). exec_mode=default, executor=pi
2026-07-26T16:44:30.319766566+00:00 Circuit breaker tripped: spawn failed 5 times. Last error: spawn transaction for agent-894 rolled back (task remains dispatchable; rollback diagnostics: task claim: refused to roll back task 'move-panel-shortcut' because claim ownership changed from agent-894). exec_mode=default, executor=pi. Task marked incomplete for evaluator review.
2026-07-26T16:49:33.203441705+00:00 Spawn circuit breaker reset (cooldown decay).
2026-07-26T16:49:33.812001418+00:00 Spawn failed (attempt 1/5): spawn transaction for agent-894 rolled back (task remains dispatchable; rollback diagnostics: task claim: refused to roll back task 'move-panel-shortcut' because claim ownership changed from agent-894). exec_mode=default, executor=pi
2026-07-26T16:49:34.495145925+00:00 Reconciliation: stale-claim cleared (was Open, agent: agent-894)
2026-07-26T16:49:36.252965537+00:00 Spawn failed (attempt 2/5): spawn transaction for agent-894 rolled back (task remains dispatchable; rollback diagnostics: task claim: refused to roll back task 'move-panel-shortcut' because claim ownership changed from agent-894). exec_mode=default, executor=pi
2026-07-26T16:49:39.498783580+00:00 Reconciliation: stale-claim cleared (was Open, agent: agent-894)
2026-07-26T16:49:41.260453169+00:00 Spawn failed (attempt 3/5): spawn transaction for agent-894 rolled back (task remains dispatchable; rollback diagnostics: task claim: refused to roll back task 'move-panel-shortcut' because claim ownership changed from agent-894). exec_mode=default, executor=pi
2026-07-26T16:49:41.954794566+00:00 Reconciliation: stale-claim cleared (was Open, agent: agent-894)
2026-07-26T16:49:43.724757762+00:00 Spawn failed (attempt 4/5): spawn transaction for agent-894 rolled back (task remains dispatchable; rollback diagnostics: task claim: refused to roll back task 'move-panel-shortcut' because claim ownership changed from agent-894). exec_mode=default, executor=pi
2026-07-26T16:49:46.959483300+00:00 Reconciliation: stale-claim cleared (was Open, agent: agent-894)
2026-07-26T16:49:49.336209801+00:00 Spawn failed (attempt 5/5): spawn transaction for agent-894 rolled back (task remains dispatchable; rollback diagnostics: task claim: refused to roll back task 'move-panel-shortcut' because claim ownership changed from agent-894). exec_mode=default, executor=pi
2026-07-26T16:49:49.336209801+00:00 Circuit breaker tripped: spawn failed 5 times. Last error: spawn transaction for agent-894 rolled back (task remains dispatchable; rollback diagnostics: task claim: refused to roll back task 'move-panel-shortcut' because claim ownership changed from agent-894). exec_mode=default, executor=pi. Task marked incomplete for evaluator review.
2026-07-26T16:54:52.900049065+00:00 Spawn circuit breaker reset (cooldown decay).
2026-07-26T16:54:53.507041568+00:00 Spawn failed (attempt 1/5): spawn transaction for agent-894 rolled back (task remains dispatchable; rollback diagnostics: task claim: refused to roll back task 'move-panel-shortcut' because claim ownership changed from agent-894). exec_mode=default, executor=pi
2026-07-26T17:21:32.417325040+00:00 Reconciliation: stale-claim cleared (was Open, agent: agent-894)
2026-07-26T17:21:35.378779224+00:00 Spawn failed (attempt 2/5): spawn transaction for agent-894 rolled back (task remains dispatchable; rollback diagnostics: task claim: refused to roll back task 'move-panel-shortcut' because claim ownership changed from agent-894). exec_mode=default, executor=pi
2026-07-26T17:21:35.468306953+00:00 Reconciliation: stale-claim cleared (was Open, agent: agent-894)
2026-07-26T17:21:38.431729531+00:00 Spawn failed (attempt 3/5): spawn transaction for agent-894 rolled back (task remains dispatchable; rollback diagnostics: task claim: refused to roll back task 'move-panel-shortcut' because claim ownership changed from agent-894). exec_mode=default, executor=pi
2026-07-26T17:21:40.472514400+00:00 Reconciliation: stale-claim cleared (was Open, agent: agent-894)
2026-07-26T17:21:43.424237624+00:00 Spawn failed (attempt 4/5): spawn transaction for agent-894 rolled back (task remains dispatchable; rollback diagnostics: task claim: refused to roll back task 'move-panel-shortcut' because claim ownership changed from agent-894). exec_mode=default, executor=pi
2026-07-26T17:21:43.511197352+00:00 Reconciliation: stale-claim cleared (was Open, agent: agent-894)
2026-07-26T17:21:46.501562086+00:00 Spawn failed (attempt 5/5): spawn transaction for agent-894 rolled back (task remains dispatchable; rollback diagnostics: task claim: refused to roll back task 'move-panel-shortcut' because claim ownership changed from agent-894). exec_mode=default, executor=pi
2026-07-26T17:21:46.501562086+00:00 Circuit breaker tripped: spawn failed 5 times. Last error: spawn transaction for agent-894 rolled back (task remains dispatchable; rollback diagnostics: task claim: refused to roll back task 'move-panel-shortcut' because claim ownership changed from agent-894). exec_mode=default, executor=pi. Task marked incomplete for evaluator review.
2026-07-26T17:26:49.340842123+00:00 Spawn circuit breaker reset (cooldown decay).
2026-07-26T17:26:49.952454828+00:00 Spawn failed (attempt 1/5): spawn transaction for agent-894 rolled back (task remains dispatchable; rollback diagnostics: task claim: refused to roll back task 'move-panel-shortcut' because claim ownership changed from agent-894). exec_mode=default, executor=pi
2026-07-26T17:35:26.949251801+00:00 Reconciliation: stale-claim cleared (was Open, agent: agent-894)
2026-07-26T17:35:29.954001037+00:00 Spawn failed (attempt 2/5): spawn transaction for agent-894 rolled back (task remains dispatchable; rollback diagnostics: task claim: refused to roll back task 'move-panel-shortcut' because claim ownership changed from agent-894). exec_mode=default, executor=pi
2026-07-26T17:35:31.958345754+00:00 Reconciliation: stale-claim cleared (was Open, agent: agent-894)
2026-07-26T17:35:34.338187957+00:00 Spawn failed (attempt 3/5): spawn transaction for agent-894 rolled back (task remains dispatchable; rollback diagnostics: task claim: refused to roll back task 'move-panel-shortcut' because claim ownership changed from agent-894). exec_mode=default, executor=pi
2026-07-26T17:35:35.035777192+00:00 Reconciliation: stale-claim cleared (was Open, agent: agent-894)
2026-07-26T17:35:37.400031934+00:00 Spawn failed (attempt 4/5): spawn transaction for agent-894 rolled back (task remains dispatchable; rollback diagnostics: task claim: refused to roll back task 'move-panel-shortcut' because claim ownership changed from agent-894). exec_mode=default, executor=pi
2026-07-26T17:35:40.071546785+00:00 Reconciliation: stale-claim cleared (was Open, agent: agent-894)
2026-07-26T17:35:42.446171494+00:00 Spawn failed (attempt 5/5): spawn transaction for agent-894 rolled back (task remains dispatchable; rollback diagnostics: task claim: refused to roll back task 'move-panel-shortcut' because claim ownership changed from agent-894). exec_mode=default, executor=pi
2026-07-26T17:35:42.446171494+00:00 Circuit breaker tripped: spawn failed 5 times. Last error: spawn transaction for agent-894 rolled back (task remains dispatchable; rollback diagnostics: task claim: refused to roll back task 'move-panel-shortcut' because claim ownership changed from agent-894). exec_mode=default, executor=pi. Task marked incomplete for evaluator review.
2026-07-26T17:39:54.864565415+00:00 Task paused
2026-07-26T17:58:42.918847923+00:00 Task resumed
2026-07-26T21:01:17.379334762+00:00 Spawn preparation deferred before launch permit; rollback is complete and no circuit-breaker charge was recorded. Repair the reported checkout/configuration condition and retry: spawn transaction for agent-901 rolled back (task remains dispatchable; rollback diagnostics: complete): failed to establish isolated-worktree observer baseline: observer state already exists; use open_at for restart reconciliation
2026-07-26T21:02:02.702730683+00:00 Spawned by coordinator --executor pi --model openai-codex:gpt-5.6-sol --isolation required-worktree
2026-07-26T21:02:09.730386406+00:00 Starting implementation; first inspecting prior WIP and current TUI help/input architecture.
2026-07-26T21:22:35.754041764+00:00 Implemented modal Help state/input ownership, rendered-row scrolling with keyboard/wheel/trackpad/scrollbar control, no-click-through dismissal, resize clamping, restored first-viewport essentials, and removed the persistent Panel hint. Added focused unit coverage; now validating the permanent real tmux/PTY flow.
2026-07-26T21:30:32.581507664+00:00 Validation: focused modal Help + existing Panel/Layout + Help content tests pass; real candidate-binary tmux/PTY/SGR scenario passes. cargo fmt --check, cargo clippy, and cargo build pass. Full cargo test reached 3000 passes/38 ignored; 8 known unrelated branch-drift failures remain (dispatch agency external executor plus named-profile dry-run root and its mutex-poison cascade), matching dependency reports.
2026-07-26T21:34:15.512227534+00:00 Committed: a78a8a2b — pushed to remote
2026-07-26T21:34:34.884284687+00:00 Task marked as done