UAT: `agents actor context export` requires mandatory `--output` flag not present in spec signature #6312

New issue

Open

opened 2026-04-09 20:09:11 +00:00 by HAL9000 · 0 comments

HAL9000 commented

2026-04-09 20:09:11 +00:00

Owner

Summary

The spec defines agents actor context export <ACTOR> [--format ...] with no mandatory --output flag. The implementation marks --output as a required parameter (using Typer's = ... sentinel), so the command always errors if --output is not supplied. Additionally, the command argument is named <NAME> (a context name) rather than <ACTOR> (an actor name), reflecting a different data model.

Spec Reference

docs/specification.md — Actor Context Commands:

agents actor context export <ACTOR> [--format ...]

Exports the context for actor <ACTOR>
--output is not listed as a required parameter

Code Location

src/cleveragents/cli/commands/actor_context.py, lines 234–330

@app.command("export")
def context_export(
    name: Annotated[str, typer.Argument(help="Context name to export")],  # line 238
    output: Annotated[
        Path,
        typer.Option(
            "--output",
            "-o",
            help="Output file path (JSON or YAML)",
            resolve_path=True,
        ),
    ] = ...,  # line 248 — REQUIRED (ellipsis = mandatory in Typer/Pydantic)

The = ... (Ellipsis) at line 248 makes --output a required argument. Without it, Typer raises:

Error: Missing option '--output' / '-o'.

Steps to Reproduce

# Attempt spec-compliant usage (output to stdout or default location)
agents actor context export local/my-actor
# Error: Missing option '--output' / '-o'.

# Required invocation
agents actor context export local/my-actor --output /tmp/ctx.json

Expected vs Actual

	Expected	Actual
`--output` flag	Optional (may default to stdout or auto-named file)	Required — command fails without it
When omitted	Exports to stdout or a default filename	Hard error

Impact

Users following the spec cannot export actor contexts without supplying --output. The spec defines a simpler interface; the implementation adds a mandatory flag that breaks spec conformance.

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

## Summary The spec defines `agents actor context export <ACTOR> [--format ...]` with no mandatory `--output` flag. The implementation marks `--output` as a required parameter (using Typer's `= ...` sentinel), so the command always errors if `--output` is not supplied. Additionally, the command argument is named `<NAME>` (a context name) rather than `<ACTOR>` (an actor name), reflecting a different data model. ## Spec Reference `docs/specification.md` — Actor Context Commands: ``` agents actor context export <ACTOR> [--format ...] ``` - Exports the context for actor `<ACTOR>` - `--output` is **not** listed as a required parameter ## Code Location `src/cleveragents/cli/commands/actor_context.py`, lines 234–330 ```python @app.command("export") def context_export( name: Annotated[str, typer.Argument(help="Context name to export")], # line 238 output: Annotated[ Path, typer.Option( "--output", "-o", help="Output file path (JSON or YAML)", resolve_path=True, ), ] = ..., # line 248 — REQUIRED (ellipsis = mandatory in Typer/Pydantic) ``` The `= ...` (Ellipsis) at line 248 makes `--output` a required argument. Without it, Typer raises: ``` Error: Missing option '--output' / '-o'. ``` ## Steps to Reproduce ```bash # Attempt spec-compliant usage (output to stdout or default location) agents actor context export local/my-actor # Error: Missing option '--output' / '-o'. # Required invocation agents actor context export local/my-actor --output /tmp/ctx.json ``` ## Expected vs Actual | | Expected | Actual | |---|---|---| | `--output` flag | Optional (may default to stdout or auto-named file) | **Required** — command fails without it | | When omitted | Exports to stdout or a default filename | Hard error | ## Impact Users following the spec cannot export actor contexts without supplying `--output`. The spec defines a simpler interface; the implementation adds a mandatory flag that breaks spec conformance. --- **Automated by CleverAgents Bot** Supervisor: UAT Testing | Agent: uat-tester

HAL9000 referenced this issue

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

[AUTO-UAT-POOL] UAT Testing Report (Cycle 3) #6294

HAL9000 added the

labels

2026-04-09 20:19:10 +00:00