@cleocode/core 2.0.0

package/dist/error-catalog.js

@@ -0,0 +1,404 @@
+/**
+ * Unified Error Catalog -- single source of truth for all CLEO error definitions.
+ *
+ * Merges previously scattered error registries (error-registry.ts, _error.ts,
+ * mcp/lib/exit-codes.ts) into one canonical catalog keyed by ExitCode.
+ *
+ * Consumers should import from here instead of the legacy registries.
+ *
+ * @task T5240
+ */
+import { ExitCode } from '@cleocode/contracts';
+function def(code, name, category, message, httpStatus, recoverable, lafsCode, fix) {
+    return { code, name, category, message, httpStatus, recoverable, lafsCode, fix };
+}
+/**
+ * The unified error catalog. Keyed by numeric ExitCode value.
+ */
+export const ERROR_CATALOG = new Map([
+    // === SUCCESS (0) ===
+    [
+        ExitCode.SUCCESS,
+        def(ExitCode.SUCCESS, 'SUCCESS', 'INTERNAL', 'Success', 200, false, 'E_CLEO_SUCCESS'),
+    ],
+    // === GENERAL ERRORS (1-9) ===
+    [
+        ExitCode.GENERAL_ERROR,
+        def(ExitCode.GENERAL_ERROR, 'GENERAL_ERROR', 'INTERNAL', 'General error', 500, true, 'E_CLEO_GENERAL', 'Check command syntax and parameters'),
+    ],
+    [
+        ExitCode.INVALID_INPUT,
+        def(ExitCode.INVALID_INPUT, 'INVALID_INPUT', 'VALIDATION', 'Invalid input', 400, false, 'E_CLEO_INVALID_INPUT', 'Verify command parameters'),
+    ],
+    [
+        ExitCode.FILE_ERROR,
+        def(ExitCode.FILE_ERROR, 'FILE_ERROR', 'INTERNAL', 'File system error', 500, false, 'E_CLEO_FILE_ERROR', 'Check file permissions and disk space'),
+    ],
+    [
+        ExitCode.NOT_FOUND,
+        def(ExitCode.NOT_FOUND, 'NOT_FOUND', 'NOT_FOUND', 'Task or resource not found', 404, false, 'E_CLEO_NOT_FOUND'),
+    ],
+    [
+        ExitCode.DEPENDENCY_ERROR,
+        def(ExitCode.DEPENDENCY_ERROR, 'DEPENDENCY_ERROR', 'VALIDATION', 'Dependency error', 422, false, 'E_CLEO_DEPENDENCY'),
+    ],
+    [
+        ExitCode.VALIDATION_ERROR,
+        def(ExitCode.VALIDATION_ERROR, 'VALIDATION_ERROR', 'VALIDATION', 'Validation error', 422, false, 'E_CLEO_VALIDATION'),
+    ],
+    [
+        ExitCode.LOCK_TIMEOUT,
+        def(ExitCode.LOCK_TIMEOUT, 'LOCK_TIMEOUT', 'CONFLICT', 'File lock timeout', 409, true, 'E_CLEO_LOCK_TIMEOUT', 'Wait for concurrent operation to complete, then retry'),
+    ],
+    [
+        ExitCode.CONFIG_ERROR,
+        def(ExitCode.CONFIG_ERROR, 'CONFIG_ERROR', 'VALIDATION', 'Configuration error', 422, false, 'E_CLEO_CONFIG', 'Check configuration file: .cleo/config.json'),
+    ],
+    // === HIERARCHY ERRORS (10-19) ===
+    [
+        ExitCode.PARENT_NOT_FOUND,
+        def(ExitCode.PARENT_NOT_FOUND, 'PARENT_NOT_FOUND', 'NOT_FOUND', 'Parent task not found', 404, false, 'E_CLEO_PARENT_NOT_FOUND', 'Create parent task first or remove --parent flag'),
+    ],
+    [
+        ExitCode.DEPTH_EXCEEDED,
+        def(ExitCode.DEPTH_EXCEEDED, 'DEPTH_EXCEEDED', 'VALIDATION', 'Max hierarchy depth exceeded', 422, false, 'E_CLEO_DEPTH_EXCEEDED'),
+    ],
+    [
+        ExitCode.SIBLING_LIMIT,
+        def(ExitCode.SIBLING_LIMIT, 'SIBLING_LIMIT', 'VALIDATION', 'Max sibling count exceeded', 422, false, 'E_CLEO_SIBLING_LIMIT'),
+    ],
+    [
+        ExitCode.INVALID_PARENT_TYPE,
+        def(ExitCode.INVALID_PARENT_TYPE, 'INVALID_PARENT_TYPE', 'VALIDATION', 'Invalid parent task type', 422, false, 'E_CLEO_INVALID_PARENT_TYPE'),
+    ],
+    [
+        ExitCode.CIRCULAR_REFERENCE,
+        def(ExitCode.CIRCULAR_REFERENCE, 'CIRCULAR_REFERENCE', 'VALIDATION', 'Circular dependency detected', 422, false, 'E_CLEO_CIRCULAR_REF'),
+    ],
+    [
+        ExitCode.ORPHAN_DETECTED,
+        def(ExitCode.ORPHAN_DETECTED, 'ORPHAN_DETECTED', 'VALIDATION', 'Orphan task detected', 422, false, 'E_CLEO_ORPHAN'),
+    ],
+    [
+        ExitCode.HAS_CHILDREN,
+        def(ExitCode.HAS_CHILDREN, 'HAS_CHILDREN', 'CONFLICT', 'Task has children', 409, false, 'E_CLEO_HAS_CHILDREN'),
+    ],
+    [
+        ExitCode.TASK_COMPLETED,
+        def(ExitCode.TASK_COMPLETED, 'TASK_COMPLETED', 'CONFLICT', 'Task already completed', 409, false, 'E_CLEO_TASK_COMPLETED'),
+    ],
+    [
+        ExitCode.CASCADE_FAILED,
+        def(ExitCode.CASCADE_FAILED, 'CASCADE_FAILED', 'INTERNAL', 'Cascade operation failed', 500, false, 'E_CLEO_CASCADE_FAILED'),
+    ],
+    [
+        ExitCode.HAS_DEPENDENTS,
+        def(ExitCode.HAS_DEPENDENTS, 'HAS_DEPENDENTS', 'CONFLICT', 'Task has dependents', 409, false, 'E_CLEO_HAS_DEPENDENTS'),
+    ],
+    // === CONCURRENCY ERRORS (20-29) ===
+    [
+        ExitCode.CHECKSUM_MISMATCH,
+        def(ExitCode.CHECKSUM_MISMATCH, 'CHECKSUM_MISMATCH', 'CONFLICT', 'Checksum mismatch', 409, true, 'E_CLEO_CHECKSUM_MISMATCH'),
+    ],
+    [
+        ExitCode.CONCURRENT_MODIFICATION,
+        def(ExitCode.CONCURRENT_MODIFICATION, 'CONCURRENT_MODIFICATION', 'CONFLICT', 'Concurrent modification', 409, true, 'E_CLEO_CONCURRENT_MOD'),
+    ],
+    [
+        ExitCode.ID_COLLISION,
+        def(ExitCode.ID_COLLISION, 'ID_COLLISION', 'CONFLICT', 'ID collision', 409, true, 'E_CLEO_ID_COLLISION'),
+    ],
+    // === SESSION ERRORS (30-39) ===
+    [
+        ExitCode.SESSION_EXISTS,
+        def(ExitCode.SESSION_EXISTS, 'SESSION_EXISTS', 'CONFLICT', 'Session already exists', 409, false, 'E_CLEO_SESSION_EXISTS'),
+    ],
+    [
+        ExitCode.SESSION_NOT_FOUND,
+        def(ExitCode.SESSION_NOT_FOUND, 'SESSION_NOT_FOUND', 'NOT_FOUND', 'Session not found', 404, false, 'E_CLEO_SESSION_NOT_FOUND'),
+    ],
+    [
+        ExitCode.SCOPE_CONFLICT,
+        def(ExitCode.SCOPE_CONFLICT, 'SCOPE_CONFLICT', 'CONFLICT', 'Session scope conflict', 409, false, 'E_CLEO_SCOPE_CONFLICT'),
+    ],
+    [
+        ExitCode.SCOPE_INVALID,
+        def(ExitCode.SCOPE_INVALID, 'SCOPE_INVALID', 'VALIDATION', 'Invalid scope', 422, false, 'E_CLEO_SCOPE_INVALID'),
+    ],
+    [
+        ExitCode.TASK_NOT_IN_SCOPE,
+        def(ExitCode.TASK_NOT_IN_SCOPE, 'TASK_NOT_IN_SCOPE', 'VALIDATION', 'Task not in session scope', 422, false, 'E_CLEO_TASK_NOT_IN_SCOPE'),
+    ],
+    [
+        ExitCode.TASK_CLAIMED,
+        def(ExitCode.TASK_CLAIMED, 'TASK_CLAIMED', 'CONFLICT', 'Task claimed by another session', 409, false, 'E_CLEO_TASK_CLAIMED'),
+    ],
+    [
+        ExitCode.SESSION_REQUIRED,
+        def(ExitCode.SESSION_REQUIRED, 'SESSION_REQUIRED', 'CONTRACT', 'Active session required', 428, false, 'E_CLEO_SESSION_REQUIRED'),
+    ],
+    [
+        ExitCode.SESSION_CLOSE_BLOCKED,
+        def(ExitCode.SESSION_CLOSE_BLOCKED, 'SESSION_CLOSE_BLOCKED', 'CONFLICT', 'Session close blocked', 409, false, 'E_CLEO_SESSION_CLOSE_BLOCKED'),
+    ],
+    [
+        ExitCode.ACTIVE_TASK_REQUIRED,
+        def(ExitCode.ACTIVE_TASK_REQUIRED, 'ACTIVE_TASK_REQUIRED', 'CONTRACT', 'Active task required', 428, false, 'E_CLEO_ACTIVE_TASK_REQUIRED'),
+    ],
+    [
+        ExitCode.NOTES_REQUIRED,
+        def(ExitCode.NOTES_REQUIRED, 'NOTES_REQUIRED', 'VALIDATION', 'Notes required', 422, false, 'E_CLEO_NOTES_REQUIRED'),
+    ],
+    // === VERIFICATION ERRORS (40-47) ===
+    [
+        ExitCode.VERIFICATION_INIT_FAILED,
+        def(ExitCode.VERIFICATION_INIT_FAILED, 'VERIFICATION_INIT_FAILED', 'VALIDATION', 'Verification initialization failed', 422, false, 'E_CLEO_VERIFICATION_INIT_FAILED'),
+    ],
+    [
+        ExitCode.GATE_UPDATE_FAILED,
+        def(ExitCode.GATE_UPDATE_FAILED, 'GATE_UPDATE_FAILED', 'VALIDATION', 'Gate update failed', 422, false, 'E_CLEO_GATE_UPDATE_FAILED'),
+    ],
+    [
+        ExitCode.INVALID_GATE,
+        def(ExitCode.INVALID_GATE, 'INVALID_GATE', 'VALIDATION', 'Invalid gate name', 422, false, 'E_CLEO_INVALID_GATE'),
+    ],
+    [
+        ExitCode.INVALID_AGENT,
+        def(ExitCode.INVALID_AGENT, 'INVALID_AGENT', 'VALIDATION', 'Invalid agent name', 422, false, 'E_CLEO_INVALID_AGENT'),
+    ],
+    [
+        ExitCode.MAX_ROUNDS_EXCEEDED,
+        def(ExitCode.MAX_ROUNDS_EXCEEDED, 'MAX_ROUNDS_EXCEEDED', 'VALIDATION', 'Maximum implementation rounds exceeded', 422, false, 'E_CLEO_MAX_ROUNDS_EXCEEDED'),
+    ],
+    [
+        ExitCode.GATE_DEPENDENCY,
+        def(ExitCode.GATE_DEPENDENCY, 'GATE_DEPENDENCY', 'VALIDATION', 'Gate dependency not met', 422, false, 'E_CLEO_GATE_DEPENDENCY'),
+    ],
+    [
+        ExitCode.VERIFICATION_LOCKED,
+        def(ExitCode.VERIFICATION_LOCKED, 'VERIFICATION_LOCKED', 'CONFLICT', 'Verification locked', 409, false, 'E_CLEO_VERIFICATION_LOCKED'),
+    ],
+    [
+        ExitCode.ROUND_MISMATCH,
+        def(ExitCode.ROUND_MISMATCH, 'ROUND_MISMATCH', 'VALIDATION', 'Round number mismatch', 422, false, 'E_CLEO_ROUND_MISMATCH'),
+    ],
+    // === CONTEXT SAFEGUARD (50-54) ===
+    [
+        ExitCode.CONTEXT_WARNING,
+        def(ExitCode.CONTEXT_WARNING, 'CONTEXT_WARNING', 'CONTRACT', 'Context warning threshold reached', 429, false, 'E_CLEO_CONTEXT_WARNING'),
+    ],
+    [
+        ExitCode.CONTEXT_CAUTION,
+        def(ExitCode.CONTEXT_CAUTION, 'CONTEXT_CAUTION', 'CONTRACT', 'Context caution threshold reached', 429, false, 'E_CLEO_CONTEXT_CAUTION'),
+    ],
+    [
+        ExitCode.CONTEXT_CRITICAL,
+        def(ExitCode.CONTEXT_CRITICAL, 'CONTEXT_CRITICAL', 'CONTRACT', 'Context critical threshold reached', 429, false, 'E_CLEO_CONTEXT_CRITICAL'),
+    ],
+    [
+        ExitCode.CONTEXT_EMERGENCY,
+        def(ExitCode.CONTEXT_EMERGENCY, 'CONTEXT_EMERGENCY', 'CONTRACT', 'Context emergency threshold reached', 429, false, 'E_CLEO_CONTEXT_EMERGENCY'),
+    ],
+    [
+        ExitCode.CONTEXT_STALE,
+        def(ExitCode.CONTEXT_STALE, 'CONTEXT_STALE', 'CONTRACT', 'Context state file is stale', 429, false, 'E_CLEO_CONTEXT_STALE'),
+    ],
+    // === ORCHESTRATOR ERRORS (60-67) ===
+    [
+        ExitCode.PROTOCOL_MISSING,
+        def(ExitCode.PROTOCOL_MISSING, 'PROTOCOL_MISSING', 'CONTRACT', 'Protocol missing', 422, false, 'E_CLEO_PROTOCOL_MISSING'),
+    ],
+    [
+        ExitCode.INVALID_RETURN_MESSAGE,
+        def(ExitCode.INVALID_RETURN_MESSAGE, 'INVALID_RETURN_MESSAGE', 'CONTRACT', 'Invalid return message', 422, false, 'E_CLEO_INVALID_RETURN'),
+    ],
+    [
+        ExitCode.MANIFEST_ENTRY_MISSING,
+        def(ExitCode.MANIFEST_ENTRY_MISSING, 'MANIFEST_ENTRY_MISSING', 'CONTRACT', 'Manifest entry missing', 422, false, 'E_CLEO_MANIFEST_MISSING'),
+    ],
+    [
+        ExitCode.SPAWN_VALIDATION_FAILED,
+        def(ExitCode.SPAWN_VALIDATION_FAILED, 'SPAWN_VALIDATION_FAILED', 'VALIDATION', 'Spawn validation failed', 422, true, 'E_CLEO_SPAWN_FAILED'),
+    ],
+    [
+        ExitCode.AUTONOMOUS_BOUNDARY,
+        def(ExitCode.AUTONOMOUS_BOUNDARY, 'AUTONOMOUS_BOUNDARY', 'CONTRACT', 'Autonomous boundary reached', 403, false, 'E_CLEO_AUTONOMOUS_BOUNDARY'),
+    ],
+    [
+        ExitCode.HANDOFF_REQUIRED,
+        def(ExitCode.HANDOFF_REQUIRED, 'HANDOFF_REQUIRED', 'CONTRACT', 'Human handoff required', 403, false, 'E_CLEO_HANDOFF_REQUIRED'),
+    ],
+    [
+        ExitCode.RESUME_FAILED,
+        def(ExitCode.RESUME_FAILED, 'RESUME_FAILED', 'INTERNAL', 'Session resume failed', 500, true, 'E_CLEO_RESUME_FAILED'),
+    ],
+    [
+        ExitCode.CONCURRENT_SESSION,
+        def(ExitCode.CONCURRENT_SESSION, 'CONCURRENT_SESSION', 'CONFLICT', 'Concurrent session detected', 409, false, 'E_CLEO_CONCURRENT_SESSION'),
+    ],
+    // === NEXUS ERRORS (70-79) ===
+    [
+        ExitCode.NEXUS_NOT_INITIALIZED,
+        def(ExitCode.NEXUS_NOT_INITIALIZED, 'NEXUS_NOT_INITIALIZED', 'INTERNAL', 'Nexus not initialized', 500, false, 'E_CLEO_NEXUS_NOT_INITIALIZED', 'Initialize Nexus: cleo nexus init'),
+    ],
+    [
+        ExitCode.NEXUS_PROJECT_NOT_FOUND,
+        def(ExitCode.NEXUS_PROJECT_NOT_FOUND, 'NEXUS_PROJECT_NOT_FOUND', 'NOT_FOUND', 'Project not found in global registry', 404, false, 'E_CLEO_NEXUS_PROJECT_NOT_FOUND'),
+    ],
+    [
+        ExitCode.NEXUS_PERMISSION_DENIED,
+        def(ExitCode.NEXUS_PERMISSION_DENIED, 'NEXUS_PERMISSION_DENIED', 'PERMISSION', 'Insufficient permission for cross-project operation', 403, false, 'E_CLEO_NEXUS_PERMISSION_DENIED'),
+    ],
+    [
+        ExitCode.NEXUS_INVALID_SYNTAX,
+        def(ExitCode.NEXUS_INVALID_SYNTAX, 'NEXUS_INVALID_SYNTAX', 'VALIDATION', 'Invalid task reference syntax', 422, false, 'E_CLEO_NEXUS_INVALID_SYNTAX'),
+    ],
+    [
+        ExitCode.NEXUS_SYNC_FAILED,
+        def(ExitCode.NEXUS_SYNC_FAILED, 'NEXUS_SYNC_FAILED', 'TRANSIENT', 'Failed to sync project metadata', 503, true, 'E_CLEO_NEXUS_SYNC_FAILED'),
+    ],
+    [
+        ExitCode.NEXUS_REGISTRY_CORRUPT,
+        def(ExitCode.NEXUS_REGISTRY_CORRUPT, 'NEXUS_REGISTRY_CORRUPT', 'INTERNAL', 'Nexus registry corrupted', 500, false, 'E_CLEO_NEXUS_REGISTRY_CORRUPT'),
+    ],
+    [
+        ExitCode.NEXUS_PROJECT_EXISTS,
+        def(ExitCode.NEXUS_PROJECT_EXISTS, 'NEXUS_PROJECT_EXISTS', 'CONFLICT', 'Project already registered', 409, false, 'E_CLEO_NEXUS_PROJECT_EXISTS'),
+    ],
+    [
+        ExitCode.NEXUS_QUERY_FAILED,
+        def(ExitCode.NEXUS_QUERY_FAILED, 'NEXUS_QUERY_FAILED', 'TRANSIENT', 'Cross-project query failed', 503, true, 'E_CLEO_NEXUS_QUERY_FAILED'),
+    ],
+    [
+        ExitCode.NEXUS_GRAPH_ERROR,
+        def(ExitCode.NEXUS_GRAPH_ERROR, 'NEXUS_GRAPH_ERROR', 'INTERNAL', 'Graph operation error', 500, true, 'E_CLEO_NEXUS_GRAPH_ERROR'),
+    ],
+    [
+        ExitCode.NEXUS_RESERVED,
+        def(ExitCode.NEXUS_RESERVED, 'NEXUS_RESERVED', 'INTERNAL', 'Reserved nexus code', 500, false, 'E_CLEO_NEXUS_RESERVED'),
+    ],
+    // === LIFECYCLE ENFORCEMENT (80-84) ===
+    [
+        ExitCode.LIFECYCLE_GATE_FAILED,
+        def(ExitCode.LIFECYCLE_GATE_FAILED, 'LIFECYCLE_GATE_FAILED', 'CONTRACT', 'Lifecycle gate failed', 422, false, 'E_CLEO_LIFECYCLE_GATE'),
+    ],
+    [
+        ExitCode.AUDIT_MISSING,
+        def(ExitCode.AUDIT_MISSING, 'AUDIT_MISSING', 'CONTRACT', 'Audit trail missing', 422, false, 'E_CLEO_AUDIT_MISSING'),
+    ],
+    [
+        ExitCode.CIRCULAR_VALIDATION,
+        def(ExitCode.CIRCULAR_VALIDATION, 'CIRCULAR_VALIDATION', 'CONTRACT', 'Circular validation detected', 422, false, 'E_CLEO_CIRCULAR_VALIDATION'),
+    ],
+    [
+        ExitCode.LIFECYCLE_TRANSITION_INVALID,
+        def(ExitCode.LIFECYCLE_TRANSITION_INVALID, 'LIFECYCLE_TRANSITION_INVALID', 'CONTRACT', 'Invalid lifecycle transition', 422, false, 'E_CLEO_LIFECYCLE_INVALID'),
+    ],
+    [
+        ExitCode.PROVENANCE_REQUIRED,
+        def(ExitCode.PROVENANCE_REQUIRED, 'PROVENANCE_REQUIRED', 'CONTRACT', 'Provenance metadata required', 422, false, 'E_CLEO_PROVENANCE_REQUIRED'),
+    ],
+    // === ARTIFACT PUBLISH (85-89) ===
+    [
+        ExitCode.ARTIFACT_TYPE_UNKNOWN,
+        def(ExitCode.ARTIFACT_TYPE_UNKNOWN, 'ARTIFACT_TYPE_UNKNOWN', 'VALIDATION', 'Unknown artifact type', 422, false, 'E_CLEO_ARTIFACT_TYPE_UNKNOWN'),
+    ],
+    [
+        ExitCode.ARTIFACT_VALIDATION_FAILED,
+        def(ExitCode.ARTIFACT_VALIDATION_FAILED, 'ARTIFACT_VALIDATION_FAILED', 'VALIDATION', 'Artifact validation failed', 422, false, 'E_CLEO_ARTIFACT_VALIDATION_FAILED'),
+    ],
+    [
+        ExitCode.ARTIFACT_BUILD_FAILED,
+        def(ExitCode.ARTIFACT_BUILD_FAILED, 'ARTIFACT_BUILD_FAILED', 'INTERNAL', 'Artifact build failed', 500, true, 'E_CLEO_ARTIFACT_BUILD_FAILED'),
+    ],
+    [
+        ExitCode.ARTIFACT_PUBLISH_FAILED,
+        def(ExitCode.ARTIFACT_PUBLISH_FAILED, 'ARTIFACT_PUBLISH_FAILED', 'INTERNAL', 'Artifact publish failed', 500, true, 'E_CLEO_ARTIFACT_PUBLISH_FAILED'),
+    ],
+    [
+        ExitCode.ARTIFACT_ROLLBACK_FAILED,
+        def(ExitCode.ARTIFACT_ROLLBACK_FAILED, 'ARTIFACT_ROLLBACK_FAILED', 'INTERNAL', 'Artifact rollback failed', 500, false, 'E_CLEO_ARTIFACT_ROLLBACK_FAILED'),
+    ],
+    // === PROVENANCE (90-94) ===
+    [
+        ExitCode.PROVENANCE_CONFIG_INVALID,
+        def(ExitCode.PROVENANCE_CONFIG_INVALID, 'PROVENANCE_CONFIG_INVALID', 'VALIDATION', 'Provenance config invalid', 422, false, 'E_CLEO_PROVENANCE_CONFIG_INVALID'),
+    ],
+    [
+        ExitCode.SIGNING_KEY_MISSING,
+        def(ExitCode.SIGNING_KEY_MISSING, 'SIGNING_KEY_MISSING', 'VALIDATION', 'Signing key missing', 422, false, 'E_CLEO_SIGNING_KEY_MISSING'),
+    ],
+    [
+        ExitCode.SIGNATURE_INVALID,
+        def(ExitCode.SIGNATURE_INVALID, 'SIGNATURE_INVALID', 'VALIDATION', 'Signature invalid', 422, false, 'E_CLEO_SIGNATURE_INVALID'),
+    ],
+    [
+        ExitCode.DIGEST_MISMATCH,
+        def(ExitCode.DIGEST_MISMATCH, 'DIGEST_MISMATCH', 'VALIDATION', 'Digest mismatch', 422, false, 'E_CLEO_DIGEST_MISMATCH'),
+    ],
+    [
+        ExitCode.ATTESTATION_INVALID,
+        def(ExitCode.ATTESTATION_INVALID, 'ATTESTATION_INVALID', 'VALIDATION', 'Attestation invalid', 422, false, 'E_CLEO_ATTESTATION_INVALID'),
+    ],
+    // === ADAPTER ERRORS (95-99) ===
+    [
+        ExitCode.ADAPTER_NOT_FOUND,
+        def(ExitCode.ADAPTER_NOT_FOUND, 'ADAPTER_NOT_FOUND', 'NOT_FOUND', 'Provider adapter not found', 404, false, 'E_CLEO_ADAPTER_NOT_FOUND'),
+    ],
+    [
+        ExitCode.ADAPTER_INIT_FAILED,
+        def(ExitCode.ADAPTER_INIT_FAILED, 'ADAPTER_INIT_FAILED', 'INTERNAL', 'Provider adapter initialization failed', 500, true, 'E_CLEO_ADAPTER_INIT_FAILED'),
+    ],
+    [
+        ExitCode.ADAPTER_HOOK_FAILED,
+        def(ExitCode.ADAPTER_HOOK_FAILED, 'ADAPTER_HOOK_FAILED', 'INTERNAL', 'Provider adapter hook execution failed', 500, true, 'E_CLEO_ADAPTER_HOOK_FAILED'),
+    ],
+    [
+        ExitCode.ADAPTER_SPAWN_FAILED,
+        def(ExitCode.ADAPTER_SPAWN_FAILED, 'ADAPTER_SPAWN_FAILED', 'INTERNAL', 'Provider adapter process spawn failed', 500, true, 'E_CLEO_ADAPTER_SPAWN_FAILED'),
+    ],
+    [
+        ExitCode.ADAPTER_INSTALL_FAILED,
+        def(ExitCode.ADAPTER_INSTALL_FAILED, 'ADAPTER_INSTALL_FAILED', 'INTERNAL', 'Provider adapter installation failed', 500, false, 'E_CLEO_ADAPTER_INSTALL_FAILED'),
+    ],
+    // === SPECIAL CODES (100+) ===
+    [
+        ExitCode.NO_DATA,
+        def(ExitCode.NO_DATA, 'NO_DATA', 'INTERNAL', 'No data to process', 200, false, 'E_CLEO_NO_DATA'),
+    ],
+    [
+        ExitCode.ALREADY_EXISTS,
+        def(ExitCode.ALREADY_EXISTS, 'ALREADY_EXISTS', 'CONFLICT', 'Resource already exists', 200, false, 'E_CLEO_ALREADY_EXISTS'),
+    ],
+    [
+        ExitCode.NO_CHANGE,
+        def(ExitCode.NO_CHANGE, 'NO_CHANGE', 'INTERNAL', 'No changes needed', 200, false, 'E_CLEO_NO_CHANGE'),
+    ],
+    [
+        ExitCode.TESTS_SKIPPED,
+        def(ExitCode.TESTS_SKIPPED, 'TESTS_SKIPPED', 'INTERNAL', 'Tests skipped', 200, false, 'E_CLEO_TESTS_SKIPPED'),
+    ],
+]);
+/**
+ * Look up an error definition by exit code.
+ */
+export function getErrorDefinition(code) {
+    return ERROR_CATALOG.get(code);
+}
+/**
+ * Look up an error definition by LAFS string code.
+ */
+export function getErrorDefinitionByLafsCode(lafsCode) {
+    for (const entry of ERROR_CATALOG.values()) {
+        if (entry.lafsCode === lafsCode)
+            return entry;
+    }
+    return undefined;
+}
+/**
+ * Get all error definitions as an array.
+ */
+export function getAllErrorDefinitions() {
+    return [...ERROR_CATALOG.values()];
+}
+//# sourceMappingURL=error-catalog.js.map

package/dist/error-catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-catalog.js","sourceRoot":"","sources":["../src/error-catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAwB/C,SAAS,GAAG,CACV,IAAc,EACd,IAAY,EACZ,QAA2B,EAC3B,OAAe,EACf,UAAkB,EAClB,WAAoB,EACpB,QAAgB,EAChB,GAAY;IAEZ,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;AACnF,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAyC,IAAI,GAAG,CACxE;IACE,sBAAsB;IACtB;QACE,QAAQ,CAAC,OAAO;QAChB,GAAG,CAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,EAAE,KAAK,EAAE,gBAAgB,CAAC;KACtF;IAED,+BAA+B;IAC/B;QACE,QAAQ,CAAC,aAAa;QACtB,GAAG,CACD,QAAQ,CAAC,aAAa,EACtB,eAAe,EACf,UAAU,EACV,eAAe,EACf,GAAG,EACH,IAAI,EACJ,gBAAgB,EAChB,qCAAqC,CACtC;KACF;IACD;QACE,QAAQ,CAAC,aAAa;QACtB,GAAG,CACD,QAAQ,CAAC,aAAa,EACtB,eAAe,EACf,YAAY,EACZ,eAAe,EACf,GAAG,EACH,KAAK,EACL,sBAAsB,EACtB,2BAA2B,CAC5B;KACF;IACD;QACE,QAAQ,CAAC,UAAU;QACnB,GAAG,CACD,QAAQ,CAAC,UAAU,EACnB,YAAY,EACZ,UAAU,EACV,mBAAmB,EACnB,GAAG,EACH,KAAK,EACL,mBAAmB,EACnB,uCAAuC,CACxC;KACF;IACD;QACE,QAAQ,CAAC,SAAS;QAClB,GAAG,CACD,QAAQ,CAAC,SAAS,EAClB,WAAW,EACX,WAAW,EACX,4BAA4B,EAC5B,GAAG,EACH,KAAK,EACL,kBAAkB,CACnB;KACF;IACD;QACE,QAAQ,CAAC,gBAAgB;QACzB,GAAG,CACD,QAAQ,CAAC,gBAAgB,EACzB,kBAAkB,EAClB,YAAY,EACZ,kBAAkB,EAClB,GAAG,EACH,KAAK,EACL,mBAAmB,CACpB;KACF;IACD;QACE,QAAQ,CAAC,gBAAgB;QACzB,GAAG,CACD,QAAQ,CAAC,gBAAgB,EACzB,kBAAkB,EAClB,YAAY,EACZ,kBAAkB,EAClB,GAAG,EACH,KAAK,EACL,mBAAmB,CACpB;KACF;IACD;QACE,QAAQ,CAAC,YAAY;QACrB,GAAG,CACD,QAAQ,CAAC,YAAY,EACrB,cAAc,EACd,UAAU,EACV,mBAAmB,EACnB,GAAG,EACH,IAAI,EACJ,qBAAqB,EACrB,uDAAuD,CACxD;KACF;IACD;QACE,QAAQ,CAAC,YAAY;QACrB,GAAG,CACD,QAAQ,CAAC,YAAY,EACrB,cAAc,EACd,YAAY,EACZ,qBAAqB,EACrB,GAAG,EACH,KAAK,EACL,eAAe,EACf,6CAA6C,CAC9C;KACF;IAED,mCAAmC;IACnC;QACE,QAAQ,CAAC,gBAAgB;QACzB,GAAG,CACD,QAAQ,CAAC,gBAAgB,EACzB,kBAAkB,EAClB,WAAW,EACX,uBAAuB,EACvB,GAAG,EACH,KAAK,EACL,yBAAyB,EACzB,kDAAkD,CACnD;KACF;IACD;QACE,QAAQ,CAAC,cAAc;QACvB,GAAG,CACD,QAAQ,CAAC,cAAc,EACvB,gBAAgB,EAChB,YAAY,EACZ,8BAA8B,EAC9B,GAAG,EACH,KAAK,EACL,uBAAuB,CACxB;KACF;IACD;QACE,QAAQ,CAAC,aAAa;QACtB,GAAG,CACD,QAAQ,CAAC,aAAa,EACtB,eAAe,EACf,YAAY,EACZ,4BAA4B,EAC5B,GAAG,EACH,KAAK,EACL,sBAAsB,CACvB;KACF;IACD;QACE,QAAQ,CAAC,mBAAmB;QAC5B,GAAG,CACD,QAAQ,CAAC,mBAAmB,EAC5B,qBAAqB,EACrB,YAAY,EACZ,0BAA0B,EAC1B,GAAG,EACH,KAAK,EACL,4BAA4B,CAC7B;KACF;IACD;QACE,QAAQ,CAAC,kBAAkB;QAC3B,GAAG,CACD,QAAQ,CAAC,kBAAkB,EAC3B,oBAAoB,EACpB,YAAY,EACZ,8BAA8B,EAC9B,GAAG,EACH,KAAK,EACL,qBAAqB,CACtB;KACF;IACD;QACE,QAAQ,CAAC,eAAe;QACxB,GAAG,CACD,QAAQ,CAAC,eAAe,EACxB,iBAAiB,EACjB,YAAY,EACZ,sBAAsB,EACtB,GAAG,EACH,KAAK,EACL,eAAe,CAChB;KACF;IACD;QACE,QAAQ,CAAC,YAAY;QACrB,GAAG,CACD,QAAQ,CAAC,YAAY,EACrB,cAAc,EACd,UAAU,EACV,mBAAmB,EACnB,GAAG,EACH,KAAK,EACL,qBAAqB,CACtB;KACF;IACD;QACE,QAAQ,CAAC,cAAc;QACvB,GAAG,CACD,QAAQ,CAAC,cAAc,EACvB,gBAAgB,EAChB,UAAU,EACV,wBAAwB,EACxB,GAAG,EACH,KAAK,EACL,uBAAuB,CACxB;KACF;IACD;QACE,QAAQ,CAAC,cAAc;QACvB,GAAG,CACD,QAAQ,CAAC,cAAc,EACvB,gBAAgB,EAChB,UAAU,EACV,0BAA0B,EAC1B,GAAG,EACH,KAAK,EACL,uBAAuB,CACxB;KACF;IACD;QACE,QAAQ,CAAC,cAAc;QACvB,GAAG,CACD,QAAQ,CAAC,cAAc,EACvB,gBAAgB,EAChB,UAAU,EACV,qBAAqB,EACrB,GAAG,EACH,KAAK,EACL,uBAAuB,CACxB;KACF;IAED,qCAAqC;IACrC;QACE,QAAQ,CAAC,iBAAiB;QAC1B,GAAG,CACD,QAAQ,CAAC,iBAAiB,EAC1B,mBAAmB,EACnB,UAAU,EACV,mBAAmB,EACnB,GAAG,EACH,IAAI,EACJ,0BAA0B,CAC3B;KACF;IACD;QACE,QAAQ,CAAC,uBAAuB;QAChC,GAAG,CACD,QAAQ,CAAC,uBAAuB,EAChC,yBAAyB,EACzB,UAAU,EACV,yBAAyB,EACzB,GAAG,EACH,IAAI,EACJ,uBAAuB,CACxB;KACF;IACD;QACE,QAAQ,CAAC,YAAY;QACrB,GAAG,CACD,QAAQ,CAAC,YAAY,EACrB,cAAc,EACd,UAAU,EACV,cAAc,EACd,GAAG,EACH,IAAI,EACJ,qBAAqB,CACtB;KACF;IAED,iCAAiC;IACjC;QACE,QAAQ,CAAC,cAAc;QACvB,GAAG,CACD,QAAQ,CAAC,cAAc,EACvB,gBAAgB,EAChB,UAAU,EACV,wBAAwB,EACxB,GAAG,EACH,KAAK,EACL,uBAAuB,CACxB;KACF;IACD;QACE,QAAQ,CAAC,iBAAiB;QAC1B,GAAG,CACD,QAAQ,CAAC,iBAAiB,EAC1B,mBAAmB,EACnB,WAAW,EACX,mBAAmB,EACnB,GAAG,EACH,KAAK,EACL,0BAA0B,CAC3B;KACF;IACD;QACE,QAAQ,CAAC,cAAc;QACvB,GAAG,CACD,QAAQ,CAAC,cAAc,EACvB,gBAAgB,EAChB,UAAU,EACV,wBAAwB,EACxB,GAAG,EACH,KAAK,EACL,uBAAuB,CACxB;KACF;IACD;QACE,QAAQ,CAAC,aAAa;QACtB,GAAG,CACD,QAAQ,CAAC,aAAa,EACtB,eAAe,EACf,YAAY,EACZ,eAAe,EACf,GAAG,EACH,KAAK,EACL,sBAAsB,CACvB;KACF;IACD;QACE,QAAQ,CAAC,iBAAiB;QAC1B,GAAG,CACD,QAAQ,CAAC,iBAAiB,EAC1B,mBAAmB,EACnB,YAAY,EACZ,2BAA2B,EAC3B,GAAG,EACH,KAAK,EACL,0BAA0B,CAC3B;KACF;IACD;QACE,QAAQ,CAAC,YAAY;QACrB,GAAG,CACD,QAAQ,CAAC,YAAY,EACrB,cAAc,EACd,UAAU,EACV,iCAAiC,EACjC,GAAG,EACH,KAAK,EACL,qBAAqB,CACtB;KACF;IACD;QACE,QAAQ,CAAC,gBAAgB;QACzB,GAAG,CACD,QAAQ,CAAC,gBAAgB,EACzB,kBAAkB,EAClB,UAAU,EACV,yBAAyB,EACzB,GAAG,EACH,KAAK,EACL,yBAAyB,CAC1B;KACF;IACD;QACE,QAAQ,CAAC,qBAAqB;QAC9B,GAAG,CACD,QAAQ,CAAC,qBAAqB,EAC9B,uBAAuB,EACvB,UAAU,EACV,uBAAuB,EACvB,GAAG,EACH,KAAK,EACL,8BAA8B,CAC/B;KACF;IACD;QACE,QAAQ,CAAC,oBAAoB;QAC7B,GAAG,CACD,QAAQ,CAAC,oBAAoB,EAC7B,sBAAsB,EACtB,UAAU,EACV,sBAAsB,EACtB,GAAG,EACH,KAAK,EACL,6BAA6B,CAC9B;KACF;IACD;QACE,QAAQ,CAAC,cAAc;QACvB,GAAG,CACD,QAAQ,CAAC,cAAc,EACvB,gBAAgB,EAChB,YAAY,EACZ,gBAAgB,EAChB,GAAG,EACH,KAAK,EACL,uBAAuB,CACxB;KACF;IAED,sCAAsC;IACtC;QACE,QAAQ,CAAC,wBAAwB;QACjC,GAAG,CACD,QAAQ,CAAC,wBAAwB,EACjC,0BAA0B,EAC1B,YAAY,EACZ,oCAAoC,EACpC,GAAG,EACH,KAAK,EACL,iCAAiC,CAClC;KACF;IACD;QACE,QAAQ,CAAC,kBAAkB;QAC3B,GAAG,CACD,QAAQ,CAAC,kBAAkB,EAC3B,oBAAoB,EACpB,YAAY,EACZ,oBAAoB,EACpB,GAAG,EACH,KAAK,EACL,2BAA2B,CAC5B;KACF;IACD;QACE,QAAQ,CAAC,YAAY;QACrB,GAAG,CACD,QAAQ,CAAC,YAAY,EACrB,cAAc,EACd,YAAY,EACZ,mBAAmB,EACnB,GAAG,EACH,KAAK,EACL,qBAAqB,CACtB;KACF;IACD;QACE,QAAQ,CAAC,aAAa;QACtB,GAAG,CACD,QAAQ,CAAC,aAAa,EACtB,eAAe,EACf,YAAY,EACZ,oBAAoB,EACpB,GAAG,EACH,KAAK,EACL,sBAAsB,CACvB;KACF;IACD;QACE,QAAQ,CAAC,mBAAmB;QAC5B,GAAG,CACD,QAAQ,CAAC,mBAAmB,EAC5B,qBAAqB,EACrB,YAAY,EACZ,wCAAwC,EACxC,GAAG,EACH,KAAK,EACL,4BAA4B,CAC7B;KACF;IACD;QACE,QAAQ,CAAC,eAAe;QACxB,GAAG,CACD,QAAQ,CAAC,eAAe,EACxB,iBAAiB,EACjB,YAAY,EACZ,yBAAyB,EACzB,GAAG,EACH,KAAK,EACL,wBAAwB,CACzB;KACF;IACD;QACE,QAAQ,CAAC,mBAAmB;QAC5B,GAAG,CACD,QAAQ,CAAC,mBAAmB,EAC5B,qBAAqB,EACrB,UAAU,EACV,qBAAqB,EACrB,GAAG,EACH,KAAK,EACL,4BAA4B,CAC7B;KACF;IACD;QACE,QAAQ,CAAC,cAAc;QACvB,GAAG,CACD,QAAQ,CAAC,cAAc,EACvB,gBAAgB,EAChB,YAAY,EACZ,uBAAuB,EACvB,GAAG,EACH,KAAK,EACL,uBAAuB,CACxB;KACF;IAED,oCAAoC;IACpC;QACE,QAAQ,CAAC,eAAe;QACxB,GAAG,CACD,QAAQ,CAAC,eAAe,EACxB,iBAAiB,EACjB,UAAU,EACV,mCAAmC,EACnC,GAAG,EACH,KAAK,EACL,wBAAwB,CACzB;KACF;IACD;QACE,QAAQ,CAAC,eAAe;QACxB,GAAG,CACD,QAAQ,CAAC,eAAe,EACxB,iBAAiB,EACjB,UAAU,EACV,mCAAmC,EACnC,GAAG,EACH,KAAK,EACL,wBAAwB,CACzB;KACF;IACD;QACE,QAAQ,CAAC,gBAAgB;QACzB,GAAG,CACD,QAAQ,CAAC,gBAAgB,EACzB,kBAAkB,EAClB,UAAU,EACV,oCAAoC,EACpC,GAAG,EACH,KAAK,EACL,yBAAyB,CAC1B;KACF;IACD;QACE,QAAQ,CAAC,iBAAiB;QAC1B,GAAG,CACD,QAAQ,CAAC,iBAAiB,EAC1B,mBAAmB,EACnB,UAAU,EACV,qCAAqC,EACrC,GAAG,EACH,KAAK,EACL,0BAA0B,CAC3B;KACF;IACD;QACE,QAAQ,CAAC,aAAa;QACtB,GAAG,CACD,QAAQ,CAAC,aAAa,EACtB,eAAe,EACf,UAAU,EACV,6BAA6B,EAC7B,GAAG,EACH,KAAK,EACL,sBAAsB,CACvB;KACF;IAED,sCAAsC;IACtC;QACE,QAAQ,CAAC,gBAAgB;QACzB,GAAG,CACD,QAAQ,CAAC,gBAAgB,EACzB,kBAAkB,EAClB,UAAU,EACV,kBAAkB,EAClB,GAAG,EACH,KAAK,EACL,yBAAyB,CAC1B;KACF;IACD;QACE,QAAQ,CAAC,sBAAsB;QAC/B,GAAG,CACD,QAAQ,CAAC,sBAAsB,EAC/B,wBAAwB,EACxB,UAAU,EACV,wBAAwB,EACxB,GAAG,EACH,KAAK,EACL,uBAAuB,CACxB;KACF;IACD;QACE,QAAQ,CAAC,sBAAsB;QAC/B,GAAG,CACD,QAAQ,CAAC,sBAAsB,EAC/B,wBAAwB,EACxB,UAAU,EACV,wBAAwB,EACxB,GAAG,EACH,KAAK,EACL,yBAAyB,CAC1B;KACF;IACD;QACE,QAAQ,CAAC,uBAAuB;QAChC,GAAG,CACD,QAAQ,CAAC,uBAAuB,EAChC,yBAAyB,EACzB,YAAY,EACZ,yBAAyB,EACzB,GAAG,EACH,IAAI,EACJ,qBAAqB,CACtB;KACF;IACD;QACE,QAAQ,CAAC,mBAAmB;QAC5B,GAAG,CACD,QAAQ,CAAC,mBAAmB,EAC5B,qBAAqB,EACrB,UAAU,EACV,6BAA6B,EAC7B,GAAG,EACH,KAAK,EACL,4BAA4B,CAC7B;KACF;IACD;QACE,QAAQ,CAAC,gBAAgB;QACzB,GAAG,CACD,QAAQ,CAAC,gBAAgB,EACzB,kBAAkB,EAClB,UAAU,EACV,wBAAwB,EACxB,GAAG,EACH,KAAK,EACL,yBAAyB,CAC1B;KACF;IACD;QACE,QAAQ,CAAC,aAAa;QACtB,GAAG,CACD,QAAQ,CAAC,aAAa,EACtB,eAAe,EACf,UAAU,EACV,uBAAuB,EACvB,GAAG,EACH,IAAI,EACJ,sBAAsB,CACvB;KACF;IACD;QACE,QAAQ,CAAC,kBAAkB;QAC3B,GAAG,CACD,QAAQ,CAAC,kBAAkB,EAC3B,oBAAoB,EACpB,UAAU,EACV,6BAA6B,EAC7B,GAAG,EACH,KAAK,EACL,2BAA2B,CAC5B;KACF;IAED,+BAA+B;IAC/B;QACE,QAAQ,CAAC,qBAAqB;QAC9B,GAAG,CACD,QAAQ,CAAC,qBAAqB,EAC9B,uBAAuB,EACvB,UAAU,EACV,uBAAuB,EACvB,GAAG,EACH,KAAK,EACL,8BAA8B,EAC9B,mCAAmC,CACpC;KACF;IACD;QACE,QAAQ,CAAC,uBAAuB;QAChC,GAAG,CACD,QAAQ,CAAC,uBAAuB,EAChC,yBAAyB,EACzB,WAAW,EACX,sCAAsC,EACtC,GAAG,EACH,KAAK,EACL,gCAAgC,CACjC;KACF;IACD;QACE,QAAQ,CAAC,uBAAuB;QAChC,GAAG,CACD,QAAQ,CAAC,uBAAuB,EAChC,yBAAyB,EACzB,YAAY,EACZ,qDAAqD,EACrD,GAAG,EACH,KAAK,EACL,gCAAgC,CACjC;KACF;IACD;QACE,QAAQ,CAAC,oBAAoB;QAC7B,GAAG,CACD,QAAQ,CAAC,oBAAoB,EAC7B,sBAAsB,EACtB,YAAY,EACZ,+BAA+B,EAC/B,GAAG,EACH,KAAK,EACL,6BAA6B,CAC9B;KACF;IACD;QACE,QAAQ,CAAC,iBAAiB;QAC1B,GAAG,CACD,QAAQ,CAAC,iBAAiB,EAC1B,mBAAmB,EACnB,WAAW,EACX,iCAAiC,EACjC,GAAG,EACH,IAAI,EACJ,0BAA0B,CAC3B;KACF;IACD;QACE,QAAQ,CAAC,sBAAsB;QAC/B,GAAG,CACD,QAAQ,CAAC,sBAAsB,EAC/B,wBAAwB,EACxB,UAAU,EACV,0BAA0B,EAC1B,GAAG,EACH,KAAK,EACL,+BAA+B,CAChC;KACF;IACD;QACE,QAAQ,CAAC,oBAAoB;QAC7B,GAAG,CACD,QAAQ,CAAC,oBAAoB,EAC7B,sBAAsB,EACtB,UAAU,EACV,4BAA4B,EAC5B,GAAG,EACH,KAAK,EACL,6BAA6B,CAC9B;KACF;IACD;QACE,QAAQ,CAAC,kBAAkB;QAC3B,GAAG,CACD,QAAQ,CAAC,kBAAkB,EAC3B,oBAAoB,EACpB,WAAW,EACX,4BAA4B,EAC5B,GAAG,EACH,IAAI,EACJ,2BAA2B,CAC5B;KACF;IACD;QACE,QAAQ,CAAC,iBAAiB;QAC1B,GAAG,CACD,QAAQ,CAAC,iBAAiB,EAC1B,mBAAmB,EACnB,UAAU,EACV,uBAAuB,EACvB,GAAG,EACH,IAAI,EACJ,0BAA0B,CAC3B;KACF;IACD;QACE,QAAQ,CAAC,cAAc;QACvB,GAAG,CACD,QAAQ,CAAC,cAAc,EACvB,gBAAgB,EAChB,UAAU,EACV,qBAAqB,EACrB,GAAG,EACH,KAAK,EACL,uBAAuB,CACxB;KACF;IAED,wCAAwC;IACxC;QACE,QAAQ,CAAC,qBAAqB;QAC9B,GAAG,CACD,QAAQ,CAAC,qBAAqB,EAC9B,uBAAuB,EACvB,UAAU,EACV,uBAAuB,EACvB,GAAG,EACH,KAAK,EACL,uBAAuB,CACxB;KACF;IACD;QACE,QAAQ,CAAC,aAAa;QACtB,GAAG,CACD,QAAQ,CAAC,aAAa,EACtB,eAAe,EACf,UAAU,EACV,qBAAqB,EACrB,GAAG,EACH,KAAK,EACL,sBAAsB,CACvB;KACF;IACD;QACE,QAAQ,CAAC,mBAAmB;QAC5B,GAAG,CACD,QAAQ,CAAC,mBAAmB,EAC5B,qBAAqB,EACrB,UAAU,EACV,8BAA8B,EAC9B,GAAG,EACH,KAAK,EACL,4BAA4B,CAC7B;KACF;IACD;QACE,QAAQ,CAAC,4BAA4B;QACrC,GAAG,CACD,QAAQ,CAAC,4BAA4B,EACrC,8BAA8B,EAC9B,UAAU,EACV,8BAA8B,EAC9B,GAAG,EACH,KAAK,EACL,0BAA0B,CAC3B;KACF;IACD;QACE,QAAQ,CAAC,mBAAmB;QAC5B,GAAG,CACD,QAAQ,CAAC,mBAAmB,EAC5B,qBAAqB,EACrB,UAAU,EACV,8BAA8B,EAC9B,GAAG,EACH,KAAK,EACL,4BAA4B,CAC7B;KACF;IAED,mCAAmC;IACnC;QACE,QAAQ,CAAC,qBAAqB;QAC9B,GAAG,CACD,QAAQ,CAAC,qBAAqB,EAC9B,uBAAuB,EACvB,YAAY,EACZ,uBAAuB,EACvB,GAAG,EACH,KAAK,EACL,8BAA8B,CAC/B;KACF;IACD;QACE,QAAQ,CAAC,0BAA0B;QACnC,GAAG,CACD,QAAQ,CAAC,0BAA0B,EACnC,4BAA4B,EAC5B,YAAY,EACZ,4BAA4B,EAC5B,GAAG,EACH,KAAK,EACL,mCAAmC,CACpC;KACF;IACD;QACE,QAAQ,CAAC,qBAAqB;QAC9B,GAAG,CACD,QAAQ,CAAC,qBAAqB,EAC9B,uBAAuB,EACvB,UAAU,EACV,uBAAuB,EACvB,GAAG,EACH,IAAI,EACJ,8BAA8B,CAC/B;KACF;IACD;QACE,QAAQ,CAAC,uBAAuB;QAChC,GAAG,CACD,QAAQ,CAAC,uBAAuB,EAChC,yBAAyB,EACzB,UAAU,EACV,yBAAyB,EACzB,GAAG,EACH,IAAI,EACJ,gCAAgC,CACjC;KACF;IACD;QACE,QAAQ,CAAC,wBAAwB;QACjC,GAAG,CACD,QAAQ,CAAC,wBAAwB,EACjC,0BAA0B,EAC1B,UAAU,EACV,0BAA0B,EAC1B,GAAG,EACH,KAAK,EACL,iCAAiC,CAClC;KACF;IAED,6BAA6B;IAC7B;QACE,QAAQ,CAAC,yBAAyB;QAClC,GAAG,CACD,QAAQ,CAAC,yBAAyB,EAClC,2BAA2B,EAC3B,YAAY,EACZ,2BAA2B,EAC3B,GAAG,EACH,KAAK,EACL,kCAAkC,CACnC;KACF;IACD;QACE,QAAQ,CAAC,mBAAmB;QAC5B,GAAG,CACD,QAAQ,CAAC,mBAAmB,EAC5B,qBAAqB,EACrB,YAAY,EACZ,qBAAqB,EACrB,GAAG,EACH,KAAK,EACL,4BAA4B,CAC7B;KACF;IACD;QACE,QAAQ,CAAC,iBAAiB;QAC1B,GAAG,CACD,QAAQ,CAAC,iBAAiB,EAC1B,mBAAmB,EACnB,YAAY,EACZ,mBAAmB,EACnB,GAAG,EACH,KAAK,EACL,0BAA0B,CAC3B;KACF;IACD;QACE,QAAQ,CAAC,eAAe;QACxB,GAAG,CACD,QAAQ,CAAC,eAAe,EACxB,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EACjB,GAAG,EACH,KAAK,EACL,wBAAwB,CACzB;KACF;IACD;QACE,QAAQ,CAAC,mBAAmB;QAC5B,GAAG,CACD,QAAQ,CAAC,mBAAmB,EAC5B,qBAAqB,EACrB,YAAY,EACZ,qBAAqB,EACrB,GAAG,EACH,KAAK,EACL,4BAA4B,CAC7B;KACF;IAED,iCAAiC;IACjC;QACE,QAAQ,CAAC,iBAAiB;QAC1B,GAAG,CACD,QAAQ,CAAC,iBAAiB,EAC1B,mBAAmB,EACnB,WAAW,EACX,4BAA4B,EAC5B,GAAG,EACH,KAAK,EACL,0BAA0B,CAC3B;KACF;IACD;QACE,QAAQ,CAAC,mBAAmB;QAC5B,GAAG,CACD,QAAQ,CAAC,mBAAmB,EAC5B,qBAAqB,EACrB,UAAU,EACV,wCAAwC,EACxC,GAAG,EACH,IAAI,EACJ,4BAA4B,CAC7B;KACF;IACD;QACE,QAAQ,CAAC,mBAAmB;QAC5B,GAAG,CACD,QAAQ,CAAC,mBAAmB,EAC5B,qBAAqB,EACrB,UAAU,EACV,wCAAwC,EACxC,GAAG,EACH,IAAI,EACJ,4BAA4B,CAC7B;KACF;IACD;QACE,QAAQ,CAAC,oBAAoB;QAC7B,GAAG,CACD,QAAQ,CAAC,oBAAoB,EAC7B,sBAAsB,EACtB,UAAU,EACV,uCAAuC,EACvC,GAAG,EACH,IAAI,EACJ,6BAA6B,CAC9B;KACF;IACD;QACE,QAAQ,CAAC,sBAAsB;QAC/B,GAAG,CACD,QAAQ,CAAC,sBAAsB,EAC/B,wBAAwB,EACxB,UAAU,EACV,sCAAsC,EACtC,GAAG,EACH,KAAK,EACL,+BAA+B,CAChC;KACF;IAED,+BAA+B;IAC/B;QACE,QAAQ,CAAC,OAAO;QAChB,GAAG,CACD,QAAQ,CAAC,OAAO,EAChB,SAAS,EACT,UAAU,EACV,oBAAoB,EACpB,GAAG,EACH,KAAK,EACL,gBAAgB,CACjB;KACF;IACD;QACE,QAAQ,CAAC,cAAc;QACvB,GAAG,CACD,QAAQ,CAAC,cAAc,EACvB,gBAAgB,EAChB,UAAU,EACV,yBAAyB,EACzB,GAAG,EACH,KAAK,EACL,uBAAuB,CACxB;KACF;IACD;QACE,QAAQ,CAAC,SAAS;QAClB,GAAG,CACD,QAAQ,CAAC,SAAS,EAClB,WAAW,EACX,UAAU,EACV,mBAAmB,EACnB,GAAG,EACH,KAAK,EACL,kBAAkB,CACnB;KACF;IACD;QACE,QAAQ,CAAC,aAAa;QACtB,GAAG,CACD,QAAQ,CAAC,aAAa,EACtB,eAAe,EACf,UAAU,EACV,eAAe,EACf,GAAG,EACH,KAAK,EACL,sBAAsB,CACvB;KACF;CACF,CACF,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,OAAO,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,4BAA4B,CAAC,QAAgB;IAC3D,KAAK,MAAM,KAAK,IAAI,aAAa,CAAC,MAAM,EAAE,EAAE,CAAC;QAC3C,IAAI,KAAK,CAAC,QAAQ,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;IAChD,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB;IACpC,OAAO,CAAC,GAAG,aAAa,CAAC,MAAM,EAAE,CAAC,CAAC;AACrC,CAAC"}

package/dist/error-registry.d.ts

@@ -0,0 +1,58 @@
+/**
+ * CLEO error code to LAFS canonical error code mapping.
+ *
+ * Maps CLEO's numeric exit codes (ExitCode enum) to LAFS error registry
+ * string codes for protocol conformance.
+ *
+ * @deprecated Use `src/core/error-catalog.ts` instead. This registry is retained
+ * for backward compatibility but will be removed in a future release.
+ * Import from `error-catalog.ts` for the unified, complete error catalog.
+ *
+ * @task T4671
+ * @epic T4663
+ */
+import type { LAFSErrorCategory } from '@cleocode/lafs-protocol';
+import { ExitCode } from '@cleocode/contracts';
+/**
+ * Entry in the CLEO-to-LAFS error registry.
+ *
+ * @task T4671
+ * @epic T4663
+ */
+export interface CleoRegistryEntry {
+    exitCode: ExitCode;
+    lafsCode: string;
+    category: LAFSErrorCategory;
+    description: string;
+    retryable: boolean;
+    httpStatus: number;
+}
+/**
+ * Look up a registry entry by CLEO exit code.
+ *
+ * @task T4671
+ * @epic T4663
+ */
+export declare function getRegistryEntry(exitCode: ExitCode): CleoRegistryEntry | undefined;
+/**
+ * Look up a registry entry by LAFS string code.
+ *
+ * @task T4671
+ * @epic T4663
+ */
+export declare function getRegistryEntryByLafsCode(lafsCode: string): CleoRegistryEntry | undefined;
+/**
+ * Get the full CLEO error registry for conformance testing.
+ *
+ * @task T4671
+ * @epic T4663
+ */
+export declare function getCleoErrorRegistry(): CleoRegistryEntry[];
+/**
+ * Check if a LAFS code is registered in the CLEO error registry.
+ *
+ * @task T4671
+ * @epic T4663
+ */
+export declare function isCleoRegisteredCode(lafsCode: string): boolean;
+//# sourceMappingURL=error-registry.d.ts.map

package/dist/error-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-registry.d.ts","sourceRoot":"","sources":["../src/error-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE/C;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,QAAQ,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAgWD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,iBAAiB,GAAG,SAAS,CAElF;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAE1F;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,IAAI,iBAAiB,EAAE,CAE1D;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE9D"}