cleveragents/cleveragents-core

Fork 3

`agents action show` missing spec-required usage hint and plan history section #9745

New issue

Open

opened 2026-04-15 08:33:14 +00:00 by hurui200320 · 4 comments

hurui200320 commented

2026-04-15 08:33:14 +00:00

Member

Metadata

Commit Message: fix(cli): add usage hint and plan history panels to agents action show output
Branch: fix/action-show-usage-hint-plan-history

Background

The spec defines agents action show output as including, beyond the basic Action Details panel, a usage hint (showing the suggested agents plan use invocation) and a plan history section (showing how many plans have been created from this action and when it was last used).

Currently agents action show outputs only the same "Action Details" panel as agents action create — making the two commands produce identical output. There is no next-steps guidance and no usage statistics, reducing the command's utility to a simple echo of the creation output.

Current Behavior

agents action show local/build-rune-encoder

Actual output:

╭─────────────────────────────── Action Details ───────────────────────────────╮
│ Namespaced Name: local/build-rune-encoder                                    │
│ Short Name: build-rune-encoder                                               │
│ Description: Build an Elder Futhark rune encoder/decoder in Kotlin with      │
│ GraalVM native image                                                         │
│ State: available                                                             │
│ Strategy Actor: anthropic/claude-sonnet-4-5                                  │
│ Execution Actor: anthropic/claude-sonnet-4-5                                 │
│ Reusable: yes                                                                │
│ Read Only: no                                                                │
│ Definition of Done: ...                                                      │
│ Created: 2026-04-15 07:49:00                                                 │
╰──────────────────────────────────────────────────────────────────────────────╯

This is identical to the output of agents action create. No usage hint, no plan history.

Expected Behavior

Per the spec, agents action show should additionally render:

1. A Next Steps / Usage hint panel with the correct agents plan use invocation pre-filled:

Next Steps
  agents plan use local/build-rune-encoder <PROJECT_NAME> [--automation-profile <PROFILE>]

2. A History panel showing the number of plans instantiated from this action:

History
  Plans Created: 0
  Last Used: never

Acceptance Criteria

agents action show output includes a usage/next-steps hint containing the correct agents plan use invocation with the action name pre-filled
agents action show output includes a plan history section showing the total number of plans created from this action
The plan count is accurate (matches live database records)
agents action list also displays a Plans count column (this column is absent in the current list output — a related gap found in the same test pass)
The command continues to return exit code 0
No regression on agents action create output (these are separate commands)

Supporting Information

Discovered during test plan rune-actor.md, Call 29 (2026-04-15)
No existing issues found covering this specific gap after exhaustive search of the issue tracker
Related gap found at the same time: agents action list missing a Plans count column (Call 28 in the same test plan)

Subtasks

Locate the action show command handler in src/cleveragents/cli/commands/action.py
Add a database query to count plans associated with this action and retrieve the last-used timestamp
Render a Next Steps panel with the suggested agents plan use <action-name> <project> invocation
Render a History panel with the plan count and last-used timestamp
Add a Plans count column to the agents action list table output
Tests (Behave): scenario — action show renders usage hint with correct action name
Tests (Behave): scenario — action show renders plan history with correct count (0 initially, N after plans are created)
Tests (Behave): scenario — action list table includes Plans column
Tests (Robot): integration test for enriched action show output
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, followed by a blank line, then additional implementation details.
The commit is pushed to the remote on the branch matching the Branch in Metadata exactly.
The commit is submitted as a pull request to master, reviewed, and merged before this issue is marked done.

## Metadata - **Commit Message**: `fix(cli): add usage hint and plan history panels to agents action show output` - **Branch**: `fix/action-show-usage-hint-plan-history` --- ## Background The spec defines `agents action show` output as including, beyond the basic Action Details panel, a usage hint (showing the suggested `agents plan use` invocation) and a plan history section (showing how many plans have been created from this action and when it was last used). Currently `agents action show` outputs only the same "Action Details" panel as `agents action create` — making the two commands produce identical output. There is no next-steps guidance and no usage statistics, reducing the command's utility to a simple echo of the creation output. --- ## Current Behavior ```bash agents action show local/build-rune-encoder ``` **Actual output:** ``` ╭─────────────────────────────── Action Details ───────────────────────────────╮ │ Namespaced Name: local/build-rune-encoder │ │ Short Name: build-rune-encoder │ │ Description: Build an Elder Futhark rune encoder/decoder in Kotlin with │ │ GraalVM native image │ │ State: available │ │ Strategy Actor: anthropic/claude-sonnet-4-5 │ │ Execution Actor: anthropic/claude-sonnet-4-5 │ │ Reusable: yes │ │ Read Only: no │ │ Definition of Done: ... │ │ Created: 2026-04-15 07:49:00 │ ╰──────────────────────────────────────────────────────────────────────────────╯ ``` This is **identical to the output of `agents action create`**. No usage hint, no plan history. --- ## Expected Behavior Per the spec, `agents action show` should additionally render: **1. A Next Steps / Usage hint panel** with the correct `agents plan use` invocation pre-filled: ``` Next Steps agents plan use local/build-rune-encoder <PROJECT_NAME> [--automation-profile <PROFILE>] ``` **2. A History panel** showing the number of plans instantiated from this action: ``` History Plans Created: 0 Last Used: never ``` --- ## Acceptance Criteria - [ ] `agents action show` output includes a usage/next-steps hint containing the correct `agents plan use` invocation with the action name pre-filled - [ ] `agents action show` output includes a plan history section showing the total number of plans created from this action - [ ] The plan count is accurate (matches live database records) - [ ] `agents action list` also displays a `Plans` count column (this column is absent in the current list output — a related gap found in the same test pass) - [ ] The command continues to return exit code 0 - [ ] No regression on `agents action create` output (these are separate commands) --- ## Supporting Information - Discovered during test plan `rune-actor.md`, Call 29 (2026-04-15) - No existing issues found covering this specific gap after exhaustive search of the issue tracker - Related gap found at the same time: `agents action list` missing a `Plans` count column (Call 28 in the same test plan) --- ## Subtasks - [ ] Locate the `action show` command handler in `src/cleveragents/cli/commands/action.py` - [ ] Add a database query to count plans associated with this action and retrieve the last-used timestamp - [ ] Render a Next Steps panel with the suggested `agents plan use <action-name> <project>` invocation - [ ] Render a History panel with the plan count and last-used timestamp - [ ] Add a `Plans` count column to the `agents action list` table output - [ ] Tests (Behave): scenario — `action show` renders usage hint with correct action name - [ ] Tests (Behave): scenario — `action show` renders plan history with correct count (0 initially, N after plans are created) - [ ] Tests (Behave): scenario — `action list` table includes `Plans` column - [ ] Tests (Robot): integration test for enriched `action show` output - [ ] 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, followed by a blank line, then additional implementation details. - The commit is pushed to the remote on the branch matching the **Branch** in Metadata exactly. - The commit is submitted as a **pull request** to `master`, reviewed, and **merged** before this issue is marked done.

hurui200320 added the

labels

2026-04-15 08:33:19 +00:00

HAL9000 commented

2026-04-15 08:41:07 +00:00

Owner

Thank you for this detailed bug report, @hurui200320.

The missing usage hint and plan history section in agents action show is a valid spec compliance gap. The observation that agents action show and agents action create produce identical output is a clear indicator of missing functionality.

Triage Assessment:

Priority: Medium (confirmed — usability gap, not blocking)
Type: Bug (confirmed — spec compliance issue)
Milestone: Needs assignment (likely v3.2.0 based on CLI scope)

The additional finding about agents action list missing a Plans count column is noted and included in the acceptance criteria — good catch.

Next Steps: This issue will be moved to State/Verified and assigned to a milestone by the grooming team. Implementation will follow standard workflow.

Automated by CleverAgents Bot
Supervisor: Human Liaison | Agent: human-liaison-pool-supervisor

Thank you for this detailed bug report, @hurui200320. The missing usage hint and plan history section in `agents action show` is a valid spec compliance gap. The observation that `agents action show` and `agents action create` produce identical output is a clear indicator of missing functionality. **Triage Assessment**: - Priority: Medium (confirmed — usability gap, not blocking) - Type: Bug (confirmed — spec compliance issue) - Milestone: Needs assignment (likely v3.2.0 based on CLI scope) The additional finding about `agents action list` missing a `Plans` count column is noted and included in the acceptance criteria — good catch. **Next Steps**: This issue will be moved to `State/Verified` and assigned to a milestone by the grooming team. Implementation will follow standard workflow. --- **Automated by CleverAgents Bot** Supervisor: Human Liaison | Agent: human-liaison-pool-supervisor

HAL9000 commented

2026-04-15 15:41:34 +00:00

Owner

🏷️ Triage Decision — [AUTO-OWNR-1]\n\nStatus: ✅ Verified\n\nIssue Type: Bug \nMoSCoW: Could Have — CLI output improvement, not blocking milestone \nPriority: Medium (already set)\n\nRationale: The `agents action show` command is missing spec-required usage hint and plan history panels. This is a real bug but it's a display/UX issue that doesn't block core functionality. Assigning Could Have since the core action execution works; this is a polish item.\n\nLabels to apply: State/Verified, MoSCoW/Could have, Priority/Medium, Type/Bug\n\n---\nAutomated by CleverAgents Bot\nSupervisor: Project Owner | Agent: project-owner-pool-supervisor

## 🏷️ Triage Decision — [AUTO-OWNR-1]\n\n**Status:** ✅ Verified\n\n**Issue Type:** Bug \n**MoSCoW:** Could Have — CLI output improvement, not blocking milestone \n**Priority:** Medium (already set)\n\n**Rationale:** The `agents action show` command is missing spec-required usage hint and plan history panels. This is a real bug but it's a display/UX issue that doesn't block core functionality. Assigning Could Have since the core action execution works; this is a polish item.\n\n**Labels to apply:** State/Verified, MoSCoW/Could have, Priority/Medium, Type/Bug\n\n---\n**Automated by CleverAgents Bot**\nSupervisor: Project Owner | Agent: project-owner-pool-supervisor

HAL9000 referenced this issue

2026-04-15 16:00:52 +00:00

[AUTO-OWNR] Status: Project Owner (Cycle 1) #9768

HAL9000 commented

2026-04-15 22:56:07 +00:00

Owner

[AUTO-OWNR-1] Triage complete.

Verified ✅ — Valid spec compliance bug. agents action show is missing the usage hint and plan history section required by the spec. The command currently produces identical output to agents action create, which is incorrect.

Type: Bug
Priority: Medium
MoSCoW: Should Have — spec compliance for CLI commands
Milestone: v3.2.0 — CLI command spec compliance

Automated by CleverAgents Bot
Supervisor: Project Owner | Agent: project-owner-pool-supervisor

Automated by CleverAgents Bot
Agent: automation-tracking-manager

[AUTO-OWNR-1] Triage complete. **Verified** ✅ — Valid spec compliance bug. `agents action show` is missing the usage hint and plan history section required by the spec. The command currently produces identical output to `agents action create`, which is incorrect. - **Type**: Bug - **Priority**: Medium - **MoSCoW**: Should Have — spec compliance for CLI commands - **Milestone**: v3.2.0 — CLI command spec compliance --- **Automated by CleverAgents Bot** Supervisor: Project Owner | Agent: project-owner-pool-supervisor --- **Automated by CleverAgents Bot** Agent: automation-tracking-manager

HAL9000 referenced this issue

2026-04-15 23:28:41 +00:00

[AUTO-PROJ-OWN] Status: Project Owner Supervisor (Cycle 1) #9876

HAL9000 added

and removed

labels

2026-04-16 07:44:29 +00:00

HAL9000 commented

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

Owner

Triage Decision [AUTO-OWNR]

Status: ✅ Verified

Type: Bug
Priority: High (upgraded from Medium — spec compliance is High priority)
MoSCoW: Must Have
Milestone: v3.2.0

Rationale: The agents action show command is missing spec-required elements (usage hint and plan history section). Spec compliance for v3.2.0 CLI commands is Must Have — the milestone cannot complete without all CLI commands meeting the specification. Upgraded to Priority/High for spec compliance.

Automated by CleverAgents Bot
Supervisor: Project Owner | Agent: project-owner-pool-supervisor

## Triage Decision [AUTO-OWNR] **Status**: ✅ Verified **Type**: Bug **Priority**: High (upgraded from Medium — spec compliance is High priority) **MoSCoW**: Must Have **Milestone**: v3.2.0 **Rationale**: The `agents action show` command is missing spec-required elements (usage hint and plan history section). Spec compliance for v3.2.0 CLI commands is Must Have — the milestone cannot complete without all CLI commands meeting the specification. Upgraded to Priority/High for spec compliance. --- **Automated by CleverAgents Bot** Supervisor: Project Owner | Agent: project-owner-pool-supervisor

HAL9000 added this to the v3.2.0 milestone

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