rails-ai-context 0.10.2 → 0.11.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 68c0816e248242dd0b6b6c122f8a5538295823a4da7386746aa3d3ea8c3a8ee0
-  data.tar.gz: 178f97d3d8557621dbe0cc163e75e83afed3156ca1ea87d185e29ca380567580
+  metadata.gz: bdd226d739429a34c2ea8cedc8faf12e854d0220de60f5ffb08fe8fed5459f71
+  data.tar.gz: 7b609ca0007e97206b168cbda0937fb9fb581888491464619ba727a8a1b2d945
 SHA512:
-  metadata.gz: 953fcec85a05ec05862157ae70a8715f0daad9d1b4f1fba075c8f1ef16a13de90eaf81e3906efd5790fb4ed32106bb5838668ff0d41533a569a7e6443f63b141
-  data.tar.gz: eade81b4fa9597317981d8f17a6fccdc6d9872adae3b543dd18cf9449d6746072584f754ded5031c2376b33d30aded7164c03f7253513e1c2f2c7b9c4c35d225
+  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

@@ -389,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.2'
+echo 'Installing rails-ai-context 0.11.0'
 echo ''
 sleep 1
 

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"))

data/lib/rails_ai_context/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module RailsAiContext
-  VERSION = "0.10.2"
+  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.2",
+  "version": "0.11.0",
   "packages": [
     {
       "registryType": "mcpb",
-      "identifier": "https://github.com/crisnahine/rails-ai-context/releases/download/v0.10.2/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.2
+  version: 0.11.0
 platform: ruby
 authors:
 - crisnahine