runbooks 1.1.3__py3-none-any.whl → 1.1.5__py3-none-any.whl

runbooks/finops/schemas.py

@@ -20,38 +20,39 @@ Strategic Alignment:
 - Maintains enterprise standards for data integrity
 """
 
-from decimal import Decimal, ROUND_HALF_UP
-from datetime import datetime, date
-from typing import Dict, List, Optional, Union, Any, Literal
-from enum import Enum
 import re
+from datetime import date, datetime
+from decimal import ROUND_HALF_UP, Decimal
+from enum import Enum
+from typing import Any, Dict, List, Literal, Optional, Union
 
-from pydantic import BaseModel, Field, field_validator, model_validator, ConfigDict
-from pydantic.types import UUID4, PositiveFloat, NonNegativeFloat
+from pydantic import BaseModel, ConfigDict, Field, field_validator, model_validator
+from pydantic.types import UUID4, NonNegativeFloat, PositiveFloat
 
 
 # Configuration for Pydantic v2
 class BaseSchema(BaseModel):
     """Base schema with common configuration for all models."""
-    
+
     model_config = ConfigDict(
         # Enable strict validation
         str_strip_whitespace=True,
         validate_assignment=True,
         use_enum_values=True,
         # Allow for schema evolution
-        extra='forbid',  # Strict validation - no unexpected fields
+        extra="forbid",  # Strict validation - no unexpected fields
         # JSON encoding settings
         json_encoders={
             datetime: lambda dt: dt.isoformat(),
             date: lambda d: d.isoformat(),
             Decimal: lambda d: float(d),
-        }
+        },
     )
 
 
 class ComplexityLevel(str, Enum):
     """Implementation complexity levels for cost optimization scenarios."""
+
     LOW = "Low"
     MEDIUM = "Medium"
     HIGH = "High"
@@ -59,6 +60,7 @@ class ComplexityLevel(str, Enum):
 
 class RiskLevel(str, Enum):
     """Risk levels for cost optimization implementations."""
+
     LOW = "Low"
     MEDIUM = "Medium"
     HIGH = "High"
@@ -67,6 +69,7 @@ class RiskLevel(str, Enum):
 
 class OptimizationCategory(str, Enum):
     """Categories of cost optimization scenarios."""
+
     UNUSED_RESOURCES = "Unused Resources"
     RIGHTSIZING = "Rightsizing"
     RESERVED_INSTANCES = "Reserved Instances"
@@ -79,8 +82,9 @@ class OptimizationCategory(str, Enum):
 
 class ValidationStatus(str, Enum):
     """Validation status for cross-checking with MCP servers."""
+
     VALIDATED = "validated"
-    VARIANCE_DETECTED = "variance_detected" 
+    VARIANCE_DETECTED = "variance_detected"
     MCP_UNAVAILABLE = "mcp_unavailable"
     ERROR = "error"
     PENDING = "pending"
@@ -88,6 +92,7 @@ class ValidationStatus(str, Enum):
 
 class ExportFormat(str, Enum):
     """Supported export formats for reports."""
+
     JSON = "json"
     CSV = "csv"
     HTML = "html"
@@ -97,219 +102,244 @@ class ExportFormat(str, Enum):
 
 # Core Cost Optimization Schemas
 
+
 class CostBreakdown(BaseSchema):
     """Detailed cost breakdown by service/category."""
-    
+
     service_name: str = Field(..., min_length=1, max_length=100)
     monthly_cost: NonNegativeFloat = Field(..., ge=0)
     annual_cost: NonNegativeFloat = Field(..., ge=0)
     percentage_of_total: float = Field(..., ge=0, le=100)
     resource_count: int = Field(..., ge=0)
-    
-    @field_validator('service_name')
+
+    @field_validator("service_name")
     @classmethod
     def validate_service_name(cls, v):
         """Validate AWS service names."""
         # Common AWS service patterns
         valid_patterns = [
-            r'^EC2-',  # EC2 services
-            r'^S3',    # S3 services
-            r'^RDS',   # RDS services
-            r'^Lambda', # Lambda
-            r'^CloudWatch', # CloudWatch
-            r'^VPC',   # VPC services
-            r'^Route 53', # Route 53
-            r'^ElastiCache', # ElastiCache
-            r'^Redshift', # Redshift
-            r'^\w+$'   # General service names
+            r"^EC2-",  # EC2 services
+            r"^S3",  # S3 services
+            r"^RDS",  # RDS services
+            r"^Lambda",  # Lambda
+            r"^CloudWatch",  # CloudWatch
+            r"^VPC",  # VPC services
+            r"^Route 53",  # Route 53
+            r"^ElastiCache",  # ElastiCache
+            r"^Redshift",  # Redshift
+            r"^\w+$",  # General service names
         ]
-        
+
         if not any(re.match(pattern, v) for pattern in valid_patterns):
             # Allow any string for flexibility, but validate length
             if len(v.strip()) == 0:
-                raise ValueError('Service name cannot be empty')
-        
+                raise ValueError("Service name cannot be empty")
+
         return v.strip()
-    
-    @field_validator('annual_cost')
+
+    @field_validator("annual_cost")
     @classmethod
     def validate_annual_cost_consistency(cls, v, info):
         """Ensure annual cost is approximately 12x monthly cost."""
-        if 'monthly_cost' in info.data:
-            expected_annual = info.data['monthly_cost'] * 12
+        if "monthly_cost" in info.data:
+            expected_annual = info.data["monthly_cost"] * 12
             # Allow 1% tolerance for rounding differences
             if abs(v - expected_annual) > (expected_annual * 0.01):
-                raise ValueError(f'Annual cost {v} should be approximately 12x monthly cost {info.data["monthly_cost"]}')
+                raise ValueError(
+                    f"Annual cost {v} should be approximately 12x monthly cost {info.data['monthly_cost']}"
+                )
         return v
 
 
 class OptimizationScenario(BaseSchema):
     """Individual cost optimization scenario with validation."""
-    
+
     scenario_name: str = Field(..., min_length=3, max_length=200)
     category: OptimizationCategory = Field(...)
     description: str = Field(..., min_length=10, max_length=1000)
-    
+
     # Financial metrics
     monthly_savings: NonNegativeFloat = Field(..., ge=0)
     annual_savings: NonNegativeFloat = Field(..., ge=0)
     implementation_cost: NonNegativeFloat = Field(0, ge=0)
     payback_period_months: Optional[PositiveFloat] = Field(None, gt=0, le=120)  # Max 10 years
-    
+
     # Implementation details
     complexity: ComplexityLevel = Field(...)
     risk_level: RiskLevel = Field(...)
     estimated_hours: PositiveFloat = Field(..., gt=0, le=2000)  # Reasonable implementation time
-    
+
     # Resource impact
     affected_services: List[str] = Field(..., min_items=1)
     affected_accounts: List[str] = Field(..., min_items=1)
     resource_count: int = Field(..., ge=1)
-    
+
     # Validation metadata
     validation_status: ValidationStatus = Field(ValidationStatus.PENDING)
     validation_timestamp: Optional[datetime] = Field(None)
     mcp_variance_percent: Optional[float] = Field(None, ge=0, le=100)
-    
-    @field_validator('scenario_name')
+
+    @field_validator("scenario_name")
     @classmethod
     def validate_scenario_name(cls, v):
         """Validate scenario naming conventions."""
         # Ensure professional naming
-        if not re.match(r'^[A-Z][A-Za-z0-9\s\-\(\)]{2,199}$', v):
-            raise ValueError('Scenario name must start with capital letter and contain only letters, numbers, spaces, hyphens, and parentheses')
+        if not re.match(r"^[A-Z][A-Za-z0-9\s\-\(\)]{2,199}$", v):
+            raise ValueError(
+                "Scenario name must start with capital letter and contain only letters, numbers, spaces, hyphens, and parentheses"
+            )
         return v.strip()
-    
-    @field_validator('annual_savings')
+
+    @field_validator("annual_savings")
     @classmethod
     def validate_annual_savings_consistency(cls, v, info):
         """Ensure annual savings consistency with monthly savings."""
-        if 'monthly_savings' in info.data:
-            expected_annual = info.data['monthly_savings'] * 12
+        if "monthly_savings" in info.data:
+            expected_annual = info.data["monthly_savings"] * 12
             if abs(v - expected_annual) > (expected_annual * 0.01):  # 1% tolerance
-                raise ValueError(f'Annual savings {v} should be approximately 12x monthly savings {info.data["monthly_savings"]}')
+                raise ValueError(
+                    f"Annual savings {v} should be approximately 12x monthly savings {info.data['monthly_savings']}"
+                )
         return v
-    
-    @field_validator('payback_period_months')
+
+    @field_validator("payback_period_months")
     @classmethod
     def calculate_payback_period(cls, v, info):
         """Calculate payback period if not provided."""
-        if v is None and 'implementation_cost' in info.data and 'monthly_savings' in info.data:
-            impl_cost = info.data['implementation_cost']
-            monthly_savings = info.data['monthly_savings']
+        if v is None and "implementation_cost" in info.data and "monthly_savings" in info.data:
+            impl_cost = info.data["implementation_cost"]
+            monthly_savings = info.data["monthly_savings"]
             if monthly_savings > 0:
                 calculated_payback = impl_cost / monthly_savings
                 return round(calculated_payback, 1)
         return v
-    
-    @field_validator('affected_services')
+
+    @field_validator("affected_services")
     @classmethod
     def validate_aws_services(cls, v):
         """Validate AWS service names in affected services."""
         common_services = {
-            'EC2', 'S3', 'RDS', 'Lambda', 'CloudWatch', 'VPC', 'ELB', 
-            'Route53', 'CloudFront', 'ElastiCache', 'Redshift', 'DynamoDB',
-            'EBS', 'EFS', 'FSx', 'Backup', 'Config', 'CloudTrail', 'IAM'
+            "EC2",
+            "S3",
+            "RDS",
+            "Lambda",
+            "CloudWatch",
+            "VPC",
+            "ELB",
+            "Route53",
+            "CloudFront",
+            "ElastiCache",
+            "Redshift",
+            "DynamoDB",
+            "EBS",
+            "EFS",
+            "FSx",
+            "Backup",
+            "Config",
+            "CloudTrail",
+            "IAM",
         }
-        
+
         for service in v:
             # Allow any service that starts with common patterns or is in common list
-            if not (service in common_services or 
-                   any(service.startswith(prefix) for prefix in ['AWS', 'Amazon']) or
-                   re.match(r'^[A-Z][A-Za-z0-9\-]{1,50}$', service)):
-                raise ValueError(f'Invalid AWS service name: {service}')
-        
+            if not (
+                service in common_services
+                or any(service.startswith(prefix) for prefix in ["AWS", "Amazon"])
+                or re.match(r"^[A-Z][A-Za-z0-9\-]{1,50}$", service)
+            ):
+                raise ValueError(f"Invalid AWS service name: {service}")
+
         return v
-    
-    @field_validator('affected_accounts')
+
+    @field_validator("affected_accounts")
     @classmethod
     def validate_account_ids(cls, v):
         """Validate AWS account ID format."""
-        account_pattern = r'^\d{12}$|^[\w\-\.]{1,50}$'  # 12-digit ID or account name
-        
+        account_pattern = r"^\d{12}$|^[\w\-\.]{1,50}$"  # 12-digit ID or account name
+
         for account in v:
             if not re.match(account_pattern, account):
-                raise ValueError(f'Invalid account format: {account}. Must be 12-digit ID or valid account name')
-        
+                raise ValueError(f"Invalid account format: {account}. Must be 12-digit ID or valid account name")
+
         return v
 
 
 class CostOptimizationResult(BaseSchema):
     """Comprehensive cost optimization analysis result."""
-    
+
     # Analysis metadata
     analysis_id: UUID4 = Field(..., description="Unique analysis identifier")
     analysis_timestamp: datetime = Field(..., description="Analysis execution time")
     profile_name: str = Field(..., min_length=1, max_length=100)
-    
+
     # Scope and configuration
     analysis_scope: Literal["single_account", "multi_account", "organization"] = Field(...)
     total_accounts: int = Field(..., ge=1, le=1000)  # Reasonable limit
     analysis_period_days: int = Field(..., ge=1, le=365)
-    
+
     # Financial summary
     current_monthly_spend: NonNegativeFloat = Field(..., ge=0)
     total_potential_monthly_savings: NonNegativeFloat = Field(..., ge=0)
     total_potential_annual_savings: NonNegativeFloat = Field(..., ge=0)
     savings_percentage: float = Field(..., ge=0, le=100)
-    
+
     # Scenarios and breakdown
     optimization_scenarios: List[OptimizationScenario] = Field(..., min_items=1, max_items=100)
     cost_breakdown: List[CostBreakdown] = Field(..., min_items=1)
-    
+
     # Implementation summary
     total_scenarios: int = Field(..., ge=1)
     low_complexity_scenarios: int = Field(..., ge=0)
     medium_complexity_scenarios: int = Field(..., ge=0)
     high_complexity_scenarios: int = Field(..., ge=0)
-    
+
     # Risk assessment
     average_risk_score: float = Field(..., ge=1, le=5)  # 1-5 scale
     high_risk_scenarios_count: int = Field(..., ge=0)
-    
+
     # Validation and quality
     mcp_validation_status: ValidationStatus = Field(ValidationStatus.PENDING)
     validation_summary: Optional[Dict[str, Any]] = Field(None)
     accuracy_confidence: Optional[float] = Field(None, ge=0, le=100)
-    
+
     # Export metadata
     supported_export_formats: List[ExportFormat] = Field(
         default=[ExportFormat.JSON, ExportFormat.CSV, ExportFormat.PDF]
     )
-    
-    @field_validator('total_potential_annual_savings')
+
+    @field_validator("total_potential_annual_savings")
     @classmethod
     def validate_annual_consistency(cls, v, info):
         """Validate annual savings consistency."""
-        if 'total_potential_monthly_savings' in info.data:
-            expected = info.data['total_potential_monthly_savings'] * 12
+        if "total_potential_monthly_savings" in info.data:
+            expected = info.data["total_potential_monthly_savings"] * 12
             if abs(v - expected) > (expected * 0.01):
-                raise ValueError('Annual savings must be approximately 12x monthly savings')
+                raise ValueError("Annual savings must be approximately 12x monthly savings")
         return v
-    
-    @field_validator('savings_percentage')
+
+    @field_validator("savings_percentage")
     @classmethod
     def calculate_savings_percentage(cls, v, info):
         """Validate or calculate savings percentage."""
-        if 'current_monthly_spend' in info.data and 'total_potential_monthly_savings' in info.data:
-            current_spend = info.data['current_monthly_spend']
+        if "current_monthly_spend" in info.data and "total_potential_monthly_savings" in info.data:
+            current_spend = info.data["current_monthly_spend"]
             if current_spend > 0:
-                calculated = (info.data['total_potential_monthly_savings'] / current_spend) * 100
+                calculated = (info.data["total_potential_monthly_savings"] / current_spend) * 100
                 if abs(v - calculated) > 0.1:  # 0.1% tolerance
-                    raise ValueError(f'Savings percentage {v}% inconsistent with calculated {calculated:.1f}%')
+                    raise ValueError(f"Savings percentage {v}% inconsistent with calculated {calculated:.1f}%")
         return v
-    
-    @field_validator('total_scenarios')
+
+    @field_validator("total_scenarios")
     @classmethod
     def validate_scenario_count(cls, v, info):
         """Ensure scenario count matches actual scenarios."""
-        if 'optimization_scenarios' in info.data:
-            actual_count = len(info.data['optimization_scenarios'])
+        if "optimization_scenarios" in info.data:
+            actual_count = len(info.data["optimization_scenarios"])
             if v != actual_count:
-                raise ValueError(f'Total scenarios {v} does not match actual scenarios count {actual_count}')
+                raise ValueError(f"Total scenarios {v} does not match actual scenarios count {actual_count}")
         return v
-    
-    @model_validator(mode='after')
+
+    @model_validator(mode="after")
     def validate_complexity_distribution(self):
         """Validate complexity scenario counts."""
         scenarios = self.optimization_scenarios or []
@@ -317,112 +347,112 @@ class CostOptimizationResult(BaseSchema):
             low_count = sum(1 for s in scenarios if s.complexity == ComplexityLevel.LOW)
             medium_count = sum(1 for s in scenarios if s.complexity == ComplexityLevel.MEDIUM)
             high_count = sum(1 for s in scenarios if s.complexity == ComplexityLevel.HIGH)
-            
+
             expected_low = self.low_complexity_scenarios or 0
             expected_medium = self.medium_complexity_scenarios or 0
             expected_high = self.high_complexity_scenarios or 0
-            
-            if (low_count != expected_low or 
-                medium_count != expected_medium or 
-                high_count != expected_high):
+
+            if low_count != expected_low or medium_count != expected_medium or high_count != expected_high:
                 raise ValueError(
-                    f'Complexity counts mismatch: expected L:{expected_low} M:{expected_medium} H:{expected_high}, '
-                    f'actual L:{low_count} M:{medium_count} H:{high_count}'
+                    f"Complexity counts mismatch: expected L:{expected_low} M:{expected_medium} H:{expected_high}, "
+                    f"actual L:{low_count} M:{medium_count} H:{high_count}"
                 )
-        
+
         return self
 
 
 # Business Interface Schemas
 
+
 class ExecutiveSummary(BaseSchema):
     """Executive-ready summary for business stakeholders."""
-    
+
     # High-level metrics
     total_annual_opportunity: NonNegativeFloat = Field(..., ge=0)
     confidence_level: float = Field(..., ge=70, le=100)  # Must be high confidence for exec presentation
     implementation_timeline_months: PositiveFloat = Field(..., gt=0, le=24)  # Reasonable timeline
-    
+
     # Business impact
     roi_percentage: PositiveFloat = Field(..., gt=0)
     payback_period_months: PositiveFloat = Field(..., gt=0, le=60)  # Max 5 years
     risk_assessment: RiskLevel = Field(...)
-    
+
     # Quick wins
     quick_wins_count: int = Field(..., ge=0, le=50)
     quick_wins_annual_value: NonNegativeFloat = Field(..., ge=0)
-    
+
     # Implementation priority
     priority_scenarios: List[str] = Field(..., max_items=10)  # Top priorities only
     recommended_next_steps: List[str] = Field(..., min_items=1, max_items=5)
-    
+
     # Validation status
     data_validation_status: ValidationStatus = Field(...)
     last_validated: datetime = Field(...)
-    
-    @field_validator('roi_percentage')
+
+    @field_validator("roi_percentage")
     @classmethod
     def validate_reasonable_roi(cls, v):
         """Ensure ROI is reasonable for executive presentation."""
         if v > 1000:  # 1000% ROI
-            raise ValueError('ROI over 1000% requires additional validation')
+            raise ValueError("ROI over 1000% requires additional validation")
         return v
 
 
 # Technical Validation Schemas
 
+
 class MCPValidationResult(BaseSchema):
     """MCP cross-validation result with strict tolerance checking."""
-    
+
     validation_timestamp: datetime = Field(...)
     notebook_value: NonNegativeFloat = Field(..., ge=0)
     mcp_value: NonNegativeFloat = Field(..., ge=0)
     variance_amount: NonNegativeFloat = Field(..., ge=0)
     variance_percent: float = Field(..., ge=0)
     tolerance_threshold: PositiveFloat = Field(..., gt=0, le=10)  # Max 10% tolerance
-    
+
     validation_status: ValidationStatus = Field(...)
     validation_message: str = Field(..., min_length=1)
-    
+
     # Technical details
     mcp_source: str = Field(..., min_length=1)
     response_time_seconds: Optional[PositiveFloat] = Field(None, le=300)  # 5 minute timeout
-    
-    @field_validator('variance_percent')
+
+    @field_validator("variance_percent")
     @classmethod
     def calculate_variance_percent(cls, v, info):
         """Calculate and validate variance percentage."""
-        if 'notebook_value' in info.data and 'mcp_value' in info.data:
-            notebook_val = info.data['notebook_value']
-            mcp_val = info.data['mcp_value']
-            
+        if "notebook_value" in info.data and "mcp_value" in info.data:
+            notebook_val = info.data["notebook_value"]
+            mcp_val = info.data["mcp_value"]
+
             if notebook_val > 0:
                 calculated = abs((notebook_val - mcp_val) / notebook_val) * 100
                 if abs(v - calculated) > 0.01:  # Very tight tolerance for variance calculation
-                    raise ValueError(f'Variance percent {v}% does not match calculated {calculated:.2f}%')
+                    raise ValueError(f"Variance percent {v}% does not match calculated {calculated:.2f}%")
         return v
 
 
 class FunctionalTestResult(BaseSchema):
     """Functional testing result for technical validation."""
-    
+
     test_name: str = Field(..., min_length=3, max_length=200)
     test_category: Literal["cost_analysis", "mcp_validation", "export_validation", "performance"] = Field(...)
-    
+
     # Test execution
     execution_timestamp: datetime = Field(...)
     execution_time_seconds: PositiveFloat = Field(..., le=300)  # 5 minute timeout
     test_passed: bool = Field(...)
-    
+
     # Test details
     expected_value: Optional[Union[str, float, int, bool]] = Field(None)
     actual_value: Optional[Union[str, float, int, bool]] = Field(None)
     tolerance_applied: Optional[float] = Field(None, ge=0, le=10)
-    
+
     # Error handling
     error_message: Optional[str] = Field(None, max_length=1000)
     stack_trace: Optional[str] = Field(None, max_length=5000)
-    
+
     # Performance metrics
     memory_usage_mb: Optional[PositiveFloat] = Field(None, le=4096)  # 4GB max
     cpu_utilization_percent: Optional[float] = Field(None, ge=0, le=100)
@@ -430,92 +460,94 @@ class FunctionalTestResult(BaseSchema):
 
 class ComprehensiveTestSuite(BaseSchema):
     """Complete test suite results for technical validation."""
-    
+
     # Test suite metadata
     suite_id: UUID4 = Field(...)
     execution_timestamp: datetime = Field(...)
     total_execution_time_seconds: PositiveFloat = Field(...)
-    
+
     # Test results
     total_tests: int = Field(..., ge=1)
     passed_tests: int = Field(..., ge=0)
     failed_tests: int = Field(..., ge=0)
     skipped_tests: int = Field(..., ge=0)
-    
+
     test_results: List[FunctionalTestResult] = Field(..., min_items=1)
-    
+
     # Summary metrics
     pass_rate_percent: float = Field(..., ge=0, le=100)
     performance_target_met: bool = Field(...)
     mcp_validation_success: bool = Field(...)
-    
+
     # Quality gates
     meets_production_criteria: bool = Field(...)
     quality_score: float = Field(..., ge=0, le=100)
-    
-    @field_validator('passed_tests')
+
+    @field_validator("passed_tests")
     @classmethod
     def validate_test_counts(cls, v, info):
         """Ensure test counts are consistent."""
-        if 'failed_tests' in info.data and 'skipped_tests' in info.data and 'total_tests' in info.data:
-            calculated_total = v + info.data['failed_tests'] + info.data['skipped_tests']
-            if calculated_total != info.data['total_tests']:
-                raise ValueError(f'Test counts inconsistent: {calculated_total} ≠ {info.data["total_tests"]}')
+        if "failed_tests" in info.data and "skipped_tests" in info.data and "total_tests" in info.data:
+            calculated_total = v + info.data["failed_tests"] + info.data["skipped_tests"]
+            if calculated_total != info.data["total_tests"]:
+                raise ValueError(f"Test counts inconsistent: {calculated_total} ≠ {info.data['total_tests']}")
         return v
-    
-    @field_validator('pass_rate_percent')
+
+    @field_validator("pass_rate_percent")
     @classmethod
     def calculate_pass_rate(cls, v, info):
         """Calculate and validate pass rate."""
-        if 'passed_tests' in info.data and 'total_tests' in info.data:
-            total = info.data['total_tests']
+        if "passed_tests" in info.data and "total_tests" in info.data:
+            total = info.data["total_tests"]
             if total > 0:
-                calculated = (info.data['passed_tests'] / total) * 100
+                calculated = (info.data["passed_tests"] / total) * 100
                 if abs(v - calculated) > 0.01:
-                    raise ValueError(f'Pass rate {v}% inconsistent with calculated {calculated:.2f}%')
+                    raise ValueError(f"Pass rate {v}% inconsistent with calculated {calculated:.2f}%")
         return v
 
 
 # Export and Integration Schemas
 
+
 class ExportMetadata(BaseSchema):
     """Metadata for exported reports."""
-    
+
     export_timestamp: datetime = Field(...)
     export_format: ExportFormat = Field(...)
     file_path: str = Field(..., min_length=1, max_length=500)
     file_size_bytes: int = Field(..., ge=0)
-    
+
     # Content metadata
     record_count: int = Field(..., ge=0)
-    schema_version: str = Field(..., pattern=r'^\d+\.\d+\.\d+$')  # Semantic versioning
-    
+    schema_version: str = Field(..., pattern=r"^\d+\.\d+\.\d+$")  # Semantic versioning
+
     # Validation
     export_validated: bool = Field(...)
     validation_errors: List[str] = Field(default_factory=list)
-    
-    @field_validator('file_path')
+
+    @field_validator("file_path")
     @classmethod
     def validate_file_path(cls, v):
         """Validate file path format."""
         # Basic path validation
-        if not re.match(r'^[/\w\-\.\s]+\.(json|csv|html|pdf|md)$', v):
-            raise ValueError('Invalid file path format')
+        if not re.match(r"^[/\w\-\.\s]+\.(json|csv|html|pdf|md)$", v):
+            raise ValueError("Invalid file path format")
         return v
 
 
 # Utility Functions for Schema Validation
 
+
 def validate_cost_optimization_result(data: Dict[str, Any]) -> CostOptimizationResult:
     """
     Validate and create CostOptimizationResult from raw data.
-    
+
     Args:
         data: Raw data dictionary
-        
+
     Returns:
         Validated CostOptimizationResult instance
-        
+
     Raises:
         ValidationError: If data doesn't meet schema requirements
     """
@@ -525,22 +557,22 @@ def validate_cost_optimization_result(data: Dict[str, Any]) -> CostOptimizationR
 def create_executive_summary(optimization_result: CostOptimizationResult) -> ExecutiveSummary:
     """
     Create executive summary from optimization result.
-    
+
     Args:
         optimization_result: Validated optimization result
-        
+
     Returns:
         ExecutiveSummary instance
     """
     # Calculate quick wins (Low complexity, Low-Medium risk)
     quick_wins = [
-        scenario for scenario in optimization_result.optimization_scenarios
-        if (scenario.complexity == ComplexityLevel.LOW and 
-            scenario.risk_level in [RiskLevel.LOW, RiskLevel.MEDIUM])
+        scenario
+        for scenario in optimization_result.optimization_scenarios
+        if (scenario.complexity == ComplexityLevel.LOW and scenario.risk_level in [RiskLevel.LOW, RiskLevel.MEDIUM])
     ]
-    
+
     quick_wins_value = sum(scenario.annual_savings for scenario in quick_wins)
-    
+
     # Calculate implementation timeline (weighted by complexity)
     complexity_weights = {ComplexityLevel.LOW: 1, ComplexityLevel.MEDIUM: 3, ComplexityLevel.HIGH: 6}
     total_weighted_hours = sum(
@@ -548,12 +580,12 @@ def create_executive_summary(optimization_result: CostOptimizationResult) -> Exe
         for scenario in optimization_result.optimization_scenarios
     )
     timeline_months = max(1, total_weighted_hours / 160)  # Assuming 160 hours/month
-    
+
     # ROI calculation
     annual_savings = optimization_result.total_potential_annual_savings
     implementation_cost = sum(scenario.implementation_cost for scenario in optimization_result.optimization_scenarios)
     roi_percentage = (annual_savings / max(implementation_cost, 1)) * 100
-    
+
     return ExecutiveSummary(
         total_annual_opportunity=annual_savings,
         confidence_level=optimization_result.accuracy_confidence or 85.0,
@@ -564,41 +596,45 @@ def create_executive_summary(optimization_result: CostOptimizationResult) -> Exe
         quick_wins_count=len(quick_wins),
         quick_wins_annual_value=quick_wins_value,
         priority_scenarios=[
-            scenario.scenario_name for scenario in 
-            sorted(optimization_result.optimization_scenarios, 
-                  key=lambda x: x.annual_savings, reverse=True)[:5]
+            scenario.scenario_name
+            for scenario in sorted(
+                optimization_result.optimization_scenarios, key=lambda x: x.annual_savings, reverse=True
+            )[:5]
         ],
         recommended_next_steps=[
             "Review and approve quick-win scenarios",
-            "Establish implementation team and timeline", 
+            "Establish implementation team and timeline",
             "Set up monitoring for cost optimization KPIs",
-            "Schedule quarterly optimization reviews"
+            "Schedule quarterly optimization reviews",
         ],
         data_validation_status=optimization_result.mcp_validation_status,
-        last_validated=datetime.now()
+        last_validated=datetime.now(),
     )
 
 
 # Export all schemas and utilities
 __all__ = [
     # Enums
-    'ComplexityLevel', 'RiskLevel', 'OptimizationCategory', 'ValidationStatus', 'ExportFormat',
-    
+    "ComplexityLevel",
+    "RiskLevel",
+    "OptimizationCategory",
+    "ValidationStatus",
+    "ExportFormat",
     # Core schemas
-    'CostBreakdown', 'OptimizationScenario', 'CostOptimizationResult',
-    
-    # Business schemas  
-    'ExecutiveSummary',
-    
+    "CostBreakdown",
+    "OptimizationScenario",
+    "CostOptimizationResult",
+    # Business schemas
+    "ExecutiveSummary",
     # Technical validation schemas
-    'MCPValidationResult', 'FunctionalTestResult', 'ComprehensiveTestSuite',
-    
+    "MCPValidationResult",
+    "FunctionalTestResult",
+    "ComprehensiveTestSuite",
     # Export schemas
-    'ExportMetadata',
-    
+    "ExportMetadata",
     # Utility functions
-    'validate_cost_optimization_result', 'create_executive_summary',
-    
+    "validate_cost_optimization_result",
+    "create_executive_summary",
     # Base schema
-    'BaseSchema'
-]
+    "BaseSchema",
+]