pangea 0.0.47 → 0.0.48

data/README.md

@@ -1,236 +1,59 @@
-# Pangea
+# pangea
 
-[![CI Status](https://github.com/drzln/pangea/workflows/CI/badge.svg)](https://github.com/drzln/pangea/actions)
-[![Ruby](https://img.shields.io/badge/ruby-3.1%2B-red.svg)](https://www.ruby-lang.org/)
-[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
-[![Gem Version](https://badge.fury.io/rb/pangea.svg)](https://badge.fury.io/rb/pangea)
+## Configuration
 
-**Scalable infrastructure management with Ruby DSL and template-level state isolation**
+### Configuration Locations
 
-Pangea is an automation-first infrastructure management tool that addresses key Terraform/OpenTofu scalability challenges through template-level state isolation, Ruby DSL compilation, and configuration-driven namespace management.
+Configuration behavior is merge behavior of directories in top/down order listed.
 
-## Overview
+- /opt/share/pangea.<ext>
+- /etc/pangea/pangea.<ext>
+- /etc/pangea/conf.d/\*.<ext>
+- $XDG_CONFIG_HOME/pangea/pangea.<ext>
+- $XDG_CONFIG_HOME/pangea/conf.d/\*.<ext>
+- pangea.<ext>
+- pangea/config.d/\*.<ext>
+- .pangea.<ext>
+- .pangea/config.d/\*.<ext>
+- StitchFile
 
-Pangea compiles Ruby DSL templates to Terraform JSON and manages infrastructure with isolated workspaces per template, enabling infrastructure that scales with team size and complexity.
+obs.
 
-## Prerequisites
+<ext> is enum rb|json|yml|yaml|toml|nix
 
-- Ruby 3.1+ (Ruby 3.3+ recommended)
-- Terraform 1.5+ or OpenTofu 1.6+
+### Configuration Notes
 
-## Installation
+Top level structure is a namespace
 
-### From RubyGems
+namespaces can receive terraform commands
+namespaces have multiple projects within them
+projects represent a single instance of state
+projects can have multiple modules.
+modules pack ruby code together to be run on a single projects
+a module may be used in multiple projects but a project has a direct association to a namespace
+a project cannot be present in multiple namespaces.
 
-```bash
-gem install pangea
-```
-
-### From Source
-
-```bash
-git clone https://github.com/drzln/pangea.git
-cd pangea
-bundle install
-bundle exec rake install
-```
-
-### Using Bundler
-
-Add to your Gemfile:
-
-```ruby
-gem 'pangea'
-```
-
-Then run:
-
-```bash
-bundle install
-```
-
-## Usage
-
-### Template Structure
-
-Create Ruby files with template declarations:
-
-```ruby
-# infrastructure.rb
-template :web_server do
-  provider :aws do
-    region "us-east-1"
-  end
-
-  resource :aws_instance, :web do
-    ami "ami-12345678"
-    instance_type "t2.micro"
+modules can be nested indefinitely.
+its modules all the way down.
 
-    tags do
-      Name "WebServer"
-    end
-  end
-end
+you can have modules provide only ruby functions.
+you can have modules provide resources.
+you can have modules call other modules.
 
-template :database do
-  provider :aws do
-    region "us-east-1"
-  end
+if something is runnable then it can receive terraform commands
+the smallest runnable item is a project
+namespaces are also runnable
 
-  resource :aws_rds_instance, :main do
-    engine "postgres"
-    instance_class "db.t2.micro"
-  end
-end
-```
-
-### Configuration
-
-Create `pangea.yaml` in your project root (see `pangea.yaml.example` for a complete example):
-
-```yaml
-default_namespace: development
-
-namespaces:
-  development:
-    state:
-      type: local
-      path: "terraform.tfstate"
-
-  production:
-    state:
-      type: s3
-      bucket: "terraform-state-prod"
-      key: "pangea/terraform.tfstate"
-      region: "us-east-1"
-      dynamodb_table: "terraform-locks"
-```
-
-### Commands
+flows are groups of runnable terraform commands in a DAG
+whose nodes are either namespace or namespace.project
 
-#### Plan Changes
+#### Namespace
 
-```bash
-# Plan all templates in file (uses default namespace)
-pangea plan infrastructure.rb
+namespace is a DAG with fixed nodes
 
-# Plan specific template
-pangea plan infrastructure.rb --template web_server
-
-# Plan with specific namespace
-pangea plan infrastructure.rb --namespace production
-
-# Show compiled Terraform JSON without running plan
-pangea plan infrastructure.rb --show-compiled
-
-# Show compiled JSON for specific template
-pangea plan infrastructure.rb --template web_server --show-compiled
 ```
-
-#### Apply Changes
-
-```bash
-# Apply (auto-approves by default)
-pangea apply infrastructure.rb --template web_server
-
-# Apply with confirmation prompt (rare)
-pangea apply infrastructure.rb --template web_server --no-auto-approve
+namespace -> site -> project
 ```
 
-#### Destroy Infrastructure
-
-```bash
-# Destroy (auto-approves by default)
-pangea destroy infrastructure.rb --template web_server
-
-# Destroy with confirmation prompt (rare)
-pangea destroy infrastructure.rb --template web_server --no-auto-approve
-```
-
-## Key Features
-
-### 🏗️ Template-Level State Isolation
-
-- Each template gets its own workspace and state file
-- More granular than industry standard directory-based approaches
-- Reduces blast radius and enables parallel development
-
-### 🤖 Automation-First Design
-
-- Auto-approval by default for streamlined CI/CD
-- Non-interactive operation for automation workflows
-
-### 📦 Ruby DSL Compilation
-
-- Type-safe resource functions with RBS definitions
-- Compile-time validation using dry-struct
-- Access to full Ruby ecosystem for complex logic
-
-### 🌐 Multi-Environment Management
-
-- Configuration-driven namespace management
-- Support for local, S3, and custom backends
-- Automatic state key generation prevents conflicts
-
-## Architecture
-
-- Templates are compiled to separate workspaces
-- Each workspace manages its own Terraform state
-- Namespaces configure shared backend settings
-- No init command needed - initialization is automatic
-
-## Why Pangea?
-
-### vs. Directory-Based Terraform
-
-- **Reduced File Sprawl**: Multiple templates in single files vs scattered directories
-- **Automatic Backend Management**: No manual backend configuration per component
-- **Ruby DSL Power**: Better abstraction than HCL for complex logic
-- **Code Reuse**: Shared helper methods and logic within files
-
-### vs. Terragrunt
-
-- **Configuration Simplicity**: Single YAML file vs multiple terragrunt.hcl files
-- **Template Isolation**: Built-in template-level isolation vs manual workspace management
-- **Ruby Ecosystem**: Access to full Ruby library ecosystem
-- **No DRY Complexity**: Templates handle repetition naturally
-
-### vs. Terraform Workspaces
-
-- **True State Isolation**: Completely separate state files vs shared backend
-- **Security Boundaries**: No cross-template state access
-- **Template Granularity**: Template-specific configurations
-- **Operational Clarity**: Template names match infrastructure components
-
-## Examples
-
-See the [`examples/`](examples/) directory for complete infrastructure templates:
-
-- [Simple Web Server](examples/simple.rb) - Basic single-template example
-- [Scalable Infrastructure](examples/scalable_infrastructure.rb) - Multi-template web application
-- [Advanced ML Infrastructure](examples/advanced_ml_healthcare_infrastructure.rb) - Complex healthcare ML platform
-
-## Contributing
-
-We welcome contributions! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for details on:
-
-- Development setup
-- Running tests
-- Submitting pull requests
-- Code style guidelines
-
-## Community
-
-- [GitHub Discussions](https://github.com/drzln/pangea/discussions) - Questions and community
-- [Issues](https://github.com/drzln/pangea/issues) - Bug reports and feature requests
-- [Security Policy](SECURITY.md) - Reporting security vulnerabilities
-
-## License
-
-This project is licensed under the Apache License 2.0 - see the [LICENSE](LICENSE) file for details.
-
-## Acknowledgments
-
-- Built on [terraform-synthesizer](https://github.com/drzln/terraform-synthesizer) for Ruby-to-Terraform compilation
-- Inspired by the need for better infrastructure-as-code scalability
-- Thanks to all [contributors](https://github.com/drzln/pangea/contributors)
+a project is the smallest component which can receive tf commands
+called like namespace.site.project

data/Rakefile

@@ -1,161 +1,38 @@
 # frozen_string_literal: true
 
-require "bundler/gem_tasks"
+require %(bundler/gem_tasks)
+require %(rubocop/rake_task)
+require %(rspec/core/rake_task)
+require_relative %(lib/pangea/docker)
 
-# Run minimal tests that work with current environment
-desc "Run basic Pangea tests"
-task :spec do
-  puts "Running minimal Pangea tests..."
-  result = system("ruby spec/minimal_test.rb")
-  
-  if result
-    puts "\n✅ Core functionality tests passed!"
-    puts "For full RSpec tests, use: nix develop --command rake rspec"
-  else
-    puts "\n❌ Some tests failed"
-    exit 1
-  end
-end
-
-# Full RSpec tests (requires nix environment)
-desc "Run full RSpec test suite"
-task :rspec do
-  rspec_cmd = "/nix/store/pzakqns6igcsfjxp1fchw3ykzjchcdqpppabjifpr3-pangea/bin/rspec"
-  rspec_cmd = "rspec" unless File.exist?(rspec_cmd)
-  
-  system("#{rspec_cmd} -I lib --require ./spec/spec_helper_fixed")
+RSpec::Core::RakeTask.new(:spec)
+RuboCop::RakeTask.new(:rubocop) do |t|
+  t.options = [%(--display-cop-names)]
 end
 
-# Fallback to regular RSpec if nix version not available
-begin
-  require "rspec/core/rake_task"
-  RSpec::Core::RakeTask.new(:spec_fallback) do |task|
-    task.rspec_opts = '-I lib --require ./spec/spec_helper_fixed'
-  end
-rescue LoadError
-  puts "RSpec not available - using system command instead"
+task :bundix do
+  sh %(bundle lock --update)
+  sh %(bundix)
 end
 
-task :default => :spec
-
-# Type checking with Steep (optional)
-desc "Run type checking with Steep"
-task :typecheck do
-  if system("which steep > /dev/null 2>&1") || system("bundle exec steep --version > /dev/null 2>&1")
-    puts "Running type checking with Steep..."
-    result = system("bundle exec steep check")
-    exit(1) unless result
-  else
-    puts "Steep is not available. Install with: gem install steep"
+namespace :container do
+  task :build do
+    image = Image.new(:pangea)
+    image.build
   end
-end
 
-desc "Run Steep statistics"
-task :type_stats do
-  if system("which steep > /dev/null 2>&1") || system("bundle exec steep --version > /dev/null 2>&1")
-    puts "Generating type coverage statistics..."
-    system("bundle exec steep stats")
-  else
-    puts "Steep is not available. Install with: gem install steep"
+  task :create do
+    container = Container.new(:pangea, :pangea)
+    container.create
   end
-end
 
-# Linting with RuboCop (optional)
-desc "Run RuboCop linting"
-task :rubocop do
-  if system("which rubocop > /dev/null 2>&1") || system("bundle exec rubocop --version > /dev/null 2>&1")
-    puts "Running RuboCop linting..."
-    system("bundle exec rubocop --display-cop-names")
-  else
-    puts "RuboCop is not available. Install with: gem install rubocop"
+  task :start do
+    container = Container.new(:pangea, :pangea)
+    container.start
   end
-end
 
-desc "Auto-correct RuboCop offenses"
-task :rubocop_fix do
-  if system("which rubocop > /dev/null 2>&1") || system("bundle exec rubocop --version > /dev/null 2>&1")
-    system("bundle exec rubocop --auto-correct-all")
-  else
-    puts "RuboCop is not available. Install with: gem install rubocop"
+  task :login do
+    container = Container.new(:pangea, :pangea)
+    container.login
   end
 end
-
-# Documentation generation
-desc "Generate YARD documentation"
-task :docs do
-  puts "Generating documentation with YARD..."
-  system("bundle exec yard doc")
-end
-
-# Quality checks
-desc "Run all quality checks (specs, types, lint)"
-task :quality => [:spec]
-
-# Test coverage
-desc "Run specs with coverage report"
-task :coverage do
-  ENV['COVERAGE'] = 'true'
-  Rake::Task[:spec].invoke
-end
-
-# Property-based testing (if available)
-desc "Run property-based tests"
-task :property_tests do
-  puts "Running property-based tests..."
-  # This would run specific property-based test files
-  system("bundle exec rspec spec/**/*_property_spec.rb")
-end
-
-# Performance tests (if available) 
-desc "Run performance tests"
-task :performance do
-  puts "Running performance tests..."
-  system("bundle exec rspec spec/performance/**/*_spec.rb")
-end
-
-# Integration tests
-desc "Run integration tests"
-task :integration do
-  puts "Running integration tests..."
-  system("bundle exec rspec spec/integration/**/*_spec.rb")
-end
-
-# All tests
-desc "Run all test suites"
-task :test_all => [:spec, :property_tests, :performance, :integration]
-
-# Clean up generated files
-desc "Clean up generated files"
-task :clean do
-  puts "Cleaning up generated files..."
-  FileUtils.rm_rf('.coverage')
-  FileUtils.rm_rf('doc')
-  FileUtils.rm_rf('.yardoc')
-  FileUtils.rm_rf('tmp')
-end
-
-# Setup development environment
-desc "Setup development environment"
-task :setup do
-  puts "Setting up development environment..."
-  system("bundle install")
-  
-  # Create necessary directories
-  FileUtils.mkdir_p(['tmp', 'log', 'spec/fixtures'])
-  
-  puts "Development environment setup complete!"
-  puts ""
-  puts "Available tasks:"
-  puts "  rake spec         - Run all specs"
-  puts "  rake typecheck    - Run type checking"
-  puts "  rake rubocop      - Run linting"
-  puts "  rake quality      - Run all quality checks"
-  puts "  rake coverage     - Run specs with coverage"
-  puts "  rake docs         - Generate documentation"
-  puts "  rake clean        - Clean generated files"
-end
-
-task :bundix do
-  sh %(bundle lock --update)
-  sh %(bundix)
-end

data/bin/pangea

@@ -1,18 +1,4 @@
 #!/usr/bin/env ruby
-# Suppress dry-types warnings about mutable defaults
-ENV['DRY_TYPES_WARNINGS'] = 'false'
-
-# Disable Zeitwerk's kernel require hook before loading dry-rb gems
-# This prevents Zeitwerk from intercepting our requires
-module Zeitwerk
-  module Kernel
-    def self.extended(base)
-      # Don't patch Kernel#require
-    end
-  end
-end
-
 lib = File.expand_path('../lib', __dir__)
 $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
-require 'pangea/cli/application'
-Pangea::CLI::Application.new.run
+require %(pangea/cli)

data/example/config/README.md

@@ -0,0 +1,3 @@
+# example configurations
+
+Configurations used in testing

data/example/config/sample.rb

@@ -0,0 +1,20 @@
+###############################################################################
+# example configurations
+###############################################################################
+
+#######################################
+# minimal
+# namespace {virtual_name} {environment} do
+#   name {name}
+# end
+#
+# there must be a method arg1, arg2 structure
+# plus a single attribute to compile.
+#######################################
+
+namespace :void, :dev do
+  name :void
+end
+
+# end minimal
+# end example configurations