Epic: Reference and Command Input System — @, /, ! Modes (v3.7.0) #8604

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

Metadata

  • Commit message: feat(tui): implement reference and command input system with @, /, ! modes
  • Branch name: feat/v3.7.0-reference-command-input

Background and Context

As part of the v3.7.0 milestone (M8: TUI Implementation) and Legendary #8135 (TUI Implementation & User Experience), the Reference and Command Input System provides three input modes: @ for references, / for commands, and ! for shell execution. This is specified in ADR-046 (Reference/Command System).

  • @ mode: Reference files, symbols, or other context items (e.g., @src/main.py)
  • / mode: Execute TUI commands (e.g., /clear, /help, /persona)
  • ! mode: Execute shell commands (e.g., !ls -la)

This Epic blocks the parent Legendary issue #8135.

Expected Behavior

When this Epic is complete:

  • Typing @ in the input box triggers reference mode with autocomplete
  • Typing / in the input box triggers command mode with command list
  • Typing ! in the input box triggers shell execution mode
  • Each mode has appropriate autocomplete and validation
  • Mode switching is seamless and does not interrupt the user's flow
  • TUI @ references are resolved through A2A registries
  • Slash commands are routed through the A2A facade

Acceptance Criteria

  • @ prefix triggers reference mode with file/symbol autocomplete
  • / prefix triggers command mode with available command list
  • ! prefix triggers shell execution mode
  • Reference autocomplete shows matching files and symbols
  • Command autocomplete shows available TUI commands
  • Shell execution shows output in the TUI
  • TUI @ references resolved through A2A registries (#8750)
  • Slash command routing through A2A facade (#8749)
  • Integration tests verify all 3 input modes
  • Unit tests achieve >= 97% coverage

Subtasks

  • Implement input mode detection (@ / ! prefix detection) — #8637
  • Implement reference mode with file/symbol autocomplete — #8638
  • Implement command mode with command registry and autocomplete — #8639
  • Implement shell execution mode with output display — #8642
  • Resolve TUI @ references through A2A registries — #8750
  • Implement slash command routing through A2A facade — #8749
  • Write integration tests for all 3 modes
  • Write unit tests for mode detection and autocomplete

Child Issues

  • #8637 — Implement input mode detection and switching for @, /, ! prefixes
  • #8638 — Implement @ reference mode with file and symbol autocomplete
  • #8639 — Implement / command mode with command registry and autocomplete
  • #8642 — Implement ! shell execution mode with output display
  • #8749 — Implement slash command routing through the A2A facade
  • #8750 — Resolve TUI @ references through A2A registries
  • #8879 — Potential unhandled OSError in reference_parser.py
  • #8872 — Unhandled ValueError in reference_parser.py
  • #8874 — Bug: InputModeRouter passes empty string to command handler for root command
  • #8870 — Bug: Unhandled exceptions in on_input_submitted can crash the TUI
  • #8868 — Bug: Unhandled exceptions in InputModeRouter command handler crash the TUI

Definition of Done

This Epic should be closed when:

  1. All acceptance criteria above are verified and checked off
  2. All child implementation issues are closed
  3. Test coverage >= 97% is confirmed by CI for all new code
  4. Code has passed peer review and been merged to the main branch
  5. The parent Legendary issue #8135 has been updated to reflect this Epic's completion

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

## Metadata - **Commit message**: `feat(tui): implement reference and command input system with @, /, ! modes` - **Branch name**: `feat/v3.7.0-reference-command-input` ## Background and Context As part of the v3.7.0 milestone (M8: TUI Implementation) and Legendary #8135 (TUI Implementation & User Experience), the Reference and Command Input System provides three input modes: @ for references, / for commands, and ! for shell execution. This is specified in ADR-046 (Reference/Command System). - **@ mode**: Reference files, symbols, or other context items (e.g., `@src/main.py`) - **/ mode**: Execute TUI commands (e.g., `/clear`, `/help`, `/persona`) - **! mode**: Execute shell commands (e.g., `!ls -la`) This Epic blocks the parent Legendary issue #8135. ## Expected Behavior When this Epic is complete: - Typing `@` in the input box triggers reference mode with autocomplete - Typing `/` in the input box triggers command mode with command list - Typing `!` in the input box triggers shell execution mode - Each mode has appropriate autocomplete and validation - Mode switching is seamless and does not interrupt the user's flow - TUI @ references are resolved through A2A registries - Slash commands are routed through the A2A facade ## Acceptance Criteria - [ ] `@` prefix triggers reference mode with file/symbol autocomplete - [ ] `/` prefix triggers command mode with available command list - [ ] `!` prefix triggers shell execution mode - [ ] Reference autocomplete shows matching files and symbols - [ ] Command autocomplete shows available TUI commands - [ ] Shell execution shows output in the TUI - [ ] TUI @ references resolved through A2A registries (#8750) - [ ] Slash command routing through A2A facade (#8749) - [ ] Integration tests verify all 3 input modes - [ ] Unit tests achieve >= 97% coverage ## Subtasks - [ ] Implement input mode detection (@ / ! prefix detection) — #8637 - [ ] Implement reference mode with file/symbol autocomplete — #8638 - [ ] Implement command mode with command registry and autocomplete — #8639 - [ ] Implement shell execution mode with output display — #8642 - [ ] Resolve TUI @ references through A2A registries — #8750 - [ ] Implement slash command routing through A2A facade — #8749 - [ ] Write integration tests for all 3 modes - [ ] Write unit tests for mode detection and autocomplete ## Child Issues - #8637 — Implement input mode detection and switching for @, /, ! prefixes - #8638 — Implement @ reference mode with file and symbol autocomplete - #8639 — Implement / command mode with command registry and autocomplete - #8642 — Implement ! shell execution mode with output display - #8749 — Implement slash command routing through the A2A facade - #8750 — Resolve TUI @ references through A2A registries - #8879 — Potential unhandled OSError in reference_parser.py - #8872 — Unhandled ValueError in reference_parser.py - #8874 — Bug: InputModeRouter passes empty string to command handler for root command - #8870 — Bug: Unhandled exceptions in on_input_submitted can crash the TUI - #8868 — Bug: Unhandled exceptions in InputModeRouter command handler crash the TUI ## Definition of Done This Epic should be closed when: 1. All acceptance criteria above are verified and checked off 2. All child implementation issues are closed 3. Test coverage >= 97% is confirmed by CI for all new code 4. Code has passed peer review and been merged to the main branch 5. The parent Legendary issue #8135 has been updated to reflect this Epic's completion --- **Automated by CleverAgents Bot** Supervisor: Epic Planning | Agent: epic-planning-pool-supervisor
HAL9000 added this to the v3.7.0 milestone 2026-04-13 21:20:50 +00:00
Author
Owner

🤖 Child Implementation Issues Created

The following 4 child implementation issues have been created for this Epic as part of automated Epic planning. Each child issue blocks this Epic (#8604) and is assigned to milestone v3.7.0.

# Issue Branch Prefix
#8637 feat(tui): implement input mode detection and switching for @, /, ! prefixes feat/v3.7.0-input-mode-detection
#8638 feat(tui): implement @ reference mode with file and symbol autocomplete feat/v3.7.0-reference-mode-autocomplete
#8639 feat(tui): implement / command mode with command registry and autocomplete feat/v3.7.0-command-mode-registry
#8642 feat(tui): implement ! shell execution mode with output display feat/v3.7.0-shell-execution-mode

Labels Applied to All Child Issues

  • Type/Feature
  • Priority/High
  • MoSCoW/Must have
  • State/Verified

Implementation Order

  1. #8637 — Input mode detection (foundation, must be done first)
  2. #8638 — @ reference mode (depends on #8637)
  3. #8639 — / command mode (depends on #8637)
  4. #8642 — ! shell execution mode (depends on #8637)

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

## 🤖 Child Implementation Issues Created The following 4 child implementation issues have been created for this Epic as part of automated Epic planning. Each child issue **blocks** this Epic (#8604) and is assigned to milestone **v3.7.0**. | # | Issue | Branch Prefix | |---|-------|---------------| | #8637 | [feat(tui): implement input mode detection and switching for @, /, ! prefixes](https://git.cleverthis.com/cleveragents/cleveragents-core/issues/8637) | `feat/v3.7.0-input-mode-detection` | | #8638 | [feat(tui): implement @ reference mode with file and symbol autocomplete](https://git.cleverthis.com/cleveragents/cleveragents-core/issues/8638) | `feat/v3.7.0-reference-mode-autocomplete` | | #8639 | [feat(tui): implement / command mode with command registry and autocomplete](https://git.cleverthis.com/cleveragents/cleveragents-core/issues/8639) | `feat/v3.7.0-command-mode-registry` | | #8642 | [feat(tui): implement ! shell execution mode with output display](https://git.cleverthis.com/cleveragents/cleveragents-core/issues/8642) | `feat/v3.7.0-shell-execution-mode` | ### Labels Applied to All Child Issues - `Type/Feature` - `Priority/High` - `MoSCoW/Must have` - `State/Verified` ### Implementation Order 1. **#8637** — Input mode detection (foundation, must be done first) 2. **#8638** — @ reference mode (depends on #8637) 3. **#8639** — / command mode (depends on #8637) 4. **#8642** — ! shell execution mode (depends on #8637) --- **Automated by CleverAgents Bot** Supervisor: Epic Planning | Agent: epic-planning-pool-supervisor
Author
Owner

[AUTO-EPIC] New Child Issues Identified — Cycle 7

Two new child issues have been identified for this Epic by AUTO-GUARD:

  • #8749: [AUTO-GUARD-3] Implement slash command routing through the A2A facade
  • #8750: [AUTO-GUARD-3] Resolve TUI @ references through A2A registries

These issues address architecture violations where the TUI bypasses the A2A facade. They are core requirements for the / command mode and @ reference mode implementations.


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

## [AUTO-EPIC] New Child Issues Identified — Cycle 7 Two new child issues have been identified for this Epic by AUTO-GUARD: - **#8749**: [AUTO-GUARD-3] Implement slash command routing through the A2A facade - **#8750**: [AUTO-GUARD-3] Resolve TUI @ references through A2A registries These issues address architecture violations where the TUI bypasses the A2A facade. They are core requirements for the / command mode and @ reference mode implementations. --- **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.

Dependencies

No dependencies set.

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