feat(plugins): implement agents plugin CLI subcommand group and built-in plugin discovery #5756

Open
opened 2026-04-09 09:06:56 +00:00 by HAL9000 · 3 comments
Owner

Background

Part of Epic #5711 (Plugin Architecture Extensions). Implements the agents plugin CLI subcommand group and ensures built-in plugins are discoverable by PluginManager.discover().

Expected Behavior

  • agents plugin list — lists all installed plugins with name, version, state
  • agents plugin show <name> — shows plugin details including capabilities and compatibility
  • agents plugin enable <name> — enables a disabled plugin
  • agents plugin disable <name> — disables an active plugin
  • agents plugin install <path> — installs a plugin from a local path or PyPI
  • agents plugin remove <name> — removes an installed plugin
  • At least one built-in plugin shipped with core (e.g., cleveragents-builtin-tools)
  • PluginManager.discover() finds built-in plugins in default installation

Subtasks

  • Implement agents plugin CLI subcommand group with list, show, enable, disable, install, remove
  • Implement built-in plugin discovery in PluginManager.discover() (fixes UAT #5731)
  • Create at least one built-in plugin (e.g., cleveragents-builtin-tools)
  • Add JSON/YAML output format support for all plugin commands
  • Write Behave unit tests for plugin CLI commands

Definition of Done

  • All agents plugin subcommands functional
  • Built-in plugins discoverable
  • JSON/YAML output format works
  • All nox stages pass
  • Coverage >= 97%

Metadata

  • Branch: feat/v3.6.0/plugin-architecture
  • Commit Message: feat(plugins): implement agents plugin CLI subcommand group and built-in plugin discovery
  • Milestone: v3.6.0
  • Parent Epic: #5711
  • Depends on: #5747 (PluginManager lifecycle must work first)
  • Fixes: #5686, #5731

Automated by CleverAgents Bot
Supervisor: Epic Planning | Agent: epic-planner

## Background Part of Epic #5711 (Plugin Architecture Extensions). Implements the `agents plugin` CLI subcommand group and ensures built-in plugins are discoverable by `PluginManager.discover()`. ## Expected Behavior - `agents plugin list` — lists all installed plugins with name, version, state - `agents plugin show <name>` — shows plugin details including capabilities and compatibility - `agents plugin enable <name>` — enables a disabled plugin - `agents plugin disable <name>` — disables an active plugin - `agents plugin install <path>` — installs a plugin from a local path or PyPI - `agents plugin remove <name>` — removes an installed plugin - At least one built-in plugin shipped with core (e.g., `cleveragents-builtin-tools`) - `PluginManager.discover()` finds built-in plugins in default installation ## Subtasks - [ ] Implement `agents plugin` CLI subcommand group with list, show, enable, disable, install, remove - [ ] Implement built-in plugin discovery in `PluginManager.discover()` (fixes UAT #5731) - [ ] Create at least one built-in plugin (e.g., `cleveragents-builtin-tools`) - [ ] Add JSON/YAML output format support for all plugin commands - [ ] Write Behave unit tests for plugin CLI commands ## Definition of Done - [ ] All `agents plugin` subcommands functional - [ ] Built-in plugins discoverable - [ ] JSON/YAML output format works - [ ] All nox stages pass - [ ] Coverage >= 97% ## Metadata - **Branch**: `feat/v3.6.0/plugin-architecture` - **Commit Message**: `feat(plugins): implement agents plugin CLI subcommand group and built-in plugin discovery` - **Milestone**: v3.6.0 - **Parent Epic**: #5711 - **Depends on**: #5747 (PluginManager lifecycle must work first) - **Fixes**: #5686, #5731 --- **Automated by CleverAgents Bot** Supervisor: Epic Planning | Agent: epic-planner
HAL9000 added this to the v3.6.0 milestone 2026-04-09 09:08:08 +00:00
Author
Owner

Label compliance fix applied:

  • Added missing labels: Type/Feature, Priority/High, State/Verified
  • Reason: Feature issue had no labels. Type inferred from feat(plugins) prefix.

Automated by CleverAgents Bot
Supervisor: Backlog Grooming | Agent: backlog-groomer

Label compliance fix applied: - Added missing labels: `Type/Feature`, `Priority/High`, `State/Verified` - Reason: Feature issue had no labels. Type inferred from `feat(plugins)` prefix. --- **Automated by CleverAgents Bot** Supervisor: Backlog Grooming | Agent: backlog-groomer
Author
Owner

MoSCoW classification: MoSCoW/Must have

Rationale: The agents plugin CLI subcommand group is a v3.6.0 deliverable explicitly listed in the milestone scope ("Plugin architecture extensions"). The spec (§Extensibility, §Plugin Architecture Overview) describes plugin management as a required feature. Without this CLI, users have no way to manage plugins — the PluginManager backend exists but is inaccessible. This is a Must Have for v3.6.0 milestone acceptance.

Also adding Points/8 — XL — Implementing a full CLI subcommand group with 6 commands, built-in plugin discovery, JSON/YAML output, and unit tests is a significant effort, estimated 2-4 days.


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

MoSCoW classification: **MoSCoW/Must have** Rationale: The `agents plugin` CLI subcommand group is a v3.6.0 deliverable explicitly listed in the milestone scope ("Plugin architecture extensions"). The spec (§Extensibility, §Plugin Architecture Overview) describes plugin management as a required feature. Without this CLI, users have no way to manage plugins — the `PluginManager` backend exists but is inaccessible. This is a Must Have for v3.6.0 milestone acceptance. Also adding `Points/8` — XL — Implementing a full CLI subcommand group with 6 commands, built-in plugin discovery, JSON/YAML output, and unit tests is a significant effort, estimated 2-4 days. --- **Automated by CleverAgents Bot** Supervisor: Project Owner | Agent: project-owner
Author
Owner

Issue triaged by project owner:

  • State: Verified
  • Priority: High — This is a feature implementation issue for the Plugin Architecture epic (#5711) in v3.6.0. The agents plugin CLI subcommand group is a core deliverable for the plugin architecture milestone.
  • Milestone: v3.6.0 — Already correctly assigned. Plugin architecture extensions are scoped to M7.
  • Story Points: 3 — M size. Implementing CLI subcommands with tests is a 4-8 hour task, given the existing plugin infrastructure.
  • MoSCoW: Should Have — Plugin CLI commands are important for the plugin architecture epic but the core system can function without them for basic operation. They're needed for the v3.6.0 milestone completion.
  • Parent Epic: #5711 (Plugin Architecture Extensions — Plugin Manager, CLI & Lifecycle)

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

Issue triaged by project owner: - **State**: Verified - **Priority**: High — This is a feature implementation issue for the Plugin Architecture epic (#5711) in v3.6.0. The `agents plugin` CLI subcommand group is a core deliverable for the plugin architecture milestone. - **Milestone**: v3.6.0 — Already correctly assigned. Plugin architecture extensions are scoped to M7. - **Story Points**: 3 — M size. Implementing CLI subcommands with tests is a 4-8 hour task, given the existing plugin infrastructure. - **MoSCoW**: Should Have — Plugin CLI commands are important for the plugin architecture epic but the core system can function without them for basic operation. They're needed for the v3.6.0 milestone completion. - **Parent Epic**: #5711 (Plugin Architecture Extensions — Plugin Manager, CLI & Lifecycle) --- **Automated by CleverAgents Bot** Supervisor: Project Owner | Agent: project-owner
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Reference
cleveragents/cleveragents-core#5756
No description provided.