mcp-adr-analysis-server 2.0.11 → 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;IA03DrB;;OAEG;YACW,sBAAsB;YAgGtB,mBAAmB;YAqMnB,sBAAsB;YAmQtB,uBAAuB;YAsUvB,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

@@ -1513,7 +1513,7 @@ export class McpAdrAnalysisServer {
                     },
                     {
                         name: 'smart_git_push',
-                        description: 'Intelligent git push with sensitive content filtering, LLM artifact detection, and release readiness analysis',
+                        description: 'AI-driven security-focused git push with credential detection, file filtering, and deployment metrics tracking. Tests should be run by calling AI and results provided.',
                         inputSchema: {
                             type: 'object',
                             properties: {
@@ -1525,48 +1525,197 @@ export class McpAdrAnalysisServer {
                                     type: 'string',
                                     description: 'Commit message (optional, commits staged files if provided)'
                                 },
-                                skipValidation: {
+                                testResults: {
+                                    type: 'object',
+                                    description: 'Test results from AI-executed tests (required for proper deployment tracking)',
+                                    properties: {
+                                        success: {
+                                            type: 'boolean',
+                                            description: 'Whether all tests passed'
+                                        },
+                                        testsRun: {
+                                            type: 'number',
+                                            description: 'Total number of tests executed'
+                                        },
+                                        testsPassed: {
+                                            type: 'number',
+                                            description: 'Number of tests that passed'
+                                        },
+                                        testsFailed: {
+                                            type: 'number',
+                                            description: 'Number of tests that failed'
+                                        },
+                                        duration: {
+                                            type: 'number',
+                                            description: 'Test execution duration in seconds'
+                                        },
+                                        command: {
+                                            type: 'string',
+                                            description: 'Test command that was executed by AI'
+                                        },
+                                        output: {
+                                            type: 'string',
+                                            description: 'Test execution output'
+                                        },
+                                        failureDetails: {
+                                            type: 'array',
+                                            items: { type: 'string' },
+                                            description: 'Details of test failures'
+                                        },
+                                        testTypes: {
+                                            type: 'object',
+                                            description: 'Results broken down by test type (unit, integration, etc.)',
+                                            additionalProperties: {
+                                                type: 'object',
+                                                properties: {
+                                                    passed: { type: 'number' },
+                                                    failed: { type: 'number' }
+                                                }
+                                            }
+                                        }
+                                    },
+                                    required: ['success', 'testsRun', 'testsPassed', 'testsFailed']
+                                },
+                                skipSecurity: {
                                     type: 'boolean',
                                     default: false,
-                                    description: 'Skip content validation'
+                                    description: 'Skip security scanning (NOT RECOMMENDED)'
                                 },
-                                allowedArtifacts: {
-                                    type: 'array',
-                                    items: { type: 'string' },
-                                    description: 'Files to allow despite being flagged as artifacts'
+                                dryRun: {
+                                    type: 'boolean',
+                                    default: false,
+                                    description: 'Show what would be pushed without actually pushing'
                                 },
-                                sensitivityLevel: {
+                                projectPath: {
                                     type: 'string',
-                                    enum: ['strict', 'moderate', 'permissive'],
-                                    default: 'moderate',
-                                    description: 'Sensitivity level for content detection'
+                                    description: 'Path to project directory (defaults to current working directory)'
                                 },
-                                interactiveMode: {
-                                    type: 'boolean',
-                                    default: true,
-                                    description: 'Enable interactive approval workflow'
-                                },
-                                dryRun: {
+                                forceUnsafe: {
                                     type: 'boolean',
                                     default: false,
-                                    description: 'Show what would be pushed without actually pushing'
+                                    description: 'Override security blocks and test failures (DANGEROUS)'
+                                }
+                            }
+                        }
+                    },
+                    {
+                        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)'
                                 },
-                                checkReleaseReadiness: {
+                                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: 'Analyze TODO.md and project state to determine if ready for release'
+                                    description: 'Allow mock code in deployment (NOT RECOMMENDED)'
+                                },
+                                productionCodeThreshold: {
+                                    type: 'number',
+                                    default: 85,
+                                    description: 'Minimum production code quality score (0-100)'
                                 },
-                                releaseType: {
+                                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',
-                                    enum: ['major', 'minor', 'patch'],
-                                    default: 'minor',
-                                    description: 'Type of release to check readiness for'
+                                    description: 'Business justification for overrides (required for emergency_override)'
+                                },
+                                approvalRequired: {
+                                    type: 'boolean',
+                                    default: true,
+                                    description: 'Require approval for overrides'
                                 }
-                            }
+                            },
+                            required: ['operation']
                         }
                     },
                     {
@@ -1895,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;
@@ -2675,6 +2827,27 @@ ${environmentResult.content[0].text}
                 temperature: 0.1,
                 maxTokens: 6000,
             });
+            // Step 6: Record project structure to knowledge graph
+            try {
+                this.logger.info('Recording project structure to knowledge graph');
+                const projectStructureSnapshot = {
+                    projectPath,
+                    analysisDepth,
+                    recursiveDepth,
+                    technologyFocus,
+                    analysisScope,
+                    includeEnvironment,
+                    timestamp: new Date().toISOString(),
+                    structureData: baseProjectAnalysisPrompt.context || {}
+                };
+                await this.kgManager.recordProjectStructure(projectStructureSnapshot);
+                this.logger.info('✅ Project structure recorded to knowledge graph');
+            }
+            catch (kgError) {
+                this.logger.warn('Failed to record project structure to knowledge graph:', kgError);
+                // Don't fail the entire analysis if KG recording fails
+            }
+            // Return appropriate response based on execution result
             if (executionResult.isAIGenerated) {
                 // AI execution successful - return actual analysis results
                 return formatMCPResponse({
@@ -2693,6 +2866,7 @@ ${environmentResult.content[0].text}
 - **Reflexion Learning**: ${enhancedMode && learningEnabled ? '✅ Enabled' : '❌ Disabled'}
 - **Enhanced Mode**: ${enhancedMode ? '✅ Enabled' : '❌ Disabled'}
 - **Technology Focus**: ${technologyFocus.length > 0 ? technologyFocus.join(', ') : 'Auto-detect'}
+- **Knowledge Graph**: ✅ Project structure recorded
 
 ${knowledgeContext}
 
@@ -2761,6 +2935,7 @@ This comprehensive analysis provides deep recursive project understanding with i
 - **Enhanced Mode**: ${enhancedMode ? '✅ Enabled' : '❌ Disabled'}
 - **Technology Focus**: ${technologyFocus.length > 0 ? technologyFocus.join(', ') : 'Auto-detect'}
 - **Include Patterns**: ${includePatterns?.length ? includePatterns.join(', ') : 'Default patterns'}
+- **Knowledge Graph**: ✅ Project structure recorded
 
 ${knowledgeContext}
 
@@ -4556,13 +4731,22 @@ Please provide:
     }
     async smartGitPush(args) {
         try {
-            const { smartGitPush } = await import('./tools/smart-git-push-tool.js');
+            const { smartGitPush } = await import('./tools/smart-git-push-tool-v2.js');
             return await smartGitPush(args);
         }
         catch (error) {
             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');