rails-ai-context 4.3.2 → 4.3.3

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/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]

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

@@ -71,7 +71,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

@@ -50,7 +50,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

data/lib/rails_ai_context/introspectors/action_mailbox_introspector.rb

@@ -41,7 +41,8 @@ module RailsAiContext
           end
 
           { name: name, file: relative, routing: routing }
-        rescue
+        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

@@ -40,7 +40,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

@@ -47,7 +47,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 +59,8 @@ 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
 
@@ -71,7 +73,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

@@ -85,7 +85,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 +100,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,7 +113,8 @@ 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
 
@@ -126,7 +129,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
 
@@ -76,7 +77,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 +86,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

data/lib/rails_ai_context/introspectors/auth_introspector.rb

@@ -103,7 +103,8 @@ module RailsAiContext
         end
 
         result
-      rescue
+      rescue => e
+        $stderr.puts "[rails-ai-context] detect_devise_modules_per_model failed: #{e.message}" if ENV["DEBUG"]
         {}
       end
 
@@ -115,7 +116,8 @@ module RailsAiContext
         token_auth[:http_token_auth] = detect_http_token_auth
 
         token_auth
-      rescue
+      rescue => e
+        $stderr.puts "[rails-ai-context] detect_token_auth failed: #{e.message}" if ENV["DEBUG"]
         {}
       end
 
@@ -129,7 +131,8 @@ module RailsAiContext
         end
 
         { detected: true }
-      rescue
+      rescue => e
+        $stderr.puts "[rails-ai-context] detect_devise_jwt failed: #{e.message}" if ENV["DEBUG"]
         { detected: false }
       end
 
@@ -150,7 +153,8 @@ module RailsAiContext
         result[:grant_flows] = grant_flows if grant_flows
         result[:access_token_expires_in] = expires_in if expires_in
         result
-      rescue
+      rescue => e
+        $stderr.puts "[rails-ai-context] detect_doorkeeper failed: #{e.message}" if ENV["DEBUG"]
         nil
       end
 
@@ -164,7 +168,8 @@ module RailsAiContext
             path.sub("#{root}/", "")
           end
         end.sort
-      rescue
+      rescue => e
+        $stderr.puts "[rails-ai-context] detect_http_token_auth failed: #{e.message}" if ENV["DEBUG"]
         []
       end
 
@@ -182,7 +187,8 @@ module RailsAiContext
           results << { model: model_name, matches: matches.flatten.map(&:strip) }
         end
         results.sort_by { |r| r[:model] }
-      rescue
+      rescue => e
+        $stderr.puts "[rails-ai-context] scan_models_for failed: #{e.message}" if ENV["DEBUG"]
         []
       end
 
@@ -190,7 +196,8 @@ module RailsAiContext
         lock_path = File.join(root, "Gemfile.lock")
         return false unless File.exist?(lock_path)
         File.read(lock_path).include?("    #{name} (")
-      rescue
+      rescue => e
+        $stderr.puts "[rails-ai-context] gem_present? failed: #{e.message}" if ENV["DEBUG"]
         false
       end
 

data/lib/rails_ai_context/introspectors/config_introspector.rb

@@ -40,7 +40,8 @@ module RailsAiContext
         when Array then store.first.to_s
         else store.class.name
         end
-      rescue
+      rescue => e
+        $stderr.puts "[rails-ai-context] detect_cache_store failed: #{e.message}" if ENV["DEBUG"]
         "unknown"
       end
 
@@ -55,7 +56,8 @@ module RailsAiContext
         when Class then adapter.name
         else adapter.to_s
         end
-      rescue
+      rescue => e
+        $stderr.puts "[rails-ai-context] detect_queue_adapter failed: #{e.message}" if ENV["DEBUG"]
         "unknown"
       end
 
@@ -78,13 +80,15 @@ module RailsAiContext
         end
 
         settings.empty? ? nil : settings
-      rescue
+      rescue => e
+        $stderr.puts "[rails-ai-context] detect_mailer_settings failed: #{e.message}" if ENV["DEBUG"]
         nil
       end
 
       def extract_middleware
         app.middleware.map { |m| m.name || m.klass.to_s }.uniq
-      rescue
+      rescue => e
+        $stderr.puts "[rails-ai-context] extract_middleware failed: #{e.message}" if ENV["DEBUG"]
         []
       end
 
@@ -100,7 +104,8 @@ module RailsAiContext
       def credentials_configured?
         creds = app.credentials
         creds.respond_to?(:config) && creds.config.keys.any?
-      rescue
+      rescue => e
+        $stderr.puts "[rails-ai-context] credentials_configured? failed: #{e.message}" if ENV["DEBUG"]
         false
       end
 
@@ -113,7 +118,8 @@ module RailsAiContext
           if content.match?(/< ActiveSupport::CurrentAttributes|< Rails::CurrentAttributes/)
             File.basename(path, ".rb").camelize
           end
-        rescue
+        rescue => e
+          $stderr.puts "[rails-ai-context] detect_current_attributes failed: #{e.message}" if ENV["DEBUG"]
           nil
         end
       end

data/lib/rails_ai_context/introspectors/controller_introspector.rb

@@ -51,7 +51,8 @@ module RailsAiContext
         else
           Rails.application.eager_load!
         end
-      rescue
+      rescue => e
+        $stderr.puts "[rails-ai-context] eager_load_controllers! failed: #{e.message}" if ENV["DEBUG"]
         nil
       end
 
@@ -131,7 +132,8 @@ module RailsAiContext
           return actions if actions.any?
         end
         ctrl.action_methods.to_a.sort
-      rescue
+      rescue => e
+        $stderr.puts "[rails-ai-context] extract_actions failed: #{e.message}" if ENV["DEBUG"]
         []
       end
 
@@ -192,7 +194,8 @@ module RailsAiContext
         end
 
         []
-      rescue
+      rescue => e
+        $stderr.puts "[rails-ai-context] extract_filters failed: #{e.message}" if ENV["DEBUG"]
         []
       end
 
@@ -215,7 +218,8 @@ module RailsAiContext
           klass = klass.superclass
         end
         constraints
-      rescue
+      rescue => e
+        $stderr.puts "[rails-ai-context] collect_source_constraints failed: #{e.message}" if ENV["DEBUG"]
         {}
       end
 
@@ -287,7 +291,8 @@ module RailsAiContext
       def devise_controller?(ctrl)
         return false unless defined?(::DeviseController)
         ctrl < ::DeviseController || ctrl.ancestors.any? { |a| a.name&.start_with?("Devise::") }
-      rescue
+      rescue => e
+        $stderr.puts "[rails-ai-context] devise_controller? failed: #{e.message}" if ENV["DEBUG"]
         false
       end
 
@@ -303,7 +308,8 @@ module RailsAiContext
           .reject { |mod| mod.name&.start_with?("ActionController", "ActionDispatch", "ActiveSupport", "AbstractController") }
           .map(&:name)
           .compact
-      rescue
+      rescue => e
+        $stderr.puts "[rails-ai-context] extract_concerns failed: #{e.message}" if ENV["DEBUG"]
         []
       end
 
@@ -338,7 +344,8 @@ module RailsAiContext
           exceptions = exception_part&.scan(/([A-Z][\w:]+)/)&.flatten || []
           exceptions.map { |ex| { exception: ex, handler: handler }.compact }
         end.flatten
-      rescue
+      rescue => e
+        $stderr.puts "[rails-ai-context] extract_rescue_from failed: #{e.message}" if ENV["DEBUG"]
         []
       end
 
@@ -349,7 +356,8 @@ module RailsAiContext
         return nil unless match
 
         match[1].strip
-      rescue
+      rescue => e
+        $stderr.puts "[rails-ai-context] extract_rate_limit failed: #{e.message}" if ENV["DEBUG"]
         nil
       end
 
@@ -369,7 +377,8 @@ module RailsAiContext
           end
         end
         actions.uniq.sort
-      rescue
+      rescue => e
+        $stderr.puts "[rails-ai-context] extract_turbo_stream_actions failed: #{e.message}" if ENV["DEBUG"]
         []
       end
 
@@ -377,7 +386,8 @@ module RailsAiContext
         path = source_path(ctrl)
         return nil unless path && File.exist?(path)
         File.read(path)
-      rescue
+      rescue => e
+        $stderr.puts "[rails-ai-context] read_source failed: #{e.message}" if ENV["DEBUG"]
         nil
       end
 

data/lib/rails_ai_context/introspectors/convention_detector.rb

@@ -146,7 +146,8 @@ module RailsAiContext
           .select { |d| File.directory?(File.join(app_dir, d)) }
           .reject { |d| STANDARD_APP_DIRS.include?(d) }
           .sort
-      rescue
+      rescue => e
+        $stderr.puts "[rails-ai-context] detect_custom_directories failed: #{e.message}" if ENV["DEBUG"]
         []
       end
 

data/lib/rails_ai_context/introspectors/design_token_introspector.rb

@@ -75,7 +75,8 @@ module RailsAiContext
         plugins << "headlessui" if pkg_content.include?("headlessui") || pkg_content.include?("@headlessui")
 
         plugins.any? ? "#{framework}+#{plugins.join('+')}" : framework
-      rescue
+      rescue => e
+        $stderr.puts "[rails-ai-context] detect_framework failed: #{e.message}" if ENV["DEBUG"]
         "unknown"
       end
 
@@ -288,7 +289,8 @@ module RailsAiContext
         end
 
         result
-      rescue
+      rescue => e
+        $stderr.puts "[rails-ai-context] extract_font_loading failed: #{e.message}" if ENV["DEBUG"]
         { font_face: 0, google_fonts: false, system_fonts: false }
       end
 
@@ -304,7 +306,8 @@ module RailsAiContext
           end
         end
         layers.uniq
-      rescue
+      rescue => e
+        $stderr.puts "[rails-ai-context] extract_css_layers failed: #{e.message}" if ENV["DEBUG"]
         []
       end
 
@@ -325,7 +328,8 @@ module RailsAiContext
           end
         end
         plugins.uniq
-      rescue
+      rescue => e
+        $stderr.puts "[rails-ai-context] extract_postcss_plugins failed: #{e.message}" if ENV["DEBUG"]
         []
       end
 

data/lib/rails_ai_context/introspectors/devops_introspector.rb

@@ -50,7 +50,8 @@ module RailsAiContext
         end
 
         config.empty? ? nil : config
-      rescue
+      rescue => e
+        $stderr.puts "[rails-ai-context] extract_puma_config failed: #{e.message}" if ENV["DEBUG"]
         nil
       end
 
@@ -77,7 +78,8 @@ module RailsAiContext
         content = File.read(routes_path)
         return true if content.match?(/\b(?:health|up|ping|status)\b/)
         nil
-      rescue
+      rescue => e
+        $stderr.puts "[rails-ai-context] detect_health_check failed: #{e.message}" if ENV["DEBUG"]
         nil
       end
 
@@ -96,7 +98,8 @@ module RailsAiContext
         info[:compose] = compose
 
         info
-      rescue
+      rescue => e
+        $stderr.puts "[rails-ai-context] extract_docker_info failed: #{e.message}" if ENV["DEBUG"]
         nil
       end
 

data/lib/rails_ai_context/introspectors/engine_introspector.rb

@@ -100,10 +100,12 @@ module RailsAiContext
           next if engine.name.start_with?("Rails::", "ActionPack::", "ActionView::", "ActiveModel::")
 
           { name: engine.name, root: engine.root.to_s.sub("#{Gem.dir}/gems/", "") }
-        rescue
+        rescue => e
+          $stderr.puts "[rails-ai-context] discover_rails_engines failed: #{e.message}" if ENV["DEBUG"]
           nil
         end.sort_by { |e| e[:name] }
-      rescue
+      rescue => e
+        $stderr.puts "[rails-ai-context] discover_rails_engines failed: #{e.message}" if ENV["DEBUG"]
         []
       end
     end

data/lib/rails_ai_context/introspectors/frontend_framework_introspector.rb

@@ -418,7 +418,8 @@ module RailsAiContext
         return false unless File.exist?(path)
         content = File.read(path, encoding: "bom|utf-8")
         content.include?("\"#{name}\"")
-      rescue
+      rescue => e
+        $stderr.puts "[rails-ai-context] package_json_has_script? failed: #{e.message}" if ENV["DEBUG"]
         false
       end
     end

data/lib/rails_ai_context/introspectors/i18n_introspector.rb

@@ -42,7 +42,8 @@ module RailsAiContext
             begin
               data = YAML.load_file(path, permitted_classes: [ Symbol ], aliases: true) || {}
               info[:key_count] = count_keys(data)
-            rescue
+            rescue => e
+              $stderr.puts "[rails-ai-context] extract_locale_files failed: #{e.message}" if ENV["DEBUG"]
               info[:parse_error] = true
             end
           end

data/lib/rails_ai_context/introspectors/job_introspector.rb

@@ -42,7 +42,8 @@ module RailsAiContext
             priority: job.priority
           }.compact
         end.sort_by { |j| j[:name] }
-      rescue
+      rescue => e
+        $stderr.puts "[rails-ai-context] extract_jobs failed: #{e.message}" if ENV["DEBUG"]
         []
       end
 
@@ -80,7 +81,8 @@ module RailsAiContext
           job[:perform_signature] = perform_signature if perform_signature
           job
         end.sort_by { |j| j[:name] }
-      rescue
+      rescue => e
+        $stderr.puts "[rails-ai-context] extract_jobs_from_source failed: #{e.message}" if ENV["DEBUG"]
         []
       end
 
@@ -99,7 +101,8 @@ module RailsAiContext
             delivery_method: mailer.delivery_method.to_s
           }
         end.sort_by { |m| m[:name] }
-      rescue
+      rescue => e
+        $stderr.puts "[rails-ai-context] extract_mailers failed: #{e.message}" if ENV["DEBUG"]
         []
       end
 
@@ -116,7 +119,8 @@ module RailsAiContext
               .map(&:to_s)
           }
         end.sort_by { |c| c[:name] }
-      rescue
+      rescue => e
+        $stderr.puts "[rails-ai-context] extract_channels failed: #{e.message}" if ENV["DEBUG"]
         []
       end
     end