agentic-qe 2.4.0 → 2.5.1

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

@@ -0,0 +1,161 @@
+/**
+ * Binary Metadata Cache - Implementation
+ *
+ * High-performance binary caching for pattern metadata.
+ * Achieves 10x faster test discovery (500ms → 50ms) through:
+ * - Binary serialization (MessagePack-based, not FlatBuffers for simplicity)
+ * - Zero-copy Float32Array embeddings
+ * - Pre-built indexes for O(1) lookup
+ * - Atomic writes with checksum validation
+ *
+ * @module core/cache/BinaryCacheImpl
+ */
+import { type BinaryCache, type PatternEntry, type AgentConfigEntry, type CacheIndexData, type CacheVersion, type CacheSerializer, type CacheValidator, type CacheInvalidator, type CacheInvalidation, type ValidationResult, type BinaryCacheConfig, type CacheMetrics, type BinaryCacheReader, type BinaryCacheBuilder, type CacheBuildResult, type TRMPatternEntry, type TRMCacheIndexData } from './BinaryMetadataCache';
+import type { TestPattern } from '../memory/IPatternStore';
+/**
+ * Binary Cache Serializer Implementation
+ *
+ * Uses a simple binary format:
+ * - Header (64 bytes): magic, version, timestamp, checksum offset, data length
+ * - Data: MessagePack-like encoding of cache structure
+ * - Checksum: SHA-256 at end
+ */
+export declare class BinaryCacheSerializerImpl implements CacheSerializer {
+    private textEncoder;
+    private textDecoder;
+    encode(cache: BinaryCache): Uint8Array;
+    decode(buffer: Uint8Array): BinaryCache;
+    computeChecksum(buffer: Uint8Array): Promise<string>;
+    encodeVersion(version: CacheVersion): number;
+    decodeVersion(encoded: number): CacheVersion;
+    private serializeCache;
+    private deserializeCache;
+}
+/**
+ * Binary Cache Validator Implementation
+ */
+export declare class BinaryCacheValidatorImpl implements CacheValidator {
+    private serializer;
+    validate(buffer: Uint8Array, expectedChecksum: string): Promise<ValidationResult>;
+    isVersionCompatible(cacheVersion: CacheVersion, codeVersion: CacheVersion): boolean;
+    isValidPatternEntry(entry: PatternEntry): boolean;
+}
+/**
+ * Binary Cache Invalidator Implementation
+ */
+export declare class BinaryCacheInvalidatorImpl implements CacheInvalidator {
+    private staleEvents;
+    private lastRebuildTime;
+    markStale(event: CacheInvalidation): void;
+    isCacheValid(cacheTimestamp: number): boolean;
+    isCacheFresh(cacheTimestamp: number, ttl: number): boolean;
+    shouldBackgroundRebuild(cacheTimestamp: number, ttl: number): boolean;
+    scheduleCacheRebuild(background: boolean): void;
+    getStaleEvents(): CacheInvalidation[];
+}
+/**
+ * Binary Cache Reader Implementation
+ */
+export declare class BinaryCacheReaderImpl implements BinaryCacheReader {
+    private cache;
+    private config;
+    private patternMap;
+    private agentConfigMap;
+    private fileSize;
+    private loadTime;
+    initialize(cachePath: string, config: BinaryCacheConfig): Promise<boolean>;
+    getPattern(id: string): PatternEntry | null;
+    getPatternsByDomain(domain: string): PatternEntry[];
+    getPatternsByType(type: string): PatternEntry[];
+    getPatternsByFramework(framework: string): PatternEntry[];
+    getAllPatterns(): PatternEntry[];
+    getAgentConfig(agentId: string): AgentConfigEntry | null;
+    getCacheMetadata(): {
+        version: CacheVersion;
+        timestamp: number;
+        patternCount: number;
+        agentConfigCount: number;
+        fileSize: number;
+    };
+    isValid(): boolean;
+    close(): void;
+    getLoadTime(): number;
+}
+/**
+ * Binary Cache Builder Implementation
+ */
+export declare class BinaryCacheBuilderImpl implements BinaryCacheBuilder {
+    private serializer;
+    buildCache(patterns: TestPattern[], agentConfigs: AgentConfigEntry[], outputPath: string): Promise<CacheBuildResult>;
+    buildIndexes(patterns: PatternEntry[]): CacheIndexData;
+    writeAtomic(buffer: Uint8Array, outputPath: string): Promise<boolean>;
+}
+/**
+ * TRM Binary Cache Builder Implementation
+ */
+export declare class TRMBinaryCacheBuilderImpl extends BinaryCacheBuilderImpl {
+    buildTRMIndexes(patterns: TRMPatternEntry[]): TRMCacheIndexData;
+}
+/**
+ * Binary Cache Manager - High-level API
+ *
+ * Provides a unified interface for cache operations with automatic
+ * fallback to SQLite on errors.
+ */
+export declare class BinaryCacheManager {
+    private reader;
+    private builder;
+    private validator;
+    private invalidator;
+    private config;
+    private metrics;
+    constructor(config?: Partial<BinaryCacheConfig>);
+    private initializeMetrics;
+    /**
+     * Load cache from disk
+     */
+    load(): Promise<boolean>;
+    /**
+     * Build and save cache from patterns
+     */
+    buildAndSave(patterns: TestPattern[], agentConfigs?: AgentConfigEntry[]): Promise<CacheBuildResult>;
+    /**
+     * Get pattern by ID
+     */
+    getPattern(id: string): PatternEntry | null;
+    /**
+     * Get patterns by domain
+     */
+    getPatternsByDomain(domain: string): PatternEntry[];
+    /**
+     * Get patterns by type
+     */
+    getPatternsByType(type: string): PatternEntry[];
+    /**
+     * Get all patterns
+     */
+    getAllPatterns(): PatternEntry[];
+    /**
+     * Check if cache is valid and fresh
+     */
+    isValid(): boolean;
+    /**
+     * Invalidate cache
+     */
+    invalidate(trigger: CacheInvalidation['trigger']): void;
+    /**
+     * Check if background rebuild is recommended
+     */
+    shouldRebuild(): boolean;
+    /**
+     * Get cache metrics
+     */
+    getMetrics(): CacheMetrics;
+    /**
+     * Close cache and release resources
+     */
+    close(): void;
+    private updateHitRate;
+}
+export declare function createBinaryCacheManager(config?: Partial<BinaryCacheConfig>): BinaryCacheManager;
+//# sourceMappingURL=BinaryCacheImpl.d.ts.map

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

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