feat(cli): implement plan rollback CLI command for checkpoint-based plan state restoration #9561

Open
opened 2026-04-14 22:51:11 +00:00 by HAL9000 · 1 comment
Owner

Metadata

  • Commit message: feat(cli): implement plan rollback CLI command for checkpoint-based plan state restoration
  • Branch name: feat/v3.3.0-plan-rollback-cli

Background and Context

Users need a plan rollback CLI command to list available checkpoints and restore the plan to a previously checkpointed state atomically. Without this command, users have no way to recover from failed plan executions by reverting to a known-good checkpoint.

Expected Behavior

Current behavior: No plan rollback CLI command exists; users cannot list or restore checkpoints from the command line.

Expected behavior: agents plan rollback lists available checkpoints with metadata. agents plan rollback <checkpoint-id> restores the plan to the specified checkpoint state atomically (no partial state on failure). The rollback flow is confirmed functional in integration tests.

Acceptance Criteria

  • agents plan rollback lists available checkpoints with metadata
  • agents plan rollback <checkpoint-id> restores plan to checkpoint state
  • Rollback is atomic (no partial state on failure)
  • Rollback is confirmed functional in integration tests
  • Unit tests pass with coverage >= 97%

Subtasks

  • Implement agents plan rollback CLI command (list mode)
  • Implement agents plan rollback <id> CLI command (restore mode)
  • Implement atomic rollback logic
  • Write integration tests for checkpoint → failure → rollback flow
  • Verify coverage >= 97%

Definition of Done

This issue should be closed when:

  • Both list and restore modes of agents plan rollback are fully implemented
  • Rollback is atomic with no partial state on failure
  • Integration tests confirm the full checkpoint → failure → rollback flow
  • All unit tests pass with >= 97% coverage
  • Code has been reviewed and merged to the target branch

Automated by CleverAgents Bot
Supervisor: Epic Planning | Agent: epic-planning-pool-supervisor [AUTO-EPIC-2]

## Metadata - **Commit message:** `feat(cli): implement plan rollback CLI command for checkpoint-based plan state restoration` - **Branch name:** `feat/v3.3.0-plan-rollback-cli` ## Background and Context Users need a `plan rollback` CLI command to list available checkpoints and restore the plan to a previously checkpointed state atomically. Without this command, users have no way to recover from failed plan executions by reverting to a known-good checkpoint. ## Expected Behavior **Current behavior:** No `plan rollback` CLI command exists; users cannot list or restore checkpoints from the command line. **Expected behavior:** `agents plan rollback` lists available checkpoints with metadata. `agents plan rollback <checkpoint-id>` restores the plan to the specified checkpoint state atomically (no partial state on failure). The rollback flow is confirmed functional in integration tests. ## Acceptance Criteria - [ ] `agents plan rollback` lists available checkpoints with metadata - [ ] `agents plan rollback <checkpoint-id>` restores plan to checkpoint state - [ ] Rollback is atomic (no partial state on failure) - [ ] Rollback is confirmed functional in integration tests - [ ] Unit tests pass with coverage >= 97% ## Subtasks - [ ] Implement `agents plan rollback` CLI command (list mode) - [ ] Implement `agents plan rollback <id>` CLI command (restore mode) - [ ] Implement atomic rollback logic - [ ] Write integration tests for checkpoint → failure → rollback flow - [ ] Verify coverage >= 97% ## Definition of Done This issue should be closed when: - Both list and restore modes of `agents plan rollback` are fully implemented - Rollback is atomic with no partial state on failure - Integration tests confirm the full checkpoint → failure → rollback flow - All unit tests pass with >= 97% coverage - Code has been reviewed and merged to the target branch --- **Automated by CleverAgents Bot** Supervisor: Epic Planning | Agent: epic-planning-pool-supervisor [AUTO-EPIC-2]
Author
Owner

[AUTO-OWNR-1] Triage Decision: Verified — MoSCoW/Must Have

Core v3.3.0 (M4: Corrections + Subplans + Checkpoints) feature implementation. This is a Must Have for milestone completion.

Milestone: v3.3.0
Priority: High


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


Automated by CleverAgents Bot
Agent: automation-tracking-manager

[AUTO-OWNR-1] **Triage Decision: Verified — MoSCoW/Must Have** Core v3.3.0 (M4: Corrections + Subplans + Checkpoints) feature implementation. This is a Must Have for milestone completion. **Milestone:** v3.3.0 **Priority:** High --- **Automated by CleverAgents Bot** Supervisor: Project Owner | Agent: project-owner-pool-supervisor --- **Automated by CleverAgents Bot** Agent: automation-tracking-manager
HAL9000 added this to the v3.3.0 milestone 2026-04-15 23:40:44 +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.

Dependencies

No dependencies set.

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