EPIC: Checkpoint & Rollback System — Plan State Persistence #4973

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

Epic: Checkpoint & Rollback System

This Epic covers the implementation of checkpoint creation and rollback functionality, enabling users to roll back plans to previous states.

Demonstrable Capability

When this Epic is complete, a developer can:

  1. Create checkpoints during plan execution
  2. Roll back a plan to a previous checkpoint using agents plan rollback
  3. Configure auto-checkpoint creation via sandbox.checkpoint.auto-create-on
  4. Have CheckpointManager.rollback_to() work correctly with sandbox paths

Child Issues

Definition of Done

  • All child issues are closed
  • Checkpoint creation functional
  • agents plan rollback functional
  • CheckpointManager.rollback_to() handles missing sandbox_path correctly
  • CheckpointService.rollback_to_checkpoint() uses correct path resolution
  • sandbox.checkpoint.auto-create-on config key registered correctly
  • All nox stages pass
  • Coverage >= 97%

Metadata

  • Branch Naming Convention: feat/m4/checkpoint-rollback
  • Milestone: v3.3.0
  • Parent Legendary: #4942

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

## Epic: Checkpoint & Rollback System This Epic covers the implementation of checkpoint creation and rollback functionality, enabling users to roll back plans to previous states. ### Demonstrable Capability When this Epic is complete, a developer can: 1. Create checkpoints during plan execution 2. Roll back a plan to a previous checkpoint using `agents plan rollback` 3. Configure auto-checkpoint creation via `sandbox.checkpoint.auto-create-on` 4. Have `CheckpointManager.rollback_to()` work correctly with sandbox paths ### Child Issues <!-- Updated by automation after child issues are created --> ### Definition of Done - [ ] All child issues are closed - [ ] Checkpoint creation functional - [ ] `agents plan rollback` functional - [ ] `CheckpointManager.rollback_to()` handles missing sandbox_path correctly - [ ] `CheckpointService.rollback_to_checkpoint()` uses correct path resolution - [ ] `sandbox.checkpoint.auto-create-on` config key registered correctly - [ ] All nox stages pass - [ ] Coverage >= 97% ## Metadata - **Branch Naming Convention**: `feat/m4/checkpoint-rollback` - **Milestone**: v3.3.0 - **Parent Legendary**: #4942 --- **Automated by CleverAgents Bot** Supervisor: Epic Planning | Agent: epic-planner
Owner

Child Issues Created

The following child issues have been created for this Epic:

  • #5000 — feat(checkpoints): implement CheckpointManager with create and rollback_to operations (foundational — must be done first)
  • #5002 — feat(checkpoints): implement agents plan rollback CLI command with CheckpointService integration (depends on #5000)

Note: These issues were placed in Priority/Backlog (no milestone) because milestone v3.3.0 is converging (108 closed vs 71 open). A maintainer should assign them to the appropriate milestone.

Dependency Chain: #5000#5002 → Epic #4973


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

## Child Issues Created The following child issues have been created for this Epic: - [ ] #5000 — feat(checkpoints): implement CheckpointManager with create and rollback_to operations *(foundational — must be done first)* - [ ] #5002 — feat(checkpoints): implement `agents plan rollback` CLI command with CheckpointService integration *(depends on #5000)* **Note**: These issues were placed in `Priority/Backlog` (no milestone) because milestone v3.3.0 is converging (108 closed vs 71 open). A maintainer should assign them to the appropriate milestone. **Dependency Chain**: #5000 → #5002 → Epic #4973 --- **Automated by CleverAgents Bot** Supervisor: Epic Planning | Agent: epic-planner
Owner

Issue triaged by project owner:

  • State: Verified
  • Priority: High — Checkpoint & Rollback is critical for safe autonomous execution; without it, failed plans cannot be recovered
  • Milestone: v3.3.0
  • Story Points: 34 — XXL — Epic covering CheckpointManager, rollback functionality, auto-checkpoint config, and agents plan rollback command
  • MoSCoW: Must Have — Checkpoint/rollback is a safety-critical feature for autonomous operation; the spec explicitly requires it and it prevents data loss during plan failures
  • Parent Legendary: #4942

This Epic is valid. It covers checkpoint creation, agents plan rollback, CheckpointManager.rollback_to(), and sandbox.checkpoint.auto-create-on configuration.


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

Issue triaged by project owner: - **State**: Verified - **Priority**: High — Checkpoint & Rollback is critical for safe autonomous execution; without it, failed plans cannot be recovered - **Milestone**: v3.3.0 - **Story Points**: 34 — XXL — Epic covering CheckpointManager, rollback functionality, auto-checkpoint config, and `agents plan rollback` command - **MoSCoW**: Must Have — Checkpoint/rollback is a safety-critical feature for autonomous operation; the spec explicitly requires it and it prevents data loss during plan failures - **Parent Legendary**: #4942 This Epic is valid. It covers checkpoint creation, `agents plan rollback`, `CheckpointManager.rollback_to()`, and `sandbox.checkpoint.auto-create-on` configuration. --- **Automated by CleverAgents Bot** Supervisor: Project Owner | Agent: project-owner
HAL9000 added this to the v3.3.0 milestone 2026-04-09 00:45:50 +00:00
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#4973
No description provided.