mcp-adr-analysis-server 2.1.11 → 2.1.20

package/dist/src/resources/deployment-status-resource.d.ts

@@ -0,0 +1,256 @@
+/**
+ * Deployment Status Resource - Current deployment state
+ * URI Pattern: adr://deployment_status
+ */
+import { URLSearchParams } from 'url';
+import { ResourceGenerationResult } from './index.js';
+export interface DeploymentStatus {
+    environment: string;
+    version: string;
+    branch: string;
+    commit: string;
+    commitMessage: string;
+    lastDeploy: string;
+    status: 'healthy' | 'degraded' | 'failed' | 'unknown';
+    checks: Array<{
+        name: string;
+        status: 'passed' | 'failed' | 'warning';
+        message: string;
+        timestamp: string;
+    }>;
+    dependencies: {
+        total: number;
+        outdated: number;
+        vulnerable: number;
+    };
+    buildInfo: {
+        lastBuild: string;
+        buildDuration?: number;
+        buildStatus: 'success' | 'failure' | 'unknown';
+    };
+    deploymentReadiness: {
+        score: number;
+        blockers: string[];
+        warnings: string[];
+        recommendations: string[];
+    };
+    codeQualityAnalysis?: {
+        overallScore: number;
+        productionCodeScore: number;
+        mockCodeIndicators: number;
+        productionCodeThreshold: number;
+        qualityGates: Array<{
+            gate: string;
+            passed: boolean;
+            score?: number;
+            threshold?: number;
+        }>;
+        treeAnalysis?: {
+            totalFiles: number;
+            productionFiles: number;
+            mockFiles: number;
+            testFiles: number;
+        };
+    };
+    testValidation?: {
+        testExecutionResult: 'passed' | 'failed' | 'partial' | 'unknown';
+        totalTests: number;
+        passedTests: number;
+        failedTests: number;
+        skippedTests: number;
+        coverage: number;
+        zeroToleranceEnforced: boolean;
+        failureDetails: Array<{
+            suite: string;
+            test: string;
+            error: string;
+            file?: string;
+            line?: number;
+        }>;
+    };
+    deploymentHistory?: {
+        totalDeployments: number;
+        successfulDeployments: number;
+        failedDeployments: number;
+        successRate: number;
+        recentFailures: number;
+        rollbackFrequency: number;
+        averageDeploymentTime: string;
+        lastSuccessfulDeployment?: string;
+        lastFailedDeployment?: string;
+        trends: Array<{
+            metric: string;
+            trend: 'improving' | 'degrading' | 'stable';
+            change: number;
+        }>;
+    };
+    adrCompliance?: {
+        totalRequirements: number;
+        metRequirements: number;
+        unmetRequirements: number;
+        complianceScore: number;
+        violations: Array<{
+            requirement: string;
+            adrId: string;
+            severity: 'critical' | 'high' | 'medium' | 'low';
+            description: string;
+        }>;
+    };
+    criticalBlockers?: Array<{
+        category: 'tests' | 'code_quality' | 'dependencies' | 'adr_compliance' | 'deployment_history';
+        title: string;
+        description: string;
+        severity: 'critical' | 'high' | 'medium' | 'low';
+        resolutionSteps: string[];
+        autoFixable: boolean;
+    }>;
+    memoryIntegration?: {
+        enabled: boolean;
+        assessmentId?: string;
+        historicalComparison?: {
+            previousScore: number;
+            currentScore: number;
+            trend: string;
+            improvement: number;
+        };
+        patternAnalysis?: {
+            commonFailures: string[];
+            successPatterns: string[];
+            riskFactors: string[];
+        };
+        insights?: string[];
+    };
+    gitPushStatus?: {
+        allowed: boolean;
+        decision: 'allowed' | 'blocked' | 'conditional';
+        reason: string;
+        conditions?: string[];
+    };
+    emergencyOverride?: {
+        active: boolean;
+        justification?: string;
+        approver?: string;
+        timestamp?: string;
+        expiresAt?: string;
+    };
+    environmentResearch?: {
+        answer: string;
+        confidence: number;
+        sources: string[];
+        needsWebSearch: boolean;
+    };
+    analysisMetadata?: {
+        operation: string;
+        timestamp: string;
+        confidence: number;
+        source: 'basic' | 'comprehensive-tool';
+        memoryIntegration: boolean;
+        strictMode: boolean;
+    };
+}
+/**
+ * Generate comprehensive deployment status resource with readiness analysis and quality gates.
+ *
+ * Performs multi-dimensional deployment readiness assessment including code quality validation,
+ * test execution, dependency health, ADR compliance, deployment history analysis, and optional
+ * memory-based pattern recognition for predictive insights.
+ *
+ * **Query Parameters:**
+ * - `operation`: Operation type (default: "check_readiness")
+ * - `environment`: Target deployment environment (default: process.env.NODE_ENV || "production")
+ * - `memory`: Enable memory integration for historical analysis (default: true)
+ * - `strict`: Enable strict zero-tolerance mode (default: true)
+ * - `comprehensive`: Use comprehensive analysis vs basic (default: true)
+ *
+ * **Comprehensive Mode includes:**
+ * - TreeSitter AST-based code quality analysis with production code scoring
+ * - Zero-tolerance test validation with detailed failure tracking
+ * - Deployment history analysis with trend detection
+ * - ADR compliance validation
+ * - Memory-based pattern analysis and insights
+ * - Critical blocker identification with auto-fix suggestions
+ * - Git push allow/block decision logic
+ *
+ * @param _params - URL path parameters (currently unused, reserved for future routing)
+ * @param searchParams - URL query parameters controlling analysis behavior
+ *
+ * @returns Promise resolving to resource generation result containing:
+ *   - data: Complete deployment status with health metrics and quality gates
+ *   - contentType: "application/json"
+ *   - lastModified: ISO timestamp of generation
+ *   - cacheKey: Unique identifier based on operation/environment/options
+ *   - ttl: Cache duration (180 seconds / 3 minutes)
+ *   - etag: Entity tag for cache validation
+ *
+ * @throws {McpAdrError} When deployment status generation fails due to:
+ *   - Invalid operation or environment parameters
+ *   - Deployment-readiness-tool execution failure
+ *   - Test execution failures (in strict mode)
+ *   - Cache operation errors
+ *
+ * @example
+ * ```typescript
+ * // Basic usage with comprehensive analysis
+ * const status = await generateDeploymentStatusResource(
+ *   {},
+ *   new URLSearchParams('operation=check_readiness&environment=production')
+ * );
+ *
+ * console.log(`Status: ${status.data.status}`);
+ * console.log(`Readiness score: ${status.data.deploymentReadiness.score}`);
+ * console.log(`Blockers: ${status.data.deploymentReadiness.blockers.length}`);
+ *
+ * // Check if deployment is allowed
+ * if (status.data.gitPushStatus?.decision === 'blocked') {
+ *   console.error(`Deployment blocked: ${status.data.gitPushStatus.reason}`);
+ *   process.exit(1);
+ * }
+ *
+ * // Example with basic mode (faster, less detailed)
+ * const basicStatus = await generateDeploymentStatusResource(
+ *   {},
+ *   new URLSearchParams('comprehensive=false&memory=false')
+ * );
+ *
+ * // Expected output structure:
+ * {
+ *   data: {
+ *     environment: "production",
+ *     status: "healthy",
+ *     version: "2.0.22",
+ *     deploymentReadiness: {
+ *       score: 95,
+ *       blockers: [],
+ *       warnings: ["Minor test coverage gaps"],
+ *       recommendations: ["Increase integration test coverage"]
+ *     },
+ *     codeQualityAnalysis: {
+ *       overallScore: 92,
+ *       productionCodeScore: 95,
+ *       qualityGates: [...]
+ *     },
+ *     testValidation: {
+ *       testExecutionResult: "passed",
+ *       totalTests: 150,
+ *       passedTests: 150,
+ *       failedTests: 0,
+ *       coverage: 85
+ *     },
+ *     gitPushStatus: {
+ *       allowed: true,
+ *       decision: "allowed",
+ *       reason: "All quality gates passed"
+ *     }
+ *   },
+ *   contentType: "application/json",
+ *   cacheKey: "deployment-status:check_readiness:production:true:true:true",
+ *   ttl: 180
+ * }
+ * ```
+ *
+ * @since v2.0.0
+ * @see {@link deploymentReadiness} tool for underlying analysis engine
+ * @see {@link generateDeploymentHistoryResource} for historical deployment data
+ */
+export declare function generateDeploymentStatusResource(_params?: Record<string, string>, searchParams?: URLSearchParams): Promise<ResourceGenerationResult>;
+//# sourceMappingURL=deployment-status-resource.d.ts.map

package/dist/src/resources/deployment-status-resource.d.ts.map

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