rails-ai-context 0.10.1 → 0.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 41d6a7f273bd4630ef25d299a4379609336714a021d77bcbb5128235a62bd830
-  data.tar.gz: 64b3c29bbf29126d6f8aaf76e1f063140ad7ea3684e15ca392a2275d2fe35110
+  metadata.gz: bdd226d739429a34c2ea8cedc8faf12e854d0220de60f5ffb08fe8fed5459f71
+  data.tar.gz: 7b609ca0007e97206b168cbda0937fb9fb581888491464619ba727a8a1b2d945
 SHA512:
-  metadata.gz: 90003df73a6d12bec5e205343ffc4615a6f59061f32bdba71f344dfcacf046de339836b871d1e6e85353bff3951673a5fa2f2c2b0bd3b950c9b0d62872760bc2
-  data.tar.gz: eaad1515c31ee3d6d3cb61a402991d92aa6107770011d70338a096d8dc23a809423e77ba3194d7813cbb3df2ea3cadf772ebdf4f7b939afe0c82940471b7b7a3
+  metadata.gz: b54b6354d0236f8f46f813593a5472fcca35dd4ceb1aefc4631479829c541b53d8a34509602b2f5903ff1af4b34b3d43d758e41f2c8e84cb5498b3212011541a
+  data.tar.gz: 0ddd8d1b1d413c3313a3189168c790dbbe776de2d573be006163867732287e939c0c8ea4490b39d1b86239f6940cfd923fcfab27ce24f6d9ba9bc3cda0c750fb

data/CLAUDE.md

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

data/README.md

@@ -21,22 +21,49 @@ The AI doesn't know your schema, your Devise setup, your Sidekiq jobs, or that `
 
 ---
 
-## Proof: 35% Token Savings (Real Benchmark)
+## Proof: 37% Token Savings (Real Benchmark)
 
-We ran the same feature task — *"Add status and date range filters to the Cooks index page"* — across 4 scenarios in parallel on a real Rails app:
+Same task — *"Add status and date range filters to the Cooks index page"* — 4 scenarios in parallel, same Rails app:
 
-| Scenario | MCP Tools | CLAUDE.md | Tokens Used | Savings |
-|----------|-----------|-----------|-------------|---------|
-| **MCP + CLAUDE.md** | Yes | Yes | **25,884** | **35% saved** |
-| MCP only | Yes | No | 27,822 | 31% saved |
-| CLAUDE.md only | No | Yes | 32,699 | 19% saved |
-| Zero (nothing) | No | No | 40,129 | baseline |
+| Setup | Tokens | Saved | What it knows |
+|-------|--------|-------|---------------|
+| **rails-ai-context (full)** | **28,834** | **37%** | 11 MCP tools + generated docs + rules |
+| rails-ai-context CLAUDE.md only | 33,106 | 27% | Generated docs + rules, no MCP tools |
+| Normal Claude `/init` | 40,700 | 11% | Generic CLAUDE.md only |
+| No rails-ai-context at all | 45,477 | baseline | Nothing — discovers everything from scratch |
 
-All 4 produced the same working feature. The only difference was how many tokens were burned getting there.
+```
+No rails-ai-context          45,477 tk  █████████████████████████████████████████████
+Normal Claude /init           40,700 tk  █████████████████████████████████████████     -11%
+rails-ai-context CLAUDE.md    33,106 tk  █████████████████████████████████             -27%
+rails-ai-context (full)       28,834 tk  █████████████████████████████                 -37%
+```
+
+https://github.com/user-attachments/assets/14476243-1210-4e62-9dc5-9d4aa9caef7e
+
+
+**What each layer gives you:**
+
+| | Normal `/init` | rails-ai-context CLAUDE.md | rails-ai-context full |
+|---|---|---|---|
+| Knows it's Rails + Tailwind | Yes | Yes | Yes |
+| Knows model names, columns, associations | No | Yes | Yes |
+| Knows controller actions, filters | No | Yes | Yes |
+| Discovery overhead | ~8 calls | 0 calls | 0 calls |
+| Structured MCP queries | No | No | Yes — 5 MCP calls replace file reads |
+
+**~16,600 fewer tokens per task** vs no gem at all.
+
+> **This was a simple task on a small 5-model app.** Real-world tasks are 3-10x more complex.
+> A feature touching auth + payments + mailers + tests on a 50-model app? Without the gem, Claude reads `db/schema.rb` (2,000+ lines), every model file, every controller, every view — easily 200K+ tokens per session. With rails-ai-context, MCP tools return only what's needed: `rails_get_schema(table:"users")` returns 25 lines instead of 2,000. **The bigger your app and the harder the task, the more you save.**
 
-https://github.com/user-attachments/assets/171f52ae-bd30-43f6-a44f-bcfdda7fc139
+| App size | Without gem | With rails-ai-context | Savings |
+|----------|-------------|----------------------|---------|
+| Small (5 models) | 45K tokens | 29K tokens | 37% |
+| Medium (30 models) | ~150K tokens | ~60K tokens | ~60% |
+| Large (100+ models) | ~500K+ tokens | ~100K tokens | ~80% |
 
-MCP tools give the AI structured, filtered access to your codebase instead of reading entire files. On this small 5-model app, that saved 35%. **On larger projects, the savings compound significantly.**
+*Medium/large estimates based on schema.rb scaling (40 lines/table), model file scaling, and MCP summary-first workflow eliminating full-file reads.*
 
 ---
 
@@ -60,10 +87,10 @@ The install generator creates `.mcp.json` for auto-discovery — Claude Code and
 
 ![Token Comparison](https://raw.githubusercontent.com/crisnahine/rails-ai-context/main/docs/token-comparison.jpeg)
 
-- Compact context files load ≤150 lines instead of thousands
-- MCP tools return `detail:"summary"` first (~55 tokens for schema overview), then drill into specifics
-- Specific lookups (`table:`, `model:`, `controller:`) return only what's needed
-- Pagination prevents dumping hundreds of tables/routes at once
+- `/init` saves 11% — knows the framework but wastes tokens discovering models and tables
+- **CLAUDE.md saves 27%** — complete Rails-specific map, zero discovery overhead
+- **Full MCP saves 37%** — structured queries replace expensive full-file reads
+- MCP tools return `detail:"summary"` first (~55 tokens), then drill into specifics
 - Split rule files only activate in relevant directories
 
 ---
@@ -362,7 +389,7 @@ The gem parses `db/schema.rb` as text when no database is connected. Works in CI
 ```bash
 git clone https://github.com/crisnahine/rails-ai-context.git
 cd rails-ai-context && bundle install
-bundle exec rspec       # 456 examples
+bundle exec rspec       # 468 examples
 bundle exec rubocop     # Lint
 ```
 

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.10.1'
+echo 'Installing rails-ai-context 0.11.0'
 echo ''
 sleep 1
 

data/lib/rails_ai_context/introspectors/model_introspector.rb

@@ -169,8 +169,8 @@ module RailsAiContext
         macros = {}
 
         macros[:has_secure_password] = true if source.match?(/\bhas_secure_password\b/)
-        macros[:encrypts] = source.scan(/\bencrypts\s+(.+)/).flat_map { |m| m[0].scan(/:(\w+)/).flatten } if source.match?(/\bencrypts\s+:/)
-        macros[:normalizes] = source.scan(/\bnormalizes\s+(.+)/).flat_map { |m| m[0].scan(/:(\w+)/).flatten } if source.match?(/\bnormalizes\s+:/)
+        macros[:encrypts] = source.scan(/\bencrypts\s+(.+?)$/).flat_map { |m| m[0].scan(/:(\w+)/).flatten } if source.match?(/\bencrypts\s+:/)
+        macros[:normalizes] = source.scan(/\bnormalizes\s+(.+?)$/).flat_map { |m| m[0].scan(/:(\w+)/).flatten } if source.match?(/\bnormalizes\s+:/)
         macros[:has_one_attached] = source.scan(/\bhas_one_attached\s+:(\w+)/).flatten if source.match?(/\bhas_one_attached\s+:/)
         macros[:has_many_attached] = source.scan(/\bhas_many_attached\s+:(\w+)/).flatten if source.match?(/\bhas_many_attached\s+:/)
         macros[:has_rich_text] = source.scan(/\bhas_rich_text\s+:(\w+)/).flatten if source.match?(/\bhas_rich_text\s+:/)
@@ -180,7 +180,7 @@ module RailsAiContext
         macros[:store] = source.scan(/\bstore(?:_accessor)?\s+:(\w+)/).flatten if source.match?(/\bstore(?:_accessor)?\s+:/)
 
         # Delegations
-        delegations = source.scan(/\bdelegate\s+(.+?),\s*to:\s*:(\w+)/).map do |methods_str, target|
+        delegations = source.scan(/\bdelegate\s+(.+?),\s*to:\s*:(\w+)/m).map do |methods_str, target|
           { methods: methods_str.scan(/:(\w+)/).flatten, to: target }
         end
         macros[:delegations] = delegations if delegations.any?

data/lib/rails_ai_context/introspectors/view_template_introspector.rb

@@ -14,11 +14,13 @@ module RailsAiContext
 
       def call
         views_dir = File.join(app.root.to_s, "app", "views")
-        return { templates: {}, partials: {} } unless Dir.exist?(views_dir)
+        return { templates: {}, partials: {}, ui_patterns: {} } unless Dir.exist?(views_dir)
 
+        all_content = collect_all_view_content(views_dir)
         {
           templates: scan_templates(views_dir),
-          partials: scan_partials(views_dir)
+          partials: scan_partials(views_dir),
+          ui_patterns: extract_ui_patterns(all_content)
         }
       rescue => e
         { error: e.message }
@@ -49,12 +51,113 @@ module RailsAiContext
         Dir.glob(File.join(views_dir, "**", "_*")).each do |path|
           next if File.directory?(path)
           relative = path.sub("#{views_dir}/", "")
-          lines = File.read(path).lines.count rescue 0
-          partials[relative] = { lines: lines }
+          content = File.read(path) rescue next
+          partials[relative] = {
+            lines: content.lines.count,
+            fields: extract_model_fields(content),
+            helpers: extract_helper_calls(content)
+          }
         end
         partials
       end
 
+      def collect_all_view_content(views_dir)
+        content = ""
+        Dir.glob(File.join(views_dir, "**", "*.{erb,haml,slim}")).each do |path|
+          next if File.directory?(path)
+          content += (File.read(path) rescue "")
+        end
+        content
+      end
+
+      def extract_ui_patterns(all_content) # rubocop:disable Metrics/MethodLength
+        patterns = {}
+        class_groups = Hash.new(0)
+
+        # Match both double and single quoted class attributes
+        all_content.scan(/class="([^"]+)"/).each do |m|
+          classes = m[0].gsub(/<%=.*?%>/, "").strip # Strip ERB interpolation
+          next if classes.length < 5
+          class_groups[classes] += 1
+        end
+        all_content.scan(/class='([^']+)'/).each do |m|
+          classes = m[0].gsub(/<%=.*?%>/, "").strip
+          next if classes.length < 5
+          class_groups[classes] += 1
+        end
+
+        # Find repeated patterns (used 2+ times) grouped by element type
+        # Framework-agnostic: works with Tailwind, Bootstrap, or custom CSS
+        buttons = []
+        cards = []
+        inputs = []
+        labels = []
+        badges = []
+        links = []
+
+        class_groups.each do |classes, count|
+          next if count < 2
+
+          if classes.match?(/btn|button|submit|bg-\w+-\d+.*text-white|hover:bg|btn-primary|btn-secondary/)
+            buttons << classes
+          elsif classes.match?(/card|panel|shadow|border.*rounded.*p-\d|bg-white.*rounded/)
+            cards << classes
+          elsif classes.match?(/input|field|form-control|border.*rounded.*px-\d|focus:ring|focus:border/)
+            inputs << classes
+          elsif classes.match?(/label|font-semibold.*mb-|font-medium.*mb-|form-label|block.*text-sm/)
+            labels << classes
+          elsif classes.match?(/badge|rounded-full|pill|tag|px-2.*py-1.*text-xs/)
+            badges << classes
+          elsif classes.match?(/link|hover:text-|hover:underline|hover:bg-.*text-.*font-/)
+            links << classes
+          end
+        end
+
+        patterns[:buttons] = buttons.first(3) if buttons.any?
+        patterns[:cards] = cards.first(3) if cards.any?
+        patterns[:inputs] = inputs.first(3) if inputs.any?
+        patterns[:labels] = labels.first(3) if labels.any?
+        patterns[:badges] = badges.first(3) if badges.any?
+        patterns[:links] = links.first(3) if links.any?
+
+        patterns
+      end
+
+      EXCLUDED_METHODS = %w[
+        each map select reject first last size count any? empty? present? blank?
+        new build create find where order limit nil? join class html_safe
+        to_s to_i to_f inspect strip chomp downcase upcase capitalize
+        humanize pluralize singularize truncate gsub sub scan match split
+        freeze dup clone length bytes chars reverse uniq compact flatten
+        flat_map zip sort sort_by min max sum group_by
+        persisted? new_record? valid? errors reload save destroy update
+        delete respond_to? is_a? kind_of? send try
+        abs round ceil floor
+        strftime iso8601 beginning_of_day end_of_day ago from_now
+      ].freeze
+
+      def extract_model_fields(content)
+        fields = []
+        content.scan(/(?:@?\w+)\.(\w+)/).each do |m|
+          field = m[0]
+          next if field.length < 3 || field.length > 40
+          next if field.match?(/\A[0-9a-f]+\z/)
+          next if field.match?(/\A[A-Z]/) # skip constant/class access
+          next if EXCLUDED_METHODS.include?(field)
+          next if field.start_with?("to_", "html_")
+          next if field.end_with?("?", "!")
+          fields << field
+        end
+        fields.uniq.first(15)
+      end
+
+      def extract_helper_calls(content)
+        helpers = []
+        # Custom helper methods (render_*, format_*, *_path, *_url)
+        content.scan(/\b(render_\w+|format_\w+)\b/).each { |m| helpers << m[0] }
+        helpers.uniq
+      end
+
       def extract_partial_refs(content)
         refs = []
         # render "partial_name" or render partial: "name"

data/lib/rails_ai_context/serializers/claude_rules_serializer.rb

@@ -24,6 +24,7 @@ module RailsAiContext
           "rails-context.md" => render_context_overview,
           "rails-schema.md" => render_schema_reference,
           "rails-models.md" => render_models_reference,
+          "rails-ui-patterns.md" => render_ui_patterns_reference,
           "rails-mcp-tools.md" => render_mcp_tools_reference
         }
 
@@ -96,11 +97,34 @@ module RailsAiContext
           ""
         ]
 
-        tables.keys.sort.each do |name|
+        skip_cols = %w[id created_at updated_at]
+        # Always show these even if they end in _id/_type (important for AI)
+        keep_cols = %w[type deleted_at discarded_at]
+
+        tables.keys.sort.first(30).each do |name|
           data = tables[name]
-          col_count = data[:columns]&.size || 0
-          pk = data[:primary_key] || "id"
-          lines << "- #{name} (#{col_count} cols, pk: #{pk})"
+          columns = data[:columns] || []
+          col_count = columns.size
+          pk = data[:primary_key]
+          pk_display = pk.is_a?(Array) ? pk.join(", ") : (pk || "id").to_s
+
+          key_cols = columns.map { |c| c[:name] }.select do |c|
+            next true if keep_cols.include?(c)
+            next true if c.end_with?("_type") # polymorphic associations
+            next false if skip_cols.include?(c)
+            next false if c.end_with?("_id")
+            true
+          end
+
+          col_sample = key_cols.first(12)
+          shown = col_sample.join(", ")
+          shown += ", ..." if key_cols.size > 12
+          col_names = col_sample.any? ? " — #{shown}" : ""
+          lines << "- #{name} (#{col_count} cols, pk: #{pk_display})#{col_names}"
+        end
+
+        if tables.size > 30
+          lines << "- ...#{tables.size - 30} more tables (use `rails_get_schema` MCP tool)"
         end
 
         lines.join("\n")
@@ -133,6 +157,29 @@ module RailsAiContext
         lines.join("\n")
       end
 
+      def render_ui_patterns_reference
+        vt = context[:view_templates]
+        return nil unless vt.is_a?(Hash) && !vt[:error]
+        patterns = vt[:ui_patterns] || {}
+        return nil if patterns.empty?
+
+        lines = [
+          "# UI Patterns",
+          "",
+          "Common CSS class patterns found in this app's views.",
+          "Use these when creating new views to match the existing design.",
+          ""
+        ]
+
+        patterns.each do |type, classes_list|
+          classes_list.each do |classes|
+            lines << "- #{type.to_s.chomp('s').capitalize}: `#{classes}`"
+          end
+        end
+
+        lines.join("\n")
+      end
+
       def render_mcp_tools_reference # rubocop:disable Metrics/MethodLength,Metrics/AbcSize
         lines = [
           "# Rails MCP Tools — ALWAYS Use These First",

data/lib/rails_ai_context/serializers/claude_serializer.rb

@@ -29,6 +29,7 @@ module RailsAiContext
         lines.concat(render_key_models)
         lines.concat(render_notable_gems)
         lines.concat(render_architecture)
+        lines.concat(render_ui_patterns)
         lines.concat(render_mcp_guide)
         lines.concat(render_conventions)
         lines.concat(render_commands)
@@ -158,6 +159,22 @@ module RailsAiContext
         lines
       end
 
+      def render_ui_patterns
+        vt = context[:view_templates]
+        return [] unless vt.is_a?(Hash) && !vt[:error]
+        patterns = vt[:ui_patterns] || {}
+        return [] if patterns.empty?
+
+        lines = [ "## UI Patterns" ]
+        patterns.each do |type, classes_list|
+          classes_list.each do |classes|
+            lines << "- #{type.to_s.chomp('s').capitalize}: `#{classes}`"
+          end
+        end
+        lines << ""
+        lines
+      end
+
       def render_mcp_guide # rubocop:disable Metrics/MethodLength
         [
           "## MCP Tools (11) — ALWAYS Use These First",

data/lib/rails_ai_context/serializers/copilot_instructions_serializer.rb

@@ -22,6 +22,7 @@ module RailsAiContext
           "rails-context.instructions.md" => render_context_instructions,
           "rails-models.instructions.md" => render_models_instructions,
           "rails-controllers.instructions.md" => render_controllers_instructions,
+          "rails-ui-patterns.instructions.md" => render_ui_patterns_instructions,
           "rails-mcp-tools.instructions.md" => render_mcp_tools_instructions
         }
 
@@ -134,6 +135,30 @@ module RailsAiContext
         lines.join("\n")
       end
 
+      def render_ui_patterns_instructions
+        vt = context[:view_templates]
+        return nil unless vt.is_a?(Hash) && !vt[:error]
+        patterns = vt[:ui_patterns] || {}
+        return nil if patterns.empty?
+
+        lines = [
+          "---",
+          "applyTo: \"app/views/**/*.erb\"",
+          "---",
+          "",
+          "# UI Patterns",
+          "",
+          "Use these CSS class patterns to match the existing design.",
+          ""
+        ]
+
+        patterns.each do |type, classes_list|
+          classes_list.each { |c| lines << "- #{type.to_s.chomp('s').capitalize}: `#{c}`" }
+        end
+
+        lines.join("\n")
+      end
+
       def render_mcp_tools_instructions # rubocop:disable Metrics/MethodLength
         lines = [
           "---",

data/lib/rails_ai_context/serializers/copilot_serializer.rb

@@ -80,6 +80,19 @@ module RailsAiContext
           end
         end
 
+        # UI Patterns
+        vt = context[:view_templates]
+        if vt.is_a?(Hash) && !vt[:error]
+          patterns = vt[:ui_patterns] || {}
+          if patterns.any?
+            lines << "## UI Patterns"
+            patterns.each do |type, classes_list|
+              classes_list.each { |c| lines << "- #{type.to_s.chomp('s').capitalize}: `#{c}`" }
+            end
+            lines << ""
+          end
+        end
+
         # MCP tools
         lines << "## MCP Tool Reference"
         lines << ""

data/lib/rails_ai_context/serializers/cursor_rules_serializer.rb

@@ -25,6 +25,7 @@ module RailsAiContext
           "rails-project.mdc" => render_project_rule,
           "rails-models.mdc" => render_models_rule,
           "rails-controllers.mdc" => render_controllers_rule,
+          "rails-ui-patterns.mdc" => render_ui_patterns_rule,
           "rails-mcp-tools.mdc" => render_mcp_tools_rule
         }
 
@@ -154,6 +155,33 @@ module RailsAiContext
         lines.join("\n")
       end
 
+      def render_ui_patterns_rule
+        vt = context[:view_templates]
+        return nil unless vt.is_a?(Hash) && !vt[:error]
+        patterns = vt[:ui_patterns] || {}
+        return nil if patterns.empty?
+
+        lines = [
+          "---",
+          "description: \"UI/CSS patterns used in this Rails app\"",
+          "globs:",
+          "  - \"app/views/**/*.erb\"",
+          "alwaysApply: false",
+          "---",
+          "",
+          "# UI Patterns",
+          "",
+          "Use these CSS class patterns to match the existing design.",
+          ""
+        ]
+
+        patterns.each do |type, classes_list|
+          classes_list.each { |c| lines << "- #{type.to_s.chomp('s').capitalize}: `#{c}`" }
+        end
+
+        lines.join("\n")
+      end
+
       # Always-on MCP tool reference — strongest enforcement point for Cursor
       def render_mcp_tools_rule # rubocop:disable Metrics/MethodLength
         lines = [

data/lib/rails_ai_context/serializers/opencode_serializer.rb

@@ -29,6 +29,7 @@ module RailsAiContext
         lines.concat(render_key_models)
         lines.concat(render_notable_gems)
         lines.concat(render_architecture)
+        lines.concat(render_ui_patterns)
         lines.concat(render_mcp_guide)
         lines.concat(render_conventions)
         lines.concat(render_commands)
@@ -158,6 +159,22 @@ module RailsAiContext
         lines
       end
 
+      def render_ui_patterns
+        vt = context[:view_templates]
+        return [] unless vt.is_a?(Hash) && !vt[:error]
+        patterns = vt[:ui_patterns] || {}
+        return [] if patterns.empty?
+
+        lines = [ "## UI Patterns" ]
+        patterns.each do |type, classes_list|
+          classes_list.each do |classes|
+            lines << "- #{type.to_s.chomp('s').capitalize}: `#{classes}`"
+          end
+        end
+        lines << ""
+        lines
+      end
+
       def render_mcp_guide # rubocop:disable Metrics/MethodLength
         [
           "## MCP Tools (11) — ALWAYS Use These First",

data/lib/rails_ai_context/serializers/rules_serializer.rb

@@ -73,6 +73,19 @@ module RailsAiContext
           end
         end
 
+        # UI Patterns
+        vt = context[:view_templates]
+        if vt.is_a?(Hash) && !vt[:error]
+          patterns = vt[:ui_patterns] || {}
+          if patterns.any?
+            lines << "## UI Patterns"
+            patterns.each do |type, classes_list|
+              classes_list.each { |c| lines << "- #{type.to_s.chomp('s').capitalize}: `#{c}`" }
+            end
+            lines << ""
+          end
+        end
+
         # MCP tools
         lines << "## MCP Tool Reference"
         lines << ""

data/lib/rails_ai_context/serializers/windsurf_rules_serializer.rb

@@ -22,6 +22,7 @@ module RailsAiContext
 
         files = {
           "rails-context.md" => render_context_rule,
+          "rails-ui-patterns.md" => render_ui_patterns_rule,
           "rails-mcp-tools.md" => render_mcp_tools_rule
         }
 
@@ -49,6 +50,19 @@ module RailsAiContext
         WindsurfSerializer.new(context).call
       end
 
+      def render_ui_patterns_rule
+        vt = context[:view_templates]
+        return nil unless vt.is_a?(Hash) && !vt[:error]
+        patterns = vt[:ui_patterns] || {}
+        return nil if patterns.empty?
+
+        lines = [ "# UI Patterns", "", "Match these CSS classes when creating new views.", "" ]
+        patterns.each do |type, classes_list|
+          classes_list.first(2).each { |c| lines << "- #{type}: `#{c}`" }
+        end
+        lines.join("\n")
+      end
+
       def render_mcp_tools_rule # rubocop:disable Metrics/MethodLength
         lines = [
           "# Rails MCP Tools (11) — Use These First",

data/lib/rails_ai_context/serializers/windsurf_serializer.rb

@@ -71,6 +71,17 @@ module RailsAiContext
           end
         end
 
+        # UI Patterns (compact — character budget is tight)
+        vt = context[:view_templates]
+        if vt.is_a?(Hash) && !vt[:error]
+          patterns = vt[:ui_patterns] || {}
+          if patterns.any?
+            lines << "# UI Patterns"
+            patterns.each { |type, list| list.first(1).each { |c| lines << "- #{type}: `#{c}`" } }
+            lines << ""
+          end
+        end
+
         # MCP tools — compact but complete (character budget is tight)
         lines << "# MCP Tools (detail:\"summary\"|\"standard\"|\"full\")"
         lines << "- rails_get_schema(table:\"name\"|detail:\"summary\"|limit:N|offset:N)"

data/lib/rails_ai_context/tasks/rails_ai_context.rake

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-ASSISTANT_TABLE = <<~TABLE
+ASSISTANT_TABLE = <<~TABLE unless defined?(ASSISTANT_TABLE)
   AI Assistant       Context File                          Command
   --                 --                                    --
   Claude Code        CLAUDE.md + .claude/rules/            rails ai:context:claude
@@ -14,7 +14,7 @@ TABLE
 def print_result(result)
   result[:written].each { |f| puts "  ✅ #{f}" }
   result[:skipped].each { |f| puts "  ⏭️  #{f} (unchanged)" }
-end
+end unless defined?(print_result)
 
 def apply_context_mode_override
   if ENV["CONTEXT_MODE"]
@@ -22,7 +22,7 @@ def apply_context_mode_override
     RailsAiContext.configuration.context_mode = mode
     puts "📐 Context mode: #{mode}"
   end
-end
+end unless defined?(apply_context_mode_override)
 
 namespace :ai do
   desc "Generate AI context files (CLAUDE.md, .cursor/rules/, .windsurfrules, .github/copilot-instructions.md)"

data/lib/rails_ai_context/tools/get_view.rb

@@ -63,15 +63,32 @@ module RailsAiContext
           text_response(lines.join("\n"))
 
         when "standard"
-          lines = [ "# Views (#{templates.size} templates)", "" ]
+          all_partials = data[:partials] || {}
+          lines = [ "# Views (#{templates.size} templates, #{all_partials.size} partials)", "" ]
           templates.keys.map { |k| k.split("/").first }.uniq.sort.each do |ctrl|
             ctrl_templates = templates.select { |k, _| k.start_with?("#{ctrl}/") }
             lines << "## #{ctrl}/"
             ctrl_templates.sort.each do |name, meta|
-              parts = meta[:partials]&.any? ? " partials: #{meta[:partials].join(', ')}" : ""
+              parts = meta[:partials]&.any? ? " renders: #{meta[:partials].join(', ')}" : ""
               stim = meta[:stimulus]&.any? ? " stimulus: #{meta[:stimulus].join(', ')}" : ""
               lines << "- #{File.basename(name)} (#{meta[:lines]} lines)#{parts}#{stim}"
             end
+            # Show partials for this controller with field/helper info
+            ctrl_partials = all_partials.select { |k, _| k.start_with?("#{ctrl}/") }
+            ctrl_partials.sort.each do |name, meta|
+              fields = meta[:fields]&.any? ? " fields: #{meta[:fields].join(', ')}" : ""
+              helpers = meta[:helpers]&.any? ? " helpers: #{meta[:helpers].join(', ')}" : ""
+              lines << "- #{File.basename(name)} (#{meta[:lines]} lines)#{fields}#{helpers}"
+            end
+            lines << ""
+          end
+          # Show shared partials
+          shared = all_partials.select { |k, _| k.start_with?("shared/") }
+          if shared.any?
+            lines << "## shared/"
+            shared.sort.each do |name, meta|
+              lines << "- #{File.basename(name)} (#{meta[:lines]} lines)"
+            end
             lines << ""
           end
           text_response(lines.join("\n"))
@@ -92,6 +109,8 @@ module RailsAiContext
         end
       end
 
+      MAX_FILE_SIZE = 2_000_000 # 2MB safety limit
+
       private_class_method def self.read_view_file(path)
         views_dir = Rails.root.join("app", "views")
         full_path = views_dir.join(path)
@@ -103,6 +122,9 @@ module RailsAiContext
         unless File.exist?(full_path)
           return text_response("View not found: #{path}")
         end
+        if File.size(full_path) > MAX_FILE_SIZE
+          return text_response("File too large: #{path} (#{File.size(full_path)} bytes)")
+        end
 
         content = File.read(full_path)
         text_response("# #{path}\n\n```erb\n#{content}\n```")

data/lib/rails_ai_context/tools/search_code.rb

@@ -106,7 +106,11 @@ module RailsAiContext
 
       private_class_method def self.search_with_ruby(pattern, search_path, file_type, max_results, root)
         results = []
-        regex = Regexp.new(pattern, Regexp::IGNORECASE)
+        begin
+          regex = Regexp.new(pattern, Regexp::IGNORECASE, timeout: 2)
+        rescue RegexpError => e
+          return [ { file: "error", line_number: 0, content: "Invalid regex: #{e.message}" } ]
+        end
         glob = file_type ? "**/*.#{file_type}" : "**/*.{rb,js,erb,yml,yaml,json}"
         excluded = RailsAiContext.configuration.excluded_paths
 

data/lib/rails_ai_context/version.rb

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

data/server.json

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