agentic-qe 1.4.4 → 1.5.0

package/dist/mcp/tools/qe/quality-gates/assess-deployment-risk.d.ts

@@ -0,0 +1,239 @@
+/**
+ * Deployment Risk Assessment Tool
+ *
+ * Comprehensive risk assessment for deployments using multi-factor analysis.
+ * Evaluates deployment readiness based on quality metrics, environment context,
+ * historical data, and change complexity.
+ *
+ * @module tools/qe/quality-gates/assess-deployment-risk
+ * @version 1.0.0
+ * @author Agentic QE Team - Phase 3
+ * @date 2025-11-09
+ */
+import { QualityMetrics, Environment, Priority, QEToolResponse } from '../shared/types.js';
+/**
+ * Parameters for deployment risk assessment
+ */
+export interface AssessDeploymentRiskParams {
+    /** Project identifier */
+    projectId: string;
+    /** Deployment identifier */
+    deploymentId: string;
+    /** Target environment */
+    environment: Environment;
+    /** Current quality metrics */
+    metrics: QualityMetrics;
+    /** Deployment configuration */
+    deploymentConfig: DeploymentConfig;
+    /** Historical deployments */
+    historicalDeployments?: HistoricalDeployment[];
+    /** Code changes */
+    changes?: CodeChangeInfo[];
+}
+/**
+ * Deployment configuration
+ */
+export interface DeploymentConfig {
+    /** Deployment strategy */
+    strategy: 'rolling' | 'blue-green' | 'canary' | 'recreate';
+    /** Target instances */
+    targetInstances: number;
+    /** Rollback enabled */
+    rollbackEnabled: boolean;
+    /** Health checks configured */
+    healthChecks: boolean;
+    /** Monitoring enabled */
+    monitoringEnabled: boolean;
+    /** Deployment criticality */
+    criticality: Priority;
+    /** Deployment window */
+    window?: {
+        start: string;
+        end: string;
+    };
+}
+/**
+ * Historical deployment record
+ */
+export interface HistoricalDeployment {
+    /** Deployment ID */
+    id: string;
+    /** Environment */
+    environment: Environment;
+    /** Success status */
+    success: boolean;
+    /** Quality score at deployment */
+    qualityScore: number;
+    /** Deployment duration (minutes) */
+    duration: number;
+    /** Incidents count */
+    incidents: number;
+    /** Rollback performed */
+    rolledBack: boolean;
+    /** Timestamp */
+    timestamp: string;
+}
+/**
+ * Code change information
+ */
+export interface CodeChangeInfo {
+    /** File path */
+    file: string;
+    /** Change type */
+    type: 'added' | 'modified' | 'deleted';
+    /** Lines changed */
+    linesChanged: number;
+    /** Cyclomatic complexity delta */
+    complexityDelta: number;
+    /** Test coverage */
+    coverage: number;
+    /** Author */
+    author: string;
+    /** Commit hash */
+    commit: string;
+    /** Change timestamp */
+    timestamp: string;
+}
+/**
+ * Deployment risk assessment result
+ */
+export interface DeploymentRiskAssessment {
+    /** Overall risk level */
+    riskLevel: 'low' | 'medium' | 'high' | 'critical';
+    /** Risk score (0-100) */
+    riskScore: number;
+    /** Deployment recommendation */
+    recommendation: 'proceed' | 'proceed-with-caution' | 'delay' | 'block';
+    /** Risk factors identified */
+    riskFactors: RiskFactor[];
+    /** Risk categories */
+    categories: RiskCategories;
+    /** Mitigation strategies */
+    mitigationStrategies: MitigationStrategy[];
+    /** Readiness indicators */
+    readinessIndicators: ReadinessIndicators;
+    /** Prediction analysis */
+    prediction: PredictionAnalysis;
+    /** Confidence in assessment */
+    confidence: number;
+}
+/**
+ * Individual risk factor
+ */
+export interface RiskFactor {
+    /** Risk category */
+    category: string;
+    /** Risk type */
+    type: string;
+    /** Severity */
+    severity: Priority;
+    /** Probability (0-1) */
+    probability: number;
+    /** Impact score (0-10) */
+    impact: number;
+    /** Description */
+    description: string;
+    /** Evidence */
+    evidence: string[];
+}
+/**
+ * Risk categories breakdown
+ */
+export interface RiskCategories {
+    /** Quality risk */
+    quality: CategoryRisk;
+    /** Security risk */
+    security: CategoryRisk;
+    /** Performance risk */
+    performance: CategoryRisk;
+    /** Infrastructure risk */
+    infrastructure: CategoryRisk;
+    /** Change risk */
+    change: CategoryRisk;
+}
+/**
+ * Category-specific risk assessment
+ */
+export interface CategoryRisk {
+    /** Risk level */
+    level: Priority;
+    /** Risk score (0-100) */
+    score: number;
+    /** Contributing factors */
+    factors: string[];
+    /** Indicators */
+    indicators: {
+        positive: string[];
+        negative: string[];
+    };
+}
+/**
+ * Mitigation strategy
+ */
+export interface MitigationStrategy {
+    /** Risk being mitigated */
+    riskType: string;
+    /** Strategy description */
+    strategy: string;
+    /** Implementation steps */
+    steps: string[];
+    /** Expected impact */
+    expectedImpact: string;
+    /** Effort required */
+    effort: 'low' | 'medium' | 'high';
+    /** Priority */
+    priority: Priority;
+}
+/**
+ * Readiness indicators
+ */
+export interface ReadinessIndicators {
+    /** Overall readiness percentage */
+    overall: number;
+    /** Individual indicators */
+    indicators: {
+        qualityMetrics: boolean;
+        testCoverage: boolean;
+        securityScan: boolean;
+        performanceBaseline: boolean;
+        rollbackPlan: boolean;
+        monitoring: boolean;
+        documentation: boolean;
+    };
+    /** Missing requirements */
+    missing: string[];
+}
+/**
+ * Prediction analysis
+ */
+export interface PredictionAnalysis {
+    /** Predicted success probability */
+    successProbability: number;
+    /** Predicted incident count */
+    predictedIncidents: number;
+    /** Predicted rollback probability */
+    rollbackProbability: number;
+    /** Confidence in prediction */
+    confidence: number;
+    /** Based on historical data */
+    basedOn: {
+        deploymentCount: number;
+        timeRange: string;
+    };
+}
+/**
+ * Assess deployment risk using multi-factor analysis
+ *
+ * Evaluates:
+ * - Quality metrics
+ * - Security vulnerabilities
+ * - Performance indicators
+ * - Infrastructure readiness
+ * - Change complexity
+ * - Historical patterns
+ *
+ * @param params - Assessment parameters
+ * @returns Comprehensive risk assessment
+ */
+export declare function assessDeploymentRisk(params: AssessDeploymentRiskParams): Promise<QEToolResponse<DeploymentRiskAssessment>>;
+//# sourceMappingURL=assess-deployment-risk.d.ts.map

package/dist/mcp/tools/qe/quality-gates/assess-deployment-risk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assess-deployment-risk.d.ts","sourceRoot":"","sources":["../../../../../src/mcp/tools/qe/quality-gates/assess-deployment-risk.ts"],"names":[],"mappings":"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"}