@specforge/mcp 2.5.1 → 3.0.0

package/dist/ai-provider/lifecycle.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Process Lifecycle Manager
+ *
+ * Handles graceful shutdown on SIGTERM, SIGINT, and SIGHUP.
+ */
+import { ClaudeCodeProcessManager } from './process-manager.js';
+export declare class ProcessLifecycleManager {
+    private processManager?;
+    private shutdownInProgress;
+    private shutdownHandlers;
+    private signalsRegistered;
+    constructor(processManager?: ClaudeCodeProcessManager | undefined);
+    /**
+     * Set the process manager to manage.
+     */
+    setProcessManager(processManager: ClaudeCodeProcessManager): void;
+    /**
+     * Register an additional shutdown handler.
+     */
+    onShutdown(handler: () => Promise<void>): void;
+    /**
+     * Check if shutdown is in progress.
+     */
+    isShuttingDown(): boolean;
+    /**
+     * Manually trigger shutdown.
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Setup signal handlers.
+     */
+    private setupSignalHandlers;
+    /**
+     * Perform the shutdown sequence.
+     */
+    private performShutdown;
+}
+/**
+ * Get or create global lifecycle manager.
+ */
+export declare function getLifecycleManager(): ProcessLifecycleManager;
+/**
+ * Create a lifecycle manager for a process manager.
+ */
+export declare function createLifecycleManager(processManager: ClaudeCodeProcessManager): ProcessLifecycleManager;
+/**
+ * Register a global shutdown handler.
+ */
+export declare function onShutdown(handler: () => Promise<void>): void;
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/ai-provider/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../src/ai-provider/lifecycle.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAMhE,qBAAa,uBAAuB;IAKtB,OAAO,CAAC,cAAc,CAAC;IAJnC,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,gBAAgB,CAAkC;IAC1D,OAAO,CAAC,iBAAiB,CAAS;gBAEd,cAAc,CAAC,EAAE,wBAAwB,YAAA;IAO7D;;OAEG;IACH,iBAAiB,CAAC,cAAc,EAAE,wBAAwB,GAAG,IAAI;IAIjE;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAI9C;;OAEG;IACH,cAAc,IAAI,OAAO;IAIzB;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAS/B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAyC3B;;OAEG;YACW,eAAe;CAiC9B;AAOD;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,uBAAuB,CAK7D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,cAAc,EAAE,wBAAwB,GACvC,uBAAuB,CAEzB;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAE7D"}

package/dist/ai-provider/lifecycle.js

@@ -0,0 +1,145 @@
+/**
+ * Process Lifecycle Manager
+ *
+ * Handles graceful shutdown on SIGTERM, SIGINT, and SIGHUP.
+ */
+import { createLogger } from './logger.js';
+const logger = createLogger('ProcessLifecycle');
+export class ProcessLifecycleManager {
+    processManager;
+    shutdownInProgress = false;
+    shutdownHandlers = [];
+    signalsRegistered = false;
+    constructor(processManager) {
+        this.processManager = processManager;
+        // Only setup signal handlers in Node.js environment
+        if (typeof process !== 'undefined' && typeof process.on === 'function') {
+            this.setupSignalHandlers();
+        }
+    }
+    /**
+     * Set the process manager to manage.
+     */
+    setProcessManager(processManager) {
+        this.processManager = processManager;
+    }
+    /**
+     * Register an additional shutdown handler.
+     */
+    onShutdown(handler) {
+        this.shutdownHandlers.push(handler);
+    }
+    /**
+     * Check if shutdown is in progress.
+     */
+    isShuttingDown() {
+        return this.shutdownInProgress;
+    }
+    /**
+     * Manually trigger shutdown.
+     */
+    async shutdown() {
+        if (this.shutdownInProgress) {
+            logger.warn('Shutdown already in progress');
+            return;
+        }
+        await this.performShutdown('manual');
+    }
+    /**
+     * Setup signal handlers.
+     */
+    setupSignalHandlers() {
+        if (this.signalsRegistered) {
+            return;
+        }
+        const signals = ['SIGTERM', 'SIGINT', 'SIGHUP'];
+        for (const signal of signals) {
+            process.on(signal, () => {
+                this.performShutdown(signal).then(() => {
+                    process.exit(0);
+                }).catch((error) => {
+                    logger.error('Error during shutdown', { error: error.message });
+                    process.exit(1);
+                });
+            });
+        }
+        // Handle uncaught exceptions
+        process.on('uncaughtException', (error) => {
+            logger.error('Uncaught exception', {
+                error: error.message,
+                stack: error.stack,
+            });
+            this.performShutdown('uncaughtException').finally(() => {
+                process.exit(1);
+            });
+        });
+        // Handle unhandled promise rejections
+        process.on('unhandledRejection', (reason) => {
+            logger.error('Unhandled rejection', {
+                reason: String(reason),
+            });
+        });
+        this.signalsRegistered = true;
+        logger.debug('Signal handlers registered');
+    }
+    /**
+     * Perform the shutdown sequence.
+     */
+    async performShutdown(signal) {
+        if (this.shutdownInProgress) {
+            return;
+        }
+        this.shutdownInProgress = true;
+        logger.info(`Received ${signal}, starting graceful shutdown...`);
+        try {
+            // Run custom shutdown handlers first
+            for (const handler of this.shutdownHandlers) {
+                try {
+                    await handler();
+                }
+                catch (error) {
+                    logger.warn('Shutdown handler error', {
+                        error: error.message,
+                    });
+                }
+            }
+            // Shutdown process manager
+            if (this.processManager) {
+                await this.processManager.shutdown();
+            }
+            logger.info('Graceful shutdown completed');
+        }
+        catch (error) {
+            logger.error('Error during shutdown', {
+                error: error.message,
+            });
+            throw error;
+        }
+    }
+}
+/**
+ * Global lifecycle manager instance.
+ */
+let globalLifecycleManager = null;
+/**
+ * Get or create global lifecycle manager.
+ */
+export function getLifecycleManager() {
+    if (!globalLifecycleManager) {
+        globalLifecycleManager = new ProcessLifecycleManager();
+    }
+    return globalLifecycleManager;
+}
+/**
+ * Create a lifecycle manager for a process manager.
+ */
+export function createLifecycleManager(processManager) {
+    return new ProcessLifecycleManager(processManager);
+}
+/**
+ * Register a global shutdown handler.
+ */
+export function onShutdown(handler) {
+    getLifecycleManager().onShutdown(handler);
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/ai-provider/lifecycle.js.map

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

package/dist/ai-provider/logger.d.ts

@@ -0,0 +1,69 @@
+/**
+ * AI Provider Logger
+ *
+ * Structured JSON logging with request ID support.
+ */
+import type { LogLevel } from './types.js';
+export declare class Logger {
+    private component;
+    private static globalRequestId?;
+    private static logLevel;
+    constructor(component: string);
+    /**
+     * Set global request ID for correlation
+     */
+    static setRequestId(requestId: string): void;
+    /**
+     * Clear global request ID
+     */
+    static clearRequestId(): void;
+    /**
+     * Get current request ID
+     */
+    static getRequestId(): string | undefined;
+    /**
+     * Set minimum log level
+     */
+    static setLogLevel(level: LogLevel): void;
+    /**
+     * Check if a log level should be output
+     */
+    private shouldLog;
+    /**
+     * Log debug message
+     */
+    debug(message: string, context?: Record<string, unknown>): void;
+    /**
+     * Log info message
+     */
+    info(message: string, context?: Record<string, unknown>): void;
+    /**
+     * Log warning message
+     */
+    warn(message: string, context?: Record<string, unknown>): void;
+    /**
+     * Log error message
+     */
+    error(message: string, context?: Record<string, unknown>): void;
+    /**
+     * Log error with Error object
+     */
+    errorWithException(message: string, error: Error, context?: Record<string, unknown>): void;
+    /**
+     * Create a child logger with additional context
+     */
+    child(subComponent: string): Logger;
+    /**
+     * Core logging method
+     */
+    private log;
+    /**
+     * Sanitize context to prevent PII logging
+     */
+    private sanitizeContext;
+}
+/**
+ * Create a logger for a specific component
+ */
+export declare function createLogger(component: string): Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/ai-provider/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/ai-provider/logger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAY,MAAM,YAAY,CAAC;AAMrD,qBAAa,MAAM;IAIL,OAAO,CAAC,SAAS;IAH7B,OAAO,CAAC,MAAM,CAAC,eAAe,CAAC,CAAS;IACxC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAoB;gBAEvB,SAAS,EAAE,MAAM;IAErC;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAI5C;;OAEG;IACH,MAAM,CAAC,cAAc,IAAI,IAAI;IAI7B;;OAEG;IACH,MAAM,CAAC,YAAY,IAAI,MAAM,GAAG,SAAS;IAIzC;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAIzC;;OAEG;IACH,OAAO,CAAC,SAAS;IAOjB;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI/D;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI9D;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI9D;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI/D;;OAEG;IACH,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAW1F;;OAEG;IACH,KAAK,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;IAInC;;OAEG;IACH,OAAO,CAAC,GAAG;IAiCX;;OAEG;IACH,OAAO,CAAC,eAAe;CAyBxB;AAMD;;GAEG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEtD"}

package/dist/ai-provider/logger.js

@@ -0,0 +1,161 @@
+/**
+ * AI Provider Logger
+ *
+ * Structured JSON logging with request ID support.
+ */
+// ============================================================================
+// Logger Class
+// ============================================================================
+export class Logger {
+    component;
+    static globalRequestId;
+    static logLevel = 'info';
+    constructor(component) {
+        this.component = component;
+    }
+    /**
+     * Set global request ID for correlation
+     */
+    static setRequestId(requestId) {
+        Logger.globalRequestId = requestId;
+    }
+    /**
+     * Clear global request ID
+     */
+    static clearRequestId() {
+        Logger.globalRequestId = undefined;
+    }
+    /**
+     * Get current request ID
+     */
+    static getRequestId() {
+        return Logger.globalRequestId;
+    }
+    /**
+     * Set minimum log level
+     */
+    static setLogLevel(level) {
+        Logger.logLevel = level;
+    }
+    /**
+     * Check if a log level should be output
+     */
+    shouldLog(level) {
+        const levels = ['debug', 'info', 'warn', 'error'];
+        const currentIndex = levels.indexOf(Logger.logLevel);
+        const messageIndex = levels.indexOf(level);
+        return messageIndex >= currentIndex;
+    }
+    /**
+     * Log debug message
+     */
+    debug(message, context) {
+        this.log('debug', message, context);
+    }
+    /**
+     * Log info message
+     */
+    info(message, context) {
+        this.log('info', message, context);
+    }
+    /**
+     * Log warning message
+     */
+    warn(message, context) {
+        this.log('warn', message, context);
+    }
+    /**
+     * Log error message
+     */
+    error(message, context) {
+        this.log('error', message, context);
+    }
+    /**
+     * Log error with Error object
+     */
+    errorWithException(message, error, context) {
+        this.log('error', message, {
+            ...context,
+            error: {
+                name: error.name,
+                message: error.message,
+                stack: error.stack,
+            },
+        });
+    }
+    /**
+     * Create a child logger with additional context
+     */
+    child(subComponent) {
+        return new Logger(`${this.component}:${subComponent}`);
+    }
+    /**
+     * Core logging method
+     */
+    log(level, message, context) {
+        if (!this.shouldLog(level)) {
+            return;
+        }
+        const entry = {
+            timestamp: new Date().toISOString(),
+            level,
+            component: this.component,
+            message,
+            context: this.sanitizeContext(context),
+            requestId: Logger.globalRequestId,
+        };
+        // Structured JSON logging
+        const output = JSON.stringify(entry);
+        switch (level) {
+            case 'debug':
+                console.debug(output);
+                break;
+            case 'info':
+                console.info(output);
+                break;
+            case 'warn':
+                console.warn(output);
+                break;
+            case 'error':
+                console.error(output);
+                break;
+        }
+    }
+    /**
+     * Sanitize context to prevent PII logging
+     */
+    sanitizeContext(context) {
+        if (!context) {
+            return undefined;
+        }
+        const sanitized = {};
+        const sensitiveKeys = ['password', 'token', 'apiKey', 'secret', 'credential', 'auth'];
+        for (const [key, value] of Object.entries(context)) {
+            const lowerKey = key.toLowerCase();
+            const isSensitive = sensitiveKeys.some(sk => lowerKey.includes(sk));
+            if (isSensitive) {
+                sanitized[key] = '[REDACTED]';
+            }
+            else if (typeof value === 'string' && value.length > 1000) {
+                sanitized[key] = value.substring(0, 1000) + '...[TRUNCATED]';
+            }
+            else if (typeof value === 'object' && value !== null) {
+                sanitized[key] = this.sanitizeContext(value);
+            }
+            else {
+                sanitized[key] = value;
+            }
+        }
+        return sanitized;
+    }
+}
+// ============================================================================
+// Factory Function
+// ============================================================================
+/**
+ * Create a logger for a specific component
+ */
+export function createLogger(component) {
+    return new Logger(component);
+}
+//# sourceMappingURL=logger.js.map

package/dist/ai-provider/logger.js.map

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

package/dist/ai-provider/metrics.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Metrics Collection
+ *
+ * Counters and histograms for observability.
+ */
+import type { MetricStats } from './types.js';
+export declare class Metrics {
+    private counters;
+    private histograms;
+    private gauges;
+    /**
+     * Increment a counter.
+     */
+    increment(name: string, value?: number): void;
+    /**
+     * Decrement a counter.
+     */
+    decrement(name: string, value?: number): void;
+    /**
+     * Record a value in a histogram.
+     */
+    histogram(name: string, value: number): void;
+    /**
+     * Set a gauge value.
+     */
+    gauge(name: string, value: number): void;
+    /**
+     * Get a counter value.
+     */
+    getCounter(name: string): number;
+    /**
+     * Get a gauge value.
+     */
+    getGauge(name: string): number;
+    /**
+     * Get histogram statistics.
+     */
+    getHistogramStats(name: string): MetricStats | null;
+    /**
+     * Get all metrics.
+     */
+    getAll(): {
+        counters: Record<string, number>;
+        gauges: Record<string, number>;
+        histograms: Record<string, MetricStats | null>;
+    };
+    /**
+     * Reset all metrics.
+     */
+    reset(): void;
+    /**
+     * Reset a specific metric.
+     */
+    resetMetric(name: string): void;
+    /**
+     * Export metrics as Prometheus-style text.
+     */
+    toPrometheus(): string;
+    /**
+     * Calculate percentile from sorted array.
+     */
+    private percentile;
+}
+/**
+ * Get or create global metrics instance.
+ */
+export declare function getMetrics(): Metrics;
+/**
+ * Create a new metrics instance.
+ */
+export declare function createMetrics(): Metrics;
+export declare const METRIC_NAMES: {
+    readonly REQUESTS_STARTED: "requests.started";
+    readonly REQUESTS_SUCCESS: "requests.success";
+    readonly REQUESTS_FAILURE: "requests.failure";
+    readonly REQUESTS_TIMEOUT: "requests.timeout";
+    readonly REQUESTS_CIRCUIT_BLOCKED: "requests.circuit_breaker_blocked";
+    readonly REQUEST_DURATION_MS: "requests.duration_ms";
+    readonly SPAWN_DURATION_MS: "spawn.duration_ms";
+    readonly PROCESSES_ACTIVE: "processes.active";
+    readonly PROCESSES_SPAWNED: "processes.spawned";
+    readonly PROCESSES_KILLED: "processes.killed";
+    readonly ERRORS_AUTH: "errors.auth";
+    readonly ERRORS_RATE_LIMIT: "errors.rate_limit";
+    readonly ERRORS_TIMEOUT: "errors.timeout";
+    readonly ERRORS_NETWORK: "errors.network";
+    readonly ERRORS_UNKNOWN: "errors.unknown";
+    readonly RETRIES_ATTEMPTED: "retries.attempted";
+    readonly RETRIES_SUCCESS: "retries.success";
+};
+//# sourceMappingURL=metrics.d.ts.map

package/dist/ai-provider/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../src/ai-provider/metrics.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,qBAAa,OAAO;IAClB,OAAO,CAAC,QAAQ,CAAkC;IAClD,OAAO,CAAC,UAAU,CAAoC;IACtD,OAAO,CAAC,MAAM,CAAkC;IAEhD;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,IAAI;IAKhD;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,IAAI;IAKhD;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAM5C;;OAEG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAIxC;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAIhC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAI9B;;OAEG;IACH,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAkBnD;;OAEG;IACH,MAAM,IAAI;QACR,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACjC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC/B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC,CAAC;KAChD;IAaD;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAM/B;;OAEG;IACH,YAAY,IAAI,MAAM;IAsCtB;;OAEG;IACH,OAAO,CAAC,UAAU;CAInB;AAOD;;GAEG;AACH,wBAAgB,UAAU,IAAI,OAAO,CAKpC;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAGD,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;CA2Bf,CAAC"}