EPIC: Plugin Architecture Extensions — Plugin Manager, CLI & Lifecycle (v3.6.0) #5711

Open
opened 2026-04-09 08:46:00 +00:00 by HAL9000 · 1 comment
Owner

Background

Part of Legendary #4945 (Advanced Concepts & Extended Integrations). This Epic implements the plugin architecture extensions for CleverAgents, enabling third-party plugins to extend the system with new resource types, actors, tools, and context strategies.

Demonstrable Capability

When this Epic is complete, users can install, manage, and use CleverAgents plugins via the agents plugin CLI commands. Plugins can register new resource types, actors, and tools.

Scope

  • PluginManager with complete lifecycle state machine (LOADING → LOADED → EXECUTING → ACTIVE → DEACTIVATING → INACTIVE)
  • PluginDescriptor with min_core_version/max_core_version compatibility fields
  • agents plugin CLI subcommand group (install, list, enable, disable, remove, show)
  • Plugin registration hooks for resource types, actors, tools, and context strategies
  • Plugin compatibility validation against core version

Child Issues

  • TBD

Definition of Done

  • All child issues are closed and merged
  • agents plugin CLI commands functional
  • Plugin lifecycle state machine complete
  • Plugin compatibility validation works
  • All nox stages pass
  • Coverage >= 97%

Metadata

  • Branch Naming Convention: feat/v3.6.0/plugin-architecture
  • Milestone: v3.6.0
  • Parent Legendary: #4945

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

## Background Part of Legendary #4945 (Advanced Concepts & Extended Integrations). This Epic implements the plugin architecture extensions for CleverAgents, enabling third-party plugins to extend the system with new resource types, actors, tools, and context strategies. ## Demonstrable Capability When this Epic is complete, users can install, manage, and use CleverAgents plugins via the `agents plugin` CLI commands. Plugins can register new resource types, actors, and tools. ## Scope - `PluginManager` with complete lifecycle state machine (LOADING → LOADED → EXECUTING → ACTIVE → DEACTIVATING → INACTIVE) - `PluginDescriptor` with `min_core_version`/`max_core_version` compatibility fields - `agents plugin` CLI subcommand group (install, list, enable, disable, remove, show) - Plugin registration hooks for resource types, actors, tools, and context strategies - Plugin compatibility validation against core version ## Child Issues <!-- Updated by automation after child issues are created --> - [ ] TBD ## Definition of Done - [ ] All child issues are closed and merged - [ ] `agents plugin` CLI commands functional - [ ] Plugin lifecycle state machine complete - [ ] Plugin compatibility validation works - [ ] All nox stages pass - [ ] Coverage >= 97% ## Metadata - **Branch Naming Convention**: `feat/v3.6.0/plugin-architecture` - **Milestone**: v3.6.0 - **Parent Legendary**: #4945 --- **Automated by CleverAgents Bot** Supervisor: Epic Planning | Agent: epic-planner
HAL9000 added this to the v3.6.0 milestone 2026-04-09 08:47:06 +00:00
Author
Owner

Child Issues

The following child issues have been created for this Epic:

  • #5747 — feat(plugins): implement PluginManager lifecycle state machine and PluginDescriptor compatibility fields
  • #5756 — feat(plugins): implement agents plugin CLI subcommand group and built-in plugin discovery

Dependency Chain: #5747 (PluginManager lifecycle) must be completed first, then #5756 (CLI commands) can proceed.

Also linked (existing UAT issues):

  • #5691 — UAT: PluginState.EXECUTING state never set
  • #5686 — UAT: No agents plugin CLI commands
  • #5699 — UAT: PluginDescriptor missing version fields
  • #5726 — UAT: No plugin isolation mechanism
  • #5731 — UAT: No built-in plugins shipped with core

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

## Child Issues The following child issues have been created for this Epic: - [ ] #5747 — feat(plugins): implement PluginManager lifecycle state machine and PluginDescriptor compatibility fields - [ ] #5756 — feat(plugins): implement agents plugin CLI subcommand group and built-in plugin discovery **Dependency Chain**: #5747 (PluginManager lifecycle) must be completed first, then #5756 (CLI commands) can proceed. **Also linked** (existing UAT issues): - #5691 — UAT: PluginState.EXECUTING state never set - #5686 — UAT: No agents plugin CLI commands - #5699 — UAT: PluginDescriptor missing version fields - #5726 — UAT: No plugin isolation mechanism - #5731 — UAT: No built-in plugins shipped with core --- **Automated by CleverAgents Bot** Supervisor: Epic Planning | Agent: epic-planner
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.

Blocks Depends on
Reference
cleveragents/cleveragents-core#5711
No description provided.