Module: Browserctl::Error::ExitCodes

Defined in:
lib/browserctl/error/exit_codes.rb

Overview

Stable mapping from a canonical Codes string to a process exit status. The CLI’s top-level rescue uses this so AI agents and shell scripts can branch on ‘$?` deterministically without parsing stderr.

Stability contract:

  • Exit code integers are part of the v0.12 stable surface and will not be renumbered without a major version bump.

  • Unknown / unmapped codes intentionally fall through to GENERIC (1) so an unfamiliar code never silently surfaces as a non-error (0).

See docs/reference/exit-codes.md for the operator-facing table.

Constant Summary collapse

OK = 
0
GENERIC = 
1
DRIFT = 
2
AUTH_REQUIRED = 
3
DAEMON_UNREACHABLE = 
4
PROTOCOL_MISMATCH = 
5
SELECTOR_NOT_FOUND = 
6
STATE_EXPIRED = 
7
VALIDATION_FAILED = 
8
TABLE =

Canonical Codes string → exit status integer. Codes without an entry (e.g. DOMAIN_NOT_ALLOWED, KEY_NOT_FOUND, SECRET_RESOLUTION_FAILED, GENERIC) collapse to GENERIC for now; they may earn dedicated exit codes in a future milestone.

DRIFT (2) is reserved for a future Codes::DRIFT and currently has no entry in this table — drift-related raises fall through to GENERIC until that code is introduced.

The validation family (VALIDATION_FAILED parent plus INVALID_* specialisations) all map to exit code 8 — agents and scripts can branch on ‘$? == 8` for any caller-side validation failure without caring which specific guard tripped.

{
  Codes::AUTH_REQUIRED => AUTH_REQUIRED,
  Codes::DAEMON_UNREACHABLE => DAEMON_UNREACHABLE,
  Codes::PROTOCOL_MISMATCH => PROTOCOL_MISMATCH,
  Codes::SELECTOR_NOT_FOUND => SELECTOR_NOT_FOUND,
  Codes::STATE_EXPIRED => STATE_EXPIRED,
  Codes::VALIDATION_FAILED => VALIDATION_FAILED,
  Codes::INVALID_SELECTOR_REF => VALIDATION_FAILED,
  Codes::INVALID_STATE_NAME => VALIDATION_FAILED,
  Codes::INVALID_DSL_USAGE => VALIDATION_FAILED,
  Codes::INVALID_FORMAT_VERSION => VALIDATION_FAILED
}.freeze

Class Method Summary collapse

Class Method Details

.for(code) ⇒ Integer

Returns mapped exit status; GENERIC for nil or unknown codes.

Parameters:

  • code (String, nil) —

    a canonical code from Codes

Returns:

  • (Integer) —

    mapped exit status; GENERIC for nil or unknown codes



58
59
60
61
62
 
# File 'lib/browserctl/error/exit_codes.rb', line 58

def self.for(code)
  return GENERIC if code.nil?

  TABLE.fetch(code, GENERIC)
end