agentic-qe 2.7.0 → 2.7.2

package/dist/planning/integration/GOAPQualityGateIntegration.d.ts

@@ -0,0 +1,229 @@
+/**
+ * GOAP Quality Gate Integration
+ *
+ * Bridges GOAP planning with quality gate evaluation:
+ * - Converts quality metrics to WorldState
+ * - Generates remediation plans on gate failure
+ * - Tracks plan execution and success rates
+ * - Provides alternative paths when primary actions fail
+ *
+ * @module planning/integration/GOAPQualityGateIntegration
+ * @version 1.0.0
+ */
+import Database from 'better-sqlite3';
+import { WorldState, GOAPPlan, StateConditions } from '../types';
+/**
+ * Quality metrics from the existing quality gate system
+ */
+export interface QualityGateMetrics {
+    coverage?: {
+        overallPercentage?: number;
+        linePercentage?: number;
+        branchPercentage?: number;
+        functionPercentage?: number;
+    };
+    testResults?: {
+        total?: number;
+        passed?: number;
+        failed?: number;
+        failureRate?: number;
+        flakyTests?: number;
+    };
+    security?: {
+        summary?: {
+            critical?: number;
+            high?: number;
+            medium?: number;
+            low?: number;
+        };
+    };
+    performance?: {
+        errorRate?: number;
+        p95Latency?: number;
+        throughput?: number;
+    };
+    codeQuality?: {
+        maintainabilityIndex?: number;
+        cyclomaticComplexity?: number;
+        technicalDebtDays?: number;
+    };
+}
+/**
+ * Quality gate context for planning
+ */
+export interface QualityGateContext {
+    projectId: string;
+    buildId: string;
+    environment: 'development' | 'staging' | 'production';
+    criticality?: 'low' | 'medium' | 'high' | 'critical';
+    changedFiles?: string[];
+    previousFailures?: number;
+    timeRemaining?: number;
+    availableAgents?: string[];
+}
+/**
+ * Remediation plan for quality gate failures
+ */
+export interface RemediationPlan {
+    planId: string;
+    actions: RemediationAction[];
+    totalCost: number;
+    estimatedDuration: number;
+    successProbability: number;
+    alternativePaths: AlternativePath[];
+    createdAt: string;
+}
+/**
+ * Individual remediation action
+ */
+export interface RemediationAction {
+    id: string;
+    name: string;
+    description?: string;
+    agentType: string;
+    category: string;
+    estimatedDuration: number;
+    successRate: number;
+    effects: string[];
+}
+/**
+ * Alternative remediation path
+ */
+export interface AlternativePath {
+    planId: string;
+    actions: string[];
+    totalCost: number;
+    estimatedDuration: number;
+    differenceFromPrimary: string;
+}
+/**
+ * Goal definitions for quality gate scenarios
+ */
+export declare const QUALITY_GATE_GOALS: {
+    /**
+     * Pass all quality gates with standard thresholds
+     */
+    PASS_QUALITY_GATE: {
+        id: string;
+        name: string;
+        conditions: StateConditions;
+        priority: number;
+    };
+    /**
+     * Achieve minimum viable quality for hotfix
+     */
+    HOTFIX_QUALITY: {
+        id: string;
+        name: string;
+        conditions: StateConditions;
+        priority: number;
+    };
+    /**
+     * Fix test failures to reach passing threshold
+     */
+    TEST_SUCCESS: {
+        id: string;
+        name: string;
+        conditions: StateConditions;
+        priority: number;
+    };
+    /**
+     * Improve coverage to target threshold
+     */
+    COVERAGE_TARGET: {
+        id: string;
+        name: string;
+        conditions: StateConditions;
+        priority: number;
+    };
+    /**
+     * Resolve security vulnerabilities
+     */
+    SECURITY_CLEAR: {
+        id: string;
+        name: string;
+        conditions: StateConditions;
+        priority: number;
+    };
+    /**
+     * Performance meets SLA
+     */
+    PERFORMANCE_SLA: {
+        id: string;
+        name: string;
+        conditions: StateConditions;
+        priority: number;
+    };
+};
+/**
+ * GOAP Quality Gate Integration
+ */
+export declare class GOAPQualityGateIntegration {
+    private planner;
+    private db;
+    private logger;
+    private initialized;
+    constructor(db: Database.Database);
+    /**
+     * Initialize planner with quality gate actions
+     */
+    initialize(): Promise<void>;
+    /**
+     * Close database connection and cleanup resources
+     * Call this in tests to prevent memory leaks
+     */
+    close(): void;
+    /**
+     * Convert quality gate metrics to GOAP WorldState
+     */
+    buildWorldState(metrics: QualityGateMetrics, context: QualityGateContext): WorldState;
+    /**
+     * Generate remediation plan for quality gate failure
+     */
+    generateRemediationPlan(metrics: QualityGateMetrics, context: QualityGateContext, targetGoal?: keyof typeof QUALITY_GATE_GOALS): Promise<RemediationPlan | null>;
+    /**
+     * Find alternative remediation paths
+     *
+     * STRATEGY: With flag-based actions, we have two types:
+     * 1. MEASUREMENT actions (set flags like testsMeasured=true) - MUST run, cannot be excluded
+     * 2. IMPROVEMENT actions (increase metrics) - CAN be swapped for alternatives
+     *
+     * We find diverse alternatives by:
+     * - Keeping measurement actions fixed (they're prerequisites)
+     * - Swapping improvement actions for alternatives with similar effects
+     */
+    private findAlternativePaths;
+    /**
+     * Calculate success probability for a plan
+     */
+    private calculateSuccessProbability;
+    /**
+     * Persist plan to database
+     */
+    private persistPlan;
+    /**
+     * Format plan for external consumption
+     */
+    private formatRemediationPlan;
+    /**
+     * Map criticality to risk level
+     */
+    private mapCriticality;
+    /**
+     * Update action success rate based on execution outcome
+     */
+    recordActionOutcome(actionId: string, success: boolean): Promise<void>;
+    /**
+     * Mark plan as completed
+     */
+    completePlan(planId: string, success: boolean, reason?: string): Promise<void>;
+    /**
+     * Get successful plan templates for similar goals
+     */
+    getSimilarSuccessfulPlans(goalId: string, limit?: number): Promise<GOAPPlan[]>;
+}
+/**
+ * Factory function to create integration instance
+ */
+export declare function createQualityGateIntegration(dbPath: string): GOAPQualityGateIntegration;
+//# sourceMappingURL=GOAPQualityGateIntegration.d.ts.map

package/dist/planning/integration/GOAPQualityGateIntegration.d.ts.map

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