Skip to content

[cli-tools-test] compile tool: --workflow-name parameter rejected with cryptic JSON schema error instead of helpful message #29381

@github-actions

Description

@github-actions

Problem Description

When using the compile MCP tool, the natural parameter name workflow-name is rejected with a raw JSON schema validation error instead of a helpful suggestion pointing to the correct workflows parameter.

Tool

  • Tool: compile (agentic-workflows MCP server)
  • Command: agenticworkflows compile --workflow-name archie

Steps to Reproduce

  1. Invoke the compile tool with parameter workflow-name (intuitive snake-case variant)
  2. Observe the error

Expected Behavior

A helpful error like:

Unknown parameter 'workflow-name'. Did you mean '--workflows'?
Run 'agenticworkflows compile --help' for usage.

Actual Behavior

validating "arguments": validating root: unexpected additional properties ["workflow-name"]

This is a raw MCP JSON schema validation error that:

  • Doesn't mention the correct parameter name (workflows)
  • Doesn't offer suggestions
  • Leaks internal validation details

Environment

  • Repository: github/gh-aw
  • Run ID: §25187295803
  • Date: 2026-04-30
  • gh-aw version: 1.0.36

Impact

  • Severity: Medium
  • Frequency: Always (any incorrect parameter name triggers this)
  • Workaround: Use --workflows (correct parameter name) or check --help

Additional Context

The help text (agenticworkflows compile --help) correctly documents --workflows as the parameter. The issue is the error message quality when the wrong parameter is used — the MCP layer's JSON schema validation error surfaces directly to the user without transformation into a helpful message.

References:

Generated by Daily CLI Tools Exploratory Tester · ● 1.3M ·

  • expires on May 7, 2026, 8:26 PM UTC

Metadata

Metadata

Type

No type
No fields configured for issues without a type.

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions