UAT: `agents plan explain` rich output uses generic key-value table instead of spec-required Decision/Alternatives/Impact/Context/Rationale/Correction panels #6486

New issue

Open

opened 2026-04-09 21:09:09 +00:00 by HAL9000 · 0 comments

HAL9000 commented

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

Owner

Bug Report

Feature Area

Plan Lifecycle — agents plan explain rich output

Spec Reference

docs/specification.md §14546–14611 (agents plan explain rich output)

Expected Behavior (from spec)

The spec defines the following output panels for agents plan explain <DECISION_ID> (rich format):

"Decision" panel — ID, Type, Question, Chosen, Confidence, Plan, Sequence, Created
"Alternatives Considered" panel — numbered list of alternatives with "(chosen)" marker
"Impact" panel — Downstream Decisions, Downstream Child Plans, Artifacts Produced, Correction Impact
"Context Snapshot" panel (when --show-context) — context items and Hot Context Hash
"Rationale" panel — explanation text
"Correction" panel — the correction command to use
Footer: ✓ OK Decision explained

Actual Behavior

The implementation in explain_decision_cmd() (src/cleveragents/cli/commands/plan.py, lines 4244–4257) for rich output:

table = Table(title="Decision Details", show_header=False, expand=False)
table.add_column("Field", style="bold")
table.add_column("Value")
for key, val in data.items():
    table.add_row(key, str(val))
console.print(Panel(table, expand=False))

This renders a single generic key-value table inside a panel. Missing panels:

❌ "Alternatives Considered" panel (numbered list with "(chosen)" marker)
❌ "Impact" panel (Downstream Decisions, Downstream Child Plans, Artifacts Produced, Correction Impact)
❌ "Context Snapshot" panel (even when --show-context is passed, it's just a dict in the table)
❌ "Rationale" panel (only shown when --show-reasoning is passed, but spec shows it always)
❌ "Correction" panel (showing the correction command)
❌ Footer "✓ OK Decision explained"

Additionally, _build_explain_dict() (lines 4150–4185) is missing:

impact dict (downstream_decisions, downstream_child_plans, artifacts_produced, correction_impact)
correction field (the correction command string)

Code Location

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

Lines 4150–4185: _build_explain_dict() — missing impact and correction fields
Lines 4244–4257: explain_decision_cmd() rich output — uses generic table instead of spec-required panels

Steps to Reproduce

agents plan explain <DECISION_ID> --show-context

Observe: single generic key-value table instead of the 6 spec-required panels.

Severity

Low-Medium — the decision data is present but the output format doesn't match the spec. Users miss the "Impact" and "Correction" panels which are important for understanding how to correct decisions.

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

## Bug Report ### Feature Area Plan Lifecycle — `agents plan explain` rich output ### Spec Reference `docs/specification.md` §14546–14611 (agents plan explain rich output) ### Expected Behavior (from spec) The spec defines the following output panels for `agents plan explain <DECISION_ID>` (rich format): 1. **"Decision" panel** — ID, Type, Question, Chosen, Confidence, Plan, Sequence, Created 2. **"Alternatives Considered" panel** — numbered list of alternatives with "(chosen)" marker 3. **"Impact" panel** — Downstream Decisions, Downstream Child Plans, Artifacts Produced, Correction Impact 4. **"Context Snapshot" panel** (when `--show-context`) — context items and Hot Context Hash 5. **"Rationale" panel** — explanation text 6. **"Correction" panel** — the correction command to use 7. **Footer**: `✓ OK Decision explained` ### Actual Behavior The implementation in `explain_decision_cmd()` (`src/cleveragents/cli/commands/plan.py`, lines 4244–4257) for rich output: ```python table = Table(title="Decision Details", show_header=False, expand=False) table.add_column("Field", style="bold") table.add_column("Value") for key, val in data.items(): table.add_row(key, str(val)) console.print(Panel(table, expand=False)) ``` This renders a single generic key-value table inside a panel. **Missing panels:** - ❌ "Alternatives Considered" panel (numbered list with "(chosen)" marker) - ❌ "Impact" panel (Downstream Decisions, Downstream Child Plans, Artifacts Produced, Correction Impact) - ❌ "Context Snapshot" panel (even when `--show-context` is passed, it's just a dict in the table) - ❌ "Rationale" panel (only shown when `--show-reasoning` is passed, but spec shows it always) - ❌ "Correction" panel (showing the correction command) - ❌ Footer "✓ OK Decision explained" Additionally, `_build_explain_dict()` (lines 4150–4185) is missing: - `impact` dict (downstream_decisions, downstream_child_plans, artifacts_produced, correction_impact) - `correction` field (the correction command string) ### Code Location `src/cleveragents/cli/commands/plan.py`: - Lines 4150–4185: `_build_explain_dict()` — missing `impact` and `correction` fields - Lines 4244–4257: `explain_decision_cmd()` rich output — uses generic table instead of spec-required panels ### Steps to Reproduce ```bash agents plan explain <DECISION_ID> --show-context ``` Observe: single generic key-value table instead of the 6 spec-required panels. ### Severity Low-Medium — the decision data is present but the output format doesn't match the spec. Users miss the "Impact" and "Correction" panels which are important for understanding how to correct decisions. --- **Automated by CleverAgents Bot** Supervisor: UAT Testing | Agent: uat-tester

HAL9000 added the

labels

2026-04-09 21:19:45 +00:00

HAL9000 referenced this issue

2026-04-09 21:37:14 +00:00

[AUTO-UAT-SUP] UAT Testing Pool Status (Cycle 6) #6372