UAT: `agents actor context list`, `show`, and `clear` commands are missing — spec mandates all three #6788

New issue

Open

opened 2026-04-10 02:06:05 +00:00 by HAL9000 · 0 comments

HAL9000 commented

2026-04-10 02:06:05 +00:00

Owner

Background

The spec defines six agents actor context subcommands. Three of them (list, show, clear) are completely absent from the implementation.

What Was Tested

Code analysis of src/cleveragents/cli/commands/actor_context.py — listing all registered @app.command() entries.

Expected Behavior (from spec)

The spec Command Synopsis (and corresponding agents actor context section) mandates these six subcommands:

agents actor context remove [--yes|-y] (--all|-a|<NAME>)
agents actor context list [<REGEX>]
agents actor context show <NAME>
agents actor context export (--output|-o) <FILE> <NAME>
agents actor context import [--update] (--input|-i) <FILE> [<NAME>]
agents actor context clear [--yes|-y] (--all|-a|<NAME>)

Each has full documentation with purpose, arguments, and example output in the spec.

Actual Behavior

The file src/cleveragents/cli/commands/actor_context.py only implements three subcommands:

@app.command("remove")   # ✅ Present
@app.command("export")   # ✅ Present
@app.command("import")   # ✅ Present
# Missing: list, show, clear

Running agents actor context list, agents actor context show, or agents actor context clear will fail with an error because these commands do not exist.

Missing Command Definitions

`agents actor context list [<REGEX>]`

Purpose: List actor contexts (files stored in contexts), with optional regex filter.

`agents actor context show <NAME>`

Purpose: Show content/summary of a specific named actor context.

`agents actor context clear [--yes|-y] (--all|-a|<NAME>)`

Purpose: Clear all files from a context but keep the context itself (distinct from remove which deletes the context entirely). The spec notes: "Clear all files from a context but keep the context itself."

Steps to Reproduce

agents actor context list
# Error: No such command 'list'

agents actor context show docs
# Error: No such command 'show'

agents actor context clear docs
# Error: No such command 'clear'

Acceptance Criteria

agents actor context list [<REGEX>] is implemented and lists context names/files
agents actor context show <NAME> is implemented and shows context details
agents actor context clear [--yes|-y] (--all|-a|<NAME>) is implemented and clears context files without deleting the context
All three commands support --format output options (json, yaml, plain, rich)
JSON output follows the spec envelope schema (command, status, exit_code, data, timing, messages)

Subtasks

Implement context_list() command in src/cleveragents/cli/commands/actor_context.py
Implement context_show() command in src/cleveragents/cli/commands/actor_context.py
Implement context_clear() command in src/cleveragents/cli/commands/actor_context.py
Add Behave unit tests for all three new commands
Add Robot Framework integration tests
Run nox -e coverage_report, verify >=97%
Run nox (all default sessions), fix any errors

Definition of Done

This issue is complete when all three missing commands are implemented, tested, and a PR is reviewed and merged.

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

## Background The spec defines six `agents actor context` subcommands. Three of them (`list`, `show`, `clear`) are completely absent from the implementation. ## What Was Tested Code analysis of `src/cleveragents/cli/commands/actor_context.py` — listing all registered `@app.command()` entries. ## Expected Behavior (from spec) The spec Command Synopsis (and corresponding `agents actor context` section) mandates these six subcommands: ``` agents actor context remove [--yes|-y] (--all|-a|<NAME>) agents actor context list [<REGEX>] agents actor context show <NAME> agents actor context export (--output|-o) <FILE> <NAME> agents actor context import [--update] (--input|-i) <FILE> [<NAME>] agents actor context clear [--yes|-y] (--all|-a|<NAME>) ``` Each has full documentation with purpose, arguments, and example output in the spec. ## Actual Behavior The file `src/cleveragents/cli/commands/actor_context.py` only implements three subcommands: ```python @app.command("remove") # ✅ Present @app.command("export") # ✅ Present @app.command("import") # ✅ Present # Missing: list, show, clear ``` Running `agents actor context list`, `agents actor context show`, or `agents actor context clear` will fail with an error because these commands do not exist. ## Missing Command Definitions ### `agents actor context list [<REGEX>]` Purpose: List actor contexts (files stored in contexts), with optional regex filter. ### `agents actor context show <NAME>` Purpose: Show content/summary of a specific named actor context. ### `agents actor context clear [--yes|-y] (--all|-a|<NAME>)` Purpose: Clear all files from a context but keep the context itself (distinct from `remove` which deletes the context entirely). The spec notes: "Clear all files from a context but keep the context itself." ## Steps to Reproduce ```bash agents actor context list # Error: No such command 'list' agents actor context show docs # Error: No such command 'show' agents actor context clear docs # Error: No such command 'clear' ``` ## Acceptance Criteria - [ ] `agents actor context list [<REGEX>]` is implemented and lists context names/files - [ ] `agents actor context show <NAME>` is implemented and shows context details - [ ] `agents actor context clear [--yes|-y] (--all|-a|<NAME>)` is implemented and clears context files without deleting the context - [ ] All three commands support `--format` output options (json, yaml, plain, rich) - [ ] JSON output follows the spec envelope schema (`command`, `status`, `exit_code`, `data`, `timing`, `messages`) ## Subtasks - [ ] Implement `context_list()` command in `src/cleveragents/cli/commands/actor_context.py` - [ ] Implement `context_show()` command in `src/cleveragents/cli/commands/actor_context.py` - [ ] Implement `context_clear()` command in `src/cleveragents/cli/commands/actor_context.py` - [ ] Add Behave unit tests for all three new commands - [ ] Add Robot Framework integration tests - [ ] Run `nox -e coverage_report`, verify >=97% - [ ] Run `nox` (all default sessions), fix any errors ## Definition of Done This issue is complete when all three missing commands are implemented, tested, and a PR is reviewed and merged. --- **Automated by CleverAgents Bot** Supervisor: UAT Testing | Agent: uat-tester

HAL9000 added the

labels

2026-04-10 02:06:09 +00:00

HAL9000 added this to the v3.4.0 milestone

2026-04-10 02:06:12 +00:00

HAL9000 referenced this issue