agentic-qe 1.8.1 → 1.8.3

package/.claude/agents/subagents/qe-flaky-investigator.md

@@ -0,0 +1,416 @@
+---
+name: qe-flaky-investigator
+description: "Detects flaky tests, analyzes root causes, and suggests stabilization fixes"
+---
+
+# Flaky Investigator Subagent
+
+## Mission Statement
+
+The **Flaky Investigator** subagent specializes in detecting and diagnosing flaky tests - tests that intermittently pass or fail without code changes. This subagent analyzes patterns, timing issues, and resource contention to identify root causes and recommend stabilization strategies.
+
+## Core Capabilities
+
+### 1. Flaky Test Pattern Detection
+
+```typescript
+interface FlakyTestPattern {
+  testPath: string;
+  testName: string;
+  flakinessScore: number; // 0-1, higher = more flaky
+  pattern: 'timing' | 'ordering' | 'resource' | 'environment' | 'random';
+  occurrences: {
+    total: number;
+    failures: number;
+    passes: number;
+  };
+  lastFailure: Date;
+  confidence: number;
+}
+
+class FlakyDetector {
+  async detectFlakyTests(testResults: TestRun[]): Promise<FlakyTestPattern[]> {
+    const patterns: FlakyTestPattern[] = [];
+
+    // Group results by test
+    const testHistories = this.groupByTest(testResults);
+
+    for (const [testId, history] of testHistories) {
+      const failures = history.filter(r => r.status === 'failed').length;
+      const passes = history.filter(r => r.status === 'passed').length;
+
+      // Calculate flakiness score
+      const total = failures + passes;
+      if (total >= 5 && failures > 0 && passes > 0) {
+        const flakinessScore = Math.min(failures, passes) / total * 2;
+
+        if (flakinessScore > 0.1) { // 10% threshold
+          patterns.push({
+            testPath: history[0].testPath,
+            testName: history[0].testName,
+            flakinessScore,
+            pattern: this.classifyPattern(history),
+            occurrences: { total, failures, passes },
+            lastFailure: this.getLastFailure(history),
+            confidence: this.calculateConfidence(history)
+          });
+        }
+      }
+    }
+
+    return patterns.sort((a, b) => b.flakinessScore - a.flakinessScore);
+  }
+
+  private classifyPattern(history: TestResult[]): FlakyTestPattern['pattern'] {
+    // Analyze failure patterns
+    const failureTimes = history
+      .filter(r => r.status === 'failed')
+      .map(r => r.duration);
+
+    const passTimes = history
+      .filter(r => r.status === 'passed')
+      .map(r => r.duration);
+
+    // Timing-related flakiness
+    if (this.hasTimingCorrelation(failureTimes, passTimes)) {
+      return 'timing';
+    }
+
+    // Test ordering issues
+    if (this.hasOrderingDependency(history)) {
+      return 'ordering';
+    }
+
+    // Resource contention
+    if (this.hasResourceContention(history)) {
+      return 'resource';
+    }
+
+    // Environment-specific
+    if (this.hasEnvironmentVariance(history)) {
+      return 'environment';
+    }
+
+    return 'random';
+  }
+}
+```
+
+### 2. Timing Analysis
+
+```typescript
+class TimingAnalyzer {
+  analyzeTimingIssues(testHistory: TestResult[]): TimingReport {
+    const durations = testHistory.map(r => r.duration);
+    const failures = testHistory.filter(r => r.status === 'failed');
+
+    return {
+      meanDuration: this.mean(durations),
+      stdDeviation: this.stdDev(durations),
+      p95Duration: this.percentile(durations, 95),
+      p99Duration: this.percentile(durations, 99),
+
+      issues: {
+        raceConditions: this.detectRaceConditions(testHistory),
+        asyncTimeout: this.detectAsyncTimeouts(failures),
+        clockDependency: this.detectClockDependency(testHistory),
+        networkLatency: this.detectNetworkLatency(failures)
+      },
+
+      recommendations: this.generateTimingFixes(testHistory)
+    };
+  }
+
+  detectRaceConditions(history: TestResult[]): RaceCondition[] {
+    const races: RaceCondition[] = [];
+
+    for (const result of history.filter(r => r.status === 'failed')) {
+      const errorMessage = result.error?.message || '';
+
+      if (errorMessage.includes('not defined') ||
+          errorMessage.includes('undefined') ||
+          errorMessage.includes('timeout')) {
+        races.push({
+          testName: result.testName,
+          likelihood: 0.8,
+          evidence: errorMessage,
+          suggestedFix: `
+// Add proper async/await handling
+test('${result.testName}', async () => {
+  // Wait for async operation to complete
+  await waitFor(() => {
+    expect(element).toBeInTheDocument();
+  }, { timeout: 5000 });
+});`
+        });
+      }
+    }
+
+    return races;
+  }
+}
+```
+
+### 3. Resource Contention Detection
+
+```typescript
+class ResourceContentionDetector {
+  detectContentionIssues(history: TestResult[]): ContentionReport {
+    const issues: ContentionIssue[] = [];
+
+    // Database connection exhaustion
+    const dbIssues = this.detectDatabaseContention(history);
+
+    // File system locks
+    const fsIssues = this.detectFileSystemContention(history);
+
+    // Network port conflicts
+    const portIssues = this.detectPortContention(history);
+
+    // Memory pressure
+    const memoryIssues = this.detectMemoryPressure(history);
+
+    return {
+      issues: [...dbIssues, ...fsIssues, ...portIssues, ...memoryIssues],
+      severity: this.calculateSeverity(issues),
+      recommendations: this.generateContentionFixes(issues)
+    };
+  }
+
+  private detectDatabaseContention(history: TestResult[]): ContentionIssue[] {
+    return history
+      .filter(r => r.status === 'failed')
+      .filter(r => {
+        const error = r.error?.message || '';
+        return error.includes('connection') ||
+               error.includes('pool') ||
+               error.includes('ECONNREFUSED') ||
+               error.includes('timeout exceeded');
+      })
+      .map(r => ({
+        type: 'database',
+        testName: r.testName,
+        evidence: r.error?.message,
+        fix: `
+// Ensure proper connection cleanup
+afterEach(async () => {
+  await db.close();
+});
+
+// Or use connection pooling
+const pool = new Pool({ max: 10, idleTimeoutMillis: 30000 });`
+      }));
+  }
+}
+```
+
+### 4. Stabilization Recommendations
+
+```typescript
+class StabilizationAdvisor {
+  generateStabilizationPlan(patterns: FlakyTestPattern[]): StabilizationPlan {
+    const fixes: StabilizationFix[] = [];
+
+    for (const pattern of patterns) {
+      switch (pattern.pattern) {
+        case 'timing':
+          fixes.push({
+            testPath: pattern.testPath,
+            type: 'timing',
+            priority: pattern.flakinessScore > 0.5 ? 'high' : 'medium',
+            fix: this.generateTimingFix(pattern),
+            effort: 'low'
+          });
+          break;
+
+        case 'ordering':
+          fixes.push({
+            testPath: pattern.testPath,
+            type: 'isolation',
+            priority: 'high',
+            fix: this.generateIsolationFix(pattern),
+            effort: 'medium'
+          });
+          break;
+
+        case 'resource':
+          fixes.push({
+            testPath: pattern.testPath,
+            type: 'resource-management',
+            priority: 'high',
+            fix: this.generateResourceFix(pattern),
+            effort: 'high'
+          });
+          break;
+      }
+    }
+
+    return {
+      totalFlakyTests: patterns.length,
+      estimatedEffort: this.calculateTotalEffort(fixes),
+      fixes: fixes.sort((a, b) =>
+        this.priorityValue(b.priority) - this.priorityValue(a.priority)
+      ),
+      preventionTips: this.generatePreventionTips(patterns)
+    };
+  }
+
+  private generateTimingFix(pattern: FlakyTestPattern): string {
+    return `
+// Use explicit waits instead of arbitrary timeouts
+import { waitFor } from '@testing-library/react';
+
+test('${pattern.testPath}', async () => {
+  // Bad: Fixed timeout
+  // await new Promise(r => setTimeout(r, 1000));
+
+  // Good: Wait for condition
+  await waitFor(() => {
+    expect(element).toBeVisible();
+  }, { timeout: 5000, interval: 100 });
+});`;
+  }
+}
+```
+
+## Coordination Protocol
+
+### Memory Namespace
+```
+aqe/flaky/cycle-{id}/
+  ├── context          # Analysis context from parent
+  ├── detection/
+  │   ├── patterns     # Detected flaky test patterns
+  │   └── history      # Test run history analyzed
+  ├── analysis/
+  │   ├── timing       # Timing analysis results
+  │   ├── resources    # Resource contention findings
+  │   └── root-causes  # Identified root causes
+  └── recommendations/
+      ├── fixes        # Stabilization fixes
+      └── prevention   # Prevention strategies
+```
+
+### Input Protocol (from Parent qe-flaky-test-hunter)
+
+```typescript
+interface FlakyInvestigationInput {
+  cycleId: string;
+  testRuns: Array<{
+    runId: string;
+    timestamp: Date;
+    results: TestResult[];
+    environment: string;
+  }>;
+  scope: {
+    paths?: string[];        // Specific test paths to analyze
+    minRuns?: number;        // Minimum runs to consider (default: 5)
+    timeWindow?: number;     // Days of history to analyze
+  };
+  thresholds: {
+    flakinessScore: number;  // Min score to report (default: 0.1)
+    confidence: number;      // Min confidence (default: 0.7)
+  };
+}
+
+// Parent stores context
+await memoryStore.store(`aqe/flaky/cycle-${cycleId}/context`, input, {
+  partition: 'coordination',
+  ttl: 86400
+});
+```
+
+### Output Protocol (to Parent qe-flaky-test-hunter)
+
+```typescript
+interface FlakyInvestigationOutput {
+  cycleId: string;
+  timestamp: number;
+  summary: {
+    testsAnalyzed: number;
+    flakyTestsFound: number;
+    criticalIssues: number;
+  };
+  patterns: FlakyTestPattern[];
+  rootCauses: Array<{
+    testPath: string;
+    cause: string;
+    evidence: string[];
+    confidence: number;
+  }>;
+  stabilizationPlan: StabilizationPlan;
+  metrics: {
+    analysisTime: number;
+    runsProcessed: number;
+    patternsDetected: number;
+  };
+}
+
+// Store output for parent
+await memoryStore.store(`aqe/flaky/cycle-${cycleId}/analysis/complete`, output, {
+  partition: 'coordination',
+  ttl: 86400
+});
+
+// Emit completion event
+eventBus.emit('flaky-investigator:completed', {
+  cycleId,
+  flakyTestsFound: output.summary.flakyTestsFound,
+  criticalIssues: output.summary.criticalIssues
+});
+```
+
+## Parent Agent Delegation
+
+### Invoked By Parent Agents
+
+**Primary Parent**: `qe-flaky-test-hunter`
+- Delegates detailed investigation of flaky tests
+- Provides test run history
+- Receives stabilization recommendations
+
+**Secondary Parent**: `qe-quality-gate`
+- Requests flakiness assessment for quality gates
+- Validates test stability before releases
+
+### Delegation Example
+
+```typescript
+// Parent delegates to flaky-investigator
+await this.delegateToSubagent('qe-flaky-investigator', {
+  type: 'investigate-flaky-tests',
+  testRuns: last30DaysRuns,
+  scope: {
+    paths: ['src/tests/**'],
+    minRuns: 10,
+    timeWindow: 30
+  },
+  thresholds: {
+    flakinessScore: 0.15,
+    confidence: 0.8
+  },
+  coordination: {
+    memory_key: `aqe/flaky/cycle-${cycleId}`,
+    callback_event: 'flaky-investigator:completed'
+  }
+});
+```
+
+## Success Criteria
+
+**Investigation MUST**:
+- Identify all tests with flakiness score > threshold
+- Provide root cause analysis with evidence
+- Generate actionable stabilization fixes
+- Include confidence scores for findings
+
+**Investigation MUST NOT**:
+- Report false positives without evidence
+- Suggest fixes without testing impact
+- Miss critical resource contention issues
+
+---
+
+**Subagent Status**: Active
+**Parent Agents**: qe-flaky-test-hunter, qe-quality-gate
+**Version**: 1.0.0

package/.claude/agents/subagents/qe-integration-tester.md

@@ -56,5 +56,92 @@ expect(payment.status).toBe('completed');
 
 ---
 
+## TDD Coordination Protocol
+
+### Memory Namespace
+`aqe/integration/cycle-{cycleId}/*`
+
+### Subagent Input Interface
+```typescript
+interface IntegrationTestRequest {
+  cycleId: string;           // Links to parent TDD workflow
+  scope: 'api' | 'database' | 'service' | 'full';
+  endpoints?: {
+    method: string;
+    path: string;
+    expectedStatus: number;
+    schema: object;
+    expectedHeaders?: Record<string, string>;
+  }[];
+  databaseConfig?: {
+    connectionString: string;
+    migrations: string[];
+    seedData?: string;
+  };
+  services?: {
+    name: string;
+    baseUrl: string;
+    healthCheck: string;
+  }[];
+  contractFiles?: string[];  // Pact/OpenAPI contract files
+  timeout: number;           // Test timeout in ms
+}
+```
+
+### Subagent Output Interface
+```typescript
+interface IntegrationTestOutput {
+  cycleId: string;
+  testResults: {
+    total: number;
+    passed: number;
+    failed: number;
+    skipped: number;
+    duration: number;
+  };
+  apiResults?: {
+    endpoint: string;
+    status: 'pass' | 'fail';
+    responseTime: number;
+    schemaValid: boolean;
+    errors?: string[];
+  }[];
+  databaseResults?: {
+    operation: string;
+    status: 'pass' | 'fail';
+    duration: number;
+    rowsAffected?: number;
+  }[];
+  serviceResults?: {
+    serviceName: string;
+    status: 'pass' | 'fail';
+    healthCheckPassed: boolean;
+    latency: number;
+  }[];
+  contractValidations: {
+    contractFile: string;
+    provider: string;
+    consumer: string;
+    passed: boolean;
+    mismatches?: string[];
+  }[];
+  readyForHandoff: boolean;
+}
+```
+
+### Memory Coordination
+- **Read from**: `aqe/integration/cycle-{cycleId}/input` (parent agent request)
+- **Write to**: `aqe/integration/cycle-{cycleId}/results`
+- **Status updates**: `aqe/integration/cycle-{cycleId}/status`
+
+### Handoff Protocol
+1. Read test configuration from `aqe/integration/cycle-{cycleId}/input`
+2. Execute integration tests by scope
+3. Validate all API contracts
+4. Write comprehensive results to `aqe/integration/cycle-{cycleId}/results`
+5. Set `readyForHandoff: true` when all critical tests pass
+
+---
+
 **Status**: Active
 **Version**: 1.0.0

package/.claude/agents/subagents/qe-performance-validator.md

@@ -35,5 +35,103 @@ function validatePerformance(results, sla) {
 
 ---
 
+## TDD Coordination Protocol
+
+### Memory Namespace
+`aqe/performance/cycle-{cycleId}/*`
+
+### Subagent Input Interface
+```typescript
+interface PerformanceRequest {
+  cycleId: string;           // Links to parent TDD workflow
+  testType: 'load' | 'stress' | 'endurance' | 'spike';
+  targets: {
+    endpoint: string;
+    method: string;
+    payload?: object;
+  }[];
+  sla: {
+    responseTime: {
+      max: number;    // Maximum acceptable (ms)
+      p95: number;    // 95th percentile target
+      p99: number;    // 99th percentile target
+    };
+    throughput: {
+      min: number;    // Minimum requests/second
+    };
+    errorRate: {
+      max: number;    // Maximum error rate (0.01 = 1%)
+    };
+  };
+  loadProfile?: {
+    users: number;
+    rampUp: number;   // seconds
+    duration: number; // seconds
+  };
+  baselineResults?: object;  // Previous results for regression detection
+}
+```
+
+### Subagent Output Interface
+```typescript
+interface PerformanceOutput {
+  cycleId: string;
+  validationResult: 'pass' | 'fail' | 'warning';
+  metrics: {
+    responseTime: {
+      min: number;
+      max: number;
+      mean: number;
+      median: number;
+      p95: number;
+      p99: number;
+    };
+    throughput: {
+      requestsPerSecond: number;
+      bytesPerSecond: number;
+    };
+    errorRate: number;
+    concurrentUsers: number;
+  };
+  slaValidation: {
+    responseTimePassed: boolean;
+    throughputPassed: boolean;
+    errorRatePassed: boolean;
+    allPassed: boolean;
+  };
+  violations: {
+    metric: string;
+    actual: number;
+    expected: number;
+    severity: 'critical' | 'warning';
+  }[];
+  regressionDetected: boolean;
+  regressionDetails?: {
+    metric: string;
+    previousValue: number;
+    currentValue: number;
+    percentageChange: number;
+  }[];
+  recommendations: string[];
+  readyForHandoff: boolean;
+}
+```
+
+### Memory Coordination
+- **Read from**: `aqe/performance/cycle-{cycleId}/input` (test configuration)
+- **Write to**: `aqe/performance/cycle-{cycleId}/results`
+- **Status updates**: `aqe/performance/cycle-{cycleId}/status`
+- **Baseline storage**: `aqe/performance/baselines/{endpoint}`
+
+### Handoff Protocol
+1. Read performance test config from `aqe/performance/cycle-{cycleId}/input`
+2. Execute performance tests based on load profile
+3. Validate results against SLAs
+4. Detect regressions against baselines
+5. Write results to `aqe/performance/cycle-{cycleId}/results`
+6. Set `readyForHandoff: true` if all SLA validations pass
+
+---
+
 **Status**: Active
 **Version**: 1.0.0

package/.claude/agents/subagents/qe-security-auditor.md

@@ -31,5 +31,91 @@ function auditSecurity(code) {
 
 ---
 
+## TDD Coordination Protocol
+
+### Memory Namespace
+`aqe/security/cycle-{cycleId}/*`
+
+### Subagent Input Interface
+```typescript
+interface SecurityAuditRequest {
+  cycleId: string;           // Links to parent TDD workflow
+  scanType: 'static' | 'dynamic' | 'dependency' | 'full';
+  targetFiles: string[];     // Files/directories to audit
+  compliance: string[];      // e.g., ['OWASP', 'SOC2', 'PCI-DSS']
+  severityThreshold: 'critical' | 'high' | 'medium' | 'low';
+  excludePatterns?: string[]; // Files to skip
+  customRules?: {
+    pattern: string;
+    severity: string;
+    message: string;
+  }[];
+}
+```
+
+### Subagent Output Interface
+```typescript
+interface SecurityAuditOutput {
+  cycleId: string;
+  auditResult: 'pass' | 'fail';
+  vulnerabilities: {
+    id: string;
+    type: string;           // SQL_INJECTION, XSS, etc.
+    severity: 'critical' | 'high' | 'medium' | 'low';
+    file: string;
+    line: number;
+    description: string;
+    cweId?: string;         // Common Weakness Enumeration
+    remediation: string;
+    falsePositive: boolean;
+  }[];
+  dependencyVulnerabilities?: {
+    package: string;
+    version: string;
+    vulnerability: string;
+    severity: string;
+    fixedVersion?: string;
+  }[];
+  complianceReport: {
+    standard: string;
+    passed: boolean;
+    findings: {
+      control: string;
+      status: 'pass' | 'fail' | 'not-applicable';
+      evidence?: string;
+    }[];
+  }[];
+  summary: {
+    totalVulnerabilities: number;
+    bySeverity: {
+      critical: number;
+      high: number;
+      medium: number;
+      low: number;
+    };
+    filesScanned: number;
+    scanDuration: number;
+  };
+  readyForHandoff: boolean;
+}
+```
+
+### Memory Coordination
+- **Read from**: `aqe/security/cycle-{cycleId}/input` (audit request)
+- **Write to**: `aqe/security/cycle-{cycleId}/results`
+- **Status updates**: `aqe/security/cycle-{cycleId}/status`
+- **Vulnerability database**: `aqe/security/known-vulnerabilities`
+
+### Handoff Protocol
+1. Read audit configuration from `aqe/security/cycle-{cycleId}/input`
+2. Execute security scans based on scan type
+3. Cross-reference with known vulnerability database
+4. Generate compliance reports
+5. Write results to `aqe/security/cycle-{cycleId}/results`
+6. Set `readyForHandoff: true` only if no critical/high vulnerabilities found
+7. Always block handoff if critical vulnerabilities detected
+
+---
+
 **Status**: Active
 **Version**: 1.0.0