agentic-qe 2.5.9 → 2.5.10

package/CHANGELOG.md

@@ -7,6 +7,81 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.5.10] - 2025-12-19
+
+### Added
+
+#### Phase 0.5: RuVector Self-Learning Integration
+
+Major milestone implementing PostgreSQL-based self-learning with GNN, LoRA, and EWC++ for continuous pattern improvement.
+
+**M0.5.4: RuVector PostgreSQL Adapter**
+- **RuVectorPostgresAdapter** (`src/providers/RuVectorPostgresAdapter.ts`) - PostgreSQL vector database adapter
+  - O(log n) similarity search with pgvector
+  - 768-dimension vector embeddings
+  - Query with learning (cache + LLM fallback)
+  - Force learning consolidation (GNN/LoRA/EWC++)
+  - Health check and metrics reporting
+  - `createDockerRuVectorAdapter()` factory for Docker deployments
+
+**M0.5.5: CLI Commands**
+- **RuVector CLI** (`src/cli/commands/ruvector/index.ts`) - Management commands
+  - `aqe ruvector status` - Check container and connection health
+  - `aqe ruvector metrics` - Show GOAP metrics (latency, retention, cache hits)
+  - `aqe ruvector learn` - Force GNN/LoRA/EWC++ learning consolidation
+  - `aqe ruvector migrate` - Migrate patterns from memory.db
+  - `aqe ruvector health` - Detailed diagnostics
+
+**M0.5.6: Migration Script**
+- **migrate-patterns-to-ruvector.ts** (`scripts/migrate-patterns-to-ruvector.ts`)
+  - Batch processing with configurable batch size
+  - Dry-run mode for preview
+  - Progress tracking and error handling
+  - Validates embedding dimensions (768/384)
+
+**Agent Pattern Store Integration**
+- **FlakyTestHunterAgent** - Stores flaky test patterns with stability scores
+- **SecurityScannerAgent** - Stores vulnerability patterns with severity weights
+- **BaseAgent** - PostgreSQL adapter wiring when `AQE_RUVECTOR_ENABLED=true`
+
+**Validation Tests**
+- **ruvector-self-learning.test.ts** (`tests/integration/ruvector-self-learning.test.ts`)
+  - GNN learning validation (50+ queries, pattern consolidation)
+  - EWC++ anti-forgetting (>98% retention after adding new patterns)
+  - Latency requirements (environment-adjusted thresholds)
+  - Memory constraints validation
+  - Cache integration (high-confidence hits)
+  - LLM fallback (low-confidence queries)
+
+**GOAP Targets Achieved**
+- Cache hit rate: >50%
+- Search latency: <1ms (production), <500ms (DevPod)
+- Pattern retention: >98% (EWC++ guaranteed)
+- LoRA memory: <300MB
+
+#### Documentation
+- **RuVector Self-Learning Guide** (`docs/guides/ruvector-self-learning.md`)
+  - Complete setup instructions
+  - CLI command reference
+  - Configuration options
+  - Migration guide
+  - Troubleshooting FAQ
+
+### Changed
+- **BaseAgent** - Added environment variable support for RuVector configuration
+  - `AQE_RUVECTOR_ENABLED` - Enable/disable RuVector (default: false)
+  - `AQE_RUVECTOR_URL` - Full PostgreSQL connection URL
+  - `RUVECTOR_HOST/PORT/DATABASE/USER/PASSWORD` - Individual connection settings
+- **aqe init** - Shows optional RuVector enhancement with setup instructions
+- **docker-compose.ruvector.yml** - Updated port mappings for PostgreSQL (5432)
+
+### Fixed
+- **Security** - Use `crypto.randomUUID()` instead of `Math.random()` for ID generation
+- **Docker** - Use Docker-in-Docker instead of host Docker socket for better isolation
+
+### Dependencies
+- Added `pg` (PostgreSQL client) for RuVector adapter
+
 ## [2.5.9] - 2025-12-18
 
 ### Changed

package/README.md

@@ -11,7 +11,7 @@
 [![Run in Smithery](https://smithery.ai/badge/skills/proffesor-for-testing)](https://smithery.ai/skills?ns=proffesor-for-testing&utm_source=github&utm_medium=badge)
 
 
-**Version 2.5.9** | [Changelog](CHANGELOG.md) | [Contributors](CONTRIBUTORS.md) | [Issues](https://github.com/proffesor-for-testing/agentic-qe/issues) | [Discussions](https://github.com/proffesor-for-testing/agentic-qe/discussions)
+**Version 2.5.10** | [Changelog](CHANGELOG.md) | [Contributors](CONTRIBUTORS.md) | [Issues](https://github.com/proffesor-for-testing/agentic-qe/issues) | [Discussions](https://github.com/proffesor-for-testing/agentic-qe/discussions)
 
 > AI-powered test automation that learns from every task, switches between 300+ AI models on-the-fly, scores code testability, visualizes agent activity in real-time, and improves autonomously overnight — with built-in safety guardrails and full observability.
 
@@ -393,7 +393,7 @@ mcp__agentic_qe__coverage_analyze({
 })
 ```
 
-**All 85 MCP Tools Available:**
+**All 91 MCP Tools Available:**
 - Fleet Management (9 tools): init, spawn, status, coordinate, orchestrate
 - Test Generation (2 tools): generate enhanced, execute
 - Test Execution (3 tools): execute, parallel, stream

package/dist/agents/BaseAgent.d.ts

@@ -62,6 +62,26 @@ export interface AgentLLMConfig {
 /**
  * Configuration for BaseAgent
  */
+/**
+ * QE Pattern Store Configuration
+ * Enables QE agents to store learned patterns in RuVector for 150x faster retrieval
+ */
+export interface QEPatternStoreConfig {
+    /** Enable QE pattern storage (default: true) */
+    enabled: boolean;
+    /** Use RuVector Docker when available (default: true) */
+    useRuVector: boolean;
+    /** Use local HNSW fallback (default: true) */
+    useHNSW: boolean;
+    /** Write to both RuVector and HNSW during migration (default: false) */
+    dualWrite: boolean;
+    /** RuVector Docker base URL (default: http://localhost:8080) */
+    ruvectorUrl?: string;
+    /** Pattern storage path (default: ./data/qe-patterns.ruvector) */
+    storagePath?: string;
+    /** Auto-sync patterns to RuVector (default: false) */
+    autoSync?: boolean;
+}
 export interface BaseAgentConfig {
     id?: string;
     type: AgentType;
@@ -79,6 +99,8 @@ export interface BaseAgentConfig {
     coordinationStrategy?: AgentCoordinationStrategy;
     /** LLM configuration - enables agents to make LLM calls via RuvLLM */
     llm?: AgentLLMConfig;
+    /** Pattern store configuration for QE agents */
+    patternStore?: Partial<QEPatternStoreConfig>;
 }
 export declare abstract class BaseAgent extends EventEmitter {
     protected readonly agentId: AgentId;
@@ -108,6 +130,9 @@ export declare abstract class BaseAgent extends EventEmitter {
     protected federatedManager?: FederatedManager;
     protected ephemeralAgent?: EphemeralAgent;
     private federatedInitialized;
+    protected qePatternStore?: any;
+    protected readonly qePatternConfig: Required<QEPatternStoreConfig>;
+    private patternStoreInitialized;
     protected readonly lifecycleManager: AgentLifecycleManager;
     protected readonly coordinator: AgentCoordinator;
     protected readonly memoryService: AgentMemoryService;
@@ -282,6 +307,8 @@ export declare abstract class BaseAgent extends EventEmitter {
         sessionId?: string;
         provider?: string;
         hasRuVectorCache?: boolean;
+        hasPatternStore?: boolean;
+        patternStoreType?: 'ruvector' | 'fallback';
     };
     /**
      * Check if RuVector GNN cache is available
@@ -356,6 +383,98 @@ export declare abstract class BaseAgent extends EventEmitter {
         source: 'cache' | 'local' | 'cloud';
         confidence?: number;
     }>;
+    /**
+     * Initialize QE Pattern Store for learned pattern storage
+     * Supports both RuVector Docker (150x faster) and local HNSW fallback
+     */
+    private initializePatternStore;
+    /**
+     * Check if QE pattern store is available
+     */
+    hasPatternStore(): boolean;
+    /**
+     * Store a QE learned pattern
+     * Automatically uses RuVector when available, falls back to HNSW
+     *
+     * @param pattern - The QE pattern to store
+     * @returns Success status
+     */
+    protected storeQEPattern(pattern: {
+        id: string;
+        type: string;
+        domain: string;
+        content: string;
+        embedding: number[];
+        framework?: string;
+        coverage?: number;
+        metadata?: Record<string, any>;
+    }): Promise<{
+        success: boolean;
+        synced?: boolean;
+    }>;
+    /**
+     * Search for similar QE patterns
+     * Uses RuVector's 150x faster search when available
+     *
+     * @param embedding - Query embedding vector
+     * @param k - Number of results to return (default: 10)
+     * @param options - Additional search options
+     * @returns Array of similar patterns with scores
+     */
+    protected searchQEPatterns(embedding: number[], k?: number, options?: {
+        domain?: string;
+        type?: string;
+        framework?: string;
+        threshold?: number;
+        useMMR?: boolean;
+    }): Promise<Array<{
+        pattern: any;
+        score: number;
+    }>>;
+    /**
+     * Get QE pattern store metrics
+     * Returns performance and usage statistics
+     */
+    getQEPatternMetrics(): {
+        enabled: boolean;
+        patternCount: number;
+        implementation: 'ruvector' | 'fallback';
+        performance?: {
+            avgSearchTime: number;
+            p50SearchTime: number;
+            p99SearchTime: number;
+            estimatedQPS: number;
+        };
+        gnnLearning?: {
+            enabled: boolean;
+            cacheHitRate: number;
+            patternsLearned: number;
+        };
+    } | null;
+    /**
+     * Sync local patterns to remote RuVector service
+     * Only applicable when RuVector Docker is enabled
+     */
+    protected syncPatternsToRemote(options?: {
+        force?: boolean;
+    }): Promise<{
+        synced: number;
+        failed: number;
+        duration: number;
+    }>;
+    /**
+     * Force GNN learning consolidation on remote service
+     * Triggers LoRA parameter updates with EWC protection
+     */
+    protected forcePatternLearning(): Promise<{
+        success: boolean;
+        patternsConsolidated: number;
+        duration: number;
+    }>;
+    /**
+     * Cleanup pattern store resources on agent termination
+     */
+    private cleanupPatternStore;
     /**
      * Cleanup LLM resources on agent termination
      */

package/dist/agents/BaseAgent.d.ts.map

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

package/dist/agents/BaseAgent.js

@@ -32,6 +32,7 @@ class BaseAgent extends events_1.EventEmitter {
         super();
         this.performanceMetrics = { tasksCompleted: 0, averageExecutionTime: 0, errorCount: 0, lastActivity: new Date() };
         this.federatedInitialized = false;
+        this.patternStoreInitialized = false;
         this.agentId = { id: config.id || (0, utils_1.generateAgentId)(config.type), type: config.type, created: new Date() };
         this.capabilities = new Map((config.capabilities || []).map(cap => [cap.name, cap]));
         this.context = config.context;
@@ -41,6 +42,22 @@ class BaseAgent extends events_1.EventEmitter {
         this.learningConfig = config.learningConfig;
         // LLM configuration (Phase 0 - default enabled with RuvLLM)
         this.llmConfig = config.llm ?? { enabled: true, preferredProvider: 'ruvllm' };
+        // QE Pattern Store configuration (Phase 0.5 - RuVector Integration)
+        // Environment variables take precedence, then config, then defaults
+        // RuVector is OPT-IN to maintain backward compatibility with existing users
+        const envRuVectorEnabled = process.env.AQE_RUVECTOR_ENABLED?.toLowerCase() === 'true';
+        const envRuVectorUrl = process.env.AQE_RUVECTOR_URL || process.env.RUVECTOR_URL;
+        const envPatternStoreEnabled = process.env.AQE_PATTERN_STORE_ENABLED?.toLowerCase() !== 'false';
+        this.qePatternConfig = {
+            enabled: config.patternStore?.enabled ?? envPatternStoreEnabled,
+            // RuVector defaults to FALSE - opt-in for advanced self-learning
+            useRuVector: config.patternStore?.useRuVector ?? envRuVectorEnabled,
+            useHNSW: config.patternStore?.useHNSW ?? true,
+            dualWrite: config.patternStore?.dualWrite ?? (process.env.AQE_PATTERN_DUAL_WRITE === 'true'),
+            ruvectorUrl: config.patternStore?.ruvectorUrl ?? envRuVectorUrl ?? 'postgresql://ruvector:ruvector@localhost:5432/ruvector_db',
+            storagePath: config.patternStore?.storagePath ?? process.env.AQE_PATTERN_STORE_PATH ?? './data/qe-patterns.ruvector',
+            autoSync: config.patternStore?.autoSync ?? (process.env.AQE_PATTERN_AUTO_SYNC === 'true'),
+        };
         // Early validation (Issue #137)
         const validation = (0, utils_1.validateLearningConfig)(config);
         if (!validation.valid && validation.warning) {
@@ -105,6 +122,8 @@ class BaseAgent extends events_1.EventEmitter {
                     await this.initializeLLMProvider();
                     // Initialize Federated Learning (Phase 0 M0.5)
                     await this.initializeFederatedLearning();
+                    // Initialize QE Pattern Store (Phase 0.5)
+                    await this.initializePatternStore();
                     await this.initializeComponents();
                     await this.executeHook('post-initialization');
                     this.coordinator.emitEvent('agent.initialized', { agentId: this.agentId });
@@ -160,6 +179,7 @@ class BaseAgent extends events_1.EventEmitter {
                     await this.cleanup();
                     await this.cleanupLLM(); // Phase 0: Cleanup LLM resources
                     await this.cleanupFederated(); // Phase 0 M0.5: Cleanup federated learning
+                    await this.cleanupPatternStore(); // Phase 0.5: Cleanup pattern store
                     this.coordinator.clearAllHandlers();
                 },
                 onPostTermination: async () => {
@@ -798,6 +818,10 @@ class BaseAgent extends events_1.EventEmitter {
             sessionId: this.llmSessionId,
             provider: this.hybridRouter ? 'hybrid' : (this.llmProvider ? 'ruvllm' : undefined),
             hasRuVectorCache: this.hasRuVectorCache(),
+            hasPatternStore: this.hasPatternStore(),
+            patternStoreType: this.hasPatternStore() ?
+                this.qePatternStore?.getImplementationInfo?.()?.type :
+                undefined,
         };
     }
     // ============================================
@@ -923,6 +947,270 @@ class BaseAgent extends events_1.EventEmitter {
         const text = await this.llmComplete(prompt, options);
         return { response: text, source: 'local' };
     }
+    // ============================================
+    // QE Pattern Store Methods (Phase 0.5 - RuVector Integration)
+    // ============================================
+    /**
+     * Initialize QE Pattern Store for learned pattern storage
+     * Supports both RuVector Docker (150x faster) and local HNSW fallback
+     */
+    async initializePatternStore() {
+        if (!this.qePatternConfig.enabled) {
+            console.log(`[${this.agentId.id}] QE Pattern Store disabled by configuration`);
+            return;
+        }
+        try {
+            // Phase 0.5: Use PostgreSQL adapter when RuVector is enabled
+            if (this.qePatternConfig.useRuVector) {
+                try {
+                    const { createDockerRuVectorAdapter } = require('../providers/RuVectorPostgresAdapter');
+                    // Parse PostgreSQL connection URL or use defaults
+                    const url = this.qePatternConfig.ruvectorUrl || '';
+                    const isPostgres = url.startsWith('postgresql://') || url.startsWith('postgres://');
+                    if (isPostgres) {
+                        // Parse connection URL
+                        const parsed = new URL(url);
+                        this.qePatternStore = createDockerRuVectorAdapter({
+                            host: parsed.hostname,
+                            port: parseInt(parsed.port) || 5432,
+                            database: parsed.pathname.slice(1) || 'ruvector_db',
+                            user: parsed.username || 'ruvector',
+                            password: parsed.password || 'ruvector',
+                            learningEnabled: true,
+                            cacheThreshold: 0.85,
+                        });
+                    }
+                    else {
+                        // Use default Docker configuration
+                        this.qePatternStore = createDockerRuVectorAdapter({
+                            host: process.env.RUVECTOR_HOST || 'localhost',
+                            port: parseInt(process.env.RUVECTOR_PORT || '5432'),
+                            database: process.env.RUVECTOR_DATABASE || 'ruvector_db',
+                            user: process.env.RUVECTOR_USER || 'ruvector',
+                            password: process.env.RUVECTOR_PASSWORD || 'ruvector',
+                            learningEnabled: true,
+                            cacheThreshold: 0.85,
+                        });
+                    }
+                    await this.qePatternStore.initialize();
+                    this.patternStoreInitialized = true;
+                    console.log(`[${this.agentId.id}] QE Pattern Store initialized (RuVector PostgreSQL: enabled)`);
+                    return;
+                }
+                catch (postgresError) {
+                    console.warn(`[${this.agentId.id}] RuVector PostgreSQL unavailable, falling back to HNSW:`, postgresError.message);
+                    // Fall through to HNSW fallback
+                }
+            }
+            // Fallback: Use local RuVectorPatternStore (HNSW-based)
+            const { RuVectorPatternStore } = require('../memory/RuVectorPatternStore');
+            // Configure pattern store with local HNSW
+            const storeConfig = {
+                dimension: 384,
+                metric: 'cosine',
+                storagePath: this.qePatternConfig.storagePath,
+                autoPersist: true,
+                enableMetrics: true,
+                hnsw: {
+                    m: 32,
+                    efConstruction: 200,
+                    efSearch: 100,
+                },
+            };
+            this.qePatternStore = new RuVectorPatternStore(storeConfig);
+            await this.qePatternStore.initialize();
+            this.patternStoreInitialized = true;
+            console.log(`[${this.agentId.id}] QE Pattern Store initialized (HNSW fallback)`);
+        }
+        catch (error) {
+            console.warn(`[${this.agentId.id}] Pattern Store initialization failed:`, error.message);
+            // Don't throw - agent can work without pattern store
+        }
+    }
+    /**
+     * Check if QE pattern store is available
+     */
+    hasPatternStore() {
+        return this.patternStoreInitialized && this.qePatternStore !== undefined;
+    }
+    /**
+     * Store a QE learned pattern
+     * Automatically uses RuVector when available, falls back to HNSW
+     *
+     * @param pattern - The QE pattern to store
+     * @returns Success status
+     */
+    async storeQEPattern(pattern) {
+        if (!this.hasPatternStore()) {
+            return { success: false };
+        }
+        try {
+            const testPattern = {
+                id: pattern.id,
+                type: pattern.type,
+                domain: pattern.domain,
+                content: pattern.content,
+                embedding: pattern.embedding,
+                framework: pattern.framework,
+                coverage: pattern.coverage,
+                createdAt: Date.now(),
+                lastUsed: Date.now(),
+                usageCount: 0,
+                metadata: {
+                    agentId: this.agentId.id,
+                    agentType: this.agentId.type,
+                    ...pattern.metadata,
+                },
+            };
+            // Use auto-sync variant if enabled
+            if (this.qePatternConfig.autoSync && this.qePatternStore.storeWithSync) {
+                const result = await this.qePatternStore.storeWithSync(testPattern);
+                return { success: result.stored, synced: result.synced };
+            }
+            await this.qePatternStore.storePattern(testPattern);
+            return { success: true };
+        }
+        catch (error) {
+            console.warn(`[${this.agentId.id}] Failed to store QE pattern:`, error.message);
+            return { success: false };
+        }
+    }
+    /**
+     * Search for similar QE patterns
+     * Uses RuVector's 150x faster search when available
+     *
+     * @param embedding - Query embedding vector
+     * @param k - Number of results to return (default: 10)
+     * @param options - Additional search options
+     * @returns Array of similar patterns with scores
+     */
+    async searchQEPatterns(embedding, k = 10, options) {
+        if (!this.hasPatternStore()) {
+            return [];
+        }
+        try {
+            const results = await this.qePatternStore.searchSimilar(embedding, {
+                k,
+                domain: options?.domain,
+                type: options?.type,
+                framework: options?.framework,
+                threshold: options?.threshold ?? 0.7,
+                useMMR: options?.useMMR ?? false,
+            });
+            return results;
+        }
+        catch (error) {
+            console.warn(`[${this.agentId.id}] Pattern search failed:`, error.message);
+            return [];
+        }
+    }
+    /**
+     * Get QE pattern store metrics
+     * Returns performance and usage statistics
+     */
+    getQEPatternMetrics() {
+        if (!this.hasPatternStore()) {
+            return null;
+        }
+        try {
+            const stats = this.qePatternStore.getStats?.();
+            const perfMetrics = this.qePatternStore.getPerformanceMetrics?.();
+            const metrics = {
+                enabled: true,
+                patternCount: stats?.count ?? 0,
+                implementation: stats?.implementation ?? 'fallback',
+            };
+            if (perfMetrics) {
+                metrics.performance = {
+                    avgSearchTime: perfMetrics.avgSearchTime,
+                    p50SearchTime: perfMetrics.p50SearchTime,
+                    p99SearchTime: perfMetrics.p99SearchTime,
+                    estimatedQPS: perfMetrics.estimatedQPS,
+                };
+            }
+            // GNN learning metrics if available
+            if (this.qePatternStore.isGNNEnabled?.()) {
+                const gnnMetrics = this.qePatternStore.getGNNMetrics?.();
+                if (gnnMetrics) {
+                    metrics.gnnLearning = {
+                        enabled: gnnMetrics.enabled,
+                        cacheHitRate: gnnMetrics.cacheHitRate,
+                        patternsLearned: gnnMetrics.patternsLearned,
+                    };
+                }
+            }
+            return metrics;
+        }
+        catch (error) {
+            console.warn(`[${this.agentId.id}] Failed to get pattern metrics:`, error.message);
+            return null;
+        }
+    }
+    /**
+     * Sync local patterns to remote RuVector service
+     * Only applicable when RuVector Docker is enabled
+     */
+    async syncPatternsToRemote(options) {
+        if (!this.hasPatternStore() || !this.qePatternStore.syncToRemote) {
+            return { synced: 0, failed: 0, duration: 0 };
+        }
+        try {
+            const result = await this.qePatternStore.syncToRemote(options);
+            console.log(`[${this.agentId.id}] Synced ${result.synced} patterns to remote (${result.duration}ms)`);
+            return result;
+        }
+        catch (error) {
+            console.warn(`[${this.agentId.id}] Pattern sync failed:`, error.message);
+            return { synced: 0, failed: 0, duration: 0 };
+        }
+    }
+    /**
+     * Force GNN learning consolidation on remote service
+     * Triggers LoRA parameter updates with EWC protection
+     */
+    async forcePatternLearning() {
+        if (!this.hasPatternStore() || !this.qePatternStore.forceGNNLearn) {
+            return { success: false, patternsConsolidated: 0, duration: 0 };
+        }
+        try {
+            const result = await this.qePatternStore.forceGNNLearn({
+                domain: this.agentId.type,
+            });
+            return {
+                success: result.success,
+                patternsConsolidated: result.patternsConsolidated,
+                duration: result.duration,
+            };
+        }
+        catch (error) {
+            console.warn(`[${this.agentId.id}] Force learning failed:`, error.message);
+            return { success: false, patternsConsolidated: 0, duration: 0 };
+        }
+    }
+    /**
+     * Cleanup pattern store resources on agent termination
+     */
+    async cleanupPatternStore() {
+        if (!this.patternStoreInitialized || !this.qePatternStore) {
+            return;
+        }
+        try {
+            // Sync pending patterns before shutdown
+            if (this.qePatternConfig.autoSync && this.qePatternStore.syncToRemote) {
+                await this.qePatternStore.syncToRemote({ force: true });
+            }
+            // Shutdown and release resources
+            if (this.qePatternStore.shutdown) {
+                await this.qePatternStore.shutdown();
+            }
+            console.log(`[${this.agentId.id}] Pattern Store cleanup complete`);
+        }
+        catch (error) {
+            console.warn(`[${this.agentId.id}] Pattern Store cleanup error:`, error.message);
+        }
+        this.patternStoreInitialized = false;
+        this.qePatternStore = undefined;
+    }
     /**
      * Cleanup LLM resources on agent termination
      */