@skillsmith/core 0.5.5 → 0.5.6

package/dist/benchmarks/SearchBenchmark.js

@@ -0,0 +1,321 @@
+/**
+ * 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 { createDatabaseAsync, closeDatabase } from '../db/schema.js';
+import { SkillRepository } from '../repositories/SkillRepository.js';
+import { SearchService } from '../services/SearchService.js';
+import { BenchmarkRunner } from './BenchmarkRunner.js';
+const DEFAULT_CONFIG = {
+    warmupIterations: 5,
+    iterations: 1000,
+    measureMemory: true,
+    suiteName: 'search',
+    skillCount: 1000,
+    coldCache: false,
+    // SMI-689: Memory profiling defaults
+    enableMemoryProfiler: false,
+    memoryRegressionThreshold: 10,
+    memoryBaselines: {},
+};
+/**
+ * Performance targets for search operations
+ */
+export const SEARCH_TARGETS = {
+    p50_ms: 100,
+    p95_ms: 300,
+    p99_ms: 500,
+    memoryPeak_mb: 50,
+};
+/**
+ * Search query benchmark suite
+ */
+export class SearchBenchmark {
+    config;
+    db = null;
+    repo = null;
+    search = null;
+    constructor(config = {}) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * Run all search benchmarks
+     */
+    async run() {
+        const runner = new BenchmarkRunner({
+            warmupIterations: this.config.warmupIterations,
+            iterations: this.config.iterations,
+            measureMemory: this.config.measureMemory,
+            suiteName: this.config.suiteName,
+        });
+        // Setup database and seed data
+        await this.setup();
+        // Simple query benchmarks
+        runner.add({
+            name: 'simple_query',
+            fn: () => {
+                if (this.config.coldCache) {
+                    this.search.clearCache();
+                }
+                this.search.search({ query: 'typescript' });
+            },
+        });
+        runner.add({
+            name: 'simple_query_common_term',
+            fn: () => {
+                if (this.config.coldCache) {
+                    this.search.clearCache();
+                }
+                this.search.search({ query: 'skill' });
+            },
+        });
+        runner.add({
+            name: 'simple_query_rare_term',
+            fn: () => {
+                if (this.config.coldCache) {
+                    this.search.clearCache();
+                }
+                this.search.search({ query: 'xyzzy123' });
+            },
+        });
+        // Complex query benchmarks
+        runner.add({
+            name: 'multi_term_query',
+            fn: () => {
+                if (this.config.coldCache) {
+                    this.search.clearCache();
+                }
+                this.search.search({ query: 'typescript formatting code' });
+            },
+        });
+        runner.add({
+            name: 'phrase_query',
+            fn: () => {
+                if (this.config.coldCache) {
+                    this.search.clearCache();
+                }
+                this.search.searchPhrase('TypeScript code');
+            },
+        });
+        runner.add({
+            name: 'boolean_query_and',
+            fn: () => {
+                if (this.config.coldCache) {
+                    this.search.clearCache();
+                }
+                this.search.searchBoolean({ must: ['typescript', 'formatting'] });
+            },
+        });
+        runner.add({
+            name: 'boolean_query_or',
+            fn: () => {
+                if (this.config.coldCache) {
+                    this.search.clearCache();
+                }
+                this.search.searchBoolean({ should: ['typescript', 'javascript', 'python'] });
+            },
+        });
+        // Filtered query benchmarks
+        runner.add({
+            name: 'filtered_by_trust_tier',
+            fn: () => {
+                if (this.config.coldCache) {
+                    this.search.clearCache();
+                }
+                this.search.search({ query: 'skill', trustTier: 'verified' });
+            },
+        });
+        runner.add({
+            name: 'filtered_by_quality_score',
+            fn: () => {
+                if (this.config.coldCache) {
+                    this.search.clearCache();
+                }
+                this.search.search({ query: 'skill', minQualityScore: 0.8 });
+            },
+        });
+        runner.add({
+            name: 'combined_filters',
+            fn: () => {
+                if (this.config.coldCache) {
+                    this.search.clearCache();
+                }
+                this.search.search({
+                    query: 'skill',
+                    trustTier: 'verified',
+                    minQualityScore: 0.7,
+                });
+            },
+        });
+        // Pagination benchmarks
+        runner.add({
+            name: 'paginated_first_page',
+            fn: () => {
+                if (this.config.coldCache) {
+                    this.search.clearCache();
+                }
+                this.search.search({ query: 'skill', limit: 20, offset: 0 });
+            },
+        });
+        runner.add({
+            name: 'paginated_deep_page',
+            fn: () => {
+                if (this.config.coldCache) {
+                    this.search.clearCache();
+                }
+                this.search.search({ query: 'skill', limit: 20, offset: 500 });
+            },
+        });
+        // Suggestions benchmark
+        runner.add({
+            name: 'suggestions',
+            fn: () => {
+                this.search.suggest('Type', 10);
+            },
+        });
+        // Similar skills benchmark - cache skill ID to avoid overhead
+        let similarSkillId = null;
+        runner.add({
+            name: 'find_similar',
+            setup: () => {
+                const skills = this.repo.findAll(1, 0);
+                similarSkillId = skills.items.length > 0 ? skills.items[0].id : null;
+            },
+            fn: () => {
+                if (similarSkillId) {
+                    this.search.findSimilar(similarSkillId, 5);
+                }
+            },
+        });
+        // Popular skills benchmark
+        runner.add({
+            name: 'get_popular',
+            fn: () => {
+                this.search.getPopular(undefined, 10);
+            },
+        });
+        runner.add({
+            name: 'get_popular_filtered',
+            fn: () => {
+                this.search.getPopular('verified', 10);
+            },
+        });
+        // Empty result benchmarks
+        runner.add({
+            name: 'empty_results',
+            fn: () => {
+                if (this.config.coldCache) {
+                    this.search.clearCache();
+                }
+                this.search.search({ query: 'nonexistentterm12345' });
+            },
+        });
+        // Run benchmarks
+        const report = await runner.run();
+        // Cleanup
+        await this.teardown();
+        return report;
+    }
+    /**
+     * Run cold cache benchmarks (separate from main suite)
+     */
+    async runColdCache() {
+        const coldConfig = { ...this.config, coldCache: true, suiteName: 'search_cold' };
+        const coldBenchmark = new SearchBenchmark(coldConfig);
+        return coldBenchmark.run();
+    }
+    /**
+     * Setup database and seed test data
+     */
+    async setup() {
+        this.db = await createDatabaseAsync(':memory:');
+        this.repo = new SkillRepository(this.db);
+        this.search = new SearchService(this.db, { cacheTtl: 60 });
+        // Seed test data
+        const skills = this.generateTestSkills(this.config.skillCount);
+        this.repo.createBatch(skills);
+    }
+    /**
+     * Cleanup database resources
+     */
+    async teardown() {
+        if (this.db) {
+            closeDatabase(this.db);
+            this.db = null;
+            this.repo = null;
+            this.search = null;
+        }
+    }
+    /**
+     * Generate test skills with realistic distribution
+     */
+    generateTestSkills(count) {
+        const languages = ['TypeScript', 'JavaScript', 'Python', 'Go', 'Rust', 'Java', 'CPlusPlus'];
+        const categories = [
+            'formatting',
+            'linting',
+            'testing',
+            'deployment',
+            'documentation',
+            'security',
+        ];
+        const trustTiers = [
+            'verified',
+            'community',
+            'experimental',
+            'unknown',
+        ];
+        const authors = ['developer-one', 'developer-two', 'developer-three', 'org-alpha', 'org-beta'];
+        return Array.from({ length: count }, (_, i) => {
+            const lang = languages[i % languages.length];
+            const category = categories[i % categories.length];
+            const tier = trustTiers[i % trustTiers.length];
+            // Use words instead of numbers to avoid FTS5 column parsing issues
+            const suffix = ['alpha', 'beta', 'gamma', 'delta', 'epsilon'][i % 5];
+            return {
+                name: `${lang} ${category} skill ${suffix}`,
+                description: `A comprehensive ${category} skill for ${lang} code with advanced features and best practices support.`,
+                author: authors[i % authors.length],
+                tags: [lang.toLowerCase(), category, 'skill', i % 2 === 0 ? 'popular' : 'niche'],
+                qualityScore: 0.5 + Math.random() * 0.5, // 0.5 to 1.0
+                trustTier: tier,
+            };
+        });
+    }
+}
+/**
+ * Validate search benchmark results against targets
+ */
+export function validateSearchResults(report) {
+    const failures = [];
+    const warnings = [];
+    for (const [name, stats] of Object.entries(report.results)) {
+        // Check p50 target
+        if (stats.p50_ms > SEARCH_TARGETS.p50_ms) {
+            failures.push(`${name}: p50 (${stats.p50_ms}ms) exceeds target (${SEARCH_TARGETS.p50_ms}ms)`);
+        }
+        // Check p95 target
+        if (stats.p95_ms > SEARCH_TARGETS.p95_ms) {
+            failures.push(`${name}: p95 (${stats.p95_ms}ms) exceeds target (${SEARCH_TARGETS.p95_ms}ms)`);
+        }
+        // Check p99 target
+        if (stats.p99_ms > SEARCH_TARGETS.p99_ms) {
+            failures.push(`${name}: p99 (${stats.p99_ms}ms) exceeds target (${SEARCH_TARGETS.p99_ms}ms)`);
+        }
+        // Check memory target
+        if (stats.memoryPeak_mb && stats.memoryPeak_mb > SEARCH_TARGETS.memoryPeak_mb) {
+            warnings.push(`${name}: memory peak (${stats.memoryPeak_mb}MB) exceeds target (${SEARCH_TARGETS.memoryPeak_mb}MB)`);
+        }
+    }
+    return {
+        passed: failures.length === 0,
+        failures,
+        warnings,
+    };
+}
+//# sourceMappingURL=SearchBenchmark.js.map

package/dist/benchmarks/SearchBenchmark.js.map

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

package/dist/benchmarks/cacheBenchmark.d.ts

@@ -0,0 +1,75 @@
+/**
+ * SMI-738: Cache Operation Benchmarks
+ *
+ * Measures performance of cache operations:
+ * - L1 (LRU) cache get/set operations
+ * - L2 (SQLite) cache persistence
+ * - Tiered cache hit/miss patterns
+ * - Cache invalidation performance
+ * - TTL tier calculations
+ */
+import { type BenchmarkReport, type BenchmarkConfig } from './BenchmarkRunner.js';
+/**
+ * Cache benchmark configuration
+ */
+export interface CacheBenchmarkConfig extends BenchmarkConfig {
+    /** Number of entries to pre-populate cache (default: 1000) */
+    cacheSize?: number;
+    /** L1 cache max size (default: 500) */
+    l1MaxSize?: number;
+    /** Simulate cache misses ratio (0-1, default: 0.2) */
+    missRatio?: number;
+}
+/**
+ * Performance targets for cache operations
+ */
+export declare const CACHE_TARGETS: {
+    l1_get_p50_ms: number;
+    l1_get_p95_ms: number;
+    l2_get_p50_ms: number;
+    l2_get_p95_ms: number;
+    set_p50_ms: number;
+    set_p95_ms: number;
+    invalidate_p50_ms: number;
+    invalidate_p95_ms: number;
+};
+/**
+ * Cache operation benchmark suite
+ */
+export declare class CacheBenchmark {
+    private config;
+    private tieredCache;
+    private cacheManager;
+    private testKeys;
+    private testResults;
+    constructor(config?: CacheBenchmarkConfig);
+    /**
+     * Run all cache benchmarks
+     */
+    run(): Promise<BenchmarkReport>;
+    /**
+     * Setup caches with test data
+     */
+    private setup;
+    /**
+     * Cleanup resources
+     */
+    private teardown;
+    /**
+     * Generate mock search results
+     */
+    private generateMockResults;
+}
+/**
+ * Validate cache benchmark results against targets
+ */
+export declare function validateCacheResults(report: BenchmarkReport): CacheValidationResult;
+/**
+ * Cache validation result
+ */
+export interface CacheValidationResult {
+    passed: boolean;
+    failures: string[];
+    warnings: string[];
+}
+//# sourceMappingURL=cacheBenchmark.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cacheBenchmark.d.ts","sourceRoot":"","sources":["../../src/benchmarks/cacheBenchmark.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAmB,KAAK,eAAe,EAAE,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAKlG;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,eAAe;IAC3D,8DAA8D;IAC9D,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAeD;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;CASzB,CAAA;AAED;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAgC;IAC9C,OAAO,CAAC,WAAW,CAAmC;IACtD,OAAO,CAAC,YAAY,CAA4B;IAChD,OAAO,CAAC,QAAQ,CAAe;IAC/B,OAAO,CAAC,WAAW,CAA0E;gBAEjF,MAAM,GAAE,oBAAyB;IAI7C;;OAEG;IACG,GAAG,IAAI,OAAO,CAAC,eAAe,CAAC;IAsLrC;;OAEG;YACW,KAAK;IAwCnB;;OAEG;YACW,QAAQ;IAatB;;OAEG;IACH,OAAO,CAAC,mBAAmB;CAS5B;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,eAAe,GAAG,qBAAqB,CA0CnF;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,OAAO,CAAA;IACf,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB"}