cleveragents/cleveragents-core

Fork 3

UAT: `agents actor context list` and `agents actor context show` commands missing — actor context discovery not possible #4955

New issue

Open

opened 2026-04-08 23:40:04 +00:00 by freemo · 1 comment

freemo commented

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

Owner

Bug Report

Summary

The agents actor context list [<REGEX>] and agents actor context show <NAME> commands are completely absent from the implementation. The actor_context.py module only registers three commands (remove, export, import), leaving users with no way to discover or inspect their saved actor contexts.

Expected Behavior (from spec)

The specification (Command Synopsis, line 279 and Command Reference section) defines:

agents actor context list [<REGEX>]
agents actor context show <NAME>

agents actor context list — lists all named actor contexts stored under ~/.cleveragents/context/, with optional regex filtering
agents actor context show <NAME> — displays details of a specific named context (message count, size, last updated, global context keys, etc.)

Actual Behavior

Running agents actor context list or agents actor context show raises a Typer "No such command" error because neither command is registered in actor_context.py.

$ agents actor context list
Error: No such command 'list'.

Code Location

File: src/cleveragents/cli/commands/actor_context.py

The file only registers three commands via @app.command(...):

Line 99: @app.command("remove")
Line 234: @app.command("export")
Line 333: @app.command("import")

The list and show commands are entirely absent.

Impact

Users cannot discover what named contexts exist — they must manually inspect ~/.cleveragents/context/ on the filesystem
Users cannot inspect the contents of a context (message count, size, metadata) without exporting it first
Breaks the actor context management workflow: create context via actor run --context <name>, then list/show/export/import/remove

Steps to Reproduce

Run any actor with a named context: agents actor run --context myctx <actor> "hello"
Try to list contexts: agents actor context list
Observe: Error: No such command 'list'.

Suggested Fix

Add list and show commands to src/cleveragents/cli/commands/actor_context.py:

@app.command("list")
def context_list(
    regex: Annotated[str | None, typer.Argument(help="Optional regex filter")] = None,
    context_dir: Annotated[Path | None, typer.Option("--context-dir", resolve_path=True)] = None,
    fmt: Annotated[str, typer.Option("--format", "-f")] = "rich",
) -> None:
    """List all named actor contexts."""
    base = _default_context_base(context_dir)
    names = _list_context_names(base)
    if regex:
        import re
        names = [n for n in names if re.search(regex, n)]
    # ... render table of names with size/message count

@app.command("show")
def context_show(
    name: Annotated[str, typer.Argument(help="Context name to show")],
    context_dir: Annotated[Path | None, typer.Option("--context-dir", resolve_path=True)] = None,
    fmt: Annotated[str, typer.Option("--format", "-f")] = "rich",
) -> None:
    """Show details of a named actor context."""
    base = _default_context_base(context_dir)
    if not (base / name).exists():
        typer.echo(f"Error: Context '{name}' does not exist.", err=True)
        raise typer.Exit(code=1)
    ctx_mgr = ContextManager(name, context_dir)
    # ... render panels with message count, size, metadata, global_context keys

Definition of Done

agents actor context list lists all contexts with name, message count, size, last updated
agents actor context list <REGEX> filters by regex pattern
agents actor context show <NAME> shows full details of a specific context
Both commands support --format json/yaml/plain/table/rich
Both commands return exit code 0 on success, 1 on error
agents actor context show returns exit code 1 with error message when context does not exist

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

## Bug Report ### Summary The `agents actor context list [<REGEX>]` and `agents actor context show <NAME>` commands are completely absent from the implementation. The `actor_context.py` module only registers three commands (`remove`, `export`, `import`), leaving users with no way to discover or inspect their saved actor contexts. ### Expected Behavior (from spec) The specification (Command Synopsis, line 279 and Command Reference section) defines: ``` agents actor context list [<REGEX>] agents actor context show <NAME> ``` - `agents actor context list` — lists all named actor contexts stored under `~/.cleveragents/context/`, with optional regex filtering - `agents actor context show <NAME>` — displays details of a specific named context (message count, size, last updated, global context keys, etc.) ### Actual Behavior Running `agents actor context list` or `agents actor context show` raises a Typer "No such command" error because neither command is registered in `actor_context.py`. ``` $ agents actor context list Error: No such command 'list'. ``` ### Code Location **File:** `src/cleveragents/cli/commands/actor_context.py` The file only registers three commands via `@app.command(...)`: - Line 99: `@app.command("remove")` - Line 234: `@app.command("export")` - Line 333: `@app.command("import")` The `list` and `show` commands are entirely absent. ### Impact - Users cannot discover what named contexts exist — they must manually inspect `~/.cleveragents/context/` on the filesystem - Users cannot inspect the contents of a context (message count, size, metadata) without exporting it first - Breaks the actor context management workflow: create context via `actor run --context <name>`, then list/show/export/import/remove ### Steps to Reproduce 1. Run any actor with a named context: `agents actor run --context myctx <actor> "hello"` 2. Try to list contexts: `agents actor context list` 3. Observe: `Error: No such command 'list'.` ### Suggested Fix Add `list` and `show` commands to `src/cleveragents/cli/commands/actor_context.py`: ```python @app.command("list") def context_list( regex: Annotated[str | None, typer.Argument(help="Optional regex filter")] = None, context_dir: Annotated[Path | None, typer.Option("--context-dir", resolve_path=True)] = None, fmt: Annotated[str, typer.Option("--format", "-f")] = "rich", ) -> None: """List all named actor contexts.""" base = _default_context_base(context_dir) names = _list_context_names(base) if regex: import re names = [n for n in names if re.search(regex, n)] # ... render table of names with size/message count @app.command("show") def context_show( name: Annotated[str, typer.Argument(help="Context name to show")], context_dir: Annotated[Path | None, typer.Option("--context-dir", resolve_path=True)] = None, fmt: Annotated[str, typer.Option("--format", "-f")] = "rich", ) -> None: """Show details of a named actor context.""" base = _default_context_base(context_dir) if not (base / name).exists(): typer.echo(f"Error: Context '{name}' does not exist.", err=True) raise typer.Exit(code=1) ctx_mgr = ContextManager(name, context_dir) # ... render panels with message count, size, metadata, global_context keys ``` ### Definition of Done - [ ] `agents actor context list` lists all contexts with name, message count, size, last updated - [ ] `agents actor context list <REGEX>` filters by regex pattern - [ ] `agents actor context show <NAME>` shows full details of a specific context - [ ] Both commands support `--format json/yaml/plain/table/rich` - [ ] Both commands return exit code 0 on success, 1 on error - [ ] `agents actor context show` returns exit code 1 with error message when context does not exist --- **Automated by CleverAgents Bot** Supervisor: UAT Testing | Agent: uat-tester

freemo added the

labels

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

freemo referenced this issue

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

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

freemo added

and removed

labels

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

HAL9000 added the

labels

2026-04-09 00:29:18 +00:00

HAL9000 commented

2026-04-09 00:51:37 +00:00

Owner

Issue triaged by project owner:

State: Verified
Priority: Medium — agents actor context list and agents actor context show are missing commands that prevent users from discovering and inspecting saved actor contexts
Milestone: v3.2.0 (actor context management is core functionality)
Story Points: 3 — M — Fix requires implementing both list and show subcommands in actor_context.py
MoSCoW: Must Have — The spec explicitly defines both commands; without them, users have no way to discover or inspect their saved actor contexts, making context management unusable

This is a valid spec compliance bug. The actor_context.py module is missing both list and show subcommand registrations.

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

Issue triaged by project owner: - **State**: Verified - **Priority**: Medium — `agents actor context list` and `agents actor context show` are missing commands that prevent users from discovering and inspecting saved actor contexts - **Milestone**: v3.2.0 (actor context management is core functionality) - **Story Points**: 3 — M — Fix requires implementing both `list` and `show` subcommands in `actor_context.py` - **MoSCoW**: Must Have — The spec explicitly defines both commands; without them, users have no way to discover or inspect their saved actor contexts, making context management unusable This is a valid spec compliance bug. The `actor_context.py` module is missing both `list` and `show` subcommand registrations. --- **Automated by CleverAgents Bot** Supervisor: Project Owner | Agent: project-owner

HAL9000 added

and removed

labels

2026-04-09 00:51:44 +00:00

HAL9000 added this to the v3.2.0 milestone