belt 0.2.11 → 0.2.13

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

@@ -10,10 +10,14 @@ module Belt
       TEMPLATE_DIR = File.expand_path('../../templates/views', __dir__)
 
       def self.run(args)
+        force = args.delete('--force') || args.delete('-f')
+
         name = args.shift
         if name.nil? || name.empty?
-          puts 'Usage: belt generate views <resource> [field:type ...]'
+          puts 'Usage: belt generate views <resource> [field:type ...] [options]'
           puts "\nGenerates React pages for all REST actions (index, show, new, edit)."
+          puts "\nOptions:"
+          puts '  --force, -f    Overwrite existing files without prompting'
           puts "\nExamples:"
           puts '  belt generate views post title:string content:text status:string'
           puts '  belt generate views comment body:text author:string'
@@ -25,14 +29,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
+        new(name, fields, force: force).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)
@@ -40,20 +49,37 @@ module Belt
 
         # Extract fields from model block
         if content =~ /model :#{singular} do\n(.*?)\n\s*end/m
-          ::Regexp.last_match(1).scan(/field :(\w+), type: :(\w+)/).except('created_at', 'updated_at')
-                  .map do |n, t|
-            {
-              name: n, type: t
-            }
+          block_content = ::Regexp.last_match(1)
+          timestamp_fields = %w[created_at updated_at]
+
+          # Support both formats:
+          #   field :name, type: :string   (legacy)
+          #   string :name                 (current schema DSL)
+          dsl_types = %w[string text integer number boolean float date datetime]
+          dsl_pattern = /(?:#{dsl_types.join('|')}) :(\w+)/
+          fields = block_content.scan(/field :(\w+), type: :(\w+)/)
+          fields += block_content.scan(dsl_pattern).map do |match|
+            field_name = match[0]
+            # Extract type from the DSL method name on that line
+            type_match = block_content.match(/(\w+) :#{Regexp.escape(field_name)}/)
+            [field_name, type_match ? type_match[1] : 'string']
+          end
+
+          fields.filter_map do |n, t|
+            next if timestamp_fields.include?(n)
+
+            { name: n, type: t }
           end
         else
           []
         end
       end
 
-      def initialize(name, fields)
+      def initialize(name, fields, force: false)
         @name = name.downcase.gsub(/[^a-z0-9_]/, '_')
         @fields = fields
+        @force = force
+        @overwrite_all = false
         @singular_name = Belt::Inflector.singularize(@name)
         @resource_name = Belt::Inflector.pluralize(@singular_name)
         @class_name = Belt::Inflector.classify(@singular_name)
@@ -92,8 +118,61 @@ module Belt
       def write_template(template_name, dest_path)
         template_path = File.join(TEMPLATE_DIR, template_name)
         content = ERB.new(File.read(template_path), trim_mode: '-').result(binding)
+        existed = File.exist?(dest_path)
+
+        if existed && !@force && !@overwrite_all
+          action = prompt_overwrite(dest_path)
+          case action
+          when :yes
+            # fall through to write
+          when :all
+            @overwrite_all = true
+            # fall through to write
+          when :no
+            puts "  skip    #{dest_path}"
+            return
+          when :quit
+            puts "\nAborted."
+            exit 1
+          end
+        end
+
         File.write(dest_path, content)
-        puts "  create  #{dest_path}"
+        puts "  #{existed ? 'overwrite' : 'create'}  #{dest_path}"
+      end
+
+      def prompt_overwrite(path)
+        return :yes if @overwrite_all
+
+        print "  conflict  #{path}\n"
+        print "  Overwrite #{path}? (enter \"h\" for help) [Ynaqh] "
+        $stdout.flush
+
+        loop do
+          answer = $stdin.gets&.strip&.downcase
+          case answer
+          when '', 'y', 'yes'
+            return :yes
+          when 'n', 'no'
+            return :no
+          when 'a', 'all'
+            @overwrite_all = true
+            return :all
+          when 'q', 'quit'
+            return :quit
+          when 'h', 'help'
+            puts '  Y - yes, overwrite this file'
+            puts '  n - no, skip this file'
+            puts '  a - all, overwrite this and all remaining files'
+            puts '  q - quit, abort the generator'
+            puts '  h - help, show this help'
+            print "  Overwrite #{path}? (enter \"h\" for help) [Ynaqh] "
+            $stdout.flush
+          else
+            print '  Please enter Y, n, a, q, or h: '
+            $stdout.flush
+          end
+        end
       end
 
       def inject_routes
@@ -104,6 +183,12 @@ module Belt
         pages_dir = @resource_name
         plural_class = @plural_class_name || Belt::Inflector.camelize(@resource_name)
 
+        # Skip route injection if routes for this resource already exist
+        if content.include?("path=\"/#{@resource_name}\"")
+          puts "  skip    #{app_jsx} (routes already exist)"
+          return
+        end
+
         import_lines = [
           "import #{plural_class}Index from './pages/#{pages_dir}/#{plural_class}Index'",
           "import #{@class_name}Show from './pages/#{pages_dir}/#{@class_name}Show'",

data/lib/belt/cli.rb

@@ -18,9 +18,11 @@ 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'
+require_relative 'cli/logs_command'
 require_relative 'cli/doctor_command'
 require_relative 'cli/plugin_command'
 
@@ -31,8 +33,10 @@ 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,
+      'logs' => Belt::CLI::LogsCommand,
       %w[tasks --tasks -T] => Belt::CLI::TasksCommand,
       'setup' => Belt::CLI::SetupCommand,
       'doctor' => Belt::CLI::DoctorCommand,
@@ -109,10 +113,12 @@ 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)
           c                                           Alias for console
+          logs [lambda] [-f] [-s 5m] [-e env]         View Lambda function logs
           tasks [-g PATTERN] [-a]                     List available rake tasks
           -T [-g PATTERN] [-a]                        Alias for tasks
           setup state                                 Create/select S3 state bucket

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,9 +518,9 @@ 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
+    SUPPORTED_TYPES = %i[string text number integer boolean date datetime array object map list].freeze
 
     attr_reader :request_models, :response_models
 
@@ -557,7 +557,7 @@ module Belt
   end
 
   class RequestModelBuilder
-    SUPPORTED_TYPES = %i[string number integer boolean array object map list].freeze
+    SUPPORTED_TYPES = %i[string text number integer boolean date datetime array object map list].freeze
 
     attr_reader :name, :fields
 
@@ -590,6 +590,7 @@ module Belt
 
     def map_type(dsl_type)
       case dsl_type
+      when :text, :date, :datetime then 'string'
       when :map then 'object'
       when :list then 'array'
       else dsl_type.to_s
@@ -598,7 +599,7 @@ module Belt
   end
 
   class ResponseModelBuilder
-    SUPPORTED_TYPES = %i[string number integer boolean array object map list].freeze
+    SUPPORTED_TYPES = %i[string text number integer boolean date datetime array object map list].freeze
 
     attr_reader :name, :contexts, :fields
 
@@ -636,6 +637,7 @@ module Belt
 
     def map_type(dsl_type)
       case dsl_type
+      when :text, :date, :datetime then 'string'
       when :map then 'object'
       when :list then 'array'
       else dsl_type.to_s
@@ -644,7 +646,7 @@ module Belt
   end
 
   class ContextBuilder
-    SUPPORTED_TYPES = %i[string number integer boolean array object map list].freeze
+    SUPPORTED_TYPES = %i[string text number integer boolean date datetime array object map list].freeze
 
     attr_reader :name, :fields
 
@@ -673,6 +675,7 @@ module Belt
 
     def map_type(dsl_type)
       case dsl_type
+      when :text, :date, :datetime then 'string'
       when :map then 'object'
       when :list then 'array'
       else dsl_type.to_s

data/lib/belt/version.rb

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

data/lib/belt.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+require 'activeitem'
 require_relative 'belt/version'
 require_relative 'belt/root'
 require_relative 'belt/configuration'

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/generate/controller.rb.erb

@@ -6,53 +6,48 @@ module <%= @module_name %>Controllers
   class <%= @class_name %>sController < ApplicationController
     # GET /<%= @resource_name %>
     def index
-      <%= @resource_name %> = <%= @class_name %>.all
-      success_response(<%= @resource_name %>: <%= @resource_name %>.map(&:to_h))
+      @<%= @resource_name %> = <%= @class_name %>.all
     end
 
     # POST /<%= @resource_name %>
     def create
-      <%= @singular_name %> = <%= @class_name %>.new(<%= @fields.map { |f| "#{f[:name]}: params[:#{f[:name]}]" }.join(', ') %>)
+      @<%= @singular_name %> = <%= @class_name %>.new(<%= @fields.map { |f| "#{f[:name]}: params[:#{f[:name]}]" }.join(', ') %>)
 
-      if <%= @singular_name %>.save
-        success_response(<%= @singular_name %>: <%= @singular_name %>.to_h)
+      if @<%= @singular_name %>.save
+        response_status :created
       else
-        error_response(<%= @singular_name %>.errors.full_messages.join(', '), 422)
+        error_response(@<%= @singular_name %>.errors.full_messages.join(', '), :unprocessable_entity)
       end
     end
 
     # GET /<%= @resource_name %>/:<%= @singular_name %>_id
     def show
-      <%= @singular_name %> = <%= @class_name %>.find(params[:<%= @singular_name %>_id])
-      return error_response('<%= @class_name %> not found', 404) unless <%= @singular_name %>
-
-      success_response(<%= @singular_name %>: <%= @singular_name %>.to_h)
+      @<%= @singular_name %> = <%= @class_name %>.find(params[:<%= @singular_name %>_id])
+      return error_response('<%= @class_name %> not found', :not_found) unless @<%= @singular_name %>
     end
 
     # PUT /<%= @resource_name %>/:<%= @singular_name %>_id
     def update
-      <%= @singular_name %> = <%= @class_name %>.find(params[:<%= @singular_name %>_id])
-      return error_response('<%= @class_name %> not found', 404) unless <%= @singular_name %>
+      @<%= @singular_name %> = <%= @class_name %>.find(params[:<%= @singular_name %>_id])
+      return error_response('<%= @class_name %> not found', :not_found) unless @<%= @singular_name %>
 
       attrs = {}
 <% @fields.each do |field| -%>
       attrs[:<%= field[:name] %>] = params[:<%= field[:name] %>] if params.key?(:<%= field[:name] %>)
 <% end -%>
 
-      if <%= @singular_name %>.update(attrs)
-        success_response(<%= @singular_name %>: <%= @singular_name %>.to_h)
-      else
-        error_response(<%= @singular_name %>.errors.full_messages.join(', '), 422)
+      unless @<%= @singular_name %>.update(attrs)
+        error_response(@<%= @singular_name %>.errors.full_messages.join(', '), :unprocessable_entity)
       end
     end
 
     # DELETE /<%= @resource_name %>/:<%= @singular_name %>_id
     def destroy
       <%= @singular_name %> = <%= @class_name %>.find(params[:<%= @singular_name %>_id])
-      return error_response('<%= @class_name %> not found', 404) unless <%= @singular_name %>
+      return error_response('<%= @class_name %> not found', :not_found) unless <%= @singular_name %>
 
       <%= @singular_name %>.destroy
-      success_response(message: '<%= @class_name %> deleted')
+      head :no_content
     end
   end
 end

data/lib/templates/generate/model.rb.erb

@@ -1,18 +1,5 @@
 # frozen_string_literal: true
 
 class <%= @class_name %> < ApplicationRecord
-<% @fields.each do |field| -%>
-  attr_accessor :<%= field[:name] %>
-<% end -%>
-
-  def to_h
-    {
-      id: id,
-<% @fields.each do |field| -%>
-      <%= field[:name] %>: <%= field[:name] %>,
-<% end -%>
-      created_at: created_at,
-      updated_at: updated_at
-    }
-  end
+  attr_accessor <%= @fields.map { |f| ":#{f[:name]}" }.join(', ') %>
 end

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/Gemfile.erb

@@ -2,6 +2,4 @@
 
 source 'https://rubygems.org'
 
-gem 'activeitem'
 gem 'belt'
-gem 'lambda_loadout'

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/new_app/gitignore.erb

@@ -12,3 +12,6 @@
 # Lambda build artifacts
 /lambda/vendor/
 /lambda/.bundle/
+
+# Generated route manifests (belt routes --namespace)
+/lambda/lib/routes/

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

@@ -1,15 +1,9 @@
 # frozen_string_literal: true
 
 require 'belt'
-require 'activeitem'
 
 include Belt::LambdaHandler
 
-ActiveItem.configure do |config|
-  config.table_prefix = ENV['APP_NAME']
-  config.environment = ENV['ENVIRONMENT']
-end
-
 require_relative 'lib/routes/api_routes'
 <% @resources&.each do |r| -%>
 require_relative 'controllers/<%= @app_name %>/<%= r %>_controller'

data/lib/templates/new_app/lambda/config/environment.rb.erb

@@ -3,16 +3,10 @@
 # Boot the application. Used by `belt console` and Lambda at runtime.
 
 require 'belt'
-require 'activeitem'
 
 ENV['APP_NAME'] ||= '<%= @app_name %>'
 ENV['AWS_REGION'] ||= 'us-east-1'
 
-ActiveItem.configure do |config|
-  config.table_prefix = ENV['APP_NAME']
-  config.environment = ENV['ENVIRONMENT']
-end
-
 # Load lib and models
 Dir[File.join(__dir__, '..', 'lib', '**', '*.rb')].sort.each { |f| require f }
 

data/lib/templates/new_app/lambda/models/application_record.rb.erb

@@ -1,6 +1,4 @@
 # frozen_string_literal: true
 
-require 'activeitem'
-
 class ApplicationRecord < ActiveItem::Base
 end

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