mcp-adr-analysis-server 2.0.12 → 2.0.13

package/README.md

@@ -25,6 +25,7 @@ The Model Context Protocol enables seamless integration between AI assistants an
 📊 **Workflow Automation** - Todo generation, deployment tracking, and rule validation
 🧪 **TDD Integration** - Two-phase Test-Driven Development with ADR linking and validation
 🔍 **Mock Detection** - Sophisticated analysis to distinguish mock from production code
+🚀 **Deployment Readiness** - Zero-tolerance test validation with deployment history tracking and hard blocking
 
 
 
@@ -296,6 +297,50 @@ const rules = await generateRules({
 });
 ```
 
+### Deployment Readiness & Safety
+```typescript
+// Comprehensive deployment validation with zero tolerance
+const deploymentCheck = await deploymentReadiness({
+  operation: "full_audit",
+  projectPath: "/path/to/project",
+  targetEnvironment: "production",
+  
+  // Test validation (zero tolerance by default)
+  maxTestFailures: 0,              // Hard block on any test failures
+  requireTestCoverage: 80,         // Minimum coverage requirement
+  blockOnFailingTests: true,       // Prevent deployment with failing tests
+  
+  // Deployment history validation
+  maxRecentFailures: 2,            // Max recent deployment failures
+  deploymentSuccessThreshold: 80,  // Required success rate
+  rollbackFrequencyThreshold: 20,  // Max rollback frequency
+  
+  // Integration options
+  integrateTodoTasks: true,        // Auto-create blocking tasks
+  updateHealthScoring: true,       // Update project metrics
+  strictMode: true                 // Enable all safety checks
+});
+
+// Enhanced git push with deployment readiness
+const pushResult = await smartGitPush({
+  message: "Deploy feature X",
+  branch: "main",
+  
+  // Deployment readiness integration
+  checkDeploymentReadiness: true,     // Validate before push
+  enforceDeploymentReadiness: true,   // Hard block on issues
+  targetEnvironment: "production",    // Environment-specific checks
+  strictDeploymentMode: true          // Maximum safety
+});
+
+// Emergency override for critical fixes
+const override = await deploymentReadiness({
+  operation: "emergency_override",
+  businessJustification: "Critical security patch - CVE-2024-XXXX",
+  approvalRequired: true
+});
+```
+
 ## 🎯 Use Cases
 
 ### 👨‍💻 **AI Coding Assistants**

package/dist/src/index.d.ts

@@ -136,6 +136,7 @@ export declare class McpAdrAnalysisServer {
     private manageTodoJson;
     private generateDeploymentGuidance;
     private smartGitPush;
+    private deploymentReadiness;
     private troubleshootGuidedWorkflow;
     private smartScore;
 }

package/dist/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;GAMG;AA2EH;;GAEG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,aAAa,CAAM;IAC3B,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,MAAM,CAAkC;IAChD,OAAO,CAAC,SAAS,CAAwB;;IAyBzC;;OAEG;YACW,qBAAqB;IAUnC;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAKlC;;OAEG;IACH,OAAO,CAAC,aAAa;IAu5DrB;;OAEG;YACW,sBAAsB;YAgGtB,mBAAmB;YAqMnB,sBAAsB;YAmQtB,uBAAuB;YA+VvB,uBAAuB;YA0PvB,mBAAmB;YA6RnB,eAAe;YA2Hf,kBAAkB;IAyFhC;;OAEG;YACW,+BAA+B;IA0K7C;;OAEG;IACH,OAAO,CAAC,cAAc;IAgCtB;;OAEG;IACH,OAAO,CAAC,cAAc;IAkDtB;;OAEG;IACH,OAAO,CAAC,0BAA0B;IAyClC;;OAEG;IACH,OAAO,CAAC,+BAA+B;IAmFvC;;OAEG;YACW,sBAAsB;YAKtB,sBAAsB;YAKtB,uBAAuB;YAKvB,wBAAwB;YAKxB,sBAAsB;YAKtB,WAAW;YAkJX,sBAAsB;IAuHpC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAazB;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAyDnC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAyF3B;;OAEG;YACW,WAAW;YAKX,uBAAuB;YAKvB,oBAAoB;IAKlC;;OAEG;YACW,mBAAmB;YAKnB,sBAAsB;YAKtB,yBAAyB;IAKvC;;OAEG;YACW,aAAa;YAKb,aAAa;YAKb,aAAa;IAK3B;;OAEG;YACW,kBAAkB;IAKhC;;OAEG;YACW,yBAAyB;IAKvC;;OAEG;YACW,yBAAyB;IAKvC;;OAEG;IACH;;OAEG;YACW,kBAAkB;YAwFlB,kBAAkB;IAWhC;;OAEG;YACW,YAAY;IAmF1B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAc5B;;OAEG;YACW,QAAQ;YAiCR,SAAS;YAqCT,aAAa;YAuCb,cAAc;YAiBd,0BAA0B;YAY1B,YAAY;YAYZ,0BAA0B;YAY1B,UAAU;CAWzB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;GAMG;AA2EH;;GAEG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,aAAa,CAAM;IAC3B,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,MAAM,CAAkC;IAChD,OAAO,CAAC,SAAS,CAAwB;;IAyBzC;;OAEG;YACW,qBAAqB;IAUnC;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAKlC;;OAEG;IACH,OAAO,CAAC,aAAa;IAkhErB;;OAEG;YACW,sBAAsB;YAgGtB,mBAAmB;YAqMnB,sBAAsB;YAmQtB,uBAAuB;YA+VvB,uBAAuB;YA0PvB,mBAAmB;YA6RnB,eAAe;YA2Hf,kBAAkB;IAyFhC;;OAEG;YACW,+BAA+B;IA0K7C;;OAEG;IACH,OAAO,CAAC,cAAc;IAgCtB;;OAEG;IACH,OAAO,CAAC,cAAc;IAkDtB;;OAEG;IACH,OAAO,CAAC,0BAA0B;IAyClC;;OAEG;IACH,OAAO,CAAC,+BAA+B;IAmFvC;;OAEG;YACW,sBAAsB;YAKtB,sBAAsB;YAKtB,uBAAuB;YAKvB,wBAAwB;YAKxB,sBAAsB;YAKtB,WAAW;YAkJX,sBAAsB;IAuHpC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAazB;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAyDnC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAyF3B;;OAEG;YACW,WAAW;YAKX,uBAAuB;YAKvB,oBAAoB;IAKlC;;OAEG;YACW,mBAAmB;YAKnB,sBAAsB;YAKtB,yBAAyB;IAKvC;;OAEG;YACW,aAAa;YAKb,aAAa;YAKb,aAAa;IAK3B;;OAEG;YACW,kBAAkB;IAKhC;;OAEG;YACW,yBAAyB;IAKvC;;OAEG;YACW,yBAAyB;IAKvC;;OAEG;IACH;;OAEG;YACW,kBAAkB;YAwFlB,kBAAkB;IAWhC;;OAEG;YACW,YAAY;IAmF1B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAc5B;;OAEG;YACW,QAAQ;YAiCR,SAAS;YAqCT,aAAa;YAuCb,cAAc;YAiBd,0BAA0B;YAY1B,YAAY;YAYZ,mBAAmB;YAYnB,0BAA0B;YAY1B,UAAU;CAWzB"}

package/dist/src/index.js

@@ -1598,6 +1598,126 @@ export class McpAdrAnalysisServer {
                             }
                         }
                     },
+                    {
+                        name: 'deployment_readiness',
+                        description: 'Comprehensive deployment readiness validation with test failure tracking, deployment history analysis, and hard blocking for unsafe deployments. Integrates with smart_git_push for deployment gating.',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                operation: {
+                                    type: 'string',
+                                    enum: ['check_readiness', 'validate_production', 'test_validation', 'deployment_history', 'full_audit', 'emergency_override'],
+                                    description: 'Type of deployment readiness check to perform'
+                                },
+                                projectPath: {
+                                    type: 'string',
+                                    description: 'Path to project directory (defaults to current working directory)'
+                                },
+                                targetEnvironment: {
+                                    type: 'string',
+                                    enum: ['staging', 'production', 'integration'],
+                                    default: 'production',
+                                    description: 'Target deployment environment'
+                                },
+                                strictMode: {
+                                    type: 'boolean',
+                                    default: true,
+                                    description: 'Enable strict validation (recommended for production)'
+                                },
+                                allowMockCode: {
+                                    type: 'boolean',
+                                    default: false,
+                                    description: 'Allow mock code in deployment (NOT RECOMMENDED)'
+                                },
+                                productionCodeThreshold: {
+                                    type: 'number',
+                                    default: 85,
+                                    description: 'Minimum production code quality score (0-100)'
+                                },
+                                mockCodeMaxAllowed: {
+                                    type: 'number',
+                                    default: 0,
+                                    description: 'Maximum mock code indicators allowed'
+                                },
+                                maxTestFailures: {
+                                    type: 'number',
+                                    default: 0,
+                                    description: 'Maximum test failures allowed (0 = zero tolerance)'
+                                },
+                                requireTestCoverage: {
+                                    type: 'number',
+                                    default: 80,
+                                    description: 'Minimum test coverage percentage required'
+                                },
+                                blockOnFailingTests: {
+                                    type: 'boolean',
+                                    default: true,
+                                    description: 'Block deployment if tests are failing'
+                                },
+                                testSuiteRequired: {
+                                    type: 'array',
+                                    items: { type: 'string' },
+                                    default: [],
+                                    description: 'Required test suites that must pass'
+                                },
+                                maxRecentFailures: {
+                                    type: 'number',
+                                    default: 2,
+                                    description: 'Maximum recent deployment failures allowed'
+                                },
+                                deploymentSuccessThreshold: {
+                                    type: 'number',
+                                    default: 80,
+                                    description: 'Minimum deployment success rate required (%)'
+                                },
+                                blockOnRecentFailures: {
+                                    type: 'boolean',
+                                    default: true,
+                                    description: 'Block if recent deployments failed'
+                                },
+                                rollbackFrequencyThreshold: {
+                                    type: 'number',
+                                    default: 20,
+                                    description: 'Maximum rollback frequency allowed (%)'
+                                },
+                                requireAdrCompliance: {
+                                    type: 'boolean',
+                                    default: true,
+                                    description: 'Require ADR compliance validation'
+                                },
+                                integrateTodoTasks: {
+                                    type: 'boolean',
+                                    default: true,
+                                    description: 'Auto-create blocking tasks for issues'
+                                },
+                                updateHealthScoring: {
+                                    type: 'boolean',
+                                    default: true,
+                                    description: 'Update project health scores'
+                                },
+                                triggerSmartGitPush: {
+                                    type: 'boolean',
+                                    default: false,
+                                    description: 'Trigger smart git push validation'
+                                },
+                                emergencyBypass: {
+                                    type: 'boolean',
+                                    default: false,
+                                    description: 'Emergency bypass for critical fixes'
+                                },
+                                businessJustification: {
+                                    type: 'string',
+                                    description: 'Business justification for overrides (required for emergency_override)'
+                                },
+                                approvalRequired: {
+                                    type: 'boolean',
+                                    default: true,
+                                    description: 'Require approval for overrides'
+                                }
+                            },
+                            required: ['operation']
+                        }
+                    },
                     {
                         name: 'troubleshoot_guided_workflow',
                         description: 'Structured failure analysis and test plan generation - provide JSON failure info to get specific test commands',
@@ -1924,6 +2044,9 @@ export class McpAdrAnalysisServer {
                     case 'smart_git_push':
                         response = await this.smartGitPush(args);
                         break;
+                    case 'deployment_readiness':
+                        response = await this.deploymentReadiness(args);
+                        break;
                     case 'troubleshoot_guided_workflow':
                         response = await this.troubleshootGuidedWorkflow(args);
                         break;
@@ -4615,6 +4738,15 @@ Please provide:
             throw new McpAdrError(`Smart git push failed: ${error instanceof Error ? error.message : String(error)}`, 'SMART_GIT_PUSH_ERROR');
         }
     }
+    async deploymentReadiness(args) {
+        try {
+            const { deploymentReadiness } = await import('./tools/deployment-readiness-tool.js');
+            return await deploymentReadiness(args);
+        }
+        catch (error) {
+            throw new McpAdrError(`Deployment readiness check failed: ${error instanceof Error ? error.message : String(error)}`, 'DEPLOYMENT_READINESS_ERROR');
+        }
+    }
     async troubleshootGuidedWorkflow(args) {
         try {
             const { troubleshootGuidedWorkflow } = await import('./tools/troubleshoot-guided-workflow-tool.js');