belt 0.1.4 → 0.1.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d40f2f591f9daeb3ee7a04cebbb5399268bb181771ccaeddb036ca100159dcfd
-  data.tar.gz: 77a31c0cf454675261c2103cfc66ba391d879a6fdd24b7f7df2a05fdf7a3313c
+  metadata.gz: 330331693d70f3a18ad04c47b4f0b07c69b6a75538291be891946e12c7863dfc
+  data.tar.gz: 643ed0cad19c1124581d86b7f816ce199d372be0415c03b53c8f9d5f990bc3a9
 SHA512:
-  metadata.gz: b8e1a4a0bb6127fe6216f11f218b4ad9c835acf04b45b163c711ebec98dd9153016b8dc09136bfeeea1b34a6f83d45831e407aa5db831601872a5df1d303f0ad
-  data.tar.gz: b8dc9e16e672b73b99afcae96d268c8ab8d7eac0fbd30b5a82bffcc6f34b6a4189b1c14af84b55d0d5d1458de088c91984a41ff9bd5e30b5264a9e24af3444f6
+  metadata.gz: ca9f5d87f6b8ab597106789e5a381aa3ba6f33b85cc2620552b8c9380ad5508d7f27d5ed34cea52b59858db91ab02653ee4a487044562f7c3c68739c3fa40779
+  data.tar.gz: 36cbc894c45482981d1c3ddd34f0b59dd7e5259dd5de975175af756c54488693e6b0396c44b81b396442149a70ff6067d8d40046cef749d7119d248f49d57990

data/lib/belt/action_router.rb

@@ -155,6 +155,13 @@ module Belt
         end
       end
 
+      # Final fallback: gem-embedded controllers under Belt:: namespace
+      class_name = "#{controller_name.split(%r{[_/]}).map(&:capitalize).join}Controller"
+      belt_class_name = "Belt::#{class_name}"
+      if Belt.const_defined?(class_name, false)
+        return Belt.const_get(class_name, false)
+      end
+
       raise Belt::ActionNotFound, "Controller not found: #{controller_name}"
     end
 

data/lib/belt/assets/welcome.css

@@ -0,0 +1,112 @@
+* { margin: 0; padding: 0; box-sizing: border-box; }
+body {
+  font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+  background: #f8f9fa;
+  color: #2d3748;
+  min-height: 100vh;
+}
+
+/* Hero section — full width background image */
+.hero {
+  position: relative;
+  width: 100%;
+  overflow: hidden;
+}
+.hero-bg {
+  width: 100%;
+  height: auto;
+  display: block;
+}
+.overlay {
+  position: absolute;
+  top: 35%;
+  left: 50%;
+  transform: translate(-50%, -50%);
+  padding: 2rem 3rem;
+  background: rgba(255, 255, 255, 0.88);
+  backdrop-filter: blur(6px);
+  -webkit-backdrop-filter: blur(6px);
+  border-radius: 12px;
+  text-align: center;
+  max-width: 600px;
+  width: 90%;
+  box-shadow: 0 4px 20px rgba(0, 0, 0, 0.1);
+}
+.overlay h1 {
+  font-size: 2.2rem;
+  font-weight: 700;
+  color: #2d3748;
+  margin-bottom: 0.4rem;
+}
+.overlay .subtitle {
+  font-size: 1.1rem;
+  color: #4a5568;
+}
+
+/* Content below the hero */
+.container {
+  max-width: 700px;
+  margin: 0 auto;
+  padding: 2rem;
+}
+.stack-check {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  gap: 0.75rem;
+  margin-bottom: 2rem;
+  flex-wrap: wrap;
+}
+.check-item {
+  display: flex;
+  align-items: center;
+  gap: 0.4rem;
+  padding: 0.5rem 1rem;
+  border-radius: 8px;
+  font-weight: 500;
+}
+.check-pass {
+  background: rgba(39, 174, 96, 0.1);
+  border: 1px solid rgba(39, 174, 96, 0.3);
+  color: #1e8449;
+}
+.check-warn {
+  background: rgba(243, 156, 18, 0.1);
+  border: 1px solid rgba(243, 156, 18, 0.3);
+  color: #d68910;
+}
+.icon { font-size: 1.1rem; }
+.arrow { color: #718096; font-size: 1.2rem; }
+.info {
+  background: #ffffff;
+  border: 1px solid #e2e8f0;
+  border-radius: 12px;
+  padding: 1.5rem;
+  margin-bottom: 1.5rem;
+}
+.info p { margin-bottom: 0.5rem; color: #4a5568; }
+.info p:last-child { margin-bottom: 0; }
+.info strong { color: #2d3748; }
+.info code {
+  background: rgba(99, 45, 145, 0.08);
+  padding: 0.15rem 0.4rem;
+  border-radius: 4px;
+  color: #632d91;
+  font-size: 0.85rem;
+}
+.next-steps {
+  background: #ffffff;
+  border: 1px solid #e2e8f0;
+  border-radius: 12px;
+  padding: 1.5rem;
+}
+.next-steps h2 { font-size: 1.1rem; margin-bottom: 1rem; color: #2d3748; }
+.next-steps ol { padding-left: 1.5rem; }
+.next-steps li { margin-bottom: 0.6rem; color: #4a5568; line-height: 1.5; }
+.next-steps code {
+  background: rgba(99, 45, 145, 0.08);
+  padding: 0.15rem 0.4rem;
+  border-radius: 4px;
+  color: #632d91;
+  font-size: 0.85rem;
+}

data/lib/belt/cli/deploy_command.rb

@@ -0,0 +1,182 @@
+# frozen_string_literal: true
+
+require_relative 'env_resolver'
+require_relative 'terraform_command'
+
+module Belt
+  module CLI
+    class DeployCommand
+      def self.run(args)
+        # Handle `belt deploy frontend <env>` as before
+        if args.first == 'frontend'
+          args.shift
+          Belt::CLI::FrontendDeployCommand.run(args)
+          return
+        end
+
+        auto_approve = false
+        filtered_args = []
+
+        args.each do |arg|
+          case arg
+          when '--auto', '--yes', '-y'
+            auto_approve = true
+          when '-h', '--help'
+            puts help_text
+            exit 0
+          else
+            filtered_args << arg
+          end
+        end
+
+        env = EnvResolver.resolve(filtered_args)
+
+        # Default to the first available environment when none specified
+        if env.nil?
+          available = TerraformCommand.list_environments
+          if available.any?
+            env = available.first
+          else
+            puts 'Usage: belt deploy [environment] [options]'
+            puts "\nDefaults to BELT_ENV or the first available environment."
+            puts "\nOptions:"
+            puts '  --auto, --yes, -y    Skip confirmation prompt (auto-approve)'
+            puts '  -h, --help           Show this help'
+            puts "\nExamples:"
+            puts '  belt deploy                # Deploy dev (or BELT_ENV)'
+            puts '  belt deploy prod           # Deploy to prod'
+            puts '  belt deploy dev --auto     # Deploy without confirmation'
+            puts '  belt deploy frontend dev   # Deploy frontend only'
+            puts "\nNo environments found. Run `belt generate environment dev` first."
+            exit 1
+          end
+        end
+
+        new(env, auto_approve: auto_approve, extra_args: filtered_args).run
+      end
+
+      def self.help_text
+        <<~HELP
+          Deploy your Belt application to AWS.
+
+          Usage: belt deploy [environment] [options]
+                 belt deploy frontend <environment>
+
+          This runs the full deployment lifecycle:
+            1. terraform init    (initialize providers/modules)
+            2. terraform plan    (preview changes)
+            3. Prompt for confirmation (unless --auto)
+            4. terraform apply   (deploy changes)
+
+          Options:
+            --auto, --yes, -y    Skip confirmation prompt (auto-approve)
+            -h, --help           Show this help
+
+          Environment:
+            Defaults to BELT_ENV if set, otherwise requires an argument.
+
+          Examples:
+            belt deploy                # Deploy dev (or BELT_ENV)
+            belt deploy prod           # Deploy to prod
+            belt deploy dev --auto     # Deploy without confirmation (CI mode)
+            belt deploy frontend dev   # Deploy frontend assets only
+        HELP
+      end
+
+      def initialize(env, auto_approve: false, extra_args: [])
+        @env = env
+        @auto_approve = auto_approve
+        @extra_args = extra_args
+        @infra_dir = TerraformCommand.find_infrastructure_dir
+      end
+
+      def run
+        validate!
+        env_dir = File.join(@infra_dir, @env)
+
+        puts "belt → deploying #{@env} (in #{env_dir}/)\n\n"
+
+        Dir.chdir(env_dir) do
+          run_init
+          run_plan
+          return unless confirm_apply
+          run_apply
+        end
+
+        puts "\n✅ Deployed #{@env} successfully!"
+        print_outputs(env_dir)
+        puts "\n   Run `belt server` to view your app locally (auto-connects to the deployed API)."
+      end
+
+      private
+
+      def validate!
+        unless @infra_dir
+          abort "Error: No infrastructure/ directory found.\n" \
+                "Run `belt generate environment #{@env}` first."
+        end
+
+        env_dir = File.join(@infra_dir, @env)
+        return if Dir.exist?(env_dir)
+
+        abort "Error: Environment '#{@env}' not found at #{env_dir}/.\n\n" \
+              "Available environments:\n#{TerraformCommand.list_environments.map { |e| "  #{e}" }.join("\n")}\n\n" \
+              "Create it with: belt generate environment #{@env}"
+      end
+
+      def run_init
+        puts '━━━ terraform init ━━━'
+        success = system('terraform', 'init')
+        abort "\n✗ terraform init failed" unless success
+        puts ''
+      end
+
+      def run_plan
+        puts '━━━ terraform plan ━━━'
+        success = system('terraform', 'plan', '-out=tfplan', *@extra_args)
+        abort "\n✗ terraform plan failed" unless success
+        puts ''
+      end
+
+      def confirm_apply
+        return true if @auto_approve
+
+        if @env == 'prod' || @env == 'production'
+          print "⚠️  You are about to deploy to \e[1;31m#{@env}\e[0m. Continue? [y/N] "
+        else
+          print "Apply these changes to #{@env}? [y/N] "
+        end
+
+        response = $stdin.gets
+        return true if response&.strip&.downcase&.start_with?('y')
+
+        puts 'Cancelled.'
+        cleanup_plan
+        false
+      end
+
+      def run_apply
+        puts '━━━ terraform apply ━━━'
+        success = system('terraform', 'apply', 'tfplan')
+        cleanup_plan
+        abort "\n✗ terraform apply failed" unless success
+      end
+
+      def cleanup_plan
+        File.delete('tfplan') if File.exist?('tfplan')
+      end
+
+      def print_outputs(env_dir)
+        Dir.chdir(env_dir) do
+          output = `terraform output 2>/dev/null`.strip
+          return if output.empty?
+
+          puts "\nOutputs:"
+          output.each_line do |line|
+            puts "  #{line}"
+          end
+        end
+      end
+    end
+  end
+end

data/lib/belt/cli/environment_command.rb

@@ -26,9 +26,10 @@ module Belt
         new(env_name).generate
       end
 
-      def initialize(env_name)
+      def initialize(env_name, quiet: false)
         @env_name = env_name.downcase.gsub(/[^a-z0-9_-]/, '')
         @app_name = detect_app_name
+        @quiet = quiet
       end
 
       def generate
@@ -49,11 +50,14 @@ module Belt
         end
 
         puts "\n✓ Environment '#{@env_name}' created!"
-        puts "\nNext steps:"
-        puts "  cd #{dest_dir}"
-        puts '  terraform init'
-        puts '  terraform plan'
-        puts '  terraform apply'
+
+        unless @quiet
+          puts "\nNext steps:"
+          puts "  cd #{dest_dir}"
+          puts '  terraform init'
+          puts '  terraform plan'
+          puts '  terraform apply'
+        end
       end
 
       private
@@ -63,7 +67,8 @@ module Belt
           'main.tf.erb' => 'main.tf',
           'backend.tf.erb' => 'backend.tf',
           'variables.tf.erb' => 'variables.tf',
-          'terraform.tfvars.erb' => 'terraform.tfvars'
+          'terraform.tfvars.erb' => 'terraform.tfvars',
+          'outputs.tf.erb' => 'outputs.tf'
         }
       end
 

data/lib/belt/cli/generate_command.rb

@@ -15,19 +15,79 @@ module Belt
 
       include AppDetection
 
+      FIELD_TYPES = %w[string text integer float boolean date datetime].freeze
+
+      GENERATOR_HELP = {
+        'resource' => {
+          description: 'Generate a model, controller, routes, and schema for a REST resource.',
+          usage: 'belt generate resource <name> [field:type ...] [options]',
+          options: [
+            ['--skip-views', 'Skip generating frontend view pages']
+          ],
+          examples: [
+            ['belt g resource post title:string body:text', 'Post with title and body fields'],
+            ['belt g resource comment author:string body:text status:string', 'Comment with multiple fields'],
+            ['belt g resource task --skip-views', 'Task resource without frontend pages']
+          ],
+          notes: <<~NOTES
+            Creates:
+              lambda/models/<name>.rb                            Model with validations and fields
+              lambda/controllers/<app>/<names>_controller.rb    RESTful controller (index, show, create, update, destroy)
+              infrastructure/routes.tf.rb                        Route entry added
+              infrastructure/schema.tf.rb                        DynamoDB table schema added
+              lambda/lib/routes/<app>_routes.rb                  Route manifest updated
+          NOTES
+        },
+        'model' => {
+          description: 'Generate an ActiveItem model with validations and DynamoDB field definitions.',
+          usage: 'belt generate model <name> [field:type ...]',
+          options: [],
+          examples: [
+            ['belt g model user email:string name:string', 'User model with email and name'],
+            ['belt g model event title:string starts_at:datetime', 'Event model with datetime field']
+          ],
+          notes: <<~NOTES
+            Creates:
+              lambda/models/<name>.rb    Model class inheriting from ActiveItem::Base
+          NOTES
+        },
+        'controller' => {
+          description: 'Generate a controller with standard REST actions.',
+          usage: 'belt generate controller <name>',
+          options: [],
+          examples: [
+            ['belt g controller posts', 'Posts controller with CRUD actions'],
+            ['belt g controller admin/users', 'Namespaced controller']
+          ],
+          notes: <<~NOTES
+            Creates:
+              lambda/controllers/<app>/<name>_controller.rb    Controller class
+          NOTES
+        }
+      }.freeze
+
       def self.run(args)
         generator = args.shift
 
-        if generator.nil? || !GENERATORS.include?(generator)
-          puts "Usage: belt generate <#{GENERATORS.join('|')}> <name> [field:type ...]"
-          puts "\nExamples:"
-          puts '  belt generate resource post title:string content:text status:string'
-          puts '  belt generate model comment body:text author:string'
-          puts '  belt generate controller comments'
-          puts '  belt generate environment dev01'
+        # Top-level help: belt generate --help or belt generate (no args)
+        if generator.nil? || generator =~ /\A-/
+          print_generate_help
+          exit 0
+        end
+
+        unless GENERATORS.include?(generator)
+          puts "Unknown generator: '#{generator}'"
+          puts "Available generators: #{GENERATORS.join(', ')}"
+          puts "\nRun 'belt generate --help' for usage information."
           exit 1
         end
 
+        # Per-generator help: belt g resource --help
+        if args.include?('--help') || args.include?('-h')
+          print_generator_help(generator)
+          exit 0
+        end
+
         return Belt::CLI::EnvironmentCommand.run(args) if generator == 'environment'
 
         return Belt::CLI::FrontendCommand.run(args) if generator == 'frontend'
@@ -36,10 +96,12 @@ module Belt
 
         name = args.shift
         if name.nil? || name.empty?
-          puts "Usage: belt generate #{generator} <name> [field:type ...]"
-          exit 1
+          print_generator_help(generator)
+          exit 0
         end
 
+        validate_resource_name!(name, generator)
+
         skip_views = args.delete('--skip-views')
         fields = args.map { |arg| parse_field(arg) }
         new(generator, name, fields, skip_views: skip_views).generate
@@ -50,6 +112,99 @@ module Belt
         { name: name, type: type || 'string' }
       end
 
+      RESERVED_NAMES = %w[
+        help new edit create update destroy index show delete remove
+        application base controller model resource generate
+        belt setup environment frontend views routes
+      ].freeze
+
+      def self.validate_resource_name!(name, generator)
+        errors = []
+
+        errors << 'must start with a letter' unless name.match?(/\A[a-zA-Z]/)
+        errors << 'must be at least 2 characters' if name.length < 2
+        errors << 'must only contain letters, numbers, and underscores' unless name.match?(/\A[a-zA-Z][a-zA-Z0-9_]*\z/)
+        errors << 'must not start or end with an underscore' if name.match?(/\A_|_\z/)
+        errors << 'must not contain consecutive underscores' if name.include?('__')
+        errors << "is a reserved name" if RESERVED_NAMES.include?(name.downcase.chomp('s'))
+        errors << "is a reserved name" if RESERVED_NAMES.include?(name.downcase)
+
+        return if errors.empty?
+
+        puts "\n✗ Invalid #{generator} name '#{name}':"
+        errors.uniq.each { |e| puts "  - #{e}" }
+        puts "\nName must start with a letter, be at least 2 characters, and contain only letters, numbers, and single underscores."
+        exit 1
+      end
+
+      def self.print_generate_help
+        puts <<~HELP
+          Usage: belt generate <generator> <name> [field:type ...] [options]
+                 belt g <generator> <name> [field:type ...] [options]
+
+          Generators:
+            resource      Generate model, controller, routes, and schema (full REST resource)
+            model         Generate an ActiveItem model
+            controller    Generate a controller
+            environment   Create a new deployment environment
+            frontend      Scaffold a frontend app (react, vue, svelte)
+            views         Generate React pages for a resource
+
+          Field Types:
+            #{FIELD_TYPES.join(', ')}
+
+          Examples:
+            belt g resource post title:string body:text status:string
+            belt g model user email:string name:string
+            belt g controller comments
+            belt g environment staging
+            belt g frontend react
+            belt g views post title:string body:text
+
+          Run 'belt generate <generator> --help' for detailed help on a specific generator.
+        HELP
+      end
+
+      def self.print_generator_help(generator)
+        info = GENERATOR_HELP[generator]
+
+        unless info
+          puts "Usage: belt generate #{generator} <name>"
+          puts "\nRun 'belt generate #{generator} --help' is not yet documented."
+          puts "Try 'belt generate --help' for the full list of generators."
+          return
+        end
+
+        puts info[:description]
+        puts
+        puts "Usage: #{info[:usage]}"
+
+        if info[:options].any?
+          puts "\nOptions:"
+          info[:options].each do |flag, desc|
+            puts "  %-20s %s" % [flag, desc]
+          end
+        end
+
+        puts "\nField Types:"
+        puts "  #{FIELD_TYPES.join(', ')}"
+
+        puts "\nExamples:"
+        info[:examples].each do |cmd, desc|
+          puts "  #{cmd}"
+          puts "    #{desc}" if desc
+        end
+
+        puts "\n#{info[:notes]}" if info[:notes]
+
+        puts "Naming Rules:"
+        puts "  - Must start with a letter"
+        puts "  - At least 2 characters"
+        puts "  - Letters, numbers, and single underscores only"
+        puts "  - No leading/trailing/consecutive underscores"
+        puts "  - Cannot use reserved names (help, new, create, destroy, etc.)"
+      end
+
       def initialize(generator, name, fields, skip_views: false)
         @generator = generator
         @name = name.downcase.gsub(/[^a-z0-9_]/, '_')