@codebaz/nextdoctor-agent 0.1.0-beta.1

package/dist/system-monitor.d.ts

@@ -0,0 +1,124 @@
+import type { LogLevel } from './types.js';
+export interface CPUMetrics {
+    timestamp: number;
+    usage: number;
+    loadAverage: {
+        oneMinute: number;
+        fiveMinutes: number;
+        fifteenMinutes: number;
+    };
+    coreCount: number;
+    systemLoadPerCore: number;
+}
+export interface MemoryMetrics {
+    timestamp: number;
+    heapUsed: number;
+    heapTotal: number;
+    external: number;
+    arrayBuffers: number;
+    heapUsagePercent: number;
+    systemMemoryUsed: number;
+    systemMemoryTotal: number;
+    systemMemoryUsagePercent: number;
+}
+export interface SystemMetrics {
+    cpu: CPUMetrics;
+    memory: MemoryMetrics;
+    uptime: number;
+}
+/**
+ * CPU Monitor - Real-time CPU usage tracking
+ */
+export declare class CPUMonitor {
+    private static readonly SAMPLE_INTERVAL;
+    private lastCPUTimes;
+    private lastSampleTime;
+    private logFn?;
+    constructor(logFn?: (level: LogLevel, message: string, meta?: any) => void);
+    private initializeBaseline;
+    /**
+     * Calcula o uso de CPU em percentual
+     */
+    getCPUUsage(): CPUMetrics;
+    /**
+     * Monitora CPU e alerta se exceder threshold
+     */
+    checkCPUThreshold(threshold?: number): {
+        exceeded: boolean;
+        usage: number;
+    };
+}
+/**
+ * Memory Monitor - Real-time memory usage tracking
+ */
+export declare class MemoryMonitor {
+    private logFn?;
+    constructor(logFn?: (level: LogLevel, message: string, meta?: any) => void);
+    /**
+     * Obtém métricas de memória
+     */
+    getMemoryMetrics(): MemoryMetrics;
+    /**
+     * Verifica se memória excedeu threshold
+     */
+    checkMemoryThreshold(threshold?: number): {
+        heapExceeded: boolean;
+        systemExceeded: boolean;
+        metrics: MemoryMetrics;
+    };
+    /**
+     * Formata bytes para string legível
+     */
+    formatBytes(bytes: number): string;
+}
+/**
+ * System Monitor - Unified system metrics collector
+ */
+export declare class SystemMonitor {
+    private cpuMonitor;
+    private memoryMonitor;
+    private startTime;
+    private logFn?;
+    constructor(logFn?: (level: LogLevel, message: string, meta?: any) => void);
+    /**
+     * Coleta todas as métricas do sistema
+     */
+    getSystemMetrics(): SystemMetrics;
+    /**
+     * Monitora saúde geral do sistema
+     */
+    getSystemHealth(cpuThreshold?: number, memThreshold?: number): {
+        healthy: boolean;
+        warnings: string[];
+        metrics: SystemMetrics;
+    };
+    /**
+     * Dashboard-friendly summary
+     */
+    getSummary(): {
+        status: string;
+        cpu: {
+            usage: string;
+            cores: number;
+            load: {
+                oneMinute: number;
+                fiveMinutes: number;
+                fifteenMinutes: number;
+            };
+        };
+        memory: {
+            heap: {
+                used: string;
+                total: string;
+                usage: string;
+            };
+            system: {
+                used: string;
+                total: string;
+                usage: string;
+            };
+        };
+        warnings: string[];
+    };
+}
+//# sourceMappingURL=system-monitor.d.ts.map

package/dist/system-monitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system-monitor.d.ts","sourceRoot":"","sources":["../src/system-monitor.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE;QACX,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,wBAAwB,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,UAAU,CAAC;IAChB,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAO;IAC9C,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,cAAc,CAAqB;IAC3C,OAAO,CAAC,KAAK,CAAC,CAAyD;gBAE3D,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,IAAI;IAK1E,OAAO,CAAC,kBAAkB;IAY1B;;OAEG;IACH,WAAW,IAAI,UAAU;IA4CzB;;OAEG;IACH,iBAAiB,CAAC,SAAS,GAAE,MAAW,GAAG;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE;CAmBhF;AAED;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CAAC,CAAyD;gBAE3D,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,IAAI;IAI1E;;OAEG;IACH,gBAAgB,IAAI,aAAa;IAsBjC;;OAEG;IACH,oBAAoB,CAAC,SAAS,GAAE,MAAW,GAAG;QAC5C,YAAY,EAAE,OAAO,CAAC;QACtB,cAAc,EAAE,OAAO,CAAC;QACxB,OAAO,EAAE,aAAa,CAAC;KACxB;IAqBD;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;CAOnC;AAED;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,SAAS,CAAc;IAC/B,OAAO,CAAC,KAAK,CAAC,CAAyD;gBAE3D,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,IAAI;IAM1E;;OAEG;IACH,gBAAgB,IAAI,aAAa;IAQjC;;OAEG;IACH,eAAe,CAAC,YAAY,GAAE,MAAW,EAAE,YAAY,GAAE,MAAW,GAAG;QACrE,OAAO,EAAE,OAAO,CAAC;QACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,OAAO,EAAE,aAAa,CAAC;KACxB;IA0BD;;OAEG;IACH,UAAU;;;;;;2BApQG,MAAM;6BACJ,MAAM;gCACH,MAAM;;;;;;;;;;;;;;;;;CA4RzB"}

package/dist/system-monitor.js

@@ -0,0 +1,221 @@
+import { cpus, loadavg, totalmem, freemem } from 'os';
+import { performance } from 'perf_hooks';
+/**
+ * CPU Monitor - Real-time CPU usage tracking
+ */
+export class CPUMonitor {
+    static SAMPLE_INTERVAL = 100; // ms
+    lastCPUTimes = [];
+    lastSampleTime = performance.now();
+    logFn;
+    constructor(logFn) {
+        this.logFn = logFn;
+        this.initializeBaseline();
+    }
+    initializeBaseline() {
+        const cpus_info = cpus();
+        this.lastCPUTimes = cpus_info.map((cpu) => {
+            return (cpu.times.user +
+                cpu.times.sys +
+                cpu.times.idle +
+                cpu.times.irq);
+        });
+    }
+    /**
+     * Calcula o uso de CPU em percentual
+     */
+    getCPUUsage() {
+        const cpus_info = cpus();
+        const coreCount = cpus_info.length;
+        const [one, five, fifteen] = loadavg();
+        // Calculate average CPU usage across all cores
+        let totalUsage = 0;
+        cpus_info.forEach((cpu, index) => {
+            const currentTime = cpu.times.user +
+                cpu.times.sys +
+                cpu.times.idle +
+                cpu.times.irq;
+            const lastTime = this.lastCPUTimes[index] || currentTime;
+            const timeDiff = currentTime - lastTime;
+            if (timeDiff > 0) {
+                const userTime = cpu.times.user - (this.lastCPUTimes[index] || 0);
+                const systemTime = cpu.times.sys - (this.lastCPUTimes[index] || 0);
+                const usage = ((userTime + systemTime) / timeDiff) * 100;
+                totalUsage += Math.min(100, Math.max(0, usage));
+            }
+            this.lastCPUTimes[index] = currentTime;
+        });
+        const averageUsage = totalUsage / coreCount;
+        const systemLoadPerCore = one / coreCount;
+        return {
+            timestamp: Date.now(),
+            usage: Math.round(averageUsage * 100) / 100,
+            loadAverage: {
+                oneMinute: Math.round(one * 100) / 100,
+                fiveMinutes: Math.round(five * 100) / 100,
+                fifteenMinutes: Math.round(fifteen * 100) / 100,
+            },
+            coreCount,
+            systemLoadPerCore: Math.round(systemLoadPerCore * 100) / 100,
+        };
+    }
+    /**
+     * Monitora CPU e alerta se exceder threshold
+     */
+    checkCPUThreshold(threshold = 80) {
+        const metrics = this.getCPUUsage();
+        const exceeded = metrics.usage > threshold;
+        if (exceeded && this.logFn) {
+            // @ts-ignore
+            this.logFn(2, `CPU usage exceeded threshold: ${metrics.usage}% > ${threshold}%`, {
+                usage: metrics.usage,
+                threshold,
+                cores: metrics.coreCount,
+                systemLoad: metrics.loadAverage,
+            });
+        }
+        return {
+            exceeded,
+            usage: metrics.usage,
+        };
+    }
+}
+/**
+ * Memory Monitor - Real-time memory usage tracking
+ */
+export class MemoryMonitor {
+    logFn;
+    constructor(logFn) {
+        this.logFn = logFn;
+    }
+    /**
+     * Obtém métricas de memória
+     */
+    getMemoryMetrics() {
+        const memUsage = process.memoryUsage();
+        const systemTotal = totalmem();
+        const systemFree = freemem();
+        const systemUsed = systemTotal - systemFree;
+        const heapUsagePercent = (memUsage.heapUsed / memUsage.heapTotal) * 100;
+        const systemMemoryUsagePercent = (systemUsed / systemTotal) * 100;
+        return {
+            timestamp: Date.now(),
+            heapUsed: memUsage.heapUsed,
+            heapTotal: memUsage.heapTotal,
+            external: memUsage.external,
+            arrayBuffers: memUsage.arrayBuffers || 0,
+            heapUsagePercent: Math.round(heapUsagePercent * 100) / 100,
+            systemMemoryUsed: systemUsed,
+            systemMemoryTotal: systemTotal,
+            systemMemoryUsagePercent: Math.round(systemMemoryUsagePercent * 100) / 100,
+        };
+    }
+    /**
+     * Verifica se memória excedeu threshold
+     */
+    checkMemoryThreshold(threshold = 85) {
+        const metrics = this.getMemoryMetrics();
+        const heapExceeded = metrics.heapUsagePercent > threshold;
+        const systemExceeded = metrics.systemMemoryUsagePercent > threshold;
+        if ((heapExceeded || systemExceeded) && this.logFn) {
+            // @ts-ignore
+            this.logFn(2, 'Memory threshold exceeded', {
+                heap: `${metrics.heapUsagePercent}% (${Math.round(metrics.heapUsed / 1024 / 1024)}MB)`,
+                system: `${metrics.systemMemoryUsagePercent}% (${Math.round(metrics.systemMemoryUsed / 1024 / 1024 / 1024)}GB)`,
+                threshold,
+            });
+        }
+        return {
+            heapExceeded,
+            systemExceeded,
+            metrics,
+        };
+    }
+    /**
+     * Formata bytes para string legível
+     */
+    formatBytes(bytes) {
+        if (bytes === 0)
+            return '0 B';
+        const k = 1024;
+        const sizes = ['B', 'KB', 'MB', 'GB', 'TB'];
+        const i = Math.floor(Math.log(bytes) / Math.log(k));
+        return Math.round((bytes / Math.pow(k, i)) * 100) / 100 + ' ' + sizes[i];
+    }
+}
+/**
+ * System Monitor - Unified system metrics collector
+ */
+export class SystemMonitor {
+    cpuMonitor;
+    memoryMonitor;
+    startTime = Date.now();
+    logFn;
+    constructor(logFn) {
+        this.logFn = logFn;
+        this.cpuMonitor = new CPUMonitor(logFn);
+        this.memoryMonitor = new MemoryMonitor(logFn);
+    }
+    /**
+     * Coleta todas as métricas do sistema
+     */
+    getSystemMetrics() {
+        return {
+            cpu: this.cpuMonitor.getCPUUsage(),
+            memory: this.memoryMonitor.getMemoryMetrics(),
+            uptime: Date.now() - this.startTime,
+        };
+    }
+    /**
+     * Monitora saúde geral do sistema
+     */
+    getSystemHealth(cpuThreshold = 80, memThreshold = 85) {
+        const metrics = this.getSystemMetrics();
+        const warnings = [];
+        const { exceeded: cpuExceeded, usage: cpuUsage } = this.cpuMonitor.checkCPUThreshold(cpuThreshold);
+        const { heapExceeded, systemExceeded } = this.memoryMonitor.checkMemoryThreshold(memThreshold);
+        if (cpuExceeded) {
+            warnings.push(`High CPU usage: ${cpuUsage}% (threshold: ${cpuThreshold}%)`);
+        }
+        if (heapExceeded) {
+            warnings.push(`High heap memory: ${metrics.memory.heapUsagePercent}% (threshold: ${memThreshold}%)`);
+        }
+        if (systemExceeded) {
+            warnings.push(`High system memory: ${metrics.memory.systemMemoryUsagePercent}% (threshold: ${memThreshold}%)`);
+        }
+        return {
+            healthy: warnings.length === 0,
+            warnings,
+            metrics,
+        };
+    }
+    /**
+     * Dashboard-friendly summary
+     */
+    getSummary() {
+        const metrics = this.getSystemMetrics();
+        const health = this.getSystemHealth();
+        return {
+            status: health.healthy ? 'healthy' : 'warning',
+            cpu: {
+                usage: `${metrics.cpu.usage}%`,
+                cores: metrics.cpu.coreCount,
+                load: metrics.cpu.loadAverage,
+            },
+            memory: {
+                heap: {
+                    used: this.memoryMonitor.formatBytes(metrics.memory.heapUsed),
+                    total: this.memoryMonitor.formatBytes(metrics.memory.heapTotal),
+                    usage: `${metrics.memory.heapUsagePercent}%`,
+                },
+                system: {
+                    used: this.memoryMonitor.formatBytes(metrics.memory.systemMemoryUsed),
+                    total: this.memoryMonitor.formatBytes(metrics.memory.systemMemoryTotal),
+                    usage: `${metrics.memory.systemMemoryUsagePercent}%`,
+                },
+            },
+            warnings: health.warnings,
+        };
+    }
+}
+//# sourceMappingURL=system-monitor.js.map

package/dist/system-monitor.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,61 @@
+export declare enum LogLevel {
+    DEBUG = 0,
+    INFO = 1,
+    WARN = 2,
+    ERROR = 3
+}
+export declare enum ExporterType {
+    OTLP_HTTP = "otlp-http",
+    VERCEL = "vercel",
+    NONE = "none"
+}
+export interface RetryPolicy {
+    maxRetries: number;
+    initialDelayMs: number;
+    maxDelayMs: number;
+    backoffMultiplier: number;
+    randomizationFactor: number;
+}
+export interface ExporterConfig {
+    type: ExporterType;
+    url?: string;
+    headers?: Record<string, string>;
+    batchSize?: number;
+    batchTimeoutMs?: number;
+}
+export interface NextDoctorConfig {
+    projectToken: string;
+    endpoint: string;
+    enabled?: boolean;
+    serviceName?: string;
+    version?: string;
+    environment?: 'development' | 'staging' | 'production';
+    logLevel?: LogLevel;
+    exporter?: ExporterConfig;
+    retryPolicy?: Partial<RetryPolicy>;
+    captureLogs?: boolean;
+    captureMetrics?: boolean;
+    captureExceptions?: boolean;
+    samplingRate?: number;
+    enableDebugLogging?: boolean;
+    timeout?: number;
+}
+export interface DetectedIssue {
+    id: string;
+    severity: 'info' | 'warning' | 'high' | 'critical';
+    message: string;
+    suggestion: string;
+    route?: string;
+    spanId?: string;
+    attributes?: Record<string, unknown>;
+    detectedAt: number;
+}
+export interface AgentHealth {
+    initialized: boolean;
+    isHealthy: boolean;
+    lastHealthCheckAt?: number;
+    exporterStatus: 'healthy' | 'degraded' | 'unreachable';
+    bufferedSpans: number;
+    errorCount: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,oBAAY,QAAQ;IAClB,KAAK,IAAI;IACT,IAAI,IAAI;IACR,IAAI,IAAI;IACR,KAAK,IAAI;CACV;AAED,oBAAY,YAAY;IACtB,SAAS,cAAc;IACvB,MAAM,WAAW;IACjB,IAAI,SAAS;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,YAAY,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,aAAa,GAAG,SAAS,GAAG,YAAY,CAAC;IACvD,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;IACnC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,UAAU,CAAC;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,cAAc,EAAE,SAAS,GAAG,UAAU,GAAG,aAAa,CAAC;IACvD,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB"}

package/dist/types.js

@@ -0,0 +1,14 @@
+export var LogLevel;
+(function (LogLevel) {
+    LogLevel[LogLevel["DEBUG"] = 0] = "DEBUG";
+    LogLevel[LogLevel["INFO"] = 1] = "INFO";
+    LogLevel[LogLevel["WARN"] = 2] = "WARN";
+    LogLevel[LogLevel["ERROR"] = 3] = "ERROR";
+})(LogLevel || (LogLevel = {}));
+export var ExporterType;
+(function (ExporterType) {
+    ExporterType["OTLP_HTTP"] = "otlp-http";
+    ExporterType["VERCEL"] = "vercel";
+    ExporterType["NONE"] = "none";
+})(ExporterType || (ExporterType = {}));
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,QAKX;AALD,WAAY,QAAQ;IAClB,yCAAS,CAAA;IACT,uCAAQ,CAAA;IACR,uCAAQ,CAAA;IACR,yCAAS,CAAA;AACX,CAAC,EALW,QAAQ,KAAR,QAAQ,QAKnB;AAED,MAAM,CAAN,IAAY,YAIX;AAJD,WAAY,YAAY;IACtB,uCAAuB,CAAA;IACvB,iCAAiB,CAAA;IACjB,6BAAa,CAAA;AACf,CAAC,EAJW,YAAY,KAAZ,YAAY,QAIvB"}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@codebaz/nextdoctor-agent",
+  "version": "0.1.0-beta.1",
+  "type": "module",
+  "description": "NextDoctor agent for OpenTelemetry tracing and performance monitoring",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./middleware": {
+      "types": "./dist/middleware.d.ts",
+      "import": "./dist/middleware.js"
+    },
+    "./optimization": {
+      "types": "./dist/optimization.d.ts",
+      "import": "./dist/optimization.js"
+    },
+    "./system-monitor": {
+      "types": "./dist/system-monitor.d.ts",
+      "import": "./dist/system-monitor.js"
+    }
+  },
+  "dependencies": {
+    "@opentelemetry/api": "^1.9.1",
+    "@opentelemetry/auto-instrumentations-node": "^0.72.0",
+    "@opentelemetry/core": "^2.6.1",
+    "@opentelemetry/exporter-otlp-http": "^0.26.0",
+    "@opentelemetry/instrumentation": "^0.214.0",
+    "@opentelemetry/instrumentation-http": "^0.214.0",
+    "@opentelemetry/sdk-node": "^0.214.0",
+    "@opentelemetry/sdk-trace-base": "^2.6.1",
+    "@opentelemetry/sdk-trace-node": "^2.6.1",
+    "@vercel/otel": "^2.1.1"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "eslint": "^9.0.0",
+    "typescript": "^5.9.3",
+    "vitest": "^1.5.0",
+    "@workspace/typescript-config": "0.0.0",
+    "@workspace/eslint-config": "0.0.0"
+  },
+  "peerDependencies": {
+    "next": ">=14.0.0"
+  },
+  "scripts": {
+    "dev": "tsc --watch",
+    "build": "tsc --build",
+    "test": "vitest",
+    "lint": "eslint . --ext .ts"
+  }
+}

package/src/detectors/__tests__/cold-start-threshold.test.ts

@@ -0,0 +1,183 @@
+import { describe, it, expect } from 'vitest';
+import type { ReadableSpan } from '@opentelemetry/sdk-trace-base';
+import { ColdStartThresholdDetector } from '../cold-start-threshold.detector.js';
+
+function createMockSpan(overrides: Partial<ReadableSpan> = {}): ReadableSpan {
+  const defaultStartTime: [number, number] = [Math.floor(Date.now() / 1000), 0];
+  const defaultEndTime: [number, number] = [
+    defaultStartTime[0],
+    defaultStartTime[1] + 100_000_000, // 100ms
+  ];
+
+  return {
+    name: 'http.request',
+    spanContext: () => ({
+      traceId: 'test-trace',
+      spanId: 'test-span-' + Math.random().toString(36).substr(2, 9),
+      traceFlags: 0x01,
+      traceState: undefined,
+      isRecording: true,
+    }),
+    parentSpanId: undefined,
+    startTime: defaultStartTime,
+    endTime: defaultEndTime,
+    attributes: {
+      'http.route': '/api/test',
+      ...overrides.attributes,
+    },
+    links: [],
+    events: [],
+    status: { code: 0 },
+    instrumentationLibrary: {
+      name: 'nextdoctor',
+      version: '0.1.0',
+    },
+    resource: {
+      attributes: {},
+    },
+    duration: defaultEndTime,
+    ended: true,
+    ...overrides,
+  } as ReadableSpan;
+}
+
+describe('ColdStartThresholdDetector', () => {
+  const detector = new ColdStartThresholdDetector();
+
+  it('detects cold start above threshold (800ms)', () => {
+    const issues = detector.detect([], { 
+      runtime: 'edge',
+      startupTimeMs: 1200,
+    });
+
+    expect(issues).toHaveLength(1);
+    expect(issues[0]!.id).toBe('COLD_START_THRESHOLD');
+    expect(issues[0]!.severity).toBe('critical');
+    expect(issues[0]!.message).toContain('1200ms');
+    expect(issues[0]!.message).toContain('800ms');
+  });
+
+  it('ignores cold start below threshold', () => {
+    const issues = detector.detect([], { 
+      runtime: 'edge',
+      startupTimeMs: 500,
+    });
+
+    expect(issues).toHaveLength(0);
+  });
+
+  it('detects cold start exactly at threshold', () => {
+    const issues = detector.detect([], { 
+      runtime: 'edge',
+      startupTimeMs: 800,
+    });
+
+    // At threshold should pass (not exceed)
+    expect(issues).toHaveLength(0);
+  });
+
+  it('fires with 20+ spans when P99 - P50 > 2000ms', () => {
+    const spans = Array.from({ length: 20 }).map((_, i) => {
+      const durationNano = i < 10 
+        ? 100_000_000 // 100ms (P50)
+        : 2500_000_000; // 2500ms (P99)
+
+      return createMockSpan({
+        name: 'http.request',
+        attributes: {
+          'http.route': '/api/users',
+        },
+        startTime: [1000, 0],
+        endTime: [1000, durationNano],
+        spanContext: () => ({
+          traceId: 'test-trace',
+          spanId: `span-${i}`,
+          traceFlags: 0x01,
+          traceState: undefined,
+          isRecording: true,
+        }),
+      });
+    });
+
+    const issues = detector.detect(spans, { 
+      runtime: 'edge',
+      route: '/api/users',
+    });
+
+    expect(issues.some(i => i.id === 'COLD_START_INTERMITTENT')).toBe(true);
+    const issue = issues.find(i => i.id === 'COLD_START_INTERMITTENT');
+    expect(issue?.severity).toBe('warning');
+    expect(issue?.message).toContain('high latency variance');
+  });
+
+  it('ignores low variance', () => {
+    const spans = Array.from({ length: 20 }).map((_, i) =>
+      createMockSpan({
+        name: 'http.request',
+        attributes: {
+          'http.route': '/api/test',
+        },
+        startTime: [1000, 0],
+        endTime: [1000, 100_000_000 + i * 10_000_000], // 100-190ms range
+        spanContext: () => ({
+          traceId: 'test-trace',
+          spanId: `span-${i}`,
+          traceFlags: 0x01,
+          traceState: undefined,
+          isRecording: true,
+        }),
+      })
+    );
+
+    const issues = detector.detect(spans, { 
+      runtime: 'edge',
+      route: '/api/test',
+    });
+
+    expect(issues.filter(i => i.id === 'COLD_START_INTERMITTENT')).toHaveLength(0);
+  });
+
+  it('does not fire with fewer than 20 spans for variance calculation', () => {
+    const spans = Array.from({ length: 19 }).map((_, i) =>
+      createMockSpan({
+        startTime: [1000, 0],
+        endTime: [1000, i < 2 ? 100_000_000 : 3000_000_000],
+        spanContext: () => ({
+          traceId: 'test-trace',
+          spanId: `span-${i}`,
+          traceFlags: 0x01,
+          traceState: undefined,
+          isRecording: true,
+        }),
+      })
+    );
+
+    const issues = detector.detect(spans, { 
+      runtime: 'edge',
+      route: '/api/test',
+    });
+
+    expect(issues.every(i => i.id !== 'COLD_START_INTERMITTENT')).toBe(true);
+  });
+
+  it('includes suggestions in issue', () => {
+    const issues = detector.detect([], { 
+      runtime: 'edge',
+      startupTimeMs: 1200,
+    });
+
+    expect(issues[0]!.suggestion).toContain('import');
+    expect(issues[0]!.suggestion).toContain('runtime');
+  });
+
+  it('includes attributes with threshold data', () => {
+    const issues = detector.detect([], { 
+      runtime: 'edge',
+      startupTimeMs: 1200,
+    });
+
+    expect(issues[0]!.attributes?.startupTimeMs).toBe(1200);
+    expect(issues[0]!.attributes?.threshold).toBe(800);
+    expect(issues[0]!.attributes?.runtime).toBe('edge');
+  });
+});