agentic-qe 2.3.5 → 2.4.0

package/dist/core/cache/BinaryCacheBuilder.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Binary Cache Builder - Cache Generation from SQLite
+ *
+ * Builds binary cache from pattern data with:
+ * - Index pre-computation
+ * - Atomic file writes
+ * - Checksum generation
+ *
+ * Performance:
+ * - Build time: ~50-100ms for 1000 patterns
+ * - Atomic writes prevent corruption
+ * - Optimized index generation
+ *
+ * @module core/cache/BinaryCacheBuilder
+ * @version 1.0.0
+ */
+import type { BinaryCacheBuilder, CacheBuildResult, CacheIndexData, PatternEntry, AgentConfigEntry } from './BinaryMetadataCache';
+import type { TestPattern } from '../memory/IPatternStore';
+/**
+ * Implementation of BinaryCacheBuilder interface
+ *
+ * Builds binary cache with:
+ * - Pattern serialization from SQLite data
+ * - Pre-computed indexes for fast lookup
+ * - Atomic file writes with temporary files
+ * - Checksum computation for validation
+ */
+export declare class BinaryMetadataCacheBuilder implements BinaryCacheBuilder {
+    private serializer;
+    private currentVersion;
+    constructor();
+    /**
+     * Build cache from SQLite patterns
+     *
+     * Process:
+     * 1. Convert TestPatterns to PatternEntries
+     * 2. Build search indexes
+     * 3. Serialize to binary format
+     * 4. Compute checksum
+     * 5. Write atomically to disk
+     *
+     * @param patterns - Array of test patterns from SQLite
+     * @param agentConfigs - Array of agent configurations
+     * @param outputPath - Cache file output path
+     * @returns Build result with metrics
+     */
+    buildCache(patterns: TestPattern[], agentConfigs: AgentConfigEntry[], outputPath: string): Promise<CacheBuildResult>;
+    /**
+     * Build cache indexes
+     *
+     * Pre-computes indexes for:
+     * - Domain → pattern IDs
+     * - Type → pattern IDs
+     * - Framework → pattern IDs
+     *
+     * Enables O(1) filtering by domain/type/framework.
+     *
+     * @param patterns - Array of pattern entries
+     * @returns Index data structure
+     */
+    buildIndexes(patterns: PatternEntry[]): CacheIndexData;
+    /**
+     * Write cache to disk atomically
+     *
+     * Atomic write pattern:
+     * 1. Write to temporary file (*.tmp)
+     * 2. Verify write success
+     * 3. Rename to final path (atomic operation)
+     *
+     * Prevents partial writes and corruption.
+     *
+     * @param buffer - Binary cache buffer
+     * @param outputPath - Target file path
+     * @returns True if write successful
+     */
+    writeAtomic(buffer: Uint8Array, outputPath: string): Promise<boolean>;
+}
+/**
+ * Create a new BinaryCacheBuilder instance
+ *
+ * @returns BinaryCacheBuilder instance
+ */
+export declare function createCacheBuilder(): BinaryMetadataCacheBuilder;
+//# sourceMappingURL=BinaryCacheBuilder.d.ts.map

package/dist/core/cache/BinaryCacheBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BinaryCacheBuilder.d.ts","sourceRoot":"","sources":["../../../src/core/cache/BinaryCacheBuilder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,OAAO,KAAK,EACV,kBAAkB,EAClB,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,gBAAgB,EAGjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAI3D;;;;;;;;GAQG;AACH,qBAAa,0BAA2B,YAAW,kBAAkB;IACnE,OAAO,CAAC,UAAU,CAAwB;IAC1C,OAAO,CAAC,cAAc,CAAkD;;IAMxE;;;;;;;;;;;;;;OAcG;IACG,UAAU,CACd,QAAQ,EAAE,WAAW,EAAE,EACvB,YAAY,EAAE,gBAAgB,EAAE,EAChC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,gBAAgB,CAAC;IAmF5B;;;;;;;;;;;;OAYG;IACH,YAAY,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,cAAc;IAgCtD;;;;;;;;;;;;;OAaG;IACG,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CA2C5E;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,0BAA0B,CAE/D"}

package/dist/core/cache/BinaryCacheBuilder.js

@@ -0,0 +1,225 @@
+"use strict";
+/**
+ * Binary Cache Builder - Cache Generation from SQLite
+ *
+ * Builds binary cache from pattern data with:
+ * - Index pre-computation
+ * - Atomic file writes
+ * - Checksum generation
+ *
+ * Performance:
+ * - Build time: ~50-100ms for 1000 patterns
+ * - Atomic writes prevent corruption
+ * - Optimized index generation
+ *
+ * @module core/cache/BinaryCacheBuilder
+ * @version 1.0.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BinaryMetadataCacheBuilder = void 0;
+exports.createCacheBuilder = createCacheBuilder;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const MessagePackSerializer_1 = require("./MessagePackSerializer");
+const BinaryMetadataCache_1 = require("./BinaryMetadataCache");
+/**
+ * Implementation of BinaryCacheBuilder interface
+ *
+ * Builds binary cache with:
+ * - Pattern serialization from SQLite data
+ * - Pre-computed indexes for fast lookup
+ * - Atomic file writes with temporary files
+ * - Checksum computation for validation
+ */
+class BinaryMetadataCacheBuilder {
+    constructor() {
+        this.currentVersion = { major: 1, minor: 0, patch: 0 };
+        this.serializer = new MessagePackSerializer_1.MessagePackSerializer();
+    }
+    /**
+     * Build cache from SQLite patterns
+     *
+     * Process:
+     * 1. Convert TestPatterns to PatternEntries
+     * 2. Build search indexes
+     * 3. Serialize to binary format
+     * 4. Compute checksum
+     * 5. Write atomically to disk
+     *
+     * @param patterns - Array of test patterns from SQLite
+     * @param agentConfigs - Array of agent configurations
+     * @param outputPath - Cache file output path
+     * @returns Build result with metrics
+     */
+    async buildCache(patterns, agentConfigs, outputPath) {
+        const startTime = Date.now();
+        try {
+            // 1. Convert patterns to cache entries
+            const patternEntries = patterns.map(BinaryMetadataCache_1.testPatternToEntry);
+            // 2. Build indexes
+            const indexes = this.buildIndexes(patternEntries);
+            // 3. Create cache structure (without checksum)
+            const cacheWithoutChecksum = {
+                version: this.serializer.encodeVersion(this.currentVersion),
+                timestamp: Date.now(),
+                checksum: '', // Placeholder, will compute after serialization
+                patterns: patternEntries,
+                agentConfigs,
+                indexes,
+            };
+            // 4. Serialize to binary
+            const buffer = this.serializer.encode(cacheWithoutChecksum);
+            // 5. Compute checksum
+            const checksum = await this.serializer.computeChecksum(buffer);
+            // 6. Update cache with actual checksum
+            const cacheWithChecksum = {
+                ...cacheWithoutChecksum,
+                checksum,
+            };
+            // 7. Serialize again with correct checksum
+            const finalBuffer = this.serializer.encode(cacheWithChecksum);
+            // 8. Write atomically
+            const writeSuccess = await this.writeAtomic(finalBuffer, outputPath);
+            if (!writeSuccess) {
+                throw new Error('Atomic write failed');
+            }
+            const duration = Date.now() - startTime;
+            console.log('[BinaryCacheBuilder] Cache built successfully:', {
+                duration: `${duration}ms`,
+                patternCount: patterns.length,
+                agentConfigCount: agentConfigs.length,
+                cacheFileSize: finalBuffer.length,
+                checksum,
+            });
+            return {
+                success: true,
+                duration,
+                patternCount: patterns.length,
+                agentConfigCount: agentConfigs.length,
+                cacheFileSize: finalBuffer.length,
+                version: this.currentVersion,
+                checksum,
+            };
+        }
+        catch (error) {
+            const duration = Date.now() - startTime;
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+            console.error('[BinaryCacheBuilder] Cache build failed:', {
+                error: errorMessage,
+                duration: `${duration}ms`,
+            });
+            return {
+                success: false,
+                duration,
+                patternCount: patterns.length,
+                agentConfigCount: agentConfigs.length,
+                cacheFileSize: 0,
+                version: this.currentVersion,
+                checksum: '',
+                error: errorMessage,
+            };
+        }
+    }
+    /**
+     * Build cache indexes
+     *
+     * Pre-computes indexes for:
+     * - Domain → pattern IDs
+     * - Type → pattern IDs
+     * - Framework → pattern IDs
+     *
+     * Enables O(1) filtering by domain/type/framework.
+     *
+     * @param patterns - Array of pattern entries
+     * @returns Index data structure
+     */
+    buildIndexes(patterns) {
+        const domainIndex = new Map();
+        const typeIndex = new Map();
+        const frameworkIndex = new Map();
+        for (const pattern of patterns) {
+            // Domain index
+            if (!domainIndex.has(pattern.domain)) {
+                domainIndex.set(pattern.domain, []);
+            }
+            domainIndex.get(pattern.domain).push(pattern.id);
+            // Type index
+            if (!typeIndex.has(pattern.type)) {
+                typeIndex.set(pattern.type, []);
+            }
+            typeIndex.get(pattern.type).push(pattern.id);
+            // Framework index
+            if (!frameworkIndex.has(pattern.framework)) {
+                frameworkIndex.set(pattern.framework, []);
+            }
+            frameworkIndex.get(pattern.framework).push(pattern.id);
+        }
+        return {
+            domainIndex,
+            typeIndex,
+            frameworkIndex,
+        };
+    }
+    /**
+     * Write cache to disk atomically
+     *
+     * Atomic write pattern:
+     * 1. Write to temporary file (*.tmp)
+     * 2. Verify write success
+     * 3. Rename to final path (atomic operation)
+     *
+     * Prevents partial writes and corruption.
+     *
+     * @param buffer - Binary cache buffer
+     * @param outputPath - Target file path
+     * @returns True if write successful
+     */
+    async writeAtomic(buffer, outputPath) {
+        const tempPath = `${outputPath}.tmp`;
+        try {
+            // 1. Ensure directory exists
+            const dir = (0, path_1.dirname)(outputPath);
+            await fs_1.promises.mkdir(dir, { recursive: true });
+            // 2. Write to temporary file
+            await fs_1.promises.writeFile(tempPath, buffer);
+            // 3. Verify write (read back and compare size)
+            const stats = await fs_1.promises.stat(tempPath);
+            if (stats.size !== buffer.length) {
+                throw new Error(`Write verification failed: expected ${buffer.length} bytes, got ${stats.size} bytes`);
+            }
+            // 4. Atomic rename
+            await fs_1.promises.rename(tempPath, outputPath);
+            // 5. Create backup of previous cache (if exists)
+            try {
+                await fs_1.promises.access(outputPath);
+                const backupPath = `${outputPath}.bak`;
+                await fs_1.promises.copyFile(outputPath, backupPath);
+            }
+            catch {
+                // No previous cache, skip backup
+            }
+            return true;
+        }
+        catch (error) {
+            console.error('[BinaryCacheBuilder] Atomic write failed:', error);
+            // Clean up temporary file
+            try {
+                await fs_1.promises.unlink(tempPath);
+            }
+            catch {
+                // Ignore cleanup errors
+            }
+            return false;
+        }
+    }
+}
+exports.BinaryMetadataCacheBuilder = BinaryMetadataCacheBuilder;
+/**
+ * Create a new BinaryCacheBuilder instance
+ *
+ * @returns BinaryCacheBuilder instance
+ */
+function createCacheBuilder() {
+    return new BinaryMetadataCacheBuilder();
+}
+//# sourceMappingURL=BinaryCacheBuilder.js.map

package/dist/core/cache/BinaryCacheBuilder.js.map

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

package/dist/core/cache/BinaryCacheManager.d.ts

@@ -0,0 +1,142 @@
+/**
+ * Binary Cache Manager - High-Level Cache Orchestration
+ *
+ * Orchestrates binary cache with graceful SQLite fallback.
+ *
+ * Features:
+ * - Automatic cache initialization
+ * - Transparent SQLite fallback on errors
+ * - TTL-based cache invalidation
+ * - Background cache rebuild
+ * - Performance metrics tracking
+ *
+ * Architecture:
+ * - Tier 1: Binary cache (target: <5ms)
+ * - Tier 2: SQLite fallback (baseline: 32ms)
+ *
+ * @module core/cache/BinaryCacheManager
+ * @version 1.0.0
+ */
+import type { BinaryCacheConfig, CacheMetrics } from './BinaryMetadataCache';
+import type { TestPattern, IPatternStore } from '../memory/IPatternStore';
+/**
+ * Binary Cache Manager
+ *
+ * Provides high-level API for cache operations with automatic
+ * fallback to SQLite on errors.
+ */
+export declare class BinaryCacheManager {
+    private reader;
+    private builder;
+    private invalidator;
+    private config;
+    private sqliteAdapter;
+    private metrics;
+    private isEnabled;
+    constructor(config: BinaryCacheConfig, sqliteAdapter: IPatternStore);
+    /**
+     * Initialize cache manager
+     *
+     * Loads binary cache or falls back to SQLite.
+     *
+     * @returns True if cache loaded successfully
+     */
+    initialize(): Promise<boolean>;
+    /**
+     * Load pattern by ID
+     *
+     * Attempts to load from cache, falls back to SQLite on error.
+     *
+     * @param id - Pattern unique ID
+     * @returns Test pattern or null
+     */
+    loadPattern(id: string): Promise<TestPattern | null>;
+    /**
+     * Load patterns by domain
+     *
+     * @param domain - Domain filter
+     * @returns Array of test patterns
+     */
+    loadPatternsByDomain(domain: string): Promise<TestPattern[]>;
+    /**
+     * Load patterns by type
+     *
+     * @param type - Type filter
+     * @returns Array of test patterns
+     */
+    loadPatternsByType(type: string): Promise<TestPattern[]>;
+    /**
+     * Load patterns by framework
+     *
+     * @param framework - Framework filter
+     * @returns Array of test patterns
+     */
+    loadPatternsByFramework(framework: string): Promise<TestPattern[]>;
+    /**
+     * Rebuild cache from SQLite
+     *
+     * Queries all patterns from SQLite and builds fresh cache.
+     */
+    rebuildCache(): Promise<void>;
+    /**
+     * Check if cache is valid
+     *
+     * @returns True if cache is valid and fresh
+     */
+    private isCacheValid;
+    /**
+     * Log cache fallback event
+     *
+     * @private
+     */
+    private logCacheFallback;
+    /**
+     * Record cache hit
+     *
+     * @private
+     */
+    private recordCacheHit;
+    /**
+     * Record cache miss
+     *
+     * @private
+     */
+    private recordCacheMiss;
+    /**
+     * Update cache hit rate
+     *
+     * @private
+     */
+    private updateCacheHitRate;
+    /**
+     * Update average cache load time
+     *
+     * @private
+     */
+    private updateAvgLoadTime;
+    /**
+     * Update average SQLite fallback time
+     *
+     * @private
+     */
+    private updateAvgFallbackTime;
+    /**
+     * Get cache metrics
+     *
+     * @returns Current cache metrics
+     */
+    getMetrics(): CacheMetrics;
+    /**
+     * Shutdown cache manager
+     */
+    shutdown(): Promise<void>;
+}
+/**
+ * Create a new BinaryCacheManager instance
+ *
+ * @param config - Cache configuration
+ * @param sqliteAdapter - SQLite pattern store adapter
+ * @returns BinaryCacheManager instance
+ */
+export declare function createCacheManager(config: BinaryCacheConfig, sqliteAdapter: IPatternStore): BinaryCacheManager;
+//# sourceMappingURL=BinaryCacheManager.d.ts.map

package/dist/core/cache/BinaryCacheManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BinaryCacheManager.d.ts","sourceRoot":"","sources":["../../../src/core/cache/BinaryCacheManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,YAAY,EAGb,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAM1E;;;;;GAKG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAA0C;IACxD,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,WAAW,CAAyB;IAC5C,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,SAAS,CAAU;gBAEf,MAAM,EAAE,iBAAiB,EAAE,aAAa,EAAE,aAAa;IAyBnE;;;;;;OAMG;IACG,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;IA6CpC;;;;;;;OAOG;IACG,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAuC1D;;;;;OAKG;IACG,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAgBlE;;;;;OAKG;IACG,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAe9D;;;;;OAKG;IACG,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAexE;;;;OAIG;IACG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAmCnC;;;;OAIG;IACH,OAAO,CAAC,YAAY;IAsBpB;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAYxB;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAKtB;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAKvB;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAK1B;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAMzB;;;;OAIG;IACH,OAAO,CAAC,qBAAqB;IAM7B;;;;OAIG;IACH,UAAU,IAAI,YAAY;IAI1B;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAQhC;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,iBAAiB,EACzB,aAAa,EAAE,aAAa,GAC3B,kBAAkB,CAEpB"}