mcp-adr-analysis-server 1.1.0

package/dist/src/utils/deployment-analysis.js

@@ -0,0 +1,263 @@
+/**
+ * Deployment analysis utilities using prompt-driven AI analysis
+ * Implements intelligent deployment progress tracking and completion verification
+ */
+import { McpAdrError } from '../types/index.js';
+/**
+ * Identify deployment tasks from ADRs and todo content
+ */
+export async function identifyDeploymentTasks(adrDirectory = 'docs/adrs', todoPath) {
+    try {
+        const { findFiles } = await import('./file-system.js');
+        const { generateDeploymentTaskIdentificationPrompt } = await import('../prompts/deployment-analysis-prompts.js');
+        // Find all ADR files
+        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$/, ''),
+                content: file.content || '',
+                status: statusMatch?.[1] || 'Unknown',
+            };
+        });
+        // Read todo content if provided
+        let todoContent;
+        if (todoPath) {
+            try {
+                const { promises: fs } = await import('fs');
+                todoContent = await fs.readFile(todoPath, 'utf-8');
+            }
+            catch (error) {
+                console.warn(`Failed to read todo file: ${todoPath}`);
+            }
+        }
+        const identificationPrompt = generateDeploymentTaskIdentificationPrompt(adrData, todoContent);
+        const instructions = `
+# Deployment Task Identification Instructions
+
+This analysis will identify deployment-related tasks from ADRs and todo content for comprehensive deployment tracking.
+
+## Identification Scope
+- **ADR Directory**: ${adrDirectory}
+- **ADRs Analyzed**: ${adrFiles.length} files
+- **Todo Content**: ${todoPath ? 'Included' : 'Not provided'}
+- **Task Categories**: Infrastructure, Application, CI/CD, Operational
+
+## Next Steps
+1. **Submit the identification prompt** to an AI agent for comprehensive task analysis
+2. **Parse the JSON response** to get identified deployment tasks
+3. **Review task dependencies** and deployment phases
+4. **Use tasks** for deployment progress tracking and management
+
+## Expected AI Response Format
+The AI will return a JSON object with:
+- \`deploymentTaskAnalysis\`: Overall analysis metadata and confidence
+- \`identifiedTasks\`: Detailed deployment tasks with verification criteria
+- \`deploymentPhases\`: Organized deployment phases and sequencing
+- \`deploymentDependencies\`: Task dependencies and constraints
+- \`riskAssessment\`: Deployment risks and mitigation strategies
+- \`recommendations\`: Process and tooling recommendations
+
+## Usage Example
+\`\`\`typescript
+const result = await identifyDeploymentTasks(adrDirectory, todoPath);
+// Submit result.identificationPrompt to AI agent
+// Parse AI response for deployment tasks
+\`\`\`
+`;
+        return {
+            identificationPrompt,
+            instructions,
+        };
+    }
+    catch (error) {
+        throw new McpAdrError(`Failed to identify deployment tasks: ${error instanceof Error ? error.message : String(error)}`, 'DEPLOYMENT_TASK_IDENTIFICATION_ERROR');
+    }
+}
+/**
+ * Analyze CI/CD logs and pipeline status
+ */
+export async function analyzeCiCdStatus(cicdLogs, pipelineConfig, deploymentTasks) {
+    try {
+        const { generateCiCdAnalysisPrompt } = await import('../prompts/deployment-analysis-prompts.js');
+        // Prepare deployment tasks context
+        const tasksContext = deploymentTasks?.map(task => ({
+            taskId: task.taskId,
+            taskName: task.taskName,
+            category: task.category,
+            verificationCriteria: task.verificationCriteria,
+        }));
+        const analysisPrompt = generateCiCdAnalysisPrompt(cicdLogs, pipelineConfig, tasksContext);
+        const instructions = `
+# CI/CD Pipeline Analysis Instructions
+
+This analysis will examine CI/CD logs and pipeline configuration to assess deployment progress and identify issues.
+
+## Analysis Scope
+- **CI/CD Logs**: ${cicdLogs.length} characters of log data
+- **Pipeline Config**: ${pipelineConfig ? 'Included' : 'Not provided'}
+- **Deployment Tasks**: ${deploymentTasks?.length || 0} tasks for context
+- **Analysis Areas**: Build status, test results, quality gates, deployment status
+
+## Next Steps
+1. **Submit the analysis prompt** to an AI agent for comprehensive CI/CD analysis
+2. **Parse the JSON response** to get pipeline status and issues
+3. **Review performance metrics** and optimization opportunities
+4. **Use findings** for deployment progress calculation and issue resolution
+
+## Expected AI Response Format
+The AI will return a JSON object with:
+- \`cicdAnalysis\`: Overall pipeline status and progress
+- \`pipelineStages\`: Detailed stage-by-stage analysis
+- \`testResults\`: Comprehensive test result analysis
+- \`qualityGates\`: Quality gate status and compliance
+- \`deploymentStatus\`: Environment deployment status
+- \`issues\`: Identified issues with suggested fixes
+- \`performanceMetrics\`: Pipeline performance and resource usage
+- \`recommendations\`: Optimization and improvement recommendations
+
+## Usage Example
+\`\`\`typescript
+const result = await analyzeCiCdStatus(logs, config, tasks);
+// Submit result.analysisPrompt to AI agent
+// Parse AI response for CI/CD analysis
+\`\`\`
+`;
+        return {
+            analysisPrompt,
+            instructions,
+        };
+    }
+    catch (error) {
+        throw new McpAdrError(`Failed to analyze CI/CD status: ${error instanceof Error ? error.message : String(error)}`, 'CICD_ANALYSIS_ERROR');
+    }
+}
+/**
+ * Calculate deployment progress
+ */
+export async function calculateDeploymentProgress(deploymentTasks, cicdStatus, environmentStatus) {
+    try {
+        const { generateDeploymentProgressCalculationPrompt } = await import('../prompts/deployment-analysis-prompts.js');
+        // Prepare task data for progress calculation
+        const taskData = deploymentTasks.map(task => ({
+            taskId: task.taskId,
+            taskName: task.taskName,
+            status: task.status,
+            progress: task.progress,
+            category: task.category,
+            priority: task.priority,
+        }));
+        const progressPrompt = generateDeploymentProgressCalculationPrompt(taskData, cicdStatus, environmentStatus);
+        const instructions = `
+# Deployment Progress Calculation Instructions
+
+This analysis will calculate comprehensive deployment progress based on tasks, CI/CD status, and environment status.
+
+## Progress Calculation
+- **Deployment Tasks**: ${deploymentTasks.length} tasks
+- **Task Categories**: ${Array.from(new Set(deploymentTasks.map(t => t.category))).join(', ')}
+- **CI/CD Status**: ${cicdStatus ? 'Included' : 'Not provided'}
+- **Environment Status**: ${environmentStatus ? 'Included' : 'Not provided'}
+
+## Next Steps
+1. **Submit the progress prompt** to an AI agent for comprehensive calculation
+2. **Parse the JSON response** to get detailed progress analysis
+3. **Review critical path** and bottlenecks
+4. **Use progress data** for stakeholder reporting and decision making
+
+## Expected AI Response Format
+The AI will return a JSON object with:
+- \`deploymentProgress\`: Overall progress and completion estimates
+- \`categoryProgress\`: Progress by deployment category
+- \`taskProgress\`: Individual task progress and contributions
+- \`criticalPath\`: Critical path analysis and bottlenecks
+- \`milestones\`: Milestone progress and status
+- \`qualityMetrics\`: Quality and compliance metrics
+- \`riskAssessment\`: Risk analysis and mitigation
+- \`recommendations\`: Progress acceleration recommendations
+- \`nextActions\`: Immediate actions required
+
+## Usage Example
+\`\`\`typescript
+const result = await calculateDeploymentProgress(tasks, cicdStatus, envStatus);
+// Submit result.progressPrompt to AI agent
+// Parse AI response for progress calculation
+\`\`\`
+`;
+        return {
+            progressPrompt,
+            instructions,
+        };
+    }
+    catch (error) {
+        throw new McpAdrError(`Failed to calculate deployment progress: ${error instanceof Error ? error.message : String(error)}`, 'PROGRESS_CALCULATION_ERROR');
+    }
+}
+/**
+ * Verify deployment completion with outcome rules
+ */
+export async function verifyDeploymentCompletion(deploymentTasks, outcomeRules, actualOutcomes) {
+    try {
+        const { generateCompletionVerificationPrompt } = await import('../prompts/deployment-analysis-prompts.js');
+        // Prepare task data for verification
+        const taskData = deploymentTasks.map(task => ({
+            taskId: task.taskId,
+            taskName: task.taskName,
+            verificationCriteria: task.verificationCriteria,
+            expectedOutcome: task.expectedOutcome,
+            status: task.status,
+        }));
+        const verificationPrompt = generateCompletionVerificationPrompt(taskData, outcomeRules, actualOutcomes);
+        const instructions = `
+# Deployment Completion Verification Instructions
+
+This analysis will verify deployment completion by comparing actual outcomes against expected outcome rules.
+
+## Verification Scope
+- **Deployment Tasks**: ${deploymentTasks.length} tasks to verify
+- **Outcome Rules**: ${outcomeRules.length} rules to validate
+- **Actual Outcomes**: ${actualOutcomes?.length || 0} outcomes provided
+- **Verification Areas**: Criteria compliance, outcome validation, quality assessment
+
+## Next Steps
+1. **Submit the verification prompt** to an AI agent for comprehensive verification
+2. **Parse the JSON response** to get completion verification results
+3. **Review compliance gaps** and quality assessments
+4. **Use verification results** for sign-off decisions and go-live recommendations
+
+## Expected AI Response Format
+The AI will return a JSON object with:
+- \`completionVerification\`: Overall completion status and confidence
+- \`taskVerification\`: Individual task verification results
+- \`ruleCompliance\`: Outcome rule compliance assessment
+- \`qualityAssessment\`: Quality and compliance metrics
+- \`successMetrics\`: Success metric evaluation
+- \`completionGaps\`: Identified gaps and remediation
+- \`recommendations\`: Completion and quality recommendations
+- \`signOffStatus\`: Sign-off readiness and go-live recommendation
+
+## Usage Example
+\`\`\`typescript
+const result = await verifyDeploymentCompletion(tasks, rules, outcomes);
+// Submit result.verificationPrompt to AI agent
+// Parse AI response for completion verification
+\`\`\`
+`;
+        return {
+            verificationPrompt,
+            instructions,
+        };
+    }
+    catch (error) {
+        throw new McpAdrError(`Failed to verify deployment completion: ${error instanceof Error ? error.message : String(error)}`, 'COMPLETION_VERIFICATION_ERROR');
+    }
+}
+//# sourceMappingURL=deployment-analysis.js.map

package/dist/src/utils/deployment-analysis.js.map

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

package/dist/src/utils/environment-analysis.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Environment analysis utilities using prompt-driven AI analysis
+ * Implements intelligent environment context analysis and compliance assessment
+ */
+export interface EnvironmentFile {
+    filename: string;
+    content: string;
+    path: string;
+    type: 'dockerfile' | 'compose' | 'kubernetes' | 'terraform' | 'config' | 'other';
+}
+export interface ContainerizationAnalysis {
+    detected: boolean;
+    technology: string;
+    maturity: string;
+    orchestration: string;
+    dockerfiles: any[];
+    composeFiles: any[];
+    kubernetesManifests: any[];
+    buildConfiguration: any;
+    resourceManagement: any;
+    bestPractices: any;
+    recommendations: any[];
+    securityFindings: any[];
+}
+export interface EnvironmentRequirements {
+    infrastructure: any;
+    platform: any;
+    security: any;
+    performance: any;
+    operationalRequirements: any;
+    gaps: any[];
+    recommendations: any[];
+}
+export interface ComplianceAssessment {
+    overallScore: number;
+    assessmentDate: string;
+    riskLevel: string;
+    complianceStatus: string;
+    categoryScores: any;
+    complianceDetails: any[];
+    violations: any[];
+    strengths: any[];
+    recommendations: any[];
+    improvementPlan: any;
+    riskAssessment: any;
+    complianceMetrics: any;
+}
+/**
+ * Analyze system environment specifications
+ */
+export declare function analyzeEnvironmentSpecs(projectPath?: string): Promise<{
+    analysisPrompt: string;
+    instructions: string;
+}>;
+/**
+ * Detect containerization technologies
+ */
+export declare function detectContainerization(projectPath?: string): Promise<{
+    detectionPrompt: string;
+    instructions: string;
+}>;
+/**
+ * Determine environment requirements from ADRs
+ */
+export declare function determineEnvironmentRequirements(adrDirectory?: string): Promise<{
+    requirementsPrompt: string;
+    instructions: string;
+}>;
+/**
+ * Assess environment compliance
+ */
+export declare function assessEnvironmentCompliance(currentEnvironment: any, requirements: any, industryStandards?: string[]): Promise<{
+    compliancePrompt: string;
+    instructions: string;
+}>;
+//# sourceMappingURL=environment-analysis.d.ts.map

package/dist/src/utils/environment-analysis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment-analysis.d.ts","sourceRoot":"","sources":["../../../src/utils/environment-analysis.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,YAAY,GAAG,SAAS,GAAG,YAAY,GAAG,WAAW,GAAG,QAAQ,GAAG,OAAO,CAAC;CAClF;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,GAAG,EAAE,CAAC;IACnB,YAAY,EAAE,GAAG,EAAE,CAAC;IACpB,mBAAmB,EAAE,GAAG,EAAE,CAAC;IAC3B,kBAAkB,EAAE,GAAG,CAAC;IACxB,kBAAkB,EAAE,GAAG,CAAC;IACxB,aAAa,EAAE,GAAG,CAAC;IACnB,eAAe,EAAE,GAAG,EAAE,CAAC;IACvB,gBAAgB,EAAE,GAAG,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,uBAAuB;IACtC,cAAc,EAAE,GAAG,CAAC;IACpB,QAAQ,EAAE,GAAG,CAAC;IACd,QAAQ,EAAE,GAAG,CAAC;IACd,WAAW,EAAE,GAAG,CAAC;IACjB,uBAAuB,EAAE,GAAG,CAAC;IAC7B,IAAI,EAAE,GAAG,EAAE,CAAC;IACZ,eAAe,EAAE,GAAG,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,GAAG,CAAC;IACpB,iBAAiB,EAAE,GAAG,EAAE,CAAC;IACzB,UAAU,EAAE,GAAG,EAAE,CAAC;IAClB,SAAS,EAAE,GAAG,EAAE,CAAC;IACjB,eAAe,EAAE,GAAG,EAAE,CAAC;IACvB,eAAe,EAAE,GAAG,CAAC;IACrB,cAAc,EAAE,GAAG,CAAC;IACpB,iBAAiB,EAAE,GAAG,CAAC;CACxB;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,WAAW,GAAE,MAAsB,GAClC,OAAO,CAAC;IAAE,cAAc,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAAC,CAiE3D;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,WAAW,GAAE,MAAsB,GAClC,OAAO,CAAC;IAAE,eAAe,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAAC,CAqF5D;AAED;;GAEG;AACH,wBAAsB,gCAAgC,CACpD,YAAY,GAAE,MAAoB,GACjC,OAAO,CAAC;IAAE,kBAAkB,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAAC,CA4E/D;AAED;;GAEG;AACH,wBAAsB,2BAA2B,CAC/C,kBAAkB,EAAE,GAAG,EACvB,YAAY,EAAE,GAAG,EACjB,iBAAiB,CAAC,EAAE,MAAM,EAAE,GAC3B,OAAO,CAAC;IAAE,gBAAgB,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAAC,CA2D7D"}

package/dist/src/utils/environment-analysis.js

@@ -0,0 +1,329 @@
+/**
+ * Environment analysis utilities using prompt-driven AI analysis
+ * Implements intelligent environment context analysis and compliance assessment
+ */
+import { McpAdrError } from '../types/index.js';
+/**
+ * Analyze system environment specifications
+ */
+export async function analyzeEnvironmentSpecs(projectPath = process.cwd()) {
+    try {
+        const { analyzeProjectStructure } = await import('./file-system.js');
+        const { generateAnalysisContext } = await import('../prompts/analysis-prompts.js');
+        const { generateEnvironmentSpecAnalysisPrompt } = await import('../prompts/environment-analysis-prompts.js');
+        // Find environment-related files
+        const environmentFiles = await findEnvironmentFiles(projectPath);
+        // Analyze project structure
+        const projectStructure = await analyzeProjectStructure(projectPath);
+        const analysisContext = generateAnalysisContext(projectStructure);
+        const analysisPrompt = generateEnvironmentSpecAnalysisPrompt(environmentFiles, analysisContext);
+        const instructions = `
+# Environment Specification Analysis Instructions
+
+This analysis will examine environment specifications and infrastructure configurations to understand deployment requirements.
+
+## Analysis Scope
+- **Project Path**: ${projectPath}
+- **Environment Files**: ${environmentFiles.length} files found
+- **File Types**: ${Array.from(new Set(environmentFiles.map(f => f.type))).join(', ')}
+
+## Discovered Files
+${environmentFiles.map(f => `- **${f.filename}** (${f.type}): ${f.path}`).join('\n')}
+
+## Next Steps
+1. **Submit the analysis prompt** to an AI agent for comprehensive environment analysis
+2. **Parse the JSON response** to get environment specifications and recommendations
+3. **Review infrastructure requirements** and compliance status
+4. **Use findings** for environment optimization and compliance improvement
+
+## Expected AI Response Format
+The AI will return a JSON object with:
+- \`environmentAnalysis\`: Overall environment assessment and classification
+- \`infrastructure\`: Detailed infrastructure component analysis
+- \`containerization\`: Container technology detection and evaluation
+- \`cloudServices\`: Cloud platform and service analysis
+- \`configuration\`: Configuration management assessment
+- \`qualityAttributes\`: Non-functional requirement evaluation
+- \`recommendations\`: Prioritized improvement suggestions
+- \`gaps\`: Identified missing or inadequate components
+
+## Usage Example
+\`\`\`typescript
+const result = await analyzeEnvironmentSpecs(projectPath);
+// Submit result.analysisPrompt to AI agent
+// Parse AI response for environment analysis
+\`\`\`
+`;
+        return {
+            analysisPrompt,
+            instructions,
+        };
+    }
+    catch (error) {
+        throw new McpAdrError(`Failed to analyze environment specs: ${error instanceof Error ? error.message : String(error)}`, 'ENVIRONMENT_ANALYSIS_ERROR');
+    }
+}
+/**
+ * Detect containerization technologies
+ */
+export async function detectContainerization(projectPath = process.cwd()) {
+    try {
+        const { findFiles } = await import('./file-system.js');
+        const { generateContainerizationDetectionPrompt } = await import('../prompts/environment-analysis-prompts.js');
+        // Find container-related files
+        const containerFiles = await findFiles(process.cwd(), [
+            '**/Dockerfile*',
+            '**/docker-compose*.yml',
+            '**/docker-compose*.yaml',
+            '**/*.dockerfile',
+            '**/Containerfile*',
+            '**/k8s/**/*.yml',
+            '**/k8s/**/*.yaml',
+            '**/kubernetes/**/*.yml',
+            '**/kubernetes/**/*.yaml',
+            '**/helm/**/*.yml',
+            '**/helm/**/*.yaml',
+            '**/.dockerignore',
+        ], { includeContent: true });
+        // Prepare file data
+        const projectFiles = containerFiles.map(file => ({
+            filename: file.name,
+            content: file.content || '',
+            path: file.path,
+        }));
+        const detectionPrompt = generateContainerizationDetectionPrompt(projectFiles);
+        const instructions = `
+# Containerization Detection Instructions
+
+This analysis will detect and evaluate containerization technologies and configurations in the project.
+
+## Detection Scope
+- **Project Path**: ${projectPath}
+- **Container Files**: ${containerFiles.length} files found
+- **File Types**: Dockerfiles, Compose files, Kubernetes manifests, Helm charts
+
+## Discovered Files
+${containerFiles.map(f => `- **${f.name}**: ${f.path}`).join('\n')}
+
+## Next Steps
+1. **Submit the detection prompt** to an AI agent for containerization analysis
+2. **Parse the JSON response** to get containerization assessment
+3. **Review security findings** and best practice compliance
+4. **Implement recommendations** for container optimization
+
+## Expected AI Response Format
+The AI will return a JSON object with:
+- \`containerization\`: Overall containerization status and maturity
+- \`dockerfiles\`: Analysis of Dockerfile configurations
+- \`composeFiles\`: Docker Compose file evaluation
+- \`kubernetesManifests\`: Kubernetes resource analysis
+- \`buildConfiguration\`: Build optimization assessment
+- \`resourceManagement\`: Resource limit and scaling evaluation
+- \`bestPractices\`: Security and optimization best practices
+- \`recommendations\`: Prioritized improvement suggestions
+- \`securityFindings\`: Security issues and remediation
+
+## Usage Example
+\`\`\`typescript
+const result = await detectContainerization(projectPath);
+// Submit result.detectionPrompt to AI agent
+// Parse AI response as ContainerizationAnalysis
+\`\`\`
+`;
+        return {
+            detectionPrompt,
+            instructions,
+        };
+    }
+    catch (error) {
+        throw new McpAdrError(`Failed to detect containerization: ${error instanceof Error ? error.message : String(error)}`, 'CONTAINERIZATION_DETECTION_ERROR');
+    }
+}
+/**
+ * Determine environment requirements from ADRs
+ */
+export async function determineEnvironmentRequirements(adrDirectory = 'docs/adrs') {
+    try {
+        const { findFiles } = await import('./file-system.js');
+        const { generateAdrEnvironmentRequirementsPrompt } = await import('../prompts/environment-analysis-prompts.js');
+        // Find all ADR files
+        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$/, ''),
+                content: file.content || '',
+                status: statusMatch?.[1] || 'Unknown',
+            };
+        });
+        const requirementsPrompt = generateAdrEnvironmentRequirementsPrompt(adrData);
+        const instructions = `
+# Environment Requirements Analysis Instructions
+
+This analysis will extract environment and infrastructure requirements from Architectural Decision Records.
+
+## Requirements Extraction
+- **ADR Directory**: ${adrDirectory}
+- **ADRs Analyzed**: ${adrFiles.length} files
+- **Requirement Categories**: Infrastructure, Platform, Security, Performance, Operational
+
+## Next Steps
+1. **Submit the requirements prompt** to an AI agent for ADR analysis
+2. **Parse the JSON response** to get extracted requirements
+3. **Review requirement completeness** and identify gaps
+4. **Use requirements** for environment compliance assessment
+
+## Expected AI Response Format
+The AI will return a JSON object with:
+- \`environmentRequirements\`: Overall requirements metadata
+- \`infrastructure\`: Compute, networking, and availability requirements
+- \`platform\`: Containerization, cloud services, and database requirements
+- \`security\`: Compliance, access control, and data protection requirements
+- \`performance\`: Response time, throughput, and scalability requirements
+- \`operationalRequirements\`: Monitoring, deployment, and maintenance requirements
+- \`gaps\`: Missing or unclear requirements
+- \`recommendations\`: Suggested requirement clarifications
+
+## Usage Example
+\`\`\`typescript
+const result = await determineEnvironmentRequirements(adrDirectory);
+// Submit result.requirementsPrompt to AI agent
+// Parse AI response as EnvironmentRequirements
+\`\`\`
+`;
+        return {
+            requirementsPrompt,
+            instructions,
+        };
+    }
+    catch (error) {
+        throw new McpAdrError(`Failed to determine environment requirements: ${error instanceof Error ? error.message : String(error)}`, 'REQUIREMENTS_ANALYSIS_ERROR');
+    }
+}
+/**
+ * Assess environment compliance
+ */
+export async function assessEnvironmentCompliance(currentEnvironment, requirements, industryStandards) {
+    try {
+        const { generateEnvironmentCompliancePrompt } = await import('../prompts/environment-analysis-prompts.js');
+        const compliancePrompt = generateEnvironmentCompliancePrompt(currentEnvironment, requirements, industryStandards);
+        const instructions = `
+# Environment Compliance Assessment Instructions
+
+This analysis will assess the current environment against requirements and industry standards.
+
+## Assessment Scope
+- **Current Environment**: Analyzed environment specifications
+- **Requirements**: Extracted from ADRs and project needs
+- **Industry Standards**: ${industryStandards?.length || 0} standards
+- **Assessment Areas**: Infrastructure, Security, Performance, Operational
+
+## Next Steps
+1. **Submit the compliance prompt** to an AI agent for assessment
+2. **Parse the JSON response** to get compliance evaluation
+3. **Review violations** and prioritize remediation
+4. **Implement improvement plan** based on recommendations
+
+## Expected AI Response Format
+The AI will return a JSON object with:
+- \`complianceAssessment\`: Overall compliance score and status
+- \`categoryScores\`: Compliance scores by category
+- \`complianceDetails\`: Detailed requirement-by-requirement assessment
+- \`violations\`: Specific compliance violations with remediation
+- \`strengths\`: Areas where compliance exceeds requirements
+- \`recommendations\`: Prioritized improvement recommendations
+- \`improvementPlan\`: Phased implementation roadmap
+- \`riskAssessment\`: Risk analysis and mitigation strategies
+- \`complianceMetrics\`: Quantitative compliance measurements
+
+## Usage Example
+\`\`\`typescript
+const result = await assessEnvironmentCompliance(environment, requirements, standards);
+// Submit result.compliancePrompt to AI agent
+// Parse AI response as ComplianceAssessment
+\`\`\`
+`;
+        return {
+            compliancePrompt,
+            instructions,
+        };
+    }
+    catch (error) {
+        throw new McpAdrError(`Failed to assess environment compliance: ${error instanceof Error ? error.message : String(error)}`, 'COMPLIANCE_ASSESSMENT_ERROR');
+    }
+}
+/**
+ * Find environment-related files in the project
+ */
+async function findEnvironmentFiles(projectPath) {
+    try {
+        const { findFiles } = await import('./file-system.js');
+        const files = await findFiles(projectPath, [
+            '**/Dockerfile*',
+            '**/docker-compose*.yml',
+            '**/docker-compose*.yaml',
+            '**/*.dockerfile',
+            '**/Containerfile*',
+            '**/k8s/**/*.yml',
+            '**/k8s/**/*.yaml',
+            '**/kubernetes/**/*.yml',
+            '**/kubernetes/**/*.yaml',
+            '**/terraform/**/*.tf',
+            '**/terraform/**/*.tfvars',
+            '**/.env*',
+            '**/config/**/*.yml',
+            '**/config/**/*.yaml',
+            '**/config/**/*.json',
+            '**/helm/**/*.yml',
+            '**/helm/**/*.yaml',
+        ], { includeContent: true });
+        return files.map(file => ({
+            filename: file.name,
+            content: file.content || '',
+            path: file.path,
+            type: determineFileType(file.name, file.path),
+        }));
+    }
+    catch (error) {
+        console.warn('Failed to find environment files:', error);
+        return [];
+    }
+}
+/**
+ * Determine file type based on filename and path
+ */
+function determineFileType(filename, path) {
+    const lowerFilename = filename.toLowerCase();
+    const lowerPath = path.toLowerCase();
+    if (lowerFilename.includes('dockerfile') || lowerFilename.includes('containerfile')) {
+        return 'dockerfile';
+    }
+    if (lowerFilename.includes('docker-compose') || lowerFilename.includes('compose')) {
+        return 'compose';
+    }
+    if (lowerPath.includes('k8s') || lowerPath.includes('kubernetes') || lowerPath.includes('helm')) {
+        return 'kubernetes';
+    }
+    if (lowerPath.includes('terraform') ||
+        lowerFilename.endsWith('.tf') ||
+        lowerFilename.endsWith('.tfvars')) {
+        return 'terraform';
+    }
+    if (lowerFilename.includes('config') ||
+        lowerFilename.startsWith('.env') ||
+        lowerFilename.endsWith('.yml') ||
+        lowerFilename.endsWith('.yaml') ||
+        lowerFilename.endsWith('.json')) {
+        return 'config';
+    }
+    return 'other';
+}
+//# sourceMappingURL=environment-analysis.js.map