Epic: M3 UAT Bug Resolution — Spec Alignment Backlog #8043

Open
opened 2026-04-13 01:12:08 +00:00 by HAL9000 · 4 comments
Owner

Metadata

  • Commit message: epic: m3 uat bug resolution spec alignment backlog
  • Branch name: epic/m3-uat-bug-resolution-spec-alignment-backlog

Background and Context

UAT testing of v3.2.0 has produced a large backlog of spec alignment bugs. These bugs represent gaps between the current implementation and the specification requirements. This Epic tracks the overall UAT bug resolution effort for the M3 milestone.

The bugs span multiple feature areas including:

  • Plan lifecycle (plan use, execute, apply, diff, correct)
  • Configuration management (agents config)
  • Decision service and tree
  • Invariant enforcement
  • Output format compliance
  • Checkpoint and rollback
  • Resource management

Expected Behavior

All UAT-identified spec alignment bugs are resolved. The implementation matches the specification for all M3 acceptance criteria. The milestone can be accepted by the product team.

Acceptance Criteria

  • All Priority/Critical UAT bugs in v3.2.0 are closed
  • All Priority/High UAT bugs in v3.2.0 are closed
  • All M3 milestone acceptance criteria pass UAT verification
  • No open State/Verified bugs remain in v3.2.0
  • The milestone is accepted by the product team

Subtasks

  • Triage all open UAT bugs in v3.2.0 milestone
  • Resolve all Priority/Critical UAT bugs
  • Resolve all Priority/High UAT bugs
  • Fix DecisionService dependency edge persistence (#7926)
  • Fix Apply phase Definition-of-Done gating (#7927)
  • Fix --format color uncoloured plain text output (#7910)
  • Fix agents plan tree --format json list vs structured object (#7944)
  • Fix Plan CLI JSON output spec divergence (#7945)
  • Verify all M3 acceptance criteria pass UAT
  • Obtain product team milestone acceptance sign-off

Child Issues

See all open issues in v3.2.0 with Type/Bug and State/Verified labels. Key critical bugs:

  • #7926 UAT: DecisionService does not persist decision dependency edges (Critical)
  • #7927 UAT: Apply phase ignores Definition-of-Done gating (High)
  • #7910 UAT: --format color outputs uncoloured plain text (High)
  • #7944 UAT: plan tree --format json returns list instead of structured object (Backlog)
  • #7945 UAT: Plan CLI JSON outputs diverge from specification (Backlog)
  • #8830 agents automation-profile add --update should warn if no existing profile (Low)
  • #8848 — CI Performance: Investigate and Optimize Long-Running Smoke Tests
  • #8847 — Fix: Robot Framework test 'Session Tell Appends Message' fails
  • #8834 — fix: plan use crashes with sqlite3.IntegrityError on action_arguments UNIQUE constraint
  • #8854 — Improve test infrastructure to easily generate and view coverage reports

Additional child issues: All open UAT bugs in v3.2.0 milestone.

Parent Legendary

Depends on: Legendary #375 (Execution Pipeline & Decisions)

Definition of Done

This Epic is complete when:

  • All Priority/Critical and Priority/High UAT bugs in v3.2.0 are closed
  • All M3 milestone acceptance criteria pass UAT verification
  • No open State/Verified bugs remain in v3.2.0

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

## Metadata - **Commit message**: `epic: m3 uat bug resolution spec alignment backlog` - **Branch name**: `epic/m3-uat-bug-resolution-spec-alignment-backlog` ## Background and Context UAT testing of v3.2.0 has produced a large backlog of spec alignment bugs. These bugs represent gaps between the current implementation and the specification requirements. This Epic tracks the overall UAT bug resolution effort for the M3 milestone. The bugs span multiple feature areas including: - Plan lifecycle (plan use, execute, apply, diff, correct) - Configuration management (agents config) - Decision service and tree - Invariant enforcement - Output format compliance - Checkpoint and rollback - Resource management ## Expected Behavior All UAT-identified spec alignment bugs are resolved. The implementation matches the specification for all M3 acceptance criteria. The milestone can be accepted by the product team. ## Acceptance Criteria - [ ] All `Priority/Critical` UAT bugs in v3.2.0 are closed - [ ] All `Priority/High` UAT bugs in v3.2.0 are closed - [ ] All M3 milestone acceptance criteria pass UAT verification - [ ] No open `State/Verified` bugs remain in v3.2.0 - [ ] The milestone is accepted by the product team ## Subtasks - [ ] Triage all open UAT bugs in v3.2.0 milestone - [ ] Resolve all `Priority/Critical` UAT bugs - [ ] Resolve all `Priority/High` UAT bugs - [ ] Fix DecisionService dependency edge persistence (#7926) - [ ] Fix Apply phase Definition-of-Done gating (#7927) - [ ] Fix `--format color` uncoloured plain text output (#7910) - [ ] Fix `agents plan tree --format json` list vs structured object (#7944) - [ ] Fix Plan CLI JSON output spec divergence (#7945) - [ ] Verify all M3 acceptance criteria pass UAT - [ ] Obtain product team milestone acceptance sign-off ## Child Issues See all open issues in v3.2.0 with `Type/Bug` and `State/Verified` labels. Key critical bugs: - #7926 UAT: DecisionService does not persist decision dependency edges (Critical) - #7927 UAT: Apply phase ignores Definition-of-Done gating (High) - #7910 UAT: --format color outputs uncoloured plain text (High) - #7944 UAT: plan tree --format json returns list instead of structured object (Backlog) - #7945 UAT: Plan CLI JSON outputs diverge from specification (Backlog) - #8830 `agents automation-profile add --update` should warn if no existing profile (Low) - #8848 — CI Performance: Investigate and Optimize Long-Running Smoke Tests - #8847 — Fix: Robot Framework test 'Session Tell Appends Message' fails - #8834 — fix: plan use crashes with sqlite3.IntegrityError on action_arguments UNIQUE constraint - #8854 — Improve test infrastructure to easily generate and view coverage reports Additional child issues: All open UAT bugs in v3.2.0 milestone. ## Parent Legendary Depends on: Legendary #375 (Execution Pipeline & Decisions) ## Definition of Done This Epic is complete when: - All `Priority/Critical` and `Priority/High` UAT bugs in v3.2.0 are closed - All M3 milestone acceptance criteria pass UAT verification - No open `State/Verified` bugs remain in v3.2.0 --- **Automated by CleverAgents Bot** Supervisor: Epic Planning | Agent: epic-planning-pool-supervisor
HAL9000 added this to the v3.2.0 milestone 2026-04-13 01:12:45 +00:00
Author
Owner

New Child Issue Linked

Issue #8319 (Missing docstrings in langgraph module) has been linked as a child of this Epic.

Status: Open — pending implementation
Milestone: v3.2.0


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

## New Child Issue Linked Issue #8319 (Missing docstrings in langgraph module) has been linked as a child of this Epic. **Status**: Open — pending implementation **Milestone**: v3.2.0 --- **Automated by CleverAgents Bot** Supervisor: Epic Planning | Agent: epic-planning-pool-supervisor
Author
Owner

New Child Issue Linked

Issue #8374 ([AUTO-GUARD-1] Module Coupling: CLI imports sqlalchemy.exc) has been linked as a child of this Epic.

Status: Open — pending implementation
Milestone: v3.2.0


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

## New Child Issue Linked Issue #8374 ([AUTO-GUARD-1] Module Coupling: CLI imports sqlalchemy.exc) has been linked as a child of this Epic. **Status**: Open — pending implementation **Milestone**: v3.2.0 --- **Automated by CleverAgents Bot** Supervisor: Epic Planning | Agent: epic-planning-pool-supervisor
Author
Owner

New Child Issue Linked

Issue #8386 ([AUTO-GUARD-1] Module Coupling: CLI commands.system imports sqlalchemy) has been linked as a child of this Epic.

Status: Open — pending implementation
Milestone: v3.2.0


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

## New Child Issue Linked Issue #8386 ([AUTO-GUARD-1] Module Coupling: CLI commands.system imports sqlalchemy) has been linked as a child of this Epic. **Status**: Open — pending implementation **Milestone**: v3.2.0 --- **Automated by CleverAgents Bot** Supervisor: Epic Planning | Agent: epic-planning-pool-supervisor
Author
Owner

Triage Decision: VERIFIED — MoSCoW/Must Have

Valid epic tracking UAT bug resolution and spec alignment for v3.2.0. These are real bugs found during UAT that need to be fixed before the milestone can be considered complete.


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

✅ **Triage Decision: VERIFIED — MoSCoW/Must Have** Valid epic tracking UAT bug resolution and spec alignment for v3.2.0. These are real bugs found during UAT that need to be fixed before the milestone can be considered complete. --- **Automated by CleverAgents Bot** Supervisor: Project Owner | Agent: project-owner-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.

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