tracelattice 1.2.5

package/dist/cluster/WorkerManager.js

@@ -0,0 +1,202 @@
+import { existsSync } from "node:fs";
+import { cpus } from "node:os";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { Worker } from "node:worker_threads";
+class WorkerManager {
+    _workers = new Map();
+    _nextWorkerId = 0;
+    _maxWorkers;
+    _workerScript;
+    _workerTimeout;
+    _enableHealthCheck;
+    _healthCheckInterval;
+    _maxRetries;
+    _activeRequests = new Map();
+    _workerRetryCount = new Map();
+    _healthCheckTimer = null;
+    _nextWorkerIndex = 0;
+    _terminated = false;
+    _logger;
+    constructor(options = {}){
+        this._maxWorkers = options.maxWorkers ?? cpus().length;
+        this._workerScript = options.workerScript ?? join(dirname(fileURLToPath(import.meta.url)), 'worker.js');
+        this._workerTimeout = options.workerTimeout ?? 30000;
+        this._enableHealthCheck = options.enableHealthCheck ?? true;
+        this._healthCheckInterval = options.healthCheckInterval ?? 60000;
+        this._maxRetries = options.maxRetries ?? 3;
+        this._logger = options.logger ?? this._createNoopLogger();
+    }
+    _createNoopLogger() {
+        return {
+            info: ()=>{},
+            warn: ()=>{},
+            error: ()=>{},
+            debug: ()=>{},
+            setLevel: ()=>{},
+            getLevel: ()=>'info'
+        };
+    }
+    async start() {
+        if (this._terminated) throw new Error('WorkerManager has been terminated');
+        if (!existsSync(this._workerScript)) throw new Error(`Worker script not found: ${this._workerScript}`);
+        for(let i = 0; i < this._maxWorkers; i++)await this._spawnWorker();
+        if (this._enableHealthCheck) this._startHealthCheck();
+        this._logger.info(`WorkerManager started with ${this._workers.size} workers`);
+    }
+    async _spawnWorker(reuseId) {
+        const workerId = void 0 !== reuseId ? reuseId : this._nextWorkerId++;
+        const worker = new Worker(this._workerScript, {
+            resourceLimits: {
+                maxOldGenerationSizeMb: 100
+            }
+        });
+        worker.on('online', ()=>{
+            this._logger.info(`Worker ${workerId} is online`);
+            this._workerRetryCount.delete(workerId);
+        });
+        worker.on('message', (message)=>{
+            this._handleWorkerMessage(workerId, message);
+        });
+        worker.on('error', ()=>{
+            this._logger.error(`Worker ${workerId} error`);
+            this._handleWorkerError(workerId);
+        });
+        worker.on('exit', (code)=>{
+            this._logger.info(`Worker ${workerId} exited with code ${code}`);
+            this._handleWorkerExit(workerId, code);
+        });
+        this._workers.set(workerId, worker);
+    }
+    _handleWorkerMessage(workerId, message) {
+        if ('result' === message.type && message.requestId) {
+            const callback = this._activeRequests.get(message.requestId);
+            if (callback) {
+                callback(message.result);
+                this._activeRequests.delete(message.requestId);
+            }
+        } else if ('error' === message.type && message.requestId) {
+            const callback = this._activeRequests.get(message.requestId);
+            if (callback) {
+                callback(new Error(message.error || 'Unknown error'));
+                this._activeRequests.delete(message.requestId);
+            }
+        } else if ('health' === message.type) this._workerRetryCount.delete(workerId);
+    }
+    _handleWorkerError(workerId) {
+        const retryCount = this._workerRetryCount.get(workerId) || 0;
+        if (retryCount < this._maxRetries) {
+            this._workerRetryCount.set(workerId, retryCount + 1);
+            this._logger.info(`Restarting worker ${workerId} (attempt ${retryCount + 1}/${this._maxRetries})`);
+            const worker = this._workers.get(workerId);
+            if (worker) {
+                try {
+                    worker.terminate();
+                } catch  {}
+                this._workers.delete(workerId);
+            }
+            setTimeout(()=>{
+                if (!this._terminated) this._spawnWorker(workerId).catch((spawnErr)=>{
+                    this._logger.error(`Failed to restart worker ${workerId}`, {
+                        error: spawnErr
+                    });
+                });
+            }, 1000 * (retryCount + 1));
+        } else {
+            this._logger.error(`Worker ${workerId} exceeded max retries, removing from pool`);
+            const worker = this._workers.get(workerId);
+            if (worker) {
+                try {
+                    worker.terminate();
+                } catch  {}
+                this._workers.delete(workerId);
+            }
+        }
+    }
+    _handleWorkerExit(workerId, code) {
+        this._workers.delete(workerId);
+        if (!this._terminated && 0 !== code) {
+            this._logger.info(`Spawning replacement worker ${workerId}`);
+            this._spawnWorker(workerId).catch((err)=>{
+                this._logger.error("Failed to spawn replacement worker", err);
+            });
+        }
+    }
+    _startHealthCheck() {
+        this._healthCheckTimer = setInterval(()=>{
+            for (const [, worker] of this._workers.entries())try {
+                worker.postMessage({
+                    type: 'health-check'
+                });
+            } catch  {}
+        }, this._healthCheckInterval);
+    }
+    async processThought(input) {
+        if (this._terminated) throw new Error('WorkerManager has been terminated');
+        if (0 === this._workers.size) throw new Error('No workers available');
+        const workerIds = Array.from(this._workers.keys());
+        const index = this._nextWorkerIndex % workerIds.length;
+        const workerId = workerIds[index];
+        const worker = this._workers.get(workerId);
+        if (!worker) throw new Error(`Worker ${workerId} not available`);
+        this._nextWorkerIndex = (this._nextWorkerIndex + 1) % workerIds.length;
+        const requestId = `req_${Date.now()}_${Math.random().toString(36).substring(2, 11)}`;
+        return new Promise((resolve, reject)=>{
+            const timeout = setTimeout(()=>{
+                this._activeRequests.delete(requestId);
+                reject(new Error(`Worker timeout after ${this._workerTimeout}ms`));
+            }, this._workerTimeout);
+            this._activeRequests.set(requestId, (result)=>{
+                clearTimeout(timeout);
+                if (result instanceof Error) reject(result);
+                else resolve(result);
+            });
+            try {
+                worker.postMessage({
+                    type: 'process-thought',
+                    requestId,
+                    input
+                });
+            } catch (error) {
+                clearTimeout(timeout);
+                this._activeRequests.delete(requestId);
+                reject(error);
+            }
+        });
+    }
+    getStats() {
+        return {
+            activeWorkers: this._workers.size,
+            activeRequests: this._activeRequests.size,
+            maxWorkers: this._maxWorkers,
+            healthCheckEnabled: this._enableHealthCheck
+        };
+    }
+    async terminate() {
+        if (this._terminated) return;
+        this._terminated = true;
+        if (this._healthCheckTimer) {
+            clearInterval(this._healthCheckTimer);
+            this._healthCheckTimer = null;
+        }
+        const terminatePromises = Array.from(this._workers.values()).map((worker)=>new Promise((resolve)=>{
+                worker.terminate().then(()=>resolve()).catch(()=>resolve());
+            }));
+        await Promise.all(terminatePromises);
+        this._workers.clear();
+        this._activeRequests.clear();
+        this._logger.info('WorkerManager terminated');
+    }
+    async dispose() {
+        await this.terminate();
+    }
+    isRunning() {
+        return !this._terminated && this._workers.size > 0;
+    }
+}
+function createWorkerManager(options) {
+    return new WorkerManager(options);
+}
+export { WorkerManager, createWorkerManager };
+
+//# sourceMappingURL=WorkerManager.js.map

package/dist/cluster/WorkerManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cluster/WorkerManager.js","sources":["../../src/cluster/WorkerManager.ts"],"sourcesContent":["/**\n * Multi-process Architecture for parallel thought processing.\n *\n * This module provides a WorkerManager that uses Node.js worker threads\n * to distribute thought processing across multiple CPU cores, enabling\n * horizontal scaling and improved performance.\n *\n * @example\n * ```typescript\n * const manager = new WorkerManager({\n *   maxWorkers: 4,\n *   workerScript: './dist/worker.js'\n * });\n * await manager.start();\n *\n * const result = await manager.processThought({ thought: 'test', thought_number: 1, total_thoughts: 1 });\n * ```\n */\n\nimport { existsSync } from 'node:fs';\nimport { cpus } from 'node:os';\nimport { dirname, join } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport { Worker } from 'node:worker_threads';\nimport type { ThoughtData } from '../core/thought.js';\nimport type { Logger } from '../logger/StructuredLogger.js';\nimport type { IDisposable } from '../types/disposable.js';\n\nexport interface WorkerManagerOptions {\n\t/**\n\t * Maximum number of worker processes to spawn\n\t * @default Number of CPU cores\n\t */\n\tmaxWorkers?: number;\n\n\t/**\n\t * Path to the worker script\n\t * @default './dist/worker.js'\n\t */\n\tworkerScript?: string;\n\n\t/**\n\t * Timeout for worker responses in milliseconds\n\t * @default 30000 (30 seconds)\n\t */\n\tworkerTimeout?: number;\n\n\t/**\n\t * Enable worker health monitoring and auto-restart\n\t * @default true\n\t */\n\tenableHealthCheck?: boolean;\n\n\t/**\n\t * Health check interval in milliseconds\n\t * @default 60000 (1 minute)\n\t */\n\thealthCheckInterval?: number;\n\n\t/**\n\t * Maximum number of retries for a failed worker\n\t * @default 3\n\t */\n\tmaxRetries?: number;\n\n\t/**\n\t * Logger instance\n\t */\n\tlogger?: Logger;\n}\n\nexport interface WorkerMessage {\n\ttype: 'process-thought' | 'health-check' | 'terminate';\n\trequestId?: string;\n\tinput?: unknown;\n}\n\nexport interface WorkerResponse {\n\ttype: 'result' | 'error' | 'health';\n\trequestId?: string;\n\tresult?: unknown;\n\terror?: string;\n}\n\n/**\n * WorkerManager manages a pool of worker processes for parallel thought processing.\n *\n * Each worker runs in a separate process and can process thoughts independently.\n * The manager distributes incoming requests across available workers.\n */\nexport class WorkerManager implements IDisposable {\n\tprivate _workers: Map<number, Worker> = new Map();\n\tprivate _nextWorkerId = 0;\n\tprivate _maxWorkers: number;\n\tprivate _workerScript: string;\n\tprivate _workerTimeout: number;\n\tprivate _enableHealthCheck: boolean;\n\tprivate _healthCheckInterval: number;\n\tprivate _maxRetries: number;\n\tprivate _activeRequests: Map<string, (result: unknown) => void> = new Map();\n\tprivate _workerRetryCount: Map<number, number> = new Map();\n\tprivate _healthCheckTimer: NodeJS.Timeout | null = null;\n\tprivate _nextWorkerIndex = 0;\n\n\tprivate _terminated = false;\n\tprivate _logger: Logger;\n\n\tconstructor(options: WorkerManagerOptions = {}) {\n\t\tthis._maxWorkers = options.maxWorkers ?? cpus().length;\n\t\tthis._workerScript =\n\t\t\toptions.workerScript ?? join(dirname(fileURLToPath(import.meta.url)), 'worker.js');\n\t\tthis._workerTimeout = options.workerTimeout ?? 30000;\n\t\tthis._enableHealthCheck = options.enableHealthCheck ?? true;\n\t\tthis._healthCheckInterval = options.healthCheckInterval ?? 60000;\n\t\tthis._maxRetries = options.maxRetries ?? 3;\n\t\tthis._logger = options.logger ?? this._createNoopLogger();\n\t}\n\n\t/**\n\t * Create a no-op logger when none is provided.\n\t */\n\tprivate _createNoopLogger(): Logger {\n\t\treturn {\n\t\t\tinfo: () => {},\n\t\t\twarn: () => {},\n\t\t\terror: () => {},\n\t\t\tdebug: () => {},\n\t\t\tsetLevel: () => {},\n\t\t\tgetLevel: () => 'info',\n\t\t};\n\t}\n\n\t/**\n\t * Start the worker manager and spawn all worker processes.\n\t */\n\tasync start(): Promise<void> {\n\t\tif (this._terminated) {\n\t\t\tthrow new Error('WorkerManager has been terminated');\n\t\t}\n\n\t\t// Verify worker script exists\n\t\tif (!existsSync(this._workerScript)) {\n\t\t\tthrow new Error(`Worker script not found: ${this._workerScript}`);\n\t\t}\n\n\t\t// Spawn workers\n\t\tfor (let i = 0; i < this._maxWorkers; i++) {\n\t\t\tawait this._spawnWorker();\n\t\t}\n\n\t\t// Start health check if enabled\n\t\tif (this._enableHealthCheck) {\n\t\t\tthis._startHealthCheck();\n\t\t}\n\n\t\tthis._logger.info(`WorkerManager started with ${this._workers.size} workers`);\n\t}\n\n\t/**\n\t * Spawn a single worker process.\n\t */\n\tprivate async _spawnWorker(reuseId?: number): Promise<void> {\n\t\tconst workerId = reuseId !== undefined ? reuseId : this._nextWorkerId++;\n\t\tconst worker = new Worker(this._workerScript, {\n\t\t\tresourceLimits: {\n\t\t\t\tmaxOldGenerationSizeMb: 100, // Limit memory usage\n\t\t\t},\n\t\t});\n\n\t\tworker.on('online', () => {\n\t\t\tthis._logger.info(`Worker ${workerId} is online`);\n\t\t\tthis._workerRetryCount.delete(workerId);\n\t\t});\n\n\t\tworker.on('message', (message: WorkerResponse) => {\n\t\t\tthis._handleWorkerMessage(workerId, message);\n\t\t});\n\n\t\tworker.on('error', () => {\n\t\t\tthis._logger.error(`Worker ${workerId} error`);\n\t\t\tthis._handleWorkerError(workerId);\n\t\t});\n\n\t\tworker.on('exit', (code) => {\n\t\t\tthis._logger.info(`Worker ${workerId} exited with code ${code}`);\n\t\t\tthis._handleWorkerExit(workerId, code);\n\t\t});\n\n\t\tthis._workers.set(workerId, worker);\n\t}\n\n\t/**\n\t * Handle incoming messages from workers.\n\t */\n\tprivate _handleWorkerMessage(workerId: number, message: WorkerResponse): void {\n\t\tif (message.type === 'result' && message.requestId) {\n\t\t\tconst callback = this._activeRequests.get(message.requestId);\n\t\t\tif (callback) {\n\t\t\t\tcallback(message.result);\n\t\t\t\tthis._activeRequests.delete(message.requestId);\n\t\t\t}\n\t\t} else if (message.type === 'error' && message.requestId) {\n\t\t\tconst callback = this._activeRequests.get(message.requestId);\n\t\t\tif (callback) {\n\t\t\t\tcallback(new Error(message.error || 'Unknown error'));\n\t\t\t\tthis._activeRequests.delete(message.requestId);\n\t\t\t}\n\t\t} else if (message.type === 'health') {\n\t\t\t// Health check response - worker is alive\n\t\t\tthis._workerRetryCount.delete(workerId);\n\t\t}\n\t}\n\n\t/**\n\t * Handle worker errors.\n\t */\n\tprivate _handleWorkerError(workerId: number): void {\n\t\tconst retryCount = this._workerRetryCount.get(workerId) || 0;\n\n\t\tif (retryCount < this._maxRetries) {\n\t\t\tthis._workerRetryCount.set(workerId, retryCount + 1);\n\t\t\tthis._logger.info(\n\t\t\t\t`Restarting worker ${workerId} (attempt ${retryCount + 1}/${this._maxRetries})`\n\t\t\t);\n\n\t\t\t// Remove failed worker\n\t\t\tconst worker = this._workers.get(workerId);\n\t\t\tif (worker) {\n\t\t\t\ttry {\n\t\t\t\t\tworker.terminate();\n\t\t\t\t} catch {\n\t\t\t\t\t// Ignore\n\t\t\t\t}\n\t\t\t\tthis._workers.delete(workerId);\n\t\t\t}\n\n\t\t\t// Spawn new worker after delay\n\t\t\tsetTimeout(\n\t\t\t\t() => {\n\t\t\t\t\tif (!this._terminated) {\n\t\t\t\t\t\tthis._spawnWorker(workerId).catch((spawnErr) => {\n\t\t\t\t\t\t\tthis._logger.error(`Failed to restart worker ${workerId}`, { error: spawnErr });\n\t\t\t\t\t\t});\n\t\t\t\t\t}\n\t\t\t\t},\n\t\t\t\t1000 * (retryCount + 1)\n\t\t\t);\n\t\t} else {\n\t\t\tthis._logger.error(`Worker ${workerId} exceeded max retries, removing from pool`);\n\t\t\tconst worker = this._workers.get(workerId);\n\t\t\tif (worker) {\n\t\t\t\ttry {\n\t\t\t\t\tworker.terminate();\n\t\t\t\t} catch {\n\t\t\t\t\t// Ignore\n\t\t\t\t}\n\t\t\t\tthis._workers.delete(workerId);\n\t\t\t}\n\t\t}\n\t}\n\n\t/**\n\t * Handle worker exit.\n\t */\n\tprivate _handleWorkerExit(workerId: number, code: number): void {\n\t\tthis._workers.delete(workerId);\n\n\t\t// Spawn replacement worker if not terminated\n\t\tif (!this._terminated && code !== 0) {\n\t\t\tthis._logger.info(`Spawning replacement worker ${workerId}`);\n\t\t\tthis._spawnWorker(workerId).catch((err) => {\n\t\t\t\tthis._logger.error(`Failed to spawn replacement worker`, err);\n\t\t\t});\n\t\t}\n\t}\n\n\t/**\n\t * Start periodic health checks for all workers.\n\t */\n\tprivate _startHealthCheck(): void {\n\t\tthis._healthCheckTimer = setInterval(() => {\n\t\t\tfor (const [, worker] of this._workers.entries()) {\n\t\t\t\ttry {\n\t\t\t\t\tworker.postMessage({ type: 'health-check' });\n\t\t\t\t} catch {\n\t\t\t\t\t// Worker is dead, will be handled by exit event\n\t\t\t\t}\n\t\t\t}\n\t\t}, this._healthCheckInterval);\n\t}\n\n\t/**\n\t * Process a thought using an available worker.\n\t *\n\t * @param input - The thought data to process\n\t * @returns Promise with the processing result\n\t */\n\tasync processThought(input: ThoughtData): Promise<unknown> {\n\t\tif (this._terminated) {\n\t\t\tthrow new Error('WorkerManager has been terminated');\n\t\t}\n\n\t\tif (this._workers.size === 0) {\n\t\t\tthrow new Error('No workers available');\n\t\t}\n\n\t\t// Get next available worker (round-robin over Map keys)\n\t\tconst workerIds = Array.from(this._workers.keys());\n\t\tconst index = this._nextWorkerIndex % workerIds.length;\n\t\tconst workerId = workerIds[index]!;\n\t\tconst worker = this._workers.get(workerId);\n\n\t\tif (!worker) {\n\t\t\tthrow new Error(`Worker ${workerId} not available`);\n\t\t}\n\n\t\t// Increment next worker index (round-robin)\n\t\tthis._nextWorkerIndex = (this._nextWorkerIndex + 1) % workerIds.length;\n\n\t\t// Generate unique request ID\n\t\tconst requestId = `req_${Date.now()}_${Math.random().toString(36).substring(2, 11)}`;\n\n\t\treturn new Promise((resolve, reject) => {\n\t\t\t// Set timeout\n\t\t\tconst timeout = setTimeout(() => {\n\t\t\t\tthis._activeRequests.delete(requestId);\n\t\t\t\treject(new Error(`Worker timeout after ${this._workerTimeout}ms`));\n\t\t\t}, this._workerTimeout);\n\n\t\t\t// Store callback\n\t\t\tthis._activeRequests.set(requestId, (result) => {\n\t\t\t\tclearTimeout(timeout);\n\t\t\t\tif (result instanceof Error) {\n\t\t\t\t\treject(result);\n\t\t\t\t} else {\n\t\t\t\t\tresolve(result);\n\t\t\t\t}\n\t\t\t});\n\n\t\t\t// Send message to worker\n\t\t\ttry {\n\t\t\t\tworker.postMessage({\n\t\t\t\t\ttype: 'process-thought',\n\t\t\t\t\trequestId,\n\t\t\t\t\tinput,\n\t\t\t\t});\n\t\t\t} catch (error) {\n\t\t\t\tclearTimeout(timeout);\n\t\t\t\tthis._activeRequests.delete(requestId);\n\t\t\t\treject(error);\n\t\t\t}\n\t\t});\n\t}\n\n\t/**\n\t * Get statistics about the worker pool.\n\t */\n\tgetStats(): {\n\t\tactiveWorkers: number;\n\t\tactiveRequests: number;\n\t\tmaxWorkers: number;\n\t\thealthCheckEnabled: boolean;\n\t} {\n\t\treturn {\n\t\t\tactiveWorkers: this._workers.size,\n\t\t\tactiveRequests: this._activeRequests.size,\n\t\t\tmaxWorkers: this._maxWorkers,\n\t\t\thealthCheckEnabled: this._enableHealthCheck,\n\t\t};\n\t}\n\n\t/**\n\t * Terminate all workers and stop the health check.\n\t */\n\tasync terminate(): Promise<void> {\n\t\tif (this._terminated) {\n\t\t\treturn;\n\t\t}\n\n\t\tthis._terminated = true;\n\n\t\t// Stop health check\n\t\tif (this._healthCheckTimer) {\n\t\t\tclearInterval(this._healthCheckTimer);\n\t\t\tthis._healthCheckTimer = null;\n\t\t}\n\n\t\t// Terminate all workers\n\t\tconst terminatePromises = Array.from(this._workers.values()).map((worker) => {\n\t\t\treturn new Promise<void>((resolve) => {\n\t\t\t\tworker\n\t\t\t\t\t.terminate()\n\t\t\t\t\t.then(() => resolve())\n\t\t\t\t\t.catch(() => resolve());\n\t\t\t});\n\t\t});\n\n\t\tawait Promise.all(terminatePromises);\n\t\tthis._workers.clear();\n\t\tthis._activeRequests.clear();\n\n\t\tthis._logger.info('WorkerManager terminated');\n\t}\n\n\t/**\n\t * Dispose of the worker manager, releasing all resources.\n\t * Implements the IDisposable interface.\n\t * Delegates to terminate() for backward compatibility.\n\t */\n\tasync dispose(): Promise<void> {\n\t\tawait this.terminate();\n\t}\n\n\t/**\n\t * Check if worker manager is running.\n\t */\n\tisRunning(): boolean {\n\t\treturn !this._terminated && this._workers.size > 0;\n\t}\n}\n\n/**\n * Create a WorkerManager with the given options.\n *\n * @param options - Worker manager configuration\n * @returns A configured WorkerManager\n *\n * @example\n * ```typescript\n * const manager = createWorkerManager({\n *   maxWorkers: 4,\n *   workerScript: './dist/worker.js'\n * });\n * await manager.start();\n * ```\n */\nexport function createWorkerManager(options?: WorkerManagerOptions): WorkerManager {\n\treturn new WorkerManager(options);\n}\n"],"names":["WorkerManager","Map","options","cpus","join","dirname","fileURLToPath","Error","existsSync","i","reuseId","workerId","undefined","worker","Worker","message","code","callback","retryCount","setTimeout","spawnErr","err","setInterval","input","workerIds","Array","index","requestId","Date","Math","Promise","resolve","reject","timeout","result","clearTimeout","error","clearInterval","terminatePromises","createWorkerManager"],"mappings":"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"}

package/dist/cluster/worker.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Worker thread entry point for parallel thought processing.
+ *
+ * This module is the entry point for worker processes that handle thought
+ * processing in parallel. Workers receive messages from the main process
+ * via the Worker messaging API and process them asynchronously.
+ *
+ * @module cluster
+ */
+export {};
+//# sourceMappingURL=worker.d.ts.map

package/dist/cluster/worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../src/cluster/worker.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/cluster/worker.js

@@ -0,0 +1,36 @@
+import { parentPort } from "node:worker_threads";
+if (null !== parentPort) {
+    parentPort.on('message', async (message)=>{
+        try {
+            if ('process-thought' === message.type) {
+                const result = await handleProcessThought(message.input);
+                parentPort.postMessage({
+                    type: 'result',
+                    requestId: message.requestId,
+                    result
+                });
+            } else if ('health-check' === message.type) parentPort.postMessage({
+                type: 'health'
+            });
+        } catch (error) {
+            parentPort.postMessage({
+                type: 'error',
+                requestId: message.requestId,
+                error: error instanceof Error ? error.message : String(error)
+            });
+        }
+    });
+    parentPort.postMessage({
+        type: 'ready'
+    });
+}
+async function handleProcessThought(input) {
+    const result = {
+        success: true,
+        timestamp: Date.now(),
+        input
+    };
+    return result;
+}
+
+//# sourceMappingURL=worker.js.map

package/dist/cluster/worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cluster/worker.js","sources":["../../src/cluster/worker.ts"],"sourcesContent":["/**\n * Worker thread entry point for parallel thought processing.\n *\n * This module is the entry point for worker processes that handle thought\n * processing in parallel. Workers receive messages from the main process\n * via the Worker messaging API and process them asynchronously.\n *\n * @module cluster\n */\n\nimport { parentPort } from 'node:worker_threads';\n\n/**\n * Message types that can be sent to the worker from the main process.\n *\n * @example\n * ```typescript\n * const message: WorkerInput = {\n *   type: 'process-thought',\n *   requestId: 'req_123',\n *   input: { thought: 'test', thought_number: 1, total_thoughts: 1 }\n * };\n * ```\n */\ninterface WorkerInput {\n\t/** The message type indicating the action to perform. */\n\ttype: 'process-thought' | 'health-check';\n\n\t/** Optional request identifier for correlating responses. */\n\trequestId?: string;\n\n\t/** The input data for processing (varies by type). */\n\tinput?: unknown;\n}\n\n/**\n * Response types sent from the worker back to the main process.\n *\n * @example\n * ```typescript\n * const response: WorkerResponse = {\n *   type: 'result',\n *   requestId: 'req_123',\n *   result: { success: true, data: {...} }\n * };\n * ```\n */\ninterface WorkerResponse {\n\t/** The response type indicating the result status. */\n\ttype: 'result' | 'error' | 'health' | 'ready';\n\n\t/** Optional request identifier for correlating with the original request. */\n\trequestId?: string;\n\n\t/** The result data (present for successful results). */\n\tresult?: unknown;\n\n\t/** Error message (present for errors). */\n\terror?: string;\n}\n\n/**\n * Worker entry point for handling messages from the main process.\n *\n * This script runs in a separate process and receives messages from the main\n * process via the Worker messaging API. It processes thoughts and returns results.\n * The worker responds to 'process-thought' messages by processing thoughts and\n * to 'health-check' messages with a health status.\n *\n * @remarks\n * **Message Flow:**\n * 1. Worker starts and sends a 'ready' message\n * 2. Main process can send 'health-check' messages to verify worker status\n * 3. Main process sends 'process-thought' messages with thought data\n * 4. Worker processes the thought and sends back a 'result' message\n * 5. On errors, worker sends an 'error' message with details\n *\n * **Supported Message Types:**\n * - `process-thought` - Process a thought and return recommendations\n * - `health-check` - Return worker health status\n *\n * @example\n * ```typescript\n * // In main process:\n * const { Worker } = await import('node:worker_threads');\n * const worker = new Worker('./dist/cluster/worker.js');\n *\n * worker.on('message', (response: WorkerResponse) => {\n *   if (response.type === 'result') {\n *     console.log('Result:', response.result);\n *   } else if (response.type === 'ready') {\n *     console.log('Worker ready');\n *   }\n * });\n *\n * // Send a thought for processing\n * worker.postMessage({\n *   type: 'process-thought',\n *   requestId: 'req_123',\n *   input: {\n *     thought: 'I need to analyze this problem',\n *     thought_number: 1,\n *     total_thoughts: 3,\n *     next_thought_needed: true\n *   }\n * });\n * ```\n */\nif (parentPort !== null) {\n\tparentPort.on('message', async (message: WorkerInput) => {\n\t\ttry {\n\t\t\tif (message.type === 'process-thought') {\n\t\t\t\tconst result = await handleProcessThought(message.input);\n\t\t\t\tparentPort!.postMessage({\n\t\t\t\t\ttype: 'result',\n\t\t\t\t\trequestId: message.requestId,\n\t\t\t\t\tresult,\n\t\t\t\t} as WorkerResponse);\n\t\t\t} else if (message.type === 'health-check') {\n\t\t\t\t// Respond to health check\n\t\t\t\tparentPort!.postMessage({\n\t\t\t\t\ttype: 'health',\n\t\t\t\t} as WorkerResponse);\n\t\t\t}\n\t\t} catch (error) {\n\t\t\tparentPort!.postMessage({\n\t\t\t\ttype: 'error',\n\t\t\t\trequestId: message.requestId,\n\t\t\t\terror: error instanceof Error ? error.message : String(error),\n\t\t\t} as WorkerResponse);\n\t\t}\n\t});\n\n\t// Signal ready\n\tparentPort!.postMessage({ type: 'ready' } as WorkerResponse);\n}\n\n/**\n * Process a thought and generate recommendations.\n *\n * This function contains the core thought processing logic that runs in the\n * worker process. It validates the thought, adds it to history, generates\n * tool/skill recommendations, and formats the response.\n *\n * @remarks\n * **Processing Steps:**\n * 1. Validate the thought input\n * 2. Store the thought in history\n * 3. Generate tool and skill recommendations\n * 4. Format the output response\n *\n * This is currently a placeholder implementation that echoes back the input\n * with a timestamp. A full implementation would integrate with the\n * ThoughtProcessor, HistoryManager, and other components.\n *\n * @param input - The thought data to process\n * @returns A Promise resolving to the processing result\n *\n * @example\n * ```typescript\n * const result = await handleProcessThought({\n *   thought: 'I should read the configuration file',\n *   thought_number: 1,\n *   total_thoughts: 2,\n *   next_thought_needed: true\n * });\n *\n * // Result: { success: true, timestamp: 1705550000000, input: {...} }\n * ```\n */\nasync function handleProcessThought(input: unknown): Promise<unknown> {\n\t// This is a placeholder implementation\n\t// In a real scenario, this would use the ThoughtProcessor and other components\n\n\tconst result = {\n\t\tsuccess: true,\n\t\ttimestamp: Date.now(),\n\t\tinput,\n\t};\n\n\treturn result;\n}\n"],"names":["parentPort","message","result","handleProcessThought","error","Error","String","input","Date"],"mappings":";AA4GA,IAAIA,AAAe,SAAfA,YAAqB;IACxBA,WAAW,EAAE,CAAC,WAAW,OAAOC;QAC/B,IAAI;YACH,IAAIA,AAAiB,sBAAjBA,QAAQ,IAAI,EAAwB;gBACvC,MAAMC,SAAS,MAAMC,qBAAqBF,QAAQ,KAAK;gBACvDD,WAAAA,WAAuB,CAAC;oBACvB,MAAM;oBACN,WAAWC,QAAQ,SAAS;oBAC5BC;gBACD;YACD,OAAO,IAAID,AAAiB,mBAAjBA,QAAQ,IAAI,EAEtBD,WAAAA,WAAuB,CAAC;gBACvB,MAAM;YACP;QAEF,EAAE,OAAOI,OAAO;YACfJ,WAAAA,WAAuB,CAAC;gBACvB,MAAM;gBACN,WAAWC,QAAQ,SAAS;gBAC5B,OAAOG,iBAAiBC,QAAQD,MAAM,OAAO,GAAGE,OAAOF;YACxD;QACD;IACD;IAGAJ,WAAAA,WAAuB,CAAC;QAAE,MAAM;IAAQ;AACzC;AAmCA,eAAeG,qBAAqBI,KAAc;IAIjD,MAAML,SAAS;QACd,SAAS;QACT,WAAWM,KAAK,GAAG;QACnBD;IACD;IAEA,OAAOL;AACR"}

package/dist/config/ConfigLoader.d.ts

@@ -0,0 +1,224 @@
+/**
+ * Configuration file loading with environment variable override support.
+ *
+ * This module provides the `ConfigLoader` class which handles loading configuration
+ * from YAML and JSON files in standard locations, with automatic environment variable
+ * overrides for all settings.
+ *
+ * @module config
+ */
+import type { PersistenceConfig } from '../persistence/PersistenceBackend.js';
+/**
+ * Configuration options loaded from config files.
+ *
+ * These options represent the structure of configuration files (JSON or YAML)
+ * that can be loaded from standard locations. All values can be overridden
+ * by environment variables.
+ *
+ * @example
+ * ```yaml
+ * # .claude/config.yaml
+ * maxHistorySize: 500
+ * maxBranches: 25
+ * logLevel: debug
+ * prettyLog: true
+ * skillDirs:
+ *   - ./custom-skills
+ * discoveryCache:
+ *   ttl: 600000
+ *   maxSize: 200
+ * persistence:
+ *   enabled: true
+ *   backend: sqlite
+ *   options:
+ *     dbPath: ./data/history.db
+ * ```
+ */
+export interface ConfigFileOptions {
+    /**
+     * Maximum number of thoughts to keep in history.
+     * Can be overridden by `MAX_HISTORY_SIZE` environment variable.
+     */
+    maxHistorySize?: number;
+    /**
+     * Maximum number of branches to maintain.
+     * Can be overridden by `MAX_BRANCHES` environment variable.
+     */
+    maxBranches?: number;
+    /**
+     * Maximum size of each branch.
+     * Can be overridden by `MAX_BRANCH_SIZE` environment variable.
+     */
+    maxBranchSize?: number;
+    /**
+     * Logging level for the application.
+     * Can be overridden by `LOG_LEVEL` environment variable.
+     */
+    logLevel?: 'debug' | 'info' | 'warn' | 'error';
+    /**
+     * Whether to enable pretty (formatted) logging output.
+     * Can be overridden by `PRETTY_LOG` environment variable (set to "false" to disable).
+     */
+    prettyLog?: boolean;
+    /**
+     * Directory paths to search for skills.
+     * Can be overridden by `SKILL_DIRS` environment variable (colon-separated).
+     */
+    skillDirs?: string[];
+    /**
+     * Discovery cache configuration.
+     * Can be overridden by `DISCOVERY_CACHE_TTL` and `DISCOVERY_CACHE_MAX_SIZE` environment variables.
+     */
+    discoveryCache?: {
+        /**
+         * Time-to-live for cache entries in milliseconds.
+         * Environment variable `DISCOVERY_CACHE_TTL` accepts seconds.
+         */
+        ttl?: number;
+        /**
+         * Maximum number of entries in the cache.
+         */
+        maxSize?: number;
+    };
+    /**
+     * Persistence configuration for storing history and state.
+     */
+    persistence?: PersistenceConfig;
+}
+/**
+ * Loads configuration from files with environment variable overrides.
+ *
+ * This class searches for configuration files in standard locations and applies
+ * environment variable overrides. Files are searched in priority order, with the
+ * first match being used. Environment variables always take precedence over file values.
+ *
+ * @remarks
+ * **Config File Search Order (priority):**
+ * 1. Custom path (if provided to constructor)
+ * 2. `.claude/config.json` (project-local)
+ * 3. `.claude/config.yaml` (project-local)
+ * 4. `.claude/config.yml` (project-local)
+ * 5. `~/.claude/config.json` (user-global)
+ * 6. `~/.claude/config.yaml` (user-global)
+ * 7. `~/.claude/config.yml` (user-global)
+ *
+ * **Environment Variable Overrides:**
+ * | Variable | Type | Description |
+ * |----------|------|-------------|
+ * | `MAX_HISTORY_SIZE` | number | Max thoughts in history |
+ * | `MAX_BRANCHES` | number | Max number of branches |
+ * | `MAX_BRANCH_SIZE` | number | Max size of each branch |
+ * | `LOG_LEVEL` | string | Logging level (debug/info/warn/error) |
+ * | `PRETTY_LOG` | string | "false" to disable pretty logging |
+ * | `SKILL_DIRS` | string | Colon-separated directory paths |
+ * | `DISCOVERY_CACHE_TTL` | number | TTL in seconds (converted to ms) |
+ * | `DISCOVERY_CACHE_MAX_SIZE` | number | Max cache entries |
+ *
+ * @example
+ * ```typescript
+ * // Use default search paths
+ * const loader1 = new ConfigLoader();
+ * const config1 = loader1.load();
+ *
+ * // Use custom config path
+ * const loader2 = new ConfigLoader('./my-config.yaml');
+ * const config2 = loader2.load();
+ *
+ * // Convert to ServerConfig options
+ * const serverOptions = loader2.toServerConfigOptions(config2);
+ * ```
+ */
+export declare class ConfigLoader {
+    /** Array of config file paths to search, in priority order. */
+    private _configPaths;
+    /**
+     * Creates a new ConfigLoader instance.
+     *
+     * @param customPath - Optional custom config file path. If provided, only this path will be checked.
+     *
+     * @example
+     * ```typescript
+     * // Use default search paths
+     * const loader1 = new ConfigLoader();
+     *
+     * // Use a specific config file
+     * const loader2 = new ConfigLoader('./custom-config.json');
+     * ```
+     */
+    constructor(customPath?: string);
+    /**
+     * Loads configuration from files and applies environment overrides.
+     *
+     * Searches for config files in the configured paths (in priority order),
+     * parses the first match, and applies environment variable overrides.
+     * Returns null if no config file is found and no environment overrides are set.
+     *
+     * @returns The loaded configuration with environment overrides applied, or null if no config found
+     *
+     * @example
+     * ```typescript
+     * const loader = new ConfigLoader();
+     * const config = loader.load();
+     *
+     * if (config) {
+     *   console.log('Max history size:', config.maxHistorySize);
+     *   console.log('Log level:', config.logLevel);
+     * }
+     * ```
+     */
+    load(): ConfigFileOptions | null;
+    /**
+     * Applies environment variable overrides to the configuration.
+     *
+     * Environment variables take precedence over file-based configuration.
+     * Supported environment variables:
+     * - `MAX_HISTORY_SIZE`, `MAX_BRANCHES`, `MAX_BRANCH_SIZE` (numbers)
+     * - `LOG_LEVEL` (debug/info/warn/error)
+     * - `PRETTY_LOG` ("false" to disable)
+     * - `SKILL_DIRS` (colon-separated paths)
+     * - `DISCOVERY_CACHE_TTL` (in seconds, converted to ms)
+     * - `DISCOVERY_CACHE_MAX_SIZE` (number)
+     *
+     * @param config - The configuration to apply overrides to
+     * @returns A new configuration object with environment overrides applied
+     * @private
+     */
+    private applyEnvironmentOverrides;
+    /**
+     * Parses a configuration file (JSON or YAML).
+     *
+     * Detects the file type by extension and uses the appropriate parser.
+     * Supports `.json`, `.yaml`, and `.yml` file extensions.
+     *
+     * @param filePath - Path to the configuration file to parse
+     * @returns The parsed configuration object
+     * @throws {Error} If the file cannot be parsed
+     * @private
+     */
+    private parseConfig;
+    /**
+     * Converts file-based configuration to ServerConfig options.
+     *
+     * This is a convenience method for extracting the ServerConfig-relevant
+     * options from a file-based configuration.
+     *
+     * @param config - The configuration to convert
+     * @returns An object with ServerConfig-compatible options
+     *
+     * @example
+     * ```typescript
+     * const loader = new ConfigLoader();
+     * const config = loader.load();
+     * if (config) {
+     *   const serverOpts = loader.toServerConfigOptions(config);
+     *   const serverConfig = new ServerConfig(serverOpts);
+     * }
+     * ```
+     */
+    toServerConfigOptions(config: ConfigFileOptions): {
+        maxHistorySize?: number;
+        maxBranches?: number;
+        maxBranchSize?: number;
+    };
+}
+//# sourceMappingURL=ConfigLoader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigLoader.d.ts","sourceRoot":"","sources":["../../src/config/ConfigLoader.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAE9E;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,WAAW,iBAAiB;IACjC;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAE/C;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAErB;;;OAGG;IACH,cAAc,CAAC,EAAE;QAChB;;;WAGG;QACH,GAAG,CAAC,EAAE,MAAM,CAAC;QACb;;WAEG;QACH,OAAO,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IAEF;;OAEG;IACH,WAAW,CAAC,EAAE,iBAAiB,CAAC;CAChC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,qBAAa,YAAY;IACxB,+DAA+D;IAC/D,OAAO,CAAC,YAAY,CAAW;IAE/B;;;;;;;;;;;;;OAaG;gBACS,UAAU,CAAC,EAAE,MAAM;IAa/B;;;;;;;;;;;;;;;;;;;OAmBG;IACH,IAAI,IAAI,iBAAiB,GAAG,IAAI;IAoBhC;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,yBAAyB;IAmDjC;;;;;;;;;;OAUG;IACH,OAAO,CAAC,WAAW;IAWnB;;;;;;;;;;;;;;;;;;OAkBG;IACH,qBAAqB,CAAC,MAAM,EAAE,iBAAiB,GAAG;QACjD,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,aAAa,CAAC,EAAE,MAAM,CAAC;KACvB;CAOD"}

package/dist/config/ConfigLoader.js

@@ -0,0 +1,85 @@
+import { existsSync, readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { parse } from "yaml";
+class ConfigLoader {
+    _configPaths;
+    constructor(customPath){
+        this._configPaths = customPath ? [
+            customPath
+        ] : [
+            '.claude/config.json',
+            '.claude/config.yaml',
+            '.claude/config.yml',
+            join(homedir(), '.claude/config.json'),
+            join(homedir(), '.claude/config.yaml'),
+            join(homedir(), '.claude/config.yml')
+        ];
+    }
+    load() {
+        let config = null;
+        for (const configPath of this._configPaths)if (existsSync(configPath)) try {
+            config = this.parseConfig(configPath);
+            break;
+        } catch (error) {
+            console.error(`Failed to load config from ${configPath}:`, error instanceof Error ? error.message : String(error));
+        }
+        return this.applyEnvironmentOverrides(config || {});
+    }
+    applyEnvironmentOverrides(config) {
+        const result = {
+            ...config
+        };
+        if (process.env.MAX_HISTORY_SIZE) {
+            const parsed = parseInt(process.env.MAX_HISTORY_SIZE, 10);
+            if (Number.isFinite(parsed)) result.maxHistorySize = parsed;
+        }
+        if (process.env.MAX_BRANCHES) {
+            const parsed = parseInt(process.env.MAX_BRANCHES, 10);
+            if (Number.isFinite(parsed)) result.maxBranches = parsed;
+        }
+        if (process.env.MAX_BRANCH_SIZE) {
+            const parsed = parseInt(process.env.MAX_BRANCH_SIZE, 10);
+            if (Number.isFinite(parsed)) result.maxBranchSize = parsed;
+        }
+        if (process.env.LOG_LEVEL && [
+            'debug',
+            'info',
+            'warn',
+            'error'
+        ].includes(process.env.LOG_LEVEL)) result.logLevel = process.env.LOG_LEVEL;
+        if ('false' === process.env.PRETTY_LOG) result.prettyLog = false;
+        if (process.env.SKILL_DIRS) result.skillDirs = process.env.SKILL_DIRS.split(':');
+        if (process.env.DISCOVERY_CACHE_TTL) {
+            const parsed = parseInt(process.env.DISCOVERY_CACHE_TTL, 10);
+            if (Number.isFinite(parsed)) {
+                result.discoveryCache = result.discoveryCache || {};
+                result.discoveryCache.ttl = 1000 * parsed;
+            }
+        }
+        if (process.env.DISCOVERY_CACHE_MAX_SIZE) {
+            const parsed = parseInt(process.env.DISCOVERY_CACHE_MAX_SIZE, 10);
+            if (Number.isFinite(parsed)) {
+                result.discoveryCache = result.discoveryCache || {};
+                result.discoveryCache.maxSize = parsed;
+            }
+        }
+        return result;
+    }
+    parseConfig(filePath) {
+        const content = readFileSync(filePath, 'utf-8');
+        const ext = filePath.split('.').pop()?.toLowerCase();
+        if ('yaml' === ext || 'yml' === ext) return parse(content);
+        return JSON.parse(content);
+    }
+    toServerConfigOptions(config) {
+        return {
+            maxHistorySize: config.maxHistorySize,
+            maxBranches: config.maxBranches,
+            maxBranchSize: config.maxBranchSize
+        };
+    }
+}
+export { ConfigLoader };
+
+//# sourceMappingURL=ConfigLoader.js.map

package/dist/config/ConfigLoader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config/ConfigLoader.js","sources":["../../src/config/ConfigLoader.ts"],"sourcesContent":["/**\n * Configuration file loading with environment variable override support.\n *\n * This module provides the `ConfigLoader` class which handles loading configuration\n * from YAML and JSON files in standard locations, with automatic environment variable\n * overrides for all settings.\n *\n * @module config\n */\n\nimport { existsSync, readFileSync } from 'node:fs';\nimport { homedir } from 'node:os';\nimport { join } from 'node:path';\nimport { parse as parseYaml } from 'yaml';\nimport type { PersistenceConfig } from '../persistence/PersistenceBackend.js';\n\n/**\n * Configuration options loaded from config files.\n *\n * These options represent the structure of configuration files (JSON or YAML)\n * that can be loaded from standard locations. All values can be overridden\n * by environment variables.\n *\n * @example\n * ```yaml\n * # .claude/config.yaml\n * maxHistorySize: 500\n * maxBranches: 25\n * logLevel: debug\n * prettyLog: true\n * skillDirs:\n *   - ./custom-skills\n * discoveryCache:\n *   ttl: 600000\n *   maxSize: 200\n * persistence:\n *   enabled: true\n *   backend: sqlite\n *   options:\n *     dbPath: ./data/history.db\n * ```\n */\nexport interface ConfigFileOptions {\n\t/**\n\t * Maximum number of thoughts to keep in history.\n\t * Can be overridden by `MAX_HISTORY_SIZE` environment variable.\n\t */\n\tmaxHistorySize?: number;\n\n\t/**\n\t * Maximum number of branches to maintain.\n\t * Can be overridden by `MAX_BRANCHES` environment variable.\n\t */\n\tmaxBranches?: number;\n\n\t/**\n\t * Maximum size of each branch.\n\t * Can be overridden by `MAX_BRANCH_SIZE` environment variable.\n\t */\n\tmaxBranchSize?: number;\n\n\t/**\n\t * Logging level for the application.\n\t * Can be overridden by `LOG_LEVEL` environment variable.\n\t */\n\tlogLevel?: 'debug' | 'info' | 'warn' | 'error';\n\n\t/**\n\t * Whether to enable pretty (formatted) logging output.\n\t * Can be overridden by `PRETTY_LOG` environment variable (set to \"false\" to disable).\n\t */\n\tprettyLog?: boolean;\n\n\t/**\n\t * Directory paths to search for skills.\n\t * Can be overridden by `SKILL_DIRS` environment variable (colon-separated).\n\t */\n\tskillDirs?: string[];\n\n\t/**\n\t * Discovery cache configuration.\n\t * Can be overridden by `DISCOVERY_CACHE_TTL` and `DISCOVERY_CACHE_MAX_SIZE` environment variables.\n\t */\n\tdiscoveryCache?: {\n\t\t/**\n\t\t * Time-to-live for cache entries in milliseconds.\n\t\t * Environment variable `DISCOVERY_CACHE_TTL` accepts seconds.\n\t\t */\n\t\tttl?: number;\n\t\t/**\n\t\t * Maximum number of entries in the cache.\n\t\t */\n\t\tmaxSize?: number;\n\t};\n\n\t/**\n\t * Persistence configuration for storing history and state.\n\t */\n\tpersistence?: PersistenceConfig;\n}\n\n/**\n * Loads configuration from files with environment variable overrides.\n *\n * This class searches for configuration files in standard locations and applies\n * environment variable overrides. Files are searched in priority order, with the\n * first match being used. Environment variables always take precedence over file values.\n *\n * @remarks\n * **Config File Search Order (priority):**\n * 1. Custom path (if provided to constructor)\n * 2. `.claude/config.json` (project-local)\n * 3. `.claude/config.yaml` (project-local)\n * 4. `.claude/config.yml` (project-local)\n * 5. `~/.claude/config.json` (user-global)\n * 6. `~/.claude/config.yaml` (user-global)\n * 7. `~/.claude/config.yml` (user-global)\n *\n * **Environment Variable Overrides:**\n * | Variable | Type | Description |\n * |----------|------|-------------|\n * | `MAX_HISTORY_SIZE` | number | Max thoughts in history |\n * | `MAX_BRANCHES` | number | Max number of branches |\n * | `MAX_BRANCH_SIZE` | number | Max size of each branch |\n * | `LOG_LEVEL` | string | Logging level (debug/info/warn/error) |\n * | `PRETTY_LOG` | string | \"false\" to disable pretty logging |\n * | `SKILL_DIRS` | string | Colon-separated directory paths |\n * | `DISCOVERY_CACHE_TTL` | number | TTL in seconds (converted to ms) |\n * | `DISCOVERY_CACHE_MAX_SIZE` | number | Max cache entries |\n *\n * @example\n * ```typescript\n * // Use default search paths\n * const loader1 = new ConfigLoader();\n * const config1 = loader1.load();\n *\n * // Use custom config path\n * const loader2 = new ConfigLoader('./my-config.yaml');\n * const config2 = loader2.load();\n *\n * // Convert to ServerConfig options\n * const serverOptions = loader2.toServerConfigOptions(config2);\n * ```\n */\nexport class ConfigLoader {\n\t/** Array of config file paths to search, in priority order. */\n\tprivate _configPaths: string[];\n\n\t/**\n\t * Creates a new ConfigLoader instance.\n\t *\n\t * @param customPath - Optional custom config file path. If provided, only this path will be checked.\n\t *\n\t * @example\n\t * ```typescript\n\t * // Use default search paths\n\t * const loader1 = new ConfigLoader();\n\t *\n\t * // Use a specific config file\n\t * const loader2 = new ConfigLoader('./custom-config.json');\n\t * ```\n\t */\n\tconstructor(customPath?: string) {\n\t\tthis._configPaths = customPath\n\t\t\t? [customPath]\n\t\t\t: [\n\t\t\t\t\t'.claude/config.json',\n\t\t\t\t\t'.claude/config.yaml',\n\t\t\t\t\t'.claude/config.yml',\n\t\t\t\t\tjoin(homedir(), '.claude/config.json'),\n\t\t\t\t\tjoin(homedir(), '.claude/config.yaml'),\n\t\t\t\t\tjoin(homedir(), '.claude/config.yml'),\n\t\t\t\t];\n\t}\n\n\t/**\n\t * Loads configuration from files and applies environment overrides.\n\t *\n\t * Searches for config files in the configured paths (in priority order),\n\t * parses the first match, and applies environment variable overrides.\n\t * Returns null if no config file is found and no environment overrides are set.\n\t *\n\t * @returns The loaded configuration with environment overrides applied, or null if no config found\n\t *\n\t * @example\n\t * ```typescript\n\t * const loader = new ConfigLoader();\n\t * const config = loader.load();\n\t *\n\t * if (config) {\n\t *   console.log('Max history size:', config.maxHistorySize);\n\t *   console.log('Log level:', config.logLevel);\n\t * }\n\t * ```\n\t */\n\tload(): ConfigFileOptions | null {\n\t\tlet config: ConfigFileOptions | null = null;\n\n\t\tfor (const configPath of this._configPaths) {\n\t\t\tif (existsSync(configPath)) {\n\t\t\t\ttry {\n\t\t\t\t\tconfig = this.parseConfig(configPath);\n\t\t\t\t\tbreak;\n\t\t\t\t} catch (error) {\n\t\t\t\t\tconsole.error(\n\t\t\t\t\t\t`Failed to load config from ${configPath}:`,\n\t\t\t\t\t\terror instanceof Error ? error.message : String(error)\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\treturn this.applyEnvironmentOverrides(config || {});\n\t}\n\n\t/**\n\t * Applies environment variable overrides to the configuration.\n\t *\n\t * Environment variables take precedence over file-based configuration.\n\t * Supported environment variables:\n\t * - `MAX_HISTORY_SIZE`, `MAX_BRANCHES`, `MAX_BRANCH_SIZE` (numbers)\n\t * - `LOG_LEVEL` (debug/info/warn/error)\n\t * - `PRETTY_LOG` (\"false\" to disable)\n\t * - `SKILL_DIRS` (colon-separated paths)\n\t * - `DISCOVERY_CACHE_TTL` (in seconds, converted to ms)\n\t * - `DISCOVERY_CACHE_MAX_SIZE` (number)\n\t *\n\t * @param config - The configuration to apply overrides to\n\t * @returns A new configuration object with environment overrides applied\n\t * @private\n\t */\n\tprivate applyEnvironmentOverrides(config: ConfigFileOptions): ConfigFileOptions {\n\t\tconst result: ConfigFileOptions = { ...config };\n\n\t\tif (process.env.MAX_HISTORY_SIZE) {\n\t\t\tconst parsed = parseInt(process.env.MAX_HISTORY_SIZE, 10);\n\t\t\tif (Number.isFinite(parsed)) {\n\t\t\t\tresult.maxHistorySize = parsed;\n\t\t\t}\n\t\t}\n\t\tif (process.env.MAX_BRANCHES) {\n\t\t\tconst parsed = parseInt(process.env.MAX_BRANCHES, 10);\n\t\t\tif (Number.isFinite(parsed)) {\n\t\t\t\tresult.maxBranches = parsed;\n\t\t\t}\n\t\t}\n\t\tif (process.env.MAX_BRANCH_SIZE) {\n\t\t\tconst parsed = parseInt(process.env.MAX_BRANCH_SIZE, 10);\n\t\t\tif (Number.isFinite(parsed)) {\n\t\t\t\tresult.maxBranchSize = parsed;\n\t\t\t}\n\t\t}\n\t\tif (\n\t\t\tprocess.env.LOG_LEVEL &&\n\t\t\t['debug', 'info', 'warn', 'error'].includes(process.env.LOG_LEVEL)\n\t\t) {\n\t\t\tresult.logLevel = process.env.LOG_LEVEL as 'debug' | 'info' | 'warn' | 'error';\n\t\t}\n\t\tif (process.env.PRETTY_LOG === 'false') {\n\t\t\tresult.prettyLog = false;\n\t\t}\n\t\tif (process.env.SKILL_DIRS) {\n\t\t\tresult.skillDirs = process.env.SKILL_DIRS.split(':');\n\t\t}\n\t\tif (process.env.DISCOVERY_CACHE_TTL) {\n\t\t\tconst parsed = parseInt(process.env.DISCOVERY_CACHE_TTL, 10);\n\t\t\tif (Number.isFinite(parsed)) {\n\t\t\t\tresult.discoveryCache = result.discoveryCache || {};\n\t\t\t\tresult.discoveryCache.ttl = parsed * 1000;\n\t\t\t}\n\t\t}\n\t\tif (process.env.DISCOVERY_CACHE_MAX_SIZE) {\n\t\t\tconst parsed = parseInt(process.env.DISCOVERY_CACHE_MAX_SIZE, 10);\n\t\t\tif (Number.isFinite(parsed)) {\n\t\t\t\tresult.discoveryCache = result.discoveryCache || {};\n\t\t\t\tresult.discoveryCache.maxSize = parsed;\n\t\t\t}\n\t\t}\n\n\t\treturn result;\n\t}\n\n\t/**\n\t * Parses a configuration file (JSON or YAML).\n\t *\n\t * Detects the file type by extension and uses the appropriate parser.\n\t * Supports `.json`, `.yaml`, and `.yml` file extensions.\n\t *\n\t * @param filePath - Path to the configuration file to parse\n\t * @returns The parsed configuration object\n\t * @throws {Error} If the file cannot be parsed\n\t * @private\n\t */\n\tprivate parseConfig(filePath: string): ConfigFileOptions {\n\t\tconst content = readFileSync(filePath, 'utf-8');\n\t\tconst ext = filePath.split('.').pop()?.toLowerCase();\n\n\t\tif (ext === 'yaml' || ext === 'yml') {\n\t\t\treturn parseYaml(content) as ConfigFileOptions;\n\t\t}\n\n\t\treturn JSON.parse(content) as ConfigFileOptions;\n\t}\n\n\t/**\n\t * Converts file-based configuration to ServerConfig options.\n\t *\n\t * This is a convenience method for extracting the ServerConfig-relevant\n\t * options from a file-based configuration.\n\t *\n\t * @param config - The configuration to convert\n\t * @returns An object with ServerConfig-compatible options\n\t *\n\t * @example\n\t * ```typescript\n\t * const loader = new ConfigLoader();\n\t * const config = loader.load();\n\t * if (config) {\n\t *   const serverOpts = loader.toServerConfigOptions(config);\n\t *   const serverConfig = new ServerConfig(serverOpts);\n\t * }\n\t * ```\n\t */\n\ttoServerConfigOptions(config: ConfigFileOptions): {\n\t\tmaxHistorySize?: number;\n\t\tmaxBranches?: number;\n\t\tmaxBranchSize?: number;\n\t} {\n\t\treturn {\n\t\t\tmaxHistorySize: config.maxHistorySize,\n\t\t\tmaxBranches: config.maxBranches,\n\t\t\tmaxBranchSize: config.maxBranchSize,\n\t\t};\n\t}\n}\n"],"names":["ConfigLoader","customPath","join","homedir","config","configPath","existsSync","error","console","Error","String","result","process","parsed","parseInt","Number","filePath","content","readFileSync","ext","parseYaml","JSON"],"mappings":"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"}