UAT: `agents actor remove` missing `--format` option — no JSON/YAML/plain output support; rich-only output cannot be machine-parsed #6491

New issue

Closed

opened 2026-04-09 21:09:41 +00:00 by HAL9000 · 0 comments

HAL9000 commented

2026-04-09 21:09:41 +00:00

Owner

Summary

agents actor remove has no --format option. It always produces rich console output (panels) with no way to get machine-readable JSON/YAML output. All other actor commands (add, list, show) support --format. The spec's JSON example for actor remove implies structured output should be available.

Spec Reference

docs/specification.md lines 5330–5385 — JSON output for agents actor remove local/reviewer:

{
  "command": "agents actor remove local/reviewer",
  "status": "ok",
  "exit_code": 0,
  "data": {
    "actor_removed": {
      "name": "local/reviewer",
      "provider": "openai",
      "model": "gpt-4"
    },
    "impact": {
      "sessions": 0,
      "active_plans": 0,
      "actions_referencing": 0
    },
    "cleanup": {
      "config": "kept on disk",
      "contexts": "1 orphaned"
    }
  },
  "timing": { "duration_ms": 65 },
  "messages": [{ "level": "ok", "text": "Actor removed" }]
}

The spec shows JSON/YAML/plain output variants for actor remove, implying --format should be supported.

Code Location

src/cleveragents/cli/commands/actor.py, lines 781–840 (remove command):

@app.command()
def remove(name: Annotated[str, typer.Argument(help="Actor name to remove")]) -> None:
    """Remove a custom actor."""
    # No fmt parameter — always uses rich console output
    ...
    console.print(actor_panel)
    console.print(impact_panel)
    console.print(cleanup_panel)
    console.print("[green bold]✓ OK[/green bold] Actor removed")

Compare with list and show which both accept fmt: Annotated[str, typer.Option("--format", "-f", ...)].

Steps to Reproduce

agents actor remove --help
# No --format option listed

agents actor remove local/some-actor --format json
# Error: Got unexpected extra argument (--format)

Expected vs Actual

	Expected	Actual
`--format` option	Supported (json/yaml/plain/rich)	Missing
JSON output	Structured `actor_removed`/`impact`/`cleanup` sections	Not available
Automation use	Can parse removal result	Cannot parse — rich panels only

Impact

Automation scripts and CI pipelines cannot parse the result of actor remove. The command is not consistent with other actor commands that all support --format.

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

## Summary `agents actor remove` has no `--format` option. It always produces rich console output (panels) with no way to get machine-readable JSON/YAML output. All other actor commands (`add`, `list`, `show`) support `--format`. The spec's JSON example for `actor remove` implies structured output should be available. ## Spec Reference `docs/specification.md` lines 5330–5385 — JSON output for `agents actor remove local/reviewer`: ```json { "command": "agents actor remove local/reviewer", "status": "ok", "exit_code": 0, "data": { "actor_removed": { "name": "local/reviewer", "provider": "openai", "model": "gpt-4" }, "impact": { "sessions": 0, "active_plans": 0, "actions_referencing": 0 }, "cleanup": { "config": "kept on disk", "contexts": "1 orphaned" } }, "timing": { "duration_ms": 65 }, "messages": [{ "level": "ok", "text": "Actor removed" }] } ``` The spec shows JSON/YAML/plain output variants for `actor remove`, implying `--format` should be supported. ## Code Location `src/cleveragents/cli/commands/actor.py`, lines 781–840 (`remove` command): ```python @app.command() def remove(name: Annotated[str, typer.Argument(help="Actor name to remove")]) -> None: """Remove a custom actor.""" # No fmt parameter — always uses rich console output ... console.print(actor_panel) console.print(impact_panel) console.print(cleanup_panel) console.print("[green bold]✓ OK[/green bold] Actor removed") ``` Compare with `list` and `show` which both accept `fmt: Annotated[str, typer.Option("--format", "-f", ...)]`. ## Steps to Reproduce ```bash agents actor remove --help # No --format option listed agents actor remove local/some-actor --format json # Error: Got unexpected extra argument (--format) ``` ## Expected vs Actual | | Expected | Actual | |---|---|---| | `--format` option | Supported (json/yaml/plain/rich) | Missing | | JSON output | Structured `actor_removed`/`impact`/`cleanup` sections | Not available | | Automation use | Can parse removal result | Cannot parse — rich panels only | ## Impact Automation scripts and CI pipelines cannot parse the result of `actor remove`. The command is not consistent with other actor commands that all support `--format`. --- **Automated by CleverAgents Bot** Supervisor: UAT Testing | Agent: uat-tester

Rows
Columns

UAT: agents actor remove missing --format option — no JSON/YAML/plain output support; rich-only output cannot be machine-parsed #6491