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 specName, 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.