UAT: `agents project` has three undocumented extra commands (`init`, `status`, `file-filter`) not in spec #4854

New issue

Open

opened 2026-04-08 20:09:31 +00:00 by HAL9000 · 0 comments

HAL9000 commented

2026-04-08 20:09:31 +00:00

Owner

Bug Report

Feature Area: CLI Commands — agents project

What Was Tested

Code-level analysis of src/cleveragents/cli/commands/project.py against the specification's agents project command surface (spec lines 226–267).

Expected Behavior (from spec)

The spec defines the following subcommands for agents project:

agents project create
agents project link-resource
agents project unlink-resource
agents project list
agents project show
agents project delete
agents project context set
agents project context show
agents project context inspect
agents project context simulate

Actual Behavior

agents project --help shows 11 subcommands — including three undocumented commands:

init             Initialize a new CleverAgents project.
status           Show current project status and information.
clean            Clean project cache and temporary files.
create           Create a new namespaced project.
link-resource    Link a resource to a project.
unlink-resource  Unlink a resource from a project.
list             List all projects in the registry.
show             Show details of a project.
delete           Delete a project from the registry.
file-filter      Manage project include/exclude filters
context          Manage project context policies

Three extra commands are present that are not in the spec:

init — initializes a project in the current directory (spec has a top-level agents init for global init, not project init)
status — shows current project status (not in spec's project subcommands)
file-filter — manages project include/exclude filters (not in spec)

Note: clean is also undocumented but is already tracked in a separate issue as an unimplemented stub.

Code Location

src/cleveragents/cli/commands/project.py:
- init — line 402
- status — line 475
- file-filter — line 265 (as a sub-app)

Steps to Reproduce

agents project --help

Impact

agents project init overlaps with the top-level agents init command, creating confusion about which to use for project initialization.
agents project status provides project status information that is not in the spec's command surface.
agents project file-filter exposes file filtering functionality that is not in the spec, creating an undocumented API surface.

These extra commands may confuse users and create undocumented behavior. If intentional, they should be added to the spec.

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

## Bug Report **Feature Area:** CLI Commands — `agents project` ### What Was Tested Code-level analysis of `src/cleveragents/cli/commands/project.py` against the specification's `agents project` command surface (spec lines 226–267). ### Expected Behavior (from spec) The spec defines the following subcommands for `agents project`: ``` agents project create agents project link-resource agents project unlink-resource agents project list agents project show agents project delete agents project context set agents project context show agents project context inspect agents project context simulate ``` ### Actual Behavior `agents project --help` shows **11** subcommands — including three undocumented commands: ``` init Initialize a new CleverAgents project. status Show current project status and information. clean Clean project cache and temporary files. create Create a new namespaced project. link-resource Link a resource to a project. unlink-resource Unlink a resource from a project. list List all projects in the registry. show Show details of a project. delete Delete a project from the registry. file-filter Manage project include/exclude filters context Manage project context policies ``` Three extra commands are present that are **not in the spec**: - `init` — initializes a project in the current directory (spec has a top-level `agents init` for global init, not `project init`) - `status` — shows current project status (not in spec's `project` subcommands) - `file-filter` — manages project include/exclude filters (not in spec) Note: `clean` is also undocumented but is already tracked in a separate issue as an unimplemented stub. ### Code Location - `src/cleveragents/cli/commands/project.py`: - `init` — line 402 - `status` — line 475 - `file-filter` — line 265 (as a sub-app) ### Steps to Reproduce ```bash agents project --help ``` ### Impact - `agents project init` overlaps with the top-level `agents init` command, creating confusion about which to use for project initialization. - `agents project status` provides project status information that is not in the spec's command surface. - `agents project file-filter` exposes file filtering functionality that is not in the spec, creating an undocumented API surface. These extra commands may confuse users and create undocumented behavior. If intentional, they should be added to the spec. --- **Automated by CleverAgents Bot** Supervisor: UAT Testing | Agent: uat-tester

HAL9000 referenced this issue

2026-04-08 20:11:41 +00:00

[Automated] CleverAgents Build Session - 2026-04-08 #4799

HAL9000 referenced this issue

2026-04-08 20:12:39 +00:00

[Automated] CleverAgents Build Session - 2026-04-08 #4799

HAL9000 referenced this issue

2026-04-08 20:16:04 +00:00

[Automated] CleverAgents Build Session - 2026-04-08 #4799

HAL9000 added this to the v3.5.0 milestone

2026-04-08 20:18:54 +00:00

HAL9000 referenced this issue