UAT: agents actor context clear command is missing from actor_context.py #5569

Open
opened 2026-04-09 07:36:01 +00:00 by HAL9000 · 2 comments
Owner

Bug Report

Feature Area: Context Assembly Pipeline — Actor Context CLI Commands

Severity: Critical (milestone-blocking — v3.4.0 actor context management)

What Was Tested

Code-level analysis of src/cleveragents/cli/commands/actor_context.py against the specification for agents actor context clear.

Expected Behavior (from spec §6256–§6354)

The spec defines:

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

Purpose: Clear all files from a context but keep the context itself (unlike remove which deletes the context directory entirely).

Arguments:

  • <NAME>: Context name (positional argument). Use --all/-a to target all contexts.
  • --all, -a: Target all contexts instead of a named one.
  • --yes, -y: Skip confirmation.

Output must include:

  • "Context Cleared" panel with Context name, Items removed count, Storage freed
  • "Retention" panel showing context is preserved but files removed

Actual Behavior (from code)

src/cleveragents/cli/commands/actor_context.py only registers:

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

There is no clear command. The context.py file has a clear command but it operates on the current project's context (plan context), not on named actor contexts.

The distinction matters: clear keeps the context directory but removes its contents, while remove deletes the directory entirely. The spec explicitly requires both.

Steps to Reproduce

agents actor context clear docs  # → Error: No such command 'clear'
agents actor context clear --all  # → Error: No such command 'clear'

Code Location

  • Missing command: src/cleveragents/cli/commands/actor_context.py
  • Spec reference: Lines 6256–6354 of docs/specification.md

Impact

Users cannot clear the contents of a named actor context while preserving the context directory. The only option is remove which permanently deletes the context.


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

## Bug Report **Feature Area**: Context Assembly Pipeline — Actor Context CLI Commands **Severity**: Critical (milestone-blocking — v3.4.0 actor context management) ### What Was Tested Code-level analysis of `src/cleveragents/cli/commands/actor_context.py` against the specification for `agents actor context clear`. ### Expected Behavior (from spec §6256–§6354) The spec defines: ``` agents actor context clear [--yes|-y] (--all|-a|<NAME>) ``` **Purpose**: Clear all files from a context but keep the context itself (unlike `remove` which deletes the context directory entirely). **Arguments**: - `<NAME>`: Context name (positional argument). Use `--all/-a` to target all contexts. - `--all, -a`: Target all contexts instead of a named one. - `--yes, -y`: Skip confirmation. **Output** must include: - "Context Cleared" panel with Context name, Items removed count, Storage freed - "Retention" panel showing context is preserved but files removed ### Actual Behavior (from code) `src/cleveragents/cli/commands/actor_context.py` only registers: - `remove` (line 99) — deletes the entire context directory - `export` (line 234) - `import` (line 333) There is no `clear` command. The `context.py` file has a `clear` command but it operates on the **current project's context** (plan context), not on named actor contexts. The distinction matters: `clear` keeps the context directory but removes its contents, while `remove` deletes the directory entirely. The spec explicitly requires both. ### Steps to Reproduce ```bash agents actor context clear docs # → Error: No such command 'clear' agents actor context clear --all # → Error: No such command 'clear' ``` ### Code Location - Missing command: `src/cleveragents/cli/commands/actor_context.py` - Spec reference: Lines 6256–6354 of `docs/specification.md` ### Impact Users cannot clear the contents of a named actor context while preserving the context directory. The only option is `remove` which permanently deletes the context. --- **Automated by CleverAgents Bot** Supervisor: UAT Testing | Agent: uat-tester
Author
Owner

Label compliance fix applied:

  • Added missing labels: Type/Bug, Priority/Medium, State/Unverified
  • Reason: UAT issue had no labels.

Automated by CleverAgents Bot
Supervisor: Backlog Grooming | Agent: backlog-groomer

Label compliance fix applied: - Added missing labels: `Type/Bug`, `Priority/Medium`, `State/Unverified` - Reason: UAT issue had no labels. --- **Automated by CleverAgents Bot** Supervisor: Backlog Grooming | Agent: backlog-groomer
Author
Owner

Hierarchical Compliance Fix: This issue was detected as an orphan (no parent Epic).

Solution: Linked to Epic #5502 (Actor Execution & Configuration — GRAPH Actor, Config Schema & CLI Compliance) based on scope alignment — actor context CLI commands are part of the actor CLI compliance work.

Hierarchy: Issue #5569 → Epic #5502


Automated by CleverAgents Bot
Supervisor: Epic Planning | Agent: epic-planner

**Hierarchical Compliance Fix**: This issue was detected as an orphan (no parent Epic). **Solution**: Linked to Epic #5502 (Actor Execution & Configuration — GRAPH Actor, Config Schema & CLI Compliance) based on scope alignment — actor context CLI commands are part of the actor CLI compliance work. **Hierarchy**: Issue #5569 → Epic #5502 --- **Automated by CleverAgents Bot** Supervisor: Epic Planning | Agent: epic-planner
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Reference
cleveragents/cleveragents-core#5569
No description provided.