cleveragents/cleveragents-core

Fork 3

UAT: `agents actor context` missing `list`, `show`, and `clear` subcommands #2405

New issue

Open

opened 2026-04-03 17:34:49 +00:00 by freemo · 1 comment

freemo commented

2026-04-03 17:34:49 +00:00

Owner

Background and Context

The agents actor context command group is missing three of the six subcommands defined in the specification. Only remove, export, and import are implemented. The list, show, and clear subcommands are completely absent from src/cleveragents/cli/commands/actor_context.py.

The spec (§5766-6255) defines six actor context subcommands as part of the Actor YAML & Compiler feature set. Three of these are unimplemented, causing "No such command" errors at runtime.

Current Behavior

Running any of the following commands results in a "No such command" error:

agents actor context list docs
agents actor context show docs
agents actor context clear docs

Inspecting src/cleveragents/cli/commands/actor_context.py confirms only three commands are registered (lines 99, 234, 333): remove, export, and import.

Expected Behavior (from spec §5862-6255)

The spec defines 6 actor context subcommands:

#	Command	Status
1	`agents actor context remove [--yes\|-y] (--all\|-a\|<NAME>)`	✅ Implemented
2	`agents actor context list [<REGEX>]`	❌ MISSING
3	`agents actor context show <NAME>`	❌ MISSING
4	`agents actor context export (--output\|-o) <FILE> <NAME>`	✅ Implemented
5	`agents actor context import [--update] (--input\|-i) <FILE> [<NAME>]`	✅ Implemented
6	`agents actor context clear [--yes\|-y] (--all\|-a\|<NAME>)`	❌ MISSING

agents actor context list [<REGEX>] — Lists files stored in an actor context, optionally filtered by a regex pattern. Output should include Name, Type, Size, and Added columns, plus a Stats panel showing Total Files, Total Size, Estimated Tokens, and Languages.

agents actor context show <NAME> — Shows detailed context information for a named actor context, including messages, metadata, state, and global_context fields.

agents actor context clear [--yes\|-y] (--all\|-a\|<NAME>) — Clears context messages from one or all actor contexts. This is distinct from remove, which deletes the context directory entirely; clear only wipes the message history/data within the context.

Supporting Information

Code location:

src/cleveragents/cli/commands/actor_context.py — only has remove (line 99), export (line 234), and import (line 333) command handlers
Missing: list, show, and clear command handler functions

Spec reference: docs/specification.md §5862-6255 (agents actor context list, show, and clear sections)

Steps to reproduce:

agents actor context list          # Error: No such command 'list'
agents actor context show myctx    # Error: No such command 'show'
agents actor context clear myctx   # Error: No such command 'clear'

Metadata

Branch: fix/actor-context-missing-list-show-clear
Commit Message: fix(cli): implement actor context list, show, and clear subcommands
Milestone: v3.5.0
Parent Epic: #392

Subtasks

Implement agents actor context list [<REGEX>] command handler in actor_context.py
- Display Name, Type, Size, Added columns for files in the context
- Display Stats panel: Total Files, Total Size, Estimated Tokens, Languages
- Support optional <REGEX> argument to filter listed files
Implement agents actor context show <NAME> command handler in actor_context.py
- Display messages, metadata, state, and global_context fields
- Format output consistently with other show commands in the CLI
Implement agents actor context clear [--yes|-y] (--all|-a|<NAME>) command handler in actor_context.py
- Support --all / -a flag to clear all actor contexts
- Support <NAME> argument to clear a specific named context
- Support --yes / -y flag to skip confirmation prompt
- Ensure clear only wipes message history/data, NOT the context directory (that is remove)
Register all three new commands on the context_app Typer group
Tests (Behave): Add scenarios for actor context list — no filter, with regex filter, empty context
Tests (Behave): Add scenarios for actor context show — existing context, non-existent context
Tests (Behave): Add scenarios for actor context clear — single context, --all, with and without --yes confirmation
Tests (Behave): Add @tdd_expected_fail tagged scenarios capturing the "No such command" failure before fix
Tests (Robot): Add integration tests for all three new subcommands end-to-end
Verify nox -e typecheck passes (full static typing on all new command handlers)
Verify coverage >= 97% via nox -s coverage_report
Run nox (all default sessions), fix any errors

Definition of Done

This issue is complete when:

All subtasks above are completed and checked off.
agents actor context list [<REGEX>] lists context files with Name, Type, Size, Added columns and a Stats panel.
agents actor context show <NAME> displays messages, metadata, state, and global_context for the named context.
agents actor context clear [--yes|-y] (--all|-a|<NAME>) clears context message history without deleting the context directory.
All three commands are registered on the context_app Typer group in actor_context.py.
A Git commit is created where the first line of the commit message matches the Commit Message in Metadata exactly, followed by a blank line, then additional lines providing relevant details about the implementation.
The commit is pushed to the remote on the branch matching the Branch in Metadata exactly.
The commit is submitted as a pull request to master, reviewed, and merged before this issue is marked done.
All nox stages pass.
Coverage >= 97%.

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

## Background and Context The `agents actor context` command group is missing three of the six subcommands defined in the specification. Only `remove`, `export`, and `import` are implemented. The `list`, `show`, and `clear` subcommands are completely absent from `src/cleveragents/cli/commands/actor_context.py`. The spec (§5766-6255) defines six `actor context` subcommands as part of the Actor YAML & Compiler feature set. Three of these are unimplemented, causing "No such command" errors at runtime. ## Current Behavior Running any of the following commands results in a `"No such command"` error: ```bash agents actor context list docs agents actor context show docs agents actor context clear docs ``` Inspecting `src/cleveragents/cli/commands/actor_context.py` confirms only three commands are registered (lines 99, 234, 333): `remove`, `export`, and `import`. ## Expected Behavior (from spec §5862-6255) The spec defines 6 `actor context` subcommands: | # | Command | Status | |---|---------|--------| | 1 | `agents actor context remove [--yes\|-y] (--all\|-a\|<NAME>)` | ✅ Implemented | | 2 | `agents actor context list [<REGEX>]` | ❌ MISSING | | 3 | `agents actor context show <NAME>` | ❌ MISSING | | 4 | `agents actor context export (--output\|-o) <FILE> <NAME>` | ✅ Implemented | | 5 | `agents actor context import [--update] (--input\|-i) <FILE> [<NAME>]` | ✅ Implemented | | 6 | `agents actor context clear [--yes\|-y] (--all\|-a\|<NAME>)` | ❌ MISSING | **`agents actor context list [<REGEX>]`** — Lists files stored in an actor context, optionally filtered by a regex pattern. Output should include Name, Type, Size, and Added columns, plus a Stats panel showing Total Files, Total Size, Estimated Tokens, and Languages. **`agents actor context show <NAME>`** — Shows detailed context information for a named actor context, including messages, metadata, state, and global_context fields. **`agents actor context clear [--yes\|-y] (--all\|-a\|<NAME>)`** — Clears context messages from one or all actor contexts. This is distinct from `remove`, which deletes the context directory entirely; `clear` only wipes the message history/data within the context. ## Supporting Information **Code location:** - `src/cleveragents/cli/commands/actor_context.py` — only has `remove` (line 99), `export` (line 234), and `import` (line 333) command handlers - Missing: `list`, `show`, and `clear` command handler functions **Spec reference:** `docs/specification.md` §5862-6255 (`agents actor context list`, `show`, and `clear` sections) **Steps to reproduce:** ```bash agents actor context list # Error: No such command 'list' agents actor context show myctx # Error: No such command 'show' agents actor context clear myctx # Error: No such command 'clear' ``` --- ## Metadata - **Branch**: `fix/actor-context-missing-list-show-clear` - **Commit Message**: `fix(cli): implement actor context list, show, and clear subcommands` - **Milestone**: v3.5.0 - **Parent Epic**: #392 ## Subtasks - [ ] Implement `agents actor context list [<REGEX>]` command handler in `actor_context.py` - [ ] Display Name, Type, Size, Added columns for files in the context - [ ] Display Stats panel: Total Files, Total Size, Estimated Tokens, Languages - [ ] Support optional `<REGEX>` argument to filter listed files - [ ] Implement `agents actor context show <NAME>` command handler in `actor_context.py` - [ ] Display messages, metadata, state, and global_context fields - [ ] Format output consistently with other `show` commands in the CLI - [ ] Implement `agents actor context clear [--yes|-y] (--all|-a|<NAME>)` command handler in `actor_context.py` - [ ] Support `--all` / `-a` flag to clear all actor contexts - [ ] Support `<NAME>` argument to clear a specific named context - [ ] Support `--yes` / `-y` flag to skip confirmation prompt - [ ] Ensure `clear` only wipes message history/data, NOT the context directory (that is `remove`) - [ ] Register all three new commands on the `context_app` Typer group - [ ] Tests (Behave): Add scenarios for `actor context list` — no filter, with regex filter, empty context - [ ] Tests (Behave): Add scenarios for `actor context show` — existing context, non-existent context - [ ] Tests (Behave): Add scenarios for `actor context clear` — single context, `--all`, with and without `--yes` confirmation - [ ] Tests (Behave): Add `@tdd_expected_fail` tagged scenarios capturing the "No such command" failure before fix - [ ] Tests (Robot): Add integration tests for all three new subcommands end-to-end - [ ] Verify `nox -e typecheck` passes (full static typing on all new command handlers) - [ ] Verify coverage >= 97% via `nox -s coverage_report` - [ ] Run `nox` (all default sessions), fix any errors ## Definition of Done This issue is complete when: - All subtasks above are completed and checked off. - `agents actor context list [<REGEX>]` lists context files with Name, Type, Size, Added columns and a Stats panel. - `agents actor context show <NAME>` displays messages, metadata, state, and global_context for the named context. - `agents actor context clear [--yes|-y] (--all|-a|<NAME>)` clears context message history without deleting the context directory. - All three commands are registered on the `context_app` Typer group in `actor_context.py`. - A Git commit is created where the **first line** of the commit message matches the Commit Message in Metadata exactly, followed by a blank line, then additional lines providing relevant details about the implementation. - The commit is pushed to the remote on the branch matching the **Branch** in Metadata exactly. - The commit is submitted as a **pull request** to `master`, reviewed, and **merged** before this issue is marked done. - All nox stages pass. - Coverage >= 97%. --- **Automated by CleverAgents Bot** Supervisor: UAT Testing | Agent: ca-uat-tester

freemo added this to the v3.5.0 milestone

2026-04-03 17:34:57 +00:00

freemo added a new dependency

2026-04-03 17:35:23 +00:00

#392 Epic: Actor YAML & Compiler

freemo referenced this issue

2026-04-03 17:42:38 +00:00

[UAT-SUPERVISOR] Progress Report — Cycle 1511 — v3.7.0 #2421

freemo referenced this issue

2026-04-03 17:52:45 +00:00

[UAT-SUPERVISOR] Progress Report — Cycle 1521 — v3.7.0 #2422

freemo referenced this issue

2026-04-03 18:02:52 +00:00

[UAT-SUPERVISOR] Progress Report — Cycle 1531 — v3.7.0 #2433

freemo referenced this issue

2026-04-03 18:12:59 +00:00

[UAT-SUPERVISOR] Progress Report — Cycle 1541 — v3.7.0 #2434

freemo referenced this issue

2026-04-03 18:23:14 +00:00

[UAT-SUPERVISOR] Progress Report — Cycle 1551 — v3.7.0 #2445

freemo commented

2026-04-03 18:24:46 +00:00

Author

Owner

Issue triaged by project owner:

State: Verified
Priority: Medium — Three of six agents actor context subcommands are missing (list, show, clear). This is a significant feature gap in the actor context management CLI.
Milestone: v3.5.0
MoSCoW: Should Have — The missing subcommands are spec-required. While remove, export, and import cover the critical operations, list, show, and clear are important for context management workflows.
Parent Epic: Needs assignment — linking to Epic #392 (Actor YAML & Compiler) for actor context management.

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

Issue triaged by project owner: - **State**: Verified - **Priority**: Medium — Three of six `agents actor context` subcommands are missing (`list`, `show`, `clear`). This is a significant feature gap in the actor context management CLI. - **Milestone**: v3.5.0 - **MoSCoW**: Should Have — The missing subcommands are spec-required. While `remove`, `export`, and `import` cover the critical operations, `list`, `show`, and `clear` are important for context management workflows. - **Parent Epic**: Needs assignment — linking to Epic #392 (Actor YAML & Compiler) for actor context management. --- **Automated by CleverAgents Bot** Supervisor: Project Owner | Agent: ca-project-owner