mcp-adr-analysis-server 2.1.0 → 2.1.11

package/dist/src/tools/deployment-guidance-tool.js

@@ -3,18 +3,20 @@
  * Implements prompt-driven deployment guidance generation following project patterns
  */
 import { McpAdrError } from '../types/index.js';
+import { ResearchOrchestrator } from '../utils/research-orchestrator.js';
 /**
  * Generate deployment guidance from ADRs using AI-driven analysis
  */
 export async function generateDeploymentGuidance(args) {
-    const { adrDirectory = 'docs/adrs', environment = 'production', format = 'markdown', projectPath = process.cwd(), includeScripts = true, includeConfigs = true, includeValidation = true, technologyFilter, customRequirements, includeRollback = true, generateFiles = false } = args;
+    const { adrDirectory = 'docs/adrs', environment = 'production', format = 'markdown', projectPath = process.cwd(), includeScripts = true, includeConfigs = true, includeValidation = true, technologyFilter, customRequirements, includeRollback = true, generateFiles = false, } = args;
     try {
         // Use existing ADR discovery
         const { discoverAdrsInDirectory } = await import('../utils/adr-discovery.js');
         const discoveryResult = await discoverAdrsInDirectory(adrDirectory, true, projectPath);
         if (discoveryResult.adrs.length === 0) {
             return {
-                content: [{
+                content: [
+                    {
                         type: 'text',
                         text: `# No ADRs Found for Deployment Guidance
 
@@ -46,10 +48,41 @@ Use Docker containers with docker-compose for orchestration.
 - Requires container registry and orchestration setup
 - Port 3000 for application, 5432 for PostgreSQL
 \`\`\`
-`
-                    }]
+`,
+                    },
+                ],
             };
         }
+        // Research current deployment environment
+        let environmentContext = '';
+        try {
+            const orchestrator = new ResearchOrchestrator(projectPath, adrDirectory);
+            const research = await orchestrator.answerResearchQuestion(`Analyze deployment requirements for ${environment} environment:
+1. What deployment infrastructure is currently available?
+2. What deployment patterns are documented in ADRs?
+3. Are there existing deployment scripts or configurations?
+4. What are the deployment constraints or requirements?`);
+            const envSource = research.sources.find(s => s.type === 'environment');
+            const capabilities = envSource?.data?.capabilities || [];
+            environmentContext = `
+
+## 🔍 Current Environment Analysis
+
+**Research Confidence**: ${(research.confidence * 100).toFixed(1)}%
+
+### Available Infrastructure
+${capabilities.length > 0 ? capabilities.map((c) => `- ${c}`).join('\n') : '- No infrastructure tools detected'}
+
+### Deployment Context
+${research.answer || 'No specific deployment context found'}
+
+### Key Findings
+${research.sources.map(s => `- ${s.type}: Consulted`).join('\n')}
+`;
+        }
+        catch (error) {
+            environmentContext = `\n## ⚠️ Environment Analysis Failed\n${error instanceof Error ? error.message : String(error)}\n`;
+        }
         // Create comprehensive deployment guidance prompt
         const deploymentPrompt = `
 # Deployment Guidance Generation
@@ -61,16 +94,19 @@ You are an expert DevOps engineer tasked with creating comprehensive deployment
 - **Target Environment**: ${environment}
 - **ADR Directory**: ${adrDirectory}
 - **Total ADRs**: ${discoveryResult.adrs.length}
+${environmentContext}
 
 ## ADR Content
-${discoveryResult.adrs.map(adr => `
+${discoveryResult.adrs
+            .map(adr => `
 ### ${adr.title} (${adr.filename})
 **Status**: ${adr.status}
 **Content**:
 \`\`\`markdown
 ${adr.content?.slice(0, 1000) || 'No content available'}${adr.content && adr.content.length > 1000 ? '...' : ''}
 \`\`\`
-`).join('\n')}
+`)
+            .join('\n')}
 
 ## Deployment Analysis Instructions
 
@@ -94,16 +130,20 @@ Extract specific configuration details:
 
 ### 3. **Environment-Specific Considerations**
 For **${environment}** environment:
-${environment === 'production' ? `
+${environment === 'production'
+            ? `
 - **Security**: TLS certificates, secure connections, secrets management
 - **Performance**: Load balancing, caching, optimization
 - **Reliability**: Backup procedures, monitoring, alerting
 - **Scalability**: Auto-scaling, resource allocation
-` : environment === 'staging' ? `
+`
+            : environment === 'staging'
+                ? `
 - **Testing**: Staging-specific configurations
 - **Data**: Test data setup, database seeding
 - **Integration**: External service connections
-` : `
+`
+                : `
 - **Development**: Hot-reload, debugging, local services
 - **Convenience**: Simplified setup, development tools
 `}
@@ -117,30 +157,36 @@ Create step-by-step deployment instructions:
 5. **Service Configuration**: Web server, load balancer, SSL
 6. **Verification**: Health checks, smoke tests, monitoring
 
-${includeScripts ? `
+${includeScripts
+            ? `
 ### 5. **Script Generation**
 Generate deployment scripts:
 - **Shell scripts** for automated deployment
 - **Docker commands** for containerized deployment
 - **Configuration files** (nginx.conf, docker-compose.yml, .env)
-` : ''}
+`
+            : ''}
 
-${includeValidation ? `
+${includeValidation
+            ? `
 ### 6. **Validation & Health Checks**
 Create verification procedures:
 - **Health check endpoints** and commands
 - **Service connectivity tests**
 - **Performance validation**
 - **Security verification**
-` : ''}
+`
+            : ''}
 
-${includeRollback ? `
+${includeRollback
+            ? `
 ### 7. **Rollback Procedures**
 Document rollback steps:
 - **Rollback commands** in reverse order
 - **Data migration rollback** if applicable
 - **Service restoration** procedures
-` : ''}
+`
+            : ''}
 
 ## Output Format
 
@@ -219,22 +265,27 @@ KEY=value
 - **Complete**: Cover entire deployment lifecycle
 - **Evidence-based**: Base all recommendations on ADR content
 
-${technologyFilter && technologyFilter.length > 0 ? `
+${technologyFilter && technologyFilter.length > 0
+            ? `
 ## Technology Filter
 Focus only on these technologies: ${technologyFilter.join(', ')}
-` : ''}
+`
+            : ''}
 
-${customRequirements && customRequirements.length > 0 ? `
+${customRequirements && customRequirements.length > 0
+            ? `
 ## Custom Requirements
 Additionally address these requirements:
 ${customRequirements.map(req => `- ${req}`).join('\n')}
-` : ''}
+`
+            : ''}
 
 Begin deployment guidance generation now.
 `;
         // Return the prompt for AI execution
         return {
-            content: [{
+            content: [
+                {
                     type: 'text',
                     text: `# Deployment Guidance Generation
 
@@ -271,15 +322,18 @@ The AI will generate:
 
 All based on the architectural decisions documented in your ADRs.
 
-${generateFiles ? `
+${generateFiles
+                        ? `
 ## File Generation Mode
 **Note**: File generation is enabled. The AI guidance will include instructions for creating actual deployment files in your project.
-` : ''}
+`
+                        : ''}
 
 ## ADR Sources
 ${discoveryResult.adrs.map(adr => `- **${adr.title}** (${adr.filename})`).join('\n')}
-`
-                }]
+`,
+                },
+            ],
         };
     }
     catch (error) {

package/dist/src/tools/deployment-guidance-tool.js.map

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

package/dist/src/tools/deployment-readiness-tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deployment-readiness-tool.d.ts","sourceRoot":"","sources":["../../../src/tools/deployment-readiness-tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AA2zBH;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CA4JjE"}
+{"version":3,"file":"deployment-readiness-tool.d.ts","sourceRoot":"","sources":["../../../src/tools/deployment-readiness-tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AA60BH;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CA4JjE"}

package/dist/src/tools/deployment-readiness-tool.js

@@ -31,6 +31,7 @@ import { MemoryEntityManager } from '../utils/memory-entity-manager.js';
 import { EnhancedLogger } from '../utils/enhanced-logging.js';
 import { TreeSitterAnalyzer } from '../utils/tree-sitter-analyzer.js';
 import { findFiles, findRelatedCode } from '../utils/file-system.js';
+import { ResearchOrchestrator } from '../utils/research-orchestrator.js';
 // Core schemas
 const DeploymentReadinessSchema = z.object({
     operation: z
@@ -106,6 +107,15 @@ const DeploymentReadinessSchema = z.object({
         .array(z.string())
         .default(['typescript', 'javascript', 'python', 'yaml', 'hcl'])
         .describe('Languages to analyze with tree-sitter'),
+    // Research-Driven Integration
+    enableResearchIntegration: z
+        .boolean()
+        .default(true)
+        .describe('Use research-orchestrator to verify environment readiness'),
+    researchConfidenceThreshold: z
+        .number()
+        .default(0.7)
+        .describe('Minimum confidence for environment research (0-1)'),
 });
 /**
  * Deployment Memory Manager for tracking deployment assessments and patterns
@@ -1047,10 +1057,74 @@ function analyzeFailurePatterns(failedDeployments) {
     });
     return Array.from(patterns.values());
 }
+/**
+ * Research environment readiness using research-orchestrator
+ */
+async function performEnvironmentResearch(args, projectPath) {
+    if (!args.enableResearchIntegration) {
+        return {
+            answer: 'Environment research disabled',
+            confidence: 1.0,
+            sources: [],
+            needsWebSearch: false,
+            warnings: [],
+        };
+    }
+    try {
+        const orchestrator = new ResearchOrchestrator(projectPath, 'docs/adrs');
+        const researchQuestion = `Verify deployment readiness for ${args.targetEnvironment} environment:
+1. Are required deployment tools available (Docker/Podman, Kubernetes/OpenShift)?
+2. What is the current infrastructure state and health?
+3. Are environment configurations present and valid?
+4. What deployment patterns are documented in ADRs?
+5. Are there any known deployment blockers or issues?`;
+        const research = await orchestrator.answerResearchQuestion(researchQuestion);
+        const warnings = [];
+        // Check confidence level
+        if (research.confidence < args.researchConfidenceThreshold) {
+            warnings.push(`Research confidence (${(research.confidence * 100).toFixed(1)}%) below threshold (${(args.researchConfidenceThreshold * 100).toFixed(1)}%)`);
+        }
+        // Check if web search is needed
+        if (research.needsWebSearch) {
+            warnings.push('Local environment data insufficient - external research may be needed');
+        }
+        // Check for environment capability availability
+        const hasKubernetes = research.sources.some(s => s.type === 'environment' && s.data?.capabilities?.includes('kubernetes'));
+        const hasDocker = research.sources.some(s => s.type === 'environment' && s.data?.capabilities?.includes('docker'));
+        const hasOpenShift = research.sources.some(s => s.type === 'environment' && s.data?.capabilities?.includes('openshift'));
+        const hasPodman = research.sources.some(s => s.type === 'environment' && s.data?.capabilities?.includes('podman'));
+        if (!hasKubernetes && !hasOpenShift && !hasDocker && !hasPodman) {
+            warnings.push('No container orchestration tools detected - manual deployment verification required');
+        }
+        return {
+            answer: research.answer || 'No environment research results available',
+            confidence: research.confidence,
+            sources: research.sources.map(s => ({
+                type: s.type,
+                found: true, // Sources in array are already found
+            })),
+            needsWebSearch: research.needsWebSearch,
+            warnings,
+        };
+    }
+    catch (error) {
+        return {
+            answer: `Environment research failed: ${error instanceof Error ? error.message : String(error)}`,
+            confidence: 0,
+            sources: [],
+            needsWebSearch: true,
+            warnings: [
+                'Failed to perform environment research - proceeding without environment validation',
+            ],
+        };
+    }
+}
 /**
  * Perform full audit (all checks)
  */
 async function performFullAudit(args, projectPath, historyPath) {
+    // Step 0: Research environment readiness
+    const environmentResearch = await performEnvironmentResearch(args, projectPath);
     // Combine all validations
     const testResult = await performTestValidation(args, projectPath);
     const historyResult = await performDeploymentHistoryAnalysis(args, historyPath);
@@ -1156,17 +1230,43 @@ ${deploymentCriticalFiles.length > 0
 `;
         }
     }
+    // Create environment blockers based on research findings
+    const environmentBlockers = [];
+    if (environmentResearch.warnings.length > 0) {
+        environmentResearch.warnings.forEach(warning => {
+            if (warning.includes('threshold') || warning.includes('No container orchestration')) {
+                environmentBlockers.push({
+                    category: 'environment',
+                    title: 'Environment Readiness Concern',
+                    description: warning,
+                    severity: warning.includes('No container orchestration') ? 'high' : 'medium',
+                    impact: 'May affect deployment execution',
+                    resolutionSteps: [
+                        'Verify environment tools are installed',
+                        'Check environment configurations',
+                        'Consult deployment documentation',
+                    ],
+                    estimatedResolutionTime: '30 minutes - 1 hour',
+                    blocksDeployment: args.strictMode && warning.includes('No container orchestration'),
+                });
+            }
+        });
+    }
     const allBlockers = [
         ...testResult.criticalBlockers,
         ...testResult.testFailureBlockers,
         ...historyResult.deploymentHistoryBlockers,
+        ...environmentBlockers,
     ];
-    const overallScore = (testResult.overallScore + historyResult.overallScore) / 2;
-    const isReady = allBlockers.length === 0;
+    // Adjust overall score based on environment research confidence
+    const baseScore = (testResult.overallScore + historyResult.overallScore) / 2;
+    const environmentScore = environmentResearch.confidence * 100;
+    const overallScore = baseScore * 0.7 + environmentScore * 0.3;
+    const isReady = allBlockers.filter(b => b.blocksDeployment).length === 0;
     const result = {
         isDeploymentReady: isReady,
         overallScore,
-        confidence: Math.min(testResult.confidence, historyResult.confidence),
+        confidence: Math.min(testResult.confidence, historyResult.confidence, environmentResearch.confidence * 100),
         codeQualityAnalysis: testResult.codeQualityAnalysis,
         testValidationResult: testResult.testValidationResult,
         deploymentHistoryAnalysis: historyResult.deploymentHistoryAnalysis,
@@ -1174,12 +1274,13 @@ ${deploymentCriticalFiles.length > 0
         criticalBlockers: allBlockers.filter(b => b.severity === 'critical'),
         testFailureBlockers: testResult.testFailureBlockers,
         deploymentHistoryBlockers: historyResult.deploymentHistoryBlockers,
-        warnings: [...testResult.warnings, ...historyResult.warnings],
+        warnings: [...testResult.warnings, ...historyResult.warnings, ...environmentResearch.warnings],
         todoTasksCreated: [],
         healthScoreUpdate: {},
         gitPushStatus: isReady ? 'allowed' : 'blocked',
         overrideStatus: {},
         smartCodeAnalysis, // Include Smart Code Linking analysis
+        environmentResearch, // Include environment research results
     };
     return result;
 }
@@ -1367,6 +1468,29 @@ function generateSuccessResponse(result, args) {
 - **ADRs Analyzed**: ${result.adrComplianceResult.compliantAdrs}/${result.adrComplianceResult.totalAdrs}
 - **Missing Implementations**: ${result.adrComplianceResult.missingImplementations.length} items
 
+${result.environmentResearch
+                    ? `
+## 🔍 Environment Research Analysis
+
+**Research Confidence**: ${(result.environmentResearch.confidence * 100).toFixed(1)}%
+
+### Infrastructure State
+${result.environmentResearch.answer}
+
+### Sources Consulted
+${result.environmentResearch.sources.map(s => `- ${s.type}: ${s.found ? '✅ Available' : '❌ Not found'}`).join('\n')}
+
+${result.environmentResearch.warnings.length > 0
+                        ? `### Environment Warnings
+${result.environmentResearch.warnings.map(w => `- ⚠️ ${w}`).join('\n')}`
+                        : '### Environment Status\n✅ All environment checks passed'}
+
+${result.environmentResearch.needsWebSearch
+                        ? '⚠️ **Note**: Local environment data may be insufficient - consider external verification'
+                        : ''}
+`
+                    : ''}
+
 ${result.smartCodeAnalysis || ''}
 
 ## 🚀 Deployment Approved
@@ -1421,6 +1545,29 @@ ${result.deploymentHistoryAnalysis.failurePatterns.map(p => `- **${p.pattern}**:
 `
                     : '✅ Deployment history stable'}
 
+${result.environmentResearch
+                    ? `
+## 🔍 Environment Research Analysis
+
+**Research Confidence**: ${(result.environmentResearch.confidence * 100).toFixed(1)}%
+
+### Infrastructure State
+${result.environmentResearch.answer}
+
+### Sources Consulted
+${result.environmentResearch.sources.map(s => `- ${s.type}: ${s.found ? '✅ Available' : '❌ Not found'}`).join('\n')}
+
+${result.environmentResearch.warnings.length > 0
+                        ? `### Environment Warnings
+${result.environmentResearch.warnings.map(w => `- ⚠️ ${w}`).join('\n')}`
+                        : '### Environment Status\n✅ All environment checks passed'}
+
+${result.environmentResearch.needsWebSearch
+                        ? '⚠️ **Note**: Local environment data may be insufficient - consider external verification'
+                        : ''}
+`
+                    : ''}
+
 ${result.smartCodeAnalysis || ''}
 
 ## 🚨 Critical Blockers (Must Fix Before Deployment)