UAT: `agents actor context show` shows file content instead of spec-required context summary (Context/Files/Total Size/Estimated Tokens/Created); takes optional `[PATH]` instead of required `<NAME>` #6548

New issue

Open

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

HAL9000 commented

2026-04-09 21:17:34 +00:00

Owner

Summary

The spec defines agents actor context show <NAME> to show a summary of a named context (Context Summary panel with Context/Files/Total Size/Estimated Tokens/Created). The current implementation (from context.py) takes an optional [PATH] and shows the content of context files. The semantics are completely different.

Spec Reference

docs/specification.md line 285:

agents actor context show <NAME>

docs/specification.md lines 5978–6061:

agents actor context show <NAME>

Purpose: Show content of a file in an actor context.

Arguments:
- <NAME>: Context name (positional argument).

Rich output:
╭─ Context Summary ───────────╮
│ Context: docs               │
│ Files: 3                    │
│ Total Size: 26.5 KB         │
│ Estimated Tokens: ~6,600    │
│ Created: 2026-02-08 12:10   │
╰─────────────────────────────╯
✓ OK Context displayed

JSON output:

{
  "data": {
    "context_summary": {
      "context": "docs",
      "files": 3,
      "total_size_kb": 26.5,
      "estimated_tokens": 6600,
      "created": "2026-02-08T12:10:00Z"
    }
  }
}

Code Location

src/cleveragents/cli/commands/context.py, lines 486–565 (context_show):

@app.command("show")
def context_show(
    path: Annotated[
        str | None,
        typer.Argument(help="Specific file to show (shows all if not specified)"),
    ] = None,
) -> None:
    """Display the content of context files."""
    # Shows file content, not context summary
    # Takes optional PATH, not required NAME
    # No --format option

Steps to Reproduce

agents actor context show --help
# Shows: [PATH] optional argument
# Missing: required <NAME> argument, --format option

# Spec-compliant invocation
agents actor context show docs
# Actual: Tries to show content of a file named "docs" in current plan context
# Expected: Shows summary of named context "docs" (files count, size, tokens, created date)

Expected vs Actual

	Expected	Actual
Signature	`show <NAME>` (required)	`show [PATH]` (optional)
`<NAME>`	Named context identifier	File path in current plan context
Output	Context Summary panel (files, size, tokens, created)	File content display
`--format`	Supported (json/yaml/plain)	Missing

Impact

Users cannot get a summary of a named context. The command shows file content instead of context metadata. The --format option is missing so no machine-readable output is available.

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

## Summary The spec defines `agents actor context show <NAME>` to show a summary of a named context (Context Summary panel with Context/Files/Total Size/Estimated Tokens/Created). The current implementation (from `context.py`) takes an optional `[PATH]` and shows the content of context files. The semantics are completely different. ## Spec Reference `docs/specification.md` line 285: ``` agents actor context show <NAME> ``` `docs/specification.md` lines 5978–6061: ``` agents actor context show <NAME> Purpose: Show content of a file in an actor context. Arguments: - <NAME>: Context name (positional argument). Rich output: ╭─ Context Summary ───────────╮ │ Context: docs │ │ Files: 3 │ │ Total Size: 26.5 KB │ │ Estimated Tokens: ~6,600 │ │ Created: 2026-02-08 12:10 │ ╰─────────────────────────────╯ ✓ OK Context displayed ``` JSON output: ```json { "data": { "context_summary": { "context": "docs", "files": 3, "total_size_kb": 26.5, "estimated_tokens": 6600, "created": "2026-02-08T12:10:00Z" } } } ``` ## Code Location `src/cleveragents/cli/commands/context.py`, lines 486–565 (`context_show`): ```python @app.command("show") def context_show( path: Annotated[ str | None, typer.Argument(help="Specific file to show (shows all if not specified)"), ] = None, ) -> None: """Display the content of context files.""" # Shows file content, not context summary # Takes optional PATH, not required NAME # No --format option ``` ## Steps to Reproduce ```bash agents actor context show --help # Shows: [PATH] optional argument # Missing: required <NAME> argument, --format option # Spec-compliant invocation agents actor context show docs # Actual: Tries to show content of a file named "docs" in current plan context # Expected: Shows summary of named context "docs" (files count, size, tokens, created date) ``` ## Expected vs Actual | | Expected | Actual | |---|---|---| | Signature | `show <NAME>` (required) | `show [PATH]` (optional) | | `<NAME>` | Named context identifier | File path in current plan context | | Output | Context Summary panel (files, size, tokens, created) | File content display | | `--format` | Supported (json/yaml/plain) | Missing | ## Impact Users cannot get a summary of a named context. The command shows file content instead of context metadata. The `--format` option is missing so no machine-readable output is available. --- **Automated by CleverAgents Bot** Supervisor: UAT Testing | Agent: uat-tester

HAL9000 added the

labels

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

HAL9000 added this to the v3.2.0 milestone

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

HAL9000 referenced this issue