cleveragents/cleveragents-core

Fork 3

UAT: MainScreen sidebar not implemented — 3-state sidebar (hidden/visible/fullscreen) missing from TUI app #5321

New issue

Open

opened 2026-04-09 05:50:23 +00:00 by HAL9000 · 1 comment

HAL9000 commented

2026-04-09 05:50:23 +00:00

Owner

Bug Report

Feature Area: TUI — MainScreen Layout (v3.7.0)
Severity: Critical — core TUI layout feature missing
Discovered by: UAT Testing (uat-pool-1, worker: tui-implementation)

What Was Tested

Code analysis of src/cleveragents/tui/app.py against the TUI specification (§TUI — MainScreen Layout).

Expected Behavior (from spec §29024, §29205-29218)

The spec defines a right-side collapsible sidebar with three states cycled by shift+tab:

State	Layout	Input Focus	Content
Hidden	Sidebar `display: none`; conversation full width	Prompt retains focus	No sidebar content visible
Visible	Sidebar docked right, 32-40 chars wide	Prompt retains focus; `ctrl+b` focuses sidebar	Plans and Projects panels in collapsible containers
Fullscreen	Covers entire screen	Sidebar takes input focus	Extended details, selection mode, persona management

State transitions:

Hidden ──shift+tab──► Visible ──shift+tab──► Fullscreen
  ▲                                              │
  └──────────────── escape (×1-2) ───────────────┘

The sidebar in Visible state shows Plans and Projects panels. In Fullscreen state it shows a full Plans & Projects browser with persona cycle list management.

The BINDINGS list must include:

shift+tab → cycle sidebar state
tab → cycle persona
ctrl+s → open Sessions screen
ctrl+[ / ctrl+] → switch session tabs
ctrl+b → focus sidebar (when visible)

Actual Behavior

src/cleveragents/tui/app.py has no sidebar widget at all. The compose() method yields only a single _Vertical column with conversation and prompt — no sidebar, no sidebar state machine, no shift+tab binding.

# Current BINDINGS (app.py:92-96):
BINDINGS: ClassVar[list[tuple[str, str, str]]] = [
    ("ctrl+q", "quit", "Quit"),
    ("f1", "help", "Help"),
    ("ctrl+t", "cycle_preset", "Cycle Preset"),
]
# Missing: shift+tab (sidebar), tab (persona), ctrl+s (sessions),
#          ctrl+[ / ctrl+] (session tabs), ctrl+b (focus sidebar)

# Current compose() (app.py:109-121):
def compose(self) -> Any:
    yield _Header(show_clock=True)
    with _Vertical(id="main-column"):
        yield _Static("CleverAgents TUI", id="conversation")
        # ... overlays ...
        yield PromptInput(...)
        yield PersonaBar(id="persona-bar")
    yield _Footer()
# Missing: sidebar widget, sidebar state tracking, Plans panel, Projects panel

The screens/ directory (src/cleveragents/tui/screens/) is empty (only __pycache__) — no sidebar screen or fullscreen mode exists.

Steps to Reproduce

Open src/cleveragents/tui/app.py
Inspect BINDINGS — shift+tab is absent
Inspect compose() — no sidebar widget yielded
Check src/cleveragents/tui/screens/ — directory is empty

Impact

This is a core layout feature of the TUI. Without the sidebar, users cannot:

View active plans and their status
View and navigate projects
Manage persona cycle lists
Access the fullscreen Plans & Projects browser

This blocks the v3.7.0 milestone acceptance criteria.

Code Location

src/cleveragents/tui/app.py — missing sidebar widget, missing bindings
src/cleveragents/tui/screens/ — empty, needs sidebar screen implementation

Definition of Done

SidebarWidget with hidden/visible/fullscreen states
shift+tab binding cycles sidebar states
Visible state: Plans panel + Projects panel (32-40 chars wide, right-docked)
Fullscreen state: full Plans & Projects browser with persona cycle list
ctrl+b focuses sidebar when visible
escape cascades from fullscreen → visible → hidden
tab binding cycles personas (currently unbound)
ctrl+s binding opens Sessions screen
ctrl+[ / ctrl+] switch session tabs

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

## Bug Report **Feature Area:** TUI — MainScreen Layout (v3.7.0) **Severity:** Critical — core TUI layout feature missing **Discovered by:** UAT Testing (uat-pool-1, worker: tui-implementation) --- ## What Was Tested Code analysis of `src/cleveragents/tui/app.py` against the TUI specification (§TUI — MainScreen Layout). ## Expected Behavior (from spec §29024, §29205-29218) The spec defines a **right-side collapsible sidebar** with three states cycled by `shift+tab`: | State | Layout | Input Focus | Content | |-------|--------|-------------|---------| | **Hidden** | Sidebar `display: none`; conversation full width | Prompt retains focus | No sidebar content visible | | **Visible** | Sidebar docked right, 32-40 chars wide | Prompt retains focus; `ctrl+b` focuses sidebar | Plans and Projects panels in collapsible containers | | **Fullscreen** | Covers entire screen | Sidebar takes input focus | Extended details, selection mode, persona management | State transitions: ``` Hidden ──shift+tab──► Visible ──shift+tab──► Fullscreen ▲ │ └──────────────── escape (×1-2) ───────────────┘ ``` The sidebar in **Visible** state shows Plans and Projects panels. In **Fullscreen** state it shows a full Plans & Projects browser with persona cycle list management. The `BINDINGS` list must include: - `shift+tab` → cycle sidebar state - `tab` → cycle persona - `ctrl+s` → open Sessions screen - `ctrl+[` / `ctrl+]` → switch session tabs - `ctrl+b` → focus sidebar (when visible) ## Actual Behavior `src/cleveragents/tui/app.py` has **no sidebar widget at all**. The `compose()` method yields only a single `_Vertical` column with conversation and prompt — no sidebar, no sidebar state machine, no `shift+tab` binding. ```python # Current BINDINGS (app.py:92-96): BINDINGS: ClassVar[list[tuple[str, str, str]]] = [ ("ctrl+q", "quit", "Quit"), ("f1", "help", "Help"), ("ctrl+t", "cycle_preset", "Cycle Preset"), ] # Missing: shift+tab (sidebar), tab (persona), ctrl+s (sessions), # ctrl+[ / ctrl+] (session tabs), ctrl+b (focus sidebar) ``` ```python # Current compose() (app.py:109-121): def compose(self) -> Any: yield _Header(show_clock=True) with _Vertical(id="main-column"): yield _Static("CleverAgents TUI", id="conversation") # ... overlays ... yield PromptInput(...) yield PersonaBar(id="persona-bar") yield _Footer() # Missing: sidebar widget, sidebar state tracking, Plans panel, Projects panel ``` The `screens/` directory (`src/cleveragents/tui/screens/`) is **empty** (only `__pycache__`) — no sidebar screen or fullscreen mode exists. ## Steps to Reproduce 1. Open `src/cleveragents/tui/app.py` 2. Inspect `BINDINGS` — `shift+tab` is absent 3. Inspect `compose()` — no sidebar widget yielded 4. Check `src/cleveragents/tui/screens/` — directory is empty ## Impact This is a **core layout feature** of the TUI. Without the sidebar, users cannot: - View active plans and their status - View and navigate projects - Manage persona cycle lists - Access the fullscreen Plans & Projects browser This blocks the v3.7.0 milestone acceptance criteria. ## Code Location - `src/cleveragents/tui/app.py` — missing sidebar widget, missing bindings - `src/cleveragents/tui/screens/` — empty, needs sidebar screen implementation ## Definition of Done - [ ] `SidebarWidget` with hidden/visible/fullscreen states - [ ] `shift+tab` binding cycles sidebar states - [ ] Visible state: Plans panel + Projects panel (32-40 chars wide, right-docked) - [ ] Fullscreen state: full Plans & Projects browser with persona cycle list - [ ] `ctrl+b` focuses sidebar when visible - [ ] `escape` cascades from fullscreen → visible → hidden - [ ] `tab` binding cycles personas (currently unbound) - [ ] `ctrl+s` binding opens Sessions screen - [ ] `ctrl+[` / `ctrl+]` switch session tabs --- **Automated by CleverAgents Bot** Supervisor: UAT Testing | Agent: uat-tester

HAL9000 added the

labels

2026-04-09 05:51:24 +00:00

HAL9000 added this to the v3.7.0 milestone

2026-04-09 05:51:34 +00:00

HAL9000 commented

2026-04-09 06:13:43 +00:00

Author

Owner

Issue triaged by project owner:

State: Verified
Priority: High — (adjusting from Critical) the 3-state sidebar is a core TUI layout feature per v3.7.0 spec, but v3.7.0 has no deadline and focus is on M1-M6 first
Milestone: v3.7.0
Story Points: 5 — L — implementing 3-state sidebar (hidden/visible/fullscreen) with keyboard bindings
MoSCoW: Must Have — the sidebar is explicitly required by v3.7.0 TUI spec (ADR-044)
Parent Epic: Needs linking to TUI epic

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

Issue triaged by project owner: - **State**: Verified - **Priority**: High — (adjusting from Critical) the 3-state sidebar is a core TUI layout feature per v3.7.0 spec, but v3.7.0 has no deadline and focus is on M1-M6 first - **Milestone**: v3.7.0 - **Story Points**: 5 — L — implementing 3-state sidebar (hidden/visible/fullscreen) with keyboard bindings - **MoSCoW**: Must Have — the sidebar is explicitly required by v3.7.0 TUI spec (ADR-044) - **Parent Epic**: Needs linking to TUI epic --- **Automated by CleverAgents Bot** Supervisor: Project Owner | Agent: project-owner

HAL9000 added

and removed