mcp-adr-analysis-server 1.1.0

package/dist/src/utils/research-documentation.js

@@ -0,0 +1,438 @@
+/**
+ * Research documentation utilities
+ * Creates structured research documentation in docs/research/
+ */
+import { McpAdrError } from '../types/index.js';
+/**
+ * Create perform_research.md file for a research topic
+ */
+export async function createResearchDocument(researchData, outputDirectory = 'docs/research') {
+    try {
+        const { promises: fs } = await import('fs');
+        const { join } = await import('path');
+        // Ensure output directory exists
+        await fs.mkdir(outputDirectory, { recursive: true });
+        // Generate research document content
+        const content = generateResearchDocumentContent(researchData);
+        // Create filename
+        const filename = `perform_research_${researchData.id.toLowerCase().replace(/[^a-z0-9]/g, '_')}.md`;
+        const filePath = join(outputDirectory, filename);
+        // Write file
+        await fs.writeFile(filePath, content, 'utf-8');
+        return {
+            filePath,
+            content,
+        };
+    }
+    catch (error) {
+        throw new McpAdrError(`Failed to create research document: ${error instanceof Error ? error.message : String(error)}`, 'RESEARCH_DOCUMENT_ERROR');
+    }
+}
+/**
+ * Generate research document content in markdown format
+ */
+function generateResearchDocumentContent(research) {
+    const now = new Date().toISOString().split('T')[0];
+    return `# Research: ${research.title}
+
+**Research ID**: ${research.id}  
+**Category**: ${research.category}  
+**Status**: ${research.status}  
+**Priority**: ${research.priority}  
+**Created**: ${now}  
+
+## Overview
+
+This document tracks the research progress for "${research.title}". It includes research questions, methodology, findings, and recommendations.
+
+## Research Questions
+
+${research.questions
+        .map((q, index) => `
+### ${index + 1}. ${q.question}
+
+**Question ID**: ${q.id}  
+**Type**: ${q.type}  
+**Methodology**: ${q.methodology}  
+
+**Status**: [ ] Not Started / [ ] In Progress / [ ] Completed
+
+**Findings**:
+- [ ] Finding 1
+- [ ] Finding 2
+- [ ] Finding 3
+
+**Notes**:
+<!-- Add research notes here -->
+
+---
+`)
+        .join('')}
+
+## Timeline & Milestones
+
+**Start Date**: ${research.timeline.startDate}  
+**End Date**: ${research.timeline.endDate}  
+
+### Milestones
+
+${research.timeline.milestones
+        .map(milestone => `
+- **${milestone.name}** (${milestone.date}): ${milestone.description}
+`)
+        .join('')}
+
+## Resources Required
+
+${research.resources
+        .map(resource => `
+- **${resource.type}**: ${resource.description} (Status: ${resource.status})
+`)
+        .join('')}
+
+## Research Progress
+
+### Current Status
+- [ ] Research planning completed
+- [ ] Resources secured
+- [ ] Research questions defined
+- [ ] Methodology established
+- [ ] Data collection started
+- [ ] Analysis in progress
+- [ ] Findings documented
+- [ ] Recommendations formulated
+- [ ] Research completed
+
+### Progress Notes
+
+| Date | Progress | Notes |
+|------|----------|-------|
+| ${now} | Research document created | Initial research planning |
+<!-- Add progress entries here -->
+
+## Findings
+
+${research.findings.length > 0
+        ? research.findings
+            .map(finding => `
+### Finding: ${finding.finding}
+
+**Date**: ${finding.date}  
+**Confidence**: ${finding.confidence * 100}%  
+**Impact**: ${finding.impact}  
+
+**Details**:
+<!-- Add detailed finding information here -->
+
+---
+`)
+            .join('')
+        : `
+<!-- Findings will be documented here as research progresses -->
+
+### Template for Findings
+
+**Finding**: [Brief description]  
+**Date**: [Date of finding]  
+**Confidence**: [0-100%]  
+**Impact**: [Low/Medium/High/Critical]  
+
+**Details**:
+[Detailed explanation of the finding]
+
+**Evidence**:
+- [Supporting evidence 1]
+- [Supporting evidence 2]
+
+**Implications**:
+- [Implication 1]
+- [Implication 2]
+
+---
+`}
+
+## Recommendations
+
+${research.recommendations.length > 0
+        ? research.recommendations
+            .map((rec, index) => `
+### Recommendation ${index + 1}: ${rec.recommendation}
+
+**Priority**: ${rec.priority}  
+**Rationale**: ${rec.rationale}  
+**Implementation**: ${rec.implementation}  
+
+---
+`)
+            .join('')
+        : `
+<!-- Recommendations will be documented here based on research findings -->
+
+### Template for Recommendations
+
+**Recommendation**: [Brief description]  
+**Priority**: [Critical/High/Medium/Low]  
+**Rationale**: [Why this recommendation is important]  
+**Implementation**: [How to implement this recommendation]  
+
+**Expected Benefits**:
+- [Benefit 1]
+- [Benefit 2]
+
+**Risks & Mitigation**:
+- [Risk 1]: [Mitigation strategy]
+- [Risk 2]: [Mitigation strategy]
+
+**Success Criteria**:
+- [Criteria 1]
+- [Criteria 2]
+
+---
+`}
+
+## Research Methodology
+
+### Approach
+<!-- Document the research approach and methodology here -->
+
+### Data Collection
+<!-- Document data collection methods and sources -->
+
+### Analysis Methods
+<!-- Document analysis methods and tools -->
+
+### Validation Approach
+<!-- Document how findings will be validated -->
+
+## Risk Management
+
+### Identified Risks
+<!-- Document potential risks to research success -->
+
+### Mitigation Strategies
+<!-- Document risk mitigation approaches -->
+
+## Quality Assurance
+
+### Review Process
+<!-- Document peer review and validation process -->
+
+### Documentation Standards
+<!-- Document quality standards for research documentation -->
+
+## Knowledge Sharing
+
+### Stakeholders
+<!-- List stakeholders who should be informed of findings -->
+
+### Communication Plan
+<!-- Document how findings will be communicated -->
+
+### Follow-up Actions
+<!-- Document planned follow-up actions based on research -->
+
+## References
+
+<!-- Add references to relevant ADRs, documentation, and external sources -->
+
+### Related ADRs
+<!-- Link to relevant Architectural Decision Records -->
+
+### External References
+<!-- Link to external research, documentation, and resources -->
+
+## Appendices
+
+### Appendix A: Research Data
+<!-- Include raw research data and supporting materials -->
+
+### Appendix B: Analysis Details
+<!-- Include detailed analysis and calculations -->
+
+### Appendix C: Additional Resources
+<!-- Include additional supporting materials -->
+
+---
+
+**Document Status**: ${research.status}  
+**Last Updated**: ${now}  
+**Next Review**: [Schedule next review date]  
+
+<!-- 
+Research Document Guidelines:
+1. Update progress regularly
+2. Document all findings with evidence
+3. Include confidence levels for findings
+4. Link to relevant ADRs and documentation
+5. Share findings with stakeholders
+6. Archive completed research appropriately
+-->
+`;
+}
+/**
+ * Create research index file
+ */
+export async function createResearchIndex(researchDocuments, outputDirectory = 'docs/research') {
+    try {
+        const { promises: fs } = await import('fs');
+        const { join } = await import('path');
+        // Ensure output directory exists
+        await fs.mkdir(outputDirectory, { recursive: true });
+        // Generate index content
+        const content = generateResearchIndexContent(researchDocuments);
+        const filePath = join(outputDirectory, 'README.md');
+        // Write file
+        await fs.writeFile(filePath, content, 'utf-8');
+        return {
+            filePath,
+            content,
+        };
+    }
+    catch (error) {
+        throw new McpAdrError(`Failed to create research index: ${error instanceof Error ? error.message : String(error)}`, 'RESEARCH_INDEX_ERROR');
+    }
+}
+/**
+ * Generate research index content
+ */
+function generateResearchIndexContent(researchDocuments) {
+    const now = new Date().toISOString().split('T')[0];
+    // Group by status
+    const byStatus = researchDocuments.reduce((acc, doc) => {
+        if (!acc[doc.status])
+            acc[doc.status] = [];
+        acc[doc.status].push(doc);
+        return acc;
+    }, {});
+    // Group by category
+    const byCategory = researchDocuments.reduce((acc, doc) => {
+        if (!acc[doc.category])
+            acc[doc.category] = [];
+        acc[doc.category].push(doc);
+        return acc;
+    }, {});
+    return `# Research Documentation Index
+
+This directory contains all research documentation for the project. Each research topic has its own \`perform_research_*.md\` file with detailed tracking and findings.
+
+**Last Updated**: ${now}  
+**Total Research Topics**: ${researchDocuments.length}  
+
+## Quick Stats
+
+- **Planned**: ${byStatus['planned']?.length || 0}
+- **In Progress**: ${byStatus['in_progress']?.length || 0}
+- **Completed**: ${byStatus['completed']?.length || 0}
+- **Cancelled**: ${byStatus['cancelled']?.length || 0}
+
+## Research by Status
+
+### 🔄 In Progress
+${byStatus['in_progress']
+        ?.map(doc => `
+- [${doc.title}](./perform_research_${doc.id.toLowerCase().replace(/[^a-z0-9]/g, '_')}.md) (${doc.priority} priority)
+`)
+        .join('') || 'No research currently in progress.'}
+
+### 📋 Planned
+${byStatus['planned']
+        ?.map(doc => `
+- [${doc.title}](./perform_research_${doc.id.toLowerCase().replace(/[^a-z0-9]/g, '_')}.md) (${doc.priority} priority)
+`)
+        .join('') || 'No research currently planned.'}
+
+### ✅ Completed
+${byStatus['completed']
+        ?.map(doc => `
+- [${doc.title}](./perform_research_${doc.id.toLowerCase().replace(/[^a-z0-9]/g, '_')}.md) (${doc.priority} priority)
+`)
+        .join('') || 'No research completed yet.'}
+
+### ❌ Cancelled
+${byStatus['cancelled']
+        ?.map(doc => `
+- [${doc.title}](./perform_research_${doc.id.toLowerCase().replace(/[^a-z0-9]/g, '_')}.md) (${doc.priority} priority)
+`)
+        .join('') || 'No research cancelled.'}
+
+## Research by Category
+
+${Object.entries(byCategory)
+        .map(([category, docs]) => `
+### ${category.charAt(0).toUpperCase() + category.slice(1)}
+${docs
+        .map(doc => `
+- [${doc.title}](./perform_research_${doc.id.toLowerCase().replace(/[^a-z0-9]/g, '_')}.md) (${doc.status}, ${doc.priority} priority)
+`)
+        .join('')}
+`)
+        .join('')}
+
+## Research Guidelines
+
+### Creating New Research
+1. Use the \`generate_research_questions\` MCP tool to create research questions
+2. Create a new \`perform_research_*.md\` file using the research documentation utilities
+3. Update this index file to include the new research
+4. Begin research execution following the documented methodology
+
+### Research Process
+1. **Planning**: Define questions, methodology, and timeline
+2. **Execution**: Collect data and conduct analysis
+3. **Documentation**: Record findings with evidence and confidence levels
+4. **Review**: Peer review and validation of findings
+5. **Communication**: Share findings with stakeholders
+6. **Implementation**: Apply recommendations and track outcomes
+
+### Quality Standards
+- All findings must include confidence levels and supporting evidence
+- Research methodology must be clearly documented
+- Regular progress updates are required
+- Peer review is mandatory for critical findings
+- All research must link to relevant ADRs and architectural decisions
+
+### Documentation Standards
+- Use the provided research document template
+- Include clear research questions and methodology
+- Document all findings with dates and confidence levels
+- Provide actionable recommendations with implementation guidance
+- Link to relevant ADRs and external references
+
+## Research Tools
+
+### MCP Tools Available
+- \`generate_research_questions\`: Generate context-aware research questions
+- \`analyze_environment\`: Analyze environment context for research
+- \`generate_rules\`: Generate architectural rules from research findings
+
+### Research Methodologies
+- Literature review and analysis
+- Experimental validation and testing
+- Prototype development and evaluation
+- Stakeholder interviews and surveys
+- Architectural analysis and modeling
+
+## Knowledge Management
+
+### Research Findings Integration
+- Update relevant ADRs with research findings
+- Create new ADRs based on research recommendations
+- Update architectural documentation with new insights
+- Share findings through team knowledge sharing sessions
+
+### Research Archive
+- Completed research is archived but remains accessible
+- Research findings are integrated into project knowledge base
+- Lessons learned are documented for future research
+- Research methodologies are refined based on experience
+
+---
+
+**Research Coordination**: [Assign research coordinator]  
+**Next Review**: [Schedule regular research review meetings]  
+**Knowledge Sharing**: [Plan knowledge sharing sessions]  
+
+For questions about research processes or to propose new research topics, please contact the research coordinator or create an issue in the project repository.
+`;
+}
+//# sourceMappingURL=research-documentation.js.map

package/dist/src/utils/research-documentation.js.map

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

package/dist/src/utils/research-integration.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Research integration utilities using prompt-driven AI analysis
+ * Implements intelligent research findings incorporation into ADRs
+ */
+export interface ResearchFile {
+    filename: string;
+    content: string;
+    lastModified: string;
+    size: number;
+    path: string;
+}
+export interface ResearchTopic {
+    id: string;
+    title: string;
+    category: string;
+    description: string;
+    sourceFiles: string[];
+    keyFindings: string[];
+    evidence: string[];
+    confidence: number;
+    relevanceScore: number;
+    lastUpdated: string;
+    tags: string[];
+}
+export interface ResearchInsight {
+    insight: string;
+    impact: 'low' | 'medium' | 'high' | 'critical';
+    category: string;
+    supportingTopics: string[];
+    actionRequired: boolean;
+    urgency: 'low' | 'medium' | 'high' | 'critical';
+}
+export interface AdrImpactAnalysis {
+    adrId: string;
+    adrTitle: string;
+    impactLevel: 'none' | 'low' | 'medium' | 'high' | 'critical';
+    impactType: string;
+    affectedSections: string[];
+    relatedTopics: string[];
+    findings: string[];
+    recommendedAction: 'no_action' | 'review' | 'update' | 'deprecate' | 'supersede';
+    urgency: 'low' | 'medium' | 'high' | 'critical';
+    confidence: number;
+    reasoning: string;
+}
+/**
+ * Monitor research directory for files
+ */
+export declare function monitorResearchDirectory(researchPath?: string): Promise<{
+    monitoringPrompt: string;
+    instructions: string;
+}>;
+/**
+ * Extract research topics from files
+ */
+export declare function extractResearchTopics(researchPath?: string, existingTopics?: string[]): Promise<{
+    extractionPrompt: string;
+    instructions: string;
+}>;
+/**
+ * Evaluate research impact on existing ADRs
+ */
+export declare function evaluateResearchImpact(researchTopics: ResearchTopic[], adrDirectory?: string): Promise<{
+    evaluationPrompt: string;
+    instructions: string;
+}>;
+/**
+ * Generate ADR update suggestions
+ */
+export declare function generateAdrUpdateSuggestions(adrId: string, researchFindings: Array<{
+    finding: string;
+    evidence: string[];
+    impact: string;
+}>, updateType: 'content' | 'status' | 'consequences' | 'alternatives' | 'deprecation', adrDirectory?: string): Promise<{
+    updatePrompt: string;
+    instructions: string;
+}>;
+/**
+ * Create research file template
+ */
+export declare function createResearchTemplate(title: string, category?: string): string;
+/**
+ * Prompt for action confirmation before generating drafts
+ */
+export declare function promptForActionConfirmation(action: string, details: string, impact: 'low' | 'medium' | 'high' | 'critical'): {
+    confirmationPrompt: string;
+    instructions: string;
+};
+//# sourceMappingURL=research-integration.d.ts.map

package/dist/src/utils/research-integration.d.ts.map

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