rails-ai-context 4.3.2 → 4.4.0

data/demo.tape

@@ -0,0 +1,33 @@
+# VHS demo tape for rails-ai-context install
+Output demo.gif
+
+Set Shell zsh
+Set FontSize 14
+Set Width 950
+Set Height 520
+Set Padding 12
+Set Theme "Catppuccin Mocha"
+Set TypingSpeed 35ms
+
+Type "cd /Users/crisjosephnahine/Documents/Projects/daily-content-chef"
+Enter
+Sleep 1s
+
+Type "rails generate rails_ai_context:install"
+Sleep 400ms
+Enter
+Sleep 3s
+
+# Select Claude Code + Cursor
+Type "1,2"
+Sleep 300ms
+Enter
+Sleep 2s
+
+# Select MCP mode (yes)
+Type "1"
+Sleep 300ms
+Enter
+Sleep 4s
+
+Sleep 2s

data/docs/GUIDE.md

@@ -1128,7 +1128,7 @@ Both transports are **read-only** — they expose the same 39 tools and never mo
 RailsAiContext.configure do |config|
   # --- Introspectors ---
 
-  # Presets: :full (32 introspectors, default) or :standard (14 core)
+  # Presets: :full (33 introspectors, default) or :standard (19)
   config.preset = :full
 
   # Cherry-pick on top of a preset
@@ -1300,7 +1300,7 @@ All split rules include an app overview file, so no context is lost when root fi
 
 ## Introspectors — Full List
 
-### Standard preset (14 introspectors)
+### Standard preset (19 introspectors)
 
 Core Rails structure only. Use `config.preset = :standard` for a lighter footprint.
 
@@ -1320,19 +1320,21 @@ Core Rails structure only. Use `config.preset = :standard` for a lighter footpri
 | `view_templates` | View file contents, partial references, Stimulus data attributes, UI pattern extraction, model field usage in partials. |
 | `design_tokens` | Auto-detects CSS framework (Tailwind v3/v4, Bootstrap, Sass, plain CSS) and extracts design tokens from config files and built CSS. |
 | `components` | ViewComponent/Phlex components: props, slots, previews, sidecar assets, usage examples. |
+| `turbo` | Turbo Frames (IDs and files), Turbo Stream templates, model broadcasts (`broadcasts_to`, `broadcasts`). |
+| `auth` | Devise models with modules, Rails 8 built-in auth, has_secure_password, Pundit policies, CanCanCan, CORS config, CSP config. |
+| `accessibility` | ARIA attributes, semantic HTML elements, screen reader text, alt text coverage, landmark roles, accessibility score. |
+| `performance` | N+1 query risks, missing counter_cache, missing FK indexes, Model.all anti-patterns, eager load candidates. |
+| `i18n` | Default locale, available locales, locale files with key counts, backend class, parse errors. |
 
-### Full preset (32 introspectors) — default
+### Full preset (33 introspectors) — default
 
 Includes all standard introspectors plus:
 
 | Introspector | What it discovers |
 |-------------|-------------------|
 | `views` | Layouts, templates grouped by controller, partials (per-controller and shared), helpers with methods, template engines (erb, haml, slim), view components. |
-| `turbo` | Turbo Frames (IDs and files), Turbo Stream templates, model broadcasts (`broadcasts_to`, `broadcasts`). |
-| `i18n` | Default locale, available locales, locale files with key counts, backend class, parse errors. |
 | `active_storage` | Attachments (has_one_attached, has_many_attached per model), storage services, direct upload config. |
 | `action_text` | Rich text fields (has_rich_text per model), Action Text installation status. |
-| `auth` | Devise models with modules, Rails 8 built-in auth, has_secure_password, Pundit policies, CanCanCan, CORS config, CSP config. |
 | `api` | API-only mode, API versioning (from directory structure), serializers (Jbuilder, AMS, etc.), GraphQL (types, mutations), rate limiting (Rack::Attack). |
 | `rake_tasks` | Custom rake tasks in `lib/tasks/` with names, descriptions, namespaces, file paths. |
 | `assets` | Asset pipeline (Propshaft/Sprockets), JS bundler (importmap/esbuild/webpack/vite), CSS framework, importmap pins, manifest files. |
@@ -1342,10 +1344,8 @@ Includes all standard introspectors plus:
 | `middleware` | Custom Rack middleware in app/middleware/ with detected patterns (auth, rate limiting, tenant isolation, logging). Full middleware stack. |
 | `engines` | Mounted Rails engines from routes.rb with paths and descriptions for 23+ known engines (Sidekiq::Web, Flipper::UI, PgHero, ActiveAdmin, etc.). |
 | `multi_database` | Multiple databases, replicas, sharding config, model-specific `connects_to` declarations. database.yml parsing fallback. |
-| `accessibility` | ARIA attributes, semantic HTML elements, screen reader text, alt text coverage, landmark roles, accessibility score. |
-| `performance` | N+1 query risks, missing counter_cache, missing FK indexes, Model.all anti-patterns, eager load candidates. |
 | `frontend_frameworks` | Frontend JS framework detection (React/Vue/Svelte/Angular), mounting strategy (Inertia/react-rails), TypeScript config, state management, package manager. |
-| `database_stats` | PostgreSQL approximate row counts via `pg_stat_user_tables`. **Opt-in only** — not in any preset, add manually: `config.introspectors += [:database_stats]`. |
+| `database_stats` | PostgreSQL approximate row counts via `pg_stat_user_tables`. Gracefully skips on non-PostgreSQL adapters. |
 
 ### Using the standard preset
 

data/lib/generators/rails_ai_context/install/install_generator.rb

@@ -377,7 +377,8 @@ module RailsAiContext
         return nil unless match
 
         match[1].split.map(&:to_sym)
-      rescue
+      rescue => e
+        $stderr.puts "[rails-ai-context] read_previous_ai_tools failed: #{e.message}" if ENV["DEBUG"]
         nil
       end
       end # no_tasks

data/lib/rails_ai_context/cli/tool_runner.rb

@@ -178,7 +178,7 @@ module RailsAiContext
                 next
               end
 
-              value = args[i + 1]
+              value = (i + 1 < args.size) ? args[i + 1] : nil
               if value && !value.start_with?("--")
                 result[key] = coerce_value(value, prop)
                 i += 2

data/lib/rails_ai_context/configuration.rb

@@ -6,7 +6,7 @@ module RailsAiContext
       standard: %i[schema models routes jobs gems conventions controllers tests migrations stimulus
                    view_templates design_tokens config components
                    turbo auth accessibility performance i18n],
-      full: %i[schema models routes jobs gems conventions stimulus controllers views view_templates design_tokens turbo
+      full: %i[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
                components accessibility performance frontend_frameworks]
@@ -198,5 +198,29 @@ module RailsAiContext
     def output_dir_for(app)
       @output_dir || app.root.to_s
     end
+
+    def http_port=(value)
+      value = value.to_i
+      raise ArgumentError, "http_port must be between 1 and 65535 (got #{value})" unless value.between?(1, 65535)
+      @http_port = value
+    end
+
+    def cache_ttl=(value)
+      value = value.to_i
+      raise ArgumentError, "cache_ttl must be positive (got #{value})" unless value > 0
+      @cache_ttl = value
+    end
+
+    def max_tool_response_chars=(value)
+      value = value.to_i
+      raise ArgumentError, "max_tool_response_chars must be positive (got #{value})" unless value > 0
+      @max_tool_response_chars = value
+    end
+
+    def query_row_limit=(value)
+      value = value.to_i
+      raise ArgumentError, "query_row_limit must be between 1 and 1000 (got #{value})" unless value.between?(1, 1000)
+      @query_row_limit = value
+    end
   end
 end

data/lib/rails_ai_context/doctor.rb

@@ -84,7 +84,8 @@ module RailsAiContext
           message: "#{pending.size} pending migration(s) — schema data will be stale",
           fix: "Run `rails db:migrate`")
       end
-    rescue
+    rescue => e
+      $stderr.puts "[rails-ai-context] check_pending_migrations failed: #{e.message}" if ENV["DEBUG"]
       # Can't check pending migrations in this environment
       nil
     end
@@ -234,7 +235,8 @@ module RailsAiContext
           message: "#{errors.size} introspector(s) returned errors: #{errors.join(', ')}",
           fix: "Check if the app has the required features (e.g., stimulus needs app/javascript/controllers/)")
       end
-    rescue
+    rescue => e
+      $stderr.puts "[rails-ai-context] check_introspector_health failed: #{e.message}" if ENV["DEBUG"]
       nil
     end
 

data/lib/rails_ai_context/fingerprinter.rb

@@ -50,6 +50,8 @@ module RailsAiContext
         WATCHED_FILES.each do |file|
           path = File.join(root, file)
           digest.update(File.mtime(path).to_f.to_s) if File.exist?(path)
+        rescue Errno::ENOENT
+          # File deleted between exist? check and mtime read — skip
         end
 
         WATCHED_DIRS.each do |dir|
@@ -58,6 +60,8 @@ module RailsAiContext
 
           Dir.glob(File.join(full_dir, "**/*.{rb,rake,js,ts,erb,haml,slim,yml}")).sort.each do |path|
             digest.update(File.mtime(path).to_f.to_s)
+          rescue Errno::ENOENT
+            # File deleted between glob and mtime read — skip
           end
         end
 
@@ -71,7 +75,8 @@ module RailsAiContext
         spec = Bundler.rubygems.find_name("rails-ai-context").first
         return false unless spec
         spec.source.is_a?(Bundler::Source::Path)
-      rescue
+      rescue => e
+        $stderr.puts "[rails-ai-context] local_gem_path? failed: #{e.message}" if ENV["DEBUG"]
         false
       end
 

data/lib/rails_ai_context/introspectors/accessibility_introspector.rb

@@ -21,6 +21,10 @@ module RailsAiContext
           images: analyze_images(views),
           labels: analyze_labels(views),
           landmarks: extract_landmarks(views),
+          heading_hierarchy: analyze_heading_hierarchy(views),
+          skip_links: detect_skip_links(views),
+          live_regions: count_live_regions(views),
+          form_inputs: analyze_form_inputs(views),
           summary: build_summary(views)
         }
       rescue => e
@@ -50,7 +54,8 @@ module RailsAiContext
           Dir.glob(File.join(dir, "**/*.{erb,haml,slim,html}")).each do |path|
             content = File.read(path, encoding: "UTF-8", invalid: :replace, undef: :replace)
             views << { file: path.sub("#{root}/", ""), content: content }
-          rescue
+          rescue => e
+            $stderr.puts "[rails-ai-context] collect_view_content failed: #{e.message}" if ENV["DEBUG"]
             next
           end
         end
@@ -149,6 +154,52 @@ module RailsAiContext
         landmarks
       end
 
+      def analyze_heading_hierarchy(views)
+        all_content = views.map { |v| v[:content] }.join("\n")
+        counts = {}
+        (1..6).each do |level|
+          count = all_content.scan(/<h#{level}[\s>]/i).size
+          counts["h#{level}"] = count if count > 0
+        end
+        counts
+      rescue => e
+        $stderr.puts "[rails-ai-context] analyze_heading_hierarchy failed: #{e.message}" if ENV["DEBUG"]
+        {}
+      end
+
+      def detect_skip_links(views)
+        all_content = views.map { |v| v[:content] }.join("\n")
+        {
+          skip_to_content: all_content.scan(/skip.to.(?:content|main)/i).size > 0,
+          skip_navigation: all_content.scan(/skip.nav/i).size > 0
+        }
+      rescue => e
+        $stderr.puts "[rails-ai-context] detect_skip_links failed: #{e.message}" if ENV["DEBUG"]
+        {}
+      end
+
+      def count_live_regions(views)
+        all_content = views.map { |v| v[:content] }.join("\n")
+        {
+          aria_live: all_content.scan(/aria-live=["'](\w+)["']/).flatten.tally,
+          aria_atomic: all_content.scan(/aria-atomic=/).size
+        }
+      rescue => e
+        $stderr.puts "[rails-ai-context] count_live_regions failed: #{e.message}" if ENV["DEBUG"]
+        {}
+      end
+
+      def analyze_form_inputs(views)
+        all_content = views.map { |v| v[:content] }.join("\n")
+        {
+          required: all_content.scan(/\brequired\b/).size,
+          input_types: all_content.scan(/type=["'](\w+)["']/).flatten.tally
+        }
+      rescue => e
+        $stderr.puts "[rails-ai-context] analyze_form_inputs failed: #{e.message}" if ENV["DEBUG"]
+        {}
+      end
+
       def build_summary(views)
         all_content = views.map { |v| v[:content] }.join("\n")
 

data/lib/rails_ai_context/introspectors/action_mailbox_introspector.rb

@@ -40,8 +40,16 @@ module RailsAiContext
             { pattern: match[0], action: match[1] }
           end
 
-          { name: name, file: relative, routing: routing }
-        rescue
+          # Extract callbacks
+          callbacks = content.scan(/\b(before_processing|after_processing|around_processing)\s+:(\w+)/).map do |type, method|
+            { type: type, method: method }
+          end
+
+          entry = { name: name, file: relative, routing: routing }
+          entry[:callbacks] = callbacks if callbacks.any?
+          entry
+        rescue => e
+          $stderr.puts "[rails-ai-context] extract_mailboxes failed: #{e.message}" if ENV["DEBUG"]
           nil
         end.sort_by { |m| m[:name] }
       end

data/lib/rails_ai_context/introspectors/action_text_introspector.rb

@@ -13,7 +13,8 @@ module RailsAiContext
       def call
         {
           installed: defined?(ActionText) ? true : false,
-          rich_text_fields: extract_rich_text_fields
+          rich_text_fields: extract_rich_text_fields,
+          trix_customizations: detect_trix_customizations
         }
       rescue => e
         { error: e.message }
@@ -25,6 +26,24 @@ module RailsAiContext
         app.root.to_s
       end
 
+      def detect_trix_customizations
+        customs = []
+        js_dirs = [ File.join(app.root, "app", "javascript"), File.join(app.root, "app", "assets", "javascripts") ]
+        js_dirs.each do |dir|
+          next unless Dir.exist?(dir)
+          Dir.glob(File.join(dir, "**", "*.{js,ts}")).each do |path|
+            content = File.read(path, encoding: "UTF-8", invalid: :replace, undef: :replace)
+            customs << "custom_toolbar" if content.match?(/Trix\.config\.toolbar/)
+            customs << "custom_attachment" if content.match?(/trix-attachment|Trix\.Attachment/)
+            customs << "custom_editor" if content.match?(/trix-initialize|trix-change/)
+          end
+        end
+        customs.uniq
+      rescue => e
+        $stderr.puts "[rails-ai-context] detect_trix_customizations failed: #{e.message}" if ENV["DEBUG"]
+        []
+      end
+
       def extract_rich_text_fields
         models_dir = File.join(root, "app/models")
         return [] unless Dir.exist?(models_dir)
@@ -40,7 +59,8 @@ module RailsAiContext
         end
 
         fields.sort_by { |f| [ f[:model], f[:field] ] }
-      rescue
+      rescue => e
+        $stderr.puts "[rails-ai-context] extract_rich_text_fields failed: #{e.message}" if ENV["DEBUG"]
         []
       end
     end

data/lib/rails_ai_context/introspectors/active_storage_introspector.rb

@@ -16,7 +16,9 @@ module RailsAiContext
           installed: defined?(ActiveStorage) ? true : false,
           attachments: extract_attachments,
           storage_services: extract_storage_services,
-          direct_upload: detect_direct_upload
+          direct_upload: detect_direct_upload,
+          validations: extract_attachment_validations,
+          variants: extract_variants
         }
       rescue => e
         { error: e.message }
@@ -47,7 +49,8 @@ module RailsAiContext
         end
 
         attachments.sort_by { |a| [ a[:model], a[:name] ] }
-      rescue
+      rescue => e
+        $stderr.puts "[rails-ai-context] extract_attachments failed: #{e.message}" if ENV["DEBUG"]
         []
       end
 
@@ -58,7 +61,49 @@ module RailsAiContext
         require "yaml"
         config = YAML.load_file(config_path, permitted_classes: [ Symbol ], aliases: true) || {}
         config.keys.sort
-      rescue
+      rescue => e
+        $stderr.puts "[rails-ai-context] extract_storage_services failed: #{e.message}" if ENV["DEBUG"]
+        []
+      end
+
+      def extract_attachment_validations
+        validations = []
+        models_dir = File.join(app.root, "app", "models")
+        return validations unless Dir.exist?(models_dir)
+
+        Dir.glob(File.join(models_dir, "**", "*.rb")).each do |path|
+          content = File.read(path, encoding: "UTF-8", invalid: :replace, undef: :replace)
+          model = File.basename(path, ".rb").camelize
+          content.each_line do |line|
+            if (match = line.match(/validates?\s+:(\w+),.*content_type:/))
+              validations << { model: model, attachment: match[1], type: "content_type" }
+            end
+            if (match = line.match(/validates?\s+:(\w+),.*size:/))
+              validations << { model: model, attachment: match[1], type: "size" }
+            end
+          end
+        end
+        validations
+      rescue => e
+        $stderr.puts "[rails-ai-context] extract_attachment_validations failed: #{e.message}" if ENV["DEBUG"]
+        []
+      end
+
+      def extract_variants
+        variants = []
+        models_dir = File.join(app.root, "app", "models")
+        return variants unless Dir.exist?(models_dir)
+
+        Dir.glob(File.join(models_dir, "**", "*.rb")).each do |path|
+          content = File.read(path, encoding: "UTF-8", invalid: :replace, undef: :replace)
+          model = File.basename(path, ".rb").camelize
+          content.scan(/\.variant\s*\(\s*:(\w+)/).each do |name|
+            variants << { model: model, name: name[0] }
+          end
+        end
+        variants
+      rescue => e
+        $stderr.puts "[rails-ai-context] extract_variants failed: #{e.message}" if ENV["DEBUG"]
         []
       end
 
@@ -71,7 +116,8 @@ module RailsAiContext
           Dir.glob(File.join(dir, "**/*")).any? do |f|
             next false if File.directory?(f)
             File.read(f).match?(/direct.upload|DirectUpload|direct_upload/)
-          rescue
+          rescue => e
+            $stderr.puts "[rails-ai-context] detect_direct_upload failed: #{e.message}" if ENV["DEBUG"]
             false
           end
         end

data/lib/rails_ai_context/introspectors/api_introspector.rb

@@ -20,7 +20,9 @@ module RailsAiContext
           rate_limiting: detect_rate_limiting,
           openapi_spec: detect_openapi_specs,
           cors_config: detect_cors_config,
-          api_client_generation: detect_api_client_generation
+          api_client_generation: detect_api_client_generation,
+          graphql_details: extract_graphql_details,
+          pagination: detect_pagination
         }
       rescue => e
         { error: e.message }
@@ -85,7 +87,8 @@ module RailsAiContext
              .map { |path| path.sub("#{root}/", "") }
              .sort
              .uniq
-      rescue
+      rescue => e
+        $stderr.puts "[rails-ai-context] detect_openapi_specs failed: #{e.message}" if ENV["DEBUG"]
         []
       end
 
@@ -99,7 +102,8 @@ module RailsAiContext
         end
 
         { file: "config/initializers/cors.rb", origins: origins }
-      rescue
+      rescue => e
+        $stderr.puts "[rails-ai-context] detect_cors_config failed: #{e.message}" if ENV["DEBUG"]
         nil
       end
 
@@ -111,10 +115,41 @@ module RailsAiContext
         codegen_tools = %w[openapi-typescript @graphql-codegen/cli orval]
 
         codegen_tools.select { |tool| content.include?(%("#{tool}")) }
-      rescue
+      rescue => e
+        $stderr.puts "[rails-ai-context] detect_api_client_generation failed: #{e.message}" if ENV["DEBUG"]
         []
       end
 
+      def extract_graphql_details
+        graphql_dir = File.join(app.root, "app", "graphql")
+        return nil unless Dir.exist?(graphql_dir)
+
+        details = {}
+        details[:resolvers] = Dir.glob(File.join(graphql_dir, "**", "*resolver*")).map { |f| File.basename(f, ".rb").camelize }
+        details[:subscriptions] = Dir.glob(File.join(graphql_dir, "**", "subscriptions", "*.rb")).map { |f| File.basename(f, ".rb").camelize }
+        details[:dataloaders] = Dir.glob(File.join(graphql_dir, "**", "{loaders,dataloaders}", "*.rb")).map { |f| File.basename(f, ".rb").camelize }
+        details.reject { |_, v| v.empty? }
+      rescue => e
+        $stderr.puts "[rails-ai-context] extract_graphql_details failed: #{e.message}" if ENV["DEBUG"]
+        nil
+      end
+
+      def detect_pagination
+        gemfile_lock = File.join(app.root, "Gemfile.lock")
+        return nil unless File.exist?(gemfile_lock)
+        content = File.read(gemfile_lock)
+
+        strategies = []
+        strategies << "pagy" if content.include?("pagy")
+        strategies << "kaminari" if content.include?("kaminari")
+        strategies << "will_paginate" if content.include?("will_paginate")
+        strategies << "cursor" if content.include?("graphql-pro") # cursor-based pagination
+        strategies.empty? ? nil : strategies
+      rescue => e
+        $stderr.puts "[rails-ai-context] detect_pagination failed: #{e.message}" if ENV["DEBUG"]
+        nil
+      end
+
       def detect_rate_limiting
         # Rack::Attack
         init_path = File.join(root, "config/initializers/rack_attack.rb")
@@ -126,7 +161,8 @@ module RailsAiContext
           Dir.glob(File.join(controllers_dir, "**/*.rb")).each do |path|
             content = File.read(path)
             return { rails_rate_limiting: true } if content.match?(/rate_limit\b/)
-          rescue
+          rescue => e
+            $stderr.puts "[rails-ai-context] detect_rate_limiting failed: #{e.message}" if ENV["DEBUG"]
             next
           end
         end

data/lib/rails_ai_context/introspectors/asset_pipeline_introspector.rb

@@ -42,7 +42,8 @@ module RailsAiContext
 
         content = File.read(path)
         content.scan(/pin\s+["']([^"']+)["']/).flatten.sort
-      rescue
+      rescue => e
+        $stderr.puts "[rails-ai-context] extract_importmap_pins failed: #{e.message}" if ENV["DEBUG"]
         []
       end
 
@@ -50,14 +51,17 @@ module RailsAiContext
         lock_content = read_gemfile_lock
         return nil unless lock_content
 
-        return "tailwindcss" if lock_content.include?("tailwindcss-rails (")
+        return "tailwindcss" if lock_content.include?("tailwindcss-rails (") || package_json_has?("tailwindcss")
         return "bootstrap" if lock_content.include?("bootstrap (") || package_json_has?("bootstrap")
         return "bulma" if package_json_has?("bulma")
+        return "foundation" if package_json_has?("foundation-sites")
+        return "postcss" if package_json_has?("postcss") && !package_json_has?("tailwindcss")
         nil
       end
 
       def detect_js_bundler
         return "importmap" if File.exist?(File.join(root, "config/importmap.rb"))
+        return "bun" if File.exist?(File.join(root, "bun.lockb")) || File.exist?(File.join(root, "bunfig.toml"))
         return "esbuild" if package_json_has?("esbuild")
         return "webpack" if File.exist?(File.join(root, "config/webpack")) || package_json_has?("webpack")
         return "vite" if Dir.glob(File.join(root, "vite.config.*")).any?
@@ -76,7 +80,8 @@ module RailsAiContext
       def read_gemfile_lock
         path = File.join(root, "Gemfile.lock")
         File.exist?(path) ? File.read(path) : nil
-      rescue
+      rescue => e
+        $stderr.puts "[rails-ai-context] read_gemfile_lock failed: #{e.message}" if ENV["DEBUG"]
         nil
       end
 
@@ -84,7 +89,8 @@ module RailsAiContext
         path = File.join(root, "package.json")
         return false unless File.exist?(path)
         File.read(path).include?("\"#{package}\"")
-      rescue
+      rescue => e
+        $stderr.puts "[rails-ai-context] package_json_has? failed: #{e.message}" if ENV["DEBUG"]
         false
       end
     end