Error codes¶
Stable error codes raised by GenoLeWM. The table is generated from
geno_lewm.errors.ERROR_CODES at docs-build time; renaming any
code is a MAJOR change per RFC-0012.
| Code | Exception class | Family | Exit code | Summary |
|---|---|---|---|---|
CONFIG.GENERIC |
ConfigError |
CONFIG | 3 | Configuration error |
CONFIG.SCHEMA_INCOMPAT |
SchemaCompatError |
CONFIG | 3 | On-disk schema MAJOR mismatch |
CONFIG.MISSING_FIELD |
MissingConfigError |
CONFIG | 3 | Required config field absent |
CONFIG.UNKNOWN_TOP_LEVEL_KEY |
UnknownTopLevelKeyError |
CONFIG | 3 | Top-level config key is not in the schema |
INPUT.GENERIC |
InputError |
INPUT | 2 | Caller-supplied input invalid |
INPUT.INVALID_EDIT |
InvalidEditError |
INPUT | 2 | EditSpec invariants violated |
INPUT.UNSUPPORTED_EDIT |
UnsupportedEditError |
INPUT | 2 | Edit type or length out of scope |
INPUT.WINDOW_MISMATCH |
WindowMismatchError |
INPUT | 2 | Window ref bases differ from EditSpec.ref |
INPUT.OVERLAPPING_EDITS |
OverlappingEditsError |
INPUT | 2 | Haplotype edits overlap |
INPUT.OUT_OF_WINDOW |
OutOfWindowError |
INPUT | 2 | rel_pos outside window |
INPUT.VCF_PARSE |
VcfParseError |
INPUT | 2 | Malformed VCF or FASTA |
RESOURCE.GENERIC |
ResourceError |
RESOURCE | 4 | Capacity, IO, or network failure |
RESOURCE.CACHE_CORRUPT |
CacheCorruptError |
RESOURCE | 4 | Cache shard failed integrity check |
RESOURCE.DISK_FULL |
DiskFullError |
RESOURCE | 4 | Storage exhausted during write |
RESOURCE.OOM |
OutOfMemoryError |
RESOURCE | 4 | CUDA or host OOM with context |
RESOURCE.MODEL_NOT_FOUND |
ModelNotFoundError |
RESOURCE | 4 | Checkpoint missing or not downloadable |
RESOURCE.RUNTIME_SETUP |
RuntimeSetupError |
RESOURCE | 4 | First-run network setup failed |
RESOURCE.NETWORK_PROHIBITED |
NetworkCallProhibitedError |
RESOURCE | 4 | Runtime fail-closed: post-setup network call attempted |
TRAINING.GENERIC |
TrainingError |
TRAINING | 5 | Training-loop failure |
TRAINING.COLLAPSE_DETECTED |
CollapseDetectedError |
TRAINING | 5 | Collapse alert tripped |
TRAINING.NAN_LOSS |
NaNLossError |
TRAINING | 5 | Loss became NaN or Inf |
TRAINING.DATALOADER |
DataLoaderError |
TRAINING | 5 | Data pipeline failure |
EVAL.GENERIC |
EvalError |
EVAL | 6 | Evaluation harness failure |
EVAL.DATASET |
EvalDatasetError |
EVAL | 6 | Benchmark dataset load failed |
EVAL.REGRESSION |
EvalRegressionError |
EVAL | 6 | Smoke-eval gate failed |
DEPLOY.GENERIC |
DeployError |
DEPLOY | 7 | Export or runtime backend failure |
DEPLOY.EXPORT_FORMAT |
ExportFormatError |
DEPLOY | 7 | ONNX/Core ML/GGUF conversion failed |
DEPLOY.QUANTIZATION_FAILED |
QuantizationError |
DEPLOY | 7 | int8/int4 calibration failed |
DEPLOY.BACKEND_UNSUPPORTED |
BackendUnsupportedError |
DEPLOY | 7 | Backend unavailable on host |
PROVENANCE.GENERIC |
ProvenanceError |
PROVENANCE | 8 | Receipt/provenance failure |
PROVENANCE.MANIFEST_HASH_MISMATCH |
ManifestHashMismatchError |
PROVENANCE | 8 | Manifest content != stated model_id |
PROVENANCE.INPUT_COMMITMENT_MISMATCH |
InputCommitmentMismatchError |
PROVENANCE | 8 | Recomputed input commitment != receipt |
PROVENANCE.OUTPUT_COMMITMENT_MISMATCH |
OutputCommitmentMismatchError |
PROVENANCE | 8 | Bit-mismatch on output re-run |
PROVENANCE.KIND_UNSUPPORTED |
ProvenanceKindUnsupportedError |
PROVENANCE | 8 | Verifier does not understand receipt provenance kind |
PROVENANCE.RECEIPT_SCHEMA |
ReceiptSchemaError |
PROVENANCE | 8 | Receipt JSON invalid |
INTERNAL.GENERIC |
InternalError |
INTERNAL | 9 | Internal error |
INTERNAL.INVARIANT_VIOLATION |
InvariantViolation |
INTERNAL | 9 | An INV-* invariant was breached |
INTERNAL.UNREACHABLE |
UnreachableError |
INTERNAL | 9 | Control reached an unreachable branch |
Exit code mapping¶
Family-level mapping applied by exit_code_for(exc). Non-GenoLeWMError
exceptions map to exit code 1; KeyboardInterrupt maps to 130.
| Family | Exit code |
|---|---|
InputError |
2 |
ConfigError |
3 |
ResourceError |
4 |
TrainingError |
5 |
EvalError |
6 |
DeployError |
7 |
ProvenanceError |
8 |
InternalError |
9 |