exitcode

const (
	// OK indicates successful execution.
	OK = 0

	// Error is the fallback for unclassified runtime errors.
	Error = 1

	// PermissionDenied indicates a filesystem or network permission failure.
	PermissionDenied = 2

	// Timeout indicates the operation exceeded its time limit.
	Timeout = 3

	// Interrupted indicates the process received SIGINT or SIGTERM.
	Interrupted = 4
)

const (
	// MissingRequiredFlag indicates a required input was missing at command
	// execution time. Structured errors may include hints about env fallbacks,
	// but the primary classification remains a missing required flag/input.
	MissingRequiredFlag = 10

	// InvalidFlagValue indicates a flag value has the wrong type or format
	// (eg. "abc" for an int flag).
	InvalidFlagValue = 11

	// UnknownFlag indicates the flag does not exist on the command.
	UnknownFlag = 12

	// ValidationFailed indicates one or more custom validation rules failed
	// (from ValidatableOptions). The structured error JSON includes a
	// "violations" array with per-field details.
	ValidationFailed = 13

	// UnknownCommand indicates the subcommand does not exist.
	// The structured error JSON includes an "available" array.
	UnknownCommand = 14

	// InvalidFlagEnum indicates the value is not in the allowed enum set.
	InvalidFlagEnum = 15
)

const (
	// ConfigParseError indicates the config file exists but is malformed
	// (invalid YAML, JSON, or TOML syntax).
	ConfigParseError = 20

	// ConfigUnknownKey indicates the config file contains an unrecognized key.
	// The structured error JSON includes an "available" array of valid keys.
	ConfigUnknownKey = 21

	// ConfigInvalidValue indicates a config key has the wrong type or format.
	ConfigInvalidValue = 22

	// ConfigNotFound indicates the path passed via --config does not exist.
	ConfigNotFound = 23

	// EnvInvalidValue indicates an environment variable is set but has the
	// wrong format or type for its target flag.
	EnvInvalidValue = 25

	// EnvMissingRequired is reserved for future env-only required inputs.
	// HandleError currently reports missing required flags/inputs as
	// MissingRequiredFlag and may include env fallback hints in the
	// structured error payload instead.
	EnvMissingRequired = 26
)

const (
	CategoryOK      = "ok"
	CategoryRuntime = "runtime"
	CategoryInput   = "input"
	CategoryConfig  = "config"
)