rails-ai-context 0.13.1 → 0.14.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9eb210617bf9e0de267dc49a092f8a06c26383bd3dc6ad82ecb52ed61ce08aa6
-  data.tar.gz: '08929a12848a79b58a7e5e896a8a75c1d7068f8c1fe4910d8fc6f7eb8371aeec'
+  metadata.gz: f5b745a3b7eec70c71340022f60a7fadacd80cae84f5d4586936b78633677f0e
+  data.tar.gz: 5619c0302827cb96ef33175264e83f36fa2f055925e6517316b379d24599fff7
 SHA512:
-  metadata.gz: '0280fc9dff2714ddda17e7cc9f714e3147641bbbbe4a08f01c03515b4a847ac60acf7e68e55d0181ae768f6c8cb7fc1ac0d518b90af5ea390fd2af211d65a34b'
-  data.tar.gz: 5b5e52eacd2efac4320b633e027af67c5d72aa506c217dd7ddf64d4e969fd471122daeb2d9a0ed5fb4f2b256b65b52509a8785f783e0befb70c15fbea2bcb1c3
+  metadata.gz: 810c890604f5d4b78d56e4580254279b3b741d15fd0dbe2419fbf661d2ee47dd70b678cf962aa65244e025e70633dcc5cceee30319c27edf60c04d2a6127ce39
+  data.tar.gz: 4f6ed5c100bcf1907b5c38ac9043669ab4c4d833a30c65613d25f0a125de1909f054da48ce3b3fd87f427e1f5e7ff6f8fb422cd812016ed57b85218d592c5f52

data/CLAUDE.md

@@ -32,7 +32,7 @@ structure to AI assistants via the Model Context Protocol (MCP).
 6. **Diff-aware** — context regeneration skips unchanged files
 7. **Per-assistant serializers** — each AI tool gets tailored output format
 8. **Zeitwerk autoloading** — files loaded on-demand, not all upfront
-9. **Introspector presets** — `:standard` (12 core) default, `:full` (28) for power users
+9. **Introspector presets** — `:standard` (13 core) default, `:full` (28) for power users
 10. **MCP auto-discovery** — `.mcp.json` generated by install generator
 11. **Compact by default** — context files ≤150 lines, MCP tools use `detail` parameter (summary/standard/full)
 12. **Per-tool split rules** — `.claude/rules/`, `.cursor/rules/`, `.windsurf/rules/`, `.github/instructions/`

data/README.md

@@ -203,7 +203,7 @@ Root files (CLAUDE.md, AGENTS.md, etc.) use **section markers** — your custom
 | **DevOps** | Puma, Procfile, Docker, deployment tools, asset pipeline |
 | **Architecture** | Service objects, STI, polymorphism, state machines, multi-tenancy, engines |
 
-29 introspectors total. The `:standard` preset runs 12 core ones by default; use `:full` for 28 (`database_stats` is opt-in, PostgreSQL only).
+29 introspectors total. The `:standard` preset runs 13 core ones by default; use `:full` for 28 (`database_stats` is opt-in, PostgreSQL only).
 
 ---
 
@@ -257,7 +257,7 @@ end
 ```ruby
 # config/initializers/rails_ai_context.rb
 RailsAiContext.configure do |config|
-  # Presets: :standard (12 introspectors, default) or :full (all 28)
+  # Presets: :standard (13 introspectors, default) or :full (all 28)
   config.preset = :standard
 
   # Cherry-pick on top of a preset
@@ -291,7 +291,7 @@ end
 | Option | Default | Description |
 |--------|---------|-------------|
 | `preset` | `:standard` | Introspector preset (`:standard` or `:full`) |
-| `introspectors` | 12 core | Array of introspector symbols |
+| `introspectors` | 13 core | Array of introspector symbols |
 | `context_mode` | `:compact` | `:compact` (≤150 lines) or `:full` (dump everything) |
 | `claude_max_lines` | `150` | Max lines for CLAUDE.md in compact mode |
 | `max_tool_response_chars` | `120_000` | Safety cap for MCP tool responses |

data/demo_script.sh

@@ -8,7 +8,7 @@ echo 'Fetching gem metadata from https://rubygems.org...'
 sleep 0.3
 echo 'Resolving dependencies...'
 sleep 0.3
-echo 'Installing rails-ai-context 0.13.1'
+echo 'Installing rails-ai-context 0.14.0'
 echo ''
 sleep 1
 

data/docs/GUIDE.md

@@ -579,7 +579,7 @@ Both transports are **read-only** — they expose the same 13 tools and never mo
 RailsAiContext.configure do |config|
   # --- Introspectors ---
 
-  # Presets: :standard (12 core, default) or :full (all 28)
+  # Presets: :standard (13 core, default) or :full (all 28)
   config.preset = :standard
 
   # Cherry-pick on top of a preset
@@ -636,7 +636,7 @@ end
 | Option | Type | Default | Description |
 |--------|------|---------|-------------|
 | `preset` | Symbol | `:standard` | Introspector preset (`:standard` or `:full`) |
-| `introspectors` | Array | 12 core symbols | Which introspectors to run |
+| `introspectors` | Array | 13 core symbols | Which introspectors to run |
 | `context_mode` | Symbol | `:compact` | `:compact` or `:full` |
 | `claude_max_lines` | Integer | `150` | Max lines for CLAUDE.md in compact mode |
 | `max_tool_response_chars` | Integer | `120_000` | Safety cap for MCP tool responses |
@@ -673,7 +673,7 @@ All split rules include an app overview file, so no context is lost when root fi
 
 ## Introspectors — Full List
 
-### Standard preset (12 introspectors)
+### Standard preset (13 introspectors)
 
 These run by default. Fast and cover core Rails structure.
 

data/lib/rails_ai_context/configuration.rb

@@ -3,7 +3,7 @@
 module RailsAiContext
   class Configuration
     PRESETS = {
-      standard: %i[schema models routes jobs gems conventions controllers tests migrations stimulus view_templates design_tokens],
+      standard: %i[schema models routes jobs gems conventions controllers tests migrations stimulus view_templates design_tokens config],
       full: %i[schema models routes jobs gems conventions stimulus 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]

data/lib/rails_ai_context/introspectors/route_introspector.rb

@@ -26,6 +26,9 @@ module RailsAiContext
       private
 
       def extract_routes
+        # Force Rails to reload routes if routes.rb has changed
+        app.routes_reloader&.execute_if_updated rescue nil
+
         app.routes.routes.filter_map do |route|
           next if route.respond_to?(:internal?) && route.internal?
           next if route.defaults[:controller].blank?

data/lib/rails_ai_context/introspectors/schema_introspector.rb

@@ -138,8 +138,13 @@ module RailsAiContext
             tables[current_table] = { columns: [], indexes: [], foreign_keys: [] }
           elsif current_table && (match = line.match(/t\.(\w+)\s+"(\w+)"/))
             tables[current_table][:columns] << { name: match[2], type: match[1] }
-          elsif (match = line.match(/add_index\s+"(\w+)",\s+\[?"(\w+)"/))
-            tables[match[1]]&.dig(:indexes)&.push({ columns: match[2] })
+          elsif (match = line.match(/add_index\s+"(\w+)",\s+(.+)/))
+            table_name = match[1]
+            rest = match[2]
+            cols = rest.scan(/(?::|\")(\w+)/).flatten
+            unique = rest.include?("unique: true")
+            idx_name = rest.match(/name:\s*"(\w+)"/)&.send(:[], 1)
+            tables[table_name]&.dig(:indexes)&.push({ name: idx_name, columns: cols, unique: unique }.compact) if cols.any?
           end
         end
 
@@ -164,9 +169,9 @@ module RailsAiContext
         end
 
         # Match CREATE INDEX / CREATE UNIQUE INDEX
-        content.scan(/CREATE (?:UNIQUE )?INDEX (\w+) ON (?:public\.)?(\w+).*?\((.+?)\)/m) do |idx_name, table, cols|
-          col_list = cols.scan(/\w+/).first
-          tables[table]&.dig(:indexes)&.push({ name: idx_name, columns: col_list })
+        content.scan(/CREATE (UNIQUE )?INDEX (\w+) ON (?:public\.)?(\w+).*?\((.+?)\)/m) do |unique, idx_name, table, cols|
+          col_list = cols.scan(/\w+/)
+          tables[table]&.dig(:indexes)&.push({ name: idx_name, columns: col_list, unique: !!unique })
         end
 
         # Match ALTER TABLE ... ADD CONSTRAINT ... FOREIGN KEY (handles multi-line)

data/lib/rails_ai_context/introspectors/stimulus_introspector.rb

@@ -52,10 +52,25 @@ module RailsAiContext
       end
 
       def extract_values(content)
-        match = content.match(/static\s+values\s*=\s*\{([^}]*)\}/m)
+        match = content.match(/static\s+values\s*=\s*\{(.*?)\}/m)
         return {} unless match
 
-        match[1].scan(/(\w+)\s*:\s*(\w+)/).to_h
+        body = match[1]
+        values = {}
+
+        # Handle complex format: name: { type: Type, default: val }
+        body.scan(/(\w+)\s*:\s*\{([^}]+)\}/).each do |name, inner|
+          type = inner.match(/type:\s*(\w+)/)&.send(:[], 1) || "Object"
+          default = inner.match(/default:\s*(\S+)/)&.send(:[], 1)&.chomp(",")
+          values[name] = default ? "#{type} (default: #{default})" : type
+        end
+
+        # Handle simple format: name: Type (single line or multi-line)
+        body.scan(/(\w+)\s*:\s*([A-Z]\w+)/).each do |name, type|
+          values[name] ||= type
+        end
+
+        values
       end
 
       def extract_actions(content)

data/lib/rails_ai_context/tools/get_model_details.rb

@@ -135,10 +135,15 @@ module RailsAiContext
           end
         end
 
-        # Concerns
+        # Concerns — filter out internal Rails modules
         if data[:concerns]&.any?
-          lines << "" << "## Concerns"
-          lines << data[:concerns].map { |c| "- #{c}" }.join("\n")
+          app_concerns = data[:concerns].reject do |c|
+            c.match?(/\A(ActiveRecord|ActiveModel|ActiveSupport|ActionText|ActionMailbox|ActiveStorage|GeneratedAssociationMethods|Kernel|JSON|PP|Marshal|MessagePack|GeneratedRelationMethods)/)
+          end
+          if app_concerns.any?
+            lines << "" << "## Concerns"
+            lines << app_concerns.map { |c| "- #{c}" }.join("\n")
+          end
         end
 
         # Key instance methods — include signatures from source if available

data/lib/rails_ai_context/tools/get_routes.rb

@@ -24,13 +24,21 @@ module RailsAiContext
           offset: {
             type: "integer",
             description: "Skip routes for pagination. Default: 0."
+          },
+          app_only: {
+            type: "boolean",
+            description: "Filter out internal Rails routes (Active Storage, Action Mailbox, Conductor, etc.). Default: true."
           }
         }
       )
 
+      INTERNAL_PREFIXES = %w[
+        action_mailbox/ active_storage/ rails/ conductor/
+      ].freeze
+
       annotations(read_only_hint: true, destructive_hint: false, idempotent_hint: true, open_world_hint: false)
 
-      def self.call(controller: nil, detail: "standard", limit: nil, offset: 0, server_context: nil)
+      def self.call(controller: nil, detail: "standard", limit: nil, offset: 0, app_only: true, server_context: nil)
         routes = cached_context[:routes]
         return text_response("Route introspection not available. Add :routes to introspectors.") unless routes
         return text_response("Route introspection failed: #{routes[:error]}") if routes[:error]
@@ -38,6 +46,11 @@ module RailsAiContext
         by_controller = routes[:by_controller] || {}
         offset = [ offset.to_i, 0 ].max
 
+        # Filter out internal Rails routes by default
+        if app_only
+          by_controller = by_controller.reject { |k, _| INTERNAL_PREFIXES.any? { |p| k.downcase.start_with?(p) } }
+        end
+
         # Filter by controller
         if controller
           filtered = by_controller.select { |k, _| k.downcase.include?(controller.downcase) }
@@ -70,7 +83,8 @@ module RailsAiContext
               count += 1
               next if count <= offset
               break if count > offset + limit
-              ctrl_lines << "- `#{r[:verb]}` `#{r[:path]}` → #{r[:action]}"
+              name_part = r[:name] ? " `#{r[:name]}`" : ""
+              ctrl_lines << "- `#{r[:verb]}` `#{r[:path]}` → #{r[:action]}#{name_part}"
             end
             if ctrl_lines.any?
               lines << "## #{ctrl}"

data/lib/rails_ai_context/tools/get_stimulus.rb

@@ -30,10 +30,12 @@ module RailsAiContext
         controllers = data[:controllers] || []
         return text_response("No Stimulus controllers found.") if controllers.empty?
 
-        # Specific controller
+        # Specific controller — accepts both dash and underscore naming
+        # (HTML uses data-controller="weekly-chart", file is weekly_chart_controller.js)
         if controller
-          ctrl = controllers.find { |c| c[:name]&.downcase == controller.downcase }
-          return text_response("Controller '#{controller}' not found. Available: #{controllers.map { |c| c[:name] }.sort.join(', ')}") unless ctrl
+          normalized = controller.downcase.tr("-", "_")
+          ctrl = controllers.find { |c| c[:name]&.downcase&.tr("-", "_") == normalized }
+          return text_response("Controller '#{controller}' not found. Available: #{controllers.map { |c| c[:name] }.sort.join(', ')}\n\n_Note: use dashes in HTML (`data-controller=\"my-name\"`) but underscores for lookup (`controller:\"my_name\"`)._") unless ctrl
           return text_response(format_controller_full(ctrl))
         end
 
@@ -78,6 +80,8 @@ module RailsAiContext
         lines << "- **Outlets:** #{ctrl[:outlets].join(', ')}" if ctrl[:outlets]&.any?
         lines << "- **Classes:** #{ctrl[:classes].join(', ')}" if ctrl[:classes]&.any?
         lines << "- **File:** #{ctrl[:file]}" if ctrl[:file]
+        html_name = ctrl[:name]&.tr("_", "-")
+        lines << "" << "_HTML: `data-controller=\"#{html_name}\"`_" if html_name
         lines.join("\n")
       end
     end

data/lib/rails_ai_context/tools/search_code.rb

@@ -27,6 +27,10 @@ module RailsAiContext
           max_results: {
             type: "integer",
             description: "Maximum number of results. Default: 30, max: 100."
+          },
+          context_lines: {
+            type: "integer",
+            description: "Lines of context before and after each match (like grep -C). Default: 0, max: 5."
           }
         },
         required: [ "pattern" ]
@@ -34,7 +38,7 @@ module RailsAiContext
 
       annotations(read_only_hint: true, destructive_hint: false, idempotent_hint: true, open_world_hint: false)
 
-      def self.call(pattern:, path: nil, file_type: nil, max_results: 30, server_context: nil)
+      def self.call(pattern:, path: nil, file_type: nil, max_results: 30, context_lines: 0, server_context: nil)
         root = Rails.root.to_s
 
         # Validate file_type to prevent injection
@@ -42,9 +46,10 @@ module RailsAiContext
           return text_response("Invalid file_type: must contain only alphanumeric characters.")
         end
 
-        # Cap max_results
+        # Cap max_results and context_lines
         max_results = [ max_results.to_i, MAX_RESULTS_CAP ].min
         max_results = 30 if max_results < 1
+        context_lines = [ [ context_lines.to_i, 0 ].max, 5 ].min
 
         search_path = path ? File.join(root, path) : root
 
@@ -64,7 +69,7 @@ module RailsAiContext
         end
 
         results = if ripgrep_available?
-                    search_with_ripgrep(pattern, search_path, file_type, max_results, root)
+                    search_with_ripgrep(pattern, search_path, file_type, max_results, root, context_lines)
         else
                     search_with_ruby(pattern, search_path, file_type, max_results, root)
         end
@@ -84,8 +89,9 @@ module RailsAiContext
         @rg_available ||= system("which rg > /dev/null 2>&1")
       end
 
-      private_class_method def self.search_with_ripgrep(pattern, search_path, file_type, max_results, root)
+      private_class_method def self.search_with_ripgrep(pattern, search_path, file_type, max_results, root, ctx_lines = 0)
         cmd = [ "rg", "--no-heading", "--line-number", "--max-count", max_results.to_s ]
+        cmd.push("-C", ctx_lines.to_s) if ctx_lines > 0
 
         RailsAiContext.configuration.excluded_paths.each do |p|
           cmd << "--glob=!#{p}"

data/lib/rails_ai_context/version.rb

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

data/server.json

@@ -7,11 +7,11 @@
     "url": "https://github.com/crisnahine/rails-ai-context",
     "source": "github"
   },
-  "version": "0.13.1",
+  "version": "0.14.0",
   "packages": [
     {
       "registryType": "mcpb",
-      "identifier": "https://github.com/crisnahine/rails-ai-context/releases/download/v0.13.1/rails-ai-context-mcp.mcpb",
+      "identifier": "https://github.com/crisnahine/rails-ai-context/releases/download/v0.14.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: 0.13.1
+  version: 0.14.0
 platform: ruby
 authors:
 - crisnahine