@skillsmith/core 0.5.5 → 0.5.6

package/dist/benchmarks/incrementalParseBenchmark.js

@@ -0,0 +1,121 @@
+#!/usr/bin/env npx tsx
+/**
+ * SMI-4293: Incremental parsing benchmark.
+ *
+ * Runs the Python adapter's full parse vs incremental parse over a
+ * synthetic module of ~500 function/class/import constructs. Targets:
+ *   • Single-file re-parse < 100ms (SMI-1309 success criterion)
+ *   • Unchanged re-parse ≥ 5× faster than a cold full parse
+ *
+ * Usage:
+ *   npx tsx src/benchmarks/incrementalParseBenchmark.ts
+ *   # or via npm script:
+ *   npm run benchmark:incremental-parse -w @skillsmith/core
+ *
+ * @see docs/internal/implementation/github-wave-5c-tree-sitter-incremental.md
+ */
+import { performance } from 'perf_hooks';
+import { PythonIncrementalParser } from '../analysis/tree-sitter/pythonIncremental.js';
+function makePythonSource(functionCount, classCount) {
+    const lines = [];
+    lines.push('import os');
+    lines.push('import sys');
+    lines.push('from typing import Optional, List, Dict, Any');
+    lines.push('from dataclasses import dataclass');
+    lines.push('');
+    for (let i = 0; i < classCount; i++) {
+        lines.push(`class Model${i}:`);
+        lines.push(`    """Auto-generated model ${i}."""`);
+        lines.push(`    def __init__(self, a: int, b: str):`);
+        lines.push(`        self.a = a`);
+        lines.push(`        self.b = b`);
+        lines.push('');
+        lines.push(`    def describe${i}(self) -> str:`);
+        lines.push(`        return f"{self.a}:{self.b}"`);
+        lines.push('');
+    }
+    for (let i = 0; i < functionCount; i++) {
+        lines.push(`def fn_${i}(x: int, y: int) -> int:`);
+        lines.push(`    return x + y + ${i}`);
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+function applySingleCharEdit(src) {
+    // Replace the first occurrence of "+ 0" with "+ 1" (roughly middle of
+    // the module); a minimal edit that doesn't shift line counts.
+    const target = '+ 0';
+    const idx = src.indexOf(target);
+    if (idx === -1)
+        return src + '\n# tail\n';
+    return src.slice(0, idx + 2) + '1' + src.slice(idx + 3);
+}
+async function time(label, fn, iterations = 1) {
+    // Warm-up
+    await fn();
+    const start = performance.now();
+    for (let i = 0; i < iterations; i++) {
+        await fn();
+    }
+    const total = performance.now() - start;
+    const avg = total / iterations;
+    console.log(`  ${label}: ${avg.toFixed(2)}ms (avg over ${iterations} iterations)`);
+    return avg;
+}
+async function main() {
+    const source = makePythonSource(500, 50);
+    const edited = applySingleCharEdit(source);
+    console.log(`Python source: ${source.length} bytes, ${source.split('\n').length} lines`);
+    const parser = new PythonIncrementalParser();
+    await parser.ensureReady();
+    if (!parser.isReady) {
+        console.error('[benchmark] WASM parser unavailable; aborting.');
+        process.exit(2);
+    }
+    console.log('\n=== Full (cold) parse ===');
+    // Cold: dispose+reinit before each iteration so we measure a fresh parse.
+    const coldParser = new PythonIncrementalParser();
+    await coldParser.ensureReady();
+    const coldAvg = await time('cold full parse', () => {
+        coldParser.invalidate('bench.py');
+        coldParser.parseSync(source, 'bench.py');
+    }, 5);
+    console.log('\n=== Warm full parse (no cache hit: fresh file path) ===');
+    let counter = 0;
+    const warmFullAvg = await time('warm full parse', () => {
+        parser.parseSync(source, `fresh-${counter++}.py`);
+    }, 5);
+    console.log('\n=== Unchanged re-parse (cache hit) ===');
+    parser.parseSync(source, 'bench-unchanged.py'); // seed
+    const unchangedAvg = await time('unchanged re-parse', () => {
+        parser.parseSync(source, 'bench-unchanged.py');
+    }, 20);
+    console.log('\n=== Incremental edit (tree.edit reuse) ===');
+    parser.parseSync(source, 'bench-incr.py'); // seed
+    const incrAvg = await time('incremental edit', () => {
+        parser.parseSync(edited, 'bench-incr.py');
+        parser.parseSync(source, 'bench-incr.py'); // flip back for the next iteration
+    }, 10);
+    console.log('\n=== Summary ===');
+    console.log(`  Cold full parse:     ${coldAvg.toFixed(2)}ms`);
+    console.log(`  Warm full parse:     ${warmFullAvg.toFixed(2)}ms`);
+    console.log(`  Unchanged re-parse:  ${unchangedAvg.toFixed(2)}ms`);
+    console.log(`  Incremental edit:    ${incrAvg.toFixed(2)}ms`);
+    const speedup = coldAvg > 0 ? coldAvg / unchangedAvg : 0;
+    console.log(`  Unchanged speedup:   ${speedup.toFixed(1)}×`);
+    console.log('\n=== Targets ===');
+    const singleFileTarget = incrAvg < 100;
+    const speedupTarget = speedup >= 5;
+    console.log(`  Single-file re-parse < 100ms: ${singleFileTarget ? 'PASS' : 'FAIL'} (${incrAvg.toFixed(2)}ms)`);
+    console.log(`  Unchanged ≥ 5× full parse:     ${speedupTarget ? 'PASS' : 'FAIL'} (${speedup.toFixed(1)}×)`);
+    parser.dispose();
+    coldParser.dispose();
+    // Exit non-zero if any target fails so CI / humans notice.
+    if (!singleFileTarget || !speedupTarget)
+        process.exit(1);
+}
+main().catch((err) => {
+    console.error('[benchmark] error:', err);
+    process.exit(1);
+});
+//# sourceMappingURL=incrementalParseBenchmark.js.map

package/dist/benchmarks/incrementalParseBenchmark.js.map

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

package/dist/benchmarks/index.d.ts

@@ -0,0 +1,55 @@
+/**
+ * SMI-632: Benchmark module exports
+ * SMI-689: Enhanced with MemoryProfiler integration
+ * SMI-1189: Updated to export from split modules
+ *
+ * Provides performance benchmarking infrastructure for:
+ * - Search query latency
+ * - Indexing throughput
+ * - Statistical analysis
+ * - CI integration
+ * - Memory profiling and leak detection
+ */
+export { BenchmarkRunner, type BenchmarkConfig, type BenchmarkResult, type BenchmarkStats, type BenchmarkReport, type BenchmarkDefinition, type BenchmarkFn, type MemoryStats, type EnvironmentInfo, type ComparisonResult, type MetricComparison, type DetailedMemoryStats, type MemoryRegressionInfo, formatReportAsJson, formatReportAsText, formatBytes, compareReports, hasRegressions, getRegressedBenchmarks, getImprovedBenchmarks, } from './BenchmarkRunner.js';
+export { DEFAULT_CONFIG } from './types.js';
+export { formatBytes as formatBytesUtil } from './formatters.js';
+export { hasRegressions as hasRegressionsUtil } from './comparator.js';
+export { MemoryProfiler, defaultMemoryProfiler, type MemorySnapshot, type MemoryStats as ProfilerMemoryStats, type MemoryBaseline, type LeakDetectionResult, type MemoryRegressionResult, } from './MemoryProfiler.js';
+export { SearchBenchmark, type SearchBenchmarkConfig, type ValidationResult, SEARCH_TARGETS, validateSearchResults, } from './SearchBenchmark.js';
+export { IndexBenchmark, type IndexBenchmarkConfig, type ThroughputResult, type SizeImpactResult, type IndexValidationResult, INDEX_TARGETS, validateIndexResults, } from './IndexBenchmark.js';
+export { CacheBenchmark, type CacheBenchmarkConfig, type CacheValidationResult, CACHE_TARGETS, validateCacheResults, } from './cacheBenchmark.js';
+export { EmbeddingBenchmark, type EmbeddingBenchmarkConfig, type EmbeddingValidationResult, EMBEDDING_TARGETS, validateEmbeddingResults, } from './embeddingBenchmark.js';
+export { percentile, mean, sampleStddev, calculateLatencyStats, type LatencyStats, } from './stats.js';
+/**
+ * CLI-friendly benchmark runner
+ *
+ * Usage:
+ *   npx ts-node -e "import { runAllBenchmarks } from './benchmarks'; runAllBenchmarks()"
+ *
+ * Or with npm script:
+ *   npm run benchmark
+ *   npm run benchmark -- --suite search
+ *   npm run benchmark -- --suite index
+ *   npm run benchmark -- --compare baseline.json
+ */
+export declare function runAllBenchmarks(options?: CLIOptions): Promise<void>;
+/**
+ * CLI options for benchmark runner
+ */
+export interface CLIOptions {
+    /** Run specific suite (search, index, cache, embedding) */
+    suite?: 'search' | 'index' | 'cache' | 'embedding';
+    /** Path to baseline JSON for comparison */
+    compare?: string;
+    /** Output format (text, json) */
+    output?: 'text' | 'json';
+    /** Number of iterations (overrides default) */
+    iterations?: number;
+    /** SMI-689: Enable memory profiling */
+    memory?: boolean;
+    /** SMI-689: Memory regression threshold percentage */
+    memoryThreshold?: number;
+    /** SMI-689: Path to memory baselines JSON file */
+    memoryBaseline?: string;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/benchmarks/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EACL,eAAe,EACf,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,oBAAoB,EACzB,kBAAkB,EAClB,kBAAkB,EAClB,WAAW,EACX,cAAc,EACd,cAAc,EACd,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,sBAAsB,CAAA;AAG7B,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAG3C,OAAO,EAAE,WAAW,IAAI,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAGhE,OAAO,EAAE,cAAc,IAAI,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAGtE,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,KAAK,cAAc,EACnB,KAAK,WAAW,IAAI,mBAAmB,EACvC,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,GAC5B,MAAM,qBAAqB,CAAA;AAG5B,OAAO,EACL,eAAe,EACf,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACrB,cAAc,EACd,qBAAqB,GACtB,MAAM,sBAAsB,CAAA;AAG7B,OAAO,EACL,cAAc,EACd,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,qBAAqB,EAC1B,aAAa,EACb,oBAAoB,GACrB,MAAM,qBAAqB,CAAA;AAG5B,OAAO,EACL,cAAc,EACd,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,aAAa,EACb,oBAAoB,GACrB,MAAM,qBAAqB,CAAA;AAG5B,OAAO,EACL,kBAAkB,EAClB,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC9B,iBAAiB,EACjB,wBAAwB,GACzB,MAAM,yBAAyB,CAAA;AAGhC,OAAO,EACL,UAAU,EACV,IAAI,EACJ,YAAY,EACZ,qBAAqB,EACrB,KAAK,YAAY,GAClB,MAAM,YAAY,CAAA;AAEnB;;;;;;;;;;;GAWG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,GAAE,UAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAoL9E;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,2DAA2D;IAC3D,KAAK,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,WAAW,CAAA;IAClD,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACxB,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,uCAAuC;IACvC,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,sDAAsD;IACtD,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,kDAAkD;IAClD,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB"}

package/dist/benchmarks/index.js

@@ -0,0 +1,208 @@
+/**
+ * SMI-632: Benchmark module exports
+ * SMI-689: Enhanced with MemoryProfiler integration
+ * SMI-1189: Updated to export from split modules
+ *
+ * Provides performance benchmarking infrastructure for:
+ * - Search query latency
+ * - Indexing throughput
+ * - Statistical analysis
+ * - CI integration
+ * - Memory profiling and leak detection
+ */
+// Core benchmark runner (includes re-exports for backwards compatibility)
+export { BenchmarkRunner, formatReportAsJson, formatReportAsText, formatBytes, compareReports, hasRegressions, getRegressedBenchmarks, getImprovedBenchmarks, } from './BenchmarkRunner.js';
+// Types module (direct access)
+export { DEFAULT_CONFIG } from './types.js';
+// Formatters module (direct access)
+export { formatBytes as formatBytesUtil } from './formatters.js';
+// Comparator module (direct access)
+export { hasRegressions as hasRegressionsUtil } from './comparator.js';
+// SMI-689: Memory profiler
+export { MemoryProfiler, defaultMemoryProfiler, } from './MemoryProfiler.js';
+// Search benchmarks
+export { SearchBenchmark, SEARCH_TARGETS, validateSearchResults, } from './SearchBenchmark.js';
+// Index benchmarks
+export { IndexBenchmark, INDEX_TARGETS, validateIndexResults, } from './IndexBenchmark.js';
+// SMI-738: Cache benchmarks
+export { CacheBenchmark, CACHE_TARGETS, validateCacheResults, } from './cacheBenchmark.js';
+// SMI-738: Embedding benchmarks
+export { EmbeddingBenchmark, EMBEDDING_TARGETS, validateEmbeddingResults, } from './embeddingBenchmark.js';
+// SMI-677: Shared statistical utilities
+export { percentile, mean, sampleStddev, calculateLatencyStats, } from './stats.js';
+/**
+ * CLI-friendly benchmark runner
+ *
+ * Usage:
+ *   npx ts-node -e "import { runAllBenchmarks } from './benchmarks'; runAllBenchmarks()"
+ *
+ * Or with npm script:
+ *   npm run benchmark
+ *   npm run benchmark -- --suite search
+ *   npm run benchmark -- --suite index
+ *   npm run benchmark -- --compare baseline.json
+ */
+export async function runAllBenchmarks(options = {}) {
+    const { suite, compare, output = 'text', iterations, memory = false, memoryThreshold = 10, memoryBaseline, } = options;
+    console.log('Starting Skillsmith Performance Benchmarks\n');
+    // SMI-689: Load memory baselines if provided
+    let memoryBaselines = {};
+    if (memoryBaseline) {
+        try {
+            const fs = await import('fs');
+            const baselineData = fs.readFileSync(memoryBaseline, 'utf-8');
+            const parsed = JSON.parse(baselineData);
+            memoryBaselines = parsed.memoryBaselines ?? {};
+            console.log(`Loaded memory baselines from ${memoryBaseline}`);
+        }
+        catch (err) {
+            console.warn(`Warning: Could not load memory baselines: ${err instanceof Error ? err.message : err}`);
+        }
+    }
+    const results = [];
+    // Run search benchmarks
+    if (!suite || suite === 'search') {
+        console.log('Running search benchmarks...');
+        // SMI-689: Enable memory profiling if requested
+        const searchBenchmark = new SearchBenchmark({
+            iterations: iterations ?? 1000,
+            skillCount: 1000,
+            enableMemoryProfiler: memory,
+            memoryRegressionThreshold: memoryThreshold,
+            memoryBaselines: memoryBaselines,
+        });
+        const searchReport = await searchBenchmark.run();
+        results.push(searchReport);
+        const searchValidation = validateSearchResults(searchReport);
+        if (!searchValidation.passed) {
+            console.error('Search benchmark failures:');
+            searchValidation.failures.forEach((f) => console.error(`  - ${f}`));
+        }
+        if (searchValidation.warnings.length > 0) {
+            console.warn('Search benchmark warnings:');
+            searchValidation.warnings.forEach((w) => console.warn(`  - ${w}`));
+        }
+    }
+    // Run index benchmarks
+    if (!suite || suite === 'index') {
+        console.log('Running index benchmarks...');
+        // SMI-689: Enable memory profiling if requested
+        const indexBenchmark = new IndexBenchmark({
+            iterations: iterations ?? 100,
+            enableMemoryProfiler: memory,
+            memoryRegressionThreshold: memoryThreshold,
+            memoryBaselines: memoryBaselines,
+        });
+        const indexReport = await indexBenchmark.run();
+        results.push(indexReport);
+        const indexValidation = validateIndexResults(indexReport);
+        if (!indexValidation.passed) {
+            console.error('Index benchmark failures:');
+            indexValidation.failures.forEach((f) => console.error(`  - ${f}`));
+        }
+        if (indexValidation.warnings.length > 0) {
+            console.warn('Index benchmark warnings:');
+            indexValidation.warnings.forEach((w) => console.warn(`  - ${w}`));
+        }
+    }
+    // SMI-738: Run cache benchmarks
+    if (suite === 'cache') {
+        console.log('Running cache benchmarks...');
+        const cacheBenchmark = new CacheBenchmark({
+            iterations: iterations ?? 1000,
+            enableMemoryProfiler: memory,
+            memoryRegressionThreshold: memoryThreshold,
+            memoryBaselines: memoryBaselines,
+        });
+        const cacheReport = await cacheBenchmark.run();
+        results.push(cacheReport);
+        const cacheValidation = validateCacheResults(cacheReport);
+        if (!cacheValidation.passed) {
+            console.error('Cache benchmark failures:');
+            cacheValidation.failures.forEach((f) => console.error(`  - ${f}`));
+        }
+        if (cacheValidation.warnings.length > 0) {
+            console.warn('Cache benchmark warnings:');
+            cacheValidation.warnings.forEach((w) => console.warn(`  - ${w}`));
+        }
+    }
+    // SMI-738: Run embedding benchmarks
+    if (suite === 'embedding') {
+        console.log('Running embedding benchmarks...');
+        const embeddingBenchmark = new EmbeddingBenchmark({
+            iterations: iterations ?? 50,
+            skipModelLoad: true, // Skip slow model load by default
+            enableMemoryProfiler: memory,
+            memoryRegressionThreshold: memoryThreshold,
+            memoryBaselines: memoryBaselines,
+        });
+        const embeddingReport = await embeddingBenchmark.run();
+        results.push(embeddingReport);
+        const embeddingValidation = validateEmbeddingResults(embeddingReport);
+        if (!embeddingValidation.passed) {
+            console.error('Embedding benchmark failures:');
+            embeddingValidation.failures.forEach((f) => console.error(`  - ${f}`));
+        }
+        if (embeddingValidation.warnings.length > 0) {
+            console.warn('Embedding benchmark warnings:');
+            embeddingValidation.warnings.forEach((w) => console.warn(`  - ${w}`));
+        }
+    }
+    // Output results
+    for (const report of results) {
+        if (output === 'json') {
+            console.log(formatReportAsJson(report));
+        }
+        else {
+            console.log(formatReportAsText(report));
+        }
+    }
+    // Compare with baseline if provided
+    if (compare) {
+        console.log('\nComparing with baseline...');
+        const fs = await import('fs');
+        const baselineData = fs.readFileSync(compare, 'utf-8');
+        const baseline = JSON.parse(baselineData);
+        for (const report of results) {
+            if (report.suite === baseline.suite) {
+                const comparison = compareReports(baseline, report);
+                console.log(`\nComparison for ${report.suite}:`);
+                console.log(`  Regressions: ${comparison.summary.regressions}`);
+                console.log(`  Improvements: ${comparison.summary.improvements}`);
+                console.log(`  Unchanged: ${comparison.summary.unchanged}`);
+                if (comparison.summary.regressions > 0) {
+                    console.error('\nRegression details:');
+                    for (const [name, comp] of Object.entries(comparison.comparisons)) {
+                        if (comp.isRegression) {
+                            console.error(`  ${name}: p95 increased by ${comp.p95ChangePercent}%`);
+                        }
+                    }
+                    process.exitCode = 1;
+                }
+            }
+        }
+    }
+    // SMI-689: Check for memory regressions
+    if (memory) {
+        let hasMemoryRegression = false;
+        for (const report of results) {
+            if (report.memoryRegression?.hasRegressions) {
+                hasMemoryRegression = true;
+                console.error(`\nMemory regression detected in ${report.suite}:`);
+                for (const reg of report.memoryRegression.regressions) {
+                    console.error(`  ${reg.label}: heap grew by ${reg.changePercent.toFixed(1)}%`);
+                }
+            }
+        }
+        if (hasMemoryRegression) {
+            process.exitCode = 1;
+        }
+    }
+}
+// Re-export everything for convenience
+import { SearchBenchmark, validateSearchResults } from './SearchBenchmark.js';
+import { IndexBenchmark, validateIndexResults } from './IndexBenchmark.js';
+import { CacheBenchmark, validateCacheResults } from './cacheBenchmark.js';
+import { EmbeddingBenchmark, validateEmbeddingResults } from './embeddingBenchmark.js';
+import { formatReportAsJson, formatReportAsText, compareReports, } from './BenchmarkRunner.js';
+//# sourceMappingURL=index.js.map

package/dist/benchmarks/index.js.map

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

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

@@ -0,0 +1,165 @@
+/**
+ * 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 type { MemorySnapshot, MemoryStats, MemoryBaseline, LeakDetectionResult, MemoryRegressionResult } from './types.js';
+export type { MemorySnapshot, MemoryStats, MemoryBaseline, LeakDetectionResult, MemoryRegressionResult, } from './types.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 declare class MemoryProfiler {
+    private activeTracking;
+    private completedStats;
+    private baselineManager;
+    private samplingIntervalMs;
+    /**
+     * Create a new MemoryProfiler instance
+     *
+     * @param samplingIntervalMs - Interval in ms for collecting memory samples (default: 100ms)
+     */
+    constructor(samplingIntervalMs?: number);
+    /**
+     * 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: string): void;
+    /**
+     * 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: string): MemoryStats;
+    /**
+     * 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(): MemorySnapshot;
+    /**
+     * 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?: number): LeakDetectionResult;
+    /**
+     * 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: string): MemoryBaseline;
+    /**
+     * Load baselines from a JSON object
+     *
+     * @param baselines - Object mapping labels to baselines
+     */
+    loadBaselines(baselines: Record<string, MemoryBaseline>): void;
+    /**
+     * Check for memory regression against baseline
+     *
+     * @param label - Label to check
+     * @param threshold - Regression threshold percentage (default: 10%)
+     * @returns Regression result
+     */
+    checkRegression(label: string, threshold?: number): MemoryRegressionResult;
+    /**
+     * 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(): string;
+    /**
+     * Get all completed statistics
+     *
+     * @returns Map of label to MemoryStats
+     */
+    getCompletedStats(): Map<string, MemoryStats>;
+    /**
+     * 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 tracking data
+     */
+    clear(): void;
+    /**
+     * Clear baselines
+     */
+    clearBaselines(): void;
+}
+/**
+ * Default memory profiler instance for convenience
+ */
+export declare const defaultMemoryProfiler: MemoryProfiler;
+//# sourceMappingURL=MemoryProfiler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MemoryProfiler.d.ts","sourceRoot":"","sources":["../../../src/benchmarks/memory/MemoryProfiler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EACV,cAAc,EACd,WAAW,EACX,cAAc,EACd,mBAAmB,EACnB,sBAAsB,EAEvB,MAAM,YAAY,CAAA;AAOnB,YAAY,EACV,cAAc,EACd,WAAW,EACX,cAAc,EACd,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,YAAY,CAAA;AAEnB;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,cAAc,CAAwC;IAC9D,OAAO,CAAC,cAAc,CAAsC;IAC5D,OAAO,CAAC,eAAe,CAAyC;IAChE,OAAO,CAAC,kBAAkB,CAAQ;IAElC;;;;OAIG;gBACS,kBAAkB,GAAE,MAAY;IAI5C;;;;;;;;;;OAUG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAyBhC;;;;;;;;;;;;OAYG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW;IA+CxC;;;;;;;;;;OAUG;IACH,eAAe,IAAI,cAAc;IAiBjC;;;;;;;;;;;;;OAaG;IACH,WAAW,CAAC,SAAS,GAAE,MAAW,GAAG,mBAAmB;IAIxD;;;;;OAKG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc;IAQ3C;;;;OAIG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,IAAI;IAI9D;;;;;;OAMG;IACH,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,GAAE,MAAW,GAAG,sBAAsB;IAS9E;;;;;;;;;;;;;OAaG;IACH,kBAAkB,IAAI,MAAM;IA8E5B;;;;OAIG;IACH,iBAAiB,IAAI,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC;IAI7C;;;;OAIG;IACH,YAAY,IAAI,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC;IAI3C;;;;OAIG;IACH,eAAe,IAAI,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC;IAIjD;;OAEG;IACH,KAAK,IAAI,IAAI;IAWb;;OAEG;IACH,cAAc,IAAI,IAAI;CAGvB;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB,gBAAuB,CAAA"}