feat(tui): implement MainScreen with Dracula theme, 3-state sidebar, and custom layout components #5032

Open
opened 2026-04-09 00:49:40 +00:00 by HAL9000 · 1 comment
Owner

Metadata

  • Commit Message: feat(tui): implement MainScreen with Dracula theme, 3-state sidebar, and custom layout components
  • Branch: feat/m8/tui-main-screen
  • Milestone: v3.7.0
  • Parent Epic: #4963

Background and Context

The TUI needs a MainScreen class built with Textual >= 1.0 that implements the Dracula theme, a 3-state sidebar (hidden/visible/fullscreen), and custom layout components (Throbber, SessionTabs, Flash bar) instead of generic Header/Footer.

Expected Behavior

  • MainScreen class uses Dracula theme (THEME = "dracula")
  • Sidebar has 3 states: hidden, visible, fullscreen
  • Custom layout includes: Throbber, SessionTabs, Flash bar, sidebar
  • No generic Textual Header/Footer used
  • Layout is responsive and handles terminal resize

Acceptance Criteria

  • MainScreen class implemented in src/cleveragents/tui/
  • THEME = "dracula" class variable set
  • Sidebar has 3 states with proper transitions
  • Throbber widget implemented
  • SessionTabs widget implemented
  • Flash bar (notification area) implemented
  • No generic Header/Footer used
  • Unit tests (Behave) cover layout state transitions
  • Integration test (Robot) verifies TUI launches correctly

Subtasks

  • Implement MainScreen class with Dracula theme
  • Implement 3-state sidebar (hidden/visible/fullscreen)
  • Implement Throbber widget
  • Implement SessionTabs widget
  • Implement Flash bar notification area
  • Remove generic Header/Footer
  • Tests (Behave): Add scenarios for layout states
  • Tests (Robot): Add integration test for TUI launch
  • Verify coverage >=97% via nox -s coverage_report
  • Run nox (all default sessions), fix any errors

Definition of Done

This issue is complete when:

  • All subtasks above are completed and checked off.
  • A Git commit is created where the first line of the commit message matches the Commit Message in Metadata exactly.
  • The commit is pushed to the remote on the branch matching the Branch in Metadata exactly.
  • The commit is submitted as a pull request to master, reviewed, and merged before this issue is marked done.

Automated by CleverAgents Bot
Supervisor: Epic Planning | Agent: epic-planner

## Metadata - **Commit Message**: `feat(tui): implement MainScreen with Dracula theme, 3-state sidebar, and custom layout components` - **Branch**: `feat/m8/tui-main-screen` - **Milestone**: v3.7.0 - **Parent Epic**: #4963 ## Background and Context The TUI needs a `MainScreen` class built with Textual >= 1.0 that implements the Dracula theme, a 3-state sidebar (hidden/visible/fullscreen), and custom layout components (Throbber, SessionTabs, Flash bar) instead of generic Header/Footer. ## Expected Behavior - `MainScreen` class uses Dracula theme (`THEME = "dracula"`) - Sidebar has 3 states: hidden, visible, fullscreen - Custom layout includes: Throbber, SessionTabs, Flash bar, sidebar - No generic Textual Header/Footer used - Layout is responsive and handles terminal resize ## Acceptance Criteria - [ ] `MainScreen` class implemented in `src/cleveragents/tui/` - [ ] `THEME = "dracula"` class variable set - [ ] Sidebar has 3 states with proper transitions - [ ] `Throbber` widget implemented - [ ] `SessionTabs` widget implemented - [ ] Flash bar (notification area) implemented - [ ] No generic Header/Footer used - [ ] Unit tests (Behave) cover layout state transitions - [ ] Integration test (Robot) verifies TUI launches correctly ## Subtasks - [ ] Implement `MainScreen` class with Dracula theme - [ ] Implement 3-state sidebar (hidden/visible/fullscreen) - [ ] Implement `Throbber` widget - [ ] Implement `SessionTabs` widget - [ ] Implement Flash bar notification area - [ ] Remove generic Header/Footer - [ ] Tests (Behave): Add scenarios for layout states - [ ] Tests (Robot): Add integration test for TUI launch - [ ] Verify coverage >=97% via `nox -s coverage_report` - [ ] Run `nox` (all default sessions), fix any errors ## Definition of Done This issue is complete when: - All subtasks above are completed and checked off. - A Git commit is created where the **first line** of the commit message matches the Commit Message in Metadata exactly. - The commit is pushed to the remote on the branch matching the **Branch** in Metadata exactly. - The commit is submitted as a **pull request** to `master`, reviewed, and **merged** before this issue is marked done. --- **Automated by CleverAgents Bot** Supervisor: Epic Planning | Agent: epic-planner
HAL9000 added this to the v3.7.0 milestone 2026-04-09 00:50:00 +00:00
Author
Owner

Issue triaged by project owner:

  • State: Verified
  • Priority: High — Core TUI feature required for the TUI Legendary
  • Milestone: v3.7.0
  • Story Points: 8 — XL
  • MoSCoW: Must Have — Required for TUI Legendary completion
  • Parent Epic: #4963 or #4966 (TUI Epics)

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

Issue triaged by project owner: - **State**: Verified - **Priority**: High — Core TUI feature required for the TUI Legendary - **Milestone**: v3.7.0 - **Story Points**: 8 — XL - **MoSCoW**: Must Have — Required for TUI Legendary completion - **Parent Epic**: #4963 or #4966 (TUI Epics) --- **Automated by CleverAgents Bot** Supervisor: Project Owner | Agent: project-owner
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Reference
cleveragents/cleveragents-core#5032
No description provided.