agentic-qe 2.3.5 → 2.5.0

package/dist/learning/SONAFeedbackLoop.js

@@ -0,0 +1,344 @@
+"use strict";
+/**
+ * SONA Feedback Loop - Continuous Improvement System
+ *
+ * Implements the Execute → Measure → Adapt loop for QE agents:
+ * 1. Execute: Run agent tasks and capture results
+ * 2. Measure: Evaluate quality, coverage, and performance
+ * 3. Adapt: Update patterns and trigger learning
+ *
+ * Integrates with:
+ * - SONALearningStrategy for adaptive learning
+ * - QEReasoningBank for pattern storage
+ * - TRMLearningStrategy for reasoning patterns
+ *
+ * @module learning/SONAFeedbackLoop
+ * @version 1.0.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SONAFeedbackLoop = void 0;
+exports.createFeedbackLoop = createFeedbackLoop;
+exports.createConnectedFeedbackLoop = createConnectedFeedbackLoop;
+const Logger_1 = require("../utils/Logger");
+/**
+ * SONA Feedback Loop implementation
+ */
+class SONAFeedbackLoop {
+    constructor(config = {}) {
+        this.feedbackBuffer = [];
+        this.analysisHistory = [];
+        this.patternPerformance = new Map();
+        this.isProcessing = false;
+        this.config = {
+            enabled: config.enabled ?? true,
+            minExecutionsForAnalysis: config.minExecutionsForAnalysis ?? 10,
+            batchSize: config.batchSize ?? 20,
+            adaptiveLearningRate: config.adaptiveLearningRate ?? true,
+            adaptationThreshold: config.adaptationThreshold ?? 0.7,
+            enableDriftDetection: config.enableDriftDetection ?? true,
+            driftWindowSize: config.driftWindowSize ?? 50,
+        };
+        this.logger = Logger_1.Logger.getInstance();
+    }
+    /**
+     * Connect to a learning strategy
+     */
+    connect(strategy) {
+        this.learningStrategy = strategy;
+        this.logger.info('SONA Feedback Loop connected to learning strategy');
+    }
+    /**
+     * Record feedback from task execution
+     */
+    async recordFeedback(event) {
+        if (!this.config.enabled)
+            return;
+        this.feedbackBuffer.push(event);
+        // Track pattern performance
+        if (event.patternsUsed) {
+            for (const patternId of event.patternsUsed) {
+                const perf = this.patternPerformance.get(patternId) || { successes: 0, failures: 0 };
+                if (event.success) {
+                    perf.successes++;
+                }
+                else {
+                    perf.failures++;
+                }
+                this.patternPerformance.set(patternId, perf);
+            }
+        }
+        // Forward to learning strategy
+        if (this.learningStrategy) {
+            await this.learningStrategy.recordExecution({
+                task: event.task,
+                success: event.success,
+                duration: event.duration,
+                result: event.result,
+                error: event.error,
+            });
+        }
+        // Process batch if buffer is full
+        if (this.feedbackBuffer.length >= this.config.batchSize) {
+            await this.processFeedbackBatch();
+        }
+    }
+    /**
+     * Process accumulated feedback and generate adaptations
+     */
+    async processFeedbackBatch() {
+        if (this.isProcessing || this.feedbackBuffer.length < this.config.minExecutionsForAnalysis) {
+            return null;
+        }
+        this.isProcessing = true;
+        try {
+            // Analyze feedback
+            const analysis = this.analyzeFeedback(this.feedbackBuffer);
+            this.analysisHistory.push(analysis);
+            // Keep history bounded
+            if (this.analysisHistory.length > 100) {
+                this.analysisHistory.shift();
+            }
+            // Apply adaptations
+            await this.applyAdaptations(analysis);
+            // Clear processed feedback
+            this.feedbackBuffer = [];
+            this.logger.info('Feedback batch processed', {
+                successRate: analysis.successRate.toFixed(2),
+                adaptations: analysis.recommendations.length,
+                driftDetected: analysis.driftDetected,
+            });
+            return analysis;
+        }
+        finally {
+            this.isProcessing = false;
+        }
+    }
+    /**
+     * Analyze feedback batch
+     */
+    analyzeFeedback(events) {
+        const successes = events.filter(e => e.success);
+        const successRate = events.length > 0 ? successes.length / events.length : 0;
+        const qualityEvents = events.filter(e => e.quality !== undefined);
+        const avgQuality = qualityEvents.length > 0
+            ? qualityEvents.reduce((sum, e) => sum + (e.quality ?? 0), 0) / qualityEvents.length
+            : 0;
+        const avgDuration = events.length > 0
+            ? events.reduce((sum, e) => sum + e.duration, 0) / events.length
+            : 0;
+        // Calculate performance trend
+        const performanceTrend = this.calculatePerformanceTrend(events);
+        // Detect drift
+        const driftDetected = this.detectDrift();
+        // Identify patterns to reinforce or review
+        const { patternsToReinforce, patternsToReview } = this.analyzePatternPerformance();
+        // Generate recommendations
+        const recommendations = this.generateRecommendations({
+            successRate,
+            avgQuality,
+            performanceTrend,
+            driftDetected,
+            patternsToReinforce,
+            patternsToReview,
+        });
+        return {
+            successRate,
+            avgQuality,
+            avgDuration,
+            performanceTrend,
+            patternsToReinforce,
+            patternsToReview,
+            recommendations,
+            driftDetected,
+        };
+    }
+    /**
+     * Calculate performance trend
+     */
+    calculatePerformanceTrend(events) {
+        if (events.length < 10)
+            return 0;
+        const halfPoint = Math.floor(events.length / 2);
+        const firstHalf = events.slice(0, halfPoint);
+        const secondHalf = events.slice(halfPoint);
+        const firstRate = firstHalf.filter(e => e.success).length / firstHalf.length;
+        const secondRate = secondHalf.filter(e => e.success).length / secondHalf.length;
+        return secondRate - firstRate; // Positive = improving, negative = declining
+    }
+    /**
+     * Detect performance drift
+     */
+    detectDrift() {
+        if (!this.config.enableDriftDetection)
+            return false;
+        if (this.analysisHistory.length < 3)
+            return false;
+        const recentAnalyses = this.analysisHistory.slice(-3);
+        const avgRecentSuccessRate = recentAnalyses.reduce((sum, a) => sum + a.successRate, 0) / recentAnalyses.length;
+        // Check for significant decline
+        const olderAnalyses = this.analysisHistory.slice(-6, -3);
+        if (olderAnalyses.length === 0)
+            return false;
+        const avgOlderSuccessRate = olderAnalyses.reduce((sum, a) => sum + a.successRate, 0) / olderAnalyses.length;
+        // Drift if success rate dropped by more than 15%
+        return (avgOlderSuccessRate - avgRecentSuccessRate) > 0.15;
+    }
+    /**
+     * Analyze pattern performance
+     */
+    analyzePatternPerformance() {
+        const patternsToReinforce = [];
+        const patternsToReview = [];
+        for (const [patternId, perf] of this.patternPerformance.entries()) {
+            const total = perf.successes + perf.failures;
+            if (total < 5)
+                continue; // Need sufficient data
+            const successRate = perf.successes / total;
+            if (successRate >= 0.8) {
+                patternsToReinforce.push(patternId);
+            }
+            else if (successRate < 0.5) {
+                patternsToReview.push(patternId);
+            }
+        }
+        return { patternsToReinforce, patternsToReview };
+    }
+    /**
+     * Generate adaptation recommendations
+     */
+    generateRecommendations(data) {
+        const recommendations = [];
+        // Drift detected - trigger retraining
+        if (data.driftDetected) {
+            recommendations.push({
+                type: 'retrain',
+                target: 'base-model',
+                reason: 'Performance drift detected, model may need retraining',
+                priority: 5,
+            });
+        }
+        // Low success rate - consolidate learning
+        if (data.successRate < this.config.adaptationThreshold) {
+            recommendations.push({
+                type: 'consolidate',
+                target: 'patterns',
+                reason: `Success rate (${(data.successRate * 100).toFixed(1)}%) below threshold`,
+                priority: 4,
+            });
+        }
+        // Reinforce high-performing patterns
+        for (const patternId of data.patternsToReinforce.slice(0, 5)) {
+            recommendations.push({
+                type: 'reinforce',
+                target: patternId,
+                reason: 'High-performing pattern should be reinforced',
+                priority: 3,
+            });
+        }
+        // Review underperforming patterns
+        for (const patternId of data.patternsToReview.slice(0, 5)) {
+            recommendations.push({
+                type: 'prune',
+                target: patternId,
+                reason: 'Underperforming pattern should be reviewed or pruned',
+                priority: 2,
+            });
+        }
+        // Declining performance trend
+        if (data.performanceTrend < -0.1) {
+            recommendations.push({
+                type: 'retrain',
+                target: 'micro-lora',
+                reason: 'Declining performance trend detected',
+                priority: 3,
+            });
+        }
+        return recommendations.sort((a, b) => b.priority - a.priority);
+    }
+    /**
+     * Apply adaptations based on analysis
+     */
+    async applyAdaptations(analysis) {
+        if (!this.learningStrategy)
+            return;
+        for (const adaptation of analysis.recommendations) {
+            try {
+                switch (adaptation.type) {
+                    case 'reinforce':
+                        await this.learningStrategy.updatePatternConfidence(adaptation.target, true);
+                        break;
+                    case 'prune':
+                        await this.learningStrategy.updatePatternConfidence(adaptation.target, false);
+                        break;
+                    case 'consolidate':
+                        await this.learningStrategy.train(5);
+                        break;
+                    case 'retrain':
+                        await this.learningStrategy.train(10);
+                        break;
+                }
+                this.logger.debug('Applied adaptation', {
+                    type: adaptation.type,
+                    target: adaptation.target,
+                });
+            }
+            catch (error) {
+                this.logger.warn('Failed to apply adaptation', {
+                    type: adaptation.type,
+                    target: adaptation.target,
+                    error: error.message,
+                });
+            }
+        }
+    }
+    /**
+     * Get current metrics
+     */
+    async getMetrics() {
+        const recentAnalysis = this.analysisHistory.slice(-1)[0];
+        return {
+            feedbackPending: this.feedbackBuffer.length,
+            analysisCount: this.analysisHistory.length,
+            currentSuccessRate: recentAnalysis?.successRate ?? 0,
+            performanceTrend: recentAnalysis?.performanceTrend ?? 0,
+            patternsTracked: this.patternPerformance.size,
+        };
+    }
+    /**
+     * Force immediate analysis (for testing or manual triggers)
+     */
+    async forceAnalysis() {
+        if (this.feedbackBuffer.length === 0)
+            return null;
+        const previousMin = this.config.minExecutionsForAnalysis;
+        this.config.minExecutionsForAnalysis = 1;
+        const result = await this.processFeedbackBatch();
+        this.config.minExecutionsForAnalysis = previousMin;
+        return result;
+    }
+    /**
+     * Reset feedback loop state
+     */
+    reset() {
+        this.feedbackBuffer = [];
+        this.analysisHistory = [];
+        this.patternPerformance.clear();
+        this.isProcessing = false;
+    }
+}
+exports.SONAFeedbackLoop = SONAFeedbackLoop;
+/**
+ * Create a feedback loop instance
+ */
+function createFeedbackLoop(config) {
+    return new SONAFeedbackLoop(config);
+}
+/**
+ * Integration helper - create and connect feedback loop to strategy
+ */
+function createConnectedFeedbackLoop(strategy, config) {
+    const loop = new SONAFeedbackLoop(config);
+    loop.connect(strategy);
+    return loop;
+}
+//# sourceMappingURL=SONAFeedbackLoop.js.map

package/dist/learning/SONAFeedbackLoop.js.map

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

package/dist/learning/baselines/BaselineCollector.d.ts

@@ -1,7 +1,7 @@
 /**
  * BaselineCollector - Phase 0 of Nightly-Learner System
  *
- * Collects performance baselines for all 19 QE agents to establish
+ * Collects performance baselines for all 20 QE agents to establish
  * quantitative improvement targets (10-20% above baseline).
  *
  * Architecture:

package/dist/learning/baselines/BaselineCollector.js

@@ -2,7 +2,7 @@
 /**
  * BaselineCollector - Phase 0 of Nightly-Learner System
  *
- * Collects performance baselines for all 19 QE agents to establish
+ * Collects performance baselines for all 20 QE agents to establish
  * quantitative improvement targets (10-20% above baseline).
  *
  * Architecture:

package/dist/learning/baselines/StandardTaskSuite.d.ts

@@ -1,7 +1,7 @@
 /**
  * StandardTaskSuite - Standard tasks for baseline measurement
  *
- * Defines representative tasks for each of the 19 QE agents to ensure
+ * Defines representative tasks for each of the 20 QE agents to ensure
  * consistent and reproducible baseline measurements.
  *
  * Each agent type has 10 standard tasks covering typical workloads.

package/dist/learning/baselines/StandardTaskSuite.js

@@ -2,7 +2,7 @@
 /**
  * StandardTaskSuite - Standard tasks for baseline measurement
  *
- * Defines representative tasks for each of the 19 QE agents to ensure
+ * Defines representative tasks for each of the 20 QE agents to ensure
  * consistent and reproducible baseline measurements.
  *
  * Each agent type has 10 standard tasks covering typical workloads.

package/dist/learning/index.d.ts

@@ -28,4 +28,6 @@ export { PerformanceOptimizer } from './PerformanceOptimizer';
 export type { PerformanceOptimizerConfig } from './PerformanceOptimizer';
 export { PrivacyManager, PrivacyLevel } from './PrivacyManager';
 export type { PrivacyConfig, SanitizedExperience, RetentionPolicyResult } from './PrivacyManager';
+export { SONAFeedbackLoop, createFeedbackLoop, createConnectedFeedbackLoop, } from './SONAFeedbackLoop';
+export type { FeedbackLoopConfig, FeedbackEvent, FeedbackAnalysis, Adaptation, } from './SONAFeedbackLoop';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/learning/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AAGnC,OAAO,EACL,uBAAuB,EACxB,MAAM,2BAA2B,CAAC;AAInC,OAAO,EACL,iBAAiB,EACjB,QAAQ,EACR,MAAM,EACN,YAAY,EACZ,WAAW,EACX,kBAAkB,EAClB,iBAAiB,EACjB,8BAA8B,EAC9B,UAAU,EACV,SAAS,EACT,sBAAsB,EACtB,iBAAiB,EAClB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,yBAAyB,EACzB,uBAAuB,EACvB,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,YAAY,EACb,MAAM,6BAA6B,CAAC;AAGrC,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,cAAc,EACd,qBAAqB,EACrB,0BAA0B,EAC1B,YAAY,EACb,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,4BAA4B,EAC5B,aAAa,EACb,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACpB,MAAM,gCAAgC,CAAC;AAGxC,OAAO,EACL,uBAAuB,EACvB,cAAc,EACd,eAAe,EACf,eAAe,EACf,gBAAgB,EACjB,MAAM,2BAA2B,CAAC;AACnC,YAAY,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAG1E,OAAO,EACL,oBAAoB,EACrB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAGzE,OAAO,EACL,cAAc,EACd,YAAY,EACb,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,aAAa,EACb,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/learning/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AAGnC,OAAO,EACL,uBAAuB,EACxB,MAAM,2BAA2B,CAAC;AAInC,OAAO,EACL,iBAAiB,EACjB,QAAQ,EACR,MAAM,EACN,YAAY,EACZ,WAAW,EACX,kBAAkB,EAClB,iBAAiB,EACjB,8BAA8B,EAC9B,UAAU,EACV,SAAS,EACT,sBAAsB,EACtB,iBAAiB,EAClB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,yBAAyB,EACzB,uBAAuB,EACvB,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,YAAY,EACb,MAAM,6BAA6B,CAAC;AAGrC,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,sBAAsB,EACtB,cAAc,EACd,qBAAqB,EACrB,0BAA0B,EAC1B,YAAY,EACb,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,4BAA4B,EAC5B,aAAa,EACb,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,mBAAmB,EACpB,MAAM,gCAAgC,CAAC;AAGxC,OAAO,EACL,uBAAuB,EACvB,cAAc,EACd,eAAe,EACf,eAAe,EACf,gBAAgB,EACjB,MAAM,2BAA2B,CAAC;AACnC,YAAY,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAG1E,OAAO,EACL,oBAAoB,EACrB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAGzE,OAAO,EACL,cAAc,EACd,YAAY,EACb,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,aAAa,EACb,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,2BAA2B,GAC5B,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,kBAAkB,EAClB,aAAa,EACb,gBAAgB,EAChB,UAAU,GACX,MAAM,oBAAoB,CAAC"}

package/dist/learning/index.js

@@ -21,7 +21,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PrivacyLevel = exports.PrivacyManager = exports.PerformanceOptimizer = exports.TransferLearningManager = exports.GossipPatternSharingProtocol = exports.ExplainableLearning = exports.ExperienceSharingProtocol = exports.createRLAlgorithm = exports.createDefaultPPOConfig = exports.PPOLearner = exports.createDefaultActorCriticConfig = exports.ActorCriticLearner = exports.SARSALearner = exports.AbstractRLLearner = exports.FixRecommendationEngine = void 0;
+exports.createConnectedFeedbackLoop = exports.createFeedbackLoop = exports.SONAFeedbackLoop = exports.PrivacyLevel = exports.PrivacyManager = exports.PerformanceOptimizer = exports.TransferLearningManager = exports.GossipPatternSharingProtocol = exports.ExplainableLearning = exports.ExperienceSharingProtocol = exports.createRLAlgorithm = exports.createDefaultPPOConfig = exports.PPOLearner = exports.createDefaultActorCriticConfig = exports.ActorCriticLearner = exports.SARSALearner = exports.AbstractRLLearner = exports.FixRecommendationEngine = void 0;
 __exportStar(require("./types"), exports);
 __exportStar(require("./LearningEngine"), exports);
 __exportStar(require("./QLearning"), exports);
@@ -66,4 +66,9 @@ Object.defineProperty(exports, "PerformanceOptimizer", { enumerable: true, get:
 var PrivacyManager_1 = require("./PrivacyManager");
 Object.defineProperty(exports, "PrivacyManager", { enumerable: true, get: function () { return PrivacyManager_1.PrivacyManager; } });
 Object.defineProperty(exports, "PrivacyLevel", { enumerable: true, get: function () { return PrivacyManager_1.PrivacyLevel; } });
+// SONA Feedback Loop (NEW in v2.4.0+ - ruvLLM Integration)
+var SONAFeedbackLoop_1 = require("./SONAFeedbackLoop");
+Object.defineProperty(exports, "SONAFeedbackLoop", { enumerable: true, get: function () { return SONAFeedbackLoop_1.SONAFeedbackLoop; } });
+Object.defineProperty(exports, "createFeedbackLoop", { enumerable: true, get: function () { return SONAFeedbackLoop_1.createFeedbackLoop; } });
+Object.defineProperty(exports, "createConnectedFeedbackLoop", { enumerable: true, get: function () { return SONAFeedbackLoop_1.createConnectedFeedbackLoop; } });
 //# sourceMappingURL=index.js.map

package/dist/learning/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/learning/index.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;;;;;;;;;;;;;;;AAEH,0CAAwB;AACxB,mDAAiC;AACjC,8CAA4B;AAC5B,2DAAyC;AACzC,uDAAqC;AACrC,oDAAkC;AAClC,sDAAoC;AACpC,sDAAoC;AACpC,yDAAuC;AACvC,4DAA0C;AAC1C,wDAAsC;AACtC,qDAAmC;AAEnC,gDAAgD;AAChD,qEAEmC;AADjC,kIAAA,uBAAuB,OAAA;AAGzB,iCAAiC;AACjC,4FAA4F;AAC5F,2CAasB;AAZpB,+GAAA,iBAAiB,OAAA;AAGjB,0GAAA,YAAY,OAAA;AAEZ,gHAAA,kBAAkB,OAAA;AAElB,4HAAA,8BAA8B,OAAA;AAC9B,wGAAA,UAAU,OAAA;AAEV,oHAAA,sBAAsB,OAAA;AACtB,+GAAA,iBAAiB,OAAA;AAGnB,sCAAsC;AACtC,yEAOqC;AANnC,sIAAA,yBAAyB,OAAA;AAQ3B,qDAAqD;AACrD,6DAS+B;AAR7B,0HAAA,mBAAmB,OAAA;AAUrB,uDAAuD;AACvD,+EAOwC;AANtC,4IAAA,4BAA4B,OAAA;AAQ9B,kDAAkD;AAClD,qEAMmC;AALjC,kIAAA,uBAAuB,OAAA;AAQzB,sDAAsD;AACtD,+DAEgC;AAD9B,4HAAA,oBAAoB,OAAA;AAItB,gDAAgD;AAChD,mDAG0B;AAFxB,gHAAA,cAAc,OAAA;AACd,8GAAA,YAAY,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/learning/index.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;;;;;;;;;;;;;;;AAEH,0CAAwB;AACxB,mDAAiC;AACjC,8CAA4B;AAC5B,2DAAyC;AACzC,uDAAqC;AACrC,oDAAkC;AAClC,sDAAoC;AACpC,sDAAoC;AACpC,yDAAuC;AACvC,4DAA0C;AAC1C,wDAAsC;AACtC,qDAAmC;AAEnC,gDAAgD;AAChD,qEAEmC;AADjC,kIAAA,uBAAuB,OAAA;AAGzB,iCAAiC;AACjC,4FAA4F;AAC5F,2CAasB;AAZpB,+GAAA,iBAAiB,OAAA;AAGjB,0GAAA,YAAY,OAAA;AAEZ,gHAAA,kBAAkB,OAAA;AAElB,4HAAA,8BAA8B,OAAA;AAC9B,wGAAA,UAAU,OAAA;AAEV,oHAAA,sBAAsB,OAAA;AACtB,+GAAA,iBAAiB,OAAA;AAGnB,sCAAsC;AACtC,yEAOqC;AANnC,sIAAA,yBAAyB,OAAA;AAQ3B,qDAAqD;AACrD,6DAS+B;AAR7B,0HAAA,mBAAmB,OAAA;AAUrB,uDAAuD;AACvD,+EAOwC;AANtC,4IAAA,4BAA4B,OAAA;AAQ9B,kDAAkD;AAClD,qEAMmC;AALjC,kIAAA,uBAAuB,OAAA;AAQzB,sDAAsD;AACtD,+DAEgC;AAD9B,4HAAA,oBAAoB,OAAA;AAItB,gDAAgD;AAChD,mDAG0B;AAFxB,gHAAA,cAAc,OAAA;AACd,8GAAA,YAAY,OAAA;AAQd,2DAA2D;AAC3D,uDAI4B;AAH1B,oHAAA,gBAAgB,OAAA;AAChB,sHAAA,kBAAkB,OAAA;AAClB,+HAAA,2BAA2B,OAAA"}

package/dist/mcp/handlers/base-handler.d.ts

@@ -1,9 +1,11 @@
+import { OutputFormatterImpl, OutputMode, OutputType } from '../../output';
 /**
  * Base Handler for Agentic QE MCP Tools
  *
  * Provides common functionality and interface for all MCP tool handlers.
+ * Includes AI-friendly output formatting for Claude Code integration.
  *
- * @version 1.0.0
+ * @version 1.1.0
  * @author Agentic QE Team
  */
 export interface HandlerResponse {
@@ -18,6 +20,8 @@ export interface HandlerResponse {
 }
 export declare abstract class BaseHandler {
     protected requestCounter: number;
+    protected outputFormatter: OutputFormatterImpl;
+    constructor();
     /**
      * Abstract method that must be implemented by all handlers
      */
@@ -79,5 +83,28 @@ export declare abstract class BaseHandler {
         result: T;
         executionTime: number;
     }>;
+    /**
+     * Detect current output mode (AI vs Human)
+     * Returns 'ai' when running in Claude Code context
+     */
+    protected detectOutputMode(): OutputMode;
+    /**
+     * Check if running in AI/Claude context
+     */
+    protected isAIMode(): boolean;
+    /**
+     * Format response for AI consumption with structured JSON and action suggestions
+     * Use this when returning results that Claude will process
+     *
+     * @param data - The response data
+     * @param outputType - Type of output (test_results, coverage, agent_status, etc.)
+     * @returns Formatted string (JSON in AI mode, human-readable otherwise)
+     */
+    protected formatForAI(data: any, outputType?: OutputType): string;
+    /**
+     * Create a success response with AI-friendly formatting
+     * Automatically includes action suggestions when in AI mode
+     */
+    protected createAIFormattedResponse(data: any, requestId?: string): HandlerResponse;
 }
 //# sourceMappingURL=base-handler.d.ts.map

package/dist/mcp/handlers/base-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base-handler.d.ts","sourceRoot":"","sources":["../../../src/mcp/handlers/base-handler.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE;QACT,aAAa,EAAE,MAAM,CAAC;QACtB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,8BAAsB,WAAW;IAC/B,SAAS,CAAC,cAAc,SAAK;IAE7B;;OAEG;IACH,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,eAAe,CAAC;IAEpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;cACa,UAAU,CACxB,OAAO,EAAE,MAAM,OAAO,CAAC,eAAe,CAAC,GACtC,OAAO,CAAC,eAAe,CAAC;IAgB3B;;OAEG;IACH,SAAS,CAAC,iBAAiB,IAAI,MAAM;IAIrC;;OAEG;IACH,SAAS,CAAC,qBAAqB,CAAC,IAAI,EAAE,GAAG,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,eAAe;IAY/E;;OAEG;IACH,SAAS,CAAC,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,eAAe;IAYjF;;OAEG;IACH,SAAS,CAAC,gBAAgB,CAAC,IAAI,EAAE,GAAG,EAAE,cAAc,EAAE,MAAM,EAAE,GAAG,IAAI;IAUrE;;OAEG;IACH,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAKlF;;OAEG;cACa,oBAAoB,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,CAAC,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;CAMpH"}
+{"version":3,"file":"base-handler.d.ts","sourceRoot":"","sources":["../../../src/mcp/handlers/base-handler.ts"],"names":[],"mappings":"AACA,OAAO,EACL,mBAAmB,EAEnB,UAAU,EACV,UAAU,EACX,MAAM,cAAc,CAAC;AAEtB;;;;;;;;GAQG;AAEH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE;QACT,aAAa,EAAE,MAAM,CAAC;QACtB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,8BAAsB,WAAW;IAC/B,SAAS,CAAC,cAAc,SAAK;IAC7B,SAAS,CAAC,eAAe,EAAE,mBAAmB,CAAC;;IAM/C;;OAEG;IACH,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,eAAe,CAAC;IAEpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;cACa,UAAU,CACxB,OAAO,EAAE,MAAM,OAAO,CAAC,eAAe,CAAC,GACtC,OAAO,CAAC,eAAe,CAAC;IAgB3B;;OAEG;IACH,SAAS,CAAC,iBAAiB,IAAI,MAAM;IAIrC;;OAEG;IACH,SAAS,CAAC,qBAAqB,CAAC,IAAI,EAAE,GAAG,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,eAAe;IAY/E;;OAEG;IACH,SAAS,CAAC,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,eAAe;IAYjF;;OAEG;IACH,SAAS,CAAC,gBAAgB,CAAC,IAAI,EAAE,GAAG,EAAE,cAAc,EAAE,MAAM,EAAE,GAAG,IAAI;IAUrE;;OAEG;IACH,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,IAAI;IAKlF;;OAEG;cACa,oBAAoB,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,CAAC,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;IAOnH;;;OAGG;IACH,SAAS,CAAC,gBAAgB,IAAI,UAAU;IAIxC;;OAEG;IACH,SAAS,CAAC,QAAQ,IAAI,OAAO;IAI7B;;;;;;;OAOG;IACH,SAAS,CAAC,WAAW,CAAC,IAAI,EAAE,GAAG,EAAE,UAAU,GAAE,UAA2B,GAAG,MAAM;IAIjF;;;OAGG;IACH,SAAS,CAAC,yBAAyB,CAAC,IAAI,EAAE,GAAG,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,eAAe;CAYpF"}

package/dist/mcp/handlers/base-handler.js

@@ -2,9 +2,11 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BaseHandler = void 0;
 const SecureRandom_js_1 = require("../../utils/SecureRandom.js");
+const output_1 = require("../../output");
 class BaseHandler {
     constructor() {
         this.requestCounter = 0;
+        this.outputFormatter = new output_1.OutputFormatterImpl();
     }
     /**
      * Wrapper that ensures all errors are caught and converted to HandlerResponse.
@@ -110,6 +112,45 @@ class BaseHandler {
         const executionTime = performance.now() - startTime;
         return { result, executionTime };
     }
+    /**
+     * Detect current output mode (AI vs Human)
+     * Returns 'ai' when running in Claude Code context
+     */
+    detectOutputMode() {
+        return output_1.OutputModeDetector.detectMode();
+    }
+    /**
+     * Check if running in AI/Claude context
+     */
+    isAIMode() {
+        return this.detectOutputMode() === output_1.OutputMode.AI;
+    }
+    /**
+     * Format response for AI consumption with structured JSON and action suggestions
+     * Use this when returning results that Claude will process
+     *
+     * @param data - The response data
+     * @param outputType - Type of output (test_results, coverage, agent_status, etc.)
+     * @returns Formatted string (JSON in AI mode, human-readable otherwise)
+     */
+    formatForAI(data, outputType = 'agent_status') {
+        return this.outputFormatter.format(data, outputType, output_1.OutputMode.AUTO);
+    }
+    /**
+     * Create a success response with AI-friendly formatting
+     * Automatically includes action suggestions when in AI mode
+     */
+    createAIFormattedResponse(data, requestId) {
+        const formattedData = this.isAIMode()
+            ? {
+                ...data,
+                _aiFormatted: true,
+                _outputMode: 'ai',
+                _schemaVersion: '1.0.0',
+            }
+            : data;
+        return this.createSuccessResponse(formattedData, requestId);
+    }
 }
 exports.BaseHandler = BaseHandler;
 //# sourceMappingURL=base-handler.js.map

package/dist/mcp/handlers/base-handler.js.map

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

package/dist/mcp/server-instructions.d.ts

@@ -6,7 +6,7 @@
  */
 export declare const SERVER_INSTRUCTIONS = "\n# Agentic QE Fleet - MCP Tool Guide\n\n## Overview\nAgentic QE provides 96 specialized quality engineering tools organized into a hierarchical system for efficient context usage.\n\n## Quick Start\n1. **Discover available tools:** Use `tools_discover` to see all domains\n2. **Load domain tools:** Use `tools_load_domain` to load specialized tools\n3. **Auto-loading:** Domain tools auto-load when relevant keywords are detected\n\n---\n\n## Core Tools (Always Available - 14 tools)\n\n### Fleet Management\n- `fleet_init` - Initialize QE fleet with topology\n- `agent_spawn` - Spawn specialized QE agent\n- `fleet_status` - Get fleet and agent status\n\n### Testing\n- `test_generate_enhanced` - AI test generation with pattern recognition\n- `test_execute_parallel` - Parallel test execution with retry\n- `test_report_comprehensive` - Multi-format test reports\n\n### Memory & Coordination\n- `memory_store` - Store data with TTL & namespacing\n- `memory_retrieve` - Retrieve stored data\n- `memory_query` - Pattern-based memory search\n\n### Quality & Orchestration\n- `quality_analyze` - Analyze quality metrics\n- `task_orchestrate` - Orchestrate tasks across agents\n- `task_status` - Check task progress\n\n### Discovery\n- `tools_discover` - List available tool domains\n- `tools_load_domain` - Load tools for a domain\n\n---\n\n## Domain Tools (Load as Needed)\n\n| Domain | Keywords | Tools | Use Case |\n|--------|----------|-------|----------|\n| **Security** | security, vulnerability, audit, owasp | 4 tools | Security scanning, vulnerability detection |\n| **Performance** | benchmark, bottleneck, profiling | 4 tools | Performance testing, bottleneck analysis |\n| **Coverage** | coverage, gap, uncovered | 5 tools | Coverage analysis, gap detection |\n| **Quality** | quality gate, deploy, release | 6 tools | Quality gates, deployment readiness |\n| **Flaky** | flaky, unstable, retry | 3 tools | Flaky test detection and stabilization |\n| **Visual** | screenshot, accessibility, wcag | 3 tools | Visual regression, accessibility testing |\n| **Requirements** | bdd, gherkin, acceptance | 2 tools | Requirements validation, BDD generation |\n\n### Loading Domain Tools\n```\n# Explicit load\ntools_load_domain({ domain: 'security' })\n\n# Auto-load: Just mention keywords in your request\n\"I need to run a security scan\" \u2192 Security tools auto-load\n```\n\n---\n\n## Specialized Tools (Expert Use)\n\n### Learning Domain (4 tools)\nFor persistent learning and pattern storage across sessions.\nLoad with: `tools_load_domain({ domain: 'learning' })`\n\n### Advanced Domain (7 tools)\nFor mutation testing, API contract validation, production incident replay.\nLoad with: `tools_load_domain({ domain: 'advanced' })`\n\n---\n\n## Best Practices\n\n1. **Start with core tools** - They handle 80% of use cases\n2. **Let auto-load work** - Mention keywords naturally\n3. **Use tools_discover** - When unsure what's available\n4. **Batch operations** - Use parallel execution for speed\n5. **Check fleet_status** - Monitor agent health\n\n---\n\n## Common Workflows\n\n### Test Generation & Execution\n1. `test_generate_enhanced` - Generate tests\n2. `test_execute_parallel` - Run tests\n3. `test_report_comprehensive` - Generate report\n\n### Quality Gate Check\n1. Load quality domain if not auto-loaded\n2. `quality_analyze` - Analyze metrics\n3. `qe_qualitygate_evaluate` - Make go/no-go decision\n\n### Security Audit\n1. `tools_load_domain({ domain: 'security' })`\n2. `qe_security_scan_comprehensive` - Full scan\n3. `qe_security_detect_vulnerabilities` - Detailed analysis\n\n---\n\n## Tool Naming Convention\nAll tools follow: `mcp__agentic_qe__<tool_name>`\n\nExample: `mcp__agentic_qe__test_generate_enhanced`\n";
 export declare const SERVER_NAME = "agentic-qe";
-export declare const SERVER_VERSION = "2.3.5";
+export declare const SERVER_VERSION = "2.5.0";
 /**
  * Get formatted server info for MCP initialization
  */

package/dist/mcp/server-instructions.js

@@ -119,7 +119,7 @@ All tools follow: \`mcp__agentic_qe__<tool_name>\`
 Example: \`mcp__agentic_qe__test_generate_enhanced\`
 `;
 exports.SERVER_NAME = 'agentic-qe';
-exports.SERVER_VERSION = '2.3.5';
+exports.SERVER_VERSION = '2.5.0';
 /**
  * Get formatted server info for MCP initialization
  */

package/dist/mcp/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AA6GjF;;;;;GAKG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAmB;IACnC,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,WAAW,CAAmB;IACtC,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,SAAS,CAAmB;IACpC,OAAO,CAAC,QAAQ,CAAe;IAC/B,OAAO,CAAC,gBAAgB,CAA+B;;IA+CvD;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAkJ1B;;;;;;;OAOG;IACH,OAAO,CAAC,0BAA0B;IAmClC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAmlB5B;;OAEG;IACG,KAAK,CAAC,SAAS,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAY5D;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ3B;;OAEG;IACH,SAAS,IAAI,MAAM;IAInB;;OAEG;IACH,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAIR;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;CAGxC;AAED;;GAEG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAIzE;AAED;;GAEG;AACH,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAuB1C"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAgHjF;;;;;GAKG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAmB;IACnC,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,WAAW,CAAmB;IACtC,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,SAAS,CAAmB;IACpC,OAAO,CAAC,QAAQ,CAAe;IAC/B,OAAO,CAAC,gBAAgB,CAA+B;;IA+CvD;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAoJ1B;;;;;;;OAOG;IACH,OAAO,CAAC,0BAA0B;IAmClC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAulB5B;;OAEG;IACG,KAAK,CAAC,SAAS,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAY5D;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ3B;;OAEG;IACH,SAAS,IAAI,MAAM;IAInB;;OAEG;IACH,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAIR;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;CAGxC;AAED;;GAEG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAIzE;AAED;;GAEG;AACH,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAuB1C"}