EPIC: TUI Session Management & Persistence — SQLite State & Multi-Session Tabs (v3.7.0) #5308

Open
opened 2026-04-09 05:48:38 +00:00 by HAL9000 · 2 comments
Owner

Epic: TUI Session Management & Persistence

Milestone: v3.7.0
Parent Legendary: #4946 (LEGENDARY: TUI Implementation)

Background

The TUI supports multiple concurrent sessions with independent state. Sessions are persisted to SQLite at ~/.local/state/cleveragents/tui.db. The session tab bar shows state indicators and supports navigation. Defined in ADR-044.

Scope

  • SQLite session persistence at ~/.local/state/cleveragents/tui.db
  • Multi-session tab bar with state indicators (, , plain)
  • Session tab navigation: ctrl+[ prev, ctrl+] next, ctrl+n new, ctrl+w close
  • Jump to tab by number: 1-9
  • ctrl+s opens Sessions screen
  • Sessions screen for saved session management
  • Session export (JSON format per spec)
  • session:export slash command
  • Session storage size calculation for agents session list

Child Issues

  • TBD

Definition of Done

  • All child issues are closed
  • Sessions persist to SQLite across restarts
  • Multi-session tab bar works with state indicators
  • Tab navigation hotkeys work
  • Sessions screen opens with ctrl+s
  • Session export produces valid JSON
  • All nox stages pass
  • Coverage >= 97%

Metadata

  • Branch Naming Convention: feat/tui-v370/session-management
  • Milestone: v3.7.0

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

## Epic: TUI Session Management & Persistence **Milestone**: v3.7.0 **Parent Legendary**: #4946 (LEGENDARY: TUI Implementation) ### Background The TUI supports multiple concurrent sessions with independent state. Sessions are persisted to SQLite at `~/.local/state/cleveragents/tui.db`. The session tab bar shows state indicators and supports navigation. Defined in ADR-044. ### Scope - SQLite session persistence at `~/.local/state/cleveragents/tui.db` - Multi-session tab bar with state indicators (`⌛`, `❯`, plain) - Session tab navigation: `ctrl+[` prev, `ctrl+]` next, `ctrl+n` new, `ctrl+w` close - Jump to tab by number: `1`-`9` - `ctrl+s` opens Sessions screen - Sessions screen for saved session management - Session export (JSON format per spec) - `session:export` slash command - Session storage size calculation for `agents session list` ### Child Issues <!-- Updated by automation after child issues are created --> - [ ] TBD ### Definition of Done - [ ] All child issues are closed - [ ] Sessions persist to SQLite across restarts - [ ] Multi-session tab bar works with state indicators - [ ] Tab navigation hotkeys work - [ ] Sessions screen opens with `ctrl+s` - [ ] Session export produces valid JSON - [ ] All nox stages pass - [ ] Coverage >= 97% ## Metadata - **Branch Naming Convention**: `feat/tui-v370/session-management` - **Milestone**: v3.7.0 --- **Automated by CleverAgents Bot** Supervisor: Epic Planning | Agent: epic-planner
HAL9000 added this to the v3.7.0 milestone 2026-04-09 05:48:38 +00:00
Author
Owner

Label compliance fix applied:

  • Added missing labels: MoSCoW/Must have, Points/21
  • Reason: New Epic issue was missing MoSCoW classification and story points estimate. Applied MoSCoW/Must have based on Priority/High and TUI milestone scope. Applied Points/21 as standard Epic estimate.

Note: MoSCoW labels are normally set by the project owner. If this classification is incorrect, please update accordingly.


Automated by CleverAgents Bot
Supervisor: Backlog Grooming | Agent: backlog-groomer

Label compliance fix applied: - Added missing labels: `MoSCoW/Must have`, `Points/21` - Reason: New Epic issue was missing MoSCoW classification and story points estimate. Applied `MoSCoW/Must have` based on Priority/High and TUI milestone scope. Applied `Points/21` as standard Epic estimate. Note: MoSCoW labels are normally set by the project owner. If this classification is incorrect, please update accordingly. --- **Automated by CleverAgents Bot** Supervisor: Backlog Grooming | Agent: backlog-groomer
Author
Owner

Child Issues — Epic #5308: TUI Session Management & Persistence

Updated: 2026-04-10 (Cycle 1 — Epic Planning)

Feature Issues (foundational)

  • #5330 — feat(tui): implement SQLite session persistence and multi-session tab bar with state indicators (foundational — must be done first)
  • #5333 — feat(tui): implement Sessions screen for saved session management and JSON session export (depends on #5330)

Bug Issues (must fix)

  • #5548 — UAT: TUI session database path mismatch — spec requires ~/.local/state/cleveragents/tui.db
  • #5945 — UAT: Multi-session tabs not implemented — TUI only supports single hardcoded session
  • #6610 — BUG-HUNT: /session:export with --format md/txt crashes with AttributeError

Total: 5 child issues (2 features + 3 bugs)

Dependency Chain: #5330#5333 → Epic #5308


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

## Child Issues — Epic #5308: TUI Session Management & Persistence **Updated**: 2026-04-10 (Cycle 1 — Epic Planning) ### Feature Issues (foundational) - [ ] #5330 — feat(tui): implement SQLite session persistence and multi-session tab bar with state indicators *(foundational — must be done first)* - [ ] #5333 — feat(tui): implement Sessions screen for saved session management and JSON session export *(depends on #5330)* ### Bug Issues (must fix) - [ ] #5548 — UAT: TUI session database path mismatch — spec requires `~/.local/state/cleveragents/tui.db` - [ ] #5945 — UAT: Multi-session tabs not implemented — TUI only supports single hardcoded session - [ ] #6610 — BUG-HUNT: /session:export with --format md/txt crashes with AttributeError **Total**: 5 child issues (2 features + 3 bugs) **Dependency Chain**: #5330 → #5333 → Epic #5308 --- **Automated by CleverAgents Bot** Supervisor: Epic Planning | Agent: epic-planner
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#5308
No description provided.