Struct ExitCode 

pub struct ExitCode(/* private fields */);

Exit codes matching the documented exit code table.

ExitCode provides type-safe exit code handling for xchecker operations. Use the named constants for common exit codes, or as_i32() to get the numeric value for std::process::exit().

This is a stable public type. The numeric values are part of the public API and will not change in 1.x releases.

Constants

Constant	Value	Description
SUCCESS	0	Operation completed successfully
INTERNAL	1	General/internal failure
CLI_ARGS	2	Invalid CLI arguments
PACKET_OVERFLOW	7	Packet size exceeded
SECRET_DETECTED	8	Secret found in content
LOCK_HELD	9	Lock already held
PHASE_TIMEOUT	10	Phase timed out
CLAUDE_FAILURE	70	Claude CLI failed

Example

use xchecker_utils::exit_codes::ExitCode;

// Using named constants
let code = ExitCode::SUCCESS;
assert_eq!(code.as_i32(), 0);

let code = ExitCode::PACKET_OVERFLOW;
assert_eq!(code.as_i32(), 7);

// Comparing exit codes
assert_eq!(ExitCode::SUCCESS, ExitCode::from_i32(0));

Integration with XCheckerError

Use XCheckerError::to_exit_code() to map errors to exit codes:

use xchecker_utils::error::ConfigError;
use xchecker_utils::error::XCheckerError;
use xchecker_utils::exit_codes::ExitCode;

let err = XCheckerError::Config(ConfigError::InvalidFile("test".to_string()));
assert_eq!(err.to_exit_code(), ExitCode::CLI_ARGS);

Implementations

impl ExitCode

pub const SUCCESS: ExitCode

Success - operation completed successfully

pub const CLI_ARGS: ExitCode

CLI arguments error - invalid or missing command-line arguments

pub const PACKET_OVERFLOW: ExitCode

Packet overflow - input packet exceeded size limits before Claude invocation

pub const SECRET_DETECTED: ExitCode

Secret detected - redaction system detected potential secrets

pub const LOCK_HELD: ExitCode

Lock held - another process is already working on the same spec

pub const PHASE_TIMEOUT: ExitCode

Phase timeout - phase execution exceeded configured timeout

pub const CLAUDE_FAILURE: ExitCode

Claude failure - underlying Claude CLI invocation failed

pub const INTERNAL: ExitCode

Internal error - general failure

pub const fn as_i32(self) -> i32

Get the numeric exit code value.

Use this with std::process::exit().

pub const fn from_i32(code: i32) -> Self

Create an ExitCode from a raw i32 value.

Prefer using the named constants when possible.

Trait Implementations

impl Clone for ExitCode

fn clone(&self) -> ExitCode

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ExitCode

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl From<ExitCode> for i32

fn from(code: ExitCode) -> Self

Converts to this type from the input type.

impl From<i32> for ExitCode

fn from(code: i32) -> Self

Converts to this type from the input type.

impl PartialEq for ExitCode

fn eq(&self, other: &ExitCode) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for ExitCode

impl Eq for ExitCode

impl StructuralPartialEq for ExitCode