mcp-adr-analysis-server 2.1.9 → 2.1.20

package/dist/src/tools/perform-research-tool.js

@@ -0,0 +1,324 @@
+/**
+ * Perform Research Tool
+ *
+ * New MCP tool that uses the research orchestrator to answer research questions
+ * using cascading sources: project files → knowledge graph → environment → web search
+ */
+import { McpAdrError } from '../types/index.js';
+import { ResearchOrchestrator } from '../utils/research-orchestrator.js';
+import { ToolContextManager } from '../utils/context-document-manager.js';
+import * as path from 'path';
+/**
+ * Perform research using the orchestrated multi-source approach
+ *
+ * @description Executes comprehensive research using cascading data sources:
+ * project files → knowledge graph → environment analysis → web search.
+ * Returns structured research results with confidence scoring and source attribution.
+ *
+ * @param {Object} args - Research configuration parameters
+ * @param {string} args.question - The research question to investigate
+ * @param {string} [args.projectPath] - Path to project root (defaults to cwd)
+ * @param {string} [args.adrDirectory] - ADR directory relative to project (defaults to 'docs/adrs')
+ * @param {number} [args.confidenceThreshold] - Minimum confidence for results (0-1, defaults to 0.6)
+ * @param {boolean} [args.performWebSearch] - Enable web search as fallback (defaults to true)
+ *
+ * @returns {Promise<any>} Research results with answer, confidence, and sources
+ *
+ * @throws {McpAdrError} When question is empty or research orchestration fails
+ *
+ * @example
+ * ```typescript
+ * // Basic research question
+ * const result = await performResearch({
+ *   question: 'What authentication methods are used in this project?'
+ * });
+ *
+ * console.log(result.answer);     // Research findings
+ * console.log(result.confidence); // 0.85
+ * console.log(result.sources);    // ['project-files', 'knowledge-graph']
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Advanced research with custom settings
+ * const result = await performResearch({
+ *   question: 'How does the deployment pipeline work?',
+ *   projectPath: '/path/to/project',
+ *   confidenceThreshold: 0.8,
+ *   performWebSearch: false
+ * });
+ * ```
+ *
+ * @since 2.0.0
+ * @category Research
+ * @category Tools
+ * @mcp-tool
+ */
+export async function performResearch(args, context) {
+    const { question, projectPath = process.cwd(), adrDirectory = 'docs/adrs', confidenceThreshold = 0.6, performWebSearch = true, } = args;
+    if (!question || question.trim().length === 0) {
+        throw new McpAdrError('Research question is required', 'INVALID_INPUT');
+    }
+    try {
+        context?.info(`🔍 Starting research: ${question}`);
+        context?.report_progress(0, 100);
+        // Create research orchestrator
+        const orchestrator = new ResearchOrchestrator(projectPath, adrDirectory);
+        orchestrator.setConfidenceThreshold(confidenceThreshold);
+        context?.info('📁 Searching project files...');
+        context?.report_progress(25, 100);
+        // Perform research (orchestrator handles: files → knowledge graph → environment → web)
+        context?.info('📊 Querying knowledge graph and environment resources...');
+        context?.report_progress(50, 100);
+        const research = await orchestrator.answerResearchQuestion(question);
+        context?.info('🌐 Analyzing results and preparing response...');
+        context?.report_progress(75, 100);
+        // Format response
+        let response = `# Research Results: ${question}
+
+## Summary
+${research.answer || 'No conclusive answer found from available sources.'}
+
+## Confidence Score: ${(research.confidence * 100).toFixed(1)}%
+
+## Sources Consulted
+`;
+        // Add source details
+        if (research.sources.length === 0) {
+            response += '\n*No relevant sources found*\n';
+        }
+        else {
+            for (const source of research.sources) {
+                response += `\n### ${formatSourceName(source.type)}
+- **Confidence**: ${(source.confidence * 100).toFixed(1)}%
+- **Timestamp**: ${source.timestamp}
+`;
+                // Add source-specific details
+                if (source.type === 'project_files') {
+                    const files = source.data.files || [];
+                    response += `- **Files Found**: ${files.length}\n`;
+                    if (files.length > 0) {
+                        response += '\n**Relevant Files**:\n';
+                        files.slice(0, 10).forEach((file) => {
+                            const relevance = source.data.relevance?.[file];
+                            response += `- \`${file}\`${relevance ? ` (relevance: ${(relevance * 100).toFixed(0)}%)` : ''}\n`;
+                        });
+                        if (files.length > 10) {
+                            response += `\n*... and ${files.length - 10} more files*\n`;
+                        }
+                    }
+                }
+                if (source.type === 'knowledge_graph') {
+                    const nodes = source.data.nodes || [];
+                    response += `- **Related ADRs**: ${nodes.length}\n`;
+                }
+                if (source.type === 'environment') {
+                    const capabilities = source.data.capabilities || [];
+                    response += `- **Available Capabilities**: ${capabilities.join(', ')}\n`;
+                    if (source.data.data?.length > 0) {
+                        response += '\n**Environment Data**:\n';
+                        source.data.data.forEach((cap) => {
+                            response += `- **${cap.capability}**: ${cap.found ? '✅ Data found' : '❌ No data'}\n`;
+                        });
+                    }
+                }
+            }
+        }
+        // Web search recommendation
+        if (research.needsWebSearch && performWebSearch) {
+            response += `
+
+## 🌐 Web Search Recommended
+
+Confidence is below threshold (${(confidenceThreshold * 100).toFixed(0)}%).
+Consider performing a web search for additional information:
+
+**Suggested search queries**:
+${generateSearchQueries(question)
+                .map(q => `- "${q}"`)
+                .join('\n')}
+`;
+        }
+        // Metadata
+        response += `
+
+## Research Metadata
+- **Duration**: ${research.metadata.duration}ms
+- **Sources Queried**: ${research.metadata.sourcesQueried.join(', ')}
+- **Files Analyzed**: ${research.metadata.filesAnalyzed}
+- **Overall Confidence**: ${(research.confidence * 100).toFixed(1)}%
+
+## Next Steps
+
+`;
+        if (research.confidence >= 0.8) {
+            response += `✅ High confidence answer. You can proceed with this information.
+`;
+        }
+        else if (research.confidence >= 0.6) {
+            response += `⚠️ Moderate confidence. Consider validating findings with additional sources.
+`;
+        }
+        else {
+            response += `❌ Low confidence. Web search or manual research recommended.
+`;
+        }
+        // Recommendations based on sources
+        if (research.sources.some(s => s.type === 'project_files')) {
+            response += `
+### Recommended Actions
+1. Review the identified project files for detailed implementation information
+2. Check for any related configuration files or documentation
+3. Consider creating or updating ADRs to document findings
+`;
+        }
+        if (research.sources.some(s => s.type === 'environment')) {
+            response += `
+### Environment Insights
+- Live environment data is available for verification
+- Consider running environment analysis tools for more details
+- Check environment configuration against ADR requirements
+`;
+        }
+        context?.info('✅ Research complete!');
+        context?.report_progress(100, 100);
+        // Save research context for future sessions
+        try {
+            const contextManager = new ToolContextManager(projectPath);
+            await contextManager.initialize();
+            const contextDoc = {
+                metadata: {
+                    toolName: 'perform_research',
+                    toolVersion: '2.0.0',
+                    generated: new Date().toISOString(),
+                    projectPath,
+                    projectName: path.basename(projectPath),
+                    status: research.confidence >= confidenceThreshold ? 'success' : 'partial',
+                    confidence: research.confidence * 100,
+                },
+                quickReference: `Research: "${question}" - ${(research.confidence * 100).toFixed(0)}% confidence. Sources: ${research.sources.map(s => formatSourceName(s.type)).join(', ')}`,
+                executionSummary: {
+                    status: `Research completed with ${(research.confidence * 100).toFixed(0)}% confidence`,
+                    confidence: research.confidence * 100,
+                    keyFindings: [
+                        `Question: ${question}`,
+                        `Confidence: ${(research.confidence * 100).toFixed(1)}%`,
+                        `Sources consulted: ${research.metadata.sourcesQueried.join(', ')}`,
+                        `Files analyzed: ${research.metadata.filesAnalyzed}`,
+                        `Duration: ${research.metadata.duration}ms`,
+                    ],
+                },
+                detectedContext: {
+                    question,
+                    answer: research.answer,
+                    confidence: research.confidence,
+                    sources: research.sources.map(s => ({
+                        type: s.type,
+                        confidence: s.confidence,
+                        timestamp: s.timestamp,
+                        dataType: s.data ? Object.keys(s.data).join(', ') : 'none',
+                    })),
+                    needsWebSearch: research.needsWebSearch,
+                },
+                keyDecisions: [
+                    {
+                        decision: `Research approach: ${research.metadata.sourcesQueried.join(' → ')}`,
+                        rationale: `Cascading research strategy from local project files to external sources`,
+                        alternatives: ['Direct web search', 'Manual code review'],
+                    },
+                ],
+                learnings: {
+                    successes: research.confidence >= 0.8
+                        ? ['High confidence research results obtained', 'Sufficient local context available']
+                        : research.confidence >= 0.6
+                            ? ['Moderate confidence results', 'Some local context found']
+                            : [],
+                    failures: research.confidence < 0.6
+                        ? [
+                            'Low confidence - insufficient local data',
+                            'May need web search or manual research',
+                        ]
+                        : [],
+                    recommendations: research.confidence >= 0.8
+                        ? ['Results can be used with confidence', 'Consider documenting findings in ADR']
+                        : research.confidence >= 0.6
+                            ? [
+                                'Validate findings with additional sources',
+                                'Consider cross-referencing with documentation',
+                            ]
+                            : ['Perform web search for additional context', 'Manual research recommended'],
+                    environmentSpecific: [],
+                },
+                relatedDocuments: {
+                    adrs: [],
+                    configs: [],
+                    otherContexts: [],
+                },
+                rawData: {
+                    research: {
+                        answer: research.answer,
+                        confidence: research.confidence,
+                        sources: research.sources,
+                        needsWebSearch: research.needsWebSearch,
+                        metadata: research.metadata,
+                    },
+                },
+            };
+            await contextManager.saveContext('research', contextDoc);
+            context?.info('💾 Research context saved for future reference');
+        }
+        catch (contextError) {
+            // Don't fail the research if context saving fails
+            context?.info(`⚠️ Failed to save research context: ${contextError}`);
+        }
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: response,
+                },
+            ],
+        };
+    }
+    catch (error) {
+        throw new McpAdrError(`Failed to perform research: ${error instanceof Error ? error.message : String(error)}`, 'RESEARCH_ERROR');
+    }
+}
+/**
+ * Format source name for display
+ */
+function formatSourceName(sourceType) {
+    const names = {
+        project_files: '📁 Project Files',
+        knowledge_graph: '🧠 Knowledge Graph',
+        environment: '🔧 Environment Resources',
+        web_search: '🌐 Web Search',
+    };
+    return names[sourceType] || sourceType;
+}
+/**
+ * Generate web search queries based on research question
+ */
+function generateSearchQueries(question) {
+    const queries = [question];
+    // Add variations
+    const questionLower = question.toLowerCase();
+    if (questionLower.includes('what')) {
+        queries.push(question.replace(/^what/i, 'how to'));
+    }
+    if (questionLower.includes('how')) {
+        queries.push(question.replace(/^how/i, 'best practices for'));
+    }
+    // Add context-specific queries
+    if (questionLower.includes('kubernetes') || questionLower.includes('k8s')) {
+        queries.push(`${question} kubernetes best practices`);
+    }
+    if (questionLower.includes('docker')) {
+        queries.push(`${question} docker production`);
+    }
+    if (questionLower.includes('openshift')) {
+        queries.push(`${question} openshift documentation`);
+    }
+    return queries.slice(0, 3); // Limit to top 3
+}
+//# sourceMappingURL=perform-research-tool.js.map

package/dist/src/tools/perform-research-tool.js.map

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

package/dist/src/tools/research-question-tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"research-question-tool.d.ts","sourceRoot":"","sources":["../../../src/tools/research-question-tool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;GAGG;AACH,wBAAsB,yBAAyB,CAAC,IAAI,EAAE;IACpD,YAAY,CAAC,EAAE,aAAa,GAAG,WAAW,GAAG,WAAW,GAAG,UAAU,GAAG,eAAe,CAAC;IACxF,eAAe,CAAC,EAAE;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,EAAE,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;QACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,QAAQ,CAAC,EAAE,KAAK,CAAC;QACf,EAAE,EAAE,MAAM,CAAC;QACX,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;IACH,cAAc,CAAC,EAAE;QACf,YAAY,EAAE,GAAG,EAAE,CAAC;QACpB,QAAQ,EAAE,GAAG,EAAE,CAAC;QAChB,IAAI,EAAE,GAAG,EAAE,CAAC;QACZ,aAAa,EAAE,GAAG,EAAE,CAAC;KACtB,CAAC;IACF,iBAAiB,CAAC,EAAE;QAClB,IAAI,EAAE,GAAG,EAAE,CAAC;QACZ,QAAQ,EAAE,GAAG,EAAE,CAAC;QAChB,IAAI,EAAE,GAAG,EAAE,CAAC;QACZ,aAAa,EAAE,GAAG,EAAE,CAAC;KACtB,CAAC;IACF,iBAAiB,CAAC,EAAE,KAAK,CAAC;QACxB,EAAE,EAAE,MAAM,CAAC;QACX,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;IACH,eAAe,CAAC,EAAE,KAAK,CAAC;QACtB,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC,CAAC;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,GAAG,OAAO,CAAC,GAAG,CAAC,CAihBf"}
+{"version":3,"file":"research-question-tool.d.ts","sourceRoot":"","sources":["../../../src/tools/research-question-tool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;GAGG;AACH,wBAAsB,yBAAyB,CAAC,IAAI,EAAE;IACpD,YAAY,CAAC,EAAE,aAAa,GAAG,WAAW,GAAG,WAAW,GAAG,UAAU,GAAG,eAAe,CAAC;IACxF,eAAe,CAAC,EAAE;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,EAAE,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;QACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,QAAQ,CAAC,EAAE,KAAK,CAAC;QACf,EAAE,EAAE,MAAM,CAAC;QACX,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;IACH,cAAc,CAAC,EAAE;QACf,YAAY,EAAE,GAAG,EAAE,CAAC;QACpB,QAAQ,EAAE,GAAG,EAAE,CAAC;QAChB,IAAI,EAAE,GAAG,EAAE,CAAC;QACZ,aAAa,EAAE,GAAG,EAAE,CAAC;KACtB,CAAC;IACF,iBAAiB,CAAC,EAAE;QAClB,IAAI,EAAE,GAAG,EAAE,CAAC;QACZ,QAAQ,EAAE,GAAG,EAAE,CAAC;QAChB,IAAI,EAAE,GAAG,EAAE,CAAC;QACZ,aAAa,EAAE,GAAG,EAAE,CAAC;KACtB,CAAC;IACF,iBAAiB,CAAC,EAAE,KAAK,CAAC;QACxB,EAAE,EAAE,MAAM,CAAC;QACX,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;IACH,eAAe,CAAC,EAAE,KAAK,CAAC;QACtB,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC,CAAC;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,GAAG,OAAO,CAAC,GAAG,CAAC,CAqiBf"}

package/dist/src/tools/research-question-tool.js

@@ -29,11 +29,11 @@ export async function generateResearchQuestions(args) {
                             projectPath,
                             technologies: [],
                             patterns: [],
-                            projectType: 'research-methodology'
+                            projectType: 'research-methodology',
                         }, {
                             domains: ['data-architecture'],
                             depth: 'intermediate',
-                            cacheEnabled: true
+                            cacheEnabled: true,
                         });
                         knowledgeContext = `\n## Research Methodology Knowledge Enhancement\n\n${knowledgeResult.prompt}\n\n---\n`;
                     }
@@ -55,10 +55,12 @@ export async function generateResearchQuestions(args) {
 - **Enhanced Mode**: ${enhancedMode ? '✅ Applied' : '❌ Disabled'}
 - **Knowledge Domains**: Research methods, statistical analysis, knowledge mapping, scientific inquiry
 
-${knowledgeContext ? `## Research Methodology Context
+${knowledgeContext
+                                ? `## Research Methodology Context
 
 ${knowledgeContext}
-` : ''}
+`
+                                : ''}
 
 ${result.instructions}
 
@@ -103,7 +105,7 @@ This correlation analysis enables:
                     scope: 'project',
                     objectives: ['Identify relevant architectural patterns and decisions'],
                     constraints: [],
-                    timeline: 'Not specified'
+                    timeline: 'Not specified',
                 };
                 const effectiveResearchContext = researchContext || defaultResearchContext;
                 if (!researchContext) {
@@ -163,7 +165,7 @@ This relevance analysis provides:
                     scope: 'project',
                     objectives: ['Generate relevant research questions for architectural analysis'],
                     constraints: [],
-                    timeline: 'Not specified'
+                    timeline: 'Not specified',
                 };
                 const effectiveResearchContext = researchContext || defaultResearchContext;
                 if (!researchContext) {
@@ -187,7 +189,7 @@ Create detailed research plans that help teams investigate architectural decisio
 Focus on practical research approaches that can be executed by development teams.
 Provide clear guidance on research methods, success criteria, and expected outcomes.
 IMPORTANT: Save the generated research questions to the docs/research directory as specified in the instructions.`,
-                    responseFormat: 'text'
+                    responseFormat: 'text',
                 });
                 if (executionResult.isAIGenerated) {
                     // AI execution successful - return actual research question generation results
@@ -337,10 +339,10 @@ This tracking system enables:
                         'Identify architectural patterns and best practices',
                         'Analyze current system design decisions',
                         'Discover improvement opportunities',
-                        'Evaluate technology choices and alternatives'
+                        'Evaluate technology choices and alternatives',
                     ],
                     constraints: ['Time and resource limitations'],
-                    timeline: 'Not specified'
+                    timeline: 'Not specified',
                 };
                 const effectiveResearchContext = researchContext || defaultResearchContext;
                 // Log warning if using defaults

package/dist/src/tools/research-question-tool.js.map

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

package/dist/src/tools/review-existing-adrs-tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"review-existing-adrs-tool.d.ts","sourceRoot":"","sources":["../../../src/tools/review-existing-adrs-tool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAyCvE;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC7C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,eAAe,CAAC;IACvD,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;CAC3C,GAAG,OAAO,CAAC,GAAG,CAAC,CAkSf"}
+{"version":3,"file":"review-existing-adrs-tool.d.ts","sourceRoot":"","sources":["../../../src/tools/review-existing-adrs-tool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AA0CvE;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE;IAC7C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,eAAe,CAAC;IACvD,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;CAC3C,GAAG,OAAO,CAAC,GAAG,CAAC,CA4Uf"}

package/dist/src/tools/review-existing-adrs-tool.js

@@ -5,6 +5,7 @@
  */
 import { McpAdrError } from '../types/index.js';
 import { TreeSitterAnalyzer } from '../utils/tree-sitter-analyzer.js';
+import { ResearchOrchestrator } from '../utils/research-orchestrator.js';
 import * as path from 'path';
 import * as fs from 'fs/promises';
 /**
@@ -15,7 +16,10 @@ export async function reviewExistingAdrs(args) {
     try {
         // Step 1: Discover existing ADRs
         const { discoverAdrsInDirectory } = await import('../utils/adr-discovery.js');
-        const discoveryResult = await discoverAdrsInDirectory(adrDirectory, true, projectPath);
+        const discoveryResult = await discoverAdrsInDirectory(adrDirectory, projectPath, {
+            includeContent: true,
+            includeTimeline: false,
+        });
         if (discoveryResult.totalAdrs === 0) {
             return {
                 content: [
@@ -56,9 +60,41 @@ export async function reviewExistingAdrs(args) {
         if (adrsToReview.length === 0) {
             throw new McpAdrError(`No ADRs found matching: ${specificAdr}`, 'ADR_NOT_FOUND');
         }
-        // Step 3: Analyze code structure
+        // Step 3: Research environment and implementation state
+        let environmentContext = '';
+        let researchConfidence = 0;
+        try {
+            const orchestrator = new ResearchOrchestrator(projectPath, adrDirectory);
+            const research = await orchestrator.answerResearchQuestion(`Analyze ADR implementation status:
+1. What architectural decisions are documented in ADRs?
+2. How are these decisions reflected in the current codebase?
+3. What is the current infrastructure and deployment state?
+4. Are there any gaps between documented decisions and actual implementation?`);
+            researchConfidence = research.confidence;
+            const envSource = research.sources.find(s => s.type === 'environment');
+            const capabilities = envSource?.data?.capabilities || [];
+            environmentContext = `
+
+## 🔍 Research-Driven Analysis
+
+**Research Confidence**: ${(research.confidence * 100).toFixed(1)}%
+
+### Implementation Context
+${research.answer || 'No specific implementation context found'}
+
+### Environment Infrastructure
+${capabilities.length > 0 ? capabilities.map((c) => `- ${c}`).join('\n') : '- No infrastructure tools detected'}
+
+### Sources Analyzed
+${research.sources.map(s => `- ${s.type}: Consulted`).join('\n')}
+`;
+        }
+        catch (error) {
+            environmentContext = `\n## ⚠️ Research Analysis\nFailed to analyze environment: ${error instanceof Error ? error.message : String(error)}\n`;
+        }
+        // Step 4: Analyze code structure
         const codeAnalysis = await analyzeCodeStructure(projectPath, includeTreeSitter);
-        // Step 4: Review each ADR
+        // Step 5: Review each ADR
         const reviewResults = [];
         for (const adr of adrsToReview) {
             const reviewResult = await reviewSingleAdr(adr, codeAnalysis, analysisDepth, projectPath);
@@ -83,9 +119,12 @@ export async function reviewExistingAdrs(args) {
 - **Project**: ${path.basename(projectPath)}
 - **ADRs Reviewed**: ${reviewResults.length}
 - **Overall Compliance Score**: ${overallScore.toFixed(1)}/10
+- **Research Confidence**: ${(researchConfidence * 100).toFixed(1)}%
 - **Analysis Depth**: ${analysisDepth}
 - **Tree-sitter Analysis**: ${includeTreeSitter ? '✅ Enabled' : '❌ Disabled'}
 
+${environmentContext}
+
 ## Summary Statistics
 - **Total Gaps Identified**: ${totalGaps}
 - **ADRs Needing Updates**: ${needsUpdate}