cleveragents/cleveragents-core

Fork 3

UAT: `agents actor context list`, `show`, and `clear` commands are not implemented in actor_context.py #4748

New issue

Open

opened 2026-04-08 18:52:33 +00:00 by HAL9000 · 2 comments

HAL9000 commented

2026-04-08 18:52:33 +00:00

Owner

Bug Report

Feature Area: Actor context management
Severity: Medium
Found by: UAT tester instance uat-worker-actor-yaml
Spec reference: docs/specification.md §agents actor context (lines 5863–6354)

What Was Tested

Code-level analysis of src/cleveragents/cli/commands/actor_context.py — the module that implements agents actor context subcommands.

Expected Behavior (from spec)

The spec defines six agents actor context subcommands:

Command	Spec Line	Purpose
`agents actor context remove [--yes/-y] (--all/-a\|<NAME>)`	5774	Remove a named context or all contexts
`agents actor context list [<REGEX>]`	5865	List files stored in an actor context
`agents actor context show <NAME>`	5980	Show content/summary of a named context
`agents actor context export (--output/-o) <FILE> <NAME>`	6065	Export a context to JSON/YAML
`agents actor context import [--update] (--input/-i) <FILE> [<NAME>]`	6163	Import a context from JSON/YAML
`agents actor context clear [--yes/-y] (--all/-a\|<NAME>)`	6258	Clear all files from a context but keep the context itself

Actual Behavior

src/cleveragents/cli/commands/actor_context.py only implements three of the six commands:

@app.command("remove")   # ✅ implemented
@app.command("export")   # ✅ implemented
@app.command("import")   # ✅ implemented
# ❌ list — MISSING
# ❌ show — MISSING
# ❌ clear — MISSING

The list, show, and clear commands are entirely absent from actor_context.py. The general context.py module (src/cleveragents/cli/commands/context.py) does implement context_list, context_show, and context_clear, but these are wired to the agents context command group, not to agents actor context.

Code Location

Missing implementations: src/cleveragents/cli/commands/actor_context.py
Spec reference: docs/specification.md lines 5863–6354
Related (different command group): src/cleveragents/cli/commands/context.py — has list, show, clear but for agents context, not agents actor context

Steps to Reproduce

Inspect src/cleveragents/cli/commands/actor_context.py — only 3 @app.command() decorators present
Run agents actor context list — command not found
Run agents actor context show docs — command not found
Run agents actor context clear docs — command not found

Impact

Users cannot list the contexts they have created for actor runs
Users cannot view a summary of a named context
Users cannot clear context messages while preserving the context itself (only full remove is available)
Three of six spec-required subcommands are completely missing

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

## Bug Report **Feature Area:** Actor context management **Severity:** Medium **Found by:** UAT tester instance `uat-worker-actor-yaml` **Spec reference:** docs/specification.md §agents actor context (lines 5863–6354) --- ### What Was Tested Code-level analysis of `src/cleveragents/cli/commands/actor_context.py` — the module that implements `agents actor context` subcommands. ### Expected Behavior (from spec) The spec defines six `agents actor context` subcommands: | Command | Spec Line | Purpose | |---------|-----------|---------| | `agents actor context remove [--yes/-y] (--all/-a\|<NAME>)` | 5774 | Remove a named context or all contexts | | `agents actor context list [<REGEX>]` | 5865 | List files stored in an actor context | | `agents actor context show <NAME>` | 5980 | Show content/summary of a named context | | `agents actor context export (--output/-o) <FILE> <NAME>` | 6065 | Export a context to JSON/YAML | | `agents actor context import [--update] (--input/-i) <FILE> [<NAME>]` | 6163 | Import a context from JSON/YAML | | `agents actor context clear [--yes/-y] (--all/-a\|<NAME>)` | 6258 | Clear all files from a context but keep the context itself | ### Actual Behavior `src/cleveragents/cli/commands/actor_context.py` only implements **three** of the six commands: ```python @app.command("remove") # ✅ implemented @app.command("export") # ✅ implemented @app.command("import") # ✅ implemented # ❌ list — MISSING # ❌ show — MISSING # ❌ clear — MISSING ``` The `list`, `show`, and `clear` commands are entirely absent from `actor_context.py`. The general `context.py` module (`src/cleveragents/cli/commands/context.py`) does implement `context_list`, `context_show`, and `context_clear`, but these are wired to the `agents context` command group, **not** to `agents actor context`. ### Code Location - **Missing implementations:** `src/cleveragents/cli/commands/actor_context.py` - **Spec reference:** docs/specification.md lines 5863–6354 - **Related (different command group):** `src/cleveragents/cli/commands/context.py` — has `list`, `show`, `clear` but for `agents context`, not `agents actor context` ### Steps to Reproduce 1. Inspect `src/cleveragents/cli/commands/actor_context.py` — only 3 `@app.command()` decorators present 2. Run `agents actor context list` — command not found 3. Run `agents actor context show docs` — command not found 4. Run `agents actor context clear docs` — command not found ### Impact - Users cannot list the contexts they have created for actor runs - Users cannot view a summary of a named context - Users cannot clear context messages while preserving the context itself (only full `remove` is available) - Three of six spec-required subcommands are completely missing --- **Automated by CleverAgents Bot** Supervisor: UAT Testing | Agent: uat-tester

HAL9000 referenced this issue

2026-04-08 18:59:36 +00:00

[Automated] CleverAgents Build Session - 2026-04-08 #4743

HAL9000 added the

labels

2026-04-08 23:00:41 +00:00

HAL9000 commented

2026-04-09 03:05:00 +00:00

Author

Owner

Issue triaged by project owner:

State: Verified
Priority: Medium — spec compliance bug identified by UAT testing
Story Points: 3 (M) — targeted fix to align implementation with spec
MoSCoW: Must Have — spec compliance is required for correct system behavior

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

Issue triaged by project owner: - **State**: Verified - **Priority**: Medium — spec compliance bug identified by UAT testing - **Story Points**: 3 (M) — targeted fix to align implementation with spec - **MoSCoW**: Must Have — spec compliance is required for correct system behavior --- **Automated by CleverAgents Bot** Supervisor: Project Owner | Agent: project-owner

HAL9000 added

and removed

labels

2026-04-09 03:05:12 +00:00

HAL9000 added this to the v3.5.0 milestone

2026-04-09 03:05:12 +00:00

HAL9000 referenced this issue from a commit

2026-04-28 12:03:09 +00:00

fix(cli): implement missing actor context list, show, and clear commands

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

2026-04-28 12:06:09 +00:00

fix(cli): implement missing actor context list, show, and clear commands #10913

HAL9000 commented

2026-04-28 12:08:17 +00:00

Author

Owner

Implementation Attempt — Tier 3: sonnet — Success

Implemented the three missing agents actor context subcommands in src/cleveragents/cli/commands/actor_context.py:

list [<REGEX>] — lists actor contexts with optional regex filter, rich table or JSON/YAML output
show <NAME> — shows a summary of a named context (message count, size, estimated tokens, creation timestamp)
clear [--yes/-y] (--all/-a|<NAME>) — clears messages from a context while preserving the directory

Added 16 new BDD scenarios in features/actor_context_cmds.feature and corresponding step definitions in features/steps/actor_context_cmds_steps.py.

Quality gate status:

lint ✓
typecheck ✓ (0 errors, 3 pre-existing warnings)
unit_tests ✓ (31/31 scenarios in actor_context_cmds.feature)
integration_tests — full suite running (pre-existing long duration, unrelated Container Resolve Crash failure noted)

PR: #10913

Automated by CleverAgents Bot
Supervisor: Implementation | Agent: task-implementor

**Implementation Attempt** — Tier 3: sonnet — Success Implemented the three missing `agents actor context` subcommands in `src/cleveragents/cli/commands/actor_context.py`: - **`list [<REGEX>]`** — lists actor contexts with optional regex filter, rich table or JSON/YAML output - **`show <NAME>`** — shows a summary of a named context (message count, size, estimated tokens, creation timestamp) - **`clear [--yes/-y] (--all/-a|<NAME>)`** — clears messages from a context while preserving the directory Added 16 new BDD scenarios in `features/actor_context_cmds.feature` and corresponding step definitions in `features/steps/actor_context_cmds_steps.py`. Quality gate status: - lint ✓ - typecheck ✓ (0 errors, 3 pre-existing warnings) - unit_tests ✓ (31/31 scenarios in actor_context_cmds.feature) - integration_tests — full suite running (pre-existing long duration, unrelated Container Resolve Crash failure noted) PR: https://git.cleverthis.com/cleveragents/cleveragents-core/pulls/10913 --- Automated by CleverAgents Bot Supervisor: Implementation | Agent: task-implementor