agentic-qe 1.7.0 → 1.8.0

package/dist/agents/examples/batchAnalyze.js

@@ -0,0 +1,259 @@
+"use strict";
+/**
+ * Batch Coverage Analysis Example
+ *
+ * Demonstrates using the BatchOperationManager to analyze coverage
+ * for multiple modules/packages in parallel.
+ *
+ * Performance Improvement:
+ * - Sequential: 10 modules × 1s = 10s
+ * - Batched: max(1s) with 5 concurrent = ~2s
+ * - Speedup: 5x faster
+ *
+ * @module agents/examples/batchAnalyze
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CoverageMonitor = void 0;
+exports.analyzeCoverageForModules = analyzeCoverageForModules;
+exports.analyzeCoverageWithPriority = analyzeCoverageWithPriority;
+exports.analyzeCoverageDelta = analyzeCoverageDelta;
+const batch_operations_1 = require("../../utils/batch-operations");
+/**
+ * Batch analyze coverage for multiple modules
+ *
+ * @example
+ * ```typescript
+ * const modules = [
+ *   { moduleName: 'auth', coverageDataPath: 'coverage/auth/lcov.info' },
+ *   { moduleName: 'api', coverageDataPath: 'coverage/api/lcov.info' },
+ *   { moduleName: 'ui', coverageDataPath: 'coverage/ui/lcov.info' }
+ * ];
+ *
+ * const result = await analyzeCoverageForModules(modules, {
+ *   threshold: 80,
+ *   maxConcurrent: 5,
+ *   includeDetails: true,
+ *   onProgress: (completed, total, module) => {
+ *     console.log(`Analyzed ${completed}/${total}: ${module}`);
+ *   }
+ * });
+ *
+ * console.log(`Analyzed ${result.results.length} modules`);
+ * console.log(`Success rate: ${result.successRate * 100}%`);
+ * ```
+ */
+async function analyzeCoverageForModules(modules, config) {
+    const batchManager = new batch_operations_1.BatchOperationManager();
+    const { threshold = 80, maxConcurrent = 5, timeout = 60000, retryOnError = true, includeDetails = false, onProgress, } = config;
+    // Handler function for single module analysis
+    const analyzeModule = async (input) => {
+        const startTime = Date.now();
+        // This would call your actual coverage analysis service
+        const coverage = await analyzeCoverageData({
+            moduleName: input.moduleName,
+            coverageDataPath: input.coverageDataPath,
+            threshold: input.config?.threshold || threshold,
+            includeDetails,
+        });
+        // Find gaps (files below threshold)
+        const gaps = findCoverageGaps(coverage, threshold);
+        // Generate recommendations
+        const recommendations = includeDetails
+            ? generateRecommendations(gaps)
+            : undefined;
+        const analysisTime = Date.now() - startTime;
+        return {
+            moduleName: input.moduleName,
+            coverage: coverage.summary,
+            gaps,
+            filesAnalyzed: coverage.files.length,
+            analysisTime,
+            recommendations,
+        };
+    };
+    // Execute batch analysis
+    return batchManager.batchExecute(modules, analyzeModule, {
+        maxConcurrent,
+        timeout,
+        retryOnError,
+        maxRetries: 3,
+        failFast: false,
+        onProgress: (completed, total) => {
+            const currentModule = modules[completed - 1]?.moduleName || 'unknown';
+            onProgress?.(completed, total, currentModule);
+        },
+    });
+}
+/**
+ * Placeholder for actual coverage analysis implementation
+ */
+async function analyzeCoverageData(params) {
+    // This would integrate with your CoverageAnalyzerAgent
+    throw new Error('Not implemented - integrate with CoverageAnalyzerAgent');
+}
+/**
+ * Find coverage gaps below threshold
+ */
+function findCoverageGaps(coverage, threshold) {
+    return coverage.files
+        .filter((file) => file.coverage < threshold)
+        .map((file) => {
+        const priority = file.coverage < threshold - 20
+            ? 'high'
+            : file.coverage < threshold - 10
+                ? 'medium'
+                : 'low';
+        return {
+            filePath: file.path,
+            coverage: file.coverage,
+            uncoveredLines: [], // Would be populated from actual coverage data
+            priority,
+        };
+    })
+        .sort((a, b) => a.coverage - b.coverage); // Worst coverage first
+}
+/**
+ * Generate improvement recommendations
+ */
+function generateRecommendations(gaps) {
+    const recommendations = [];
+    if (gaps.length === 0) {
+        return ['All files meet coverage threshold'];
+    }
+    const highPriorityGaps = gaps.filter((g) => g.priority === 'high');
+    if (highPriorityGaps.length > 0) {
+        recommendations.push(`Focus on ${highPriorityGaps.length} high-priority files with <60% coverage`);
+    }
+    const avgCoverage = gaps.reduce((sum, g) => sum + g.coverage, 0) / gaps.length;
+    if (avgCoverage < 50) {
+        recommendations.push('Consider implementing integration tests to improve overall coverage');
+    }
+    if (gaps.length > 10) {
+        recommendations.push('Use batch test generation to address multiple gaps simultaneously');
+    }
+    return recommendations;
+}
+/**
+ * Batch analyze coverage with gap prioritization
+ *
+ * Analyzes all modules and returns a prioritized list of files to test.
+ *
+ * @example
+ * ```typescript
+ * const result = await analyzeCoverageWithPriority(modules, {
+ *   threshold: 80,
+ *   topN: 20 // Return top 20 gaps
+ * });
+ *
+ * console.log('Top coverage gaps to address:');
+ * result.prioritizedGaps.forEach((gap, idx) => {
+ *   console.log(`${idx + 1}. ${gap.filePath} (${gap.coverage}%)`);
+ * });
+ * ```
+ */
+async function analyzeCoverageWithPriority(modules, config) {
+    const result = await analyzeCoverageForModules(modules, config);
+    // Aggregate all gaps
+    const allGaps = result.results.flatMap((r) => r.gaps);
+    // Sort by priority and coverage
+    const prioritizedGaps = allGaps
+        .sort((a, b) => {
+        const priorityOrder = { high: 0, medium: 1, low: 2 };
+        const priorityDiff = priorityOrder[a.priority] - priorityOrder[b.priority];
+        return priorityDiff !== 0 ? priorityDiff : a.coverage - b.coverage;
+    })
+        .slice(0, config.topN || 50);
+    // Calculate overall coverage
+    const totalCoverage = result.results.reduce((sum, r) => ({
+        lines: sum.lines + r.coverage.lines,
+        branches: sum.branches + r.coverage.branches,
+        functions: sum.functions + r.coverage.functions,
+        statements: sum.statements + r.coverage.statements,
+    }), { lines: 0, branches: 0, functions: 0, statements: 0 });
+    const count = result.results.length || 1;
+    const overallCoverage = {
+        lines: totalCoverage.lines / count,
+        branches: totalCoverage.branches / count,
+        functions: totalCoverage.functions / count,
+        statements: totalCoverage.statements / count,
+    };
+    return {
+        ...result,
+        prioritizedGaps,
+        overallCoverage,
+    };
+}
+/**
+ * Continuous coverage monitoring with batch analysis
+ *
+ * Runs coverage analysis at intervals and tracks trends over time.
+ *
+ * @example
+ * ```typescript
+ * const monitor = new CoverageMonitor(modules, {
+ *   interval: 60000, // 1 minute
+ *   threshold: 80,
+ *   onCoverageChange: (current, previous) => {
+ *     console.log(`Coverage changed: ${previous}% -> ${current}%`);
+ *   }
+ * });
+ *
+ * await monitor.start();
+ * ```
+ */
+class CoverageMonitor {
+    constructor(modules, config) {
+        this.modules = modules;
+        this.config = config;
+    }
+    async start() {
+        const interval = this.config.interval || 60000;
+        // Initial analysis
+        await this.runAnalysis();
+        // Schedule periodic analysis
+        this.intervalId = setInterval(() => {
+            this.runAnalysis();
+        }, interval);
+    }
+    stop() {
+        if (this.intervalId) {
+            clearInterval(this.intervalId);
+            this.intervalId = undefined;
+        }
+    }
+    async runAnalysis() {
+        const result = await analyzeCoverageWithPriority(this.modules, this.config);
+        const currentCoverage = result.overallCoverage.lines;
+        if (this.previousCoverage !== undefined &&
+            this.config.onCoverageChange) {
+            this.config.onCoverageChange(currentCoverage, this.previousCoverage);
+        }
+        this.previousCoverage = currentCoverage;
+    }
+}
+exports.CoverageMonitor = CoverageMonitor;
+/**
+ * Analyze coverage delta between two points in time
+ *
+ * Useful for PR validation to ensure coverage doesn't decrease.
+ *
+ * @example
+ * ```typescript
+ * const delta = await analyzeCoverageDelta(
+ *   modules,
+ *   'baseline-coverage.json',
+ *   'current-coverage.json',
+ *   { threshold: 80 }
+ * );
+ *
+ * if (delta.overallChange < 0) {
+ *   console.error('Coverage decreased!');
+ *   process.exit(1);
+ * }
+ * ```
+ */
+async function analyzeCoverageDelta(modules, baselinePath, currentPath, config) {
+    // This would load baseline and current coverage, then compare
+    throw new Error('Not implemented - integrate with coverage comparison logic');
+}
+//# sourceMappingURL=batchAnalyze.js.map

package/dist/agents/examples/batchAnalyze.js.map

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

package/dist/agents/examples/batchGenerate.d.ts

@@ -0,0 +1,153 @@
+/**
+ * Batch Test Generation Example
+ *
+ * Demonstrates using the BatchOperationManager to generate tests
+ * for multiple files in parallel with automatic retry and timeout handling.
+ *
+ * Performance Improvement:
+ * - Sequential: 3 files × 2s = 6s
+ * - Batched: max(2s) with 5 concurrent = ~2s
+ * - Speedup: 3x faster
+ *
+ * @module agents/examples/batchGenerate
+ */
+import { type BatchResult } from '../../utils/batch-operations';
+import type { TestGenerationRequest, TestGenerationResult } from '../TestGeneratorAgent';
+/**
+ * Configuration for batch test generation
+ */
+export interface BatchGenerateConfig {
+    /**
+     * Test framework to use
+     */
+    framework: 'jest' | 'vitest' | 'mocha';
+    /**
+     * Target coverage percentage
+     */
+    targetCoverage?: number;
+    /**
+     * Maximum concurrent file processing
+     * @default 5
+     */
+    maxConcurrent?: number;
+    /**
+     * Timeout per file in milliseconds
+     * @default 60000 (60 seconds)
+     */
+    timeout?: number;
+    /**
+     * Enable retry on failure
+     * @default true
+     */
+    retryOnError?: boolean;
+    /**
+     * Progress callback
+     */
+    onProgress?: (completed: number, total: number, file: string) => void;
+}
+/**
+ * Single file test generation input
+ */
+export interface FileGenerationInput {
+    /**
+     * Path to source file
+     */
+    filePath: string;
+    /**
+     * File content (optional, will read if not provided)
+     */
+    content?: string;
+    /**
+     * Custom configuration for this file
+     */
+    config?: Partial<TestGenerationRequest>;
+}
+/**
+ * Result for a single file
+ */
+export interface FileGenerationResult {
+    /**
+     * Source file path
+     */
+    filePath: string;
+    /**
+     * Generated test file path
+     */
+    testFilePath: string;
+    /**
+     * Test generation result
+     */
+    result: TestGenerationResult;
+    /**
+     * Generation time in milliseconds
+     */
+    generationTime: number;
+}
+/**
+ * Batch test generation for multiple files
+ *
+ * @example
+ * ```typescript
+ * const files = [
+ *   { filePath: 'src/utils/parser.ts' },
+ *   { filePath: 'src/utils/validator.ts' },
+ *   { filePath: 'src/utils/formatter.ts' }
+ * ];
+ *
+ * const result = await generateTestsForFiles(files, {
+ *   framework: 'jest',
+ *   targetCoverage: 80,
+ *   maxConcurrent: 5,
+ *   onProgress: (completed, total, file) => {
+ *     console.log(`Progress: ${completed}/${total} - ${file}`);
+ *   }
+ * });
+ *
+ * console.log(`Generated ${result.results.length} test files`);
+ * console.log(`Success rate: ${result.successRate * 100}%`);
+ * console.log(`Total time: ${result.totalTime}ms`);
+ * ```
+ */
+export declare function generateTestsForFiles(files: FileGenerationInput[], config: BatchGenerateConfig): Promise<BatchResult<FileGenerationResult>>;
+/**
+ * Batch generate tests for an entire directory
+ *
+ * @example
+ * ```typescript
+ * const result = await generateTestsForDirectory('src/utils', {
+ *   framework: 'jest',
+ *   pattern: '**\/*.ts',
+ *   exclude: ['**\/*.test.ts', '**\/*.spec.ts'],
+ *   maxConcurrent: 5
+ * });
+ * ```
+ */
+export declare function generateTestsForDirectory(directory: string, config: BatchGenerateConfig & {
+    pattern?: string;
+    exclude?: string[];
+}): Promise<BatchResult<FileGenerationResult>>;
+/**
+ * Batch generate tests with intelligent prioritization
+ *
+ * Prioritizes files by:
+ * 1. Code complexity (higher first)
+ * 2. Current test coverage (lower first)
+ * 3. Change frequency (higher first)
+ *
+ * @example
+ * ```typescript
+ * const result = await generateTestsWithPriority(
+ *   [
+ *     { filePath: 'src/complex.ts', complexity: 15, coverage: 20 },
+ *     { filePath: 'src/simple.ts', complexity: 3, coverage: 80 },
+ *   ],
+ *   { framework: 'jest' }
+ * );
+ * ```
+ */
+export declare function generateTestsWithPriority(files: Array<FileGenerationInput & {
+    complexity?: number;
+    coverage?: number;
+    changeFrequency?: number;
+}>, config: BatchGenerateConfig): Promise<BatchResult<FileGenerationResult>>;
+//# sourceMappingURL=batchGenerate.d.ts.map

package/dist/agents/examples/batchGenerate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batchGenerate.d.ts","sourceRoot":"","sources":["../../../src/agents/examples/batchGenerate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAyB,KAAK,WAAW,EAAE,MAAM,8BAA8B,CAAC;AACvF,OAAO,KAAK,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAEzF;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,SAAS,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;IAEvC;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB;;OAEG;IACH,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACvE;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC,CAAC;CACzC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,MAAM,EAAE,oBAAoB,CAAC;IAE7B;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,mBAAmB,EAAE,EAC5B,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,WAAW,CAAC,oBAAoB,CAAC,CAAC,CAkD5C;AAyBD;;;;;;;;;;;;GAYG;AACH,wBAAsB,yBAAyB,CAC7C,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,mBAAmB,GAAG;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB,GACA,OAAO,CAAC,WAAW,CAAC,oBAAoB,CAAC,CAAC,CAO5C;AAeD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,KAAK,CACV,mBAAmB,GAAG;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CACF,EACD,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,WAAW,CAAC,oBAAoB,CAAC,CAAC,CAS5C"}

package/dist/agents/examples/batchGenerate.js

@@ -0,0 +1,166 @@
+"use strict";
+/**
+ * Batch Test Generation Example
+ *
+ * Demonstrates using the BatchOperationManager to generate tests
+ * for multiple files in parallel with automatic retry and timeout handling.
+ *
+ * Performance Improvement:
+ * - Sequential: 3 files × 2s = 6s
+ * - Batched: max(2s) with 5 concurrent = ~2s
+ * - Speedup: 3x faster
+ *
+ * @module agents/examples/batchGenerate
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateTestsForFiles = generateTestsForFiles;
+exports.generateTestsForDirectory = generateTestsForDirectory;
+exports.generateTestsWithPriority = generateTestsWithPriority;
+const batch_operations_1 = require("../../utils/batch-operations");
+/**
+ * Batch test generation for multiple files
+ *
+ * @example
+ * ```typescript
+ * const files = [
+ *   { filePath: 'src/utils/parser.ts' },
+ *   { filePath: 'src/utils/validator.ts' },
+ *   { filePath: 'src/utils/formatter.ts' }
+ * ];
+ *
+ * const result = await generateTestsForFiles(files, {
+ *   framework: 'jest',
+ *   targetCoverage: 80,
+ *   maxConcurrent: 5,
+ *   onProgress: (completed, total, file) => {
+ *     console.log(`Progress: ${completed}/${total} - ${file}`);
+ *   }
+ * });
+ *
+ * console.log(`Generated ${result.results.length} test files`);
+ * console.log(`Success rate: ${result.successRate * 100}%`);
+ * console.log(`Total time: ${result.totalTime}ms`);
+ * ```
+ */
+async function generateTestsForFiles(files, config) {
+    const batchManager = new batch_operations_1.BatchOperationManager();
+    const { framework, targetCoverage = 80, maxConcurrent = 5, timeout = 60000, retryOnError = true, onProgress, } = config;
+    // Handler function for single file generation
+    const generateForFile = async (input) => {
+        const startTime = Date.now();
+        // This would call your actual test generation service
+        // For now, this is a placeholder that shows the integration pattern
+        const result = await generateUnitTestsForFile({
+            filePath: input.filePath,
+            content: input.content,
+            framework,
+            targetCoverage,
+            ...input.config,
+        });
+        const generationTime = Date.now() - startTime;
+        return {
+            filePath: input.filePath,
+            testFilePath: getTestFilePath(input.filePath, framework),
+            result,
+            generationTime,
+        };
+    };
+    // Execute batch generation
+    return batchManager.batchExecute(files, generateForFile, {
+        maxConcurrent,
+        timeout,
+        retryOnError,
+        maxRetries: 3,
+        failFast: false,
+        onProgress: (completed, total) => {
+            const currentFile = files[completed - 1]?.filePath || 'unknown';
+            onProgress?.(completed, total, currentFile);
+        },
+    });
+}
+/**
+ * Placeholder for actual test generation implementation
+ * Replace this with your actual TestGeneratorAgent call
+ */
+async function generateUnitTestsForFile(params) {
+    // This would integrate with your TestGeneratorAgent
+    // For demonstration purposes only
+    throw new Error('Not implemented - integrate with TestGeneratorAgent');
+}
+/**
+ * Get test file path based on source file path
+ */
+function getTestFilePath(sourcePath, framework) {
+    const extension = framework === 'jest' || framework === 'vitest' ? '.test.ts' : '.spec.ts';
+    return sourcePath.replace(/\.(ts|js)$/, extension);
+}
+/**
+ * Batch generate tests for an entire directory
+ *
+ * @example
+ * ```typescript
+ * const result = await generateTestsForDirectory('src/utils', {
+ *   framework: 'jest',
+ *   pattern: '**\/*.ts',
+ *   exclude: ['**\/*.test.ts', '**\/*.spec.ts'],
+ *   maxConcurrent: 5
+ * });
+ * ```
+ */
+async function generateTestsForDirectory(directory, config) {
+    const { pattern = '**/*.ts', exclude = ['**/*.test.ts', '**/*.spec.ts'] } = config;
+    // Find all matching files (would use glob or similar)
+    const files = await findSourceFiles(directory, pattern, exclude);
+    return generateTestsForFiles(files, config);
+}
+/**
+ * Placeholder for file discovery
+ * Replace with actual glob implementation
+ */
+async function findSourceFiles(directory, pattern, exclude) {
+    // This would use glob or a similar file discovery mechanism
+    throw new Error('Not implemented - integrate with file system utilities');
+}
+/**
+ * Batch generate tests with intelligent prioritization
+ *
+ * Prioritizes files by:
+ * 1. Code complexity (higher first)
+ * 2. Current test coverage (lower first)
+ * 3. Change frequency (higher first)
+ *
+ * @example
+ * ```typescript
+ * const result = await generateTestsWithPriority(
+ *   [
+ *     { filePath: 'src/complex.ts', complexity: 15, coverage: 20 },
+ *     { filePath: 'src/simple.ts', complexity: 3, coverage: 80 },
+ *   ],
+ *   { framework: 'jest' }
+ * );
+ * ```
+ */
+async function generateTestsWithPriority(files, config) {
+    // Sort by priority score
+    const prioritized = [...files].sort((a, b) => {
+        const scoreA = calculatePriorityScore(a);
+        const scoreB = calculatePriorityScore(b);
+        return scoreB - scoreA; // Higher score first
+    });
+    return generateTestsForFiles(prioritized, config);
+}
+/**
+ * Calculate priority score for a file
+ * Higher score = higher priority
+ */
+function calculatePriorityScore(file) {
+    const complexity = file.complexity || 5;
+    const coverage = file.coverage || 50;
+    const changeFrequency = file.changeFrequency || 1;
+    // Normalize to 0-100 scale and weight
+    const complexityScore = Math.min(complexity * 5, 100) * 0.4;
+    const coverageScore = (100 - coverage) * 0.4; // Invert: lower coverage = higher priority
+    const changeScore = Math.min(changeFrequency * 10, 100) * 0.2;
+    return complexityScore + coverageScore + changeScore;
+}
+//# sourceMappingURL=batchGenerate.js.map

package/dist/agents/examples/batchGenerate.js.map

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