mirror of
https://github.com/tiennm99/ccs.git
synced 2026-07-16 10:16:49 +00:00
kaitranntt
22dbfd91c5
- add errors/ directory with error types, handler, cleanup registry - extract claude-spawner.ts from auth modules - update imports across auth, ccs, web-server Phase 2 & 4: Error handling consolidation
80 lines
2.2 KiB
TypeScript
80 lines
2.2 KiB
TypeScript
/**
|
|
* Standardized exit codes for CCS CLI
|
|
*
|
|
* Exit codes follow Unix conventions:
|
|
* - 0: Success
|
|
* - 1-125: Application errors
|
|
* - 126-127: Command execution errors (reserved by shell)
|
|
* - 128+N: Signal termination (128 + signal number)
|
|
* - 130: SIGINT (Ctrl+C) - 128 + 2
|
|
*/
|
|
|
|
export enum ExitCode {
|
|
/** Successful execution */
|
|
SUCCESS = 0,
|
|
|
|
/** General/unspecified error */
|
|
GENERAL_ERROR = 1,
|
|
|
|
/** Configuration file errors (missing, invalid, corrupt) */
|
|
CONFIG_ERROR = 2,
|
|
|
|
/** Network-related errors (connection, timeout, DNS) */
|
|
NETWORK_ERROR = 3,
|
|
|
|
/** Authentication/authorization errors (invalid token, expired, forbidden) */
|
|
AUTH_ERROR = 4,
|
|
|
|
/** Binary/executable errors (missing Claude CLI, corrupted binary) */
|
|
BINARY_ERROR = 5,
|
|
|
|
/** Provider-specific errors (API errors, rate limits, service unavailable) */
|
|
PROVIDER_ERROR = 6,
|
|
|
|
/** Profile not found or invalid */
|
|
PROFILE_ERROR = 7,
|
|
|
|
/** Proxy-related errors (startup failure, port conflict) */
|
|
PROXY_ERROR = 8,
|
|
|
|
/** Migration errors (failed to migrate config) */
|
|
MIGRATION_ERROR = 9,
|
|
|
|
/** User aborted operation (Ctrl+C, SIGINT) */
|
|
USER_ABORT = 130,
|
|
}
|
|
|
|
/**
|
|
* Human-readable descriptions for exit codes
|
|
* Used in error messages and documentation
|
|
*/
|
|
export const EXIT_CODE_DESCRIPTIONS: Record<ExitCode, string> = {
|
|
[ExitCode.SUCCESS]: 'Success',
|
|
[ExitCode.GENERAL_ERROR]: 'General error',
|
|
[ExitCode.CONFIG_ERROR]: 'Configuration error',
|
|
[ExitCode.NETWORK_ERROR]: 'Network error',
|
|
[ExitCode.AUTH_ERROR]: 'Authentication error',
|
|
[ExitCode.BINARY_ERROR]: 'Binary/executable error',
|
|
[ExitCode.PROVIDER_ERROR]: 'Provider error',
|
|
[ExitCode.PROFILE_ERROR]: 'Profile error',
|
|
[ExitCode.PROXY_ERROR]: 'Proxy error',
|
|
[ExitCode.MIGRATION_ERROR]: 'Migration error',
|
|
[ExitCode.USER_ABORT]: 'User abort (Ctrl+C)',
|
|
};
|
|
|
|
/**
|
|
* Check if an exit code indicates success
|
|
*/
|
|
export function isSuccess(code: ExitCode | number): boolean {
|
|
return code === ExitCode.SUCCESS;
|
|
}
|
|
|
|
/**
|
|
* Check if an exit code indicates a recoverable error
|
|
* (errors that might succeed on retry)
|
|
*/
|
|
export function isRecoverable(code: ExitCode | number): boolean {
|
|
const recoverableCodes = [ExitCode.NETWORK_ERROR, ExitCode.PROVIDER_ERROR];
|
|
return recoverableCodes.includes(code as ExitCode);
|
|
}
|