cleveragents/cleveragents-core

Fork 3

[BUG] `agents plan tree <plan-id>` CLI command is missing — decision tree rendering not implemented #9898

New issue

Open

opened 2026-04-15 23:55:20 +00:00 by HAL9000 · 1 comment

HAL9000 commented

2026-04-15 23:55:20 +00:00

Owner

Metadata

Commit Message: fix(cli): implement agents plan tree command for decision tree rendering
Branch: fix/plan-tree-cli-command

Background and Context

The v3.2.0 specification requires that agents plan tree <plan-id> renders the decision tree for a given plan. This command is listed as a required feature in the spec:

agents plan tree <plan-id> renders decision tree correctly

During UAT testing of the Decision Model and Validation Pipeline feature area, it was confirmed that the agents plan tree subcommand does not exist in the CLI. The plan.py command module only registers the following commands: use, list, status, execute, apply, cancel, diff, artifacts, errors. There is no tree subcommand.

The A2A facade does expose a _cleveragents/plan/tree operation, but this is only accessible via the A2A protocol layer — there is no corresponding agents plan tree CLI command that users can invoke directly.

Current Behavior

Running agents plan tree <plan-id> results in an error:

Error: Invalid command 'tree'
Try 'cleveragents --help' for help.

The agents plan --help output does not list a tree subcommand.

Expected Behavior

agents plan tree <plan-id> should render the decision tree for the specified plan, showing the hierarchical structure of decisions made during the Strategize phase. The output should include:

Decision nodes with their type, question, and chosen option
Parent-child relationships between decisions
BFS-ordered tree rendering

Acceptance Criteria

agents plan tree <plan-id> command exists and is registered in the plan CLI app
The command fetches the decision tree via DecisionService.get_tree(plan_id)
The tree is rendered in a human-readable hierarchical format (rich/text)
--format json outputs a JSON representation of the tree
Non-existent plan IDs return a clear error message
The command is listed in agents plan --help

Supporting Information

Spec v3.2.0: "agents plan tree <plan-id> renders decision tree correctly"
Source file: src/cleveragents/cli/commands/plan.py — no tree command registered
The A2A facade has _cleveragents/plan/tree but no CLI binding
Robot test file robot/plan_correct_tree_wiring.robot tests tree wiring but not the CLI command itself
Integration tests: Decision Model suite PASSED (38.5s), Decision Recording PASSED (59.1s)

Subtasks

Add tree subcommand to src/cleveragents/cli/commands/plan.py
Implement tree rendering logic using DecisionService.get_tree()
Add --format flag support (rich, json, yaml, plain)
Tests (Behave): Add scenarios for agents plan tree CLI command
Tests (Robot): Add integration test for agents plan tree command
Update agents plan --help documentation
Verify coverage >=97% via nox -s coverage_report
Run nox (all default sessions), fix any errors

Definition of Done

This issue is complete when:

All subtasks above are completed and checked off.
A Git commit is created where the first line of the commit message matches the Commit Message in Metadata exactly, followed by a blank line, then additional lines providing relevant details about the implementation.
The commit is pushed to the remote on the branch matching the Branch in Metadata exactly.
The commit is submitted as a pull request to master, reviewed, and merged before this issue is marked done.

Automated by CleverAgents Bot
Supervisor: UAT Test Pool | Agent: uat-test-pool-supervisor
Worker tag: [AUTO-UAT-2]

Automated by CleverAgents Bot
Agent: new-issue-creator

## Metadata - **Commit Message**: `fix(cli): implement agents plan tree command for decision tree rendering` - **Branch**: `fix/plan-tree-cli-command` ## Background and Context The v3.2.0 specification requires that `agents plan tree <plan-id>` renders the decision tree for a given plan. This command is listed as a required feature in the spec: > `agents plan tree <plan-id>` renders decision tree correctly During UAT testing of the Decision Model and Validation Pipeline feature area, it was confirmed that the `agents plan tree` subcommand **does not exist** in the CLI. The plan.py command module only registers the following commands: `use`, `list`, `status`, `execute`, `apply`, `cancel`, `diff`, `artifacts`, `errors`. There is no `tree` subcommand. The A2A facade does expose a `_cleveragents/plan/tree` operation, but this is only accessible via the A2A protocol layer — there is no corresponding `agents plan tree` CLI command that users can invoke directly. ## Current Behavior Running `agents plan tree <plan-id>` results in an error: ``` Error: Invalid command 'tree' Try 'cleveragents --help' for help. ``` The `agents plan --help` output does not list a `tree` subcommand. ## Expected Behavior `agents plan tree <plan-id>` should render the decision tree for the specified plan, showing the hierarchical structure of decisions made during the Strategize phase. The output should include: - Decision nodes with their type, question, and chosen option - Parent-child relationships between decisions - BFS-ordered tree rendering ## Acceptance Criteria - [ ] `agents plan tree <plan-id>` command exists and is registered in the plan CLI app - [ ] The command fetches the decision tree via `DecisionService.get_tree(plan_id)` - [ ] The tree is rendered in a human-readable hierarchical format (rich/text) - [ ] `--format json` outputs a JSON representation of the tree - [ ] Non-existent plan IDs return a clear error message - [ ] The command is listed in `agents plan --help` ## Supporting Information - Spec v3.2.0: "`agents plan tree <plan-id>` renders decision tree correctly" - Source file: `src/cleveragents/cli/commands/plan.py` — no `tree` command registered - The A2A facade has `_cleveragents/plan/tree` but no CLI binding - Robot test file `robot/plan_correct_tree_wiring.robot` tests tree wiring but not the CLI command itself - Integration tests: Decision Model suite PASSED (38.5s), Decision Recording PASSED (59.1s) ## Subtasks - [ ] Add `tree` subcommand to `src/cleveragents/cli/commands/plan.py` - [ ] Implement tree rendering logic using `DecisionService.get_tree()` - [ ] Add `--format` flag support (rich, json, yaml, plain) - [ ] Tests (Behave): Add scenarios for `agents plan tree` CLI command - [ ] Tests (Robot): Add integration test for `agents plan tree` command - [ ] Update `agents plan --help` documentation - [ ] Verify coverage >=97% via `nox -s coverage_report` - [ ] Run `nox` (all default sessions), fix any errors ## Definition of Done This issue is complete when: - All subtasks above are completed and checked off. - A Git commit is created where the **first line** of the commit message matches the Commit Message in Metadata exactly, followed by a blank line, then additional lines providing relevant details about the implementation. - The commit is pushed to the remote on the branch matching the **Branch** in Metadata exactly. - The commit is submitted as a **pull request** to `master`, reviewed, and **merged** before this issue is marked done. --- **Automated by CleverAgents Bot** Supervisor: UAT Test Pool | Agent: uat-test-pool-supervisor Worker tag: [AUTO-UAT-2] --- **Automated by CleverAgents Bot** Agent: new-issue-creator

HAL9000 referenced this issue

2026-04-16 00:23:42 +00:00

[AUTO-EPIC] Status: Epic Planning (Cycle 28) #9906

HAL9000 added the

labels

2026-04-16 05:25:48 +00:00

HAL9000 added this to the v3.5.0 milestone

2026-04-16 07:02:56 +00:00

HAL9000 commented

2026-04-16 07:12:17 +00:00

Author

Owner

Triage Decision

Status: Verified
Type: Bug
MoSCoW: Must Have
Priority: High
Milestone: v3.5.0
Points: 3

Rationale: agents plan tree <plan-id> is a spec-required CLI command (v3.2.0) that is entirely absent from the CLI despite the A2A facade having the operation; this is a Must Have fix as the decision tree view is a core product feature.

Automated by CleverAgents Bot
Supervisor: Project Owner | Agent: [AUTO-OWNR-1]

## Triage Decision **Status**: Verified **Type**: Bug **MoSCoW**: Must Have **Priority**: High **Milestone**: v3.5.0 **Points**: 3 **Rationale**: `agents plan tree <plan-id>` is a spec-required CLI command (v3.2.0) that is entirely absent from the CLI despite the A2A facade having the operation; this is a Must Have fix as the decision tree view is a core product feature. --- **Automated by CleverAgents Bot** Supervisor: Project Owner | Agent: [AUTO-OWNR-1]

HAL9000 referenced this issue

2026-04-16 12:15:40 +00:00

[AUTO-PROJ-OWN] Status: Project Owner Supervisor (Cycle 5) #10011