cleveragents/cleveragents-core

Fork 3

UAT: ReferencePickerOverlay is a static text widget — no interactive fuzzy search, tree browser mode, or tab switching #4727

New issue

Open

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

HAL9000 commented

2026-04-08 18:12:08 +00:00

Owner

Bug Report

Feature area: TUI @ reference picker

Severity: Medium — the overlay exists but is non-interactive; users cannot navigate or switch modes

What was tested

src/cleveragents/tui/widgets/reference_picker.py — the ReferencePickerOverlay widget and its integration in src/cleveragents/tui/app.py.

Expected behavior (from spec)

The @ reference picker overlay should be a fully interactive widget supporting:

Fuzzy search mode: live filtering of candidates as the user types after @
Tree browser mode: hierarchical file/resource tree the user can navigate
Tab switching between fuzzy search mode and tree browser mode
Keyboard navigation: ↑/↓ to move cursor, Enter to select, Escape to dismiss

Actual behavior

ReferencePickerOverlay extends textual.widgets.Static — a non-interactive static text display widget. It has a single method set_suggestions(query, suggestions) that renders a plain text list of up to 10 items. There is:

No fuzzy search UI (the fuzzy ranking happens in reference_parser.py, not in the overlay)
No tree browser mode
No tab switching between modes
No keyboard navigation (no on_key, no BINDINGS, no cursor state)
No Escape to dismiss, no Enter to select

The overlay is only updated after the user submits (on_input_submitted), not while typing. There is no on_input_changed handler in app.py.

Code locations

src/cleveragents/tui/widgets/reference_picker.py — entire file (983 bytes, ~35 lines)
src/cleveragents/tui/app.py lines 204–207 — only updates picker on submit, not on keypress
src/cleveragents/tui/app.py lines 123–131 — on_mount initialises picker with empty suggestions

Steps to reproduce (code analysis)

# reference_picker.py — the entire implementation
class ReferencePickerOverlay(_StaticBase):
    """Simple overlay displaying reference suggestions."""

    def set_suggestions(self, query: str, suggestions: list[str]) -> None:
        if not suggestions:
            self.update(f"@{query}\n(no matches)")
            return
        lines = [f"@{query}"]
        for item in suggestions[:10]:
            lines.append(f"  {item}")
        self.update("\n".join(lines))

No interactive behaviour, no mode switching, no keyboard handling.

Impact

Users cannot interactively browse or select @ references. The picker only shows a static text dump after submitting a message, which is too late to be useful for reference selection.

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

## Bug Report **Feature area:** TUI @ reference picker **Severity:** Medium — the overlay exists but is non-interactive; users cannot navigate or switch modes --- ### What was tested `src/cleveragents/tui/widgets/reference_picker.py` — the `ReferencePickerOverlay` widget and its integration in `src/cleveragents/tui/app.py`. ### Expected behavior (from spec) The `@` reference picker overlay should be a fully interactive widget supporting: - **Fuzzy search mode**: live filtering of candidates as the user types after `@` - **Tree browser mode**: hierarchical file/resource tree the user can navigate - **Tab switching** between fuzzy search mode and tree browser mode - Keyboard navigation: `↑`/`↓` to move cursor, `Enter` to select, `Escape` to dismiss ### Actual behavior `ReferencePickerOverlay` extends `textual.widgets.Static` — a **non-interactive static text display widget**. It has a single method `set_suggestions(query, suggestions)` that renders a plain text list of up to 10 items. There is: - No fuzzy search UI (the fuzzy ranking happens in `reference_parser.py`, not in the overlay) - No tree browser mode - No tab switching between modes - No keyboard navigation (no `on_key`, no `BINDINGS`, no cursor state) - No `Escape` to dismiss, no `Enter` to select The overlay is only updated **after the user submits** (`on_input_submitted`), not while typing. There is no `on_input_changed` handler in `app.py`. ### Code locations - `src/cleveragents/tui/widgets/reference_picker.py` — entire file (983 bytes, ~35 lines) - `src/cleveragents/tui/app.py` lines 204–207 — only updates picker on submit, not on keypress - `src/cleveragents/tui/app.py` lines 123–131 — `on_mount` initialises picker with empty suggestions ### Steps to reproduce (code analysis) ```python # reference_picker.py — the entire implementation class ReferencePickerOverlay(_StaticBase): """Simple overlay displaying reference suggestions.""" def set_suggestions(self, query: str, suggestions: list[str]) -> None: if not suggestions: self.update(f"@{query}\n(no matches)") return lines = [f"@{query}"] for item in suggestions[:10]: lines.append(f" {item}") self.update("\n".join(lines)) ``` No interactive behaviour, no mode switching, no keyboard handling. ### Impact Users cannot interactively browse or select `@` references. The picker only shows a static text dump after submitting a message, which is too late to be useful for reference selection. --- **Automated by CleverAgents Bot** Supervisor: UAT Testing | Agent: uat-tester

HAL9000 added the

labels

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

HAL9000 referenced this issue

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

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

HAL9000 referenced this issue

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

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

HAL9000 commented

2026-04-09 03:05:40 +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:05:47 +00:00

HAL9000 added this to the v3.7.0 milestone