UAT: agents resource type list rich output uses wrong table columns and is missing the summary panel #2052

Open
opened 2026-04-03 03:42:34 +00:00 by freemo · 0 comments
Owner

Background

During UAT testing of the agents resource type list command, the rich (default) output was found to render a table with incorrect columns and is missing the spec-required summary panel showing Built-in/Custom/User Addable counts.

The implementation in src/cleveragents/cli/commands/resource.py (lines 340–364) diverges significantly from the display contract defined in docs/specification.md (lines 10115–10153).

Current Behavior

Running agents resource type list renders a table with the following columns:

  • Name, Kind, Sandbox, Inherits, Built-in, User-addable, Description

No summary panel is shown. The column names and content differ significantly from the spec:

  • Source (built-in/custom) → missing entirely
  • Phys/Virt → shown as Kind with raw enum value
  • Addable → shown as User-addable with yes/no
  • Auto-children → missing entirely
  • Sandbox → extra column not in spec
  • Inherits → extra column not in spec (though useful, not spec-required in list view)
  • Description → extra column not in spec

Additionally, the _resource_type_dict() helper (lines 120–148) does not include source (built-in/custom string), physical_virtual (as the spec uses this key), or auto_children fields in its output, meaning the JSON/YAML/plain output formats are also affected.

Steps to Reproduce:

  1. Run agents resource type list
  2. Observe: table shows Name, Kind, Sandbox, Inherits, Built-in, User-addable, Description columns
  3. Expected: table shows Name, Source, Phys/Virt, Addable, Auto-children columns plus a summary panel

Code Location: src/cleveragents/cli/commands/resource.py, lines 340–364 (type_list function's rich rendering block) and lines 120–148 (_resource_type_dict() helper).

Expected Behavior

Per docs/specification.md lines 10115–10153, the rich output for agents resource type list must show:

Table columns: Name, Source (built-in/custom), Phys/Virt (physical/virtual), Addable (yes/no), Auto-children (comma-separated list of auto-discovered child types)

Summary panel following the table:

╭─ Summary ─────────────────╮
│ Built-in: 24              │
│ Custom: 1                 │
│ User Addable: 4           │
╰───────────────────────────╯
✓ OK 25 resource types listed

The _resource_type_dict() helper must also be updated to include source, physical_virtual, and auto_children fields so that JSON/YAML/plain output formats are spec-compliant.

Metadata

  • Branch: fix/resource-type-list-rich-output-columns
  • Commit Message: fix(cli): correct resource type list table columns and add summary panel
  • Milestone: v3.7.0
  • Parent Epic: #398

Subtasks

  • Update _resource_type_dict() helper (lines 120–148) to include source, physical_virtual, and auto_children fields per spec JSON schema
  • Rewrite the rich table rendering block in type_list (lines 340–364) to use columns: Name, Source, Phys/Virt, Addable, Auto-children
  • Add the summary panel (Built-in: N, Custom: N, User Addable: N) after the table in rich output
  • Add the footer line ✓ OK N resource types listed in rich output
  • Update/add Behave scenarios covering the corrected rich output columns and summary panel
  • Update/add Behave scenarios covering the corrected JSON/YAML/plain output fields
  • Verify coverage >= 97% via nox -s coverage_report
  • Run nox (all default sessions), fix any errors

Definition of Done

This issue is complete when:

  • All subtasks above are completed and checked off.
  • A Git commit is created where the first line of the commit message matches the Commit Message in Metadata exactly (fix(cli): correct resource type list table columns and add summary panel), followed by a blank line, then additional lines providing relevant details about the implementation.
  • The commit is pushed to the remote on the branch matching the Branch in Metadata exactly (fix/resource-type-list-rich-output-columns).
  • The commit is submitted as a pull request to master, reviewed, and merged before this issue is marked done.
  • All nox stages pass.
  • Coverage >= 97%.

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

## Background During UAT testing of the `agents resource type list` command, the rich (default) output was found to render a table with incorrect columns and is missing the spec-required summary panel showing Built-in/Custom/User Addable counts. The implementation in `src/cleveragents/cli/commands/resource.py` (lines 340–364) diverges significantly from the display contract defined in `docs/specification.md` (lines 10115–10153). ## Current Behavior Running `agents resource type list` renders a table with the following columns: - **Name**, **Kind**, **Sandbox**, **Inherits**, **Built-in**, **User-addable**, **Description** No summary panel is shown. The column names and content differ significantly from the spec: - `Source` (built-in/custom) → missing entirely - `Phys/Virt` → shown as `Kind` with raw enum value - `Addable` → shown as `User-addable` with yes/no - `Auto-children` → missing entirely - `Sandbox` → extra column not in spec - `Inherits` → extra column not in spec (though useful, not spec-required in list view) - `Description` → extra column not in spec Additionally, the `_resource_type_dict()` helper (lines 120–148) does not include `source` (built-in/custom string), `physical_virtual` (as the spec uses this key), or `auto_children` fields in its output, meaning the JSON/YAML/plain output formats are also affected. **Steps to Reproduce:** 1. Run `agents resource type list` 2. Observe: table shows Name, Kind, Sandbox, Inherits, Built-in, User-addable, Description columns 3. Expected: table shows Name, Source, Phys/Virt, Addable, Auto-children columns plus a summary panel **Code Location:** `src/cleveragents/cli/commands/resource.py`, lines 340–364 (`type_list` function's rich rendering block) and lines 120–148 (`_resource_type_dict()` helper). ## Expected Behavior Per `docs/specification.md` lines 10115–10153, the rich output for `agents resource type list` must show: **Table columns:** Name, Source (built-in/custom), Phys/Virt (physical/virtual), Addable (yes/no), Auto-children (comma-separated list of auto-discovered child types) **Summary panel** following the table: ``` ╭─ Summary ─────────────────╮ │ Built-in: 24 │ │ Custom: 1 │ │ User Addable: 4 │ ╰───────────────────────────╯ ✓ OK 25 resource types listed ``` The `_resource_type_dict()` helper must also be updated to include `source`, `physical_virtual`, and `auto_children` fields so that JSON/YAML/plain output formats are spec-compliant. ## Metadata - **Branch**: `fix/resource-type-list-rich-output-columns` - **Commit Message**: `fix(cli): correct resource type list table columns and add summary panel` - **Milestone**: v3.7.0 - **Parent Epic**: #398 ## Subtasks - [ ] Update `_resource_type_dict()` helper (lines 120–148) to include `source`, `physical_virtual`, and `auto_children` fields per spec JSON schema - [ ] Rewrite the rich table rendering block in `type_list` (lines 340–364) to use columns: Name, Source, Phys/Virt, Addable, Auto-children - [ ] Add the summary panel (Built-in: N, Custom: N, User Addable: N) after the table in rich output - [ ] Add the footer line `✓ OK N resource types listed` in rich output - [ ] Update/add Behave scenarios covering the corrected rich output columns and summary panel - [ ] Update/add Behave scenarios covering the corrected JSON/YAML/plain output fields - [ ] Verify coverage >= 97% via `nox -s coverage_report` - [ ] Run `nox` (all default sessions), fix any errors ## Definition of Done This issue is complete when: - All subtasks above are completed and checked off. - A Git commit is created where the **first line** of the commit message matches the Commit Message in Metadata exactly (`fix(cli): correct resource type list table columns and add summary panel`), followed by a blank line, then additional lines providing relevant details about the implementation. - The commit is pushed to the remote on the branch matching the **Branch** in Metadata exactly (`fix/resource-type-list-rich-output-columns`). - The commit is submitted as a **pull request** to `master`, reviewed, and **merged** before this issue is marked done. - All nox stages pass. - Coverage >= 97%. --- **Automated by CleverAgents Bot** Supervisor: UAT Testing | Agent: ca-new-issue-creator
freemo added this to the v3.7.0 milestone 2026-04-03 03:42:39 +00:00
freemo self-assigned this 2026-04-03 16:58:13 +00:00
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Blocks
#398 Epic: Post-MVP Resources
cleveragents/cleveragents-core
Reference
cleveragents/cleveragents-core#2052
No description provided.