agentic-qe 2.3.5 → 2.5.0

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,204 @@
+"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.TRM_CACHE_MAGIC_NUMBER = exports.DEFAULT_TRM_CACHE_CONFIG = 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;
+exports.getQualityBucket = getQualityBucket;
+exports.createTRMPatternEntry = createTRMPatternEntry;
+/**
+ * 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,
+        },
+    };
+}
+/**
+ * Default TRM cache configuration
+ */
+exports.DEFAULT_TRM_CACHE_CONFIG = {
+    ...exports.DEFAULT_CACHE_CONFIG,
+    cachePath: '.aqe/cache/trm-patterns.bin',
+    maxAge: 7200000, // 2 hours (TRM patterns are more valuable)
+    version: { major: 1, minor: 1, patch: 0 }, // TRM extension version
+};
+/**
+ * TRM cache file magic number (0x54524D43 = "TRMC" = TRM Cache)
+ */
+exports.TRM_CACHE_MAGIC_NUMBER = 0x54524D43;
+/**
+ * Helper: Compute quality bucket for indexing
+ *
+ * @param quality - Quality score (0.0-1.0)
+ * @returns Quality bucket string
+ */
+function getQualityBucket(quality) {
+    if (quality >= 0.75)
+        return 'high';
+    if (quality >= 0.5)
+        return 'medium';
+    if (quality >= 0.25)
+        return 'low';
+    return 'very_low';
+}
+/**
+ * Helper: Create TRM pattern entry
+ *
+ * @param input - Input text
+ * @param output - Output text
+ * @param inputEmb - Input embedding
+ * @param outputEmb - Output embedding
+ * @param metadata - TRM metadata
+ * @returns TRM pattern entry
+ */
+function createTRMPatternEntry(input, output, inputEmb, outputEmb, metadata) {
+    return {
+        id: `trm-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`,
+        type: metadata.iterations && metadata.iterations > 1 ? 'refinement' : 'reasoning',
+        inputText: input,
+        outputText: output,
+        inputEmbedding: new Float32Array(inputEmb),
+        outputEmbedding: new Float32Array(outputEmb),
+        metadata: {
+            quality: metadata.quality ?? 0.5,
+            qualityMetric: metadata.qualityMetric ?? 'coherence',
+            iterations: metadata.iterations ?? 1,
+            converged: metadata.converged ?? false,
+            confidence: metadata.confidence ?? 0.5,
+            createdAt: Date.now(),
+            lastUsed: Date.now(),
+            usageCount: 1,
+            avgIterationLatency: metadata.avgIterationLatency ?? 0,
+            loraAdapterId: metadata.loraAdapterId,
+        },
+    };
+}
+//# 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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"}

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

@@ -0,0 +1,103 @@
+/**
+ * Cache Invalidator - Lifecycle Management
+ *
+ * Manages cache lifecycle with:
+ * - Event-based invalidation
+ * - TTL-based expiration
+ * - Background rebuild scheduling
+ *
+ * @module core/cache/CacheInvalidator
+ * @version 1.0.0
+ */
+import type { CacheInvalidator, CacheInvalidation } from './BinaryMetadataCache';
+/**
+ * Implementation of CacheInvalidator interface
+ *
+ * Tracks cache staleness and schedules rebuilds based on:
+ * - Manual invalidation events
+ * - TTL expiration
+ * - Automatic rebuild triggers
+ */
+export declare class BinaryCacheInvalidator implements CacheInvalidator {
+    private staleTimestamp;
+    private rebuildCallbacks;
+    /**
+     * Mark cache as stale
+     *
+     * Records invalidation event and schedules rebuild if required.
+     *
+     * @param event - Invalidation event
+     */
+    markStale(event: CacheInvalidation): void;
+    /**
+     * Check if cache is valid
+     *
+     * Cache is valid if:
+     * - Cache timestamp > stale timestamp
+     * - No invalidation events since cache generation
+     *
+     * @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
+     *
+     * Triggers when cache age exceeds 80% of TTL to prevent
+     * cold start latency spikes.
+     *
+     * @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
+     *
+     * Invokes registered rebuild callbacks.
+     *
+     * @param background - Whether to rebuild in background
+     */
+    scheduleCacheRebuild(background: boolean): void;
+    /**
+     * Register a rebuild callback
+     *
+     * Callback is invoked when cache rebuild is scheduled.
+     *
+     * @param callback - Rebuild callback function
+     */
+    onRebuild(callback: () => void): void;
+    /**
+     * Unregister a rebuild callback
+     *
+     * @param callback - Rebuild callback function
+     */
+    offRebuild(callback: () => void): void;
+    /**
+     * Get stale timestamp
+     *
+     * @returns Timestamp when cache was marked stale
+     */
+    getStaleTimestamp(): number;
+    /**
+     * Reset invalidator state
+     *
+     * Clears stale timestamp and callbacks.
+     */
+    reset(): void;
+}
+/**
+ * Create a new BinaryCacheInvalidator instance
+ *
+ * @returns BinaryCacheInvalidator instance
+ */
+export declare function createCacheInvalidator(): BinaryCacheInvalidator;
+//# sourceMappingURL=CacheInvalidator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CacheInvalidator.d.ts","sourceRoot":"","sources":["../../../src/core/cache/CacheInvalidator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,uBAAuB,CAAC;AAE/B;;;;;;;GAOG;AACH,qBAAa,sBAAuB,YAAW,gBAAgB;IAC7D,OAAO,CAAC,cAAc,CAAa;IACnC,OAAO,CAAC,gBAAgB,CAA8B;IAEtD;;;;;;OAMG;IACH,SAAS,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI;IAgBzC;;;;;;;;;OASG;IACH,YAAY,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO;IAI7C;;;;;;OAMG;IACH,YAAY,CAAC,cAAc,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO;IAK1D;;;;;;;;;OASG;IACH,uBAAuB,CAAC,cAAc,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO;IAMrE;;;;;;OAMG;IACH,oBAAoB,CAAC,UAAU,EAAE,OAAO,GAAG,IAAI;IAa/C;;;;;;OAMG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI;IAIrC;;;;OAIG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI;IAItC;;;;OAIG;IACH,iBAAiB,IAAI,MAAM;IAI3B;;;;OAIG;IACH,KAAK,IAAI,IAAI;CAId;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,IAAI,sBAAsB,CAE/D"}

package/dist/core/cache/CacheInvalidator.js

@@ -0,0 +1,152 @@
+"use strict";
+/**
+ * Cache Invalidator - Lifecycle Management
+ *
+ * Manages cache lifecycle with:
+ * - Event-based invalidation
+ * - TTL-based expiration
+ * - Background rebuild scheduling
+ *
+ * @module core/cache/CacheInvalidator
+ * @version 1.0.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BinaryCacheInvalidator = void 0;
+exports.createCacheInvalidator = createCacheInvalidator;
+/**
+ * Implementation of CacheInvalidator interface
+ *
+ * Tracks cache staleness and schedules rebuilds based on:
+ * - Manual invalidation events
+ * - TTL expiration
+ * - Automatic rebuild triggers
+ */
+class BinaryCacheInvalidator {
+    constructor() {
+        this.staleTimestamp = 0;
+        this.rebuildCallbacks = new Set();
+    }
+    /**
+     * Mark cache as stale
+     *
+     * Records invalidation event and schedules rebuild if required.
+     *
+     * @param event - Invalidation event
+     */
+    markStale(event) {
+        this.staleTimestamp = event.timestamp;
+        if (event.requiresRebuild) {
+            this.scheduleCacheRebuild(false);
+        }
+        // Log invalidation event
+        console.log('[CacheInvalidator] Cache marked stale:', {
+            trigger: event.trigger,
+            timestamp: new Date(event.timestamp).toISOString(),
+            requiresRebuild: event.requiresRebuild,
+            metadata: event.metadata,
+        });
+    }
+    /**
+     * Check if cache is valid
+     *
+     * Cache is valid if:
+     * - Cache timestamp > stale timestamp
+     * - No invalidation events since cache generation
+     *
+     * @param cacheTimestamp - Cache generation timestamp
+     * @returns True if cache is valid and not stale
+     */
+    isCacheValid(cacheTimestamp) {
+        return cacheTimestamp > this.staleTimestamp;
+    }
+    /**
+     * 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, ttl) {
+        const age = Date.now() - cacheTimestamp;
+        return age < ttl;
+    }
+    /**
+     * Check if background rebuild should be triggered
+     *
+     * Triggers when cache age exceeds 80% of TTL to prevent
+     * cold start latency spikes.
+     *
+     * @param cacheTimestamp - Cache generation timestamp
+     * @param ttl - Time-to-live in milliseconds
+     * @returns True if background rebuild recommended
+     */
+    shouldBackgroundRebuild(cacheTimestamp, ttl) {
+        const age = Date.now() - cacheTimestamp;
+        const threshold = ttl * 0.8; // 80% of TTL
+        return age > threshold;
+    }
+    /**
+     * Schedule cache rebuild
+     *
+     * Invokes registered rebuild callbacks.
+     *
+     * @param background - Whether to rebuild in background
+     */
+    scheduleCacheRebuild(background) {
+        console.log(`[CacheInvalidator] Scheduling cache rebuild (background: ${background})`);
+        // Invoke rebuild callbacks
+        for (const callback of this.rebuildCallbacks) {
+            try {
+                callback();
+            }
+            catch (error) {
+                console.error('[CacheInvalidator] Rebuild callback failed:', error);
+            }
+        }
+    }
+    /**
+     * Register a rebuild callback
+     *
+     * Callback is invoked when cache rebuild is scheduled.
+     *
+     * @param callback - Rebuild callback function
+     */
+    onRebuild(callback) {
+        this.rebuildCallbacks.add(callback);
+    }
+    /**
+     * Unregister a rebuild callback
+     *
+     * @param callback - Rebuild callback function
+     */
+    offRebuild(callback) {
+        this.rebuildCallbacks.delete(callback);
+    }
+    /**
+     * Get stale timestamp
+     *
+     * @returns Timestamp when cache was marked stale
+     */
+    getStaleTimestamp() {
+        return this.staleTimestamp;
+    }
+    /**
+     * Reset invalidator state
+     *
+     * Clears stale timestamp and callbacks.
+     */
+    reset() {
+        this.staleTimestamp = 0;
+        this.rebuildCallbacks.clear();
+    }
+}
+exports.BinaryCacheInvalidator = BinaryCacheInvalidator;
+/**
+ * Create a new BinaryCacheInvalidator instance
+ *
+ * @returns BinaryCacheInvalidator instance
+ */
+function createCacheInvalidator() {
+    return new BinaryCacheInvalidator();
+}
+//# sourceMappingURL=CacheInvalidator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CacheInvalidator.js","sourceRoot":"","sources":["../../../src/core/cache/CacheInvalidator.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AAqJH,wDAEC;AAhJD;;;;;;;GAOG;AACH,MAAa,sBAAsB;IAAnC;QACU,mBAAc,GAAW,CAAC,CAAC;QAC3B,qBAAgB,GAAoB,IAAI,GAAG,EAAE,CAAC;IA6HxD,CAAC;IA3HC;;;;;;OAMG;IACH,SAAS,CAAC,KAAwB;QAChC,IAAI,CAAC,cAAc,GAAG,KAAK,CAAC,SAAS,CAAC;QAEtC,IAAI,KAAK,CAAC,eAAe,EAAE,CAAC;YAC1B,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC;QACnC,CAAC;QAED,yBAAyB;QACzB,OAAO,CAAC,GAAG,CAAC,wCAAwC,EAAE;YACpD,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,SAAS,EAAE,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE;YAClD,eAAe,EAAE,KAAK,CAAC,eAAe;YACtC,QAAQ,EAAE,KAAK,CAAC,QAAQ;SACzB,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;OASG;IACH,YAAY,CAAC,cAAsB;QACjC,OAAO,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC;IAC9C,CAAC;IAED;;;;;;OAMG;IACH,YAAY,CAAC,cAAsB,EAAE,GAAW;QAC9C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,cAAc,CAAC;QACxC,OAAO,GAAG,GAAG,GAAG,CAAC;IACnB,CAAC;IAED;;;;;;;;;OASG;IACH,uBAAuB,CAAC,cAAsB,EAAE,GAAW;QACzD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,cAAc,CAAC;QACxC,MAAM,SAAS,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC,aAAa;QAC1C,OAAO,GAAG,GAAG,SAAS,CAAC;IACzB,CAAC;IAED;;;;;;OAMG;IACH,oBAAoB,CAAC,UAAmB;QACtC,OAAO,CAAC,GAAG,CAAC,4DAA4D,UAAU,GAAG,CAAC,CAAC;QAEvF,2BAA2B;QAC3B,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC7C,IAAI,CAAC;gBACH,QAAQ,EAAE,CAAC;YACb,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,KAAK,CAAC,6CAA6C,EAAE,KAAK,CAAC,CAAC;YACtE,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACH,SAAS,CAAC,QAAoB;QAC5B,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACtC,CAAC;IAED;;;;OAIG;IACH,UAAU,CAAC,QAAoB;QAC7B,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACzC,CAAC;IAED;;;;OAIG;IACH,iBAAiB;QACf,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAED;;;;OAIG;IACH,KAAK;QACH,IAAI,CAAC,cAAc,GAAG,CAAC,CAAC;QACxB,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,CAAC;IAChC,CAAC;CACF;AA/HD,wDA+HC;AAED;;;;GAIG;AACH,SAAgB,sBAAsB;IACpC,OAAO,IAAI,sBAAsB,EAAE,CAAC;AACtC,CAAC"}

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

@@ -0,0 +1,69 @@
+/**
+ * Cache Validator - Integrity and Version Validation
+ *
+ * Validates binary cache integrity using:
+ * - SHA-256 checksum verification
+ * - Semantic version compatibility checks
+ * - Pattern entry validation
+ *
+ * @module core/cache/CacheValidator
+ * @version 1.0.0
+ */
+import type { CacheValidator, CacheVersion, ValidationResult, PatternEntry } from './BinaryMetadataCache';
+/**
+ * Implementation of CacheValidator interface
+ *
+ * Provides multi-level validation:
+ * 1. Checksum validation (SHA-256)
+ * 2. Version compatibility (semantic versioning)
+ * 3. Pattern entry validation (required fields)
+ */
+export declare class BinaryCacheValidator implements CacheValidator {
+    private serializer;
+    constructor();
+    /**
+     * Validate cache integrity
+     *
+     * Performs comprehensive validation:
+     * - Checksum matches expected value
+     * - Version is compatible with current code
+     * - Buffer structure is valid
+     *
+     * @param buffer - Binary cache buffer
+     * @param expectedChecksum - Expected SHA-256 checksum
+     * @returns Validation result with detailed diagnostics
+     */
+    validate(buffer: Uint8Array, expectedChecksum: string): Promise<ValidationResult>;
+    /**
+     * Check version compatibility
+     *
+     * Rules:
+     * - Major version mismatch: INCOMPATIBLE (breaking changes)
+     * - Minor version mismatch: COMPATIBLE (backward compatible)
+     * - Patch version mismatch: COMPATIBLE (bug fixes)
+     *
+     * @param cacheVersion - Version from cache header
+     * @param codeVersion - Current code version
+     * @returns True if compatible
+     */
+    isVersionCompatible(cacheVersion: CacheVersion, codeVersion: CacheVersion): boolean;
+    /**
+     * Validate pattern entry
+     *
+     * Checks for:
+     * - Required fields present
+     * - Valid embedding dimensions
+     * - Valid metadata values
+     *
+     * @param entry - Pattern entry to validate
+     * @returns True if valid
+     */
+    isValidPatternEntry(entry: PatternEntry): boolean;
+}
+/**
+ * Create a new BinaryCacheValidator instance
+ *
+ * @returns BinaryCacheValidator instance
+ */
+export declare function createCacheValidator(): BinaryCacheValidator;
+//# sourceMappingURL=CacheValidator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CacheValidator.d.ts","sourceRoot":"","sources":["../../../src/core/cache/CacheValidator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACb,MAAM,uBAAuB,CAAC;AAG/B;;;;;;;GAOG;AACH,qBAAa,oBAAqB,YAAW,cAAc;IACzD,OAAO,CAAC,UAAU,CAAwB;;IAM1C;;;;;;;;;;;OAWG;IACG,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAqEvF;;;;;;;;;;;OAWG;IACH,mBAAmB,CAAC,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,GAAG,OAAO;IAgBnF;;;;;;;;;;OAUG;IACH,mBAAmB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO;CAmDlD;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,oBAAoB,CAE3D"}