belt 0.2.11 → 0.2.12

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 43ae84461595be08ca6caada3afd148ccfa0db94bfc2e2bd864a9b466d41f087
-  data.tar.gz: 1f33826b8c7a7b068458db8ca38aa9910079e16f04c3c5c727550f084ed85075
+  metadata.gz: 10e92ad2ab3fe79f48f07cca6495ce8b9ccdad09755c7a6517e651deadcc118d
+  data.tar.gz: 6cd8a8ee7ad1023fb949183122c3aca465c216cf91d175e8f9395e8f413ad880
 SHA512:
-  metadata.gz: 81532edca53a084bdd6aabf5e7027fd1653ec0fc4c592b0bdb60374283c7c59512a2217405d3a19f32a975bcbcbbebdf9f9a97d952a25b1567e05af8e2cb879d
-  data.tar.gz: d5ff609d6526f8cc59964df6da091a43150eca9d1c6f625dee27b070db0c56bd90ef58ef11c42f57e27259f169c477a4c1c548f9ca0f4c4f916c8bea540763bb
+  metadata.gz: cb7d5dacc2b90e0ae7c4dd9853d76ea42ef8d6e324d30edd91c5fbe6d934affafd2c3bee6fb752960d9c8462a59663244ae448797ab7e57de7ad05c50afa627f
+  data.tar.gz: fd7f4ff9af68c36b34c02c2f4af2c42649f0e9494ac192eaaefeae3111e0da81ced4091b88510b82ac183fefaadfd0677e4d34f270e16a7dcf389b54259e8c52

data/CHANGELOG.md

@@ -1,5 +1,36 @@
 # Changelog
 
+## 0.2.12
+
+### Rename: `routes.tf.rb` → `routes.rb`, `schema.tf.rb` → `contracts.rb`
+
+The `.tf.rb` extension was a vestige of when these files produced HCL output — that hasn't been the case for a while. New apps now get clean, Rails-familiar names:
+
+- `config/routes.rb` — API route definitions
+- `config/contracts.rb` — API request/response contracts
+
+**Backward compatible:** All detection helpers (`Belt.root`, `Belt.routes_file`, `Belt.contracts_file`, `find_routes_file_path`, `find_contracts_file_path`) check new names first, then fall back to `*.tf.rb` and `infrastructure/` paths. Existing apps continue working without changes.
+
+### New command: `belt contracts`
+
+Dedicated CLI command for inspecting API contracts, separate from `belt routes`:
+
+```bash
+belt contracts                    # Human-readable table of request/response models
+belt contracts -f json            # JSON output (for tooling/CI)
+belt contracts -g post            # Filter by pattern
+belt contracts --file path.rb     # Explicit file override
+```
+
+Previously, contracts were only accessible as a side-effect of `belt routes -f json --schema <file>`. Now they have their own first-class command. `belt routes -f json` continues to include models for backward compatibility.
+
+### Other changes
+
+- `Belt.schema_file` is now an alias for `Belt.contracts_file`
+- `find_schema_file_path` is now an alias for `find_contracts_file_path`
+- Module template updated: `source` points to `config/routes.rb`
+- All scaffold/generator help text and templates reference new filenames
+
 ## Unreleased
 
 ## 0.2.11

data/lib/belt/cli/app_detection.rb

@@ -40,17 +40,31 @@ module Belt
         name.to_s.downcase.tr('_', '-')
       end
 
-      # Finds routes.tf.rb checking config/ first, then infrastructure/ (legacy).
+      # Finds routes file checking config/routes.rb first, then legacy paths.
       def find_routes_file_path
-        candidates = ['config/routes.tf.rb', 'infrastructure/routes.tf.rb']
+        candidates = [
+          'config/routes.rb',
+          'config/routes.tf.rb',
+          'infrastructure/routes.tf.rb'
+        ]
         candidates.find { |f| File.exist?(f) }
       end
 
-      # Finds schema.tf.rb checking config/ first, then infrastructure/ (legacy).
-      def find_schema_file_path
-        candidates = ['config/schema.tf.rb', 'infrastructure/schema.tf.rb']
+      # Finds contracts file checking config/contracts.rb first, then legacy paths.
+      def find_contracts_file_path
+        candidates = [
+          'config/contracts.rb',
+          'config/contracts.tf.rb',
+          'config/schema.tf.rb',
+          'infrastructure/schema.tf.rb'
+        ]
         candidates.find { |f| File.exist?(f) }
       end
+
+      # Legacy alias for backward compatibility
+      def find_schema_file_path
+        find_contracts_file_path
+      end
     end
   end
 end

data/lib/belt/cli/contracts_command.rb

@@ -0,0 +1,142 @@
+# frozen_string_literal: true
+
+require 'json'
+require 'optparse'
+require_relative '../route_dsl'
+require_relative 'routes_command/schema_loader'
+
+module Belt
+  module CLI
+    class ContractsCommand
+      include RoutesCommand::SchemaLoader
+
+      def self.run(args)
+        new(args).run
+      end
+
+      def initialize(args)
+        @options = {}
+        parse_options(args)
+      end
+
+      def run
+        contracts_file = find_contracts_file
+        unless contracts_file
+          abort 'Error: No contracts file found. ' \
+                'Expected config/contracts.rb (or config/contracts.tf.rb, config/schema.tf.rb)'
+        end
+
+        models = load_contracts(contracts_file)
+
+        if @options[:format] == 'json'
+          output_json(models)
+        else
+          output_concise(models)
+        end
+      end
+
+      private
+
+      def parse_options(args)
+        OptionParser.new do |opts|
+          opts.banner = 'Usage: belt contracts [options]'
+
+          opts.on('-f', '--format FORMAT', 'Output format: concise (default), json') do |format|
+            @options[:format] = format
+          end
+
+          opts.on('-g', '--grep PATTERN', 'Filter contracts matching pattern') do |pattern|
+            @options[:grep] = pattern
+          end
+
+          opts.on('--file FILE', 'Path to contracts file (overrides auto-detection)') do |file|
+            @options[:contracts_file] = file
+          end
+
+          opts.on('-h', '--help', 'Show this help') do
+            puts opts
+            exit
+          end
+        end.parse!(args)
+      end
+
+      def find_contracts_file
+        if @options[:contracts_file]
+          file = @options[:contracts_file]
+          return file if File.exist?(file)
+
+          abort "Error: Specified contracts file not found: #{file}"
+        end
+
+        candidates = [
+          'config/contracts.rb',
+          'config/contracts.tf.rb',
+          'config/schema.tf.rb',
+          'infrastructure/schema.tf.rb'
+        ]
+        candidates.find { |f| File.exist?(f) }
+      end
+
+      def load_contracts(file)
+        Belt.instance_variable_set(:@application, nil)
+        begin
+          eval(File.read(file), binding, file) # rubocop:disable Security/Eval
+        rescue StandardError => e
+          abort "Error: Failed to load contracts file #{file}: #{e.message}"
+        end
+
+        schema = Belt.application.schema.to_h
+        models = build_models_from_schema(schema)
+        models = apply_grep(models) if @options[:grep]
+        models
+      end
+
+      def apply_grep(models)
+        pattern = Regexp.new(@options[:grep], Regexp::IGNORECASE)
+        models.select do |m|
+          m[:name].match?(pattern) ||
+            m[:kind].match?(pattern) ||
+            m[:description].match?(pattern)
+        end
+      end
+
+      def output_json(models)
+        puts JSON.pretty_generate(models: models)
+      end
+
+      def output_concise(models)
+        return puts('No contracts defined.') if models.empty?
+
+        requests = models.select { |m| m[:kind] == 'request' }
+        responses = models.select { |m| m[:kind] == 'response' }
+
+        if requests.any?
+          puts 'REQUEST MODELS'
+          puts '-' * 60
+          requests.each { |m| print_model(m) }
+          puts
+        end
+
+        if responses.any?
+          puts 'RESPONSE MODELS'
+          puts '-' * 60
+          responses.each { |m| print_model(m) }
+        end
+
+        puts "\n#{models.length} contract(s) total (#{requests.length} request, #{responses.length} response)"
+      end
+
+      def print_model(model)
+        required = model[:required] || []
+        props = (model[:properties] || {}).map do |name, meta|
+          type = meta['type'] || meta[:type] || 'string'
+          req_marker = required.include?(name.to_s) ? ' *' : ''
+          "#{name}:#{type}#{req_marker}"
+        end
+
+        puts "  #{model[:name]} (#{model[:kind]})"
+        puts "    #{props.join(', ')}" if props.any?
+      end
+    end
+  end
+end

data/lib/belt/cli/destroy_command.rb

@@ -258,6 +258,9 @@ module Belt
             end
           end
 
+          # Empty S3 buckets before destroy — terraform can't delete non-empty buckets
+          empty_s3_buckets_in_state
+
           # Run destroy with auto-approve (user already confirmed)
           unless system('terraform', 'destroy', '-auto-approve')
             puts "\n✗ terraform destroy failed."
@@ -269,6 +272,77 @@ module Belt
         puts '  ✓ Infrastructure destroyed.'
       end
 
+      def empty_s3_buckets_in_state
+        output = `terraform state list 2>/dev/null`
+        return unless Process.last_status.success?
+
+        bucket_resources = output.lines.map(&:strip).grep(/\Aaws_s3_bucket\./)
+        return if bucket_resources.empty?
+
+        bucket_resources.each do |resource|
+          bucket_name = resolve_bucket_name(resource)
+          next unless bucket_name
+
+          empty_s3_bucket(bucket_name)
+        end
+      end
+
+      def resolve_bucket_name(resource)
+        output = `terraform state show '#{resource}' 2>/dev/null`
+        return nil unless Process.last_status.success?
+
+        match = output.match(/^\s*bucket\s*=\s*"([^"]+)"/)
+        match&.[](1)
+      end
+
+      def empty_s3_bucket(bucket_name)
+        # Check if bucket exists
+        `aws s3api head-bucket --bucket '#{bucket_name}' 2>&1`
+        return unless Process.last_status.success?
+
+        puts "  Emptying S3 bucket: #{bucket_name}"
+
+        # Delete all object versions (handles versioned buckets)
+        `aws s3 rm 's3://#{bucket_name}' --recursive 2>/dev/null`
+
+        # Also delete versioned objects and delete markers
+        delete_all_versions(bucket_name)
+      end
+
+      def delete_all_versions(bucket_name)
+        loop do
+          output = `aws s3api list-object-versions --bucket '#{bucket_name}' --max-items 1000 2>/dev/null`
+          break unless Process.last_status.success?
+
+          begin
+            data = JSON.parse(output)
+          rescue JSON::ParserError
+            break
+          end
+
+          versions = (data['Versions'] || []) + (data['DeleteMarkers'] || [])
+          break if versions.empty?
+
+          # Build delete objects payload
+          objects = versions.map do |v|
+            { 'Key' => v['Key'], 'VersionId' => v['VersionId'] }
+          end
+
+          delete_payload = JSON.generate({ 'Objects' => objects, 'Quiet' => true })
+
+          # Use a temp file for the payload since it can be large
+          require 'tempfile'
+          Tempfile.create(['delete-objects', '.json']) do |f|
+            f.write(delete_payload)
+            f.flush
+            `aws s3api delete-objects --bucket '#{bucket_name}' --delete 'file://#{f.path}' 2>/dev/null`
+          end
+
+          # If there's no next token, we're done
+          break unless data['NextToken'] || data['IsTruncated']
+        end
+      end
+
       def destroy_frontend
         dir = 'frontend'
         if Dir.exist?(dir)

data/lib/belt/cli/generate_command.rb

@@ -38,8 +38,8 @@ module Belt
             Creates:
               lambda/models/<name>.rb                            Model with validations and fields
               lambda/controllers/<app>/<names>_controller.rb    RESTful controller (index, show, create, update, destroy)
-              config/routes.tf.rb                                Route entry added
-              config/schema.tf.rb                                API response contract added
+              config/routes.rb                                   Route entry added
+              config/contracts.rb                                API response contract added
               lambda/lib/routes/<app>_routes.rb                  Route manifest updated
               infrastructure/modules/app/dynamodb.tf             DynamoDB table generated
               frontend/src/pages/<names>/                        React pages (if frontend exists)
@@ -60,7 +60,7 @@ module Belt
           notes: <<~NOTES
             Creates:
               lambda/models/<name>.rb                            Model class inheriting from ApplicationRecord
-              config/schema.tf.rb                                API response contract added
+              config/contracts.rb                                API response contract added
               infrastructure/modules/app/dynamodb.tf             DynamoDB table generated
           NOTES
         },
@@ -333,8 +333,8 @@ module Belt
         puts "\nFiles created/updated:"
         puts "  lambda/models/#{@singular_name}.rb"
         puts "  lambda/controllers/#{@app_name}/#{@resource_name}_controller.rb"
-        puts "  #{find_routes_file_path || 'config/routes.tf.rb'} (updated)"
-        puts "  #{find_schema_file_path || 'config/schema.tf.rb'} (updated)"
+        puts "  #{find_routes_file_path || 'config/routes.rb'} (updated)"
+        puts "  #{find_contracts_file_path || 'config/contracts.rb'} (updated)"
         puts "  lambda/lib/routes/#{@app_name}_routes.rb (updated)"
         puts "  frontend/src/pages/#{@resource_name}/ (views)" if Dir.exist?('frontend/src')
       end

data/lib/belt/cli/new_command.rb

@@ -167,8 +167,8 @@ module Belt
           'lambda/controllers/application_controller.rb.erb' =>
             "#{@app_name}/lambda/controllers/api/application_controller.rb",
           'lambda/lib/routes/routes.rb.erb' => "#{@app_name}/lambda/lib/routes/api_routes.rb",
-          'config/routes.tf.rb.erb' => "#{@app_name}/config/routes.tf.rb",
-          'config/schema.tf.rb.erb' => "#{@app_name}/config/schema.tf.rb",
+          'config/routes.rb.erb' => "#{@app_name}/config/routes.rb",
+          'config/contracts.rb.erb' => "#{@app_name}/config/contracts.rb",
           'config/lambda/api.yml.erb' => "#{@app_name}/config/lambda/api.yml",
           'README.md.erb' => "#{@app_name}/README.md",
           'AGENTS.md.erb' => "#{@app_name}/AGENTS.md",

data/lib/belt/cli/routes_command/schema_loader.rb

@@ -8,14 +8,14 @@ module Belt
         private
 
         def load_schema_models(routes_file)
-          schema_file = resolve_schema_file(routes_file)
+          schema_file = resolve_contracts_file(routes_file)
           return [] unless schema_file && File.exist?(schema_file)
 
           Belt.instance_variable_set(:@application, nil)
           begin
             eval(File.read(schema_file), binding, schema_file) # rubocop:disable Security/Eval
           rescue StandardError => e
-            warn "Warning: Failed to load schema file #{schema_file}: #{e.message}"
+            warn "Warning: Failed to load contracts file #{schema_file}: #{e.message}"
             return []
           end
 
@@ -23,15 +23,25 @@ module Belt
           build_models_from_schema(schema)
         end
 
-        def resolve_schema_file(routes_file)
+        def resolve_contracts_file(routes_file)
           schema_file = @options[:schema_file]
           unless schema_file
             routes_dir = File.dirname(File.expand_path(routes_file))
-            schema_file = File.join(routes_dir, 'schema.tf.rb')
+            # Check new convention first, then legacy names
+            candidates = [
+              File.join(routes_dir, 'contracts.rb'),
+              File.join(routes_dir, 'contracts.tf.rb'),
+              File.join(routes_dir, 'schema.tf.rb')
+            ]
+            schema_file = candidates.find { |f| File.exist?(f) }
+
             # Fall back to infrastructure/ if not found in same directory as routes
-            unless File.exist?(schema_file)
-              alt = 'infrastructure/schema.tf.rb'
-              schema_file = alt if File.exist?(alt)
+            unless schema_file
+              legacy_candidates = [
+                'infrastructure/contracts.rb',
+                'infrastructure/schema.tf.rb'
+              ]
+              schema_file = legacy_candidates.find { |f| File.exist?(f) }
             end
           end
           schema_file

data/lib/belt/cli/routes_command.rb

@@ -27,7 +27,7 @@ module Belt
         routes_file = find_routes_file
         unless routes_file
           abort 'Error: No routes file found. ' \
-                'Expected config/routes.tf.rb (or infrastructure/routes.tf.rb)'
+                'Expected config/routes.rb (or config/routes.tf.rb, infrastructure/routes.tf.rb)'
         end
 
         dsl = load_routes(routes_file)
@@ -71,7 +71,7 @@ module Belt
             @options[:output_dir] = dir
           end
 
-          opts.on('--schema FILE', 'Path to schema.tf.rb for model definitions') do |file|
+          opts.on('--schema FILE', 'Path to contracts.rb for model definitions') do |file|
             @options[:schema_file] = file
           end
 
@@ -87,7 +87,11 @@ module Belt
       end
 
       def find_routes_file
-        candidates = ['config/routes.tf.rb', 'infrastructure/routes.tf.rb']
+        candidates = [
+          'config/routes.rb',
+          'config/routes.tf.rb',
+          'infrastructure/routes.tf.rb'
+        ]
         candidates.find { |f| File.exist?(f) }
       end
 

data/lib/belt/cli/setup_command.rb

@@ -32,7 +32,7 @@ module Belt
           puts 'Usage: belt setup <state|tables|frontend> [options]'
           puts "\nSubcommands:"
           puts '  state     Set up S3 bucket for Terraform state'
-          puts '  tables    Generate DynamoDB table definitions from schema.tf.rb'
+          puts '  tables    Generate DynamoDB table definitions from contracts.rb'
           puts '  frontend  Generate S3 + CloudFront infrastructure for frontend hosting'
           exit 1
         end

data/lib/belt/cli/views_command.rb

@@ -25,14 +25,19 @@ module Belt
           { name: n, type: t || 'string' }
         end
 
-        # If no fields provided, try to read from schema.tf.rb
+        # If no fields provided, try to read from contracts.rb
         fields = read_schema_fields(name) if fields.empty?
 
         new(name, fields).generate
       end
 
       def self.read_schema_fields(name)
-        schema_file = ['config/schema.tf.rb', 'infrastructure/schema.tf.rb'].find { |f| File.exist?(f) }
+        schema_file = [
+          'config/contracts.rb',
+          'config/contracts.tf.rb',
+          'config/schema.tf.rb',
+          'infrastructure/schema.tf.rb'
+        ].find { |f| File.exist?(f) }
         return [] unless schema_file
 
         content = File.read(schema_file)

data/lib/belt/cli.rb

@@ -18,6 +18,7 @@ require_relative 'cli/backup_config'
 require_relative 'cli/backup_runner'
 require_relative 'cli/server_command'
 require_relative 'cli/routes_command'
+require_relative 'cli/contracts_command'
 require_relative 'cli/lambda_config_command'
 require_relative 'cli/tasks_command'
 require_relative 'cli/console_command'
@@ -31,6 +32,7 @@ module Belt
       %w[generate g] => Belt::CLI::GenerateCommand,
       %w[destroy d] => Belt::CLI::DestroyCommand,
       'routes' => Belt::CLI::RoutesCommand,
+      'contracts' => Belt::CLI::ContractsCommand,
       'lambda-config' => Belt::CLI::LambdaConfigCommand,
       %w[console c] => Belt::CLI::ConsoleCommand,
       %w[tasks --tasks -T] => Belt::CLI::TasksCommand,
@@ -109,6 +111,7 @@ module Belt
           deploy frontend <env>                       Build and deploy frontend to AWS
           frontend env <env>                          Write frontend/.env from terraform outputs
           routes [-g PATTERN] [-f json]               Show route definitions
+          contracts [-g PATTERN] [-f json]            Show API request/response contracts
           lambda-config [-e ENV] [-f json|terraform]  Show merged lambda configuration
 
           console                                     Start an interactive console (IRB)

data/lib/belt/root.rb

@@ -9,24 +9,32 @@ module Belt
     @root = path
   end
 
-  # Resolves the path to routes.tf.rb, checking config/ first then infrastructure/ (legacy).
+  # Resolves the path to routes.rb, checking config/ first then legacy paths.
   def self.routes_file
     candidates = [
+      File.join(root, 'config/routes.rb'),
       File.join(root, 'config/routes.tf.rb'),
       File.join(root, 'infrastructure/routes.tf.rb')
     ]
     candidates.find { |f| File.exist?(f) }
   end
 
-  # Resolves the path to schema.tf.rb, checking config/ first then infrastructure/ (legacy).
-  def self.schema_file
+  # Resolves the path to contracts.rb, checking config/ first then legacy paths.
+  def self.contracts_file
     candidates = [
+      File.join(root, 'config/contracts.rb'),
+      File.join(root, 'config/contracts.tf.rb'),
       File.join(root, 'config/schema.tf.rb'),
       File.join(root, 'infrastructure/schema.tf.rb')
     ]
     candidates.find { |f| File.exist?(f) }
   end
 
+  # Legacy alias for backward compatibility
+  def self.schema_file
+    contracts_file
+  end
+
   # Resolves the lambda config directory.
   def self.lambda_config_dir
     File.join(root, 'config/lambda')
@@ -35,6 +43,7 @@ module Belt
   def self.detect_root
     dir = Dir.pwd
     loop do
+      return dir if File.exist?(File.join(dir, 'config/routes.rb'))
       return dir if File.exist?(File.join(dir, 'config/routes.tf.rb'))
       return dir if File.exist?(File.join(dir, 'infrastructure/routes.tf.rb'))
 

data/lib/belt/route_dsl.rb

@@ -5,7 +5,7 @@ require_relative 'inflector'
 module Belt
   # DSL for defining API Gateway routes.
   # Ported from terraform-provider-conveyor-belt/scripts/lib/route_dsl.rb
-  # so that `belt routes` can parse routes.tf.rb without external dependencies.
+  # so that `belt routes` can parse routes.rb without external dependencies.
 
   class Route
     attr_reader :method, :path, :auth, :lambda, :cors, :tables, :route_type,
@@ -518,7 +518,7 @@ module Belt
     end
   end
 
-  # SchemaBuilder captures request and response model definitions from schema.tf.rb
+  # SchemaBuilder captures request and response model definitions from contracts.rb
   class SchemaBuilder
     SUPPORTED_TYPES = %i[string number integer boolean array object map list].freeze
 

data/lib/belt/version.rb

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

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

@@ -9,7 +9,8 @@ resource "random_string" "frontend_suffix" {
 
 # S3 bucket for frontend static assets
 resource "aws_s3_bucket" "frontend" {
-  bucket = "<%= s3_safe_name(@app_name) %>-frontend-${var.environment}-${random_string.frontend_suffix.result}"
+  bucket        = "<%= s3_safe_name(@app_name) %>-frontend-${var.environment}-${random_string.frontend_suffix.result}"
+  force_destroy = true
 
   lifecycle {
     ignore_changes = [bucket]

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

@@ -9,7 +9,8 @@ resource "random_string" "frontend_suffix" {
 
 # S3 bucket for frontend static assets
 resource "aws_s3_bucket" "frontend" {
-  bucket = "${var.app_name}-frontend-${var.environment}-${random_string.frontend_suffix.result}"
+  bucket        = "${var.app_name}-frontend-${var.environment}-${random_string.frontend_suffix.result}"
+  force_destroy = true
 
   lifecycle {
     ignore_changes = [bucket]

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

@@ -22,7 +22,7 @@ resource "conveyor_belt" "main" {
   provider = conveyor-belt
 
   # path.module is infrastructure/modules/app — climb three levels to project root
-  source            = "${path.module}/../../../config/routes.tf.rb"
+  source            = "${path.module}/../../../config/routes.rb"
   app_name          = var.app_name
   lambda_source_dir = "${path.module}/../../../lambda"
   lambda_shared_dirs = ["controllers", "helpers", "lib", "models", "views"]

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`.
-- **Conveyor Belt** — 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.rb`) and creates API Gateway + Lambda + IAM infrastructure.
 - **Lambda Loadout** — Lambda cold-start optimizer (auto-required by Belt).
 
 ## Project Structure
@@ -23,8 +23,8 @@ This file explains the project structure, tooling, and conventions for AI agents
 │   ├── lib/routes/                     # Route manifests (auto-generated)
 │   └── Gemfile                         # Lambda-specific dependencies
 ├── config/
-│   ├── routes.tf.rb                    # API routes (Conveyor Belt DSL)
-│   ├── schema.tf.rb                    # Model schema definitions
+│   ├── routes.rb                       # API routes (Conveyor Belt DSL)
+│   ├── contracts.rb                    # API request/response contracts
 │   └── lambda/                         # Per-lambda config (like database.yml)
 │       └── api.yml                     # Lambda timeout, memory, env vars
 ├── infrastructure/
@@ -53,7 +53,7 @@ belt output <env>                                      # terraform output
 
 ## How Routing Works
 
-1. `config/routes.tf.rb` defines routes using a DSL:
+1. `config/routes.rb` defines routes using a DSL:
    ```ruby
    Belt.application.routes.draw do
      namespace :<%= @app_name %> do

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

@@ -6,8 +6,8 @@ A serverless application built with [Belt](https://github.com/stowzilla/belt) an
 
 ```
 ├── config/
-│   ├── routes.tf.rb        # API route definitions
-│   ├── schema.tf.rb        # Model schema definitions
+│   ├── routes.rb           # API route definitions
+│   ├── contracts.rb        # API request/response contracts
 │   └── lambda/             # Per-lambda config (timeout, memory, env vars)
 │       └── api.yml
 ├── infrastructure/         # Terraform environments

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

@@ -67,7 +67,7 @@ When fleshing out the generator, typically install:
 1. **Terraform module** → `infrastructure/modules/<%= plugin_name %>/` (`main.tf`, `variables.tf`, `outputs.tf`)
 2. **Lambda config** → `config/lambda/<%= plugin_name %>.yml` (timeout, memory, env, triggers)
 3. **Lambda entrypoint** → `lambda/<%= plugin_name %>.rb` using `Belt::LambdaHandler`
-4. **Routes / schema** → inject into `config/routes.tf.rb` or schema files when needed
+4. **Routes / schema** → inject into `config/routes.rb` or `config/contracts.rb` when needed
 5. **Optional overrides** → `--controllers` (or similar) for app-local subclasses — keep defaults in the gem
 6. **Destroy path** → `belt destroy <%= plugin_name %>` removes generated artifacts
 7. **Help** → `.description` plus `--help` / `-h` explaining files and next steps

data/lib/templates/plugin/README.md.erb

@@ -42,7 +42,7 @@ Typical plugin generators create some combination of:
 - **Terraform module** — `infrastructure/modules/<%= plugin_name %>/`
 - **Lambda entry point** — `lambda/<%= plugin_name %>.rb`
 - **Lambda config** — `config/lambda/<%= plugin_name %>.yml`
-- **Route / schema injection** — updates to `routes.tf.rb` / `schema.tf.rb`
+- **Route / schema injection** — updates to `config/routes.rb` / `config/contracts.rb`
 - **Optional controller overrides** — `belt g <%= plugin_name %> --controllers`
 
 ## Development

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: belt
 version: !ruby/object:Gem::Version
-  version: 0.2.11
+  version: 0.2.12
 platform: ruby
 authors:
 - Stowzilla
@@ -74,6 +74,7 @@ files:
 - lib/belt/cli/backup_runner.rb
 - lib/belt/cli/bucket_security.rb
 - lib/belt/cli/console_command.rb
+- lib/belt/cli/contracts_command.rb
 - lib/belt/cli/deploy_command.rb
 - lib/belt/cli/destroy_command.rb
 - lib/belt/cli/doctor_command.rb
@@ -144,9 +145,9 @@ files:
 - lib/templates/new_app/Gemfile.erb
 - lib/templates/new_app/README.md.erb
 - lib/templates/new_app/Rakefile.erb
+- lib/templates/new_app/config/contracts.rb.erb
 - lib/templates/new_app/config/lambda/api.yml.erb
-- lib/templates/new_app/config/routes.tf.rb.erb
-- lib/templates/new_app/config/schema.tf.rb.erb
+- lib/templates/new_app/config/routes.rb.erb
 - lib/templates/new_app/gitignore.erb
 - lib/templates/new_app/lambda/api.rb.erb
 - lib/templates/new_app/lambda/config/environment.rb.erb