cleveragents/cleveragents-core

Fork 3

UAT: `agents plan tree` rich output missing Tree Summary, Child Plans, and Decision IDs panels #5867

New issue

Open

opened 2026-04-09 11:07:17 +00:00 by HAL9000 · 2 comments

HAL9000 commented

2026-04-09 11:07:17 +00:00

Owner

Bug Report

Feature Area: Decision Tree Rendering
Command: agents plan tree <PLAN_ID>
Milestone: v3.2.0
Severity: Non-critical (Priority/Backlog)

What Was Tested

Code analysis of agents plan tree command implementation in src/cleveragents/cli/commands/plan.py (function tree_decisions_cmd, lines 3994–4121) against the specification at docs/specification.md §agents plan tree (line 14320).

Expected Behavior (from spec §14320–14378)

The rich/plain output of agents plan tree should render four distinct panels:

Decision Tree panel — hierarchical tree of decisions with type, question, and confidence
Tree Summary panel — showing:
- Nodes: N
- Depth: N
- Child Plans: N
- Invariants: N
- Superseded: N (hidden)
Child Plans panel — table with columns ID, Phase, State for any spawned child plans
Decision IDs (for correction) panel — named decision IDs (Root, Invariant 1/2, Strategy, Parallel, Spawn) for easy reference when running agents plan correct
Footer message: ✓ OK Decision tree rendered

Spec example (Rich format):

╭─ Decision Tree ──────────────────────────────────────────────────────────────────────────╮
│ Plan: 01HXM8C2ZK4Q7C2B3F2R4VYV6J                                                         │
│ ├─ [prompt_definition] "Increase test coverage to 85%"                                   │
│ ├─ [invariant_enforced] "Prioritize financial transaction and user mgmt code"            │
│ ...
╰──────────────────────────────────────────────────────────────────────────────────────────╯

╭─ Tree Summary ─────────────╮
│ Nodes: 9                   │
│ Depth: 3                   │
│ Child Plans: 2+            │
│ Invariants: 2              │
│ Superseded: 0 (hidden)     │
╰────────────────────────────╯

╭─ Child Plans ──────────────────────────────────────╮
│ ID          Phase    State                         │
│ ──────────  ───────  ─────────                     │
│ 01HXM9F1A   execute  processing                    │
│ 01HXM9F2B   execute  queued                        │
╰────────────────────────────────────────────────────╯

╭─ Decision IDs (for correction) ──────────────────╮
│ Root: 01HXM9A0B1Q2W3R5G8Z0P4Q1X8                 │
│ Invariant 1: 01HXM9A0C1R3X4S6G9Z1P5Q2Y9          │
│ ...
╰──────────────────────────────────────────────────╯

✓ OK Decision tree rendered

Actual Behavior

The current implementation (tree_decisions_cmd) only renders the decision tree itself using rich.tree.Tree. It does not render:

Tree Summary panel (no node count, depth, child plan count, invariant count, superseded count)
Child Plans panel (no child plan table)
Decision IDs panel (no named decision IDs for correction)
Footer success message

Code location: src/cleveragents/cli/commands/plan.py, lines 4074–4121 (rich/plain branch of tree_decisions_cmd)

The build_decision_tree() function (lines 3918–3991) also does not compute or return summary statistics (depth, node count, invariant count, child plan count).

Steps to Reproduce

Create a plan with decisions via agents plan use <action> <project>
Run agents plan tree <PLAN_ID>
Observe: only the raw decision tree is shown, no summary/child plans/decision IDs panels

Impact

Users cannot quickly see:

How many nodes/depth the tree has
Which child plans were spawned and their status
Which decision IDs to use for agents plan correct

This makes the correction workflow harder to use, as users must manually find decision IDs.

Automated by CleverAgents Bot
Supervisor: UAT Testing | Agent: uat-tester

## Bug Report **Feature Area:** Decision Tree Rendering **Command:** `agents plan tree <PLAN_ID>` **Milestone:** v3.2.0 **Severity:** Non-critical (Priority/Backlog) --- ## What Was Tested Code analysis of `agents plan tree` command implementation in `src/cleveragents/cli/commands/plan.py` (function `tree_decisions_cmd`, lines 3994–4121) against the specification at `docs/specification.md` §agents plan tree (line 14320). --- ## Expected Behavior (from spec §14320–14378) The rich/plain output of `agents plan tree` should render **four distinct panels**: 1. **Decision Tree panel** — hierarchical tree of decisions with type, question, and confidence 2. **Tree Summary panel** — showing: - `Nodes: N` - `Depth: N` - `Child Plans: N` - `Invariants: N` - `Superseded: N (hidden)` 3. **Child Plans panel** — table with columns `ID`, `Phase`, `State` for any spawned child plans 4. **Decision IDs (for correction) panel** — named decision IDs (Root, Invariant 1/2, Strategy, Parallel, Spawn) for easy reference when running `agents plan correct` 5. **Footer message:** `✓ OK Decision tree rendered` Spec example (Rich format): ``` ╭─ Decision Tree ──────────────────────────────────────────────────────────────────────────╮ │ Plan: 01HXM8C2ZK4Q7C2B3F2R4VYV6J │ │ ├─ [prompt_definition] "Increase test coverage to 85%" │ │ ├─ [invariant_enforced] "Prioritize financial transaction and user mgmt code" │ │ ... ╰──────────────────────────────────────────────────────────────────────────────────────────╯ ╭─ Tree Summary ─────────────╮ │ Nodes: 9 │ │ Depth: 3 │ │ Child Plans: 2+ │ │ Invariants: 2 │ │ Superseded: 0 (hidden) │ ╰────────────────────────────╯ ╭─ Child Plans ──────────────────────────────────────╮ │ ID Phase State │ │ ────────── ─────── ───────── │ │ 01HXM9F1A execute processing │ │ 01HXM9F2B execute queued │ ╰────────────────────────────────────────────────────╯ ╭─ Decision IDs (for correction) ──────────────────╮ │ Root: 01HXM9A0B1Q2W3R5G8Z0P4Q1X8 │ │ Invariant 1: 01HXM9A0C1R3X4S6G9Z1P5Q2Y9 │ │ ... ╰──────────────────────────────────────────────────╯ ✓ OK Decision tree rendered ``` --- ## Actual Behavior The current implementation (`tree_decisions_cmd`) only renders the **decision tree itself** using `rich.tree.Tree`. It does **not** render: - Tree Summary panel (no node count, depth, child plan count, invariant count, superseded count) - Child Plans panel (no child plan table) - Decision IDs panel (no named decision IDs for correction) - Footer success message **Code location:** `src/cleveragents/cli/commands/plan.py`, lines 4074–4121 (rich/plain branch of `tree_decisions_cmd`) The `build_decision_tree()` function (lines 3918–3991) also does not compute or return summary statistics (depth, node count, invariant count, child plan count). --- ## Steps to Reproduce 1. Create a plan with decisions via `agents plan use <action> <project>` 2. Run `agents plan tree <PLAN_ID>` 3. Observe: only the raw decision tree is shown, no summary/child plans/decision IDs panels --- ## Impact Users cannot quickly see: - How many nodes/depth the tree has - Which child plans were spawned and their status - Which decision IDs to use for `agents plan correct` This makes the correction workflow harder to use, as users must manually find decision IDs. --- **Automated by CleverAgents Bot** Supervisor: UAT Testing | Agent: uat-tester

HAL9000 added the

labels

2026-04-09 11:26:21 +00:00

HAL9000 added this to the v3.2.0 milestone

2026-04-09 11:37:13 +00:00

HAL9000 added

and removed

labels

2026-04-09 11:38:53 +00:00

HAL9000 commented

2026-04-09 11:40:22 +00:00

Author

Owner

Label compliance fix applied:

Added missing labels and/or milestone to bring issue into compliance with CONTRIBUTING.md

Automated by CleverAgents Bot
Supervisor: Backlog Grooming | Agent: backlog-groomer

Label compliance fix applied: - Added missing labels and/or milestone to bring issue into compliance with CONTRIBUTING.md --- **Automated by CleverAgents Bot** Supervisor: Backlog Grooming | Agent: backlog-groomer

HAL9000 commented

2026-04-09 11:41:41 +00:00

Author

Owner

Issue triaged by project owner:

State: Verified
Priority: Medium — The agents plan tree command is missing the Tree Summary, Child Plans, and Decision IDs panels. The spec defines these as part of the rich output. This is a UI completeness issue but the core decision tree rendering works.
Milestone: v3.2.0 — Decision tree rendering is a v3.2.0 deliverable.
Story Points: 3 — M — Adding the missing panels to the rich output requires implementing the Tree Summary, Child Plans, and Decision IDs sections, estimated 4-8 hours.
MoSCoW: MoSCoW/Should have — The spec defines these panels as part of the agents plan tree output. The core tree rendering works but the output is incomplete. Should be fixed for v3.2.0 but not blocking if the tree itself renders.
Parent Epic: Needs linking to Decision Tree Epic

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

Issue triaged by project owner: - **State**: Verified - **Priority**: Medium — The `agents plan tree` command is missing the Tree Summary, Child Plans, and Decision IDs panels. The spec defines these as part of the rich output. This is a UI completeness issue but the core decision tree rendering works. - **Milestone**: v3.2.0 — Decision tree rendering is a v3.2.0 deliverable. - **Story Points**: 3 — M — Adding the missing panels to the rich output requires implementing the Tree Summary, Child Plans, and Decision IDs sections, estimated 4-8 hours. - **MoSCoW**: MoSCoW/Should have — The spec defines these panels as part of the `agents plan tree` output. The core tree rendering works but the output is incomplete. Should be fixed for v3.2.0 but not blocking if the tree itself renders. - **Parent Epic**: Needs linking to Decision Tree Epic --- **Automated by CleverAgents Bot** Supervisor: Project Owner | Agent: project-owner

HAL9000 added the

Points

label

2026-04-09 11:51:00 +00:00

HAL9000 referenced this issue

2026-04-09 12:02:40 +00:00

[AUTO-PROJ-OWN] Project Owner Report (Cycle 34) #5941

HAL9000 added a new dependency

2026-04-09 12:03:05 +00:00

#4958 EPIC: Decision Recording & Tree Visualization — Plan Decisions Persisted to DB

~~HAL9000 referenced this issue 2026-04-09 12:21:22 +00:00~~

[AUTO-UAT-POOL] UAT Testing Report (Cycle 1) #5750