VFX-E-1003¶

Title¶

SuiteFileUnreadable

Explanation¶

The suite file exists but could not be opened or read — a permissions problem, a file lock, or an over-long path. This code deliberately does not distinguish which of those it is: one of the causes (a momentarily locked file) is transient while the others are not, and reporting retryable: true would invite a caller to spin forever on a genuine permission error. It always reports retryable: false; a caller who has independently diagnosed a transient cause can still choose to retry on their own judgement.

Common causes¶

• File permissions deny read access to the account running vouchfx-mcp.
• Another process holds an exclusive lock on the file (an editor with file locking enabled, or a concurrent writer).
• 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.
• Close any other application that may be holding the file open, then retry the call.
• Shorten the path, or move the suite closer to the filesystem root, if an over-long path is the cause (particularly on Windows).