@specforge/mcp 2.5.1 → 3.0.0

package/dist/ai-provider/metrics.js

@@ -0,0 +1,187 @@
+/**
+ * Metrics Collection
+ *
+ * Counters and histograms for observability.
+ */
+export class Metrics {
+    counters = new Map();
+    histograms = new Map();
+    gauges = new Map();
+    /**
+     * Increment a counter.
+     */
+    increment(name, value = 1) {
+        const current = this.counters.get(name) || 0;
+        this.counters.set(name, current + value);
+    }
+    /**
+     * Decrement a counter.
+     */
+    decrement(name, value = 1) {
+        const current = this.counters.get(name) || 0;
+        this.counters.set(name, Math.max(0, current - value));
+    }
+    /**
+     * Record a value in a histogram.
+     */
+    histogram(name, value) {
+        const values = this.histograms.get(name) || [];
+        values.push(value);
+        this.histograms.set(name, values);
+    }
+    /**
+     * Set a gauge value.
+     */
+    gauge(name, value) {
+        this.gauges.set(name, value);
+    }
+    /**
+     * Get a counter value.
+     */
+    getCounter(name) {
+        return this.counters.get(name) || 0;
+    }
+    /**
+     * Get a gauge value.
+     */
+    getGauge(name) {
+        return this.gauges.get(name) || 0;
+    }
+    /**
+     * Get histogram statistics.
+     */
+    getHistogramStats(name) {
+        const values = this.histograms.get(name);
+        if (!values || values.length === 0)
+            return null;
+        const sorted = [...values].sort((a, b) => a - b);
+        const count = sorted.length;
+        return {
+            count,
+            min: sorted[0],
+            max: sorted[count - 1],
+            avg: sorted.reduce((a, b) => a + b, 0) / count,
+            p50: this.percentile(sorted, 0.5),
+            p95: this.percentile(sorted, 0.95),
+            p99: this.percentile(sorted, 0.99),
+        };
+    }
+    /**
+     * Get all metrics.
+     */
+    getAll() {
+        const histograms = {};
+        for (const name of this.histograms.keys()) {
+            histograms[name] = this.getHistogramStats(name);
+        }
+        return {
+            counters: Object.fromEntries(this.counters),
+            gauges: Object.fromEntries(this.gauges),
+            histograms,
+        };
+    }
+    /**
+     * Reset all metrics.
+     */
+    reset() {
+        this.counters.clear();
+        this.histograms.clear();
+        this.gauges.clear();
+    }
+    /**
+     * Reset a specific metric.
+     */
+    resetMetric(name) {
+        this.counters.delete(name);
+        this.histograms.delete(name);
+        this.gauges.delete(name);
+    }
+    /**
+     * Export metrics as Prometheus-style text.
+     */
+    toPrometheus() {
+        const lines = [];
+        // Counters
+        for (const [name, value] of this.counters) {
+            const safeName = name.replace(/\./g, '_');
+            lines.push(`# TYPE ${safeName} counter`);
+            lines.push(`${safeName} ${value}`);
+        }
+        // Gauges
+        for (const [name, value] of this.gauges) {
+            const safeName = name.replace(/\./g, '_');
+            lines.push(`# TYPE ${safeName} gauge`);
+            lines.push(`${safeName} ${value}`);
+        }
+        // Histograms
+        for (const [name, values] of this.histograms) {
+            if (values.length === 0)
+                continue;
+            const safeName = name.replace(/\./g, '_');
+            const stats = this.getHistogramStats(name);
+            if (!stats)
+                continue;
+            lines.push(`# TYPE ${safeName} histogram`);
+            lines.push(`${safeName}_count ${stats.count}`);
+            lines.push(`${safeName}_sum ${values.reduce((a, b) => a + b, 0)}`);
+            lines.push(`${safeName}_min ${stats.min}`);
+            lines.push(`${safeName}_max ${stats.max}`);
+            lines.push(`${safeName}{quantile="0.5"} ${stats.p50}`);
+            lines.push(`${safeName}{quantile="0.95"} ${stats.p95}`);
+            lines.push(`${safeName}{quantile="0.99"} ${stats.p99}`);
+        }
+        return lines.join('\n');
+    }
+    /**
+     * Calculate percentile from sorted array.
+     */
+    percentile(sorted, p) {
+        const index = Math.ceil(sorted.length * p) - 1;
+        return sorted[Math.max(0, Math.min(index, sorted.length - 1))];
+    }
+}
+/**
+ * Global metrics instance.
+ */
+let globalMetrics = null;
+/**
+ * Get or create global metrics instance.
+ */
+export function getMetrics() {
+    if (!globalMetrics) {
+        globalMetrics = new Metrics();
+    }
+    return globalMetrics;
+}
+/**
+ * Create a new metrics instance.
+ */
+export function createMetrics() {
+    return new Metrics();
+}
+// Metric name constants for consistency
+export const METRIC_NAMES = {
+    // Request metrics
+    REQUESTS_STARTED: 'requests.started',
+    REQUESTS_SUCCESS: 'requests.success',
+    REQUESTS_FAILURE: 'requests.failure',
+    REQUESTS_TIMEOUT: 'requests.timeout',
+    REQUESTS_CIRCUIT_BLOCKED: 'requests.circuit_breaker_blocked',
+    // Duration metrics
+    REQUEST_DURATION_MS: 'requests.duration_ms',
+    SPAWN_DURATION_MS: 'spawn.duration_ms',
+    // Process metrics
+    PROCESSES_ACTIVE: 'processes.active',
+    PROCESSES_SPAWNED: 'processes.spawned',
+    PROCESSES_KILLED: 'processes.killed',
+    // Error metrics
+    ERRORS_AUTH: 'errors.auth',
+    ERRORS_RATE_LIMIT: 'errors.rate_limit',
+    ERRORS_TIMEOUT: 'errors.timeout',
+    ERRORS_NETWORK: 'errors.network',
+    ERRORS_UNKNOWN: 'errors.unknown',
+    // Retry metrics
+    RETRIES_ATTEMPTED: 'retries.attempted',
+    RETRIES_SUCCESS: 'retries.success',
+};
+//# sourceMappingURL=metrics.js.map

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

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

package/dist/ai-provider/process-manager.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Claude Code Process Manager
+ *
+ * Core module for spawning and managing Claude CLI processes.
+ */
+import type { ProcessManagerConfig, ProcessResult, ProcessStatus } from './types.js';
+/**
+ * Claude CLI Process Manager.
+ */
+export declare class ClaudeCodeProcessManager {
+    private config;
+    private semaphore;
+    private circuitBreaker;
+    private retryExecutor;
+    private activeProcesses;
+    private isRateLimited;
+    private rateLimitMessage?;
+    private metrics;
+    private tracer;
+    private isShuttingDown;
+    constructor(config: ProcessManagerConfig);
+    /**
+     * Check if user is authenticated with Claude Code.
+     */
+    checkAuth(): Promise<{
+        authenticated: boolean;
+        error?: string;
+        cliVersion?: string;
+    }>;
+    /**
+     * Run a prompt using Claude Code CLI.
+     */
+    run(prompt: string, options?: {
+        workingDirectory?: string;
+        timeout?: number;
+        model?: 'sonnet' | 'opus';
+        sessionId?: string;
+    }): Promise<ProcessResult>;
+    /**
+     * Execute prompt with CLI.
+     */
+    private executePrompt;
+    /**
+     * Spawn a Claude CLI process.
+     */
+    private spawn;
+    /**
+     * Detect rate limit errors from CLI output.
+     */
+    private isRateLimitError;
+    /**
+     * Detect auth errors from CLI output.
+     */
+    private isAuthError;
+    /**
+     * Check if error is retryable.
+     */
+    private isRetryable;
+    /**
+     * Categorize error type.
+     */
+    private categorizeError;
+    /**
+     * Get current status.
+     */
+    getStatus(): ProcessStatus;
+    /**
+     * Reset rate limit flag (after user switches accounts).
+     */
+    resetRateLimitFlag(): void;
+    /**
+     * Get metrics.
+     */
+    getMetrics(): {
+        counters: Record<string, number>;
+        gauges: Record<string, number>;
+        histograms: Record<string, import("./types.js").MetricStats | null>;
+    };
+    /**
+     * Graceful shutdown.
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Health check.
+     */
+    healthCheck(): Promise<{
+        healthy: boolean;
+        details: Record<string, unknown>;
+    }>;
+}
+/**
+ * Create a process manager with configuration.
+ */
+export declare function createProcessManager(config: Partial<ProcessManagerConfig> & {
+    workingDirectory: string;
+}): ClaudeCodeProcessManager;
+//# sourceMappingURL=process-manager.d.ts.map

package/dist/ai-provider/process-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-manager.d.ts","sourceRoot":"","sources":["../../src/ai-provider/process-manager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EACV,oBAAoB,EACpB,aAAa,EACb,aAAa,EAEd,MAAM,YAAY,CAAC;AAoCpB;;GAEG;AACH,qBAAa,wBAAwB;IAWvB,OAAO,CAAC,MAAM;IAV1B,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,eAAe,CAAwC;IAC/D,OAAO,CAAC,aAAa,CAAkB;IACvC,OAAO,CAAC,gBAAgB,CAAC,CAAS;IAClC,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,cAAc,CAAkB;gBAEpB,MAAM,EAAE,oBAAoB;IAchD;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC;QACzB,aAAa,EAAE,OAAO,CAAC;QACvB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;IA0CF;;OAEG;IACG,GAAG,CACP,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;QAAE,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GACvG,OAAO,CAAC,aAAa,CAAC;IAgFzB;;OAEG;YACW,aAAa;IAyE3B;;OAEG;YACW,KAAK;IA2HnB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAKxB;;OAEG;IACH,OAAO,CAAC,WAAW;IAKnB;;OAEG;IACH,OAAO,CAAC,WAAW;IAMnB;;OAEG;IACH,OAAO,CAAC,eAAe;IAqBvB;;OAEG;IACH,SAAS,IAAI,aAAa;IAS1B;;OAEG;IACH,kBAAkB,IAAI,IAAI;IAM1B;;OAEG;IACH,UAAU;;;;;IAIV;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAyC/B;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC;QAC3B,OAAO,EAAE,OAAO,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAClC,CAAC;CAkBH;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG;IAAE,gBAAgB,EAAE,MAAM,CAAA;CAAE,GACnE,wBAAwB,CAS1B"}