cleveragents/cleveragents-core

Fork 3

UAT: `agents actor show` missing Options, Graph Structure, Access, Usage panels and Built-in field #3489

New issue

Open

opened 2026-04-05 18:36:17 +00:00 by freemo · 1 comment

freemo commented

2026-04-05 18:36:17 +00:00

Owner

Metadata

Branch: fix/actor-show-missing-panels
Commit Message: fix(cli): add missing panels and fields to agents actor show command
Milestone: (Backlog — no milestone assigned)
Parent Epic: #392

Backlog note: This issue was discovered during autonomous operation
on milestone v3.2.0. It does not block milestone completion and has been
placed in the backlog for human review and future milestone assignment.

Background and Context

The spec defines that agents actor show <NAME> should display a comprehensive set of panels:

╭─ Actor Details ────────────────────╮
│ Name: local/reviewer               │
│ Provider: openai                   │
│ Model: gpt-4                       │
│ Default: yes                       │
│ Built-in: no                       │    ← MISSING
│ Unsafe: no                         │
│ Type: graph                        │
│ Created: 2026-02-08 12:35          │    ← MISSING
│ Updated: 2026-02-08 12:40          │    ← MISSING
│ Config: ./actors/reviewer.yaml     │    ← MISSING
│ Config Hash: 9c4e2a1               │    ← MISSING
╰────────────────────────────────────╯

╭─ Options ──────────╮               ← ENTIRE PANEL MISSING
│ - temperature: 0.2 │
│ - max_tokens: 2048 │
│ - top_p: 1.0       │
╰────────────────────╯

╭─ Graph Structure ─╮                ← ENTIRE PANEL MISSING
│ Nodes: 3          │
│ Edges: 4          │
│ Entry: analyze    │
│ Exit: report      │
╰───────────────────╯

╭─ Tools ────────────────────────╮   ← ENTIRE PANEL MISSING
│ Tool          Read-Only  Safe  │
│ read_file     yes        yes   │
│ search_files  yes        yes   │
│ git_diff      yes        yes   │
╰────────────────────────────────╯

╭─ Access ────────────╮              ← ENTIRE PANEL MISSING
│ Unsafe: no          │
│ Filesystem: allowed │
│ Network: restricted │
╰─────────────────────╯

╭─ Usage ─────────────────────────────────────────╮  ← ENTIRE PANEL MISSING
│ Referenced by Actions: 1 (local/code-coverage)  │
│ Active in Sessions: 0                           │
│ Total Runs: 14                                  │
│ Avg Cost/Run: $0.0032                           │
╰─────────────────────────────────────────────────╯

✓ OK Actor loaded

Problem

The show command in src/cleveragents/cli/commands/actor.py calls _print_actor(actor, title="Actor details", fmt=fmt) without show_add_panels=True. The _print_actor() function only shows the basic panel (Name, Provider, Model, Default, Unsafe, Type) when show_add_panels=False.

Missing from the show output:

Built-in field in the Actor Details panel
Created timestamp in the Actor Details panel
Updated timestamp in the Actor Details panel
Config path in the Actor Details panel
Config Hash in the Actor Details panel
Options panel (showing actor options like temperature, max_tokens)
Graph Structure panel (Nodes, Edges, Entry, Exit)
Tools panel (tool list with Read-Only and Safe columns)
Access panel (Unsafe, Filesystem, Network)
Usage panel (Referenced by Actions, Active in Sessions, Total Runs, Avg Cost/Run)
Success line: ✓ OK Actor loaded

Steps to Reproduce

Register an actor: agents actor add --config ./actors/my-actor.yaml
Run: agents actor show local/my-actor
Expected: Full output with all panels listed above
Actual: Only basic panel with Name, Provider, Model, Default, Unsafe, Type

Code Location

src/cleveragents/cli/commands/actor.py, show() function and _print_actor() function
The _print_actor() function needs a separate code path for the show command that renders all the spec-required panels

Expected Behavior (from spec)

Full actor details with all panels, ending with ✓ OK Actor loaded.

Subtasks

Add Built-in, Created, Updated, Config, and Config Hash fields to the Actor Details panel in _print_actor()
Implement the Options panel rendering (temperature, max_tokens, top_p, etc.)
Implement the Graph Structure panel rendering (Nodes, Edges, Entry, Exit) for type: graph actors
Implement the Tools panel rendering (tool list with Read-Only and Safe columns)
Implement the Access panel rendering (Unsafe, Filesystem, Network)
Implement the Usage panel rendering (Referenced by Actions, Active in Sessions, Total Runs, Avg Cost/Run)
Add ✓ OK Actor loaded success line at the end of show output
Update show() to invoke _print_actor() with show_add_panels=True (or equivalent)
Write Behave unit tests covering each new panel and field
Write Robot Framework integration test for agents actor show full output
Verify all nox stages pass

Definition of Done

All subtasks above are checked
agents actor show <NAME> renders all panels and fields as specified in docs/specification.md
Behave unit tests cover all new rendering paths
Robot Framework integration test validates full show output
All nox stages pass
Coverage >= 97%
Commit pushed to fix/actor-show-missing-panels with message fix(cli): add missing panels and fields to agents actor show command
PR merged and this issue closed

Automated by CleverAgents Bot
Supervisor: UAT Testing | Agent: ca-new-issue-creator

## Metadata - **Branch**: `fix/actor-show-missing-panels` - **Commit Message**: `fix(cli): add missing panels and fields to agents actor show command` - **Milestone**: *(Backlog — no milestone assigned)* - **Parent Epic**: #392 > **Backlog note:** This issue was discovered during autonomous operation > on milestone v3.2.0. It does not block milestone completion and has been > placed in the backlog for human review and future milestone assignment. ## Background and Context The spec defines that `agents actor show <NAME>` should display a comprehensive set of panels: ``` ╭─ Actor Details ────────────────────╮ │ Name: local/reviewer │ │ Provider: openai │ │ Model: gpt-4 │ │ Default: yes │ │ Built-in: no │ ← MISSING │ Unsafe: no │ │ Type: graph │ │ Created: 2026-02-08 12:35 │ ← MISSING │ Updated: 2026-02-08 12:40 │ ← MISSING │ Config: ./actors/reviewer.yaml │ ← MISSING │ Config Hash: 9c4e2a1 │ ← MISSING ╰────────────────────────────────────╯ ╭─ Options ──────────╮ ← ENTIRE PANEL MISSING │ - temperature: 0.2 │ │ - max_tokens: 2048 │ │ - top_p: 1.0 │ ╰────────────────────╯ ╭─ Graph Structure ─╮ ← ENTIRE PANEL MISSING │ Nodes: 3 │ │ Edges: 4 │ │ Entry: analyze │ │ Exit: report │ ╰───────────────────╯ ╭─ Tools ────────────────────────╮ ← ENTIRE PANEL MISSING │ Tool Read-Only Safe │ │ read_file yes yes │ │ search_files yes yes │ │ git_diff yes yes │ ╰────────────────────────────────╯ ╭─ Access ────────────╮ ← ENTIRE PANEL MISSING │ Unsafe: no │ │ Filesystem: allowed │ │ Network: restricted │ ╰─────────────────────╯ ╭─ Usage ─────────────────────────────────────────╮ ← ENTIRE PANEL MISSING │ Referenced by Actions: 1 (local/code-coverage) │ │ Active in Sessions: 0 │ │ Total Runs: 14 │ │ Avg Cost/Run: $0.0032 │ ╰─────────────────────────────────────────────────╯ ✓ OK Actor loaded ``` ## Problem The `show` command in `src/cleveragents/cli/commands/actor.py` calls `_print_actor(actor, title="Actor details", fmt=fmt)` without `show_add_panels=True`. The `_print_actor()` function only shows the basic panel (Name, Provider, Model, Default, Unsafe, Type) when `show_add_panels=False`. Missing from the `show` output: 1. **Built-in** field in the Actor Details panel 2. **Created** timestamp in the Actor Details panel 3. **Updated** timestamp in the Actor Details panel 4. **Config** path in the Actor Details panel 5. **Config Hash** in the Actor Details panel 6. **Options** panel (showing actor options like temperature, max_tokens) 7. **Graph Structure** panel (Nodes, Edges, Entry, Exit) 8. **Tools** panel (tool list with Read-Only and Safe columns) 9. **Access** panel (Unsafe, Filesystem, Network) 10. **Usage** panel (Referenced by Actions, Active in Sessions, Total Runs, Avg Cost/Run) 11. Success line: `✓ OK Actor loaded` ## Steps to Reproduce 1. Register an actor: `agents actor add --config ./actors/my-actor.yaml` 2. Run: `agents actor show local/my-actor` 3. **Expected**: Full output with all panels listed above 4. **Actual**: Only basic panel with Name, Provider, Model, Default, Unsafe, Type ## Code Location - `src/cleveragents/cli/commands/actor.py`, `show()` function and `_print_actor()` function - The `_print_actor()` function needs a separate code path for the `show` command that renders all the spec-required panels ## Expected Behavior (from spec) Full actor details with all panels, ending with `✓ OK Actor loaded`. ## Subtasks - [ ] Add `Built-in`, `Created`, `Updated`, `Config`, and `Config Hash` fields to the Actor Details panel in `_print_actor()` - [ ] Implement the **Options** panel rendering (temperature, max_tokens, top_p, etc.) - [ ] Implement the **Graph Structure** panel rendering (Nodes, Edges, Entry, Exit) for `type: graph` actors - [ ] Implement the **Tools** panel rendering (tool list with Read-Only and Safe columns) - [ ] Implement the **Access** panel rendering (Unsafe, Filesystem, Network) - [ ] Implement the **Usage** panel rendering (Referenced by Actions, Active in Sessions, Total Runs, Avg Cost/Run) - [ ] Add `✓ OK Actor loaded` success line at the end of `show` output - [ ] Update `show()` to invoke `_print_actor()` with `show_add_panels=True` (or equivalent) - [ ] Write Behave unit tests covering each new panel and field - [ ] Write Robot Framework integration test for `agents actor show` full output - [ ] Verify all nox stages pass ## Definition of Done - [ ] All subtasks above are checked - [ ] `agents actor show <NAME>` renders all panels and fields as specified in `docs/specification.md` - [ ] Behave unit tests cover all new rendering paths - [ ] Robot Framework integration test validates full `show` output - [ ] All nox stages pass - [ ] Coverage >= 97% - [ ] Commit pushed to `fix/actor-show-missing-panels` with message `fix(cli): add missing panels and fields to agents actor show command` - [ ] PR merged and this issue closed --- **Automated by CleverAgents Bot** Supervisor: UAT Testing | Agent: ca-new-issue-creator

freemo added a new dependency

2026-04-05 18:36:27 +00:00

#392 Epic: Actor YAML & Compiler

freemo referenced this issue

2026-04-05 18:51:50 +00:00

[Automated] CleverAgents Build Session - 2026-04-05 #3377

freemo referenced this issue

2026-04-05 18:52:57 +00:00

[Automated] CleverAgents Build Session - 2026-04-05 #3377

freemo referenced this issue

2026-04-05 19:05:02 +00:00

[Automated] CleverAgents Build Session - 2026-04-05 #3377

freemo added this to the v3.7.0 milestone

2026-04-05 20:36:15 +00:00

freemo commented

2026-04-06 06:22:53 +00:00

Author

Owner

Duplicate Detection — UAT Re-Discovery

This issue was independently re-discovered during a UAT testing pass on 2026-04-06 and submitted for tracking. No new issue was created because this issue already captures the same defect.

Additional Context from Re-Discovery

The UAT tester's report adds the following supplementary details not present in the original issue body:

Confirmed code location:

src/cleveragents/cli/commands/actor.py — _print_actor() function

The show_add_panels=False default causes early return after the basic panel:

def _print_actor(actor, title, fmt, config_path, show_add_panels=False):
    ...
    console.print(Panel(details, title=title, expand=False))
    if not show_add_panels:
        return  # <-- Returns here for 'show' command, skipping all other panels

Even the add command's panels (Config, Capabilities, Tools) differ from what show requires (Options, Graph Structure, Access, Usage), so a simple flag flip is insufficient — separate rendering logic is needed.

Impact assessment (from re-discovery):

Operators cannot audit actor configurations effectively via show
Users cannot see actor options, graph structure, access controls, or usage statistics
The show command is significantly less informative than the spec requires (lines 5551–5602)

Steps to Reproduce (confirmed):

Register an actor: agents actor add local/reviewer --config ./reviewer.yaml
Run: agents actor show local/reviewer
Observe: Only a single basic panel is shown — Options, Graph Structure, Access, and Usage panels are absent

No action required — this comment is for traceability only.

Automated by CleverAgents Bot
Supervisor: UAT Testing | Agent: ca-new-issue-creator

## Duplicate Detection — UAT Re-Discovery This issue was independently re-discovered during a UAT testing pass on **2026-04-06** and submitted for tracking. No new issue was created because this issue already captures the same defect. ### Additional Context from Re-Discovery The UAT tester's report adds the following supplementary details not present in the original issue body: **Confirmed code location:** - `src/cleveragents/cli/commands/actor.py` — `_print_actor()` function - The `show_add_panels=False` default causes early return after the basic panel: ```python def _print_actor(actor, title, fmt, config_path, show_add_panels=False): ... console.print(Panel(details, title=title, expand=False)) if not show_add_panels: return # <-- Returns here for 'show' command, skipping all other panels ``` - Even the `add` command's panels (Config, Capabilities, Tools) differ from what `show` requires (Options, Graph Structure, Access, Usage), so a simple flag flip is insufficient — separate rendering logic is needed. **Impact assessment (from re-discovery):** - Operators cannot audit actor configurations effectively via `show` - Users cannot see actor options, graph structure, access controls, or usage statistics - The `show` command is significantly less informative than the spec requires (lines 5551–5602) **Steps to Reproduce (confirmed):** 1. Register an actor: `agents actor add local/reviewer --config ./reviewer.yaml` 2. Run: `agents actor show local/reviewer` 3. Observe: Only a single basic panel is shown — Options, Graph Structure, Access, and Usage panels are absent No action required — this comment is for traceability only. --- **Automated by CleverAgents Bot** Supervisor: UAT Testing | Agent: ca-new-issue-creator

freemo referenced this issue

2026-04-06 06:44:13 +00:00

[Automated] CleverAgents Build Session - 2026-04-06 #3775