@skillsmith/core 0.5.5 → 0.5.6

package/dist/benchmarks/memory/MemoryProfiler.js

@@ -0,0 +1,312 @@
+/**
+ * SMI-689: MemoryProfiler - Memory profiling for benchmark infrastructure
+ *
+ * Features:
+ * - Track memory usage for labeled operations
+ * - Detect memory leaks over threshold
+ * - Get heap snapshots using V8 statistics
+ * - Generate human-readable memory reports
+ * - Baseline comparison for memory regression detection
+ */
+import * as v8 from 'v8';
+import { BaselineManager } from './baseline-manager.js';
+import { detectLeaks } from './leak-detector.js';
+import { checkRegression } from './regression-detector.js';
+import { formatBytes, forceGC } from './utils.js';
+/**
+ * MemoryProfiler provides comprehensive memory tracking and leak detection
+ * for the benchmark infrastructure.
+ *
+ * @example
+ * ```typescript
+ * const profiler = new MemoryProfiler();
+ *
+ * profiler.trackMemory('heavy_operation');
+ * await heavyOperation();
+ * const stats = profiler.stopTracking('heavy_operation');
+ *
+ * console.log(`Heap grew by ${stats.heapGrowthPercent}%`);
+ *
+ * // Check for leaks
+ * const leakResult = profiler.detectLeaks(10);
+ * if (leakResult.hasLeaks) {
+ *   console.error(leakResult.message);
+ * }
+ * ```
+ */
+export class MemoryProfiler {
+    activeTracking = new Map();
+    completedStats = new Map();
+    baselineManager = new BaselineManager();
+    samplingIntervalMs;
+    /**
+     * Create a new MemoryProfiler instance
+     *
+     * @param samplingIntervalMs - Interval in ms for collecting memory samples (default: 100ms)
+     */
+    constructor(samplingIntervalMs = 100) {
+        this.samplingIntervalMs = samplingIntervalMs;
+    }
+    /**
+     * Start tracking memory for a labeled operation
+     *
+     * @param label - Unique label to identify this tracking session
+     * @throws Error if label is already being tracked
+     *
+     * @example
+     * ```typescript
+     * profiler.trackMemory('database_query');
+     * ```
+     */
+    trackMemory(label) {
+        if (this.activeTracking.has(label)) {
+            throw new Error(`Memory tracking already active for label: ${label}`);
+        }
+        // Force GC if available for more accurate starting point
+        forceGC();
+        const startSnapshot = this.getHeapSnapshot();
+        const entry = {
+            label,
+            startSnapshot,
+            startTime: performance.now(),
+            samples: [startSnapshot],
+        };
+        // Start periodic sampling
+        entry.samplingInterval = setInterval(() => {
+            const snapshot = this.getHeapSnapshot();
+            entry.samples.push(snapshot);
+        }, this.samplingIntervalMs);
+        this.activeTracking.set(label, entry);
+    }
+    /**
+     * Stop tracking memory for a labeled operation and return statistics
+     *
+     * @param label - Label of the tracking session to stop
+     * @returns Memory statistics for the tracked operation
+     * @throws Error if label is not being tracked
+     *
+     * @example
+     * ```typescript
+     * const stats = profiler.stopTracking('database_query');
+     * console.log(`Heap growth: ${stats.heapGrowthPercent}%`);
+     * ```
+     */
+    stopTracking(label) {
+        const entry = this.activeTracking.get(label);
+        if (!entry) {
+            throw new Error(`No active memory tracking for label: ${label}`);
+        }
+        // Stop sampling
+        if (entry.samplingInterval) {
+            clearInterval(entry.samplingInterval);
+        }
+        // Force GC for accurate end measurement
+        forceGC();
+        const endSnapshot = this.getHeapSnapshot();
+        const duration = performance.now() - entry.startTime;
+        // Calculate peak from samples
+        const peakHeapUsed = Math.max(entry.startSnapshot.usedHeapSize, ...entry.samples.map((s) => s.usedHeapSize), endSnapshot.usedHeapSize);
+        const heapGrowth = endSnapshot.usedHeapSize - entry.startSnapshot.usedHeapSize;
+        const heapGrowthPercent = entry.startSnapshot.usedHeapSize > 0
+            ? (heapGrowth / entry.startSnapshot.usedHeapSize) * 100
+            : 0;
+        const stats = {
+            label,
+            startSnapshot: entry.startSnapshot,
+            endSnapshot,
+            duration,
+            heapGrowth,
+            heapGrowthPercent: Math.round(heapGrowthPercent * 100) / 100,
+            peakHeapUsed,
+            sampleCount: entry.samples.length + 1,
+        };
+        this.completedStats.set(label, stats);
+        this.activeTracking.delete(label);
+        return stats;
+    }
+    /**
+     * Get current heap statistics using V8
+     *
+     * @returns Current memory snapshot
+     *
+     * @example
+     * ```typescript
+     * const snapshot = profiler.getHeapSnapshot();
+     * console.log(`Used heap: ${snapshot.usedHeapSize / 1024 / 1024} MB`);
+     * ```
+     */
+    getHeapSnapshot() {
+        const heapStats = v8.getHeapStatistics();
+        const memUsage = process.memoryUsage();
+        return {
+            timestamp: Date.now(),
+            totalHeapSize: heapStats.total_heap_size,
+            usedHeapSize: heapStats.used_heap_size,
+            externalMemory: memUsage.external,
+            heapSizeLimit: heapStats.heap_size_limit,
+            totalPhysicalSize: heapStats.total_physical_size,
+            totalAvailableSize: heapStats.total_available_size,
+            mallocedMemory: heapStats.malloced_memory,
+            peakMallocedMemory: heapStats.peak_malloced_memory,
+        };
+    }
+    /**
+     * Detect potential memory leaks across all completed tracking sessions
+     *
+     * @param threshold - Heap growth percentage threshold to consider a leak (default: 10%)
+     * @returns Leak detection result
+     *
+     * @example
+     * ```typescript
+     * const result = profiler.detectLeaks(15); // 15% threshold
+     * if (result.hasLeaks) {
+     *   console.error(`Potential leak detected: ${result.message}`);
+     * }
+     * ```
+     */
+    detectLeaks(threshold = 10) {
+        return detectLeaks(this.completedStats, threshold);
+    }
+    /**
+     * Save a baseline for memory regression comparison
+     *
+     * @param label - Label to save as baseline
+     * @throws Error if no completed stats exist for the label
+     */
+    saveBaseline(label) {
+        const stats = this.completedStats.get(label);
+        if (!stats) {
+            throw new Error(`No completed stats for label: ${label}`);
+        }
+        return this.baselineManager.saveBaseline(label, stats);
+    }
+    /**
+     * Load baselines from a JSON object
+     *
+     * @param baselines - Object mapping labels to baselines
+     */
+    loadBaselines(baselines) {
+        this.baselineManager.loadBaselines(baselines);
+    }
+    /**
+     * Check for memory regression against baseline
+     *
+     * @param label - Label to check
+     * @param threshold - Regression threshold percentage (default: 10%)
+     * @returns Regression result
+     */
+    checkRegression(label, threshold = 10) {
+        return checkRegression(label, this.baselineManager.getBaseline(label), this.completedStats.get(label), threshold);
+    }
+    /**
+     * Generate a human-readable memory report
+     *
+     * @returns Formatted memory report string
+     *
+     * @example
+     * ```typescript
+     * profiler.trackMemory('op1');
+     * await operation1();
+     * profiler.stopTracking('op1');
+     *
+     * console.log(profiler.formatMemoryReport());
+     * ```
+     */
+    formatMemoryReport() {
+        const lines = [
+            '===================================================================================================',
+            '                        SMI-689: Memory Profiling Report                       ',
+            '===================================================================================================',
+        ];
+        // Current heap snapshot
+        const current = this.getHeapSnapshot();
+        lines.push(' Current Heap Status:                                                          ');
+        lines.push(`   Used Heap:      ${formatBytes(current.usedHeapSize).padEnd(15)} | Total Heap:  ${formatBytes(current.totalHeapSize).padEnd(15)}  `);
+        lines.push(`   Heap Limit:     ${formatBytes(current.heapSizeLimit).padEnd(15)} | External:    ${formatBytes(current.externalMemory).padEnd(15)}  `);
+        lines.push('                                                                               ');
+        // Completed tracking stats
+        if (this.completedStats.size > 0) {
+            lines.push(' Tracked Operations:                                                           ');
+            lines.push('---------------------------------------------------------------------------------------------------');
+            for (const [label, stats] of this.completedStats) {
+                const growthColor = stats.heapGrowthPercent > 10 ? '!' : stats.heapGrowthPercent > 5 ? '~' : ' ';
+                lines.push(` ${growthColor} ${label.substring(0, 25).padEnd(25)} | Duration: ${stats.duration.toFixed(0).padStart(6)}ms | Growth: ${stats.heapGrowthPercent.toFixed(1).padStart(6)}% `);
+                lines.push(`     Start: ${formatBytes(stats.startSnapshot.usedHeapSize).padEnd(10)} | End: ${formatBytes(stats.endSnapshot?.usedHeapSize ?? 0).padEnd(10)} | Peak: ${formatBytes(stats.peakHeapUsed).padEnd(10)} `);
+            }
+        }
+        else {
+            lines.push(' No tracked operations recorded.                                               ');
+        }
+        // Active tracking
+        if (this.activeTracking.size > 0) {
+            lines.push('                                                                               ');
+            lines.push(' Active Tracking:                                                              ');
+            for (const [label, entry] of this.activeTracking) {
+                const elapsed = (performance.now() - entry.startTime).toFixed(0);
+                lines.push(`   ${label.substring(0, 30).padEnd(30)} | Elapsed: ${elapsed.padStart(6)}ms | Samples: ${String(entry.samples.length).padStart(4)} `);
+            }
+        }
+        // Leak detection summary
+        const leakResult = this.detectLeaks(10);
+        lines.push('                                                                               ');
+        lines.push(' Leak Detection (10% threshold):                                               ');
+        if (leakResult.hasLeaks) {
+            lines.push(`   WARNING: POTENTIAL LEAKS DETECTED                                                  `);
+            lines.push(`   Suspected: ${leakResult.suspectedLabels.slice(0, 3).join(', ').substring(0, 60).padEnd(60)}  `);
+            lines.push(`   Total leaked: ${formatBytes(leakResult.leakedBytes).padEnd(15)} | Max growth: ${leakResult.heapGrowthPercent.toFixed(1).padStart(6)}%     `);
+        }
+        else {
+            lines.push(`   OK: No memory leaks detected                                                  `);
+        }
+        lines.push('===================================================================================================');
+        return lines.join('\n');
+    }
+    /**
+     * Get all completed statistics
+     *
+     * @returns Map of label to MemoryStats
+     */
+    getCompletedStats() {
+        return new Map(this.completedStats);
+    }
+    /**
+     * Get all baselines
+     *
+     * @returns Map of label to MemoryBaseline
+     */
+    getBaselines() {
+        return this.baselineManager.getBaselines();
+    }
+    /**
+     * Export baselines as JSON-serializable object
+     *
+     * @returns Object mapping labels to baselines
+     */
+    exportBaselines() {
+        return this.baselineManager.exportBaselines();
+    }
+    /**
+     * Clear all tracking data
+     */
+    clear() {
+        // Stop any active tracking
+        for (const entry of this.activeTracking.values()) {
+            if (entry.samplingInterval) {
+                clearInterval(entry.samplingInterval);
+            }
+        }
+        this.activeTracking.clear();
+        this.completedStats.clear();
+    }
+    /**
+     * Clear baselines
+     */
+    clearBaselines() {
+        this.baselineManager.clear();
+    }
+}
+/**
+ * Default memory profiler instance for convenience
+ */
+export const defaultMemoryProfiler = new MemoryProfiler();
+//# sourceMappingURL=MemoryProfiler.js.map

package/dist/benchmarks/memory/MemoryProfiler.js.map

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

package/dist/benchmarks/memory/baseline-manager.d.ts

@@ -0,0 +1,64 @@
+/**
+ * SMI-689: Memory Baseline Manager
+ *
+ * Manages memory baselines for regression comparison.
+ */
+import type { MemoryStats, MemoryBaseline } from './types.js';
+/**
+ * Manages baseline storage and comparison for memory profiling.
+ */
+export declare class BaselineManager {
+    private baselines;
+    /**
+     * Save a baseline from completed stats
+     *
+     * @param label - Label to save as baseline
+     * @param stats - Memory stats to create baseline from
+     * @returns Created baseline
+     */
+    saveBaseline(label: string, stats: MemoryStats): MemoryBaseline;
+    /**
+     * Load baselines from a JSON object
+     *
+     * @param baselines - Object mapping labels to baselines
+     */
+    loadBaselines(baselines: Record<string, MemoryBaseline>): void;
+    /**
+     * Get a baseline by label
+     *
+     * @param label - Label to look up
+     * @returns Baseline or undefined
+     */
+    getBaseline(label: string): MemoryBaseline | undefined;
+    /**
+     * Get all baselines
+     *
+     * @returns Map of label to MemoryBaseline
+     */
+    getBaselines(): Map<string, MemoryBaseline>;
+    /**
+     * Export baselines as JSON-serializable object
+     *
+     * @returns Object mapping labels to baselines
+     */
+    exportBaselines(): Record<string, MemoryBaseline>;
+    /**
+     * Clear all baselines
+     */
+    clear(): void;
+    /**
+     * Check if a baseline exists
+     *
+     * @param label - Label to check
+     * @returns True if baseline exists
+     */
+    hasBaseline(label: string): boolean;
+    /**
+     * Delete a specific baseline
+     *
+     * @param label - Label to delete
+     * @returns True if baseline was deleted
+     */
+    deleteBaseline(label: string): boolean;
+}
+//# sourceMappingURL=baseline-manager.d.ts.map

package/dist/benchmarks/memory/baseline-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"baseline-manager.d.ts","sourceRoot":"","sources":["../../../src/benchmarks/memory/baseline-manager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAE7D;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,SAAS,CAAyC;IAE1D;;;;;;OAMG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,cAAc;IAgB/D;;;;OAIG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,IAAI;IAM9D;;;;;OAKG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAItD;;;;OAIG;IACH,YAAY,IAAI,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC;IAI3C;;;;OAIG;IACH,eAAe,IAAI,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC;IAQjD;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;;;;OAKG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAInC;;;;;OAKG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;CAGvC"}

package/dist/benchmarks/memory/baseline-manager.js

@@ -0,0 +1,95 @@
+/**
+ * SMI-689: Memory Baseline Manager
+ *
+ * Manages memory baselines for regression comparison.
+ */
+/**
+ * Manages baseline storage and comparison for memory profiling.
+ */
+export class BaselineManager {
+    baselines = new Map();
+    /**
+     * Save a baseline from completed stats
+     *
+     * @param label - Label to save as baseline
+     * @param stats - Memory stats to create baseline from
+     * @returns Created baseline
+     */
+    saveBaseline(label, stats) {
+        const baseline = {
+            label,
+            timestamp: new Date().toISOString(),
+            avgHeapUsed: (stats.startSnapshot.usedHeapSize +
+                (stats.endSnapshot?.usedHeapSize ?? stats.startSnapshot.usedHeapSize)) /
+                2,
+            peakHeapUsed: stats.peakHeapUsed,
+            sampleCount: stats.sampleCount,
+        };
+        this.baselines.set(label, baseline);
+        return baseline;
+    }
+    /**
+     * Load baselines from a JSON object
+     *
+     * @param baselines - Object mapping labels to baselines
+     */
+    loadBaselines(baselines) {
+        for (const [label, baseline] of Object.entries(baselines)) {
+            this.baselines.set(label, baseline);
+        }
+    }
+    /**
+     * Get a baseline by label
+     *
+     * @param label - Label to look up
+     * @returns Baseline or undefined
+     */
+    getBaseline(label) {
+        return this.baselines.get(label);
+    }
+    /**
+     * Get all baselines
+     *
+     * @returns Map of label to MemoryBaseline
+     */
+    getBaselines() {
+        return new Map(this.baselines);
+    }
+    /**
+     * Export baselines as JSON-serializable object
+     *
+     * @returns Object mapping labels to baselines
+     */
+    exportBaselines() {
+        const result = {};
+        for (const [label, baseline] of this.baselines) {
+            result[label] = baseline;
+        }
+        return result;
+    }
+    /**
+     * Clear all baselines
+     */
+    clear() {
+        this.baselines.clear();
+    }
+    /**
+     * Check if a baseline exists
+     *
+     * @param label - Label to check
+     * @returns True if baseline exists
+     */
+    hasBaseline(label) {
+        return this.baselines.has(label);
+    }
+    /**
+     * Delete a specific baseline
+     *
+     * @param label - Label to delete
+     * @returns True if baseline was deleted
+     */
+    deleteBaseline(label) {
+        return this.baselines.delete(label);
+    }
+}
+//# sourceMappingURL=baseline-manager.js.map

package/dist/benchmarks/memory/baseline-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"baseline-manager.js","sourceRoot":"","sources":["../../../src/benchmarks/memory/baseline-manager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;GAEG;AACH,MAAM,OAAO,eAAe;IAClB,SAAS,GAAgC,IAAI,GAAG,EAAE,CAAA;IAE1D;;;;;;OAMG;IACH,YAAY,CAAC,KAAa,EAAE,KAAkB;QAC5C,MAAM,QAAQ,GAAmB;YAC/B,KAAK;YACL,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,WAAW,EACT,CAAC,KAAK,CAAC,aAAa,CAAC,YAAY;gBAC/B,CAAC,KAAK,CAAC,WAAW,EAAE,YAAY,IAAI,KAAK,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC;gBACxE,CAAC;YACH,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,WAAW,EAAE,KAAK,CAAC,WAAW;SAC/B,CAAA;QAED,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;QACnC,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED;;;;OAIG;IACH,aAAa,CAAC,SAAyC;QACrD,KAAK,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;YAC1D,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAA;QACrC,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,WAAW,CAAC,KAAa;QACvB,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;IAClC,CAAC;IAED;;;;OAIG;IACH,YAAY;QACV,OAAO,IAAI,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;IAChC,CAAC;IAED;;;;OAIG;IACH,eAAe;QACb,MAAM,MAAM,GAAmC,EAAE,CAAA;QACjD,KAAK,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YAC/C,MAAM,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAA;QAC1B,CAAC;QACD,OAAO,MAAM,CAAA;IACf,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAA;IACxB,CAAC;IAED;;;;;OAKG;IACH,WAAW,CAAC,KAAa;QACvB,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;IAClC,CAAC;IAED;;;;;OAKG;IACH,cAAc,CAAC,KAAa;QAC1B,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IACrC,CAAC;CACF"}

package/dist/benchmarks/memory/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * SMI-689: Memory Profiler Module
+ *
+ * Exports all memory profiling types and functionality.
+ */
+export * from './types.js';
+export * from './utils.js';
+export * from './baseline-manager.js';
+export * from './leak-detector.js';
+export * from './regression-detector.js';
+export { MemoryProfiler, defaultMemoryProfiler } from './MemoryProfiler.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/benchmarks/memory/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/benchmarks/memory/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,uBAAuB,CAAA;AACrC,cAAc,oBAAoB,CAAA;AAClC,cAAc,0BAA0B,CAAA;AACxC,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA"}

package/dist/benchmarks/memory/index.js

@@ -0,0 +1,12 @@
+/**
+ * SMI-689: Memory Profiler Module
+ *
+ * Exports all memory profiling types and functionality.
+ */
+export * from './types.js';
+export * from './utils.js';
+export * from './baseline-manager.js';
+export * from './leak-detector.js';
+export * from './regression-detector.js';
+export { MemoryProfiler, defaultMemoryProfiler } from './MemoryProfiler.js';
+//# sourceMappingURL=index.js.map

package/dist/benchmarks/memory/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/benchmarks/memory/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,uBAAuB,CAAA;AACrC,cAAc,oBAAoB,CAAA;AAClC,cAAc,0BAA0B,CAAA;AACxC,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA"}

package/dist/benchmarks/memory/leak-detector.d.ts

@@ -0,0 +1,23 @@
+/**
+ * SMI-689: Memory Leak Detector
+ *
+ * Detects potential memory leaks from completed tracking sessions.
+ */
+import type { MemoryStats, LeakDetectionResult } from './types.js';
+/**
+ * Detect potential memory leaks across completed tracking sessions
+ *
+ * @param completedStats - Map of label to completed MemoryStats
+ * @param threshold - Heap growth percentage threshold to consider a leak (default: 10%)
+ * @returns Leak detection result
+ *
+ * @example
+ * ```typescript
+ * const result = detectLeaks(completedStats, 15); // 15% threshold
+ * if (result.hasLeaks) {
+ *   console.error(`Potential leak detected: ${result.message}`);
+ * }
+ * ```
+ */
+export declare function detectLeaks(completedStats: Map<string, MemoryStats>, threshold?: number): LeakDetectionResult;
+//# sourceMappingURL=leak-detector.d.ts.map

package/dist/benchmarks/memory/leak-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"leak-detector.d.ts","sourceRoot":"","sources":["../../../src/benchmarks/memory/leak-detector.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAGlE;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,WAAW,CACzB,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,EACxC,SAAS,GAAE,MAAW,GACrB,mBAAmB,CA0BrB"}

package/dist/benchmarks/memory/leak-detector.js

@@ -0,0 +1,46 @@
+/**
+ * SMI-689: Memory Leak Detector
+ *
+ * Detects potential memory leaks from completed tracking sessions.
+ */
+import { formatBytes } from './utils.js';
+/**
+ * Detect potential memory leaks across completed tracking sessions
+ *
+ * @param completedStats - Map of label to completed MemoryStats
+ * @param threshold - Heap growth percentage threshold to consider a leak (default: 10%)
+ * @returns Leak detection result
+ *
+ * @example
+ * ```typescript
+ * const result = detectLeaks(completedStats, 15); // 15% threshold
+ * if (result.hasLeaks) {
+ *   console.error(`Potential leak detected: ${result.message}`);
+ * }
+ * ```
+ */
+export function detectLeaks(completedStats, threshold = 10) {
+    const suspectedLabels = [];
+    let totalLeakedBytes = 0;
+    let maxGrowthPercent = 0;
+    for (const [label, stats] of completedStats) {
+        if (stats.heapGrowthPercent > threshold) {
+            suspectedLabels.push(label);
+            totalLeakedBytes += stats.heapGrowth;
+            maxGrowthPercent = Math.max(maxGrowthPercent, stats.heapGrowthPercent);
+        }
+    }
+    const hasLeaks = suspectedLabels.length > 0;
+    return {
+        hasLeaks,
+        threshold,
+        heapGrowthPercent: Math.round(maxGrowthPercent * 100) / 100,
+        leakedBytes: totalLeakedBytes,
+        suspectedLabels,
+        message: hasLeaks
+            ? `Potential memory leak detected in ${suspectedLabels.length} operation(s): ${suspectedLabels.join(', ')}. ` +
+                `Total leaked: ${formatBytes(totalLeakedBytes)}, max growth: ${maxGrowthPercent.toFixed(2)}%`
+            : `No memory leaks detected (threshold: ${threshold}%)`,
+    };
+}
+//# sourceMappingURL=leak-detector.js.map

package/dist/benchmarks/memory/leak-detector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"leak-detector.js","sourceRoot":"","sources":["../../../src/benchmarks/memory/leak-detector.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAExC;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,WAAW,CACzB,cAAwC,EACxC,YAAoB,EAAE;IAEtB,MAAM,eAAe,GAAa,EAAE,CAAA;IACpC,IAAI,gBAAgB,GAAG,CAAC,CAAA;IACxB,IAAI,gBAAgB,GAAG,CAAC,CAAA;IAExB,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,cAAc,EAAE,CAAC;QAC5C,IAAI,KAAK,CAAC,iBAAiB,GAAG,SAAS,EAAE,CAAC;YACxC,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;YAC3B,gBAAgB,IAAI,KAAK,CAAC,UAAU,CAAA;YACpC,gBAAgB,GAAG,IAAI,CAAC,GAAG,CAAC,gBAAgB,EAAE,KAAK,CAAC,iBAAiB,CAAC,CAAA;QACxE,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,eAAe,CAAC,MAAM,GAAG,CAAC,CAAA;IAE3C,OAAO;QACL,QAAQ;QACR,SAAS;QACT,iBAAiB,EAAE,IAAI,CAAC,KAAK,CAAC,gBAAgB,GAAG,GAAG,CAAC,GAAG,GAAG;QAC3D,WAAW,EAAE,gBAAgB;QAC7B,eAAe;QACf,OAAO,EAAE,QAAQ;YACf,CAAC,CAAC,qCAAqC,eAAe,CAAC,MAAM,kBAAkB,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;gBAC3G,iBAAiB,WAAW,CAAC,gBAAgB,CAAC,iBAAiB,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG;YAC/F,CAAC,CAAC,wCAAwC,SAAS,IAAI;KAC1D,CAAA;AACH,CAAC"}

package/dist/benchmarks/memory/regression-detector.d.ts

@@ -0,0 +1,17 @@
+/**
+ * SMI-689: Memory Regression Detector
+ *
+ * Detects memory regressions by comparing current stats to baselines.
+ */
+import type { MemoryStats, MemoryBaseline, MemoryRegressionResult } from './types.js';
+/**
+ * Check for memory regression against a baseline
+ *
+ * @param label - Label to check
+ * @param baseline - Baseline to compare against (optional)
+ * @param currentStats - Current memory stats (optional)
+ * @param threshold - Regression threshold percentage (default: 10%)
+ * @returns Regression result
+ */
+export declare function checkRegression(label: string, baseline: MemoryBaseline | undefined, currentStats: MemoryStats | undefined, threshold?: number): MemoryRegressionResult;
+//# sourceMappingURL=regression-detector.d.ts.map

package/dist/benchmarks/memory/regression-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"regression-detector.d.ts","sourceRoot":"","sources":["../../../src/benchmarks/memory/regression-detector.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA;AAGrF;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,cAAc,GAAG,SAAS,EACpC,YAAY,EAAE,WAAW,GAAG,SAAS,EACrC,SAAS,GAAE,MAAW,GACrB,sBAAsB,CA4CxB"}