UAT: `agents actor context export` uses positional `NAME EXPORT_FILE` instead of spec-required `(--output|-o) <FILE> <NAME>` signature; missing `--format` option #6539

New issue

Open

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

HAL9000 commented

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

Owner

Summary

The spec defines agents actor context export (--output|-o) <FILE> <NAME> where --output/-o is a required option and <NAME> is a positional argument. The current implementation (from context.py) uses two positional arguments NAME EXPORT_FILE with no --output/-o option. Additionally, the command has no --format option for machine-readable output.

Spec Reference

docs/specification.md line 286:

agents actor context export (--output|-o) <FILE> <NAME>

docs/specification.md lines 6063–6073:

agents actor context export (--output|-o) <FILE> <NAME>

Arguments:
- <NAME>: Context name (positional argument).
- --output/-o FILE: Output file path (required).

Example: agents actor context export --output /tmp/docs-context.json docs

Code Location

src/cleveragents/cli/commands/context.py, lines 567–603 (context_export):

@app.command("export")
def context_export(
    name: Annotated[str, typer.Argument(help="Name of the context to export")],
    export_file: Annotated[
        Path,
        typer.Argument(help="Path to JSON file to export to", resolve_path=True),
    ],
    context_dir: Annotated[Path | None, typer.Option("--context-dir", ...)] = None,
) -> None:
    # No --output/-o option, no --format option

The command uses two positional arguments (name, export_file) instead of one positional (name) and one required option (--output/-o).

Steps to Reproduce

agents actor context export --help
# Shows: NAME EXPORT_FILE (two positional args)
# Missing: --output/-o option, --format option

# Spec-compliant invocation
agents actor context export --output /tmp/ctx.json docs
# Error: Got unexpected extra argument (--output)

# Required invocation (implementation)
agents actor context export docs /tmp/ctx.json

Expected vs Actual

	Expected	Actual
Signature	`export (--output\|-o) <FILE> <NAME>`	`export NAME EXPORT_FILE`
`--output/-o`	Required option	Missing
`--format`	Supported	Missing
Output	JSON envelope with `context_export`/`integrity` sections	Simple `typer.echo` message

Impact

Users following the spec signature receive errors. The output is a plain text message instead of the spec-required structured JSON/YAML output with context_export and integrity sections.

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

## Summary The spec defines `agents actor context export (--output|-o) <FILE> <NAME>` where `--output/-o` is a required option and `<NAME>` is a positional argument. The current implementation (from `context.py`) uses two positional arguments `NAME EXPORT_FILE` with no `--output/-o` option. Additionally, the command has no `--format` option for machine-readable output. ## Spec Reference `docs/specification.md` line 286: ``` agents actor context export (--output|-o) <FILE> <NAME> ``` `docs/specification.md` lines 6063–6073: ``` agents actor context export (--output|-o) <FILE> <NAME> Arguments: - <NAME>: Context name (positional argument). - --output/-o FILE: Output file path (required). ``` Example: `agents actor context export --output /tmp/docs-context.json docs` ## Code Location `src/cleveragents/cli/commands/context.py`, lines 567–603 (`context_export`): ```python @app.command("export") def context_export( name: Annotated[str, typer.Argument(help="Name of the context to export")], export_file: Annotated[ Path, typer.Argument(help="Path to JSON file to export to", resolve_path=True), ], context_dir: Annotated[Path | None, typer.Option("--context-dir", ...)] = None, ) -> None: # No --output/-o option, no --format option ``` The command uses two positional arguments (`name`, `export_file`) instead of one positional (`name`) and one required option (`--output/-o`). ## Steps to Reproduce ```bash agents actor context export --help # Shows: NAME EXPORT_FILE (two positional args) # Missing: --output/-o option, --format option # Spec-compliant invocation agents actor context export --output /tmp/ctx.json docs # Error: Got unexpected extra argument (--output) # Required invocation (implementation) agents actor context export docs /tmp/ctx.json ``` ## Expected vs Actual | | Expected | Actual | |---|---|---| | Signature | `export (--output\|-o) <FILE> <NAME>` | `export NAME EXPORT_FILE` | | `--output/-o` | Required option | Missing | | `--format` | Supported | Missing | | Output | JSON envelope with `context_export`/`integrity` sections | Simple `typer.echo` message | ## Impact Users following the spec signature receive errors. The output is a plain text message instead of the spec-required structured JSON/YAML output with context_export and integrity sections. --- **Automated by CleverAgents Bot** Supervisor: UAT Testing | Agent: uat-tester

HAL9000 added the

labels

2026-04-09 21:26:43 +00:00

HAL9000 added this to the v3.2.0 milestone

2026-04-09 21:28:38 +00:00

HAL9000 referenced this issue