agentic-qe 2.3.5 → 2.4.0

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

@@ -0,0 +1,533 @@
+/**
+ * Binary Metadata Cache - TypeScript Interface Definitions
+ *
+ * High-performance binary caching system for pattern metadata using FlatBuffers.
+ * Achieves 10x faster test discovery (500ms → 50ms) by reducing pattern load
+ * time from 32ms (SQLite baseline) to <5ms (binary cache target).
+ *
+ * Architecture:
+ * - Format: FlatBuffers (zero-copy deserialization)
+ * - Versioning: Semantic versioning (major.minor.patch)
+ * - Validation: SHA-256 checksum
+ * - Fallback: Graceful degradation to SQLite on corruption
+ * - Invalidation: Event-based + TTL-based expiration
+ *
+ * Performance Targets:
+ * - Pattern load time: <5ms (1000 patterns)
+ * - Embedding access: <0.15ms (768-dim Float32Array)
+ * - Cache hit rate: >95%
+ * - Test discovery: <50ms (end-to-end)
+ *
+ * @module core/cache/BinaryMetadataCache
+ * @version 1.0.0
+ */
+import type { TestPattern } from '../memory/IPatternStore';
+/**
+ * Binary cache format version
+ */
+export interface CacheVersion {
+    /** Major version (breaking schema changes) */
+    major: number;
+    /** Minor version (backward-compatible additions) */
+    minor: number;
+    /** Patch version (non-breaking optimizations) */
+    patch: number;
+}
+/**
+ * Root binary cache container
+ *
+ * Represents the entire cached state of pattern metadata, agent configurations,
+ * and pre-built search indexes. Serialized to disk using FlatBuffers for
+ * zero-copy access and fast deserialization.
+ */
+export interface BinaryCache {
+    /** Cache format version (encoded as uint32: major << 16 | minor << 8 | patch) */
+    version: number;
+    /** Cache generation timestamp (Unix milliseconds) */
+    timestamp: number;
+    /** SHA-256 checksum for integrity validation (hex string) */
+    checksum: string;
+    /** Pattern metadata entries */
+    patterns: PatternEntry[];
+    /** Agent configuration cache */
+    agentConfigs: AgentConfigEntry[];
+    /** Pre-built search indexes for fast lookup */
+    indexes: CacheIndexData;
+}
+/**
+ * Pattern metadata entry in binary cache
+ *
+ * Optimized layout for fast deserialization:
+ * - Embedding stored as Float32Array (zero-copy access)
+ * - Strings interned for memory efficiency
+ * - Metadata stored inline for cache locality
+ */
+export interface PatternEntry {
+    /** Pattern unique ID */
+    id: string;
+    /** Pattern type (e.g., "unit-test", "integration-test") */
+    type: string;
+    /** Domain/category (e.g., "api", "ui") */
+    domain: string;
+    /** Test framework (e.g., "jest", "vitest") */
+    framework: string;
+    /** Vector embedding (768-dim, zero-copy access) */
+    embedding: Float32Array;
+    /** Pattern content/template */
+    content: string;
+    /** Extended metadata */
+    metadata: PatternMetadata;
+}
+/**
+ * Pattern metadata (inline in PatternEntry)
+ */
+export interface PatternMetadata {
+    /** Code coverage score (0.0-1.0) */
+    coverage: number;
+    /** Flakiness probability (0.0-1.0) */
+    flakinessScore: number;
+    /** Test verdict */
+    verdict: 'success' | 'failure' | 'flaky' | 'unknown';
+    /** Creation timestamp (Unix milliseconds) */
+    createdAt: number;
+    /** Last usage timestamp (Unix milliseconds) */
+    lastUsed: number;
+    /** Usage counter */
+    usageCount: number;
+    /** Success counter */
+    successCount: number;
+}
+/**
+ * Agent configuration entry in cache
+ */
+export interface AgentConfigEntry {
+    /** Agent unique ID */
+    agentId: string;
+    /** Agent type (e.g., "test-generator", "coverage-analyzer") */
+    type: string;
+    /** JSON-serialized configuration */
+    configJson: string;
+    /** Configuration version */
+    version: string;
+    /** Last update timestamp (Unix milliseconds) */
+    updatedAt: number;
+}
+/**
+ * Pre-built search indexes for O(1) lookup
+ *
+ * Indexes are computed at cache generation time to avoid runtime overhead.
+ * Supports filtering by domain, type, and framework.
+ */
+export interface CacheIndexData {
+    /** Domain → pattern IDs mapping */
+    domainIndex: Map<string, string[]>;
+    /** Type → pattern IDs mapping */
+    typeIndex: Map<string, string[]>;
+    /** Framework → pattern IDs mapping */
+    frameworkIndex: Map<string, string[]>;
+}
+/**
+ * Cache serializer interface
+ *
+ * Handles encoding/decoding of cache data to/from binary format using FlatBuffers.
+ * Supports atomic writes and checksum computation.
+ */
+export interface CacheSerializer {
+    /**
+     * Encode cache data to binary buffer
+     *
+     * @param cache - Cache data to serialize
+     * @returns Binary buffer (Uint8Array) ready for disk write
+     * @throws {SerializationError} If encoding fails
+     */
+    encode(cache: BinaryCache): Uint8Array;
+    /**
+     * Decode binary buffer to cache data
+     *
+     * @param buffer - Binary buffer from disk read
+     * @returns Decoded cache data with zero-copy embeddings
+     * @throws {DeserializationError} If decoding fails
+     */
+    decode(buffer: Uint8Array): BinaryCache;
+    /**
+     * Compute SHA-256 checksum of cache data
+     *
+     * @param buffer - Binary buffer to checksum
+     * @returns SHA-256 hash as hex string
+     */
+    computeChecksum(buffer: Uint8Array): Promise<string>;
+    /**
+     * Encode cache version to uint32
+     *
+     * Format: (major << 16) | (minor << 8) | patch
+     * Example: v1.2.3 → 0x00010203 (66051)
+     *
+     * @param version - Semantic version
+     * @returns Encoded version as uint32
+     */
+    encodeVersion(version: CacheVersion): number;
+    /**
+     * Decode uint32 to cache version
+     *
+     * @param encoded - Encoded version uint32
+     * @returns Semantic version
+     */
+    decodeVersion(encoded: number): CacheVersion;
+}
+/**
+ * Cache validator interface
+ *
+ * Validates cache integrity and version compatibility.
+ * Ensures data consistency and prevents use of corrupted caches.
+ */
+export interface CacheValidator {
+    /**
+     * Validate cache integrity
+     *
+     * Performs checksum validation and version compatibility check.
+     *
+     * @param buffer - Binary cache buffer
+     * @param expectedChecksum - Expected SHA-256 checksum
+     * @returns Validation result with error details
+     */
+    validate(buffer: Uint8Array, expectedChecksum: string): Promise<ValidationResult>;
+    /**
+     * Check version compatibility
+     *
+     * @param cacheVersion - Version from cache header
+     * @param codeVersion - Current code version
+     * @returns Compatibility result
+     */
+    isVersionCompatible(cacheVersion: CacheVersion, codeVersion: CacheVersion): boolean;
+    /**
+     * Validate pattern entry
+     *
+     * Checks for required fields and data integrity.
+     *
+     * @param entry - Pattern entry to validate
+     * @returns True if valid, false otherwise
+     */
+    isValidPatternEntry(entry: PatternEntry): boolean;
+}
+/**
+ * Validation result
+ */
+export interface ValidationResult {
+    /** Overall validation success */
+    valid: boolean;
+    /** Checksum validation passed */
+    checksumValid: boolean;
+    /** Version compatibility check passed */
+    versionCompatible: boolean;
+    /** Error message (if validation failed) */
+    error?: string;
+    /** Computed checksum (for debugging) */
+    computedChecksum?: string;
+    /** Cache version (for debugging) */
+    cacheVersion?: CacheVersion;
+}
+/**
+ * Cache invalidation event
+ */
+export interface CacheInvalidation {
+    /** Invalidation trigger type */
+    trigger: 'pattern_stored' | 'pattern_deleted' | 'config_updated' | 'schema_migration' | 'manual' | 'ttl_expired';
+    /** Event timestamp (Unix milliseconds) */
+    timestamp: number;
+    /** Whether immediate cache rebuild is required */
+    requiresRebuild: boolean;
+    /** Additional metadata */
+    metadata?: Record<string, any>;
+}
+/**
+ * Cache invalidator interface
+ *
+ * Manages cache lifecycle and invalidation logic.
+ * Supports event-based and TTL-based invalidation.
+ */
+export interface CacheInvalidator {
+    /**
+     * Mark cache as stale
+     *
+     * @param event - Invalidation event
+     */
+    markStale(event: CacheInvalidation): void;
+    /**
+     * Check if cache is valid
+     *
+     * @param cacheTimestamp - Cache generation timestamp
+     * @returns True if cache is valid and not stale
+     */
+    isCacheValid(cacheTimestamp: number): boolean;
+    /**
+     * Check if cache is fresh (within TTL)
+     *
+     * @param cacheTimestamp - Cache generation timestamp
+     * @param ttl - Time-to-live in milliseconds
+     * @returns True if cache age < TTL
+     */
+    isCacheFresh(cacheTimestamp: number, ttl: number): boolean;
+    /**
+     * Check if background rebuild should be triggered
+     *
+     * Typically triggers when cache age exceeds 80% of TTL.
+     *
+     * @param cacheTimestamp - Cache generation timestamp
+     * @param ttl - Time-to-live in milliseconds
+     * @returns True if background rebuild recommended
+     */
+    shouldBackgroundRebuild(cacheTimestamp: number, ttl: number): boolean;
+    /**
+     * Schedule cache rebuild
+     *
+     * @param background - Whether to rebuild in background
+     */
+    scheduleCacheRebuild(background: boolean): void;
+}
+/**
+ * Cache configuration
+ */
+export interface BinaryCacheConfig {
+    /** Enable binary cache (feature flag) */
+    enabled: boolean;
+    /** Cache file path (default: .aqe/cache/patterns.bin) */
+    cachePath: string;
+    /** Maximum cache age in milliseconds (default: 3600000 = 1 hour) */
+    maxAge: number;
+    /** Cache validation check interval (default: 300000 = 5 min) */
+    checkInterval: number;
+    /** Enable background cache rebuild (default: true) */
+    backgroundRebuild: boolean;
+    /** Graceful fallback to SQLite on errors (default: true) */
+    fallbackToSQLite: boolean;
+    /** Current cache format version */
+    version: CacheVersion;
+    /** Enable performance metrics collection (default: true) */
+    enableMetrics: boolean;
+}
+/**
+ * Cache metrics for monitoring
+ */
+export interface CacheMetrics {
+    /** Total cache hits */
+    cacheHits: number;
+    /** Total cache misses */
+    cacheMisses: number;
+    /** Cache hit rate (0.0-1.0) */
+    cacheHitRate: number;
+    /** Average cache load time (milliseconds) */
+    avgCacheLoadTime: number;
+    /** Average SQLite fallback time (milliseconds) */
+    avgSQLiteFallbackTime: number;
+    /** Cache corruption count */
+    cacheCorruptionCount: number;
+    /** Cache rebuild count */
+    cacheRebuildCount: number;
+    /** Last cache generation timestamp */
+    lastCacheGenerationTime: number;
+    /** Cache file size (bytes) */
+    cacheFileSize: number;
+    /** Number of patterns in cache */
+    patternCount: number;
+}
+/**
+ * Binary cache reader interface (zero-copy access)
+ *
+ * Provides read-only access to cached pattern metadata with minimal overhead.
+ * Uses memory-mapped files and FlatBuffers for zero-copy deserialization.
+ */
+export interface BinaryCacheReader {
+    /**
+     * Initialize cache reader
+     *
+     * Loads cache file, validates checksum, and prepares for zero-copy access.
+     *
+     * @param cachePath - Path to binary cache file
+     * @param config - Cache configuration
+     * @returns Initialization success status
+     * @throws {CacheLoadError} If cache loading fails
+     */
+    initialize(cachePath: string, config: BinaryCacheConfig): Promise<boolean>;
+    /**
+     * Get pattern by ID (zero-copy)
+     *
+     * @param id - Pattern unique ID
+     * @returns Pattern entry or null if not found
+     */
+    getPattern(id: string): PatternEntry | null;
+    /**
+     * Get patterns by domain (O(1) lookup)
+     *
+     * @param domain - Domain filter
+     * @returns Array of pattern entries
+     */
+    getPatternsByDomain(domain: string): PatternEntry[];
+    /**
+     * Get patterns by type (O(1) lookup)
+     *
+     * @param type - Type filter
+     * @returns Array of pattern entries
+     */
+    getPatternsByType(type: string): PatternEntry[];
+    /**
+     * Get patterns by framework (O(1) lookup)
+     *
+     * @param framework - Framework filter
+     * @returns Array of pattern entries
+     */
+    getPatternsByFramework(framework: string): PatternEntry[];
+    /**
+     * Get all patterns (zero-copy)
+     *
+     * @returns Array of all pattern entries
+     */
+    getAllPatterns(): PatternEntry[];
+    /**
+     * Get agent configuration by ID
+     *
+     * @param agentId - Agent unique ID
+     * @returns Agent config entry or null if not found
+     */
+    getAgentConfig(agentId: string): AgentConfigEntry | null;
+    /**
+     * Get cache metadata
+     *
+     * @returns Cache version, timestamp, and statistics
+     */
+    getCacheMetadata(): {
+        version: CacheVersion;
+        timestamp: number;
+        patternCount: number;
+        agentConfigCount: number;
+        fileSize: number;
+    };
+    /**
+     * Check if cache is valid and fresh
+     *
+     * @returns True if cache is usable
+     */
+    isValid(): boolean;
+    /**
+     * Close cache reader and release resources
+     */
+    close(): void;
+}
+/**
+ * Binary cache builder interface
+ *
+ * Builds binary cache from SQLite data source.
+ * Handles serialization, index generation, and atomic writes.
+ */
+export interface BinaryCacheBuilder {
+    /**
+     * Build cache from SQLite patterns
+     *
+     * @param patterns - Array of test patterns from SQLite
+     * @param agentConfigs - Array of agent configurations
+     * @param outputPath - Cache file output path
+     * @returns Build success status and metrics
+     */
+    buildCache(patterns: TestPattern[], agentConfigs: AgentConfigEntry[], outputPath: string): Promise<CacheBuildResult>;
+    /**
+     * Build cache indexes
+     *
+     * Pre-computes domain, type, and framework indexes for O(1) lookup.
+     *
+     * @param patterns - Array of pattern entries
+     * @returns Index data structure
+     */
+    buildIndexes(patterns: PatternEntry[]): CacheIndexData;
+    /**
+     * Write cache to disk atomically
+     *
+     * Uses atomic write pattern (write to temp, validate, rename) to prevent
+     * partial writes and corruption.
+     *
+     * @param buffer - Binary cache buffer
+     * @param outputPath - Target file path
+     * @returns Write success status
+     */
+    writeAtomic(buffer: Uint8Array, outputPath: string): Promise<boolean>;
+}
+/**
+ * Cache build result
+ */
+export interface CacheBuildResult {
+    /** Build success status */
+    success: boolean;
+    /** Build duration (milliseconds) */
+    duration: number;
+    /** Number of patterns cached */
+    patternCount: number;
+    /** Number of agent configs cached */
+    agentConfigCount: number;
+    /** Cache file size (bytes) */
+    cacheFileSize: number;
+    /** Cache version */
+    version: CacheVersion;
+    /** SHA-256 checksum */
+    checksum: string;
+    /** Error message (if build failed) */
+    error?: string;
+}
+/**
+ * Cache load error types
+ */
+export type CacheLoadErrorType = 'file_not_found' | 'permission_denied' | 'checksum_mismatch' | 'version_incompatible' | 'corrupted_data' | 'io_error';
+/**
+ * Cache load error
+ */
+export declare class CacheLoadError extends Error {
+    type: CacheLoadErrorType;
+    metadata?: Record<string, any> | undefined;
+    constructor(type: CacheLoadErrorType, message: string, metadata?: Record<string, any> | undefined);
+}
+/**
+ * Serialization error
+ */
+export declare class SerializationError extends Error {
+    cause?: Error | undefined;
+    constructor(message: string, cause?: Error | undefined);
+}
+/**
+ * Deserialization error
+ */
+export declare class DeserializationError extends Error {
+    cause?: Error | undefined;
+    constructor(message: string, cause?: Error | undefined);
+}
+/**
+ * Default cache configuration
+ */
+export declare const DEFAULT_CACHE_CONFIG: BinaryCacheConfig;
+/**
+ * Cache file magic number (0x41514543 = "AQEC" = Agentic QE Cache)
+ */
+export declare const CACHE_MAGIC_NUMBER = 1095845187;
+/**
+ * Cache file header size (bytes)
+ */
+export declare const CACHE_HEADER_SIZE = 64;
+/**
+ * Current cache format version
+ */
+export declare const CACHE_VERSION: CacheVersion;
+/**
+ * Helper: Convert TestPattern to PatternEntry
+ *
+ * Maps from IPatternStore.TestPattern to cache-optimized PatternEntry format.
+ *
+ * @param pattern - Test pattern from SQLite
+ * @returns Pattern entry for cache
+ */
+export declare function testPatternToEntry(pattern: TestPattern): PatternEntry;
+/**
+ * Helper: Convert PatternEntry to TestPattern
+ *
+ * Maps from cache-optimized PatternEntry to IPatternStore.TestPattern format.
+ *
+ * @param entry - Pattern entry from cache
+ * @returns Test pattern for application use
+ */
+export declare function entryToTestPattern(entry: PatternEntry): TestPattern;
+//# sourceMappingURL=BinaryMetadataCache.d.ts.map

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

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

package/dist/core/cache/BinaryMetadataCache.js

@@ -0,0 +1,142 @@
+"use strict";
+/**
+ * Binary Metadata Cache - TypeScript Interface Definitions
+ *
+ * High-performance binary caching system for pattern metadata using FlatBuffers.
+ * Achieves 10x faster test discovery (500ms → 50ms) by reducing pattern load
+ * time from 32ms (SQLite baseline) to <5ms (binary cache target).
+ *
+ * Architecture:
+ * - Format: FlatBuffers (zero-copy deserialization)
+ * - Versioning: Semantic versioning (major.minor.patch)
+ * - Validation: SHA-256 checksum
+ * - Fallback: Graceful degradation to SQLite on corruption
+ * - Invalidation: Event-based + TTL-based expiration
+ *
+ * Performance Targets:
+ * - Pattern load time: <5ms (1000 patterns)
+ * - Embedding access: <0.15ms (768-dim Float32Array)
+ * - Cache hit rate: >95%
+ * - Test discovery: <50ms (end-to-end)
+ *
+ * @module core/cache/BinaryMetadataCache
+ * @version 1.0.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CACHE_VERSION = exports.CACHE_HEADER_SIZE = exports.CACHE_MAGIC_NUMBER = exports.DEFAULT_CACHE_CONFIG = exports.DeserializationError = exports.SerializationError = exports.CacheLoadError = void 0;
+exports.testPatternToEntry = testPatternToEntry;
+exports.entryToTestPattern = entryToTestPattern;
+/**
+ * Cache load error
+ */
+class CacheLoadError extends Error {
+    constructor(type, message, metadata) {
+        super(message);
+        this.type = type;
+        this.metadata = metadata;
+        this.name = 'CacheLoadError';
+    }
+}
+exports.CacheLoadError = CacheLoadError;
+/**
+ * Serialization error
+ */
+class SerializationError extends Error {
+    constructor(message, cause) {
+        super(message);
+        this.cause = cause;
+        this.name = 'SerializationError';
+    }
+}
+exports.SerializationError = SerializationError;
+/**
+ * Deserialization error
+ */
+class DeserializationError extends Error {
+    constructor(message, cause) {
+        super(message);
+        this.cause = cause;
+        this.name = 'DeserializationError';
+    }
+}
+exports.DeserializationError = DeserializationError;
+/**
+ * Default cache configuration
+ */
+exports.DEFAULT_CACHE_CONFIG = {
+    enabled: true,
+    cachePath: '.aqe/cache/patterns.bin',
+    maxAge: 3600000, // 1 hour
+    checkInterval: 300000, // 5 minutes
+    backgroundRebuild: true,
+    fallbackToSQLite: true,
+    version: { major: 1, minor: 0, patch: 0 },
+    enableMetrics: true,
+};
+/**
+ * Cache file magic number (0x41514543 = "AQEC" = Agentic QE Cache)
+ */
+exports.CACHE_MAGIC_NUMBER = 0x41514543;
+/**
+ * Cache file header size (bytes)
+ */
+exports.CACHE_HEADER_SIZE = 64;
+/**
+ * Current cache format version
+ */
+exports.CACHE_VERSION = { major: 1, minor: 0, patch: 0 };
+/**
+ * Helper: Convert TestPattern to PatternEntry
+ *
+ * Maps from IPatternStore.TestPattern to cache-optimized PatternEntry format.
+ *
+ * @param pattern - Test pattern from SQLite
+ * @returns Pattern entry for cache
+ */
+function testPatternToEntry(pattern) {
+    return {
+        id: pattern.id,
+        type: pattern.type,
+        domain: pattern.domain,
+        framework: pattern.framework || 'unknown',
+        embedding: new Float32Array(pattern.embedding),
+        content: pattern.content,
+        metadata: {
+            coverage: pattern.coverage || 0,
+            flakinessScore: pattern.flakinessScore || 0,
+            verdict: pattern.verdict || 'unknown',
+            createdAt: pattern.createdAt || Date.now(),
+            lastUsed: pattern.lastUsed || Date.now(),
+            usageCount: pattern.usageCount || 0,
+            successCount: pattern.metadata?.successCount || 0,
+        },
+    };
+}
+/**
+ * Helper: Convert PatternEntry to TestPattern
+ *
+ * Maps from cache-optimized PatternEntry to IPatternStore.TestPattern format.
+ *
+ * @param entry - Pattern entry from cache
+ * @returns Test pattern for application use
+ */
+function entryToTestPattern(entry) {
+    return {
+        id: entry.id,
+        type: entry.type,
+        domain: entry.domain,
+        framework: entry.framework,
+        embedding: Array.from(entry.embedding),
+        content: entry.content,
+        coverage: entry.metadata.coverage,
+        flakinessScore: entry.metadata.flakinessScore,
+        verdict: entry.metadata.verdict === 'unknown' ? undefined : entry.metadata.verdict,
+        createdAt: entry.metadata.createdAt,
+        lastUsed: entry.metadata.lastUsed,
+        usageCount: entry.metadata.usageCount,
+        metadata: {
+            successCount: entry.metadata.successCount,
+        },
+    };
+}
+//# sourceMappingURL=BinaryMetadataCache.js.map

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

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