agentic-qe 1.9.3 → 1.9.4

package/dist/alerting/AlertManager.d.ts

@@ -0,0 +1,120 @@
+/**
+ * AlertManager - Core Alert Evaluation Engine
+ *
+ * Evaluates metrics against alert rules and manages alert lifecycle.
+ * This is the ACTUAL implementation, not documentation.
+ *
+ * @module alerting/AlertManager
+ * @version 1.0.0
+ */
+import { EventEmitter } from 'events';
+import { Alert, AlertRule, AlertEvaluation, AlertSeverity, AlertingConfig, MetricValue } from './types';
+/**
+ * AlertManager handles alert evaluation, firing, and lifecycle management.
+ *
+ * @example
+ * ```typescript
+ * const manager = new AlertManager();
+ * manager.loadRules(rules);
+ * manager.on('alert:fired', (alert) => console.log('Alert!', alert));
+ * manager.evaluate(metrics);
+ * ```
+ */
+export declare class AlertManager extends EventEmitter {
+    private rules;
+    private activeAlerts;
+    private alertHistory;
+    private cooldowns;
+    private config;
+    private evaluationTimer?;
+    private alertCountThisHour;
+    private hourlyResetTimer?;
+    constructor(config?: Partial<AlertingConfig>);
+    /**
+     * Load alert rules from configuration
+     */
+    loadRules(rules: AlertRule[]): void;
+    /**
+     * Parse rules from YAML-style config object
+     */
+    loadRulesFromConfig(config: {
+        groups: Array<{
+            name: string;
+            rules: unknown[];
+        }>;
+    }): void;
+    /**
+     * Evaluate metrics against all rules
+     */
+    evaluate(metrics: MetricValue[]): AlertEvaluation[];
+    /**
+     * Evaluate a single rule against a metric
+     */
+    private evaluateRule;
+    /**
+     * Extract threshold value from expression
+     */
+    private extractThreshold;
+    /**
+     * Extract comparison operator from expression
+     */
+    private extractComparison;
+    /**
+     * Compare values based on operator
+     */
+    private compareValues;
+    /**
+     * Find metrics relevant to a rule
+     */
+    private findRelevantMetrics;
+    /**
+     * Handle a firing alert
+     */
+    private handleFiringAlert;
+    /**
+     * Handle alert resolution
+     */
+    private handleResolvedAlert;
+    /**
+     * Generate unique fingerprint for alert deduplication
+     */
+    private generateFingerprint;
+    /**
+     * Check if alert is on cooldown
+     */
+    private isOnCooldown;
+    /**
+     * Start periodic evaluation
+     */
+    startEvaluation(metricsProvider: () => MetricValue[]): void;
+    /**
+     * Stop periodic evaluation
+     */
+    stopEvaluation(): void;
+    /**
+     * Start hourly counter reset
+     */
+    private startHourlyReset;
+    /**
+     * Get all active alerts
+     */
+    getActiveAlerts(): Alert[];
+    /**
+     * Get alert history
+     */
+    getAlertHistory(limit?: number): Alert[];
+    /**
+     * Get alert statistics
+     */
+    getStats(): {
+        activeCount: number;
+        totalFired: number;
+        bySeverity: Record<AlertSeverity, number>;
+        alertsThisHour: number;
+    };
+    /**
+     * Cleanup resources
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=AlertManager.d.ts.map

package/dist/alerting/AlertManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AlertManager.d.ts","sourceRoot":"","sources":["../../src/alerting/AlertManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,OAAO,EACL,KAAK,EACL,SAAS,EACT,eAAe,EACf,aAAa,EAEb,cAAc,EACd,WAAW,EAEZ,MAAM,SAAS,CAAC;AAUjB;;;;;;;;;;GAUG;AACH,qBAAa,YAAa,SAAQ,YAAY;IAC5C,OAAO,CAAC,KAAK,CAAqC;IAClD,OAAO,CAAC,YAAY,CAAiC;IACrD,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,SAAS,CAAgC;IACjD,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,eAAe,CAAC,CAAiB;IACzC,OAAO,CAAC,kBAAkB,CAAK;IAC/B,OAAO,CAAC,gBAAgB,CAAC,CAAiB;gBAE9B,MAAM,GAAE,OAAO,CAAC,cAAc,CAAM;IAMhD;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,IAAI;IAQnC;;OAEG;IACH,mBAAmB,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,OAAO,EAAE,CAAA;SAAE,CAAC,CAAA;KAAE,GAAG,IAAI;IAsCxF;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,eAAe,EAAE;IAqBnD;;OAEG;IACH,OAAO,CAAC,YAAY;IAiBpB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAMxB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAKzB;;OAEG;IACH,OAAO,CAAC,aAAa;IAYrB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAW3B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAuDzB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAY3B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAK3B;;OAEG;IACH,OAAO,CAAC,YAAY;IAMpB;;OAEG;IACH,eAAe,CAAC,eAAe,EAAE,MAAM,WAAW,EAAE,GAAG,IAAI;IAQ3D;;OAEG;IACH,cAAc,IAAI,IAAI;IAOtB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAMxB;;OAEG;IACH,eAAe,IAAI,KAAK,EAAE;IAI1B;;OAEG;IACH,eAAe,CAAC,KAAK,SAAM,GAAG,KAAK,EAAE;IAIrC;;OAEG;IACH,QAAQ,IAAI;QACV,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;QAC1C,cAAc,EAAE,MAAM,CAAC;KACxB;IAoBD;;OAEG;IACH,OAAO,IAAI,IAAI;CAOhB"}

package/dist/alerting/AlertManager.js

@@ -0,0 +1,345 @@
+"use strict";
+/**
+ * AlertManager - Core Alert Evaluation Engine
+ *
+ * Evaluates metrics against alert rules and manages alert lifecycle.
+ * This is the ACTUAL implementation, not documentation.
+ *
+ * @module alerting/AlertManager
+ * @version 1.0.0
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AlertManager = void 0;
+const events_1 = require("events");
+const crypto = __importStar(require("crypto"));
+const DEFAULT_CONFIG = {
+    evaluationInterval: 15000, // 15 seconds
+    cooldownPeriod: 300000, // 5 minutes
+    maxAlertsPerHour: 100,
+    enableFeedbackLoop: true,
+    feedbackDelay: 1000
+};
+/**
+ * AlertManager handles alert evaluation, firing, and lifecycle management.
+ *
+ * @example
+ * ```typescript
+ * const manager = new AlertManager();
+ * manager.loadRules(rules);
+ * manager.on('alert:fired', (alert) => console.log('Alert!', alert));
+ * manager.evaluate(metrics);
+ * ```
+ */
+class AlertManager extends events_1.EventEmitter {
+    constructor(config = {}) {
+        super();
+        this.rules = new Map();
+        this.activeAlerts = new Map();
+        this.alertHistory = [];
+        this.cooldowns = new Map();
+        this.alertCountThisHour = 0;
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        this.startHourlyReset();
+    }
+    /**
+     * Load alert rules from configuration
+     */
+    loadRules(rules) {
+        this.rules.clear();
+        for (const rule of rules) {
+            this.rules.set(rule.name, rule);
+        }
+        this.emit('rules:loaded', rules.length);
+    }
+    /**
+     * Parse rules from YAML-style config object
+     */
+    loadRulesFromConfig(config) {
+        const rules = [];
+        for (const group of config.groups) {
+            for (const rawRule of group.rules) {
+                const rule = rawRule;
+                rules.push({
+                    name: rule.alert,
+                    expr: rule.expr,
+                    forDuration: rule.for || '0s',
+                    labels: {
+                        severity: rule.labels?.severity || 'warning',
+                        component: rule.labels?.component || 'unknown',
+                        alert_type: rule.labels?.alert_type || 'generic',
+                        feedback_action: rule.labels?.feedback_action || 'adjust_strategy',
+                        agent_scope: rule.labels?.agent_scope
+                    },
+                    annotations: {
+                        summary: rule.annotations?.summary || '',
+                        description: rule.annotations?.description || '',
+                        feedback_strategy: rule.annotations?.feedback_strategy,
+                        feedback_action: rule.annotations?.feedback_action,
+                        runbook_url: rule.annotations?.runbook_url
+                    }
+                });
+            }
+        }
+        this.loadRules(rules);
+    }
+    /**
+     * Evaluate metrics against all rules
+     */
+    evaluate(metrics) {
+        const evaluations = [];
+        for (const rule of Array.from(this.rules.values())) {
+            const relevantMetrics = this.findRelevantMetrics(rule, metrics);
+            for (const metric of relevantMetrics) {
+                const evaluation = this.evaluateRule(rule, metric);
+                evaluations.push(evaluation);
+                if (evaluation.isFiring) {
+                    this.handleFiringAlert(rule, metric, evaluation);
+                }
+                else {
+                    this.handleResolvedAlert(rule, metric);
+                }
+            }
+        }
+        return evaluations;
+    }
+    /**
+     * Evaluate a single rule against a metric
+     */
+    evaluateRule(rule, metric) {
+        const threshold = this.extractThreshold(rule.expr);
+        const comparison = this.extractComparison(rule.expr);
+        const isFiring = this.compareValues(metric.value, threshold, comparison);
+        return {
+            rule,
+            metric,
+            threshold,
+            actual: metric.value,
+            isFiring,
+            message: isFiring
+                ? `${rule.name}: ${metric.value} ${comparison} ${threshold}`
+                : `${rule.name}: OK (${metric.value})`
+        };
+    }
+    /**
+     * Extract threshold value from expression
+     */
+    extractThreshold(expr) {
+        // Match patterns like "> 0.05", "< 80", ">= 5"
+        const match = expr.match(/[<>=]+\s*([\d.]+)\s*$/);
+        return match ? parseFloat(match[1]) : 0;
+    }
+    /**
+     * Extract comparison operator from expression
+     */
+    extractComparison(expr) {
+        const match = expr.match(/([<>=]+)\s*[\d.]+\s*$/);
+        return match ? match[1] : '>';
+    }
+    /**
+     * Compare values based on operator
+     */
+    compareValues(actual, threshold, operator) {
+        switch (operator) {
+            case '>': return actual > threshold;
+            case '>=': return actual >= threshold;
+            case '<': return actual < threshold;
+            case '<=': return actual <= threshold;
+            case '==': return actual === threshold;
+            case '!=': return actual !== threshold;
+            default: return actual > threshold;
+        }
+    }
+    /**
+     * Find metrics relevant to a rule
+     */
+    findRelevantMetrics(rule, metrics) {
+        // Extract metric name from expression (e.g., "aqe_quality_coverage_line" from expr)
+        const metricNameMatch = rule.expr.match(/([a-z_]+)/);
+        const metricName = metricNameMatch ? metricNameMatch[1] : '';
+        return metrics.filter(m => m.name.includes(metricName) ||
+            rule.expr.includes(m.name));
+    }
+    /**
+     * Handle a firing alert
+     */
+    handleFiringAlert(rule, metric, evaluation) {
+        const fingerprint = this.generateFingerprint(rule, metric);
+        // Check cooldown
+        if (this.isOnCooldown(fingerprint)) {
+            return;
+        }
+        // Check rate limiting
+        if (this.alertCountThisHour >= this.config.maxAlertsPerHour) {
+            this.emit('alert:suppressed', { reason: 'rate_limit', rule: rule.name });
+            return;
+        }
+        // Check if already firing
+        if (this.activeAlerts.has(fingerprint)) {
+            return;
+        }
+        const alert = {
+            id: crypto.randomUUID(),
+            name: rule.name,
+            status: 'firing',
+            severity: rule.labels.severity,
+            labels: { ...rule.labels, ...metric.labels },
+            annotations: {
+                ...rule.annotations,
+                actual_value: String(metric.value),
+                threshold: String(evaluation.threshold)
+            },
+            value: metric.value,
+            firedAt: new Date(),
+            fingerprint
+        };
+        this.activeAlerts.set(fingerprint, alert);
+        this.alertHistory.push(alert);
+        this.alertCountThisHour++;
+        this.cooldowns.set(fingerprint, new Date());
+        this.emit('alert:fired', alert);
+        // Trigger feedback loop if enabled
+        if (this.config.enableFeedbackLoop) {
+            setTimeout(() => {
+                this.emit('alert:feedback', {
+                    alert,
+                    feedbackAction: rule.labels.feedback_action,
+                    strategy: rule.annotations.feedback_strategy,
+                    targetAgent: rule.labels.agent_scope
+                });
+            }, this.config.feedbackDelay);
+        }
+    }
+    /**
+     * Handle alert resolution
+     */
+    handleResolvedAlert(rule, metric) {
+        const fingerprint = this.generateFingerprint(rule, metric);
+        const existingAlert = this.activeAlerts.get(fingerprint);
+        if (existingAlert && existingAlert.status === 'firing') {
+            existingAlert.status = 'resolved';
+            existingAlert.resolvedAt = new Date();
+            this.activeAlerts.delete(fingerprint);
+            this.emit('alert:resolved', existingAlert);
+        }
+    }
+    /**
+     * Generate unique fingerprint for alert deduplication
+     */
+    generateFingerprint(rule, metric) {
+        const data = `${rule.name}:${metric.name}:${JSON.stringify(metric.labels)}`;
+        return crypto.createHash('md5').update(data).digest('hex');
+    }
+    /**
+     * Check if alert is on cooldown
+     */
+    isOnCooldown(fingerprint) {
+        const lastFired = this.cooldowns.get(fingerprint);
+        if (!lastFired)
+            return false;
+        return Date.now() - lastFired.getTime() < this.config.cooldownPeriod;
+    }
+    /**
+     * Start periodic evaluation
+     */
+    startEvaluation(metricsProvider) {
+        this.stopEvaluation();
+        this.evaluationTimer = setInterval(() => {
+            const metrics = metricsProvider();
+            this.evaluate(metrics);
+        }, this.config.evaluationInterval);
+    }
+    /**
+     * Stop periodic evaluation
+     */
+    stopEvaluation() {
+        if (this.evaluationTimer) {
+            clearInterval(this.evaluationTimer);
+            this.evaluationTimer = undefined;
+        }
+    }
+    /**
+     * Start hourly counter reset
+     */
+    startHourlyReset() {
+        this.hourlyResetTimer = setInterval(() => {
+            this.alertCountThisHour = 0;
+        }, 3600000); // 1 hour
+    }
+    /**
+     * Get all active alerts
+     */
+    getActiveAlerts() {
+        return Array.from(this.activeAlerts.values());
+    }
+    /**
+     * Get alert history
+     */
+    getAlertHistory(limit = 100) {
+        return this.alertHistory.slice(-limit);
+    }
+    /**
+     * Get alert statistics
+     */
+    getStats() {
+        const bySeverity = {
+            info: 0,
+            warning: 0,
+            error: 0,
+            critical: 0
+        };
+        for (const alert of Array.from(this.activeAlerts.values())) {
+            bySeverity[alert.severity]++;
+        }
+        return {
+            activeCount: this.activeAlerts.size,
+            totalFired: this.alertHistory.length,
+            bySeverity,
+            alertsThisHour: this.alertCountThisHour
+        };
+    }
+    /**
+     * Cleanup resources
+     */
+    destroy() {
+        this.stopEvaluation();
+        if (this.hourlyResetTimer) {
+            clearInterval(this.hourlyResetTimer);
+        }
+        this.removeAllListeners();
+    }
+}
+exports.AlertManager = AlertManager;
+//# sourceMappingURL=AlertManager.js.map

package/dist/alerting/AlertManager.js.map

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

package/dist/alerting/FeedbackRouter.d.ts

@@ -0,0 +1,98 @@
+/**
+ * FeedbackRouter - Routes Alerts to Appropriate Actions
+ *
+ * Takes fired alerts and routes them to the appropriate feedback actions
+ * based on alert type, severity, and configured strategies.
+ *
+ * @module alerting/FeedbackRouter
+ * @version 1.0.0
+ */
+import { EventEmitter } from 'events';
+import { Alert, FeedbackEvent, Strategy } from './types';
+/**
+ * Feedback routing configuration
+ */
+export interface FeedbackRouterConfig {
+    /** Default confidence threshold for auto-actions */
+    confidenceThreshold: number;
+    /** Enable automatic escalation for critical alerts */
+    autoEscalate: boolean;
+    /** Escalation delay in milliseconds */
+    escalationDelay: number;
+    /** Maximum retry attempts for failed actions */
+    maxRetries: number;
+}
+/**
+ * FeedbackRouter routes alerts to feedback actions and strategies.
+ *
+ * @example
+ * ```typescript
+ * const router = new FeedbackRouter();
+ * router.on('feedback:generated', (event) => strategyApplicator.apply(event));
+ * router.route(alert);
+ * ```
+ */
+export declare class FeedbackRouter extends EventEmitter {
+    private config;
+    private strategies;
+    private feedbackHistory;
+    private pendingEscalations;
+    constructor(config?: Partial<FeedbackRouterConfig>);
+    /**
+     * Initialize default feedback strategies
+     */
+    private initializeDefaultStrategies;
+    /**
+     * Register a custom strategy
+     */
+    registerStrategy(strategy: Strategy): void;
+    /**
+     * Route an alert to appropriate feedback action
+     */
+    route(alert: Alert): FeedbackEvent | null;
+    /**
+     * Determine feedback action based on alert labels
+     */
+    private determineFeedbackAction;
+    /**
+     * Generate suggestions based on alert type
+     */
+    private generateSuggestions;
+    /**
+     * Select best strategy for alert
+     */
+    private selectStrategy;
+    /**
+     * Infer target agent from alert
+     */
+    private inferTargetAgent;
+    /**
+     * Calculate overall confidence from suggestions
+     */
+    private calculateConfidence;
+    /**
+     * Check if escalation is needed
+     */
+    private shouldEscalate;
+    /**
+     * Schedule escalation for unresolved critical alerts
+     */
+    private scheduleEscalation;
+    /**
+     * Cancel pending escalation (e.g., when alert resolves)
+     */
+    cancelEscalation(alertId: string): void;
+    /**
+     * Get feedback history
+     */
+    getFeedbackHistory(limit?: number): FeedbackEvent[];
+    /**
+     * Get all registered strategies
+     */
+    getStrategies(): Strategy[];
+    /**
+     * Cleanup resources
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=FeedbackRouter.d.ts.map

package/dist/alerting/FeedbackRouter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FeedbackRouter.d.ts","sourceRoot":"","sources":["../../src/alerting/FeedbackRouter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,OAAO,EACL,KAAK,EACL,aAAa,EAGb,QAAQ,EACT,MAAM,SAAS,CAAC;AAEjB;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,oDAAoD;IACpD,mBAAmB,EAAE,MAAM,CAAC;IAC5B,sDAAsD;IACtD,YAAY,EAAE,OAAO,CAAC;IACtB,uCAAuC;IACvC,eAAe,EAAE,MAAM,CAAC;IACxB,gDAAgD;IAChD,UAAU,EAAE,MAAM,CAAC;CACpB;AAkBD;;;;;;;;;GASG;AACH,qBAAa,cAAe,SAAQ,YAAY;IAC9C,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,UAAU,CAAoC;IACtD,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,kBAAkB,CAA0C;gBAExD,MAAM,GAAE,OAAO,CAAC,oBAAoB,CAAM;IAMtD;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAgEnC;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAK1C;;OAEG;IACH,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,aAAa,GAAG,IAAI;IAuCzC;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAa/B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAuD3B;;OAEG;IACH,OAAO,CAAC,cAAc;IAuBtB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAcxB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAO3B;;OAEG;IACH,OAAO,CAAC,cAAc;IAOtB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAc1B;;OAEG;IACH,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAQvC;;OAEG;IACH,kBAAkB,CAAC,KAAK,SAAM,GAAG,aAAa,EAAE;IAIhD;;OAEG;IACH,aAAa,IAAI,QAAQ,EAAE;IAI3B;;OAEG;IACH,OAAO,IAAI,IAAI;CAOhB"}