UAT: `agents plan status` makes `<PLAN_ID>` optional — spec requires it as a mandatory positional argument #2536

New issue

Open

opened 2026-04-03 18:49:59 +00:00 by freemo · 0 comments

freemo commented

2026-04-03 18:49:59 +00:00

Owner

Bug Report

What was tested

The agents plan status CLI command argument signature vs the specification.

Expected behavior (from spec)

Per docs/specification.md §agents plan status:

agents plan status <PLAN_ID>

Arguments:

<PLAN_ID>: Plan ID (required).

The spec command synopsis also shows:

agents plan status <PLAN_ID>

with <PLAN_ID> as a required positional argument (no brackets).

Actual behavior (from code)

In src/cleveragents/cli/commands/plan.py (line 2094–2179), the plan_status command defines plan_id as optional:

@app.command("status")
def plan_status(
    plan_id: Annotated[
        str | None,
        typer.Argument(help="Plan ID to show status for"),
    ] = None,
    ...
) -> None:

When no plan_id is provided, the command falls back to listing all plans (lines 2115–2159), which is the behavior of agents plan list, not agents plan status.

Impact

agents plan status without a <PLAN_ID> silently behaves like agents plan list instead of failing with a usage error.
Scripts and automation that rely on agents plan status requiring a plan ID will not get the expected error when the ID is accidentally omitted.
The spec clearly distinguishes agents plan list (no required ID, shows all plans) from agents plan status <PLAN_ID> (required ID, shows one plan's detailed status).

Code location

src/cleveragents/cli/commands/plan.py, function plan_status, line ~2094.

Steps to reproduce

Run agents plan status (no arguments)
Observe: command lists all plans instead of showing a usage error

Issue #2509: agents plan execute and agents plan apply make <PLAN_ID> optional (same pattern)

Automated by CleverAgents Bot
Supervisor: UAT Testing | Agent: ca-uat-tester

## Bug Report ### What was tested The `agents plan status` CLI command argument signature vs the specification. ### Expected behavior (from spec) Per `docs/specification.md` §`agents plan status`: ``` agents plan status <PLAN_ID> ``` **Arguments:** - `<PLAN_ID>`: Plan ID (**required**). The spec command synopsis also shows: ``` agents plan status <PLAN_ID> ``` with `<PLAN_ID>` as a required positional argument (no brackets). ### Actual behavior (from code) In `src/cleveragents/cli/commands/plan.py` (line 2094–2179), the `plan_status` command defines `plan_id` as **optional**: ```python @app.command("status") def plan_status( plan_id: Annotated[ str | None, typer.Argument(help="Plan ID to show status for"), ] = None, ... ) -> None: ``` When no `plan_id` is provided, the command falls back to listing all plans (lines 2115–2159), which is the behavior of `agents plan list`, not `agents plan status`. ### Impact - `agents plan status` without a `<PLAN_ID>` silently behaves like `agents plan list` instead of failing with a usage error. - Scripts and automation that rely on `agents plan status` requiring a plan ID will not get the expected error when the ID is accidentally omitted. - The spec clearly distinguishes `agents plan list` (no required ID, shows all plans) from `agents plan status <PLAN_ID>` (required ID, shows one plan's detailed status). ### Code location `src/cleveragents/cli/commands/plan.py`, function `plan_status`, line ~2094. ### Steps to reproduce 1. Run `agents plan status` (no arguments) 2. Observe: command lists all plans instead of showing a usage error ### Related - Issue #2509: `agents plan execute` and `agents plan apply` make `<PLAN_ID>` optional (same pattern) --- **Automated by CleverAgents Bot** Supervisor: UAT Testing | Agent: ca-uat-tester

freemo referenced this issue

2026-04-03 18:50:51 +00:00

[CA-AUTO] Architect Supervisor — architect-1 — Session Tracker #2437

freemo referenced this issue

2026-04-03 18:53:37 +00:00

[UAT-SUPERVISOR] Progress Report — Cycle 1581 — v3.7.0 #2558

freemo referenced this issue

2026-04-03 18:55:33 +00:00

[CA-GROOMER] Backlog Groomer — Session State (groomer-1) #2386

freemo referenced this issue

2026-04-04 20:50:23 +00:00

[CA-AUTO] Project Owner — project-owner-1 — Session Tracker #2793