UAT: agents actor context list, show, and clear commands are missing — spec requires three additional actor context subcommands #2517

Open
opened 2026-04-03 18:43:41 +00:00 by freemo · 1 comment
Owner

Metadata

  • Branch: fix/cli-actor-context-missing-commands
  • Commit Message: fix(cli): add missing actor context list, show, and clear commands
  • Milestone: v3.6.0
  • Parent Epic: #945

Description

The specification defines the following agents actor context subcommands that are currently absent from the implementation:

  • agents actor context list [<REGEX>] — lists named actor contexts with optional regex filter
  • agents actor context show <NAME> — shows details of a named actor context
  • agents actor context clear (--all|-a|<NAME>) — clears messages from a named context or all contexts (with --yes/-y option)

What was tested:
Code analysis of /app/src/cleveragents/cli/commands/actor_context.py (the module registered as agents actor context).

Expected behavior (from spec):
The agents actor context subcommand group should expose 6 commands: remove, list, show, export, import, clear.

Actual behavior:
actor_context.py only defines 3 commands: remove, export, import. The list, show, and clear commands are completely absent.

Code location:
/app/src/cleveragents/cli/commands/actor_context.py — only 446 lines, missing the three commands.

The context.py module (used for the deprecated top-level agents context group) does implement list, show, and clear commands, but these are NOT registered under agents actor context — only the actor_context.py module is registered there (via app.add_typer(actor_context_app, name="context") in actor.py line 840).

Steps to reproduce:

  1. Run agents actor context list → command not found
  2. Run agents actor context show mycontext → command not found
  3. Run agents actor context clear mycontext → command not found

Suggested fix:
Add list, show, and clear commands to actor_context.py following the spec:

  • list [<REGEX>] with optional --context-dir and --format options
  • show <NAME> with optional --context-dir and --format options
  • clear (--all|-a|<NAME>) with --yes/-y, --context-dir, and --format options

Subtasks

  • Add list command to actor_context.py
  • Add show command to actor_context.py
  • Add clear command to actor_context.py
  • Add Behave unit tests for each new command
  • Add Robot Framework integration tests
  • Update PR and close this issue

Definition of Done

  • All three commands are implemented and accessible via agents actor context list/show/clear
  • Commands match spec signatures (arguments, options, output formats)
  • Unit test coverage ≥ 97%
  • All nox sessions pass (nox -e lint, nox -e typecheck, nox -e unit_tests, nox -e integration_tests, nox -e coverage_report)
  • All nox stages pass
  • Coverage >= 97%

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

## Metadata - **Branch**: `fix/cli-actor-context-missing-commands` - **Commit Message**: `fix(cli): add missing actor context list, show, and clear commands` - **Milestone**: v3.6.0 - **Parent Epic**: #945 ## Description The specification defines the following `agents actor context` subcommands that are currently absent from the implementation: - `agents actor context list [<REGEX>]` — lists named actor contexts with optional regex filter - `agents actor context show <NAME>` — shows details of a named actor context - `agents actor context clear (--all|-a|<NAME>)` — clears messages from a named context or all contexts (with `--yes/-y` option) **What was tested:** Code analysis of `/app/src/cleveragents/cli/commands/actor_context.py` (the module registered as `agents actor context`). **Expected behavior (from spec):** The `agents actor context` subcommand group should expose 6 commands: `remove`, `list`, `show`, `export`, `import`, `clear`. **Actual behavior:** `actor_context.py` only defines 3 commands: `remove`, `export`, `import`. The `list`, `show`, and `clear` commands are completely absent. **Code location:** `/app/src/cleveragents/cli/commands/actor_context.py` — only 446 lines, missing the three commands. The `context.py` module (used for the deprecated top-level `agents context` group) does implement `list`, `show`, and `clear` commands, but these are NOT registered under `agents actor context` — only the `actor_context.py` module is registered there (via `app.add_typer(actor_context_app, name="context")` in `actor.py` line 840). **Steps to reproduce:** 1. Run `agents actor context list` → command not found 2. Run `agents actor context show mycontext` → command not found 3. Run `agents actor context clear mycontext` → command not found **Suggested fix:** Add `list`, `show`, and `clear` commands to `actor_context.py` following the spec: - `list [<REGEX>]` with optional `--context-dir` and `--format` options - `show <NAME>` with optional `--context-dir` and `--format` options - `clear (--all|-a|<NAME>)` with `--yes/-y`, `--context-dir`, and `--format` options ## Subtasks - [ ] Add `list` command to `actor_context.py` - [ ] Add `show` command to `actor_context.py` - [ ] Add `clear` command to `actor_context.py` - [ ] Add Behave unit tests for each new command - [ ] Add Robot Framework integration tests - [ ] Update PR and close this issue ## Definition of Done - [ ] All three commands are implemented and accessible via `agents actor context list/show/clear` - [ ] Commands match spec signatures (arguments, options, output formats) - [ ] Unit test coverage ≥ 97% - [ ] All nox sessions pass (`nox -e lint`, `nox -e typecheck`, `nox -e unit_tests`, `nox -e integration_tests`, `nox -e coverage_report`) - All nox stages pass - Coverage >= 97% --- **Automated by CleverAgents Bot** Supervisor: UAT Testing | Agent: ca-uat-tester
freemo added this to the v3.6.0 milestone 2026-04-03 18:43:46 +00:00
Author
Owner

Issue triaged by project owner:

  • State: Verified
  • MoSCoW: Should Have — Spec compliance or quality improvement that should be included in the milestone.

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

Issue triaged by project owner: - **State**: Verified - **MoSCoW**: Should Have — Spec compliance or quality improvement that should be included in the milestone. --- **Automated by CleverAgents Bot** Supervisor: Project Owner | Agent: ca-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#2517
No description provided.