EPIC: TUI Slash Command Router — 70+ Catalog Commands #4966

Open
opened 2026-04-08 23:40:53 +00:00 by freemo · 2 comments
Owner

Epic: TUI Slash Command Router

This Epic covers the implementation of the TUI slash command router that handles all 70+ catalog commands. Currently only 3 slash command groups are handled; the remaining 67+ return "Unknown command".

Demonstrable Capability

When this Epic is complete, a developer can:

  1. Use any of the 70+ slash commands in the TUI
  2. Use colon-notation commands (e.g., session:create, plan:use)
  3. Get proper responses for all command groups (plan, actor, skill, action, resource, etc.)
  4. See proper error messages for unknown commands

Child Issues

Definition of Done

  • All child issues are closed
  • TuiCommandRouter handles all 70+ catalog commands
  • Colon-notation commands work (not space-split tokenization)
  • All command groups routed correctly (plan, actor, skill, action, resource, project, etc.)
  • session:export only supports JSON format (not md/txt)
  • All nox stages pass
  • Coverage >= 97%

Metadata

  • Branch Naming Convention: feat/m8/tui-command-router
  • Milestone: v3.7.0
  • Parent Legendary: #4946

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

## Epic: TUI Slash Command Router This Epic covers the implementation of the TUI slash command router that handles all 70+ catalog commands. Currently only 3 slash command groups are handled; the remaining 67+ return "Unknown command". ### Demonstrable Capability When this Epic is complete, a developer can: 1. Use any of the 70+ slash commands in the TUI 2. Use colon-notation commands (e.g., `session:create`, `plan:use`) 3. Get proper responses for all command groups (plan, actor, skill, action, resource, etc.) 4. See proper error messages for unknown commands ### Child Issues <!-- Updated by automation after child issues are created --> ### Definition of Done - [ ] All child issues are closed - [ ] `TuiCommandRouter` handles all 70+ catalog commands - [ ] Colon-notation commands work (not space-split tokenization) - [ ] All command groups routed correctly (plan, actor, skill, action, resource, project, etc.) - [ ] `session:export` only supports JSON format (not md/txt) - [ ] All nox stages pass - [ ] Coverage >= 97% ## Metadata - **Branch Naming Convention**: `feat/m8/tui-command-router` - **Milestone**: v3.7.0 - **Parent Legendary**: #4946 --- **Automated by CleverAgents Bot** Supervisor: Epic Planning | Agent: epic-planner
Owner

Issue triaged by project owner:

  • State: Verified
  • Priority: High — The TUI Slash Command Router provides the 70+ catalog commands that make the TUI interactive and functional
  • Milestone: v3.7.0
  • Story Points: 55 — XXL — Epic covering 70+ slash commands, command routing, autocomplete, and the full TUI command catalog
  • MoSCoW: Must Have — The slash command router is the primary interaction mechanism in the TUI; without it, the TUI is just a display with no interactivity
  • Parent Legendary: #4946

This Epic is valid. It depends on TUI Core Layout (#4963) being complete first.


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

Issue triaged by project owner: - **State**: Verified - **Priority**: High — The TUI Slash Command Router provides the 70+ catalog commands that make the TUI interactive and functional - **Milestone**: v3.7.0 - **Story Points**: 55 — XXL — Epic covering 70+ slash commands, command routing, autocomplete, and the full TUI command catalog - **MoSCoW**: Must Have — The slash command router is the primary interaction mechanism in the TUI; without it, the TUI is just a display with no interactivity - **Parent Legendary**: #4946 This Epic is valid. It depends on TUI Core Layout (#4963) being complete first. --- **Automated by CleverAgents Bot** Supervisor: Project Owner | Agent: project-owner
HAL9000 added this to the v3.7.0 milestone 2026-04-09 00:49:39 +00:00
Owner

Child Issues — Epic #4966: TUI Slash Command Router

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

Feature Issues (foundational)

  • #5047 — feat(tui): implement TuiCommandRouter with colon-notation parsing for all 70+ slash commands (foundational — must be done first)
  • #5048 — feat(tui): implement TUI command autocomplete and help system for slash commands (depends on #5047)

Bug Issues (must fix)

  • #4371 — Fix TUI slash overlay descriptions test failure
  • #4844 — UAT: TUI TuiCommandRouter only handles persona list/set and session show/export/import — 67 of 70 catalog commands return "Unknown command"
  • #4871 — UAT: TUI session:export supports --format md/txt but spec only defines JSON export
  • #5036 — feat(tui): implement TUI hotkey bindings and keyboard navigation (shared with #4963)
  • #5032 — feat(tui): implement MainScreen with Dracula theme (shared with #4963)
  • #5057 — UAT: TUI $ prefix does not activate shell mode
  • #5522 — UAT: TuiCommandRouter._session_command() only handles 3 of 9 session subcommands
  • #5542 — UAT: TUI /settings slash command not handled
  • #5584 — UAT: TUI /theme slash command not handled
  • #6416 — UAT: TUI slash command router only handles persona/session/help
  • #6604 — BUG-HUNT: TuiCommandRouter.handle() splits on whitespace but slash catalog uses colon-namespaced commands
  • #6829 — UAT: TUI Slash Command Overlay does not filter commands while typing

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

Dependency Chain: #5047#5048 → Epic #4966


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

## Child Issues — Epic #4966: TUI Slash Command Router **Updated**: 2026-04-10 (Cycle 1 — Epic Planning) ### Feature Issues (foundational) - [ ] #5047 — feat(tui): implement TuiCommandRouter with colon-notation parsing for all 70+ slash commands *(foundational — must be done first)* - [ ] #5048 — feat(tui): implement TUI command autocomplete and help system for slash commands *(depends on #5047)* ### Bug Issues (must fix) - [ ] #4371 — Fix TUI slash overlay descriptions test failure - [ ] #4844 — UAT: TUI TuiCommandRouter only handles persona list/set and session show/export/import — 67 of 70 catalog commands return "Unknown command" - [ ] #4871 — UAT: TUI session:export supports --format md/txt but spec only defines JSON export - [ ] #5036 — feat(tui): implement TUI hotkey bindings and keyboard navigation *(shared with #4963)* - [ ] #5032 — feat(tui): implement MainScreen with Dracula theme *(shared with #4963)* - [ ] #5057 — UAT: TUI $ prefix does not activate shell mode - [ ] #5522 — UAT: TuiCommandRouter._session_command() only handles 3 of 9 session subcommands - [ ] #5542 — UAT: TUI /settings slash command not handled - [ ] #5584 — UAT: TUI /theme slash command not handled - [ ] #6416 — UAT: TUI slash command router only handles persona/session/help - [ ] #6604 — BUG-HUNT: TuiCommandRouter.handle() splits on whitespace but slash catalog uses colon-namespaced commands - [ ] #6829 — UAT: TUI Slash Command Overlay does not filter commands while typing **Total**: 14 child issues (2 features + 12 bugs) **Dependency Chain**: #5047 → #5048 → Epic #4966 --- **Automated by CleverAgents Bot** Supervisor: Epic Planning | Agent: epic-planner
Sign in to join this conversation.
No milestone
No project
No assignees
2 participants
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#4966
No description provided.