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

New issue

Open

opened 2026-04-09 06:50:53 +00:00 by HAL9000 · 0 comments

HAL9000 commented

2026-04-09 06:50:53 +00:00

Owner

Summary

The specification defines six agents actor context subcommands:

remove ✅ implemented
export ✅ implemented
import ✅ implemented
list ❌ MISSING
show ❌ MISSING
clear ❌ MISSING

The file src/cleveragents/cli/commands/actor_context.py only registers three commands (remove, export, import). The list, show, and clear commands are completely absent.

Expected Behavior (from spec)

`agents actor context list [<REGEX>]`

Lists files stored in an actor context. Optional regex filter for context names.

$ agents actor context list docs

╭─ Context Files ──────────────────────────────╮
│ Name              Type  Size     Added       │
│ ────────────────  ────  ───────  ──────────  │
│ README.md         file  4.2 KB   02-08 12:10 │
│ docs/overview.md  file  12.8 KB  02-08 12:10 │
│ docs/cli.md       file  9.5 KB   02-08 12:10 │
╰──────────────────────────────────────────────╯

╭─ Stats ───────────────────────╮
│ Total Files: 3                │
│ Total Size: 26.5 KB           │
│ Estimated Tokens: ~6,600      │
│ Languages: Markdown           │
╰───────────────────────────────╯

✓ OK 3 files listed

`agents actor context show <NAME>`

Shows content summary of a named actor context.

$ agents actor context show docs

╭─ Context Summary ───────────╮
│ Context: docs               │
│ Files: 3                    │
│ Total Size: 26.5 KB         │
│ Estimated Tokens: ~6,600    │
│ Created: 2026-02-08 12:10   │
╰─────────────────────────────╯

✓ OK Context displayed

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

Clears all files from a context but keeps the context itself (unlike remove which deletes the context entirely).

$ agents actor context clear docs

Clear context docs? [y/N]: y

╭─ Context Cleared ────╮
│ Context: docs        │
│ Items: 12 removed    │
│ Storage: 48 KB freed │
╰──────────────────────╯

╭─ Retention ────────╮
│ Context: preserved │
│ Files: removed     │
╰────────────────────╯

✓ OK Context cleared

Actual Behavior

Running any of these commands results in an error:

Error: Invalid command 'context'

or if accessed via agents actor context list, Typer reports the subcommand doesn't exist.

Code Location

File: src/cleveragents/cli/commands/actor_context.py
Registered commands: only remove, export, import (lines 99, 234, 333)
Missing: list, show, clear

Spec Reference

docs/specification.md lines 5863–6354:
- ###### agents actor context list (line 5863)
- ###### agents actor context show (line 5978)
- ###### agents actor context clear (line 6256)

Impact

Users cannot list what files are in an actor context
Users cannot view a context summary
Users cannot clear a context without deleting it entirely
All three commands are documented in the spec and expected by users

Subtasks

Implement agents actor context list [<REGEX>] with --format support
Implement agents actor context show <NAME> with --format support
Implement agents actor context clear [--yes|-y] (--all|-a|<NAME>) with --format support
Register all three commands in actor_context.py
Add unit tests (Behave) for each new command
Verify JSON/YAML/plain output envelopes match spec

Definition of Done

All three commands are registered and callable
Each command supports --format json/yaml/plain/rich
list shows files with name, type, size, added timestamp
show shows context summary (files count, total size, estimated tokens, created)
clear removes files but preserves the context directory, with confirmation prompt
Exit codes: 0 for success, 1 for not found
Unit tests pass

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

## Summary The specification defines six `agents actor context` subcommands: - `remove` ✅ implemented - `export` ✅ implemented - `import` ✅ implemented - `list` ❌ **MISSING** - `show` ❌ **MISSING** - `clear` ❌ **MISSING** The file `src/cleveragents/cli/commands/actor_context.py` only registers three commands (`remove`, `export`, `import`). The `list`, `show`, and `clear` commands are completely absent. ## Expected Behavior (from spec) ### `agents actor context list [<REGEX>]` Lists files stored in an actor context. Optional regex filter for context names. ``` $ agents actor context list docs ╭─ Context Files ──────────────────────────────╮ │ Name Type Size Added │ │ ──────────────── ──── ─────── ────────── │ │ README.md file 4.2 KB 02-08 12:10 │ │ docs/overview.md file 12.8 KB 02-08 12:10 │ │ docs/cli.md file 9.5 KB 02-08 12:10 │ ╰──────────────────────────────────────────────╯ ╭─ Stats ───────────────────────╮ │ Total Files: 3 │ │ Total Size: 26.5 KB │ │ Estimated Tokens: ~6,600 │ │ Languages: Markdown │ ╰───────────────────────────────╯ ✓ OK 3 files listed ``` ### `agents actor context show <NAME>` Shows content summary of a named actor context. ``` $ agents actor context show docs ╭─ Context Summary ───────────╮ │ Context: docs │ │ Files: 3 │ │ Total Size: 26.5 KB │ │ Estimated Tokens: ~6,600 │ │ Created: 2026-02-08 12:10 │ ╰─────────────────────────────╯ ✓ OK Context displayed ``` ### `agents actor context clear [--yes|-y] (--all|-a|<NAME>)` Clears all files from a context but keeps the context itself (unlike `remove` which deletes the context entirely). ``` $ agents actor context clear docs Clear context docs? [y/N]: y ╭─ Context Cleared ────╮ │ Context: docs │ │ Items: 12 removed │ │ Storage: 48 KB freed │ ╰──────────────────────╯ ╭─ Retention ────────╮ │ Context: preserved │ │ Files: removed │ ╰────────────────────╯ ✓ OK Context cleared ``` ## Actual Behavior Running any of these commands results in an error: ``` Error: Invalid command 'context' ``` or if accessed via `agents actor context list`, Typer reports the subcommand doesn't exist. ## Code Location - **File**: `src/cleveragents/cli/commands/actor_context.py` - **Registered commands**: only `remove`, `export`, `import` (lines 99, 234, 333) - **Missing**: `list`, `show`, `clear` ## Spec Reference - `docs/specification.md` lines 5863–6354: - `###### agents actor context list` (line 5863) - `###### agents actor context show` (line 5978) - `###### agents actor context clear` (line 6256) ## Impact - Users cannot list what files are in an actor context - Users cannot view a context summary - Users cannot clear a context without deleting it entirely - All three commands are documented in the spec and expected by users ## Subtasks - [ ] Implement `agents actor context list [<REGEX>]` with `--format` support - [ ] Implement `agents actor context show <NAME>` with `--format` support - [ ] Implement `agents actor context clear [--yes|-y] (--all|-a|<NAME>)` with `--format` support - [ ] Register all three commands in `actor_context.py` - [ ] Add unit tests (Behave) for each new command - [ ] Verify JSON/YAML/plain output envelopes match spec ## Definition of Done - All three commands are registered and callable - Each command supports `--format json/yaml/plain/rich` - `list` shows files with name, type, size, added timestamp - `show` shows context summary (files count, total size, estimated tokens, created) - `clear` removes files but preserves the context directory, with confirmation prompt - Exit codes: 0 for success, 1 for not found - Unit tests pass --- **Automated by CleverAgents Bot** Supervisor: UAT Testing | Agent: uat-tester

HAL9000 added the

labels

2026-04-09 06:51:49 +00:00

HAL9000 referenced this issue

2026-04-09 06:53:36 +00:00

[AUTO-GROOMER] Backlog Grooming Report (Cycle 45) #5411