UAT: `agents plan tree` rich output missing spec-required panels (Tree Summary, Child Plans, Decision IDs for correction) #2842

New issue

Open

opened 2026-04-04 20:48:04 +00:00 by freemo · 0 comments

freemo commented

2026-04-04 20:48:04 +00:00

Owner

Bug Report

What Was Tested

Code analysis of src/cleveragents/cli/commands/plan.py, tree_decisions_cmd() function (lines 3631–3757).

Expected Behavior (from spec)

Per docs/specification.md lines 14338–14377, the agents plan tree command must render four distinct structured panels in its rich output:

Decision tree panel — The visual tree structure of decisions (implemented)
Tree Summary panel — Nodes count, Depth, Child Plans count, Invariants count, Superseded count
Child Plans panel — Table showing child plan IDs, Phase, and State
Decision IDs (for correction) panel — Lists decision IDs by type (Root, Invariant N, Strategy, Parallel N, Spawn X)

Actual Behavior

The current implementation at src/cleveragents/cli/commands/plan.py lines 3711–3757 renders only the tree structure using rich.tree.Tree. The code ends at line 3757 with just the tree rendering — no "Tree Summary" panel, no "Child Plans" panel, and no "Decision IDs (for correction)" panel are rendered at all.

None of the three additional spec-required panels are present in the output.

Additional Missing Elements

Tree Summary panel — nodes count, depth, child_plans count, invariants count, and superseded count are never displayed
Child Plans panel — No table showing child plan IDs, Phase, and State is rendered
Decision IDs (for correction) panel — Decision IDs by type (Root, Invariant N, Strategy, Parallel N, Spawn X) are never surfaced, making it impossible for users to know which IDs to pass to agents plan correct

Code Location

src/cleveragents/cli/commands/plan.py:

tree_decisions_cmd() function (lines 3631–3757) — renders only the tree structure; the three additional spec-required panels are absent

Steps to Reproduce

agents plan tree <PLAN_ID>

Run with a plan that has decisions
Observe: Only the tree structure is shown, no summary panels
Expected: Tree + "Tree Summary" panel + "Child Plans" panel + "Decision IDs (for correction)" panel

Impact

Users cannot see a summary of the decision tree (node count, depth, invariants, superseded decisions)
Users cannot see which child plans exist under the current plan or their phase/state
Users cannot easily identify decision IDs to pass to agents plan correct — the primary use case of the "Decision IDs (for correction)" panel
The output is significantly incomplete compared to the spec

Metadata

Branch: fix/m4-plan-tree-rich-output-panels
Commit Message: fix(cli): render spec-required Tree Summary, Child Plans, and Decision IDs panels in agents plan tree output
Milestone: v3.3.0
Parent Epic: #394

Subtasks

Render "Tree Summary" Rich Panel with Nodes count, Depth, Child Plans count, Invariants count, and Superseded count
Render "Child Plans" Rich Table showing child plan IDs, Phase, and State columns
Render "Decision IDs (for correction)" Rich Panel listing decision IDs by type (Root, Invariant N, Strategy, Parallel N, Spawn X)
Add Behave feature scenarios covering all three additional panels in rich output
Add Robot Framework integration test for agents plan tree rich output

Definition of Done

Rich output renders all three spec-required additional panels (Tree Summary, Child Plans, Decision IDs for correction)
All panel fields match the field names and format defined in docs/specification.md lines 14338–14377
"Decision IDs (for correction)" panel correctly categorises IDs by type (Root, Invariant N, Strategy, Parallel N, Spawn X)
All nox stages pass
Coverage >= 97%

Automated by CleverAgents Bot
Supervisor: UAT Testing | Agent: ca-new-issue-creator

## Bug Report ### What Was Tested Code analysis of `src/cleveragents/cli/commands/plan.py`, `tree_decisions_cmd()` function (lines 3631–3757). ### Expected Behavior (from spec) Per `docs/specification.md` lines 14338–14377, the `agents plan tree` command must render **four distinct structured panels** in its rich output: 1. **Decision tree panel** — The visual tree structure of decisions (implemented) 2. **Tree Summary panel** — Nodes count, Depth, Child Plans count, Invariants count, Superseded count 3. **Child Plans panel** — Table showing child plan IDs, Phase, and State 4. **Decision IDs (for correction) panel** — Lists decision IDs by type (Root, Invariant N, Strategy, Parallel N, Spawn X) ### Actual Behavior The current implementation at `src/cleveragents/cli/commands/plan.py` lines 3711–3757 renders only the tree structure using `rich.tree.Tree`. The code ends at line 3757 with just the tree rendering — no "Tree Summary" panel, no "Child Plans" panel, and no "Decision IDs (for correction)" panel are rendered at all. None of the three additional spec-required panels are present in the output. ### Additional Missing Elements 1. **Tree Summary panel** — `nodes` count, `depth`, `child_plans` count, `invariants` count, and `superseded` count are never displayed 2. **Child Plans panel** — No table showing child plan IDs, Phase, and State is rendered 3. **Decision IDs (for correction) panel** — Decision IDs by type (Root, Invariant N, Strategy, Parallel N, Spawn X) are never surfaced, making it impossible for users to know which IDs to pass to `agents plan correct` ### Code Location `src/cleveragents/cli/commands/plan.py`: - `tree_decisions_cmd()` function (lines 3631–3757) — renders only the tree structure; the three additional spec-required panels are absent ### Steps to Reproduce ```bash agents plan tree <PLAN_ID> ``` 1. Run with a plan that has decisions 2. Observe: Only the tree structure is shown, no summary panels 3. Expected: Tree + "Tree Summary" panel + "Child Plans" panel + "Decision IDs (for correction)" panel ### Impact - Users cannot see a summary of the decision tree (node count, depth, invariants, superseded decisions) - Users cannot see which child plans exist under the current plan or their phase/state - Users cannot easily identify decision IDs to pass to `agents plan correct` — the primary use case of the "Decision IDs (for correction)" panel - The output is significantly incomplete compared to the spec ## Metadata - **Branch**: `fix/m4-plan-tree-rich-output-panels` - **Commit Message**: `fix(cli): render spec-required Tree Summary, Child Plans, and Decision IDs panels in agents plan tree output` - **Milestone**: v3.3.0 - **Parent Epic**: #394 ## Subtasks - [ ] Render "Tree Summary" Rich Panel with Nodes count, Depth, Child Plans count, Invariants count, and Superseded count - [ ] Render "Child Plans" Rich Table showing child plan IDs, Phase, and State columns - [ ] Render "Decision IDs (for correction)" Rich Panel listing decision IDs by type (Root, Invariant N, Strategy, Parallel N, Spawn X) - [ ] Add Behave feature scenarios covering all three additional panels in rich output - [ ] Add Robot Framework integration test for `agents plan tree` rich output ## Definition of Done - [ ] Rich output renders all three spec-required additional panels (Tree Summary, Child Plans, Decision IDs for correction) - [ ] All panel fields match the field names and format defined in `docs/specification.md` lines 14338–14377 - [ ] "Decision IDs (for correction)" panel correctly categorises IDs by type (Root, Invariant N, Strategy, Parallel N, Spawn X) - [ ] All nox stages pass - [ ] Coverage >= 97% --- **Automated by CleverAgents Bot** Supervisor: UAT Testing | Agent: ca-new-issue-creator

freemo added this to the v3.3.0 milestone

2026-04-04 20:48:09 +00:00

freemo added a new dependency

2026-04-04 20:48:30 +00:00

#394 Epic: Decision Framework

freemo referenced this issue

2026-04-04 20:50:18 +00:00

[CA-AUTO] UAT Pool Supervisor — v3.7.0 — Session Tracker #2803

freemo referenced this issue

2026-04-04 20:51:19 +00:00

[CA-AUTO] UAT Pool Supervisor — v3.7.0 — Session Tracker #2803

freemo referenced this issue