agentic-qe 3.7.6 → 3.7.8

package/dist/domains/test-generation/blind-review/blind-review-orchestrator.js

@@ -0,0 +1,189 @@
+/**
+ * Blind Review Orchestrator for Test Generation
+ * Inspired by loki-mode blind review pattern
+ *
+ * Runs N independent test generation passes in parallel with varied
+ * temperatures, then deduplicates using Jaccard similarity on tokenized
+ * assertions to maximize test diversity.
+ */
+import { ok, err } from '../../../shared/types/index.js';
+const DEFAULT_CONFIG = {
+    reviewerCount: 3,
+    deduplicationThreshold: 0.8,
+    timeoutMs: 30000,
+    varyTemperatures: true,
+    temperatures: [0.2, 0.5, 0.8],
+};
+// ============================================================================
+// Tokenization & Jaccard Similarity
+// ============================================================================
+/**
+ * Tokenize code into a set of meaningful tokens.
+ * Strips whitespace, splits on non-alphanumeric boundaries,
+ * and filters tokens shorter than 3 characters.
+ */
+export function tokenize(code) {
+    return new Set(code
+        .replace(/\s+/g, ' ')
+        .split(/[^a-zA-Z0-9_]+/)
+        .filter((t) => t.length > 2));
+}
+/**
+ * Compute Jaccard similarity between two token sets.
+ * Returns 0 if both sets are empty.
+ */
+export function jaccardSimilarity(a, b) {
+    if (a.size === 0 && b.size === 0)
+        return 0;
+    let intersectionSize = 0;
+    const smaller = a.size <= b.size ? a : b;
+    const larger = a.size <= b.size ? b : a;
+    for (const token of smaller) {
+        if (larger.has(token)) {
+            intersectionSize++;
+        }
+    }
+    const unionSize = a.size + b.size - intersectionSize;
+    return unionSize === 0 ? 0 : intersectionSize / unionSize;
+}
+/**
+ * Deduplicate tests using Jaccard similarity on tokenized test code.
+ * Groups tests by target file, then within each group keeps the
+ * test with the most assertions from each similarity cluster.
+ */
+export function deduplicateTests(tests, threshold) {
+    if (tests.length === 0)
+        return [];
+    // Group by source file
+    const bySource = new Map();
+    for (const test of tests) {
+        const key = test.sourceFile || '__ungrouped__';
+        const group = bySource.get(key) || [];
+        group.push(test);
+        bySource.set(key, group);
+    }
+    const deduplicated = [];
+    for (const group of bySource.values()) {
+        const tokenSets = group.map((t) => tokenize(t.testCode));
+        const used = new Set();
+        for (let i = 0; i < group.length; i++) {
+            if (used.has(i))
+                continue;
+            // Start a cluster with this test
+            const cluster = [i];
+            used.add(i);
+            for (let j = i + 1; j < group.length; j++) {
+                if (used.has(j))
+                    continue;
+                const similarity = jaccardSimilarity(tokenSets[i], tokenSets[j]);
+                if (similarity >= threshold) {
+                    cluster.push(j);
+                    used.add(j);
+                }
+            }
+            // Keep the test with the most assertions from the cluster
+            let best = cluster[0];
+            for (const idx of cluster) {
+                if (group[idx].assertions > group[best].assertions) {
+                    best = idx;
+                }
+            }
+            deduplicated.push(group[best]);
+        }
+    }
+    return deduplicated;
+}
+// ============================================================================
+// Orchestrator
+// ============================================================================
+/**
+ * Wraps a promise with a timeout. Rejects if the promise does not
+ * settle within the given number of milliseconds.
+ */
+function withTimeout(promise, ms) {
+    return new Promise((resolve, reject) => {
+        const timer = setTimeout(() => reject(new Error(`Reviewer timed out after ${ms}ms`)), ms);
+        promise.then((value) => {
+            clearTimeout(timer);
+            resolve(value);
+        }, (reason) => {
+            clearTimeout(timer);
+            reject(reason);
+        });
+    });
+}
+export class BlindReviewOrchestrator {
+    service;
+    constructor(service) {
+        this.service = service;
+    }
+    /**
+     * Run blind review: N independent generation passes in parallel,
+     * then deduplicate and merge results.
+     */
+    async generateWithBlindReview(request, config) {
+        const cfg = { ...DEFAULT_CONFIG, ...config };
+        if (cfg.reviewerCount < 1) {
+            return err(new Error('reviewerCount must be at least 1'));
+        }
+        // Launch N parallel reviewers with varied temperatures
+        const reviewerPromises = Array.from({ length: cfg.reviewerCount }, (_, i) => {
+            const reviewerId = `reviewer-${i}`;
+            const start = Date.now();
+            // Vary the request per reviewer: each gets a different temperature
+            // to encourage diverse test generation outputs
+            const reviewerRequest = { ...request };
+            if (cfg.varyTemperatures && cfg.temperatures.length > 0) {
+                const temperature = cfg.temperatures[i % cfg.temperatures.length];
+                // Attach temperature hint as pattern metadata that the generator can use
+                reviewerRequest.patterns = [
+                    ...(request.patterns ?? []),
+                    `__blind_review_temperature:${temperature}`,
+                ];
+            }
+            const genPromise = this.service
+                .generateTests(reviewerRequest)
+                .then((result) => {
+                const durationMs = Date.now() - start;
+                if (result.success) {
+                    return {
+                        reviewerId,
+                        tests: result.value.tests,
+                        durationMs,
+                    };
+                }
+                return { reviewerId, tests: [], durationMs };
+            });
+            return withTimeout(genPromise, cfg.timeoutMs).catch(() => ({
+                reviewerId,
+                tests: [],
+                durationMs: Date.now() - start,
+            }));
+        });
+        const reviewerOutputs = await Promise.allSettled(reviewerPromises);
+        // Collect fulfilled results
+        const outputs = reviewerOutputs
+            .filter((r) => r.status === 'fulfilled')
+            .map((r) => r.value);
+        // Gather all tests
+        const allTests = outputs.flatMap((o) => o.tests);
+        if (allTests.length === 0) {
+            return err(new Error('All reviewers failed to generate tests'));
+        }
+        // Deduplicate
+        const mergedTests = deduplicateTests(allTests, cfg.deduplicationThreshold);
+        const totalGenerated = allTests.length;
+        const afterDedup = mergedTests.length;
+        const uniquenessScore = totalGenerated === 0 ? 0 : afterDedup / totalGenerated;
+        return ok({
+            mergedTests,
+            reviewerOutputs: outputs,
+            stats: {
+                totalGenerated,
+                afterDedup,
+                uniquenessScore,
+            },
+        });
+    }
+}
+//# sourceMappingURL=blind-review-orchestrator.js.map

package/dist/domains/test-generation/blind-review/blind-review-orchestrator.js.map

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

package/dist/domains/test-generation/blind-review/index.d.ts

@@ -0,0 +1,2 @@
+export { BlindReviewOrchestrator, tokenize, jaccardSimilarity, deduplicateTests, type BlindReviewConfig, type BlindReviewResult, type BlindReviewStats, type ReviewerOutput, } from './blind-review-orchestrator.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/domains/test-generation/blind-review/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/domains/test-generation/blind-review/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,QAAQ,EACR,iBAAiB,EACjB,gBAAgB,EAChB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,cAAc,GACpB,MAAM,gCAAgC,CAAC"}

package/dist/domains/test-generation/blind-review/index.js

@@ -0,0 +1,2 @@
+export { BlindReviewOrchestrator, tokenize, jaccardSimilarity, deduplicateTests, } from './blind-review-orchestrator.js';
+//# sourceMappingURL=index.js.map

package/dist/domains/test-generation/blind-review/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/domains/test-generation/blind-review/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,QAAQ,EACR,iBAAiB,EACjB,gBAAgB,GAKjB,MAAM,gCAAgC,CAAC"}

package/dist/domains/test-generation/gates/index.d.ts

@@ -0,0 +1,2 @@
+export { TestQualityGate, type TestQualityGateResult, type TestQualityIssue, type TestQualityIssueType, type TestQualityGateConfig, } from './test-quality-gate.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/domains/test-generation/gates/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/domains/test-generation/gates/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,GAC3B,MAAM,wBAAwB,CAAC"}

package/dist/domains/test-generation/gates/index.js

@@ -0,0 +1,2 @@
+export { TestQualityGate, } from './test-quality-gate.js';
+//# sourceMappingURL=index.js.map

package/dist/domains/test-generation/gates/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/domains/test-generation/gates/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,GAKhB,MAAM,wBAAwB,CAAC"}

package/dist/domains/test-generation/gates/test-quality-gate.d.ts

@@ -0,0 +1,85 @@
+/**
+ * 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.
+ */
+export type TestQualityIssueType = 'no-source-import' | 'tautological-assertion' | 'empty-test-body' | 'mirrored-assertion';
+export interface TestQualityIssue {
+    type: TestQualityIssueType;
+    severity: 'error' | 'warning';
+    line?: number;
+    description: string;
+    suggestion: string;
+}
+export interface TestQualityGateResult {
+    passed: boolean;
+    issues: TestQualityIssue[];
+    score: number;
+}
+export interface TestQualityGateConfig {
+    /** Check for missing source imports (default: true) */
+    checkSourceImports: boolean;
+    /** Check for tautological assertions (default: true) */
+    checkTautologicalAssertions: boolean;
+    /** Check for empty test bodies (default: true) */
+    checkEmptyTestBodies: boolean;
+    /** Check for mirrored assertion values (default: true) */
+    checkMirroredAssertions: boolean;
+    /** Minimum score to pass (default: 60) */
+    minPassScore: number;
+}
+export declare class TestQualityGate {
+    private readonly config;
+    constructor(config?: Partial<TestQualityGateConfig>);
+    /**
+     * 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: string, sourceFilePath: string, sourceCode?: string): TestQualityGateResult;
+    /**
+     * Check whether the test code imports from the source file.
+     * If no import/require statement references the source file basename, flag an error.
+     */
+    private detectMissingSourceImports;
+    /**
+     * Detect tautological assertions where the expected and actual values are identical.
+     * Examples: expect(true).toBe(true), expect(x).toBe(x), expect('a').toEqual('a')
+     */
+    private detectTautologicalAssertions;
+    /**
+     * Detect empty test bodies - test/it blocks with no assertions or meaningful code.
+     * Matches: it('...', () => {}), test('...', () => { /* comment * / })
+     */
+    private detectEmptyTestBodies;
+    /**
+     * Detect mirrored assertions - expected values that appear to be copy-pasted
+     * from source code literals rather than independently computed.
+     */
+    private detectMirroredAssertions;
+    /**
+     * Extract non-trivial string and number literals from source code.
+     * Trivial values (true, false, null, undefined, 0, 1, '', "") are excluded.
+     */
+    private extractNonTrivialLiterals;
+    /**
+     * Check if an assertion expected value matches a source literal.
+     */
+    private literalMatches;
+    /**
+     * Calculate quality score from issues.
+     * Start at 100, subtract per issue (error: -20, warning: -5), clamp to 0.
+     */
+    private calculateScore;
+}
+//# sourceMappingURL=test-quality-gate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"test-quality-gate.d.ts","sourceRoot":"","sources":["../../../../src/domains/test-generation/gates/test-quality-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,MAAM,MAAM,oBAAoB,GAC5B,kBAAkB,GAClB,wBAAwB,GACxB,iBAAiB,GACjB,oBAAoB,CAAC;AAEzB,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,oBAAoB,CAAC;IAC3B,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,qBAAqB;IACpC,uDAAuD;IACvD,kBAAkB,EAAE,OAAO,CAAC;IAC5B,wDAAwD;IACxD,2BAA2B,EAAE,OAAO,CAAC;IACrC,kDAAkD;IAClD,oBAAoB,EAAE,OAAO,CAAC;IAC9B,0DAA0D;IAC1D,uBAAuB,EAAE,OAAO,CAAC;IACjC,0CAA0C;IAC1C,YAAY,EAAE,MAAM,CAAC;CACtB;AAcD,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;gBAEnC,MAAM,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC;IAInD;;;;;;;OAOG;IACH,QAAQ,CACN,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,MAAM,EACtB,UAAU,CAAC,EAAE,MAAM,GAClB,qBAAqB;IA6BxB;;;OAGG;IACH,OAAO,CAAC,0BAA0B;IAkDlC;;;OAGG;IACH,OAAO,CAAC,4BAA4B;IA2FpC;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAyC7B;;;OAGG;IACH,OAAO,CAAC,wBAAwB;IA0ChC;;;OAGG;IACH,OAAO,CAAC,yBAAyB;IA8BjC;;OAEG;IACH,OAAO,CAAC,cAAc;IAWtB;;;OAGG;IACH,OAAO,CAAC,cAAc;CAavB"}

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