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
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.

{
  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
}.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



47
48
49
50
51
 
# File 'lib/browserctl/error/exit_codes.rb', line 47

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

  TABLE.fetch(code, GENERIC)
end