UAT: agents plan list rich output missing spec-required Filters panel, Summary panel, Elapsed column, and success message #1522

Closed
opened 2026-04-02 20:11:34 +00:00 by freemo · 2 comments
Owner

Metadata

  • Branch: fix/plan-list-rich-output-spec-alignment
  • Commit Message: fix(cli): render spec-required Filters, Summary panels and Elapsed column in agents plan list rich output
  • Milestone: v3.7.0
  • Parent Epic: #936

Background and Context

The agents plan list command's rich output format was tested against the specification (docs/specification.md section ##### agents plan list). The specification defines a structured multi-panel rich output layout with a Plans table (including an Elapsed column), a Filters panel, a Summary panel, and a success message. The current implementation renders only a single table with different columns and no additional panels.

Current Behavior

The lifecycle_list_plans function (located in src/cleveragents/cli/commands/plan.py, lines 2346–2381) renders a single Rich table with columns: ID, Name, Action, Phase, State, Profile, Invariants, Projects, Created.

The spec-required elements are entirely absent:

  1. Missing Elapsed column — spec requires an elapsed time column showing how long the plan has been running
  2. Missing Filters panel — spec requires a panel showing active filter values (Phase, State, Project, Action)
  3. Missing Summary panel — spec requires a panel showing Total, Processing, Completed, Errored counts
  4. Missing success message — spec requires ✓ OK N plan listed (or [OK] N plan listed in plain format)
  5. Extra columns not in spec — Name, Profile, Invariants columns are not in the spec table

Expected Behavior (from spec)

The spec requires the rich output to display:

  1. Plans table with columns: ID, Phase, State, Action, Project, Elapsed
  2. Filters panel: showing Phase: <value>, State: (any), Project: (any), Action: (any) (only shown when filters are active)
  3. Summary panel: showing Total: N, Processing: N, Completed: N, Errored: N
  4. Success message: ✓ OK N plan listed

Example from spec:

╭─ Plans ──────────────────────────────────────────────────────────────────────────────╮
│ ID        Phase    State       Action               Project            Elapsed       │
│ ────────  ───────  ──────────  ───────────────────  ─────────────────  ─────────     │
│ 01HXM7A9  execute  processing  local/code-coverage  local/api-service  00:01:12      │
╰──────────────────────────────────────────────────────────────────────────────────────╯

╭─ Filters ──────╮
│ Phase: execute │
│ State: (any)   │
│ Project: (any) │
│ Action: (any)  │
╰────────────────╯

╭─ Summary ─────────╮
│ Total: 1          │
│ Processing: 1     │
│ Completed: 0      │
│ Errored: 0        │
╰───────────────────╯

✓ OK 1 plan listed

Steps to Reproduce

agents plan list --phase execute

Impact

Users cannot see elapsed time for running plans, cannot verify which filters are active, and cannot get a quick summary of plan states. The missing Filters panel is particularly important for debugging why expected plans are not appearing in the list.

Subtasks

  • Add Elapsed column to the Plans table (computed from created_at to now, or from execute_started_at)
  • Remove non-spec columns (Name, Profile, Invariants) from the table
  • Add Filters panel showing active filter values (only when at least one filter is active)
  • Add Summary panel showing Total, Processing, Completed, Errored counts
  • Add ✓ OK N plan listed success message after the panels
  • Tests (Behave): Add/update scenarios for agents plan list rich output covering Filters panel, Summary panel, Elapsed column, and success message
  • 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.
  • agents plan list rich output renders the Plans table with spec-required columns (ID, Phase, State, Action, Project, Elapsed)
  • Filters panel is shown when filters are active
  • Summary panel is always shown
  • Success message ✓ OK N plan listed is printed after the panels
  • All existing plan list tests continue to pass
  • 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.
  • All nox stages pass
  • Coverage >= 97%

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

## Metadata - **Branch**: `fix/plan-list-rich-output-spec-alignment` - **Commit Message**: `fix(cli): render spec-required Filters, Summary panels and Elapsed column in agents plan list rich output` - **Milestone**: v3.7.0 - **Parent Epic**: #936 ## Background and Context The `agents plan list` command's rich output format was tested against the specification (`docs/specification.md` section `##### agents plan list`). The specification defines a structured multi-panel rich output layout with a Plans table (including an Elapsed column), a Filters panel, a Summary panel, and a success message. The current implementation renders only a single table with different columns and no additional panels. ## Current Behavior The `lifecycle_list_plans` function (located in `src/cleveragents/cli/commands/plan.py`, lines 2346–2381) renders a single Rich table with columns: `ID, Name, Action, Phase, State, Profile, Invariants, Projects, Created`. The spec-required elements are entirely absent: 1. **Missing `Elapsed` column** — spec requires an elapsed time column showing how long the plan has been running 2. **Missing Filters panel** — spec requires a panel showing active filter values (Phase, State, Project, Action) 3. **Missing Summary panel** — spec requires a panel showing Total, Processing, Completed, Errored counts 4. **Missing success message** — spec requires `✓ OK N plan listed` (or `[OK] N plan listed` in plain format) 5. **Extra columns not in spec** — `Name`, `Profile`, `Invariants` columns are not in the spec table ## Expected Behavior (from spec) The spec requires the rich output to display: 1. **Plans table** with columns: `ID, Phase, State, Action, Project, Elapsed` 2. **Filters panel**: showing `Phase: <value>`, `State: (any)`, `Project: (any)`, `Action: (any)` (only shown when filters are active) 3. **Summary panel**: showing `Total: N`, `Processing: N`, `Completed: N`, `Errored: N` 4. **Success message**: `✓ OK N plan listed` Example from spec: ``` ╭─ Plans ──────────────────────────────────────────────────────────────────────────────╮ │ ID Phase State Action Project Elapsed │ │ ──────── ─────── ────────── ─────────────────── ───────────────── ───────── │ │ 01HXM7A9 execute processing local/code-coverage local/api-service 00:01:12 │ ╰──────────────────────────────────────────────────────────────────────────────────────╯ ╭─ Filters ──────╮ │ Phase: execute │ │ State: (any) │ │ Project: (any) │ │ Action: (any) │ ╰────────────────╯ ╭─ Summary ─────────╮ │ Total: 1 │ │ Processing: 1 │ │ Completed: 0 │ │ Errored: 0 │ ╰───────────────────╯ ✓ OK 1 plan listed ``` ## Steps to Reproduce ```bash agents plan list --phase execute ``` ## Impact Users cannot see elapsed time for running plans, cannot verify which filters are active, and cannot get a quick summary of plan states. The missing Filters panel is particularly important for debugging why expected plans are not appearing in the list. ## Subtasks - [ ] Add `Elapsed` column to the Plans table (computed from `created_at` to now, or from `execute_started_at`) - [ ] Remove non-spec columns (`Name`, `Profile`, `Invariants`) from the table - [ ] Add Filters panel showing active filter values (only when at least one filter is active) - [ ] Add Summary panel showing Total, Processing, Completed, Errored counts - [ ] Add `✓ OK N plan listed` success message after the panels - [ ] Tests (Behave): Add/update scenarios for `agents plan list` rich output covering Filters panel, Summary panel, Elapsed column, and success message - [ ] 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. - `agents plan list` rich output renders the Plans table with spec-required columns (ID, Phase, State, Action, Project, Elapsed) - Filters panel is shown when filters are active - Summary panel is always shown - Success message `✓ OK N plan listed` is printed after the panels - All existing plan list tests continue to pass - 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. - All nox stages pass - Coverage >= 97% --- **Automated by CleverAgents Bot** Supervisor: UAT Testing | Agent: ca-new-issue-creator
freemo added this to the v3.7.0 milestone 2026-04-02 20:18:36 +00:00
freemo self-assigned this 2026-04-02 20:40:25 +00:00
Author
Owner

Issue triaged by project owner:

  • State: Verified
  • Priority: Medium (already assigned) — Rich output deviates from spec with missing panels and incorrect columns, but the command functions correctly.
  • Milestone: v3.7.0 (already assigned) — Correct, this is a TUI/CLI output issue.
  • MoSCoW: Should Have — The spec defines a structured multi-panel layout (Plans table with Elapsed column, Filters panel, Summary panel, success message). The current implementation renders a single table with non-spec columns. While plan list works functionally, the output is significantly less informative than specified. The Filters panel is particularly important for debugging plan visibility. This is a spec compliance issue but not a functional blocker.
  • Parent Epic: #936 (already linked in metadata)

Valid UAT bug. The issue is well-structured with all required sections (Metadata, Subtasks, Definition of Done). The fix involves restructuring the table columns, adding three new panels, and adding the success message.

Note: #1511 and #1508 (session list output) follow the same pattern — missing spec-required panels and fields. These are all part of a broader CLI output spec-alignment effort under Epic #936.


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

Issue triaged by project owner: - **State**: Verified - **Priority**: Medium (already assigned) — Rich output deviates from spec with missing panels and incorrect columns, but the command functions correctly. - **Milestone**: v3.7.0 (already assigned) — Correct, this is a TUI/CLI output issue. - **MoSCoW**: Should Have — The spec defines a structured multi-panel layout (Plans table with Elapsed column, Filters panel, Summary panel, success message). The current implementation renders a single table with non-spec columns. While `plan list` works functionally, the output is significantly less informative than specified. The Filters panel is particularly important for debugging plan visibility. This is a spec compliance issue but not a functional blocker. - **Parent Epic**: #936 (already linked in metadata) Valid UAT bug. The issue is well-structured with all required sections (Metadata, Subtasks, Definition of Done). The fix involves restructuring the table columns, adding three new panels, and adding the success message. Note: #1511 and #1508 (session list output) follow the same pattern — missing spec-required panels and fields. These are all part of a broader CLI output spec-alignment effort under Epic #936. --- **Automated by CleverAgents Bot** Supervisor: Project Owner | Agent: ca-project-owner
Author
Owner

Closing — work completed in PR #1565 (merged). The PR rendered spec-required Filters, Summary panels and Exit message for agents plan list.


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

Closing — work completed in PR #1565 (merged). The PR rendered spec-required Filters, Summary panels and Exit message for `agents plan list`. --- **Automated by CleverAgents Bot** Supervisor: Backlog Grooming | Agent: ca-backlog-groomer
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#1522
No description provided.