UAT: `agents actor context` has three undocumented extra commands (`add`, `load`, `delete`) not in spec #4838

New issue

Open

opened 2026-04-08 20:06:29 +00:00 by HAL9000 · 0 comments

HAL9000 commented

2026-04-08 20:06:29 +00:00

Owner

Bug Report

Feature Area: CLI Commands — agents actor context

What Was Tested

Code-level analysis of src/cleveragents/cli/commands/context.py and src/cleveragents/cli/commands/actor_context.py against the specification's agents actor context command surface (spec lines 283–288).

Expected Behavior (from spec)

The spec defines exactly 6 subcommands for agents actor context:

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>)

Actual Behavior

agents actor context --help shows 9 subcommands:

add     Add files or directories to the current plan's context.
load    Load files or directories into context (alias for 'add').
remove  Remove files or directories from the current plan's context.
list    List all files in the current plan's context.
show    Display the content of context files.
export  Export a named context to a JSON file.
import  Import a context from a JSON file into a named context.
delete  Delete a named context or all contexts from the context directory.
clear   Clear all files from a named context or the current plan's context.

Three extra commands are present that are not in the spec:

add — adds files to context (no spec equivalent under actor context)
load — alias for add (no spec equivalent)
delete — deletes a named context (no spec equivalent; spec only has clear and remove)

Code Location

src/cleveragents/cli/commands/context.py — lines 216–305 (add, load), lines 644–729 (delete)
These are registered as actor context subcommands via actor.app.add_typer(context.app, name="context") in main.py

Steps to Reproduce

agents actor context --help

Impact

The add and load commands expose file-loading functionality under actor context that is not in the spec. The spec's actor context is for managing named context snapshots, not for adding files.
The delete command overlaps confusingly with remove and clear — the spec uses remove for removing files from context and clear for clearing all files from a context.
These extra commands may confuse users and create undocumented behavior surface.

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

## Bug Report **Feature Area:** CLI Commands — `agents actor context` ### What Was Tested Code-level analysis of `src/cleveragents/cli/commands/context.py` and `src/cleveragents/cli/commands/actor_context.py` against the specification's `agents actor context` command surface (spec lines 283–288). ### Expected Behavior (from spec) The spec defines exactly **6** subcommands for `agents actor context`: ``` 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>) ``` ### Actual Behavior `agents actor context --help` shows **9** subcommands: ``` add Add files or directories to the current plan's context. load Load files or directories into context (alias for 'add'). remove Remove files or directories from the current plan's context. list List all files in the current plan's context. show Display the content of context files. export Export a named context to a JSON file. import Import a context from a JSON file into a named context. delete Delete a named context or all contexts from the context directory. clear Clear all files from a named context or the current plan's context. ``` Three extra commands are present that are **not in the spec**: - `add` — adds files to context (no spec equivalent under `actor context`) - `load` — alias for `add` (no spec equivalent) - `delete` — deletes a named context (no spec equivalent; spec only has `clear` and `remove`) ### Code Location - `src/cleveragents/cli/commands/context.py` — lines 216–305 (`add`, `load`), lines 644–729 (`delete`) - These are registered as `actor context` subcommands via `actor.app.add_typer(context.app, name="context")` in `main.py` ### Steps to Reproduce ```bash agents actor context --help ``` ### Impact - The `add` and `load` commands expose file-loading functionality under `actor context` that is not in the spec. The spec's `actor context` is for managing named context snapshots, not for adding files. - The `delete` command overlaps confusingly with `remove` and `clear` — the spec uses `remove` for removing files from context and `clear` for clearing all files from a context. - These extra commands may confuse users and create undocumented behavior surface. --- **Automated by CleverAgents Bot** Supervisor: UAT Testing | Agent: uat-tester

Rows
Columns

UAT: agents actor context has three undocumented extra commands (add, load, delete) not in spec #4838