mcp-adr-analysis-server 1.1.0

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

@@ -0,0 +1,432 @@
+/**
+ * Research integration utilities using prompt-driven AI analysis
+ * Implements intelligent research findings incorporation into ADRs
+ */
+import { McpAdrError } from '../types/index.js';
+/**
+ * Monitor research directory for files
+ */
+export async function monitorResearchDirectory(researchPath = 'docs/research') {
+    try {
+        const { findFiles } = await import('./file-system.js');
+        // Find all research files
+        const researchFiles = await findFiles(process.cwd(), [
+            `${researchPath}/**/*.md`,
+            `${researchPath}/**/*.txt`,
+            `${researchPath}/**/*.pdf`,
+            `${researchPath}/**/*.doc`,
+            `${researchPath}/**/*.docx`,
+        ], { includeContent: true });
+        const instructions = `
+# Research Directory Monitoring
+
+Monitoring research directory for architectural insights and findings.
+
+## Directory Status
+- **Research Path**: ${researchPath}
+- **Files Found**: ${researchFiles.length} files
+- **Total Size**: ${researchFiles.reduce((sum, f) => sum + (f.size || 0), 0)} bytes
+
+## Discovered Files
+${researchFiles.length === 0
+            ? 'No research files found in the specified directory.'
+            : researchFiles
+                .map((file, index) => `
+### ${index + 1}. ${file.name}
+- **Path**: ${file.path}
+- **Size**: ${file.size} bytes
+- **Last Modified**: ${file.lastModified || 'Unknown'}
+`)
+                .join('')}
+
+## Next Steps
+1. **Extract research topics** using the topic extraction tool
+2. **Analyze impact on existing ADRs** using the impact evaluation tool
+3. **Generate update suggestions** for affected ADRs
+4. **Monitor for new research** files and changes
+
+## Monitoring Recommendations
+- Set up file system watchers for automatic detection
+- Establish research file naming conventions
+- Create research templates for consistent structure
+- Schedule regular research integration reviews
+
+${researchFiles.length === 0
+            ? `
+## Getting Started
+To begin using research integration:
+1. Create the research directory: \`mkdir -p ${researchPath}\`
+2. Add research files (markdown, text, or documents)
+3. Use the \`incorporate_research\` tool to analyze findings
+4. Review suggested ADR updates and implementations
+`
+            : ''}
+`;
+        return {
+            monitoringPrompt: `Research directory monitoring complete. Found ${researchFiles.length} files in ${researchPath}.`,
+            instructions,
+        };
+    }
+    catch (error) {
+        throw new McpAdrError(`Failed to monitor research directory: ${error instanceof Error ? error.message : String(error)}`, 'MONITORING_ERROR');
+    }
+}
+/**
+ * Extract research topics from files
+ */
+export async function extractResearchTopics(researchPath = 'docs/research', existingTopics) {
+    try {
+        const { findFiles } = await import('./file-system.js');
+        const { generateResearchTopicExtractionPrompt } = await import('../prompts/research-integration-prompts.js');
+        // Find and read research files
+        const researchFiles = await findFiles(process.cwd(), [`${researchPath}/**/*.md`, `${researchPath}/**/*.txt`], { includeContent: true });
+        if (researchFiles.length === 0) {
+            throw new McpAdrError(`No research files found in ${researchPath}`, 'NO_RESEARCH_FILES');
+        }
+        // Prepare research file data
+        const fileData = researchFiles.map(file => ({
+            filename: file.name,
+            content: file.content || '',
+            lastModified: file.lastModified || new Date().toISOString(),
+            size: file.size || 0,
+        }));
+        const extractionPrompt = generateResearchTopicExtractionPrompt(fileData, existingTopics);
+        const instructions = `
+# Research Topic Extraction Instructions
+
+This analysis will extract key topics and findings from research files that could impact architectural decisions.
+
+## Research Analysis
+- **Research Path**: ${researchPath}
+- **Files Analyzed**: ${researchFiles.length} files
+- **Existing Topics**: ${existingTopics?.length || 0} topics
+- **Total Content**: ${fileData.reduce((sum, f) => sum + f.content.length, 0)} characters
+
+## Next Steps
+1. **Submit the extraction prompt** to an AI agent for topic analysis
+2. **Parse the JSON response** to get extracted topics and insights
+3. **Review the research findings** for architectural relevance
+4. **Use the impact evaluation tool** to assess ADR implications
+
+## Expected AI Response Format
+The AI will return a JSON object with:
+- \`extractedTopics\`: Array of research topics with findings and evidence
+- \`researchSummary\`: Overall assessment of research quality and completeness
+- \`keyInsights\`: Major insights that require action
+- \`recommendations\`: Specific recommendations for incorporating findings
+- \`gaps\`: Areas where additional research is needed
+
+## Usage Example
+\`\`\`typescript
+const result = await extractResearchTopics(researchPath, existingTopics);
+// Submit result.extractionPrompt to AI agent
+// Parse AI response for research topics and insights
+\`\`\`
+`;
+        return {
+            extractionPrompt,
+            instructions,
+        };
+    }
+    catch (error) {
+        throw new McpAdrError(`Failed to extract research topics: ${error instanceof Error ? error.message : String(error)}`, 'EXTRACTION_ERROR');
+    }
+}
+/**
+ * Evaluate research impact on existing ADRs
+ */
+export async function evaluateResearchImpact(researchTopics, adrDirectory = 'docs/adrs') {
+    try {
+        const { findFiles } = await import('./file-system.js');
+        const { generateResearchImpactEvaluationPrompt } = await import('../prompts/research-integration-prompts.js');
+        // Find existing ADRs
+        const adrFiles = await findFiles(process.cwd(), [`${adrDirectory}/**/*.md`], {
+            includeContent: true,
+        });
+        if (adrFiles.length === 0) {
+            throw new McpAdrError(`No ADR files found in ${adrDirectory}`, 'NO_ADRS_FOUND');
+        }
+        // Prepare ADR data
+        const adrData = adrFiles.map(file => {
+            const titleMatch = file.content?.match(/^#\s+(.+)$/m);
+            const statusMatch = file.content?.match(/##\s+Status\s*\n\s*(.+)/i);
+            return {
+                id: file.name.replace(/\.md$/, ''),
+                title: titleMatch?.[1] || file.name.replace(/\.md$/, ''),
+                status: statusMatch?.[1] || 'Unknown',
+                content: file.content || '',
+                category: extractAdrCategory(file.content || ''),
+            };
+        });
+        const evaluationPrompt = generateResearchImpactEvaluationPrompt(researchTopics, adrData);
+        const instructions = `
+# Research Impact Evaluation Instructions
+
+This analysis will evaluate how research findings impact existing ADRs and suggest necessary updates.
+
+## Impact Analysis
+- **Research Topics**: ${researchTopics.length} topics
+- **Existing ADRs**: ${adrFiles.length} ADRs
+- **ADR Directory**: ${adrDirectory}
+- **High Relevance Topics**: ${researchTopics.filter(t => t.relevanceScore > 0.7).length} topics
+
+## Next Steps
+1. **Submit the evaluation prompt** to an AI agent for impact analysis
+2. **Parse the JSON response** to get impact assessments and recommendations
+3. **Review suggested updates** and prioritize based on impact level
+4. **Use the update suggestion tool** for specific ADR modifications
+
+## Expected AI Response Format
+The AI will return a JSON object with:
+- \`impactAnalysis\`: Detailed impact assessment for each ADR
+- \`updateRecommendations\`: Specific update suggestions with justifications
+- \`newAdrSuggestions\`: Recommendations for new ADRs based on research
+- \`deprecationSuggestions\`: ADRs that should be deprecated
+- \`overallAssessment\`: Summary of findings and action priorities
+
+## Usage Example
+\`\`\`typescript
+const result = await evaluateResearchImpact(researchTopics, adrDirectory);
+// Submit result.evaluationPrompt to AI agent
+// Parse AI response for impact analysis and recommendations
+\`\`\`
+`;
+        return {
+            evaluationPrompt,
+            instructions,
+        };
+    }
+    catch (error) {
+        throw new McpAdrError(`Failed to evaluate research impact: ${error instanceof Error ? error.message : String(error)}`, 'EVALUATION_ERROR');
+    }
+}
+/**
+ * Generate ADR update suggestions
+ */
+export async function generateAdrUpdateSuggestions(adrId, researchFindings, updateType, adrDirectory = 'docs/adrs') {
+    try {
+        const { findFiles } = await import('./file-system.js');
+        const { generateAdrUpdateSuggestionPrompt } = await import('../prompts/research-integration-prompts.js');
+        // Find the specific ADR
+        const adrFiles = await findFiles(process.cwd(), [`${adrDirectory}/**/*.md`], {
+            includeContent: true,
+        });
+        const targetAdr = adrFiles.find(file => file.name.includes(adrId) || file.content?.includes(adrId) || file.path.includes(adrId));
+        if (!targetAdr) {
+            throw new McpAdrError(`ADR not found: ${adrId}`, 'ADR_NOT_FOUND');
+        }
+        // Extract ADR metadata
+        const titleMatch = targetAdr.content?.match(/^#\s+(.+)$/m);
+        const statusMatch = targetAdr.content?.match(/##\s+Status\s*\n\s*(.+)/i);
+        const adrData = {
+            id: adrId,
+            title: titleMatch?.[1] || targetAdr.name.replace(/\.md$/, ''),
+            content: targetAdr.content || '',
+            status: statusMatch?.[1] || 'Unknown',
+        };
+        const updatePrompt = generateAdrUpdateSuggestionPrompt(adrData, researchFindings, updateType);
+        const instructions = `
+# ADR Update Suggestion Instructions
+
+This will generate specific update suggestions for an ADR based on research findings.
+
+## Update Details
+- **ADR ID**: ${adrId}
+- **ADR Title**: ${adrData.title}
+- **Current Status**: ${adrData.status}
+- **Update Type**: ${updateType}
+- **Research Findings**: ${researchFindings.length} findings
+
+## Next Steps
+1. **Submit the update prompt** to an AI agent for suggestion generation
+2. **Parse the JSON response** to get detailed update recommendations
+3. **Review the proposed changes** for accuracy and completeness
+4. **Apply the updates** to the ADR file with proper version control
+5. **Notify stakeholders** of the changes and rationale
+
+## Expected AI Response Format
+The AI will return a JSON object with:
+- \`updateSuggestion\`: Overall update metadata and assessment
+- \`proposedChanges\`: Specific changes to make to the ADR
+- \`newContent\`: Complete updated ADR content
+- \`migrationGuidance\`: Implementation and rollback guidance
+- \`qualityChecks\`: Quality assessment of the proposed updates
+- \`reviewRecommendations\`: Suggested review and approval process
+
+## Usage Example
+\`\`\`typescript
+const result = await generateAdrUpdateSuggestions(adrId, findings, updateType);
+// Submit result.updatePrompt to AI agent
+// Parse AI response for update suggestions and implementation guidance
+\`\`\`
+`;
+        return {
+            updatePrompt,
+            instructions,
+        };
+    }
+    catch (error) {
+        throw new McpAdrError(`Failed to generate ADR update suggestions: ${error instanceof Error ? error.message : String(error)}`, 'UPDATE_GENERATION_ERROR');
+    }
+}
+/**
+ * Extract category from ADR content
+ */
+function extractAdrCategory(content) {
+    const categoryPatterns = [
+        { pattern: /framework|library|dependency/i, category: 'technology' },
+        { pattern: /database|storage|persistence/i, category: 'database' },
+        { pattern: /api|rest|graphql|endpoint/i, category: 'api' },
+        { pattern: /security|authentication|authorization/i, category: 'security' },
+        { pattern: /deployment|infrastructure|cloud/i, category: 'deployment' },
+        { pattern: /test|testing|quality/i, category: 'testing' },
+        { pattern: /architecture|pattern|design/i, category: 'architecture' },
+        { pattern: /process|workflow|methodology/i, category: 'process' },
+    ];
+    for (const { pattern, category } of categoryPatterns) {
+        if (pattern.test(content)) {
+            return category;
+        }
+    }
+    return 'general';
+}
+/**
+ * Create research file template
+ */
+export function createResearchTemplate(title, category = 'general') {
+    const date = new Date().toISOString().split('T')[0];
+    return `# ${title}
+
+**Date**: ${date}
+**Category**: ${category}
+**Status**: In Progress
+
+## Research Question
+
+[What specific question or problem is this research addressing?]
+
+## Background
+
+[Provide context and background information]
+
+## Methodology
+
+[Describe how the research was conducted]
+
+## Key Findings
+
+### Finding 1
+- **Description**: [Detailed description]
+- **Evidence**: [Supporting evidence or data]
+- **Confidence**: [High/Medium/Low]
+- **Source**: [Source of information]
+
+### Finding 2
+- **Description**: [Detailed description]
+- **Evidence**: [Supporting evidence or data]
+- **Confidence**: [High/Medium/Low]
+- **Source**: [Source of information]
+
+## Implications
+
+### Architectural Impact
+[How do these findings impact architectural decisions?]
+
+### Technology Choices
+[What technology choices are affected?]
+
+### Risk Assessment
+[What risks are identified or mitigated?]
+
+## Recommendations
+
+1. [Specific recommendation 1]
+2. [Specific recommendation 2]
+3. [Specific recommendation 3]
+
+## Related ADRs
+
+- [List any ADRs that might be affected by this research]
+
+## Next Steps
+
+- [ ] [Action item 1]
+- [ ] [Action item 2]
+- [ ] [Action item 3]
+
+## References
+
+- [Reference 1]
+- [Reference 2]
+- [Reference 3]
+`;
+}
+/**
+ * Prompt for action confirmation before generating drafts
+ */
+export function promptForActionConfirmation(action, details, impact) {
+    const confirmationPrompt = `
+# Action Confirmation Required
+
+**Action**: ${action}
+**Impact Level**: ${impact.toUpperCase()}
+
+## Details
+${details}
+
+## Confirmation Required
+Before proceeding with this action, please confirm:
+
+1. **Understanding**: Do you understand the proposed action and its implications?
+2. **Authorization**: Are you authorized to approve this type of change?
+3. **Impact Assessment**: Have you reviewed the potential impact on existing systems?
+4. **Timing**: Is this an appropriate time to implement this change?
+5. **Resources**: Are the necessary resources available for implementation?
+
+## Risk Assessment
+${impact === 'critical'
+        ? '🔴 **CRITICAL**: This action may have significant system-wide impact'
+        : impact === 'high'
+            ? '🟠 **HIGH**: This action may affect multiple components or stakeholders'
+            : impact === 'medium'
+                ? '🟡 **MEDIUM**: This action has moderate impact and should be reviewed'
+                : '🟢 **LOW**: This action has minimal impact but still requires confirmation'}
+
+Please respond with:
+- **APPROVED**: To proceed with the action
+- **REJECTED**: To cancel the action
+- **MODIFIED**: To request modifications to the proposed action
+- **DEFERRED**: To postpone the action to a later time
+
+Include any additional comments or requirements for the action.
+`;
+    const instructions = `
+# Action Confirmation Instructions
+
+This confirmation step ensures that significant changes are properly reviewed before implementation.
+
+## Confirmation Process
+1. **Review the proposed action** and its details carefully
+2. **Assess the impact level** and potential consequences
+3. **Consider timing and resources** required for implementation
+4. **Provide clear approval or rejection** with reasoning
+5. **Specify any modifications** needed if not approving as-is
+
+## Response Options
+- **APPROVED**: Action can proceed as proposed
+- **REJECTED**: Action should not be implemented
+- **MODIFIED**: Action needs changes before approval
+- **DEFERRED**: Action should be postponed
+
+## Best Practices
+- Always review high and critical impact actions carefully
+- Consider stakeholder impact and communication needs
+- Ensure proper backup and rollback plans are in place
+- Document the approval decision and reasoning
+`;
+    return {
+        confirmationPrompt,
+        instructions,
+    };
+}
+//# sourceMappingURL=research-integration.js.map

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

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

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

@@ -0,0 +1,97 @@
+/**
+ * Research question generation utilities using prompt-driven AI analysis
+ * Implements intelligent research question generation and task tracking
+ */
+export interface ResearchProblem {
+    id: string;
+    description: string;
+    category: string;
+    severity: string;
+    context: string;
+}
+export interface KnowledgeGraph {
+    technologies: Array<{
+        name: string;
+        description?: string;
+        category?: string;
+    }>;
+    patterns: Array<{
+        name: string;
+        description?: string;
+        category?: string;
+    }>;
+    adrs: Array<{
+        id: string;
+        title: string;
+        status: string;
+        content?: string;
+    }>;
+    relationships: Array<{
+        source: string;
+        target: string;
+        type: string;
+    }>;
+}
+export interface ResearchContext {
+    topic: string;
+    category: string;
+    scope: string;
+    objectives: string[];
+    constraints?: string[];
+    timeline?: string;
+}
+export interface ResearchQuestion {
+    id: string;
+    question: string;
+    type: string;
+    priority: string;
+    complexity: string;
+    timeline: string;
+    methodology: string;
+    expectedOutcome: string;
+    successCriteria: string[];
+    relatedKnowledge: string[];
+    resources: string[];
+    risks: string[];
+    dependencies: string[];
+}
+/**
+ * Correlate problems with knowledge graph
+ */
+export declare function correlateProblemKnowledge(problems: ResearchProblem[], knowledgeGraph: KnowledgeGraph): Promise<{
+    correlationPrompt: string;
+    instructions: string;
+}>;
+/**
+ * Find relevant ADRs and patterns for research context
+ */
+export declare function findRelevantAdrPatterns(researchContext: ResearchContext, adrDirectory?: string): Promise<{
+    relevancePrompt: string;
+    instructions: string;
+}>;
+/**
+ * Generate context-aware research questions
+ */
+export declare function generateContextAwareQuestions(researchContext: ResearchContext, relevantKnowledge: {
+    adrs: any[];
+    patterns: any[];
+    gaps: any[];
+    opportunities: any[];
+}, projectPath?: string): Promise<{
+    questionPrompt: string;
+    instructions: string;
+}>;
+/**
+ * Create research task tracking system
+ */
+export declare function createResearchTaskTracking(researchQuestions: ResearchQuestion[], currentProgress?: Array<{
+    questionId: string;
+    status: string;
+    progress: number;
+    findings: string[];
+    blockers: string[];
+}>): Promise<{
+    trackingPrompt: string;
+    instructions: string;
+}>;
+//# sourceMappingURL=research-questions.d.ts.map

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

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