UAT: TUI Reference Picker has no tree browser mode — `tab` in overlay should switch to hierarchical tree navigation #5063

New issue

Closed

opened 2026-04-09 00:53:33 +00:00 by HAL9000 · 1 comment

HAL9000 commented

2026-04-09 00:53:33 +00:00

Owner

Bug Report

Feature Area: TUI — Reference Picker (@ system)

Severity: Medium (tree navigation missing)

What Was Tested

The Reference Picker tree browser mode as defined in the specification (§ Reference Picker — Tree Browser Mode).

Expected Behavior (from spec)

Pressing tab in the Reference Picker switches to tree browser mode for hierarchical navigation:

┌─ Reference Picker (Tree) ────────────────────────────────────────────┐
│                                                                      │
│  ▼ Projects                                                          │
│    ▼ local/cleveragents                                              │
│      ▼ git_dir (git-checkout)                                        │
│        ▸ src/                                                        │
│        ▸ tests/                                                      │
│        ▸ docs/                                                       │
│        ─ pyproject.toml                                              │
│  ▼ Plans                                                             │
│    ▸ fix-auth-bug (01HXM8C2)                                         │
│                                                                      │
│ enter Select │ tab Search │ space Expand │ / Filter                  │
└──────────────────────────────────────────────────────────────────────┘

Tree browser mode hotkeys:

enter — Select highlighted item as reference
space — Expand / collapse tree node
up / down — Navigate tree
/ — Open inline filter
tab — Switch back to fuzzy search mode
escape — Dismiss picker

Actual Behavior (from code analysis)

The ReferencePickerOverlay in src/cleveragents/tui/widgets/reference_picker.py only has a set_suggestions() method that renders a flat list of fuzzy search results. There is no tree browser mode, no tab toggle between modes, no tree node expand/collapse, and no hierarchical project/resource display.

The overlay is a simple Static widget with no interactive navigation.

Steps to Reproduce

Run agents tui
Type @ in the prompt
Press tab — no tree browser mode appears (focus cycles to next widget instead)

Code Location

src/cleveragents/tui/widgets/reference_picker.py — only set_suggestions(), no tree mode

Impact

Users cannot browse the project/resource hierarchy visually. The tree browser is particularly important for discovering resources in deeply nested project structures where fuzzy search alone is insufficient.

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

## Bug Report **Feature Area:** TUI — Reference Picker (@ system) **Severity:** Medium (tree navigation missing) ### What Was Tested The Reference Picker tree browser mode as defined in the specification (§ Reference Picker — Tree Browser Mode). ### Expected Behavior (from spec) Pressing `tab` in the Reference Picker switches to tree browser mode for hierarchical navigation: ``` ┌─ Reference Picker (Tree) ────────────────────────────────────────────┐ │ │ │ ▼ Projects │ │ ▼ local/cleveragents │ │ ▼ git_dir (git-checkout) │ │ ▸ src/ │ │ ▸ tests/ │ │ ▸ docs/ │ │ ─ pyproject.toml │ │ ▼ Plans │ │ ▸ fix-auth-bug (01HXM8C2) │ │ │ │ enter Select │ tab Search │ space Expand │ / Filter │ └──────────────────────────────────────────────────────────────────────┘ ``` Tree browser mode hotkeys: - `enter` — Select highlighted item as reference - `space` — Expand / collapse tree node - `up` / `down` — Navigate tree - `/` — Open inline filter - `tab` — Switch back to fuzzy search mode - `escape` — Dismiss picker ### Actual Behavior (from code analysis) The `ReferencePickerOverlay` in `src/cleveragents/tui/widgets/reference_picker.py` only has a `set_suggestions()` method that renders a flat list of fuzzy search results. There is no tree browser mode, no `tab` toggle between modes, no tree node expand/collapse, and no hierarchical project/resource display. The overlay is a simple `Static` widget with no interactive navigation. ### Steps to Reproduce 1. Run `agents tui` 2. Type `@` in the prompt 3. Press `tab` — no tree browser mode appears (focus cycles to next widget instead) ### Code Location - `src/cleveragents/tui/widgets/reference_picker.py` — only `set_suggestions()`, no tree mode ### Impact Users cannot browse the project/resource hierarchy visually. The tree browser is particularly important for discovering resources in deeply nested project structures where fuzzy search alone is insufficient. --- **Automated by CleverAgents Bot** Supervisor: UAT Testing | Agent: uat-tester

HAL9000 commented

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

Author

Owner

Closing as duplicate of #4727 — both issues report the same problem: TUI ReferencePickerOverlay is a static text widget with no interactive tree browser mode.

Automated by CleverAgents Bot
Supervisor: Backlog Grooming | Agent: backlog-groomer

Closing as duplicate of #4727 — both issues report the same problem: TUI ReferencePickerOverlay is a static text widget with no interactive tree browser mode. --- **Automated by CleverAgents Bot** Supervisor: Backlog Grooming | Agent: backlog-groomer

HAL9000 closed this issue

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

HAL9000 referenced this issue

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

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