atlas-pipeline-mcp 1.0.17 → 1.0.19

package/dist/tools/testgen.js

@@ -0,0 +1,413 @@
+/**
+ * Atlas Server - Test Generation Tool
+ *
+ * Automatic test generation capabilities:
+ * - Unit test generation
+ * - Integration test generation
+ * - Test case extraction from code
+ * - Mock/stub generation
+ * - Edge case identification
+ * - Coverage suggestions
+ */
+import { getActiveProvider, isNoLLMMode } from '../providers/index.js';
+import { logger } from '../utils.js';
+// ============================================================================
+// Test Generation
+// ============================================================================
+/**
+ * Generate tests for the given code
+ */
+export async function generateTests(code, options = {}) {
+    const { language, framework = 'auto', testType = 'unit', functionName, context } = options;
+    logger.debug({ language, framework, testType }, 'Starting test generation');
+    // Detect language and framework if not provided
+    const detectedLanguage = language ?? detectLanguage(code);
+    const detectedFramework = framework === 'auto' ? detectFramework(detectedLanguage) : framework;
+    // Extract function signatures and analyze code structure
+    const codeAnalysis = analyzeCodeForTesting(code, detectedLanguage);
+    // Generate test cases
+    let testCases;
+    let generatedCode;
+    let mocks = [];
+    let imports = [];
+    if (!isNoLLMMode()) {
+        try {
+            const aiResult = await generateTestsWithAI(code, {
+                language: detectedLanguage,
+                framework: detectedFramework,
+                testType,
+                functionName,
+                context,
+                codeAnalysis,
+            });
+            testCases = aiResult.testCases;
+            generatedCode = aiResult.code;
+            mocks = aiResult.mocks;
+            imports = aiResult.imports;
+        }
+        catch (error) {
+            logger.warn({ error }, 'AI test generation failed, using heuristic generation');
+            const heuristicResult = generateHeuristicTests(code, detectedLanguage, detectedFramework, codeAnalysis);
+            testCases = heuristicResult.testCases;
+            generatedCode = heuristicResult.code;
+            imports = heuristicResult.imports;
+        }
+    }
+    else {
+        const heuristicResult = generateHeuristicTests(code, detectedLanguage, detectedFramework, codeAnalysis);
+        testCases = heuristicResult.testCases;
+        generatedCode = heuristicResult.code;
+        imports = heuristicResult.imports;
+    }
+    // Generate coverage suggestions
+    const coverage = generateCoverageSuggestions(code, testCases, codeAnalysis);
+    // Generate recommendations
+    const recommendations = generateTestRecommendations(testCases, coverage, detectedFramework);
+    return {
+        tests: {
+            code: generatedCode,
+            framework: detectedFramework,
+            testCases,
+            imports,
+            mocks,
+        },
+        coverage,
+        recommendations,
+        generatedAt: new Date().toISOString(),
+    };
+}
+function analyzeCodeForTesting(code, language) {
+    const analysis = {
+        functions: [],
+        classes: [],
+        exports: [],
+        dependencies: [],
+        hasAsync: false,
+        hasCallbacks: false,
+    };
+    // Detect functions based on language
+    if (['typescript', 'javascript'].includes(language.toLowerCase())) {
+        // Function declarations
+        const funcRegex = /(?:export\s+)?(?:async\s+)?function\s+(\w+)\s*\(([^)]*)\)(?:\s*:\s*([^{]+))?/g;
+        let match;
+        while ((match = funcRegex.exec(code)) !== null) {
+            analysis.functions.push({
+                name: match[1],
+                params: match[2] ? match[2].split(',').map(p => p.trim()) : [],
+                returnType: match[3]?.trim(),
+                isAsync: code.slice(Math.max(0, match.index - 10), match.index).includes('async'),
+                isExported: code.slice(Math.max(0, match.index - 10), match.index).includes('export'),
+            });
+        }
+        // Arrow functions
+        const arrowRegex = /(?:export\s+)?(?:const|let|var)\s+(\w+)\s*=\s*(?:async\s+)?\([^)]*\)\s*(?::\s*[^=]+)?\s*=>/g;
+        while ((match = arrowRegex.exec(code)) !== null) {
+            const funcStart = match.index;
+            const isAsync = code.slice(funcStart, funcStart + 50).includes('async');
+            analysis.functions.push({
+                name: match[1],
+                params: [],
+                isAsync,
+                isExported: code.slice(Math.max(0, funcStart - 10), funcStart).includes('export'),
+            });
+        }
+        // Classes
+        const classRegex = /(?:export\s+)?class\s+(\w+)/g;
+        while ((match = classRegex.exec(code)) !== null) {
+            analysis.classes.push(match[1]);
+        }
+        // Check for async/callbacks
+        analysis.hasAsync = /async\s+|await\s+|\.then\s*\(|Promise/g.test(code);
+        analysis.hasCallbacks = /callback|cb\s*\(|done\s*\(/g.test(code);
+        // Dependencies (imports)
+        const importRegex = /import\s+.*\s+from\s+['"]([^'"]+)['"]/g;
+        while ((match = importRegex.exec(code)) !== null) {
+            analysis.dependencies.push(match[1]);
+        }
+    }
+    else if (language.toLowerCase() === 'python') {
+        // Python function detection
+        const pyFuncRegex = /(?:async\s+)?def\s+(\w+)\s*\(([^)]*)\)/g;
+        let match;
+        while ((match = pyFuncRegex.exec(code)) !== null) {
+            analysis.functions.push({
+                name: match[1],
+                params: match[2] ? match[2].split(',').map(p => p.trim().split(':')[0].trim()) : [],
+                isAsync: code.slice(Math.max(0, match.index - 10), match.index).includes('async'),
+                isExported: true, // Python doesn't have explicit exports
+            });
+        }
+        // Python classes
+        const pyClassRegex = /class\s+(\w+)/g;
+        while ((match = pyClassRegex.exec(code)) !== null) {
+            analysis.classes.push(match[1]);
+        }
+        analysis.hasAsync = /async\s+def|await\s+/g.test(code);
+    }
+    return analysis;
+}
+// ============================================================================
+// AI Test Generation
+// ============================================================================
+async function generateTestsWithAI(code, options) {
+    const provider = await getActiveProvider();
+    const prompt = `Generate comprehensive ${options.testType} tests for this code.
+
+## Code to Test
+\`\`\`${options.language}
+${code}
+\`\`\`
+
+## Requirements
+- Framework: ${options.framework}
+- Language: ${options.language}
+- Test Type: ${options.testType}
+${options.functionName ? `- Focus on function: ${options.functionName}` : ''}
+${options.context ? `- Context: ${options.context}` : ''}
+
+## Functions Found
+${options.codeAnalysis.functions.map(f => `- ${f.name}(${f.params.join(', ')})`).join('\n')}
+
+## Generate Tests That Cover:
+1. Happy path scenarios
+2. Edge cases (null, undefined, empty, boundary values)
+3. Error handling
+4. Async behavior (if applicable)
+
+## Output Format
+{
+  "code": "Complete test file code",
+  "testCases": [
+    {
+      "name": "test name",
+      "description": "what it tests",
+      "type": "unit|integration|e2e",
+      "input": "input description",
+      "expectedOutput": "expected output",
+      "edgeCase": true/false
+    }
+  ],
+  "mocks": ["mock descriptions"],
+  "imports": ["required imports"]
+}`;
+    const response = await provider.completeJson(prompt, {
+        systemPrompt: 'You are an expert test engineer. Generate comprehensive, well-structured tests with good coverage. Return valid JSON only.',
+        temperature: 0.3,
+        maxTokens: 4096,
+    });
+    if (response.data) {
+        return response.data;
+    }
+    throw new Error('Failed to generate tests with AI');
+}
+// ============================================================================
+// Heuristic Test Generation
+// ============================================================================
+function generateHeuristicTests(code, language, framework, analysis) {
+    const testCases = [];
+    const imports = [];
+    let testCode = '';
+    if (['typescript', 'javascript'].includes(language.toLowerCase())) {
+        // Generate Jest/Vitest style tests
+        const isVitest = framework === 'vitest';
+        imports.push(isVitest
+            ? `import { describe, it, expect, beforeEach, afterEach } from 'vitest';`
+            : `import { describe, it, expect, beforeEach, afterEach } from '@jest/globals';`);
+        testCode = `${imports.join('\n')}
+// Import the module to test
+// import { ${analysis.functions.map(f => f.name).join(', ')} } from './module';
+
+`;
+        for (const func of analysis.functions) {
+            testCode += `describe('${func.name}', () => {\n`;
+            // Happy path test
+            testCode += `  it('should work correctly with valid input', ${func.isAsync ? 'async ' : ''}() => {\n`;
+            testCode += `    // Arrange\n`;
+            testCode += `    const input = ${generateSampleInput(func.params)};\n`;
+            testCode += `    \n`;
+            testCode += `    // Act\n`;
+            testCode += `    const result = ${func.isAsync ? 'await ' : ''}${func.name}(${func.params.length > 0 ? 'input' : ''});\n`;
+            testCode += `    \n`;
+            testCode += `    // Assert\n`;
+            testCode += `    expect(result).toBeDefined();\n`;
+            testCode += `  });\n\n`;
+            testCases.push({
+                name: `${func.name} - happy path`,
+                description: 'Tests basic functionality with valid input',
+                type: 'unit',
+                input: 'valid input',
+                expectedOutput: 'expected result',
+                edgeCase: false,
+            });
+            // Edge case: empty input
+            if (func.params.length > 0) {
+                testCode += `  it('should handle empty/null input gracefully', ${func.isAsync ? 'async ' : ''}() => {\n`;
+                testCode += `    // Test with null/undefined/empty values\n`;
+                testCode += `    expect(() => ${func.name}(null)).toThrow();\n`;
+                testCode += `  });\n\n`;
+                testCases.push({
+                    name: `${func.name} - null input`,
+                    description: 'Tests behavior with null/undefined input',
+                    type: 'unit',
+                    input: 'null/undefined',
+                    expectedOutput: 'should throw or handle gracefully',
+                    edgeCase: true,
+                });
+            }
+            // Error handling test
+            testCode += `  it('should handle errors correctly', ${func.isAsync ? 'async ' : ''}() => {\n`;
+            testCode += `    // Test error scenarios\n`;
+            testCode += `    // Add specific error test cases here\n`;
+            testCode += `  });\n`;
+            testCases.push({
+                name: `${func.name} - error handling`,
+                description: 'Tests error handling behavior',
+                type: 'unit',
+                input: 'invalid input',
+                expectedOutput: 'error or error message',
+                edgeCase: true,
+            });
+            testCode += `});\n\n`;
+        }
+    }
+    else if (language.toLowerCase() === 'python') {
+        // Generate pytest style tests
+        imports.push('import pytest');
+        testCode = `${imports.join('\n')}
+# Import the module to test
+# from module import ${analysis.functions.map(f => f.name).join(', ')}
+
+`;
+        for (const func of analysis.functions) {
+            testCode += `class Test${capitalize(func.name)}:\n`;
+            // Happy path
+            testCode += `    def test_${func.name}_with_valid_input(self):\n`;
+            testCode += `        """Test ${func.name} with valid input."""\n`;
+            testCode += `        # Arrange\n`;
+            testCode += `        # input_data = ...\n`;
+            testCode += `        \n`;
+            testCode += `        # Act\n`;
+            testCode += `        # result = ${func.name}(input_data)\n`;
+            testCode += `        \n`;
+            testCode += `        # Assert\n`;
+            testCode += `        # assert result is not None\n`;
+            testCode += `        pass\n\n`;
+            testCases.push({
+                name: `test_${func.name}_with_valid_input`,
+                description: 'Tests basic functionality with valid input',
+                type: 'unit',
+                input: 'valid input',
+                expectedOutput: 'expected result',
+                edgeCase: false,
+            });
+            // Edge case
+            testCode += `    def test_${func.name}_with_none_input(self):\n`;
+            testCode += `        """Test ${func.name} with None input."""\n`;
+            testCode += `        with pytest.raises((TypeError, ValueError)):\n`;
+            testCode += `            ${func.name}(None)\n\n`;
+            testCases.push({
+                name: `test_${func.name}_with_none_input`,
+                description: 'Tests behavior with None input',
+                type: 'unit',
+                input: 'None',
+                expectedOutput: 'raises exception',
+                edgeCase: true,
+            });
+        }
+    }
+    else {
+        // Generic test template
+        testCode = `// Test file for ${language}\n// Add your test cases here\n`;
+    }
+    return { code: testCode, testCases, imports };
+}
+// ============================================================================
+// Helper Functions
+// ============================================================================
+function detectLanguage(code) {
+    if (code.includes('interface ') || code.includes(': string') || code.includes(': number')) {
+        return 'typescript';
+    }
+    if (code.includes('function ') || code.includes('=>') || code.includes('const ')) {
+        return 'javascript';
+    }
+    if (code.includes('def ') && code.includes(':')) {
+        return 'python';
+    }
+    if (code.includes('func ') && code.includes('package ')) {
+        return 'go';
+    }
+    return 'javascript';
+}
+function detectFramework(language) {
+    switch (language.toLowerCase()) {
+        case 'typescript':
+        case 'javascript':
+            return 'vitest';
+        case 'python':
+            return 'pytest';
+        case 'go':
+            return 'go_test';
+        case 'ruby':
+            return 'rspec';
+        default:
+            return 'jest';
+    }
+}
+function generateSampleInput(params) {
+    if (params.length === 0)
+        return '{}';
+    if (params.length === 1)
+        return `'test-value'`;
+    return `{ ${params.map(p => `${p.split(':')[0].trim()}: 'value'`).join(', ')} }`;
+}
+function capitalize(str) {
+    return str.charAt(0).toUpperCase() + str.slice(1);
+}
+function generateCoverageSuggestions(code, testCases, analysis) {
+    const totalFunctions = analysis.functions.length;
+    const testedFunctions = new Set(testCases.map(tc => tc.name.split(' ')[0])).size;
+    const estimatedCoverage = totalFunctions > 0
+        ? Math.round((testedFunctions / totalFunctions) * 70) // Assume 70% max from generated tests
+        : 50;
+    const uncoveredPaths = [];
+    const suggestedAdditionalTests = [];
+    // Check for untested scenarios
+    if (analysis.hasAsync && !testCases.some(tc => tc.description.includes('async'))) {
+        suggestedAdditionalTests.push('Add tests for async error handling and timeout scenarios');
+    }
+    if (analysis.hasCallbacks && !testCases.some(tc => tc.description.includes('callback'))) {
+        suggestedAdditionalTests.push('Add tests for callback error scenarios');
+    }
+    // Suggest edge cases
+    suggestedAdditionalTests.push('Add boundary value tests (min/max values)');
+    suggestedAdditionalTests.push('Add performance/load tests for critical paths');
+    suggestedAdditionalTests.push('Add integration tests with external dependencies');
+    return {
+        estimatedCoverage,
+        uncoveredPaths,
+        suggestedAdditionalTests,
+    };
+}
+function generateTestRecommendations(testCases, coverage, framework) {
+    const recommendations = [];
+    // Coverage recommendations
+    if (coverage.estimatedCoverage < 80) {
+        recommendations.push(`Aim for at least 80% code coverage (currently estimated at ${coverage.estimatedCoverage}%)`);
+    }
+    // Edge case recommendations
+    const edgeCaseCount = testCases.filter(tc => tc.edgeCase).length;
+    if (edgeCaseCount < 3) {
+        recommendations.push('Add more edge case tests (boundary values, null checks, error scenarios)');
+    }
+    // Framework-specific recommendations
+    if (framework === 'jest' || framework === 'vitest') {
+        recommendations.push('Consider using snapshot testing for UI components');
+        recommendations.push('Use beforeEach/afterEach for proper test isolation');
+    }
+    // General recommendations
+    recommendations.push('Run tests with coverage reporting enabled');
+    recommendations.push('Add CI/CD integration to run tests on every commit');
+    return recommendations;
+}
+//# sourceMappingURL=testgen.js.map

package/dist/tools/testgen.js.map

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

package/dist/tools/think.d.ts

@@ -0,0 +1,223 @@
+/**
+ * Atlas Server - Advanced Sequential Thinking Tool
+ *
+ * Enhanced reasoning capabilities beyond basic sequential thinking:
+ * - Dynamic thought branching with merge support
+ * - Hypothesis generation and verification
+ * - Confidence scoring and uncertainty tracking
+ * - Automatic insight extraction
+ * - Deadend detection and smart backtracking
+ * - AI-enhanced reasoning when LLM available
+ * - Thought summarization and compression
+ * - Memory of key conclusions
+ * - Session persistence with LRU eviction
+ *
+ * Performance Features:
+ * - Optimized session lookup with Map
+ * - Lazy AI enhancement (only when needed)
+ * - Efficient insight extraction using pre-compiled patterns
+ * - Memory-efficient session cleanup
+ *
+ * @module think
+ * @author Nishant Unavane
+ * @version 1.1.0
+ */
+export interface ThoughtInput {
+    thought: string;
+    thoughtNumber: number;
+    totalThoughts: number;
+    nextThoughtNeeded: boolean;
+    isRevision?: boolean;
+    revisesThought?: number;
+    branchFromThought?: number;
+    branchId?: string;
+    mergeBranches?: string[];
+    thoughtType?: ThoughtType;
+    confidence?: number;
+    hypothesis?: string;
+    verificationResult?: 'confirmed' | 'refuted' | 'partial' | 'inconclusive';
+    isDeadEnd?: boolean;
+    keyInsight?: string;
+    needsMoreThoughts?: boolean;
+    problemContext?: string;
+    constraints?: string[];
+}
+export type ThoughtType = 'analysis' | 'hypothesis' | 'verification' | 'revision' | 'synthesis' | 'conclusion' | 'question' | 'exploration' | 'backtrack' | 'insight';
+export interface ThoughtRecord extends ThoughtInput {
+    timestamp: string;
+    aiEnhancement?: string;
+    extractedInsights: string[];
+    confidenceHistory: number[];
+}
+export interface Branch {
+    id: string;
+    name?: string;
+    parentThought: number;
+    thoughts: ThoughtRecord[];
+    status: 'active' | 'merged' | 'abandoned' | 'deadend';
+    hypothesis?: string;
+    conclusion?: string;
+}
+export interface ThinkingSession {
+    id: string;
+    startTime: string;
+    lastAccessTime: number;
+    problem: string;
+    thoughts: ThoughtRecord[];
+    branches: Record<string, Branch>;
+    currentBranch: string | null;
+    hypotheses: Hypothesis[];
+    keyInsights: string[];
+    deadEnds: DeadEnd[];
+    conclusion?: Conclusion;
+    overallConfidence: number;
+}
+export interface Hypothesis {
+    id: string;
+    statement: string;
+    proposedAt: number;
+    status: 'proposed' | 'testing' | 'confirmed' | 'refuted' | 'partial';
+    evidence: Evidence[];
+    confidence: number;
+}
+export interface Evidence {
+    thoughtNumber: number;
+    type: 'supports' | 'refutes' | 'neutral';
+    description: string;
+    weight: number;
+}
+export interface DeadEnd {
+    thoughtNumber: number;
+    reason: string;
+    lessonsLearned: string[];
+    backtrackTo: number;
+}
+export interface Conclusion {
+    answer: string;
+    confidence: number;
+    supportingThoughts: number[];
+    alternativeConsidered: string[];
+    caveats: string[];
+}
+export interface ThinkingResult {
+    thoughtNumber: number;
+    totalThoughts: number;
+    nextThoughtNeeded: boolean;
+    currentBranch: string | null;
+    branches: string[];
+    thoughtHistoryLength: number;
+    currentConfidence: number;
+    activeHypotheses: number;
+    keyInsightsCount: number;
+    deadEndsEncountered: number;
+    aiSuggestion?: string;
+    recommendedNextStep?: string;
+    progressSummary: string;
+    conclusion?: Conclusion;
+    processingTimeMs?: number;
+}
+/**
+ * Advanced Thinking Server with optimized session management
+ * - LRU eviction for memory management
+ * - Efficient insight extraction
+ * - Lazy AI enhancement
+ */
+export declare class AdvancedThinkingServer {
+    private sessions;
+    private currentSession;
+    private cleanupTimer;
+    constructor();
+    /**
+     * Start periodic cleanup of stale sessions
+     */
+    private startCleanupTimer;
+    /**
+     * Clean up sessions that haven't been accessed recently
+     */
+    private cleanupStaleSessions;
+    /**
+     * Shutdown and cleanup
+     */
+    shutdown(): void;
+    /**
+     * Start a new thinking session
+     */
+    startSession(problem: string, sessionId?: string): string;
+    /**
+     * Get session count for monitoring
+     */
+    getSessionCount(): number;
+    /**
+     * Process a thought and return the result
+     */
+    processThought(input: ThoughtInput): Promise<ThinkingResult>;
+    /**
+     * Extract insights from thought text
+     */
+    private extractInsights;
+    /**
+     * Handle branching logic
+     */
+    private handleBranching;
+    /**
+     * Handle merging of branches
+     */
+    private handleMerge;
+    /**
+     * Add a new hypothesis
+     */
+    private addHypothesis;
+    /**
+     * Update hypothesis status based on verification
+     */
+    private updateHypothesisStatus;
+    /**
+     * Record a dead end
+     */
+    private recordDeadEnd;
+    /**
+     * Find the best point to backtrack to
+     */
+    private findBacktrackPoint;
+    /**
+     * Calculate overall confidence
+     */
+    private calculateOverallConfidence;
+    /**
+     * Get AI enhancement for the current thinking
+     */
+    private getAIEnhancement;
+    /**
+     * Generate a progress summary
+     */
+    private generateProgressSummary;
+    /**
+     * Generate final conclusion
+     */
+    private generateConclusion;
+    /**
+     * Get current session
+     */
+    getSession(): ThinkingSession | null;
+    /**
+     * Reset the server
+     */
+    reset(): void;
+}
+/**
+ * Process a thought using the advanced thinking server
+ */
+export declare function processThought(input: ThoughtInput): Promise<ThinkingResult>;
+/**
+ * Start a new thinking session
+ */
+export declare function startSession(problem: string): string;
+/**
+ * Reset the thinking server
+ */
+export declare function resetThinking(): void;
+/**
+ * Get the current session
+ */
+export declare function getCurrentSession(): ThinkingSession | null;
+//# sourceMappingURL=think.d.ts.map

package/dist/tools/think.d.ts.map

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