feat(context): implement context strategy plugin loading via Python entry points #8620

Open
opened 2026-04-13 21:16:19 +00:00 by HAL9000 · 0 comments
Owner

Metadata

  • Commit message type: feat
  • Scope: context
  • Branch name prefix: feat/v3.6.0-context-strategy-plugin-loading

Background and Context

As part of Epic #8505 (Advanced Context Strategies & LLM Provider Extensions), context strategy plugins must be loadable from external packages via Python entry points. This enables third-party developers to create and distribute custom context strategies.

This issue depends on the ContextStrategy protocol and registry being implemented first.

This issue blocks Epic #8505.

Expected Behavior

  • External packages can register context strategies via the cleveragents.context_strategies entry point group
  • Strategies are discovered and loaded automatically on startup
  • Strategy loading failures are logged as warnings (not fatal errors)
  • Documentation covers how to create and register a custom strategy plugin

Acceptance Criteria

  • cleveragents.context_strategies entry point group is defined
  • Strategies registered via entry points are discovered on startup
  • Strategy loading failures are logged as warnings
  • Documentation covers custom strategy plugin creation
  • Integration test verifies entry-point-based strategy loading
  • Unit tests achieve >= 97% coverage

Subtasks

  • Define cleveragents.context_strategies entry point group
  • Implement entry-point discovery in StrategyRegistry
  • Add error handling for loading failures (log warning, continue)
  • Write documentation for custom strategy plugin creation
  • Write integration test for entry-point loading
  • Write unit tests for discovery logic

Definition of Done

  1. Context strategy plugin loading via entry points is functional
  2. Integration test verifies entry-point loading
  3. Unit tests pass with >= 97% coverage
  4. Documentation covers custom strategy creation
  5. Code reviewed and merged to main branch

Automated by CleverAgents Bot
Supervisor: Epic Planning | Agent: epic-planning-pool-supervisor

## Metadata - **Commit message type**: `feat` - **Scope**: `context` - **Branch name prefix**: `feat/v3.6.0-context-strategy-plugin-loading` ## Background and Context As part of Epic #8505 (Advanced Context Strategies & LLM Provider Extensions), context strategy plugins must be loadable from external packages via Python entry points. This enables third-party developers to create and distribute custom context strategies. This issue depends on the ContextStrategy protocol and registry being implemented first. This issue blocks Epic #8505. ## Expected Behavior - External packages can register context strategies via the `cleveragents.context_strategies` entry point group - Strategies are discovered and loaded automatically on startup - Strategy loading failures are logged as warnings (not fatal errors) - Documentation covers how to create and register a custom strategy plugin ## Acceptance Criteria - [ ] `cleveragents.context_strategies` entry point group is defined - [ ] Strategies registered via entry points are discovered on startup - [ ] Strategy loading failures are logged as warnings - [ ] Documentation covers custom strategy plugin creation - [ ] Integration test verifies entry-point-based strategy loading - [ ] Unit tests achieve >= 97% coverage ## Subtasks - [ ] Define `cleveragents.context_strategies` entry point group - [ ] Implement entry-point discovery in `StrategyRegistry` - [ ] Add error handling for loading failures (log warning, continue) - [ ] Write documentation for custom strategy plugin creation - [ ] Write integration test for entry-point loading - [ ] Write unit tests for discovery logic ## Definition of Done 1. Context strategy plugin loading via entry points is functional 2. Integration test verifies entry-point loading 3. Unit tests pass with >= 97% coverage 4. Documentation covers custom strategy creation 5. Code reviewed and merged to main branch --- **Automated by CleverAgents Bot** Supervisor: Epic Planning | Agent: epic-planning-pool-supervisor
HAL9000 added this to the v3.6.0 milestone 2026-04-13 21:16:33 +00:00
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.

Dependencies

No dependencies set.

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