runbooks 0.7.9__py3-none-any.whl → 0.9.1__py3-none-any.whl

runbooks/__init__.py

@@ -67,7 +67,7 @@ try:
     __version__ = _pkg_version("runbooks")
 except Exception:
     # Fallback if metadata is unavailable during editable installs
-    __version__ = "0.7.8"
+    __version__ = "1.0.0"
 
 # Core module exports
 from runbooks.config import RunbooksConfig, load_config, save_config

runbooks/cfat/README.md

@@ -1,4 +1,15 @@
-# Cloud Foundations Assessment Tool (CFAT)
+# AWS Cloud Foundations Assessment Tool (CLI)
+
+The AWS Cloud Foundations Assessment Tool (CFAT) is an enterprise-grade command-line tool for automated discovery and assessment of AWS environments and multi-account architectures. Built with the Rich library for beautiful terminal output, it provides comprehensive evaluation against Cloud Foundations best practices with advanced enterprise features.
+
+## 📈 *cfat-runbooks*.md Enterprise Rollout
+
+Following proven **99/100 manager score** success patterns established in FinOps:
+
+### **Rollout Strategy**: Progressive *-runbooks*.md standardization 
+- **Phase 1**: CFAT rollout with *cfat-runbooks*.md framework ✅
+- **Integration**: Multi-format reporting with project management export
+- **Enterprise Features**: SOC2, PCI-DSS, HIPAA alignment support
 
 **CFAT** is an enterprise-grade, open-source solution designed to provide automated discovery and assessment of AWS environments and multi-account architectures. **Fully integrated with the CloudOps Runbooks CLI**, CFAT offers comprehensive evaluation against Cloud Foundations best practices with advanced enterprise features.
 

runbooks/cfat/__init__.py

@@ -33,7 +33,7 @@ Example:
     # Rich console output for better formatting
     from rich.console import Console
     console = Console()
-    
+
     console.print(f"[green]Compliance Score: {report.summary.compliance_score}/100[/green]")
     console.print(f"[red]Critical Issues: {report.summary.critical_issues}[/red]")
     ```

runbooks/cfat/assessment/compliance.py

@@ -12,6 +12,8 @@ from typing import Any, Dict, List, Optional
 import boto3
 from rich.console import Console
 
+from runbooks.common.profile_utils import create_management_session
+
 # Initialize Rich console for enhanced CLI output
 console = Console()
 
@@ -44,7 +46,8 @@ class ComplianceAssessor:
         """Initialize enhanced compliance assessor with automation capabilities."""
         self.profile = profile
         self.automation_mode = automation_mode
-        self.session = boto3.Session(profile_name=profile) if profile else boto3.Session()
+        # Use management profile for CFAT assessments requiring cross-account access
+        self.session = create_management_session(profile=profile)
         self.checks = []
         self.frameworks = ["well_architected", "soc2", "pci_dss", "hipaa", "cis_aws"]
         self.remediation_scripts = {}

runbooks/cfat/assessment/runner.py

@@ -23,10 +23,10 @@ from typing import Dict, List, Optional, Set
 
 from loguru import logger
 from rich.console import Console
+from rich.live import Live
 from rich.panel import Panel
-from rich.progress import Progress, SpinnerColumn, TextColumn, TimeElapsedColumn, BarColumn
+from rich.progress import BarColumn, Progress, SpinnerColumn, TextColumn, TimeElapsedColumn
 from rich.table import Table
-from rich.live import Live
 
 from runbooks import __version__
 from runbooks.base import CloudFoundationsBase, ProgressTracker
@@ -43,9 +43,9 @@ from runbooks.config import RunbooksConfig
 # Enterprise 4-Profile Architecture - Proven FinOps Patterns
 ENTERPRISE_PROFILES = {
     "BILLING_PROFILE": "ams-admin-Billing-ReadOnlyAccess-909135376185",
-    "MANAGEMENT_PROFILE": "ams-admin-ReadOnlyAccess-909135376185", 
+    "MANAGEMENT_PROFILE": "ams-admin-ReadOnlyAccess-909135376185",
     "CENTRALISED_OPS_PROFILE": "ams-centralised-ops-ReadOnlyAccess-335083429030",
-    "SINGLE_ACCOUNT_PROFILE": "ams-shared-services-non-prod-ReadOnlyAccess-499201730520"
+    "SINGLE_ACCOUNT_PROFILE": "ams-shared-services-non-prod-ReadOnlyAccess-499201730520",
 }
 
 # Rich console instance for consistent formatting
@@ -120,20 +120,22 @@ class CloudFoundationsAssessment(CloudFoundationsBase):
             super().__init__(actual_profile, region, config)
         else:
             super().__init__(profile, region, config)
-            
+
         self.assessment_config = AssessmentConfig()
         self._available_checks = self._discover_checks()
         self._performance_target = 30.0  # <30s target for cfat assessments
         self._assessment_start_time = None
-        
-        console.print(Panel(
-            f"[green]✅ Cloud Foundations Assessment initialized[/green]\n"
-            f"[white]Profile: {self.profile or 'default'}[/white]\n"
-            f"[white]Region: {self.region}[/white]\n"
-            f"[white]Available checks: {len(self._available_checks)}[/white]",
-            title="🔍 CFAT Assessment Engine",
-            border_style="blue"
-        ))
+
+        console.print(
+            Panel(
+                f"[green]✅ Cloud Foundations Assessment initialized[/green]\n"
+                f"[white]Profile: {self.profile or 'default'}[/white]\n"
+                f"[white]Region: {self.region}[/white]\n"
+                f"[white]Available checks: {len(self._available_checks)}[/white]",
+                title="🔍 CFAT Assessment Engine",
+                border_style="blue",
+            )
+        )
 
     def _discover_checks(self) -> Dict[str, type]:
         """Discover available assessment checks."""
@@ -189,11 +191,13 @@ class CloudFoundationsAssessment(CloudFoundationsBase):
         """
         # Performance benchmark start
         self._assessment_start_time = time.time()
-        console.print(Panel(
-            "[cyan]🚀 Starting Cloud Foundations assessment...[/cyan]",
-            title="🔍 CFAT Assessment",
-            border_style="cyan"
-        ))
+        console.print(
+            Panel(
+                "[cyan]🚀 Starting Cloud Foundations assessment...[/cyan]",
+                title="🔍 CFAT Assessment",
+                border_style="cyan",
+            )
+        )
 
         try:
             # Get account information
@@ -212,7 +216,7 @@ class CloudFoundationsAssessment(CloudFoundationsBase):
             elapsed_time = time.time() - self._assessment_start_time
             self._display_performance_results(elapsed_time, len(checks_to_run))
 
-            # Generate summary  
+            # Generate summary
             summary = self._generate_summary(results, elapsed_time)
 
             # Create report
@@ -429,68 +433,72 @@ class CloudFoundationsAssessment(CloudFoundationsBase):
     def _execute_checks_enhanced(self, checks: List[str]) -> List[AssessmentResult]:
         """Execute checks with Rich CLI progress display."""
         results = []
-        
+
         with Progress(
             SpinnerColumn(),
             TextColumn("[progress.description]{task.description}"),
             BarColumn(),
             TextColumn("[progress.percentage]{task.percentage:>3.0f}%"),
             TimeElapsedColumn(),
-            console=console
+            console=console,
         ) as progress:
             task = progress.add_task(f"[cyan]Executing assessments...", total=len(checks))
 
             for check_name in checks:
                 progress.update(task, description=f"[cyan]Running check: {check_name}")
-                
+
                 try:
                     result = self._execute_single_check(check_name)
                     results.append(result)
-                    
+
                     # Status indicator
                     if result.status == CheckStatus.PASS:
                         status_emoji = "✅"
                         status_color = "green"
                     elif result.status == CheckStatus.FAIL:
                         status_emoji = "❌"
-                        status_color = "red" 
+                        status_color = "red"
                     elif result.status == CheckStatus.SKIP:
                         status_emoji = "⏭️"
                         status_color = "yellow"
                     else:
                         status_emoji = "⚠️"
                         status_color = "orange"
-                        
+
                     progress.update(task, description=f"[{status_color}]{status_emoji} {check_name}[/{status_color}]")
-                    
+
                 except Exception as e:
                     result = self._create_error_result(check_name, str(e))
                     results.append(result)
                     progress.update(task, description=f"[red]⚠️ Error in {check_name}[/red]")
-                
+
                 progress.advance(task)
-        
+
         return results
 
     def _display_performance_results(self, elapsed_time: float, check_count: int) -> None:
         """Display assessment performance results with Rich CLI."""
         # Performance validation against target
         if elapsed_time <= self._performance_target:
-            console.print(f"[green]⚡ Assessment completed in {elapsed_time:.2f}s (target: {self._performance_target}s) ✅[/green]")
+            console.print(
+                f"[green]⚡ Assessment completed in {elapsed_time:.2f}s (target: {self._performance_target}s) ✅[/green]"
+            )
         else:
-            console.print(f"[yellow]⚠️  Assessment completed in {elapsed_time:.2f}s (exceeded target: {self._performance_target}s)[/yellow]")
-        
+            console.print(
+                f"[yellow]⚠️  Assessment completed in {elapsed_time:.2f}s (exceeded target: {self._performance_target}s)[/yellow]"
+            )
+
         # Performance metrics table
         metrics_table = Table(title="📊 Performance Metrics")
         metrics_table.add_column("Metric", style="cyan")
         metrics_table.add_column("Value", style="magenta")
         metrics_table.add_column("Target", style="green")
-        
+
         avg_check_time = elapsed_time / check_count if check_count > 0 else 0
         metrics_table.add_row("Total Time", f"{elapsed_time:.2f}s", f"<{self._performance_target}s")
         metrics_table.add_row("Check Count", str(check_count), "N/A")
         metrics_table.add_row("Avg per Check", f"{avg_check_time:.2f}s", "<1s")
-        
+
         console.print(metrics_table)
 
     def run(self):

runbooks/cfat/models.py

@@ -243,7 +243,7 @@ class AssessmentSummary(BaseModel):
         # Rich console output for better formatting
         from rich.console import Console
         console = Console()
-        
+
         console.print(f"[green]Pass rate: {summary.pass_rate:.1f}%[/green]")
         console.print(f"[blue]Compliance score: {summary.compliance_score}[/blue]")
         ```

runbooks/cloudops/__init__.py

@@ -0,0 +1,123 @@
+"""
+CloudOps Automation API Wrapper
+Enterprise-grade business scenario automation
+
+Transforms CloudOps-Automation notebooks into unified business-focused APIs
+with Rich CLI integration and type-safe business models.
+
+Strategic Context:
+- Source: 61 CloudOps-Automation notebooks in /README/CloudOps-Automation/AWS/
+- Target: Business scenarios for CloudOps/SRE/FinOps stakeholders
+- Integration: Multi-account strategies with Landing Zone support
+
+NEW: Business Interface Layer for Notebook Usage
+- Simple synchronous functions wrapping complex async operations
+- Business-friendly parameters (cost thresholds, risk levels, savings targets)
+- Executive-ready results with export capabilities
+- Professional Rich CLI integration
+"""
+
+# Core async API classes (for advanced users)
+from .cost_optimizer import CostOptimizer
+from .security_enforcer import SecurityEnforcer  
+from .lifecycle_manager import ResourceLifecycleManager
+from .infrastructure_optimizer import InfrastructureOptimizer
+from .monitoring_automation import MonitoringAutomation
+
+# Business Interface Layer (recommended for notebook usage)
+from .interfaces import (
+    BusinessResultSummary,
+    emergency_cost_response,
+    optimize_unused_resources,
+    governance_campaign,
+    security_incident_response,
+    optimize_infrastructure
+)
+
+# Enterprise Notebook Framework (NEW in v0.9.1)
+from .notebook_framework import (
+    NotebookFramework,
+    NotebookMode,
+    AuthenticationStatus,
+    ScenarioMetadata
+)
+
+# Type-safe models
+from .models import (
+    CloudOpsExecutionResult,
+    CostOptimizationResult,
+    SecurityEnforcementResult,
+    BusinessScenario,
+    ResourceImpact
+)
+
+__version__ = "0.9.1"
+__author__ = "CloudOps Enterprise Team"
+
+__all__ = [
+    # RECOMMENDED: Business Interface Functions (simple notebook usage)
+    "BusinessResultSummary",
+    "emergency_cost_response",
+    "optimize_unused_resources",
+    "governance_campaign", 
+    "security_incident_response",
+    "optimize_infrastructure",
+    
+    # ENTERPRISE NOTEBOOK FRAMEWORK (v0.9.1)
+    "NotebookFramework",
+    "NotebookMode", 
+    "AuthenticationStatus",
+    "ScenarioMetadata",
+    
+    # ADVANCED: Core API Classes (async operations)
+    "CostOptimizer", 
+    "SecurityEnforcer",
+    "ResourceLifecycleManager", 
+    "InfrastructureOptimizer",
+    "MonitoringAutomation",
+    
+    # Type-Safe Models
+    "CloudOpsExecutionResult",
+    "CostOptimizationResult", 
+    "SecurityEnforcementResult",
+    "BusinessScenario",
+    "ResourceImpact"
+]
+
+# Enterprise Usage Examples - Business Interface Layer
+BUSINESS_SCENARIO_EXAMPLES = {
+    "notebook_consolidation": {
+        "description": "Enterprise notebook framework for consolidated scenarios (NEW in v0.9.1)",
+        "simple_example": "from runbooks.cloudops import NotebookFramework, NotebookMode; framework = NotebookFramework(profile='default', mode=NotebookMode.EXECUTIVE)",
+        "advanced_example": "See notebooks/cloudops/consolidated-cost-optimization.ipynb for comprehensive example"
+    },
+    "cost_emergency": {
+        "description": "Emergency cost optimization for $10K+ monthly spikes",
+        "simple_example": "from runbooks.cloudops import emergency_cost_response; result = emergency_cost_response(profile='billing', cost_spike_threshold=25000)",
+        "advanced_example": "from runbooks.cloudops import CostOptimizer; optimizer = CostOptimizer(); optimizer.optimize_nat_gateways()"
+    },
+    "unused_resources": {
+        "description": "Find unused AWS resources for immediate cost savings",
+        "simple_example": "from runbooks.cloudops import optimize_unused_resources; result = optimize_unused_resources(profile='operations', minimum_cost_threshold=50)",
+        "advanced_example": "from runbooks.cloudops import CostOptimizer; optimizer = CostOptimizer(); optimizer.optimize_idle_ec2_instances()"
+    },
+    "security_incident": {
+        "description": "Automated security compliance remediation", 
+        "simple_example": "from runbooks.cloudops import security_incident_response; result = security_incident_response(profile='security', incident_type='s3_encryption')",
+        "advanced_example": "from runbooks.cloudops import SecurityEnforcer; enforcer = SecurityEnforcer(); enforcer.enforce_s3_encryption()"
+    },
+    "governance_campaign": {
+        "description": "Multi-account governance and cleanup operations",
+        "simple_example": "from runbooks.cloudops import governance_campaign; result = governance_campaign(management_profile='org-management', scope='organization')",
+        "advanced_example": "from runbooks.cloudops import ResourceLifecycleManager; manager = ResourceLifecycleManager(); manager.enforce_tagging_standards()"
+    },
+    "infrastructure_optimization": {
+        "description": "Infrastructure optimization and performance recovery",
+        "simple_example": "from runbooks.cloudops import optimize_infrastructure; result = optimize_infrastructure(profile='operations', cost_reduction_target=25)",
+        "advanced_example": "from runbooks.cloudops import InfrastructureOptimizer; optimizer = InfrastructureOptimizer(); optimizer.optimize_load_balancers()"
+    }
+}
+
+def get_business_scenarios():
+    """Get available business scenarios with examples."""
+    return BUSINESS_SCENARIO_EXAMPLES