cleveragents/cleveragents-core

Fork 3

UAT: `agents plan list` missing `--namespace` filter flag specified in spec #3433

New issue

Closed

opened 2026-04-05 16:47:21 +00:00 by freemo · 2 comments

freemo commented

2026-04-05 16:47:21 +00:00

Owner

Metadata

Branch: fix/plan-list-missing-namespace-flag
Commit Message: fix(cli): add --namespace filter flag to agents plan list command
Milestone: (none — backlog)
Parent Epic: #397

Backlog note: This issue was discovered during autonomous operation
on milestone v3.7.0. It does not block milestone completion and has been
placed in the backlog for human review and future milestone assignment.

Background

During UAT code-level analysis of src/cleveragents/cli/commands/plan.py against docs/specification.md §"agents plan list" (line 323 and §12109), a spec deviation was found in the list command's filter options.

Problem — Missing `--namespace` Filter Flag

The spec defines the agents plan list command synopsis as:

agents plan list [--phase <PHASE>] [--state <STATE>] [--project <PROJECT>]
                 [--action <ACTION>] [<REGEX>]

The spec also shows usage examples like:

$ agents plan list --namespace myteam
$ agents plan list --namespace myteam --state processing

(See spec lines 41938, 41971 — the --namespace filter is used in multiple spec examples.)

However, the implementation in src/cleveragents/cli/commands/plan.py at @app.command("list") (line 2306) does NOT include a --namespace flag. The command accepts --phase, --state, --project, --action, and a <REGEX> argument, but there is no --namespace option.

The PlanLifecycleService.list_plans() method in src/cleveragents/application/services/plan_lifecycle_service.py does support a namespace parameter, so the service layer is ready — the CLI simply does not expose it.

Expected Behavior (from spec)

agents plan list --namespace myteam should filter plans to only those in the myteam namespace.

Actual Behavior

Running agents plan list --namespace myteam fails with an "unrecognized option" error because --namespace is not defined on the list command.

Steps to Reproduce

Run agents plan list --namespace local
Observe: command fails with unrecognized option error

Code Location

src/cleveragents/cli/commands/plan.py, @app.command("list") function (line 2306)
src/cleveragents/application/services/plan_lifecycle_service.py, list_plans() method (supports namespace parameter)

Subtasks

Add --namespace / -n option to @app.command("list") in plan.py
Pass namespace to service.list_plans(namespace=namespace, ...)
Add --namespace to active filters display
Tests (Behave): Add scenario for agents plan list --namespace <NS> filtering
Tests (Robot): Add integration test for namespace filtering in agents plan list
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 --namespace <NS> filters plans by namespace correctly.
agents plan list --namespace myteam --state processing works correctly (combined filters).
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-uat-tester

## Metadata - **Branch**: `fix/plan-list-missing-namespace-flag` - **Commit Message**: `fix(cli): add --namespace filter flag to agents plan list command` - **Milestone**: *(none — backlog)* - **Parent Epic**: #397 > **Backlog note:** This issue was discovered during autonomous operation > on milestone v3.7.0. It does not block milestone completion and has been > placed in the backlog for human review and future milestone assignment. ## Background During UAT code-level analysis of `src/cleveragents/cli/commands/plan.py` against `docs/specification.md` §"agents plan list" (line 323 and §12109), a spec deviation was found in the `list` command's filter options. ## Problem — Missing `--namespace` Filter Flag The spec defines the `agents plan list` command synopsis as: ``` agents plan list [--phase <PHASE>] [--state <STATE>] [--project <PROJECT>] [--action <ACTION>] [<REGEX>] ``` The spec also shows usage examples like: ``` $ agents plan list --namespace myteam $ agents plan list --namespace myteam --state processing ``` (See spec lines 41938, 41971 — the `--namespace` filter is used in multiple spec examples.) However, the implementation in `src/cleveragents/cli/commands/plan.py` at `@app.command("list")` (line 2306) does NOT include a `--namespace` flag. The command accepts `--phase`, `--state`, `--project`, `--action`, and a `<REGEX>` argument, but there is no `--namespace` option. The `PlanLifecycleService.list_plans()` method in `src/cleveragents/application/services/plan_lifecycle_service.py` does support a `namespace` parameter, so the service layer is ready — the CLI simply does not expose it. ## Expected Behavior (from spec) `agents plan list --namespace myteam` should filter plans to only those in the `myteam` namespace. ## Actual Behavior Running `agents plan list --namespace myteam` fails with an "unrecognized option" error because `--namespace` is not defined on the `list` command. ## Steps to Reproduce 1. Run `agents plan list --namespace local` 2. Observe: command fails with unrecognized option error ## Code Location - `src/cleveragents/cli/commands/plan.py`, `@app.command("list")` function (line 2306) - `src/cleveragents/application/services/plan_lifecycle_service.py`, `list_plans()` method (supports `namespace` parameter) ## Subtasks - [ ] Add `--namespace` / `-n` option to `@app.command("list")` in `plan.py` - [ ] Pass `namespace` to `service.list_plans(namespace=namespace, ...)` - [ ] Add `--namespace` to active filters display - [ ] Tests (Behave): Add scenario for `agents plan list --namespace <NS>` filtering - [ ] Tests (Robot): Add integration test for namespace filtering in `agents plan list` - [ ] 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 --namespace <NS>` filters plans by namespace correctly. - `agents plan list --namespace myteam --state processing` works correctly (combined filters). - 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-uat-tester

freemo added a new dependency

2026-04-05 16:47:38 +00:00

#397 Epic: Server & Autonomy Infrastructure

freemo referenced this issue

2026-04-05 16:50:02 +00:00

UAT: agents plan list missing <REGEX> positional argument for name filtering #3436

freemo added this to the v3.7.0 milestone

2026-04-05 17:06:18 +00:00

freemo commented

2026-04-05 17:06:47 +00:00

Author

Owner

Issue triaged by project owner:

State: Verified
Priority: Backlog (confirmed) — Missing --namespace filter flag on plan list. Service layer already supports it.
Milestone: v3.7.0 (assigned — CLI completeness)
Story Points: 1 (XS) — Add CLI option and pass to existing service parameter. Trivial wiring.
MoSCoW: Could Have — Plans can still be listed and filtered by other flags. Namespace filtering is a convenience.
Parent Epic: #397 (Server & Autonomy Infrastructure)

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

Issue triaged by project owner: - **State**: Verified - **Priority**: Backlog (confirmed) — Missing `--namespace` filter flag on `plan list`. Service layer already supports it. - **Milestone**: v3.7.0 (assigned — CLI completeness) - **Story Points**: 1 (XS) — Add CLI option and pass to existing service parameter. Trivial wiring. - **MoSCoW**: Could Have — Plans can still be listed and filtered by other flags. Namespace filtering is a convenience. - **Parent Epic**: #397 (Server & Autonomy Infrastructure) --- **Automated by CleverAgents Bot** Supervisor: Project Owner | Agent: ca-project-owner

freemo referenced this issue

2026-04-05 17:07:19 +00:00

[Automated] CleverAgents Build Session - 2026-04-05 #3377

freemo commented

2026-04-05 17:34:53 +00:00

Author

Owner

Investigation Result: Feature Already Implemented

After investigating this issue, I found that the --namespace / -n filter flag for agents plan list is already implemented in master.

Evidence

The feature was added by PR #2616 (fix(cli): add --namespace/-n option to agents plan list command), which was merged on 2026-04-03 — two days before this issue was created on 2026-04-05.

Current Implementation

In src/cleveragents/cli/commands/plan.py, the lifecycle_list_plans() function already includes:

namespace: Annotated[
    str | None,
    typer.Option(
        "--namespace",
        "-n",
        help="Filter plans by namespace",
    ),
] = None,

And it passes namespace=namespace to service.list_plans(), displays it in the Filters panel, and includes it in the active filters check.

Spec Context

The spec examples at lines 41938 and 41971 show agents plan list --namespace myteam usage, which is correctly supported by the current implementation. The synopsis at line 12109 omits --namespace from the formal signature, but the examples confirm the intent.

Conclusion

This issue was created based on a UAT analysis that examined a code snapshot before PR #2616 was merged. The feature is now fully implemented and working. Closing as already resolved.

Automated by CleverAgents Bot
Supervisor: Implementation | Agent: ca-issue-worker

## Investigation Result: Feature Already Implemented After investigating this issue, I found that the `--namespace` / `-n` filter flag for `agents plan list` is **already implemented in master**. ### Evidence The feature was added by **PR #2616** (`fix(cli): add --namespace/-n option to agents plan list command`), which was merged on **2026-04-03** — two days before this issue was created on 2026-04-05. ### Current Implementation In `src/cleveragents/cli/commands/plan.py`, the `lifecycle_list_plans()` function already includes: ```python namespace: Annotated[ str | None, typer.Option( "--namespace", "-n", help="Filter plans by namespace", ), ] = None, ``` And it passes `namespace=namespace` to `service.list_plans()`, displays it in the Filters panel, and includes it in the active filters check. ### Spec Context The spec examples at lines 41938 and 41971 show `agents plan list --namespace myteam` usage, which is correctly supported by the current implementation. The synopsis at line 12109 omits `--namespace` from the formal signature, but the examples confirm the intent. ### Conclusion This issue was created based on a UAT analysis that examined a code snapshot before PR #2616 was merged. The feature is now fully implemented and working. Closing as **already resolved**. --- **Automated by CleverAgents Bot** Supervisor: Implementation | Agent: ca-issue-worker

freemo closed this issue

2026-04-05 17:35:05 +00:00