agentic-qe 2.1.1 → 2.2.0

package/dist/memory/PatternQualityScorer.js

@@ -0,0 +1,327 @@
+"use strict";
+/**
+ * PatternQualityScorer - Pattern Quality Scoring and Garbage Collection
+ *
+ * Features:
+ * - Score patterns based on usage success rate
+ * - Track comprehensive usage statistics
+ * - Garbage collection for low-quality patterns
+ * - Pattern ranking and recommendations
+ * - Adaptive quality thresholds
+ *
+ * @module memory/PatternQualityScorer
+ * @version 1.0.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PatternQualityScorer = void 0;
+/**
+ * PatternQualityScorer - Tracks and scores pattern quality for optimization
+ *
+ * This class provides:
+ * - Real-time quality scoring based on success rate and usage
+ * - Comprehensive usage statistics tracking
+ * - Automatic garbage collection of low-quality patterns
+ * - Pattern ranking for recommendations
+ * - Trend analysis for quality improvement/degradation
+ */
+class PatternQualityScorer {
+    constructor(library, config = {}) {
+        this.DEFAULT_MIN_SUCCESS_RATE = 0.7;
+        this.DEFAULT_MIN_USAGE_COUNT = 5;
+        this.DEFAULT_MAX_AGE_DAYS = 90;
+        this.DEFAULT_MIN_QUALITY_SCORE = 0.5;
+        this.DEFAULT_GC_INTERVAL = 3600000; // 1 hour
+        this.library = library;
+        this.config = {
+            minSuccessRate: config.minSuccessRate || this.DEFAULT_MIN_SUCCESS_RATE,
+            minUsageCount: config.minUsageCount || this.DEFAULT_MIN_USAGE_COUNT,
+            maxAgeInDays: config.maxAgeInDays || this.DEFAULT_MAX_AGE_DAYS,
+            minQualityScore: config.minQualityScore || this.DEFAULT_MIN_QUALITY_SCORE,
+            successRateWeight: config.successRateWeight || 0.5,
+            usageWeight: config.usageWeight || 0.3,
+            recencyWeight: config.recencyWeight || 0.2,
+            enableAutoGC: config.enableAutoGC !== false,
+            gcInterval: config.gcInterval || this.DEFAULT_GC_INTERVAL
+        };
+        this.usageHistory = new Map();
+        this.metricsCache = new Map();
+    }
+    /**
+     * Start automatic garbage collection
+     */
+    startAutoGC() {
+        if (!this.config.enableAutoGC) {
+            return;
+        }
+        this.gcTimer = setInterval(async () => {
+            await this.garbageCollect();
+        }, this.config.gcInterval);
+    }
+    /**
+     * Stop automatic garbage collection
+     */
+    stopAutoGC() {
+        if (this.gcTimer) {
+            clearInterval(this.gcTimer);
+            this.gcTimer = undefined;
+        }
+    }
+    /**
+     * Record pattern usage
+     */
+    async recordUsage(usage) {
+        const history = this.usageHistory.get(usage.patternId) || [];
+        history.push(usage);
+        this.usageHistory.set(usage.patternId, history);
+        // Invalidate metrics cache
+        this.metricsCache.delete(usage.patternId);
+        // Update pattern lastUsed and usageCount
+        const pattern = await this.library.getPattern(usage.patternId);
+        if (pattern) {
+            pattern.lastUsed = usage.timestamp;
+            pattern.usageCount = (pattern.usageCount || 0) + 1;
+            await this.library.updatePattern(pattern);
+        }
+    }
+    /**
+     * Calculate quality metrics for a pattern
+     */
+    async calculateMetrics(patternId) {
+        // Check cache first
+        const cached = this.metricsCache.get(patternId);
+        if (cached) {
+            return cached;
+        }
+        const pattern = await this.library.getPattern(patternId);
+        if (!pattern) {
+            return null;
+        }
+        const history = this.usageHistory.get(patternId) || [];
+        const now = Date.now();
+        // Calculate basic stats
+        const totalUsage = history.length;
+        const successCount = history.filter(u => u.success).length;
+        const failureCount = totalUsage - successCount;
+        const successRate = totalUsage > 0 ? successCount / totalUsage : 0;
+        // Calculate average execution time
+        const executionTimes = history
+            .filter(u => u.executionTime !== undefined)
+            .map(u => u.executionTime);
+        const averageExecutionTime = executionTimes.length > 0
+            ? executionTimes.reduce((a, b) => a + b, 0) / executionTimes.length
+            : 0;
+        // Calculate age
+        const createdTimestamp = pattern.createdAt || now;
+        const ageInDays = (now - createdTimestamp) / (1000 * 60 * 60 * 24);
+        // Calculate trend score (recent vs old performance)
+        const trendScore = this.calculateTrend(history);
+        // Calculate quality score
+        const qualityScore = this.calculateQualityScore({
+            successRate,
+            totalUsage,
+            ageInDays,
+            averageExecutionTime
+        });
+        const metrics = {
+            patternId,
+            qualityScore,
+            successRate,
+            totalUsage,
+            successCount,
+            failureCount,
+            averageExecutionTime,
+            lastUsedTimestamp: pattern.lastUsed || createdTimestamp,
+            createdTimestamp,
+            ageInDays,
+            trendScore
+        };
+        // Cache metrics
+        this.metricsCache.set(patternId, metrics);
+        return metrics;
+    }
+    /**
+     * Calculate overall quality score (0-1)
+     */
+    calculateQualityScore(params) {
+        const { successRate, totalUsage, ageInDays, averageExecutionTime } = params;
+        // Success rate component (0-1)
+        const successComponent = successRate * this.config.successRateWeight;
+        // Usage frequency component (0-1, normalized)
+        // More usage = higher score, with diminishing returns
+        const usageComponent = Math.min(totalUsage / 100, 1) * this.config.usageWeight;
+        // Recency component (0-1, inverse of age)
+        // Newer patterns score higher
+        const recencyComponent = Math.max(0, 1 - ageInDays / this.config.maxAgeInDays) * this.config.recencyWeight;
+        // Combine components
+        const rawScore = successComponent + usageComponent + recencyComponent;
+        // Normalize to 0-1
+        const totalWeight = this.config.successRateWeight + this.config.usageWeight + this.config.recencyWeight;
+        return Math.min(rawScore / totalWeight, 1);
+    }
+    /**
+     * Calculate trend score (recent performance vs historical)
+     */
+    calculateTrend(history) {
+        if (history.length < 10) {
+            return 0; // Not enough data
+        }
+        const sortedHistory = [...history].sort((a, b) => a.timestamp - b.timestamp);
+        const midpoint = Math.floor(sortedHistory.length / 2);
+        const oldHalf = sortedHistory.slice(0, midpoint);
+        const newHalf = sortedHistory.slice(midpoint);
+        const oldSuccessRate = oldHalf.filter(u => u.success).length / oldHalf.length;
+        const newSuccessRate = newHalf.filter(u => u.success).length / newHalf.length;
+        // Positive = improving, negative = degrading
+        return newSuccessRate - oldSuccessRate;
+    }
+    /**
+     * Get ranked patterns by quality
+     */
+    async getRankedPatterns(options) {
+        const patterns = await this.library.getPatterns();
+        const rankedPatterns = [];
+        for (const pattern of patterns) {
+            const metrics = await this.calculateMetrics(pattern.id);
+            if (!metrics)
+                continue;
+            // Apply quality filter
+            if (options?.minQualityScore && metrics.qualityScore < options.minQualityScore) {
+                continue;
+            }
+            rankedPatterns.push({
+                pattern,
+                metrics,
+                rank: 0 // Will be set after sorting
+            });
+        }
+        // Sort patterns
+        const sortBy = options?.sortBy || 'quality';
+        rankedPatterns.sort((a, b) => {
+            switch (sortBy) {
+                case 'usage':
+                    return b.metrics.totalUsage - a.metrics.totalUsage;
+                case 'recency':
+                    return b.metrics.lastUsedTimestamp - a.metrics.lastUsedTimestamp;
+                case 'quality':
+                default:
+                    return b.metrics.qualityScore - a.metrics.qualityScore;
+            }
+        });
+        // Assign ranks
+        rankedPatterns.forEach((rp, index) => {
+            rp.rank = index + 1;
+        });
+        // Apply limit
+        if (options?.limit) {
+            return rankedPatterns.slice(0, options.limit);
+        }
+        return rankedPatterns;
+    }
+    /**
+     * Get patterns eligible for garbage collection
+     */
+    async getGarbageCandidates() {
+        const patterns = await this.library.getPatterns();
+        const candidates = [];
+        for (const pattern of patterns) {
+            const metrics = await this.calculateMetrics(pattern.id);
+            if (!metrics)
+                continue;
+            // Check if pattern should be garbage collected
+            const shouldGC = (metrics.qualityScore < this.config.minQualityScore &&
+                metrics.totalUsage >= this.config.minUsageCount) ||
+                (metrics.successRate < this.config.minSuccessRate &&
+                    metrics.totalUsage >= this.config.minUsageCount) ||
+                (metrics.ageInDays > this.config.maxAgeInDays &&
+                    metrics.totalUsage === 0);
+            if (shouldGC) {
+                candidates.push(metrics);
+            }
+        }
+        return candidates;
+    }
+    /**
+     * Perform garbage collection
+     */
+    async garbageCollect() {
+        const startTime = Date.now();
+        const stats = await this.library.getStats();
+        const totalPatterns = stats.totalPatterns;
+        const candidates = await this.getGarbageCandidates();
+        const removedPatternIds = [];
+        let bytesReclaimed = 0;
+        for (const metrics of candidates) {
+            const pattern = await this.library.getPattern(metrics.patternId);
+            if (!pattern)
+                continue;
+            // Estimate bytes
+            const patternSize = JSON.stringify(pattern).length;
+            // Delete pattern
+            const deleted = await this.library.deletePattern(metrics.patternId);
+            if (deleted) {
+                removedPatternIds.push(metrics.patternId);
+                bytesReclaimed += patternSize;
+                // Remove from caches
+                this.usageHistory.delete(metrics.patternId);
+                this.metricsCache.delete(metrics.patternId);
+            }
+        }
+        const duration = Date.now() - startTime;
+        return {
+            totalPatterns,
+            patternsRemoved: removedPatternIds.length,
+            removedPatternIds,
+            bytesReclaimed,
+            duration,
+            timestamp: Date.now()
+        };
+    }
+    /**
+     * Get scorer statistics
+     */
+    async getStats() {
+        const libraryStats = await this.library.getStats();
+        const patterns = await this.library.getPatterns();
+        let totalQualityScore = 0;
+        let lowQualityCount = 0;
+        for (const pattern of patterns) {
+            const metrics = await this.calculateMetrics(pattern.id);
+            if (metrics) {
+                totalQualityScore += metrics.qualityScore;
+                if (metrics.qualityScore < this.config.minQualityScore) {
+                    lowQualityCount++;
+                }
+            }
+        }
+        const candidates = await this.getGarbageCandidates();
+        return {
+            totalPatterns: libraryStats.totalPatterns,
+            trackedPatterns: patterns.length,
+            averageQualityScore: patterns.length > 0 ? totalQualityScore / patterns.length : 0,
+            lowQualityPatterns: lowQualityCount,
+            garbageCandidates: candidates.length
+        };
+    }
+    /**
+     * Clear all usage history
+     */
+    clearHistory() {
+        this.usageHistory.clear();
+        this.metricsCache.clear();
+    }
+    /**
+     * Export usage history for analysis
+     */
+    exportHistory() {
+        return new Map(this.usageHistory);
+    }
+    /**
+     * Import usage history from external source
+     */
+    importHistory(history) {
+        this.usageHistory = new Map(history);
+        this.metricsCache.clear(); // Invalidate cache
+    }
+}
+exports.PatternQualityScorer = PatternQualityScorer;
+//# sourceMappingURL=PatternQualityScorer.js.map

package/dist/memory/PatternQualityScorer.js.map

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

package/dist/memory/PatternReplicationService.d.ts

@@ -0,0 +1,187 @@
+/**
+ * PatternReplicationService - Pattern Replication with Health Monitoring
+ *
+ * Features:
+ * - Multi-agent pattern replication with configurable replication factor
+ * - Health monitoring for replication nodes
+ * - Conflict resolution for concurrent updates
+ * - Automatic failover and recovery
+ * - Replication consistency tracking
+ *
+ * @module memory/PatternReplicationService
+ * @version 1.0.0
+ */
+import { DistributedPatternLibrary } from './DistributedPatternLibrary';
+import { TestPattern } from '../core/memory/IPatternStore';
+import { EventEmitter } from 'events';
+/**
+ * Replication node status
+ */
+export declare enum ReplicationNodeStatus {
+    HEALTHY = "healthy",
+    DEGRADED = "degraded",
+    FAILED = "failed",
+    RECOVERING = "recovering"
+}
+/**
+ * Replication node information
+ */
+export interface ReplicationNode {
+    agentId: string;
+    library: DistributedPatternLibrary;
+    status: ReplicationNodeStatus;
+    lastHeartbeat: number;
+    consecutiveFailures: number;
+    totalPatterns: number;
+    lastSyncTimestamp: number;
+}
+/**
+ * Replication health metrics
+ */
+export interface ReplicationHealth {
+    totalNodes: number;
+    healthyNodes: number;
+    degradedNodes: number;
+    failedNodes: number;
+    recoveringNodes: number;
+    averageReplicationLag: number;
+    consistencyPercentage: number;
+    lastHealthCheck: number;
+}
+/**
+ * Replication configuration
+ */
+export interface ReplicationConfig {
+    /** Replication factor (number of copies) */
+    replicationFactor: number;
+    /** Heartbeat interval in milliseconds */
+    heartbeatInterval?: number;
+    /** Node failure threshold (consecutive failures) */
+    failureThreshold?: number;
+    /** Sync interval in milliseconds */
+    syncInterval?: number;
+    /** Enable automatic recovery */
+    autoRecover?: boolean;
+    /** Minimum healthy nodes required */
+    minHealthyNodes?: number;
+}
+/**
+ * Replication event types
+ */
+export type ReplicationEvent = {
+    type: 'pattern_replicated';
+    patternId: string;
+    nodeCount: number;
+} | {
+    type: 'node_failed';
+    agentId: string;
+    reason: string;
+} | {
+    type: 'node_recovered';
+    agentId: string;
+} | {
+    type: 'sync_completed';
+    duration: number;
+    patternsReplicated: number;
+} | {
+    type: 'inconsistency_detected';
+    patternId: string;
+    nodeIds: string[];
+};
+/**
+ * PatternReplicationService - Manages pattern replication across multiple agents
+ *
+ * This service provides:
+ * - Automatic pattern replication to N nodes (configurable replication factor)
+ * - Health monitoring with heartbeat mechanism
+ * - Automatic failover and recovery
+ * - Consistency checking and repair
+ * - Event-driven notifications for replication events
+ */
+export declare class PatternReplicationService extends EventEmitter {
+    private nodes;
+    private config;
+    private heartbeatTimer?;
+    private syncTimer?;
+    private isRunning;
+    private readonly DEFAULT_HEARTBEAT_INTERVAL;
+    private readonly DEFAULT_SYNC_INTERVAL;
+    private readonly DEFAULT_FAILURE_THRESHOLD;
+    constructor(config: ReplicationConfig);
+    /**
+     * Start the replication service
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the replication service
+     */
+    stop(): Promise<void>;
+    /**
+     * Register a replication node
+     */
+    registerNode(agentId: string, library: DistributedPatternLibrary): Promise<void>;
+    /**
+     * Unregister a replication node
+     */
+    unregisterNode(agentId: string): Promise<boolean>;
+    /**
+     * Replicate a pattern to all healthy nodes
+     */
+    replicatePattern(pattern: TestPattern, sourceAgentId?: string): Promise<number>;
+    /**
+     * Sync patterns across all nodes
+     */
+    syncPatterns(): Promise<{
+        synced: number;
+        duration: number;
+    }>;
+    /**
+     * Check replication health
+     */
+    checkHealth(): Promise<ReplicationHealth>;
+    /**
+     * Get replication statistics
+     */
+    getStats(): Promise<{
+        replicationFactor: number;
+        registeredNodes: number;
+        health: ReplicationHealth;
+    }>;
+    /**
+     * Get all registered nodes
+     */
+    getNodes(): ReplicationNode[];
+    /**
+     * Get healthy nodes only
+     */
+    private getHealthyNodes;
+    /**
+     * Start heartbeat monitoring
+     */
+    private startHeartbeat;
+    /**
+     * Start periodic sync
+     */
+    private startSync;
+    /**
+     * Perform heartbeat check on all nodes
+     */
+    private performHeartbeat;
+    /**
+     * Handle node failure
+     */
+    private handleNodeFailure;
+    /**
+     * Attempt to recover a failed node
+     */
+    private attemptRecovery;
+    /**
+     * Sync a single node with the cluster
+     */
+    private syncNode;
+    /**
+     * Calculate consistency percentage across all nodes
+     */
+    private calculateConsistency;
+}
+//# sourceMappingURL=PatternReplicationService.d.ts.map

package/dist/memory/PatternReplicationService.d.ts.map

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