pangea 0.0.42 → 0.0.45

data/scripts/verify_implementation.rb

@@ -0,0 +1,146 @@
+#!/usr/bin/env ruby
+# 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.
+
+
+# Mock colorize if not available
+class String
+  def colorize(color)
+    self
+  end
+end
+
+class ImplementationVerifier
+  def initialize
+    @results = []
+  end
+  
+  def verify_all
+    puts "Pangea Implementation Verification".colorize(:blue)
+    puts "=" * 50
+    
+    verify_phase_1_types
+    verify_phase_2_resources
+    verify_phase_3_testing
+    verify_phase_4_components
+    verify_phase_5_errors
+    verify_phase_6_documentation
+    
+    print_summary
+  end
+  
+  private
+  
+  def verify_phase_1_types
+    puts "\nPhase 1: Type System".colorize(:yellow)
+    
+    check_file_exists("lib/pangea/types.rb")
+    check_file_exists("lib/pangea/types/registry.rb")
+    check_file_exists("lib/pangea/types/base_types.rb")
+    check_file_exists("lib/pangea/types/aws_types.rb")
+    
+    check_code_works(
+      "Type Registry",
+      "require './lib/pangea/types'; Pangea::Types[:cidr_block]"
+    )
+  end
+  
+  def verify_phase_2_resources
+    puts "\nPhase 2: Resource Standardization".colorize(:yellow)
+    
+    check_file_exists("lib/pangea/resources/templates/resource_template.rb.erb")
+    check_file_exists("lib/pangea/generators/resource_generator.rb")
+    check_file_exists("lib/pangea/quality/resource_auditor.rb")
+    check_file_exists("audit_results/vpc_resources_audit.json")
+  end
+  
+  def verify_phase_3_testing
+    puts "\nPhase 3: Testing Framework".colorize(:yellow)
+    
+    check_file_exists("spec/support/test_data_registry.rb")
+    check_file_exists("lib/pangea/generators/test_generator.rb")
+    check_file_exists("spec/templates/resource_spec.rb.erb")
+    check_file_exists("spec/templates/synthesis_spec.rb.erb")
+    check_file_exists("spec/templates/integration_spec.rb.erb")
+  end
+  
+  def verify_phase_4_components
+    puts "\nPhase 4: Component Standardization".colorize(:yellow)
+    
+    check_file_exists("lib/pangea/components/base.rb")
+    check_file_exists("lib/pangea/components/capabilities.rb")
+    
+    check_code_works(
+      "Component Base Class",
+      "require './lib/pangea/components/base'; Pangea::Components::Base"
+    )
+  end
+  
+  def verify_phase_5_errors
+    puts "\nPhase 5: Error Standardization".colorize(:yellow)
+    
+    check_file_exists("lib/pangea/errors.rb")
+    check_file_exists("lib/pangea/validation.rb")
+    
+    check_code_works(
+      "Error Messages",
+      "require './lib/pangea/errors'; Pangea::Errors::ValidationError.missing_required('test', 'attr')"
+    )
+  end
+  
+  def verify_phase_6_documentation
+    puts "\nPhase 6: Documentation".colorize(:yellow)
+    
+    check_file_exists("lib/pangea/documentation/generator.rb")
+    check_file_exists("lib/pangea/documentation/writer.rb")
+  end
+  
+  def check_file_exists(path)
+    if File.exist?(path)
+      @results << { status: :pass, message: "File exists: #{path}" }
+      puts "  ✓ #{path}".colorize(:green)
+    else
+      @results << { status: :fail, message: "Missing file: #{path}" }
+      puts "  ✗ #{path}".colorize(:red)
+    end
+  end
+  
+  def check_code_works(name, code)
+    begin
+      eval(code)
+      @results << { status: :pass, message: "#{name} works" }
+      puts "  ✓ #{name}".colorize(:green)
+    rescue => e
+      @results << { status: :fail, message: "#{name} failed: #{e.message}" }
+      puts "  ✗ #{name}: #{e.message}".colorize(:red)
+    end
+  end
+  
+  def print_summary
+    puts "\n" + "=" * 50
+    passed = @results.count { |r| r[:status] == :pass }
+    failed = @results.count { |r| r[:status] == :fail }
+    
+    puts "Summary: #{passed} passed, #{failed} failed".colorize(failed > 0 ? :red : :green)
+    
+    if failed > 0
+      puts "\nFailed checks:".colorize(:red)
+      @results.select { |r| r[:status] == :fail }.each do |result|
+        puts "  - #{result[:message]}"
+      end
+    end
+  end
+end
+
+ ImplementationVerifier.new.verify_all

data/scripts/verify_utilities.rb

@@ -0,0 +1,185 @@
+#!/usr/bin/env ruby
+# 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.
+
+
+class UtilitiesVerifier
+  def initialize
+    @results = []
+  end
+  
+  def verify_all
+    puts "Pangea Utilities Implementation Verification"
+    puts "=" * 50
+    
+    verify_foundation
+    verify_remote_state
+    verify_drift_detection
+    verify_cost_analysis
+    verify_visualization
+    verify_cli_commands
+    
+    print_summary
+  end
+  
+  private
+  
+  def verify_foundation
+    puts "\nPhase 1: Foundation"
+    
+    check_directory_structure
+    check_module_loading
+  end
+  
+  def verify_remote_state
+    puts "\nPhase 2: Remote State"
+    
+    check_class_exists("Pangea::Utilities::RemoteState::Reference")
+    check_class_exists("Pangea::Utilities::RemoteState::DependencyManager")
+    check_class_exists("Pangea::Utilities::RemoteState::OutputRegistry")
+    
+    check_functionality("Remote State Reference") do
+      ref = Pangea::Utilities::RemoteState.reference('test', 'network', 'vpc_id')
+      ref.reference_string == '${data.terraform_remote_state.network_state.outputs.vpc_id}'
+    end
+  end
+  
+  def verify_drift_detection
+    puts "\nPhase 3: Drift Detection"
+    
+    check_class_exists("Pangea::Utilities::Drift::Detector")
+    check_class_exists("Pangea::Utilities::Drift::Report")
+    
+    check_functionality("Drift Report") do
+      report = Pangea::Utilities::Drift::Report.new('test', :drift_detected, {})
+      report.drift_detected?
+    end
+  end
+  
+  def verify_cost_analysis
+    puts "\nPhase 4: Cost Analysis"
+    
+    check_class_exists("Pangea::Utilities::Cost::Calculator")
+    check_class_exists("Pangea::Utilities::Cost::ResourcePricing")
+    
+    check_functionality("Resource Pricing") do
+      price = Pangea::Utilities::Cost::ResourcePricing.get_price('aws_instance', {instance_type: 't3.micro'})
+      price[:hourly] == 0.0104
+    end
+  end
+  
+  def verify_visualization
+    puts "\nPhase 5: Visualization"
+    
+    check_class_exists("Pangea::Utilities::Visualization::Graph")
+    check_class_exists("Pangea::Utilities::Visualization::MermaidExporter")
+    
+    check_functionality("Graph Creation") do
+      graph = Pangea::Utilities::Visualization::Graph.new
+      graph.add_node('test')
+      graph.nodes.key?('test')
+    end
+  end
+  
+  def verify_cli_commands
+    puts "\nPhase 6: CLI Commands"
+    
+    check_file_exists("lib/pangea/utilities/cli/command.rb")
+    check_file_exists("lib/pangea/utilities/cli/commands/state_command.rb")
+    check_file_exists("lib/pangea/utilities/cli/commands/drift_command.rb")
+    check_file_exists("lib/pangea/utilities/cli/commands/cost_command.rb")
+  end
+  
+  def check_directory_structure
+    expected_dirs = %w[
+      remote_state drift cost visualization analysis
+      validation backup migration monitoring cli/commands
+    ]
+    
+    expected_dirs.each do |dir|
+      path = "lib/pangea/utilities/#{dir}"
+      if Dir.exist?(path)
+        success "Directory exists: #{dir}"
+      else
+        error "Missing directory: #{dir}"
+      end
+    end
+  end
+  
+  def check_module_loading
+    begin
+      require 'pangea/utilities'
+      success "Utilities module loads successfully"
+    rescue => e
+      error "Failed to load utilities: #{e.message}"
+    end
+  end
+  
+  def check_class_exists(class_name)
+    klass = class_name.split('::').inject(Object) { |o, c| o.const_get(c) }
+    success "#{class_name} exists"
+    @results << { status: :pass }
+  rescue => e
+    error "#{class_name} missing: #{e.message}"
+    @results << { status: :fail }
+  end
+  
+  def check_file_exists(path)
+    if File.exist?(path)
+      success "File exists: #{path}"
+      @results << { status: :pass }
+    else
+      error "Missing file: #{path}"
+      @results << { status: :fail }
+    end
+  end
+  
+  def check_functionality(name)
+    result = yield
+    if result
+      success "#{name} works correctly"
+      @results << { status: :pass }
+    else
+      error "#{name} failed"
+      @results << { status: :fail }
+    end
+  rescue => e
+    error "#{name} error: #{e.message}"
+    @results << { status: :fail }
+  end
+  
+  def success(message)
+    puts "  ✓ #{message}"
+  end
+  
+  def error(message)
+    puts "  ✗ #{message}"
+  end
+  
+  def print_summary
+    puts "\n" + "=" * 50
+    passed = @results.count { |r| r[:status] == :pass }
+    failed = @results.count { |r| r[:status] == :fail }
+    
+    puts "Summary: #{passed} passed, #{failed} failed"
+  end
+end
+
+# Change to Pangea directory before running
+Dir.chdir(File.expand_path('..', __dir__))
+
+# Load the library path
+$LOAD_PATH.unshift(File.expand_path('lib', Dir.pwd))
+
+UtilitiesVerifier.new.verify_all

data/shell.nix

@@ -0,0 +1,13 @@
+with (import <nixpkgs> {});
+let
+  env = bundlerEnv {
+    name = "pangea-bundler-env";
+    inherit ruby;
+    gemfile  = ./Gemfile;
+    lockfile = ./Gemfile.lock;
+    gemset   = ./gemset.nix;
+  };
+in stdenv.mkDerivation {
+  name = "pangea";
+  buildInputs = [ env ];
+}

data/sig/pangea/architectures.rbs

@@ -0,0 +1,260 @@
+# frozen_string_literal: true
+
+module Pangea
+  module Architectures
+    # Base architecture reference returned by all architecture functions
+    class ArchitectureReference < Dry::Struct
+      attr_reader architecture_type: String
+      attr_reader name: Symbol
+      attr_reader attributes: Hash[Symbol, untyped]
+      attr_reader resources: Hash[Symbol, untyped]
+      attr_reader overrides: Hash[Symbol, bool]
+      attr_reader extensions: Array[Integer]
+
+      def network: () -> untyped
+      def network=: (untyped value) -> void
+      def compute: () -> untyped
+      def compute=: (untyped value) -> void
+      def database: () -> untyped  
+      def database=: (untyped value) -> void
+      def storage: () -> untyped
+      def storage=: (untyped value) -> void
+      def monitoring: () -> untyped
+      def monitoring=: (untyped value) -> void
+      def security: () -> untyped
+      def security=: (untyped value) -> void
+
+      def all_resources: () -> Array[untyped]
+      def all_resource_ids: () -> Array[String]
+      
+      def availability_zones: () -> Array[String]
+      def is_highly_available?: () -> bool
+      def is_multi_region?: () -> bool
+      def estimated_monthly_cost: () -> Float
+      def security_compliance_score: () -> Float
+
+      def override: (Symbol component_name) { (ArchitectureReference) -> untyped } -> ArchitectureReference
+      def extend: () { (ArchitectureReference) -> void } -> ArchitectureReference
+      def compose_with: () { (ArchitectureReference) -> void } -> ArchitectureReference
+
+      private
+
+      def estimate_instance_cost: (String? instance_type) -> Float
+      def estimate_rds_cost: (String? instance_class) -> Float
+      def has_security_groups?: () -> bool
+      def database_encrypted?: () -> bool
+      def has_monitoring?: () -> bool
+    end
+
+    # Base functionality for all architecture functions
+    module Base
+      protected
+
+      def create_architecture_reference: (String type, Symbol name, ?Hash[Symbol, untyped] attributes) -> ArchitectureReference
+      def merge_with_defaults: (Hash[Symbol, untyped] attributes, Hash[Symbol, untyped] defaults) -> Hash[Symbol, untyped]
+      def validate_architecture_attributes: (Class attributes_class, Hash[Symbol, untyped] attributes) -> untyped
+      def add_resource_to_architecture: (ArchitectureReference arch_ref, Symbol tier, untyped resource) -> ArchitectureReference
+      def architecture_tags: (ArchitectureReference arch_ref, ?Hash[Symbol, String] additional_tags) -> Hash[Symbol, String]
+      def architecture_resource_name: (Symbol arch_name, Symbol resource_type, ?Symbol resource_name) -> Symbol
+    end
+
+    module Patterns
+      # Web Application Architecture Types
+      module WebApplication
+        include Base
+
+        class WebApplicationAttributes < Dry::Struct
+          attribute domain: String
+          attribute environment: String
+          attribute vpc_cidr: String
+          attribute availability_zones: Array[String]
+          attribute high_availability: bool
+          attribute auto_scaling: Hash[Symbol, Integer]
+          attribute instance_type: String
+          attribute ami_id: String
+          attribute key_pair: String?
+          attribute database_enabled: bool
+          attribute database_engine: String
+          attribute database_instance_class: String
+          attribute database_allocated_storage: Integer
+          attribute database_backup_retention: Integer
+          attribute s3_bucket_enabled: bool
+          attribute cloudfront_enabled: bool
+          attribute waf_enabled: bool
+          attribute ssl_certificate_arn: String?
+          attribute monitoring_enabled: bool
+          attribute log_retention_days: Integer
+          attribute tags: Hash[Symbol, String]
+
+          def is_production?: () -> bool
+          def requires_https?: () -> bool
+          def subnet_count: () -> Integer
+        end
+
+        def web_application_architecture: (Symbol name, ?Hash[Symbol, untyped] attributes) -> ArchitectureReference
+
+        private
+
+        def create_security_tier: (Symbol name, ArchitectureReference arch_ref, WebApplicationAttributes arch_attrs, Hash[Symbol, String] base_tags) -> Hash[Symbol, untyped]
+        def create_storage_tier: (Symbol name, ArchitectureReference arch_ref, WebApplicationAttributes arch_attrs, Hash[Symbol, String] base_tags) -> Hash[Symbol, untyped]
+        def create_database_tier: (Symbol name, ArchitectureReference arch_ref, WebApplicationAttributes arch_attrs, Hash[Symbol, String] base_tags) -> Hash[Symbol, untyped]
+        def create_compute_tier: (Symbol name, ArchitectureReference arch_ref, WebApplicationAttributes arch_attrs, Hash[Symbol, String] base_tags) -> Hash[Symbol, untyped]
+        def create_load_balancer_tier: (Symbol name, ArchitectureReference arch_ref, WebApplicationAttributes arch_attrs, Hash[Symbol, String] base_tags) -> Hash[Symbol, untyped]
+        def create_monitoring_tier: (Symbol name, ArchitectureReference arch_ref, WebApplicationAttributes arch_attrs, Hash[Symbol, String] base_tags) -> Hash[Symbol, untyped]
+        
+        def generate_user_data: (Symbol name, ArchitectureReference arch_ref, WebApplicationAttributes arch_attrs) -> String
+        def generate_dashboard_body: (Symbol name, ArchitectureReference arch_ref, WebApplicationAttributes arch_attrs) -> String
+      end
+
+      # Microservices Architecture Types
+      module Microservices
+        include Base
+
+        class MicroservicesPlatformAttributes < Dry::Struct
+          attribute platform_name: String
+          attribute environment: String
+          attribute vpc_cidr: String
+          attribute availability_zones: Array[String]
+          attribute service_mesh: String
+          attribute service_discovery: bool
+          attribute circuit_breaker: bool
+          attribute distributed_tracing: bool
+          attribute orchestrator: String
+          attribute container_registry: String
+          attribute api_gateway: bool
+          attribute shared_database: bool
+          attribute message_queue: String
+          attribute shared_cache: bool
+          attribute centralized_logging: bool
+          attribute metrics_collection: bool
+          attribute log_retention_days: Integer
+          attribute mutual_tls: bool
+          attribute rbac_enabled: bool
+          attribute secrets_management: bool
+          attribute tags: Hash[Symbol, String]
+        end
+
+        class MicroserviceAttributes < Dry::Struct
+          attribute service_name: String
+          attribute runtime: String
+          attribute port: Integer
+          attribute health_check_path: String
+          attribute min_instances: Integer
+          attribute max_instances: Integer
+          attribute desired_instances: Integer
+          attribute cpu_threshold: Integer
+          attribute memory_threshold: Integer
+          attribute database_type: String
+          attribute database_size: String
+          attribute cache_enabled: bool
+          attribute security_level: String
+          attribute expose_publicly: bool
+          attribute depends_on: Array[String]
+          attribute external_apis: Array[String]
+          attribute tags: Hash[Symbol, String]
+        end
+
+        def microservices_platform_architecture: (Symbol name, ?Hash[Symbol, untyped] attributes) -> ArchitectureReference
+        def microservice_architecture: (Symbol name, platform_ref: ArchitectureReference, ?attributes: Hash[Symbol, untyped]) -> ArchitectureReference
+
+        private
+
+        def create_orchestration_platform: (Symbol name, ArchitectureReference arch_ref, MicroservicesPlatformAttributes platform_attrs, Hash[Symbol, String] base_tags) -> Hash[Symbol, untyped]
+        def create_shared_services: (Symbol name, ArchitectureReference arch_ref, MicroservicesPlatformAttributes platform_attrs, Hash[Symbol, String] base_tags) -> Hash[Symbol, untyped]
+        def create_service_mesh: (Symbol name, ArchitectureReference arch_ref, MicroservicesPlatformAttributes platform_attrs, Hash[Symbol, String] base_tags) -> Hash[Symbol, untyped]
+        def create_observability_stack: (Symbol name, ArchitectureReference arch_ref, MicroservicesPlatformAttributes platform_attrs, Hash[Symbol, String] base_tags) -> Hash[Symbol, untyped]
+        def create_security_services: (Symbol name, ArchitectureReference arch_ref, MicroservicesPlatformAttributes platform_attrs, Hash[Symbol, String] base_tags) -> Hash[Symbol, untyped]
+        
+        def create_service_database: (Symbol name, ArchitectureReference arch_ref, ArchitectureReference platform_ref, MicroserviceAttributes service_attrs, Hash[Symbol, String] base_tags) -> untyped
+        def create_service_compute: (Symbol name, ArchitectureReference arch_ref, ArchitectureReference platform_ref, MicroserviceAttributes service_attrs, Hash[Symbol, String] base_tags) -> Hash[Symbol, untyped]
+        def create_service_security: (Symbol name, ArchitectureReference arch_ref, ArchitectureReference platform_ref, MicroserviceAttributes service_attrs, Hash[Symbol, String] base_tags) -> Hash[Symbol, untyped]
+        def create_service_monitoring: (Symbol name, ArchitectureReference arch_ref, ArchitectureReference platform_ref, MicroserviceAttributes service_attrs, Hash[Symbol, String] base_tags) -> Hash[Symbol, untyped]
+        
+        def create_db_subnet_group: (Symbol name, ArchitectureReference platform_ref, Hash[Symbol, String] base_tags) -> untyped
+        def create_task_execution_role: (Symbol name, Hash[Symbol, String] base_tags) -> untyped
+        def generate_container_definition: (Symbol name, ArchitectureReference arch_ref, MicroserviceAttributes service_attrs) -> String
+        def generate_platform_dashboard_body: (Symbol name, ArchitectureReference arch_ref, MicroservicesPlatformAttributes platform_attrs) -> String
+      end
+
+      # Data Processing Architecture Types
+      module DataProcessing
+        include Base
+
+        class DataLakeAttributes < Dry::Struct
+          attribute data_lake_name: String
+          attribute environment: String
+          attribute vpc_cidr: String
+          attribute availability_zones: Array[String]
+          attribute data_sources: Array[String]
+          attribute real_time_processing: bool
+          attribute batch_processing: bool
+          attribute raw_data_retention_days: Integer
+          attribute processed_data_retention_days: Integer
+          attribute data_encryption: bool
+          attribute cross_region_replication: bool
+          attribute batch_processing_schedule: String
+          attribute streaming_buffer_size: Integer
+          attribute streaming_buffer_interval: Integer
+          attribute data_warehouse: String
+          attribute machine_learning: bool
+          attribute business_intelligence: bool
+          attribute emr_enabled: bool
+          attribute glue_enabled: bool
+          attribute lambda_enabled: bool
+          attribute tags: Hash[Symbol, String]
+        end
+
+        class StreamingArchitectureAttributes < Dry::Struct
+          attribute stream_name: String
+          attribute stream_type: String
+          attribute shard_count: Integer
+          attribute retention_hours: Integer
+          attribute stream_processing_framework: String
+          attribute windowing_strategy: String
+          attribute window_size_minutes: Integer
+          attribute output_destinations: Array[String]
+          attribute error_handling: String
+          attribute monitoring_enabled: bool
+          attribute alerting_enabled: bool
+          attribute tags: Hash[Symbol, String]
+        end
+
+        def data_lake_architecture: (Symbol name, ?Hash[Symbol, untyped] attributes) -> ArchitectureReference
+        def streaming_data_architecture: (Symbol name, ?Hash[Symbol, untyped] attributes) -> ArchitectureReference
+
+        private
+
+        def create_data_storage_tier: (Symbol name, ArchitectureReference arch_ref, DataLakeAttributes data_attrs, Hash[Symbol, String] base_tags) -> Hash[Symbol, untyped]
+        def create_data_ingestion_tier: (Symbol name, ArchitectureReference arch_ref, DataLakeAttributes data_attrs, Hash[Symbol, String] base_tags) -> Hash[Symbol, untyped]
+        def create_data_processing_tier: (Symbol name, ArchitectureReference arch_ref, DataLakeAttributes data_attrs, Hash[Symbol, String] base_tags) -> Hash[Symbol, untyped]
+        def create_analytics_tier: (Symbol name, ArchitectureReference arch_ref, DataLakeAttributes data_attrs, Hash[Symbol, String] base_tags) -> Hash[Symbol, untyped]
+        def create_data_security_tier: (Symbol name, ArchitectureReference arch_ref, DataLakeAttributes data_attrs, Hash[Symbol, String] base_tags) -> Hash[Symbol, untyped]
+        def create_data_monitoring_tier: (Symbol name, ArchitectureReference arch_ref, DataLakeAttributes data_attrs, Hash[Symbol, String] base_tags) -> Hash[Symbol, untyped]
+        
+        def create_streaming_ingestion: (Symbol name, ArchitectureReference arch_ref, StreamingArchitectureAttributes stream_attrs, Hash[Symbol, String] base_tags) -> Hash[Symbol, untyped]
+        def create_stream_processing: (Symbol name, ArchitectureReference arch_ref, StreamingArchitectureAttributes stream_attrs, Hash[Symbol, String] base_tags) -> Hash[Symbol, untyped]
+        def create_streaming_outputs: (Symbol name, ArchitectureReference arch_ref, StreamingArchitectureAttributes stream_attrs, Hash[Symbol, String] base_tags) -> Hash[Symbol, untyped]
+        def create_streaming_monitoring: (Symbol name, ArchitectureReference arch_ref, StreamingArchitectureAttributes stream_attrs, Hash[Symbol, String] base_tags) -> Hash[Symbol, untyped]
+        
+        def create_firehose_role: (Symbol name, ArchitectureReference arch_ref, Hash[Symbol, String] base_tags) -> untyped
+        def generate_data_dashboard_body: (Symbol name, ArchitectureReference arch_ref, DataLakeAttributes data_attrs) -> String
+        def generate_streaming_dashboard_body: (Symbol name, ArchitectureReference arch_ref, StreamingArchitectureAttributes stream_attrs) -> String
+      end
+    end
+
+    # Example architecture compositions
+    module Examples
+      include Patterns::WebApplication
+      include Patterns::Microservices
+      include Patterns::DataProcessing
+
+      def ecommerce_platform_architecture: (Symbol name, ?Hash[Symbol, untyped] attributes) -> ArchitectureReference
+      def multi_region_saas_architecture: (Symbol name, ?Hash[Symbol, untyped] attributes) -> ArchitectureReference
+      def ml_platform_architecture: (Symbol name, ?Hash[Symbol, untyped] attributes) -> ArchitectureReference
+      def devops_platform_architecture: (Symbol name, ?Hash[Symbol, untyped] attributes) -> ArchitectureReference
+
+      def composite_resource_name: (Symbol platform_name, Symbol architecture_type, Symbol resource_name) -> Symbol
+      def share_resources_between_architectures: (ArchitectureReference source_arch, ArchitectureReference target_arch, ?Array[Symbol] shared_resources) -> void
+    end
+  end
+end

data/sig/pangea/entities/namespace.rbs

@@ -0,0 +1,37 @@
+# sig/pangea/entities/namespace.rbs
+
+module Pangea
+  module Entities
+    class Namespace < Dry::Struct
+      class StateConfig < Dry::Struct
+        attr_reader bucket: String?
+        attr_reader region: String
+        attr_reader lock: String?
+        
+        def validate_s3!: () -> void
+      end
+      
+      class State < Dry::Struct
+        attr_reader type: :s3 | :local
+        attr_reader config: StateConfig
+        
+        def s3?: () -> bool
+        def local?: () -> bool
+      end
+      
+      attr_reader name: String
+      attr_reader state: State
+      attr_reader description: String?
+      attr_reader tags: Hash[Symbol, untyped]
+      
+      def s3_backend?: () -> bool
+      def local_backend?: () -> bool
+      def state_config: () -> Hash[Symbol, String | Symbol | nil]
+      def s3_config: () -> Hash[Symbol, String]
+      def to_terraform_backend: () -> Hash[Symbol, Hash[Symbol, untyped]]
+    end
+    
+    class ValidationError < StandardError
+    end
+  end
+end