feat: implement TUI reference and command input system with @, /, ! modes per ADR-046 #8220

Open
opened 2026-04-13 04:47:26 +00:00 by HAL9000 · 1 comment
Owner

Metadata

  • Commit message: feat: implement TUI reference command input system @ / ! modes
  • Branch name: feat/tui-reference-command-input-system

Background and Context

ADR-046 (Reference/Command System) defines a special input system where @ triggers reference mode (file/symbol references), / triggers command mode (slash commands), and ! triggers shell mode. This is a core UX feature that enables power users to efficiently navigate and interact with the TUI.

This input system is a fundamental differentiator for the TUI experience. It allows users to quickly reference files, execute commands, and run shell operations without leaving the TUI context. The distinct visual styling per mode provides clear feedback about the active input context.

Current Behavior

No special input modes exist. Input is plain text only.

Expected Behavior

@ prefix triggers reference mode with autocomplete for files and symbols. / prefix triggers command mode with slash command autocomplete. ! prefix triggers shell mode for shell command execution. Each mode has distinct visual styling to indicate the active mode.

Acceptance Criteria

  • @ prefix triggers reference mode with file/symbol autocomplete
  • / prefix triggers command mode with slash command autocomplete
  • ! prefix triggers shell mode for shell commands
  • Each mode has distinct visual styling
  • Mode switching is instant and responsive
  • Autocomplete results are filtered as user types
  • Test coverage >= 97% for input system

Subtasks

  • Implement input mode detection (@, /, ! prefixes)
  • Implement reference mode autocomplete for files/symbols
  • Implement command mode autocomplete for slash commands
  • Implement shell mode for shell command execution
  • Implement distinct visual styling per mode
  • Write widget tests for input mode switching
  • Write integration tests for autocomplete

Definition of Done

All 3 input modes work with autocomplete, distinct visual styling, and test coverage >= 97%.

Parent Epic

Blocks #8086


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

## Metadata - **Commit message**: `feat: implement TUI reference command input system @ / ! modes` - **Branch name**: `feat/tui-reference-command-input-system` ## Background and Context ADR-046 (Reference/Command System) defines a special input system where `@` triggers reference mode (file/symbol references), `/` triggers command mode (slash commands), and `!` triggers shell mode. This is a core UX feature that enables power users to efficiently navigate and interact with the TUI. This input system is a fundamental differentiator for the TUI experience. It allows users to quickly reference files, execute commands, and run shell operations without leaving the TUI context. The distinct visual styling per mode provides clear feedback about the active input context. ## Current Behavior No special input modes exist. Input is plain text only. ## Expected Behavior `@` prefix triggers reference mode with autocomplete for files and symbols. `/` prefix triggers command mode with slash command autocomplete. `!` prefix triggers shell mode for shell command execution. Each mode has distinct visual styling to indicate the active mode. ## Acceptance Criteria - [ ] `@` prefix triggers reference mode with file/symbol autocomplete - [ ] `/` prefix triggers command mode with slash command autocomplete - [ ] `!` prefix triggers shell mode for shell commands - [ ] Each mode has distinct visual styling - [ ] Mode switching is instant and responsive - [ ] Autocomplete results are filtered as user types - [ ] Test coverage >= 97% for input system ## Subtasks - [ ] Implement input mode detection (@, /, ! prefixes) - [ ] Implement reference mode autocomplete for files/symbols - [ ] Implement command mode autocomplete for slash commands - [ ] Implement shell mode for shell command execution - [ ] Implement distinct visual styling per mode - [ ] Write widget tests for input mode switching - [ ] Write integration tests for autocomplete ## Definition of Done All 3 input modes work with autocomplete, distinct visual styling, and test coverage >= 97%. ## Parent Epic Blocks #8086 --- **Automated by CleverAgents Bot** Supervisor: Epic Planning | Agent: epic-planning-pool-supervisor
HAL9000 added this to the v3.7.0 milestone 2026-04-13 04:48:33 +00:00
Author
Owner

Verified — Reference and command input system (@, /, ! modes) is explicitly listed in v3.7.0 milestone scope per ADR-046. Must Have for v3.7.0. Verified.


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

✅ **Verified** — Reference and command input system (@, /, ! modes) is explicitly listed in v3.7.0 milestone scope per ADR-046. **Must Have** for v3.7.0. Verified. --- **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#8220
No description provided.