fix(cli): remove legacy command references from error messages and standardize V3-only error guidance #4377

Open
opened 2026-04-08 11:25:23 +00:00 by HAL9000 · 0 comments
Owner

Metadata

  • Commit Message: fix(cli): remove legacy command references from error messages and standardize V3-only error guidance
  • Branch: fix/cli-error-messages-v3-only
  • Parent Epic: #4182

Background and Context

Epic #4182 identifies that CLI error messages in src/cleveragents/cli/commands/plan.py (lines 56–72) acknowledge the incompatibility between legacy and V3 workflows but still reference legacy commands. Since the goal is to remove legacy commands entirely, error messages should only reference V3 commands and guide users to the migration guide.

Expected Behavior

All CLI error messages:

  • Reference only V3 commands (agents plan use, agents plan execute, agents plan apply)
  • Do not mention legacy commands (agents tell, agents build) as alternatives
  • Direct users to docs/Legacy_to_V3_Guide.md when they encounter workflow confusion
  • Provide clear, actionable guidance for the V3 workflow

Acceptance Criteria

  • All error messages in src/cleveragents/cli/commands/plan.py reference only V3 commands
  • Error messages that previously mentioned legacy commands now reference the migration guide
  • Error messages are clear and actionable for V3 workflow users
  • No references to agents tell, agents build, or other legacy commands in error output

Supporting Information

  • Key files: src/cleveragents/cli/commands/plan.py (error messages: lines 56–72)
  • Related: #4181 (CLI help output), #4376 (migration guide), #4182 (parent epic)

Subtasks

  • Audit all error messages in src/cleveragents/cli/commands/plan.py for legacy command references
  • Audit all error messages in other CLI command files for legacy references
  • Update error messages to reference only V3 commands
  • Add references to migration guide in relevant error messages
  • Tests (Behave): Add scenarios verifying error messages contain V3 commands only
  • Tests (Behave): Verify error messages reference migration guide where appropriate
  • Run nox (all default sessions), fix any errors
  • Verify coverage >= 97% via nox -s coverage_report

Definition of Done

This issue is complete when:

  • All subtasks above are completed and checked off.
  • All CLI error messages reference only V3 commands.
  • A Git commit is created where the first line of the commit message matches the Commit Message in Metadata exactly, followed by a blank line, then additional details.
  • The commit is pushed to the remote on the branch matching the Branch in Metadata exactly.
  • 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: Product Builder | Agent: epic-planner

## Metadata - **Commit Message**: `fix(cli): remove legacy command references from error messages and standardize V3-only error guidance` - **Branch**: `fix/cli-error-messages-v3-only` - **Parent Epic**: #4182 ## Background and Context Epic #4182 identifies that CLI error messages in `src/cleveragents/cli/commands/plan.py` (lines 56–72) acknowledge the incompatibility between legacy and V3 workflows but still reference legacy commands. Since the goal is to remove legacy commands entirely, error messages should only reference V3 commands and guide users to the migration guide. ## Expected Behavior All CLI error messages: - Reference only V3 commands (`agents plan use`, `agents plan execute`, `agents plan apply`) - Do not mention legacy commands (`agents tell`, `agents build`) as alternatives - Direct users to `docs/Legacy_to_V3_Guide.md` when they encounter workflow confusion - Provide clear, actionable guidance for the V3 workflow ## Acceptance Criteria - [ ] All error messages in `src/cleveragents/cli/commands/plan.py` reference only V3 commands - [ ] Error messages that previously mentioned legacy commands now reference the migration guide - [ ] Error messages are clear and actionable for V3 workflow users - [ ] No references to `agents tell`, `agents build`, or other legacy commands in error output ## Supporting Information - **Key files**: `src/cleveragents/cli/commands/plan.py` (error messages: lines 56–72) - **Related**: #4181 (CLI help output), #4376 (migration guide), #4182 (parent epic) ## Subtasks - [ ] Audit all error messages in `src/cleveragents/cli/commands/plan.py` for legacy command references - [ ] Audit all error messages in other CLI command files for legacy references - [ ] Update error messages to reference only V3 commands - [ ] Add references to migration guide in relevant error messages - [ ] Tests (Behave): Add scenarios verifying error messages contain V3 commands only - [ ] Tests (Behave): Verify error messages reference migration guide where appropriate - [ ] Run `nox` (all default sessions), fix any errors - [ ] Verify coverage >= 97% via `nox -s coverage_report` ## Definition of Done This issue is complete when: - All subtasks above are completed and checked off. - All CLI error messages reference only V3 commands. - A Git commit is created where the **first line** of the commit message matches the Commit Message in Metadata exactly, followed by a blank line, then additional details. - The commit is pushed to the remote on the branch matching the **Branch** in Metadata exactly. - 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: Product Builder | Agent: epic-planner
HAL9000 added this to the v3.5.0 milestone 2026-04-08 17:43:06 +00:00
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.

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