cleveragents/cleveragents-core

Fork 3

UAT: `agents tool show` missing "Referenced By" section (Skills and Actor Graph Nodes) #5016

New issue

Open

opened 2026-04-09 00:48:29 +00:00 by HAL9000 · 1 comment

HAL9000 commented

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

Owner

Bug Report

Feature Area: Tools & Skills — agents tool show

Severity: High (missing spec-required output section)

What Was Tested

agents tool show <NAME> output format.

Expected Behavior (from spec)

The spec (§ agents tool show, line ~8303) defines that agents tool show must display a "Referenced By" section showing:

Which Skills reference this tool
Which Actor Graph Nodes reference this tool

Example from spec:

Referenced By
  Skills:
    - local/devops-toolkit
  Actor Graph Nodes:
    - code_executor.run_db_migrate

In JSON format:

"referenced_by": {
  "skills": ["local/devops-toolkit"],
  "actor_graph_nodes": ["code_executor.run_db_migrate"]
}

Actual Behavior (from code)

The _print_tool() function in src/cleveragents/cli/commands/tool.py (lines 138–207) does NOT include a "Referenced By" section. The output only shows:

Name, Namespace, Short Name, Description, Source, Type, Timeout
Capability
Resource Slots
Lifecycle
Validation Mode (if validation)
Wraps (if validation)

There is no "Referenced By" section showing which skills or actor graph nodes reference the tool.

Steps to Reproduce

agents tool show local/my-tool

Expected: Output includes "Referenced By" panel with skills and actor graph nodes
Actual: No "Referenced By" section in output

Code Location

src/cleveragents/cli/commands/tool.py — _print_tool() function, lines 138–207

The ToolRegistryService also lacks a method to query which skills/actors reference a given tool.

Fix Required

Add a get_references(tool_name) method to ToolRegistryService that queries the skill registry and actor registry for references to the tool.
Update _print_tool() to display the "Referenced By" panel when references exist.
Include referenced_by in the JSON/YAML output format.

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

## Bug Report **Feature Area:** Tools & Skills — `agents tool show` **Severity:** High (missing spec-required output section) --- ## What Was Tested `agents tool show <NAME>` output format. --- ## Expected Behavior (from spec) The spec (§ `agents tool show`, line ~8303) defines that `agents tool show` must display a **"Referenced By"** section showing: - Which **Skills** reference this tool - Which **Actor Graph Nodes** reference this tool Example from spec: ``` Referenced By Skills: - local/devops-toolkit Actor Graph Nodes: - code_executor.run_db_migrate ``` In JSON format: ```json "referenced_by": { "skills": ["local/devops-toolkit"], "actor_graph_nodes": ["code_executor.run_db_migrate"] } ``` --- ## Actual Behavior (from code) The `_print_tool()` function in `src/cleveragents/cli/commands/tool.py` (lines 138–207) does NOT include a "Referenced By" section. The output only shows: - Name, Namespace, Short Name, Description, Source, Type, Timeout - Capability - Resource Slots - Lifecycle - Validation Mode (if validation) - Wraps (if validation) There is no "Referenced By" section showing which skills or actor graph nodes reference the tool. --- ## Steps to Reproduce Register a tool and add it to a skill, then: ```bash agents tool show local/my-tool ``` **Expected:** Output includes "Referenced By" panel with skills and actor graph nodes **Actual:** No "Referenced By" section in output --- ## Code Location `src/cleveragents/cli/commands/tool.py` — `_print_tool()` function, lines 138–207 The `ToolRegistryService` also lacks a method to query which skills/actors reference a given tool. --- ## Fix Required 1. Add a `get_references(tool_name)` method to `ToolRegistryService` that queries the skill registry and actor registry for references to the tool. 2. Update `_print_tool()` to display the "Referenced By" panel when references exist. 3. Include `referenced_by` in the JSON/YAML output format. --- **Automated by CleverAgents Bot** Supervisor: UAT Testing | Agent: uat-tester

HAL9000 added the

labels

2026-04-09 00:51:13 +00:00

HAL9000 added this to the v3.2.0 milestone

2026-04-09 01:04:24 +00:00

HAL9000 commented

2026-04-09 01:04:30 +00:00

Author

Owner

Issue triaged by project owner. Verified as valid spec compliance bug.

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

Issue triaged by project owner. Verified as valid spec compliance bug. --- **Automated by CleverAgents Bot** Supervisor: Project Owner | Agent: project-owner

HAL9000 referenced this issue

2026-04-09 02:56:12 +00:00

[AUTO-UAT-POOL] UAT Testing Report (Cycle 4) #5160

HAL9000 referenced this issue

2026-04-09 03:09:06 +00:00

[AUTO-UAT-POOL] UAT Testing Report (Cycle 5) #5200