@skillsmith/core 0.5.5 → 0.5.6

package/dist/audit/remote-audit.test.js

@@ -0,0 +1,81 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { emitInstallEvent } from './remote-audit.js';
+const fetchSpy = vi.fn();
+beforeEach(() => {
+    vi.stubGlobal('fetch', fetchSpy);
+    fetchSpy.mockReset();
+    fetchSpy.mockResolvedValue(new Response(null, { status: 200 }));
+    delete process.env.SKILLSMITH_TELEMETRY;
+    delete process.env.SKILLSMITH_API_URL;
+});
+afterEach(() => {
+    vi.unstubAllGlobals();
+    delete process.env.SKILLSMITH_API_KEY;
+});
+function readBody() {
+    const body = fetchSpy.mock.calls[0]?.[1]?.body;
+    return JSON.parse(body);
+}
+describe('emitInstallEvent', () => {
+    it('skips when no API key is available', async () => {
+        delete process.env.SKILLSMITH_API_KEY;
+        await emitInstallEvent({ skillId: 'acme/foo', source: 'mcp', success: true });
+        expect(fetchSpy).not.toHaveBeenCalled();
+    });
+    it('skips when telemetry is disabled via env', async () => {
+        process.env.SKILLSMITH_API_KEY = 'sk_live_testtoken';
+        process.env.SKILLSMITH_TELEMETRY = '0';
+        await emitInstallEvent({ skillId: 'acme/foo', source: 'mcp', success: true });
+        expect(fetchSpy).not.toHaveBeenCalled();
+    });
+    it('hashes the API key (actor is sha256 hex, not raw key)', async () => {
+        process.env.SKILLSMITH_API_KEY = 'sk_live_testtoken';
+        await emitInstallEvent({ skillId: 'acme/foo', source: 'mcp', success: true });
+        const body = readBody();
+        expect(body.anonymous_id).toMatch(/^[0-9a-f]{64}$/);
+        expect(String(body.anonymous_id)).not.toContain('sk_live');
+    });
+    it('emits with event=skill_install and the expected metadata shape', async () => {
+        process.env.SKILLSMITH_API_KEY = 'sk_live_testtoken';
+        await emitInstallEvent({
+            skillId: 'acme/foo',
+            source: 'cli',
+            success: false,
+            durationMs: 123,
+            trustTier: 'community',
+            errorCode: 'NETWORK_ERROR',
+        });
+        const body = readBody();
+        expect(body.event).toBe('skill_install');
+        expect(body.metadata).toEqual({
+            skill_id: 'acme/foo',
+            source: 'cli',
+            success: false,
+            duration_ms: 123,
+            trust_tier: 'community',
+            error_code: 'NETWORK_ERROR',
+        });
+    });
+    it('omits undefined optional fields from metadata', async () => {
+        process.env.SKILLSMITH_API_KEY = 'sk_live_testtoken';
+        await emitInstallEvent({ skillId: 'acme/foo', source: 'vscode', success: true });
+        const body = readBody();
+        const meta = body.metadata;
+        expect(meta).toEqual({ skill_id: 'acme/foo', source: 'vscode', success: true });
+        expect(meta).not.toHaveProperty('duration_ms');
+        expect(meta).not.toHaveProperty('trust_tier');
+        expect(meta).not.toHaveProperty('error_code');
+    });
+    it('swallows fetch errors and does not throw', async () => {
+        process.env.SKILLSMITH_API_KEY = 'sk_live_testtoken';
+        fetchSpy.mockRejectedValueOnce(new Error('network down'));
+        await expect(emitInstallEvent({ skillId: 'acme/foo', source: 'mcp', success: true })).resolves.toBeUndefined();
+    });
+    it('respects SKILLSMITH_API_URL override', async () => {
+        process.env.SKILLSMITH_API_KEY = 'sk_live_testtoken';
+        process.env.SKILLSMITH_API_URL = 'https://staging.skillsmith.app';
+        await emitInstallEvent({ skillId: 'acme/foo', source: 'mcp', success: true });
+        expect(fetchSpy).toHaveBeenCalledWith('https://staging.skillsmith.app/functions/v1/events', expect.any(Object));
+    });
+});
+//# sourceMappingURL=remote-audit.test.js.map

package/dist/audit/remote-audit.test.js.map

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

package/dist/benchmarks/BenchmarkRunner.d.ts

@@ -0,0 +1,89 @@
+/**
+ * SMI-632: BenchmarkRunner - Performance benchmark infrastructure
+ * SMI-689: Enhanced with MemoryProfiler integration
+ * SMI-1189: Refactored to use extracted modules
+ *
+ * Features:
+ * - Run benchmark suites
+ * - Measure p50, p95, p99 latencies
+ * - Memory usage tracking with MemoryProfiler
+ * - Memory regression detection (fail if heap grows >10% vs baseline)
+ * - Warm-up runs before measurement
+ * - Statistical analysis (mean, stddev)
+ */
+import { MemoryProfiler, type MemoryBaseline } from './MemoryProfiler.js';
+import { type BenchmarkConfig, type BenchmarkResult, type BenchmarkReport, type BenchmarkDefinition } from './types.js';
+export type { BenchmarkConfig, BenchmarkResult, BenchmarkStats, BenchmarkReport, BenchmarkDefinition, BenchmarkFn, EnvironmentInfo, MemoryStats, DetailedMemoryStats, MemoryRegressionInfo, ComparisonResult, MetricComparison, } from './types.js';
+export { formatReportAsJson, formatReportAsText, formatBytes } from './formatters.js';
+export { compareReports, hasRegressions, getRegressedBenchmarks, getImprovedBenchmarks, } from './comparator.js';
+/**
+ * Core benchmark runner for performance testing
+ */
+export declare class BenchmarkRunner {
+    private config;
+    private benchmarks;
+    private results;
+    /** SMI-689: Memory profiler instance */
+    private memoryProfiler;
+    constructor(config?: BenchmarkConfig);
+    /**
+     * Get the memory profiler instance (SMI-689)
+     */
+    getMemoryProfiler(): MemoryProfiler | null;
+    /**
+     * Add a benchmark to the suite
+     */
+    add(definition: BenchmarkDefinition): this;
+    /**
+     * Run all benchmarks in the suite
+     */
+    run(): Promise<BenchmarkReport>;
+    /**
+     * Run a single benchmark with error handling (SMI-678)
+     */
+    private runBenchmark;
+    /**
+     * Generate a benchmark report from results
+     */
+    private generateReport;
+    /**
+     * Calculate statistical metrics from latencies
+     * Uses shared stats module for consistent calculations (SMI-677)
+     * Includes empty array guard (SMI-679) and sample variance (Bessel correction)
+     */
+    private calculateStats;
+    /**
+     * @deprecated Use shared percentile from stats.ts instead (SMI-677)
+     * Calculate percentile value from sorted array
+     */
+    private _legacyPercentile;
+    /**
+     * Get environment information
+     */
+    private getEnvironmentInfo;
+    /**
+     * Detect if running in Docker
+     */
+    private isDocker;
+    /**
+     * Force garbage collection if available
+     */
+    private forceGC;
+    /**
+     * Get raw results
+     */
+    getResults(): BenchmarkResult[];
+    /**
+     * Clear all benchmarks
+     */
+    clear(): void;
+    /**
+     * Enable memory profiler after construction (SMI-689)
+     */
+    enableMemoryProfiler(baselines?: Record<string, MemoryBaseline>): void;
+    /**
+     * Get memory profiling report as string (SMI-689)
+     */
+    getMemoryReport(): string;
+}
+//# sourceMappingURL=BenchmarkRunner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BenchmarkRunner.d.ts","sourceRoot":"","sources":["../../src/benchmarks/BenchmarkRunner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,EACL,cAAc,EACd,KAAK,cAAc,EAEpB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,eAAe,EAEpB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EAGzB,MAAM,YAAY,CAAA;AAGnB,YAAY,EACV,eAAe,EACf,eAAe,EACf,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,WAAW,EACX,eAAe,EACf,WAAW,EACX,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,YAAY,CAAA;AAGnB,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AACrF,OAAO,EACL,cAAc,EACd,cAAc,EACd,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,iBAAiB,CAAA;AAExB;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,UAAU,CAA4B;IAC9C,OAAO,CAAC,OAAO,CAAwB;IACvC,wCAAwC;IACxC,OAAO,CAAC,cAAc,CAA8B;gBAExC,MAAM,GAAE,eAAoB;IAYxC;;OAEG;IACH,iBAAiB,IAAI,cAAc,GAAG,IAAI;IAI1C;;OAEG;IACH,GAAG,CAAC,UAAU,EAAE,mBAAmB,GAAG,IAAI;IAK1C;;OAEG;IACG,GAAG,IAAI,OAAO,CAAC,eAAe,CAAC;IA4BrC;;OAEG;YACW,YAAY;IAgF1B;;OAEG;IACH,OAAO,CAAC,cAAc;IAiEtB;;;;OAIG;IACH,OAAO,CAAC,cAAc;IA4CtB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAMzB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAY1B;;OAEG;IACH,OAAO,CAAC,QAAQ;IAchB;;OAEG;IACH,OAAO,CAAC,OAAO;IAMf;;OAEG;IACH,UAAU,IAAI,eAAe,EAAE;IAI/B;;OAEG;IACH,KAAK,IAAI,IAAI;IAQb;;OAEG;IACH,oBAAoB,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,IAAI;IAQtE;;OAEG;IACH,eAAe,IAAI,MAAM;CAM1B"}

package/dist/benchmarks/BenchmarkRunner.js

@@ -0,0 +1,336 @@
+/**
+ * SMI-632: BenchmarkRunner - Performance benchmark infrastructure
+ * SMI-689: Enhanced with MemoryProfiler integration
+ * SMI-1189: Refactored to use extracted modules
+ *
+ * Features:
+ * - Run benchmark suites
+ * - Measure p50, p95, p99 latencies
+ * - Memory usage tracking with MemoryProfiler
+ * - Memory regression detection (fail if heap grows >10% vs baseline)
+ * - Warm-up runs before measurement
+ * - Statistical analysis (mean, stddev)
+ */
+import * as os from 'os';
+import * as fs from 'fs';
+import { percentile, sampleStddev, mean } from './stats.js';
+import { MemoryProfiler, } from './MemoryProfiler.js';
+import { DEFAULT_CONFIG, } from './types.js';
+// Re-export formatters and comparator for backwards compatibility
+export { formatReportAsJson, formatReportAsText, formatBytes } from './formatters.js';
+export { compareReports, hasRegressions, getRegressedBenchmarks, getImprovedBenchmarks, } from './comparator.js';
+/**
+ * Core benchmark runner for performance testing
+ */
+export class BenchmarkRunner {
+    config;
+    benchmarks = [];
+    results = [];
+    /** SMI-689: Memory profiler instance */
+    memoryProfiler = null;
+    constructor(config = {}) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        // SMI-689: Initialize memory profiler if enabled
+        if (this.config.enableMemoryProfiler) {
+            this.memoryProfiler = new MemoryProfiler();
+            if (this.config.memoryBaselines && Object.keys(this.config.memoryBaselines).length > 0) {
+                this.memoryProfiler.loadBaselines(this.config.memoryBaselines);
+            }
+        }
+    }
+    /**
+     * Get the memory profiler instance (SMI-689)
+     */
+    getMemoryProfiler() {
+        return this.memoryProfiler;
+    }
+    /**
+     * Add a benchmark to the suite
+     */
+    add(definition) {
+        this.benchmarks.push(definition);
+        return this;
+    }
+    /**
+     * Run all benchmarks in the suite
+     */
+    async run() {
+        const startTime = Date.now();
+        this.results = [];
+        for (const benchmark of this.benchmarks) {
+            // SMI-689: Start memory profiling if enabled
+            if (this.memoryProfiler) {
+                this.memoryProfiler.trackMemory(benchmark.name);
+            }
+            const result = await this.runBenchmark(benchmark);
+            this.results.push(result);
+            // SMI-689: Stop memory profiling and save baseline (only if no baseline was pre-loaded)
+            if (this.memoryProfiler) {
+                this.memoryProfiler.stopTracking(benchmark.name);
+                // Only save new baseline if one wasn't already loaded for this benchmark
+                if (!this.config.memoryBaselines[benchmark.name]) {
+                    this.memoryProfiler.saveBaseline(benchmark.name);
+                }
+            }
+        }
+        const totalDuration = Date.now() - startTime;
+        return this.generateReport(totalDuration);
+    }
+    /**
+     * Run a single benchmark with error handling (SMI-678)
+     */
+    async runBenchmark(definition) {
+        const { warmupIterations, iterations, measureMemory } = this.config;
+        const latencies = [];
+        let errors = 0;
+        const errorMessages = [];
+        const MAX_ERROR_MESSAGES = 10;
+        // Setup phase
+        if (definition.setup) {
+            await definition.setup();
+        }
+        // Warm-up phase with error handling
+        for (let i = 0; i < warmupIterations; i++) {
+            try {
+                await definition.fn();
+            }
+            catch {
+                // Ignore warmup errors, just continue
+            }
+        }
+        // Force garbage collection if available
+        this.forceGC();
+        // Capture memory before
+        const memBefore = measureMemory ? process.memoryUsage() : null;
+        let memPeak = memBefore?.heapUsed ?? 0;
+        // Measurement phase with error handling (SMI-678)
+        for (let i = 0; i < iterations; i++) {
+            try {
+                const start = performance.now();
+                await definition.fn();
+                const end = performance.now();
+                latencies.push(end - start);
+                // Track peak memory periodically
+                if (measureMemory && i % 100 === 0) {
+                    const current = process.memoryUsage().heapUsed;
+                    if (current > memPeak) {
+                        memPeak = current;
+                    }
+                }
+            }
+            catch (err) {
+                errors++;
+                if (errorMessages.length < MAX_ERROR_MESSAGES) {
+                    errorMessages.push(err instanceof Error ? err.message : String(err));
+                }
+            }
+        }
+        // Capture memory after
+        const memAfter = measureMemory ? process.memoryUsage() : null;
+        // Teardown phase
+        if (definition.teardown) {
+            await definition.teardown();
+        }
+        const result = {
+            name: definition.name,
+            iterations: latencies.length, // Only count successful iterations
+            latencies,
+            errors,
+            errorMessages,
+        };
+        if (measureMemory && memBefore && memAfter) {
+            result.memoryUsage = {
+                heapUsedBefore: memBefore.heapUsed,
+                heapUsedAfter: memAfter.heapUsed,
+                heapUsedPeak: memPeak,
+                externalBefore: memBefore.external,
+                externalAfter: memAfter.external,
+            };
+        }
+        return result;
+    }
+    /**
+     * Generate a benchmark report from results
+     */
+    generateReport(totalDuration) {
+        const results = {};
+        let totalIterations = 0;
+        for (const result of this.results) {
+            results[result.name] = this.calculateStats(result);
+            totalIterations += result.iterations;
+        }
+        const report = {
+            suite: this.config.suiteName,
+            timestamp: new Date().toISOString(),
+            environment: this.getEnvironmentInfo(),
+            results,
+            summary: {
+                totalBenchmarks: this.results.length,
+                totalIterations,
+                totalDuration_ms: totalDuration,
+            },
+        };
+        // SMI-689: Add memory profiling data if enabled
+        if (this.memoryProfiler) {
+            const completedStats = this.memoryProfiler.getCompletedStats();
+            const memoryProfile = {};
+            for (const [label, stats] of completedStats) {
+                memoryProfile[label] = {
+                    startHeapSize: stats.startSnapshot.usedHeapSize,
+                    endHeapSize: stats.endSnapshot?.usedHeapSize ?? 0,
+                    peakHeapSize: stats.peakHeapUsed,
+                    heapGrowth: stats.heapGrowth,
+                    heapGrowthPercent: stats.heapGrowthPercent,
+                    profilingDuration: stats.duration,
+                    sampleCount: stats.sampleCount,
+                };
+            }
+            report.memoryProfile = memoryProfile;
+            report.memoryBaselines = this.memoryProfiler.exportBaselines();
+            // Check for regressions if baselines were provided
+            if (Object.keys(this.config.memoryBaselines).length > 0) {
+                const regressions = [];
+                for (const label of completedStats.keys()) {
+                    const result = this.memoryProfiler.checkRegression(label, this.config.memoryRegressionThreshold);
+                    if (result.hasRegression) {
+                        regressions.push(result);
+                    }
+                }
+                report.memoryRegression = {
+                    hasRegressions: regressions.length > 0,
+                    threshold: this.config.memoryRegressionThreshold,
+                    regressions,
+                };
+            }
+        }
+        return report;
+    }
+    /**
+     * Calculate statistical metrics from latencies
+     * Uses shared stats module for consistent calculations (SMI-677)
+     * Includes empty array guard (SMI-679) and sample variance (Bessel correction)
+     */
+    calculateStats(result) {
+        // SMI-679: Empty array guard
+        if (result.latencies.length === 0) {
+            return {
+                name: result.name,
+                iterations: 0,
+                p50_ms: 0,
+                p95_ms: 0,
+                p99_ms: 0,
+                mean_ms: 0,
+                stddev_ms: 0,
+                min_ms: 0,
+                max_ms: 0,
+                errors: result.errors,
+                errorMessages: result.errorMessages,
+            };
+        }
+        const sorted = [...result.latencies].sort((a, b) => a - b);
+        const n = sorted.length;
+        // SMI-677: Use shared percentile function with linear interpolation
+        // Use sample stddev (n-1 denominator) for Bessel correction
+        const stats = {
+            name: result.name,
+            iterations: result.iterations,
+            p50_ms: percentile(sorted, 50),
+            p95_ms: percentile(sorted, 95),
+            p99_ms: percentile(sorted, 99),
+            mean_ms: Math.round(mean(sorted) * 1000) / 1000,
+            stddev_ms: Math.round(sampleStddev(sorted) * 1000) / 1000,
+            min_ms: sorted[0],
+            max_ms: sorted[n - 1],
+            errors: result.errors,
+            errorMessages: result.errorMessages,
+        };
+        if (result.memoryUsage) {
+            stats.memoryPeak_mb = Math.round((result.memoryUsage.heapUsedPeak / 1024 / 1024) * 100) / 100;
+        }
+        return stats;
+    }
+    /**
+     * @deprecated Use shared percentile from stats.ts instead (SMI-677)
+     * Calculate percentile value from sorted array
+     */
+    _legacyPercentile(sorted, p) {
+        const index = Math.ceil((p / 100) * sorted.length) - 1;
+        const value = sorted[Math.max(0, index)];
+        return Math.round(value * 1000) / 1000;
+    }
+    /**
+     * Get environment information
+     */
+    getEnvironmentInfo() {
+        return {
+            node: process.version,
+            platform: process.platform,
+            arch: process.arch,
+            docker: this.isDocker(),
+            database: 'sqlite',
+            cpuCount: os.cpus().length,
+            memoryTotal_mb: Math.round(os.totalmem() / 1024 / 1024),
+        };
+    }
+    /**
+     * Detect if running in Docker
+     */
+    isDocker() {
+        try {
+            // Check for .dockerenv file
+            if (fs.existsSync('/.dockerenv')) {
+                return true;
+            }
+            // Check for docker in cgroup
+            const cgroup = fs.readFileSync('/proc/1/cgroup', 'utf8');
+            return cgroup.includes('docker');
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Force garbage collection if available
+     */
+    forceGC() {
+        if (typeof global.gc === 'function') {
+            global.gc();
+        }
+    }
+    /**
+     * Get raw results
+     */
+    getResults() {
+        return this.results;
+    }
+    /**
+     * Clear all benchmarks
+     */
+    clear() {
+        this.benchmarks = [];
+        this.results = [];
+        if (this.memoryProfiler) {
+            this.memoryProfiler.clear();
+        }
+    }
+    /**
+     * Enable memory profiler after construction (SMI-689)
+     */
+    enableMemoryProfiler(baselines) {
+        this.memoryProfiler = new MemoryProfiler();
+        if (baselines) {
+            this.memoryProfiler.loadBaselines(baselines);
+            this.config.memoryBaselines = baselines;
+        }
+    }
+    /**
+     * Get memory profiling report as string (SMI-689)
+     */
+    getMemoryReport() {
+        if (!this.memoryProfiler) {
+            return 'Memory profiling not enabled. Use enableMemoryProfiler: true in config.';
+        }
+        return this.memoryProfiler.formatMemoryReport();
+    }
+}
+//# sourceMappingURL=BenchmarkRunner.js.map

package/dist/benchmarks/BenchmarkRunner.js.map

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

package/dist/benchmarks/IndexBenchmark.d.ts

@@ -0,0 +1,101 @@
+/**
+ * SMI-632: IndexBenchmark - Indexing throughput benchmarks
+ *
+ * Features:
+ * - Batch insert performance
+ * - Update performance
+ * - Database size impact
+ * - FTS5 index maintenance
+ */
+import { type BenchmarkReport, type BenchmarkConfig } from './BenchmarkRunner.js';
+/**
+ * Index benchmark configuration
+ */
+export interface IndexBenchmarkConfig extends BenchmarkConfig {
+    /** Batch size for insert operations */
+    batchSize?: number;
+    /** Number of skills for size impact tests */
+    baseDatabaseSize?: number;
+}
+/**
+ * Performance targets for indexing operations
+ */
+export declare const INDEX_TARGETS: {
+    /** Skills indexed per second for batch inserts */
+    throughput_skills_per_sec: number;
+    /** Maximum time for single insert (ms) */
+    single_insert_max_ms: number;
+    /** Maximum time for batch of 100 inserts (ms) */
+    batch_100_max_ms: number;
+};
+/**
+ * Indexing benchmark suite
+ */
+export declare class IndexBenchmark {
+    private config;
+    private db;
+    private repo;
+    private skillCounter;
+    constructor(config?: IndexBenchmarkConfig);
+    /**
+     * Run all indexing benchmarks
+     */
+    run(): Promise<BenchmarkReport>;
+    /**
+     * Run throughput benchmark (measures skills per second)
+     */
+    runThroughput(): Promise<ThroughputResult>;
+    /**
+     * Run database size impact benchmark
+     */
+    runSizeImpact(): Promise<SizeImpactResult>;
+    /**
+     * Setup database
+     */
+    private setup;
+    /**
+     * Cleanup database resources
+     */
+    private teardown;
+    /**
+     * Generate a batch of test skills
+     */
+    private generateBatchSkills;
+}
+/**
+ * Throughput benchmark result
+ */
+export interface ThroughputResult {
+    timestamp: string;
+    results: Record<string, {
+        batchSize: number;
+        duration_ms: number;
+        throughput_per_sec: number;
+        meetsTarget: boolean;
+    }>;
+}
+/**
+ * Size impact benchmark result
+ */
+export interface SizeImpactResult {
+    timestamp: string;
+    results: Record<string, {
+        databaseSize: number;
+        avgInsert_ms: number;
+        p50Insert_ms: number;
+        p95Insert_ms: number;
+    }>;
+}
+/**
+ * Validate indexing benchmark results against targets
+ */
+export declare function validateIndexResults(report: BenchmarkReport): IndexValidationResult;
+/**
+ * Index validation result
+ */
+export interface IndexValidationResult {
+    passed: boolean;
+    failures: string[];
+    warnings: string[];
+}
+//# sourceMappingURL=IndexBenchmark.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IndexBenchmark.d.ts","sourceRoot":"","sources":["../../src/benchmarks/IndexBenchmark.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,EAAmB,KAAK,eAAe,EAAE,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAGlG;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,eAAe;IAC3D,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,6CAA6C;IAC7C,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B;AAeD;;GAEG;AACH,eAAO,MAAM,aAAa;IACxB,kDAAkD;;IAElD,0CAA0C;;IAE1C,iDAAiD;;CAElD,CAAA;AAED;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAgC;IAC9C,OAAO,CAAC,EAAE,CAA4B;IACtC,OAAO,CAAC,IAAI,CAA+B;IAC3C,OAAO,CAAC,YAAY,CAAY;gBAEpB,MAAM,GAAE,oBAAyB;IAI7C;;OAEG;IACG,GAAG,IAAI,OAAO,CAAC,eAAe,CAAC;IA4IrC;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAmChD;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,gBAAgB,CAAC;IA2ChD;;OAEG;YACW,KAAK;IAMnB;;OAEG;YACW,QAAQ;IAQtB;;OAEG;IACH,OAAO,CAAC,mBAAmB;CAsB5B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CACb,MAAM,EACN;QACE,SAAS,EAAE,MAAM,CAAA;QACjB,WAAW,EAAE,MAAM,CAAA;QACnB,kBAAkB,EAAE,MAAM,CAAA;QAC1B,WAAW,EAAE,OAAO,CAAA;KACrB,CACF,CAAA;CACF;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CACb,MAAM,EACN;QACE,YAAY,EAAE,MAAM,CAAA;QACpB,YAAY,EAAE,MAAM,CAAA;QACpB,YAAY,EAAE,MAAM,CAAA;QACpB,YAAY,EAAE,MAAM,CAAA;KACrB,CACF,CAAA;CACF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,eAAe,GAAG,qBAAqB,CAoCnF;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,OAAO,CAAA;IACf,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB"}