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

runbooks/finops/scenarios.py

@@ -6,8 +6,8 @@ scenarios in Jupyter notebooks and external applications. It abstracts the compl
 of the underlying finops_scenarios.py and business_cases.py modules.
 
 Strategic Achievement: $132,720+ annual savings (380-757% above targets)
-- FinOps-24: WorkSpaces cleanup ($13,020 annual, 104% of target)
-- FinOps-23: RDS snapshots optimization ($119,700 annual, 498% of target) 
+- FinOps-24: WorkSpaces cleanup (significant annual savings, 104% of target)
+- FinOps-23: RDS snapshots optimization (significant annual savings, 498% of target) 
 - FinOps-25: Commvault EC2 investigation framework (methodology established)
 
 API Functions for Notebook Integration:
@@ -72,7 +72,7 @@ def finops_workspaces(profile: Optional[str] = None, accounts: Optional[List[str
     Clean API wrapper for Jupyter notebook consumption that provides
     comprehensive WorkSpaces utilization analysis and cleanup recommendations.
     
-    Proven Result: $13,020 annual savings (104% of target achievement)
+    Proven Result: significant annual savings savings (104% of target achievement)
     
     Args:
         profile: AWS profile name for authentication (optional)
@@ -124,7 +124,7 @@ def finops_workspaces(profile: Optional[str] = None, accounts: Optional[List[str
                 'validation': {
                     'data_source': 'Error - AWS API unavailable',
                     'timestamp': datetime.now().isoformat(),
-                    'version': '0.9.5'
+                    'version': 'latest version'
                 }
             }
         
@@ -168,7 +168,7 @@ def finops_workspaces(profile: Optional[str] = None, accounts: Optional[List[str
                 'data_source': 'Real AWS WorkSpaces API via runbooks',
                 'validation_method': 'Direct AWS API integration',
                 'timestamp': datetime.now().isoformat(),
-                'version': '0.9.5'
+                'version': 'latest version'
             }
         }
         
@@ -188,7 +188,7 @@ def finops_workspaces(profile: Optional[str] = None, accounts: Optional[List[str
             'validation': {
                 'data_source': f'Error: {str(e)}',
                 'timestamp': datetime.now().isoformat(),
-                'version': '0.9.5'
+                'version': 'latest version'
             }
         }
 
@@ -200,7 +200,7 @@ def finops_snapshots(profile: Optional[str] = None, accounts: Optional[List[str]
     Clean API wrapper for comprehensive RDS manual snapshots analysis
     and storage cost optimization recommendations.
     
-    Proven Result: $119,700 annual savings (498% of target achievement)
+    Proven Result: significant annual savings savings (498% of target achievement)
     
     Args:
         profile: AWS profile name for authentication (optional)
@@ -253,7 +253,7 @@ def finops_snapshots(profile: Optional[str] = None, accounts: Optional[List[str]
                 'validation': {
                     'data_source': 'Error - AWS API unavailable',
                     'timestamp': datetime.now().isoformat(),
-                    'version': '0.9.5'
+                    'version': 'latest version'
                 }
             }
         
@@ -301,7 +301,7 @@ def finops_snapshots(profile: Optional[str] = None, accounts: Optional[List[str]
                 'data_source': 'Real AWS RDS API via runbooks',
                 'validation_method': 'Direct AWS API integration',
                 'timestamp': datetime.now().isoformat(),
-                'version': '0.9.5'
+                'version': 'latest version'
             }
         }
         
@@ -321,7 +321,7 @@ def finops_snapshots(profile: Optional[str] = None, accounts: Optional[List[str]
             'validation': {
                 'data_source': f'Error: {str(e)}',
                 'timestamp': datetime.now().isoformat(),
-                'version': '0.9.5'
+                'version': 'latest version'
             }
         }
 
@@ -384,7 +384,7 @@ def finops_commvault(profile: Optional[str] = None, account: Optional[str] = Non
                 'validation': {
                     'data_source': 'Error - Framework setup unavailable',
                     'timestamp': datetime.now().isoformat(),
-                    'version': '0.9.5'
+                    'version': 'latest version'
                 }
             }
         
@@ -429,7 +429,7 @@ def finops_commvault(profile: Optional[str] = None, account: Optional[str] = Non
                 'validation_method': raw_analysis.get('investigation_results', {}).get('validation_method', 'Investigation framework'),
                 'framework_validation': 'Real AWS integration operational',
                 'timestamp': datetime.now().isoformat(),
-                'version': '0.9.5'
+                'version': 'latest version'
             }
         }
         
@@ -449,7 +449,7 @@ def finops_commvault(profile: Optional[str] = None, account: Optional[str] = Non
             'validation': {
                 'data_source': f'Error: {str(e)}',
                 'timestamp': datetime.now().isoformat(),
-                'version': '0.9.5'
+                'version': 'latest version'
             }
         }
 
@@ -555,7 +555,7 @@ def get_business_scenarios_summary(scenarios: Optional[List[str]] = None) -> Dic
                 'accuracy_standard': '≥99.5% enterprise validation requirement',
                 'portfolio_validation': 'Cross-scenario validation operational',
                 'timestamp': datetime.now().isoformat(),
-                'version': '0.9.5'
+                'version': 'latest version'
             }
         }
         
@@ -574,7 +574,7 @@ def get_business_scenarios_summary(scenarios: Optional[List[str]] = None) -> Dic
             'validation': {
                 'data_source': f'Error: {str(e)}',
                 'timestamp': datetime.now().isoformat(),
-                'version': '0.9.5'
+                'version': 'latest version'
             }
         }
 
@@ -729,7 +729,7 @@ def _format_notebook_audience(data: Dict[str, Any]) -> str:
     - **Validation:** {data.get('validation', {}).get('validation_method', 'Enterprise standard')}
     
     ---
-    *Generated: {data.get('validation', {}).get('timestamp', datetime.now().isoformat())} | Version: {data.get('validation', {}).get('version', '0.9.5')}*
+    *Generated: {data.get('validation', {}).get('timestamp', datetime.now().isoformat())} | Version: {data.get('validation', {}).get('version', 'latest version')}*
     """
 
 

runbooks/finops/single_dashboard.py

@@ -90,7 +90,7 @@ class SingleAccountDashboard:
         self.context_logger = create_context_logger("finops.single_dashboard")
         self.context_console = get_context_console()
 
-        # Sprint 2 Enhancement: Use OptimizedProgressTracker for 82% caching efficiency
+        # Phase 2 Enhancement: Use OptimizedProgressTracker for 82% caching efficiency
         self.progress_tracker = OptimizedProgressTracker(self.console, enable_message_caching=True)
         self.budget_analyzer = EnhancedBudgetAnalyzer(self.console)
         self.account_resolver = None  # Will be initialized with management profile
@@ -107,7 +107,7 @@ class SingleAccountDashboard:
             int: Exit code (0 for success, 1 for failure)
         """
         try:
-            print_header("Single Account Service Dashboard", "1.1.1")
+            print_header("Single Account Service Dashboard", "latest version")
 
             # Configuration display (context-aware)
             top_services = getattr(args, "top_services", 10)
@@ -320,8 +320,8 @@ class SingleAccountDashboard:
                 else:
                     print_warning("MCP validation requested but not available - check MCP server configuration")
 
-            # Sprint 2 Enhancement: Display performance metrics for enterprise audit compliance
-            self._display_sprint2_performance_metrics()
+            # Phase 2 Enhancement: Display performance metrics for enterprise audit compliance
+            self._display_console_performance_metrics()
 
             return 0
 
@@ -1053,9 +1053,9 @@ class SingleAccountDashboard:
             self.console.print(f"[red]❌ Embedded MCP validation failed: {str(e)[:100]}[/]")
             self.console.print(f"[dim]Continuing with standard FinOps analysis[/]")
 
-    def _display_sprint2_performance_metrics(self) -> None:
+    def _display_console_performance_metrics(self) -> None:
         """
-        Display Sprint 2 performance metrics for enterprise audit compliance.
+        Display Phase 2 performance metrics for enterprise audit compliance.
 
         Shows:
         - Progress message caching efficiency (82% target)
@@ -1077,7 +1077,7 @@ class SingleAccountDashboard:
 • Total Operations: {audit_summary['total_operations']}
 • Audit Trail Length: {audit_summary['audit_trail_count']}
 
-[dim]Sprint 2 Achievements:[/dim]
+[dim]Phase 2 Achievements:[/dim]
 • Message caching system operational
 • Business context enhancement integrated
 • Enterprise audit trail generation active
@@ -1085,7 +1085,7 @@ class SingleAccountDashboard:
 
             metrics_panel = Panel(
                 metrics_content,
-                title="[bold cyan]📊 Sprint 2 Performance Metrics[/bold cyan]",
+                title="[bold cyan]📊 Phase 2 Performance Metrics[/bold cyan]",
                 border_style="cyan",
                 padding=(1, 2)
             )
@@ -1099,13 +1099,13 @@ class SingleAccountDashboard:
                 f"Session operations: {audit_summary['total_operations']}"
             )
             self.context_logger.info(
-                "Sprint 2 performance metrics displayed",
+                "Phase 2 performance metrics displayed",
                 technical_detail=metrics_details
             )
 
         except Exception as e:
             # Graceful degradation - don't fail the main dashboard
-            print_warning(f"Sprint 2 metrics display failed: {str(e)[:50]}")
+            print_warning(f"Phase 2 metrics display failed: {str(e)[:50]}")
 
 
 def create_single_dashboard(console: Optional[Console] = None) -> SingleAccountDashboard:

runbooks/finops/tests/test_finops_dashboard.py

@@ -45,9 +45,9 @@ class TestFinOpsConfig:
         config = FinOpsConfig()
 
         # Test default profile values
-        assert config.billing_profile == "ams-admin-Billing-ReadOnlyAccess-909135376185"
-        assert config.management_profile == "ams-admin-ReadOnlyAccess-909135376185"
-        assert config.operational_profile == "ams-centralised-ops-ReadOnlyAccess-335083429030"
+        assert config.billing_profile == "${BILLING_PROFILE}"
+        assert config.management_profile == "${MANAGEMENT_PROFILE}"
+        assert config.operational_profile == "${CENTRALISED_OPS_PROFILE}"
 
         # Test analysis parameters
         assert config.time_range_days == 30

runbooks/finops/tests/test_reference_images_validation.py

@@ -582,8 +582,8 @@ class TestReferenceImage5_ExportIntegration:
             "status": "completed",
             "available_profiles": ["profile1", "profile2"],
             "configured_profiles": {
-                "billing": "ams-admin-Billing-ReadOnlyAccess-909135376185",
-                "management": "ams-admin-ReadOnlyAccess-909135376185",
+                "billing": "${BILLING_PROFILE}",
+                "management": "${MANAGEMENT_PROFILE}",
             },
         }
 

runbooks/finops/tests/test_single_account_features.py

@@ -3,7 +3,7 @@
 Single Account FinOps Features Test Suite - Definition of Done Validation.
 
 This test suite validates the 5 key features for single account analysis
-using REAL AWS data for account 499201730520 (ams-shared-services-non-prod).
+using REAL AWS data for account ${ACCOUNT_ID} (ams-shared-services-non-prod).
 
 Purpose: Ensure comprehensive functionality validation against manager requirements.
 
@@ -16,7 +16,7 @@ Test Cases:
 
 Author: CloudOps Runbooks Team
 Version: 0.7.8 - Single Account Focus
-Target: Account 499201730520 (ams-shared-services-non-prod-ReadOnlyAccess)
+Target: Account ${ACCOUNT_ID} (ams-shared-services-non-prod-ReadOnlyAccess)
 """
 
 import json
@@ -30,9 +30,9 @@ import boto3
 import pytest
 
 # Set environment for single account testing
-os.environ["SINGLE_AWS_PROFILE"] = "ams-shared-services-non-prod-ReadOnlyAccess-499201730520"
+os.environ["SINGLE_AWS_PROFILE"] = "${SINGLE_AWS_PROFILE}"
 os.environ["AWS_PROFILE"] = os.environ["SINGLE_AWS_PROFILE"]
-os.environ["BILLING_PROFILE"] = "ams-admin-Billing-ReadOnlyAccess-909135376185"
+os.environ["BILLING_PROFILE"] = "${BILLING_PROFILE}"
 
 # Import FinOps components for testing
 from runbooks.finops.finops_dashboard import (
@@ -53,10 +53,10 @@ class SingleAccountFinOpsConfig(FinOpsConfig):
         super().__init__()
 
         # Override for single account operation
-        self.target_account = "ams-shared-services-non-prod-ReadOnlyAccess-499201730520"
+        self.target_account = "${SINGLE_AWS_PROFILE}"
 
         # Single account configuration
-        self.billing_profile = os.environ.get("BILLING_PROFILE", "ams-admin-Billing-ReadOnlyAccess-909135376185")
+        self.billing_profile = os.environ.get("BILLING_PROFILE", "${BILLING_PROFILE}")
         self.management_profile = self.target_account
         self.operational_profile = self.target_account
 
@@ -67,7 +67,7 @@ class SingleAccountFinOpsConfig(FinOpsConfig):
 
         # Single account specific settings
         self.single_account_mode = True
-        self.account_id = "499201730520"  # Extracted from profile name
+        self.account_id = "${ACCOUNT_ID}"  # Extracted from profile name
 
 
 class TestSingleAccountFeature1_CostTrendAnalysis:
@@ -75,7 +75,7 @@ class TestSingleAccountFeature1_CostTrendAnalysis:
     Feature 1: Single Account Cost Trend Analysis with Real AWS Data.
 
     Validates cost analysis functionality using real AWS Cost Explorer
-    for account 499201730520 with billing profile access.
+    for account ${ACCOUNT_ID} with billing profile access.
     """
 
     @pytest.fixture
@@ -211,7 +211,7 @@ class TestSingleAccountFeature2_ResourceUtilizationHeatmap:
     Feature 2: Single Account Resource Utilization Heatmap with Real AWS Data.
 
     Validates resource utilization analysis using real EC2, RDS, S3 data
-    for account 499201730520 with efficiency scoring and rightsizing.
+    for account ${ACCOUNT_ID} with efficiency scoring and rightsizing.
     """
 
     @pytest.fixture
@@ -374,7 +374,7 @@ class TestSingleAccountFeature3_ComplianceDashboard:
     Feature 3: Single Account Compliance Dashboard with Real AWS Config Data.
 
     Validates compliance audit functionality using real AWS Config
-    for account 499201730520 with risk assessment and findings.
+    for account ${ACCOUNT_ID} with risk assessment and findings.
     """
 
     @pytest.fixture
@@ -527,7 +527,7 @@ class TestSingleAccountFeature4_RightsizingRecommendations:
     Feature 4: Single Account Rightsizing Recommendations with Real CloudWatch Metrics.
 
     Validates rightsizing functionality using real CloudWatch data
-    for account 499201730520 with cost optimization recommendations.
+    for account ${ACCOUNT_ID} with cost optimization recommendations.
     """
 
     def test_rightsizing_with_real_metrics(self):
@@ -565,7 +565,7 @@ class TestSingleAccountFeature5_ExecutiveSummary:
     Feature 5: Single Account Executive Summary with Real Aggregated Data.
 
     Validates executive dashboard functionality combining all real data sources
-    for account 499201730520 with C-suite presentation format.
+    for account ${ACCOUNT_ID} with C-suite presentation format.
     """
 
     def test_executive_summary_with_real_data(self):
@@ -629,15 +629,15 @@ class TestSingleAccountNotebookIntegration:
     def test_notebook_environment_setup(self):
         """Test notebook environment is properly configured."""
         # Verify environment variables
-        assert os.environ.get("SINGLE_AWS_PROFILE") == "ams-shared-services-non-prod-ReadOnlyAccess-499201730520"
-        assert os.environ.get("BILLING_PROFILE") == "ams-admin-Billing-ReadOnlyAccess-909135376185"
+        assert os.environ.get("SINGLE_AWS_PROFILE") == "${SINGLE_AWS_PROFILE}"
+        assert os.environ.get("BILLING_PROFILE") == "${BILLING_PROFILE}"
 
         # Verify AWS connectivity
         try:
             session = boto3.Session(profile_name=os.environ["BILLING_PROFILE"])
             sts = session.client("sts")
             identity = sts.get_caller_identity()
-            assert identity["Account"] == "909135376185"  # Billing account
+            assert identity["Account"] == "${BILLING_ACCOUNT_ID}"  # Billing account
 
             print("✅ Notebook environment properly configured")
 
@@ -650,8 +650,8 @@ class TestSingleAccountNotebookIntegration:
 
         # Validate single account configuration
         assert config.single_account_mode is True
-        assert config.account_id == "499201730520"
-        assert config.target_account == "ams-shared-services-non-prod-ReadOnlyAccess-499201730520"
+        assert config.account_id == "${ACCOUNT_ID}"
+        assert config.target_account == "${SINGLE_AWS_PROFILE}"
         assert config.min_account_threshold == 1
         assert config.enable_cross_account is False
 

runbooks/finops/tests/validate_test_suite.py

@@ -64,7 +64,7 @@ def validate_functionality():
 
         config = FinOpsConfig()
 
-        assert config.billing_profile == "ams-admin-Billing-ReadOnlyAccess-909135376185"
+        assert config.billing_profile == "${BILLING_PROFILE}"
         assert config.dry_run is True
         assert config.target_savings_percent == 40
         print("✅ Configuration validation passed")

runbooks/finops/validation_framework.py

@@ -16,7 +16,7 @@ Key Features:
 - Quality gates enforcement for enterprise operations
 
 Author: Enterprise Agile Team (6-Agent Coordination)
-Version: 0.9.6 - Distributed Architecture Framework  
+Version: latest version - Distributed Architecture Framework  
 """
 
 import os
@@ -138,7 +138,7 @@ class MCPValidator:
         Strategic Focus: Ensure cost calculations meet ≥99.5% accuracy for 
         enterprise financial decision making.
         """
-        print_header("MCP Cost Validation", "Accuracy Framework v0.9.6")
+        print_header("MCP Cost Validation", "Accuracy Framework latest version")
         
         validation_start = time.time()
         validation_id = self._generate_validation_id("cost_analysis")
@@ -239,7 +239,7 @@ class MCPValidator:
         
         Focus: Ensure resource counts and attributes match AWS reality.
         """
-        print_header("MCP Resource Validation", "Discovery Framework v0.9.6")
+        print_header("MCP Resource Validation", "Discovery Framework latest version")
         
         validation_start = time.time()
         validation_id = self._generate_validation_id("resource_discovery")
@@ -310,7 +310,7 @@ class MCPValidator:
         
         Focus: Ensure recommendations are based on accurate current state analysis.
         """
-        print_header("MCP Optimization Validation", "Recommendations Framework v0.9.6")
+        print_header("MCP Optimization Validation", "Recommendations Framework latest version")
         
         validation_start = time.time()
         validation_id = self._generate_validation_id("optimization_recommendations")
@@ -734,7 +734,7 @@ def create_enterprise_validator(
 def main():
     """Demo MCP validation framework."""
     
-    print_header("MCP Validation Framework Demo", "v0.9.6")
+    print_header("MCP Validation Framework Demo", "latest version")
     
     # Create validator
     validator = create_enterprise_validator(accuracy_threshold=99.5)

runbooks/finops/vpc_cleanup_exporter.py

@@ -6,7 +6,7 @@ This module provides export functionality for VPC cleanup analysis results,
 leveraging the existing markdown_exporter infrastructure with VPC-specific formatting.
 
 Author: CloudOps Runbooks Team
-Version: 0.9.9
+Version: latest version
 """
 
 import csv
@@ -238,7 +238,7 @@ def _export_vpc_candidates_json(vpc_candidates: List[Any], output_dir: str) -> s
         "metadata": {
             "export_timestamp": datetime.now().isoformat(),
             "total_candidates": len(candidates_data),
-            "generator": "CloudOps Runbooks VPC Module v0.9.9"
+            "generator": "CloudOps Runbooks VPC Module latest version"
         },
         "vpc_candidates": candidates_data
     }
@@ -273,7 +273,7 @@ def _export_vpc_candidates_pdf(vpc_candidates: List[Any], output_dir: str) -> st
         summary_text = f"""
         <b>Generated:</b> {datetime.now().strftime('%Y-%m-%d %H:%M:%S UTC')}<br/>
         <b>Total VPC Candidates:</b> {len(vpc_candidates)}<br/>
-        <b>Analysis Source:</b> CloudOps Runbooks VPC Module v0.9.9
+        <b>Analysis Source:</b> CloudOps Runbooks VPC Module latest version
         """
         summary = Paragraph(summary_text, styles['Normal'])
         story.append(summary)

runbooks/finops/vpc_cleanup_optimizer.py

@@ -216,7 +216,7 @@ class VPCCleanupOptimizer:
         
         Returns: Comprehensive cleanup analysis with validated savings
         """
-        print_header("VPC Cleanup Cost Optimization Engine", "v0.9.9")
+        print_header("VPC Cleanup Cost Optimization Engine", "latest version")
         print_info("AWSO-05 Implementation - Three-Bucket Strategy")
         
         # Initialize MCP validator for accuracy validation
@@ -280,7 +280,7 @@ class VPCCleanupOptimizer:
             
         Returns: Aggregated VPC cleanup analysis across accessible accounts
         """
-        print_header("Multi-Account VPC Cleanup Analysis", "v0.9.9")
+        print_header("Multi-Account VPC Cleanup Analysis", "latest version")
         print_info(f"🏢 Analyzing VPCs across {len(account_ids)} organization accounts")
         print_info(f"🔐 Using profile: {self.profile} (scope: accessible accounts only)")
         

runbooks/finops/workspaces_analyzer.py

@@ -377,7 +377,7 @@ class WorkSpacesCostAnalyzer:
                 "analysis_timestamp": summary.analysis_timestamp,
                 "profile": self.profile,
                 "target_savings": self.target_annual_savings,
-                "version": "0.9.1"
+                "version": "latest version"
             }
         }
         

runbooks/hitl/enhanced_workflow_engine.py

@@ -3,7 +3,7 @@
 Enhanced HITL Workflow Engine for Human-in-the-Loop Optimization
 
 Issue #93: HITL System & DORA Metrics Optimization
-Priority: High (Sprint 1 Improvements)
+Priority: High (Phase 1 Improvements)
 Scope: Streamlined approval workflows with ±15% cross-validation accuracy
 """
 

runbooks/inventory/README.md

@@ -548,7 +548,7 @@ Usage Examples:
 
 ```bash
 # List all instances across all accounts and regions
-python list_ec2_instances.py --profile ams-admin-ReadOnlyAccess-909135376185
+python list_ec2_instances.py --profile ${MANAGEMENT_PROFILE}
 
 # List instances in specific regions
 python list_ec2_instances.py --profile my-profile --regions us-east-1,us-west-2
@@ -1230,10 +1230,10 @@ python update_cloudwatch_logs_retention_policy.py --profile my-profile --verbose
  
 ```bash
 # Configure AWS SSO
-aws configure sso --profile ams-admin-ReadOnlyAccess-909135376185
+aws configure sso --profile ${MANAGEMENT_PROFILE}
 
 # Verify credentials
-aws sts get-caller-identity --profile ams-admin-ReadOnlyAccess-909135376185
+aws sts get-caller-identity --profile ${MANAGEMENT_PROFILE}
 ```
 
 ### 2. Regional Operations