@defai.digital/contracts 13.0.3

package/dist/config/v1/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/config/v1/config.ts"],"names":[],"mappings":"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"}

package/dist/config/v1/config.js

@@ -0,0 +1,348 @@
+/**
+ * Configuration Contract V1
+ *
+ * Main configuration schema for AutomatosX.
+ *
+ * Invariants:
+ * - INV-CFG-CON-001: All config types derived from Zod schemas
+ * - INV-CFG-CON-002: Config includes version for migrations
+ */
+import { z } from 'zod';
+import { DATA_DIR_NAME, MEMORY_DB_FILENAME, TRACE_DB_FILENAME, SESSION_DB_FILENAME, TIMEOUT_WORKFLOW_STEP, TIMEOUT_HEALTH_CHECK, TIMEOUT_GRACEFUL_SHUTDOWN, TIMEOUT_FORCE_KILL, TIMEOUT_PROVIDER_DEFAULT, INTERVAL_HEALTH_CHECK, CIRCUIT_RECOVERY_TIMEOUT, RETRY_MAX_DEFAULT, RETRY_DELAY_DEFAULT, } from '../../constants.js';
+// ============================================================================
+// Constants
+// ============================================================================
+/**
+ * Configuration file version for migrations
+ */
+export const CONFIG_VERSION = '1.0.0';
+// ============================================================================
+// Basic Type Schemas
+// ============================================================================
+/**
+ * Log level enum
+ */
+export const LogLevelSchema = z.enum(['debug', 'info', 'warn', 'error', 'silent']);
+/**
+ * Output format enum
+ */
+export const OutputFormatSchema = z.enum(['text', 'json', 'yaml']);
+/**
+ * Config scope enum
+ */
+export const ConfigScopeSchema = z.enum(['global', 'local']);
+/**
+ * Config read scope (includes merged)
+ */
+export const ConfigReadScopeSchema = z.enum(['global', 'local', 'merged']);
+// ============================================================================
+// Provider Configuration Schema (matches old working design)
+// Note: Prefixed with "Config" to avoid conflicts with provider/v1 runtime schemas
+// ============================================================================
+/**
+ * Health check configuration for a provider (config file format)
+ */
+export const ConfigHealthCheckSchema = z.object({
+    enabled: z.boolean().default(true),
+    interval: z.number().int().min(1000).max(3600000).default(300000), // 5 minutes
+    timeout: z.number().int().min(100).max(60000).default(5000),
+});
+/**
+ * Circuit breaker configuration for resilience (config file format)
+ */
+export const ConfigCircuitBreakerSchema = z.object({
+    enabled: z.boolean().default(true),
+    failureThreshold: z.number().int().min(1).max(10).default(3),
+    recoveryTimeout: z.number().int().min(1000).max(600000).default(60000),
+});
+/**
+ * Process management configuration
+ */
+export const ConfigProcessManagementSchema = z.object({
+    gracefulShutdownTimeout: z.number().int().min(1000).max(60000).default(5000),
+    forceKillDelay: z.number().int().min(100).max(10000).default(1000),
+});
+/**
+ * Version detection configuration
+ */
+export const ConfigVersionDetectionSchema = z.object({
+    timeout: z.number().int().min(1000).max(30000).default(5000),
+    forceKillDelay: z.number().int().min(100).max(10000).default(1000),
+    cacheEnabled: z.boolean().default(true),
+});
+/**
+ * Provider limit tracking configuration
+ */
+export const ConfigLimitTrackingSchema = z.object({
+    enabled: z.boolean().default(true),
+    window: z.enum(['daily', 'weekly', 'custom']).default('daily'),
+    resetHourUtc: z.number().int().min(0).max(23).default(0),
+    customResetMs: z.number().int().positive().optional(),
+});
+/**
+ * Provider type enum
+ */
+export const ConfigProviderTypeSchema = z.enum(['cli', 'sdk', 'hybrid']);
+/**
+ * Full provider configuration (matches old working design)
+ * This is a Record<string, ProviderConfig> keyed by provider name
+ */
+export const ProviderConfigSchema = z.object({
+    enabled: z.boolean().default(true),
+    priority: z.number().int().min(1).max(100).default(50),
+    timeout: z.number().int().min(1000).max(7200000).default(2700000), // 45 minutes default
+    type: ConfigProviderTypeSchema.optional(),
+    command: z.string().min(1).optional(), // Optional for SDK providers
+    description: z.string().optional(),
+    model: z.string().optional(),
+    healthCheck: ConfigHealthCheckSchema.optional(),
+    circuitBreaker: ConfigCircuitBreakerSchema.optional(),
+    processManagement: ConfigProcessManagementSchema.optional(),
+    versionDetection: ConfigVersionDetectionSchema.optional(),
+    limitTracking: ConfigLimitTrackingSchema.optional(),
+});
+/**
+ * Providers configuration map (Record keyed by provider name)
+ * This matches the old working design: providers: { "claude-code": {...}, "gemini-cli": {...} }
+ */
+export const ProvidersConfigSchema = z.record(z.string(), ProviderConfigSchema);
+// ============================================================================
+// Execution Policy Schema
+// ============================================================================
+/**
+ * Execution policy configuration
+ */
+export const ExecutionPolicySchema = z.object({
+    defaultTimeoutMs: z.number().int().min(1000).max(600000).default(120000),
+    maxRetries: z.number().int().min(0).max(10).default(3),
+    retryDelayMs: z.number().int().min(100).max(60000).default(1000),
+    enableParallelExecution: z.boolean().default(false),
+});
+// ============================================================================
+// Feature Flags Schema
+// ============================================================================
+/**
+ * Feature flags configuration
+ */
+export const FeatureFlagsSchema = z.object({
+    enableTracing: z.boolean().default(true),
+    enableMemoryPersistence: z.boolean().default(true),
+    enableGuard: z.boolean().default(true),
+    enableMetrics: z.boolean().default(false),
+    experimentalFeatures: z.record(z.string(), z.boolean()).default({}),
+});
+// ============================================================================
+// Workspace Config Schema
+// ============================================================================
+/**
+ * Workspace configuration
+ */
+export const WorkspaceConfigSchema = z.object({
+    rootPath: z.string().optional(),
+    dataDir: z.string().default(DATA_DIR_NAME),
+    memoryDbPath: z.string().default(MEMORY_DB_FILENAME),
+    traceDbPath: z.string().default(TRACE_DB_FILENAME),
+    sessionDbPath: z.string().default(SESSION_DB_FILENAME),
+});
+// ============================================================================
+// User Preferences Schema
+// ============================================================================
+/**
+ * User preferences configuration
+ */
+export const UserPreferencesSchema = z.object({
+    colorOutput: z.boolean().default(true),
+    verboseErrors: z.boolean().default(false),
+    confirmDestructive: z.boolean().default(true),
+    defaultOutputFormat: OutputFormatSchema.default('text'),
+});
+// ============================================================================
+// Main Configuration Schema
+// ============================================================================
+/**
+ * Main AutomatosX configuration
+ */
+export const AutomatosXConfigSchema = z.object({
+    // Metadata
+    version: z.string().default(CONFIG_VERSION),
+    createdAt: z.string().datetime().optional(),
+    updatedAt: z.string().datetime().optional(),
+    // Core settings
+    logLevel: LogLevelSchema.default('info'),
+    telemetryEnabled: z.boolean().default(false),
+    // Provider configuration (Record keyed by provider name - matches old working design)
+    providers: ProvidersConfigSchema.default({}),
+    defaultProvider: z.string().optional(),
+    // Execution settings
+    executionPolicy: ExecutionPolicySchema.default({}),
+    // Feature flags
+    features: FeatureFlagsSchema.default({}),
+    // Workspace settings
+    workspace: WorkspaceConfigSchema.default({}),
+    // User preferences
+    preferences: UserPreferencesSchema.default({}),
+});
+// ============================================================================
+// Validation Functions
+// ============================================================================
+/**
+ * Validates configuration (throws on error)
+ *
+ * INV-CFG-CON-001: All config types derived from Zod schemas
+ */
+export function validateConfig(data) {
+    return AutomatosXConfigSchema.parse(data);
+}
+/**
+ * Safely validates configuration (returns result)
+ */
+export function safeValidateConfig(data) {
+    const result = AutomatosXConfigSchema.safeParse(data);
+    if (result.success) {
+        return { success: true, data: result.data };
+    }
+    return { success: false, error: result.error };
+}
+/**
+ * Validates config and returns array of error messages
+ */
+export function validateConfigWithErrors(data) {
+    const result = AutomatosXConfigSchema.safeParse(data);
+    if (result.success) {
+        return { valid: true, config: result.data };
+    }
+    return {
+        valid: false,
+        errors: result.error.errors.map((e) => `${e.path.join('.')}: ${e.message}`),
+    };
+}
+// ============================================================================
+// Default Configuration
+// ============================================================================
+/**
+ * Default configuration for new installations
+ */
+export const DEFAULT_CONFIG = {
+    version: CONFIG_VERSION,
+    logLevel: 'info',
+    telemetryEnabled: false,
+    providers: {
+        'claude-code': {
+            enabled: true,
+            priority: 3,
+            timeout: TIMEOUT_WORKFLOW_STEP,
+            command: 'claude',
+            healthCheck: {
+                enabled: true,
+                interval: INTERVAL_HEALTH_CHECK,
+                timeout: TIMEOUT_HEALTH_CHECK,
+            },
+            circuitBreaker: {
+                enabled: true,
+                failureThreshold: RETRY_MAX_DEFAULT,
+                recoveryTimeout: CIRCUIT_RECOVERY_TIMEOUT,
+            },
+            processManagement: {
+                gracefulShutdownTimeout: TIMEOUT_GRACEFUL_SHUTDOWN,
+                forceKillDelay: TIMEOUT_FORCE_KILL,
+            },
+            versionDetection: {
+                timeout: TIMEOUT_HEALTH_CHECK,
+                forceKillDelay: TIMEOUT_FORCE_KILL,
+                cacheEnabled: true,
+            },
+            limitTracking: {
+                enabled: true,
+                window: 'weekly',
+                resetHourUtc: 0,
+            },
+        },
+        'gemini-cli': {
+            enabled: true,
+            priority: 2,
+            timeout: TIMEOUT_WORKFLOW_STEP,
+            command: 'gemini',
+            healthCheck: {
+                enabled: true,
+                interval: INTERVAL_HEALTH_CHECK,
+                timeout: TIMEOUT_HEALTH_CHECK,
+            },
+            circuitBreaker: {
+                enabled: true,
+                failureThreshold: RETRY_MAX_DEFAULT,
+                recoveryTimeout: CIRCUIT_RECOVERY_TIMEOUT,
+            },
+            processManagement: {
+                gracefulShutdownTimeout: TIMEOUT_GRACEFUL_SHUTDOWN,
+                forceKillDelay: TIMEOUT_FORCE_KILL,
+            },
+            versionDetection: {
+                timeout: TIMEOUT_HEALTH_CHECK,
+                forceKillDelay: TIMEOUT_FORCE_KILL,
+                cacheEnabled: true,
+            },
+            limitTracking: {
+                enabled: true,
+                window: 'daily',
+                resetHourUtc: 0,
+            },
+        },
+        openai: {
+            enabled: true,
+            priority: 1,
+            timeout: TIMEOUT_WORKFLOW_STEP,
+            command: 'codex',
+            healthCheck: {
+                enabled: true,
+                interval: INTERVAL_HEALTH_CHECK,
+                timeout: TIMEOUT_HEALTH_CHECK,
+            },
+            circuitBreaker: {
+                enabled: true,
+                failureThreshold: RETRY_MAX_DEFAULT,
+                recoveryTimeout: CIRCUIT_RECOVERY_TIMEOUT,
+            },
+            processManagement: {
+                gracefulShutdownTimeout: TIMEOUT_GRACEFUL_SHUTDOWN,
+                forceKillDelay: TIMEOUT_FORCE_KILL,
+            },
+            versionDetection: {
+                timeout: TIMEOUT_HEALTH_CHECK,
+                forceKillDelay: TIMEOUT_FORCE_KILL,
+                cacheEnabled: true,
+            },
+            limitTracking: {
+                enabled: true,
+                window: 'daily',
+                resetHourUtc: 0,
+            },
+        },
+    },
+    defaultProvider: 'claude-code',
+    executionPolicy: {
+        defaultTimeoutMs: TIMEOUT_PROVIDER_DEFAULT,
+        maxRetries: RETRY_MAX_DEFAULT,
+        retryDelayMs: RETRY_DELAY_DEFAULT,
+        enableParallelExecution: false,
+    },
+    features: {
+        enableTracing: true,
+        enableMemoryPersistence: true,
+        enableGuard: true,
+        enableMetrics: false,
+        experimentalFeatures: {},
+    },
+    workspace: {
+        dataDir: DATA_DIR_NAME,
+        memoryDbPath: MEMORY_DB_FILENAME,
+        traceDbPath: TRACE_DB_FILENAME,
+        sessionDbPath: SESSION_DB_FILENAME,
+    },
+    preferences: {
+        colorOutput: true,
+        verboseErrors: false,
+        confirmDestructive: true,
+        defaultOutputFormat: 'text',
+    },
+};
+//# sourceMappingURL=config.js.map

package/dist/config/v1/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/config/v1/config.ts"],"names":[],"mappings":"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"}

package/dist/config/v1/errors.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Configuration Error Codes Contract V1
+ *
+ * Error codes and error class for configuration operations.
+ */
+/**
+ * Configuration error codes
+ */
+export declare const ConfigErrorCode: {
+    readonly CONFIG_NOT_FOUND: "CONFIG_NOT_FOUND";
+    readonly CONFIG_READ_ERROR: "CONFIG_READ_ERROR";
+    readonly CONFIG_WRITE_ERROR: "CONFIG_WRITE_ERROR";
+    readonly CONFIG_PERMISSION_DENIED: "CONFIG_PERMISSION_DENIED";
+    readonly CONFIG_VALIDATION_ERROR: "CONFIG_VALIDATION_ERROR";
+    readonly CONFIG_SCHEMA_MISMATCH: "CONFIG_SCHEMA_MISMATCH";
+    readonly CONFIG_MIGRATION_REQUIRED: "CONFIG_MIGRATION_REQUIRED";
+    readonly CONFIG_MIGRATION_FAILED: "CONFIG_MIGRATION_FAILED";
+    readonly PROVIDER_NOT_DETECTED: "PROVIDER_NOT_DETECTED";
+    readonly PROVIDER_NOT_AUTHENTICATED: "PROVIDER_NOT_AUTHENTICATED";
+    readonly PROVIDER_DETECTION_TIMEOUT: "PROVIDER_DETECTION_TIMEOUT";
+    readonly SETUP_ALREADY_COMPLETE: "SETUP_ALREADY_COMPLETE";
+    readonly SETUP_INCOMPLETE: "SETUP_INCOMPLETE";
+    readonly SETUP_CANCELLED: "SETUP_CANCELLED";
+    readonly CONFIG_INVALID_TRANSITION: "CONFIG_INVALID_TRANSITION";
+    readonly CONFIG_PATH_NOT_FOUND: "CONFIG_PATH_NOT_FOUND";
+    readonly CONFIG_INVALID_VALUE: "CONFIG_INVALID_VALUE";
+};
+export type ConfigErrorCode = (typeof ConfigErrorCode)[keyof typeof ConfigErrorCode];
+/**
+ * Recovery hints for error codes
+ */
+export declare const CONFIG_ERROR_HINTS: Record<ConfigErrorCode, string>;
+/**
+ * Gets recovery hint for an error code
+ */
+export declare function getRecoveryHint(code: ConfigErrorCode): string;
+/**
+ * Configuration error class
+ */
+export declare class ConfigError extends Error {
+    readonly code: ConfigErrorCode;
+    readonly details: Record<string, unknown> | undefined;
+    readonly recoveryHint: string;
+    constructor(code: ConfigErrorCode, message: string, details?: Record<string, unknown>);
+    /**
+     * Converts error to JSON-serializable object
+     */
+    toJSON(): {
+        name: string;
+        code: ConfigErrorCode;
+        message: string;
+        recoveryHint: string;
+        details: Record<string, unknown> | undefined;
+    };
+}
+/**
+ * Creates a CONFIG_NOT_FOUND error
+ */
+export declare function configNotFoundError(path?: string): ConfigError;
+/**
+ * Creates a CONFIG_VALIDATION_ERROR error
+ */
+export declare function configValidationError(errors: string[]): ConfigError;
+/**
+ * Creates a PROVIDER_NOT_DETECTED error
+ */
+export declare function providerNotDetectedError(providerId: string): ConfigError;
+/**
+ * Creates a PROVIDER_NOT_AUTHENTICATED error
+ */
+export declare function providerNotAuthenticatedError(providerId: string): ConfigError;
+/**
+ * Creates a CONFIG_INVALID_TRANSITION error
+ */
+export declare function configInvalidTransitionError(from: string, to: string): ConfigError;
+/**
+ * Creates a CONFIG_PATH_NOT_FOUND error
+ */
+export declare function configPathNotFoundError(path: string): ConfigError;
+/**
+ * Type guard for ConfigError
+ */
+export declare function isConfigError(error: unknown): error is ConfigError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/config/v1/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/config/v1/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;CA+BlB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,OAAO,eAAe,CAAC,CAAC;AAMrF;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,eAAe,EAAE,MAAM,CAkB9D,CAAC;AAEF;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAE7D;AAMD;;GAEG;AACH,qBAAa,WAAY,SAAQ,KAAK;IACpC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IACtD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;gBAG5B,IAAI,EAAE,eAAe,EACrB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAcnC;;OAEG;IACH,MAAM,IAAI;QACR,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,eAAe,CAAC;QACtB,OAAO,EAAE,MAAM,CAAC;QAChB,YAAY,EAAE,MAAM,CAAC;QACrB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;KAC9C;CASF;AAMD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,WAAW,CAQ9D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,WAAW,CAMnE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,MAAM,GAAG,WAAW,CAMxE;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,UAAU,EAAE,MAAM,GAAG,WAAW,CAM7E;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,GACT,WAAW,CAMb;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAMjE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAElE"}

package/dist/config/v1/errors.js

@@ -0,0 +1,150 @@
+/**
+ * Configuration Error Codes Contract V1
+ *
+ * Error codes and error class for configuration operations.
+ */
+// ============================================================================
+// Error Codes
+// ============================================================================
+/**
+ * Configuration error codes
+ */
+export const ConfigErrorCode = {
+    // File operations
+    CONFIG_NOT_FOUND: 'CONFIG_NOT_FOUND',
+    CONFIG_READ_ERROR: 'CONFIG_READ_ERROR',
+    CONFIG_WRITE_ERROR: 'CONFIG_WRITE_ERROR',
+    CONFIG_PERMISSION_DENIED: 'CONFIG_PERMISSION_DENIED',
+    // Validation
+    CONFIG_VALIDATION_ERROR: 'CONFIG_VALIDATION_ERROR',
+    CONFIG_SCHEMA_MISMATCH: 'CONFIG_SCHEMA_MISMATCH',
+    // Migration
+    CONFIG_MIGRATION_REQUIRED: 'CONFIG_MIGRATION_REQUIRED',
+    CONFIG_MIGRATION_FAILED: 'CONFIG_MIGRATION_FAILED',
+    // Provider
+    PROVIDER_NOT_DETECTED: 'PROVIDER_NOT_DETECTED',
+    PROVIDER_NOT_AUTHENTICATED: 'PROVIDER_NOT_AUTHENTICATED',
+    PROVIDER_DETECTION_TIMEOUT: 'PROVIDER_DETECTION_TIMEOUT',
+    // Setup
+    SETUP_ALREADY_COMPLETE: 'SETUP_ALREADY_COMPLETE',
+    SETUP_INCOMPLETE: 'SETUP_INCOMPLETE',
+    SETUP_CANCELLED: 'SETUP_CANCELLED',
+    // State machine
+    CONFIG_INVALID_TRANSITION: 'CONFIG_INVALID_TRANSITION',
+    // Operations
+    CONFIG_PATH_NOT_FOUND: 'CONFIG_PATH_NOT_FOUND',
+    CONFIG_INVALID_VALUE: 'CONFIG_INVALID_VALUE',
+};
+// ============================================================================
+// Error Recovery Hints
+// ============================================================================
+/**
+ * Recovery hints for error codes
+ */
+export const CONFIG_ERROR_HINTS = {
+    CONFIG_NOT_FOUND: 'Run `ax setup` to create configuration',
+    CONFIG_READ_ERROR: 'Check file permissions and JSON syntax',
+    CONFIG_WRITE_ERROR: 'Check write permissions on config directory',
+    CONFIG_PERMISSION_DENIED: 'Check permissions on ~/.automatosx/ or run with appropriate privileges',
+    CONFIG_VALIDATION_ERROR: 'Run `ax config reset` to restore defaults or fix the configuration manually',
+    CONFIG_SCHEMA_MISMATCH: 'Config version mismatch - run `ax setup --force` to recreate',
+    CONFIG_MIGRATION_REQUIRED: 'Run `ax setup` to migrate configuration to latest version',
+    CONFIG_MIGRATION_FAILED: 'Backup config and run `ax config reset` to start fresh',
+    PROVIDER_NOT_DETECTED: 'Install provider CLI: e.g., `npm install -g @anthropic/claude-cli`',
+    PROVIDER_NOT_AUTHENTICATED: 'Run provider auth: e.g., `claude auth login`',
+    PROVIDER_DETECTION_TIMEOUT: 'Provider CLI is slow to respond - try again or check CLI installation',
+    SETUP_ALREADY_COMPLETE: 'Configuration exists - use `ax setup --force` to reconfigure',
+    SETUP_INCOMPLETE: 'Run `ax setup` to complete configuration',
+    SETUP_CANCELLED: 'Setup was cancelled - run `ax setup` to try again',
+    CONFIG_INVALID_TRANSITION: 'Invalid operation for current config state',
+    CONFIG_PATH_NOT_FOUND: 'The specified configuration path does not exist',
+    CONFIG_INVALID_VALUE: 'The provided value is invalid for this configuration path',
+};
+/**
+ * Gets recovery hint for an error code
+ */
+export function getRecoveryHint(code) {
+    return CONFIG_ERROR_HINTS[code];
+}
+// ============================================================================
+// Error Class
+// ============================================================================
+/**
+ * Configuration error class
+ */
+export class ConfigError extends Error {
+    code;
+    details;
+    recoveryHint;
+    constructor(code, message, details) {
+        super(message);
+        this.name = 'ConfigError';
+        this.code = code;
+        this.details = details ?? undefined;
+        this.recoveryHint = CONFIG_ERROR_HINTS[code];
+        // Maintains proper stack trace for where error was thrown (V8)
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, ConfigError);
+        }
+    }
+    /**
+     * Converts error to JSON-serializable object
+     */
+    toJSON() {
+        return {
+            name: this.name,
+            code: this.code,
+            message: this.message,
+            recoveryHint: this.recoveryHint,
+            details: this.details,
+        };
+    }
+}
+// ============================================================================
+// Error Factory Functions
+// ============================================================================
+/**
+ * Creates a CONFIG_NOT_FOUND error
+ */
+export function configNotFoundError(path) {
+    return new ConfigError(ConfigErrorCode.CONFIG_NOT_FOUND, path !== undefined
+        ? `Configuration file not found: ${path}`
+        : 'Configuration file not found', path !== undefined ? { path } : undefined);
+}
+/**
+ * Creates a CONFIG_VALIDATION_ERROR error
+ */
+export function configValidationError(errors) {
+    return new ConfigError(ConfigErrorCode.CONFIG_VALIDATION_ERROR, `Configuration validation failed: ${errors.join(', ')}`, { errors });
+}
+/**
+ * Creates a PROVIDER_NOT_DETECTED error
+ */
+export function providerNotDetectedError(providerId) {
+    return new ConfigError(ConfigErrorCode.PROVIDER_NOT_DETECTED, `Provider CLI not detected: ${providerId}`, { providerId });
+}
+/**
+ * Creates a PROVIDER_NOT_AUTHENTICATED error
+ */
+export function providerNotAuthenticatedError(providerId) {
+    return new ConfigError(ConfigErrorCode.PROVIDER_NOT_AUTHENTICATED, `Provider not authenticated: ${providerId}`, { providerId });
+}
+/**
+ * Creates a CONFIG_INVALID_TRANSITION error
+ */
+export function configInvalidTransitionError(from, to) {
+    return new ConfigError(ConfigErrorCode.CONFIG_INVALID_TRANSITION, `Invalid state transition from '${from}' to '${to}'`, { from, to });
+}
+/**
+ * Creates a CONFIG_PATH_NOT_FOUND error
+ */
+export function configPathNotFoundError(path) {
+    return new ConfigError(ConfigErrorCode.CONFIG_PATH_NOT_FOUND, `Configuration path not found: ${path}`, { path });
+}
+/**
+ * Type guard for ConfigError
+ */
+export function isConfigError(error) {
+    return error instanceof ConfigError;
+}
+//# sourceMappingURL=errors.js.map

package/dist/config/v1/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/config/v1/errors.ts"],"names":[],"mappings":"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"}