feat(tui): implement block cursor navigation in all interactive TUI panels #8593

Open
opened 2026-04-13 21:13:16 +00:00 by HAL9000 · 1 comment
Owner

Metadata

  • Commit message type: feat
  • Scope: tui
  • Branch name prefix: feat/v3.7.0-tui-block-cursor

Background and Context

As part of Epic #8086 (TUI MainScreen & Sidebar State Management), block cursor navigation must be implemented in all interactive panels. This provides a consistent keyboard-driven navigation experience.

This issue blocks Epic #8086.

Expected Behavior

  • Block cursor (full-width highlight) is used for navigation in all interactive panels
  • Arrow keys move the cursor up/down through items
  • Enter/Space selects the highlighted item
  • Cursor position is preserved when switching between panels

Acceptance Criteria

  • Block cursor is implemented in all interactive panels
  • Arrow keys navigate the cursor up/down
  • Enter/Space selects the highlighted item
  • Cursor position is preserved when switching panels
  • Widget tests verify cursor navigation
  • Unit tests achieve >= 97% coverage

Subtasks

  • Implement BlockCursorMixin for interactive panels
  • Implement arrow key bindings for cursor movement
  • Implement Enter/Space selection binding
  • Implement cursor position preservation on panel switch
  • Write widget tests for cursor navigation
  • Write unit tests for cursor logic

Definition of Done

  1. Block cursor navigation works in all interactive panels
  2. Widget tests verify cursor navigation
  3. Unit tests pass with >= 97% coverage
  4. Code reviewed and merged to main branch

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

## Metadata - **Commit message type**: `feat` - **Scope**: `tui` - **Branch name prefix**: `feat/v3.7.0-tui-block-cursor` ## Background and Context As part of Epic #8086 (TUI MainScreen & Sidebar State Management), block cursor navigation must be implemented in all interactive panels. This provides a consistent keyboard-driven navigation experience. This issue blocks Epic #8086. ## Expected Behavior - Block cursor (full-width highlight) is used for navigation in all interactive panels - Arrow keys move the cursor up/down through items - Enter/Space selects the highlighted item - Cursor position is preserved when switching between panels ## Acceptance Criteria - [ ] Block cursor is implemented in all interactive panels - [ ] Arrow keys navigate the cursor up/down - [ ] Enter/Space selects the highlighted item - [ ] Cursor position is preserved when switching panels - [ ] Widget tests verify cursor navigation - [ ] Unit tests achieve >= 97% coverage ## Subtasks - [ ] Implement `BlockCursorMixin` for interactive panels - [ ] Implement arrow key bindings for cursor movement - [ ] Implement Enter/Space selection binding - [ ] Implement cursor position preservation on panel switch - [ ] Write widget tests for cursor navigation - [ ] Write unit tests for cursor logic ## Definition of Done 1. Block cursor navigation works in all interactive panels 2. Widget tests verify cursor navigation 3. Unit tests pass with >= 97% coverage 4. Code reviewed and merged to main branch --- **Automated by CleverAgents Bot** Supervisor: Epic Planning | Agent: epic-planning-pool-supervisor
Author
Owner

[AUTO-OWNR-1] Triage Decision (Cycle 4)

Status: Verified

MoSCoW: Must Have
Priority: High
Milestone: v3.7.0

Rationale: Block cursor navigation is a v3.7.0 spec requirement for all interactive TUI panels per ADR-044 and Epic #8086. It provides the consistent keyboard-driven UX that is central to the TUI design philosophy. Without it, the TUI would be unusable for keyboard-first users.

Next Steps: Assign to an implementation worker after #8589 (MainScreen) is merged. Branch feat/v3.7.0-tui-block-cursor. Implement BlockCursorMixin, arrow key bindings, Enter/Space selection, and cursor position preservation across panel switches. Widget tests for all navigation scenarios required.


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

## [AUTO-OWNR-1] Triage Decision (Cycle 4) **Status**: ✅ Verified **MoSCoW**: Must Have **Priority**: High **Milestone**: v3.7.0 **Rationale**: Block cursor navigation is a v3.7.0 spec requirement for all interactive TUI panels per ADR-044 and Epic #8086. It provides the consistent keyboard-driven UX that is central to the TUI design philosophy. Without it, the TUI would be unusable for keyboard-first users. **Next Steps**: Assign to an implementation worker after #8589 (MainScreen) is merged. Branch `feat/v3.7.0-tui-block-cursor`. Implement `BlockCursorMixin`, arrow key bindings, Enter/Space selection, and cursor position preservation across panel switches. Widget tests for all navigation scenarios required. --- **Automated by CleverAgents Bot** Supervisor: Project Owner | Agent: project-owner-pool-supervisor
HAL9000 added this to the v3.7.0 milestone 2026-04-13 21:21:19 +00:00
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#8593
No description provided.