VFX-E-1005¶

Title¶

EventsFileUnreadable

Explanation¶

The run events file exists but could not be read — the same class of causes as VFX-E-1003 (SuiteFileUnreadable), applied to a run's events file instead of a suite file: permissions, a file lock, or an over-long path. Always reported as retryable: false, for the same "cannot tell the causes apart" reasoning as VFX-E-1003.

Common causes¶

• File permissions deny read access to the account running vouchfx-mcp.
• Another process holds a lock on the events file — for example, run_suite itself still writing to it if called while a run is genuinely still in flight.
• The full path exceeds the operating system's maximum path length.

Fixes¶

• Check the file's permissions and grant read access to the server's process account.
• Wait for any in-flight run to finish writing before reading its events file.
• Shorten the path, or move the events file closer to the filesystem root, if an over-long path is the cause.