atlas-pipeline-mcp 1.0.19 → 1.0.21

package/dist/tools/review.js

@@ -0,0 +1,428 @@
+/**
+ * Atlas Server - AI Code Review Assistant
+ *
+ * Comprehensive AI-powered code review capabilities:
+ * - Multi-dimensional code quality analysis
+ * - Best practices enforcement
+ * - Architectural pattern validation
+ * - Security vulnerability detection
+ * - Performance optimization suggestions
+ * - Test coverage recommendations
+ * - Documentation quality assessment
+ * - Team coding standards compliance
+ *
+ * @module review
+ * @author Nishant Unavane
+ * @version 1.0.0
+ */
+import { getActiveProvider, isNoLLMMode } from '../providers/index.js';
+import { logger, createTimer } from '../utils.js';
+import { z } from 'zod';
+// ============================================================================
+// Validation Schema
+// ============================================================================
+const CodeReviewOptionsSchema = z.object({
+    code: z.string().min(1).max(500000),
+    language: z.string().min(1),
+    filePath: z.string().optional(),
+    checkQuality: z.boolean().optional(),
+    checkSecurity: z.boolean().optional(),
+    checkPerformance: z.boolean().optional(),
+    checkArchitecture: z.boolean().optional(),
+    checkTests: z.boolean().optional(),
+    checkDocumentation: z.boolean().optional(),
+    framework: z.string().optional(),
+    teamStandards: z.string().optional(),
+    pullRequestContext: z.string().optional(),
+    changedFiles: z.array(z.string()).optional(),
+});
+// ============================================================================
+// Static Analysis
+// ============================================================================
+/**
+ * Calculate quality metrics from code
+ */
+function calculateQualityMetrics(code, language) {
+    const lines = code.split('\n');
+    const codeLines = lines.filter(l => {
+        const trimmed = l.trim();
+        return trimmed.length > 0 && !trimmed.startsWith('//') && !trimmed.startsWith('/*') && !trimmed.startsWith('*') && !trimmed.startsWith('#');
+    });
+    const commentLines = lines.filter(l => {
+        const trimmed = l.trim();
+        return trimmed.startsWith('//') || trimmed.startsWith('/*') || trimmed.startsWith('*') || trimmed.startsWith('#');
+    });
+    const blankLines = lines.filter(l => l.trim().length === 0);
+    // Calculate average complexity (simplified)
+    const decisionPoints = (code.match(/\b(if|else|for|while|case|catch|\?|&&|\|\|)\b/g) || []).length;
+    const functions = (code.match(/\b(function|def|fn|func)\s+\w+/g) || []).length || 1;
+    const averageComplexity = decisionPoints / functions;
+    // Detect duplicated code (very simplified - just looks for repeated lines)
+    const lineSet = new Set(codeLines.map(l => l.trim()));
+    const duplicatedCodeRatio = 1 - (lineSet.size / (codeLines.length || 1));
+    // Check documentation coverage (count documented functions vs total)
+    const totalFunctions = (code.match(/\b(function|def|fn|func|class|interface)\s+\w+/g) || []).length;
+    const documentedFunctions = (code.match(/\/\*\*[\s\S]*?\*\/\s*(?:export\s+)?(?:async\s+)?(?:function|class|interface)\s+\w+/g) || []).length;
+    const documentationCoverage = totalFunctions > 0 ? documentedFunctions / totalFunctions : 0;
+    return {
+        totalLines: lines.length,
+        codeLines: codeLines.length,
+        commentLines: commentLines.length,
+        blankLines: blankLines.length,
+        commentRatio: commentLines.length / (codeLines.length || 1),
+        averageComplexity,
+        duplicatedCodeRatio,
+        documentationCoverage,
+    };
+}
+/**
+ * Detect common code issues automatically
+ */
+function detectIssues(code, language) {
+    const findings = [];
+    // Security: SQL Injection risk
+    if (code.match(/\bquery\s*\+\s*\w+|SELECT.*\+|sql\s*=\s*['"`].*\+/i)) {
+        findings.push({
+            severity: 'critical',
+            category: 'security',
+            title: 'Potential SQL Injection',
+            description: 'String concatenation detected in SQL queries',
+            suggestion: 'Use parameterized queries or prepared statements',
+            autoFixable: false,
+            references: ['https://owasp.org/www-community/attacks/SQL_Injection'],
+        });
+    }
+    // Security: Eval usage
+    if (code.match(/\beval\s*\(/)) {
+        findings.push({
+            severity: 'critical',
+            category: 'security',
+            title: 'Dangerous eval() usage',
+            description: 'eval() can execute arbitrary code and is a security risk',
+            suggestion: 'Avoid eval() - use safer alternatives like JSON.parse() or Function constructor',
+            autoFixable: false,
+        });
+    }
+    // Performance: Console.log in production
+    if (code.match(/console\.(log|debug|info)/)) {
+        findings.push({
+            severity: 'minor',
+            category: 'performance',
+            title: 'Console logging in code',
+            description: 'Console statements can impact performance in production',
+            suggestion: 'Use a proper logger with log levels or remove before production',
+            autoFixable: true,
+        });
+    }
+    // Correctness: Comparison with ==
+    if (language === 'javascript' || language === 'typescript') {
+        if (code.match(/[^=!]={2}[^=]/)) {
+            findings.push({
+                severity: 'minor',
+                category: 'best-practices',
+                title: 'Loose equality (==) instead of strict equality (===)',
+                description: 'Using == can lead to unexpected type coercion',
+                suggestion: 'Use === for strict equality checks',
+                autoFixable: true,
+            });
+        }
+    }
+    // Maintainability: Magic numbers
+    const magicNumbers = code.match(/\b\d{3,}\b/g) || [];
+    if (magicNumbers.length > 5) {
+        findings.push({
+            severity: 'minor',
+            category: 'maintainability',
+            title: 'Too many magic numbers',
+            description: `${magicNumbers.length} numeric literals found without explanation`,
+            suggestion: 'Extract magic numbers to named constants',
+            autoFixable: false,
+        });
+    }
+    // Reliability: Missing error handling
+    if (code.match(/\bawait\s+\w+/) && !code.match(/try\s*{[\s\S]*}catch/)) {
+        findings.push({
+            severity: 'major',
+            category: 'reliability',
+            title: 'Missing error handling for async code',
+            description: 'Async operations without try-catch can cause unhandled rejections',
+            suggestion: 'Wrap async code in try-catch blocks',
+            autoFixable: false,
+        });
+    }
+    // Architecture: God function
+    const functionBodies = code.match(/(?:function|def|fn)\s+\w+[^{]*{([^}]{1000,})}/gs) || [];
+    if (functionBodies.length > 0) {
+        findings.push({
+            severity: 'major',
+            category: 'architecture',
+            title: 'Overly long function(s)',
+            description: `${functionBodies.length} function(s) exceed 50 lines`,
+            suggestion: 'Break down large functions into smaller, focused ones',
+            autoFixable: false,
+        });
+    }
+    // Documentation: Missing JSDoc
+    const publicFunctions = (code.match(/\bexport\s+(?:async\s+)?function\s+\w+/g) || []).length;
+    const documentedExports = (code.match(/\/\*\*[\s\S]*?\*\/\s*export\s+(?:async\s+)?function\s+\w+/g) || []).length;
+    if (publicFunctions > documentedExports && publicFunctions > 0) {
+        findings.push({
+            severity: 'minor',
+            category: 'documentation',
+            title: 'Missing documentation for public APIs',
+            description: `${publicFunctions - documentedExports} exported functions lack documentation`,
+            suggestion: 'Add JSDoc comments to all public functions',
+            autoFixable: false,
+        });
+    }
+    return findings;
+}
+/**
+ * Calculate grade from score
+ */
+function scoreToGrade(score) {
+    if (score >= 97)
+        return 'A+';
+    if (score >= 90)
+        return 'A';
+    if (score >= 80)
+        return 'B';
+    if (score >= 70)
+        return 'C';
+    if (score >= 60)
+        return 'D';
+    return 'F';
+}
+// ============================================================================
+// Main Review Function
+// ============================================================================
+/**
+ * Comprehensive AI-powered code review
+ */
+export async function reviewCode(options) {
+    const timer = createTimer();
+    const { code, language, filePath, checkQuality = true, checkSecurity = true, checkPerformance = true, checkArchitecture = true, checkTests = false, checkDocumentation = true, framework, teamStandards, pullRequestContext, } = CodeReviewOptionsSchema.parse(options);
+    logger.info({ language, filePath }, 'Starting code review');
+    const warnings = [];
+    // Static analysis
+    const metrics = calculateQualityMetrics(code, language);
+    const staticFindings = detectIssues(code, language);
+    // Build review prompt
+    const aspects = [];
+    if (checkQuality)
+        aspects.push('code quality');
+    if (checkSecurity)
+        aspects.push('security vulnerabilities');
+    if (checkPerformance)
+        aspects.push('performance optimization');
+    if (checkArchitecture)
+        aspects.push('architecture and design patterns');
+    if (checkTests)
+        aspects.push('test coverage and quality');
+    if (checkDocumentation)
+        aspects.push('documentation quality');
+    const prompt = `You are a senior code reviewer with 50 years of experience conducting PR reviews. Review this ${language} code.
+
+**Code:**
+\`\`\`${language}
+${code}
+\`\`\`
+
+**Context:**
+${filePath ? `- File: ${filePath}` : ''}
+${framework ? `- Framework: ${framework}` : ''}
+${pullRequestContext ? `- PR Context: ${pullRequestContext}` : ''}
+${teamStandards ? `- Team Standards:\n${teamStandards}` : ''}
+
+**Metrics:**
+- Total Lines: ${metrics.totalLines}
+- Code Lines: ${metrics.codeLines}
+- Comment Ratio: ${(metrics.commentRatio * 100).toFixed(1)}%
+- Average Complexity: ${metrics.averageComplexity.toFixed(1)}
+- Documentation Coverage: ${(metrics.documentationCoverage * 100).toFixed(1)}%
+
+**Review Focus:** ${aspects.join(', ')}
+
+**Static Analysis Findings:** ${staticFindings.length} issues detected
+
+**Instructions:**
+Provide a comprehensive code review covering:
+1. **Quality** (readability, maintainability, complexity)
+2. **Security** (vulnerabilities, input validation, auth)
+3. **Performance** (algorithmic efficiency, resource usage)
+4. **Architecture** (design patterns, separation of concerns)
+5. **Testing** (testability, edge cases)
+6. **Documentation** (clarity, completeness)
+
+For each aspect, provide:
+- Score (0-100)
+- Key strengths
+- Key weaknesses
+- Specific findings with severity
+
+**Format your response as:**
+
+QUALITY: [score]
+Strengths: [strength 1], [strength 2]
+Weaknesses: [weakness 1], [weakness 2]
+
+SECURITY: [score]
+Strengths: [strength 1]
+Weaknesses: [weakness 1]
+
+PERFORMANCE: [score]
+Strengths: [strength 1]
+Weaknesses: [weakness 1]
+
+ARCHITECTURE: [score]
+Strengths: [strength 1]
+Weaknesses: [weakness 1]
+
+TESTS: [score]
+Strengths: [strength 1]
+Weaknesses: [weakness 1]
+
+DOCUMENTATION: [score]
+Strengths: [strength 1]
+Weaknesses: [weakness 1]
+
+FINDINGS:
+- [SEVERITY] [CATEGORY]: [description] - Suggestion: [fix]
+...
+
+SUMMARY:
+[2-3 sentence overall assessment]`;
+    let allFindings = [...staticFindings];
+    let suggestions = [];
+    let grades = {
+        quality: { score: 70, letter: 'C', issues: 0, strengths: [], weaknesses: [] },
+        security: { score: 70, letter: 'C', issues: 0, strengths: [], weaknesses: [] },
+        performance: { score: 70, letter: 'C', issues: 0, strengths: [], weaknesses: [] },
+        architecture: { score: 70, letter: 'C', issues: 0, strengths: [], weaknesses: [] },
+        tests: { score: 0, letter: 'F', issues: 0, strengths: [], weaknesses: [] },
+        documentation: { score: Math.round(metrics.documentationCoverage * 100), letter: scoreToGrade(metrics.documentationCoverage * 100), issues: 0, strengths: [], weaknesses: [] },
+    };
+    let summary = 'Code review completed with static analysis only.';
+    if (isNoLLMMode()) {
+        warnings.push('No LLM provider - using static analysis only');
+        summary = `Static analysis detected ${staticFindings.length} issues. Install an LLM provider for comprehensive AI-powered review.`;
+    }
+    else {
+        const provider = await getActiveProvider();
+        try {
+            const response = await provider.complete(prompt, {
+                maxTokens: 3000,
+                temperature: 0.3,
+            });
+            const responseText = response.text;
+            // Parse grades
+            const gradePattern = /(\w+):\s*(\d+)\s*Strengths:\s*([^\n]+)\s*Weaknesses:\s*([^\n]+)/gi;
+            let match;
+            while ((match = gradePattern.exec(responseText)) !== null) {
+                const aspect = match[1]?.toLowerCase() || '';
+                const score = parseInt(match[2] || '70');
+                const strengths = (match[3] || '').split(',').map(s => s.trim()).filter(Boolean);
+                const weaknesses = (match[4] || '').split(',').map(s => s.trim()).filter(Boolean);
+                const grade = {
+                    score,
+                    letter: scoreToGrade(score),
+                    issues: weaknesses.length,
+                    strengths,
+                    weaknesses,
+                };
+                if (aspect in grades) {
+                    grades[aspect] = grade;
+                }
+            }
+            // Parse findings
+            const findingsSection = responseText.match(/FINDINGS:\s*([\s\S]*?)(?:SUMMARY:|$)/i);
+            if (findingsSection && findingsSection[1]) {
+                const findingLines = findingsSection[1].trim().split('\n')
+                    .filter((line) => line.trim().startsWith('-'));
+                for (const line of findingLines) {
+                    const cleanLine = line.replace(/^-\s*/, '').trim();
+                    const parts = cleanLine.split(' - Suggestion: ');
+                    if (parts.length >= 2 && parts[0]) {
+                        const [firstPart, suggestion] = parts;
+                        const [severityCategory, ...descParts] = firstPart.split(': ');
+                        const [severityStr, categoryStr] = (severityCategory || '').split(' ');
+                        allFindings.push({
+                            severity: severityStr?.toLowerCase() || 'minor',
+                            category: categoryStr?.toLowerCase() || 'best-practices',
+                            title: descParts.join(': '),
+                            description: descParts.join(': '),
+                            suggestion: suggestion || '',
+                            autoFixable: false,
+                        });
+                    }
+                }
+            }
+            // Parse summary
+            const summaryMatch = responseText.match(/SUMMARY:\s*([\s\S]+?)$/i);
+            if (summaryMatch && summaryMatch[1]) {
+                summary = summaryMatch[1].trim();
+            }
+            // Generate suggestions
+            const criticalIssues = allFindings.filter(f => f.severity === 'blocker' || f.severity === 'critical');
+            if (criticalIssues.length > 0) {
+                suggestions.push({
+                    priority: 'must',
+                    category: 'Critical Issues',
+                    description: `Fix ${criticalIssues.length} critical/blocker issues before merging`,
+                    rationale: 'These issues pose security or correctness risks',
+                });
+            }
+            if (metrics.averageComplexity > 10) {
+                suggestions.push({
+                    priority: 'should',
+                    category: 'Complexity',
+                    description: 'Reduce cyclomatic complexity',
+                    rationale: 'High complexity makes code harder to test and maintain',
+                });
+            }
+            if (metrics.documentationCoverage < 0.5) {
+                suggestions.push({
+                    priority: 'should',
+                    category: 'Documentation',
+                    description: 'Improve documentation coverage',
+                    rationale: 'Well-documented code is easier for team members to understand',
+                });
+            }
+        }
+        catch (error) {
+            logger.error({ error }, 'Review failed');
+            warnings.push(`LLM error: ${error instanceof Error ? error.message : 'Unknown'}`);
+        }
+    }
+    // Calculate overall score
+    const scores = [
+        grades.quality.score,
+        grades.security.score,
+        grades.performance.score,
+        grades.architecture.score,
+        grades.documentation.score,
+    ];
+    const overallScore = Math.round(scores.reduce((a, b) => a + b, 0) / scores.length);
+    const executionTimeMs = timer.elapsed();
+    logger.info({
+        overallScore,
+        findings: allFindings.length,
+        executionTimeMs
+    }, 'Code review completed');
+    return {
+        code,
+        overallScore,
+        grades,
+        findings: allFindings,
+        suggestions,
+        metrics,
+        summary,
+        executionTimeMs,
+        warnings,
+    };
+}
+// ============================================================================
+// Export
+// ============================================================================
+export default reviewCode;
+//# sourceMappingURL=review.js.map

package/dist/tools/review.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"review.js","sourceRoot":"","sources":["../../src/tools/review.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAwGxB,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC;IACnC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACpC,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACrC,gBAAgB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACxC,iBAAiB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACzC,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAClC,kBAAkB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC1C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACpC,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACzC,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CAC7C,CAAC,CAAC;AAEH,+EAA+E;AAC/E,kBAAkB;AAClB,+EAA+E;AAE/E;;GAEG;AACH,SAAS,uBAAuB,CAAC,IAAY,EAAE,QAAgB;IAC7D,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAE/B,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;QACjC,MAAM,OAAO,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QACzB,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IAC9I,CAAC,CAAC,CAAC;IAEH,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;QACpC,MAAM,OAAO,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QACzB,OAAO,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IACpH,CAAC,CAAC,CAAC;IAEH,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC;IAE5D,4CAA4C;IAC5C,MAAM,cAAc,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,gDAAgD,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;IACnG,MAAM,SAAS,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,iCAAiC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC;IACpF,MAAM,iBAAiB,GAAG,cAAc,GAAG,SAAS,CAAC;IAErD,2EAA2E;IAC3E,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACtD,MAAM,mBAAmB,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,SAAS,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC;IAEzE,qEAAqE;IACrE,MAAM,cAAc,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,iDAAiD,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;IACpG,MAAM,mBAAmB,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,qFAAqF,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;IAC7I,MAAM,qBAAqB,GAAG,cAAc,GAAG,CAAC,CAAC,CAAC,CAAC,mBAAmB,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;IAE5F,OAAO;QACL,UAAU,EAAE,KAAK,CAAC,MAAM;QACxB,SAAS,EAAE,SAAS,CAAC,MAAM;QAC3B,YAAY,EAAE,YAAY,CAAC,MAAM;QACjC,UAAU,EAAE,UAAU,CAAC,MAAM;QAC7B,YAAY,EAAE,YAAY,CAAC,MAAM,GAAG,CAAC,SAAS,CAAC,MAAM,IAAI,CAAC,CAAC;QAC3D,iBAAiB;QACjB,mBAAmB;QACnB,qBAAqB;KACtB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,YAAY,CAAC,IAAY,EAAE,QAAgB;IAClD,MAAM,QAAQ,GAAoB,EAAE,CAAC;IAErC,+BAA+B;IAC/B,IAAI,IAAI,CAAC,KAAK,CAAC,oDAAoD,CAAC,EAAE,CAAC;QACrE,QAAQ,CAAC,IAAI,CAAC;YACZ,QAAQ,EAAE,UAAU;YACpB,QAAQ,EAAE,UAAU;YACpB,KAAK,EAAE,yBAAyB;YAChC,WAAW,EAAE,8CAA8C;YAC3D,UAAU,EAAE,kDAAkD;YAC9D,WAAW,EAAE,KAAK;YAClB,UAAU,EAAE,CAAC,uDAAuD,CAAC;SACtE,CAAC,CAAC;IACL,CAAC;IAED,uBAAuB;IACvB,IAAI,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,EAAE,CAAC;QAC9B,QAAQ,CAAC,IAAI,CAAC;YACZ,QAAQ,EAAE,UAAU;YACpB,QAAQ,EAAE,UAAU;YACpB,KAAK,EAAE,wBAAwB;YAC/B,WAAW,EAAE,0DAA0D;YACvE,UAAU,EAAE,iFAAiF;YAC7F,WAAW,EAAE,KAAK;SACnB,CAAC,CAAC;IACL,CAAC;IAED,yCAAyC;IACzC,IAAI,IAAI,CAAC,KAAK,CAAC,2BAA2B,CAAC,EAAE,CAAC;QAC5C,QAAQ,CAAC,IAAI,CAAC;YACZ,QAAQ,EAAE,OAAO;YACjB,QAAQ,EAAE,aAAa;YACvB,KAAK,EAAE,yBAAyB;YAChC,WAAW,EAAE,yDAAyD;YACtE,UAAU,EAAE,iEAAiE;YAC7E,WAAW,EAAE,IAAI;SAClB,CAAC,CAAC;IACL,CAAC;IAED,kCAAkC;IAClC,IAAI,QAAQ,KAAK,YAAY,IAAI,QAAQ,KAAK,YAAY,EAAE,CAAC;QAC3D,IAAI,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,EAAE,CAAC;YAChC,QAAQ,CAAC,IAAI,CAAC;gBACZ,QAAQ,EAAE,OAAO;gBACjB,QAAQ,EAAE,gBAAgB;gBAC1B,KAAK,EAAE,sDAAsD;gBAC7D,WAAW,EAAE,+CAA+C;gBAC5D,UAAU,EAAE,oCAAoC;gBAChD,WAAW,EAAE,IAAI;aAClB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,iCAAiC;IACjC,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC;IACrD,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5B,QAAQ,CAAC,IAAI,CAAC;YACZ,QAAQ,EAAE,OAAO;YACjB,QAAQ,EAAE,iBAAiB;YAC3B,KAAK,EAAE,wBAAwB;YAC/B,WAAW,EAAE,GAAG,YAAY,CAAC,MAAM,6CAA6C;YAChF,UAAU,EAAE,0CAA0C;YACtD,WAAW,EAAE,KAAK;SACnB,CAAC,CAAC;IACL,CAAC;IAED,sCAAsC;IACtC,IAAI,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,sBAAsB,CAAC,EAAE,CAAC;QACvE,QAAQ,CAAC,IAAI,CAAC;YACZ,QAAQ,EAAE,OAAO;YACjB,QAAQ,EAAE,aAAa;YACvB,KAAK,EAAE,uCAAuC;YAC9C,WAAW,EAAE,mEAAmE;YAChF,UAAU,EAAE,qCAAqC;YACjD,WAAW,EAAE,KAAK;SACnB,CAAC,CAAC;IACL,CAAC;IAED,6BAA6B;IAC7B,MAAM,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,iDAAiD,CAAC,IAAI,EAAE,CAAC;IAC3F,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,QAAQ,CAAC,IAAI,CAAC;YACZ,QAAQ,EAAE,OAAO;YACjB,QAAQ,EAAE,cAAc;YACxB,KAAK,EAAE,yBAAyB;YAChC,WAAW,EAAE,GAAG,cAAc,CAAC,MAAM,8BAA8B;YACnE,UAAU,EAAE,uDAAuD;YACnE,WAAW,EAAE,KAAK;SACnB,CAAC,CAAC;IACL,CAAC;IAED,+BAA+B;IAC/B,MAAM,eAAe,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,yCAAyC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;IAC7F,MAAM,iBAAiB,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,4DAA4D,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;IAClH,IAAI,eAAe,GAAG,iBAAiB,IAAI,eAAe,GAAG,CAAC,EAAE,CAAC;QAC/D,QAAQ,CAAC,IAAI,CAAC;YACZ,QAAQ,EAAE,OAAO;YACjB,QAAQ,EAAE,eAAe;YACzB,KAAK,EAAE,uCAAuC;YAC9C,WAAW,EAAE,GAAG,eAAe,GAAG,iBAAiB,wCAAwC;YAC3F,UAAU,EAAE,4CAA4C;YACxD,WAAW,EAAE,KAAK;SACnB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,SAAS,YAAY,CAAC,KAAa;IACjC,IAAI,KAAK,IAAI,EAAE;QAAE,OAAO,IAAI,CAAC;IAC7B,IAAI,KAAK,IAAI,EAAE;QAAE,OAAO,GAAG,CAAC;IAC5B,IAAI,KAAK,IAAI,EAAE;QAAE,OAAO,GAAG,CAAC;IAC5B,IAAI,KAAK,IAAI,EAAE;QAAE,OAAO,GAAG,CAAC;IAC5B,IAAI,KAAK,IAAI,EAAE;QAAE,OAAO,GAAG,CAAC;IAC5B,OAAO,GAAG,CAAC;AACb,CAAC;AAED,+EAA+E;AAC/E,uBAAuB;AACvB,+EAA+E;AAE/E;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,OAA0B;IACzD,MAAM,KAAK,GAAG,WAAW,EAAE,CAAC;IAE5B,MAAM,EACJ,IAAI,EACJ,QAAQ,EACR,QAAQ,EACR,YAAY,GAAG,IAAI,EACnB,aAAa,GAAG,IAAI,EACpB,gBAAgB,GAAG,IAAI,EACvB,iBAAiB,GAAG,IAAI,EACxB,UAAU,GAAG,KAAK,EAClB,kBAAkB,GAAG,IAAI,EACzB,SAAS,EACT,aAAa,EACb,kBAAkB,GACnB,GAAG,uBAAuB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAE3C,MAAM,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,sBAAsB,CAAC,CAAC;IAE5D,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,kBAAkB;IAClB,MAAM,OAAO,GAAG,uBAAuB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACxD,MAAM,cAAc,GAAG,YAAY,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAEpD,sBAAsB;IACtB,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,YAAY;QAAE,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC/C,IAAI,aAAa;QAAE,OAAO,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;IAC5D,IAAI,gBAAgB;QAAE,OAAO,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;IAC/D,IAAI,iBAAiB;QAAE,OAAO,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;IACxE,IAAI,UAAU;QAAE,OAAO,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;IAC1D,IAAI,kBAAkB;QAAE,OAAO,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IAE9D,MAAM,MAAM,GAAG,iGAAiG,QAAQ;;;QAGlH,QAAQ;EACd,IAAI;;;;EAIJ,QAAQ,CAAC,CAAC,CAAC,WAAW,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE;EACrC,SAAS,CAAC,CAAC,CAAC,gBAAgB,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE;EAC5C,kBAAkB,CAAC,CAAC,CAAC,iBAAiB,kBAAkB,EAAE,CAAC,CAAC,CAAC,EAAE;EAC/D,aAAa,CAAC,CAAC,CAAC,sBAAsB,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE;;;iBAG3C,OAAO,CAAC,UAAU;gBACnB,OAAO,CAAC,SAAS;mBACd,CAAC,OAAO,CAAC,YAAY,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;wBAClC,OAAO,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC;4BAChC,CAAC,OAAO,CAAC,qBAAqB,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;;oBAExD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;;gCAEN,cAAc,CAAC,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kCAgDnB,CAAC;IAEjC,IAAI,WAAW,GAAG,CAAC,GAAG,cAAc,CAAC,CAAC;IACtC,IAAI,WAAW,GAAuB,EAAE,CAAC;IACzC,IAAI,MAAM,GAAiB;QACzB,OAAO,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE;QAC7E,QAAQ,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE;QAC9E,WAAW,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE;QACjF,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE;QAClF,KAAK,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE;QAC1E,aAAa,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,qBAAqB,GAAG,GAAG,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,OAAO,CAAC,qBAAqB,GAAG,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE;KAC/K,CAAC;IACF,IAAI,OAAO,GAAG,kDAAkD,CAAC;IAEjE,IAAI,WAAW,EAAE,EAAE,CAAC;QAClB,QAAQ,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;QAC9D,OAAO,GAAG,4BAA4B,cAAc,CAAC,MAAM,uEAAuE,CAAC;IACrI,CAAC;SAAM,CAAC;QACN,MAAM,QAAQ,GAAG,MAAM,iBAAiB,EAAE,CAAC;QAE3C,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE;gBAC/C,SAAS,EAAE,IAAI;gBACf,WAAW,EAAE,GAAG;aACjB,CAAC,CAAC;YAEH,MAAM,YAAY,GAAG,QAAQ,CAAC,IAAI,CAAC;YAEnC,eAAe;YACf,MAAM,YAAY,GAAG,mEAAmE,CAAC;YACzF,IAAI,KAAK,CAAC;YAEV,OAAO,CAAC,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;gBAC1D,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;gBAC7C,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC;gBACzC,MAAM,SAAS,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;gBACjF,MAAM,UAAU,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;gBAElF,MAAM,KAAK,GAAU;oBACnB,KAAK;oBACL,MAAM,EAAE,YAAY,CAAC,KAAK,CAAC;oBAC3B,MAAM,EAAE,UAAU,CAAC,MAAM;oBACzB,SAAS;oBACT,UAAU;iBACX,CAAC;gBAEF,IAAI,MAAM,IAAI,MAAM,EAAE,CAAC;oBACpB,MAAc,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC;gBAClC,CAAC;YACH,CAAC;YAED,iBAAiB;YACjB,MAAM,eAAe,GAAG,YAAY,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAC;YACpF,IAAI,eAAe,IAAI,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC1C,MAAM,YAAY,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;qBACvD,MAAM,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;gBAEzD,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;oBAChC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;oBACnD,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;oBAEjD,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;wBAClC,MAAM,CAAC,SAAS,EAAE,UAAU,CAAC,GAAG,KAAK,CAAC;wBACtC,MAAM,CAAC,gBAAgB,EAAE,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;wBAC/D,MAAM,CAAC,WAAW,EAAE,WAAW,CAAC,GAAG,CAAC,gBAAgB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;wBAEvE,WAAW,CAAC,IAAI,CAAC;4BACf,QAAQ,EAAG,WAAW,EAAE,WAAW,EAAU,IAAI,OAAO;4BACxD,QAAQ,EAAG,WAAW,EAAE,WAAW,EAAU,IAAI,gBAAgB;4BACjE,KAAK,EAAE,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC;4BAC3B,WAAW,EAAE,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC;4BACjC,UAAU,EAAE,UAAU,IAAI,EAAE;4BAC5B,WAAW,EAAE,KAAK;yBACnB,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;YACH,CAAC;YAED,gBAAgB;YAChB,MAAM,YAAY,GAAG,YAAY,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;YACnE,IAAI,YAAY,IAAI,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;gBACpC,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YACnC,CAAC;YAED,uBAAuB;YACvB,MAAM,cAAc,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,SAAS,IAAI,CAAC,CAAC,QAAQ,KAAK,UAAU,CAAC,CAAC;YACtG,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC9B,WAAW,CAAC,IAAI,CAAC;oBACf,QAAQ,EAAE,MAAM;oBAChB,QAAQ,EAAE,iBAAiB;oBAC3B,WAAW,EAAE,OAAO,cAAc,CAAC,MAAM,yCAAyC;oBAClF,SAAS,EAAE,iDAAiD;iBAC7D,CAAC,CAAC;YACL,CAAC;YAED,IAAI,OAAO,CAAC,iBAAiB,GAAG,EAAE,EAAE,CAAC;gBACnC,WAAW,CAAC,IAAI,CAAC;oBACf,QAAQ,EAAE,QAAQ;oBAClB,QAAQ,EAAE,YAAY;oBACtB,WAAW,EAAE,8BAA8B;oBAC3C,SAAS,EAAE,wDAAwD;iBACpE,CAAC,CAAC;YACL,CAAC;YAED,IAAI,OAAO,CAAC,qBAAqB,GAAG,GAAG,EAAE,CAAC;gBACxC,WAAW,CAAC,IAAI,CAAC;oBACf,QAAQ,EAAE,QAAQ;oBAClB,QAAQ,EAAE,eAAe;oBACzB,WAAW,EAAE,gCAAgC;oBAC7C,SAAS,EAAE,+DAA+D;iBAC3E,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE,eAAe,CAAC,CAAC;YACzC,QAAQ,CAAC,IAAI,CAAC,cAAc,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;QACpF,CAAC;IACH,CAAC;IAED,0BAA0B;IAC1B,MAAM,MAAM,GAAG;QACb,MAAM,CAAC,OAAO,CAAC,KAAK;QACpB,MAAM,CAAC,QAAQ,CAAC,KAAK;QACrB,MAAM,CAAC,WAAW,CAAC,KAAK;QACxB,MAAM,CAAC,YAAY,CAAC,KAAK;QACzB,MAAM,CAAC,aAAa,CAAC,KAAK;KAC3B,CAAC;IACF,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IAEnF,MAAM,eAAe,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC;IACxC,MAAM,CAAC,IAAI,CAAC;QACV,YAAY;QACZ,QAAQ,EAAE,WAAW,CAAC,MAAM;QAC5B,eAAe;KAChB,EAAE,uBAAuB,CAAC,CAAC;IAE5B,OAAO;QACL,IAAI;QACJ,YAAY;QACZ,MAAM;QACN,QAAQ,EAAE,WAAW;QACrB,WAAW;QACX,OAAO;QACP,OAAO;QACP,eAAe;QACf,QAAQ;KACT,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,SAAS;AACT,+EAA+E;AAE/E,eAAe,UAAU,CAAC"}

package/dist/tools/test-utils.d.ts

@@ -0,0 +1,170 @@
+/**
+ * Atlas Server - Testing Utilities and Fixtures
+ *
+ * Comprehensive testing infrastructure for all tools:
+ * - Mock data generators
+ * - Test fixtures and helpers
+ * - Performance benchmarking
+ * - Integration test utilities
+ * - Assertion helpers
+ *
+ * @module test-utils
+ * @version 1.0.0
+ */
+import type { IntentAnalysis, PipelineContext, GitContext, ProjectInfo, CodeSnippet, DecompositionResult, SolutionVariant, Critique } from '../types.js';
+/**
+ * Generate mock intent analysis for testing
+ */
+export declare function mockIntentAnalysis(overrides?: Partial<IntentAnalysis>): IntentAnalysis;
+/**
+ * Generate mock project info for testing
+ */
+export declare function mockProjectInfo(overrides?: Partial<ProjectInfo>): ProjectInfo;
+/**
+ * Generate mock git context for testing
+ */
+export declare function mockGitContext(overrides?: Partial<GitContext>): GitContext;
+/**
+ * Generate mock code snippet for testing
+ */
+export declare function mockCodeSnippet(overrides?: Partial<CodeSnippet>): CodeSnippet;
+/**
+ * Generate mock pipeline context for testing
+ */
+export declare function mockPipelineContext(overrides?: Partial<PipelineContext>): PipelineContext;
+/**
+ * Generate mock decomposition result for testing
+ */
+export declare function mockDecompositionResult(overrides?: Partial<DecompositionResult>): DecompositionResult;
+/**
+ * Generate mock solution variant for testing
+ */
+export declare function mockSolutionVariant(overrides?: Partial<SolutionVariant>): SolutionVariant;
+/**
+ * Generate mock critique for testing
+ */
+export declare function mockCritique(overrides?: Partial<Critique>): Critique;
+/**
+ * Measure async function execution time
+ */
+export declare function measureTime<T>(fn: () => Promise<T>): Promise<{
+    result: T;
+    durationMs: number;
+}>;
+/**
+ * Assert that a function throws with a specific message
+ */
+export declare function assertThrows(fn: () => Promise<unknown> | unknown, expectedMessage?: string | RegExp): Promise<Error>;
+/**
+ * Wait for a condition to be true
+ */
+export declare function waitFor(condition: () => boolean | Promise<boolean>, options?: {
+    timeout?: number;
+    interval?: number;
+}): Promise<void>;
+/**
+ * Create a spy function that tracks calls
+ */
+export declare function createSpy<T extends (...args: any[]) => any>(): {
+    spy: T;
+    calls: Array<{
+        args: Parameters<T>;
+        result?: ReturnType<T>;
+        error?: Error;
+    }>;
+    reset: () => void;
+};
+export interface BenchmarkResult {
+    name: string;
+    iterations: number;
+    totalMs: number;
+    avgMs: number;
+    minMs: number;
+    maxMs: number;
+    opsPerSecond: number;
+}
+/**
+ * Benchmark a function performance
+ */
+export declare function benchmark(name: string, fn: () => Promise<void> | void, iterations?: number): Promise<BenchmarkResult>;
+/**
+ * Compare multiple function implementations
+ */
+export declare function benchmarkCompare(tests: Array<{
+    name: string;
+    fn: () => Promise<void> | void;
+}>, iterations?: number): Promise<BenchmarkResult[]>;
+/**
+ * Print benchmark results to console
+ */
+export declare function printBenchmarkResults(results: BenchmarkResult[]): void;
+/**
+ * Create a temporary directory for testing
+ */
+export declare function createTempDir(): Promise<string>;
+/**
+ * Cleanup a temporary directory
+ */
+export declare function cleanupTempDir(dir: string): Promise<void>;
+/**
+ * Write test file to a directory
+ */
+export declare function writeTestFile(dir: string, filename: string, content: string): Promise<string>;
+/**
+ * Execute test with automatic cleanup
+ */
+export declare function withTestDir<T>(fn: (dir: string) => Promise<T>): Promise<T>;
+/**
+ * Assert that two values are deeply equal
+ */
+export declare function assertEqual<T>(actual: T, expected: T, message?: string): void;
+/**
+ * Assert that a value is truthy
+ */
+export declare function assertTrue(value: unknown, message?: string): void;
+/**
+ * Assert that a value is falsy
+ */
+export declare function assertFalse(value: unknown, message?: string): void;
+/**
+ * Assert that a value is defined (not null or undefined)
+ */
+export declare function assertDefined<T>(value: T | null | undefined, message?: string): asserts value is T;
+/**
+ * Assert that an array contains a value
+ */
+export declare function assertContains<T>(array: T[], value: T, message?: string): void;
+/**
+ * Assert that a number is within a range
+ */
+export declare function assertInRange(value: number, min: number, max: number, message?: string): void;
+/**
+ * Mock LLM provider for testing without actual API calls
+ */
+export declare class MockLLMProvider {
+    private responses;
+    callCount: number;
+    /**
+     * Set a mock response for a specific prompt pattern
+     */
+    setResponse(pattern: string | RegExp, response: unknown): void;
+    /**
+     * Mock complete method
+     */
+    complete(prompt: string): Promise<string>;
+    /**
+     * Mock completeJson method
+     */
+    completeJson<T>(prompt: string): Promise<{
+        data: T | null;
+    }>;
+    /**
+     * Reset the mock provider
+     */
+    reset(): void;
+}
+/**
+ * Example test suite demonstrating usage
+ */
+export declare function exampleTestSuite(): Promise<void>;
+//# sourceMappingURL=test-utils.d.ts.map

package/dist/tools/test-utils.d.ts.map

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