claude-flow-novice 2.15.2 → 2.15.4

package/dist/lib/completion-signal-handler.js

@@ -0,0 +1,243 @@
+/**
+ * Completion Signal Handler
+ *
+ * Provides reliable completion signaling for agent-coordinator communication.
+ * Part of Task 2.1: Persistent Agent Output Workspace (Integration)
+ *
+ * Signal File Format:
+ *   COMPLETION_SIGNAL.json
+ *   {
+ *     "success": true,
+ *     "confidence": 0.85,
+ *     "deliverables": ["file1.ts", "file2.ts"],
+ *     "errors": [],
+ *     "metrics": { "executionTimeMs": 5420 },
+ *     "timestamp": "2025-01-15T10:30:00.000Z",
+ *     "agentId": "agent-123",
+ *     "taskId": "task-456"
+ *   }
+ *
+ * Usage:
+ *   // Agent writes completion signal
+ *   await writeCompletionSignal(workspace, {
+ *     success: true,
+ *     confidence: 0.85,
+ *     deliverables: ['file.ts'],
+ *     taskId: 'task-123',
+ *     agentId: 'agent-456',
+ *     timestamp: new Date()
+ *   });
+ *
+ *   // Coordinator polls for completion
+ *   const signal = await pollForCompletion(workspace, 300000);
+ */ import * as path from 'path';
+import { atomicWrite } from './file-operations.js';
+import { createLogger } from './logging.js';
+import { createError, ErrorCode, createTimeoutError } from './errors.js';
+const logger = createLogger('completion-signal-handler');
+/**
+ * Completion signal file name
+ */ const COMPLETION_SIGNAL_FILE = 'COMPLETION_SIGNAL.json';
+/**
+ * Default poll options
+ */ const DEFAULT_POLL_OPTIONS = {
+    timeoutMs: 300000,
+    intervalMs: 500
+};
+/**
+ * Write completion signal to workspace
+ *
+ * Pattern: Atomic write ensures signal is never partially written
+ *
+ * @param workspace - Workspace path information
+ * @param signal - Completion signal data
+ * @returns Promise that resolves when signal is written
+ * @throws FILE_WRITE_FAILED if write fails
+ */ export async function writeCompletionSignal(workspace, signal) {
+    // Validate signal
+    validateSignal(signal);
+    const signalPath = path.join(workspace.path, COMPLETION_SIGNAL_FILE);
+    // Prepare signal data (convert Date to ISO string for JSON)
+    const signalData = {
+        ...signal,
+        timestamp: signal.timestamp.toISOString()
+    };
+    try {
+        await atomicWrite(signalPath, JSON.stringify(signalData, null, 2));
+        logger.info('Completion signal written', {
+            taskId: workspace.taskId,
+            agentId: workspace.agentId,
+            success: signal.success,
+            confidence: signal.confidence
+        });
+    } catch (error) {
+        throw createError(ErrorCode.FILE_WRITE_FAILED, 'Failed to write completion signal', {
+            taskId: workspace.taskId,
+            agentId: workspace.agentId,
+            error: error.message
+        });
+    }
+}
+/**
+ * Read completion signal from workspace
+ *
+ * @param workspace - Workspace path information
+ * @returns Completion signal data or null if not found
+ * @throws FILE_READ_FAILED if read fails (other than ENOENT)
+ */ export async function readCompletionSignal(workspace) {
+    const signalPath = path.join(workspace.path, COMPLETION_SIGNAL_FILE);
+    try {
+        const fs = await import('fs/promises');
+        const content = await fs.readFile(signalPath, 'utf8');
+        const signalData = JSON.parse(content);
+        // Convert ISO string back to Date
+        return {
+            ...signalData,
+            timestamp: new Date(signalData.timestamp)
+        };
+    } catch (error) {
+        const err = error;
+        if (err.code === 'ENOENT') {
+            // Signal file doesn't exist yet
+            return null;
+        }
+        throw createError(ErrorCode.FILE_READ_FAILED, 'Failed to read completion signal', {
+            taskId: workspace.taskId,
+            agentId: workspace.agentId,
+            error: error.message
+        });
+    }
+}
+/**
+ * Poll for completion signal with timeout
+ *
+ * Pattern: Non-blocking polling with configurable interval and timeout
+ *
+ * @param workspace - Workspace path information
+ * @param timeoutMs - Timeout in milliseconds (default: 300000 = 5 minutes)
+ * @param options - Poll options
+ * @returns Completion signal data
+ * @throws TIMEOUT if signal not received within timeout
+ * @throws FILE_READ_FAILED if read fails
+ */ export async function pollForCompletion(workspace, timeoutMs, options = {}) {
+    const pollOptions = {
+        ...DEFAULT_POLL_OPTIONS,
+        ...timeoutMs !== undefined ? {
+            timeoutMs
+        } : {},
+        ...options
+    };
+    const startTime = Date.now();
+    const endTime = startTime + pollOptions.timeoutMs;
+    logger.debug('Starting completion polling', {
+        taskId: workspace.taskId,
+        agentId: workspace.agentId,
+        timeoutMs: pollOptions.timeoutMs,
+        intervalMs: pollOptions.intervalMs
+    });
+    while(Date.now() < endTime){
+        // Try to read signal
+        const signal = await readCompletionSignal(workspace);
+        if (signal) {
+            const elapsedMs = Date.now() - startTime;
+            logger.info('Completion signal received', {
+                taskId: workspace.taskId,
+                agentId: workspace.agentId,
+                success: signal.success,
+                confidence: signal.confidence,
+                elapsedMs
+            });
+            return signal;
+        }
+        // Wait before next poll
+        await sleep(pollOptions.intervalMs);
+    }
+    // Timeout reached
+    const elapsedMs = Date.now() - startTime;
+    throw createTimeoutError('Completion signal timeout', pollOptions.timeoutMs, {
+        taskId: workspace.taskId,
+        agentId: workspace.agentId,
+        elapsedMs
+    });
+}
+/**
+ * Check if completion signal exists
+ *
+ * @param workspace - Workspace path information
+ * @returns True if signal exists, false otherwise
+ */ export async function hasCompletionSignal(workspace) {
+    const signal = await readCompletionSignal(workspace);
+    return signal !== null;
+}
+/**
+ * Delete completion signal
+ *
+ * Useful for resetting workspace state.
+ *
+ * @param workspace - Workspace path information
+ * @returns Promise that resolves when signal is deleted
+ */ export async function deleteCompletionSignal(workspace) {
+    const signalPath = path.join(workspace.path, COMPLETION_SIGNAL_FILE);
+    try {
+        const fs = await import('fs/promises');
+        await fs.unlink(signalPath);
+        logger.debug('Completion signal deleted', {
+            taskId: workspace.taskId,
+            agentId: workspace.agentId
+        });
+    } catch (error) {
+        const err = error;
+        if (err.code === 'ENOENT') {
+            // Signal file doesn't exist, nothing to delete
+            return;
+        }
+        throw error;
+    }
+}
+/**
+ * Validate completion signal data
+ *
+ * @param signal - Completion signal to validate
+ * @throws INVALID_INPUT if signal is invalid
+ */ function validateSignal(signal) {
+    if (typeof signal.success !== 'boolean') {
+        throw createError(ErrorCode.INVALID_INPUT, 'Signal success must be a boolean', {
+            signal
+        });
+    }
+    if (typeof signal.confidence !== 'number' || signal.confidence < 0 || signal.confidence > 1) {
+        throw createError(ErrorCode.INVALID_INPUT, 'Signal confidence must be a number between 0 and 1', {
+            signal
+        });
+    }
+    if (!Array.isArray(signal.deliverables)) {
+        throw createError(ErrorCode.INVALID_INPUT, 'Signal deliverables must be an array', {
+            signal
+        });
+    }
+    if (!signal.taskId || typeof signal.taskId !== 'string') {
+        throw createError(ErrorCode.INVALID_INPUT, 'Signal taskId must be a non-empty string', {
+            signal
+        });
+    }
+    if (!signal.agentId || typeof signal.agentId !== 'string') {
+        throw createError(ErrorCode.INVALID_INPUT, 'Signal agentId must be a non-empty string', {
+            signal
+        });
+    }
+    if (!(signal.timestamp instanceof Date)) {
+        throw createError(ErrorCode.INVALID_INPUT, 'Signal timestamp must be a Date object', {
+            signal
+        });
+    }
+}
+/**
+ * Sleep for specified duration
+ *
+ * @param ms - Duration in milliseconds
+ * @returns Promise that resolves after duration
+ */ function sleep(ms) {
+    return new Promise((resolve)=>setTimeout(resolve, ms));
+}
+
+//# sourceMappingURL=completion-signal-handler.js.map

package/dist/lib/completion-signal-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/completion-signal-handler.ts"],"sourcesContent":["/**\r\n * Completion Signal Handler\r\n *\r\n * Provides reliable completion signaling for agent-coordinator communication.\r\n * Part of Task 2.1: Persistent Agent Output Workspace (Integration)\r\n *\r\n * Signal File Format:\r\n *   COMPLETION_SIGNAL.json\r\n *   {\r\n *     \"success\": true,\r\n *     \"confidence\": 0.85,\r\n *     \"deliverables\": [\"file1.ts\", \"file2.ts\"],\r\n *     \"errors\": [],\r\n *     \"metrics\": { \"executionTimeMs\": 5420 },\r\n *     \"timestamp\": \"2025-01-15T10:30:00.000Z\",\r\n *     \"agentId\": \"agent-123\",\r\n *     \"taskId\": \"task-456\"\r\n *   }\r\n *\r\n * Usage:\r\n *   // Agent writes completion signal\r\n *   await writeCompletionSignal(workspace, {\r\n *     success: true,\r\n *     confidence: 0.85,\r\n *     deliverables: ['file.ts'],\r\n *     taskId: 'task-123',\r\n *     agentId: 'agent-456',\r\n *     timestamp: new Date()\r\n *   });\r\n *\r\n *   // Coordinator polls for completion\r\n *   const signal = await pollForCompletion(workspace, 300000);\r\n */\r\n\r\nimport * as path from 'path';\r\nimport { atomicWrite } from './file-operations.js';\r\nimport { createLogger } from './logging.js';\r\nimport { createError, ErrorCode, createTimeoutError } from './errors.js';\r\nimport { WorkspacePath } from './agent-workspace.js';\r\n\r\nconst logger = createLogger('completion-signal-handler');\r\n\r\n/**\r\n * Completion signal file name\r\n */\r\nconst COMPLETION_SIGNAL_FILE = 'COMPLETION_SIGNAL.json';\r\n\r\n/**\r\n * Completion metadata (partial, provided by caller)\r\n */\r\nexport interface CompletionMetadata {\r\n  /** Whether the task completed successfully */\r\n  success: boolean;\r\n  /** Agent confidence score (0.0 - 1.0) */\r\n  confidence: number;\r\n  /** List of deliverable file paths */\r\n  deliverables: string[];\r\n  /** List of errors encountered (optional) */\r\n  errors?: string[];\r\n  /** Performance metrics (optional) */\r\n  metrics?: {\r\n    executionTimeMs?: number;\r\n    tokensUsed?: number;\r\n    costUsd?: number;\r\n    [key: string]: any;\r\n  };\r\n}\r\n\r\n/**\r\n * Complete completion signal (written to file)\r\n */\r\nexport interface CompletionSignal extends CompletionMetadata {\r\n  /** Task ID */\r\n  taskId: string;\r\n  /** Agent ID */\r\n  agentId: string;\r\n  /** Signal timestamp */\r\n  timestamp: Date;\r\n}\r\n\r\n/**\r\n * Poll options\r\n */\r\nexport interface PollOptions {\r\n  /** Timeout in milliseconds (default: 300000 = 5 minutes) */\r\n  timeoutMs?: number;\r\n  /** Poll interval in milliseconds (default: 500) */\r\n  intervalMs?: number;\r\n}\r\n\r\n/**\r\n * Default poll options\r\n */\r\nconst DEFAULT_POLL_OPTIONS: Required<PollOptions> = {\r\n  timeoutMs: 300000, // 5 minutes\r\n  intervalMs: 500, // 500ms\r\n};\r\n\r\n/**\r\n * Write completion signal to workspace\r\n *\r\n * Pattern: Atomic write ensures signal is never partially written\r\n *\r\n * @param workspace - Workspace path information\r\n * @param signal - Completion signal data\r\n * @returns Promise that resolves when signal is written\r\n * @throws FILE_WRITE_FAILED if write fails\r\n */\r\nexport async function writeCompletionSignal(\r\n  workspace: WorkspacePath,\r\n  signal: CompletionSignal\r\n): Promise<void> {\r\n  // Validate signal\r\n  validateSignal(signal);\r\n\r\n  const signalPath = path.join(workspace.path, COMPLETION_SIGNAL_FILE);\r\n\r\n  // Prepare signal data (convert Date to ISO string for JSON)\r\n  const signalData = {\r\n    ...signal,\r\n    timestamp: signal.timestamp.toISOString(),\r\n  };\r\n\r\n  try {\r\n    await atomicWrite(signalPath, JSON.stringify(signalData, null, 2));\r\n    logger.info('Completion signal written', {\r\n      taskId: workspace.taskId,\r\n      agentId: workspace.agentId,\r\n      success: signal.success,\r\n      confidence: signal.confidence,\r\n    });\r\n  } catch (error) {\r\n    throw createError(\r\n      ErrorCode.FILE_WRITE_FAILED,\r\n      'Failed to write completion signal',\r\n      {\r\n        taskId: workspace.taskId,\r\n        agentId: workspace.agentId,\r\n        error: (error as Error).message,\r\n      }\r\n    );\r\n  }\r\n}\r\n\r\n/**\r\n * Read completion signal from workspace\r\n *\r\n * @param workspace - Workspace path information\r\n * @returns Completion signal data or null if not found\r\n * @throws FILE_READ_FAILED if read fails (other than ENOENT)\r\n */\r\nexport async function readCompletionSignal(\r\n  workspace: WorkspacePath\r\n): Promise<CompletionSignal | null> {\r\n  const signalPath = path.join(workspace.path, COMPLETION_SIGNAL_FILE);\r\n\r\n  try {\r\n    const fs = await import('fs/promises');\r\n    const content = await fs.readFile(signalPath, 'utf8');\r\n    const signalData = JSON.parse(content);\r\n\r\n    // Convert ISO string back to Date\r\n    return {\r\n      ...signalData,\r\n      timestamp: new Date(signalData.timestamp),\r\n    };\r\n  } catch (error) {\r\n    const err = error as NodeJS.ErrnoException;\r\n    if (err.code === 'ENOENT') {\r\n      // Signal file doesn't exist yet\r\n      return null;\r\n    }\r\n    throw createError(\r\n      ErrorCode.FILE_READ_FAILED,\r\n      'Failed to read completion signal',\r\n      {\r\n        taskId: workspace.taskId,\r\n        agentId: workspace.agentId,\r\n        error: (error as Error).message,\r\n      }\r\n    );\r\n  }\r\n}\r\n\r\n/**\r\n * Poll for completion signal with timeout\r\n *\r\n * Pattern: Non-blocking polling with configurable interval and timeout\r\n *\r\n * @param workspace - Workspace path information\r\n * @param timeoutMs - Timeout in milliseconds (default: 300000 = 5 minutes)\r\n * @param options - Poll options\r\n * @returns Completion signal data\r\n * @throws TIMEOUT if signal not received within timeout\r\n * @throws FILE_READ_FAILED if read fails\r\n */\r\nexport async function pollForCompletion(\r\n  workspace: WorkspacePath,\r\n  timeoutMs?: number,\r\n  options: PollOptions = {}\r\n): Promise<CompletionSignal> {\r\n  const pollOptions = {\r\n    ...DEFAULT_POLL_OPTIONS,\r\n    ...(timeoutMs !== undefined ? { timeoutMs } : {}),\r\n    ...options,\r\n  };\r\n\r\n  const startTime = Date.now();\r\n  const endTime = startTime + pollOptions.timeoutMs;\r\n\r\n  logger.debug('Starting completion polling', {\r\n    taskId: workspace.taskId,\r\n    agentId: workspace.agentId,\r\n    timeoutMs: pollOptions.timeoutMs,\r\n    intervalMs: pollOptions.intervalMs,\r\n  });\r\n\r\n  while (Date.now() < endTime) {\r\n    // Try to read signal\r\n    const signal = await readCompletionSignal(workspace);\r\n    if (signal) {\r\n      const elapsedMs = Date.now() - startTime;\r\n      logger.info('Completion signal received', {\r\n        taskId: workspace.taskId,\r\n        agentId: workspace.agentId,\r\n        success: signal.success,\r\n        confidence: signal.confidence,\r\n        elapsedMs,\r\n      });\r\n      return signal;\r\n    }\r\n\r\n    // Wait before next poll\r\n    await sleep(pollOptions.intervalMs);\r\n  }\r\n\r\n  // Timeout reached\r\n  const elapsedMs = Date.now() - startTime;\r\n  throw createTimeoutError(\r\n    'Completion signal timeout',\r\n    pollOptions.timeoutMs,\r\n    {\r\n      taskId: workspace.taskId,\r\n      agentId: workspace.agentId,\r\n      elapsedMs,\r\n    }\r\n  );\r\n}\r\n\r\n/**\r\n * Check if completion signal exists\r\n *\r\n * @param workspace - Workspace path information\r\n * @returns True if signal exists, false otherwise\r\n */\r\nexport async function hasCompletionSignal(\r\n  workspace: WorkspacePath\r\n): Promise<boolean> {\r\n  const signal = await readCompletionSignal(workspace);\r\n  return signal !== null;\r\n}\r\n\r\n/**\r\n * Delete completion signal\r\n *\r\n * Useful for resetting workspace state.\r\n *\r\n * @param workspace - Workspace path information\r\n * @returns Promise that resolves when signal is deleted\r\n */\r\nexport async function deleteCompletionSignal(\r\n  workspace: WorkspacePath\r\n): Promise<void> {\r\n  const signalPath = path.join(workspace.path, COMPLETION_SIGNAL_FILE);\r\n\r\n  try {\r\n    const fs = await import('fs/promises');\r\n    await fs.unlink(signalPath);\r\n    logger.debug('Completion signal deleted', {\r\n      taskId: workspace.taskId,\r\n      agentId: workspace.agentId,\r\n    });\r\n  } catch (error) {\r\n    const err = error as NodeJS.ErrnoException;\r\n    if (err.code === 'ENOENT') {\r\n      // Signal file doesn't exist, nothing to delete\r\n      return;\r\n    }\r\n    throw error;\r\n  }\r\n}\r\n\r\n/**\r\n * Validate completion signal data\r\n *\r\n * @param signal - Completion signal to validate\r\n * @throws INVALID_INPUT if signal is invalid\r\n */\r\nfunction validateSignal(signal: CompletionSignal): void {\r\n  if (typeof signal.success !== 'boolean') {\r\n    throw createError(\r\n      ErrorCode.INVALID_INPUT,\r\n      'Signal success must be a boolean',\r\n      { signal }\r\n    );\r\n  }\r\n\r\n  if (\r\n    typeof signal.confidence !== 'number' ||\r\n    signal.confidence < 0 ||\r\n    signal.confidence > 1\r\n  ) {\r\n    throw createError(\r\n      ErrorCode.INVALID_INPUT,\r\n      'Signal confidence must be a number between 0 and 1',\r\n      { signal }\r\n    );\r\n  }\r\n\r\n  if (!Array.isArray(signal.deliverables)) {\r\n    throw createError(\r\n      ErrorCode.INVALID_INPUT,\r\n      'Signal deliverables must be an array',\r\n      { signal }\r\n    );\r\n  }\r\n\r\n  if (!signal.taskId || typeof signal.taskId !== 'string') {\r\n    throw createError(\r\n      ErrorCode.INVALID_INPUT,\r\n      'Signal taskId must be a non-empty string',\r\n      { signal }\r\n    );\r\n  }\r\n\r\n  if (!signal.agentId || typeof signal.agentId !== 'string') {\r\n    throw createError(\r\n      ErrorCode.INVALID_INPUT,\r\n      'Signal agentId must be a non-empty string',\r\n      { signal }\r\n    );\r\n  }\r\n\r\n  if (!(signal.timestamp instanceof Date)) {\r\n    throw createError(\r\n      ErrorCode.INVALID_INPUT,\r\n      'Signal timestamp must be a Date object',\r\n      { signal }\r\n    );\r\n  }\r\n}\r\n\r\n/**\r\n * Sleep for specified duration\r\n *\r\n * @param ms - Duration in milliseconds\r\n * @returns Promise that resolves after duration\r\n */\r\nfunction sleep(ms: number): Promise<void> {\r\n  return new Promise((resolve) => setTimeout(resolve, ms));\r\n}\r\n"],"names":["path","atomicWrite","createLogger","createError","ErrorCode","createTimeoutError","logger","COMPLETION_SIGNAL_FILE","DEFAULT_POLL_OPTIONS","timeoutMs","intervalMs","writeCompletionSignal","workspace","signal","validateSignal","signalPath","join","signalData","timestamp","toISOString","JSON","stringify","info","taskId","agentId","success","confidence","error","FILE_WRITE_FAILED","message","readCompletionSignal","fs","content","readFile","parse","Date","err","code","FILE_READ_FAILED","pollForCompletion","options","pollOptions","undefined","startTime","now","endTime","debug","elapsedMs","sleep","hasCompletionSignal","deleteCompletionSignal","unlink","INVALID_INPUT","Array","isArray","deliverables","ms","Promise","resolve","setTimeout"],"mappings":"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"}

package/dist/lib/config-manager.js

@@ -0,0 +1,312 @@
+/**
+ * Configuration Manager v2
+ * YAML-based configuration management with hot reload and migration support
+ *
+ * @version 2.0.0
+ * @description Standardized configuration management for CFN
+ */ import * as fs from 'fs/promises';
+import * as path from 'path';
+import * as yaml from 'js-yaml';
+import Ajv from 'ajv';
+import { EventEmitter } from 'events';
+import * as chokidar from 'chokidar';
+/**
+ * ConfigManager - Type-safe YAML configuration management
+ */ export class ConfigManager extends EventEmitter {
+    config = {};
+    configPath;
+    schemaPath;
+    ajv;
+    watcher = null;
+    environment = 'default';
+    options;
+    constructor(configPath, schemaPath, options = {}){
+        super();
+        this.configPath = configPath;
+        this.schemaPath = schemaPath;
+        this.ajv = new Ajv({
+            allErrors: true,
+            strict: false
+        });
+        this.options = {
+            enableHotReload: false,
+            validateOnLoad: true,
+            coerceTypes: true,
+            ...options
+        };
+    }
+    /**
+   * Load configuration from file
+   */ async load(environment = 'default') {
+        this.environment = environment;
+        try {
+            // Load base configuration
+            const baseConfig = await this.loadConfigFile(this.configPath);
+            // Load environment-specific overrides if not default
+            let envConfig = {};
+            if (environment !== 'default') {
+                const envPath = this.getEnvironmentConfigPath(environment);
+                try {
+                    envConfig = await this.loadConfigFile(envPath);
+                } catch (error) {
+                    // Environment override file doesn't exist - that's okay
+                    this.emit('warning', `Environment config not found: ${envPath}`);
+                }
+            }
+            // Merge configurations (environment overrides base)
+            this.config = this.deepMerge(baseConfig, envConfig);
+            // Type coercion if enabled
+            if (this.options.coerceTypes) {
+                this.config = this.coerceTypes(this.config);
+            }
+            // Validate against schema
+            if (this.options.validateOnLoad) {
+                await this.validate();
+            }
+            this.emit('loaded', this.config);
+        } catch (error) {
+            if (error instanceof Error) {
+                throw new Error(`Failed to load configuration: ${error.message}`);
+            }
+            throw error;
+        }
+    }
+    /**
+   * Load configuration from YAML or JSON file
+   */ async loadConfigFile(filePath) {
+        const content = await fs.readFile(filePath, 'utf-8');
+        const ext = path.extname(filePath).toLowerCase();
+        try {
+            if (ext === '.yml' || ext === '.yaml') {
+                return yaml.load(content);
+            } else if (ext === '.json') {
+                this.emit('warning', `JSON format is deprecated. Please migrate to YAML: ${filePath}`);
+                return JSON.parse(content);
+            } else {
+                throw new Error(`Unsupported configuration format: ${ext}`);
+            }
+        } catch (error) {
+            if (error instanceof yaml.YAMLException) {
+                throw new Error(`YAML parsing error: ${error.message}`);
+            }
+            throw error;
+        }
+    }
+    /**
+   * Get environment-specific config path
+   */ getEnvironmentConfigPath(environment) {
+        const dir = path.dirname(this.configPath);
+        const ext = path.extname(this.configPath);
+        return path.join(dir, `${environment}${ext}`);
+    }
+    /**
+   * Validate configuration against JSON schema
+   */ async validate() {
+        const schemaContent = await fs.readFile(this.schemaPath, 'utf-8');
+        const schema = JSON.parse(schemaContent);
+        const validate = this.ajv.compile(schema);
+        const valid = validate(this.config);
+        if (!valid) {
+            const errors = validate.errors?.map((err)=>`${err.instancePath} ${err.message}`).join(', ');
+            throw new Error(`Configuration schema validation failed: ${errors}`);
+        }
+    }
+    /**
+   * Coerce types from strings to proper types
+   */ coerceTypes(obj, parentKey) {
+        if (obj === null || obj === undefined) {
+            return obj;
+        }
+        if (Array.isArray(obj)) {
+            return obj.map((item)=>this.coerceTypes(item));
+        }
+        if (typeof obj === 'object') {
+            const coerced = {};
+            for (const [key, value] of Object.entries(obj)){
+                coerced[key] = this.coerceTypes(value, key);
+            }
+            return coerced;
+        }
+        if (typeof obj === 'string') {
+            // Don't coerce 'version' fields - keep as strings
+            if (parentKey === 'version') {
+                return obj;
+            }
+            // Boolean coercion (case insensitive)
+            const lower = obj.toLowerCase();
+            if (lower === 'true') return true;
+            if (lower === 'false') return false;
+            // Null coercion
+            if (lower === 'null') return null;
+            // Number coercion - only if it looks like a pure number
+            // Don't coerce version strings like "1.0", "2.5.0"
+            if (/^-?\d+$/.test(obj)) {
+                return parseInt(obj, 10);
+            }
+            if (/^-?\d+\.\d+$/.test(obj) && !obj.match(/\d+\.\d+\.\d+/)) {
+                return parseFloat(obj);
+            }
+        }
+        return obj;
+    }
+    /**
+   * Deep merge two objects
+   */ deepMerge(target, source) {
+        if (!source) return target;
+        if (!target) return source;
+        const output = {
+            ...target
+        };
+        for(const key in source){
+            if (source.hasOwnProperty(key)) {
+                if (typeof source[key] === 'object' && source[key] !== null && !Array.isArray(source[key])) {
+                    if (key in output) {
+                        output[key] = this.deepMerge(output[key], source[key]);
+                    } else {
+                        output[key] = source[key];
+                    }
+                } else {
+                    output[key] = source[key];
+                }
+            }
+        }
+        return output;
+    }
+    /**
+   * Get configuration value by key path
+   */ get(keyPath, defaultValue) {
+        const keys = keyPath.split('.');
+        let value = this.config;
+        for (const key of keys){
+            if (value && typeof value === 'object' && key in value) {
+                value = value[key];
+            } else {
+                return defaultValue;
+            }
+        }
+        return value;
+    }
+    /**
+   * Get all configuration
+   */ getAll() {
+        return {
+            ...this.config
+        };
+    }
+    /**
+   * Set configuration value (runtime only, not persisted)
+   */ set(keyPath, value) {
+        const keys = keyPath.split('.');
+        let current = this.config;
+        for(let i = 0; i < keys.length - 1; i++){
+            const key = keys[i];
+            if (!(key in current) || typeof current[key] !== 'object') {
+                current[key] = {};
+            }
+            current = current[key];
+        }
+        current[keys[keys.length - 1]] = value;
+        this.emit('changed', keyPath, value);
+    }
+    /**
+   * Enable hot reload (file watching)
+   */ async enableHotReload() {
+        if (this.watcher) {
+            return; // Already watching
+        }
+        const watchPaths = [
+            this.configPath
+        ];
+        // Add environment-specific config if not default
+        if (this.environment !== 'default') {
+            watchPaths.push(this.getEnvironmentConfigPath(this.environment));
+        }
+        this.watcher = chokidar.watch(watchPaths, {
+            persistent: true,
+            ignoreInitial: true,
+            awaitWriteFinish: {
+                stabilityThreshold: 300,
+                pollInterval: 100
+            }
+        });
+        this.watcher.on('change', async (filePath)=>{
+            try {
+                await this.reload();
+                this.emit('reload', this.config);
+            } catch (error) {
+                this.emit('error', error);
+            }
+        });
+        this.emit('hotReloadEnabled');
+    }
+    /**
+   * Disable hot reload
+   */ async disableHotReload() {
+        if (this.watcher) {
+            await this.watcher.close();
+            this.watcher = null;
+            this.emit('hotReloadDisabled');
+        }
+    }
+    /**
+   * Reload configuration from disk
+   */ async reload() {
+        await this.load(this.environment);
+    }
+    /**
+   * Check if configuration has a key
+   */ has(keyPath) {
+        const keys = keyPath.split('.');
+        let value = this.config;
+        for (const key of keys){
+            if (value && typeof value === 'object' && key in value) {
+                value = value[key];
+            } else {
+                return false;
+            }
+        }
+        return true;
+    }
+    /**
+   * Export configuration to YAML string
+   */ toYAML() {
+        return yaml.dump(this.config, {
+            indent: 2,
+            lineWidth: 80,
+            noRefs: true
+        });
+    }
+    /**
+   * Export configuration to JSON string
+   */ toJSON() {
+        return JSON.stringify(this.config, null, 2);
+    }
+    /**
+   * Cleanup resources
+   */ async destroy() {
+        await this.disableHotReload();
+        this.removeAllListeners();
+        this.config = {};
+    }
+}
+/**
+ * Singleton instance for global configuration
+ */ let globalInstance = null;
+export function getGlobalConfigManager() {
+    if (!globalInstance) {
+        throw new Error('ConfigManager not initialized. Call initializeConfigManager() first.');
+    }
+    return globalInstance;
+}
+export function initializeConfigManager(configPath, schemaPath, options) {
+    globalInstance = new ConfigManager(configPath, schemaPath, options);
+    return globalInstance;
+}
+export function resetGlobalConfigManager() {
+    if (globalInstance) {
+        globalInstance.destroy();
+        globalInstance = null;
+    }
+}
+
+//# sourceMappingURL=config-manager.js.map

package/dist/lib/config-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/config-manager.ts"],"sourcesContent":["/**\r\n * Configuration Manager v2\r\n * YAML-based configuration management with hot reload and migration support\r\n *\r\n * @version 2.0.0\r\n * @description Standardized configuration management for CFN\r\n */\r\n\r\nimport * as fs from 'fs/promises';\r\nimport * as path from 'path';\r\nimport * as yaml from 'js-yaml';\r\nimport Ajv, { JSONSchemaType } from 'ajv';\r\nimport { EventEmitter } from 'events';\r\nimport * as chokidar from 'chokidar';\r\n\r\nexport interface ConfigValue {\r\n  [key: string]: string | number | boolean | ConfigValue | ConfigValue[] | null;\r\n}\r\n\r\nexport interface ConfigSchema {\r\n  version?: string;\r\n  [key: string]: ConfigValue | string | number | boolean | null | undefined;\r\n}\r\n\r\nexport interface ConfigManagerOptions {\r\n  enableHotReload?: boolean;\r\n  validateOnLoad?: boolean;\r\n  coerceTypes?: boolean;\r\n}\r\n\r\n/**\r\n * ConfigManager - Type-safe YAML configuration management\r\n */\r\nexport class ConfigManager extends EventEmitter {\r\n  private config: ConfigSchema = {};\r\n  private configPath: string;\r\n  private schemaPath: string;\r\n  private ajv: Ajv;\r\n  private watcher: chokidar.FSWatcher | null = null;\r\n  private environment: string = 'default';\r\n  private options: ConfigManagerOptions;\r\n\r\n  constructor(\r\n    configPath: string,\r\n    schemaPath: string,\r\n    options: ConfigManagerOptions = {}\r\n  ) {\r\n    super();\r\n    this.configPath = configPath;\r\n    this.schemaPath = schemaPath;\r\n    this.ajv = new Ajv({ allErrors: true, strict: false });\r\n    this.options = {\r\n      enableHotReload: false,\r\n      validateOnLoad: true,\r\n      coerceTypes: true,\r\n      ...options\r\n    };\r\n  }\r\n\r\n  /**\r\n   * Load configuration from file\r\n   */\r\n  async load(environment: string = 'default'): Promise<void> {\r\n    this.environment = environment;\r\n\r\n    try {\r\n      // Load base configuration\r\n      const baseConfig = await this.loadConfigFile(this.configPath);\r\n\r\n      // Load environment-specific overrides if not default\r\n      let envConfig: ConfigSchema = {};\r\n      if (environment !== 'default') {\r\n        const envPath = this.getEnvironmentConfigPath(environment);\r\n        try {\r\n          envConfig = await this.loadConfigFile(envPath);\r\n        } catch (error) {\r\n          // Environment override file doesn't exist - that's okay\r\n          this.emit('warning', `Environment config not found: ${envPath}`);\r\n        }\r\n      }\r\n\r\n      // Merge configurations (environment overrides base)\r\n      this.config = this.deepMerge(baseConfig, envConfig);\r\n\r\n      // Type coercion if enabled\r\n      if (this.options.coerceTypes) {\r\n        this.config = this.coerceTypes(this.config);\r\n      }\r\n\r\n      // Validate against schema\r\n      if (this.options.validateOnLoad) {\r\n        await this.validate();\r\n      }\r\n\r\n      this.emit('loaded', this.config);\r\n    } catch (error) {\r\n      if (error instanceof Error) {\r\n        throw new Error(`Failed to load configuration: ${error.message}`);\r\n      }\r\n      throw error;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Load configuration from YAML or JSON file\r\n   */\r\n  private async loadConfigFile(filePath: string): Promise<ConfigSchema> {\r\n    const content = await fs.readFile(filePath, 'utf-8');\r\n    const ext = path.extname(filePath).toLowerCase();\r\n\r\n    try {\r\n      if (ext === '.yml' || ext === '.yaml') {\r\n        return yaml.load(content) as ConfigSchema;\r\n      } else if (ext === '.json') {\r\n        this.emit('warning', `JSON format is deprecated. Please migrate to YAML: ${filePath}`);\r\n        return JSON.parse(content) as ConfigSchema;\r\n      } else {\r\n        throw new Error(`Unsupported configuration format: ${ext}`);\r\n      }\r\n    } catch (error) {\r\n      if (error instanceof yaml.YAMLException) {\r\n        throw new Error(`YAML parsing error: ${error.message}`);\r\n      }\r\n      throw error;\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Get environment-specific config path\r\n   */\r\n  private getEnvironmentConfigPath(environment: string): string {\r\n    const dir = path.dirname(this.configPath);\r\n    const ext = path.extname(this.configPath);\r\n    return path.join(dir, `${environment}${ext}`);\r\n  }\r\n\r\n  /**\r\n   * Validate configuration against JSON schema\r\n   */\r\n  private async validate(): Promise<void> {\r\n    const schemaContent = await fs.readFile(this.schemaPath, 'utf-8');\r\n    const schema = JSON.parse(schemaContent);\r\n\r\n    const validate = this.ajv.compile(schema);\r\n    const valid = validate(this.config);\r\n\r\n    if (!valid) {\r\n      const errors = validate.errors?.map(err =>\r\n        `${err.instancePath} ${err.message}`\r\n      ).join(', ');\r\n      throw new Error(`Configuration schema validation failed: ${errors}`);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Coerce types from strings to proper types\r\n   */\r\n  private coerceTypes(obj: any, parentKey?: string): any {\r\n    if (obj === null || obj === undefined) {\r\n      return obj;\r\n    }\r\n\r\n    if (Array.isArray(obj)) {\r\n      return obj.map(item => this.coerceTypes(item));\r\n    }\r\n\r\n    if (typeof obj === 'object') {\r\n      const coerced: any = {};\r\n      for (const [key, value] of Object.entries(obj)) {\r\n        coerced[key] = this.coerceTypes(value, key);\r\n      }\r\n      return coerced;\r\n    }\r\n\r\n    if (typeof obj === 'string') {\r\n      // Don't coerce 'version' fields - keep as strings\r\n      if (parentKey === 'version') {\r\n        return obj;\r\n      }\r\n\r\n      // Boolean coercion (case insensitive)\r\n      const lower = obj.toLowerCase();\r\n      if (lower === 'true') return true;\r\n      if (lower === 'false') return false;\r\n\r\n      // Null coercion\r\n      if (lower === 'null') return null;\r\n\r\n      // Number coercion - only if it looks like a pure number\r\n      // Don't coerce version strings like \"1.0\", \"2.5.0\"\r\n      if (/^-?\\d+$/.test(obj)) {\r\n        return parseInt(obj, 10);\r\n      }\r\n      if (/^-?\\d+\\.\\d+$/.test(obj) && !obj.match(/\\d+\\.\\d+\\.\\d+/)) {\r\n        return parseFloat(obj);\r\n      }\r\n    }\r\n\r\n    return obj;\r\n  }\r\n\r\n  /**\r\n   * Deep merge two objects\r\n   */\r\n  private deepMerge(target: any, source: any): any {\r\n    if (!source) return target;\r\n    if (!target) return source;\r\n\r\n    const output = { ...target };\r\n\r\n    for (const key in source) {\r\n      if (source.hasOwnProperty(key)) {\r\n        if (\r\n          typeof source[key] === 'object' &&\r\n          source[key] !== null &&\r\n          !Array.isArray(source[key])\r\n        ) {\r\n          if (key in output) {\r\n            output[key] = this.deepMerge(output[key], source[key]);\r\n          } else {\r\n            output[key] = source[key];\r\n          }\r\n        } else {\r\n          output[key] = source[key];\r\n        }\r\n      }\r\n    }\r\n\r\n    return output;\r\n  }\r\n\r\n  /**\r\n   * Get configuration value by key path\r\n   */\r\n  get<T = any>(keyPath: string, defaultValue?: T): T {\r\n    const keys = keyPath.split('.');\r\n    let value: any = this.config;\r\n\r\n    for (const key of keys) {\r\n      if (value && typeof value === 'object' && key in value) {\r\n        value = value[key];\r\n      } else {\r\n        return defaultValue as T;\r\n      }\r\n    }\r\n\r\n    return value as T;\r\n  }\r\n\r\n  /**\r\n   * Get all configuration\r\n   */\r\n  getAll(): ConfigSchema {\r\n    return { ...this.config };\r\n  }\r\n\r\n  /**\r\n   * Set configuration value (runtime only, not persisted)\r\n   */\r\n  set(keyPath: string, value: any): void {\r\n    const keys = keyPath.split('.');\r\n    let current: any = this.config;\r\n\r\n    for (let i = 0; i < keys.length - 1; i++) {\r\n      const key = keys[i];\r\n      if (!(key in current) || typeof current[key] !== 'object') {\r\n        current[key] = {};\r\n      }\r\n      current = current[key];\r\n    }\r\n\r\n    current[keys[keys.length - 1]] = value;\r\n    this.emit('changed', keyPath, value);\r\n  }\r\n\r\n  /**\r\n   * Enable hot reload (file watching)\r\n   */\r\n  async enableHotReload(): Promise<void> {\r\n    if (this.watcher) {\r\n      return; // Already watching\r\n    }\r\n\r\n    const watchPaths = [this.configPath];\r\n\r\n    // Add environment-specific config if not default\r\n    if (this.environment !== 'default') {\r\n      watchPaths.push(this.getEnvironmentConfigPath(this.environment));\r\n    }\r\n\r\n    this.watcher = chokidar.watch(watchPaths, {\r\n      persistent: true,\r\n      ignoreInitial: true,\r\n      awaitWriteFinish: {\r\n        stabilityThreshold: 300,\r\n        pollInterval: 100\r\n      }\r\n    });\r\n\r\n    this.watcher.on('change', async (filePath: string) => {\r\n      try {\r\n        await this.reload();\r\n        this.emit('reload', this.config);\r\n      } catch (error) {\r\n        this.emit('error', error);\r\n      }\r\n    });\r\n\r\n    this.emit('hotReloadEnabled');\r\n  }\r\n\r\n  /**\r\n   * Disable hot reload\r\n   */\r\n  async disableHotReload(): Promise<void> {\r\n    if (this.watcher) {\r\n      await this.watcher.close();\r\n      this.watcher = null;\r\n      this.emit('hotReloadDisabled');\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Reload configuration from disk\r\n   */\r\n  async reload(): Promise<void> {\r\n    await this.load(this.environment);\r\n  }\r\n\r\n  /**\r\n   * Check if configuration has a key\r\n   */\r\n  has(keyPath: string): boolean {\r\n    const keys = keyPath.split('.');\r\n    let value: any = this.config;\r\n\r\n    for (const key of keys) {\r\n      if (value && typeof value === 'object' && key in value) {\r\n        value = value[key];\r\n      } else {\r\n        return false;\r\n      }\r\n    }\r\n\r\n    return true;\r\n  }\r\n\r\n  /**\r\n   * Export configuration to YAML string\r\n   */\r\n  toYAML(): string {\r\n    return yaml.dump(this.config, {\r\n      indent: 2,\r\n      lineWidth: 80,\r\n      noRefs: true\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Export configuration to JSON string\r\n   */\r\n  toJSON(): string {\r\n    return JSON.stringify(this.config, null, 2);\r\n  }\r\n\r\n  /**\r\n   * Cleanup resources\r\n   */\r\n  async destroy(): Promise<void> {\r\n    await this.disableHotReload();\r\n    this.removeAllListeners();\r\n    this.config = {};\r\n  }\r\n}\r\n\r\n/**\r\n * Singleton instance for global configuration\r\n */\r\nlet globalInstance: ConfigManager | null = null;\r\n\r\nexport function getGlobalConfigManager(): ConfigManager {\r\n  if (!globalInstance) {\r\n    throw new Error('ConfigManager not initialized. Call initializeConfigManager() first.');\r\n  }\r\n  return globalInstance;\r\n}\r\n\r\nexport function initializeConfigManager(\r\n  configPath: string,\r\n  schemaPath: string,\r\n  options?: ConfigManagerOptions\r\n): ConfigManager {\r\n  globalInstance = new ConfigManager(configPath, schemaPath, options);\r\n  return globalInstance;\r\n}\r\n\r\nexport function resetGlobalConfigManager(): void {\r\n  if (globalInstance) {\r\n    globalInstance.destroy();\r\n    globalInstance = null;\r\n  }\r\n}\r\n"],"names":["fs","path","yaml","Ajv","EventEmitter","chokidar","ConfigManager","config","configPath","schemaPath","ajv","watcher","environment","options","allErrors","strict","enableHotReload","validateOnLoad","coerceTypes","load","baseConfig","loadConfigFile","envConfig","envPath","getEnvironmentConfigPath","error","emit","deepMerge","validate","Error","message","filePath","content","readFile","ext","extname","toLowerCase","JSON","parse","YAMLException","dir","dirname","join","schemaContent","schema","compile","valid","errors","map","err","instancePath","obj","parentKey","undefined","Array","isArray","item","coerced","key","value","Object","entries","lower","test","parseInt","match","parseFloat","target","source","output","hasOwnProperty","get","keyPath","defaultValue","keys","split","getAll","set","current","i","length","watchPaths","push","watch","persistent","ignoreInitial","awaitWriteFinish","stabilityThreshold","pollInterval","on","reload","disableHotReload","close","has","toYAML","dump","indent","lineWidth","noRefs","toJSON","stringify","destroy","removeAllListeners","globalInstance","getGlobalConfigManager","initializeConfigManager","resetGlobalConfigManager"],"mappings":"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"}