UAT: No `agents plugin` CLI commands — plugin management subcommand group entirely absent #5686

New issue

Open

opened 2026-04-09 08:35:13 +00:00 by HAL9000 · 0 comments

HAL9000 commented

2026-04-09 08:35:13 +00:00

Owner

Bug Report

Feature Area: Plugin Architecture — Plugin CLI
Milestone: v3.6.0
Severity: Critical (blocks v3.6.0 milestone acceptance)

What Was Tested

Searched the entire CLI command registration in src/cleveragents/cli/main.py and src/cleveragents/cli/commands/ for any plugin subcommand group.

Expected Behavior (from spec)

The spec (§Extensibility, §Plugin Architecture Overview, and v3.6.0 deliverable #13) describes a plugin management CLI. The task description for this UAT explicitly lists:

agents plugin list      — list installed/registered plugins
agents plugin install   — install a plugin package
agents plugin remove    — remove a plugin
agents plugin enable    — enable a disabled plugin
agents plugin disable   — disable an enabled plugin

The PluginManager class in src/cleveragents/infrastructure/plugins/manager.py provides list_plugins(), activate_plugin(), deactivate_plugin(), and discover() methods that are the natural backend for these CLI commands.

Actual Behavior

No agents plugin subcommand group exists anywhere in the codebase:

# src/cleveragents/cli/main.py — _register_subcommands()
# Lists: project, actor, plan, action, resource, skill, lsp, cleanup,
#        audit, session, config, tool, validation, automation-profile,
#        invariant, repl, tui, server, repo
# MISSING: plugin

The cli/commands/ directory contains no plugin.py file.

Code Location

src/cleveragents/cli/main.py — _register_subcommands() function (lines 74–232)
src/cleveragents/cli/commands/ — directory listing shows no plugin.py
src/cleveragents/infrastructure/plugins/manager.py — backend exists but not wired to CLI

Steps to Reproduce

Run agents plugin list — command not found
Run agents plugin --help — command not found
Inspect src/cleveragents/cli/main.py — no plugin app registered

Impact

Users cannot manage plugins through the CLI. The PluginManager singleton is wired into the DI container (application/container.py line 820) but has no user-facing interface. Plugin discovery, activation, and deactivation are only accessible programmatically.

Suggested Fix

Create src/cleveragents/cli/commands/plugin.py with a Typer app implementing:

agents plugin list — calls plugin_manager.list_plugins()
agents plugin enable <name> — calls plugin_manager.activate_plugin(name)
agents plugin disable <name> — calls plugin_manager.deactivate_plugin(name)
agents plugin discover — calls plugin_manager.discover()

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

## Bug Report **Feature Area**: Plugin Architecture — Plugin CLI **Milestone**: v3.6.0 **Severity**: Critical (blocks v3.6.0 milestone acceptance) ### What Was Tested Searched the entire CLI command registration in `src/cleveragents/cli/main.py` and `src/cleveragents/cli/commands/` for any `plugin` subcommand group. ### Expected Behavior (from spec) The spec (§Extensibility, §Plugin Architecture Overview, and v3.6.0 deliverable #13) describes a plugin management CLI. The task description for this UAT explicitly lists: ``` agents plugin list — list installed/registered plugins agents plugin install — install a plugin package agents plugin remove — remove a plugin agents plugin enable — enable a disabled plugin agents plugin disable — disable an enabled plugin ``` The `PluginManager` class in `src/cleveragents/infrastructure/plugins/manager.py` provides `list_plugins()`, `activate_plugin()`, `deactivate_plugin()`, and `discover()` methods that are the natural backend for these CLI commands. ### Actual Behavior No `agents plugin` subcommand group exists anywhere in the codebase: ```python # src/cleveragents/cli/main.py — _register_subcommands() # Lists: project, actor, plan, action, resource, skill, lsp, cleanup, # audit, session, config, tool, validation, automation-profile, # invariant, repl, tui, server, repo # MISSING: plugin ``` The `cli/commands/` directory contains no `plugin.py` file. ### Code Location - `src/cleveragents/cli/main.py` — `_register_subcommands()` function (lines 74–232) - `src/cleveragents/cli/commands/` — directory listing shows no `plugin.py` - `src/cleveragents/infrastructure/plugins/manager.py` — backend exists but not wired to CLI ### Steps to Reproduce 1. Run `agents plugin list` — command not found 2. Run `agents plugin --help` — command not found 3. Inspect `src/cleveragents/cli/main.py` — no `plugin` app registered ### Impact Users cannot manage plugins through the CLI. The `PluginManager` singleton is wired into the DI container (`application/container.py` line 820) but has no user-facing interface. Plugin discovery, activation, and deactivation are only accessible programmatically. ### Suggested Fix Create `src/cleveragents/cli/commands/plugin.py` with a Typer app implementing: - `agents plugin list` — calls `plugin_manager.list_plugins()` - `agents plugin enable <name>` — calls `plugin_manager.activate_plugin(name)` - `agents plugin disable <name>` — calls `plugin_manager.deactivate_plugin(name)` - `agents plugin discover` — calls `plugin_manager.discover()` Register the app in `main.py` `_register_subcommands()`. --- **Automated by CleverAgents Bot** Supervisor: UAT Testing | Agent: uat-tester

Rows
Columns

UAT: No agents plugin CLI commands — plugin management subcommand group entirely absent #5686