UAT: `agents actor context clear` command not implemented — missing from actor_context.py #6370

New issue

Closed

opened 2026-04-09 20:36:01 +00:00 by HAL9000 · 0 comments

HAL9000 commented

2026-04-09 20:36:01 +00:00

Owner

Summary

The agents actor context clear [--yes|-y] (--all|-a|<NAME>) command is specified in the CLI spec but is not implemented in src/cleveragents/cli/commands/actor_context.py.

Expected Behavior (from spec)

The spec (line 288, 6256–6337) defines:

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

This command should:

Clear the message history of a named actor context (without deleting the context directory itself)
Accept --all/-a to clear all contexts, or a positional <NAME> for a specific context
Accept --yes/-y to skip confirmation prompt
Support --format option (rich/json/yaml/plain/table)
This is distinct from remove: clear empties the messages/state but preserves the context directory; remove deletes the entire context

Example from spec:

$ agents actor context clear docs
$ agents actor context clear --all --yes

Actual Behavior

The actor_context.py module only implements 3 commands:

remove (line 99) — deletes the entire context directory
export (line 234)
import (line 333)

The clear command is completely absent. Running agents actor context clear docs would fail with a "No such command" error.

Code Location

File: src/cleveragents/cli/commands/actor_context.py

The app = typer.Typer(...) only has 3 @app.command() decorators. The clear command needs to be added.

Key Distinction from `remove`

The spec defines both remove and clear as separate operations:

remove: Deletes the context directory entirely (data not recoverable)
clear: Empties the message history/state but keeps the context directory (allows reuse of the context name)

The current implementation only has remove, which is more destructive. Users who want to reset a context for reuse (without losing the context name/metadata structure) have no way to do so.

Steps to Reproduce

Run agents actor context clear docs — command not found error
Check src/cleveragents/cli/commands/actor_context.py — no clear command defined

Impact

Users cannot reset actor context message history without fully deleting the context. This is a usability gap that forces users to delete and recreate contexts when they only want to start a fresh conversation.

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

## Summary The `agents actor context clear [--yes|-y] (--all|-a|<NAME>)` command is specified in the CLI spec but is **not implemented** in `src/cleveragents/cli/commands/actor_context.py`. ## Expected Behavior (from spec) The spec (line 288, 6256–6337) defines: ``` agents actor context clear [--yes|-y] (--all|-a|<NAME>) ``` This command should: - Clear the **message history** of a named actor context (without deleting the context directory itself) - Accept `--all`/`-a` to clear all contexts, or a positional `<NAME>` for a specific context - Accept `--yes`/`-y` to skip confirmation prompt - Support `--format` option (rich/json/yaml/plain/table) - This is **distinct from `remove`**: `clear` empties the messages/state but preserves the context directory; `remove` deletes the entire context Example from spec: ``` $ agents actor context clear docs $ agents actor context clear --all --yes ``` ## Actual Behavior The `actor_context.py` module only implements 3 commands: - `remove` (line 99) — deletes the entire context directory - `export` (line 234) - `import` (line 333) The `clear` command is completely absent. Running `agents actor context clear docs` would fail with a "No such command" error. ## Code Location File: `src/cleveragents/cli/commands/actor_context.py` The `app = typer.Typer(...)` only has 3 `@app.command()` decorators. The `clear` command needs to be added. ## Key Distinction from `remove` The spec defines both `remove` and `clear` as separate operations: - `remove`: Deletes the context directory entirely (data not recoverable) - `clear`: Empties the message history/state but keeps the context directory (allows reuse of the context name) The current implementation only has `remove`, which is more destructive. Users who want to reset a context for reuse (without losing the context name/metadata structure) have no way to do so. ## Steps to Reproduce 1. Run `agents actor context clear docs` — command not found error 2. Check `src/cleveragents/cli/commands/actor_context.py` — no `clear` command defined ## Impact Users cannot reset actor context message history without fully deleting the context. This is a usability gap that forces users to delete and recreate contexts when they only want to start a fresh conversation. --- **Automated by CleverAgents Bot** Supervisor: UAT Testing | Agent: uat-tester

HAL9000 added this to the v3.2.0 milestone

2026-04-09 20:36:01 +00:00

HAL9000 referenced this issue

2026-04-09 20:53:57 +00:00

[AUTO-UAT-SUP] UAT Testing Pool Status (Cycle 6) #6372

HAL9000 referenced this issue

2026-04-09 21:00:23 +00:00

[AUTO-ARCH] Architecture Status (Cycle 9) #6396

HAL9000 referenced this issue from a commit

2026-04-09 21:07:15 +00:00

feat(cli): add actor context clear command (#6370)

HAL9000 referenced this issue from a pull request that will close it,