belt 0.1.3 → 0.1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b12c5b4c22f46e0d4c80c10de7ee88f41bbcbb8a8e14a68b9033d19979a6c5af
-  data.tar.gz: d699a6f241fb01a111545450cb024d409e099d9e8617b788eee6fa1a47021a20
+  metadata.gz: d40f2f591f9daeb3ee7a04cebbb5399268bb181771ccaeddb036ca100159dcfd
+  data.tar.gz: 77a31c0cf454675261c2103cfc66ba391d879a6fdd24b7f7df2a05fdf7a3313c
 SHA512:
-  metadata.gz: c1a17ba50a432b6f84103129394524c1fcaf40abadc89eb59dec7dd93b9e68ef6fda35444c45486c06f030d123816c7ac99b4d7b9320ba02485d9b70716cdb46
-  data.tar.gz: dab18cbb83517e05e404755923b6ce90dd45a8e155516e07649c63285f83f7ef0ec3d5cc8d62f9f7dd08553f8596d5ed0bb0298fc687a8167c0482bee44492dd
+  metadata.gz: b8e1a4a0bb6127fe6216f11f218b4ad9c835acf04b45b163c711ebec98dd9153016b8dc09136bfeeea1b34a6f83d45831e407aa5db831601872a5df1d303f0ad
+  data.tar.gz: b8dc9e16e672b73b99afcae96d268c8ab8d7eac0fbd30b5a82bffcc6f34b6a4189b1c14af84b55d0d5d1458de088c91984a41ff9bd5e30b5264a9e24af3444f6

data/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## Unreleased
+
+## 0.1.4
+
+### Bug fixes
+
+- Accept optional `environment` keyword on terraform commands so `belt destroy environment dev` works (mirrors `belt generate environment`). Short form `belt destroy dev` still works.
+- Sanitize app names for S3 bucket names in `belt setup state` (and env/frontend templates): underscores are converted to hyphens so names like `my_app` produce valid buckets (`my-app-terraform-state`)
+
 ## 0.1.1
 
 ### `belt routes` CLI command

data/README.md

@@ -112,17 +112,18 @@ That's it. `lambda_handler` is automatically your Lambda function handler. It:
 - Catches unhandled errors and returns proper CORS-enabled error responses
 - Calls your `execute` method for routing
 
-### 5. Configure the Belt Terraform provider
+### 5. Configure the Conveyor Belt Terraform provider
 
-The Belt Terraform provider (formerly Dispatcher) handles Lambda packaging, API Gateway routing, and IAM permissions.
+The [Conveyor Belt](https://registry.terraform.io/providers/stowzilla/conveyor-belt) Terraform provider (formerly Dispatcher) handles Lambda packaging, API Gateway routing, and IAM permissions.
 
 Add the provider to your Terraform config:
 
 ```hcl
 terraform {
   required_providers {
-    belt = {
-      source = "stowzilla/belt"
+    conveyor-belt = {
+      source  = "stowzilla/conveyor-belt"
+      version = "~> 0.0.1"
     }
   }
 }

data/lib/belt/cli/app_detection.rb

@@ -11,6 +11,12 @@ module Belt
         end
         File.basename(Dir.pwd)
       end
+
+      # S3 bucket names follow DNS rules — underscores are not allowed.
+      # App names often use underscores (Ruby namespaces); convert for S3.
+      def s3_safe_name(name)
+        name.to_s.downcase.tr('_', '-')
+      end
     end
   end
 end

data/lib/belt/cli/env_resolver.rb

@@ -3,7 +3,17 @@
 module Belt
   module CLI
     module EnvResolver
+      # Resolve the target environment from CLI args or BELT_ENV.
+      #
+      # Accepts an optional "environment" keyword so terraform commands mirror
+      # `belt generate environment <name>`:
+      #   belt destroy environment dev
+      #   belt apply environment staging
+      # as well as the short form:
+      #   belt destroy dev
       def self.resolve(args)
+        args.shift if args.first == 'environment'
+
         if args.first && !args.first.start_with?('-')
           args.shift
         else

data/lib/belt/cli/setup_command.rb

@@ -134,9 +134,9 @@ module Belt
         if @custom_bucket
           @custom_bucket
         elsif @env_name
-          "#{@app_name}-terraform-state-#{@env_name}"
+          s3_safe_name("#{@app_name}-terraform-state-#{@env_name}")
         else
-          "#{@app_name}-terraform-state"
+          s3_safe_name("#{@app_name}-terraform-state")
         end
       end
 

data/lib/belt/cli/terraform_command.rb

@@ -11,10 +11,11 @@ module Belt
         env = EnvResolver.resolve(args)
 
         if env.nil?
-          puts "Usage: belt #{action} <environment> [terraform flags...]"
+          puts "Usage: belt #{action} [environment] <name> [terraform flags...]"
           puts "\nYou can also set BELT_ENV to skip the environment argument."
           puts "\nExamples:"
           puts "  belt #{action} wups"
+          puts "  belt #{action} environment dev"
           puts "  belt #{action} dev01"
           puts "  BELT_ENV=wups belt #{action}"
           puts '  belt plan staging -target=module.lambda'

data/lib/belt/cli.rb

@@ -89,11 +89,11 @@ module Belt
           setup tables <env>                          Generate DynamoDB tables from schema
           setup frontend <env>                        Generate S3 + CloudFront infrastructure
           deploy frontend <env>                       Build and deploy frontend to AWS
-          init <env>                                  terraform init for environment
-          plan <env>                                  terraform plan for environment
-          apply <env>                                 terraform apply for environment
-          destroy <env>                               terraform destroy for environment
-          output <env>                                terraform output for environment
+          init [environment] <env>                    terraform init for environment
+          plan [environment] <env>                    terraform plan for environment
+          apply [environment] <env>                   terraform apply for environment
+          destroy [environment] <env>                 terraform destroy for environment
+          output [environment] <env>                  terraform output for environment
           --version                                   Show Belt version
 
         Rake Tasks:

data/lib/belt/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Belt
-  VERSION = '0.1.3'
+  VERSION = '0.1.4'
 end

data/lib/templates/environment/backend.tf.erb

@@ -1,6 +1,6 @@
 terraform {
   backend "s3" {
-    bucket  = "<%= @app_name %>-terraform-state"
+    bucket  = "<%= s3_safe_name(@app_name) %>-terraform-state"
     key     = "<%= @env_name %>/terraform.tfstate"
     region  = "us-east-1"
     encrypt = true

data/lib/templates/environment/main.tf.erb

@@ -8,9 +8,9 @@ terraform {
       source  = "hashicorp/random"
       version = "~> 3.0"
     }
-    dispatcher = {
-      source  = "terraform.local/stowzilla/dispatcher"
-      version = "99.0.0"
+    conveyor-belt = {
+      source  = "stowzilla/conveyor-belt"
+      version = "~> 0.0.1"
     }
   }
 }
@@ -27,12 +27,12 @@ provider "aws" {
   }
 }
 
-provider "dispatcher" {
+provider "conveyor-belt" {
   environment = var.environment
   aws_region  = var.aws_region
 }
 
-resource "dispatcher" "main" {
+resource "conveyor_belt" "main" {
   source            = "${path.module}/../routes.tf.rb"
   app_name          = var.app_name
   lambda_source_dir = "${path.module}/../../lambda"

data/lib/templates/frontend_infra/frontend.tf.erb

@@ -9,7 +9,7 @@ resource "random_string" "frontend_suffix" {
 
 # S3 bucket for frontend static assets
 resource "aws_s3_bucket" "frontend" {
-  bucket = "<%= @app_name %>-frontend-${var.environment}-${random_string.frontend_suffix.result}"
+  bucket = "<%= s3_safe_name(@app_name) %>-frontend-${var.environment}-${random_string.frontend_suffix.result}"
 
   lifecycle {
     ignore_changes = [bucket]
@@ -155,5 +155,5 @@ output "frontend_url" {
 }
 
 output "api_url" {
-  value = values(dispatcher.main.api_gateway_urls)[0]
+  value = values(conveyor_belt.main.api_gateway_urls)[0]
 }

data/lib/templates/new_app/AGENTS.md.erb

@@ -6,7 +6,7 @@ This file explains the project structure, tooling, and conventions for AI agents
 
 - **Belt** — CLI and runtime framework (like Rails for serverless). Provides Lambda handler, action router, controller base class, and CLI tooling.
 - **ActiveItem** — ActiveRecord-like ORM for DynamoDB. Models inherit from `ActiveItem::Base`.
-- **Dispatcher** — Terraform provider that reads a Ruby DSL (`routes.tf.rb`) and creates API Gateway + Lambda + IAM infrastructure.
+- **Conveyor Belt** — Terraform provider that reads a Ruby DSL (`routes.tf.rb`) and creates API Gateway + Lambda + IAM infrastructure.
 - **Lambda Loadout** — Lambda cold-start optimizer (auto-required by Belt).
 
 ## Project Structure
@@ -23,7 +23,7 @@ This file explains the project structure, tooling, and conventions for AI agents
 │   ├── lib/routes/                     # Route manifests (auto-generated)
 │   └── Gemfile                         # Lambda-specific dependencies
 ├── infrastructure/
-│   ├── routes.tf.rb                    # API routes (Dispatcher DSL)
+│   ├── routes.tf.rb                    # API routes (Conveyor Belt DSL)
 │   ├── schema.tf.rb                    # Model schema definitions
 │   └── <env>/                          # Per-environment Terraform configs
 ├── Gemfile                             # Project-level dependencies
@@ -44,6 +44,7 @@ belt init <env>                                        # terraform init
 belt plan <env>                                        # terraform plan
 belt apply <env>                                       # terraform apply
 belt destroy <env>                                     # terraform destroy
+belt destroy environment <env>                         # same (mirrors generate environment)
 belt output <env>                                      # terraform output
 ```
 
@@ -58,7 +59,7 @@ belt output <env>                                      # terraform output
    end
    ```
 
-2. Dispatcher creates an API Gateway where the namespace becomes a base path mapping. URLs look like:
+2. Conveyor Belt creates an API Gateway where the namespace becomes a base path mapping. URLs look like:
    ```
    https://api.<env>.example.com/<%= @app_name %>/things
    ```

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: belt
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.1.4
 platform: ruby
 authors:
 - Stowzilla