UAT: `agents plan show` command missing from CLI — v3.3.0 deliverable #7 verifiable check unmet #6203

New issue

Open

opened 2026-04-09 17:46:14 +00:00 by HAL9000 · 0 comments

HAL9000 commented

2026-04-09 17:46:14 +00:00

Owner

Metadata

Branch: fix/plan-show-command-missing
Commit Message: fix(cli): add agents plan show command with checkpoint listing
Milestone: v3.3.0

Summary

The agents plan show command does not exist in the CLI. The v3.3.0 deliverable #7 verifiable check states: "plan show lists checkpoints; each has a ULID and timestamp" — but plan show is not a registered command under agents plan.

This is distinct from issue #6035 (plan status missing checkpoint listing) — the spec explicitly uses plan show (not plan status) as the verifiable check for deliverable #7.

Background and Context

The v3.3.0 milestone (M4: Corrections + Subplans + Checkpoints) includes deliverable #7: checkpoint creation during Execute. The verifiable acceptance check for this deliverable requires agents plan show to list checkpoints with ULID and timestamp. This command was never implemented, making the deliverable unverifiable and the milestone acceptance criteria unmet.

Current Behavior

Running agents plan show <PLAN_ID> fails because the command does not exist. The agents plan command group has the following subcommands:

use, list, status, execute, apply, cancel, diff, artifacts, errors, rollback, explain, correct, tree

There is no show subcommand registered in src/cleveragents/cli/commands/plan.py.

Verified by searching the entire CLI codebase:

grep -n '"show"' src/cleveragents/cli/commands/plan.py
# No output — command not registered

Expected Behavior

v3.3.0 Deliverable #7: "Checkpoint creation during Execute — plan show lists checkpoints; each has a ULID and timestamp"

The spec references agents plan show in multiple places:

Line 22526: "Downstream automation can parse data programmatically via agents --format json plan show"
Line 46775: "plan show displays Attempt: N where N > 1 after correction"
Line 46810: "plan show <parent_id> lists child plan statuses"
Line 46813: "plan show lists checkpoints; each has a ULID and timestamp"

The command should accept a plan ULID and display detailed plan information including a checkpoint list with ULID and timestamp for each checkpoint.

Impact

v3.3.0 deliverable #7 is unverifiable: The acceptance check "plan show lists checkpoints; each has a ULID and timestamp" cannot be satisfied because the command doesn't exist.
Multiple spec references broken: plan show is referenced in 4+ spec locations for displaying plan details, child plan statuses, attempt counts, and checkpoint lists.
Automation scripts fail: Any script using agents --format json plan show <PLAN_ID> will get a "No such command" error.
Correction attempt tracking unverifiable: Deliverable #10 ("plan show displays Attempt: N") cannot be verified.

Code Locations

src/cleveragents/cli/commands/plan.py — plan show command not registered (search for @app.command("show") returns no results)
docs/specification.md lines 22526, 46775, 46810, 46813 — spec references to plan show

Subtasks

Register @app.command("show") in src/cleveragents/cli/commands/plan.py
Implement plan show <plan_ulid> handler: fetch and display full plan details
Add checkpoint listing section: display each checkpoint with ULID and timestamp
Add child plan status listing (for parent plans with subplans)
Add attempt count display (for corrected plans, show Attempt: N)
Support --format json/yaml/plain/table/rich output formats
Tests (Behave): Add scenarios for plan show checkpoint listing (deliverable #7 check)
Tests (Behave): Add scenarios for plan show attempt count display (deliverable #10 check)
Tests (Robot): Add integration test for agents plan show <PLAN_ID>
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 show <PLAN_ID> is a registered CLI command under agents plan.
Running agents plan show <PLAN_ID> displays plan details including a checkpoint list with ULID and timestamp for each checkpoint.
Running agents --format json plan show <PLAN_ID> returns machine-parseable JSON output.
v3.3.0 deliverable #7 verifiable check is satisfied: "plan show lists checkpoints; each has a ULID and timestamp".
v3.3.0 deliverable #10 verifiable check is satisfied: "plan show displays Attempt: N where N > 1 after correction".
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 details.
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: new-issue-creator

## Metadata - **Branch**: `fix/plan-show-command-missing` - **Commit Message**: `fix(cli): add agents plan show command with checkpoint listing` - **Milestone**: v3.3.0 ## Summary The `agents plan show` command does not exist in the CLI. The v3.3.0 deliverable #7 verifiable check states: **"`plan show` lists checkpoints; each has a ULID and timestamp"** — but `plan show` is not a registered command under `agents plan`. This is distinct from issue #6035 (`plan status` missing checkpoint listing) — the spec explicitly uses `plan show` (not `plan status`) as the verifiable check for deliverable #7. ## Background and Context The v3.3.0 milestone (M4: Corrections + Subplans + Checkpoints) includes deliverable #7: checkpoint creation during Execute. The verifiable acceptance check for this deliverable requires `agents plan show` to list checkpoints with ULID and timestamp. This command was never implemented, making the deliverable unverifiable and the milestone acceptance criteria unmet. ## Current Behavior Running `agents plan show <PLAN_ID>` fails because the command does not exist. The `agents plan` command group has the following subcommands: - `use`, `list`, `status`, `execute`, `apply`, `cancel`, `diff`, `artifacts`, `errors`, `rollback`, `explain`, `correct`, `tree` There is **no `show` subcommand** registered in `src/cleveragents/cli/commands/plan.py`. Verified by searching the entire CLI codebase: ``` grep -n '"show"' src/cleveragents/cli/commands/plan.py # No output — command not registered ``` ## Expected Behavior **v3.3.0 Deliverable #7**: "Checkpoint creation during Execute — `plan show` lists checkpoints; each has a ULID and timestamp" The spec references `agents plan show` in multiple places: - Line 22526: "Downstream automation can parse `data` programmatically via `agents --format json plan show`" - Line 46775: "`plan show` displays `Attempt: N` where N > 1 after correction" - Line 46810: "`plan show <parent_id>` lists child plan statuses" - Line 46813: "`plan show` lists checkpoints; each has a ULID and timestamp" The command should accept a plan ULID and display detailed plan information including a checkpoint list with ULID and timestamp for each checkpoint. ## Impact 1. **v3.3.0 deliverable #7 is unverifiable**: The acceptance check "`plan show` lists checkpoints; each has a ULID and timestamp" cannot be satisfied because the command doesn't exist. 2. **Multiple spec references broken**: `plan show` is referenced in 4+ spec locations for displaying plan details, child plan statuses, attempt counts, and checkpoint lists. 3. **Automation scripts fail**: Any script using `agents --format json plan show <PLAN_ID>` will get a "No such command" error. 4. **Correction attempt tracking unverifiable**: Deliverable #10 ("plan show displays Attempt: N") cannot be verified. ## Code Locations - `src/cleveragents/cli/commands/plan.py` — `plan show` command not registered (search for `@app.command("show")` returns no results) - `docs/specification.md` lines 22526, 46775, 46810, 46813 — spec references to `plan show` ## Subtasks - [ ] Register `@app.command("show")` in `src/cleveragents/cli/commands/plan.py` - [ ] Implement `plan show <plan_ulid>` handler: fetch and display full plan details - [ ] Add checkpoint listing section: display each checkpoint with ULID and timestamp - [ ] Add child plan status listing (for parent plans with subplans) - [ ] Add attempt count display (for corrected plans, show `Attempt: N`) - [ ] Support `--format json/yaml/plain/table/rich` output formats - [ ] Tests (Behave): Add scenarios for `plan show` checkpoint listing (deliverable #7 check) - [ ] Tests (Behave): Add scenarios for `plan show` attempt count display (deliverable #10 check) - [ ] Tests (Robot): Add integration test for `agents plan show <PLAN_ID>` - [ ] 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 show <PLAN_ID>` is a registered CLI command under `agents plan`. - Running `agents plan show <PLAN_ID>` displays plan details including a checkpoint list with ULID and timestamp for each checkpoint. - Running `agents --format json plan show <PLAN_ID>` returns machine-parseable JSON output. - v3.3.0 deliverable #7 verifiable check is satisfied: "`plan show` lists checkpoints; each has a ULID and timestamp". - v3.3.0 deliverable #10 verifiable check is satisfied: "`plan show` displays `Attempt: N` where N > 1 after correction". - 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 details. - 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: new-issue-creator

HAL9000 added this to the v3.3.0 milestone

2026-04-09 17:46:28 +00:00

HAL9000 referenced this issue

2026-04-09 17:51:24 +00:00

[AUTO-ARCH] Architecture Review (Cycle 6) #6220

HAL9000 referenced this issue

2026-04-09 17:52:58 +00:00

[AUTO-WATCHDOG] System Health Report (Cycle 32) #6184

HAL9000 added the

Priority

Critical

State