agentic-qe 3.7.7 → 3.7.9

package/dist/domains/test-generation/gates/test-quality-gate.js

@@ -0,0 +1,320 @@
+/**
+ * Test Quality Gate - Mock Detector & Mutation Detector
+ * Inspired by loki-mode Gates 8 & 9
+ *
+ * Validates generated test code quality by detecting:
+ * 1. No source imports - test never imports from the source file
+ * 2. Tautological assertions - expect(true).toBe(true), expect(x).toBe(x)
+ * 3. Empty test bodies - it('...', () => {}) with no assertions
+ * 4. Mirrored assertions - expected values copy-pasted from source literals
+ *
+ * All detection is regex-based, no LLM calls.
+ */
+const DEFAULT_CONFIG = {
+    checkSourceImports: true,
+    checkTautologicalAssertions: true,
+    checkEmptyTestBodies: true,
+    checkMirroredAssertions: true,
+    minPassScore: 60,
+};
+// ============================================================================
+// TestQualityGate
+// ============================================================================
+export class TestQualityGate {
+    config;
+    constructor(config) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * Validate generated test code quality.
+     *
+     * @param testCode - The generated test source code
+     * @param sourceFilePath - Path to the source file under test
+     * @param sourceCode - Optional source code content for mirrored assertion check
+     * @returns Gate result with pass/fail, issues, and score
+     */
+    validate(testCode, sourceFilePath, sourceCode) {
+        const issues = [];
+        if (this.config.checkSourceImports) {
+            issues.push(...this.detectMissingSourceImports(testCode, sourceFilePath));
+        }
+        if (this.config.checkTautologicalAssertions) {
+            issues.push(...this.detectTautologicalAssertions(testCode));
+        }
+        if (this.config.checkEmptyTestBodies) {
+            issues.push(...this.detectEmptyTestBodies(testCode));
+        }
+        if (this.config.checkMirroredAssertions && sourceCode) {
+            issues.push(...this.detectMirroredAssertions(testCode, sourceCode));
+        }
+        const score = this.calculateScore(issues);
+        const passed = score >= this.config.minPassScore;
+        return { passed, issues, score };
+    }
+    // ============================================================================
+    // Detection Methods
+    // ============================================================================
+    /**
+     * Check whether the test code imports from the source file.
+     * If no import/require statement references the source file basename, flag an error.
+     */
+    detectMissingSourceImports(testCode, sourceFilePath) {
+        // Extract basename without extension for matching
+        const parts = sourceFilePath.replace(/\\/g, '/').split('/');
+        const fileName = parts[parts.length - 1];
+        const baseName = fileName.replace(/\.(ts|js|tsx|jsx|mts|mjs|py)$/, '');
+        // Collect all import/require paths from the test code
+        const importPaths = [];
+        // ES import: import ... from '...'
+        const esImportRegex = /(?:import|from)\s+['"]([^'"]+)['"]/g;
+        let match;
+        while ((match = esImportRegex.exec(testCode)) !== null) {
+            importPaths.push(match[1]);
+        }
+        // CommonJS require: require('...')
+        const requireRegex = /require\s*\(\s*['"]([^'"]+)['"]\s*\)/g;
+        while ((match = requireRegex.exec(testCode)) !== null) {
+            importPaths.push(match[1]);
+        }
+        // Check if any import path references the source file
+        const hasSourceImport = importPaths.some((importPath) => {
+            const importBaseName = importPath
+                .replace(/\\/g, '/')
+                .split('/')
+                .pop()
+                ?.replace(/\.(ts|js|tsx|jsx|mts|mjs)$/, '')
+                ?.replace(/\.js$/, '');
+            return importBaseName === baseName;
+        });
+        if (!hasSourceImport && importPaths.length >= 0) {
+            return [
+                {
+                    type: 'no-source-import',
+                    severity: 'error',
+                    description: `Test does not import from source file "${baseName}". Tests that never reference the source under test are likely mock-only or dead code.`,
+                    suggestion: `Add an import statement that references the source module, e.g.: import { ... } from './${baseName}.js'`,
+                },
+            ];
+        }
+        return [];
+    }
+    /**
+     * Detect tautological assertions where the expected and actual values are identical.
+     * Examples: expect(true).toBe(true), expect(x).toBe(x), expect('a').toEqual('a')
+     */
+    detectTautologicalAssertions(testCode) {
+        const issues = [];
+        const lines = testCode.split('\n');
+        const matchers = ['toBe', 'toEqual', 'toStrictEqual'];
+        const matcherPattern = matchers.join('|');
+        // Pattern 1: Literal boolean/null/undefined on both sides
+        // expect(true).toBe(true), expect(false).toEqual(false), etc.
+        const literalPattern = new RegExp(`expect\\s*\\(\\s*(true|false|null|undefined)\\s*\\)\\s*\\.\\s*(?:${matcherPattern})\\s*\\(\\s*\\1\\s*\\)`);
+        // Pattern 2: Same numeric literal on both sides
+        // expect(1).toBe(1), expect(42).toEqual(42)
+        const numericPattern = new RegExp(`expect\\s*\\(\\s*(\\d+(?:\\.\\d+)?)\\s*\\)\\s*\\.\\s*(?:${matcherPattern})\\s*\\(\\s*\\1\\s*\\)`);
+        // Pattern 3: Same string literal on both sides (single or double quotes)
+        // expect('hello').toBe('hello'), expect("foo").toEqual("foo")
+        const singleQuotePattern = new RegExp(`expect\\s*\\(\\s*'([^']*)'\\s*\\)\\s*\\.\\s*(?:${matcherPattern})\\s*\\(\\s*'\\1'\\s*\\)`);
+        const doubleQuotePattern = new RegExp(`expect\\s*\\(\\s*"([^"]*)"\\s*\\)\\s*\\.\\s*(?:${matcherPattern})\\s*\\(\\s*"\\1"\\s*\\)`);
+        // Pattern 4: Same identifier on both sides
+        // expect(x).toBe(x), expect(result).toEqual(result)
+        const identifierPattern = new RegExp(`expect\\s*\\(\\s*([a-zA-Z_$][a-zA-Z0-9_$]*)\\s*\\)\\s*\\.\\s*(?:${matcherPattern})\\s*\\(\\s*\\1\\s*\\)`);
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            const lineNum = i + 1;
+            if (literalPattern.test(line)) {
+                const literalMatch = line.match(literalPattern);
+                issues.push({
+                    type: 'tautological-assertion',
+                    severity: 'error',
+                    line: lineNum,
+                    description: `Tautological assertion: expect(${literalMatch?.[1]}) always equals itself.`,
+                    suggestion: 'Replace with a meaningful assertion that tests actual behavior, e.g.: expect(myFunction()).toBe(expectedValue)',
+                });
+            }
+            else if (numericPattern.test(line)) {
+                const numMatch = line.match(numericPattern);
+                issues.push({
+                    type: 'tautological-assertion',
+                    severity: 'error',
+                    line: lineNum,
+                    description: `Tautological assertion: expect(${numMatch?.[1]}) always equals itself.`,
+                    suggestion: 'Replace with a meaningful assertion that tests actual behavior.',
+                });
+            }
+            else if (singleQuotePattern.test(line)) {
+                const strMatch = line.match(singleQuotePattern);
+                issues.push({
+                    type: 'tautological-assertion',
+                    severity: 'error',
+                    line: lineNum,
+                    description: `Tautological assertion: expect('${strMatch?.[1]}') always equals itself.`,
+                    suggestion: 'Replace with a meaningful assertion that tests actual behavior.',
+                });
+            }
+            else if (doubleQuotePattern.test(line)) {
+                const strMatch = line.match(doubleQuotePattern);
+                issues.push({
+                    type: 'tautological-assertion',
+                    severity: 'error',
+                    line: lineNum,
+                    description: `Tautological assertion: expect("${strMatch?.[1]}") always equals itself.`,
+                    suggestion: 'Replace with a meaningful assertion that tests actual behavior.',
+                });
+            }
+            else if (identifierPattern.test(line)) {
+                const idMatch = line.match(identifierPattern);
+                // Avoid false positives with common non-tautological patterns
+                // like expect(result).toBe(result) where result is a computed value
+                // We flag it anyway since same-variable assertions are always suspicious
+                issues.push({
+                    type: 'tautological-assertion',
+                    severity: 'error',
+                    line: lineNum,
+                    description: `Tautological assertion: expect(${idMatch?.[1]}).toBe(${idMatch?.[1]}) compares a value to itself.`,
+                    suggestion: 'Compute expected value independently from the actual value.',
+                });
+            }
+        }
+        return issues;
+    }
+    /**
+     * Detect empty test bodies - test/it blocks with no assertions or meaningful code.
+     * Matches: it('...', () => {}), test('...', () => { /* comment * / })
+     */
+    detectEmptyTestBodies(testCode) {
+        const issues = [];
+        const lines = testCode.split('\n');
+        // Match it(...) or test(...) blocks with empty or comment-only bodies
+        // We look for patterns like:
+        //   it('desc', () => {})
+        //   it('desc', () => { })
+        //   it('desc', () => { /* comment */ })
+        //   it('desc', function() {})
+        //   test('desc', () => {})
+        //
+        // Two-phase approach to avoid ReDoS: first match the block structure,
+        // then check if the body contains only whitespace and comments.
+        const testBlockRegex = /(?:it|test)\s*\(\s*(?:'[^']*'|"[^"]*"|`[^`]*`)\s*,\s*(?:async\s+)?(?:\(\)\s*=>|function\s*\(\))\s*\{([^}]*)\}\s*\)/;
+        const isEmptyOrCommentOnly = (body) => {
+            // Strip block comments, then line comments, then check if only whitespace remains
+            const stripped = body.replace(/\/\*[^*]*\*\//g, '').replace(/\/\/[^\n]*/g, '');
+            return stripped.trim().length === 0;
+        };
+        for (let i = 0; i < lines.length; i++) {
+            // Only check lines that start a test block
+            if (!/(?:it|test)\s*\(/.test(lines[i]))
+                continue;
+            // Build a multi-line window to catch bodies that span 1-3 lines
+            const window = lines.slice(i, i + 4).join(' ');
+            const match = testBlockRegex.exec(window);
+            if (match && isEmptyOrCommentOnly(match[1])) {
+                issues.push({
+                    type: 'empty-test-body',
+                    severity: 'error',
+                    line: i + 1,
+                    description: 'Empty test body: this test has no assertions or meaningful code.',
+                    suggestion: 'Add assertions that verify the expected behavior of the code under test.',
+                });
+            }
+        }
+        return issues;
+    }
+    /**
+     * Detect mirrored assertions - expected values that appear to be copy-pasted
+     * from source code literals rather than independently computed.
+     */
+    detectMirroredAssertions(testCode, sourceCode) {
+        const issues = [];
+        // Extract non-trivial literals from source code
+        const sourceLiterals = this.extractNonTrivialLiterals(sourceCode);
+        if (sourceLiterals.length === 0)
+            return issues;
+        const lines = testCode.split('\n');
+        const matcherPattern = /\.(?:toBe|toEqual|toStrictEqual)\s*\(\s*(.+?)\s*\)/;
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            const assertionMatch = line.match(matcherPattern);
+            if (!assertionMatch)
+                continue;
+            const expectedValue = assertionMatch[1].trim();
+            // Check if the expected value matches a source literal
+            for (const literal of sourceLiterals) {
+                if (this.literalMatches(expectedValue, literal)) {
+                    issues.push({
+                        type: 'mirrored-assertion',
+                        severity: 'warning',
+                        line: i + 1,
+                        description: `Assertion expected value "${expectedValue}" mirrors a literal from the source code. This may indicate the test was generated by copying source values rather than computing expected results independently.`,
+                        suggestion: 'Verify the expected value is derived from requirements, not copied from the implementation.',
+                    });
+                    break; // One warning per line is enough
+                }
+            }
+        }
+        return issues;
+    }
+    // ============================================================================
+    // Utility Methods
+    // ============================================================================
+    /**
+     * Extract non-trivial string and number literals from source code.
+     * Trivial values (true, false, null, undefined, 0, 1, '', "") are excluded.
+     */
+    extractNonTrivialLiterals(sourceCode) {
+        const literals = new Set();
+        const trivialValues = new Set([
+            'true', 'false', 'null', 'undefined',
+            '0', '1', '-1', '""', "''", '``',
+        ]);
+        // Extract string literals (single and double quoted)
+        const stringRegex = /(?:=|return|:)\s*(['"])(.+?)\1/g;
+        let match;
+        while ((match = stringRegex.exec(sourceCode)) !== null) {
+            const value = match[2];
+            if (value.length >= 2 && !trivialValues.has(value)) {
+                literals.add(`'${value}'`);
+                literals.add(`"${value}"`);
+            }
+        }
+        // Extract number literals (non-trivial: > 1 or decimals)
+        const numberRegex = /(?:=|return|:)\s*(\d+(?:\.\d+)?)\b/g;
+        while ((match = numberRegex.exec(sourceCode)) !== null) {
+            const value = match[1];
+            if (!trivialValues.has(value)) {
+                literals.add(value);
+            }
+        }
+        return Array.from(literals);
+    }
+    /**
+     * Check if an assertion expected value matches a source literal.
+     */
+    literalMatches(expectedValue, sourceLiteral) {
+        // Direct match
+        if (expectedValue === sourceLiteral)
+            return true;
+        // Strip quotes for comparison
+        const stripped = expectedValue.replace(/^['"`]|['"`]$/g, '');
+        const sourceStripped = sourceLiteral.replace(/^['"`]|['"`]$/g, '');
+        return stripped === sourceStripped && stripped.length >= 2;
+    }
+    /**
+     * Calculate quality score from issues.
+     * Start at 100, subtract per issue (error: -20, warning: -5), clamp to 0.
+     */
+    calculateScore(issues) {
+        let score = 100;
+        for (const issue of issues) {
+            if (issue.severity === 'error') {
+                score -= 20;
+            }
+            else {
+                score -= 5;
+            }
+        }
+        return Math.max(0, score);
+    }
+}
+//# sourceMappingURL=test-quality-gate.js.map

package/dist/domains/test-generation/gates/test-quality-gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-quality-gate.js","sourceRoot":"","sources":["../../../../src/domains/test-generation/gates/test-quality-gate.ts"],"names":[],"mappings":"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"}

package/dist/domains/test-generation/generators/flutter-test-generator.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Agentic QE v3 - Flutter Test Generator
+ * Strategy implementation for Flutter/Dart test framework
+ *
+ * Generates test code using:
+ * - flutter_test package (group, test, testWidgets, expect)
+ * - mockito package (@GenerateMocks, when/verify/thenReturn)
+ * - setUp / tearDown lifecycle hooks
+ * - async/await with Future<T> handling
+ * - Dart null safety (T? types)
+ * - WidgetTester for widget tests
+ *
+ * @module test-generation/generators
+ */
+import { BaseTestGenerator } from './base-test-generator.js';
+import type { TestFramework, TestType, FunctionInfo, ClassInfo, TestGenerationContext, CodeAnalysis } from '../interfaces.js';
+import type { ParsedFile } from '../../../shared/parsers/interfaces.js';
+/**
+ * FlutterTestGenerator - Test generator for Flutter/Dart test framework
+ *
+ * Produces idiomatic Dart test files using flutter_test and mockito,
+ * with support for widget tests, async Future handling, and null safety.
+ *
+ * @example
+ * ```typescript
+ * const generator = new FlutterTestGenerator();
+ * const testCode = generator.generateTests({
+ *   moduleName: 'UserService',
+ *   importPath: 'package:my_app/services/user_service.dart',
+ *   testType: 'unit',
+ *   patterns: [],
+ *   analysis: { functions: [...], classes: [...] }
+ * });
+ * ```
+ */
+export declare class FlutterTestGenerator extends BaseTestGenerator {
+    readonly framework: TestFramework;
+    /**
+     * Dart primitive types for type-aware value generation
+     */
+    private static readonly DART_TYPE_DEFAULTS;
+    /**
+     * Generate complete Dart test file from analysis
+     */
+    generateTests(context: TestGenerationContext): string;
+    /**
+     * Generate tests for a standalone function
+     */
+    generateFunctionTests(fn: FunctionInfo, _testType: TestType): string;
+    /**
+     * Generate tests for a class, including dependency injection via Mockito
+     */
+    generateClassTests(cls: ClassInfo, testType: TestType): string;
+    /**
+     * Generate stub tests when no AST analysis is available
+     */
+    generateStubTests(context: TestGenerationContext): string;
+    /**
+     * Generate coverage-focused tests for specific lines
+     */
+    generateCoverageTests(moduleName: string, importPath: string, lines: number[]): string;
+    /**
+     * Convert a ParsedFile (language-agnostic) to ICodeAnalysis for this generator
+     */
+    static convertParsedFile(parsed: ParsedFile): CodeAnalysis;
+    /**
+     * Generate Dart import statements for a test file
+     */
+    private generateDartImports;
+    /**
+     * Collect all types that need @GenerateMocks
+     */
+    private collectMockClasses;
+    /**
+     * Determine if a type looks like a service/repository (should be mocked)
+     */
+    private isDartServiceType;
+    /**
+     * Check if any class in the analysis looks like a Flutter Widget
+     */
+    private hasWidgetLikeClasses;
+    /**
+     * Determine if a class is a Widget (by name convention or methods)
+     */
+    private isWidgetClass;
+    /**
+     * Extract constructor dependencies that should be mocked
+     */
+    private extractMockDependencies;
+    /**
+     * Generate tests for a class method
+     */
+    private generateMethodTests;
+    /**
+     * Generate Dart-idiomatic test cases for a function
+     */
+    private generateDartTestCases;
+    /**
+     * Generate a Dart test value based on parameter name and type
+     */
+    private generateDartValue;
+    /**
+     * Indent a block of code by a given number of spaces
+     */
+    private indentBlock;
+}
+//# sourceMappingURL=flutter-test-generator.d.ts.map

package/dist/domains/test-generation/generators/flutter-test-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flutter-test-generator.d.ts","sourceRoot":"","sources":["../../../../src/domains/test-generation/generators/flutter-test-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EACV,aAAa,EACb,QAAQ,EACR,YAAY,EACZ,SAAS,EACT,qBAAqB,EACrB,YAAY,EACb,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uCAAuC,CAAC;AAExE;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,oBAAqB,SAAQ,iBAAiB;IACzD,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAkB;IAEnD;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAWxC;IAMF;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,qBAAqB,GAAG,MAAM;IAsCrD;;OAEG;IACH,qBAAqB,CAAC,EAAE,EAAE,YAAY,EAAE,SAAS,EAAE,QAAQ,GAAG,MAAM;IAmBpE;;OAEG;IACH,kBAAkB,CAAC,GAAG,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,GAAG,MAAM;IA2D9D;;OAEG;IACH,iBAAiB,CAAC,OAAO,EAAE,qBAAqB,GAAG,MAAM;IAiCzD;;OAEG;IACH,qBAAqB,CACnB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EAAE,GACd,MAAM;IA+BT;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,YAAY;IA4D1D;;OAEG;IACH,OAAO,CAAC,mBAAmB;IA+B3B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAgB1B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAazB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAI5B;;OAEG;IACH,OAAO,CAAC,aAAa;IAWrB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAa/B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAwF3B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA+F7B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAgCzB;;OAEG;IACH,OAAO,CAAC,WAAW;CAOpB"}