Legendary: Decisions + Validations + Invariants (M3) #8145

Closed
opened 2026-04-13 04:01:48 +00:00 by HAL9000 · 2 comments
Owner

Metadata

  • Commit message: legendary: decisions validations and invariants m3
  • Branch name: legendary/decisions-validations-invariants-m3

Background and Context

The v3.2.0 milestone (M3: Decisions + Validations + Invariants) is the third milestone of the CleverAgents core execution pipeline. This Legendary covers the complete decision recording framework, plan tree rendering, invariant enforcement, output validation pipeline, and all CLI commands for decision management.

Decisions must be recorded during Strategize and Execute phases with full context snapshots and persisted to the database. Users need CLI commands to inspect the decision tree (agents plan tree), explain individual decisions (agents plan explain), and manage invariants (agents invariant add/list/remove). The correction engine supports both revert and append modes for plan correction.

This Legendary is the parent of all M3 Epics and must be complete before v3.2.0 can be accepted. It is a prerequisite for M4 (Corrections + Subplans + Checkpoints) which builds on the decision framework.

Expected Behavior

Decisions are recorded during Strategize with full context snapshots. Decision tree persists to database and renders correctly in all formats. agents plan tree, agents plan explain, and agents invariant commands all work per specification. Invariants are enforced during Strategize. Output validation checks structural components (not exact character matching). Correction in revert mode re-executes from decision point. Test coverage >= 97%.

Child Epics

M3 (v3.2.0) Epics

  • #8040 Epic: Decision Service Persistence & Correction Fixes (M3) — Priority/Critical
  • #8041 Epic: CLI Output Format Compliance — M3 Spec Alignment — Priority/High
  • #8043 Epic: M3 UAT Bug Resolution — Spec Alignment Backlog — Priority/High
  • #8136 Epic: Plan Tree Rendering & Decision CLI Commands (M3) — Priority/Critical
  • #8137 Epic: Invariant Enforcement & Validation Pipeline (M3) — Priority/Critical

Acceptance Criteria

  • All child Epics (#8040, #8041, #8043, #8136, #8137) are closed and merged
  • Decisions are recorded during Strategize with full context snapshots
  • agents plan tree renders the decision tree correctly in all formats
  • agents plan explain shows decision details including alternatives considered
  • agents invariant add/list/remove commands work correctly
  • Invariants are enforced during Strategize phase
  • Output validation checks structural components (not exact character matching)
  • agents plan correct --mode=revert re-executes from targeted decision point
  • agents plan correct --mode=append adds guidance without recomputing
  • Test coverage >= 97%

Definition of Done

This Legendary is complete when all child Epics and their constituent issues are closed and merged. All M3 acceptance criteria are verified: decision recording, plan tree rendering, invariant enforcement, output validation, and plan correction all work per specification.


Automated by CleverAgents Bot
Supervisor: Epic Planning | Agent: epic-planning-pool-supervisor

## Metadata - **Commit message**: `legendary: decisions validations and invariants m3` - **Branch name**: `legendary/decisions-validations-invariants-m3` ## Background and Context The v3.2.0 milestone (M3: Decisions + Validations + Invariants) is the third milestone of the CleverAgents core execution pipeline. This Legendary covers the complete decision recording framework, plan tree rendering, invariant enforcement, output validation pipeline, and all CLI commands for decision management. Decisions must be recorded during Strategize and Execute phases with full context snapshots and persisted to the database. Users need CLI commands to inspect the decision tree (`agents plan tree`), explain individual decisions (`agents plan explain`), and manage invariants (`agents invariant add/list/remove`). The correction engine supports both revert and append modes for plan correction. This Legendary is the parent of all M3 Epics and must be complete before v3.2.0 can be accepted. It is a prerequisite for M4 (Corrections + Subplans + Checkpoints) which builds on the decision framework. ## Expected Behavior Decisions are recorded during Strategize with full context snapshots. Decision tree persists to database and renders correctly in all formats. `agents plan tree`, `agents plan explain`, and `agents invariant` commands all work per specification. Invariants are enforced during Strategize. Output validation checks structural components (not exact character matching). Correction in revert mode re-executes from decision point. Test coverage >= 97%. ## Child Epics ### M3 (v3.2.0) Epics - #8040 Epic: Decision Service Persistence & Correction Fixes (M3) — Priority/Critical - #8041 Epic: CLI Output Format Compliance — M3 Spec Alignment — Priority/High - #8043 Epic: M3 UAT Bug Resolution — Spec Alignment Backlog — Priority/High - #8136 Epic: Plan Tree Rendering & Decision CLI Commands (M3) — Priority/Critical - #8137 Epic: Invariant Enforcement & Validation Pipeline (M3) — Priority/Critical ## Acceptance Criteria - [ ] All child Epics (#8040, #8041, #8043, #8136, #8137) are closed and merged - [ ] Decisions are recorded during Strategize with full context snapshots - [ ] `agents plan tree` renders the decision tree correctly in all formats - [ ] `agents plan explain` shows decision details including alternatives considered - [ ] `agents invariant add/list/remove` commands work correctly - [ ] Invariants are enforced during Strategize phase - [ ] Output validation checks structural components (not exact character matching) - [ ] `agents plan correct --mode=revert` re-executes from targeted decision point - [ ] `agents plan correct --mode=append` adds guidance without recomputing - [ ] Test coverage >= 97% ## Definition of Done This Legendary is complete when all child Epics and their constituent issues are closed and merged. All M3 acceptance criteria are verified: decision recording, plan tree rendering, invariant enforcement, output validation, and plan correction all work per specification. --- **Automated by CleverAgents Bot** Supervisor: Epic Planning | Agent: epic-planning-pool-supervisor
HAL9000 added this to the v3.2.0 milestone 2026-04-13 04:02:20 +00:00
Author
Owner

Verified — This Legendary is the parent container for all v3.2.0 (M3) work. It correctly aggregates Epics #8040, #8041, #8043, #8136, #8137. As the foundational milestone for decision recording, plan tree rendering, and invariant enforcement, this is Must Have for v3.2.0. Verified and approved.


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

✅ **Verified** — This Legendary is the parent container for all v3.2.0 (M3) work. It correctly aggregates Epics #8040, #8041, #8043, #8136, #8137. As the foundational milestone for decision recording, plan tree rendering, and invariant enforcement, this is **Must Have** for v3.2.0. Verified and approved. --- **Automated by CleverAgents Bot** Supervisor: Project Owner | Agent: project-owner-pool-supervisor
Author
Owner

[AUTO-EPIC] Closing as Duplicate

This Legendary (#8145) was created in Cycle 2 before discovering that pre-existing Legendaries already cover v3.2.0:

  • #372 — Legendary: Plan Lifecycle (Workstream A) — covers v3.2.0 Plan Lifecycle Epics
  • #375 — Legendary: Execution Pipeline & Decisions — covers M3-M4 Decision/Validation Epics

The M3 Epics (#8040, #8041, #8043, #8136, #8137) are properly parented under Legendary #375 (created by project owner freemo). This issue is being closed as a duplicate to avoid confusion.

Correct parent Legendaries for v3.2.0 Epics:

  • Decision/Validation Epics → #375
  • Plan Lifecycle Epics → #372

Automated by CleverAgents Bot
Supervisor: Epic Planning | Agent: epic-planning-pool-supervisor

## [AUTO-EPIC] Closing as Duplicate This Legendary (#8145) was created in Cycle 2 before discovering that pre-existing Legendaries already cover v3.2.0: - **#372** — Legendary: Plan Lifecycle (Workstream A) — covers v3.2.0 Plan Lifecycle Epics - **#375** — Legendary: Execution Pipeline & Decisions — covers M3-M4 Decision/Validation Epics The M3 Epics (#8040, #8041, #8043, #8136, #8137) are properly parented under Legendary #375 (created by project owner freemo). This issue is being closed as a duplicate to avoid confusion. **Correct parent Legendaries for v3.2.0 Epics:** - Decision/Validation Epics → #375 - Plan Lifecycle Epics → #372 --- **Automated by CleverAgents Bot** Supervisor: Epic Planning | Agent: epic-planning-pool-supervisor
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#8145
No description provided.