UAT: `agents validation list` and `agents validation show` commands are missing — spec requires both commands #2529

New issue

Open

opened 2026-04-03 18:48:35 +00:00 by freemo · 1 comment

freemo commented

2026-04-03 18:48:35 +00:00

Owner

Metadata

Branch: feat/validation-list-show-commands
Commit Message: feat(validation): add agents validation list and agents validation show commands
Milestone: v3.4.0
Parent Epic: #394

Background and Context

The specification defines the following validation CLI commands:

agents validation add --config|-c <FILE> [--update]
agents validation attach [--project <PROJECT>|--plan <PLAN_ID>] <RESOURCE> <VALIDATION> [<ARGS>...]
agents validation detach [--yes|-y] <ATTACHMENT_ID>

However, the spec also shows agents tool show <NAME> which returns validation_details for validations, and the spec's workflow examples reference listing validations. The current implementation only has add, attach, and detach commands.

Steps to Reproduce

agents validation list
# Error: No such command 'list'

agents validation show local/coverage-check
# Error: No such command 'show'

Expected Behavior (per spec)

The spec's agents tool show <NAME> command returns validation details including validation_details, input_schema, output_schema, capability, and attached_to fields. Users need a way to list registered validations and view their details.

The spec shows the following output for agents tool show local/run-tests:

{
  "data": {
    "validation_details": {
      "name": "local/run-tests",
      "type": "validation",
      "description": "Run unit tests with coverage",
      "source": "custom",
      "mode": "required",
      "config": "./validations/run-tests.yaml",
      "registered": "2026-02-09T10:15:00Z"
    },
    "attached_to": [...]
  }
}

Actual Behavior

The agents validation command group only has three subcommands:

Commands:
  add     Register a new validation from a YAML configuration file.
  attach  Attach a validation to a resource.
  detach  Detach a validation from a resource.

There is no list or show command. Users cannot discover registered validations or inspect their details without querying the database directly.

Code Location

src/cleveragents/cli/commands/validation.py — missing list and show commands

Impact

Users cannot list registered validations via CLI
Users cannot inspect validation details (mode, attachments, capability) via CLI
Workflow examples in the spec that reference listing validations cannot be followed

Subtasks

Add agents validation list command with optional --resource, --project, --plan filters
Add agents validation show <NAME> command showing validation details and attachments
Support --format flag (json, yaml, plain, table, rich) for both commands
Add unit tests for both commands

Definition of Done

agents validation list lists all registered validations
agents validation show local/coverage-check shows validation details including mode, capability, and attachments
Both commands support --format flag
All tests pass

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

## Metadata - **Branch**: `feat/validation-list-show-commands` - **Commit Message**: `feat(validation): add agents validation list and agents validation show commands` - **Milestone**: v3.4.0 - **Parent Epic**: #394 ## Background and Context The specification defines the following validation CLI commands: ``` agents validation add --config|-c <FILE> [--update] agents validation attach [--project <PROJECT>|--plan <PLAN_ID>] <RESOURCE> <VALIDATION> [<ARGS>...] agents validation detach [--yes|-y] <ATTACHMENT_ID> ``` However, the spec also shows `agents tool show <NAME>` which returns `validation_details` for validations, and the spec's workflow examples reference listing validations. The current implementation only has `add`, `attach`, and `detach` commands. ## Steps to Reproduce ```bash agents validation list # Error: No such command 'list' agents validation show local/coverage-check # Error: No such command 'show' ``` ## Expected Behavior (per spec) The spec's `agents tool show <NAME>` command returns validation details including `validation_details`, `input_schema`, `output_schema`, `capability`, and `attached_to` fields. Users need a way to list registered validations and view their details. The spec shows the following output for `agents tool show local/run-tests`: ```json { "data": { "validation_details": { "name": "local/run-tests", "type": "validation", "description": "Run unit tests with coverage", "source": "custom", "mode": "required", "config": "./validations/run-tests.yaml", "registered": "2026-02-09T10:15:00Z" }, "attached_to": [...] } } ``` ## Actual Behavior The `agents validation` command group only has three subcommands: ``` Commands: add Register a new validation from a YAML configuration file. attach Attach a validation to a resource. detach Detach a validation from a resource. ``` There is no `list` or `show` command. Users cannot discover registered validations or inspect their details without querying the database directly. ## Code Location - `src/cleveragents/cli/commands/validation.py` — missing `list` and `show` commands ## Impact - Users cannot list registered validations via CLI - Users cannot inspect validation details (mode, attachments, capability) via CLI - Workflow examples in the spec that reference listing validations cannot be followed ## Subtasks - [ ] Add `agents validation list` command with optional `--resource`, `--project`, `--plan` filters - [ ] Add `agents validation show <NAME>` command showing validation details and attachments - [ ] Support `--format` flag (json, yaml, plain, table, rich) for both commands - [ ] Add unit tests for both commands ## Definition of Done - `agents validation list` lists all registered validations - `agents validation show local/coverage-check` shows validation details including mode, capability, and attachments - Both commands support `--format` flag - All tests pass --- **Automated by CleverAgents Bot** Supervisor: UAT Testing | Agent: ca-uat-tester

freemo referenced this issue

2026-04-03 18:53:37 +00:00

[UAT-SUPERVISOR] Progress Report — Cycle 1581 — v3.7.0 #2558

freemo commented

2026-04-03 18:53:43 +00:00

Author

Owner

Issue triaged by project owner:

State: Verified
MoSCoW: Should Have — Spec compliance or quality improvement.

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

Issue triaged by project owner: - **State**: Verified - **MoSCoW**: Should Have — Spec compliance or quality improvement. --- **Automated by CleverAgents Bot** Supervisor: Project Owner | Agent: ca-project-owner

freemo referenced this issue

2026-04-03 18:54:29 +00:00

[CA-AUTO] UAT Pool Supervisor — v3.x — Session Tracker #2435

freemo added a new dependency

2026-04-03 19:08:46 +00:00

#2597 fix(ci): restore all CI quality gates to passing on master — no suppression, no bypasses

freemo added this to the v3.5.0 milestone

2026-04-05 05:09:42 +00:00