VFX-D-1100¶

Title¶

SuiteInvalid

Explanation¶

run_suite's pre-flight envelope: the suite failed validate_suite's own checks, so run_suite did not run it. This is a successful call (isError: false) — an invalid suite is data, not a tool failure — and this code itself carries no finding of its own; the specific findings (VFX-D-1101 through VFX-D-1105, VFX-D-1107, VFX-D-1201) travel inside the result's validation.errors array. An MCP client keying off isError never sees an invalid suite as a tool failure.

Common causes¶

• The suite has one or more JSON Schema violations (VFX-D-1101).
• The suite's YAML could not be parsed (VFX-D-1102).
• The suite file exceeds the YAML-bomb guard's size, nesting, anchor/alias, or per-line-length limits (VFX-D-1103-VFX-D-1105, VFX-D-1107).
• The suite references a step type the pinned engine does not define (VFX-D-1201).

Fixes¶

• Inspect validation.errors for the specific finding code(s) and consult that code's own catalogue page.
• Call validate_suite directly to get the same diagnosis without attempting a run.
• Re-run run_suite once validate_suite reports valid: true for the same file.