debug-mcp 0.2.1 → 0.3.0

data/lib/debug_mcp/tools/rails_mail_deliveries.rb

@@ -0,0 +1,222 @@
+# frozen_string_literal: true
+
+require "mcp"
+require "base64"
+require_relative "../rails_helper"
+
+module DebugMcp
+  module Tools
+    # Read ActionMailer::Base.deliveries from the running process.
+    #
+    # Observability caveat (surfaced in every response): deliveries is only
+    # populated when delivery_method is :test. With :smtp / :letter_opener / etc.
+    # the array is usually empty, so an empty result is NOT proof that no mail
+    # was sent — it may simply not be observable this way.
+    #
+    # PII: recipients, subject and body can contain personal data or secrets, and
+    # Rails' filter_parameters does NOT apply to this path. Bodies are truncated
+    # to a preview by default; attachment CONTENT is never returned (only name
+    # and content type).
+    class RailsMailDeliveries < MCP::Tool
+      description "[Investigation] Show emails captured in ActionMailer::Base.deliveries (from, to, " \
+                  "cc, bcc, subject, body preview, attachment names). Only populated when " \
+                  "delivery_method is :test — with :smtp/:letter_opener the list is usually empty, so " \
+                  "an empty result does NOT prove no mail was sent (the response says whether it is " \
+                  "observable). Bodies are truncated by default and may contain PII; attachment content " \
+                  "is never returned. Requires the process to be paused."
+
+      annotations(
+        title: "Rails Mail Deliveries",
+        read_only_hint: true,
+        destructive_hint: false,
+        open_world_hint: false,
+      )
+
+      DEFAULT_LIMIT = 20
+      MAX_LIMIT = 200
+      DEFAULT_PREVIEW_CHARS = 500
+      MAX_PREVIEW_CHARS = 5000
+      # Hard ceiling applied even when include_body is true, so a multi-megabyte
+      # body can never cross the line-oriented debug socket as one JSON line.
+      MAX_BODY_CHARS = 50_000
+
+      input_schema(
+        properties: {
+          limit: {
+            type: "integer",
+            description: "How many of the most recent deliveries to show (default: #{DEFAULT_LIMIT}).",
+          },
+          include_body: {
+            type: "boolean",
+            description: "Return more of the body (still capped at #{MAX_BODY_CHARS} chars) instead of " \
+                         "a short preview. Off by default because bodies may contain PII/secrets.",
+          },
+          body_preview_chars: {
+            type: "integer",
+            description: "Preview length when include_body is false " \
+                         "(default: #{DEFAULT_PREVIEW_CHARS}, max: #{MAX_PREVIEW_CHARS}).",
+          },
+          session_id: {
+            type: "string",
+            description: "Debug session ID (uses default session if omitted)",
+          },
+        },
+      )
+
+      class << self
+        def call(limit: nil, include_body: false, body_preview_chars: nil, session_id: nil, server_context:)
+          client = server_context[:session_manager].client(session_id)
+          client.auto_repause!
+          RailsHelper.require_rails!(client)
+
+          # The probe iterates Mail objects and puts a JSON line; both need a
+          # normal (non-trap) paused context.
+          if RailsHelper.trap_context?(client)
+            return text_response("Rails mail deliveries: unavailable in trap context.\n\n" \
+                                 "#{RailsHelper::TRAP_CONTEXT_HINT}")
+          end
+
+          data = fetch_deliveries(
+            client,
+            limit: resolve_limit(limit),
+            include_body: include_body ? true : false,
+            preview_chars: resolve_preview(body_preview_chars),
+          )
+
+          if data.nil? || data.empty? || data[:error]
+            msg = data && data[:error] ? "Error: #{data[:error]}" : "Rails mail deliveries: unavailable."
+            msg += "\n\n#{RailsHelper::TRAP_CONTEXT_HINT}" if RailsHelper.trap_context?(client)
+            return text_response(msg)
+          end
+
+          text_response(format_output(data))
+        rescue DebugMcp::Error => e
+          text_response("Error: #{e.message}")
+        end
+
+        private
+
+        def resolve_limit(limit)
+          n = limit.to_i
+          n = DEFAULT_LIMIT unless n.positive?
+          [n, MAX_LIMIT].min
+        end
+
+        def resolve_preview(chars)
+          n = chars.to_i
+          return DEFAULT_PREVIEW_CHARS unless n.positive?
+
+          [n, MAX_PREVIEW_CHARS].min
+        end
+
+        def fetch_deliveries(client, limit:, include_body:, preview_chars:)
+          script = build_script(limit: limit, include_body: include_body, preview_chars: preview_chars)
+          encoded = Base64.strict_encode64(script)
+          cmd = "require 'base64'; eval(::Base64.decode64('#{encoded}').force_encoding('UTF-8'))"
+          result = client.send_command(cmd, timeout: 15)
+          # The script's value is a base64 JSON blob (see build_script) — the
+          # debug socket does not forward the debuggee's stdout, so we return the
+          # data as the evaluated expression's value, not via puts.
+          RailsHelper.decode_json_result(result, nil)
+        rescue DebugMcp::Error
+          nil
+        end
+
+        # Runs inside the target process. Truncates the body and strips newlines
+        # there (not in the MCP layer) so the result stays small, and returns the
+        # JSON base64-encoded as the script's value (send_command only sees the
+        # evaluated value, not puts output).
+        def build_script(limit:, include_body:, preview_chars:)
+          <<~RUBY
+            __result = begin
+              if defined?(ActionMailer::Base)
+                dm = ActionMailer::Base.delivery_method
+                deliveries = ActionMailer::Base.deliveries
+                shown = deliveries.last(#{limit})
+                offset = deliveries.size - shown.size
+                items = shown.map.with_index do |m, i|
+                  raw = begin
+                    if m.multipart?
+                      part = m.text_part || m.html_part
+                      part ? part.body.decoded.to_s : ""
+                    else
+                      m.body.decoded.to_s
+                    end
+                  rescue StandardError
+                    ""
+                  end
+                  full_len = raw.length
+                  cap = #{include_body} ? #{MAX_BODY_CHARS} : #{preview_chars}
+                  shown = raw[0, cap].to_s.gsub(/\\s+/, " ").strip
+                  atts = (m.attachments || []).map { |a|
+                    { filename: a.filename.to_s[0, 200], content_type: a.content_type.to_s[0, 100] }
+                  } rescue []
+                  {
+                    index: offset + i,
+                    from: Array(m.from).join(", ")[0, 500],
+                    to: Array(m.to).join(", ")[0, 1000],
+                    cc: Array(m.cc).join(", ")[0, 1000],
+                    bcc: Array(m.bcc).join(", ")[0, 1000],
+                    subject: m.subject.to_s.gsub(/\\s+/, " ").strip[0, 500],
+                    multipart: (m.multipart? rescue false),
+                    body_preview: shown,
+                    body_truncated: (full_len > cap),
+                    attachments: atts,
+                  }
+                end
+                { observable: (dm == :test), delivery_method: dm.to_s,
+                  total: deliveries.size, deliveries: items }.to_json
+              else
+                { observable: false, delivery_method: "(ActionMailer not loaded)",
+                  total: 0, deliveries: [] }.to_json
+              end
+            rescue => e
+              { error: e.class.to_s + ": " + e.message }.to_json
+            end
+            [__result].pack("m0")
+          RUBY
+        end
+
+        def format_output(data)
+          lines = ["=== Rails Mail Deliveries ==="]
+          lines << "delivery_method: #{data[:delivery_method]}"
+          lines << "observable: #{data[:observable] ? true : false}"
+          unless data[:observable]
+            lines << "Note: deliveries is only populated when delivery_method is :test. " \
+                     "An empty list does NOT prove no mail was sent."
+          end
+          lines << "total captured: #{data[:total]}"
+
+          deliveries = data[:deliveries] || []
+          if deliveries.empty?
+            lines << "\n(no deliveries captured)"
+            return lines.join("\n")
+          end
+
+          deliveries.each do |m|
+            lines << ""
+            lines << "## [#{m[:index]}] #{m[:subject]}"
+            lines << "from: #{m[:from]}"
+            lines << "to: #{m[:to]}"
+            lines << "cc: #{m[:cc]}" unless m[:cc].to_s.empty?
+            lines << "bcc: #{m[:bcc]}" unless m[:bcc].to_s.empty?
+            lines << "multipart: #{m[:multipart]}"
+            if (atts = m[:attachments]) && !atts.empty?
+              names = atts.map { |a| "#{a[:filename]} (#{a[:content_type]})" }.join(", ")
+              lines << "attachments: #{names}"
+            end
+            preview = m[:body_preview].to_s
+            trunc = m[:body_truncated] ? " [truncated]" : ""
+            lines << "body: #{preview}#{trunc}"
+          end
+
+          lines.join("\n")
+        end
+
+        def text_response(text)
+          MCP::Tool::Response.new([{ type: "text", text: text }])
+        end
+      end
+    end
+  end
+end

data/lib/debug_mcp/tools/rails_recent_events.rb

@@ -0,0 +1,187 @@
+# frozen_string_literal: true
+
+require "mcp"
+require_relative "../rails_helper"
+require_relative "../notifications_subscriber"
+require_relative "../event_formatter"
+
+module DebugMcp
+  module Tools
+    # Read recent Rails internal events (SQL, render, cache, job enqueue,
+    # request lifecycle) from the in-process Notifications buffer, independent
+    # of trigger_request.
+    #
+    # IMPORTANT semantics, surfaced in every response so the model does not
+    # mistake "empty" for "nothing happened":
+    # - forward-only: only events fired AFTER the subscriber was installed are
+    #   visible. The first call installs the subscriber, so it usually returns
+    #   little or nothing — that is not evidence that no SQL/jobs ran.
+    # - paused-only: the target must be paused at a debugger prompt (we send
+    #   commands over the debug socket).
+    # - NOT read-only: installing the subscriber subscribes to
+    #   ActiveSupport::Notifications inside the target — an in-process
+    #   instrumentation side effect (no application data is written).
+    class RailsRecentEvents < MCP::Tool
+      description "[Investigation] Show recent Rails internal events (SQL, renders, cache, job " \
+                  "enqueues, request lifecycle) captured from the running process, without needing " \
+                  "trigger_request. FORWARD-ONLY: the first call installs an ActiveSupport::Notifications " \
+                  "subscriber and only events fired AFTER that are visible — an empty result is NOT proof " \
+                  "that nothing happened. Requires the process to be paused (set a breakpoint / use " \
+                  "trigger_request first on threaded servers). Installing the subscriber is an in-process " \
+                  "instrumentation side effect, so this tool is not strictly read-only."
+
+      annotations(
+        title: "Rails Recent Events",
+        # Not read-only: installs an in-process Notifications subscriber.
+        read_only_hint: false,
+        destructive_hint: false,
+        open_world_hint: false,
+      )
+
+      DEFAULT_LIMIT = 50
+      MAX_LIMIT = 500
+
+      input_schema(
+        properties: {
+          kinds: {
+            type: "array",
+            items: { type: "string", enum: %w[sql render cache job request] },
+            description: "Filter to these event kinds (default: all). " \
+                         "One or more of: sql, render, cache, job, request.",
+          },
+          limit: {
+            type: "integer",
+            description: "How many of the most recent buffered events to scan (default: #{DEFAULT_LIMIT}).",
+          },
+          after_seq: {
+            type: "integer",
+            description: "Cursor: return only events with seq greater than this. Use the previous " \
+                         "response's newest_seq to page forward. Clock-independent (preferred over time).",
+          },
+          include_debug_eval: {
+            type: "boolean",
+            description: "Include events caused by debug-mcp's own evaluate_code/inspect_object calls " \
+                         "(default: false).",
+          },
+          session_id: {
+            type: "string",
+            description: "Debug session ID (uses default session if omitted)",
+          },
+        },
+      )
+
+      KIND_MATCHERS = {
+        "sql" => ->(name) { name == "sql.active_record" },
+        "render" => ->(name) { name.start_with?("render_") },
+        "cache" => ->(name) { name.start_with?("cache_") },
+        "job" => ->(name) { name == "enqueue.active_job" },
+        "request" => ->(name) { name.end_with?(".action_controller") },
+      }.freeze
+
+      class << self
+        def call(kinds: nil, limit: nil, after_seq: nil, include_debug_eval: false, session_id: nil,
+                 server_context:)
+          client = server_context[:session_manager].client(session_id)
+          client.auto_repause!
+          RailsHelper.require_rails!(client)
+
+          # Reads and install both send commands over the debug socket and both
+          # take the buffer/Notifications mutex, which fails in trap context.
+          if RailsHelper.trap_context?(client)
+            return text_response("Rails recent events: unavailable in trap context.\n\n" \
+                                 "#{RailsHelper::TRAP_CONTEXT_HINT}")
+          end
+
+          installed = NotificationsSubscriber.install(client)
+          unless installed
+            return text_response("Rails recent events: could not install the Notifications subscriber " \
+                                 "in the target process.\n\n#{RailsHelper::TRAP_CONTEXT_HINT}")
+          end
+
+          limit = resolve_limit(limit)
+          events = fetch_events(client, after_seq: after_seq, limit: limit)
+          events = filter_by_kinds(events, kinds)
+          metadata = NotificationsSubscriber.metadata(client)
+
+          # `installed` is the result of the install we just performed — the only
+          # trustworthy signal here. metadata[:installed] can be missing if the
+          # metadata round-trip itself returned no parseable object.
+          text_response(build_output(events, metadata, kinds, include_debug_eval, limit, installed))
+        rescue DebugMcp::Error => e
+          text_response("Error: #{e.message}")
+        end
+
+        private
+
+        def resolve_limit(limit)
+          n = limit.to_i
+          n = DEFAULT_LIMIT unless n.positive?
+          [n, MAX_LIMIT].min
+        end
+
+        def fetch_events(client, after_seq:, limit:)
+          if after_seq
+            # Forward cursor paging: oldest-after-cursor first, capped by limit
+            # (target-side) so a busy buffer never dumps all 1000 events.
+            NotificationsSubscriber.fetch_after_seq(client, after_seq.to_i, limit)
+          else
+            NotificationsSubscriber.fetch_last(client, limit)
+          end
+        end
+
+        def filter_by_kinds(events, kinds)
+          return events if kinds.nil? || kinds.empty?
+
+          matchers = kinds.filter_map { |k| KIND_MATCHERS[k.to_s] }
+          # All requested kinds were invalid: return nothing rather than silently
+          # falling back to every event (which would expose more, not less).
+          return [] if matchers.empty?
+
+          events.select { |e| matchers.any? { |m| m.call(e[:name].to_s) } }
+        end
+
+        def build_output(events, metadata, kinds, include_debug_eval, limit, installed)
+          header = build_metadata_header(metadata, kinds, include_debug_eval, installed)
+          # Align EventFormatter's per-section display caps with the user's limit
+          # so the "... and N more (limit=...)" note matches what was requested
+          # instead of EventFormatter's internal defaults.
+          limits = EventFormatter::DEFAULT_LIMITS.merge(
+            sql: limit, render: limit, cache: limit, job: limit,
+          )
+          formatted = EventFormatter.format(events, limits: limits, include_debug_eval: include_debug_eval)
+
+          body = if formatted.nil? || formatted.empty?
+            "(no matching events captured since the subscriber was installed)"
+          else
+            formatted
+          end
+
+          "#{header}\n\n#{body}"
+        end
+
+        def build_metadata_header(metadata, kinds, include_debug_eval, installed)
+          lines = ["=== Rails Recent Events ==="]
+          lines << "installed: #{installed ? true : false}"
+          lines << "forward_only: true (only events fired after install are visible)"
+          lines << "paused_only: true"
+          lines << "events_before_install_are_unavailable: true"
+          lines << "installed_at: #{metadata[:installed_at] || "(unknown)"}"
+          if metadata[:buffer_size]
+            lines << "buffer: #{metadata[:buffer_size]}/#{metadata[:buffer_max]} " \
+                     "(dropped: #{metadata[:dropped_count] || 0})"
+          end
+          if metadata[:oldest_seq] || metadata[:newest_seq]
+            lines << "seq range: #{metadata[:oldest_seq] || "-"}..#{metadata[:newest_seq] || "-"}"
+          end
+          lines << "filtered_kinds: #{kinds && !kinds.empty? ? kinds.join(", ") : "all"}"
+          lines << "include_debug_eval: #{include_debug_eval ? true : false}"
+          lines.join("\n")
+        end
+
+        def text_response(text)
+          MCP::Tool::Response.new([{ type: "text", text: text }])
+        end
+      end
+    end
+  end
+end

data/lib/debug_mcp/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module DebugMcp
-  VERSION = "0.2.1"
+  VERSION = "0.3.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: debug-mcp
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.3.0
 platform: ruby
 authors:
 - rira100000000
@@ -65,6 +65,26 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.9'
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '7.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '9.0'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -109,85 +129,6 @@ files:
 - LICENSE
 - README.ja.md
 - README.md
-- examples/01_simple_bug.rb
-- examples/02_data_pipeline.rb
-- examples/03_recursion.rb
-- examples/RAILS_SCENARIOS.md
-- examples/SCENARIOS.md
-- examples/rails_test_app/setup.sh
-- examples/rails_test_app/testapp/.dockerignore
-- examples/rails_test_app/testapp/.ruby-version
-- examples/rails_test_app/testapp/Dockerfile
-- examples/rails_test_app/testapp/Gemfile
-- examples/rails_test_app/testapp/README.md
-- examples/rails_test_app/testapp/Rakefile
-- examples/rails_test_app/testapp/app/assets/images/.keep
-- examples/rails_test_app/testapp/app/assets/stylesheets/application.css
-- examples/rails_test_app/testapp/app/controllers/application_controller.rb
-- examples/rails_test_app/testapp/app/controllers/concerns/.keep
-- examples/rails_test_app/testapp/app/controllers/dashboard_controller.rb
-- examples/rails_test_app/testapp/app/controllers/health_controller.rb
-- examples/rails_test_app/testapp/app/controllers/orders_controller.rb
-- examples/rails_test_app/testapp/app/controllers/posts_controller.rb
-- examples/rails_test_app/testapp/app/controllers/sessions_controller.rb
-- examples/rails_test_app/testapp/app/controllers/users_controller.rb
-- examples/rails_test_app/testapp/app/helpers/application_helper.rb
-- examples/rails_test_app/testapp/app/models/application_record.rb
-- examples/rails_test_app/testapp/app/models/comment.rb
-- examples/rails_test_app/testapp/app/models/concerns/.keep
-- examples/rails_test_app/testapp/app/models/order.rb
-- examples/rails_test_app/testapp/app/models/order_item.rb
-- examples/rails_test_app/testapp/app/models/post.rb
-- examples/rails_test_app/testapp/app/models/user.rb
-- examples/rails_test_app/testapp/app/services/order_report_service.rb
-- examples/rails_test_app/testapp/app/views/layouts/application.html.erb
-- examples/rails_test_app/testapp/app/views/pwa/manifest.json.erb
-- examples/rails_test_app/testapp/app/views/pwa/service-worker.js
-- examples/rails_test_app/testapp/bin/ci
-- examples/rails_test_app/testapp/bin/dev
-- examples/rails_test_app/testapp/bin/rails
-- examples/rails_test_app/testapp/bin/rake
-- examples/rails_test_app/testapp/bin/setup
-- examples/rails_test_app/testapp/config.ru
-- examples/rails_test_app/testapp/config/application.rb
-- examples/rails_test_app/testapp/config/boot.rb
-- examples/rails_test_app/testapp/config/ci.rb
-- examples/rails_test_app/testapp/config/database.yml
-- examples/rails_test_app/testapp/config/environment.rb
-- examples/rails_test_app/testapp/config/environments/development.rb
-- examples/rails_test_app/testapp/config/environments/production.rb
-- examples/rails_test_app/testapp/config/environments/test.rb
-- examples/rails_test_app/testapp/config/initializers/content_security_policy.rb
-- examples/rails_test_app/testapp/config/initializers/filter_parameter_logging.rb
-- examples/rails_test_app/testapp/config/initializers/inflections.rb
-- examples/rails_test_app/testapp/config/locales/en.yml
-- examples/rails_test_app/testapp/config/puma.rb
-- examples/rails_test_app/testapp/config/routes.rb
-- examples/rails_test_app/testapp/db/migrate/20260216002916_create_users.rb
-- examples/rails_test_app/testapp/db/migrate/20260216002919_create_posts.rb
-- examples/rails_test_app/testapp/db/migrate/20260216002922_create_comments.rb
-- examples/rails_test_app/testapp/db/migrate/20260222000001_create_orders.rb
-- examples/rails_test_app/testapp/db/migrate/20260222000002_create_order_items.rb
-- examples/rails_test_app/testapp/db/schema.rb
-- examples/rails_test_app/testapp/db/seeds.rb
-- examples/rails_test_app/testapp/docker-compose.yml
-- examples/rails_test_app/testapp/docker-entrypoint.sh
-- examples/rails_test_app/testapp/lib/tasks/.keep
-- examples/rails_test_app/testapp/log/.keep
-- examples/rails_test_app/testapp/public/400.html
-- examples/rails_test_app/testapp/public/404.html
-- examples/rails_test_app/testapp/public/406-unsupported-browser.html
-- examples/rails_test_app/testapp/public/422.html
-- examples/rails_test_app/testapp/public/500.html
-- examples/rails_test_app/testapp/public/icon.png
-- examples/rails_test_app/testapp/public/icon.svg
-- examples/rails_test_app/testapp/public/robots.txt
-- examples/rails_test_app/testapp/script/.keep
-- examples/rails_test_app/testapp/storage/.keep
-- examples/rails_test_app/testapp/tmp/.keep
-- examples/rails_test_app/testapp/tmp/pids/.keep
-- examples/rails_test_app/testapp/tmp/storage/.keep
-- examples/rails_test_app/testapp/vendor/.keep
 - exe/debug-mcp
 - exe/debug-rails
 - lib/debug_mcp.rb
@@ -217,7 +158,9 @@ files:
 - lib/debug_mcp/tools/list_paused_sessions.rb
 - lib/debug_mcp/tools/next.rb
 - lib/debug_mcp/tools/rails_info.rb
+- lib/debug_mcp/tools/rails_mail_deliveries.rb
 - lib/debug_mcp/tools/rails_model.rb
+- lib/debug_mcp/tools/rails_recent_events.rb
 - lib/debug_mcp/tools/rails_routes.rb
 - lib/debug_mcp/tools/read_file.rb
 - lib/debug_mcp/tools/remove_breakpoint.rb

data/examples/01_simple_bug.rb

@@ -1,43 +0,0 @@
-# frozen_string_literal: true
-
-# シナリオ: 割引計算にバグがある
-# 期待: 合計金額が1000円以上なら10%割引
-# 実際: 割引が正しく適用されない
-
-class Cart
-  attr_reader :items
-
-  def initialize
-    @items = []
-  end
-
-  def add(name, price, quantity = 1)
-    @items << { name: name, price: price, quantity: quantity }
-  end
-
-  def subtotal
-    @items.sum { |item| item[:price] * item[:quantity] }
-  end
-
-  def discount_rate
-    subtotal > 1000 ? 0.1 : 0
-  end
-
-  def total
-    sub = subtotal
-    discount = sub * discount_rate
-    sub + discount  # BUG: should be sub - discount
-  end
-end
-
-cart = Cart.new
-cart.add("りんご", 200, 3)
-cart.add("バナナ", 150, 2)
-cart.add("みかん", 100, 4)
-
-debugger
-
-puts "小計: #{cart.subtotal}円"
-puts "割引率: #{cart.discount_rate * 100}%"
-puts "合計: #{cart.total}円"
-puts "期待される合計: #{cart.subtotal * (1 - cart.discount_rate)}円"

data/examples/02_data_pipeline.rb

@@ -1,93 +0,0 @@
-# frozen_string_literal: true
-
-# シナリオ: CSVデータ変換パイプラインで一部のレコードが消える
-# ステップ実行で各段階のデータを追跡する
-
-require "csv"
-require "stringio"
-
-csv_data = <<~CSV
-  id,name,age,score
-  1,田中太郎,28,85
-  2,鈴木花子,,92
-  3,佐藤次郎,35,
-  4,山田三郎,42,78
-  5,高橋四郎,-3,95
-CSV
-
-class DataPipeline
-  def initialize(csv_string)
-    @raw = CSV.parse(csv_string, headers: true)
-    @records = []
-    @errors = []
-  end
-
-  def run
-    parse
-    validate
-    transform
-    { records: @records, errors: @errors, stats: stats }
-  end
-
-  private
-
-  def parse
-    @records = @raw.map do |row|
-      {
-        id: row["id"]&.to_i,
-        name: row["name"],
-        age: row["age"]&.to_i,     # nil.to_i => 0
-        score: row["score"]&.to_i,  # nil.to_i => 0
-      }
-    end
-  end
-
-  def validate
-    @records.reject! do |r|
-      if r[:age] <= 0
-        @errors << { id: r[:id], reason: "invalid age: #{r[:age]}" }
-        true
-      elsif r[:score] <= 0
-        @errors << { id: r[:id], reason: "invalid score: #{r[:score]}" }
-        true
-      else
-        false
-      end
-    end
-  end
-
-  def transform
-    avg = @records.sum { |r| r[:score] } / @records.size.to_f
-    @records.each do |r|
-      r[:grade] = case r[:score]
-                  when 90.. then "A"
-                  when 80.. then "B"
-                  when 70.. then "C"
-                  else "D"
-                  end
-      r[:above_average] = r[:score] > avg
-    end
-  end
-
-  def stats
-    {
-      total_input: @raw.size,
-      valid_records: @records.size,
-      error_count: @errors.size,
-      average_score: @records.sum { |r| r[:score] } / @records.size.to_f,
-    }
-  end
-end
-
-pipeline = DataPipeline.new(csv_data)
-
-debugger
-
-result = pipeline.run
-
-puts "=== 結果 ==="
-puts "有効レコード: #{result[:records].size}"
-result[:records].each { |r| puts "  #{r}" }
-puts "エラー: #{result[:errors].size}"
-result[:errors].each { |e| puts "  #{e}" }
-puts "統計: #{result[:stats]}"