@agentic-qe/v3 3.0.0-alpha.10

package/dist/coordination/protocols/defect-investigation.d.ts

@@ -0,0 +1,202 @@
+/**
+ * Agentic QE v3 - Defect Investigation Protocol
+ *
+ * Orchestrates multi-agent investigation of test failures.
+ * Trigger: Test failure event
+ * Participants: Defect Predictor, RCA, Flaky Hunter, Regression
+ * Actions: Check flakiness, analyze root cause, predict related failures
+ */
+import { Result } from '../../shared/types';
+import { EventBus, MemoryBackend } from '../../kernel/interfaces';
+import { RootCauseAnalysis, RegressionRisk } from '../../domains/defect-intelligence/interfaces';
+import { ImpactAnalysis } from '../../domains/code-intelligence/interfaces';
+/**
+ * Input for defect investigation - a test failure to investigate
+ */
+export interface TestFailure {
+    testId: string;
+    testName: string;
+    file: string;
+    error: string;
+    stack?: string;
+    duration: number;
+    runId: string;
+    timestamp: Date;
+    context?: TestFailureContext;
+}
+export interface TestFailureContext {
+    precedingTests?: string[];
+    environment?: Record<string, string>;
+    parallelWorkers?: number;
+    retryAttempt?: number;
+}
+/**
+ * Result of a complete defect investigation
+ */
+export interface DefectInvestigationResult {
+    investigationId: string;
+    testFailure: TestFailure;
+    isFlaky: boolean;
+    flakyAnalysis?: FlakyTestAnalysis;
+    rootCause?: RootCauseAnalysis;
+    regressionAnalysis?: RegressionRisk;
+    relatedFailures: RelatedFailure[];
+    impactAnalysis?: ImpactAnalysis;
+    coverageContext?: CoverageContext;
+    recommendations: DefectRecommendation[];
+    confidence: number;
+    duration: number;
+}
+export interface FlakyTestAnalysis {
+    isFlaky: boolean;
+    confidence: number;
+    pattern?: 'timing' | 'ordering' | 'resource' | 'async' | 'unknown';
+    failureRate?: number;
+    recommendation?: string;
+}
+export interface RelatedFailure {
+    testId: string;
+    testName: string;
+    file: string;
+    similarity: number;
+    reason: string;
+}
+export interface CoverageContext {
+    file: string;
+    lineCoverage: number;
+    branchCoverage: number;
+    uncoveredLines: number[];
+    riskScore: number;
+}
+export interface DefectRecommendation {
+    type: 'fix' | 'investigate' | 'retry' | 'skip' | 'quarantine';
+    priority: 'critical' | 'high' | 'medium' | 'low';
+    description: string;
+    action: string;
+    effort: 'low' | 'medium' | 'high';
+    confidence: number;
+}
+export interface DefectInvestigationStartedPayload {
+    investigationId: string;
+    testId: string;
+    testFile: string;
+    error: string;
+    runId: string;
+}
+export interface FlakinessDetectedPayload {
+    investigationId: string;
+    testId: string;
+    pattern: string;
+    failureRate: number;
+    confidence: number;
+}
+export interface RootCauseIdentifiedPayload {
+    investigationId: string;
+    testId: string;
+    rootCause: string;
+    confidence: number;
+    contributingFactors: string[];
+}
+export interface RelatedFailuresPredictedPayload {
+    investigationId: string;
+    testId: string;
+    relatedTests: string[];
+    similarityScores: number[];
+}
+export interface DefectInvestigationCompletedPayload {
+    investigationId: string;
+    testId: string;
+    isFlaky: boolean;
+    rootCause?: string;
+    relatedFailuresCount: number;
+    recommendationsCount: number;
+    confidence: number;
+    duration: number;
+}
+export declare const DefectInvestigationEvents: {
+    readonly DefectInvestigationStarted: "coordination.DefectInvestigationStarted";
+    readonly FlakinessDetected: "coordination.FlakinessDetected";
+    readonly RootCauseIdentified: "coordination.RootCauseIdentified";
+    readonly RelatedFailuresPredicted: "coordination.RelatedFailuresPredicted";
+    readonly DefectInvestigationCompleted: "coordination.DefectInvestigationCompleted";
+};
+export interface DefectInvestigationConfig {
+    /** Maximum time to spend on investigation (ms) */
+    maxDuration: number;
+    /** Minimum confidence threshold to report findings */
+    minConfidence: number;
+    /** Number of historical runs to check for flakiness */
+    flakinessHistorySize: number;
+    /** Failure rate threshold to consider test flaky */
+    flakinessThreshold: number;
+    /** Maximum related failures to predict */
+    maxRelatedFailures: number;
+    /** Enable deep root cause analysis */
+    enableDeepAnalysis: boolean;
+    /** Skip investigation for known flaky tests */
+    skipKnownFlaky: boolean;
+    /** Namespace for storing investigation data */
+    namespace: string;
+}
+/**
+ * DefectInvestigationProtocol orchestrates multi-agent investigation of test failures.
+ *
+ * Investigation workflow:
+ * 1. Check if test is known flaky (return early if yes)
+ * 2. Analyze root cause
+ * 3. Check for regression patterns
+ * 4. Predict related failures
+ * 5. Generate remediation suggestions
+ */
+export declare class DefectInvestigationProtocol {
+    private readonly eventBus;
+    private readonly memory;
+    private readonly config;
+    private readonly source;
+    constructor(eventBus: EventBus, memory: MemoryBackend, config?: Partial<DefectInvestigationConfig>);
+    /**
+     * Execute the full defect investigation protocol
+     */
+    execute(testFailure: TestFailure): Promise<Result<DefectInvestigationResult, Error>>;
+    /**
+     * Check if the test failure is due to flakiness
+     */
+    checkFlakiness(investigationId: string, testFailure: TestFailure): Promise<FlakyTestAnalysis>;
+    /**
+     * Analyze root cause of the test failure
+     */
+    analyzeRootCause(investigationId: string, testFailure: TestFailure): Promise<RootCauseAnalysis | null>;
+    /**
+     * Predict tests that may have related failures
+     */
+    predictRelatedFailures(investigationId: string, testFailure: TestFailure, rootCause: RootCauseAnalysis | null): Promise<RelatedFailure[]>;
+    /**
+     * Generate fix recommendations based on investigation findings
+     */
+    suggestFixes(testFailure: TestFailure, flakyAnalysis: FlakyTestAnalysis, rootCause: RootCauseAnalysis | null, regressionAnalysis: RegressionRisk | null, relatedFailures: RelatedFailure[]): DefectRecommendation[];
+    /**
+     * Update defect patterns for learning from this investigation
+     */
+    updateDefectPatterns(result: DefectInvestigationResult): Promise<void>;
+    private publishEvent;
+    private completeInvestigation;
+    private buildEarlyFlakyResult;
+    private detectFlakinessPattern;
+    private calculateFlakinessConfidence;
+    private getFlakyRecommendation;
+    private extractSymptoms;
+    private performRootCauseAnalysis;
+    private getRootCauseRecommendations;
+    private analyzeRegression;
+    private getCoverageContext;
+    private getImpactAnalysis;
+    private findTestsInSameFile;
+    private findTestsWithSimilarErrors;
+    private findDependentTests;
+    private createFlakyRecommendation;
+    private createRootCauseRecommendations;
+    private calculateOverallConfidence;
+    private riskToSeverity;
+    private average;
+}
+//# sourceMappingURL=defect-investigation.d.ts.map

package/dist/coordination/protocols/defect-investigation.d.ts.map

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