belt 0.1.3 → 0.1.5

data/lib/belt/cli.rb

@@ -11,6 +11,8 @@ require_relative 'cli/frontend_deploy_command'
 require_relative 'cli/views_command'
 require_relative 'cli/setup_command'
 require_relative 'cli/terraform_command'
+require_relative 'cli/deploy_command'
+require_relative 'cli/server_command'
 require_relative 'cli/routes_command'
 require_relative 'cli/tasks_command'
 require_relative 'cli/console_command'
@@ -24,15 +26,8 @@ module Belt
       %w[console c] => Belt::CLI::ConsoleCommand,
       %w[tasks --tasks -T] => Belt::CLI::TasksCommand,
       'setup' => Belt::CLI::SetupCommand,
-      'deploy' => lambda { |args|
-        subcommand = args.shift
-        if subcommand == 'frontend'
-          Belt::CLI::FrontendDeployCommand.run(args)
-        else
-          puts 'Usage: belt deploy frontend <environment>'
-          exit 1
-        end
-      },
+      'deploy' => Belt::CLI::DeployCommand,
+      %w[server s] => Belt::CLI::ServerCommand,
       %w[version --version -v] => ->(_args) { puts "Belt #{Belt::VERSION}" }
     }.freeze
 
@@ -80,6 +75,10 @@ module Belt
           generate frontend <react|vue|svelte>        Scaffold a frontend app
           generate views <resource> [fields...]       Generate React pages for REST actions
           generate environment <name>                 Create a new environment
+          server                                      Start local dev server (frontend)
+          s                                           Alias for server
+          deploy [environment]                        Deploy to AWS (init → plan → apply)
+          deploy frontend <env>                       Build and deploy frontend to AWS
           routes [-g PATTERN] [-f json]               Show route definitions
           console                                     Start an interactive console (IRB)
           c                                           Alias for console
@@ -88,12 +87,11 @@ module Belt
           setup state                                 Create/select S3 state bucket
           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:
@@ -110,8 +108,11 @@ module Belt
           belt new blog --frontend react
           belt generate resource post title:string content:text status:string
           belt generate frontend react
-          belt setup frontend wups
+          belt server                   # Start local frontend server
+          belt deploy                   # Deploy dev to AWS
+          belt deploy prod --auto       # Deploy prod without confirmation
           belt deploy frontend wups
+          belt setup frontend wups
           belt apply wups
           belt tasks                    # list all rake tasks
           belt lambda:build_layer       # run a rake task directly

data/lib/belt/controllers/welcome_controller.rb

@@ -0,0 +1,102 @@
+# frozen_string_literal: true
+
+require 'base64'
+
+module Belt
+  # Gem-embedded welcome controller that serves the default "it works!" page.
+  # Resolved via the ActionRouter's Belt:: namespace fallback when no app-defined
+  # WelcomeController exists. Gets replaced once the user defines their own root route.
+  class WelcomeController < BeltController::Base
+    skip_before_action :authenticate!
+
+    ASSETS_DIR = File.expand_path('../assets', __dir__)
+
+    def show
+      title = ENV.fetch('WELCOME_TITLE', 'Welcome to Belt')
+      subtitle = ENV.fetch('WELCOME_SUBTITLE', 'API Gateway → Lambda → DynamoDB — all connected.')
+      app_name = ENV.fetch('APP_NAME', 'my-app')
+
+      html_response(render_welcome_page(title: title, subtitle: subtitle, app_name: app_name))
+    end
+
+    private
+
+    def render_welcome_page(title:, subtitle:, app_name:)
+      <<~HTML
+        <!DOCTYPE html>
+        <html lang="en">
+        <head>
+          <meta charset="UTF-8">
+          <meta name="viewport" content="width=device-width, initial-scale=1.0">
+          <title>#{escape_html(title)}</title>
+          <style>#{welcome_css}</style>
+        </head>
+        <body>
+          <div class="hero">
+            <img src="data:image/png;base64,#{background_image_base64}" alt="Belt" class="hero-bg" />
+            <div class="overlay">
+              <h1>#{escape_html(title)}</h1>
+              <p class="subtitle">#{escape_html(subtitle)}</p>
+            </div>
+          </div>
+          <div class="container">
+            <div class="stack-check">
+              <div class="check-item check-pass">
+                <span class="icon">✓</span>
+                <span>API Gateway</span>
+              </div>
+              <div class="arrow">→</div>
+              <div class="check-item check-pass">
+                <span class="icon">✓</span>
+                <span>Lambda</span>
+              </div>
+              <div class="arrow">→</div>
+              #{dynamodb_check_html}
+            </div>
+            <div class="next-steps">
+              <h2>Next Steps</h2>
+              <ol>
+                <li>Generate a resource: <code>belt g resource post title:string body:text</code></li>
+                <li>Deploy: <code>belt deploy</code></li>
+                <li>This page will be replaced once you define your own root route.</li>
+              </ol>
+            </div>
+          </div>
+        </body>
+        </html>
+      HTML
+    end
+
+    def dynamodb_check_html
+      if dynamodb_connected?
+        '<div class="check-item check-pass"><span class="icon">✓</span><span>DynamoDB</span></div>'
+      else
+        '<div class="check-item check-warn"><span class="icon">⚠</span><span>DynamoDB</span></div>'
+      end
+    end
+
+    def dynamodb_connected?
+      return false unless defined?(Aws::DynamoDB::Client)
+
+      client = Aws::DynamoDB::Client.new
+      client.list_tables(limit: 1)
+      true
+    rescue StandardError
+      false
+    end
+
+    def escape_html(text)
+      text.to_s.gsub('&', '&amp;').gsub('<', '&lt;').gsub('>', '&gt;').gsub('"', '&quot;')
+    end
+
+    def welcome_css
+      @welcome_css ||= File.read(File.join(ASSETS_DIR, 'welcome.css'))
+    end
+
+    def background_image_base64
+      @background_image_base64 ||= Base64.strict_encode64(
+        File.binread(File.join(ASSETS_DIR, 'belt-default.png'))
+      )
+    end
+  end
+end

data/lib/belt/version.rb

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

data/lib/belt.rb

@@ -55,3 +55,4 @@ module Belt
 end
 
 require_relative 'belt_controller/base'
+require_relative 'belt/controllers/welcome_controller'

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,13 @@ provider "aws" {
   }
 }
 
-provider "dispatcher" {
+provider "conveyor-belt" {
   environment = var.environment
   aws_region  = var.aws_region
 }
 
-resource "dispatcher" "main" {
+resource "conveyor_belt" "main" {
+  provider          = conveyor-belt
   source            = "${path.module}/../routes.tf.rb"
   app_name          = var.app_name
   lambda_source_dir = "${path.module}/../../lambda"

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

@@ -0,0 +1,9 @@
+output "api_url" {
+  description = "API Gateway base URL"
+  value       = conveyor_belt.main.api_gateway_urls
+}
+
+output "lambda_functions" {
+  description = "Map of action names to Lambda function ARNs"
+  value       = conveyor_belt.main.lambda_functions
+}

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
    ```

data/lib/templates/new_app/infrastructure/routes.tf.rb.erb

@@ -1,5 +1,6 @@
 Belt.application.routes.draw do
   namespace :<%= @app_name %> do
+    get "/", action: :show, controller: :welcome
     # resources :posts
   end
 end

data/lib/templates/new_app/lambda/lib/routes/routes.rb.erb

@@ -2,6 +2,7 @@
 
 module Routes
   <%= @module_name.upcase %> = [
+    { verb: 'GET', path: '/', controller: 'welcome', action: 'show' },
     # { verb: 'GET', path: '/posts', controller: 'posts', action: 'index' },
     # { verb: 'POST', path: '/posts', controller: 'posts', action: 'create' },
     # { verb: 'GET', path: '/posts/{id}', controller: 'posts', action: 'show' },

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: belt
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.1.5
 platform: ruby
 authors:
 - Stowzilla
@@ -52,10 +52,13 @@ files:
 - exe/belt
 - lib/belt.rb
 - lib/belt/action_router.rb
+- lib/belt/assets/belt-default.png
+- lib/belt/assets/welcome.css
 - lib/belt/cli.rb
 - lib/belt/cli/app_detection.rb
 - lib/belt/cli/bucket_security.rb
 - lib/belt/cli/console_command.rb
+- lib/belt/cli/deploy_command.rb
 - lib/belt/cli/env_resolver.rb
 - lib/belt/cli/environment_command.rb
 - lib/belt/cli/frontend_command.rb
@@ -66,11 +69,13 @@ files:
 - lib/belt/cli/routes_command.rb
 - lib/belt/cli/routes_command/route_inference.rb
 - lib/belt/cli/routes_command/schema_loader.rb
+- lib/belt/cli/server_command.rb
 - lib/belt/cli/setup_command.rb
 - lib/belt/cli/tables_command.rb
 - lib/belt/cli/tasks_command.rb
 - lib/belt/cli/terraform_command.rb
 - lib/belt/cli/views_command.rb
+- lib/belt/controllers/welcome_controller.rb
 - lib/belt/helpers/cors_origin.rb
 - lib/belt/helpers/error_logging.rb
 - lib/belt/helpers/response.rb
@@ -84,6 +89,7 @@ files:
 - lib/belt_controller/base.rb
 - lib/templates/environment/backend.tf.erb
 - lib/templates/environment/main.tf.erb
+- lib/templates/environment/outputs.tf.erb
 - lib/templates/environment/terraform.tfvars.erb
 - lib/templates/environment/variables.tf.erb
 - lib/templates/frontend/react/index.html.erb