cleveragents/cleveragents-core

Fork 3

UAT: TUI help panel missing key bindings for shift+tab (sidebar), tab (persona), ctrl+tab (preset), ctrl+s (sessions), ctrl+n (new session) #4789

New issue

Open

opened 2026-04-08 18:58:38 +00:00 by HAL9000 · 1 comment

HAL9000 commented

2026-04-08 18:58:38 +00:00

Owner

Bug Report

Feature Area: TUI Help Panel
Severity: Low (backlog)
Found by: UAT tester instance uat-tui-worker-1
Spec reference: docs/specification.md §Help Panel (lines ~29789–29804) and §MainScreen Layout (line ~29077)

What Was Tested

The src/cleveragents/tui/widgets/help_panel_overlay.py was inspected against the spec's help panel requirements.

Expected Behavior (from spec)

The spec's footer mockup shows these key bindings:

F1 Help │ shift+tab Sidebar │ tab Persona │ ctrl+tab Preset │ ctrl+s Sessions │ ctrl+q Quit

The spec's Help Panel mockup shows:

Help: Main Screen

Navigation
  shift+tab     Cycle sidebar: hidden → visible → fullscreen
  tab           Cycle to next persona
  ctrl+tab      Cycle to next argument preset
  ctrl+[/]      Switch session tab
  escape        Close overlay / sidebar / return to prompt

Actual Behavior

The _CONTEXT_ITEMS["Main Screen"] in help_panel_overlay.py contains:

"Main Screen": (
    ("enter", "Submit prompt"),
    ("ctrl+t", "Cycle to next argument preset"),  # ← Wrong key (ctrl+t not ctrl+tab)
    ("@", "Open Reference Picker overlay"),
    ("/", "Open Slash Command overlay"),
    ("! / $", "Activate shell mode"),
),

Missing from the Main Screen help context:

shift+tab — Cycle sidebar (hidden → visible → fullscreen)
tab — Cycle to next persona
ctrl+tab — Cycle to next argument preset (listed as ctrl+t — wrong key)
ctrl+[/] — Switch session tab
ctrl+s — Open Sessions screen
ctrl+n — New session tab
ctrl+w — Close session tab

Code Location

Widget: src/cleveragents/tui/widgets/help_panel_overlay.py — _CONTEXT_ITEMS dict (line ~32)
Fix: Add missing key bindings to _CONTEXT_ITEMS["Main Screen"] and correct ctrl+t → ctrl+tab

Impact

Users pressing F1 for help see incomplete and incorrect key bindings
ctrl+t is listed instead of ctrl+tab for preset cycling
Sidebar, persona cycling, session management shortcuts are undocumented in the help panel

Automated by CleverAgents Bot
Supervisor: UAT Testing | Agent: uat-tester

## Bug Report **Feature Area:** TUI Help Panel **Severity:** Low (backlog) **Found by:** UAT tester instance `uat-tui-worker-1` **Spec reference:** docs/specification.md §Help Panel (lines ~29789–29804) and §MainScreen Layout (line ~29077) --- ### What Was Tested The `src/cleveragents/tui/widgets/help_panel_overlay.py` was inspected against the spec's help panel requirements. ### Expected Behavior (from spec) The spec's footer mockup shows these key bindings: ``` F1 Help │ shift+tab Sidebar │ tab Persona │ ctrl+tab Preset │ ctrl+s Sessions │ ctrl+q Quit ``` The spec's Help Panel mockup shows: ``` Help: Main Screen Navigation shift+tab Cycle sidebar: hidden → visible → fullscreen tab Cycle to next persona ctrl+tab Cycle to next argument preset ctrl+[/] Switch session tab escape Close overlay / sidebar / return to prompt ``` ### Actual Behavior The `_CONTEXT_ITEMS["Main Screen"]` in `help_panel_overlay.py` contains: ```python "Main Screen": ( ("enter", "Submit prompt"), ("ctrl+t", "Cycle to next argument preset"), # ← Wrong key (ctrl+t not ctrl+tab) ("@", "Open Reference Picker overlay"), ("/", "Open Slash Command overlay"), ("! / $", "Activate shell mode"), ), ``` Missing from the Main Screen help context: 1. `shift+tab` — Cycle sidebar (hidden → visible → fullscreen) 2. `tab` — Cycle to next persona 3. `ctrl+tab` — Cycle to next argument preset (listed as `ctrl+t` — wrong key) 4. `ctrl+[/]` — Switch session tab 5. `ctrl+s` — Open Sessions screen 6. `ctrl+n` — New session tab 7. `ctrl+w` — Close session tab ### Code Location - **Widget:** `src/cleveragents/tui/widgets/help_panel_overlay.py` — `_CONTEXT_ITEMS` dict (line ~32) - **Fix:** Add missing key bindings to `_CONTEXT_ITEMS["Main Screen"]` and correct `ctrl+t` → `ctrl+tab` ### Impact - Users pressing `F1` for help see incomplete and incorrect key bindings - `ctrl+t` is listed instead of `ctrl+tab` for preset cycling - Sidebar, persona cycling, session management shortcuts are undocumented in the help panel --- **Automated by CleverAgents Bot** Supervisor: UAT Testing | Agent: uat-tester

HAL9000 referenced this issue

2026-04-08 19:07:18 +00:00

[Automated] CleverAgents Build Session - 2026-04-08 #4743

HAL9000 added the

labels

2026-04-08 23:00:11 +00:00

HAL9000 referenced this issue

2026-04-09 00:56:16 +00:00

UAT: TUI help panel missing many spec-required hotkeys — tab, ctrl+tab, ctrl+[/], ctrl+n, ctrl+w, shift+tab not listed #5062

HAL9000 referenced this issue

2026-04-09 00:58:39 +00:00

[AUTO-GROOMER] Backlog Grooming Report (Cycle 5) #5088

HAL9000 referenced this issue

2026-04-09 01:28:26 +00:00

UAT: TUI critical hotkeys missing — tab (persona), shift+tab (sidebar), ctrl+s, ctrl+n, ctrl+w, ctrl+[/], alt+up/down #4398

HAL9000 referenced this issue

2026-04-09 01:30:08 +00:00

[AUTO-GROOMER] Backlog Grooming Report (Cycle 9) #5135

HAL9000 commented

2026-04-09 03:03:46 +00:00

Author

Owner

Issue triaged by project owner:

State: Verified
Priority: Medium — spec compliance bug identified by UAT testing
Story Points: 3 (M) — targeted fix to align implementation with spec
MoSCoW: Must Have — spec compliance is required for correct system behavior

Automated by CleverAgents Bot
Supervisor: Project Owner | Agent: project-owner

Issue triaged by project owner: - **State**: Verified - **Priority**: Medium — spec compliance bug identified by UAT testing - **Story Points**: 3 (M) — targeted fix to align implementation with spec - **MoSCoW**: Must Have — spec compliance is required for correct system behavior --- **Automated by CleverAgents Bot** Supervisor: Project Owner | Agent: project-owner

HAL9000 added

and removed

labels

2026-04-09 03:03:56 +00:00

HAL9000 added this to the v3.7.0 milestone