atlas-pipeline-mcp 1.0.17 → 1.0.19

package/dist/tools/docs.js.map

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

package/dist/tools/explain.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Atlas Server - Code Explanation Tool
+ *
+ * Intelligent code explanation capabilities:
+ * - Line-by-line explanation
+ * - Algorithm analysis
+ * - Complexity analysis (Big O)
+ * - Design pattern identification
+ * - Dependency explanation
+ * - Beginner-friendly mode
+ */
+export type ExplanationLevel = 'beginner' | 'intermediate' | 'expert';
+export type ExplanationType = 'overview' | 'detailed' | 'line-by-line' | 'algorithm';
+export interface ExplanationOptions {
+    level?: ExplanationLevel;
+    type?: ExplanationType;
+    language?: string;
+    focusArea?: string;
+    includeComplexity?: boolean;
+    includePatterns?: boolean;
+}
+export interface CodeExplanation {
+    summary: string;
+    purpose: string;
+    howItWorks: string;
+    sections: ExplanationSection[];
+    complexity?: ComplexityAnalysis;
+    patterns?: DesignPattern[];
+    dependencies?: DependencyInfo[];
+    suggestions?: string[];
+    glossary?: GlossaryTerm[];
+}
+export interface ExplanationSection {
+    title: string;
+    lineRange: {
+        start: number;
+        end: number;
+    };
+    code: string;
+    explanation: string;
+    keyPoints: string[];
+}
+export interface ComplexityAnalysis {
+    time: string;
+    space: string;
+    explanation: string;
+    bestCase?: string;
+    worstCase?: string;
+    averageCase?: string;
+}
+export interface DesignPattern {
+    name: string;
+    type: 'creational' | 'structural' | 'behavioral' | 'architectural';
+    description: string;
+    locationHint: string;
+}
+export interface DependencyInfo {
+    name: string;
+    type: 'import' | 'external' | 'internal';
+    purpose: string;
+    required: boolean;
+}
+export interface GlossaryTerm {
+    term: string;
+    definition: string;
+    example?: string;
+}
+export interface ExplanationResult {
+    explanation: CodeExplanation;
+    metadata: {
+        level: ExplanationLevel;
+        type: ExplanationType;
+        language: string;
+        lineCount: number;
+    };
+    generatedAt: string;
+}
+/**
+ * Generate an explanation for the given code
+ */
+export declare function explainCode(code: string, options?: ExplanationOptions): Promise<ExplanationResult>;
+//# sourceMappingURL=explain.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"explain.d.ts","sourceRoot":"","sources":["../../src/tools/explain.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AASH,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,cAAc,GAAG,QAAQ,CAAC;AACtE,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,UAAU,GAAG,cAAc,GAAG,WAAW,CAAC;AAErF,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,kBAAkB,EAAE,CAAC;IAC/B,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAChC,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;IAC3B,YAAY,CAAC,EAAE,cAAc,EAAE,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,YAAY,GAAG,YAAY,GAAG,YAAY,GAAG,eAAe,CAAC;IACnE,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,GAAG,UAAU,GAAG,UAAU,CAAC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,eAAe,CAAC;IAC7B,QAAQ,EAAE;QACR,KAAK,EAAE,gBAAgB,CAAC;QACxB,IAAI,EAAE,eAAe,CAAC;QACtB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,WAAW,EAAE,MAAM,CAAC;CACrB;AAMD;;GAEG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,iBAAiB,CAAC,CAkD5B"}

package/dist/tools/explain.js

@@ -0,0 +1,543 @@
+/**
+ * Atlas Server - Code Explanation Tool
+ *
+ * Intelligent code explanation capabilities:
+ * - Line-by-line explanation
+ * - Algorithm analysis
+ * - Complexity analysis (Big O)
+ * - Design pattern identification
+ * - Dependency explanation
+ * - Beginner-friendly mode
+ */
+import { getActiveProvider, isNoLLMMode } from '../providers/index.js';
+import { logger } from '../utils.js';
+// ============================================================================
+// Code Explanation
+// ============================================================================
+/**
+ * Generate an explanation for the given code
+ */
+export async function explainCode(code, options = {}) {
+    const { level = 'intermediate', type = 'overview', language, focusArea, includeComplexity = true, includePatterns = true, } = options;
+    logger.debug({ level, type, codeLength: code.length }, 'Starting code explanation');
+    // Detect language
+    const detectedLanguage = language ?? detectLanguage(code);
+    // Analyze code structure
+    const structure = analyzeCodeStructure(code, detectedLanguage);
+    // Generate explanation
+    let explanation;
+    if (!isNoLLMMode()) {
+        try {
+            explanation = await explainWithAI(code, {
+                level,
+                type,
+                language: detectedLanguage,
+                focusArea,
+                includeComplexity,
+                includePatterns,
+                structure,
+            });
+        }
+        catch (error) {
+            logger.warn({ error }, 'AI explanation failed, using heuristic explanation');
+            explanation = generateHeuristicExplanation(code, detectedLanguage, level, type, structure);
+        }
+    }
+    else {
+        explanation = generateHeuristicExplanation(code, detectedLanguage, level, type, structure);
+    }
+    return {
+        explanation,
+        metadata: {
+            level,
+            type,
+            language: detectedLanguage,
+            lineCount: code.split('\n').length,
+        },
+        generatedAt: new Date().toISOString(),
+    };
+}
+function analyzeCodeStructure(code, language) {
+    const structure = {
+        functions: [],
+        classes: [],
+        imports: [],
+        controlFlow: [],
+        loops: [],
+        conditionals: 0,
+        complexity: 1, // Base complexity
+    };
+    const lines = code.split('\n');
+    if (['typescript', 'javascript'].includes(language.toLowerCase())) {
+        // Analyze functions
+        const funcRegex = /(?:export\s+)?(?:async\s+)?function\s+(\w+)\s*\(([^)]*)\)(?:\s*:\s*([^{]+))?/g;
+        let match;
+        while ((match = funcRegex.exec(code)) !== null) {
+            const lineStart = code.substring(0, match.index).split('\n').length;
+            structure.functions.push({
+                name: match[1],
+                params: match[2] ? match[2].split(',').map(p => p.trim()) : [],
+                returnType: match[3]?.trim(),
+                isAsync: match[0].includes('async'),
+                lineStart,
+                lineEnd: lineStart + 10, // Approximate
+            });
+        }
+        // Analyze arrow functions
+        const arrowRegex = /(?:export\s+)?(?:const|let)\s+(\w+)\s*=\s*(?:async\s+)?\([^)]*\)\s*(?::\s*[^=]+)?\s*=>/g;
+        while ((match = arrowRegex.exec(code)) !== null) {
+            const lineStart = code.substring(0, match.index).split('\n').length;
+            structure.functions.push({
+                name: match[1],
+                params: [],
+                isAsync: match[0].includes('async'),
+                lineStart,
+                lineEnd: lineStart + 10,
+            });
+        }
+        // Analyze imports
+        const importRegex = /import\s+(?:(\w+)|{([^}]+)}|(\*\s+as\s+\w+))\s+from\s+['"]([^'"]+)['"]/g;
+        while ((match = importRegex.exec(code)) !== null) {
+            structure.imports.push({
+                module: match[4],
+                items: match[2] ? match[2].split(',').map(i => i.trim()) : [match[1] ?? match[3] ?? 'default'],
+                isDefault: !!match[1],
+            });
+        }
+        // Analyze classes
+        const classRegex = /class\s+(\w+)/g;
+        while ((match = classRegex.exec(code)) !== null) {
+            const lineStart = code.substring(0, match.index).split('\n').length;
+            structure.classes.push({
+                name: match[1],
+                methods: [],
+                properties: [],
+                lineStart,
+            });
+        }
+        // Analyze loops
+        const forLoopRegex = /\bfor\s*\(/g;
+        let depth = 0;
+        while ((match = forLoopRegex.exec(code)) !== null) {
+            const lineNumber = code.substring(0, match.index).split('\n').length;
+            // Check if nested by looking at bracket depth
+            const beforeCode = code.substring(0, match.index);
+            const openBrackets = (beforeCode.match(/{/g) || []).length;
+            const closeBrackets = (beforeCode.match(/}/g) || []).length;
+            const nested = openBrackets - closeBrackets > 1;
+            structure.loops.push({
+                type: 'for',
+                lineNumber,
+                nested,
+            });
+            if (nested)
+                structure.complexity += 2;
+            else
+                structure.complexity += 1;
+        }
+        const whileRegex = /\bwhile\s*\(/g;
+        while ((match = whileRegex.exec(code)) !== null) {
+            const lineNumber = code.substring(0, match.index).split('\n').length;
+            structure.loops.push({
+                type: 'while',
+                lineNumber,
+                nested: false,
+            });
+            structure.complexity += 1;
+        }
+        // Count conditionals
+        structure.conditionals = (code.match(/\bif\s*\(|\belse\s+if\s*\(|\?\s*[^:]+\s*:/g) || []).length;
+        structure.complexity += structure.conditionals;
+        // Analyze control flow
+        if (code.includes('try'))
+            structure.controlFlow.push('exception handling');
+        if (code.includes('async'))
+            structure.controlFlow.push('async/await');
+        if (code.includes('.then'))
+            structure.controlFlow.push('promises');
+        if (code.includes('callback'))
+            structure.controlFlow.push('callbacks');
+        if (code.includes('yield'))
+            structure.controlFlow.push('generators');
+        if (code.includes('Observable') || code.includes('subscribe'))
+            structure.controlFlow.push('reactive');
+    }
+    return structure;
+}
+// ============================================================================
+// AI Explanation
+// ============================================================================
+async function explainWithAI(code, options) {
+    const provider = await getActiveProvider();
+    const levelInstructions = {
+        beginner: 'Explain like I\'m new to programming. Define all technical terms. Use simple analogies.',
+        intermediate: 'Assume basic programming knowledge. Focus on the logic and architecture.',
+        expert: 'Be concise and technical. Focus on advanced patterns, edge cases, and optimizations.',
+    };
+    const prompt = `Explain this ${options.language} code.
+
+## Code
+\`\`\`${options.language}
+${code}
+\`\`\`
+
+## Explanation Level
+${levelInstructions[options.level]}
+
+## Explanation Type
+${options.type === 'line-by-line' ? 'Explain each significant line or block of code.' : ''}
+${options.type === 'algorithm' ? 'Focus on the algorithm, data structures, and computational logic.' : ''}
+${options.type === 'detailed' ? 'Provide comprehensive explanation of all aspects.' : ''}
+${options.type === 'overview' ? 'Provide a high-level overview of what the code does.' : ''}
+
+${options.focusArea ? `## Focus on: ${options.focusArea}` : ''}
+
+## Code Structure Found
+- Functions: ${options.structure.functions.map(f => f.name).join(', ') || 'none'}
+- Classes: ${options.structure.classes.map(c => c.name).join(', ') || 'none'}
+- Loops: ${options.structure.loops.length}
+- Conditionals: ${options.structure.conditionals}
+- Estimated complexity: ${options.structure.complexity}
+
+## Output Format
+{
+  "summary": "One-line summary",
+  "purpose": "What problem does this code solve?",
+  "howItWorks": "Step-by-step explanation of the logic",
+  "sections": [
+    {
+      "title": "Section name",
+      "lineRange": {"start": 1, "end": 10},
+      "code": "relevant code snippet",
+      "explanation": "what this section does",
+      "keyPoints": ["key point 1", "key point 2"]
+    }
+  ],
+  ${options.includeComplexity ? `"complexity": {
+    "time": "O(n)",
+    "space": "O(1)",
+    "explanation": "Why this complexity"
+  },` : ''}
+  ${options.includePatterns ? `"patterns": [
+    {"name": "pattern name", "type": "creational|structural|behavioral|architectural", "description": "how it's used", "locationHint": "where in the code"}
+  ],` : ''}
+  "dependencies": [
+    {"name": "module", "type": "import|external|internal", "purpose": "why it's needed", "required": true}
+  ],
+  "suggestions": ["improvement suggestion"],
+  "glossary": [
+    {"term": "technical term", "definition": "simple definition", "example": "usage example"}
+  ]
+}`;
+    const response = await provider.completeJson(prompt, {
+        systemPrompt: `You are a patient, expert programming tutor. Explain code clearly at the ${options.level} level. Return valid JSON only.`,
+        temperature: 0.4,
+        maxTokens: 4096,
+    });
+    if (response.data) {
+        return response.data;
+    }
+    throw new Error('Failed to generate explanation with AI');
+}
+// ============================================================================
+// Heuristic Explanation
+// ============================================================================
+function generateHeuristicExplanation(code, language, level, type, structure) {
+    const lines = code.split('\n');
+    // Generate summary
+    const summary = generateSummary(structure);
+    // Generate purpose
+    const purpose = generatePurpose(structure);
+    // Generate how it works
+    const howItWorks = generateHowItWorks(structure, language);
+    // Generate sections
+    const sections = generateSections(code, structure, level);
+    // Generate complexity analysis
+    const complexity = generateComplexityAnalysis(structure);
+    // Generate patterns
+    const patterns = detectPatterns(code, language);
+    // Generate dependency info
+    const dependencies = structure.imports.map(imp => ({
+        name: imp.module,
+        type: imp.module.startsWith('.') ? 'internal' : 'external',
+        purpose: `Imports ${imp.items.join(', ')}`,
+        required: true,
+    }));
+    // Generate suggestions
+    const suggestions = generateSuggestions(structure, code);
+    // Generate glossary for beginners
+    const glossary = level === 'beginner' ? generateGlossary(code, language) : undefined;
+    return {
+        summary,
+        purpose,
+        howItWorks,
+        sections,
+        complexity,
+        patterns,
+        dependencies,
+        suggestions,
+        glossary,
+    };
+}
+function generateSummary(structure) {
+    const parts = [];
+    if (structure.functions.length > 0) {
+        parts.push(`${structure.functions.length} function(s)`);
+    }
+    if (structure.classes.length > 0) {
+        parts.push(`${structure.classes.length} class(es)`);
+    }
+    if (structure.loops.length > 0) {
+        parts.push(`iterative logic`);
+    }
+    if (structure.controlFlow.includes('async/await')) {
+        parts.push(`async operations`);
+    }
+    return `This code contains ${parts.join(', ') || 'basic logic'}.`;
+}
+function generatePurpose(structure) {
+    const mainFunc = structure.functions[0];
+    if (mainFunc) {
+        return `The main purpose is to implement ${humanizeName(mainFunc.name)} functionality.`;
+    }
+    if (structure.classes.length > 0) {
+        return `Defines the ${structure.classes[0].name} class for encapsulating related functionality.`;
+    }
+    return 'This code implements specific business logic or utility functions.';
+}
+function generateHowItWorks(structure, language) {
+    const steps = [];
+    if (structure.imports.length > 0) {
+        steps.push(`1. Imports dependencies: ${structure.imports.map(i => i.module).join(', ')}`);
+    }
+    if (structure.classes.length > 0) {
+        steps.push(`2. Defines class(es): ${structure.classes.map(c => c.name).join(', ')}`);
+    }
+    if (structure.functions.length > 0) {
+        for (const [i, func] of structure.functions.entries()) {
+            steps.push(`${steps.length + 1}. Function \`${func.name}\`: ${humanizeName(func.name)}`);
+        }
+    }
+    if (structure.loops.length > 0) {
+        steps.push(`${steps.length + 1}. Uses ${structure.loops.length} loop(s) for iteration`);
+    }
+    if (structure.controlFlow.length > 0) {
+        steps.push(`${steps.length + 1}. Control flow includes: ${structure.controlFlow.join(', ')}`);
+    }
+    return steps.join('\n') || 'The code executes sequentially from top to bottom.';
+}
+function generateSections(code, structure, level) {
+    const sections = [];
+    const lines = code.split('\n');
+    // Imports section
+    if (structure.imports.length > 0) {
+        const importLines = lines.filter(l => l.includes('import '));
+        sections.push({
+            title: 'Dependencies',
+            lineRange: { start: 1, end: Math.min(structure.imports.length + 1, lines.length) },
+            code: importLines.join('\n'),
+            explanation: 'This section imports external modules and dependencies needed by the code.',
+            keyPoints: structure.imports.map(i => `${i.module}: provides ${i.items.join(', ')}`),
+        });
+    }
+    // Function sections
+    for (const func of structure.functions) {
+        const funcCode = lines.slice(func.lineStart - 1, func.lineEnd).join('\n');
+        sections.push({
+            title: `Function: ${func.name}`,
+            lineRange: { start: func.lineStart, end: func.lineEnd },
+            code: funcCode,
+            explanation: `${humanizeName(func.name)}. ${func.isAsync ? 'This is an async function that returns a Promise.' : ''}`,
+            keyPoints: [
+                `Parameters: ${func.params.length > 0 ? func.params.join(', ') : 'none'}`,
+                `Returns: ${func.returnType ?? 'unspecified'}`,
+                func.isAsync ? 'Asynchronous execution' : 'Synchronous execution',
+            ],
+        });
+    }
+    // Class sections
+    for (const cls of structure.classes) {
+        sections.push({
+            title: `Class: ${cls.name}`,
+            lineRange: { start: cls.lineStart, end: cls.lineStart + 20 },
+            code: `class ${cls.name} { ... }`,
+            explanation: `Defines the ${cls.name} class which encapsulates related data and behavior.`,
+            keyPoints: [
+                'Classes group related functionality together',
+                'Methods define what actions the class can perform',
+                'Properties store the class state',
+            ],
+        });
+    }
+    return sections;
+}
+function generateComplexityAnalysis(structure) {
+    // Estimate time complexity based on loops
+    let timeComplexity = 'O(1)';
+    let spaceComplexity = 'O(1)';
+    let explanation = 'Constant time - no significant loops or recursion detected.';
+    const nestedLoops = structure.loops.filter(l => l.nested).length;
+    const regularLoops = structure.loops.filter(l => !l.nested).length;
+    if (nestedLoops > 0) {
+        timeComplexity = `O(n^${nestedLoops + 1})`;
+        explanation = `Polynomial time due to ${nestedLoops + 1} nested loops.`;
+    }
+    else if (regularLoops > 0) {
+        timeComplexity = 'O(n)';
+        explanation = 'Linear time - iterates through input once.';
+    }
+    if (regularLoops > 0) {
+        spaceComplexity = 'O(n)';
+    }
+    return {
+        time: timeComplexity,
+        space: spaceComplexity,
+        explanation,
+        bestCase: timeComplexity,
+        worstCase: timeComplexity,
+        averageCase: timeComplexity,
+    };
+}
+function detectPatterns(code, language) {
+    const patterns = [];
+    // Singleton pattern
+    if (code.includes('getInstance') || code.includes('static instance')) {
+        patterns.push({
+            name: 'Singleton',
+            type: 'creational',
+            description: 'Ensures only one instance of a class exists.',
+            locationHint: 'Look for getInstance() method or static instance property.',
+        });
+    }
+    // Factory pattern
+    if (code.includes('create') && code.includes('return new')) {
+        patterns.push({
+            name: 'Factory',
+            type: 'creational',
+            description: 'Creates objects without specifying exact class.',
+            locationHint: 'Functions that return new instances of different types.',
+        });
+    }
+    // Observer pattern
+    if (code.includes('subscribe') || code.includes('addEventListener') || code.includes('emit')) {
+        patterns.push({
+            name: 'Observer',
+            type: 'behavioral',
+            description: 'Objects subscribe to events and get notified of changes.',
+            locationHint: 'Look for subscribe/emit or addEventListener methods.',
+        });
+    }
+    // Strategy pattern
+    if (code.includes('strategy') || (code.includes('interface') && code.match(/execute|run|process/))) {
+        patterns.push({
+            name: 'Strategy',
+            type: 'behavioral',
+            description: 'Allows selecting algorithm at runtime.',
+            locationHint: 'Multiple implementations of the same interface.',
+        });
+    }
+    // Decorator pattern
+    if (code.includes('@') || code.includes('wrapper') || code.includes('decorator')) {
+        patterns.push({
+            name: 'Decorator',
+            type: 'structural',
+            description: 'Adds behavior to objects dynamically.',
+            locationHint: 'Look for @ syntax or wrapper functions.',
+        });
+    }
+    // Module pattern (common in JS)
+    if (code.includes('export') && code.includes('import')) {
+        patterns.push({
+            name: 'Module',
+            type: 'architectural',
+            description: 'Encapsulates code and exposes public API.',
+            locationHint: 'File-level exports and imports.',
+        });
+    }
+    return patterns;
+}
+function generateSuggestions(structure, code) {
+    const suggestions = [];
+    if (structure.complexity > 10) {
+        suggestions.push('Consider breaking down complex functions into smaller, focused functions.');
+    }
+    if (structure.loops.some(l => l.nested)) {
+        suggestions.push('Nested loops may impact performance. Consider using maps or memoization.');
+    }
+    if (!code.includes('try') && structure.controlFlow.includes('async/await')) {
+        suggestions.push('Add error handling (try/catch) for async operations.');
+    }
+    if (structure.functions.some(f => f.params.length > 4)) {
+        suggestions.push('Functions with many parameters could use an options object instead.');
+    }
+    if (!code.includes('const') && code.includes('let')) {
+        suggestions.push('Prefer const over let when variables are not reassigned.');
+    }
+    return suggestions;
+}
+function generateGlossary(code, language) {
+    const glossary = [];
+    if (code.includes('async')) {
+        glossary.push({
+            term: 'async',
+            definition: 'A keyword that marks a function as asynchronous, meaning it returns a Promise.',
+            example: 'async function fetchData() { }',
+        });
+    }
+    if (code.includes('await')) {
+        glossary.push({
+            term: 'await',
+            definition: 'Pauses execution until a Promise resolves, then returns its value.',
+            example: 'const data = await fetchData();',
+        });
+    }
+    if (code.includes('=>')) {
+        glossary.push({
+            term: 'Arrow function (=>)',
+            definition: 'A shorter syntax for writing functions.',
+            example: 'const add = (a, b) => a + b;',
+        });
+    }
+    if (code.includes('map(')) {
+        glossary.push({
+            term: 'map()',
+            definition: 'Creates a new array by applying a function to each element.',
+            example: '[1, 2, 3].map(x => x * 2) // [2, 4, 6]',
+        });
+    }
+    if (code.includes('filter(')) {
+        glossary.push({
+            term: 'filter()',
+            definition: 'Creates a new array with elements that pass a test.',
+            example: '[1, 2, 3, 4].filter(x => x > 2) // [3, 4]',
+        });
+    }
+    if (code.includes('reduce(')) {
+        glossary.push({
+            term: 'reduce()',
+            definition: 'Reduces an array to a single value by applying a function.',
+            example: '[1, 2, 3].reduce((sum, x) => sum + x, 0) // 6',
+        });
+    }
+    return glossary;
+}
+function humanizeName(name) {
+    return name
+        .replace(/([A-Z])/g, ' $1')
+        .replace(/_/g, ' ')
+        .toLowerCase()
+        .trim();
+}
+function detectLanguage(code) {
+    if (code.includes('interface ') || code.includes(': string') || code.includes(': number')) {
+        return 'typescript';
+    }
+    if (code.includes('def ') && code.includes(':')) {
+        return 'python';
+    }
+    if (code.includes('func ') && code.includes('package ')) {
+        return 'go';
+    }
+    return 'javascript';
+}
+//# sourceMappingURL=explain.js.map