evilution 0.23.0 → 0.25.0

data/lib/evilution/source_ast_cache.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+require "digest"
+require "prism"
+require_relative "../evilution"
+
+# Content-hash-keyed LRU of Prism::ParseResult. Different source bytes always
+# yield a different key, so the cache is valid for the lifetime of the process.
+class Evilution::SourceAstCache
+  DEFAULT_MAX_ENTRIES = 50
+  private_constant :DEFAULT_MAX_ENTRIES
+
+  def initialize(max_entries: DEFAULT_MAX_ENTRIES)
+    @max_entries = max_entries
+    @entries = {}
+  end
+
+  def fetch(source)
+    return Prism.parse(source) if @max_entries <= 0
+
+    key = Digest::SHA256.digest(source)
+    if @entries.key?(key)
+      result = @entries.delete(key)
+      @entries[key] = result
+      return result
+    end
+
+    result = Prism.parse(source)
+    @entries[key] = result
+    evict_until_within_bounds
+    result
+  end
+
+  private
+
+  def evict_until_within_bounds
+    @entries.shift while @entries.length > @max_entries
+  end
+end

data/lib/evilution/spec_ast_cache.rb

@@ -0,0 +1,166 @@
+# frozen_string_literal: true
+
+require "prism"
+require_relative "../evilution"
+
+class Evilution::SpecAstCache
+  Block = Struct.new(:kind, :line, :end_line, :body_text)
+
+  BLOCK_METHODS = %i[
+    describe context fcontext xcontext
+    it fit xit specify
+    before after
+  ].freeze
+  private_constant :BLOCK_METHODS
+
+  DEFAULT_MAX_FILES = 50
+  DEFAULT_MAX_BLOCKS = 10_000
+  private_constant :DEFAULT_MAX_FILES, :DEFAULT_MAX_BLOCKS
+
+  def initialize(max_files: DEFAULT_MAX_FILES, max_blocks: DEFAULT_MAX_BLOCKS)
+    @max_files = max_files
+    @max_blocks = max_blocks
+    @entries = {}
+    @total_blocks = 0
+  end
+
+  def fetch(path)
+    if @entries.key?(path)
+      blocks = @entries.delete(path)
+      @entries[path] = blocks
+      return blocks
+    end
+
+    blocks = parse(path)
+    insert(path, blocks)
+    blocks
+  end
+
+  def cached?(path)
+    @entries.key?(path)
+  end
+
+  private
+
+  def insert(path, blocks)
+    @entries[path] = blocks
+    @total_blocks += blocks.length
+    evict_until_within_bounds
+  end
+
+  def evict_until_within_bounds
+    while @entries.length > @max_files || @total_blocks > @max_blocks
+      break if @entries.empty?
+
+      oldest_path = @entries.keys.first
+      evicted = @entries.delete(oldest_path)
+      @total_blocks -= evicted.length
+    end
+  end
+
+  def parse(path)
+    raise Evilution::ParseError.new("file not found: #{path}", file: path) unless File.exist?(path)
+
+    source = read_source(path)
+    result = Prism.parse(source)
+
+    if result.failure?
+      raise Evilution::ParseError.new(
+        "failed to parse #{path}: #{result.errors.map(&:message).join(", ")}",
+        file: path
+      )
+    end
+
+    comment_ranges = result.comments
+                           .map { |c| c.location.start_offset...c.location.end_offset }
+                           .sort_by(&:begin)
+    collector = BlockCollector.new(source, comment_ranges)
+    collector.visit(result.value)
+    collector.blocks
+  end
+
+  def read_source(path)
+    File.read(path)
+  rescue SystemCallError => e
+    raise Evilution::ParseError.new("cannot read #{path}: #{e.message}", file: path)
+  end
+
+  class BlockCollector < Prism::Visitor
+    attr_reader :blocks
+
+    def initialize(source, comment_ranges)
+      @source = source
+      @comment_ranges = comment_ranges
+      @blocks = []
+      super()
+    end
+
+    def visit_call_node(node)
+      @blocks << build_block(node) if block_method?(node)
+      super
+    end
+
+    private
+
+    def block_method?(node)
+      BLOCK_METHODS.include?(node.name) && node.block
+    end
+
+    def build_block(node)
+      location = node.location
+      Block.new(
+        node.name,
+        location.start_line,
+        location.end_line,
+        extract_body_text(node)
+      )
+    end
+
+    def extract_body_text(node)
+      block = node.block
+      return "" unless block
+
+      body = block.body
+      return "" unless body
+
+      start_off = body.location.start_offset
+      end_off = body.location.end_offset
+      slice = @source.byteslice(start_off, end_off - start_off) || ""
+      stripped = strip_comments(slice, start_off)
+      stripped.downcase
+    end
+
+    def strip_comments(slice, base_offset)
+      return slice if @comment_ranges.empty?
+
+      ranges = comment_ranges_within(base_offset, base_offset + slice.bytesize)
+      return slice if ranges.empty?
+
+      result = +""
+      cursor = base_offset
+      ranges.each do |range|
+        result << @source.byteslice(cursor, range.begin - cursor)
+        cursor = range.end
+      end
+      result << @source.byteslice(cursor, base_offset + slice.bytesize - cursor)
+      result
+    end
+
+    def comment_ranges_within(start_off, end_off)
+      lower = @comment_ranges.bsearch_index { |r| r.begin >= start_off }
+      return [] unless lower
+
+      result = []
+      idx = lower
+      while idx < @comment_ranges.length
+        range = @comment_ranges[idx]
+        break if range.begin >= end_off
+
+        result << range if range.end <= end_off
+        idx += 1
+      end
+      result
+    end
+  end
+  private_constant :BlockCollector
+end

data/lib/evilution/spec_resolver.rb

@@ -10,11 +10,12 @@ class Evilution::SpecResolver
     @request_dir = request_dir
   end
 
-  def call(source_path)
+  def call(source_path, spec_pattern: nil)
     return nil if source_path.nil? || source_path.empty?
 
     normalized = normalize_path(source_path)
     candidates = candidate_test_paths(normalized)
+    candidates = filter_by_pattern(candidates, spec_pattern) if spec_pattern
     candidates.find { |path| File.exist?(path) }
   end
 
@@ -24,6 +25,10 @@ class Evilution::SpecResolver
 
   private
 
+  def filter_by_pattern(candidates, pattern)
+    candidates.select { |path| File.fnmatch?(pattern, path, File::FNM_PATHNAME | File::FNM_EXTGLOB) }
+  end
+
   def normalize_path(path)
     path = path.delete_prefix("./")
     path = path.delete_prefix("#{Dir.pwd}/") if path.start_with?("/")

data/lib/evilution/spec_selector.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+require_relative "spec_resolver"
+
+class Evilution::SpecSelector
+  def initialize(spec_files: [], spec_mappings: {}, spec_pattern: nil, spec_resolver: Evilution::SpecResolver.new)
+    @spec_files = Array(spec_files)
+    @spec_mappings = spec_mappings || {}
+    @spec_pattern = spec_pattern
+    @spec_resolver = spec_resolver
+  end
+
+  def call(source_path)
+    return @spec_files unless @spec_files.empty?
+
+    mapped = mapping_for(source_path)
+    if mapped
+      existing = mapped.select { |path| File.exist?(path) }
+      return existing unless existing.empty?
+    end
+
+    resolved = @spec_resolver.call(source_path, spec_pattern: @spec_pattern)
+    resolved ? [resolved] : nil
+  end
+
+  private
+
+  def mapping_for(source_path)
+    @spec_mappings[normalize(source_path)]
+  end
+
+  def normalize(path)
+    return path if path.nil?
+
+    normalized = path.to_s
+    normalized = normalized.delete_prefix("#{Dir.pwd}/") if normalized.start_with?("/")
+    normalized.delete_prefix("./")
+  end
+end

data/lib/evilution/temp_dir_tracker.rb

@@ -21,9 +21,15 @@ module Evilution::TempDirTracker
   end
 
   def self.cleanup_all
-    @monitor.synchronize do
-      @dirs.each { |d| FileUtils.rm_rf(d) }
-      @dirs.clear
+    # Trap-safe: Signal.trap handlers forbid Monitor#synchronize, so both the
+    # snapshot and the per-dir tracking removal fall back to a lock-free path
+    # when ThreadError is raised. Successful removals drop the entry from
+    # @dirs; failures stay tracked so a later cleanup can retry.
+    snapshot_tracked_dirs.each do |d|
+      FileUtils.rm_rf(d)
+      remove_from_tracking(d)
+    rescue StandardError
+      nil
     end
   end
 
@@ -36,4 +42,18 @@ module Evilution::TempDirTracker
     @at_exit_registered = true
   end
   private_class_method :register_at_exit
+
+  def self.snapshot_tracked_dirs
+    @monitor.synchronize { @dirs.to_a }
+  rescue ThreadError
+    @dirs.to_a
+  end
+  private_class_method :snapshot_tracked_dirs
+
+  def self.remove_from_tracking(dir)
+    @monitor.synchronize { @dirs.delete(dir) }
+  rescue ThreadError
+    @dirs.delete(dir)
+  end
+  private_class_method :remove_from_tracking
 end

data/lib/evilution/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Evilution
-  VERSION = "0.23.0"
+  VERSION = "0.25.0"
 end

data/script/memory_check

@@ -7,8 +7,8 @@ require_relative "../lib/evilution/integration/rspec"
 
 FIXTURE = File.expand_path("../spec/support/fixtures/simple_class.rb", __dir__)
 FIXTURE_SPEC = File.expand_path("../spec/support/fixtures/simple_class_spec.rb", __dir__)
-COMPLEX_FIXTURE = File.expand_path("../lib/evilution/config.rb", __dir__)
-COMPLEX_FIXTURE_SPEC = File.expand_path("../spec/evilution/config_spec.rb", __dir__)
+COMPLEX_FIXTURE = File.expand_path("../spec/support/fixtures/memory_check/target.rb", __dir__)
+COMPLEX_FIXTURE_SPEC = File.expand_path("../spec/support/fixtures/memory_check/target_examples.rb", __dir__)
 ITERATIONS = Integer(ENV.fetch("MEMORY_CHECK_ITERATIONS", 50))
 MAX_GROWTH_KB = Integer(ENV.fetch("MEMORY_CHECK_MAX_GROWTH_KB", 10_240))
 
@@ -95,8 +95,10 @@ if mutations.size >= 2
 end
 
 # 5. RSpec integration per-mutation with complex fixture
-#    Uses Config (227 LOC, 73 specs, 564 mutations) for realistic per-mutation load:
-#    more ExampleGroup subclasses, deeper spec nesting, heavier metadata.
+#    Uses a frozen snapshot under spec/support/fixtures/memory_check/ for
+#    realistic per-mutation load: deep spec nesting, heavy metadata. Snapshot
+#    is intentional - decoupling the budget from project file growth so this
+#    check measures integration plumbing memory, not project size.
 complex_parser = Evilution::AST::Parser.new
 complex_registry = Evilution::Mutator::Registry.default
 complex_subjects = complex_parser.call(COMPLEX_FIXTURE)
@@ -105,7 +107,7 @@ complex_mutations = complex_subjects.flat_map { |s| complex_registry.mutations_f
 integration = Evilution::Integration::RSpec.new(test_files: [COMPLEX_FIXTURE_SPEC])
 
 # Budget is generous: per-mutation require() adds the file to $LOADED_FEATURES and
-# accumulates constant-redefinition warnings. Local runs land around 20-25 MB; CI
+# accumulates constant-redefinition warnings. Local runs land around 20 MB; CI
 # varies up to ~30 MB depending on Ruby build and GC pressure, so we leave headroom.
 all_passed &= run_check("RSpec integration per-mutation (Config)", iterations: 20, max_growth_kb: 40_960) do
   mutation = complex_mutations.sample

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: evilution
 version: !ruby/object:Gem::Version
-  version: 0.23.0
+  version: 0.25.0
 platform: ruby
 authors:
 - Denis Kiselev
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-04-14 00:00:00.000000000 Z
+date: 2026-04-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: diff-lcs
@@ -56,6 +56,7 @@ description: Evilution is a mutation testing tool for Ruby. It validates test su
 email:
 - denis.kiselyov@gmail.com
 executables:
+- evil
 - evilution
 extensions: []
 extra_rdoc_files: []
@@ -83,6 +84,7 @@ files:
 - docs/ast_pattern_syntax.md
 - docs/isolation.md
 - docs/mutation_density_benchmark.md
+- exe/evil
 - exe/evilution
 - lib/evilution.rb
 - lib/evilution/ast.rb
@@ -99,6 +101,7 @@ files:
 - lib/evilution/cli.rb
 - lib/evilution/cli/command.rb
 - lib/evilution/cli/commands.rb
+- lib/evilution/cli/commands/compare.rb
 - lib/evilution/cli/commands/environment_show.rb
 - lib/evilution/cli/commands/init.rb
 - lib/evilution/cli/commands/mcp.rb
@@ -114,7 +117,12 @@ files:
 - lib/evilution/cli/dispatcher.rb
 - lib/evilution/cli/parsed_args.rb
 - lib/evilution/cli/parser.rb
+- lib/evilution/cli/parser/command_extractor.rb
+- lib/evilution/cli/parser/file_args.rb
+- lib/evilution/cli/parser/options_builder.rb
+- lib/evilution/cli/parser/stdin_reader.rb
 - lib/evilution/cli/printers.rb
+- lib/evilution/cli/printers/compare.rb
 - lib/evilution/cli/printers/environment.rb
 - lib/evilution/cli/printers/session_detail.rb
 - lib/evilution/cli/printers/session_diff.rb
@@ -123,6 +131,12 @@ files:
 - lib/evilution/cli/printers/tests_list.rb
 - lib/evilution/cli/printers/util_mutation.rb
 - lib/evilution/cli/result.rb
+- lib/evilution/compare.rb
+- lib/evilution/compare/categorizer.rb
+- lib/evilution/compare/detector.rb
+- lib/evilution/compare/fingerprint.rb
+- lib/evilution/compare/normalizer.rb
+- lib/evilution/compare/record.rb
 - lib/evilution/config.rb
 - lib/evilution/disable_comment.rb
 - lib/evilution/equivalent.rb
@@ -135,6 +149,7 @@ files:
 - lib/evilution/equivalent/heuristic/method_body_nil.rb
 - lib/evilution/equivalent/heuristic/noop_source.rb
 - lib/evilution/equivalent/heuristic/void_context.rb
+- lib/evilution/example_filter.rb
 - lib/evilution/git.rb
 - lib/evilution/git/changed_files.rb
 - lib/evilution/hooks.rb
@@ -152,6 +167,12 @@ files:
 - lib/evilution/mcp.rb
 - lib/evilution/mcp/info_tool.rb
 - lib/evilution/mcp/mutate_tool.rb
+- lib/evilution/mcp/mutate_tool/config_builder.rb
+- lib/evilution/mcp/mutate_tool/error_payload.rb
+- lib/evilution/mcp/mutate_tool/option_parser.rb
+- lib/evilution/mcp/mutate_tool/progress_streamer.rb
+- lib/evilution/mcp/mutate_tool/report_trimmer.rb
+- lib/evilution/mcp/mutate_tool/survived_enricher.rb
 - lib/evilution/mcp/server.rb
 - lib/evilution/mcp/session_diff_tool.rb
 - lib/evilution/mcp/session_list_tool.rb
@@ -239,24 +260,76 @@ files:
 - lib/evilution/parallel.rb
 - lib/evilution/parallel/pool.rb
 - lib/evilution/parallel/work_queue.rb
+- lib/evilution/parallel_db_warning.rb
 - lib/evilution/rails_detector.rb
 - lib/evilution/related_spec_heuristic.rb
 - lib/evilution/reporter.rb
 - lib/evilution/reporter/cli.rb
 - lib/evilution/reporter/html.rb
+- lib/evilution/reporter/html/assets/style.css
+- lib/evilution/reporter/html/baseline_keys.rb
+- lib/evilution/reporter/html/diff_formatter.rb
+- lib/evilution/reporter/html/escape.rb
+- lib/evilution/reporter/html/namespace.rb
+- lib/evilution/reporter/html/report.rb
+- lib/evilution/reporter/html/section.rb
+- lib/evilution/reporter/html/sections.rb
+- lib/evilution/reporter/html/sections/baseline_comparison.rb
+- lib/evilution/reporter/html/sections/error_details.rb
+- lib/evilution/reporter/html/sections/error_entry.rb
+- lib/evilution/reporter/html/sections/file_section.rb
+- lib/evilution/reporter/html/sections/header.rb
+- lib/evilution/reporter/html/sections/mutation_map.rb
+- lib/evilution/reporter/html/sections/neutral_details.rb
+- lib/evilution/reporter/html/sections/summary_cards.rb
+- lib/evilution/reporter/html/sections/survived_details.rb
+- lib/evilution/reporter/html/sections/survived_entry.rb
+- lib/evilution/reporter/html/sections/truncation_notice.rb
+- lib/evilution/reporter/html/sections/unparseable_details.rb
+- lib/evilution/reporter/html/sections/unresolved_details.rb
+- lib/evilution/reporter/html/stylesheet.rb
+- lib/evilution/reporter/html/templates/baseline_comparison.html.erb
+- lib/evilution/reporter/html/templates/error_details.html.erb
+- lib/evilution/reporter/html/templates/error_entry.html.erb
+- lib/evilution/reporter/html/templates/file_section.html.erb
+- lib/evilution/reporter/html/templates/header.html.erb
+- lib/evilution/reporter/html/templates/mutation_map.html.erb
+- lib/evilution/reporter/html/templates/neutral_details.html.erb
+- lib/evilution/reporter/html/templates/report.html.erb
+- lib/evilution/reporter/html/templates/summary_cards.html.erb
+- lib/evilution/reporter/html/templates/survived_details.html.erb
+- lib/evilution/reporter/html/templates/survived_entry.html.erb
+- lib/evilution/reporter/html/templates/truncation_notice.html.erb
+- lib/evilution/reporter/html/templates/unparseable_details.html.erb
+- lib/evilution/reporter/html/templates/unresolved_details.html.erb
 - lib/evilution/reporter/json.rb
 - lib/evilution/reporter/progress_bar.rb
 - lib/evilution/reporter/suggestion.rb
+- lib/evilution/reporter/suggestion/diff_helpers.rb
+- lib/evilution/reporter/suggestion/registry.rb
+- lib/evilution/reporter/suggestion/templates/generic.rb
+- lib/evilution/reporter/suggestion/templates/minitest.rb
+- lib/evilution/reporter/suggestion/templates/rspec.rb
 - lib/evilution/result.rb
 - lib/evilution/result/coverage_gap.rb
 - lib/evilution/result/coverage_gap_grouper.rb
 - lib/evilution/result/mutation_result.rb
 - lib/evilution/result/summary.rb
 - lib/evilution/runner.rb
+- lib/evilution/runner/baseline_runner.rb
+- lib/evilution/runner/diagnostics.rb
+- lib/evilution/runner/isolation_resolver.rb
+- lib/evilution/runner/mutation_executor.rb
+- lib/evilution/runner/mutation_planner.rb
+- lib/evilution/runner/report_publisher.rb
+- lib/evilution/runner/subject_pipeline.rb
 - lib/evilution/session.rb
 - lib/evilution/session/diff.rb
 - lib/evilution/session/store.rb
+- lib/evilution/source_ast_cache.rb
+- lib/evilution/spec_ast_cache.rb
 - lib/evilution/spec_resolver.rb
+- lib/evilution/spec_selector.rb
 - lib/evilution/subject.rb
 - lib/evilution/temp_dir_tracker.rb
 - lib/evilution/version.rb