UAT: `/plan:prompt` slash command missing from TUI slash catalog — spec-required command not discoverable #3652

New issue

Open

opened 2026-04-05 21:07:48 +00:00 by freemo · 1 comment

freemo commented

2026-04-05 21:07:48 +00:00

Owner

Metadata

Branch: fix/tui-slash-catalog-plan-prompt
Commit Message: fix(tui): add missing plan:prompt entry to SLASH_COMMAND_SPECS catalog
Milestone: None (Backlog)
Parent Epic: #868

Backlog note: This issue was discovered during autonomous operation
on milestone v3.7.0. It does not block milestone completion and has been
placed in the backlog for human review and future milestone assignment.

Summary

The SLASH_COMMAND_SPECS tuple in src/cleveragents/tui/slash_catalog.py is missing an entry for /plan:prompt. The spec (docs/specification.md, Plan Commands table) requires /plan:prompt <plan_id> <guidance> as a TUI slash command. The A2A facade registers _cleveragents/plan/prompt as a supported method, and the CLI has agents plan prompt implemented — but the TUI slash catalog omits this command entirely, making it undiscoverable via the / overlay.

What Was Tested

TUI slash command catalog completeness against the spec's Plan Commands table.

Expected Behavior (from spec)

SLASH_COMMAND_SPECS should contain an entry for /plan:prompt <plan_id> <guidance>, consistent with all other plan sub-commands already present in the catalog (plan:use, plan:execute, plan:apply, plan:status, plan:list, plan:cancel, plan:tree, plan:explain, plan:correct, plan:diff, plan:artifacts, plan:rollback, plan:errors, plan:resume, plan:revert).

Actual Behavior

No entry for plan:prompt exists in SLASH_COMMAND_SPECS. Users cannot discover or invoke /plan:prompt from the TUI slash command overlay.

Impact

/plan:prompt is the primary recovery mechanism when a plan errors — the spec explicitly references agents plan prompt in error-state guidance. Its absence from the TUI catalog means TUI users have no discoverable path to resume a plan after an error.

Code Location

src/cleveragents/tui/slash_catalog.py — SLASH_COMMAND_SPECS tuple

Subtasks

Add plan:prompt entry to SLASH_COMMAND_SPECS in src/cleveragents/tui/slash_catalog.py with correct signature <plan_id> <guidance> and description
Verify the new entry is consistent in structure with adjacent plan sub-command entries (same field ordering, typing, help text style)
Tests (Behave): Add/extend scenario asserting plan:prompt is present in SLASH_COMMAND_SPECS and has the correct signature
Tests (Behave): Add TDD issue-capture test tagged @tdd_expected_fail demonstrating the missing entry before the fix
Run nox -e lint and nox -e typecheck, fix any errors
Verify coverage >= 97% via nox -e coverage_report
Run nox (all default sessions), fix any errors

Definition of Done

This issue is complete when:

All subtasks above are completed and checked off.
A Git commit is created where the first line of the commit message matches the Commit Message in Metadata exactly (fix(tui): add missing plan:prompt entry to SLASH_COMMAND_SPECS catalog), followed by a blank line, then additional lines providing relevant details about the implementation.
The commit is pushed to the remote on the branch matching the Branch in Metadata exactly (fix/tui-slash-catalog-plan-prompt).
The commit is submitted as a pull request to master, reviewed, and merged before this issue is marked done.
All nox stages pass.
Coverage >= 97%.

Automated by CleverAgents Bot
Supervisor: UAT Testing | Agent: ca-uat-tester

## Metadata - **Branch**: `fix/tui-slash-catalog-plan-prompt` - **Commit Message**: `fix(tui): add missing plan:prompt entry to SLASH_COMMAND_SPECS catalog` - **Milestone**: None (Backlog) - **Parent Epic**: #868 > **Backlog note:** This issue was discovered during autonomous operation > on milestone v3.7.0. It does not block milestone completion and has been > placed in the backlog for human review and future milestone assignment. ## Summary The `SLASH_COMMAND_SPECS` tuple in `src/cleveragents/tui/slash_catalog.py` is missing an entry for `/plan:prompt`. The spec (docs/specification.md, Plan Commands table) requires `/plan:prompt <plan_id> <guidance>` as a TUI slash command. The A2A facade registers `_cleveragents/plan/prompt` as a supported method, and the CLI has `agents plan prompt` implemented — but the TUI slash catalog omits this command entirely, making it undiscoverable via the `/` overlay. ## What Was Tested TUI slash command catalog completeness against the spec's Plan Commands table. ## Expected Behavior (from spec) `SLASH_COMMAND_SPECS` should contain an entry for `/plan:prompt <plan_id> <guidance>`, consistent with all other plan sub-commands already present in the catalog (`plan:use`, `plan:execute`, `plan:apply`, `plan:status`, `plan:list`, `plan:cancel`, `plan:tree`, `plan:explain`, `plan:correct`, `plan:diff`, `plan:artifacts`, `plan:rollback`, `plan:errors`, `plan:resume`, `plan:revert`). ## Actual Behavior No entry for `plan:prompt` exists in `SLASH_COMMAND_SPECS`. Users cannot discover or invoke `/plan:prompt` from the TUI slash command overlay. ## Impact `/plan:prompt` is the primary recovery mechanism when a plan errors — the spec explicitly references `agents plan prompt` in error-state guidance. Its absence from the TUI catalog means TUI users have no discoverable path to resume a plan after an error. ## Code Location `src/cleveragents/tui/slash_catalog.py` — `SLASH_COMMAND_SPECS` tuple ## Subtasks - [ ] Add `plan:prompt` entry to `SLASH_COMMAND_SPECS` in `src/cleveragents/tui/slash_catalog.py` with correct signature `<plan_id> <guidance>` and description - [ ] Verify the new entry is consistent in structure with adjacent plan sub-command entries (same field ordering, typing, help text style) - [ ] Tests (Behave): Add/extend scenario asserting `plan:prompt` is present in `SLASH_COMMAND_SPECS` and has the correct signature - [ ] Tests (Behave): Add TDD issue-capture test tagged `@tdd_expected_fail` demonstrating the missing entry before the fix - [ ] Run `nox -e lint` and `nox -e typecheck`, fix any errors - [ ] Verify coverage >= 97% via `nox -e coverage_report` - [ ] Run `nox` (all default sessions), fix any errors ## Definition of Done This issue is complete when: - All subtasks above are completed and checked off. - A Git commit is created where the **first line** of the commit message matches the Commit Message in Metadata exactly (`fix(tui): add missing plan:prompt entry to SLASH_COMMAND_SPECS catalog`), followed by a blank line, then additional lines providing relevant details about the implementation. - The commit is pushed to the remote on the branch matching the **Branch** in Metadata exactly (`fix/tui-slash-catalog-plan-prompt`). - The commit is submitted as a **pull request** to `master`, reviewed, and **merged** before this issue is marked done. - All nox stages pass. - Coverage >= 97%. --- **Automated by CleverAgents Bot** Supervisor: UAT Testing | Agent: ca-uat-tester

freemo added a new dependency

2026-04-05 21:08:09 +00:00

#868 Epic: TUI Interface, Modals and Persona System

freemo referenced this issue

2026-04-05 21:23:18 +00:00

[Automated] CleverAgents Build Session - 2026-04-05 #3377

freemo referenced this issue

2026-04-05 21:24:08 +00:00

[Automated] CleverAgents Build Session - 2026-04-05 #3377

freemo commented

2026-04-05 22:14:45 +00:00

Author

Owner

Issue triaged by project owner:

State: Verified
Priority: Backlog — Missing TUI slash command entry. The CLI equivalent works; this only affects TUI discoverability.
Story Points: 1 — XS — Add a single tuple entry to the slash command catalog.
MoSCoW: Should Have — /plan:prompt is the primary recovery mechanism for errored plans. Its absence from the TUI catalog means TUI users cannot discover this critical recovery path. The spec requires it.
Parent Epic: #868

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

Issue triaged by project owner: - **State**: Verified - **Priority**: Backlog — Missing TUI slash command entry. The CLI equivalent works; this only affects TUI discoverability. - **Story Points**: 1 — XS — Add a single tuple entry to the slash command catalog. - **MoSCoW**: Should Have — `/plan:prompt` is the primary recovery mechanism for errored plans. Its absence from the TUI catalog means TUI users cannot discover this critical recovery path. The spec requires it. - **Parent Epic**: #868 --- **Automated by CleverAgents Bot** Supervisor: Project Owner | Agent: ca-project-owner

freemo referenced this issue

2026-04-05 22:16:05 +00:00

[Automated] CleverAgents Build Session - 2026-04-05 (Resumed) #3654