Documentation / VFX-E-1002

VFX-E-1002

Title

SuiteFileNotFound

Explanation

The named .e2e.yaml suite file does not exist on disk at the moment validate_suite/run_suite checked. This is a plain file-existence probe, performed before any content is read — the suite's validity was never determined, because there is no suite to evaluate.

Common causes

  • A typo in the path, or a relative path resolved against a working directory other than the one you expected.
  • The suite was renamed, moved, or deleted between when it was authored and when the tool was called.
  • Referencing a suite path whose file was never actually saved to disk — for example, treating scaffold_suite's returned yaml text as if it were already a file.

Fixes

  • List the target directory to confirm the file's exact name and location before retrying.
  • Check what a relative path resolves against: the workspace root when the server was launched with --workspace, otherwise the server process's working directory — an absolute path sidesteps the question in either mode.
  • If the suite came from scaffold_suite, write its yaml output to the intended path yourself first — this server never writes suite files for you.