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

runbooks/vpc/tests/test_cleanup_framework.py

@@ -0,0 +1,1022 @@
+#!/usr/bin/env python3
+"""
+VPC Cleanup Framework - Comprehensive Test Suite
+==================================================
+
+Consolidates all VPC cleanup framework tests (104 tests from tests/vpc-cleanup/tests/).
+Tests config validation, query generation, attribution logic, CSV output, error handling, and multi-LZ reusability.
+
+Strategic Context: qa-testing-specialist validation for config-driven VPC cleanup framework
+"""
+
+import json
+import sys
+import tempfile
+from datetime import datetime, timedelta
+from decimal import Decimal
+from pathlib import Path
+from unittest.mock import MagicMock, Mock, patch
+
+import pytest
+import yaml
+
+# Ensure runbooks package is importable
+src_path = Path(__file__).parent.parent.parent.parent
+if str(src_path) not in sys.path:
+    sys.path.insert(0, str(src_path))
+
+from runbooks.vpc.vpc_cleanup_integration import VPCCleanupFramework
+
+
+# ========================================
+# Config Validation Tests (35 tests)
+# ========================================
+
+
+@pytest.mark.unit
+class TestConfigValidation:
+    """Test configuration validation logic"""
+
+    def test_valid_config_loads_successfully(self, cleanup_valid_config):
+        """Test AWS-25 reference config loads without errors"""
+        assert "campaign_metadata" in cleanup_valid_config
+        assert "deleted_vpcs" in cleanup_valid_config
+        assert "cost_explorer_config" in cleanup_valid_config
+
+    def test_minimal_valid_config_structure(self, cleanup_valid_config):
+        """Test minimal valid config has required structure"""
+        assert cleanup_valid_config["campaign_metadata"]["campaign_id"]
+        assert len(cleanup_valid_config["deleted_vpcs"]) > 0
+
+    def test_config_has_all_required_sections(self, cleanup_valid_config):
+        """Test config contains all required sections"""
+        required_sections = [
+            "campaign_metadata",
+            "deleted_vpcs",
+            "cost_explorer_config",
+            "attribution_rules",
+            "output_config",
+        ]
+        for section in required_sections:
+            assert section in cleanup_valid_config, f"Missing required section: {section}"
+
+    def test_campaign_metadata_validation(self, cleanup_valid_config):
+        """Test campaign_metadata section has required fields"""
+        metadata = cleanup_valid_config["campaign_metadata"]
+        required_fields = ["campaign_id", "campaign_name", "execution_date", "aws_billing_profile"]
+        for field in required_fields:
+            assert field in metadata, f"Missing required field in campaign_metadata: {field}"
+
+    def test_deleted_vpcs_validation(self, cleanup_valid_config):
+        """Test deleted_vpcs section structure"""
+        deleted_vpcs = cleanup_valid_config["deleted_vpcs"]
+        assert isinstance(deleted_vpcs, list)
+        assert len(deleted_vpcs) > 0
+
+        # Validate first VPC entry
+        vpc = deleted_vpcs[0]
+        required_vpc_fields = ["vpc_id", "account_id", "region", "deletion_date"]
+        for field in required_vpc_fields:
+            assert field in vpc, f"Missing required field in deleted_vpcs: {field}"
+
+    def test_vpc_id_format_validation(self, cleanup_valid_config):
+        """Test VPC ID follows AWS format (vpc-*)"""
+        for vpc in cleanup_valid_config["deleted_vpcs"]:
+            vpc_id = vpc["vpc_id"]
+            assert vpc_id.startswith("vpc-"), f"Invalid VPC ID format: {vpc_id}"
+            assert len(vpc_id) >= 8, f"VPC ID too short: {vpc_id}"
+
+    def test_account_id_format_validation(self, cleanup_valid_config):
+        """Test account ID is 12-digit numeric string"""
+        for vpc in cleanup_valid_config["deleted_vpcs"]:
+            account_id = vpc["account_id"]
+            assert len(account_id) == 12, f"Account ID must be 12 digits: {account_id}"
+            assert account_id.isdigit(), f"Account ID must be numeric: {account_id}"
+
+    def test_deletion_date_format_validation(self, cleanup_valid_config):
+        """Test deletion_date follows YYYY-MM-DD format"""
+        for vpc in cleanup_valid_config["deleted_vpcs"]:
+            deletion_date = vpc["deletion_date"]
+            # Validate format by parsing
+            datetime.strptime(deletion_date, "%Y-%m-%d")
+
+    def test_region_validation(self, cleanup_valid_config):
+        """Test region follows AWS region format"""
+        valid_regions = [
+            "us-east-1",
+            "us-west-2",
+            "eu-west-1",
+            "ap-southeast-2",
+            "ap-southeast-1",
+            "us-east-2",
+            "eu-central-1",
+        ]
+        for vpc in cleanup_valid_config["deleted_vpcs"]:
+            region = vpc["region"]
+            # Check format: xx-xxxx-N
+            parts = region.split("-")
+            assert len(parts) == 3, f"Invalid region format: {region}"
+            assert parts[-1].isdigit(), f"Region must end with digit: {region}"
+
+    def test_cost_explorer_config_validation(self, cleanup_valid_config):
+        """Test cost_explorer_config section structure"""
+        ce_config = cleanup_valid_config["cost_explorer_config"]
+        assert "metrics" in ce_config
+        assert "group_by_dimensions" in ce_config
+        assert isinstance(ce_config["metrics"], list)
+
+    def test_attribution_rules_validation(self, cleanup_valid_config):
+        """Test attribution_rules section structure"""
+        rules = cleanup_valid_config["attribution_rules"]
+        assert "vpc_specific_services" in rules
+        assert "confidence_level" in rules["vpc_specific_services"]
+        assert "attribution_percentage" in rules["vpc_specific_services"]
+
+    def test_output_config_validation(self, cleanup_valid_config):
+        """Test output_config section structure"""
+        output_config = cleanup_valid_config["output_config"]
+        required_fields = ["csv_output_file", "csv_columns", "json_results_file"]
+        for field in required_fields:
+            assert field in output_config, f"Missing field in output_config: {field}"
+
+    def test_config_with_missing_section_raises_error(self):
+        """Test config with missing required section raises error"""
+        invalid_config = {"campaign_metadata": {"campaign_id": "TEST"}}
+
+        with pytest.raises(KeyError):
+            # Try to access missing section
+            _ = invalid_config["deleted_vpcs"]
+
+    def test_config_with_invalid_vpc_id_format(self):
+        """Test config with invalid VPC ID format"""
+        config_with_bad_vpc = {
+            "deleted_vpcs": [
+                {
+                    "vpc_id": "invalid-vpc-id",  # Should start with vpc-
+                    "account_id": "123456789012",
+                    "region": "us-east-1",
+                    "deletion_date": "2025-09-10",
+                }
+            ]
+        }
+
+        vpc_id = config_with_bad_vpc["deleted_vpcs"][0]["vpc_id"]
+        assert not vpc_id.startswith("vpc-"), "Should detect invalid VPC ID format"
+
+    def test_config_with_invalid_account_id(self):
+        """Test config with invalid account ID"""
+        config_with_bad_account = {
+            "deleted_vpcs": [
+                {
+                    "vpc_id": "vpc-test123",
+                    "account_id": "invalid-account",  # Should be 12 digits
+                    "region": "us-east-1",
+                    "deletion_date": "2025-09-10",
+                }
+            ]
+        }
+
+        account_id = config_with_bad_account["deleted_vpcs"][0]["account_id"]
+        assert not account_id.isdigit(), "Should detect invalid account ID"
+
+    def test_config_with_invalid_date_format(self):
+        """Test config with invalid date format raises error"""
+        invalid_date = "09/10/2025"  # Should be YYYY-MM-DD
+
+        with pytest.raises(ValueError):
+            datetime.strptime(invalid_date, "%Y-%m-%d")
+
+    def test_load_nonexistent_config_file_raises_error(self):
+        """Test loading non-existent config file raises FileNotFoundError"""
+        with pytest.raises(FileNotFoundError):
+            with open("/nonexistent/path/config.yaml") as f:
+                yaml.safe_load(f)
+
+    def test_malformed_yaml_raises_error(self):
+        """Test malformed YAML syntax raises error"""
+        with tempfile.NamedTemporaryFile(mode="w", suffix=".yaml", delete=False) as f:
+            # Write invalid YAML
+            f.write("invalid: yaml: syntax:\n  - broken\n  bad_indent")
+            temp_path = f.name
+
+        try:
+            with pytest.raises(yaml.YAMLError):
+                with open(temp_path) as f:
+                    yaml.safe_load(f)
+        finally:
+            Path(temp_path).unlink(missing_ok=True)
+
+    def test_multiple_vpcs_validation(self, cleanup_sample_vpc_deletions):
+        """Test validation of multiple VPC deletions"""
+        assert len(cleanup_sample_vpc_deletions) == 3
+        for vpc in cleanup_sample_vpc_deletions:
+            assert vpc["vpc_id"].startswith("vpc-")
+            assert len(vpc["account_id"]) == 12
+
+    def test_vpc_deletion_required_fields(self, cleanup_sample_vpc_deletion):
+        """Test VPC deletion has all required fields"""
+        required_fields = ["vpc_id", "account_id", "region", "deletion_date", "deletion_principal"]
+        for field in required_fields:
+            assert field in cleanup_sample_vpc_deletion
+
+    def test_pre_deletion_baseline_months_validation(self, cleanup_sample_vpc_deletion):
+        """Test pre_deletion_baseline_months is valid integer"""
+        baseline_months = cleanup_sample_vpc_deletion.get("pre_deletion_baseline_months", 3)
+        assert isinstance(baseline_months, int)
+        assert baseline_months > 0
+        assert baseline_months <= 12, "Baseline should not exceed 12 months"
+
+    def test_deletion_principal_format(self, cleanup_sample_vpc_deletion):
+        """Test deletion_principal follows email format"""
+        principal = cleanup_sample_vpc_deletion.get("deletion_principal", "")
+        assert "@" in principal, "Deletion principal should be email format"
+        assert "." in principal, "Deletion principal should have domain"
+
+    def test_cost_explorer_metrics_validation(self, cleanup_valid_config):
+        """Test Cost Explorer metrics are valid"""
+        metrics = cleanup_valid_config["cost_explorer_config"]["metrics"]
+        valid_metrics = ["UnblendedCost", "BlendedCost", "UsageQuantity"]
+        for metric in metrics:
+            assert metric in valid_metrics, f"Invalid metric: {metric}"
+
+    def test_cost_explorer_granularity_validation(self, cleanup_valid_config):
+        """Test Cost Explorer granularity settings"""
+        ce_config = cleanup_valid_config["cost_explorer_config"]
+        if "pre_deletion_baseline" in ce_config:
+            baseline = ce_config["pre_deletion_baseline"]
+            assert "granularity_monthly" in baseline or "months_before_deletion" in baseline
+
+    def test_attribution_percentage_validation(self, cleanup_valid_config):
+        """Test attribution percentages are valid (0-100)"""
+        rules = cleanup_valid_config["attribution_rules"]
+        for rule_name, rule_config in rules.items():
+            if "attribution_percentage" in rule_config:
+                percentage = rule_config["attribution_percentage"]
+                assert 0 <= percentage <= 100, f"Invalid attribution percentage: {percentage}"
+
+    def test_service_patterns_validation(self, cleanup_valid_config):
+        """Test service patterns are defined"""
+        rules = cleanup_valid_config["attribution_rules"]
+        for rule_name, rule_config in rules.items():
+            if "service_patterns" in rule_config:
+                patterns = rule_config["service_patterns"]
+                assert isinstance(patterns, list)
+                assert len(patterns) > 0
+
+    def test_csv_columns_validation(self, cleanup_valid_config):
+        """Test CSV columns are defined"""
+        output_config = cleanup_valid_config["output_config"]
+        columns = output_config.get("csv_columns", [])
+        assert isinstance(columns, list)
+        assert len(columns) > 0
+
+    def test_output_file_paths_validation(self, cleanup_valid_config):
+        """Test output file paths are defined"""
+        output_config = cleanup_valid_config["output_config"]
+        assert output_config.get("csv_output_file", "").endswith(".csv")
+        assert output_config.get("json_results_file", "").endswith(".json")
+
+    def test_campaign_id_format(self, cleanup_valid_config):
+        """Test campaign_id follows expected format"""
+        campaign_id = cleanup_valid_config["campaign_metadata"]["campaign_id"]
+        assert len(campaign_id) > 0
+        # Should be alphanumeric with hyphens
+        assert all(c.isalnum() or c == "-" for c in campaign_id)
+
+    def test_execution_date_validation(self, cleanup_valid_config):
+        """Test execution_date is valid date format"""
+        execution_date = cleanup_valid_config["campaign_metadata"]["execution_date"]
+        # Should parse as valid date
+        datetime.strptime(execution_date, "%Y-%m-%d")
+
+    def test_aws_billing_profile_validation(self, cleanup_valid_config):
+        """Test aws_billing_profile is defined"""
+        billing_profile = cleanup_valid_config["campaign_metadata"]["aws_billing_profile"]
+        assert len(billing_profile) > 0
+        assert isinstance(billing_profile, str)
+
+    def test_config_yaml_serialization(self, cleanup_valid_config):
+        """Test config can be serialized to YAML"""
+        yaml_str = yaml.dump(cleanup_valid_config)
+        assert len(yaml_str) > 0
+
+        # Should be able to deserialize back
+        reloaded = yaml.safe_load(yaml_str)
+        assert reloaded["campaign_metadata"] == cleanup_valid_config["campaign_metadata"]
+
+    def test_config_json_serialization(self, cleanup_valid_config):
+        """Test config can be serialized to JSON"""
+        json_str = json.dumps(cleanup_valid_config, default=str)
+        assert len(json_str) > 0
+
+        # Should be able to deserialize back
+        reloaded = json.loads(json_str)
+        assert reloaded["campaign_metadata"]["campaign_id"] == cleanup_valid_config["campaign_metadata"]["campaign_id"]
+
+
+# ========================================
+# Query Generation Tests (21 tests)
+# ========================================
+
+
+@pytest.mark.unit
+class TestQueryGeneration:
+    """Test Cost Explorer query generation logic"""
+
+    def test_pre_deletion_baseline_query_generation(self, cleanup_sample_vpc_deletion):
+        """Test generation of pre-deletion baseline query"""
+        vpc = cleanup_sample_vpc_deletion
+        deletion_date = datetime.strptime(vpc["deletion_date"], "%Y-%m-%d")
+        baseline_months = vpc.get("pre_deletion_baseline_months", 3)
+
+        # Calculate expected start date
+        start_date = deletion_date - timedelta(days=baseline_months * 30)
+
+        assert start_date < deletion_date
+        assert (deletion_date - start_date).days >= baseline_months * 30
+
+    def test_post_deletion_validation_query_generation(self, cleanup_sample_vpc_deletion):
+        """Test generation of post-deletion validation query"""
+        vpc = cleanup_sample_vpc_deletion
+        deletion_date = datetime.strptime(vpc["deletion_date"], "%Y-%m-%d")
+        validation_days = 30
+
+        # Calculate expected end date
+        end_date = deletion_date + timedelta(days=validation_days)
+
+        assert end_date > deletion_date
+        assert (end_date - deletion_date).days == validation_days
+
+    def test_daily_granularity_query(self, cleanup_valid_config):
+        """Test daily granularity query generation"""
+        ce_config = cleanup_valid_config["cost_explorer_config"]
+        if "pre_deletion_detailed" in ce_config:
+            detailed = ce_config["pre_deletion_detailed"]
+            assert detailed.get("granularity_daily") == "DAILY"
+
+    def test_monthly_granularity_query(self, cleanup_valid_config):
+        """Test monthly granularity query generation"""
+        ce_config = cleanup_valid_config["cost_explorer_config"]
+        if "pre_deletion_baseline" in ce_config:
+            baseline = ce_config["pre_deletion_baseline"]
+            assert baseline.get("granularity_monthly") == "MONTHLY"
+
+    def test_metrics_query_parameter(self, cleanup_valid_config):
+        """Test metrics query parameter generation"""
+        metrics = cleanup_valid_config["cost_explorer_config"]["metrics"]
+        assert isinstance(metrics, list)
+        assert len(metrics) > 0
+
+    def test_group_by_dimensions_query_parameter(self, cleanup_valid_config):
+        """Test group_by dimensions query parameter"""
+        dimensions = cleanup_valid_config["cost_explorer_config"]["group_by_dimensions"]
+        assert isinstance(dimensions, list)
+        # Should include SERVICE for attribution
+        assert "SERVICE" in dimensions or len(dimensions) == 0
+
+    def test_filter_by_account_query_generation(self, cleanup_sample_vpc_deletion):
+        """Test query filter by account ID"""
+        account_id = cleanup_sample_vpc_deletion["account_id"]
+        # Filter should include account ID
+        filter_expression = {"Dimensions": {"Key": "LINKED_ACCOUNT", "Values": [account_id]}}
+        assert filter_expression["Dimensions"]["Values"][0] == account_id
+
+    def test_filter_by_region_query_generation(self, cleanup_sample_vpc_deletion):
+        """Test query filter by region"""
+        region = cleanup_sample_vpc_deletion["region"]
+        # Filter should include region
+        filter_expression = {"Dimensions": {"Key": "REGION", "Values": [region]}}
+        assert filter_expression["Dimensions"]["Values"][0] == region
+
+    def test_time_period_calculation(self, cleanup_sample_vpc_deletion):
+        """Test time period calculation for queries"""
+        deletion_date = datetime.strptime(cleanup_sample_vpc_deletion["deletion_date"], "%Y-%m-%d")
+        baseline_months = 3
+
+        start_date = deletion_date - timedelta(days=baseline_months * 30)
+        end_date = deletion_date
+
+        # Format as YYYY-MM-DD
+        start_str = start_date.strftime("%Y-%m-%d")
+        end_str = end_date.strftime("%Y-%m-%d")
+
+        assert start_str < end_str
+        assert len(start_str) == 10
+        assert len(end_str) == 10
+
+    def test_multi_vpc_query_generation(self, cleanup_sample_vpc_deletions):
+        """Test query generation for multiple VPCs"""
+        account_ids = [vpc["account_id"] for vpc in cleanup_sample_vpc_deletions]
+        assert len(account_ids) == 3
+        assert len(set(account_ids)) >= 1  # May have duplicate accounts
+
+    def test_cross_region_query_generation(self, cleanup_sample_vpc_deletions):
+        """Test query generation across regions"""
+        regions = [vpc["region"] for vpc in cleanup_sample_vpc_deletions]
+        assert len(regions) == 3
+        # Should have multiple regions for multi-LZ
+        assert len(set(regions)) >= 2
+
+    def test_service_filter_query_generation(self, cleanup_valid_config):
+        """Test service filter for VPC-specific costs"""
+        rules = cleanup_valid_config["attribution_rules"]
+        vpc_services = rules["vpc_specific_services"]["service_patterns"]
+        assert len(vpc_services) > 0
+
+    def test_detailed_daily_query_range(self, cleanup_valid_config):
+        """Test detailed daily query range calculation"""
+        ce_config = cleanup_valid_config["cost_explorer_config"]
+        if "pre_deletion_detailed" in ce_config:
+            days_before = ce_config["pre_deletion_detailed"].get("days_before_deletion", 10)
+            assert days_before > 0
+            assert days_before <= 30
+
+    def test_baseline_monthly_query_range(self, cleanup_valid_config):
+        """Test baseline monthly query range calculation"""
+        ce_config = cleanup_valid_config["cost_explorer_config"]
+        if "pre_deletion_baseline" in ce_config:
+            months_before = ce_config["pre_deletion_baseline"].get("months_before_deletion", 3)
+            assert months_before > 0
+            assert months_before <= 12
+
+    def test_post_deletion_validation_range(self, cleanup_valid_config):
+        """Test post-deletion validation range calculation"""
+        ce_config = cleanup_valid_config["cost_explorer_config"]
+        if "post_deletion_validation" in ce_config:
+            days_after = ce_config["post_deletion_validation"].get("days_after_deletion", 30)
+            assert days_after > 0
+            assert days_after <= 90
+
+    def test_query_date_boundaries(self, cleanup_sample_vpc_deletion):
+        """Test query date boundaries don't overlap"""
+        deletion_date = datetime.strptime(cleanup_sample_vpc_deletion["deletion_date"], "%Y-%m-%d")
+
+        # Pre-deletion should end before deletion
+        pre_end = deletion_date - timedelta(days=1)
+        assert pre_end < deletion_date
+
+        # Post-deletion should start on or after deletion
+        post_start = deletion_date
+        assert post_start >= deletion_date
+
+    def test_query_pagination_support(self):
+        """Test query should support pagination if needed"""
+        # Cost Explorer API returns NextPageToken if more results
+        # Query logic should handle pagination
+        next_token = "test-token-123"
+        assert len(next_token) > 0
+
+    def test_query_error_handling_invalid_dates(self):
+        """Test query error handling for invalid date ranges"""
+        start_date = datetime(2025, 9, 10)
+        end_date = datetime(2025, 9, 1)  # End before start
+
+        with pytest.raises(AssertionError):
+            assert start_date < end_date, "Start date must be before end date"
+
+    def test_query_multiple_metrics(self, cleanup_valid_config):
+        """Test query with multiple metrics"""
+        metrics = cleanup_valid_config["cost_explorer_config"]["metrics"]
+        if len(metrics) > 1:
+            assert "UnblendedCost" in metrics or "BlendedCost" in metrics
+
+    def test_query_optimization_for_large_accounts(self, cleanup_sample_vpc_deletions):
+        """Test query optimization strategies for large accounts"""
+        # For large accounts, queries should be batched by month or region
+        vpcs_by_account = {}
+        for vpc in cleanup_sample_vpc_deletions:
+            account = vpc["account_id"]
+            if account not in vpcs_by_account:
+                vpcs_by_account[account] = []
+            vpcs_by_account[account].append(vpc)
+
+        # Should support batching
+        assert len(vpcs_by_account) > 0
+
+    def test_query_result_caching_strategy(self):
+        """Test query result should support caching to avoid duplicate API calls"""
+        # Mock cache key generation
+        cache_key = "account_123456789012_us-east-1_2025-06-01_2025-09-01"
+        assert len(cache_key) > 0
+        assert "account" in cache_key
+
+
+# ========================================
+# Attribution Logic Tests (19 tests)
+# ========================================
+
+
+@pytest.mark.unit
+class TestAttributionLogic:
+    """Test cost attribution methodology"""
+
+    def test_vpc_specific_services_attribution(self, cleanup_valid_config):
+        """Test 100% attribution for VPC-specific services"""
+        rules = cleanup_valid_config["attribution_rules"]
+        vpc_specific = rules["vpc_specific_services"]
+        assert vpc_specific["attribution_percentage"] == 100
+        assert vpc_specific["confidence_level"] == "HIGH (95%)"
+
+    def test_vpc_related_services_attribution(self, cleanup_valid_config):
+        """Test partial attribution for VPC-related services"""
+        rules = cleanup_valid_config["attribution_rules"]
+        vpc_related = rules["vpc_related_services"]
+        assert 0 < vpc_related["attribution_percentage"] < 100
+        assert "MEDIUM" in vpc_related["confidence_level"]
+
+    def test_other_services_attribution(self, cleanup_valid_config):
+        """Test low attribution for other services"""
+        rules = cleanup_valid_config["attribution_rules"]
+        other_services = rules["other_services"]
+        assert other_services["attribution_percentage"] <= 50
+        assert "LOW" in other_services["confidence_level"]
+
+    def test_service_pattern_matching(self, cleanup_valid_config):
+        """Test service pattern matching logic"""
+        rules = cleanup_valid_config["attribution_rules"]
+        vpc_patterns = rules["vpc_specific_services"]["service_patterns"]
+
+        # Check for VPC service pattern
+        assert any("Virtual Private Cloud" in pattern for pattern in vpc_patterns)
+
+    def test_attribution_percentage_calculation(self, cleanup_mock_cost_explorer):
+        """Test attribution percentage calculation"""
+        # Mock cost data
+        vpc_cost = Decimal("100.00")
+        ec2_cost = Decimal("500.00")
+
+        # VPC-specific: 100% attribution
+        vpc_attributed = vpc_cost * Decimal("1.0")
+        assert vpc_attributed == Decimal("100.00")
+
+        # EC2 (VPC-related): 70% attribution
+        ec2_attributed = ec2_cost * Decimal("0.7")
+        assert ec2_attributed == Decimal("350.00")
+
+    def test_confidence_level_assignment(self, cleanup_valid_config):
+        """Test confidence level assignment based on service type"""
+        rules = cleanup_valid_config["attribution_rules"]
+
+        # High confidence for VPC-specific
+        assert "95%" in rules["vpc_specific_services"]["confidence_level"]
+
+        # Medium confidence for VPC-related
+        assert "85%" in rules["vpc_related_services"]["confidence_level"]
+
+    def test_wildcard_pattern_handling(self, cleanup_valid_config):
+        """Test wildcard pattern handling for other services"""
+        rules = cleanup_valid_config["attribution_rules"]
+        other_patterns = rules["other_services"]["service_patterns"]
+
+        # Should have wildcard for catch-all
+        assert "*" in other_patterns
+
+    def test_multi_service_attribution(self):
+        """Test attribution across multiple services"""
+        service_costs = {
+            "Amazon Virtual Private Cloud": Decimal("100.00"),
+            "Amazon Elastic Compute Cloud - Compute": Decimal("500.00"),
+            "Amazon S3": Decimal("200.00"),
+        }
+
+        # Apply attribution rules
+        attributed_costs = {
+            "Amazon Virtual Private Cloud": service_costs["Amazon Virtual Private Cloud"] * Decimal("1.0"),  # 100%
+            "Amazon Elastic Compute Cloud - Compute": service_costs["Amazon Elastic Compute Cloud - Compute"]
+            * Decimal("0.7"),  # 70%
+            "Amazon S3": service_costs["Amazon S3"] * Decimal("0.3"),  # 30%
+        }
+
+        total_attributed = sum(attributed_costs.values())
+        assert total_attributed > 0
+
+    def test_regional_cost_attribution(self, cleanup_sample_vpc_deletions):
+        """Test attribution per region"""
+        regions = {vpc["region"] for vpc in cleanup_sample_vpc_deletions}
+        assert len(regions) >= 2
+
+        # Each region should have independent attribution
+        for region in regions:
+            regional_vpcs = [vpc for vpc in cleanup_sample_vpc_deletions if vpc["region"] == region]
+            assert len(regional_vpcs) > 0
+
+    def test_account_level_attribution(self, cleanup_sample_vpc_deletions):
+        """Test attribution per account"""
+        accounts = {vpc["account_id"] for vpc in cleanup_sample_vpc_deletions}
+        assert len(accounts) >= 1
+
+        # Each account should have independent attribution
+        for account in accounts:
+            account_vpcs = [vpc for vpc in cleanup_sample_vpc_deletions if vpc["account_id"] == account]
+            assert len(account_vpcs) > 0
+
+    def test_time_based_attribution(self, cleanup_sample_vpc_deletion):
+        """Test time-based attribution before and after deletion"""
+        deletion_date = datetime.strptime(cleanup_sample_vpc_deletion["deletion_date"], "%Y-%m-%d")
+
+        # Pre-deletion period should have higher costs
+        pre_deletion_cost = Decimal("500.00")
+
+        # Post-deletion period should have lower costs
+        post_deletion_cost = Decimal("50.00")
+
+        # Savings calculation
+        savings = pre_deletion_cost - post_deletion_cost
+        assert savings > 0
+
+    def test_service_name_normalization(self):
+        """Test service name normalization for matching"""
+        service_names = [
+            "Amazon Virtual Private Cloud",
+            "Amazon Elastic Compute Cloud - Compute",
+            "AWS PrivateLink",
+            "Elastic Load Balancing",
+        ]
+
+        # All should be matchable
+        for name in service_names:
+            assert len(name) > 0
+            assert isinstance(name, str)
+
+    def test_attribution_rule_precedence(self, cleanup_valid_config):
+        """Test attribution rule precedence (specific before general)"""
+        rules = cleanup_valid_config["attribution_rules"]
+
+        # VPC-specific should be checked first
+        vpc_specific = rules["vpc_specific_services"]
+        assert vpc_specific["attribution_percentage"] == 100
+
+        # Other services should be last (lowest percentage)
+        other = rules["other_services"]
+        assert other["attribution_percentage"] <= vpc_specific["attribution_percentage"]
+
+    def test_zero_cost_handling(self):
+        """Test attribution handling when cost is zero"""
+        zero_cost = Decimal("0.00")
+        attribution_percentage = Decimal("0.7")
+
+        attributed = zero_cost * attribution_percentage
+        assert attributed == Decimal("0.00")
+
+    def test_negative_cost_handling(self):
+        """Test attribution handling for credits/refunds (negative costs)"""
+        credit = Decimal("-50.00")  # AWS credit
+        attribution_percentage = Decimal("0.7")
+
+        attributed = credit * attribution_percentage
+        assert attributed == Decimal("-35.00")
+
+    def test_rounding_precision(self):
+        """Test cost attribution maintains precision"""
+        cost = Decimal("100.123456")
+        attribution = Decimal("0.7")
+
+        attributed = cost * attribution
+        # Should maintain precision
+        assert attributed == Decimal("70.086419200000000000")
+
+    def test_monthly_averaging_attribution(self):
+        """Test monthly averaging for baseline calculation"""
+        monthly_costs = [Decimal("100.00"), Decimal("105.00"), Decimal("110.00")]
+
+        average = sum(monthly_costs) / len(monthly_costs)
+        assert average == Decimal("105.00")
+
+    def test_daily_granular_attribution(self):
+        """Test daily granular attribution for detailed period"""
+        daily_costs = [Decimal("15.00")] * 10  # 10 days
+
+        total = sum(daily_costs)
+        assert total == Decimal("150.00")
+
+        # Daily average
+        daily_avg = total / len(daily_costs)
+        assert daily_avg == Decimal("15.00")
+
+    def test_attribution_confidence_weighting(self):
+        """Test confidence weighting in final attribution"""
+        # High confidence (95%) = low adjustment
+        high_conf_cost = Decimal("100.00")
+        high_conf_weight = Decimal("0.95")
+
+        # Medium confidence (85%) = moderate adjustment
+        medium_conf_cost = Decimal("500.00")
+        medium_conf_weight = Decimal("0.85")
+
+        # Weighted costs
+        weighted_high = high_conf_cost * high_conf_weight
+        weighted_medium = medium_conf_cost * medium_conf_weight
+
+        assert weighted_high < high_conf_cost
+        assert weighted_medium < medium_conf_cost
+
+
+# ========================================
+# CSV Output Tests (11 tests)
+# ========================================
+
+
+@pytest.mark.unit
+class TestCSVOutput:
+    """Test CSV output generation and formatting"""
+
+    def test_csv_column_headers(self, cleanup_valid_config):
+        """Test CSV column headers are defined"""
+        columns = cleanup_valid_config["output_config"]["csv_columns"]
+        assert "VPC_ID" in columns
+        assert "Account_ID" in columns
+        assert "Deletion_Date" in columns
+
+    def test_csv_file_path_generation(self, cleanup_valid_config):
+        """Test CSV file path generation"""
+        csv_file = cleanup_valid_config["output_config"]["csv_output_file"]
+        assert csv_file.endswith(".csv")
+        assert len(csv_file) > 4
+
+    def test_csv_row_generation(self, cleanup_sample_vpc_deletion):
+        """Test CSV row generation from VPC deletion data"""
+        row = [
+            cleanup_sample_vpc_deletion["vpc_id"],
+            cleanup_sample_vpc_deletion["account_id"],
+            cleanup_sample_vpc_deletion["region"],
+            cleanup_sample_vpc_deletion["deletion_date"],
+        ]
+
+        assert len(row) == 4
+        assert row[0].startswith("vpc-")
+
+    def test_csv_multiple_rows(self, cleanup_sample_vpc_deletions):
+        """Test CSV generation with multiple VPC deletions"""
+        rows = []
+        for vpc in cleanup_sample_vpc_deletions:
+            row = [vpc["vpc_id"], vpc["account_id"], vpc["region"], vpc["deletion_date"]]
+            rows.append(row)
+
+        assert len(rows) == 3
+
+    def test_csv_numeric_formatting(self):
+        """Test CSV numeric value formatting"""
+        monthly_savings = Decimal("1234.56")
+        annual_savings = monthly_savings * 12
+
+        # Format to 2 decimal places
+        monthly_str = f"{monthly_savings:.2f}"
+        annual_str = f"{annual_savings:.2f}"
+
+        assert monthly_str == "1234.56"
+        assert annual_str == "14814.72"
+
+    def test_csv_date_formatting(self, cleanup_sample_vpc_deletion):
+        """Test CSV date formatting consistency"""
+        deletion_date = cleanup_sample_vpc_deletion["deletion_date"]
+
+        # Should be YYYY-MM-DD format
+        datetime.strptime(deletion_date, "%Y-%m-%d")
+
+    def test_csv_special_character_handling(self):
+        """Test CSV special character escaping"""
+        # Values with commas should be quoted
+        value_with_comma = "VPC,with,commas"
+        escaped = f'"{value_with_comma}"'
+
+        assert escaped.startswith('"')
+        assert escaped.endswith('"')
+
+    def test_csv_null_value_handling(self):
+        """Test CSV null value representation"""
+        null_value = None
+        csv_representation = "" if null_value is None else str(null_value)
+
+        assert csv_representation == ""
+
+    def test_csv_column_order(self, cleanup_valid_config):
+        """Test CSV column order is consistent"""
+        columns = cleanup_valid_config["output_config"]["csv_columns"]
+
+        # VPC_ID should be first
+        assert columns[0] == "VPC_ID"
+
+        # Account_ID should be second
+        assert columns[1] == "Account_ID"
+
+    def test_csv_data_quality_indicators(self):
+        """Test CSV includes data quality indicators"""
+        data_quality = "HIGH"
+        confidence_level = "95%"
+
+        assert data_quality in ["HIGH", "MEDIUM", "LOW"]
+        assert "%" in confidence_level
+
+    def test_csv_output_validation(self):
+        """Test CSV output can be parsed back"""
+        import csv
+        import io
+
+        # Create sample CSV data
+        csv_data = "VPC_ID,Account_ID,Region,Deletion_Date\nvpc-123,123456789012,us-east-1,2025-09-10\n"
+
+        # Parse it
+        reader = csv.DictReader(io.StringIO(csv_data))
+        rows = list(reader)
+
+        assert len(rows) == 1
+        assert rows[0]["VPC_ID"] == "vpc-123"
+
+
+# ========================================
+# Error Handling Tests (15 tests)
+# ========================================
+
+
+@pytest.mark.unit
+class TestErrorHandling:
+    """Test error handling and edge cases"""
+
+    def test_missing_config_file_error(self):
+        """Test error handling for missing config file"""
+        with pytest.raises(FileNotFoundError):
+            with open("/nonexistent/config.yaml") as f:
+                yaml.safe_load(f)
+
+    def test_invalid_yaml_syntax_error(self):
+        """Test error handling for invalid YAML syntax"""
+        invalid_yaml = "invalid: yaml: [\n  not closed"
+
+        with pytest.raises(yaml.YAMLError):
+            yaml.safe_load(invalid_yaml)
+
+    def test_missing_required_field_error(self):
+        """Test error handling for missing required fields"""
+        incomplete_config = {"campaign_metadata": {"campaign_id": "TEST"}}
+
+        with pytest.raises(KeyError):
+            _ = incomplete_config["deleted_vpcs"]
+
+    def test_invalid_date_format_error(self):
+        """Test error handling for invalid date format"""
+        invalid_date = "2025/09/10"  # Should be YYYY-MM-DD
+
+        with pytest.raises(ValueError):
+            datetime.strptime(invalid_date, "%Y-%m-%d")
+
+    def test_cost_explorer_api_error_handling(self, cleanup_mock_cost_explorer):
+        """Test error handling for Cost Explorer API failures"""
+        # Mock API error
+        cleanup_mock_cost_explorer.get_cost_and_usage.side_effect = Exception("API Error")
+
+        with pytest.raises(Exception):
+            cleanup_mock_cost_explorer.get_cost_and_usage()
+
+    def test_invalid_vpc_id_error(self):
+        """Test error handling for invalid VPC ID format"""
+        invalid_vpc_id = "invalid-id"
+        assert not invalid_vpc_id.startswith("vpc-")
+
+    def test_invalid_account_id_error(self):
+        """Test error handling for invalid account ID"""
+        invalid_account = "not-numeric"
+        assert not invalid_account.isdigit()
+
+    def test_future_deletion_date_warning(self):
+        """Test warning for future deletion dates"""
+        future_date = datetime.now() + timedelta(days=30)
+        current_date = datetime.now()
+
+        is_future = future_date > current_date
+        assert is_future, "Should detect future deletion date"
+
+    def test_zero_baseline_months_error(self):
+        """Test error handling for zero baseline months"""
+        baseline_months = 0
+        with pytest.raises(AssertionError):
+            assert baseline_months > 0, "Baseline months must be positive"
+
+    def test_negative_cost_validation(self):
+        """Test validation for negative costs (credits)"""
+        cost = Decimal("-100.00")
+        # Negative costs are valid (credits/refunds)
+        assert cost < 0
+
+    def test_division_by_zero_protection(self):
+        """Test protection against division by zero"""
+        total_cost = Decimal("0.00")
+        num_months = 3
+
+        # Should handle zero cost gracefully
+        average = total_cost / num_months if num_months > 0 else Decimal("0.00")
+        assert average == Decimal("0.00")
+
+    def test_empty_cost_data_handling(self):
+        """Test handling of empty cost data"""
+        cost_data = []
+        assert len(cost_data) == 0
+
+        # Should handle empty data gracefully
+        total = sum(cost_data) if cost_data else Decimal("0.00")
+        assert total == Decimal("0.00")
+
+    def test_permission_denied_error_handling(self):
+        """Test error handling for permission denied scenarios"""
+        with tempfile.NamedTemporaryFile(mode="w", delete=False) as f:
+            temp_file = f.name
+
+        try:
+            # Make file read-only
+            import os
+
+            os.chmod(temp_file, 0o444)
+
+            # Try to write (should fail)
+            with pytest.raises(PermissionError):
+                with open(temp_file, "w") as f:
+                    f.write("test")
+        finally:
+            # Cleanup
+            os.chmod(temp_file, 0o644)
+            Path(temp_file).unlink(missing_ok=True)
+
+    def test_network_timeout_handling(self):
+        """Test error handling for network timeouts"""
+        # Mock timeout scenario
+        mock_client = MagicMock()
+        mock_client.get_cost_and_usage.side_effect = TimeoutError("Request timed out")
+
+        with pytest.raises(TimeoutError):
+            mock_client.get_cost_and_usage()
+
+    def test_partial_data_recovery(self):
+        """Test partial data recovery when some queries fail"""
+        successful_data = [Decimal("100.00"), Decimal("105.00")]
+        failed_data = None
+
+        # Should still process successful data
+        total = sum(successful_data)
+        assert total > 0
+
+
+# ========================================
+# Multi-LZ Reusability Tests (8 tests)
+# ========================================
+
+
+@pytest.mark.integration
+class TestMultiLZReusability:
+    """Test framework reusability across multiple Landing Zones"""
+
+    def test_multi_account_support(self, cleanup_multi_lz_config):
+        """Test support for multiple AWS accounts"""
+        accounts = {vpc["account_id"] for vpc in cleanup_multi_lz_config["deleted_vpcs"]}
+        assert len(accounts) >= 2, "Should support multiple accounts"
+
+    def test_multi_region_support(self, cleanup_multi_lz_config):
+        """Test support for multiple AWS regions"""
+        regions = {vpc["region"] for vpc in cleanup_multi_lz_config["deleted_vpcs"]}
+        assert len(regions) >= 2, "Should support multiple regions"
+
+    def test_different_deletion_dates_support(self, cleanup_multi_lz_config):
+        """Test support for different deletion dates"""
+        dates = {vpc["deletion_date"] for vpc in cleanup_multi_lz_config["deleted_vpcs"]}
+        assert len(dates) >= 2, "Should support different deletion dates"
+
+    def test_different_deletion_principals(self, cleanup_multi_lz_config):
+        """Test support for different deletion principals"""
+        principals = {vpc["deletion_principal"] for vpc in cleanup_multi_lz_config["deleted_vpcs"]}
+        assert len(principals) >= 2, "Should support different deletion principals"
+
+    def test_campaign_level_metadata(self, cleanup_multi_lz_config):
+        """Test campaign-level metadata for multi-LZ"""
+        metadata = cleanup_multi_lz_config["campaign_metadata"]
+        assert "MULTI-LZ" in metadata["campaign_id"]
+        assert "Landing Zone" in metadata.get("description", "")
+
+    def test_consolidated_output_generation(self, cleanup_multi_lz_config):
+        """Test consolidated output for multiple LZs"""
+        output_config = cleanup_multi_lz_config["output_config"]
+
+        # Should have single output files for all LZs
+        assert "multi_lz" in output_config["csv_output_file"]
+        assert "multi_lz" in output_config["json_results_file"]
+
+    def test_per_lz_cost_attribution(self, cleanup_multi_lz_config):
+        """Test per-LZ cost attribution and aggregation"""
+        vpcs = cleanup_multi_lz_config["deleted_vpcs"]
+
+        # Each VPC should have independent attribution
+        for vpc in vpcs:
+            assert "account_id" in vpc
+            assert "region" in vpc
+
+    def test_cross_lz_comparison_support(self, cleanup_multi_lz_config):
+        """Test support for cross-LZ comparison and analysis"""
+        vpcs = cleanup_multi_lz_config["deleted_vpcs"]
+
+        # Group by account for comparison
+        by_account = {}
+        for vpc in vpcs:
+            account = vpc["account_id"]
+            if account not in by_account:
+                by_account[account] = []
+            by_account[account].append(vpc)
+
+        # Should enable comparison across accounts
+        assert len(by_account) > 0