rails-ai-context 4.3.2 → 4.4.0

data/lib/rails_ai_context/introspectors/turbo_introspector.rb

@@ -14,6 +14,7 @@ module RailsAiContext
         {
           turbo_frames: extract_turbo_frames,
           turbo_streams: extract_turbo_stream_templates,
+          stream_actions: extract_stream_actions,
           model_broadcasts: extract_model_broadcasts,
           morph_meta: detect_morph_meta,
           permanent_elements: extract_permanent_elements,
@@ -43,13 +44,18 @@ module RailsAiContext
           content = File.read(path)
           relative = path.sub("#{views_dir}/", "")
 
-          content.scan(/turbo_frame_tag\s+[:"']?(\w+)/).each do |match|
-            frames << { id: match[0], file: relative }
+          content.each_line do |line|
+            next unless (match = line.match(/turbo_frame_tag\s+[:"']?(\w+)/))
+            entry = { id: match[1], file: relative }
+            src_match = line.match(/src:\s*["']?([^"',\s)]+)/)
+            entry[:src] = src_match[1] if src_match
+            frames << entry
           end
         end
 
         frames.sort_by { |f| f[:id] }
-      rescue
+      rescue => e
+        $stderr.puts "[rails-ai-context] extract_turbo_frames failed: #{e.message}" if ENV["DEBUG"]
         []
       end
 
@@ -61,6 +67,21 @@ module RailsAiContext
         end.sort
       end
 
+      def extract_stream_actions
+        actions = Hash.new(0)
+        return actions unless Dir.exist?(views_dir)
+
+        Dir.glob(File.join(views_dir, "**", "*.turbo_stream.erb")).each do |path|
+          content = File.read(path, encoding: "UTF-8", invalid: :replace, undef: :replace)
+          content.scan(/turbo_stream\.(\w+)/).each { |action| actions[action[0]] += 1 }
+          content.scan(/<turbo-stream\s+action=["'](\w+)["']/).each { |action| actions[action[0]] += 1 }
+        end
+        actions
+      rescue => e
+        $stderr.puts "[rails-ai-context] extract_stream_actions failed: #{e.message}" if ENV["DEBUG"]
+        {}
+      end
+
       def extract_model_broadcasts
         models_dir = File.join(root, "app/models")
         return [] unless Dir.exist?(models_dir)
@@ -77,7 +98,8 @@ module RailsAiContext
         end
 
         broadcasts.sort_by { |b| b[:model] }
-      rescue
+      rescue => e
+        $stderr.puts "[rails-ai-context] extract_model_broadcasts failed: #{e.message}" if ENV["DEBUG"]
         []
       end
 
@@ -89,7 +111,8 @@ module RailsAiContext
           content = File.read(path) rescue next
           content.include?('name="turbo-refresh-method"') && content.include?('content="morph"')
         end
-      rescue
+      rescue => e
+        $stderr.puts "[rails-ai-context] detect_morph_meta failed: #{e.message}" if ENV["DEBUG"]
         false
       end
 
@@ -122,7 +145,8 @@ module RailsAiContext
         end
 
         elements.uniq
-      rescue
+      rescue => e
+        $stderr.puts "[rails-ai-context] extract_permanent_elements failed: #{e.message}" if ENV["DEBUG"]
         []
       end
 
@@ -146,7 +170,8 @@ module RailsAiContext
         end
 
         counts
-      rescue
+      rescue => e
+        $stderr.puts "[rails-ai-context] extract_turbo_drive_settings failed: #{e.message}" if ENV["DEBUG"]
         { "data-turbo-false": 0, "data-turbo-action": 0, "data-turbo-preload": 0 }
       end
 
@@ -159,7 +184,8 @@ module RailsAiContext
           native_navigation: detect_native_navigation(controllers_dir),
           native_conditionals: detect_native_conditionals
         }
-      rescue
+      rescue => e
+        $stderr.puts "[rails-ai-context] detect_turbo_native failed: #{e.message}" if ENV["DEBUG"]
         { detected: false, native_helpers: [], native_navigation: [], native_conditionals: 0 }
       end
 
@@ -170,7 +196,8 @@ module RailsAiContext
           content = File.read(path) rescue next
           content.match?(/include\s+Turbo::Native::Navigation/)
         end
-      rescue
+      rescue => e
+        $stderr.puts "[rails-ai-context] detect_native_include failed: #{e.message}" if ENV["DEBUG"]
         false
       end
 
@@ -183,7 +210,8 @@ module RailsAiContext
             path.sub("#{root}/", "")
           end
         end.sort
-      rescue
+      rescue => e
+        $stderr.puts "[rails-ai-context] detect_native_helpers failed: #{e.message}" if ENV["DEBUG"]
         []
       end
 
@@ -207,7 +235,8 @@ module RailsAiContext
         end
 
         results.sort_by { |r| [ r[:file], r[:method] ] }
-      rescue
+      rescue => e
+        $stderr.puts "[rails-ai-context] detect_native_navigation failed: #{e.message}" if ENV["DEBUG"]
         []
       end
 
@@ -221,7 +250,8 @@ module RailsAiContext
         end
 
         count
-      rescue
+      rescue => e
+        $stderr.puts "[rails-ai-context] detect_native_conditionals failed: #{e.message}" if ENV["DEBUG"]
         0
       end
 
@@ -248,7 +278,8 @@ module RailsAiContext
         end
 
         responses.uniq.sort_by { |r| [ r[:controller], r[:action] ] }
-      rescue
+      rescue => e
+        $stderr.puts "[rails-ai-context] extract_turbo_stream_responses failed: #{e.message}" if ENV["DEBUG"]
         []
       end
     end

data/lib/rails_ai_context/introspectors/view_introspector.rb

@@ -21,7 +21,8 @@ module RailsAiContext
           template_engines: detect_template_engines,
           form_builders_detected: detect_form_builders,
           component_usage: detect_component_usage,
-          layout_mapping: extract_layout_mapping
+          layout_mapping: extract_layout_mapping,
+          conditional_layouts: detect_conditional_layouts
         }
       rescue => e
         { error: e.message }
@@ -42,8 +43,16 @@ module RailsAiContext
         return [] unless Dir.exist?(dir)
 
         Dir.glob(File.join(dir, "*")).filter_map do |path|
-          File.basename(path) if File.file?(path)
-        end.sort
+          next unless File.file?(path)
+          content = File.read(path, encoding: "UTF-8", invalid: :replace, undef: :replace)
+          yields = content.scan(/<%=?\s*(?:yield|content_for)\s*[:(]?\s*:?(\w*)/).flatten.reject(&:empty?)
+          entry = { name: File.basename(path) }
+          entry[:yields] = yields unless yields.empty?
+          entry
+        rescue => e
+          $stderr.puts "[rails-ai-context] extract_layouts read failed: #{e.message}" if ENV["DEBUG"]
+          { name: File.basename(path) }
+        end.sort_by { |l| l[:name] }
       end
 
       def extract_templates
@@ -98,7 +107,8 @@ module RailsAiContext
             file: relative,
             methods: methods
           }
-        rescue
+        rescue => e
+          $stderr.puts "[rails-ai-context] extract_helpers failed: #{e.message}" if ENV["DEBUG"]
           nil
         end.sort_by { |h| h[:file] }
       end
@@ -150,7 +160,8 @@ module RailsAiContext
         end
 
         counts.sort_by { |_, v| -v }.to_h
-      rescue
+      rescue => e
+        $stderr.puts "[rails-ai-context] detect_form_builders failed: #{e.message}" if ENV["DEBUG"]
         {}
       end
 
@@ -168,7 +179,8 @@ module RailsAiContext
         end
 
         components.to_a.sort
-      rescue
+      rescue => e
+        $stderr.puts "[rails-ai-context] detect_component_usage failed: #{e.message}" if ENV["DEBUG"]
         []
       end
 
@@ -183,7 +195,34 @@ module RailsAiContext
           name = basename.sub(/\.(html|xml|json)\.(erb|haml|slim)\z/, "").sub(/\.(erb|haml|slim)\z/, "")
           name
         end.uniq.sort
-      rescue
+      rescue => e
+        $stderr.puts "[rails-ai-context] extract_layout_mapping failed: #{e.message}" if ENV["DEBUG"]
+        []
+      end
+
+      def detect_conditional_layouts
+        layouts = []
+        controllers_dir = File.join(app.root, "app", "controllers")
+        return layouts unless Dir.exist?(controllers_dir)
+
+        Dir.glob(File.join(controllers_dir, "**", "*.rb")).each do |path|
+          content = File.read(path, encoding: "UTF-8", invalid: :replace, undef: :replace)
+          content.each_line do |line|
+            if (match = line.match(/\A\s*layout\s+["':]*(\w+)["']?(.*)$/))
+              entry = { layout: match[1], controller: File.basename(path, ".rb").camelize }
+              conditions = match[2].strip
+              entry[:only] = conditions.scan(/only:\s*\[?([^\]]+)\]?/).flatten.first&.scan(/:(\w+)/)&.flatten if conditions.include?("only:")
+              entry[:except] = conditions.scan(/except:\s*\[?([^\]]+)\]?/).flatten.first&.scan(/:(\w+)/)&.flatten if conditions.include?("except:")
+              entry[:condition] = conditions.strip unless conditions.empty?
+              layouts << entry
+            end
+          end
+        rescue => e
+          $stderr.puts "[rails-ai-context] detect_conditional_layouts failed: #{e.message}" if ENV["DEBUG"]
+        end
+        layouts
+      rescue => e
+        $stderr.puts "[rails-ai-context] detect_conditional_layouts failed: #{e.message}" if ENV["DEBUG"]
         []
       end
     end

data/lib/rails_ai_context/introspectors/view_template_introspector.rb

@@ -41,8 +41,10 @@ module RailsAiContext
           relative = path.sub("#{views_dir}/", "")
           content = File.read(path, encoding: "UTF-8", invalid: :replace, undef: :replace) rescue next
 
+          slots = extract_slot_refs(content)
+
           if phlex_view?(path, content)
-            templates[relative] = {
+            entry = {
               lines: content.lines.count,
               partials: extract_partial_refs(content),
               stimulus: extract_stimulus_refs(content),
@@ -50,12 +52,16 @@ module RailsAiContext
               helpers: extract_phlex_helper_calls(content),
               phlex: true
             }
+            entry[:slots] = slots unless slots.empty?
+            templates[relative] = entry
           else
-            templates[relative] = {
+            entry = {
               lines: content.lines.count,
               partials: extract_partial_refs(content),
               stimulus: extract_stimulus_refs(content)
             }
+            entry[:slots] = slots unless slots.empty?
+            templates[relative] = entry
           end
         end
         templates
@@ -569,7 +575,8 @@ module RailsAiContext
         builders[:simple_form_for] = content.scan(/\bsimple_form_for\b/).size
         builders[:formtastic] = content.scan(/\bsemantic_form_for\b/).size
         builders.reject { |_, v| v == 0 }
-      rescue
+      rescue => e
+        $stderr.puts "[rails-ai-context] extract_form_builders failed: #{e.message}" if ENV["DEBUG"]
         {}
       end
 
@@ -580,7 +587,8 @@ module RailsAiContext
           tags[tag.to_sym] = count if count > 0
         end
         tags
-      rescue
+      rescue => e
+        $stderr.puts "[rails-ai-context] extract_semantic_html failed: #{e.message}" if ENV["DEBUG"]
         {}
       end
 
@@ -593,7 +601,8 @@ module RailsAiContext
         sr_only_count = content.scan(/\bsr-only\b/).size
         patterns[:sr_only] = sr_only_count if sr_only_count > 0
         patterns
-      rescue
+      rescue => e
+        $stderr.puts "[rails-ai-context] extract_accessibility_patterns failed: #{e.message}" if ENV["DEBUG"]
         {}
       end
 
@@ -636,7 +645,8 @@ module RailsAiContext
         end
 
         examples.values.map { |e| e.except(:score) }.first(5)
-      rescue
+      rescue => e
+        $stderr.puts "[rails-ai-context] extract_canonical_examples failed: #{e.message}" if ENV["DEBUG"]
         []
       end
 
@@ -697,7 +707,8 @@ module RailsAiContext
           description = infer_partial_description(name, content)
           { name: name, lines: content.lines.size, description: description }
         end
-      rescue
+      rescue => e
+        $stderr.puts "[rails-ai-context] discover_shared_partials failed: #{e.message}" if ENV["DEBUG"]
         []
       end
 
@@ -818,6 +829,13 @@ module RailsAiContext
         end
         refs.uniq
       end
+
+      def extract_slot_refs(content)
+        content.scan(/\b(?:renders_one|renders_many)\s+:(\w+)/).flatten
+      rescue => e
+        $stderr.puts "[rails-ai-context] extract_slot_refs failed: #{e.message}" if ENV["DEBUG"]
+        []
+      end
     end
   end
 end

data/lib/rails_ai_context/resources.rb

@@ -113,7 +113,7 @@ module RailsAiContext
           content = JSON.pretty_generate(data)
           [ { uri: uri, mime_type: "application/json", text: content } ]
         else
-          raise "Unknown resource: #{uri}"
+          raise RailsAiContext::Error, "Unknown resource: #{uri}"
         end
       end
     end

data/lib/rails_ai_context/server.rb

@@ -105,9 +105,10 @@ module RailsAiContext
 
     def start_stdio(server)
       transport = MCP::Server::Transports::StdioTransport.new(server)
+      tools = active_tools(RailsAiContext.configuration)
       # Log to stderr so we don't pollute the JSON-RPC channel on stdout
       $stderr.puts "[rails-ai-context] MCP server started (stdio transport)"
-      $stderr.puts "[rails-ai-context] Tools: #{TOOLS.map { |t| t.tool_name }.join(', ')}"
+      $stderr.puts "[rails-ai-context] Tools (#{tools.size}): #{tools.map { |t| t.tool_name }.join(', ')}"
       maybe_start_live_reload(server)
       transport.open
     end
@@ -119,13 +120,15 @@ module RailsAiContext
       # Build a minimal Rack app that delegates to the MCP transport
       rack_app = build_rack_app(transport, config.http_path)
 
-      unless config.http_bind == "127.0.0.1" || config.http_bind == "::1" || config.http_bind == "localhost"
+      loopback = %w[127.0.0.1 ::1 localhost].freeze
+      unless loopback.include?(config.http_bind)
         $stderr.puts "[rails-ai-context] WARNING: MCP HTTP transport binding to #{config.http_bind} — " \
                      "this exposes all tools to the network without authentication. " \
                      "Use 127.0.0.1 (default) unless you have external auth in place."
       end
+      tools = active_tools(config)
       $stderr.puts "[rails-ai-context] MCP server starting on #{config.http_bind}:#{config.http_port}#{config.http_path}"
-      $stderr.puts "[rails-ai-context] Tools: #{TOOLS.map { |t| t.tool_name }.join(', ')}"
+      $stderr.puts "[rails-ai-context] Tools (#{tools.size}): #{tools.map { |t| t.tool_name }.join(', ')}"
       maybe_start_live_reload(server)
 
       begin

data/lib/rails_ai_context/tasks/rails_ai_context.rake

@@ -91,7 +91,8 @@ def save_tool_mode_to_initializer(mode)
   end
 
   File.write(init_path, content)
-rescue
+rescue => e
+  $stderr.puts "[rails-ai-context] save_tool_mode_to_initializer failed: #{e.message}" if ENV["DEBUG"]
   nil
 end unless defined?(save_tool_mode_to_initializer)
 
@@ -113,7 +114,8 @@ def tool_mode_configured?
   content = File.read(init_path)
   # Check for uncommented tool_mode line (not just a comment)
   content.match?(/^\s*config\.tool_mode\s*=/)
-rescue
+rescue => e
+  $stderr.puts "[rails-ai-context] tool_mode_configured? failed: #{e.message}" if ENV["DEBUG"]
   false
 end unless defined?(tool_mode_configured?)
 
@@ -136,7 +138,8 @@ def save_ai_tools_to_initializer(tools)
 
   File.write(init_path, content)
   puts "💾 Saved to config/initializers/rails_ai_context.rb"
-rescue
+rescue => e
+  $stderr.puts "[rails-ai-context] save_ai_tools_to_initializer failed: #{e.message}" if ENV["DEBUG"]
   nil
 end unless defined?(save_ai_tools_to_initializer)
 
@@ -165,7 +168,8 @@ def add_ai_tool_to_initializer(format)
     File.write(init_path, content)
     puts "💾 Set config.ai_tools = %i[#{format_sym}]"
   end
-rescue
+rescue => e
+  $stderr.puts "[rails-ai-context] add_ai_tool_to_initializer failed: #{e.message}" if ENV["DEBUG"]
   nil
 end unless defined?(add_ai_tool_to_initializer)
 

data/lib/rails_ai_context/tools/analyze_feature.rb

@@ -202,14 +202,20 @@ module RailsAiContext
           lines << "## Services (#{found.size})"
           found.each do |path|
             relative = path.sub("#{root}/", "")
-            source = File.read(path, encoding: "UTF-8", invalid: :replace, undef: :replace) rescue next
+            source = begin
+              File.read(path, encoding: "UTF-8", invalid: :replace, undef: :replace)
+            rescue => e
+              $stderr.puts "[rails-ai-context] discover_services failed: #{e.message}" if ENV["DEBUG"]
+              next
+            end
             line_count = source.lines.size
             methods = source.scan(/\A\s*def (?:self\.)?(\w+)/m).flatten.reject { |m| m == "initialize" }
             lines << "- `#{relative}` (#{line_count} lines)"
             lines << "  Methods: #{methods.first(20).join(', ')}" if methods.any?
           end
           lines << ""
-        rescue
+        rescue => e
+          $stderr.puts "[rails-ai-context] discover_services failed: #{e.message}" if ENV["DEBUG"]
           nil
         end
 
@@ -226,13 +232,19 @@ module RailsAiContext
           lines << "## Jobs (#{found.size})"
           found.each do |path|
             relative = path.sub("#{root}/", "")
-            source = File.read(path, encoding: "UTF-8", invalid: :replace, undef: :replace) rescue next
+            source = begin
+              File.read(path, encoding: "UTF-8", invalid: :replace, undef: :replace)
+            rescue => e
+              $stderr.puts "[rails-ai-context] discover_jobs failed: #{e.message}" if ENV["DEBUG"]
+              next
+            end
             queue = source.match(/queue_as\s+[:'"](\w+)/)&.captures&.first || "default"
             retries = source.match(/retry_on.*attempts:\s*(\d+)/)&.captures&.first
             lines << "- `#{relative}` (queue: #{queue}#{retries ? ", retries: #{retries}" : ""})"
           end
           lines << ""
-        rescue
+        rescue => e
+          $stderr.puts "[rails-ai-context] discover_jobs failed: #{e.message}" if ENV["DEBUG"]
           nil
         end
 
@@ -249,7 +261,12 @@ module RailsAiContext
           lines << "## Views (#{found.size})"
           found.each do |path|
             relative = path.sub("#{views_dir}/", "")
-            source = File.read(path, encoding: "UTF-8", invalid: :replace, undef: :replace) rescue next
+            source = begin
+              File.read(path, encoding: "UTF-8", invalid: :replace, undef: :replace)
+            rescue => e
+              $stderr.puts "[rails-ai-context] discover_views failed: #{e.message}" if ENV["DEBUG"]
+              next
+            end
             line_count = source.lines.size
             partials = source.scan(/render\s+(?:partial:\s*)?["']([^"']+)["']/).flatten
             stimulus = source.scan(/data-controller=["']([^"']+)["']/).flat_map { |m| m.first.split }
@@ -259,7 +276,8 @@ module RailsAiContext
             lines << detail
           end
           lines << ""
-        rescue
+        rescue => e
+          $stderr.puts "[rails-ai-context] discover_views failed: #{e.message}" if ENV["DEBUG"]
           nil
         end
 
@@ -315,13 +333,19 @@ module RailsAiContext
           lines << "## Tests (#{found.size})"
           found.each do |path|
             relative = path.sub("#{root}/", "")
-            source = File.read(path, encoding: "UTF-8", invalid: :replace, undef: :replace) rescue next
+            source = begin
+              File.read(path, encoding: "UTF-8", invalid: :replace, undef: :replace)
+            rescue => e
+              $stderr.puts "[rails-ai-context] discover_tests failed: #{e.message}" if ENV["DEBUG"]
+              next
+            end
             test_count = source.scan(/\b(?:it|test|should)\b/).size
             lines << "- `#{relative}` (#{test_count} tests)"
           end
           lines << ""
           found
-        rescue
+        rescue => e
+          $stderr.puts "[rails-ai-context] discover_tests failed: #{e.message}" if ENV["DEBUG"]
           []
         end
 
@@ -377,7 +401,8 @@ module RailsAiContext
           lines << "## Test Coverage Gaps"
           gaps.each { |g| lines << "- #{g}" }
           lines << ""
-        rescue
+        rescue => e
+          $stderr.puts "[rails-ai-context] discover_test_gaps failed: #{e.message}" if ENV["DEBUG"]
           nil
         end
 
@@ -392,14 +417,20 @@ module RailsAiContext
           # Fallback: read source file
           path = Rails.root.join("app", "controllers", "#{parent_class.underscore}.rb")
           return [] unless File.exist?(path)
-          source = File.read(path, encoding: "UTF-8") rescue nil
+          source = begin
+            File.read(path, encoding: "UTF-8")
+          rescue => e
+            $stderr.puts "[rails-ai-context] detect_parent_filters_for_analyze failed: #{e.message}" if ENV["DEBUG"]
+            nil
+          end
           return [] unless source
 
           source.each_line.filter_map do |line|
             next if line.include?("only:") || line.include?("except:")
             { name: $1 } if line.match(/\A\s*before_action\s+:(\w+)/)
           end
-        rescue
+        rescue => e
+          $stderr.puts "[rails-ai-context] detect_parent_filters_for_analyze failed: #{e.message}" if ENV["DEBUG"]
           []
         end
 
@@ -444,7 +475,8 @@ module RailsAiContext
           lines << "## Concerns"
           concerns.sort.each { |name, count| lines << "- **#{name}** (used by #{count} model#{'s' if count > 1})" }
           lines << ""
-        rescue
+        rescue => e
+          $stderr.puts "[rails-ai-context] discover_concerns failed: #{e.message}" if ENV["DEBUG"]
           nil
         end
 
@@ -481,7 +513,8 @@ module RailsAiContext
             lines << "- `#{relative}`"
           end
           lines << ""
-        rescue
+        rescue => e
+          $stderr.puts "[rails-ai-context] discover_channels failed: #{e.message}" if ENV["DEBUG"]
           nil
         end
 
@@ -496,12 +529,18 @@ module RailsAiContext
           lines << "## Mailers (#{found.size})"
           found.each do |path|
             relative = path.sub("#{root}/", "")
-            source = File.read(path, encoding: "UTF-8", invalid: :replace, undef: :replace) rescue next
+            source = begin
+              File.read(path, encoding: "UTF-8", invalid: :replace, undef: :replace)
+            rescue => e
+              $stderr.puts "[rails-ai-context] discover_mailers failed: #{e.message}" if ENV["DEBUG"]
+              next
+            end
             methods = source.scan(/\A\s*def (\w+)/m).flatten.reject { |m| m == "initialize" }
             lines << "- `#{relative}` — #{methods.join(', ')}" if methods.any?
           end
           lines << ""
-        rescue
+        rescue => e
+          $stderr.puts "[rails-ai-context] discover_mailers failed: #{e.message}" if ENV["DEBUG"]
           nil
         end
 
@@ -519,7 +558,8 @@ module RailsAiContext
             lines << "- `#{f[:file]}`: #{f[:issue]}"
           end
           lines << ""
-        rescue
+        rescue => e
+          $stderr.puts "[rails-ai-context] discover_accessibility failed: #{e.message}" if ENV["DEBUG"]
           nil
         end
 
@@ -543,7 +583,8 @@ module RailsAiContext
             lines << "- **#{c[:name]}**#{slot_info}#{used_in}"
           end
           lines << ""
-        rescue
+        rescue => e
+          $stderr.puts "[rails-ai-context] discover_components failed: #{e.message}" if ENV["DEBUG"]
           nil
         end
 
@@ -556,7 +597,12 @@ module RailsAiContext
           dirs.each do |dir|
             Dir.glob(File.join(dir, "**", "*.rb")).each do |path|
               next unless File.basename(path, ".rb").include?(pattern) || path.downcase.include?(pattern)
-              source = File.read(path, encoding: "UTF-8", invalid: :replace, undef: :replace) rescue next
+              source = begin
+                File.read(path, encoding: "UTF-8", invalid: :replace, undef: :replace)
+              rescue => e
+                $stderr.puts "[rails-ai-context] discover_env_dependencies failed: #{e.message}" if ENV["DEBUG"]
+                next
+              end
               source.scan(/ENV\[["']([^"']+)["']\]|ENV\.fetch\(["']([^"']+)["']\)/).each do |m|
                 env_vars << (m[0] || m[1])
               end
@@ -567,7 +613,8 @@ module RailsAiContext
           lines << "## Environment Dependencies"
           env_vars.sort.each { |v| lines << "- `#{v}`" }
           lines << ""
-        rescue
+        rescue => e
+          $stderr.puts "[rails-ai-context] discover_env_dependencies failed: #{e.message}" if ENV["DEBUG"]
           nil
         end
       end

data/lib/rails_ai_context/tools/base_tool.rb

@@ -150,7 +150,7 @@ module RailsAiContext
         # App size classification — tools use this to auto-tune pagination and detail
         # small: <15 models, medium: 15-50 models, large: 50+ models
         def app_size
-          ctx = SHARED_CACHE[:context]
+          ctx = SHARED_CACHE[:mutex].synchronize { SHARED_CACHE[:context] }
           return :medium unless ctx
 
           model_count = ctx[:models]&.size || 0

data/lib/rails_ai_context/tools/diagnose.rb

@@ -377,7 +377,8 @@ module RailsAiContext
           end
 
           lines
-        rescue
+        rescue => e
+          $stderr.puts "[rails-ai-context] gather_git_context failed: #{e.message}" if ENV["DEBUG"]
           []
         end
 
@@ -390,7 +391,8 @@ module RailsAiContext
             return [] if text.include?("Log file is empty") || text.include?("not found") || text.include?("No entries")
 
             [ "## Recent Error Logs", text, "" ]
-          rescue
+          rescue => e
+            $stderr.puts "[rails-ai-context] gather_log_context failed: #{e.message}" if ENV["DEBUG"]
             []
           end
         end

data/lib/rails_ai_context/tools/get_callbacks.rb

@@ -257,7 +257,8 @@ module RailsAiContext
           start_line: start_idx + 1,
           end_line: end_idx + 1
         }
-      rescue
+      rescue => e
+        $stderr.puts "[rails-ai-context] extract_method_source failed: #{e.message}" if ENV["DEBUG"]
         nil
       end
 
@@ -294,7 +295,8 @@ module RailsAiContext
         end
 
         concern_callbacks
-      rescue
+      rescue => e
+        $stderr.puts "[rails-ai-context] find_concern_callbacks failed: #{e.message}" if ENV["DEBUG"]
         {}
       end
     end