mcp-adr-analysis-server 2.0.5 → 2.0.7

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

@@ -0,0 +1,289 @@
+/**
+ * MCP Tool for generating deployment guidance from ADRs
+ * Implements prompt-driven deployment guidance generation following project patterns
+ */
+import { McpAdrError } from '../types/index.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;
+    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: [{
+                        type: 'text',
+                        text: `# No ADRs Found for Deployment Guidance
+
+## Searched Location
+- **ADR Directory**: ${adrDirectory}
+- **Project Path**: ${projectPath}
+
+## Recommendations
+1. Create ADRs with deployment-relevant decisions
+2. Include technology choices (Docker, databases, web servers)
+3. Specify infrastructure requirements
+4. Document configuration parameters
+
+## Example ADR for Deployment
+\`\`\`markdown
+# ADR-001: Use Docker for Containerization
+
+## Status
+Accepted
+
+## Context
+We need consistent deployment across environments.
+
+## Decision
+Use Docker containers with docker-compose for orchestration.
+
+## Consequences
+- Consistent environment across dev/staging/production
+- Requires container registry and orchestration setup
+- Port 3000 for application, 5432 for PostgreSQL
+\`\`\`
+`
+                    }]
+            };
+        }
+        // Create comprehensive deployment guidance prompt
+        const deploymentPrompt = `
+# Deployment Guidance Generation
+
+You are an expert DevOps engineer tasked with creating comprehensive deployment guidance from Architectural Decision Records (ADRs).
+
+## Project Context
+- **Project**: ${projectPath.split('/').pop() || 'Unknown'}
+- **Target Environment**: ${environment}
+- **ADR Directory**: ${adrDirectory}
+- **Total ADRs**: ${discoveryResult.adrs.length}
+
+## ADR Content
+${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')}
+
+## Deployment Analysis Instructions
+
+Analyze the ADRs above and extract deployment-relevant information to create comprehensive deployment guidance:
+
+### 1. **Technology Extraction**
+Identify technologies mentioned in ADRs that require deployment:
+- **Databases**: PostgreSQL, MySQL, MongoDB, Redis, etc.
+- **Web Servers**: Nginx, Apache, Node.js, Python, etc.
+- **Containers**: Docker, Kubernetes, container orchestration
+- **Infrastructure**: Cloud providers, servers, networking
+- **Security**: TLS, authentication, secrets management
+- **Monitoring**: Logging, metrics, health checks
+
+### 2. **Configuration Requirements**
+Extract specific configuration details:
+- **Ports**: Application ports, database ports, service ports
+- **Environment Variables**: Required env vars for ${environment}
+- **Resource Limits**: Memory, CPU, storage requirements
+- **Dependencies**: Service dependencies and startup order
+
+### 3. **Environment-Specific Considerations**
+For **${environment}** environment:
+${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' ? `
+- **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
+`}
+
+### 4. **Deployment Steps Generation**
+Create step-by-step deployment instructions:
+1. **Prerequisites**: Required tools, access, dependencies
+2. **Infrastructure Setup**: Server/cloud setup, networking
+3. **Database Setup**: Database creation, schema, migrations
+4. **Application Deployment**: Build, deploy, configure
+5. **Service Configuration**: Web server, load balancer, SSL
+6. **Verification**: Health checks, smoke tests, monitoring
+
+${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 ? `
+### 6. **Validation & Health Checks**
+Create verification procedures:
+- **Health check endpoints** and commands
+- **Service connectivity tests**
+- **Performance validation**
+- **Security verification**
+` : ''}
+
+${includeRollback ? `
+### 7. **Rollback Procedures**
+Document rollback steps:
+- **Rollback commands** in reverse order
+- **Data migration rollback** if applicable
+- **Service restoration** procedures
+` : ''}
+
+## Output Format
+
+Generate deployment guidance in the following structure:
+
+\`\`\`markdown
+# Deployment Guide: [Project Name]
+
+**Environment**: ${environment}
+**Generated**: [Current Date]
+
+## 📋 Prerequisites
+- List all required tools, access, and dependencies
+
+## 🏗️ Infrastructure Setup
+- Cloud/server setup steps
+- Network configuration
+- Security setup
+
+## 🗄️ Database Setup
+- Database installation/configuration
+- Schema creation/migration
+- Connection setup
+
+## 🚀 Application Deployment
+1. **Build Steps**
+   \`\`\`bash
+   # Build commands
+   \`\`\`
+
+2. **Deploy Steps**
+   \`\`\`bash
+   # Deployment commands
+   \`\`\`
+
+3. **Configuration**
+   \`\`\`bash
+   # Configuration commands
+   \`\`\`
+
+## ⚙️ Configuration Files
+
+### .env (Environment Variables)
+\`\`\`
+KEY=value
+\`\`\`
+
+### docker-compose.yml (if applicable)
+\`\`\`yaml
+# Docker configuration
+\`\`\`
+
+## 🔍 Health Checks & Verification
+\`\`\`bash
+# Health check commands
+\`\`\`
+
+## 🔄 Rollback Procedure
+\`\`\`bash
+# Rollback commands (in reverse order)
+\`\`\`
+
+## 🛠️ Troubleshooting
+- Common issues and solutions
+
+## 📖 Reference ADRs
+- Links to relevant ADRs
+\`\`\`
+
+## Analysis Requirements
+
+- **Be specific**: Include actual commands, ports, and configurations
+- **Environment-aware**: Tailor guidance for ${environment}
+- **Security-focused**: Include security best practices
+- **Actionable**: Every step should be executable
+- **Complete**: Cover entire deployment lifecycle
+- **Evidence-based**: Base all recommendations on ADR content
+
+${technologyFilter && technologyFilter.length > 0 ? `
+## Technology Filter
+Focus only on these technologies: ${technologyFilter.join(', ')}
+` : ''}
+
+${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: [{
+                    type: 'text',
+                    text: `# Deployment Guidance Generation
+
+## Analysis Complete
+- **Found ${discoveryResult.adrs.length} ADRs** for deployment analysis
+- **Target Environment**: ${environment}
+- **Format**: ${format}
+- **Include Scripts**: ${includeScripts}
+- **Include Configs**: ${includeConfigs}
+- **Include Validation**: ${includeValidation}
+- **Include Rollback**: ${includeRollback}
+
+## AI Analysis Prompt
+
+${deploymentPrompt}
+
+## Instructions
+
+1. **Submit the prompt above** to an AI agent for comprehensive deployment guidance
+2. **Review the generated guidance** for completeness and accuracy
+3. **Customize configurations** for your specific environment
+4. **Test deployment steps** in staging before production
+5. **Save guidance** as DEPLOYMENT.md or similar documentation
+
+## Expected Output
+
+The AI will generate:
+- **Step-by-step deployment instructions**
+- **Environment-specific configurations**
+- **Shell scripts and configuration files**
+- **Health checks and validation procedures**
+- **Rollback procedures**
+- **Troubleshooting guidance**
+
+All based on the architectural decisions documented in your ADRs.
+
+${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) {
+        throw new McpAdrError(`Deployment guidance generation failed: ${error instanceof Error ? error.message : String(error)}`, 'DEPLOYMENT_GUIDANCE_ERROR');
+    }
+}
+//# sourceMappingURL=deployment-guidance-tool.js.map

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

@@ -0,0 +1 @@
+{"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/smart-git-push-tool.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Smart Git Push MCP Tool
+ *
+ * Intelligent git push with sensitive content and LLM artifact filtering
+ * Leverages existing content security tools and git CLI integration
+ */
+interface SmartGitPushArgs {
+    branch?: string;
+    message?: string;
+    skipValidation?: boolean;
+    allowedArtifacts?: string[];
+    sensitivityLevel?: 'strict' | 'moderate' | 'permissive';
+    interactiveMode?: boolean;
+    dryRun?: boolean;
+    projectPath?: string;
+    checkReleaseReadiness?: boolean;
+    releaseType?: 'major' | 'minor' | 'patch';
+}
+/**
+ * Main smart git push function
+ */
+export declare function smartGitPush(args: SmartGitPushArgs): Promise<any>;
+export {};
+//# sourceMappingURL=smart-git-push-tool.d.ts.map

package/dist/src/tools/smart-git-push-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smart-git-push-tool.d.ts","sourceRoot":"","sources":["../../../src/tools/smart-git-push-tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,UAAU,gBAAgB;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,gBAAgB,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,YAAY,CAAC;IACxD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,WAAW,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;CAC3C;AAwBD;;GAEG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC,CAqPvE"}