@stackmemoryai/stackmemory 0.2.9 → 0.3.0

package/dist/src/core/performance/performance-benchmark.js

@@ -0,0 +1,290 @@
+/**
+ * Performance Benchmark Suite
+ * Measure improvements from optimization efforts
+ */
+import { performance } from 'perf_hooks';
+import { logger } from '../monitoring/logger.js';
+import { StreamingJSONLParser } from './streaming-jsonl-parser.js';
+import { ContextCache } from './context-cache.js';
+import { LazyContextLoader } from './lazy-context-loader.js';
+import { readFileSync } from 'fs';
+import { join } from 'path';
+export class PerformanceBenchmark {
+    results = [];
+    /**
+     * Benchmark JSONL parsing performance
+     */
+    async benchmarkJSONLParsing(filePath, iterations = 3) {
+        const parser = new StreamingJSONLParser();
+        // Baseline: traditional sync parsing
+        const baselineStart = performance.now();
+        const baselineMemStart = process.memoryUsage().heapUsed;
+        let baselineCount = 0;
+        for (let i = 0; i < iterations; i++) {
+            const content = readFileSync(filePath, 'utf8');
+            const lines = content.split('\n').filter(l => l.trim());
+            for (const line of lines) {
+                try {
+                    JSON.parse(line);
+                    baselineCount++;
+                }
+                catch { }
+            }
+        }
+        const baselineDuration = performance.now() - baselineStart;
+        const baselineMemUsed = process.memoryUsage().heapUsed - baselineMemStart;
+        // Optimized: streaming parser
+        const optimizedStart = performance.now();
+        const optimizedMemStart = process.memoryUsage().heapUsed;
+        let optimizedCount = 0;
+        for (let i = 0; i < iterations; i++) {
+            for await (const batch of parser.parseStream(filePath)) {
+                optimizedCount += batch.length;
+            }
+        }
+        const optimizedDuration = performance.now() - optimizedStart;
+        const optimizedMemUsed = process.memoryUsage().heapUsed - optimizedMemStart;
+        const improvement = ((baselineDuration - optimizedDuration) / baselineDuration) * 100;
+        const memImprovement = ((baselineMemUsed - optimizedMemUsed) / baselineMemUsed) * 100;
+        const result = {
+            name: 'JSONL Parsing',
+            duration: optimizedDuration / iterations,
+            memoryUsed: optimizedMemUsed,
+            itemsProcessed: optimizedCount / iterations,
+            throughput: (optimizedCount / iterations) / (optimizedDuration / 1000 / iterations),
+            improvement,
+        };
+        logger.info('JSONL Parsing Benchmark', {
+            baseline: {
+                duration: baselineDuration / iterations,
+                memory: baselineMemUsed,
+                throughput: (baselineCount / iterations) / (baselineDuration / 1000 / iterations),
+            },
+            optimized: result,
+            improvements: {
+                speed: `${improvement.toFixed(1)}%`,
+                memory: `${memImprovement.toFixed(1)}%`,
+            },
+        });
+        this.results.push(result);
+        return result;
+    }
+    /**
+     * Benchmark context caching performance
+     */
+    async benchmarkContextCache(itemCount = 1000, accessPatterns = 10000) {
+        const cache = new ContextCache({
+            maxSize: 50 * 1024 * 1024,
+            maxItems: itemCount,
+        });
+        // Prepare test data
+        const testData = Array.from({ length: itemCount }, (_, i) => ({
+            key: `item-${i}`,
+            value: {
+                id: i,
+                data: 'x'.repeat(Math.floor(Math.random() * 1000)),
+                timestamp: Date.now(),
+            },
+        }));
+        // Populate cache
+        const populateStart = performance.now();
+        for (const item of testData) {
+            cache.set(item.key, item.value);
+        }
+        const populateDuration = performance.now() - populateStart;
+        // Benchmark cache access
+        const accessStart = performance.now();
+        let hits = 0;
+        let misses = 0;
+        for (let i = 0; i < accessPatterns; i++) {
+            const index = Math.floor(Math.random() * itemCount * 1.2); // Some will miss
+            const key = `item-${index}`;
+            const result = cache.get(key);
+            if (result)
+                hits++;
+            else
+                misses++;
+        }
+        const accessDuration = performance.now() - accessStart;
+        const stats = cache.getStats();
+        const result = {
+            name: 'Context Cache',
+            duration: accessDuration,
+            memoryUsed: cache.getSize().bytes,
+            itemsProcessed: accessPatterns,
+            throughput: accessPatterns / (accessDuration / 1000),
+            improvement: stats.hitRate * 100,
+        };
+        logger.info('Context Cache Benchmark', {
+            populate: {
+                duration: populateDuration,
+                items: itemCount,
+            },
+            access: {
+                duration: accessDuration,
+                patterns: accessPatterns,
+                hitRate: `${(stats.hitRate * 100).toFixed(1)}%`,
+            },
+            performance: {
+                throughput: `${result.throughput.toFixed(0)} ops/sec`,
+                avgAccessTime: `${stats.avgAccessTime.toFixed(2)}ms`,
+            },
+        });
+        this.results.push(result);
+        return result;
+    }
+    /**
+     * Benchmark lazy loading performance
+     */
+    async benchmarkLazyLoading(db, projectId, frameCount = 100) {
+        const loader = new LazyContextLoader(db, projectId);
+        // Check if frames table exists, if not use a mock test
+        let frames = [];
+        try {
+            frames = db.prepare('SELECT id FROM frames ORDER BY updated_at DESC LIMIT ?').all(frameCount);
+        }
+        catch (error) {
+            // Create mock frame IDs if table doesn't exist
+            logger.warn('Frames table not found, using mock data for benchmark');
+            frames = Array.from({ length: Math.min(frameCount, 10) }, (_, i) => ({
+                id: `frame-${i}`,
+            }));
+        }
+        const frameIds = frames.map((f) => f.id);
+        // Benchmark eager loading (baseline)
+        const eagerStart = performance.now();
+        const eagerMemStart = process.memoryUsage().heapUsed;
+        const eagerData = [];
+        for (const id of frameIds) {
+            try {
+                const frame = db.prepare('SELECT * FROM frames WHERE id = ?').get(id);
+                const anchors = db.prepare('SELECT * FROM anchors WHERE frame_id = ?').all(id);
+                const events = db.prepare('SELECT * FROM events WHERE frame_id = ? LIMIT 10').all(id);
+                eagerData.push({ frame, anchors, events });
+            }
+            catch {
+                // Use mock data if tables don't exist
+                eagerData.push({
+                    frame: { id, type: 'mock', name: `Mock ${id}` },
+                    anchors: [],
+                    events: [],
+                });
+            }
+        }
+        const eagerDuration = performance.now() - eagerStart;
+        const eagerMemUsed = process.memoryUsage().heapUsed - eagerMemStart;
+        // Benchmark lazy loading
+        const lazyStart = performance.now();
+        const lazyMemStart = process.memoryUsage().heapUsed;
+        // Preload with lazy loading
+        await loader.preloadContext(frameIds, { parallel: true, depth: 2 });
+        // Access data lazily
+        let accessedCount = 0;
+        for (const id of frameIds.slice(0, frameCount / 2)) {
+            const frame = await loader.lazyFrame(id).get();
+            if (frame)
+                accessedCount++;
+        }
+        const lazyDuration = performance.now() - lazyStart;
+        const lazyMemUsed = process.memoryUsage().heapUsed - lazyMemStart;
+        const improvement = ((eagerDuration - lazyDuration) / eagerDuration) * 100;
+        const memImprovement = ((eagerMemUsed - lazyMemUsed) / eagerMemUsed) * 100;
+        const result = {
+            name: 'Lazy Loading',
+            duration: lazyDuration,
+            memoryUsed: lazyMemUsed,
+            itemsProcessed: frameCount,
+            throughput: frameCount / (lazyDuration / 1000),
+            improvement,
+        };
+        logger.info('Lazy Loading Benchmark', {
+            eager: {
+                duration: eagerDuration,
+                memory: eagerMemUsed,
+            },
+            lazy: {
+                duration: lazyDuration,
+                memory: lazyMemUsed,
+                accessed: accessedCount,
+            },
+            improvements: {
+                speed: `${improvement.toFixed(1)}%`,
+                memory: `${memImprovement.toFixed(1)}%`,
+            },
+        });
+        this.results.push(result);
+        return result;
+    }
+    /**
+     * Run full benchmark suite
+     */
+    async runFullSuite(projectRoot, db, projectId) {
+        const suiteStart = performance.now();
+        logger.info('Starting Performance Benchmark Suite');
+        // Run benchmarks
+        const tasksFile = join(projectRoot, '.stackmemory', 'tasks.jsonl');
+        const jsonlResult = await this.benchmarkJSONLParsing(tasksFile);
+        const cacheResult = await this.benchmarkContextCache();
+        const lazyResult = await this.benchmarkLazyLoading(db, projectId);
+        const totalDuration = performance.now() - suiteStart;
+        const averageImprovement = this.results
+            .filter(r => r.improvement !== undefined)
+            .reduce((sum, r) => sum + (r.improvement || 0), 0) /
+            this.results.filter(r => r.improvement !== undefined).length;
+        const suite = {
+            name: 'Performance Optimization Suite',
+            results: this.results,
+            totalDuration,
+            averageImprovement,
+        };
+        // Generate summary report
+        this.generateReport(suite);
+        return suite;
+    }
+    /**
+     * Generate performance report
+     */
+    generateReport(suite) {
+        console.log('\n╔════════════════════════════════════════════╗');
+        console.log('║     Performance Benchmark Results         ║');
+        console.log('╚════════════════════════════════════════════╝\n');
+        for (const result of suite.results) {
+            console.log(`📊 ${result.name}`);
+            console.log(`   Duration: ${result.duration.toFixed(2)}ms`);
+            console.log(`   Memory: ${(result.memoryUsed / 1024 / 1024).toFixed(2)}MB`);
+            console.log(`   Throughput: ${result.throughput.toFixed(0)} items/sec`);
+            if (result.improvement !== undefined) {
+                const icon = result.improvement > 0 ? '🚀' : '⚠️';
+                console.log(`   ${icon} Improvement: ${result.improvement.toFixed(1)}%`);
+            }
+            console.log('');
+        }
+        console.log('═══════════════════════════════════════════');
+        console.log(`⏱️  Total Duration: ${suite.totalDuration.toFixed(2)}ms`);
+        console.log(`📈 Average Improvement: ${suite.averageImprovement.toFixed(1)}%`);
+        console.log('');
+        logger.info('Performance Benchmark Complete', {
+            suite: suite.name,
+            duration: suite.totalDuration,
+            avgImprovement: suite.averageImprovement,
+            results: suite.results.map(r => ({
+                name: r.name,
+                improvement: r.improvement,
+                throughput: r.throughput,
+            })),
+        });
+    }
+    /**
+     * Get benchmark results
+     */
+    getResults() {
+        return this.results;
+    }
+    /**
+     * Clear results
+     */
+    clearResults() {
+        this.results = [];
+    }
+}
+//# sourceMappingURL=performance-benchmark.js.map

package/dist/src/core/performance/performance-benchmark.js.map

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

package/dist/src/core/performance/performance-profiler.d.ts

@@ -0,0 +1,151 @@
+/**
+ * Performance Profiler
+ * Identifies and optimizes hot paths in StackMemory operations
+ */
+import Database from 'better-sqlite3';
+export interface PerformanceMetrics {
+    operationName: string;
+    callCount: number;
+    totalTimeMs: number;
+    avgTimeMs: number;
+    minTimeMs: number;
+    maxTimeMs: number;
+    p95TimeMs: number;
+    lastExecuted: number;
+}
+export interface HotPath {
+    path: string;
+    frequency: number;
+    avgDuration: number;
+    totalDuration: number;
+    lastSeen: number;
+    samples: PerformanceSample[];
+}
+export interface PerformanceSample {
+    timestamp: number;
+    duration: number;
+    metadata?: Record<string, any>;
+}
+export interface SystemPerformanceReport {
+    timestamp: number;
+    hotPaths: HotPath[];
+    databaseMetrics: any;
+    memoryUsage: {
+        heapUsed: number;
+        heapTotal: number;
+        external: number;
+    };
+    cacheMetrics: any;
+    recommendations: string[];
+}
+/**
+ * Performance profiler with hot path detection
+ */
+export declare class PerformanceProfiler {
+    private metrics;
+    private hotPaths;
+    private samples;
+    private isEnabled;
+    private sampleLimit;
+    private hotPathThreshold;
+    constructor(options?: {
+        enabled?: boolean;
+        sampleLimit?: number;
+        hotPathThreshold?: number;
+    });
+    /**
+     * Start timing an operation
+     */
+    startTiming(operationName: string): (metadata?: Record<string, any>) => void;
+    /**
+     * Time a function execution
+     */
+    timeFunction<T>(operationName: string, fn: () => T | Promise<T>, metadata?: Record<string, any>): Promise<T>;
+    /**
+     * Record timing manually
+     */
+    recordTiming(operationName: string, durationMs: number, metadata?: Record<string, any>): void;
+    /**
+     * Get performance metrics for an operation
+     */
+    getMetrics(operationName: string): PerformanceMetrics | undefined;
+    /**
+     * Get all performance metrics
+     */
+    getAllMetrics(): Map<string, PerformanceMetrics>;
+    /**
+     * Get hot paths sorted by impact
+     */
+    getHotPaths(limit?: number): HotPath[];
+    /**
+     * Generate comprehensive performance report
+     */
+    generateReport(db?: Database.Database): SystemPerformanceReport;
+    /**
+     * Reset all metrics
+     */
+    reset(): void;
+    /**
+     * Export metrics to JSON
+     */
+    exportMetrics(): string;
+    /**
+     * Enable/disable profiling
+     */
+    setEnabled(enabled: boolean): void;
+    /**
+     * End timing for an operation
+     */
+    private endTiming;
+    /**
+     * Update performance metrics for an operation
+     */
+    private updateMetrics;
+    /**
+     * Track hot path
+     */
+    private trackHotPath;
+    /**
+     * Store performance sample
+     */
+    private storeSample;
+    /**
+     * Calculate 95th percentile from samples
+     */
+    private calculateP95;
+    /**
+     * Generate optimization recommendations
+     */
+    private generateRecommendations;
+}
+/**
+ * Get or create global profiler
+ */
+export declare function getProfiler(): PerformanceProfiler;
+/**
+ * Convenience function to time operations
+ */
+export declare function timeOperation<T>(operationName: string, fn: () => T | Promise<T>, metadata?: Record<string, any>): Promise<T>;
+/**
+ * Create a performance monitoring decorator
+ */
+export declare function performanceMonitor(operationName?: string): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => PropertyDescriptor;
+/**
+ * Monitor specific StackMemory operations
+ */
+export declare class StackMemoryPerformanceMonitor {
+    private profiler;
+    /**
+     * Monitor frame operations
+     */
+    monitorFrameOperations(frameManager: any): void;
+    /**
+     * Monitor database operations
+     */
+    monitorDatabaseOperations(db: Database.Database): void;
+    /**
+     * Wrap a method with performance monitoring
+     */
+    private wrapMethod;
+}
+//# sourceMappingURL=performance-profiler.d.ts.map

package/dist/src/core/performance/performance-profiler.d.ts.map

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