agentic-qe 1.3.3 → 1.3.5

package/dist/learning/ExperienceReplayBuffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExperienceReplayBuffer.d.ts","sourceRoot":"","sources":["../../src/learning/ExperienceReplayBuffer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAGzC;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;CACtB;AAWD;;GAEG;AACH,UAAU,qBAAqB;IAC7B,UAAU,EAAE,cAAc,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,MAAM,CAA0B;IACxC,OAAO,CAAC,gBAAgB,CAAS;gBAErB,MAAM,GAAE,OAAO,CAAC,kBAAkB,CAAM;IAOpD;;;OAGG;IACH,GAAG,CAAC,UAAU,EAAE,cAAc,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI;IAgBxD;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,cAAc,EAAE,GAAG,IAAI;IAO7C;;;OAGG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,EAAE;IAe3C;;OAEG;IACH,OAAO,CAAC,aAAa;IAgBrB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAqBzB;;;OAGG;IACH,cAAc,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO;IAalE;;;OAGG;IACH,OAAO,CAAC,wBAAwB;IAUhC;;OAEG;IACH,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAIrC;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,EAAE;IAO1C;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,EAAE;IAO1C;;OAEG;IACH,MAAM,CAAC,SAAS,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,GAAG,cAAc,EAAE;IAMrE;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,IAAI,IAAI,MAAM;IAId;;OAEG;IACH,OAAO,IAAI,OAAO;IAIlB;;OAEG;IACH,MAAM,IAAI,OAAO;IAIjB;;OAEG;IACH,mBAAmB,IAAI,MAAM;IAI7B;;OAEG;IACH,aAAa,IAAI;QACf,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;KACnB;IAmBD;;OAEG;IACH,MAAM,IAAI;QACR,MAAM,EAAE,qBAAqB,EAAE,CAAC;QAChC,MAAM,EAAE,kBAAkB,CAAC;QAC3B,gBAAgB,EAAE,MAAM,CAAC;KAC1B;IAQD;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE;QACZ,MAAM,EAAE,qBAAqB,EAAE,CAAC;QAChC,MAAM,EAAE,kBAAkB,CAAC;QAC3B,gBAAgB,EAAE,MAAM,CAAC;KAC1B,GAAG,IAAI;IAMR;;;OAGG;IACH,KAAK,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM;IAYrC;;OAEG;IACH,cAAc,IAAI,MAAM;CAGzB"}

package/dist/learning/ExperienceReplayBuffer.js

@@ -0,0 +1,255 @@
+"use strict";
+/**
+ * ExperienceReplayBuffer - Phase 2 (Milestone 2.2)
+ *
+ * Implements experience replay buffer for reinforcement learning.
+ * Stores transitions and enables batch sampling for training.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExperienceReplayBuffer = void 0;
+const Logger_1 = require("../utils/Logger");
+/**
+ * Default replay buffer configuration
+ */
+const DEFAULT_CONFIG = {
+    maxSize: 10000,
+    minSize: 100,
+    prioritized: false
+};
+/**
+ * ExperienceReplayBuffer - FIFO buffer with optional prioritization
+ *
+ * Implements experience replay for more stable and efficient learning.
+ * Supports both uniform random sampling and prioritized experience replay.
+ */
+class ExperienceReplayBuffer {
+    constructor(config = {}) {
+        this.logger = Logger_1.Logger.getInstance();
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        this.buffer = [];
+        this.totalExperiences = 0;
+    }
+    /**
+     * Add a new experience to the buffer
+     * Uses FIFO eviction when buffer is full
+     */
+    add(experience, priority) {
+        const prioritizedExp = {
+            experience,
+            priority: priority ?? this.calculateDefaultPriority(experience),
+            timestamp: Date.now()
+        };
+        // FIFO eviction: remove oldest when full
+        if (this.buffer.length >= this.config.maxSize) {
+            this.buffer.shift(); // Remove oldest (first element)
+        }
+        this.buffer.push(prioritizedExp);
+        this.totalExperiences++;
+    }
+    /**
+     * Add multiple experiences in batch
+     */
+    addBatch(experiences) {
+        for (const experience of experiences) {
+            this.add(experience);
+        }
+        this.logger.debug(`Added batch of ${experiences.length} experiences`);
+    }
+    /**
+     * Sample a random batch of experiences
+     * Uses uniform random sampling or prioritized sampling based on config
+     */
+    sample(batchSize) {
+        if (!this.canSample(batchSize)) {
+            throw new Error(`Cannot sample: buffer has ${this.buffer.length} experiences, ` +
+                `need at least ${Math.max(batchSize, this.config.minSize)}`);
+        }
+        if (this.config.prioritized) {
+            return this.prioritizedSample(batchSize);
+        }
+        else {
+            return this.uniformSample(batchSize);
+        }
+    }
+    /**
+     * Uniform random sampling (default)
+     */
+    uniformSample(batchSize) {
+        const sampled = [];
+        const indices = new Set();
+        // Sample without replacement
+        while (indices.size < batchSize) {
+            const randomIndex = Math.floor(Math.random() * this.buffer.length);
+            if (!indices.has(randomIndex)) {
+                indices.add(randomIndex);
+                sampled.push(this.buffer[randomIndex].experience);
+            }
+        }
+        return sampled;
+    }
+    /**
+     * Prioritized experience replay sampling
+     * Samples based on priority with probability proportional to priority
+     */
+    prioritizedSample(batchSize) {
+        const sampled = [];
+        const totalPriority = this.buffer.reduce((sum, exp) => sum + exp.priority, 0);
+        // Sample with replacement based on priorities
+        for (let i = 0; i < batchSize; i++) {
+            let random = Math.random() * totalPriority;
+            let cumulativePriority = 0;
+            for (const exp of this.buffer) {
+                cumulativePriority += exp.priority;
+                if (random <= cumulativePriority) {
+                    sampled.push(exp.experience);
+                    break;
+                }
+            }
+        }
+        return sampled;
+    }
+    /**
+     * Update priority for a specific experience
+     * Used in prioritized experience replay to adjust importance weights
+     */
+    updatePriority(experienceId, newPriority) {
+        const index = this.buffer.findIndex(exp => exp.experience.taskId === experienceId);
+        if (index === -1) {
+            return false;
+        }
+        this.buffer[index].priority = newPriority;
+        return true;
+    }
+    /**
+     * Calculate default priority based on TD-error magnitude
+     * Higher absolute rewards get higher priority
+     */
+    calculateDefaultPriority(experience) {
+        // Priority based on absolute reward (experiences with higher impact are prioritized)
+        const basePriority = Math.abs(experience.reward) + 0.01; // Add small constant to avoid zero priority
+        // Recent experiences get slight boost
+        const recencyBoost = 1.0;
+        return basePriority * recencyBoost;
+    }
+    /**
+     * Check if buffer has enough experiences to sample
+     */
+    canSample(batchSize) {
+        return this.buffer.length >= Math.max(batchSize, this.config.minSize);
+    }
+    /**
+     * Get recent experiences (for temporal coherence)
+     */
+    getRecent(count) {
+        const actualCount = Math.min(count, this.buffer.length);
+        return this.buffer
+            .slice(-actualCount)
+            .map(exp => exp.experience);
+    }
+    /**
+     * Get oldest experiences
+     */
+    getOldest(count) {
+        const actualCount = Math.min(count, this.buffer.length);
+        return this.buffer
+            .slice(0, actualCount)
+            .map(exp => exp.experience);
+    }
+    /**
+     * Get all experiences matching a filter
+     */
+    filter(predicate) {
+        return this.buffer
+            .filter(exp => predicate(exp.experience))
+            .map(exp => exp.experience);
+    }
+    /**
+     * Clear the buffer
+     */
+    clear() {
+        this.buffer = [];
+        this.logger.info('Experience replay buffer cleared');
+    }
+    /**
+     * Get current buffer size
+     */
+    size() {
+        return this.buffer.length;
+    }
+    /**
+     * Check if buffer is empty
+     */
+    isEmpty() {
+        return this.buffer.length === 0;
+    }
+    /**
+     * Check if buffer is full
+     */
+    isFull() {
+        return this.buffer.length >= this.config.maxSize;
+    }
+    /**
+     * Get total number of experiences ever added (including evicted)
+     */
+    getTotalExperiences() {
+        return this.totalExperiences;
+    }
+    /**
+     * Get buffer statistics
+     */
+    getStatistics() {
+        const avgPriority = this.buffer.length > 0
+            ? this.buffer.reduce((sum, exp) => sum + exp.priority, 0) / this.buffer.length
+            : 0;
+        const avgReward = this.buffer.length > 0
+            ? this.buffer.reduce((sum, exp) => sum + exp.experience.reward, 0) / this.buffer.length
+            : 0;
+        return {
+            size: this.buffer.length,
+            maxSize: this.config.maxSize,
+            utilization: this.buffer.length / this.config.maxSize,
+            totalAdded: this.totalExperiences,
+            avgPriority,
+            avgReward
+        };
+    }
+    /**
+     * Export buffer state for persistence
+     */
+    export() {
+        return {
+            buffer: [...this.buffer],
+            config: { ...this.config },
+            totalExperiences: this.totalExperiences
+        };
+    }
+    /**
+     * Import buffer state from persistence
+     */
+    import(state) {
+        this.buffer = [...state.buffer];
+        this.totalExperiences = state.totalExperiences;
+        this.logger.info(`Imported replay buffer with ${this.buffer.length} experiences`);
+    }
+    /**
+     * Prune old experiences beyond retention limit
+     * Keeps most recent experiences
+     */
+    prune(retentionCount) {
+        if (this.buffer.length <= retentionCount) {
+            return 0;
+        }
+        const removeCount = this.buffer.length - retentionCount;
+        this.buffer = this.buffer.slice(-retentionCount);
+        this.logger.info(`Pruned ${removeCount} old experiences from buffer`);
+        return removeCount;
+    }
+    /**
+     * Get memory usage estimate in bytes
+     */
+    getMemoryUsage() {
+        return JSON.stringify(this.buffer).length;
+    }
+}
+exports.ExperienceReplayBuffer = ExperienceReplayBuffer;
+//# sourceMappingURL=ExperienceReplayBuffer.js.map

package/dist/learning/ExperienceReplayBuffer.js.map

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

package/dist/learning/FixRecommendationEngine.d.ts

@@ -0,0 +1,68 @@
+/**
+ * FixRecommendationEngine - Automated fix recommendations for flaky tests
+ *
+ * Generates actionable fix recommendations with code examples based on root cause analysis
+ *
+ * @module learning/FixRecommendationEngine
+ * @version 1.0.0
+ */
+import { FlakyFixRecommendation } from './types';
+/**
+ * Root cause categories for flaky tests
+ */
+export type RootCause = 'timing' | 'race_condition' | 'dependency' | 'isolation' | 'environment';
+/**
+ * Root cause analysis result
+ */
+export interface RootCauseAnalysis {
+    cause: RootCause;
+    mlConfidence: number;
+    evidence: string[];
+    patterns: string[];
+}
+/**
+ * FixRecommendationEngine for generating automated fix recommendations
+ */
+export declare class FixRecommendationEngine {
+    /**
+     * Generate fix recommendations based on root cause
+     *
+     * @param rootCause - Root cause analysis result
+     * @returns Array of fix recommendations with code examples
+     */
+    generateRecommendations(rootCause: RootCauseAnalysis): FlakyFixRecommendation[];
+    /**
+     * Timing-related fixes
+     */
+    private timingFixes;
+    /**
+     * Race condition fixes
+     */
+    private raceFixes;
+    /**
+     * Dependency-related fixes
+     */
+    private dependencyFixes;
+    /**
+     * Isolation-related fixes
+     */
+    private isolationFixes;
+    /**
+     * Environment-related fixes
+     */
+    private environmentFixes;
+    /**
+     * Generic fixes for unknown root causes
+     */
+    private genericFixes;
+    /**
+     * Get priority order for recommendations
+     */
+    getPriorityOrder(recommendations: FlakyFixRecommendation[]): FlakyFixRecommendation[];
+    /**
+     * Filter recommendations by effort
+     */
+    filterByEffort(recommendations: FlakyFixRecommendation[], maxEffort: 'low' | 'medium' | 'high'): FlakyFixRecommendation[];
+}
+export default FixRecommendationEngine;
+//# sourceMappingURL=FixRecommendationEngine.d.ts.map

package/dist/learning/FixRecommendationEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FixRecommendationEngine.d.ts","sourceRoot":"","sources":["../../src/learning/FixRecommendationEngine.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAEjD;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,gBAAgB,GAAG,YAAY,GAAG,WAAW,GAAG,aAAa,CAAC;AAEjG;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,SAAS,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,qBAAa,uBAAuB;IAClC;;;;;OAKG;IACH,uBAAuB,CAAC,SAAS,EAAE,iBAAiB,GAAG,sBAAsB,EAAE;IAiB/E;;OAEG;IACH,OAAO,CAAC,WAAW;IAoFnB;;OAEG;IACH,OAAO,CAAC,SAAS;IAiFjB;;OAEG;IACH,OAAO,CAAC,eAAe;IA4EvB;;OAEG;IACH,OAAO,CAAC,cAAc;IAoFtB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA+ExB;;OAEG;IACH,OAAO,CAAC,YAAY;IAiCpB;;OAEG;IACH,gBAAgB,CAAC,eAAe,EAAE,sBAAsB,EAAE,GAAG,sBAAsB,EAAE;IAarF;;OAEG;IACH,cAAc,CACZ,eAAe,EAAE,sBAAsB,EAAE,EACzC,SAAS,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GACnC,sBAAsB,EAAE;CAW5B;AAED,eAAe,uBAAuB,CAAC"}