Files

T

CoreRasurae cc24d8c8ac fix(cli): remove legacy plan commands from help output

Completely removed all legacy plan commands from the CLI:
    - Removed tell, build, new, current, cd, continue CLI commands
    - Removed programmatic wrapper functions (tell_command, build_command, etc.)
    - Removed legacy deprecation message
    - Updated help text to indicate V3 Plan Lifecycle exclusively
    - Removed stale references to tell/build in help output and command validation

    Removes the legacy 'tell' and 'build' CLI shortcuts from main.py:
    - Removed echo lines advertising tell/build commands
    - Removed tell/build from valid_cmds list
    - Removed tell/build from _LIGHTWEIGHT_COMMANDS frozenset
    - These dead entries were preventing helpful error messages

    Test infrastructure improvements:
    - Event bus exception test: Patch the module-level logger during emit() so that
      structlog.testing.capture_logs() can capture the logs. Without patching, the
      module-level logger created at import time is not captured by the context manager.
    - Session create/list commands: Suppress cleveragents.mcp logger to CRITICAL level
      during JSON/YAML output formatting to prevent health check warnings with ANSI codes
      from being written to stdout before JSON output, which breaks JSON parsing.
    - Extended plan_cli_coverage_boost with scenarios for estimation_result,
      invariants, execution_environment, validation_summary, and checkpoint
      coverage in _plan_spec_dict

    Documentation:
    - Created docs/Legacy_to_V3_Guide.md with comprehensive migration instructions
    - Updated CONTRIBUTING.md to document removal of legacy workflow
    - Updated CHANGELOG.md to reference issue #4181 instead of PR #10800

ISSUES CLOSED: #4181

2026-05-05 02:01:49 +00:00

2.2 KiB

Raw Blame History

Breaking Change: Legacy Plan Commands Removed (v3.5.0)

Version 3.5.0 of CleverAgents removes all legacy plan commands and requires use of the V3 Plan Lifecycle.

What Changed

The following legacy CLI commands have been completely removed:

agents tell - Use agents plan use <action> <project> instead
agents build - Use agents plan execute <plan-id> instead
agents new - Use agents plan use <action> <project> instead
agents current - Use agents plan status <plan-id> instead
agents cd - Use explicit <plan-id> in commands instead
agents continue - Use agents plan prompt <plan-id> "instructions" instead
agents apply (legacy) - Use agents plan apply <plan-id> instead
agents list (legacy) - Use agents plan list instead

Migration Required

If you have code, scripts, or tests that use the legacy commands, you must update them to use the V3 commands.

Quick Migration

Before (Legacy):

agents tell "Create a feature"
agents build
agents apply

After (V3):

agents plan use my-action ./src
agents plan execute 01HXM8C2ZK4Q7C2B3F2R4VYV6J
agents plan apply 01HXM8C2ZK4Q7C2B3F2R4VYV6J

Why This Change

Single Architecture: Removes maintenance burden of supporting two incompatible plan systems
Clarity: Users no longer need to understand the difference between legacy and V3 modes
Simplification: Reduces CLI complexity and confusion about which commands are current
V3 Advantages: The V3 architecture provides:
- Explicit ULID-based plan tracking
- Phase-aware execution (Strategize → Execute → Apply)
- Better error handling and recovery
- Decision tree inspection and correction
- Hierarchical subplan support
- Parallel execution capabilities

Migration Guide

See docs/Legacy_to_V3_Guide.md for detailed step-by-step migration instructions with examples.

Questions?

For more information on the V3 Plan Lifecycle, see:

CleverAgents Specification - Complete architectural reference
CLI Command Reference - Detailed command documentation
ADR-021: CLI and Output Rendering - Design decisions

2.2 KiB Raw Blame History