rails-ai-context 3.0.0 → 3.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 29cd675e5f63893551b3ca87869bc6bca2335a5a2fe15ea38e54ec11dab6329a
-  data.tar.gz: 4c2a0fe1003abd939f1ea005cf1aefac1055672dbe80c9fb771937acec1bde24
+  metadata.gz: a6bdb0dcbde3c7abfab69bee14e661afc8a260fe3d00faa99ecc4becbc58a19b
+  data.tar.gz: deacfa10c6c188d0482fc82199f085b4f13cbf24b0cf06e0977074ecf67864d8
 SHA512:
-  metadata.gz: 31a7796c31b70f9e3d667d4b961d00cd316a6bd365720fff32b9d922d7faa1febdbcfad00adcba0ff7d625af510e80ff8a1b596dba504543e0f1e72ce65022af
-  data.tar.gz: 552c6388e3ea2648f400d2b948eefd25e325e4ec67a896b7917dee61d6bd37032df0a5d1c5e03c1dd6dbe66fbf6b21e2e38d725344b4438b98d23c0d5141d6f4
+  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
@@ -13,17 +29,24 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 
-- **CLI tool support** — all 25 MCP tools can now be run from the terminal. Rake: `rails 'ai:tool[schema]' table=users detail=full`. Thor CLI: `rails-ai-context tool schema --table users --detail full`. `rails ai:tool` (no args) lists all tools. `--help` shows per-tool help auto-generated from input_schema. `--json` / `JSON=1` for JSON envelope output. Tool name resolution: `schema` → `get_schema` → `rails_get_schema`.
-- **`tool_mode` config** — new `config.tool_mode` option: `:mcp` (default, MCP primary + CLI fallback) or `:cli` (CLI only, no MCP server needed). Selected during `rails generate rails_ai_context:install`.
-- **ToolGuideHelper** — shared serializer module for tool reference sections, rendering MCP or CLI syntax based on `tool_mode`. All 5 serializers updated to use it.
-- **ToolRunner** — `lib/rails_ai_context/cli/tool_runner.rb` handles CLI tool execution with argument parsing, tool name resolution, help generation, and JSON output formatting.
+- **CLI tool support** — all 25 MCP tools can now be run from the terminal: `rails 'ai:tool[schema]' table=users detail=full`. Also via Thor CLI: `rails-ai-context tool schema --table users`. `rails ai:tool` lists all tools. `--help` shows per-tool help auto-generated from input_schema. `--json` / `JSON=1` for JSON envelope. Tool name resolution: `schema` → `get_schema` → `rails_get_schema`.
+- **`tool_mode` config** — `:mcp` (default, MCP primary + CLI fallback) or `:cli` (CLI only, no MCP server needed). Selected during install and first `rails ai:context` run.
+- **ToolRunner** — `lib/rails_ai_context/cli/tool_runner.rb` handles CLI tool execution: arg parsing, type coercion from input_schema, required param validation, enum checking, fuzzy tool name suggestions on typos.
+- **ToolGuideHelper** — shared serializer module renders tool reference sections with MCP or CLI syntax based on `tool_mode`, with MANDATORY enforcement + CLI escape hatch. 3-column tool table (MCP | CLI | description).
+- **Copilot `excludeAgent`** — MCP tools instruction file uses `excludeAgent: "code-review"` (code review can't invoke MCP tools, saves 4K char budget).
+- **`.mcp.json` auto-create** — `rails ai:context` automatically creates `.mcp.json` when `tool_mode` is `:mcp` and the file doesn't exist. Existing apps upgrading to v3.0.0 get it without re-running the install generator.
+- **Full config initializer** — generated initializer documents every configuration option organized by section (AI Tools, Introspection, Models & Filtering, MCP Server, File Size Limits, Extensibility, Security, Search).
+- **Cursor MDC compliance spec** — 26 tests validating MDC format: frontmatter fields, rule types, glob syntax, line limits.
+- **Copilot compliance spec** — 25 tests validating instruction format: applyTo, excludeAgent, file naming, content quality.
 
 ### Changed
 
 - Serializer count reduced from 6 to 5 (Claude, Cursor, Copilot, OpenCode, JSON).
-- Install generator AI tool selection renumbered (4 options instead of 5).
-- Install generator now includes MCP opt-in step for `tool_mode` selection.
-- All documentation, rake tasks, CLI, and configuration updated to reflect Windsurf removal.
+- Install generator renumbered (4 AI tool options instead of 5) + MCP opt-in step.
+- Cursor glob-based rules no longer combine `globs` + `description` (pure Type 2 auto-attach per Cursor best practices).
+- MCP tool instructions use MANDATORY enforcement with CLI escape hatch — AI agents use tools when available, fall back to CLI or file reading when not.
+- All CLI examples use zsh-safe quoting: `rails 'ai:tool[X]'` (brackets are glob patterns in zsh).
+- README rewritten with real-world workflow examples, categorized tool table, MCP vs CLI showcase.
 
 ## [2.0.5] - 2026-03-25
 

data/CLAUDE.md

@@ -11,7 +11,7 @@ structure to AI assistants via the Model Context Protocol (MCP).
 - `lib/rails_ai_context/introspectors/` — 29 introspectors (schema, models, routes, jobs, gems, conventions, stimulus, database_stats, controllers, views, view_templates, design_tokens, turbo, i18n, config, active_storage, action_text, auth, api, tests, rake_tasks, assets, devops, action_mailbox, migrations, seeds, middleware, engines, multi_database)
 - `lib/rails_ai_context/tools/` — 25 MCP tools using the official mcp SDK
 - `lib/rails_ai_context/cli/` — CLI tool runner (`tool_runner.rb`) — executes MCP tools from rake/Thor
-- `lib/rails_ai_context/serializers/` — Output formatters (claude, claude_rules, opencode, opencode_rules, cursor_rules, copilot, copilot_instructions, rules, markdown, JSON, context_file_serializer, test_command_detection, tool_guide_helper)
+- `lib/rails_ai_context/serializers/` — Output formatters (claude, claude_rules, opencode, opencode_rules, cursor_rules, copilot, copilot_instructions, rules, markdown, JSON, context_file_serializer, test_command_detection, tool_guide_helper, design_system_helper, stack_overview_helper)
 - `lib/rails_ai_context/resources.rb` — MCP resources (static data AI clients read directly)
 - `lib/rails_ai_context/server.rb` — MCP server configuration (stdio + HTTP transports)
 - `lib/rails_ai_context/middleware.rb` — Rack middleware for auto-mounting MCP HTTP endpoint
@@ -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,6 +9,8 @@
 
 **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 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
 rails generate rails_ai_context:install
@@ -16,6 +18,8 @@ rails generate rails_ai_context:install
 
 That's it. Your AI now has 25 tools that understand your entire Rails app — via MCP server or CLI. Zero config.
 
+> **[Full Guide →](docs/GUIDE.md)** — every command, every parameter, every configuration option.
+
 ---
 
 ## Two ways to use it
@@ -336,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.0"
+  VERSION = "3.1.0"
 end

data/server.json

@@ -2,16 +2,16 @@
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
   "name": "io.github.crisnahine/rails-ai-context",
   "title": "Rails AI Context",
-  "description": "Auto-expose Rails app structure to AI via MCP. Zero config, 25 read-only tools.",
+  "description": "Auto-expose Rails app structure to AI via MCP or CLI. Zero config, 25 read-only tools.",
   "repository": {
     "url": "https://github.com/crisnahine/rails-ai-context",
     "source": "github"
   },
-  "version": "3.0.0",
+  "version": "3.1.0",
   "packages": [
     {
       "registryType": "mcpb",
-      "identifier": "https://github.com/crisnahine/rails-ai-context/releases/download/v3.0.0/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.0
+  version: 3.1.0
 platform: ruby
 authors:
 - crisnahine
@@ -164,10 +164,11 @@ dependencies:
 description: |
   rails-ai-context gives AI coding agents a complete mental model of your Rails
   app — not just files, but how schema, models, routes, controllers, views, and
-  conventions connect. 25 live MCP tools let agents query structure on demand with
-  semantic validation that catches cross-file errors (wrong columns, missing
-  partials, broken routes) before code runs. Auto-generates context files for
-  Claude Code, Cursor, GitHub Copilot, and OpenCode. Zero config.
+  conventions connect. 25 live tools (via MCP server or CLI) let agents query
+  structure on demand with semantic validation that catches cross-file errors
+  (wrong columns, missing partials, broken routes) before code runs.
+  Auto-generates context files for Claude Code, Cursor, GitHub Copilot, and
+  OpenCode. Zero config.
 email:
 - crisjosephnahine@gmail.com
 executables:
@@ -290,9 +291,9 @@ metadata:
 post_install_message: |
   rails-ai-context installed! Quick start:
     rails generate rails_ai_context:install
-    rails ai:context         # generate context files (compact mode)
-    rails ai:context:full    # full dump (good for small apps)
-    rails ai:serve           # start MCP server for Claude Code / Cursor
+    rails ai:context              # generate context files
+    rails 'ai:tool[schema]'      # run any of the 25 tools from CLI
+    rails ai:serve                # start MCP server (optional)
 rdoc_options: []
 require_paths:
 - lib
@@ -309,5 +310,6 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 rubygems_version: 3.6.9
 specification_version: 4
-summary: Give AI agents a complete mental model of your Rails app via MCP — zero config.
+summary: Give AI agents a complete mental model of your Rails app — 25 tools via MCP
+  or CLI. Zero config.
 test_files: []