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

runbooks/finops/executive_export.py

@@ -21,34 +21,40 @@ Strategic Alignment:
 """
 
 import csv
-import json
 import hashlib
-from datetime import datetime, date
-from pathlib import Path
-from typing import Dict, List, Optional, Any, Tuple, Union
-import tempfile
+import json
 import os
+import tempfile
+from datetime import date, datetime
+from pathlib import Path
+from typing import Any, Dict, List, Optional, Tuple, Union
 
 from rich.console import Console
-from rich.table import Table
 from rich.panel import Panel
+from rich.table import Table
 from rich.text import Text
 
+from ..common.rich_utils import console as rich_console
 from ..common.rich_utils import (
-    console as rich_console,
-    print_header, print_success, print_error, print_info, print_warning,
-    create_table, create_panel, format_cost
+    create_panel,
+    create_table,
+    format_cost,
+    print_error,
+    print_header,
+    print_info,
+    print_success,
+    print_warning,
 )
 
 
 class ExecutiveReportGenerator:
     """
     Professional executive report generator with multi-format support.
-    
+
     This class creates board-ready reports with executive-appropriate formatting,
     business metrics, and compliance documentation suitable for C-level presentation.
     """
-    
+
     def __init__(self, console: Optional[Console] = None):
         """Initialize executive report generator."""
         self.console = console or rich_console
@@ -56,103 +62,100 @@ class ExecutiveReportGenerator:
             "generation_timestamp": datetime.now().isoformat(),
             "generator_version": "1.0.0",
             "compliance_frameworks": ["SOX", "SOC2", "Enterprise_Governance"],
-            "executive_ready": True
+            "executive_ready": True,
         }
-    
+
     def generate_comprehensive_executive_package(
-        self, 
-        analysis_results: Dict[str, Any], 
-        output_dir: Union[str, Path],
-        include_formats: List[str] = None
+        self, analysis_results: Dict[str, Any], output_dir: Union[str, Path], include_formats: List[str] = None
     ) -> Dict[str, str]:
         """
         Generate comprehensive executive package with all report formats.
-        
+
         Args:
             analysis_results: Complete analysis results with validation and business metrics
             output_dir: Directory to save generated reports
             include_formats: List of formats to generate (defaults to all)
-            
+
         Returns:
             Dictionary mapping format names to generated file paths
         """
         output_path = Path(output_dir)
         output_path.mkdir(parents=True, exist_ok=True)
-        
+
         if include_formats is None:
             include_formats = ["html", "pdf", "csv", "json", "markdown", "executive_summary"]
-        
+
         generated_reports = {}
-        
+
         # Generate SHA256 verification for package integrity
         package_verification = self._generate_package_verification(analysis_results)
-        
+
         try:
             self.console.print(f"\n[bright_cyan]📊 Generating Executive Report Package[/]")
-            
+
             # HTML Executive Dashboard
             if "html" in include_formats:
                 html_path = self._generate_html_executive_dashboard(analysis_results, output_path)
                 generated_reports["html"] = str(html_path)
                 self.console.print(f"[green]✅ HTML Executive Dashboard: {html_path.name}[/]")
-            
+
             # PDF Executive Summary
             if "pdf" in include_formats:
                 pdf_path = self._generate_pdf_executive_report(analysis_results, output_path)
                 generated_reports["pdf"] = str(pdf_path)
                 self.console.print(f"[green]✅ PDF Executive Report: {pdf_path.name}[/]")
-            
+
             # CSV Financial Data
             if "csv" in include_formats:
                 csv_path = self._generate_csv_financial_data(analysis_results, output_path)
                 generated_reports["csv"] = str(csv_path)
                 self.console.print(f"[green]✅ CSV Financial Data: {csv_path.name}[/]")
-            
+
             # JSON Structured Data
             if "json" in include_formats:
                 json_path = self._generate_json_structured_data(analysis_results, output_path, package_verification)
                 generated_reports["json"] = str(json_path)
                 self.console.print(f"[green]✅ JSON Structured Data: {json_path.name}[/]")
-            
+
             # Markdown Documentation
             if "markdown" in include_formats:
                 md_path = self._generate_markdown_documentation(analysis_results, output_path)
                 generated_reports["markdown"] = str(md_path)
                 self.console.print(f"[green]✅ Markdown Documentation: {md_path.name}[/]")
-            
+
             # Executive Summary (Text)
             if "executive_summary" in include_formats:
                 summary_path = self._generate_executive_text_summary(analysis_results, output_path)
                 generated_reports["executive_summary"] = str(summary_path)
                 self.console.print(f"[green]✅ Executive Summary: {summary_path.name}[/]")
-            
+
             # Package integrity verification file
             verification_path = output_path / "package_verification.json"
-            with open(verification_path, 'w') as f:
+            with open(verification_path, "w") as f:
                 json.dump(package_verification, f, indent=2, default=str)
             generated_reports["verification"] = str(verification_path)
-            
+
             # Display package summary
             self._display_package_summary(generated_reports, output_path)
-            
+
             return generated_reports
-            
+
         except Exception as e:
             print_error(f"Executive report generation failed: {str(e)}")
             return {"error": str(e)}
-    
+
     def _generate_html_executive_dashboard(self, analysis_results: Dict, output_path: Path) -> Path:
         """Generate interactive HTML executive dashboard."""
         html_file = output_path / "executive_cost_optimization_dashboard.html"
-        
+
         # Extract key metrics
-        executive_summary = analysis_results.get('executive_summary', {})
-        validation_results = analysis_results.get('validation_results', {})
-        
-        annual_savings = executive_summary.get('total_annual_opportunity', 0)
-        roi_percentage = executive_summary.get('roi_percentage', 0)
-        confidence_level = executive_summary.get('confidence_level', 0)
-        
+        executive_summary = analysis_results.get("executive_summary", {})
+        validation_results = analysis_results.get("validation_results", {})
+
+        annual_savings = executive_summary.get("total_annual_opportunity", 0)
+        roi_percentage = executive_summary.get("roi_percentage", 0)
+        confidence_level = executive_summary.get("confidence_level", 0)
+
         html_content = f"""
 <!DOCTYPE html>
 <html lang="en">
@@ -301,7 +304,7 @@ class ExecutiveReportGenerator:
         <div class="header">
             <h1>💼 Executive Cost Optimization Dashboard</h1>
             <p>Board-Ready Financial Analysis & Strategic Recommendations</p>
-            <p>Generated: {datetime.now().strftime('%B %d, %Y at %I:%M %p')}</p>
+            <p>Generated: {datetime.now().strftime("%B %d, %Y at %I:%M %p")}</p>
         </div>
         
         <div class="metrics-grid">
@@ -319,7 +322,7 @@ class ExecutiveReportGenerator:
             </div>
             <div class="metric-card">
                 <div class="metric-label">Payback Period</div>
-                <div class="metric-value">{executive_summary.get('payback_period_months', 12):.1f} Mo</div>
+                <div class="metric-value">{executive_summary.get("payback_period_months", 12):.1f} Mo</div>
             </div>
         </div>
         
@@ -380,7 +383,7 @@ class ExecutiveReportGenerator:
             <div class="section">
                 <h2>📋 Risk Assessment & Mitigation</h2>
                 <div class="recommendations">
-                    <h4>Risk Level: {executive_summary.get('risk_assessment', 'Medium').title()}</h4>
+                    <h4>Risk Level: {executive_summary.get("risk_assessment", "Medium").title()}</h4>
                     <p>Implementation approach balanced for optimal savings with minimal operational disruption.</p>
                     
                     <h4>Mitigation Strategies</h4>
@@ -410,25 +413,25 @@ class ExecutiveReportGenerator:
 </body>
 </html>
         """
-        
-        with open(html_file, 'w') as f:
+
+        with open(html_file, "w") as f:
             f.write(html_content)
-        
+
         return html_file
-    
+
     def _generate_pdf_executive_report(self, analysis_results: Dict, output_path: Path) -> Path:
         """Generate PDF executive report (placeholder - would use reportlab in production)."""
         pdf_file = output_path / "executive_cost_optimization_report.pdf"
-        
+
         # For now, create a detailed markdown that can be converted to PDF
         markdown_content = self._create_pdf_content_markdown(analysis_results)
-        
+
         # Write as PDF-ready markdown (in production, would use reportlab or weasyprint)
-        with open(pdf_file.with_suffix('.md'), 'w') as f:
+        with open(pdf_file.with_suffix(".md"), "w") as f:
             f.write(markdown_content)
-        
+
         # Create placeholder PDF indicator
-        with open(pdf_file, 'w') as f:
+        with open(pdf_file, "w") as f:
             f.write(f"""PDF Executive Report Placeholder
             
 Generated: {datetime.now().isoformat()}
@@ -436,102 +439,144 @@ Content: Executive Cost Optimization Analysis
 Status: Ready for PDF conversion
             
 To generate actual PDF:
-1. Use pandoc: pandoc {pdf_file.with_suffix('.md')} -o {pdf_file}
-2. Or use weasyprint: weasyprint {pdf_file.with_suffix('.md')} {pdf_file}
+1. Use pandoc: pandoc {pdf_file.with_suffix(".md")} -o {pdf_file}
+2. Or use weasyprint: weasyprint {pdf_file.with_suffix(".md")} {pdf_file}
 3. Or integrate reportlab for native PDF generation
             """)
-        
+
         return pdf_file
-    
+
     def _generate_csv_financial_data(self, analysis_results: Dict, output_path: Path) -> Path:
         """Generate CSV financial data export."""
         csv_file = output_path / "executive_financial_data.csv"
-        
-        executive_summary = analysis_results.get('executive_summary', {})
-        
+
+        executive_summary = analysis_results.get("executive_summary", {})
+
         # Create comprehensive financial data export
         financial_data = [
             ["Metric", "Value", "Unit", "Confidence", "Notes"],
-            ["Annual Savings Opportunity", f"{executive_summary.get('total_annual_opportunity', 0):.2f}", "USD", f"{executive_summary.get('confidence_level', 0):.1f}%", "Total projected annual cost reduction"],
-            ["Monthly Savings", f"{executive_summary.get('total_annual_opportunity', 0) / 12:.2f}", "USD", f"{executive_summary.get('confidence_level', 0):.1f}%", "Average monthly cost reduction"],
-            ["ROI Percentage", f"{executive_summary.get('roi_percentage', 0):.1f}", "Percent", f"{executive_summary.get('confidence_level', 0):.1f}%", "Return on investment percentage"],
-            ["Payback Period", f"{executive_summary.get('payback_period_months', 12):.1f}", "Months", f"{executive_summary.get('confidence_level', 0):.1f}%", "Time to recover implementation investment"],
-            ["Implementation Cost", f"{executive_summary.get('total_annual_opportunity', 0) * 0.15:.2f}", "USD", "Estimated", "15% of annual savings (industry standard)"],
-            ["Quick Wins Value", f"{executive_summary.get('quick_wins_annual_value', 0):.2f}", "USD", "High", "Immediate implementation opportunities"],
-            ["Quick Wins Count", f"{executive_summary.get('quick_wins_count', 0)}", "Count", "High", "Number of quick-win scenarios identified"],
+            [
+                "Annual Savings Opportunity",
+                f"{executive_summary.get('total_annual_opportunity', 0):.2f}",
+                "USD",
+                f"{executive_summary.get('confidence_level', 0):.1f}%",
+                "Total projected annual cost reduction",
+            ],
+            [
+                "Monthly Savings",
+                f"{executive_summary.get('total_annual_opportunity', 0) / 12:.2f}",
+                "USD",
+                f"{executive_summary.get('confidence_level', 0):.1f}%",
+                "Average monthly cost reduction",
+            ],
+            [
+                "ROI Percentage",
+                f"{executive_summary.get('roi_percentage', 0):.1f}",
+                "Percent",
+                f"{executive_summary.get('confidence_level', 0):.1f}%",
+                "Return on investment percentage",
+            ],
+            [
+                "Payback Period",
+                f"{executive_summary.get('payback_period_months', 12):.1f}",
+                "Months",
+                f"{executive_summary.get('confidence_level', 0):.1f}%",
+                "Time to recover implementation investment",
+            ],
+            [
+                "Implementation Cost",
+                f"{executive_summary.get('total_annual_opportunity', 0) * 0.15:.2f}",
+                "USD",
+                "Estimated",
+                "15% of annual savings (industry standard)",
+            ],
+            [
+                "Quick Wins Value",
+                f"{executive_summary.get('quick_wins_annual_value', 0):.2f}",
+                "USD",
+                "High",
+                "Immediate implementation opportunities",
+            ],
+            [
+                "Quick Wins Count",
+                f"{executive_summary.get('quick_wins_count', 0)}",
+                "Count",
+                "High",
+                "Number of quick-win scenarios identified",
+            ],
         ]
-        
-        with open(csv_file, 'w', newline='') as f:
+
+        with open(csv_file, "w", newline="") as f:
             writer = csv.writer(f)
             writer.writerows(financial_data)
-        
+
         return csv_file
-    
+
     def _generate_json_structured_data(self, analysis_results: Dict, output_path: Path, verification: Dict) -> Path:
         """Generate JSON structured data export with verification."""
         json_file = output_path / "executive_cost_optimization_data.json"
-        
+
         # Create comprehensive structured data
         structured_data = {
             "report_metadata": self.report_metadata,
-            "executive_summary": analysis_results.get('executive_summary', {}),
+            "executive_summary": analysis_results.get("executive_summary", {}),
             "financial_metrics": {
-                "annual_opportunity": analysis_results.get('executive_summary', {}).get('total_annual_opportunity', 0),
-                "roi_percentage": analysis_results.get('executive_summary', {}).get('roi_percentage', 0),
-                "confidence_level": analysis_results.get('executive_summary', {}).get('confidence_level', 0),
-                "payback_months": analysis_results.get('executive_summary', {}).get('payback_period_months', 12)
+                "annual_opportunity": analysis_results.get("executive_summary", {}).get("total_annual_opportunity", 0),
+                "roi_percentage": analysis_results.get("executive_summary", {}).get("roi_percentage", 0),
+                "confidence_level": analysis_results.get("executive_summary", {}).get("confidence_level", 0),
+                "payback_months": analysis_results.get("executive_summary", {}).get("payback_period_months", 12),
             },
-            "business_impact": analysis_results.get('executive_summary', {}).get('business_impact_summary', {}),
-            "validation_results": analysis_results.get('validation_results', {}),
-            "recommendations": analysis_results.get('executive_summary', {}).get('recommended_next_steps', []),
+            "business_impact": analysis_results.get("executive_summary", {}).get("business_impact_summary", {}),
+            "validation_results": analysis_results.get("validation_results", {}),
+            "recommendations": analysis_results.get("executive_summary", {}).get("recommended_next_steps", []),
             "compliance_status": {
                 "sox_compliant": True,
                 "soc2_ready": True,
                 "enterprise_governance": True,
-                "audit_trail_complete": True
+                "audit_trail_complete": True,
             },
             "package_verification": verification,
-            "export_timestamp": datetime.now().isoformat()
+            "export_timestamp": datetime.now().isoformat(),
         }
-        
-        with open(json_file, 'w') as f:
+
+        with open(json_file, "w") as f:
             json.dump(structured_data, f, indent=2, default=str)
-        
+
         return json_file
-    
+
     def _generate_markdown_documentation(self, analysis_results: Dict, output_path: Path) -> Path:
         """Generate markdown documentation."""
         md_file = output_path / "executive_cost_optimization_documentation.md"
-        
-        executive_summary = analysis_results.get('executive_summary', {})
-        
+
+        executive_summary = analysis_results.get("executive_summary", {})
+
         markdown_content = f"""# 💼 Executive Cost Optimization Analysis
 
 ## Executive Summary
 
-**Generated:** {datetime.now().strftime('%B %d, %Y')}
+**Generated:** {datetime.now().strftime("%B %d, %Y")}
 
-**Annual Cost Savings Opportunity:** ${executive_summary.get('total_annual_opportunity', 0):,.0f}
+**Annual Cost Savings Opportunity:** ${executive_summary.get("total_annual_opportunity", 0):,.0f}
 
-**Return on Investment:** {executive_summary.get('roi_percentage', 0):.0f}%
+**Return on Investment:** {executive_summary.get("roi_percentage", 0):.0f}%
 
-**Confidence Level:** {executive_summary.get('confidence_level', 0):.1f}%
+**Confidence Level:** {executive_summary.get("confidence_level", 0):.1f}%
 
-**Payback Period:** {executive_summary.get('payback_period_months', 12):.1f} months
+**Payback Period:** {executive_summary.get("payback_period_months", 12):.1f} months
 
 ---
 
 ## Financial Impact Analysis
 
 ### Annual Financial Benefits
-- **Total Annual Savings:** ${executive_summary.get('total_annual_opportunity', 0):,.0f}
-- **Monthly Cost Reduction:** ${executive_summary.get('total_annual_opportunity', 0) / 12:,.0f}
-- **Implementation Investment:** ${executive_summary.get('total_annual_opportunity', 0) * 0.15:,.0f}
-- **Net Annual Benefit:** ${executive_summary.get('total_annual_opportunity', 0) * 0.85:,.0f}
+- **Total Annual Savings:** ${executive_summary.get("total_annual_opportunity", 0):,.0f}
+- **Monthly Cost Reduction:** ${executive_summary.get("total_annual_opportunity", 0) / 12:,.0f}
+- **Implementation Investment:** ${executive_summary.get("total_annual_opportunity", 0) * 0.15:,.0f}
+- **Net Annual Benefit:** ${executive_summary.get("total_annual_opportunity", 0) * 0.85:,.0f}
 
 ### Quick Wins Portfolio
-- **Quick Wins Value:** ${executive_summary.get('quick_wins_annual_value', 0):,.0f}
-- **Quick Wins Count:** {executive_summary.get('quick_wins_count', 0)} opportunities
+- **Quick Wins Value:** ${executive_summary.get("quick_wins_annual_value", 0):,.0f}
+- **Quick Wins Count:** {executive_summary.get("quick_wins_count", 0)} opportunities
 - **Implementation Timeline:** 30-60 days
 
 ---
@@ -539,17 +584,17 @@ To generate actual PDF:
 ## Strategic Recommendations
 
 ### Immediate Actions (Next 30 Days)
-{chr(10).join([f"- {step}" for step in executive_summary.get('recommended_next_steps', [])])}
+{chr(10).join([f"- {step}" for step in executive_summary.get("recommended_next_steps", [])])}
 
 ### Priority Scenarios
-{chr(10).join([f"- {scenario}" for scenario in executive_summary.get('priority_scenarios', [])])}
+{chr(10).join([f"- {scenario}" for scenario in executive_summary.get("priority_scenarios", [])])}
 
 ---
 
 ## Risk Assessment & Compliance
 
 ### Risk Profile
-- **Risk Level:** {executive_summary.get('risk_assessment', 'Medium').title()}
+- **Risk Level:** {executive_summary.get("risk_assessment", "Medium").title()}
 - **Implementation Approach:** Phased with validation checkpoints
 - **Operational Impact:** Minimal disruption with proper planning
 
@@ -567,15 +612,15 @@ This analysis provides comprehensive cost optimization recommendations with vali
 financial projections suitable for board presentation and executive decision-making.
 
 **Key Decision Points:**
-- Approve ${executive_summary.get('total_annual_opportunity', 0) * 0.15:,.0f} implementation budget
+- Approve ${executive_summary.get("total_annual_opportunity", 0) * 0.15:,.0f} implementation budget
 - Establish cloud cost optimization team (3-5 FTE)
 - Set quarterly cost reduction targets
 - Integrate optimization KPIs into executive dashboards
 
 **Expected Outcomes:**
-- ${executive_summary.get('total_annual_opportunity', 0):,.0f} annual cost reduction
-- {executive_summary.get('roi_percentage', 0):.0f}% return on investment
-- {executive_summary.get('payback_period_months', 12):.1f} month payback period
+- ${executive_summary.get("total_annual_opportunity", 0):,.0f} annual cost reduction
+- {executive_summary.get("roi_percentage", 0):.0f}% return on investment
+- {executive_summary.get("payback_period_months", 12):.1f} month payback period
 - Sustainable cost management framework
 
 ---
@@ -585,29 +630,29 @@ financial projections suitable for board presentation and executive decision-mak
 - Generated: `{datetime.now().isoformat()}`
 - Status: ✅ Verified
 """
-        
-        with open(md_file, 'w') as f:
+
+        with open(md_file, "w") as f:
             f.write(markdown_content)
-        
+
         return md_file
-    
+
     def _generate_executive_text_summary(self, analysis_results: Dict, output_path: Path) -> Path:
         """Generate executive text summary."""
         summary_file = output_path / "executive_summary.txt"
-        
-        executive_summary = analysis_results.get('executive_summary', {})
-        
+
+        executive_summary = analysis_results.get("executive_summary", {})
+
         summary_content = f"""EXECUTIVE COST OPTIMIZATION SUMMARY
 ====================================
 
-Generated: {datetime.now().strftime('%B %d, %Y at %I:%M %p')}
+Generated: {datetime.now().strftime("%B %d, %Y at %I:%M %p")}
 
 FINANCIAL IMPACT
 ----------------
-Annual Savings Opportunity: ${executive_summary.get('total_annual_opportunity', 0):,.0f}
-Return on Investment: {executive_summary.get('roi_percentage', 0):.0f}%
-Confidence Level: {executive_summary.get('confidence_level', 0):.1f}%
-Payback Period: {executive_summary.get('payback_period_months', 12):.1f} months
+Annual Savings Opportunity: ${executive_summary.get("total_annual_opportunity", 0):,.0f}
+Return on Investment: {executive_summary.get("roi_percentage", 0):.0f}%
+Confidence Level: {executive_summary.get("confidence_level", 0):.1f}%
+Payback Period: {executive_summary.get("payback_period_months", 12):.1f} months
 
 BOARD RECOMMENDATION
 --------------------
@@ -616,7 +661,7 @@ and validated implementation approach.
 
 IMMEDIATE ACTIONS REQUIRED
 --------------------------
-{chr(10).join([f"• {step}" for step in executive_summary.get('recommended_next_steps', [])])}
+{chr(10).join([f"• {step}" for step in executive_summary.get("recommended_next_steps", [])])}
 
 COMPLIANCE STATUS
 -----------------
@@ -627,20 +672,20 @@ Audit Trail: COMPLETE
 
 BOARD PRESENTATION STATUS: READY FOR IMMEDIATE PRESENTATION
 """
-        
-        with open(summary_file, 'w') as f:
+
+        with open(summary_file, "w") as f:
             f.write(summary_content)
-        
+
         return summary_file
-    
+
     def _create_pdf_content_markdown(self, analysis_results: Dict) -> str:
         """Create PDF-ready markdown content."""
-        executive_summary = analysis_results.get('executive_summary', {})
-        
+        executive_summary = analysis_results.get("executive_summary", {})
+
         return f"""---
 title: Executive Cost Optimization Report
 author: CloudOps-Runbooks Enterprise Platform
-date: {datetime.now().strftime('%B %d, %Y')}
+date: {datetime.now().strftime("%B %d, %Y")}
 geometry: margin=1in
 fontsize: 11pt
 ---
@@ -649,28 +694,28 @@ fontsize: 11pt
 
 ## Executive Summary
 
-This comprehensive analysis identifies **${executive_summary.get('total_annual_opportunity', 0):,.0f}** in annual cost savings opportunities with **{executive_summary.get('roi_percentage', 0):.0f}%** return on investment and **{executive_summary.get('confidence_level', 0):.1f}%** confidence level.
+This comprehensive analysis identifies **${executive_summary.get("total_annual_opportunity", 0):,.0f}** in annual cost savings opportunities with **{executive_summary.get("roi_percentage", 0):.0f}%** return on investment and **{executive_summary.get("confidence_level", 0):.1f}%** confidence level.
 
 ## Key Financial Metrics
 
 | Metric | Value | Impact |
 |--------|-------|---------|
-| Annual Savings Opportunity | ${executive_summary.get('total_annual_opportunity', 0):,.0f} | Direct P&L improvement |
-| Return on Investment | {executive_summary.get('roi_percentage', 0):.0f}% | Investment efficiency |
-| Payback Period | {executive_summary.get('payback_period_months', 12):.1f} months | Time to break-even |
-| Implementation Cost | ${executive_summary.get('total_annual_opportunity', 0) * 0.15:,.0f} | Required investment |
+| Annual Savings Opportunity | ${executive_summary.get("total_annual_opportunity", 0):,.0f} | Direct P&L improvement |
+| Return on Investment | {executive_summary.get("roi_percentage", 0):.0f}% | Investment efficiency |
+| Payback Period | {executive_summary.get("payback_period_months", 12):.1f} months | Time to break-even |
+| Implementation Cost | ${executive_summary.get("total_annual_opportunity", 0) * 0.15:,.0f} | Required investment |
 
 ## Strategic Recommendations
 
 ### Immediate Actions (30-60 Days)
-{chr(10).join([f"- {step}" for step in executive_summary.get('recommended_next_steps', [])])}
+{chr(10).join([f"- {step}" for step in executive_summary.get("recommended_next_steps", [])])}
 
 ### Priority Implementation Areas
-{chr(10).join([f"- {scenario}" for scenario in executive_summary.get('priority_scenarios', [])])}
+{chr(10).join([f"- {scenario}" for scenario in executive_summary.get("priority_scenarios", [])])}
 
 ## Risk Assessment
 
-**Risk Level:** {executive_summary.get('risk_assessment', 'Medium').title()}
+**Risk Level:** {executive_summary.get("risk_assessment", "Medium").title()}
 
 **Mitigation Strategy:** Phased implementation with comprehensive validation at each stage.
 
@@ -683,23 +728,23 @@ This comprehensive analysis identifies **${executive_summary.get('total_annual_o
 
 ## Board Decision Requirements
 
-**Budget Approval:** ${executive_summary.get('total_annual_opportunity', 0) * 0.15:,.0f} for implementation
+**Budget Approval:** ${executive_summary.get("total_annual_opportunity", 0) * 0.15:,.0f} for implementation
 
 **Team Authorization:** 3-5 FTE cloud cost optimization team
 
 **Timeline:** 90-day implementation for Phase 1 quick wins
 
-**Expected ROI:** {executive_summary.get('roi_percentage', 0):.0f}% return within {executive_summary.get('payback_period_months', 12):.1f} months
+**Expected ROI:** {executive_summary.get("roi_percentage", 0):.0f}% return within {executive_summary.get("payback_period_months", 12):.1f} months
 
 ---
 
 **Document Integrity:** SHA256 verified | **Status:** Board presentation ready
 """
-    
+
     def _calculate_content_hash(self, content: str) -> str:
         """Calculate SHA256 hash of content for verification."""
         return hashlib.sha256(content.encode()).hexdigest()
-    
+
     def _generate_package_verification(self, analysis_results: Dict) -> Dict[str, Any]:
         """Generate package verification data with SHA256 hashes."""
         verification_data = {
@@ -707,24 +752,24 @@ This comprehensive analysis identifies **${executive_summary.get('total_annual_o
                 "generation_timestamp": datetime.now().isoformat(),
                 "analysis_data_hash": self._calculate_content_hash(str(analysis_results)),
                 "compliance_frameworks": ["SOX", "SOC2", "Enterprise_Governance"],
-                "executive_ready": True
+                "executive_ready": True,
             },
             "financial_validation": {
-                "annual_savings": analysis_results.get('executive_summary', {}).get('total_annual_opportunity', 0),
-                "roi_percentage": analysis_results.get('executive_summary', {}).get('roi_percentage', 0),
-                "confidence_level": analysis_results.get('executive_summary', {}).get('confidence_level', 0),
-                "validation_method": "embedded_mcp_enterprise_validation"
+                "annual_savings": analysis_results.get("executive_summary", {}).get("total_annual_opportunity", 0),
+                "roi_percentage": analysis_results.get("executive_summary", {}).get("roi_percentage", 0),
+                "confidence_level": analysis_results.get("executive_summary", {}).get("confidence_level", 0),
+                "validation_method": "embedded_mcp_enterprise_validation",
             },
             "integrity_verification": {
                 "sha256_enabled": True,
                 "tamper_detection": "ACTIVE",
                 "audit_trail": "COMPLETE",
-                "regulatory_compliance": "VERIFIED"
-            }
+                "regulatory_compliance": "VERIFIED",
+            },
         }
-        
+
         return verification_data
-    
+
     def _display_package_summary(self, generated_reports: Dict[str, str], output_path: Path):
         """Display package generation summary."""
         summary_panel = create_panel(
@@ -743,9 +788,9 @@ This comprehensive analysis identifies **${executive_summary.get('total_annual_o
 
 ⏰ **Recommended Review Timeline:** 24-48 hours for board preparation""",
             title="Executive Package Complete",
-            border_style="bright_green"
+            border_style="bright_green",
         )
-        
+
         self.console.print(summary_panel)
 
 
@@ -758,11 +803,11 @@ def create_executive_report_generator(console: Optional[Console] = None) -> Exec
 def generate_executive_reports(analysis_results: Dict, output_dir: str) -> Dict[str, str]:
     """
     Convenience function to generate executive reports.
-    
+
     Args:
         analysis_results: Complete analysis results with business metrics
         output_dir: Directory to save generated reports
-        
+
     Returns:
         Dictionary mapping format names to generated file paths
     """
@@ -773,17 +818,15 @@ def generate_executive_reports(analysis_results: Dict, output_dir: str) -> Dict[
 def generate_board_presentation_package(analysis_results: Dict, output_dir: str) -> Dict[str, str]:
     """
     Generate board presentation package with essential formats.
-    
+
     Args:
         analysis_results: Complete analysis results
         output_dir: Directory to save reports
-        
+
     Returns:
         Dictionary mapping format names to generated file paths
     """
     generator = create_executive_report_generator()
     return generator.generate_comprehensive_executive_package(
-        analysis_results, 
-        output_dir,
-        include_formats=["html", "pdf", "executive_summary", "json", "verification"]
-    )
+        analysis_results, output_dir, include_formats=["html", "pdf", "executive_summary", "json", "verification"]
+    )