rails-ai-context 3.0.1 → 3.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6eefc7e3df780d0a0553d8d33945cba9f799ff12e0013f2f4e4d8dffe2243a08
-  data.tar.gz: fed18a63451cf2a649288c5e4f8a5a13386d98eb164cc312b2e559ebc788b739
+  metadata.gz: a6bdb0dcbde3c7abfab69bee14e661afc8a260fe3d00faa99ecc4becbc58a19b
+  data.tar.gz: deacfa10c6c188d0482fc82199f085b4f13cbf24b0cf06e0977074ecf67864d8
 SHA512:
-  metadata.gz: 84fc5cb59112194dbc3a6f31c1473734646f7cd5cb29777f58290a2cc12c1ebf87036186ed7cc4fd60b52365b9486adea6a9995a561ee4f00c3348487deec532
-  data.tar.gz: b74d3406587a18690aa4bffcfbd928efd4b0ead69c176e14163821dee96b3d983958c007cf0c74073b94875e098865ab73cf239b67a59a0565b4911d7d9a7cfe
+  metadata.gz: bf049844c52cd8b88371a352907b08c9863668424ae37f9393d72c7210501c21fcc2ea3df797e59184b603b98e723f0bd07ebb4e36503852344c27d96970a308
+  data.tar.gz: ab5cf1f7f4031d605db8f076da5544ede9c1aa48d426dc57482a45551d46741c687caaaf0e8722932d8d982c6a9af5c86f425e117a80bcb88b36d2d1d761040f

data/CHANGELOG.md

@@ -5,6 +5,22 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [3.1.0] - 2026-03-26
+
+### Fixed
+
+- **Consistent input normalization across all tools** — AI agents and humans can now use any casing or format and tools resolve correctly:
+  - `model=brand_profile` (snake_case) now resolves to `BrandProfile` via `.underscore` comparison in `get_model_details`.
+  - `table=Cook` (model name) now resolves to `cooks` table via `.underscore.pluralize` normalization in `get_schema`.
+  - `controller=CooksController` now works in `get_view` and `get_routes` — both strip `Controller`/`_controller` suffix consistently, matching `get_controllers` behavior.
+  - `controller=cooks_controller` no longer leaves a trailing underscore in route matching.
+  - `stimulus=CookStatus` (PascalCase) now resolves to `cook_status` via `.underscore` conversion in `get_stimulus`.
+  - `partial=_status_badge` (underscore-prefixed, no directory) now searches recursively across all view directories in `get_partial_interface`.
+  - `model=cooks` (plural) now tries `.singularize` for test file lookup in `get_test_info`.
+- **Smarter fuzzy matching** — `BaseTool.find_closest_match` now prefers shortest substring match (so `Cook` suggests `cooks`, not `cook_comments`) and supports underscore/classify variant matching.
+- **File path suggestions in validate** — `files=["cook.rb"]` now suggests `app/models/cook.rb` when the file isn't found at the given path.
+- **Empty parameter validation** — `edit_context` now returns friendly messages for empty `file` or `near` parameters instead of hard errors.
+
 ## [3.0.0] - 2026-03-26
 
 ### Removed

data/CLAUDE.md

@@ -51,7 +51,7 @@ structure to AI assistants via the Model Context Protocol (MCP).
 ## Testing
 
 ```bash
-bundle exec rspec           # Run specs (653 examples)
+bundle exec rspec           # Run specs (681 examples)
 bundle exec rubocop         # Lint
 ```
 

data/README.md

@@ -9,7 +9,7 @@
 
 **Works with:** Claude Code • Cursor • GitHub Copilot • OpenCode • Any terminal
 
-> Built by a Rails developer with 10+ years of production experience. AI assisted — the same way it assists me shipping features at work. I designed the architecture, made every decision, reviewed every line, and wrote 653 tests. This gem exists because I understand Rails deeply enough to know exactly what AI agents get wrong and what context they need to get it right.
+> Built by a Rails developer with 10+ years of production experience. AI assisted — the same way it assists me shipping features at work. I designed the architecture, made every decision, reviewed every line, and wrote 681 tests. This gem exists because I understand Rails deeply enough to know exactly what AI agents get wrong and what context they need to get it right.
 
 ```bash
 gem "rails-ai-context", group: :development
@@ -340,7 +340,7 @@ end
 ```bash
 git clone https://github.com/crisnahine/rails-ai-context.git
 cd rails-ai-context && bundle install
-bundle exec rspec       # 653 examples
+bundle exec rspec       # 681 examples
 bundle exec rubocop     # Lint
 ```
 

data/lib/rails_ai_context/cli/tool_runner.rb

@@ -219,27 +219,37 @@ module RailsAiContext
       end
 
       # Validate kwargs against the tool's input_schema.
+      # For missing required params: strip empty values so the tool's own guards
+      # can return a friendly response (matching MCP behavior).
+      # For invalid enums: strip the bad value and let the tool use its default.
       def validate_kwargs!(kwargs, schema)
         properties = schema[:properties] || {}
         required = (schema[:required] || []).map(&:to_s)
 
-        # Check required params
+        # For required params with empty-string values, keep the key but set to nil
+        # so the tool's own guards can return friendly "parameter is required" messages
+        # (matching MCP behavior). We keep the key to avoid Ruby ArgumentError on
+        # required keyword arguments.
         required.each do |param|
-          unless kwargs.key?(param.to_sym) && !kwargs[param.to_sym].nil? && kwargs[param.to_sym].to_s != ""
-            raise InvalidArgumentError,
-              "Missing required parameter '#{param}' for #{tool_class.tool_name}.\n" \
-              "Run: rails-ai-context tool #{self.class.short_name(tool_class.tool_name)} --help"
+          if kwargs.key?(param.to_sym) && kwargs[param.to_sym].to_s.strip == ""
+            kwargs[param.to_sym] = nil
+          elsif !kwargs.key?(param.to_sym)
+            kwargs[param.to_sym] = nil
           end
         end
 
-        # Check enum constraints
+        # Check enum constraints — downcase before comparing for case-insensitive match.
+        # If invalid, strip the param so the tool uses its default behavior.
         kwargs.each do |key, value|
           prop = properties[key]
           next unless prop&.dig(:enum)
-          unless prop[:enum].include?(value.to_s)
-            raise InvalidArgumentError,
-              "Invalid value '#{value}' for --#{key.to_s.tr('_', '-')}. " \
-              "Must be one of: #{prop[:enum].join(', ')}"
+
+          # Try case-insensitive match first
+          matched = prop[:enum].find { |e| e.to_s.downcase == value.to_s.downcase }
+          if matched
+            kwargs[key] = matched
+          else
+            kwargs.delete(key)
           end
         end
       end

data/lib/rails_ai_context/tools/base_tool.rb

@@ -65,13 +65,24 @@ module RailsAiContext
           text_response(lines.join("\n"))
         end
 
-        # Simple fuzzy match: find the closest available name by substring or edit distance
+        # Fuzzy match: find the closest available name by exact, underscore, substring, or prefix
         def find_closest_match(input, available)
           return nil if available.empty?
           downcased = input.downcase
-          # Exact substring match first
-          exact = available.find { |a| a.downcase.include?(downcased) || downcased.include?(a.downcase) }
+          underscored = input.underscore.downcase
+
+          # Exact case-insensitive match (including underscore/classify variants)
+          exact = available.find do |a|
+            a_down = a.downcase
+            a_under = a.underscore.downcase
+            a_down == downcased || a_under == underscored || a_down == underscored || a_under == downcased
+          end
           return exact if exact
+
+          # Substring match — prefer shortest (most specific) to avoid cook → cook_comments
+          substring_matches = available.select { |a| a.downcase.include?(downcased) || downcased.include?(a.downcase) }
+          return substring_matches.min_by(&:length) if substring_matches.any?
+
           # Prefix match
           available.find { |a| a.downcase.start_with?(downcased[0..2]) }
         end

data/lib/rails_ai_context/tools/get_edit_context.rb

@@ -36,7 +36,11 @@ module RailsAiContext
       SENSITIVE_PATTERNS = nil # uses configuration.sensitive_patterns
 
       def self.call(file:, near:, context_lines: 5, server_context: nil)
-        # Reject empty search term
+        # Reject empty parameters
+        if file.nil? || file.strip.empty?
+          return text_response("The `file` parameter is required. Provide a path relative to Rails root (e.g. 'app/models/cook.rb').")
+        end
+
         if near.nil? || near.strip.empty?
           return text_response("The `near` parameter is required. Provide a method name, keyword, or string to find.")
         end

data/lib/rails_ai_context/tools/get_model_details.rb

@@ -40,7 +40,8 @@ module RailsAiContext
         # Specific model — always full detail (strip whitespace for fuzzy input)
         if model
           model = model.strip
-          key = models.keys.find { |k| k.downcase == model.downcase } || model
+          model_under = model.underscore
+          key = models.keys.find { |k| k.downcase == model.downcase || k.underscore == model_under } || model
           data = models[key]
           unless data
             return not_found_response("Model", model, models.keys.sort,

data/lib/rails_ai_context/tools/get_partial_interface.rb

@@ -201,6 +201,7 @@ module RailsAiContext
 
       # Resolve a partial reference to an actual file path on disk.
       # Handles both underscore-prefixed filenames and non-prefixed input.
+      # Falls back to recursive search when no directory is specified.
       private_class_method def self.resolve_partial_path(views_dir, partial)
         # Normalize: strip leading underscore from basename if provided
         parts = partial.split("/")
@@ -211,10 +212,11 @@ module RailsAiContext
         prefixed_basename = basename.start_with?("_") ? basename : "_#{basename}"
         unprefixed_basename = basename.delete_prefix("_")
 
+        extensions = %w[.html.erb .erb .html.haml .haml .html.slim .slim]
         candidates = []
 
         # Try prefixed name with various extensions
-        %w[.html.erb .erb .html.haml .haml .html.slim .slim].each do |ext|
+        extensions.each do |ext|
           candidates << File.join(views_dir, *dir_parts, "#{prefixed_basename}#{ext}")
           candidates << File.join(views_dir, *dir_parts, "#{unprefixed_basename}#{ext}")
         end
@@ -223,6 +225,19 @@ module RailsAiContext
         candidates << File.join(views_dir, partial)
 
         found = candidates.find { |c| File.exist?(c) }
+
+        # Fallback: if no directory was specified and direct lookup failed,
+        # search recursively for the partial across all view directories
+        if found.nil? && dir_parts.empty?
+          extensions.each do |ext|
+            matches = Dir.glob(File.join(views_dir, "**", "#{prefixed_basename}#{ext}"))
+            if matches.any?
+              found = matches.first
+              break
+            end
+          end
+        end
+
         return nil unless found
 
         # Path traversal protection

data/lib/rails_ai_context/tools/get_routes.rb

@@ -53,10 +53,11 @@ module RailsAiContext
           by_controller = by_controller.reject { |k, _| route_prefixes.any? { |p| k.downcase.start_with?(p) } }
         end
 
-        # Filter by controller — accepts both slash and :: notation
+        # Filter by controller — accepts "cooks", "CooksController", "cooks_controller", "Api::V1::Posts"
         if controller
-          normalized = controller.downcase.tr("::", "/").delete_suffix("controller")
-          filtered = by_controller.select { |k, _| k.downcase.include?(normalized) }
+          normalized = controller.underscore.delete_suffix("_controller")
+          normalized_alt = controller.downcase.delete_suffix("_controller").delete_suffix("controller")
+          filtered = by_controller.select { |k, _| k.downcase.include?(normalized) || k.downcase.include?(normalized_alt) }
           return text_response("No routes for '#{controller}'. Controllers: #{by_controller.keys.sort.join(', ')}") if filtered.empty?
           by_controller = filtered
         end

data/lib/rails_ai_context/tools/get_schema.rb

@@ -56,9 +56,14 @@ module RailsAiContext
         offset = [ offset.to_i, 0 ].max
         limit = [ limit.to_i, 0 ].max if limit && limit.to_i < 0
 
-        # Single table — case-insensitive lookup
+        # Single table — case-insensitive lookup with model name normalization
+        # Accepts: "users", "Users", "User" (model name → pluralized+underscored table)
         if table
-          table_key = tables.keys.find { |k| k.downcase == table.downcase } || table
+          table_down = table.downcase
+          table_as_table = table.underscore.pluralize # Cook → cooks, BrandProfile → brand_profiles
+          table_key = tables.keys.find { |k|
+            k.downcase == table_down || k == table_as_table || k == table.underscore
+          } || table
           table_data = tables[table_key]
           unless table_data
             return not_found_response("Table", table, tables.keys.sort,

data/lib/rails_ai_context/tools/get_stimulus.rb

@@ -44,7 +44,12 @@ module RailsAiContext
         # (HTML uses data-controller="weekly-chart", file is weekly_chart_controller.js)
         if controller
           normalized = controller.downcase.tr("-", "_")
-          ctrl = all_controllers.find { |c| c[:name]&.downcase&.tr("-", "_") == normalized }
+          # Also handle PascalCase: CookStatus → cook_status
+          underscored = controller.underscore.downcase.tr("-", "_")
+          ctrl = all_controllers.find { |c|
+            name_norm = c[:name]&.downcase&.tr("-", "_")
+            name_norm == normalized || name_norm == underscored
+          }
           unless ctrl
             names = all_controllers.map { |c| c[:name] }.sort
             return not_found_response("Stimulus controller", controller, names,

data/lib/rails_ai_context/tools/get_test_info.rb

@@ -157,16 +157,27 @@ module RailsAiContext
       end
 
       private_class_method def self.find_test_file(name, type, detail = "full")
-        # Normalize: accept "Bonus::CrisesController", "bonus/crises", "Crises"
+        # Normalize: accept "Bonus::CrisesController", "bonus/crises", "Crises", "cooks" (plural)
         snake = name.to_s.tr("/", "::").underscore.sub(/_controller$/, "")
+        # For models, also try singular form (cooks → cook)
+        snake_singular = snake.singularize
         candidates = case type
         when :model
-          [
+          base = [
             "spec/models/#{snake}_spec.rb",
             "test/models/#{snake}_test.rb",
             "spec/models/concerns/#{snake}_spec.rb",
             "test/models/concerns/#{snake}_test.rb"
           ]
+          if snake != snake_singular
+            base += [
+              "spec/models/#{snake_singular}_spec.rb",
+              "test/models/#{snake_singular}_test.rb",
+              "spec/models/concerns/#{snake_singular}_spec.rb",
+              "test/models/concerns/#{snake_singular}_test.rb"
+            ]
+          end
+          base
         when :controller
           [
             "spec/controllers/#{snake}_controller_spec.rb",

data/lib/rails_ai_context/tools/get_view.rb

@@ -51,9 +51,17 @@ module RailsAiContext
         end
 
         if controller
-          ctrl_lower = controller.downcase
-          filtered_templates = templates.select { |k, _| k.downcase.start_with?(ctrl_lower + "/") }
-          filtered_partials = partials.select { |k, _| k.downcase.start_with?(ctrl_lower + "/") }
+          # Normalize: accept "CooksController", "cooks", "cooks_controller", "Bonus::CooksController"
+          ctrl_lower = controller.underscore.delete_suffix("_controller")
+          ctrl_lower_alt = controller.downcase.delete_suffix("controller")
+          filtered_templates = templates.select { |k, _|
+            k_down = k.downcase
+            k_down.start_with?(ctrl_lower + "/") || k_down.start_with?(ctrl_lower_alt + "/")
+          }
+          filtered_partials = partials.select { |k, _|
+            k_down = k.downcase
+            k_down.start_with?(ctrl_lower + "/") || k_down.start_with?(ctrl_lower_alt + "/")
+          }
 
           if filtered_templates.empty? && filtered_partials.empty?
             all_dirs = (templates.keys + partials.keys).map { |k| k.split("/").first }.uniq.sort
@@ -303,7 +311,12 @@ module RailsAiContext
           .sort
 
         if controller
-          templates = templates.select { |t| t.downcase.start_with?(controller.downcase + "/") }
+          ctrl_lower = controller.underscore.delete_suffix("_controller")
+          ctrl_lower_alt = controller.downcase.delete_suffix("controller")
+          templates = templates.select { |t|
+            t_down = t.downcase
+            t_down.start_with?(ctrl_lower + "/") || t_down.start_with?(ctrl_lower_alt + "/")
+          }
         end
 
         lines = [ "# Views (#{templates.size} templates)", "" ]

data/lib/rails_ai_context/tools/validate.rb

@@ -37,7 +37,7 @@ module RailsAiContext
       # ── Main entry point ─────────────────────────────────────────────
 
       def self.call(files:, level: "syntax", server_context: nil)
-        return text_response("No files provided.") if files.empty?
+        return text_response("No files provided. Pass file paths relative to Rails root (e.g. files:[\"app/models/cook.rb\"]).") if files.nil? || files.empty?
         return text_response("Too many files (#{files.size}). Maximum is #{max_files} per call.") if files.size > max_files
 
         results = []
@@ -48,7 +48,9 @@ module RailsAiContext
           full_path = Rails.root.join(file)
 
           unless File.exist?(full_path)
-            results << "\u2717 #{file} \u2014 file not found"
+            suggestion = find_file_suggestion(file)
+            hint = suggestion ? " Did you mean '#{suggestion}'?" : ""
+            results << "\u2717 #{file} \u2014 file not found.#{hint}"
             total += 1
             next
           end
@@ -122,6 +124,24 @@ module RailsAiContext
 
       # ── Ruby validation ──────────────────────────────────────────────
 
+      # Search common Rails directories for a file by basename and suggest the full path
+      private_class_method def self.find_file_suggestion(file)
+        basename = File.basename(file)
+        %w[app/models app/controllers app/views app/helpers app/jobs app/mailers
+           app/services app/channels lib config].each do |dir|
+          candidate = File.join(dir, basename)
+          return candidate if File.exist?(Rails.root.join(candidate))
+        end
+
+        # Broader recursive search
+        matches = Dir.glob(File.join(Rails.root, "app", "**", basename)).first(1)
+        return matches.first.sub("#{Rails.root}/", "") if matches.any?
+
+        nil
+      rescue
+        nil
+      end
+
       private_class_method def self.validate_ruby(full_path)
         prism_available? ? validate_ruby_prism(full_path) : validate_ruby_subprocess(full_path)
       end

data/lib/rails_ai_context/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module RailsAiContext
-  VERSION = "3.0.1"
+  VERSION = "3.1.0"
 end

data/server.json

@@ -7,11 +7,11 @@
     "url": "https://github.com/crisnahine/rails-ai-context",
     "source": "github"
   },
-  "version": "3.0.1",
+  "version": "3.1.0",
   "packages": [
     {
       "registryType": "mcpb",
-      "identifier": "https://github.com/crisnahine/rails-ai-context/releases/download/v3.0.1/rails-ai-context-mcp.mcpb",
+      "identifier": "https://github.com/crisnahine/rails-ai-context/releases/download/v3.1.0/rails-ai-context-mcp.mcpb",
       "fileSha256": "dd711a0ad6c4de943ae4da94eaf59a6dc9494b9d57f726e24649ed4e2f156990",
       "transport": {
         "type": "stdio"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rails-ai-context
 version: !ruby/object:Gem::Version
-  version: 3.0.1
+  version: 3.1.0
 platform: ruby
 authors:
 - crisnahine