eager_eye 1.2.3 → 1.2.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2fbde5efcfa326afaf12645241e817095fbe2ac39ad69576f101d81f294b8337
-  data.tar.gz: dbd0a6d263aab997fe358cbf2194ce55629d587feffcd4652e7f13d58d459343
+  metadata.gz: 6fa0e6e3acb2c37751e7ab49a58826a016a68c7a33cc6305ddb6b82d6787c462
+  data.tar.gz: af81d8c0cfde13914b00a9f64b4b1bef6731b12902a1358c7f27473c2ab9a68d
 SHA512:
-  metadata.gz: 4b0ddfa32f3e65955cc6da31339ca86985554709f229a7cc2ebc1ce84262f767c5104451df34e359e3d9f9470d4c916192652ed44ea958dbfcfe680b057b8996
-  data.tar.gz: 1cf0da613bed275088977144260c1b44ddd3ddadc72f063bce5ac3706a827a63e526dd043cc1e76a544fabe809b7c48432782900ac1602f25c3f218d44b426d0
+  metadata.gz: a0e233e5c53c6ee3c7a32239ca20625a58deb1b385af022cb582433d02070f7b861873f44cef5fe786ede0307caee4105202e49844902e8d75e14039623bdc74
+  data.tar.gz: 238ca3ba9a777686867752bc4abbf1d10081d73215e3c0f7ed0e9360f7c380298b4736177c703f1c921fb22b4296e7544379bef69021408f9e9ad86280a3716c

data/.rubocop.yml

@@ -20,7 +20,7 @@ Metrics/BlockLength:
     - "lib/eager_eye/railtie.rb"
 
 Metrics/ClassLength:
-  Max: 165
+  Max: 170
 
 Metrics/ParameterLists:
   Max: 6

data/CHANGELOG.md

@@ -7,6 +7,29 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.2.5] - 2026-02-21
+
+### Added
+
+- **New Detector: `DecoratorNPlusOne`** - Detects N+1 queries inside decorator/presenter classes
+  - Catches `object.comments.map(...)`, `__getobj__.items.each { ... }`, `model.posts`, `source.tags` patterns
+  - Identifies decorator classes by inheritance (`Draper::Decorator`, `SimpleDelegator`, `Delegator`) or name suffix (`Decorator`, `Presenter`, `ViewObject`)
+  - Targets all four object reference styles: `object`, `__getobj__`, `source`, `model`
+  - Skips ActiveStorage methods (`attached?`, `blob`, `variant`, etc.) to prevent false positives
+  - Suggests eager loading in the controller before decorating the collection
+
+## [1.2.4] - 2026-02-21
+
+### Added
+
+- **New Detector: `DelegationNPlusOne`** - Detects hidden N+1 queries caused by `delegate :method, to: :association`
+  - `delegate :name, :email, to: :user` calls inside loops load the target association on each iteration
+  - EagerEye previously could not catch these because `order.name` looks like a plain attribute, not an association access
+  - Parses model files for `delegate` declarations and tracks delegated method → association mappings
+  - Detects delegated method calls in `each`, `map`, `select`, `flat_map`, `find_each`, and all other iteration methods
+  - Respects `includes`, `preload`, and `eager_load` — suppresses warnings when the target association is preloaded
+  - Supports both local (same-file) delegate declarations and cross-file detection via model parsing
+
 ## [1.2.3] - 2026-02-15
 
 ### Added

data/README.md

@@ -10,7 +10,7 @@
 
 <p align="center">
   <a href="https://github.com/hamzagedikkaya/eager_eye/actions/workflows/main.yml"><img src="https://github.com/hamzagedikkaya/eager_eye/actions/workflows/main.yml/badge.svg" alt="CI"></a>
-  <a href="https://rubygems.org/gems/eager_eye"><img src="https://img.shields.io/badge/gem-v1.2.3-red.svg" alt="Gem Version"></a>
+  <a href="https://rubygems.org/gems/eager_eye"><img src="https://img.shields.io/badge/gem-v1.2.5-red.svg" alt="Gem Version"></a>
   <a href="https://github.com/hamzagedikkaya/eager_eye"><img src="https://img.shields.io/badge/coverage-95%25-brightgreen.svg" alt="Coverage"></a>
   <a href="https://www.ruby-lang.org/"><img src="https://img.shields.io/badge/ruby-%3E%3D%203.1-ruby.svg" alt="Ruby"></a>
   <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License: MIT"></a>
@@ -42,7 +42,7 @@
 
 ## Features
 
-✨ **Detects 7 types of N+1 problems:**
+✨ **Detects 9 types of N+1 problems:**
 - Loop associations (queries in iterations)
 - Serializer nesting issues
 - Missing counter caches
@@ -50,6 +50,8 @@
 - Count in iteration patterns
 - Callback query N+1s
 - Pluck to array misuse
+- Delegation N+1s (hidden via `delegate :method, to: :association`)
+- Decorator N+1s (Draper, SimpleDelegator, Presenter, ViewObject)
 
 🔧 **Developer-friendly:**
 - Inline suppression (like RuboCop)
@@ -339,6 +341,63 @@ Post.where(user_id: User.active.select(:id))
 - ⚠️ **Warning** - Scoped `.pluck(:id)` (two queries, memory overhead)
 - 🔴 **Error** - Unscoped `.all.pluck(:id)` (loads entire table)
 
+### 8. Delegation N+1
+
+Detects when methods delegated via `delegate :method, to: :association` are called inside loops without preloading the target association. These are invisible to `LoopAssociation` because `order.name` looks like a plain attribute, not an association access.
+
+```ruby
+# Model
+class Order < ApplicationRecord
+  belongs_to :user
+  delegate :full_name, :email, to: :user
+end
+
+# Bad - N+1 (each call hits the database for user)
+orders.each do |order|
+  order.full_name   # actually: order.user.full_name — loads user for each order!
+  order.email       # actually: order.user.email — another load!
+end
+
+# Good - Eager load the delegated-to association
+orders.includes(:user).each do |order|
+  order.full_name   # no N+1 — user is already loaded
+  order.email       # no N+1 — user is already loaded
+end
+```
+
+EagerEye detects these by:
+1. Scanning model files for `delegate :method, to: :assoc` declarations
+2. Tracking which methods delegate to which associations
+3. Flagging calls to those methods inside iteration blocks when the association is not preloaded
+
+### 9. Decorator N+1
+
+Detects N+1 queries inside Draper decorators, SimpleDelegator subclasses, and classes named `Decorator`, `Presenter`, or `ViewObject`. Each decorator wraps a single record — when a collection is decorated without preloading, every method that accesses an association triggers a new query per record.
+
+```ruby
+# Bad - N+1 on each decorated post
+class PostDecorator < Draper::Decorator
+  def comment_summary
+    object.comments.map(&:body).join(", ")   # Query for each post!
+  end
+
+  def tag_list
+    object.tags.map(&:name).join(", ")        # Another query for each post!
+  end
+end
+
+# Controller - no includes = N+1
+@posts = Post.all.decorate
+
+# Good - Eager load before decorating
+@posts = Post.includes(:comments, :tags).all.decorate
+```
+
+Supports the following object references inside decorators:
+- `object` — Draper standard
+- `__getobj__` — SimpleDelegator standard
+- `source`, `model` — alternative Draper aliases
+
 ## Inline Suppression
 
 Suppress false positives using inline comments (RuboCop-style):
@@ -381,6 +440,8 @@ Both CamelCase and snake_case formats are accepted:
 | Count in Iteration | `CountInIteration` | `count_in_iteration` |
 | Callback Query | `CallbackQuery` | `callback_query` |
 | Pluck to Array | `PluckToArray` | `pluck_to_array` |
+| Delegation N+1 | `DelegationNPlusOne` | `delegation_n_plus_one` |
+| Decorator N+1 | `DecoratorNPlusOne` | `decorator_n_plus_one` |
 | All Detectors | `all` | `all` |
 
 ## Auto-fix (Experimental)
@@ -483,6 +544,8 @@ enabled_detectors:
   - count_in_iteration
   - callback_query
   - pluck_to_array
+  - delegation_n_plus_one
+  - decorator_n_plus_one
 
 # Severity levels per detector (error, warning, info)
 severity_levels:
@@ -492,6 +555,8 @@ severity_levels:
   count_in_iteration: warning
   callback_query: warning
   pluck_to_array: warning        # Optimization
+  delegation_n_plus_one: warning # Hidden delegation N+1
+  decorator_n_plus_one: warning  # Decorator/Presenter N+1
   missing_counter_cache: info    # Suggestion
 
 # Minimum severity to report (default: info)

data/lib/eager_eye/analyzer.rb

@@ -11,20 +11,24 @@ module EagerEye
       custom_method_query: Detectors::CustomMethodQuery,
       count_in_iteration: Detectors::CountInIteration,
       callback_query: Detectors::CallbackQuery,
-      pluck_to_array: Detectors::PluckToArray
+      pluck_to_array: Detectors::PluckToArray,
+      delegation_n_plus_one: Detectors::DelegationNPlusOne,
+      decorator_n_plus_one: Detectors::DecoratorNPlusOne
     }.freeze
 
-    attr_reader :paths, :issues, :association_preloads
+    attr_reader :paths, :issues, :association_preloads, :delegation_maps
 
     def initialize(paths: nil)
       @paths = Array(paths || EagerEye.configuration.app_path)
       @issues = []
       @association_preloads = {}
+      @delegation_maps = {}
     end
 
     def run
       @issues = []
       collect_association_preloads
+      collect_delegation_maps
       analyze_files
       @issues
     end
@@ -44,6 +48,19 @@ module EagerEye
       nil
     end
 
+    def collect_delegation_maps
+      model_files.each do |file_path|
+        ast = parse_source(File.read(file_path))
+        next unless ast
+
+        parser = DelegationParser.new
+        parser.parse_model(ast, extract_model_name(file_path))
+        @delegation_maps.merge!(parser.delegation_maps)
+      end
+    rescue StandardError
+      nil
+    end
+
     def model_files
       Dir.glob(File.join(@paths[0], "models", "**", "*.rb"))
     end
@@ -85,10 +102,7 @@ module EagerEye
       min_severity = EagerEye.configuration.min_severity
 
       enabled_detectors.each do |detector|
-        args = [ast, file_path]
-        args << @association_preloads if detector.is_a?(Detectors::LoopAssociation)
-
-        file_issues = detector.detect(*args)
+        file_issues = detector.detect(*detector_args(detector, ast, file_path))
         file_issues.reject! { |issue| comment_parser.disabled_at?(issue.line_number, issue.detector) }
         file_issues.select! { |issue| issue.meets_minimum_severity?(min_severity) }
         @issues.concat(file_issues)
@@ -103,6 +117,13 @@ module EagerEye
       nil
     end
 
+    def detector_args(detector, ast, file_path)
+      args = [ast, file_path]
+      args << @association_preloads if detector.is_a?(Detectors::LoopAssociation)
+      args << @delegation_maps if detector.is_a?(Detectors::DelegationNPlusOne)
+      args
+    end
+
     def enabled_detectors
       @enabled_detectors ||= EagerEye.configuration.enabled_detectors.filter_map do |name|
         detector_class = DETECTOR_CLASSES[name]

data/lib/eager_eye/configuration.rb

@@ -8,7 +8,7 @@ module EagerEye
     DEFAULT_DETECTORS = %i[
       loop_association serializer_nesting missing_counter_cache
       custom_method_query count_in_iteration callback_query
-      pluck_to_array
+      pluck_to_array delegation_n_plus_one decorator_n_plus_one
     ].freeze
 
     DEFAULT_SEVERITY_LEVELS = {
@@ -18,7 +18,9 @@ module EagerEye
       custom_method_query: :warning,
       count_in_iteration: :warning,
       callback_query: :warning,
-      pluck_to_array: :warning
+      pluck_to_array: :warning,
+      delegation_n_plus_one: :warning,
+      decorator_n_plus_one: :warning
     }.freeze
 
     VALID_SEVERITIES = %i[info warning error].freeze

data/lib/eager_eye/delegation_parser.rb

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+module EagerEye
+  class DelegationParser
+    attr_reader :delegation_maps
+
+    def initialize
+      @delegation_maps = {}
+    end
+
+    def parse_model(ast, model_name)
+      return unless ast
+
+      traverse(ast, model_name)
+    end
+
+    private
+
+    def traverse(node, model_name)
+      return unless node.is_a?(Parser::AST::Node)
+
+      check_delegate(node, model_name)
+      node.children.each { |child| traverse(child, model_name) }
+    end
+
+    def check_delegate(node, model_name)
+      return unless bare_delegate_call?(node)
+
+      args = node.children[2..]
+      methods = delegate_methods(args)
+      return if methods.empty?
+
+      to_target = extract_to_target(args)
+      return unless to_target
+
+      register_delegates(model_name, methods, to_target)
+    end
+
+    def bare_delegate_call?(node)
+      node.type == :send && node.children[0].nil? && node.children[1] == :delegate
+    end
+
+    def delegate_methods(args)
+      args.select { |a| a&.type == :sym }.map { |a| a.children[0] }
+    end
+
+    def register_delegates(model_name, methods, to_target)
+      @delegation_maps[model_name] ||= {}
+      methods.each { |m| @delegation_maps[model_name][m] = to_target }
+    end
+
+    def extract_to_target(args)
+      hash_arg = args.find { |a| a&.type == :hash }
+      return unless hash_arg
+
+      to_pair = hash_arg.children.find { |p| to_key_pair?(p) }
+      extract_sym_value(to_pair)
+    end
+
+    def extract_sym_value(node)
+      return unless node
+
+      value = node.children[1]
+      value.children[0] if value&.type == :sym
+    end
+
+    def to_key_pair?(pair)
+      pair.type == :pair &&
+        pair.children[0]&.type == :sym &&
+        pair.children[0].children[0] == :to
+    end
+  end
+end

data/lib/eager_eye/detectors/callback_query.rb

@@ -29,6 +29,9 @@ module EagerEye
       ITERATION_METHODS = %i[each map select find_all reject collect
                              find_each find_in_batches in_batches].freeze
       AR_BATCH_METHODS = %i[find_each find_in_batches in_batches].freeze
+      NON_AR_NAMESPACES = %w[Sidekiq Redis ActionCable ActionMailer Kafka].freeze
+      TRANSACTIONAL_CALLBACKS = %i[before_validation before_save before_create before_update before_destroy
+                                   around_save around_create around_update around_destroy].freeze
 
       def self.detector_name
         :callback_query
@@ -87,7 +90,8 @@ module EagerEye
 
         if iteration_block?(node)
           block_var = extract_block_variable(node)
-          if block_var && contains_ar_query_on_variable?(node, block_var)
+          collection = node.children[0].children[0]
+          if block_var && !non_ar_collection?(collection) && contains_ar_query_on_variable?(node, block_var)
             add_iteration_issue(node, method_name, callback_type)
             find_query_calls_in_block(node, method_name, callback_type, block_var)
           end
@@ -128,26 +132,41 @@ module EagerEye
 
       def add_query_issue(node, method_name, callback_type)
         query_method = node.children[1]
+        suggestion = if transactional_callback?(callback_type)
+                       "Callbacks run on every save/create/update. Move the query outside the iteration or preload data"
+                     else
+                       "Callbacks run on every save/create/update. Consider moving to a background job"
+                     end
 
         @issues << create_issue(
           file_path: @file_path,
           line_number: node.loc.line,
           message: "Query method `.#{query_method}` found in `#{callback_type}` callback `:#{method_name}`",
           severity: :warning,
-          suggestion: "Callbacks run on every save/create/update. Consider moving to a background job"
+          suggestion: suggestion
         )
       end
 
       def add_iteration_issue(node, method_name, callback_type)
+        suggestion = if transactional_callback?(callback_type)
+                       "Avoid DB queries in before_*/around_* callbacks. Preload data outside the iteration instead"
+                     else
+                       "Avoid iterations in callbacks. Use background jobs for bulk operations"
+                     end
+
         @issues << create_issue(
           file_path: @file_path,
           line_number: node.loc.line,
           message: "Iteration found in `#{callback_type}` callback `:#{method_name}` - potential N+1",
           severity: :error,
-          suggestion: "Avoid iterations in callbacks. Use background jobs for bulk operations"
+          suggestion: suggestion
         )
       end
 
+      def transactional_callback?(callback_type)
+        TRANSACTIONAL_CALLBACKS.include?(callback_type)
+      end
+
       def extract_block_variable(block_node)
         args_node = block_node.children[1]
         return nil unless args_node&.type == :args
@@ -171,6 +190,22 @@ module EagerEye
         end
       end
 
+      def non_ar_collection?(node)
+        ns = root_namespace(node)
+        ns && NON_AR_NAMESPACES.include?(ns)
+      end
+
+      def root_namespace(node)
+        return nil unless node.is_a?(Parser::AST::Node)
+
+        case node.type
+        when :const
+          node.children[0].nil? ? node.children[1].to_s : root_namespace(node.children[0])
+        when :send, :block
+          root_namespace(node.children[0])
+        end
+      end
+
       def contains_ar_query_on_variable?(node, block_var)
         return false unless node.is_a?(Parser::AST::Node)
         return true if query_call?(node) && receiver_chain_starts_with?(node.children[0], block_var)

data/lib/eager_eye/detectors/count_in_iteration.rb

@@ -6,6 +6,7 @@ module EagerEye
       COUNT_METHODS = %i[count].freeze
       ITERATION_METHODS = %i[each map select find_all reject collect each_with_index each_with_object flat_map
                              find_each find_in_batches in_batches].freeze
+      ARRAY_METHOD_SUFFIXES = %w[_ids _tags _types _codes _names _values].freeze
 
       def self.detector_name
         :count_in_iteration
@@ -52,9 +53,17 @@ module EagerEye
 
       def count_on_association?(node, block_var)
         node.type == :send && COUNT_METHODS.include?(node.children[1]) &&
+          !array_returning_method?(node.children[0]) &&
           association_call_on_block_var?(node.children[0], block_var)
       end
 
+      def array_returning_method?(node)
+        return false unless node.is_a?(Parser::AST::Node) && node.type == :send
+
+        method_name = node.children[1].to_s
+        ARRAY_METHOD_SUFFIXES.any? { |suffix| method_name.end_with?(suffix) }
+      end
+
       def association_call_on_block_var?(node, block_var)
         return false unless node.is_a?(Parser::AST::Node) && node.type == :send
 

data/lib/eager_eye/detectors/custom_method_query.rb

@@ -7,7 +7,7 @@ module EagerEye
                          maximum].freeze
       SAFE_QUERY_METHODS = %i[first last take count sum find size length ids].freeze
       SAFE_TRANSFORM_METHODS = %i[keys values split [] params sort pluck ids to_s to_a to_i chars bytes].freeze
-      ARRAY_COLUMN_SUFFIXES = %w[_ids _tags _types _codes _names _values].freeze
+      ARRAY_COLUMN_SUFFIXES = %w[_ids _tags _types _codes _names _values _arr].freeze
       ITERATION_METHODS = %i[each map select find_all reject collect detect find_index flat_map
                              find_each find_in_batches in_batches].freeze
 
@@ -62,6 +62,7 @@ module EagerEye
         method_name = node.children[1]
         return false unless QUERY_METHODS.include?(method_name)
         return false if skip_array_method?(node, block_var, is_array_collection)
+        return false if receiver_is_query_chain?(node.children[0])
 
         receiver_chain_starts_with?(node.children[0], block_var)
       end
@@ -130,6 +131,10 @@ module EagerEye
         SAFE_TRANSFORM_METHODS.include?(method_name) || array_column_method?(method_name)
       end
 
+      def receiver_is_query_chain?(node)
+        node.is_a?(Parser::AST::Node) && node.type == :send && QUERY_METHODS.include?(node.children[1])
+      end
+
       def array_column_method?(method_name)
         method_str = method_name.to_s
         ARRAY_COLUMN_SUFFIXES.any? { |suffix| method_str.end_with?(suffix) }

data/lib/eager_eye/detectors/decorator_n_plus_one.rb

@@ -0,0 +1,137 @@
+# frozen_string_literal: true
+
+module EagerEye
+  module Detectors
+    class DecoratorNPlusOne < Base
+      DECORATOR_PATTERNS = %w[Draper::Decorator SimpleDelegator Delegator].freeze
+      OBJECT_REFS = %i[object __getobj__ source model].freeze
+      ACTIVE_STORAGE_METHODS = %i[attached? attach attachment attachments blob blobs purge purge_later variant
+                                  preview].freeze
+      HAS_MANY_ASSOCIATIONS = %w[
+        authors users owners creators admins members customers clients
+        posts articles comments categories tags children companies organizations
+        projects tasks items orders products accounts profiles settings
+        images avatars photos attachments documents
+      ].freeze
+
+      def self.detector_name
+        :decorator_n_plus_one
+      end
+
+      def detect(ast, file_path)
+        return [] unless ast
+
+        issues = []
+
+        traverse_ast(ast) do |node|
+          next unless decorator_class?(node)
+
+          find_association_accesses(node, file_path, issues)
+        end
+
+        issues
+      end
+
+      private
+
+      def decorator_class?(node)
+        return false unless node.type == :class
+
+        class_name = extract_class_name(node)
+        return false unless class_name
+
+        decorator_name_pattern?(class_name) || inherits_from_decorator?(node)
+      end
+
+      def decorator_name_pattern?(class_name)
+        class_name.end_with?("Decorator", "Presenter", "ViewObject")
+      end
+
+      def extract_class_name(class_node)
+        name_node = class_node.children[0]
+        name_node.children[1].to_s if name_node&.type == :const
+      end
+
+      def inherits_from_decorator?(class_node)
+        parent_node = class_node.children[1]
+        return false unless parent_node
+
+        parent_name = const_to_string(parent_node)
+        DECORATOR_PATTERNS.any? { |p| parent_name&.include?(p.split("::").last) }
+      end
+
+      def const_to_string(node)
+        return nil unless node&.type == :const
+
+        parts = []
+        current = node
+        while current&.type == :const
+          parts.unshift(current.children[1].to_s)
+          current = current.children[0]
+        end
+        parts.join("::")
+      end
+
+      def find_association_accesses(class_node, file_path, issues)
+        body = class_node.children[2]
+        return unless body
+
+        traverse_ast(body) do |node|
+          next unless node.type == :def
+
+          find_associations_in_method(node.children[2], file_path, issues)
+        end
+      end
+
+      def find_associations_in_method(method_body, file_path, issues)
+        return unless method_body
+
+        storage_lines = collect_active_storage_lines(method_body)
+        traverse_ast(method_body) do |node|
+          next unless association_access?(node, storage_lines)
+
+          receiver = node.children[0]
+          method_name = node.children[1]
+          issues << create_decorator_issue(file_path, node.loc.line, receiver, method_name)
+        end
+      end
+
+      def association_access?(node, storage_lines)
+        return false unless node.type == :send
+        return false if storage_lines.include?(node.loc.line)
+
+        object_reference?(node.children[0]) && likely_association?(node.children[1])
+      end
+
+      def collect_active_storage_lines(body)
+        lines = Set.new
+        traverse_ast(body) do |node|
+          next unless node.type == :send && ACTIVE_STORAGE_METHODS.include?(node.children[1])
+
+          lines << node.loc.line
+        end
+        lines
+      end
+
+      def object_reference?(node)
+        return false unless node&.type == :send
+
+        node.children[0].nil? && OBJECT_REFS.include?(node.children[1])
+      end
+
+      def likely_association?(method_name)
+        HAS_MANY_ASSOCIATIONS.include?(method_name.to_s)
+      end
+
+      def create_decorator_issue(file_path, line, receiver, method_name)
+        ref = receiver.children[1]
+        create_issue(
+          file_path: file_path,
+          line_number: line,
+          message: "N+1 in decorator: `#{ref}.#{method_name}` loads association on each decorated object",
+          suggestion: "Eager load :#{method_name} in the controller before decorating the collection"
+        )
+      end
+    end
+  end
+end

data/lib/eager_eye/detectors/delegation_n_plus_one.rb

@@ -0,0 +1,176 @@
+# frozen_string_literal: true
+
+module EagerEye
+  module Detectors
+    class DelegationNPlusOne < Base
+      ITERATION_METHODS = %i[
+        each map collect select find_all reject filter filter_map flat_map
+        find_each find_in_batches in_batches
+      ].freeze
+      PRELOAD_METHODS = %i[includes preload eager_load].freeze
+
+      def self.detector_name
+        :delegation_n_plus_one
+      end
+
+      def detect(ast, file_path, delegation_maps = {})
+        return [] unless ast
+
+        issues = []
+        local_delegates = collect_local_delegates(ast)
+
+        traverse_ast(ast) do |node|
+          next unless iteration_block?(node)
+
+          block_var = extract_block_variable(node)
+          next unless block_var
+
+          block_body = node.children[2]
+          next unless block_body
+
+          collection_node = node.children[0]
+          model_name = infer_model_name(collection_node)
+          delegates = build_delegates(model_name, delegation_maps, local_delegates)
+          next if delegates.empty?
+
+          included = extract_included_associations(collection_node)
+          find_delegated_calls(block_body, block_var, delegates, included, file_path, issues)
+        end
+
+        issues
+      end
+
+      private
+
+      def collect_local_delegates(ast)
+        delegates = {}
+        traverse_ast(ast) do |node|
+          next unless delegate_call?(node)
+
+          extract_delegate_info(node, delegates)
+        end
+        delegates
+      end
+
+      def delegate_call?(node)
+        node.type == :send && node.children[0].nil? && node.children[1] == :delegate
+      end
+
+      def extract_delegate_info(node, delegates)
+        args = node.children[2..]
+        methods = args.select { |a| a&.type == :sym }.map { |a| a.children[0] }
+        return if methods.empty?
+
+        to_target = extract_to_target(args)
+        return unless to_target
+
+        methods.each { |m| delegates[m] = to_target }
+      end
+
+      def extract_to_target(args)
+        hash_arg = args.find { |a| a&.type == :hash }
+        return unless hash_arg
+
+        to_pair = hash_arg.children.find { |p| to_key_pair?(p) }
+        extract_sym_value(to_pair)
+      end
+
+      def extract_sym_value(node)
+        return unless node
+
+        value = node.children[1]
+        value.children[0] if value&.type == :sym
+      end
+
+      def to_key_pair?(pair)
+        pair.type == :pair &&
+          pair.children[0]&.type == :sym &&
+          pair.children[0].children[0] == :to
+      end
+
+      def build_delegates(model_name, delegation_maps, local_delegates)
+        cross_file = model_name ? (delegation_maps[model_name] || {}) : {}
+        cross_file.merge(local_delegates)
+      end
+
+      def iteration_block?(node)
+        node.type == :block &&
+          node.children[0]&.type == :send &&
+          ITERATION_METHODS.include?(node.children[0].children[1])
+      end
+
+      def extract_block_variable(block_node)
+        args = block_node&.children&.[](1)
+        first_arg = args&.children&.first
+        first_arg&.type == :arg ? first_arg.children[0] : nil
+      end
+
+      def infer_model_name(node)
+        root = find_root_receiver(node)
+        root&.type == :const ? root.children[1].to_s : nil
+      end
+
+      def find_root_receiver(node)
+        current = node
+        current = current.children[0] while current&.type == :send
+        current
+      end
+
+      def extract_included_associations(collection_node)
+        included = Set.new
+        return included unless collection_node&.type == :send
+
+        current = collection_node
+        while current&.type == :send
+          extract_from_preload(current, included) if PRELOAD_METHODS.include?(current.children[1])
+          current = current.children[0]
+        end
+        included
+      end
+
+      def extract_from_preload(method_node, included_set)
+        args = extract_method_args(method_node)
+        included_set.merge(extract_symbols_from_args(args))
+      end
+
+      def find_delegated_calls(block_body, block_var, delegates, included, file_path, issues)
+        reported = Set.new
+        traverse_ast(block_body) do |node|
+          target_assoc = delegation_target(node, block_var, delegates, included, reported)
+          next unless target_assoc
+
+          issues << create_delegation_issue(node, block_var, target_assoc, file_path)
+        end
+      end
+
+      def delegation_target(node, block_var, delegates, included, reported)
+        return unless node.type == :send
+        return unless block_var_receiver?(node, block_var)
+
+        method = node.children[1]
+        target_assoc = delegates[method]
+        return unless target_assoc
+        return if included.include?(target_assoc)
+        return unless reported.add?("#{node.loc.line}:#{method}")
+
+        target_assoc
+      end
+
+      def block_var_receiver?(node, block_var)
+        receiver = node.children[0]
+        receiver&.type == :lvar && receiver.children[0] == block_var
+      end
+
+      def create_delegation_issue(node, block_var, target_assoc, file_path)
+        method = node.children[1]
+        create_issue(
+          file_path: file_path,
+          line_number: node.loc.line,
+          message: "Potential N+1: `#{block_var}.#{method}` is delegated to `#{target_assoc}` — " \
+                   "loads `#{target_assoc}` on each iteration",
+          suggestion: "Use `includes(:#{target_assoc})` before iterating"
+        )
+      end
+    end
+  end
+end

data/lib/eager_eye/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module EagerEye
-  VERSION = "1.2.3"
+  VERSION = "1.2.5"
 end

data/lib/eager_eye.rb

@@ -5,6 +5,7 @@ require_relative "eager_eye/version"
 require_relative "eager_eye/configuration"
 require_relative "eager_eye/issue"
 require_relative "eager_eye/association_parser"
+require_relative "eager_eye/delegation_parser"
 require_relative "eager_eye/detectors/base"
 require_relative "eager_eye/detectors/loop_association"
 require_relative "eager_eye/detectors/serializer_nesting"
@@ -13,6 +14,8 @@ require_relative "eager_eye/detectors/custom_method_query"
 require_relative "eager_eye/detectors/count_in_iteration"
 require_relative "eager_eye/detectors/callback_query"
 require_relative "eager_eye/detectors/pluck_to_array"
+require_relative "eager_eye/detectors/delegation_n_plus_one"
+require_relative "eager_eye/detectors/decorator_n_plus_one"
 require_relative "eager_eye/comment_parser"
 require_relative "eager_eye/analyzer"
 require_relative "eager_eye/fixers/base"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: eager_eye
 version: !ruby/object:Gem::Version
-  version: 1.2.3
+  version: 1.2.5
 platform: ruby
 authors:
 - hamzagedikkaya
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-02-15 00:00:00.000000000 Z
+date: 2026-02-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ast
@@ -64,11 +64,14 @@ files:
 - lib/eager_eye/cli.rb
 - lib/eager_eye/comment_parser.rb
 - lib/eager_eye/configuration.rb
+- lib/eager_eye/delegation_parser.rb
 - lib/eager_eye/detectors/base.rb
 - lib/eager_eye/detectors/callback_query.rb
 - lib/eager_eye/detectors/concerns/non_ar_source_detector.rb
 - lib/eager_eye/detectors/count_in_iteration.rb
 - lib/eager_eye/detectors/custom_method_query.rb
+- lib/eager_eye/detectors/decorator_n_plus_one.rb
+- lib/eager_eye/detectors/delegation_n_plus_one.rb
 - lib/eager_eye/detectors/loop_association.rb
 - lib/eager_eye/detectors/missing_counter_cache.rb
 - lib/eager_eye/detectors/pluck_to_array.rb