Error Handling and Diagnostics

Failure Stages

Stage	Meaning
parse	Python source could not be parsed into AST.
validate	AST validation failed (unsupported constructs).
compile	Native compilation produced errors.
link	Linking shared libraries failed.
artifact	Artifact packaging or upload failed.

Common Error Codes

Code	Resolution
UNSUPPORTED_LANGUAGE_FEATURE	Refactor to remove generators or async/await.
TYPE_MISMATCH	Add type hints or stabilise variable types.
LICENSE_INVALID	Run pyvorin licence-check.
TIMEOUT	Increase request_timeout_seconds or retry.
NETWORK_ERROR	Check connectivity; events queued locally.

Reading Compiler stderr

pyvorin job details JOB_ID

Look for the compiler_stderr field for low-level error messages.