evilution 0.23.0 → 0.24.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7fe91007e7b5113b2e790e726991bcc872abe8fe8e3c321b1e1f5896f9ccec8d
-  data.tar.gz: 809753233bdd01ec72a9014e31dcc0f821f9e569b915bc58aee4ac69ce0168df
+  metadata.gz: '0925ab348be65d181cad6ed2b45f80e6c22c0667e8377f954d37944c20335621'
+  data.tar.gz: c14af9fa929612bf7dc8b87b62a8deddbd6d82535b5dff8c0d35405a47e62c6d
 SHA512:
-  metadata.gz: 5e1a965330f8d02db82e5bee493682a70a3492f67985e2e0729a66354de51c9e8d3e0b2323617d82dc3209eb7791e5cfc0af2e735c5351081fe48f44d6e26f22
-  data.tar.gz: 43bbd5cf785fe4370ef351642f697a205cd2af2490dbc15a187aae640a35df0d7a472f2d133ad45ac274fd0c5841401f1a6f8a42b395a97cb92b125b51ec84fb
+  metadata.gz: 0dda0d8fef652c798db27eb31e4065d191af1c662a39edb637a4e7883068f1716c859b8f72224c469239e37ec03b24d6151572c3051f812ba06607af6337f888
+  data.tar.gz: 8d1fc65e174a493c57c9267ebdf8acc17cd11477669ed766a8601f7812acc442faa5bf91c5efb4ae7e6bb88839db10d6f9f9d070e32922478adb525d71994dbd

data/.beads/interactions.jsonl

@@ -20,3 +20,8 @@
 {"id":"int-a43dbc64","kind":"field_change","created_at":"2026-04-13T10:26:45.290646646Z","actor":"Denis Kiselev","issue_id":"EV-gs1r","extra":{"field":"status","new_value":"closed","old_value":"in_progress","reason":"Closed"}}
 {"id":"int-ec0a4368","kind":"field_change","created_at":"2026-04-13T11:25:13.089935275Z","actor":"Denis Kiselev","issue_id":"EV-930z","extra":{"field":"status","new_value":"closed","old_value":"in_progress","reason":"Merged in PR #687"}}
 {"id":"int-a59bbad4","kind":"field_change","created_at":"2026-04-13T16:01:10.349431405Z","actor":"Denis Kiselev","issue_id":"EV-fu7n","extra":{"field":"status","new_value":"closed","old_value":"in_progress","reason":"Closed"}}
+{"id":"int-5a773d98","kind":"field_change","created_at":"2026-04-14T07:15:14.387885641Z","actor":"Denis Kiselev","issue_id":"EV-6e58","extra":{"field":"status","new_value":"closed","old_value":"in_progress","reason":"Closed"}}
+{"id":"int-bef8f44b","kind":"field_change","created_at":"2026-04-14T09:12:39.415079726Z","actor":"Denis Kiselev","issue_id":"EV-ruc4","extra":{"field":"status","new_value":"closed","old_value":"in_progress","reason":"Closed"}}
+{"id":"int-501725bd","kind":"field_change","created_at":"2026-04-14T09:55:34.799184486Z","actor":"Denis Kiselev","issue_id":"EV-2qeo","extra":{"field":"status","new_value":"closed","old_value":"in_progress","reason":"Closed"}}
+{"id":"int-7ea18f00","kind":"field_change","created_at":"2026-04-14T14:17:33.257720856Z","actor":"Denis Kiselev","issue_id":"EV-dqrk","extra":{"field":"status","new_value":"closed","old_value":"in_progress","reason":"Merged as PR #709."}}
+{"id":"int-3d40763b","kind":"field_change","created_at":"2026-04-14T14:17:35.373478774Z","actor":"Denis Kiselev","issue_id":"EV-rqy0","extra":{"field":"status","new_value":"closed","old_value":"in_progress","reason":"Merged as PR #711: Runner refactored into 7 SOLID collaborators (825→193 lines)."}}

data/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## [0.24.0] - 2026-04-14
+
+### Added
+
+- **`--fallback-full-suite` CLI flag** — when a mutation has no matching spec/test (spec resolver finds nothing), run the whole test suite instead of marking the mutation `:unresolved` and skipping; opt-in so the default remains fast (#697, PR #707)
+
+### Fixed
+
+- **`require_relative` in mutated files broken for sibling files** — the previous temp-dir copy strategy wrote the mutated source to a scratch directory where sibling source files did not exist, so any `require_relative "./sibling"` inside a mutated file failed to resolve; `Evilution::Integration::Base` now evaluates mutated source via `eval` with `__FILE__` set to the original path, so `require_relative` and `__dir__` resolve against the real source tree (#700, PR #708)
+
+### Changed
+
+- **Internal `Evilution::Reporter::HTML` refactor** — `lib/evilution/reporter/html.rb` (previously 410 lines) decomposed into section collaborators with one ERB template per section and CSS extracted to `lib/evilution/reporter/html/assets/style.css`; no output changes (#487, PR #712)
+- **Internal `Evilution::Runner` refactor** — extracted `BaselineRunner`, `IsolationResolver`, `MutationPlanner`, `SubjectPipeline`, `Diagnostics`, `MutationExecutor`, and `ReportPublisher` collaborators; no user-visible behavior change (#486, PR #711)
+- **Internal `Evilution::CLI::Parser` refactor** — decomposed into `CommandExtractor`, `FileArgs`, `OptionsBuilder`, and `StdinReader`; no user-visible behavior change (#703, PR #706)
+
 ## [0.23.0] - 2026-04-14
 
 ### Changed

data/README.md

@@ -69,6 +69,7 @@ evilution [command] [options] [files...]
 | `--no-preload`               | Boolean | _(enabled)_  | Disable parent-process preload.                     |
 | `--skip-heredoc-literals`    | Boolean | false        | Skip all string literal mutations inside heredocs.  |
 | `--show-disabled`            | Boolean | false        | Report mutations skipped by `# evilution:disable` comments. |
+| `--fallback-full-suite`      | Boolean | false        | When no matching spec/test resolves for a mutation, run the whole test suite instead of marking it `:unresolved` and skipping. |
 | `--baseline-session PATH`    | String  | _(none)_     | Saved session file for HTML report comparison.     |
 | `-e CODE`, `--eval CODE`     | String  | _(none)_     | Inline Ruby code for `util mutation` command.      |
 

data/lib/evilution/cli/parser/command_extractor.rb

@@ -0,0 +1,77 @@
+# frozen_string_literal: true
+
+class Evilution::CLI::Parser::CommandExtractor
+  SIMPLE_COMMANDS = {
+    "version" => :version,
+    "init" => :init,
+    "mcp" => :mcp,
+    "subjects" => :subjects
+  }.freeze
+
+  SESSION_SUBCOMMANDS = {
+    "list" => :session_list,
+    "show" => :session_show,
+    "diff" => :session_diff,
+    "gc" => :session_gc
+  }.freeze
+
+  TESTS_SUBCOMMANDS = { "list" => :tests_list }.freeze
+  ENVIRONMENT_SUBCOMMANDS = { "show" => :environment_show }.freeze
+  UTIL_SUBCOMMANDS = { "mutation" => :util_mutation }.freeze
+
+  Result = Struct.new(:command, :remaining_argv, :parse_error)
+
+  def self.call(argv)
+    new(argv).call
+  end
+
+  def initialize(argv)
+    @argv = argv.dup
+    @command = :run
+    @parse_error = nil
+  end
+
+  def call
+    extract
+    Result.new(@command, @argv, @parse_error)
+  end
+
+  private
+
+  def extract
+    first = @argv.first
+    if SIMPLE_COMMANDS.key?(first)
+      @command = SIMPLE_COMMANDS[first]
+      @argv.shift
+    elsif first == "run"
+      @argv.shift
+    elsif first == "session"
+      @argv.shift
+      extract_subcommand(SESSION_SUBCOMMANDS, "session", "list, show, diff, gc")
+    elsif first == "tests"
+      @argv.shift
+      extract_subcommand(TESTS_SUBCOMMANDS, "tests", "list")
+    elsif first == "environment"
+      @argv.shift
+      extract_subcommand(ENVIRONMENT_SUBCOMMANDS, "environment", "show")
+    elsif first == "util"
+      @argv.shift
+      extract_subcommand(UTIL_SUBCOMMANDS, "util", "mutation")
+    end
+  end
+
+  def extract_subcommand(table, family, available)
+    sub = @argv.first
+    if table.key?(sub)
+      @command = table[sub]
+      @argv.shift
+    elsif sub.nil?
+      @command = :parse_error
+      @parse_error = "Missing #{family} subcommand. Available subcommands: #{available}"
+    else
+      @command = :parse_error
+      @parse_error = "Unknown #{family} subcommand: #{sub}. Available subcommands: #{available}"
+      @argv.shift
+    end
+  end
+end

data/lib/evilution/cli/parser/file_args.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module Evilution::CLI::Parser::FileArgs
+  module_function
+
+  def parse(raw_args)
+    files = []
+    ranges = {}
+
+    raw_args.each do |arg|
+      file, range_str = arg.split(":", 2)
+      files << file
+      next unless range_str
+
+      ranges[file] = parse_line_range(range_str)
+    end
+
+    [files, ranges]
+  end
+
+  def expand_spec_dir(dir)
+    unless File.directory?(dir)
+      warn("Error: #{dir} is not a directory")
+      return []
+    end
+
+    Dir.glob(File.join(dir, "**/*_spec.rb"))
+  end
+
+  def parse_line_range(str)
+    if str.include?("-")
+      start_str, end_str = str.split("-", 2)
+      start_line = Integer(start_str)
+      end_line = end_str.empty? ? Float::INFINITY : Integer(end_str)
+      start_line..end_line
+    else
+      line = Integer(str)
+      line..line
+    end
+  end
+end

data/lib/evilution/cli/parser/options_builder.rb

@@ -0,0 +1,103 @@
+# frozen_string_literal: true
+
+require "optparse"
+require_relative "../../version"
+require_relative "file_args"
+
+class Evilution::CLI::Parser::OptionsBuilder
+  def self.build(options)
+    new(options).build
+  end
+
+  def initialize(options)
+    @options = options
+  end
+
+  def build
+    OptionParser.new do |opts|
+      opts.banner = "Usage: evilution [command] [options] [files...]"
+      opts.version = Evilution::VERSION
+      add_separators(opts)
+      add_core_options(opts)
+      add_filter_options(opts)
+      add_flag_options(opts)
+      add_extra_flag_options(opts)
+      add_session_options(opts)
+    end
+  end
+
+  private
+
+  def add_separators(opts)
+    opts.separator ""
+    opts.separator "Line-range targeting: lib/foo.rb:15-30, lib/foo.rb:15, lib/foo.rb:15-"
+    opts.separator ""
+    opts.separator "Commands: run (default), init, session {list,show,diff,gc}, subjects, tests {list},"
+    opts.separator "         util {mutation}, environment {show}, mcp, version"
+    opts.separator ""
+    opts.separator "Options:"
+  end
+
+  def add_core_options(opts)
+    opts.on("-j", "--jobs N", Integer, "Number of parallel workers (default: 1)") { |n| @options[:jobs] = n }
+    opts.on("-t", "--timeout N", Integer, "Per-mutation timeout in seconds") { |n| @options[:timeout] = n }
+    opts.on("-f", "--format FORMAT", "Output format: text, json, html") { |f| @options[:format] = f.to_sym }
+  end
+
+  def add_filter_options(opts)
+    opts.on("--min-score FLOAT", Float, "Minimum mutation score to pass") { |s| @options[:min_score] = s }
+    opts.on("--spec FILES", Array, "Spec files to run (comma-separated)") { |f| @options[:spec_files] = f }
+    opts.on("--spec-dir DIR", "Include all specs in DIR") { |d| expand_spec_dir(d) }
+    opts.on("--target EXPR",
+            "Filter: method (Foo#bar), type (Foo#/Foo.), namespace (Foo*),",
+            "class (Foo), glob (source:**/*.rb), hierarchy (descendants:Foo)") do |m|
+      @options[:target] = m
+    end
+  end
+
+  def add_flag_options(opts)
+    opts.on("--fail-fast", "Stop after N surviving mutants " \
+                           "(default: disabled; if provided without N, uses 1; use --fail-fast=N)") { @options[:fail_fast] ||= 1 }
+    opts.on("--no-baseline", "Skip baseline test suite check") { @options[:baseline] = false }
+    opts.on("--incremental", "Cache killed/timeout results; skip re-running them on unchanged files") { @options[:incremental] = true }
+    opts.on("--integration NAME", "Test integration: rspec, minitest (default: rspec)") { |i| @options[:integration] = i }
+    opts.on("--isolation STRATEGY", "Isolation: auto, fork, in_process (default: auto)") { |s| @options[:isolation] = s }
+    opts.on("--preload FILE", "Preload FILE in the parent process before forking " \
+                              "(default: auto-detect spec/rails_helper.rb for Rails projects)") { |f| @options[:preload] = f }
+    opts.on("--no-preload", "Disable parent-process preload even for Rails projects") { @options[:preload] = false }
+    opts.on("--stdin", "Read target file paths from stdin (one per line)") { @options[:stdin] = true }
+    opts.on("--suggest-tests", "Generate concrete test code in suggestions (RSpec or Minitest)") { @options[:suggest_tests] = true }
+    opts.on("--no-progress", "Disable progress bar") { @options[:progress] = false }
+  end
+
+  def add_extra_flag_options(opts)
+    opts.on("--skip-heredoc-literals", "Skip all string literal mutations inside heredocs") { @options[:skip_heredoc_literals] = true }
+    opts.on("--related-specs-heuristic", "Append related request/integration/feature/system specs for includes() mutations") do
+      @options[:related_specs_heuristic] = true
+    end
+    opts.on("--fallback-full-suite", "Run the whole test suite when no matching spec/test resolves " \
+                                     "for a mutation (default: mark the mutation :unresolved and skip)") do
+      @options[:fallback_to_full_suite] = true
+    end
+    opts.on("--show-disabled", "Report mutations skipped by # evilution:disable") { @options[:show_disabled] = true }
+    opts.on("--baseline-session PATH", "Compare against a baseline session in HTML report") { |p| @options[:baseline_session] = p }
+    opts.on("--save-session", "Save session results to .evilution/results/") { @options[:save_session] = true }
+    opts.on("-e", "--eval CODE", "Evaluate code snippet (for util mutation)") { |c| @options[:eval] = c }
+    opts.on("-v", "--verbose", "Verbose output") { @options[:verbose] = true }
+    opts.on("-q", "--quiet", "Suppress output") { @options[:quiet] = true }
+  end
+
+  def add_session_options(opts)
+    opts.on("--results-dir DIR", "Session results directory") { |d| @options[:results_dir] = d }
+    opts.on("--limit N", Integer, "Show only the N most recent sessions") { |n| @options[:limit] = n }
+    opts.on("--since DATE", "Show sessions since DATE (YYYY-MM-DD)") { |d| @options[:since] = d }
+    opts.on("--older-than DURATION", "Delete sessions older than DURATION (e.g., 30d, 24h, 1w)") do |d|
+      @options[:older_than] = d
+    end
+  end
+
+  def expand_spec_dir(dir)
+    specs = Evilution::CLI::Parser::FileArgs.expand_spec_dir(dir)
+    @options[:spec_files] = Array(@options[:spec_files]) + specs
+  end
+end

data/lib/evilution/cli/parser/stdin_reader.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+require_relative "file_args"
+
+class Evilution::CLI::Parser::StdinReader
+  Result = Struct.new(:files, :ranges, :error)
+
+  def self.call(io, existing_files:)
+    new(io, existing_files: existing_files).call
+  end
+
+  def initialize(io, existing_files:)
+    @io = io
+    @existing_files = existing_files
+  end
+
+  def call
+    return Result.new([], {}, "--stdin cannot be combined with positional file arguments") if @existing_files.any?
+
+    lines = []
+    @io.each_line do |line|
+      line = line.strip
+      lines << line unless line.empty?
+    end
+    files, ranges = Evilution::CLI::Parser::FileArgs.parse(lines)
+    Result.new(files, ranges, nil)
+  end
+end

data/lib/evilution/cli/parser.rb

@@ -1,28 +1,8 @@
 # frozen_string_literal: true
 
-require "optparse"
-require_relative "../version"
 require_relative "parsed_args"
 
 class Evilution::CLI::Parser
-  SIMPLE_COMMANDS = {
-    "version" => :version,
-    "init" => :init,
-    "mcp" => :mcp,
-    "subjects" => :subjects
-  }.freeze
-
-  SESSION_SUBCOMMANDS = {
-    "list" => :session_list,
-    "show" => :session_show,
-    "diff" => :session_diff,
-    "gc" => :session_gc
-  }.freeze
-
-  TESTS_SUBCOMMANDS = { "list" => :tests_list }.freeze
-  ENVIRONMENT_SUBCOMMANDS = { "show" => :environment_show }.freeze
-  UTIL_SUBCOMMANDS = { "mutation" => :util_mutation }.freeze
-
   def initialize(argv, stdin: $stdin)
     @argv = argv.dup
     @stdin = stdin
@@ -39,76 +19,19 @@ class Evilution::CLI::Parser
     return build_parsed_args if @command == :parse_error
 
     preprocess_flags
-    remaining = build_option_parser.parse!(@argv)
-    @files, @line_ranges = parse_file_args(remaining)
+    remaining = OptionsBuilder.build(@options).parse!(@argv)
+    @files, @line_ranges = FileArgs.parse(remaining)
     read_stdin_files if @options.delete(:stdin) && %i[run subjects].include?(@command)
     build_parsed_args
   end
 
   private
 
-  def read_stdin_files
-    if @files.any?
-      @stdin_error = "--stdin cannot be combined with positional file arguments"
-      return
-    end
-
-    lines = []
-    @stdin.each_line do |line|
-      line = line.strip
-      lines << line unless line.empty?
-    end
-    stdin_files, stdin_ranges = parse_file_args(lines)
-    @files = stdin_files
-    @line_ranges = @line_ranges.merge(stdin_ranges)
-  end
-
-  def build_parsed_args
-    Evilution::CLI::ParsedArgs.new(
-      command: @command,
-      options: @options,
-      files: @files,
-      line_ranges: @line_ranges,
-      stdin_error: @stdin_error,
-      parse_error: @parse_error
-    )
-  end
-
   def extract_command
-    first = @argv.first
-    if SIMPLE_COMMANDS.key?(first)
-      @command = SIMPLE_COMMANDS[first]
-      @argv.shift
-    elsif first == "run"
-      @argv.shift
-    elsif first == "session"
-      @argv.shift
-      extract_subcommand(SESSION_SUBCOMMANDS, "session", "list, show, diff, gc")
-    elsif first == "tests"
-      @argv.shift
-      extract_subcommand(TESTS_SUBCOMMANDS, "tests", "list")
-    elsif first == "environment"
-      @argv.shift
-      extract_subcommand(ENVIRONMENT_SUBCOMMANDS, "environment", "show")
-    elsif first == "util"
-      @argv.shift
-      extract_subcommand(UTIL_SUBCOMMANDS, "util", "mutation")
-    end
-  end
-
-  def extract_subcommand(table, family, available)
-    sub = @argv.first
-    if table.key?(sub)
-      @command = table[sub]
-      @argv.shift
-    elsif sub.nil?
-      @command = :parse_error
-      @parse_error = "Missing #{family} subcommand. Available subcommands: #{available}"
-    else
-      @command = :parse_error
-      @parse_error = "Unknown #{family} subcommand: #{sub}. Available subcommands: #{available}"
-      @argv.shift
-    end
+    result = CommandExtractor.call(@argv)
+    @command = result.command
+    @argv = result.remaining_argv
+    @parse_error = result.parse_error
   end
 
   def preprocess_flags
@@ -137,121 +60,29 @@ class Evilution::CLI::Parser
     @argv = result
   end
 
-  def build_option_parser
-    OptionParser.new do |opts|
-      opts.banner = "Usage: evilution [command] [options] [files...]"
-      opts.version = Evilution::VERSION
-      add_separators(opts)
-      add_options(opts)
-    end
-  end
-
-  def add_separators(opts)
-    opts.separator ""
-    opts.separator "Line-range targeting: lib/foo.rb:15-30, lib/foo.rb:15, lib/foo.rb:15-"
-    opts.separator ""
-    opts.separator "Commands: run (default), init, session {list,show,diff,gc}, subjects, tests {list},"
-    opts.separator "         util {mutation}, environment {show}, mcp, version"
-    opts.separator ""
-    opts.separator "Options:"
-  end
-
-  def add_options(opts)
-    add_core_options(opts)
-    add_filter_options(opts)
-    add_flag_options(opts)
-    add_session_options(opts)
-  end
-
-  def add_core_options(opts)
-    opts.on("-j", "--jobs N", Integer, "Number of parallel workers (default: 1)") { |n| @options[:jobs] = n }
-    opts.on("-t", "--timeout N", Integer, "Per-mutation timeout in seconds") { |n| @options[:timeout] = n }
-    opts.on("-f", "--format FORMAT", "Output format: text, json, html") { |f| @options[:format] = f.to_sym }
-  end
-
-  def add_filter_options(opts)
-    opts.on("--min-score FLOAT", Float, "Minimum mutation score to pass") { |s| @options[:min_score] = s }
-    opts.on("--spec FILES", Array, "Spec files to run (comma-separated)") { |f| @options[:spec_files] = f }
-    opts.on("--spec-dir DIR", "Include all specs in DIR") { |d| expand_spec_dir(d) }
-    opts.on("--target EXPR",
-            "Filter: method (Foo#bar), type (Foo#/Foo.), namespace (Foo*),",
-            "class (Foo), glob (source:**/*.rb), hierarchy (descendants:Foo)") do |m|
-      @options[:target] = m
-    end
-  end
-
-  def add_flag_options(opts)
-    opts.on("--fail-fast", "Stop after N surviving mutants " \
-                           "(default: disabled; if provided without N, uses 1; use --fail-fast=N)") { @options[:fail_fast] ||= 1 }
-    opts.on("--no-baseline", "Skip baseline test suite check") { @options[:baseline] = false }
-    opts.on("--incremental", "Cache killed/timeout results; skip re-running them on unchanged files") { @options[:incremental] = true }
-    opts.on("--integration NAME", "Test integration: rspec, minitest (default: rspec)") { |i| @options[:integration] = i }
-    opts.on("--isolation STRATEGY", "Isolation: auto, fork, in_process (default: auto)") { |s| @options[:isolation] = s }
-    opts.on("--preload FILE", "Preload FILE in the parent process before forking " \
-                              "(default: auto-detect spec/rails_helper.rb for Rails projects)") { |f| @options[:preload] = f }
-    opts.on("--no-preload", "Disable parent-process preload even for Rails projects") { @options[:preload] = false }
-    opts.on("--stdin", "Read target file paths from stdin (one per line)") { @options[:stdin] = true }
-    opts.on("--suggest-tests", "Generate concrete test code in suggestions (RSpec or Minitest)") { @options[:suggest_tests] = true }
-    opts.on("--no-progress", "Disable progress bar") { @options[:progress] = false }
-    add_extra_flag_options(opts)
-  end
-
-  def add_extra_flag_options(opts)
-    opts.on("--skip-heredoc-literals", "Skip all string literal mutations inside heredocs") { @options[:skip_heredoc_literals] = true }
-    opts.on("--related-specs-heuristic", "Append related request/integration/feature/system specs for includes() mutations") do
-      @options[:related_specs_heuristic] = true
-    end
-    opts.on("--show-disabled", "Report mutations skipped by # evilution:disable") { @options[:show_disabled] = true }
-    opts.on("--baseline-session PATH", "Compare against a baseline session in HTML report") { |p| @options[:baseline_session] = p }
-    opts.on("--save-session", "Save session results to .evilution/results/") { @options[:save_session] = true }
-    opts.on("-e", "--eval CODE", "Evaluate code snippet (for util mutation)") { |c| @options[:eval] = c }
-    opts.on("-v", "--verbose", "Verbose output") { @options[:verbose] = true }
-    opts.on("-q", "--quiet", "Suppress output") { @options[:quiet] = true }
-  end
-
-  def add_session_options(opts)
-    opts.on("--results-dir DIR", "Session results directory") { |d| @options[:results_dir] = d }
-    opts.on("--limit N", Integer, "Show only the N most recent sessions") { |n| @options[:limit] = n }
-    opts.on("--since DATE", "Show sessions since DATE (YYYY-MM-DD)") { |d| @options[:since] = d }
-    opts.on("--older-than DURATION", "Delete sessions older than DURATION (e.g., 30d, 24h, 1w)") do |d|
-      @options[:older_than] = d
-    end
-  end
-
-  def parse_file_args(raw_args)
-    files = []
-    ranges = {}
-
-    raw_args.each do |arg|
-      file, range_str = arg.split(":", 2)
-      files << file
-      next unless range_str
-
-      ranges[file] = parse_line_range(range_str)
-    end
-
-    [files, ranges]
-  end
-
-  def parse_line_range(str)
-    if str.include?("-")
-      start_str, end_str = str.split("-", 2)
-      start_line = Integer(start_str)
-      end_line = end_str.empty? ? Float::INFINITY : Integer(end_str)
-      start_line..end_line
-    else
-      line = Integer(str)
-      line..line
-    end
-  end
-
-  def expand_spec_dir(dir)
-    unless File.directory?(dir)
-      warn("Error: #{dir} is not a directory")
+  def read_stdin_files
+    result = StdinReader.call(@stdin, existing_files: @files)
+    if result.error
+      @stdin_error = result.error
       return
     end
+    @files = result.files
+    @line_ranges = @line_ranges.merge(result.ranges)
+  end
 
-    specs = Dir.glob(File.join(dir, "**/*_spec.rb"))
-    @options[:spec_files] = Array(@options[:spec_files]) + specs
+  def build_parsed_args
+    Evilution::CLI::ParsedArgs.new(
+      command: @command,
+      options: @options,
+      files: @files,
+      line_ranges: @line_ranges,
+      stdin_error: @stdin_error,
+      parse_error: @parse_error
+    )
   end
 end
+
+require_relative "parser/command_extractor"
+require_relative "parser/file_args"
+require_relative "parser/stdin_reader"
+require_relative "parser/options_builder"

data/lib/evilution/config.rb

@@ -28,6 +28,7 @@ class Evilution::Config
     baseline_session: nil,
     skip_heredoc_literals: false,
     related_specs_heuristic: false,
+    fallback_to_full_suite: false,
     preload: nil
   }.freeze
 
@@ -36,7 +37,8 @@ class Evilution::Config
               :jobs, :fail_fast, :baseline, :isolation, :incremental, :suggest_tests,
               :progress, :save_session, :line_ranges, :spec_files, :hooks,
               :ignore_patterns, :show_disabled, :baseline_session,
-              :skip_heredoc_literals, :related_specs_heuristic, :preload
+              :skip_heredoc_literals, :related_specs_heuristic,
+              :fallback_to_full_suite, :preload
 
   def initialize(**options)
     file_options = options.delete(:skip_config_file) ? {} : load_config_file
@@ -101,6 +103,10 @@ class Evilution::Config
     related_specs_heuristic
   end
 
+  def fallback_to_full_suite?
+    fallback_to_full_suite
+  end
+
   def self.file_options
     CONFIG_FILES.each do |path|
       next unless File.exist?(path)
@@ -155,6 +161,12 @@ class Evilution::Config
       # of N+1 regressions that only surface in higher-level specs.
       # related_specs_heuristic: true
 
+      # When no matching spec resolves for a mutation's source file, the
+      # default is to skip that mutation and mark it :unresolved in the
+      # report (a coverage gap signal). Set to true to fall back to running
+      # the entire test suite for such mutations instead (slow, high memory).
+      # fallback_to_full_suite: false
+
       # Preload file required in the parent process before forking workers.
       # For Rails projects, spec/rails_helper.rb or test/test_helper.rb is
       # auto-detected when isolation resolves to :fork. Set to false to disable.
@@ -210,6 +222,7 @@ class Evilution::Config
     @baseline_session = merged[:baseline_session]
     @skip_heredoc_literals = merged[:skip_heredoc_literals]
     @related_specs_heuristic = merged[:related_specs_heuristic]
+    @fallback_to_full_suite = merged[:fallback_to_full_suite]
     @hooks = validate_hooks(merged[:hooks])
     @preload = validate_preload(merged[:preload])
   end