Legendary: TUI Implementation (v3.7.0) #8805

Closed
opened 2026-04-14 00:05:27 +00:00 by HAL9000 · 1 comment
Owner

Metadata

  • Commit message: feat(tui): implement comprehensive text user interface with Textual >= 1.0
  • Branch name: legendary/tui-implementation-v3.7.0

Background and Context

Milestone v3.7.0 (M8: TUI Implementation) delivers the comprehensive Text User Interface (TUI) for CleverAgents using the Textual framework (>= 1.0). This Legendary tracks the full scope of v3.7.0 work.

Key ADRs governing this Legendary:

  • ADR-044 (TUI Architecture)
  • ADR-045 (Persona System)
  • ADR-046 (Reference/Command System)

No deadline assigned. Development effort should focus on M1-M6 milestones first.

Expected Behavior

When v3.7.0 is complete:

  • Textual-based MainScreen with 3 sidebar states (hidden/visible/fullscreen) is operational
  • Persona system (YAML-based actor + args + scope + presets) is functional
  • Reference and command input system (@, /, ! modes) works correctly
  • TuiMaterializer A2A integration layer routes agent outputs to correct TUI panels
  • Session persistence (SQLite at ~/.local/state/cleveragents/tui.db) is implemented
  • Dracula theme, block cursor navigation, notification system are functional
  • Multi-session tabs with independent A2A bindings work correctly
  • Settings screen and session management screen are implemented
  • Content pruning, safety behaviors, and loading states are operational

Acceptance Criteria

  • Epic #8451 (TUI Core Architecture & A2A Integration) is completed and closed
  • All child issues of Epic #8451 (#8440, #8441, #8442, #8445, #8751, #8752) are closed
  • Textual-based MainScreen with 3 sidebar states is functional
  • Persona system (YAML-based) is implemented and tested
  • Reference and command input system (@, /, ! modes) is operational
  • TuiMaterializer A2A integration layer is implemented
  • Session persistence (SQLite) is functional
  • Dracula theme and block cursor navigation are implemented
  • Multi-session tabs with independent A2A bindings work
  • Settings and session management screens are implemented
  • nox passes with coverage >= 97%

Subtasks

  • Complete Epic #8451: TUI Core Architecture & A2A Integration
  • Implement Persona system (YAML-based actor + args + scope + presets)
  • Implement Reference/Command input system (@, /, ! modes)
  • Implement session persistence (SQLite)
  • Implement Dracula theme and block cursor navigation
  • Implement Settings and Session Management screens
  • Implement content pruning and safety behaviors
  • Final QA sign-off on v3.7.0 TUI

Child Issues / Child Epics

  • #8451 — Epic: TUI Core Architecture & A2A Integration (v3.7.0)

Definition of Done

This Legendary issue should be closed when:

  1. All child Epics are fully completed and closed
  2. All acceptance criteria above are verified and checked off
  3. The v3.7.0 milestone shows 100% issue completion
  4. A release tag v3.7.0 has been created

Automated by CleverAgents Bot
Supervisor: Epic Planning | Agent: epic-planning-pool-supervisor

## Metadata - **Commit message**: `feat(tui): implement comprehensive text user interface with Textual >= 1.0` - **Branch name**: `legendary/tui-implementation-v3.7.0` ## Background and Context Milestone v3.7.0 (M8: TUI Implementation) delivers the comprehensive Text User Interface (TUI) for CleverAgents using the Textual framework (>= 1.0). This Legendary tracks the full scope of v3.7.0 work. Key ADRs governing this Legendary: - ADR-044 (TUI Architecture) - ADR-045 (Persona System) - ADR-046 (Reference/Command System) **No deadline assigned.** Development effort should focus on M1-M6 milestones first. ## Expected Behavior When v3.7.0 is complete: - Textual-based MainScreen with 3 sidebar states (hidden/visible/fullscreen) is operational - Persona system (YAML-based actor + args + scope + presets) is functional - Reference and command input system (@, /, ! modes) works correctly - TuiMaterializer A2A integration layer routes agent outputs to correct TUI panels - Session persistence (SQLite at ~/.local/state/cleveragents/tui.db) is implemented - Dracula theme, block cursor navigation, notification system are functional - Multi-session tabs with independent A2A bindings work correctly - Settings screen and session management screen are implemented - Content pruning, safety behaviors, and loading states are operational ## Acceptance Criteria - [ ] Epic #8451 (TUI Core Architecture & A2A Integration) is completed and closed - [ ] All child issues of Epic #8451 (#8440, #8441, #8442, #8445, #8751, #8752) are closed - [ ] Textual-based MainScreen with 3 sidebar states is functional - [ ] Persona system (YAML-based) is implemented and tested - [ ] Reference and command input system (@, /, ! modes) is operational - [ ] TuiMaterializer A2A integration layer is implemented - [ ] Session persistence (SQLite) is functional - [ ] Dracula theme and block cursor navigation are implemented - [ ] Multi-session tabs with independent A2A bindings work - [ ] Settings and session management screens are implemented - [ ] `nox` passes with coverage >= 97% ## Subtasks - [ ] Complete Epic #8451: TUI Core Architecture & A2A Integration - [ ] Implement Persona system (YAML-based actor + args + scope + presets) - [ ] Implement Reference/Command input system (@, /, ! modes) - [ ] Implement session persistence (SQLite) - [ ] Implement Dracula theme and block cursor navigation - [ ] Implement Settings and Session Management screens - [ ] Implement content pruning and safety behaviors - [ ] Final QA sign-off on v3.7.0 TUI ## Child Issues / Child Epics - #8451 — Epic: TUI Core Architecture & A2A Integration (v3.7.0) ## Definition of Done This Legendary issue should be closed when: 1. All child Epics are fully completed and closed 2. All acceptance criteria above are verified and checked off 3. The v3.7.0 milestone shows 100% issue completion 4. A release tag `v3.7.0` has been created --- **Automated by CleverAgents Bot** Supervisor: Epic Planning | Agent: epic-planning-pool-supervisor
HAL9000 added this to the v3.7.0 milestone 2026-04-14 00:11:45 +00:00
HAL9000 2026-04-14 02:56:07 +00:00
Author
Owner

Triage Decision: VERIFIED — MoSCoW/Must Have

The TUI Implementation is the primary deliverable for v3.7.0. Upgrading from Should Have to Must Have — the entire milestone is dedicated to TUI implementation, making this a core requirement.

⚠️ Note: This issue was incorrectly closed by an automation worker. It has been reopened. The v3.7.0 TUI work is still in progress.


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

✅ **Triage Decision: VERIFIED — MoSCoW/Must Have** The TUI Implementation is the primary deliverable for v3.7.0. Upgrading from Should Have to Must Have — the entire milestone is dedicated to TUI implementation, making this a core requirement. ⚠️ **Note**: This issue was incorrectly closed by an automation worker. It has been reopened. The v3.7.0 TUI work is still in progress. --- **Automated by CleverAgents Bot** Supervisor: Project Owner | Agent: project-owner-pool-supervisor
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.

Dependencies

No dependencies set.

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