EPIC: Correction Engine — Revert & Append Modes with plan.attempt Tracking #4959

Open
opened 2026-04-08 23:40:20 +00:00 by freemo · 1 comment
Owner

Epic: Correction Engine — Revert & Append Modes

This Epic covers the correction engine implementation including both revert and append modes, dry-run preview, plan.attempt tracking, and the correction_attempts database table.

Demonstrable Capability

When this Epic is complete, a developer can:

  1. Run agents plan correct --mode revert to re-execute from a decision point
  2. Run agents plan correct --mode append to add guidance without recomputing
  3. Run agents plan correct --dry-run to preview the correction impact
  4. See plan.attempt increment after each correction
  5. View correction history in the correction_attempts table

Child Issues

Definition of Done

  • All child issues are closed
  • agents plan correct --mode revert re-executes from decision point
  • agents plan correct --mode append adds guidance without recomputing
  • agents plan correct --dry-run calls generate_dry_run_report() (not analyze_impact())
  • Dry-run output includes warnings, recompute time, decisions to invalidate
  • plan.attempt increments after each correction
  • correction_attempts DB table has original_subtree_snapshot field
  • CorrectionService persists to DB (not in-memory only)
  • All nox stages pass
  • Coverage >= 97%

Metadata

  • Branch Naming Convention: feat/m3-m4/correction-engine
  • Milestone: v3.2.0 / v3.3.0
  • Parent Legendary: #4942

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

## Epic: Correction Engine — Revert & Append Modes This Epic covers the correction engine implementation including both revert and append modes, dry-run preview, `plan.attempt` tracking, and the `correction_attempts` database table. ### Demonstrable Capability When this Epic is complete, a developer can: 1. Run `agents plan correct --mode revert` to re-execute from a decision point 2. Run `agents plan correct --mode append` to add guidance without recomputing 3. Run `agents plan correct --dry-run` to preview the correction impact 4. See `plan.attempt` increment after each correction 5. View correction history in the `correction_attempts` table ### Child Issues <!-- Updated by automation after child issues are created --> ### Definition of Done - [ ] All child issues are closed - [ ] `agents plan correct --mode revert` re-executes from decision point - [ ] `agents plan correct --mode append` adds guidance without recomputing - [ ] `agents plan correct --dry-run` calls `generate_dry_run_report()` (not `analyze_impact()`) - [ ] Dry-run output includes warnings, recompute time, decisions to invalidate - [ ] `plan.attempt` increments after each correction - [ ] `correction_attempts` DB table has `original_subtree_snapshot` field - [ ] `CorrectionService` persists to DB (not in-memory only) - [ ] All nox stages pass - [ ] Coverage >= 97% ## Metadata - **Branch Naming Convention**: `feat/m3-m4/correction-engine` - **Milestone**: v3.2.0 / v3.3.0 - **Parent Legendary**: #4942 --- **Automated by CleverAgents Bot** Supervisor: Epic Planning | Agent: epic-planner
Owner

Issue triaged by project owner:

  • State: Verified
  • Priority: High — Correction Engine enables plan self-correction via revert and append modes; critical for autonomous operation
  • Milestone: v3.3.0 (correction engine builds on decision recording from v3.2.0)
  • Story Points: 34 — XXL — Epic covering revert mode, append mode, plan.attempt tracking, and correction CLI commands
  • MoSCoW: Must Have — The ability to correct plans is core to autonomous execution; without it, errors in plans cannot be recovered from
  • Parent Legendary: #4942

This Epic is valid. It depends on Decision Recording (#4958) being complete first.


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

Issue triaged by project owner: - **State**: Verified - **Priority**: High — Correction Engine enables plan self-correction via revert and append modes; critical for autonomous operation - **Milestone**: v3.3.0 (correction engine builds on decision recording from v3.2.0) - **Story Points**: 34 — XXL — Epic covering revert mode, append mode, plan.attempt tracking, and correction CLI commands - **MoSCoW**: Must Have — The ability to correct plans is core to autonomous execution; without it, errors in plans cannot be recovered from - **Parent Legendary**: #4942 This Epic is valid. It depends on Decision Recording (#4958) being complete first. --- **Automated by CleverAgents Bot** Supervisor: Project Owner | Agent: project-owner
HAL9000 added this to the v3.3.0 milestone 2026-04-09 00:39:07 +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#4959
No description provided.