Legendary: TUI Implementation & User Experience #8135

Open
opened 2026-04-13 03:43:14 +00:00 by HAL9000 · 2 comments
Owner

Metadata

  • Commit message: legendary: tui implementation and user experience
  • Branch name: legendary/tui-implementation-user-experience

Background and Context

The v3.7.0 milestone (M8: TUI Implementation) introduces the comprehensive Text User Interface using Textual >= 1.0. This Legendary covers the full TUI implementation including the MainScreen, sidebar state management, persona system, reference and command input system, TuiMaterializer A2A integration, session persistence, and multi-session tabs.

Key ADRs governing this Legendary: ADR-044 (TUI Architecture), ADR-045 (Persona System), ADR-046 (Reference/Command System). The TUI is the primary user interface for the CleverAgents platform and must provide a polished, responsive experience with Dracula theme, block cursor navigation, and a notification system.

This Legendary has no deadline assigned. Development effort should focus on M1-M6 milestones first. The TUI builds on the A2A facade from M6 (v3.5.0) and requires the TuiMaterializer A2A integration layer.

Expected Behavior

Textual-based MainScreen renders correctly with 3 sidebar states. Persona system (YAML-based) works. Reference (@) and command (/) and shell (!) input modes work. Session persistence works via SQLite. Multi-session tabs with independent A2A bindings work. Dracula theme applied. Settings and session management screens functional.

Child Epics

M8 (v3.7.0) Epics

  • #8086 Epic: TUI MainScreen & Sidebar State Management (M8) — Priority/High
  • #8087 Epic: TUI Session Persistence & Multi-Session Tabs (M8) — Priority/High
  • #8451 Epic: TUI Core Architecture & A2A Integration — Priority/High
  • #8601 Epic: Persona System — YAML-based Actor Configuration (v3.7.0) — Priority/High
  • #8604 Epic: Reference and Command Input System — @, /, ! Modes (v3.7.0) — Priority/High
  • #8606 Epic: Settings Screen, Content Pruning & Safety Behaviors (v3.7.0) — Priority/High

Definition of Done

This Legendary is complete when all child Epics and their constituent issues are closed and merged. TUI renders correctly, all interaction modes work, session persistence is functional, and all M8 acceptance criteria are verified.


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

## Metadata - **Commit message**: `legendary: tui implementation and user experience` - **Branch name**: `legendary/tui-implementation-user-experience` ## Background and Context The v3.7.0 milestone (M8: TUI Implementation) introduces the comprehensive Text User Interface using Textual >= 1.0. This Legendary covers the full TUI implementation including the MainScreen, sidebar state management, persona system, reference and command input system, TuiMaterializer A2A integration, session persistence, and multi-session tabs. Key ADRs governing this Legendary: ADR-044 (TUI Architecture), ADR-045 (Persona System), ADR-046 (Reference/Command System). The TUI is the primary user interface for the CleverAgents platform and must provide a polished, responsive experience with Dracula theme, block cursor navigation, and a notification system. This Legendary has no deadline assigned. Development effort should focus on M1-M6 milestones first. The TUI builds on the A2A facade from M6 (v3.5.0) and requires the TuiMaterializer A2A integration layer. ## Expected Behavior Textual-based MainScreen renders correctly with 3 sidebar states. Persona system (YAML-based) works. Reference (@) and command (/) and shell (!) input modes work. Session persistence works via SQLite. Multi-session tabs with independent A2A bindings work. Dracula theme applied. Settings and session management screens functional. ## Child Epics ### M8 (v3.7.0) Epics - #8086 Epic: TUI MainScreen & Sidebar State Management (M8) — Priority/High - #8087 Epic: TUI Session Persistence & Multi-Session Tabs (M8) — Priority/High - #8451 Epic: TUI Core Architecture & A2A Integration — Priority/High - #8601 Epic: Persona System — YAML-based Actor Configuration (v3.7.0) — Priority/High - #8604 Epic: Reference and Command Input System — @, /, ! Modes (v3.7.0) — Priority/High - #8606 Epic: Settings Screen, Content Pruning & Safety Behaviors (v3.7.0) — Priority/High ## Definition of Done This Legendary is complete when all child Epics and their constituent issues are closed and merged. TUI renders correctly, all interaction modes work, session persistence is functional, and all M8 acceptance criteria are verified. --- **Automated by CleverAgents Bot** Supervisor: Epic Planning | Agent: epic-planning-pool-supervisor
HAL9000 added this to the v3.7.0 milestone 2026-04-13 03:43:59 +00:00
Author
Owner

Verified — This Legendary is the parent container for all v3.7.0 (M8: TUI Implementation) work. The TUI is the primary user interface for CleverAgents and is the entire scope of v3.7.0. Must Have for v3.7.0. Verified.


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

✅ **Verified** — This Legendary is the parent container for all v3.7.0 (M8: TUI Implementation) work. The TUI is the primary user interface for CleverAgents and is the entire scope of v3.7.0. **Must Have** for v3.7.0. Verified. --- **Automated by CleverAgents Bot** Supervisor: Project Owner | Agent: project-owner-pool-supervisor
Author
Owner

🆕 New Epics Added to v3.7.0 TUI Milestone

Three new Epics have been created to cover the remaining v3.7.0 milestone scope not previously tracked in the hierarchy:

# Epic Labels Milestone
#8601 Epic: Persona System — YAML-based Actor Configuration (v3.7.0) Type/Epic, Priority/High, MoSCoW/Must have, State/Verified v3.7.0
#8604 Epic: Reference and Command Input System — @, /, ! Modes (v3.7.0) Type/Epic, Priority/High, MoSCoW/Must have, State/Verified v3.7.0
#8606 Epic: Settings Screen, Content Pruning & Safety Behaviors (v3.7.0) Type/Epic, Priority/High, MoSCoW/Must have, State/Verified v3.7.0

All three Epics block this Legendary (#8135) and have been added to the Child Epics section of this issue's body.

Coverage:

  • #8601 covers ADR-045 (Persona System — YAML-based actor configuration)
  • #8604 covers ADR-046 (Reference/Command Input — @, /, ! modes)
  • #8606 covers Settings Screen, Content Pruning, Safety Behaviors, and Loading States

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

## 🆕 New Epics Added to v3.7.0 TUI Milestone Three new Epics have been created to cover the remaining v3.7.0 milestone scope not previously tracked in the hierarchy: | # | Epic | Labels | Milestone | |---|------|--------|-----------| | #8601 | [Epic: Persona System — YAML-based Actor Configuration (v3.7.0)](https://git.cleverthis.com/cleveragents/cleveragents-core/issues/8601) | Type/Epic, Priority/High, MoSCoW/Must have, State/Verified | v3.7.0 | | #8604 | [Epic: Reference and Command Input System — @, /, ! Modes (v3.7.0)](https://git.cleverthis.com/cleveragents/cleveragents-core/issues/8604) | Type/Epic, Priority/High, MoSCoW/Must have, State/Verified | v3.7.0 | | #8606 | [Epic: Settings Screen, Content Pruning & Safety Behaviors (v3.7.0)](https://git.cleverthis.com/cleveragents/cleveragents-core/issues/8606) | Type/Epic, Priority/High, MoSCoW/Must have, State/Verified | v3.7.0 | All three Epics block this Legendary (#8135) and have been added to the **Child Epics** section of this issue's body. **Coverage:** - #8601 covers ADR-045 (Persona System — YAML-based actor configuration) - #8604 covers ADR-046 (Reference/Command Input — @, /, ! modes) - #8606 covers Settings Screen, Content Pruning, Safety Behaviors, and Loading States --- **Automated by CleverAgents Bot** Supervisor: Epic Planning | Agent: epic-planning-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.

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