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

runbooks/finops/scenario_cli_integration.py

@@ -8,27 +8,28 @@ Strategic Achievement: Manager requires business scenario intelligence with smar
 parameter recommendations per business case type.
 """
 
-import click
 import time
-from typing import Dict, List, Optional, Any
+from typing import Any, Dict, List, Optional
+
+import click
 from rich.console import Console
-from rich.table import Table
 from rich.panel import Panel
+from rich.table import Table
 
+from ..common.rich_utils import print_header, print_info, print_success, print_warning
 from .business_case_config import (
+    BusinessScenarioMatrix,
+    ScenarioParameter,
     get_business_case_config,
     get_business_scenario_matrix,
-    BusinessScenarioMatrix,
-    ScenarioParameter
 )
-from ..common.rich_utils import print_header, print_info, print_success, print_warning
 
 
 class SimplifiedScenarioMessaging:
     """
     Simplified scenario messaging system for 75% console operation reduction.
 
-    Sprint 2 Enhancement: Consolidates multiple console operations into
+    Phase 2 Enhancement: Consolidates multiple console operations into
     template-based single panel displays while preserving all information content.
 
     Target: 75% reduction in console operations through panel consolidation.
@@ -47,14 +48,14 @@ class SimplifiedScenarioMessaging:
         Achieves 75% reduction: 5 operations → 1 panel.
         """
         self.operation_count += 5  # Would have been 5 separate prints
-        self.template_count += 1   # Now using 1 panel template
+        self.template_count += 1  # Now using 1 panel template
 
         scenario_content = self._format_scenario_content(scenario_config)
         scenario_panel = Panel(
             scenario_content,
             title=f"[bold cyan]Scenario: {scenario_config.display_name}[/bold cyan]",
             border_style="cyan",
-            padding=(1, 2)
+            padding=(1, 2),
         )
         self.console.print(scenario_panel)
 
@@ -75,7 +76,7 @@ class SimplifiedScenarioMessaging:
             param_content,
             title="[bold green]🎯 Intelligent Parameter Recommendations[/bold green]",
             border_style="green",
-            padding=(1, 2)
+            padding=(1, 2),
         )
         self.console.print(param_panel)
 
@@ -96,12 +97,12 @@ class SimplifiedScenarioMessaging:
             suggestion_content,
             title=f"[bold yellow]💡 Parameter Optimization Suggestions for '{scenario_key}'[/bold yellow]",
             border_style="yellow",
-            padding=(1, 2)
+            padding=(1, 2),
         )
         self.console.print(suggestion_panel)
 
     def get_consolidation_metrics(self) -> Dict[str, Any]:
-        """Get consolidation efficiency metrics for Sprint 2 validation."""
+        """Get consolidation efficiency metrics for Phase 2 validation."""
         if self.operation_count == 0:
             return {"efficiency": 0.0, "operations_saved": 0}
 
@@ -111,7 +112,7 @@ class SimplifiedScenarioMessaging:
             "template_operations_used": self.template_count,
             "operations_saved": self.operation_count - self.template_count,
             "efficiency_percentage": efficiency,
-            "target_achieved": efficiency >= 75.0
+            "target_achieved": efficiency >= 75.0,
         }
 
     def _format_scenario_content(self, scenario_config) -> str:
@@ -139,7 +140,7 @@ class SimplifiedScenarioMessaging:
             content_lines.append(f"  [dim]→ {param.business_justification}[/dim]")
 
             if param.alternative_values:
-                alternatives = ', '.join(str(v) for v in param.alternative_values)
+                alternatives = ", ".join(str(v) for v in param.alternative_values)
                 content_lines.append(f"  [dim]Alternatives: {alternatives}[/dim]")
             content_lines.append("")
 
@@ -157,7 +158,7 @@ class ScenarioCliHelper:
     """
     CLI integration helper for business scenario intelligence.
 
-    Sprint 2 Enhanced: Integrates SimplifiedScenarioMessaging for 75% console
+    Phase 2 Enhanced: Integrates SimplifiedScenarioMessaging for 75% console
     operation reduction while providing intelligent parameter recommendations.
     """
 
@@ -167,7 +168,7 @@ class ScenarioCliHelper:
         self.business_config = get_business_case_config()
         self.scenario_matrix = get_business_scenario_matrix()
 
-        # Sprint 2 Enhancement: Integrate simplified messaging system
+        # Phase 2 Enhancement: Integrate simplified messaging system
         self.simplified_messaging = SimplifiedScenarioMessaging(self.console)
         self.audit_trail = []
 
@@ -184,7 +185,7 @@ class ScenarioCliHelper:
         """
         Display detailed help for a single scenario using simplified messaging.
 
-        Sprint 2 Enhancement: Uses simplified messaging to reduce console operations
+        Phase 2 Enhancement: Uses simplified messaging to reduce console operations
         by 75% while preserving all information content.
         """
         scenario_config = self.business_config.get_scenario(scenario_key)
@@ -192,13 +193,13 @@ class ScenarioCliHelper:
             print_warning(f"Unknown scenario: {scenario_key}")
             return
 
-        # Sprint 2: Use simplified messaging for scenario overview (5 prints → 1 panel)
+        # Phase 2: Use simplified messaging for scenario overview (5 prints → 1 panel)
         self.simplified_messaging.display_scenario_overview(scenario_config)
 
         # Display parameter recommendations using simplified messaging
         recommendations = self.scenario_matrix.get_parameter_recommendations(scenario_key)
         if recommendations:
-            # Sprint 2: Use simplified messaging for parameters (multiple prints → 1 panel)
+            # Phase 2: Use simplified messaging for parameters (multiple prints → 1 panel)
             self.simplified_messaging.display_parameter_recommendations(recommendations)
 
             # Display optimal command in consolidated format
@@ -206,19 +207,21 @@ class ScenarioCliHelper:
             command_panel = Panel(
                 f"[dim]runbooks finops --scenario {scenario_key} {optimal_command}[/dim]",
                 title="[bold yellow]💡 Optimal Command Example[/bold yellow]",
-                border_style="yellow"
+                border_style="yellow",
             )
             self.console.print(command_panel)
         else:
             print_info("Using standard parameters for this scenario")
 
-        # Audit trail for Sprint 2 compliance
-        self.audit_trail.append({
-            "action": "single_scenario_help",
-            "scenario": scenario_key,
-            "simplified_messaging_used": True,
-            "timestamp": time.time()
-        })
+        # Audit trail for Phase 2 compliance
+        self.audit_trail.append(
+            {
+                "action": "single_scenario_help",
+                "scenario": scenario_key,
+                "simplified_messaging_used": True,
+                "timestamp": time.time(),
+            }
+        )
 
     def _display_all_scenarios_help(self) -> None:
         """Display overview of all scenarios with parameter summaries."""
@@ -226,7 +229,7 @@ class ScenarioCliHelper:
         table = Table(
             title="🎯 Business Scenarios with Intelligent Parameter Defaults",
             show_header=True,
-            header_style="bold cyan"
+            header_style="bold cyan",
         )
 
         table.add_column("Scenario", style="bold white", width=15)
@@ -240,26 +243,20 @@ class ScenarioCliHelper:
 
         # Tier classification for display
         tier_mapping = {
-            'workspaces': 'Tier 1',
-            'nat-gateway': 'Tier 1',
-            'rds-snapshots': 'Tier 1',
-            'ebs-optimization': 'Tier 2',
-            'vpc-cleanup': 'Tier 2',
-            'elastic-ip': 'Tier 2',
-            'backup-investigation': 'Tier 3'
+            "workspaces": "Tier 1",
+            "nat-gateway": "Tier 1",
+            "rds-snapshots": "Tier 1",
+            "ebs-optimization": "Tier 2",
+            "vpc-cleanup": "Tier 2",
+            "elastic-ip": "Tier 2",
+            "backup-investigation": "Tier 3",
         }
 
         for scenario_key, scenario in self.business_config.get_all_scenarios().items():
             parameter_summary = scenario_summaries.get(scenario_key, "Standard")
             tier = tier_mapping.get(scenario_key, "Standard")
 
-            table.add_row(
-                scenario_key,
-                scenario.display_name,
-                scenario.savings_range_display,
-                parameter_summary,
-                tier
-            )
+            table.add_row(scenario_key, scenario.display_name, scenario.savings_range_display, parameter_summary, tier)
 
         self.console.print(table)
 
@@ -282,7 +279,7 @@ class ScenarioCliHelper:
 • runbooks finops --help-scenarios  # All scenarios overview
             """,
             title="📚 Scenario Usage Guide",
-            style="cyan"
+            style="cyan",
         )
         self.console.print(usage_panel)
 
@@ -298,7 +295,7 @@ class ScenarioCliHelper:
         self.console.print(f"    [dim]→ {param.business_justification}[/dim]")
 
         if param.alternative_values:
-            alternatives = ', '.join(str(v) for v in param.alternative_values)
+            alternatives = ", ".join(str(v) for v in param.alternative_values)
             self.console.print(f"    [dim]Alternatives: {alternatives}[/dim]")
         self.console.print()
 
@@ -318,22 +315,24 @@ class ScenarioCliHelper:
         """
         Validate and provide suggestions using simplified messaging.
 
-        Sprint 2 Enhancement: Uses simplified messaging to consolidate suggestion display.
+        Phase 2 Enhancement: Uses simplified messaging to consolidate suggestion display.
         """
         suggestions = self.scenario_matrix.validate_parameters_for_scenario(scenario_key, provided_params)
 
         if suggestions:
-            # Sprint 2: Use simplified messaging for suggestions
+            # Phase 2: Use simplified messaging for suggestions
             self.simplified_messaging.display_optimization_suggestions(scenario_key, suggestions)
 
             # Audit trail
-            self.audit_trail.append({
-                "action": "parameter_validation",
-                "scenario": scenario_key,
-                "suggestions_count": len(suggestions),
-                "simplified_messaging_used": True,
-                "timestamp": time.time()
-            })
+            self.audit_trail.append(
+                {
+                    "action": "parameter_validation",
+                    "scenario": scenario_key,
+                    "suggestions_count": len(suggestions),
+                    "simplified_messaging_used": True,
+                    "timestamp": time.time(),
+                }
+            )
 
     def get_scenario_cli_choices(self) -> List[str]:
         """Get list of valid scenario choices for Click options."""
@@ -344,9 +343,9 @@ class ScenarioCliHelper:
         base_help = self.business_config.get_scenario_help_text()
         return f"{base_help}\n\nUse --scenario [scenario-name] for specific optimization analysis."
 
-    def get_sprint2_performance_metrics(self) -> Dict[str, Any]:
+    def get_console_performance_metrics(self) -> Dict[str, Any]:
         """
-        Get Sprint 2 performance metrics for enterprise audit compliance.
+        Get Phase 2 performance metrics for enterprise audit compliance.
 
         Returns consolidated metrics for:
         - Message simplification efficiency (75% target)
@@ -356,25 +355,25 @@ class ScenarioCliHelper:
         messaging_metrics = self.simplified_messaging.get_consolidation_metrics()
 
         return {
-            "sprint2_enhancement": "Console log improvements with message simplification",
+            "console_enhancement": "Console log improvements with message simplification",
             "message_consolidation": messaging_metrics,
             "audit_trail": {
                 "total_operations": len(self.audit_trail),
                 "operations_with_simplified_messaging": sum(
                     1 for op in self.audit_trail if op.get("simplified_messaging_used", False)
                 ),
-                "audit_compliance": "enterprise_ready"
+                "audit_compliance": "enterprise_ready",
             },
             "target_achievements": {
                 "message_simplification_target": 75.0,
                 "achieved_efficiency": messaging_metrics.get("efficiency_percentage", 0.0),
-                "target_met": messaging_metrics.get("target_achieved", False)
+                "target_met": messaging_metrics.get("target_achieved", False),
             },
             "performance_improvements": {
                 "console_operations_reduced": messaging_metrics.get("operations_saved", 0),
                 "template_consolidation": "Rich panel integration implemented",
-                "information_preservation": "100% content maintained"
-            }
+                "information_preservation": "100% content maintained",
+            },
         }
 
 
@@ -417,21 +416,21 @@ def get_scenario_parameter_defaults(scenario_key: str) -> Dict[str, Any]:
     defaults = {}
 
     for param_key, param in recommendations.items():
-        if param.name == '--time-range':
-            defaults['time_range'] = param.optimal_value
-        elif param.name == '--unblended':
-            defaults['unblended'] = True
-        elif param.name == '--amortized':
-            defaults['amortized'] = True
-        elif param.name == '--dual-metrics':
-            defaults['dual_metrics'] = True
-        elif param.name == '--pdf':
-            defaults['pdf'] = True
-        elif param.name == '--csv':
-            defaults['csv'] = True
-        elif param.name == '--json':
-            defaults['json'] = True
-        elif param.name == '--markdown':
-            defaults['export_markdown'] = True
-
-    return defaults
+        if param.name == "--time-range":
+            defaults["time_range"] = param.optimal_value
+        elif param.name == "--unblended":
+            defaults["unblended"] = True
+        elif param.name == "--amortized":
+            defaults["amortized"] = True
+        elif param.name == "--dual-metrics":
+            defaults["dual_metrics"] = True
+        elif param.name == "--pdf":
+            defaults["pdf"] = True
+        elif param.name == "--csv":
+            defaults["csv"] = True
+        elif param.name == "--json":
+            defaults["json"] = True
+        elif param.name == "--markdown":
+            defaults["export_markdown"] = True
+
+    return defaults