fix: agents plan tree --format json returns list instead of structured object (spec divergence) #8158

Open
opened 2026-04-13 04:05:41 +00:00 by HAL9000 · 1 comment
Owner

Background and Context

UAT testing revealed that agents plan tree --format json returns a list instead of a structured object as specified. This is a spec divergence that prevents downstream consumers from parsing the plan tree output correctly. Referenced in Epic #8136 as issue #7944.

Current Behavior

agents plan tree --format json returns a JSON list [...] instead of a structured object {...} as specified in the plan tree specification.

Expected Behavior

agents plan tree --format json returns a structured JSON object with the plan tree hierarchy, matching the specification format exactly.

Acceptance Criteria

  • agents plan tree --format json returns a structured object (not a list)
  • The JSON structure matches the plan tree specification
  • All required fields are present in the JSON output
  • Existing tests updated to validate the correct format
  • Test coverage >= 97% for plan tree JSON format

Metadata

  • Commit message: fix: plan tree --format json returns structured object per spec
  • Branch name: fix/plan-tree-json-format-structured-object

Subtasks

  • Identify the code path producing the list output
  • Fix the serializer to produce a structured object
  • Validate output against the plan tree specification
  • Update existing tests to validate correct format
  • Add regression test for this specific bug

Definition of Done

agents plan tree --format json returns a structured object matching the specification, and test coverage >= 97%.

Parent Epic

Blocks #8136


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

## Background and Context UAT testing revealed that `agents plan tree --format json` returns a list instead of a structured object as specified. This is a spec divergence that prevents downstream consumers from parsing the plan tree output correctly. Referenced in Epic #8136 as issue #7944. ## Current Behavior `agents plan tree --format json` returns a JSON list `[...]` instead of a structured object `{...}` as specified in the plan tree specification. ## Expected Behavior `agents plan tree --format json` returns a structured JSON object with the plan tree hierarchy, matching the specification format exactly. ## Acceptance Criteria - [ ] `agents plan tree --format json` returns a structured object (not a list) - [ ] The JSON structure matches the plan tree specification - [ ] All required fields are present in the JSON output - [ ] Existing tests updated to validate the correct format - [ ] Test coverage >= 97% for plan tree JSON format ## Metadata - **Commit message**: `fix: plan tree --format json returns structured object per spec` - **Branch name**: `fix/plan-tree-json-format-structured-object` ## Subtasks - [ ] Identify the code path producing the list output - [ ] Fix the serializer to produce a structured object - [ ] Validate output against the plan tree specification - [ ] Update existing tests to validate correct format - [ ] Add regression test for this specific bug ## Definition of Done `agents plan tree --format json` returns a structured object matching the specification, and test coverage >= 97%. ## Parent Epic Blocks #8136 --- **Automated by CleverAgents Bot** Supervisor: Epic Planning | Agent: epic-planning-pool-supervisor
HAL9000 added this to the v3.2.0 milestone 2026-04-13 04:07:46 +00:00
Author
Owner

Verified — JSON format returning a list instead of a structured object is a spec divergence that breaks the v3.2.0 acceptance criterion for plan tree rendering. Must Have fix for v3.2.0. Verified.


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

✅ **Verified** — JSON format returning a list instead of a structured object is a spec divergence that breaks the v3.2.0 acceptance criterion for plan tree rendering. **Must Have** fix for v3.2.0. Verified. --- **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.

Dependencies

No dependencies set.

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