pangea 0.0.45 → 0.0.46

data/lib/pangea/resources/aws_autoscaling_attachment/resource.rb

@@ -1,81 +0,0 @@
-# frozen_string_literal: true
-# Copyright 2025 The Pangea Authors
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#     http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-
-require 'pangea/resources/base'
-require 'pangea/resources/reference'
-require 'pangea/resources/aws_autoscaling_attachment/types'
-require 'pangea/resource_registry'
-
-module Pangea
-  module Resources
-    module AWS
-      # Create an AWS Auto Scaling Attachment to attach an Auto Scaling Group to a load balancer
-      #
-      # @param name [Symbol] The resource name
-      # @param attributes [Hash] Attachment attributes
-      # @option attributes [String] :autoscaling_group_name The ASG name (required)
-      # @option attributes [String] :elb Classic Load Balancer name
-      # @option attributes [String] :lb_target_group_arn Target Group ARN for ALB/NLB
-      # @return [ResourceReference] Reference object with outputs and computed properties
-      #
-      # @example Attach ASG to ALB Target Group
-      #   attachment = aws_autoscaling_attachment(:web_asg_attachment, {
-      #     autoscaling_group_name: asg.name,
-      #     lb_target_group_arn: target_group.arn
-      #   })
-      #
-      # @example Attach ASG to Classic Load Balancer
-      #   attachment = aws_autoscaling_attachment(:classic_attachment, {
-      #     autoscaling_group_name: "my-asg",
-      #     elb: "my-classic-lb"
-      #   })
-      def aws_autoscaling_attachment(name, attributes = {})
-        # Validate attributes using dry-struct
-        attach_attrs = Types::Types::AutoScalingAttachmentAttributes.new(attributes)
-        
-        # Generate terraform resource block via terraform-synthesizer
-        resource(:aws_autoscaling_attachment, name) do
-          autoscaling_group_name attach_attrs.autoscaling_group_name
-          
-          # Add the appropriate attachment type
-          if attach_attrs.elb
-            elb attach_attrs.elb
-          elsif attach_attrs.lb_target_group_arn
-            lb_target_group_arn attach_attrs.lb_target_group_arn
-          end
-        end
-        
-        # Return resource reference with available outputs
-        ResourceReference.new(
-          type: 'aws_autoscaling_attachment',
-          name: name,
-          resource_attributes: attach_attrs.to_h,
-          outputs: {
-            id: "${aws_autoscaling_attachment.#{name}.id}",
-            autoscaling_group_name: "${aws_autoscaling_attachment.#{name}.autoscaling_group_name}"
-          },
-          computed_properties: {
-            attachment_type: attach_attrs.attachment_type,
-            target_arn: attach_attrs.target_arn
-          }
-        )
-      end
-    end
-  end
-end
-
-# Auto-register this module when it's loaded
-Pangea::ResourceRegistry.register(:aws, Pangea::Resources::AWS)

data/lib/pangea/resources/aws_autoscaling_attachment/types.rb

@@ -1,86 +0,0 @@
-# frozen_string_literal: true
-# Copyright 2025 The Pangea Authors
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#     http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-
-require 'dry-struct'
-require 'pangea/resources/types'
-
-module Pangea
-  module Resources
-    module AWS
-      module Types
-        # Auto Scaling Attachment resource attributes with validation
-        class AutoScalingAttachmentAttributes < Dry::Struct
-          transform_keys(&:to_sym)
-          
-          # Required: Auto Scaling Group name or ID
-          attribute :autoscaling_group_name, Resources::Types::String
-          
-          # One of these is required (mutually exclusive)
-          attribute :elb, Resources::Types::String.optional.default(nil)
-          attribute :lb_target_group_arn, Resources::Types::String.optional.default(nil)
-          attribute :alb_target_group_arn, Resources::Types::String.optional.default(nil)  # Deprecated alias
-          
-          # Validate that exactly one target is specified
-          def self.new(attributes)
-            attrs = attributes.is_a?(Hash) ? attributes : {}
-            
-            # Count how many attachment targets are specified
-            targets = [
-              attrs[:elb],
-              attrs[:lb_target_group_arn],
-              attrs[:alb_target_group_arn]
-            ].compact
-            
-            if targets.empty?
-              raise Dry::Struct::Error, "Auto Scaling attachment must specify one of: elb, lb_target_group_arn, or alb_target_group_arn"
-            end
-            
-            if targets.size > 1
-              raise Dry::Struct::Error, "Auto Scaling attachment can only specify one target type"
-            end
-            
-            # Handle deprecated alb_target_group_arn
-            if attrs[:alb_target_group_arn] && !attrs[:lb_target_group_arn]
-              attrs[:lb_target_group_arn] = attrs[:alb_target_group_arn]
-              attrs.delete(:alb_target_group_arn)
-            end
-            
-            super(attrs)
-          end
-          
-          # Computed properties
-          def attachment_type
-            return :classic_lb if elb
-            return :target_group if lb_target_group_arn
-            :unknown
-          end
-          
-          def target_arn
-            lb_target_group_arn || elb
-          end
-          
-          def to_h
-            {
-              autoscaling_group_name: autoscaling_group_name,
-              elb: elb,
-              lb_target_group_arn: lb_target_group_arn
-            }.compact
-          end
-        end
-      end
-    end
-  end
-end

data/lib/pangea/resources/aws_autoscaling_group/CLAUDE.md

@@ -1,263 +0,0 @@
-# AWS Auto Scaling Group Resource Implementation
-
-## Overview
-
-The `aws_autoscaling_group` resource creates an AWS Auto Scaling Group (ASG) that automatically adjusts the number of EC2 instances based on demand. Auto Scaling Groups ensure application availability and allow you to scale EC2 capacity up or down automatically according to conditions you define.
-
-## Type Safety Implementation
-
-### Attributes Structure
-
-```ruby
-class AutoScalingGroupAttributes < Dry::Struct
-  # Required sizing
-  attribute :min_size, Integer.constrained(gteq: 0)
-  attribute :max_size, Integer.constrained(gteq: 0)
-  
-  # Optional sizing
-  attribute :desired_capacity, Integer.optional
-  attribute :default_cooldown, Integer.default(300)
-  
-  # Launch configuration (one required)
-  attribute :launch_configuration, String.optional
-  attribute :launch_template, LaunchTemplateSpecification.optional
-  attribute :mixed_instances_policy, Hash.optional
-  
-  # Network configuration
-  attribute :vpc_zone_identifier, Array.of(String)
-  attribute :availability_zones, Array.of(String)
-  
-  # Health checks
-  attribute :health_check_type, String.enum('EC2', 'ELB')
-  attribute :health_check_grace_period, Integer
-  
-  # Tags
-  attribute :tags, Array.of(AutoScalingTag)
-end
-```
-
-### Key Design Decisions
-
-1. **Launch Configuration Flexibility**:
-   - Supports launch configurations (legacy)
-   - Supports launch templates (recommended)
-   - Supports mixed instances policy (spot/on-demand)
-   - Validates exactly one is specified
-
-2. **Network Configuration Validation**:
-   - Requires either `vpc_zone_identifier` (VPC) or `availability_zones` (EC2-Classic)
-   - Most users will use `vpc_zone_identifier` with subnet IDs
-
-3. **Capacity Validation**:
-   - Ensures `min_size` ≤ `max_size`
-   - Ensures `min_size` ≤ `desired_capacity` ≤ `max_size`
-   - Default `desired_capacity` to `min_size` if not specified
-
-4. **Tag Structure**:
-   - Uses `AutoScalingTag` type with `key`, `value`, and `propagate_at_launch`
-   - Converts to array format expected by Terraform
-
-5. **Computed Properties**:
-   - `uses_launch_template?`: Whether using launch templates
-   - `uses_mixed_instances?`: Whether using mixed instances
-   - `uses_target_groups?`: Whether attached to ALB/NLB
-   - `uses_classic_load_balancers?`: Whether attached to CLB
-
-## Resource Function Pattern
-
-The `aws_autoscaling_group` function handles complex nested configurations:
-
-```ruby
-def aws_autoscaling_group(name, attributes = {})
-  # 1. Validate attributes with dry-struct
-  asg_attrs = Types::AutoScalingGroupAttributes.new(attributes)
-  
-  # 2. Generate Terraform resource via synthesizer
-  resource(:aws_autoscaling_group, name) do
-    # Required attributes
-    min_size asg_attrs.min_size
-    max_size asg_attrs.max_size
-    
-    # Conditional launch configuration
-    if asg_attrs.launch_template
-      launch_template do
-        id asg_attrs.launch_template.id if asg_attrs.launch_template.id
-        name asg_attrs.launch_template.name if asg_attrs.launch_template.name
-        version asg_attrs.launch_template.version
-      end
-    end
-    
-    # Tag handling - convert to array format
-    tag asg_attrs.tags.map(&:to_h) if asg_attrs.tags.any?
-  end
-  
-  # 3. Return ResourceReference with outputs and computed properties
-  ResourceReference.new(
-    type: 'aws_autoscaling_group',
-    name: name,
-    outputs: { id, arn, name, desired_capacity, ... },
-    computed_properties: { uses_launch_template, uses_target_groups, ... }
-  )
-end
-```
-
-## Integration with Terraform Synthesizer
-
-The resource handles various configuration patterns:
-
-```ruby
-resource(:aws_autoscaling_group, name) do
-  # Basic configuration
-  min_size 2
-  max_size 10
-  desired_capacity 4
-  
-  # Launch template block
-  launch_template do
-    id "${aws_launch_template.web.id}"
-    version "$Latest"
-  end
-  
-  # Network configuration
-  vpc_zone_identifier ["${aws_subnet.private_a.id}", "${aws_subnet.private_b.id}"]
-  
-  # Health checks
-  health_check_type "ELB"
-  health_check_grace_period 300
-  
-  # Tags as array
-  tag [
-    { key: "Name", value: "web-server", propagate_at_launch: true },
-    { key: "Environment", value: "production", propagate_at_launch: true }
-  ]
-  
-  # Target groups for ALB
-  target_group_arns ["${aws_lb_target_group.web.arn}"]
-end
-```
-
-## Common Usage Patterns
-
-### 1. Basic Web Application ASG
-```ruby
-asg = aws_autoscaling_group(:web, {
-  min_size: 2,
-  max_size: 10,
-  desired_capacity: 4,
-  vpc_zone_identifier: [subnet_a.id, subnet_b.id],
-  launch_template: {
-    id: web_template.id,
-    version: "$Latest"
-  },
-  health_check_type: "ELB",
-  health_check_grace_period: 300,
-  target_group_arns: [web_tg.arn],
-  tags: [
-    { key: "Name", value: "web-asg", propagate_at_launch: true }
-  ]
-})
-```
-
-### 2. ASG with Mixed Instances (Spot + On-Demand)
-```ruby
-asg = aws_autoscaling_group(:mixed, {
-  min_size: 3,
-  max_size: 20,
-  mixed_instances_policy: {
-    launch_template: {
-      launch_template_specification: {
-        launch_template_id: base_template.id,
-        version: "$Latest"
-      },
-      overrides: [
-        { instance_type: "t3.medium" },
-        { instance_type: "t3.large" },
-        { instance_type: "t3a.medium" },
-        { instance_type: "t3a.large" }
-      ]
-    },
-    instances_distribution: {
-      on_demand_base_capacity: 2,
-      on_demand_percentage_above_base_capacity: 20,
-      spot_allocation_strategy: "lowest-price",
-      spot_instance_pools: 4
-    }
-  }
-})
-```
-
-### 3. ASG with Instance Refresh
-```ruby
-asg = aws_autoscaling_group(:refreshable, {
-  min_size: 3,
-  max_size: 9,
-  vpc_zone_identifier: private_subnets,
-  launch_template: { id: app_template.id },
-  instance_refresh: {
-    min_healthy_percentage: 90,
-    instance_warmup: 120,
-    checkpoint_percentages: [50],
-    checkpoint_delay: 300
-  }
-})
-```
-
-### 4. ASG with Lifecycle Hooks
-```ruby
-asg = aws_autoscaling_group(:lifecycle, {
-  min_size: 1,
-  max_size: 5,
-  vpc_zone_identifier: [subnet.id],
-  launch_template: { name: "app-template" },
-  max_instance_lifetime: 604800, # 7 days
-  protect_from_scale_in: true,
-  termination_policies: ["OldestInstance", "Default"]
-})
-```
-
-## Testing Considerations
-
-1. **Type Validation**:
-   - Test size constraint validation (min/max/desired)
-   - Test launch configuration mutual exclusivity
-   - Test network configuration requirements
-   - Test tag structure validation
-
-2. **Nested Structure Generation**:
-   - Verify launch template block generation
-   - Test tag array format conversion
-   - Test instance refresh preferences
-   - Test mixed instances policy
-
-3. **Terraform Generation**:
-   - Verify conditional attribute inclusion
-   - Test array handling for subnets and tags
-   - Test nested block syntax
-
-4. **Edge Cases**:
-   - ASG with no desired capacity specified
-   - Multiple availability zones vs VPC subnets
-   - Empty tag arrays
-   - Complex mixed instances policies
-
-## Future Enhancements
-
-1. **Enhanced Validation**:
-   - Subnet availability zone consistency
-   - Target group compatibility checks
-   - Launch template version validation
-
-2. **Computed Properties**:
-   - Estimated costs based on instance types
-   - Capacity utilization metrics
-   - Scaling policy recommendations
-
-3. **Helper Methods**:
-   - Scaling policy builders
-   - Lifecycle hook creators
-   - Blue/green deployment helpers
-
-4. **Advanced Features**:
-   - Warm pool configuration
-   - Predictive scaling setup
-   - Custom termination policy builders

data/lib/pangea/resources/aws_autoscaling_group/resource.rb

@@ -1,175 +0,0 @@
-# frozen_string_literal: true
-# Copyright 2025 The Pangea Authors
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#     http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-
-require 'pangea/resources/base'
-require 'pangea/resources/reference'
-require 'pangea/resources/aws_autoscaling_group/types'
-require 'pangea/resource_registry'
-
-module Pangea
-  module Resources
-    module AWS
-      # Create an AWS Auto Scaling Group with type-safe attributes
-      #
-      # @param name [Symbol] The resource name
-      # @param attributes [Hash] Auto Scaling Group attributes
-      # @option attributes [Integer] :min_size Minimum number of instances (required)
-      # @option attributes [Integer] :max_size Maximum number of instances (required)
-      # @option attributes [Integer] :desired_capacity Desired number of instances
-      # @option attributes [Hash] :launch_template Launch template specification
-      # @option attributes [Array<String>] :vpc_zone_identifier List of subnet IDs
-      # @option attributes [String] :health_check_type Type of health check (EC2 or ELB)
-      # @option attributes [Integer] :health_check_grace_period Grace period in seconds
-      # @option attributes [Array<Hash>] :tags Tags to apply to instances
-      # @return [ResourceReference] Reference object with outputs and computed properties
-      #
-      # @example Basic Auto Scaling Group with launch template
-      #   asg = aws_autoscaling_group(:web_asg, {
-      #     min_size: 2,
-      #     max_size: 10,
-      #     desired_capacity: 4,
-      #     vpc_zone_identifier: [subnet_a.id, subnet_b.id],
-      #     launch_template: {
-      #       id: launch_template.id,
-      #       version: "$Latest"
-      #     },
-      #     tags: [
-      #       { key: "Name", value: "web-server", propagate_at_launch: true },
-      #       { key: "Environment", value: "production", propagate_at_launch: true }
-      #     ]
-      #   })
-      #
-      # @example ASG with target groups and health checks
-      #   asg = aws_autoscaling_group(:app_asg, {
-      #     min_size: 1,
-      #     max_size: 5,
-      #     vpc_zone_identifier: private_subnet_ids,
-      #     launch_template: { name: "app-template" },
-      #     health_check_type: "ELB",
-      #     health_check_grace_period: 300,
-      #     target_group_arns: [target_group.arn]
-      #   })
-      def aws_autoscaling_group(name, attributes = {})
-        # Validate attributes using dry-struct
-        asg_attrs = Types::Types::AutoScalingGroupAttributes.new(attributes)
-        
-        # Generate terraform resource block via terraform-synthesizer
-        resource(:aws_autoscaling_group, name) do
-          # Required attributes
-          min_size asg_attrs.min_size
-          max_size asg_attrs.max_size
-          
-          # Optional sizing
-          desired_capacity asg_attrs.desired_capacity if asg_attrs.desired_capacity
-          default_cooldown asg_attrs.default_cooldown if asg_attrs.default_cooldown != 300
-          
-          # Launch configuration
-          if asg_attrs.launch_configuration
-            launch_configuration asg_attrs.launch_configuration
-          elsif asg_attrs.launch_template
-            launch_template do
-              id asg_attrs.launch_template.id if asg_attrs.launch_template.id
-              __send__(:name, asg_attrs.launch_template.name) if asg_attrs.launch_template.name
-              version asg_attrs.launch_template.version
-            end
-          elsif asg_attrs.mixed_instances_policy
-            mixed_instances_policy asg_attrs.mixed_instances_policy
-          end
-          
-          # Network configuration
-          vpc_zone_identifier asg_attrs.vpc_zone_identifier if asg_attrs.vpc_zone_identifier.any?
-          availability_zones asg_attrs.availability_zones if asg_attrs.availability_zones.any?
-          
-          # Health check configuration
-          health_check_type asg_attrs.health_check_type
-          health_check_grace_period asg_attrs.health_check_grace_period
-          
-          # Termination policies
-          termination_policies asg_attrs.termination_policies if asg_attrs.termination_policies.any?
-          
-          # Metrics
-          if asg_attrs.enabled_metrics.any?
-            enabled_metrics asg_attrs.enabled_metrics
-            metrics_granularity asg_attrs.metrics_granularity
-          end
-          
-          # Capacity and scaling options
-          wait_for_capacity_timeout asg_attrs.wait_for_capacity_timeout
-          min_elb_capacity asg_attrs.min_elb_capacity if asg_attrs.min_elb_capacity
-          protect_from_scale_in asg_attrs.protect_from_scale_in if asg_attrs.protect_from_scale_in
-          service_linked_role_arn asg_attrs.service_linked_role_arn if asg_attrs.service_linked_role_arn
-          max_instance_lifetime asg_attrs.max_instance_lifetime if asg_attrs.max_instance_lifetime
-          capacity_rebalance asg_attrs.capacity_rebalance if asg_attrs.capacity_rebalance
-          
-          # Load balancing
-          target_group_arns asg_attrs.target_group_arns if asg_attrs.target_group_arns.any?
-          load_balancers asg_attrs.load_balancers if asg_attrs.load_balancers.any?
-          
-          # Tags - handle as array of hashes
-          if asg_attrs.tags.any?
-            # Convert our AutoScalingTag objects to hash format expected by Terraform
-            tag asg_attrs.tags.map(&:to_h)
-          end
-          
-          # Instance refresh
-          if asg_attrs.instance_refresh
-            instance_refresh do
-              preferences do
-                min_healthy_percentage asg_attrs.instance_refresh.min_healthy_percentage
-                instance_warmup asg_attrs.instance_refresh.instance_warmup if asg_attrs.instance_refresh.instance_warmup
-                checkpoint_percentages asg_attrs.instance_refresh.checkpoint_percentages if asg_attrs.instance_refresh.checkpoint_percentages.any?
-                checkpoint_delay asg_attrs.instance_refresh.checkpoint_delay if asg_attrs.instance_refresh.checkpoint_delay
-              end
-            end
-          end
-        end
-        
-        # Return resource reference with available outputs and computed properties
-        ref = ResourceReference.new(
-          type: 'aws_autoscaling_group',
-          name: name,
-          resource_attributes: asg_attrs.to_h,
-          outputs: {
-            id: "${aws_autoscaling_group.#{name}.id}",
-            arn: "${aws_autoscaling_group.#{name}.arn}",
-            name: "${aws_autoscaling_group.#{name}.name}",
-            min_size: "${aws_autoscaling_group.#{name}.min_size}",
-            max_size: "${aws_autoscaling_group.#{name}.max_size}",
-            desired_capacity: "${aws_autoscaling_group.#{name}.desired_capacity}",
-            default_cooldown: "${aws_autoscaling_group.#{name}.default_cooldown}",
-            availability_zones: "${aws_autoscaling_group.#{name}.availability_zones}",
-            load_balancers: "${aws_autoscaling_group.#{name}.load_balancers}",
-            target_group_arns: "${aws_autoscaling_group.#{name}.target_group_arns}",
-            health_check_type: "${aws_autoscaling_group.#{name}.health_check_type}",
-            health_check_grace_period: "${aws_autoscaling_group.#{name}.health_check_grace_period}",
-            vpc_zone_identifier: "${aws_autoscaling_group.#{name}.vpc_zone_identifier}"
-          }
-        )
-        
-        # Add computed properties via method delegation
-        ref.define_singleton_method(:uses_launch_template?) { asg_attrs.uses_launch_template? }
-        ref.define_singleton_method(:uses_mixed_instances?) { asg_attrs.uses_mixed_instances? }
-        ref.define_singleton_method(:uses_target_groups?) { asg_attrs.uses_target_groups? }
-        ref.define_singleton_method(:uses_classic_load_balancers?) { asg_attrs.uses_classic_load_balancers? }
-        
-        ref
-      end
-    end
-  end
-end
-
-# Auto-register this module when it's loaded
-Pangea::ResourceRegistry.register(:aws, Pangea::Resources::AWS)