@skillsmith/core 0.1.0

package/dist/src/benchmarks/MemoryProfiler.js

@@ -0,0 +1,404 @@
+/**
+ * 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';
+/**
+ * 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();
+    baselines = new Map();
+    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
+        this.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
+        this.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) {
+        const suspectedLabels = [];
+        let totalLeakedBytes = 0;
+        let maxGrowthPercent = 0;
+        for (const [label, stats] of this.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: ${this.formatBytes(totalLeakedBytes)}, max growth: ${maxGrowthPercent.toFixed(2)}%`
+                : `No memory leaks detected (threshold: ${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}`);
+        }
+        const baseline = {
+            label,
+            timestamp: new Date().toISOString(),
+            avgHeapUsed: stats.startSnapshot.usedHeapSize +
+                (stats.endSnapshot?.usedHeapSize ?? stats.startSnapshot.usedHeapSize),
+            peakHeapUsed: stats.peakHeapUsed,
+            sampleCount: stats.sampleCount,
+        };
+        baseline.avgHeapUsed = baseline.avgHeapUsed / 2;
+        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);
+        }
+    }
+    /**
+     * 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) {
+        const baseline = this.baselines.get(label);
+        const current = this.completedStats.get(label);
+        if (!baseline) {
+            return {
+                hasRegression: false,
+                threshold,
+                label,
+                baselineHeap: 0,
+                currentHeap: current?.peakHeapUsed ?? 0,
+                changePercent: 0,
+                message: `No baseline exists for label: ${label}`,
+            };
+        }
+        if (!current) {
+            return {
+                hasRegression: false,
+                threshold,
+                label,
+                baselineHeap: baseline.peakHeapUsed,
+                currentHeap: 0,
+                changePercent: 0,
+                message: `No current stats exist for label: ${label}`,
+            };
+        }
+        const changePercent = baseline.peakHeapUsed > 0
+            ? ((current.peakHeapUsed - baseline.peakHeapUsed) / baseline.peakHeapUsed) * 100
+            : 0;
+        const hasRegression = changePercent > threshold;
+        return {
+            hasRegression,
+            threshold,
+            label,
+            baselineHeap: baseline.peakHeapUsed,
+            currentHeap: current.peakHeapUsed,
+            changePercent: Math.round(changePercent * 100) / 100,
+            message: hasRegression
+                ? `Memory regression detected for ${label}: heap grew by ${changePercent.toFixed(2)}% ` +
+                    `(${this.formatBytes(baseline.peakHeapUsed)} -> ${this.formatBytes(current.peakHeapUsed)})`
+                : `No memory regression for ${label} (change: ${changePercent.toFixed(2)}%)`,
+        };
+    }
+    /**
+     * 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:      ${this.formatBytes(current.usedHeapSize).padEnd(15)} │ Total Heap:  ${this.formatBytes(current.totalHeapSize).padEnd(15)}  ║`);
+        lines.push(`║   Heap Limit:     ${this.formatBytes(current.heapSizeLimit).padEnd(15)} │ External:    ${this.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: ${this.formatBytes(stats.startSnapshot.usedHeapSize).padEnd(10)} │ End: ${this.formatBytes(stats.endSnapshot?.usedHeapSize ?? 0).padEnd(10)} │ Peak: ${this.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(`║   ⚠ POTENTIAL LEAKS DETECTED                                                  ║`);
+            lines.push(`║   Suspected: ${leakResult.suspectedLabels.slice(0, 3).join(', ').substring(0, 60).padEnd(60)}  ║`);
+            lines.push(`║   Total leaked: ${this.formatBytes(leakResult.leakedBytes).padEnd(15)} │ Max growth: ${leakResult.heapGrowthPercent.toFixed(1).padStart(6)}%     ║`);
+        }
+        else {
+            lines.push(`║   ✓ 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 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 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.baselines.clear();
+    }
+    /**
+     * Force garbage collection if available
+     */
+    forceGC() {
+        if (typeof global.gc === 'function') {
+            global.gc();
+        }
+    }
+    /**
+     * Format bytes to human-readable string
+     */
+    formatBytes(bytes) {
+        if (bytes === 0)
+            return '0 B';
+        const k = 1024;
+        const sizes = ['B', 'KB', 'MB', 'GB'];
+        const i = Math.floor(Math.log(Math.abs(bytes)) / Math.log(k));
+        const value = bytes / Math.pow(k, i);
+        return `${value.toFixed(1)} ${sizes[i]}`;
+    }
+}
+/**
+ * Default memory profiler instance for convenience
+ */
+export const defaultMemoryProfiler = new MemoryProfiler();
+//# sourceMappingURL=MemoryProfiler.js.map

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

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

package/dist/src/benchmarks/SearchBenchmark.d.ts

@@ -0,0 +1,71 @@
+/**
+ * SMI-632: SearchBenchmark - Search query latency benchmarks
+ *
+ * Features:
+ * - Various query types (simple, complex, phrase, boolean)
+ * - Different result set sizes
+ * - Cold vs warm cache comparison
+ * - BM25 ranking performance
+ */
+import { type BenchmarkReport, type BenchmarkConfig } from './BenchmarkRunner.js';
+/**
+ * Search benchmark configuration
+ */
+export interface SearchBenchmarkConfig extends BenchmarkConfig {
+    /** Number of skills to seed in database */
+    skillCount?: number;
+    /** Clear cache between iterations */
+    coldCache?: boolean;
+}
+/**
+ * Performance targets for search operations
+ */
+export declare const SEARCH_TARGETS: {
+    p50_ms: number;
+    p95_ms: number;
+    p99_ms: number;
+    memoryPeak_mb: number;
+};
+/**
+ * Search query benchmark suite
+ */
+export declare class SearchBenchmark {
+    private config;
+    private db;
+    private repo;
+    private search;
+    constructor(config?: SearchBenchmarkConfig);
+    /**
+     * Run all search benchmarks
+     */
+    run(): Promise<BenchmarkReport>;
+    /**
+     * Run cold cache benchmarks (separate from main suite)
+     */
+    runColdCache(): Promise<BenchmarkReport>;
+    /**
+     * Setup database and seed test data
+     */
+    private setup;
+    /**
+     * Cleanup database resources
+     */
+    private teardown;
+    /**
+     * Generate test skills with realistic distribution
+     */
+    private generateTestSkills;
+}
+/**
+ * Validate search benchmark results against targets
+ */
+export declare function validateSearchResults(report: BenchmarkReport): ValidationResult;
+/**
+ * Validation result
+ */
+export interface ValidationResult {
+    passed: boolean;
+    failures: string[];
+    warnings: string[];
+}
+//# sourceMappingURL=SearchBenchmark.d.ts.map

package/dist/src/benchmarks/SearchBenchmark.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SearchBenchmark.d.ts","sourceRoot":"","sources":["../../../src/benchmarks/SearchBenchmark.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,EAAmB,KAAK,eAAe,EAAE,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAElG;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,eAAe;IAC5D,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,qCAAqC;IACrC,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB;AAeD;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;CAK1B,CAAA;AAED;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAiC;IAC/C,OAAO,CAAC,EAAE,CAA4B;IACtC,OAAO,CAAC,IAAI,CAA+B;IAC3C,OAAO,CAAC,MAAM,CAA6B;gBAE/B,MAAM,GAAE,qBAA0B;IAI9C;;OAEG;IACG,GAAG,IAAI,OAAO,CAAC,eAAe,CAAC;IAqMrC;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,eAAe,CAAC;IAM9C;;OAEG;YACW,KAAK;IAUnB;;OAEG;YACW,QAAQ;IAStB;;OAEG;IACH,OAAO,CAAC,kBAAkB;CA0C3B;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,eAAe,GAAG,gBAAgB,CAiC/E;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,OAAO,CAAA;IACf,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB"}