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

runbooks/finops/business_case_config.py

@@ -1,7 +1,7 @@
 """
 Dynamic Business Case Configuration - Enterprise Template System
 
-Strategic Achievement: Replace hardcoded JIRA references with dynamic business case templates
+Strategic Achievement: Replace hardcoded references with dynamic business case templates
 - Enterprise naming conventions with configurable business scenarios
 - Dynamic financial targets and achievement tracking
 - Reusable template system for unlimited business case scaling
@@ -14,12 +14,13 @@ This module provides configurable business case templates following enterprise s
 
 import os
 from dataclasses import dataclass
-from typing import Dict, List, Optional, Any, Union, NamedTuple
 from enum import Enum
+from typing import Any, Dict, List, NamedTuple, Optional, Union
 
 
 class BusinessCaseType(Enum):
     """Standard business case types for enterprise scenarios."""
+
     COST_OPTIMIZATION = "cost_optimization"
     RESOURCE_CLEANUP = "resource_cleanup"
     COMPLIANCE_FRAMEWORK = "compliance_framework"
@@ -30,6 +31,7 @@ class BusinessCaseType(Enum):
 @dataclass
 class BusinessScenario:
     """Dynamic business scenario configuration."""
+
     scenario_id: str
     display_name: str
     business_case_type: BusinessCaseType
@@ -40,12 +42,12 @@ class BusinessScenario:
     risk_level: str = "Medium"
     implementation_status: str = "Analysis"
     cli_command_suffix: str = ""
-    
+
     @property
     def scenario_display_id(self) -> str:
         """Generate enterprise-friendly scenario display ID."""
         return f"{self.business_case_type.value.replace('_', '-').title()}-{self.scenario_id}"
-    
+
     @property
     def savings_range_display(self) -> str:
         """Generate savings range display for business presentations."""
@@ -62,18 +64,18 @@ class BusinessScenario:
 
 class BusinessCaseConfigManager:
     """Enterprise business case configuration manager."""
-    
+
     def __init__(self, config_source: Optional[str] = None):
         """
         Initialize business case configuration manager.
-        
+
         Args:
             config_source: Optional path to configuration file or environment variable prefix
         """
         self.config_source = config_source or "RUNBOOKS_BUSINESS_CASE"
         self.scenarios = self._load_default_scenarios()
         self._load_environment_overrides()
-    
+
     def _load_default_scenarios(self) -> Dict[str, BusinessScenario]:
         """Load default enterprise business scenarios."""
         return {
@@ -86,7 +88,7 @@ class BusinessCaseConfigManager:
                 business_description="Identify and optimize unused Amazon WorkSpaces for cost efficiency",
                 technical_focus="Zero-usage WorkSpaces detection and cost analysis",
                 risk_level="Low",
-                cli_command_suffix="workspaces"
+                cli_command_suffix="workspaces",
             ),
             "rds-snapshots": BusinessScenario(
                 scenario_id="rds-snapshots",
@@ -97,7 +99,7 @@ class BusinessCaseConfigManager:
                 business_description="Optimize manual RDS snapshots to reduce storage costs",
                 technical_focus="Manual RDS snapshot lifecycle management",
                 risk_level="Medium",
-                cli_command_suffix="rds-snapshots"
+                cli_command_suffix="rds-snapshots",
             ),
             "backup-investigation": BusinessScenario(
                 scenario_id="backup-investigation",
@@ -107,7 +109,7 @@ class BusinessCaseConfigManager:
                 technical_focus="Backup infrastructure resource utilization analysis",
                 risk_level="Medium",
                 implementation_status="Framework",
-                cli_command_suffix="backup-investigation"
+                cli_command_suffix="backup-investigation",
             ),
             "nat-gateway": BusinessScenario(
                 scenario_id="nat-gateway",
@@ -117,7 +119,7 @@ class BusinessCaseConfigManager:
                 target_savings_max=12000,
                 business_description="Optimize NAT Gateway configurations for cost efficiency",
                 technical_focus="NAT Gateway usage analysis and rightsizing",
-                cli_command_suffix="nat-gateway"
+                cli_command_suffix="nat-gateway",
             ),
             "elastic-ip": BusinessScenario(
                 scenario_id="elastic-ip",
@@ -127,7 +129,7 @@ class BusinessCaseConfigManager:
                 business_description="Optimize unattached Elastic IP addresses",
                 technical_focus="Elastic IP attachment analysis and cleanup recommendations",
                 risk_level="Low",
-                cli_command_suffix="elastic-ip"
+                cli_command_suffix="elastic-ip",
             ),
             "ebs-optimization": BusinessScenario(
                 scenario_id="ebs-optimization",
@@ -135,7 +137,7 @@ class BusinessCaseConfigManager:
                 business_case_type=BusinessCaseType.COST_OPTIMIZATION,
                 business_description="Optimize EBS volume types and utilization for cost efficiency",
                 technical_focus="EBS volume rightsizing and type optimization (15-20% potential)",
-                cli_command_suffix="ebs-optimization"
+                cli_command_suffix="ebs-optimization",
             ),
             "vpc-cleanup": BusinessScenario(
                 scenario_id="vpc-cleanup",
@@ -144,10 +146,10 @@ class BusinessCaseConfigManager:
                 target_savings_min=5869,
                 business_description="Clean up unused VPC resources and infrastructure",
                 technical_focus="VPC resource utilization analysis and cleanup recommendations",
-                cli_command_suffix="vpc-cleanup"
-            )
+                cli_command_suffix="vpc-cleanup",
+            ),
         }
-    
+
     def _load_environment_overrides(self) -> None:
         """
         Load configuration overrides and discover new scenarios from environment variables.
@@ -206,7 +208,7 @@ class BusinessCaseConfigManager:
             if env_var.startswith(prefix) and "_DISPLAY_NAME" in env_var:
                 # Extract scenario key from pattern: RUNBOOKS_BUSINESS_CASE_[SCENARIO]_DISPLAY_NAME
                 scenario_part = env_var.replace(prefix, "").replace("_DISPLAY_NAME", "")
-                scenario_key = scenario_part.lower().replace('_', '-')
+                scenario_key = scenario_part.lower().replace("_", "-")
                 discovered_scenarios.add((scenario_key, scenario_part))
 
         # Create new scenarios for discovered patterns
@@ -216,7 +218,9 @@ class BusinessCaseConfigManager:
                 if new_scenario:
                     self.scenarios[scenario_key] = new_scenario
 
-    def _create_scenario_from_environment(self, scenario_key: str, env_scenario_key: str, prefix: str) -> Optional[BusinessScenario]:
+    def _create_scenario_from_environment(
+        self, scenario_key: str, env_scenario_key: str, prefix: str
+    ) -> Optional[BusinessScenario]:
         """
         Create a new BusinessScenario from environment variables.
 
@@ -266,21 +270,21 @@ class BusinessCaseConfigManager:
             technical_focus=technical_focus,
             risk_level=risk_level,
             implementation_status=implementation_status,
-            cli_command_suffix=cli_suffix
+            cli_command_suffix=cli_suffix,
         )
-    
+
     def get_scenario(self, scenario_key: str) -> Optional[BusinessScenario]:
         """Get business scenario by key."""
         return self.scenarios.get(scenario_key)
-    
+
     def get_all_scenarios(self) -> Dict[str, BusinessScenario]:
         """Get all configured business scenarios."""
         return self.scenarios
-    
+
     def get_scenario_choices(self) -> List[str]:
         """Get list of valid scenario keys for CLI choice options."""
         return list(self.scenarios.keys())
-    
+
     def get_scenario_help_text(self) -> str:
         """Generate help text for CLI scenario option."""
         help_parts = []
@@ -288,25 +292,28 @@ class BusinessCaseConfigManager:
             savings_display = scenario.savings_range_display
             help_parts.append(f"{key} ({scenario.display_name}: {savings_display})")
         return "Business scenario analysis: " + ", ".join(help_parts)
-    
-    def format_scenario_for_display(self, scenario_key: str, 
-                                  achieved_savings: Optional[float] = None,
-                                  achievement_percentage: Optional[float] = None) -> str:
+
+    def format_scenario_for_display(
+        self,
+        scenario_key: str,
+        achieved_savings: Optional[float] = None,
+        achievement_percentage: Optional[float] = None,
+    ) -> str:
         """Format scenario for display in tables and reports."""
         scenario = self.get_scenario(scenario_key)
         if not scenario:
             return f"Unknown scenario: {scenario_key}"
-        
+
         base_info = f"{scenario.display_name} ({scenario.savings_range_display})"
-        
+
         if achieved_savings:
             base_info += f" - Achieved: ${achieved_savings:,.0f}"
-            
+
         if achievement_percentage:
             base_info += f" ({achievement_percentage:.0f}% of target)"
-            
+
         return base_info
-    
+
     def add_dynamic_scenario(self, scenario: BusinessScenario) -> None:
         """
         Add a new business scenario dynamically.
@@ -316,7 +323,9 @@ class BusinessCaseConfigManager:
         """
         self.scenarios[scenario.scenario_id] = scenario
 
-    def create_scenario_from_template(self, scenario_id: str, template_type: str = "aws_resource_optimization") -> BusinessScenario:
+    def create_scenario_from_template(
+        self, scenario_id: str, template_type: str = "aws_resource_optimization"
+    ) -> BusinessScenario:
         """
         Create a business scenario from predefined templates.
 
@@ -344,7 +353,7 @@ class BusinessCaseConfigManager:
                 technical_focus=f"{scenario_id.title().replace('-', ' ')} resource analysis with automated recommendations",
                 risk_level="Medium",
                 implementation_status="Template Ready",
-                cli_command_suffix=scenario_id
+                cli_command_suffix=scenario_id,
             ),
             "lambda_rightsizing": BusinessScenario(
                 scenario_id=scenario_id,
@@ -353,7 +362,7 @@ class BusinessCaseConfigManager:
                 business_description="Optimize Lambda function memory allocation and timeout settings",
                 technical_focus="CloudWatch metrics analysis for memory and duration optimization",
                 risk_level="Low",
-                cli_command_suffix=scenario_id
+                cli_command_suffix=scenario_id,
             ),
             "s3_storage_optimization": BusinessScenario(
                 scenario_id=scenario_id,
@@ -362,7 +371,7 @@ class BusinessCaseConfigManager:
                 business_description="Optimize S3 storage classes based on access patterns",
                 technical_focus="S3 access pattern analysis with intelligent storage class recommendations",
                 risk_level="Low",
-                cli_command_suffix=scenario_id
+                cli_command_suffix=scenario_id,
             ),
             "healthcare_compliance": BusinessScenario(
                 scenario_id=scenario_id,
@@ -371,7 +380,7 @@ class BusinessCaseConfigManager:
                 business_description="HIPAA compliance optimization with cost considerations",
                 technical_focus="Healthcare data security analysis with cost-effective compliance solutions",
                 risk_level="High",
-                cli_command_suffix=scenario_id
+                cli_command_suffix=scenario_id,
             ),
             "finance_cost_governance": BusinessScenario(
                 scenario_id=scenario_id,
@@ -380,7 +389,7 @@ class BusinessCaseConfigManager:
                 business_description="Financial industry cost governance and audit readiness",
                 technical_focus="SOX compliance cost optimization with audit trail requirements",
                 risk_level="High",
-                cli_command_suffix=scenario_id
+                cli_command_suffix=scenario_id,
             ),
             "manufacturing_automation": BusinessScenario(
                 scenario_id=scenario_id,
@@ -389,8 +398,8 @@ class BusinessCaseConfigManager:
                 business_description="Manufacturing workflow automation with cost optimization",
                 technical_focus="IoT and automation pipeline cost optimization analysis",
                 risk_level="Medium",
-                cli_command_suffix=scenario_id
-            )
+                cli_command_suffix=scenario_id,
+            ),
         }
 
         template = templates.get(template_type, templates["aws_resource_optimization"])
@@ -405,7 +414,7 @@ class BusinessCaseConfigManager:
             technical_focus=template.technical_focus,
             risk_level=template.risk_level,
             implementation_status=template.implementation_status,
-            cli_command_suffix=template.cli_command_suffix
+            cli_command_suffix=template.cli_command_suffix,
         )
 
     def get_template_types(self) -> List[str]:
@@ -416,11 +425,12 @@ class BusinessCaseConfigManager:
             "s3_storage_optimization",
             "healthcare_compliance",
             "finance_cost_governance",
-            "manufacturing_automation"
+            "manufacturing_automation",
         ]
 
-    def calculate_roi_projection(self, scenario_key: str, current_monthly_cost: float,
-                                optimization_percentage: float = 0.20) -> Dict[str, float]:
+    def calculate_roi_projection(
+        self, scenario_key: str, current_monthly_cost: float, optimization_percentage: float = 0.20
+    ) -> Dict[str, float]:
         """
         Calculate ROI projection for a business scenario.
 
@@ -440,20 +450,15 @@ class BusinessCaseConfigManager:
             "monthly_savings": monthly_savings,
             "annual_savings": annual_savings,
             "optimization_percentage": optimization_percentage * 100,
-            "roi_12_month": annual_savings  # Assuming minimal implementation cost for analysis
+            "roi_12_month": annual_savings,  # Assuming minimal implementation cost for analysis
         }
 
     def create_business_case_summary(self) -> Dict[str, Any]:
         """Create executive summary of all business cases."""
-        total_min_savings = sum(
-            scenario.target_savings_min or 0
-            for scenario in self.scenarios.values()
-        )
+        total_min_savings = sum(scenario.target_savings_min or 0 for scenario in self.scenarios.values())
 
         total_max_savings = sum(
-            scenario.target_savings_max or 0
-            for scenario in self.scenarios.values()
-            if scenario.target_savings_max
+            scenario.target_savings_max or 0 for scenario in self.scenarios.values() if scenario.target_savings_max
         )
 
         return {
@@ -462,24 +467,22 @@ class BusinessCaseConfigManager:
             "total_potential_max": total_max_savings,
             "potential_range": f"${total_min_savings:,.0f}-${total_max_savings:,.0f}",
             "scenarios_by_type": {
-                case_type.value: [
-                    s.display_name for s in self.scenarios.values()
-                    if s.business_case_type == case_type
-                ]
+                case_type.value: [s.display_name for s in self.scenarios.values() if s.business_case_type == case_type]
                 for case_type in BusinessCaseType
             },
             "scenario_discovery": {
                 "default_scenarios": 7,
                 "environment_discovered": len(self.scenarios) - 7,
                 "total_active": len(self.scenarios),
-                "unlimited_expansion": True
-            }
+                "unlimited_expansion": True,
+            },
         }
 
 
 # Global configuration manager instance
 _config_manager = None
 
+
 def get_business_case_config() -> BusinessCaseConfigManager:
     """Get global business case configuration manager."""
     global _config_manager
@@ -506,17 +509,17 @@ def format_business_achievement(scenario_key: str, achieved_savings: float) -> s
     """Format business achievement for executive reporting."""
     config = get_business_case_config()
     scenario = config.get_scenario(scenario_key)
-    
+
     if not scenario:
         return f"{scenario_key}: ${achieved_savings:,.0f} annual savings"
-    
+
     # Calculate achievement percentage if target is available
     achievement_text = f"{scenario.display_name}: ${achieved_savings:,.0f} annual savings"
-    
+
     if scenario.target_savings_min:
         percentage = (achieved_savings / scenario.target_savings_min) * 100
         achievement_text += f" ({percentage:.0f}% of target)"
-    
+
     return achievement_text
 
 
@@ -539,12 +542,10 @@ def create_scenario_from_environment_variables(scenario_id: str) -> Optional[Bus
         BusinessScenario object or None if required fields missing
     """
     config_manager = get_business_case_config()
-    env_key = scenario_id.upper().replace('-', '_')
+    env_key = scenario_id.upper().replace("-", "_")
 
     return config_manager._create_scenario_from_environment(
-        scenario_id.lower().replace('_', '-'),
-        env_key,
-        "RUNBOOKS_BUSINESS_CASE_"
+        scenario_id.lower().replace("_", "-"), env_key, "RUNBOOKS_BUSINESS_CASE_"
     )
 
 
@@ -571,8 +572,9 @@ def get_available_templates() -> List[str]:
     return config_manager.get_template_types()
 
 
-def calculate_scenario_roi(scenario_id: str, current_monthly_cost: float,
-                          optimization_percentage: float = 0.20) -> Dict[str, float]:
+def calculate_scenario_roi(
+    scenario_id: str, current_monthly_cost: float, optimization_percentage: float = 0.20
+) -> Dict[str, float]:
     """
     Calculate ROI projection for any business scenario.
 
@@ -622,7 +624,7 @@ def discover_scenarios_summary() -> Dict[str, Any]:
 # Migration helper functions for existing hardcoded patterns
 def migrate_legacy_scenario_reference(legacy_ref: str) -> str:
     """
-    Migrate legacy JIRA references to dynamic business case keys.
+    Migrate legacy references to dynamic business case keys.
 
     Args:
         legacy_ref: Legacy reference like "FinOps-24", "finops-23", etc.
@@ -644,7 +646,7 @@ def migrate_legacy_scenario_reference(legacy_ref: str) -> str:
         "finops-ebs": "ebs-optimization",
         "FinOps-EBS": "ebs-optimization",
         "awso-05": "vpc-cleanup",
-        "AWSO-05": "vpc-cleanup"
+        "AWSO-05": "vpc-cleanup",
     }
 
     return legacy_mapping.get(legacy_ref, legacy_ref.lower())
@@ -654,8 +656,10 @@ def migrate_legacy_scenario_reference(legacy_ref: str) -> str:
 # Business Scenario Matrix - Phase 1 Priority 2 Implementation
 # ============================================================================
 
+
 class ScenarioParameter(NamedTuple):
     """Parameter recommendation for business scenarios."""
+
     name: str
     optimal_value: Union[str, int, float]
     business_justification: str
@@ -665,6 +669,7 @@ class ScenarioParameter(NamedTuple):
 @dataclass
 class ScenarioParameterMatrix:
     """Intelligent parameter defaults for business scenarios."""
+
     timerange_days: Optional[int] = None
     regional_scope: Optional[str] = None  # single, multi, global
     cost_focus: Optional[str] = None  # unblended, amortized, dual-metrics
@@ -678,40 +683,40 @@ class ScenarioParameterMatrix:
         recommendations = {}
 
         if self.timerange_days:
-            recommendations['timerange'] = ScenarioParameter(
-                name='--time-range',
+            recommendations["timerange"] = ScenarioParameter(
+                name="--time-range",
                 optimal_value=self.timerange_days,
                 business_justification=f"Optimal analysis period: {self.timerange_days} days. {self.business_justification}",
-                alternative_values=[7, 30, 60, 90, 180] if self.timerange_days not in [7, 30, 60, 90, 180] else None
+                alternative_values=[7, 30, 60, 90, 180] if self.timerange_days not in [7, 30, 60, 90, 180] else None,
             )
 
         if self.regional_scope:
             scope_mapping = {
-                'single': ['--region', 'us-east-1'],
-                'multi': ['--all-regions', True],
-                'global': ['--global-scope', True]
+                "single": ["--region", "us-east-1"],
+                "multi": ["--all-regions", True],
+                "global": ["--global-scope", True],
             }
             if self.regional_scope in scope_mapping:
                 param_name, param_value = scope_mapping[self.regional_scope]
-                recommendations['regional_scope'] = ScenarioParameter(
+                recommendations["regional_scope"] = ScenarioParameter(
                     name=param_name,
                     optimal_value=param_value,
-                    business_justification=f"Regional scope: {self.regional_scope} - {self.business_justification}"
+                    business_justification=f"Regional scope: {self.regional_scope} - {self.business_justification}",
                 )
 
         if self.cost_focus:
-            recommendations['cost_focus'] = ScenarioParameter(
-                name=f'--{self.cost_focus}',
+            recommendations["cost_focus"] = ScenarioParameter(
+                name=f"--{self.cost_focus}",
                 optimal_value=True,
-                business_justification=f"Cost perspective: {self.cost_focus} - {self.business_justification}"
+                business_justification=f"Cost perspective: {self.cost_focus} - {self.business_justification}",
             )
 
         if self.export_priority:
-            recommendations['export_format'] = ScenarioParameter(
-                name='--' + self.export_priority.replace('_', '-'),
+            recommendations["export_format"] = ScenarioParameter(
+                name="--" + self.export_priority.replace("_", "-"),
                 optimal_value=True,
                 business_justification=f"Export format: {self.export_priority} - {self.business_justification}",
-                alternative_values=['csv', 'json', 'pdf', 'markdown'] if self.export_priority else None
+                alternative_values=["csv", "json", "pdf", "markdown"] if self.export_priority else None,
             )
 
         return recommendations
@@ -737,70 +742,64 @@ class BusinessScenarioMatrix:
         """Build the complete business scenario parameter matrix."""
         return {
             # TIER 1 HIGH-VALUE SCENARIOS
-            'workspaces': ScenarioParameterMatrix(
+            "workspaces": ScenarioParameterMatrix(
                 timerange_days=90,
-                regional_scope='single',
-                cost_focus='unblended',
-                export_priority='pdf',
-                validation_level='comprehensive',
-                business_justification="WorkSpaces require quarterly analysis for usage pattern detection. Single-region focus optimizes analysis speed. Unblended costs show true resource utilization. PDF format ideal for management review."
+                regional_scope="single",
+                cost_focus="unblended",
+                export_priority="pdf",
+                validation_level="comprehensive",
+                business_justification="WorkSpaces require quarterly analysis for usage pattern detection. Single-region focus optimizes analysis speed. Unblended costs show true resource utilization. PDF format ideal for management review.",
             ),
-
-            'nat-gateway': ScenarioParameterMatrix(
+            "nat-gateway": ScenarioParameterMatrix(
                 timerange_days=30,
-                regional_scope='multi',
-                cost_focus='amortized',
-                export_priority='json',
-                validation_level='enhanced',
-                business_justification="NAT Gateways require monthly analysis for traffic optimization. Multi-region analysis essential for comprehensive network cost optimization. Amortized costs account for data transfer pricing. JSON format enables automation integration."
+                regional_scope="multi",
+                cost_focus="amortized",
+                export_priority="json",
+                validation_level="enhanced",
+                business_justification="NAT Gateways require monthly analysis for traffic optimization. Multi-region analysis essential for comprehensive network cost optimization. Amortized costs account for data transfer pricing. JSON format enables automation integration.",
             ),
-
-            'rds-snapshots': ScenarioParameterMatrix(
+            "rds-snapshots": ScenarioParameterMatrix(
                 timerange_days=90,
-                regional_scope='multi',
-                cost_focus='dual-metrics',
-                export_priority='csv',
-                validation_level='comprehensive',
-                business_justification="RDS snapshots require quarterly analysis for retention policy optimization. Multi-region scope captures all backup strategies. Dual metrics provide complete cost visibility. CSV format enables spreadsheet analysis."
+                regional_scope="multi",
+                cost_focus="dual-metrics",
+                export_priority="csv",
+                validation_level="comprehensive",
+                business_justification="RDS snapshots require quarterly analysis for retention policy optimization. Multi-region scope captures all backup strategies. Dual metrics provide complete cost visibility. CSV format enables spreadsheet analysis.",
             ),
-
             # TIER 2 STRATEGIC SCENARIOS
-            'ebs-optimization': ScenarioParameterMatrix(
+            "ebs-optimization": ScenarioParameterMatrix(
                 timerange_days=180,
-                regional_scope='multi',
-                cost_focus='dual-metrics',
-                export_priority='pdf',
-                validation_level='comprehensive',
-                business_justification="EBS optimization requires extended analysis to identify usage patterns. Multi-region scope captures all storage. Dual metrics show both immediate and amortized costs. PDF format suitable for capacity planning presentations."
+                regional_scope="multi",
+                cost_focus="dual-metrics",
+                export_priority="pdf",
+                validation_level="comprehensive",
+                business_justification="EBS optimization requires extended analysis to identify usage patterns. Multi-region scope captures all storage. Dual metrics show both immediate and amortized costs. PDF format suitable for capacity planning presentations.",
             ),
-
-            'vpc-cleanup': ScenarioParameterMatrix(
+            "vpc-cleanup": ScenarioParameterMatrix(
                 timerange_days=30,
-                regional_scope='multi',
-                cost_focus='unblended',
-                export_priority='csv',
-                validation_level='enhanced',
-                business_justification="VPC cleanup requires recent data for active resource identification. Multi-region analysis captures all network resources. Unblended costs show direct infrastructure impact. CSV enables detailed resource tracking."
+                regional_scope="multi",
+                cost_focus="unblended",
+                export_priority="csv",
+                validation_level="enhanced",
+                business_justification="VPC cleanup requires recent data for active resource identification. Multi-region analysis captures all network resources. Unblended costs show direct infrastructure impact. CSV enables detailed resource tracking.",
             ),
-
-            'elastic-ip': ScenarioParameterMatrix(
+            "elastic-ip": ScenarioParameterMatrix(
                 timerange_days=7,
-                regional_scope='multi',
-                cost_focus='unblended',
-                export_priority='json',
-                validation_level='basic',
-                business_justification="Elastic IP analysis requires recent data for attachment status. Multi-region scope captures all IP allocations. Unblended costs show direct charges. JSON format enables automated cleanup workflows."
+                regional_scope="multi",
+                cost_focus="unblended",
+                export_priority="json",
+                validation_level="basic",
+                business_justification="Elastic IP analysis requires recent data for attachment status. Multi-region scope captures all IP allocations. Unblended costs show direct charges. JSON format enables automated cleanup workflows.",
             ),
-
             # TIER 3 FRAMEWORK SCENARIOS
-            'backup-investigation': ScenarioParameterMatrix(
+            "backup-investigation": ScenarioParameterMatrix(
                 timerange_days=None,  # Framework-based
-                regional_scope='multi',
-                cost_focus='amortized',
-                export_priority='markdown',
-                validation_level='basic',
-                business_justification="Backup investigation uses framework-based timerange analysis. Multi-region scope for comprehensive backup strategy. Amortized costs for long-term planning. Markdown format for documentation and reporting."
-            )
+                regional_scope="multi",
+                cost_focus="amortized",
+                export_priority="markdown",
+                validation_level="basic",
+                business_justification="Backup investigation uses framework-based timerange analysis. Multi-region scope for comprehensive backup strategy. Amortized costs for long-term planning. Markdown format for documentation and reporting.",
+            ),
         }
 
     def _extend_matrix_with_discovered_scenarios(self) -> None:
@@ -833,59 +832,60 @@ class BusinessScenarioMatrix:
         type_defaults = {
             BusinessCaseType.COST_OPTIMIZATION: ScenarioParameterMatrix(
                 timerange_days=30,
-                regional_scope='multi',
-                cost_focus='dual-metrics',
-                export_priority='pdf',
-                validation_level='enhanced',
-                business_justification=f"Cost optimization requires comprehensive analysis with dual cost perspectives for {scenario.display_name}"
+                regional_scope="multi",
+                cost_focus="dual-metrics",
+                export_priority="pdf",
+                validation_level="enhanced",
+                business_justification=f"Cost optimization requires comprehensive analysis with dual cost perspectives for {scenario.display_name}",
             ),
             BusinessCaseType.RESOURCE_CLEANUP: ScenarioParameterMatrix(
                 timerange_days=7,
-                regional_scope='multi',
-                cost_focus='unblended',
-                export_priority='csv',
-                validation_level='basic',
-                business_justification=f"Resource cleanup requires recent data for active resource identification in {scenario.display_name}"
+                regional_scope="multi",
+                cost_focus="unblended",
+                export_priority="csv",
+                validation_level="basic",
+                business_justification=f"Resource cleanup requires recent data for active resource identification in {scenario.display_name}",
             ),
             BusinessCaseType.COMPLIANCE_FRAMEWORK: ScenarioParameterMatrix(
                 timerange_days=90,
-                regional_scope='global',
-                cost_focus='amortized',
-                export_priority='pdf',
-                validation_level='comprehensive',
-                business_justification=f"Compliance frameworks require extended analysis with comprehensive reporting for {scenario.display_name}"
+                regional_scope="global",
+                cost_focus="amortized",
+                export_priority="pdf",
+                validation_level="comprehensive",
+                business_justification=f"Compliance frameworks require extended analysis with comprehensive reporting for {scenario.display_name}",
             ),
             BusinessCaseType.SECURITY_ENHANCEMENT: ScenarioParameterMatrix(
                 timerange_days=30,
-                regional_scope='global',
-                cost_focus='unblended',
-                export_priority='markdown',
-                validation_level='comprehensive',
-                business_justification=f"Security enhancements require thorough analysis with documentation focus for {scenario.display_name}"
+                regional_scope="global",
+                cost_focus="unblended",
+                export_priority="markdown",
+                validation_level="comprehensive",
+                business_justification=f"Security enhancements require thorough analysis with documentation focus for {scenario.display_name}",
             ),
             BusinessCaseType.AUTOMATION_DEPLOYMENT: ScenarioParameterMatrix(
                 timerange_days=60,
-                regional_scope='multi',
-                cost_focus='amortized',
-                export_priority='json',
-                validation_level='enhanced',
-                business_justification=f"Automation deployment requires extended analysis with machine-readable output for {scenario.display_name}"
-            )
+                regional_scope="multi",
+                cost_focus="amortized",
+                export_priority="json",
+                validation_level="enhanced",
+                business_justification=f"Automation deployment requires extended analysis with machine-readable output for {scenario.display_name}",
+            ),
         }
 
         # Use type-based defaults or fallback to generic cost optimization pattern
-        default_matrix = type_defaults.get(scenario.business_case_type,
-                                         type_defaults[BusinessCaseType.COST_OPTIMIZATION])
+        default_matrix = type_defaults.get(
+            scenario.business_case_type, type_defaults[BusinessCaseType.COST_OPTIMIZATION]
+        )
 
         # Override with scenario-specific intelligence where available
-        if scenario.risk_level.lower() == 'high':
+        if scenario.risk_level.lower() == "high":
             # High risk scenarios need more comprehensive validation
-            default_matrix.validation_level = 'comprehensive'
+            default_matrix.validation_level = "comprehensive"
             default_matrix.timerange_days = max(default_matrix.timerange_days or 30, 90)
 
-        if scenario.risk_level.lower() == 'low':
+        if scenario.risk_level.lower() == "low":
             # Low risk scenarios can use basic validation
-            default_matrix.validation_level = 'basic'
+            default_matrix.validation_level = "basic"
             default_matrix.timerange_days = min(default_matrix.timerange_days or 30, 14)
 
         return default_matrix
@@ -932,7 +932,7 @@ class BusinessScenarioMatrix:
             help_lines.append(f"    → {param.business_justification}")
 
             if param.alternative_values:
-                alternatives = ', '.join(str(v) for v in param.alternative_values)
+                alternatives = ", ".join(str(v) for v in param.alternative_values)
                 help_lines.append(f"    Alternatives: {alternatives}")
             help_lines.append("")
 
@@ -951,25 +951,29 @@ class BusinessScenarioMatrix:
         suggestions = {}
 
         # Check timerange optimization
-        if 'timerange' in recommendations:
-            optimal_timerange = recommendations['timerange'].optimal_value
-            provided_timerange = provided_params.get('time_range')
+        if "timerange" in recommendations:
+            optimal_timerange = recommendations["timerange"].optimal_value
+            provided_timerange = provided_params.get("time_range")
 
             if provided_timerange and provided_timerange != optimal_timerange:
-                suggestions['timerange'] = f"Consider --time-range {optimal_timerange} for optimal {scenario_key} analysis (current: {provided_timerange})"
+                suggestions["timerange"] = (
+                    f"Consider --time-range {optimal_timerange} for optimal {scenario_key} analysis (current: {provided_timerange})"
+                )
 
         # Check export format optimization
-        if 'export_format' in recommendations:
-            optimal_export = recommendations['export_format'].name.replace('--', '')
-            export_formats = provided_params.get('export_formats', [])
+        if "export_format" in recommendations:
+            optimal_export = recommendations["export_format"].name.replace("--", "")
+            export_formats = provided_params.get("export_formats", [])
 
             if export_formats and optimal_export not in export_formats:
-                suggestions['export_format'] = f"Consider {optimal_export} export format for {scenario_key} analysis (optimal for business case)"
+                suggestions["export_format"] = (
+                    f"Consider {optimal_export} export format for {scenario_key} analysis (optimal for business case)"
+                )
 
         # Check cost focus optimization
-        if 'cost_focus' in recommendations:
-            optimal_focus = recommendations['cost_focus'].name.replace('--', '')
-            cost_focus_params = ['unblended', 'amortized', 'dual_metrics']
+        if "cost_focus" in recommendations:
+            optimal_focus = recommendations["cost_focus"].name.replace("--", "")
+            cost_focus_params = ["unblended", "amortized", "dual_metrics"]
             provided_focus = None
 
             for focus_type in cost_focus_params:
@@ -978,7 +982,7 @@ class BusinessScenarioMatrix:
                     break
 
             if not provided_focus:
-                suggestions['cost_focus'] = f"Consider {optimal_focus} cost perspective for {scenario_key} analysis"
+                suggestions["cost_focus"] = f"Consider {optimal_focus} cost perspective for {scenario_key} analysis"
 
         return suggestions
 
@@ -1010,9 +1014,10 @@ class BusinessScenarioMatrix:
 # Global scenario matrix instance
 _scenario_matrix = None
 
+
 def get_business_scenario_matrix() -> BusinessScenarioMatrix:
     """Get global business scenario matrix instance."""
     global _scenario_matrix
     if _scenario_matrix is None:
         _scenario_matrix = BusinessScenarioMatrix()
-    return _scenario_matrix
+    return _scenario_matrix