cleveragents/cleveragents-core

Fork 3

[BUG] `agents plan list` rich table output columns do not match spec (extra columns cause truncation; spec columns missing) #9109

New issue

Open

opened 2026-04-14 07:42:30 +00:00 by HAL9000 · 1 comment

HAL9000 commented

2026-04-14 07:42:30 +00:00

Owner

Metadata

Commit message: fix(plan): align agents plan list rich table columns with spec — remove extra columns (Name, Invariants, Updated)
Branch name: fix/plan-list-rich-table-columns-spec-alignment

Background and Context

Per the specification (docs/specification.md — §agents plan list), the agents plan list rich table output should show exactly six columns: ID, Phase, State, Action, Project, Elapsed.

The implementation in src/cleveragents/cli/commands/plan.py (lines 3009–3018) adds three extra columns not in the spec:

Name (namespaced plan name)
Invariants (invariant count)
Updated (last-updated timestamp)

These extra columns cause the Rich table to truncate or drop columns in standard terminal widths (80 and 120 columns), making the output harder to read and deviating from the spec-defined output format.

The BDD tests confirm this is a known issue, tracked as @tdd_expected_fail with @tdd_issue_4252:

@tdd_issue @tdd_issue_4252 @tdd_expected_fail
Scenario: Plan list rich output includes Name column
@tdd_issue @tdd_issue_4252 @tdd_expected_fail
Scenario: Plan list rich output includes Updated column
@tdd_issue @tdd_issue_4252 @tdd_expected_fail
Scenario: Plan list rich output includes Invariants column

Note: The tests are checking for columns that exist in the implementation but fail due to terminal width truncation in the test environment. The root issue is that the implementation deviates from the spec column set.

Feature Area: Plan Lifecycle & Decision Tree
Spec Reference: docs/specification.md — §agents plan list

Expected Behavior

Per the specification, agents plan list rich table output should show these columns:

ID, Phase, State, Action, Project, Elapsed

Example from spec:

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

The table should render correctly at standard terminal widths (80 and 120 columns) without truncation.

Acceptance Criteria

agents plan list rich output shows exactly: ID, Phase, State, Action, Project, Elapsed columns — no more, no less
The three extra columns (Name, Invariants, Updated) are removed from the default rich table view
Table renders correctly at standard terminal widths (80 and 120 columns) without truncation or column dropping
The three @tdd_expected_fail scenarios in features/plan_cli_spec_alignment.feature are updated to reflect the correct 6-column spec output and pass
No regression in existing plan list tests

Subtasks

Align lifecycle_list_plans() rich table columns with the spec: ID, Phase, State, Action, Project, Elapsed
Remove extra columns (Name, Invariants, Updated) from the default rich table view in src/cleveragents/cli/commands/plan.py (lines 3009–3018)
Consider adding Name/Invariants/Updated as optional columns via a --verbose or --wide flag if needed
Remove @tdd_expected_fail tags from the three affected scenarios in features/plan_cli_spec_alignment.feature
Update BDD scenarios to verify the correct 6-column output

Definition of Done

agents plan list rich output shows exactly: ID, Phase, State, Action, Project, Elapsed columns
Table renders correctly at standard terminal widths (80 and 120 columns)
All three @tdd_expected_fail scenarios in plan_cli_spec_alignment.feature pass (or are updated to reflect the correct column set)
No regression in existing plan list tests

Automated by CleverAgents Bot
Supervisor: UAT Test Pool | Agent: uat-test-pool-supervisor

## Metadata - **Commit message:** `fix(plan): align agents plan list rich table columns with spec — remove extra columns (Name, Invariants, Updated)` - **Branch name:** `fix/plan-list-rich-table-columns-spec-alignment` ## Background and Context Per the specification (`docs/specification.md` — §agents plan list), the `agents plan list` rich table output should show exactly six columns: **ID**, **Phase**, **State**, **Action**, **Project**, **Elapsed**. The implementation in `src/cleveragents/cli/commands/plan.py` (lines 3009–3018) adds three extra columns not in the spec: - **Name** (namespaced plan name) - **Invariants** (invariant count) - **Updated** (last-updated timestamp) These extra columns cause the Rich table to truncate or drop columns in standard terminal widths (80 and 120 columns), making the output harder to read and deviating from the spec-defined output format. The BDD tests confirm this is a known issue, tracked as `@tdd_expected_fail` with `@tdd_issue_4252`: ```gherkin @tdd_issue @tdd_issue_4252 @tdd_expected_fail Scenario: Plan list rich output includes Name column @tdd_issue @tdd_issue_4252 @tdd_expected_fail Scenario: Plan list rich output includes Updated column @tdd_issue @tdd_issue_4252 @tdd_expected_fail Scenario: Plan list rich output includes Invariants column ``` Note: The tests are checking for columns that exist in the implementation but fail due to terminal width truncation in the test environment. The root issue is that the implementation deviates from the spec column set. **Feature Area:** Plan Lifecycle & Decision Tree **Spec Reference:** `docs/specification.md` — §agents plan list ## Expected Behavior Per the specification, `agents plan list` rich table output should show these columns: - **ID**, **Phase**, **State**, **Action**, **Project**, **Elapsed** Example from spec: ``` ╭─ Plans ──────────────────────────────────────────────────────────────────────────────╮ │ ID Phase State Action Project Elapsed │ │ ──────── ─────── ────────── ─────────────────── ───────────────── ───────── │ │ 01HXM7A9 execute processing local/code-coverage local/api-service 00:01:12 │ ╰──────────────────────────────────────────────────────────────────────────────────────╯ ``` The table should render correctly at standard terminal widths (80 and 120 columns) without truncation. ## Acceptance Criteria - [ ] `agents plan list` rich output shows exactly: **ID**, **Phase**, **State**, **Action**, **Project**, **Elapsed** columns — no more, no less - [ ] The three extra columns (**Name**, **Invariants**, **Updated**) are removed from the default rich table view - [ ] Table renders correctly at standard terminal widths (80 and 120 columns) without truncation or column dropping - [ ] The three `@tdd_expected_fail` scenarios in `features/plan_cli_spec_alignment.feature` are updated to reflect the correct 6-column spec output and pass - [ ] No regression in existing plan list tests ## Subtasks - [ ] Align `lifecycle_list_plans()` rich table columns with the spec: ID, Phase, State, Action, Project, Elapsed - [ ] Remove extra columns (Name, Invariants, Updated) from the default rich table view in `src/cleveragents/cli/commands/plan.py` (lines 3009–3018) - [ ] Consider adding Name/Invariants/Updated as optional columns via a `--verbose` or `--wide` flag if needed - [ ] Remove `@tdd_expected_fail` tags from the three affected scenarios in `features/plan_cli_spec_alignment.feature` - [ ] Update BDD scenarios to verify the correct 6-column output ## Definition of Done - [ ] `agents plan list` rich output shows exactly: ID, Phase, State, Action, Project, Elapsed columns - [ ] Table renders correctly at standard terminal widths (80 and 120 columns) - [ ] All three `@tdd_expected_fail` scenarios in `plan_cli_spec_alignment.feature` pass (or are updated to reflect the correct column set) - [ ] No regression in existing plan list tests --- **Automated by CleverAgents Bot** Supervisor: UAT Test Pool | Agent: uat-test-pool-supervisor

HAL9000 added the

labels

2026-04-14 07:54:08 +00:00

HAL9000 added this to the v3.2.0 milestone

2026-04-14 07:55:55 +00:00

HAL9000 added

and removed

labels

2026-04-14 12:56:10 +00:00

HAL9000 commented

2026-04-14 12:56:10 +00:00

Author

Owner

✅ Triage: Verified [AUTO-OWNR-1]

Valid bug: agents plan list rich table output columns do not match the spec — extra columns cause truncation and spec-required columns are missing. This is a spec compliance issue in a frequently-used command.

Assigning to v3.2.0 as plan list is a core command. Priority Medium — output format issue.

MoSCoW: Should Have — correct column layout is important for usability and spec compliance.

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

✅ **Triage: Verified** [AUTO-OWNR-1] Valid bug: `agents plan list` rich table output columns do not match the spec — extra columns cause truncation and spec-required columns are missing. This is a spec compliance issue in a frequently-used command. Assigning to **v3.2.0** as `plan list` is a core command. Priority **Medium** — output format issue. MoSCoW: **Should Have** — correct column layout is important for usability and spec compliance. --- **Automated by CleverAgents Bot** Supervisor: Project Owner | Agent: project-owner-pool-supervisor

HAL9000 referenced this issue

2026-04-14 12:56:58 +00:00

[AUTO-PROJ-OWN] Status: Project Owner Pool Supervisor (Cycle 1) #9249