← Error codes catalogue · All exit codes

Exit code 1: Generic error

An unexpected error not covered by a specific code. Raised by PrivaCIError, MaskingError, and StateError by default.

Common causes

• A bug in the engine or a plugin.
• An unhandled database or network condition mid-run.
• privaci verify found at least one failing check (a masked column that did not change, passthrough drift, row-count mismatch, duplicate unique values, or an orphaned foreign key). Failing checks are printed to stderr; warnings alone do not trigger this exit.
• A when: CEL evaluation failed for a row (non-bool result, runtime error, or elapsed budget overrun). Errors omit cell values.
• ner_mask ran on a non-empty cell but SpaCy / en_core_web_sm was unavailable (normally caught earlier at validate exit 3 or preflight exit 2).

Remediation

1. Re-run with --log-level debug.
2. Capture the full Context/Cause/Remediation block.
3. For verify failures, fix the offending rule in mask-rules.yaml (see Verifying a run) and re-run the mask job.
4. File an issue with the redacted error and engine version (privaci --version).

---