EPIC: TUI Reference & Command Input System — @, /, ! Mode Parsing (v3.7.0) #5305

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

Epic: TUI Reference & Command Input System

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

Background

The TUI input system supports three special modes triggered by prefix characters:

  • @ — Reference picker (files, actors, resources)
  • / — Slash command overlay (70+ catalog commands)
  • ! or $ — Shell mode (execute shell commands)

The prompt uses a TextArea widget (not Input) with multiline support, history navigation, and mode-dependent symbol display. Defined in ADR-046.

Scope

  • TextArea-based PromptInput widget replacing current Input widget
  • @ reference picker overlay with file/actor/resource completion
  • / slash command overlay with fuzzy search
  • !/$ shell mode activation and execution
  • Multiline input detection and history navigation (up/down arrows)
  • Mode-dependent symbol display in prompt
  • Block cursor navigation (alt+up/alt+down)
  • Conversation content pruning at 2500 lines

Child Issues

  • TBD

Definition of Done

  • All child issues are closed
  • @ reference picker works with file/actor/resource completion
  • / slash command overlay shows and filters commands
  • ! and $ both activate shell mode
  • TextArea supports multiline input and history
  • Block cursor navigation works
  • All nox stages pass
  • Coverage >= 97%

Metadata

  • Branch Naming Convention: feat/tui-v370/reference-command-input
  • Milestone: v3.7.0

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

## Epic: TUI Reference & Command Input System **Milestone**: v3.7.0 **Parent Legendary**: #4946 (LEGENDARY: TUI Implementation) ### Background The TUI input system supports three special modes triggered by prefix characters: - `@` — Reference picker (files, actors, resources) - `/` — Slash command overlay (70+ catalog commands) - `!` or `$` — Shell mode (execute shell commands) The prompt uses a `TextArea` widget (not `Input`) with multiline support, history navigation, and mode-dependent symbol display. Defined in ADR-046. ### Scope - `TextArea`-based `PromptInput` widget replacing current `Input` widget - `@` reference picker overlay with file/actor/resource completion - `/` slash command overlay with fuzzy search - `!`/`$` shell mode activation and execution - Multiline input detection and history navigation (up/down arrows) - Mode-dependent symbol display in prompt - Block cursor navigation (`alt+up`/`alt+down`) - Conversation content pruning at 2500 lines ### Child Issues <!-- Updated by automation after child issues are created --> - [ ] TBD ### Definition of Done - [ ] All child issues are closed - [ ] `@` reference picker works with file/actor/resource completion - [ ] `/` slash command overlay shows and filters commands - [ ] `!` and `$` both activate shell mode - [ ] TextArea supports multiline input and history - [ ] Block cursor navigation works - [ ] All nox stages pass - [ ] Coverage >= 97% ## Metadata - **Branch Naming Convention**: `feat/tui-v370/reference-command-input` - **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:06 +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 #5305: TUI Reference & Command Input System

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

Feature Issues (foundational)

  • #5322 — feat(tui): replace Input widget with TextArea-based PromptInput supporting multiline, history, and mode symbols (foundational — must be done first)
  • #5324 — feat(tui): implement block cursor navigation (alt+up/down) and conversation content pruning at 2500 lines (depends on #5322)

Bug Issues (must fix)

  • #5345 — UAT: TUI @ reference picker does not translate to CRP directives
  • #5926 — UAT: InputModeRouter.detect_mode() uses lstrip() instead of checking position 0
  • #5958 — UAT: Reference picker strips ALL @ signs from full prompt text
  • #5962 — UAT: Block cursor navigation missing — conversation uses Static widget instead of ContentsGrid
  • #5969 — UAT: Fuzzy search score_match() returns 0.4*ratio instead of fixed weight 0.4
  • #5982 — UAT: Reference parser catalog uses filesystem walk instead of registries
  • #6431 — UAT: TUI prompt symbol does not change based on input mode
  • #6434 — UAT: TUI $ prefix for environment variable expansion not implemented
  • #6456 — UAT: TUI block cursor and context menu not implemented
  • #6827 — UAT: TUI Reference Picker only activates on prompt submission

Total: 12 child issues (2 features + 10 bugs)

Dependency Chain: #5322#5324 → Epic #5305


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

## Child Issues — Epic #5305: TUI Reference & Command Input System **Updated**: 2026-04-10 (Cycle 1 — Epic Planning) ### Feature Issues (foundational) - [ ] #5322 — feat(tui): replace Input widget with TextArea-based PromptInput supporting multiline, history, and mode symbols *(foundational — must be done first)* - [ ] #5324 — feat(tui): implement block cursor navigation (alt+up/down) and conversation content pruning at 2500 lines *(depends on #5322)* ### Bug Issues (must fix) - [ ] #5345 — UAT: TUI @ reference picker does not translate to CRP directives - [ ] #5926 — UAT: InputModeRouter.detect_mode() uses lstrip() instead of checking position 0 - [ ] #5958 — UAT: Reference picker strips ALL @ signs from full prompt text - [ ] #5962 — UAT: Block cursor navigation missing — conversation uses Static widget instead of ContentsGrid - [ ] #5969 — UAT: Fuzzy search score_match() returns 0.4*ratio instead of fixed weight 0.4 - [ ] #5982 — UAT: Reference parser catalog uses filesystem walk instead of registries - [ ] #6431 — UAT: TUI prompt symbol does not change based on input mode - [ ] #6434 — UAT: TUI `$` prefix for environment variable expansion not implemented - [ ] #6456 — UAT: TUI block cursor and context menu not implemented - [ ] #6827 — UAT: TUI Reference Picker only activates on prompt submission **Total**: 12 child issues (2 features + 10 bugs) **Dependency Chain**: #5322 → #5324 → Epic #5305 --- **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.

Blocks Depends on
Reference
cleveragents/cleveragents-core#5305
No description provided.