evilution 0.9.0 → 0.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bd6e8e6df2bd5ec7096d3d8ddf35106323f25fab3a7e0aa0ad215aab2081a43d
-  data.tar.gz: 3178e1d157672ad425758e9122b7c151e899ea561af9a00b0e40d6f899b97bbd
+  metadata.gz: a4753225c2b9795143ecd0e37a355a2503e2a467ee9f79d1be82841141102a3d
+  data.tar.gz: 760527bdb4c437124ed4ec26e35d72aff297bdc519636cb04b12eee408e5a4e4
 SHA512:
-  metadata.gz: 178f85a6accb6c0e5a844e2b3b749909b9ee1f68a7e660fe88a79eeb8624cd6a6b7112443fc35ac9a0d1401477fd986b51d4b7055be654443f1f5e0da2626cf1
-  data.tar.gz: 0f5f209a4073f8de346baf2252f318dbefd40609eb163e2cd17b8339c311cfe2b520e53c23ac9d97de009a3788af7f0618a3d870afc76aeb6185374441c0275d
+  metadata.gz: bc9b9d5d7922ecb4f6dd7fd7a9dd62dcf292f8c5ba1b8d6b71b01d3850a2565afaecd04d30fc18bdef9f8d586cf5559ce97ac7188b5c0e9e99d3d5bbfb4c91e4
+  data.tar.gz: c8ec937012b8e910c61c42b650150de6144f59e49a731e903d59973858bca71e8fbd63a29988acb749f3e6ecfaa0ecc749d907195f81449bf6c3aa68a3872fe4

data/.beads/.migration-hint-ts

@@ -1 +1 @@
-1773937412
+1774024848

data/.beads/issues.jsonl

@@ -99,7 +99,7 @@
 {"id":"EV-5.5","title":"Write README.md","description":"Replace placeholder README with: gem description, installation, quick start, CLI usage, configuration, output formats (JSON schema), operator list, comparison with mutant, contributing guide, license.","status":"closed","priority":2,"issue_type":"task","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-02T00:06:58.454635118+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-02T11:54:29.226280116+07:00","closed_at":"2026-03-02T11:54:29.226280116+07:00","close_reason":"Closed","dependencies":[{"issue_id":"EV-5.5","depends_on_id":"EV-5","type":"parent-child","created_at":"0001-01-01T00:00:00Z"},{"issue_id":"EV-5.5","depends_on_id":"EV-4.9","type":"blocks","created_at":"0001-01-01T00:00:00Z"},{"issue_id":"EV-5.5","depends_on_id":"EV-5.1","type":"blocks","created_at":"0001-01-01T00:00:00Z"}]}
 {"id":"EV-5.6","title":"Update CHANGELOG.md for v0.1.0","description":"Document all features in the initial release: operator list, RSpec integration, JSON/CLI output, parallel execution, coverage-based selection, diff-based targeting.","status":"closed","priority":2,"issue_type":"task","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-02T00:06:58.571499415+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-02T11:54:29.22634981+07:00","closed_at":"2026-03-02T11:54:29.22634981+07:00","close_reason":"Closed","dependencies":[{"issue_id":"EV-5.6","depends_on_id":"EV-5","type":"parent-child","created_at":"0001-01-01T00:00:00Z"},{"issue_id":"EV-5.6","depends_on_id":"EV-5.5","type":"blocks","created_at":"0001-01-01T00:00:00Z"}]}
 {"id":"EV-50","title":"Operator: ConditionalFlip","description":"Flip if/unless. e.g. if cond → unless cond. Catches single-branch conditional testing.","status":"closed","priority":3,"issue_type":"feature","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-16T21:50:23.379431887+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-19T16:25:00.912700206+07:00","closed_at":"2026-03-19T16:25:00.912700206+07:00","close_reason":"Implemented ConditionalFlip operator with 10 specs","external_ref":"gh-98","dependencies":[{"issue_id":"EV-50","depends_on_id":"EV-45","type":"parent-child","created_at":"0001-01-01T00:00:00Z"}]}
-{"id":"EV-51","title":"Operator: SendMutation","description":"Replace known method families. e.g. flat_map → map, public_send → send, gsub → sub. Catches untested method semantics.","status":"open","priority":4,"issue_type":"feature","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-16T21:50:23.483414117+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-19T15:45:33.737392246+07:00","external_ref":"gh-99","dependencies":[{"issue_id":"EV-51","depends_on_id":"EV-45","type":"parent-child","created_at":"0001-01-01T00:00:00Z"}]}
+{"id":"EV-51","title":"Operator: SendMutation","description":"Replace known method families. e.g. flat_map → map, public_send → send, gsub → sub. Catches untested method semantics.","status":"closed","priority":4,"issue_type":"feature","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-16T21:50:23.483414117+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-20T23:14:12.811639741+07:00","closed_at":"2026-03-20T23:14:12.811639741+07:00","close_reason":"Implemented SendMutation operator with 17 method family replacements (flat_map/map, public_send/send, gsub/sub, detect/find, collect/map, each_with_object/inject, reverse_each/each, length/size, values_at/fetch_values). 19 specs passing.","external_ref":"gh-99","dependencies":[{"issue_id":"EV-51","depends_on_id":"EV-45","type":"parent-child","created_at":"0001-01-01T00:00:00Z"}]}
 {"id":"EV-52","title":"Operator: ArgumentRemoval","description":"Remove, permute, and replace individual method call arguments. e.g. foo(a, b) → foo(a), foo(b, a), foo(a, nil). This is the #1 cited gap vs mutant — where mutant catches the most bugs evilution misses. Includes: removing each argument individually, swapping argument order, replacing with nil.","status":"closed","priority":2,"issue_type":"feature","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-16T21:50:23.587291445+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-19T15:45:33.832675896+07:00","closed_at":"2026-03-17T23:16:28.920737471+07:00","close_reason":"Merged","external_ref":"gh-100","dependencies":[{"issue_id":"EV-52","depends_on_id":"EV-45","type":"parent-child","created_at":"0001-01-01T00:00:00Z"}]}
 {"id":"EV-53","title":"Operator: ReceiverReplacement","description":"Drop explicit self receiver. e.g. self.foo → foo. Low bug-finding value.","status":"closed","priority":3,"issue_type":"feature","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-16T21:50:23.692244528+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-19T20:56:21.943424181+07:00","closed_at":"2026-03-19T20:56:21.943424181+07:00","close_reason":"Implemented ReceiverReplacement operator with 8 specs, 100% mutation score","external_ref":"gh-101","dependencies":[{"issue_id":"EV-53","depends_on_id":"EV-45","type":"parent-child","created_at":"0001-01-01T00:00:00Z"}]}
 {"id":"EV-54","title":"Deepen existing operators with more replacement variants","description":"Existing operators generate limited variants per node. E.g. integer 5 only produces 0 and 1, but could also produce -1 and nil. Expanding variant sets across all 18 operators would significantly increase mutation coverage.","status":"open","priority":3,"issue_type":"feature","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-16T21:50:23.797359784+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-19T15:45:34.022534916+07:00","external_ref":"gh-102","dependencies":[{"issue_id":"EV-54","depends_on_id":"EV-45","type":"parent-child","created_at":"0001-01-01T00:00:00Z"}]}
@@ -109,7 +109,7 @@
 {"id":"EV-54.4","title":"Expand ComparisonReplacement with opposite direction flips","description":"Currently > only mutates to >= and ==. Add full opposite flips: >→<, >=→<=, <→>, <=→>=. Catches inverted comparison bugs.","status":"open","priority":3,"issue_type":"task","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-19T21:21:20.944147572+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-19T21:22:02.036010574+07:00","external_ref":"gh-170","dependencies":[{"issue_id":"EV-54.4","depends_on_id":"EV-54","type":"parent-child","created_at":"0001-01-01T00:00:00Z"}]}
 {"id":"EV-54.5","title":"Add always-matching regexp variant","description":"Currently regexp only mutates to never-matching /a\\A/. Add always-matching /.*/ variant to test both match and no-match code paths.","status":"open","priority":3,"issue_type":"task","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-19T21:21:21.049402671+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-19T21:22:02.124434713+07:00","external_ref":"gh-171","dependencies":[{"issue_id":"EV-54.5","depends_on_id":"EV-54","type":"parent-child","created_at":"0001-01-01T00:00:00Z"}]}
 {"id":"EV-54.6","title":"Expand ArithmeticReplacement with bitwise shift operators","description":"Add <<→>> swap. Niche but catches bitwise shift bugs. Lowest priority in this epic.","status":"open","priority":4,"issue_type":"task","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-19T21:21:21.152296396+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-19T21:22:02.210556018+07:00","external_ref":"gh-172","dependencies":[{"issue_id":"EV-54.6","depends_on_id":"EV-54","type":"parent-child","created_at":"0001-01-01T00:00:00Z"}]}
-{"id":"EV-54.7","title":"Operator: ArgumentNilSubstitution","description":"Replace each method argument with nil, one at a time. E.g. foo(a, b) → foo(nil, b) and foo(a, nil). Works for single-arg calls too (unlike ArgumentRemoval which requires 2+). This catches 'default value' bugs where a method has a sensible fallback for nil — e.g. I18n.with_locale(user.locale) → I18n.with_locale(nil) silently falls back to default locale. Identified from real-world feedback where mutant caught a locale test gap that evilution missed (v0.7.0).","status":"open","priority":2,"issue_type":"task","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-19T22:09:42.995246472+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-19T22:09:57.489403188+07:00","external_ref":"gh-175","dependencies":[{"issue_id":"EV-54.7","depends_on_id":"EV-54","type":"parent-child","created_at":"0001-01-01T00:00:00Z"}]}
+{"id":"EV-54.7","title":"Operator: ArgumentNilSubstitution","description":"Replace each method argument with nil, one at a time. E.g. foo(a, b) → foo(nil, b) and foo(a, nil). Works for single-arg calls too (unlike ArgumentRemoval which requires 2+). This catches 'default value' bugs where a method has a sensible fallback for nil — e.g. I18n.with_locale(user.locale) → I18n.with_locale(nil) silently falls back to default locale. Identified from real-world feedback where mutant caught a locale test gap that evilution missed (v0.7.0).","status":"closed","priority":2,"issue_type":"task","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-19T22:09:42.995246472+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-20T23:43:12.098455761+07:00","closed_at":"2026-03-20T23:43:12.098455761+07:00","close_reason":"Implemented ArgumentNilSubstitution operator. Replaces each argument with nil one at a time, works for single-arg calls too (unlike ArgumentRemoval). Skips splat, keyword, block, and forwarding args. 12 specs passing, 705 total.","external_ref":"gh-175","dependencies":[{"issue_id":"EV-54.7","depends_on_id":"EV-54","type":"parent-child","created_at":"0001-01-01T00:00:00Z"}]}
 {"id":"EV-55","title":"Concrete suggestions: Comparison & Arithmetic operators","description":"Generate concrete RSpec it blocks for ComparisonReplacement and ArithmeticReplacement mutations. Test should assert exact return value at boundary conditions.","status":"open","priority":3,"issue_type":"feature","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-17T09:58:33.26716126+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-17T09:58:33.26716126+07:00"}
 {"id":"EV-56","title":"Concrete suggestions: Boolean operators","description":"Generate concrete RSpec it blocks for BooleanOperatorReplacement, BooleanLiteralReplacement, and NegationInsertion mutations. Test should assert true/false explicitly.","status":"open","priority":3,"issue_type":"feature","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-17T09:58:33.370014645+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-17T09:58:33.370014645+07:00"}
 {"id":"EV-57","title":"Concrete suggestions: Literal operators","description":"Generate concrete RSpec it blocks for IntegerLiteral, FloatLiteral, StringLiteral, and SymbolLiteral mutations. Test should assert exact value returned.","status":"open","priority":3,"issue_type":"feature","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-17T09:58:33.473990949+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-17T09:58:33.473990949+07:00"}
@@ -123,8 +123,8 @@
 {"id":"EV-64","title":"Class-level --target filtering","description":"Extend --target to accept class names without method (e.g. --target Game) to mutate all methods in the class. Currently only supports fully-qualified method names like Game#method.","status":"closed","priority":3,"issue_type":"feature","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-17T10:15:03.858147999+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-19T21:31:38.601679951+07:00","closed_at":"2026-03-19T21:31:38.601679951+07:00","close_reason":"Implemented class-level --target filtering with 3 new specs, 100% mutation score"}
 {"id":"EV-65","title":"Incremental mode with result caching","description":"Cache mutation results and only re-run mutations on changed lines/methods. Big CI speed win for large codebases. Could key cache on file content hash + mutation fingerprint.","status":"closed","priority":3,"issue_type":"feature","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-17T10:15:03.95132569+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-19T21:47:19.95617067+07:00","closed_at":"2026-03-19T21:47:19.95617067+07:00","close_reason":"Implemented incremental mode with result caching. Cache class (9 specs), runner integration (4 specs), CLI --incremental flag, config support. 100% mutation score on cache."}
 {"id":"EV-66","title":"Scope-aware spec resolution","description":"Improve convention-based spec resolution for nested modules. When a method is nested in a module, prefer spec/models/game_spec.rb over a generic match. Handle edge cases in app/ directory structures.","status":"closed","priority":3,"issue_type":"feature","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-17T10:15:04.04579177+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-19T22:15:01.15206232+07:00","closed_at":"2026-03-19T22:15:01.15206232+07:00","close_reason":"Implemented parent-path fallback in SpecResolver for nested module spec resolution"}
-{"id":"EV-67","title":"HTML report with visual mutation map","description":"Generate an HTML report showing which lines are well-tested vs vulnerable. Visual mutation map per file with color-coded coverage.","status":"open","priority":4,"issue_type":"feature","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-17T10:15:04.13552276+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-17T10:15:04.13552276+07:00"}
-{"id":"EV-68","title":"Equivalent mutation detection","description":"Add heuristics to skip mutations that produce provably identical behavior (dead code paths, no-op transformations). Reduces noise in mutation results.","status":"open","priority":4,"issue_type":"feature","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-17T10:15:04.226297798+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-17T10:15:04.226297798+07:00"}
+{"id":"EV-67","title":"HTML report with visual mutation map","description":"Generate an HTML report showing which lines are well-tested vs vulnerable. Visual mutation map per file with color-coded coverage.","status":"closed","priority":4,"issue_type":"feature","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-17T10:15:04.13552276+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-20T23:58:29.045246978+07:00","closed_at":"2026-03-20T23:58:29.045246978+07:00","close_reason":"Implemented HTML reporter with visual mutation map. Self-contained HTML with inline CSS (dark theme), per-file mutation maps with color-coded lines (green=killed, red=survived, yellow=timeout), expandable survived mutation details with diffs and suggestions. Writes to evilution-report.html. 17 reporter specs, 724 total passing."}
+{"id":"EV-68","title":"Equivalent mutation detection","description":"Add heuristics to skip mutations that produce provably identical behavior (dead code paths, no-op transformations). Reduces noise in mutation results.","status":"closed","priority":4,"issue_type":"feature","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-17T10:15:04.226297798+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-21T00:22:25.796367972+07:00","closed_at":"2026-03-21T00:22:25.796367972+07:00","close_reason":"Implemented equivalent mutation detection with 4 heuristics: NoopSource (identical source), MethodBodyNil (empty/nil method bodies), AliasSwap (detect/find, length/size, collect/map), DeadCode (unreachable code after return/raise). Integrated into runner pipeline, reporters (CLI/JSON/HTML), and MCP tool. Equivalents excluded from score denominator. 100% mutation score (211/211). 753 total specs passing."}
 {"id":"EV-69","title":"Minitest integration","description":"Add Minitest support alongside existing RSpec integration. Broader ecosystem support for non-RSpec projects.","status":"open","priority":4,"issue_type":"feature","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-17T10:15:04.313129974+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-17T10:15:04.313129974+07:00"}
 {"id":"EV-7","title":"Enable true per-mutation isolation with temp file copies","description":"Currently all mutations for the same file go to one worker (PR #4 fix). This means single-file projects get no parallelism benefit. Implement temp file copy approach: each worker copies the source file to a temp location, mutates the copy, and runs tests against it. This enables safe parallel mutation of the same file across multiple workers.","status":"closed","priority":2,"issue_type":"feature","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-02T16:21:46.820210376+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-06T11:46:55.740292929+07:00","closed_at":"2026-03-06T11:46:55.740292929+07:00","close_reason":"Already merged in PR #20"}
 {"id":"EV-70","title":"Epic: Fix memory leaks and add memory observability","description":"Evilution processes consume up to 17.2 GB each due to memory leaks. This epic covers: (1) identifying and fixing root causes — double forking, upfront mutation array, source string retention in results, Marshal round-trips; (2) adding runtime memory instrumentation behind --verbose; (3) adding memory budget specs to catch regressions in CI.","status":"closed","priority":1,"issue_type":"epic","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-18T18:51:39.345459861+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-19T14:34:58.765114612+07:00","closed_at":"2026-03-19T14:34:58.765114612+07:00","close_reason":"All 14 sub-issues complete. Memory leaks fixed, observability added, rake memory:check in place for regression detection.","external_ref":"gh-124","labels":["v0.7.0"]}
@@ -144,5 +144,6 @@
 {"id":"EV-70.9","title":"Strip source strings from Mutation after result creation","description":"Each MutationResult retains its Mutation which holds original_source and mutated_source (full file contents). These are only needed for diff generation in reporters. Compute and cache the diff eagerly, then release the source strings to allow GC. Or store only the diff in MutationResult.","status":"closed","priority":2,"issue_type":"bug","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-18T18:52:08.1904857+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-19T10:31:19.673577645+07:00","closed_at":"2026-03-19T10:31:19.673577645+07:00","close_reason":"Implemented strip_sources! on Mutation (lazy diff caching, nil out source strings after execution). Wired into Runner sequential and parallel paths.","external_ref":"gh-133","labels":["v0.7.0"],"dependencies":[{"issue_id":"EV-70.9","depends_on_id":"EV-70","type":"parent-child","created_at":"0001-01-01T00:00:00Z"}]}
 {"id":"EV-71","title":"Trim MCP tool response to reduce context window usage","description":"The evilution MCP tool returns full JSON report with all killed mutation diffs (~10k tokens). Only survived mutations are actionable. Trim killed/neutral/timed_out/errors detail arrays in MutateTool.call, keeping summary counts and survived details only.","status":"closed","priority":1,"issue_type":"task","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-19T23:23:32.672265145+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-19T23:31:18.511115181+07:00","closed_at":"2026-03-19T23:31:18.511115181+07:00","close_reason":"Trim killed/neutral/timed_out/errors detail arrays from MCP tool response, keeping only summary and survived details","external_ref":"marinazzio/evilution#178"}
 {"id":"EV-72","title":"Add verbosity control to MCP tool response","description":"Add a verbosity parameter (full/summary/minimal) to the MCP tool to control response size. Default to summary for best context efficiency. Full keeps all entries without diffs, summary omits killed/neutral arrays, minimal keeps only summary + survived.","status":"open","priority":3,"issue_type":"feature","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-19T23:41:41.837080367+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-19T23:41:41.837080367+07:00","external_ref":"marinazzio/evilution#179"}
+{"id":"EV-73","title":"Clean up deprecated CLI switches and config options","description":"Remove long-deprecated --diff, --no-coverage flags and coverage config option. GH #176.","status":"closed","priority":2,"issue_type":"task","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-21T00:37:09.266487789+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-21T00:49:24.827479374+07:00","closed_at":"2026-03-21T00:49:24.827479374+07:00","close_reason":"Removed deprecated --diff, --no-coverage CLI flags; removed diff_base, coverage, diff? from Config; removed filter_by_diff from Runner; deleted diff/parser, diff/file_filter, coverage/collector, coverage/test_map and their specs; cleaned up requires. 712 specs passing.","external_ref":"gh-176"}
 {"id":"EV-8","title":"Investigate RSpec state accumulation across mutation runs","description":"RSpec.reset is called between mutations but loaded spec files persist in memory. Long mutation runs may accumulate state from previously loaded specs, potentially causing false positives/negatives. Investigate whether RSpec::Core::Runner.run properly isolates between runs or if additional cleanup is needed.","status":"closed","priority":2,"issue_type":"bug","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-02T16:21:48.618669476+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-05T11:57:56.965910759+07:00","closed_at":"2026-03-05T11:57:56.965910759+07:00","close_reason":"Investigation complete: fork isolation already prevents state accumulation. Added documentation explaining the guarantee and tests verifying independent consecutive runs."}
 {"id":"EV-9","title":"Add multi-Ruby CI test matrix (3.2, 3.3, 4.0)","description":"CI currently only tests Ruby 4.0.1. Add a matrix strategy testing Ruby 3.2, 3.3, and 4.0 to ensure compatibility across supported Ruby versions. Prism ships with Ruby 3.3+ so 3.2 may need the prism gem as a dependency.","status":"closed","priority":2,"issue_type":"task","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-02T16:21:51.239774764+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-05T12:31:51.83181612+07:00","closed_at":"2026-03-05T12:31:51.83181612+07:00","close_reason":"Closed"}

data/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## [0.10.0] - 2026-03-21
+
+### Added
+
+- **SendMutation operator** — new mutation operator that replaces method calls with semantically related alternatives (e.g. `detect` ↔ `find`, `map` ↔ `flat_map`, `length` ↔ `size`, `gsub` ↔ `sub`, `send` ↔ `public_send`, and more); 17 replacement pairs covering common Ruby method families
+- **ArgumentNilSubstitution operator** — new mutation operator that replaces each positional argument with `nil` one at a time (e.g. `foo(a, b)` → `foo(nil, b)`, `foo(a, nil)`); skips splat, keyword, block, and forwarding arguments
+- **HTML report** (`--format html`) — self-contained HTML mutation report with dark theme, color-coded mutation map, survived mutation diffs with suggestions, and score badge; written to `evilution-report.html`
+- **Equivalent mutation detection** — automatically identifies mutations that produce semantically identical behavior using four heuristics: noop source (identical before/after), method body nil (empty/nil methods), alias swap (detect↔find, length↔size, collect↔map), and dead code (unreachable statements after return/raise); equivalent mutations are excluded from the mutation score denominator
+- **MCP tool equivalent trimming** — diffs are stripped from equivalent mutation entries in MCP responses alongside killed and neutral entries
+
+### Removed
+
+- **`--diff` CLI flag** — deprecated since v0.2.0; use line-range targeting instead (e.g. `evilution run lib/foo.rb:15-30`)
+- **`--no-coverage` CLI flag** — deprecated since v0.2.0; had no effect
+- **`diff_base` and `coverage` config keys** — no longer recognized in `.evilution.yml`; config file warnings removed
+- **`Diff::Parser` and `Diff::FileFilter` modules** — dead code removed along with specs
+- **`Coverage::Collector` and `Coverage::TestMap` modules** — dead code removed along with specs
+
 ## [0.9.0] - 2026-03-19
 
 ### Added

data/lib/evilution/cli.rb

@@ -106,22 +106,13 @@ module Evilution
     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") { |f| @options[:format] = f.to_sym }
-      opts.on("--diff BASE", "DEPRECATED: Use line-range targeting instead") do |b|
-        warn("Warning: --diff is deprecated and will be removed in a future version. " \
-             "Use line-range targeting instead: evilution run lib/foo.rb:15-30")
-        @options[:diff_base] = b
-      end
+      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("--target METHOD", "Only mutate the named method (e.g. Foo::Bar#calculate)") { |m| @options[:target] = m }
-      opts.on("--no-coverage", "DEPRECATED: Has no effect and will be removed in a future version") do
-        warn("Warning: --no-coverage is deprecated, currently has no effect, and will be removed in a future version.")
-        @options[:coverage] = false
-      end
     end
 
     def add_flag_options(opts)

data/lib/evilution/config.rb

@@ -9,11 +9,9 @@ module Evilution
     DEFAULTS = {
       timeout: 30,
       format: :text,
-      diff_base: nil,
       target: nil,
       min_score: 0.0,
       integration: :rspec,
-      coverage: true,
       verbose: false,
       quiet: false,
       jobs: 1,
@@ -25,14 +23,13 @@ module Evilution
       spec_files: []
     }.freeze
 
-    attr_reader :target_files, :timeout, :format, :diff_base,
-                :target, :min_score, :integration, :coverage, :verbose, :quiet,
+    attr_reader :target_files, :timeout, :format,
+                :target, :min_score, :integration, :verbose, :quiet,
                 :jobs, :fail_fast, :baseline, :isolation, :incremental, :line_ranges, :spec_files
 
     def initialize(**options)
       file_options = options.delete(:skip_config_file) ? {} : load_config_file
       merged = DEFAULTS.merge(file_options).merge(options)
-      warn_removed_options(merged, file_options)
       assign_attributes(merged)
       freeze
     end
@@ -45,8 +42,8 @@ module Evilution
       format == :text
     end
 
-    def diff?
-      !diff_base.nil?
+    def html?
+      format == :html
     end
 
     def line_ranges?
@@ -107,9 +104,6 @@ module Evilution
 
         # Stop after N surviving mutants (default: disabled)
         # fail_fast: 1
-
-        # DEPRECATED: Coverage filtering is deprecated and will be removed
-        # coverage: true
       YAML
     end
 
@@ -130,11 +124,9 @@ module Evilution
       @target_files = Array(merged[:target_files])
       @timeout = merged[:timeout]
       @format = merged[:format].to_sym
-      @diff_base = merged[:diff_base]
       @target = merged[:target]
       @min_score = merged[:min_score].to_f
       @integration = merged[:integration].to_sym
-      @coverage = merged[:coverage]
       @verbose = merged[:verbose]
       @quiet = merged[:quiet]
       @jobs = validate_jobs(merged[:jobs])
@@ -166,18 +158,6 @@ module Evilution
       raise ConfigError, "jobs must be a positive integer, got #{value.inspect}"
     end
 
-    def warn_removed_options(_merged, file_options)
-      if file_options.key?(:coverage)
-        warn("Warning: 'coverage' in config file is deprecated and ignored. " \
-             "This option will be removed in a future version.")
-      end
-
-      return unless file_options[:diff_base]
-
-      warn("Warning: 'diff_base' in config file is deprecated and will be removed in a future version. " \
-           "Use line-range targeting instead: evilution run lib/foo.rb:15-30")
-    end
-
     def load_config_file
       self.class.file_options
     end

data/lib/evilution/equivalent/detector.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+require_relative "heuristic/noop_source"
+require_relative "heuristic/method_body_nil"
+require_relative "heuristic/alias_swap"
+require_relative "heuristic/dead_code"
+
+module Evilution
+  module Equivalent
+    class Detector
+      def initialize(heuristics: nil)
+        @heuristics = heuristics || default_heuristics
+      end
+
+      def call(mutations)
+        equivalent = []
+        remaining = []
+
+        mutations.each do |mutation|
+          if @heuristics.any? { |h| h.match?(mutation) }
+            equivalent << mutation
+          else
+            remaining << mutation
+          end
+        end
+
+        [equivalent, remaining]
+      end
+
+      private
+
+      def default_heuristics
+        [
+          Heuristic::NoopSource.new,
+          Heuristic::MethodBodyNil.new,
+          Heuristic::AliasSwap.new,
+          Heuristic::DeadCode.new
+        ]
+      end
+    end
+  end
+end

data/lib/evilution/equivalent/heuristic/alias_swap.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module Evilution
+  module Equivalent
+    module Heuristic
+      class AliasSwap
+        ALIAS_PAIRS = Set[
+          Set[:detect, :find],
+          Set[:length, :size],
+          Set[:collect, :map]
+        ].freeze
+
+        def match?(mutation)
+          return false unless mutation.operator_name == "send_mutation"
+
+          diff = mutation.diff
+          removed = extract_method(diff, "- ")
+          added = extract_method(diff, "+ ")
+          return false unless removed && added
+
+          pair = Set[removed.to_sym, added.to_sym]
+          ALIAS_PAIRS.include?(pair)
+        end
+
+        private
+
+        def extract_method(diff, prefix)
+          line = diff.split("\n").find { |l| l.start_with?(prefix) }
+          return nil unless line
+
+          match = line.match(/\.(\w+)(?:[\s(]|$)/)
+          match && match[1]
+        end
+      end
+    end
+  end
+end

data/lib/evilution/equivalent/heuristic/dead_code.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+module Evilution
+  module Equivalent
+    module Heuristic
+      class DeadCode
+        def match?(mutation)
+          return false unless mutation.operator_name == "statement_deletion"
+
+          node = mutation.subject.node
+          return false unless node
+
+          body = node.body
+          return false unless body.is_a?(Prism::StatementsNode)
+
+          statements = body.body
+          unreachable_lines = find_unreachable_lines(statements)
+          unreachable_lines.include?(mutation.line)
+        end
+
+        private
+
+        def find_unreachable_lines(statements)
+          lines = Set.new
+          found_unconditional_return = false
+
+          statements.each do |stmt|
+            if found_unconditional_return
+              collect_lines(stmt, lines)
+            elsif unconditional_return?(stmt)
+              found_unconditional_return = true
+            end
+          end
+
+          lines
+        end
+
+        def unconditional_return?(node)
+          node.is_a?(Prism::ReturnNode) ||
+            (node.is_a?(Prism::CallNode) && node.name == :raise)
+        end
+
+        def collect_lines(node, lines)
+          start_line = node.location.start_line
+          end_line = node.location.end_line
+          (start_line..end_line).each { |l| lines.add(l) }
+        end
+      end
+    end
+  end
+end

data/lib/evilution/equivalent/heuristic/method_body_nil.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Evilution
+  module Equivalent
+    module Heuristic
+      class MethodBodyNil
+        def match?(mutation)
+          return false unless mutation.operator_name == "method_body_replacement"
+
+          node = mutation.subject.node
+          return false unless node
+
+          body = node.body
+          return true if body.nil? || body.is_a?(Prism::NilNode)
+
+          return body.body.first.is_a?(Prism::NilNode) if body.is_a?(Prism::StatementsNode) && body.body.length == 1
+
+          false
+        end
+      end
+    end
+  end
+end

data/lib/evilution/equivalent/heuristic/noop_source.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Evilution
+  module Equivalent
+    module Heuristic
+      class NoopSource
+        def match?(mutation)
+          mutation.original_source == mutation.mutated_source
+        end
+      end
+    end
+  end
+end

data/lib/evilution/mcp/mutate_tool.rb

@@ -103,6 +103,7 @@ module Evilution
           data = ::JSON.parse(json_string)
           strip_diffs(data, "killed")
           strip_diffs(data, "neutral")
+          strip_diffs(data, "equivalent")
           ::JSON.generate(data)
         end
 

data/lib/evilution/mutator/operator/argument_nil_substitution.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+module Evilution
+  module Mutator
+    module Operator
+      class ArgumentNilSubstitution < Base
+        SKIP_TYPES = [
+          Prism::SplatNode,
+          Prism::KeywordHashNode,
+          Prism::BlockArgumentNode,
+          Prism::ForwardingArgumentsNode
+        ].freeze
+
+        def visit_call_node(node)
+          args = node.arguments&.arguments
+
+          if args && args.length >= 1 && positional_only?(args)
+            args.each_index do |i|
+              parts = args.each_with_index.map { |a, j| j == i ? "nil" : a.slice }
+              replacement = parts.join(", ")
+
+              add_mutation(
+                offset: node.arguments.location.start_offset,
+                length: node.arguments.location.length,
+                replacement: replacement,
+                node: node
+              )
+            end
+          end
+
+          super
+        end
+
+        private
+
+        def positional_only?(args)
+          args.none? { |arg| SKIP_TYPES.any? { |type| arg.is_a?(type) } }
+        end
+      end
+    end
+  end
+end

data/lib/evilution/mutator/operator/send_mutation.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+module Evilution
+  module Mutator
+    module Operator
+      class SendMutation < Base
+        REPLACEMENTS = {
+          flat_map: [:map],
+          map: [:flat_map],
+          collect: [:map],
+          public_send: [:send],
+          send: [:public_send],
+          gsub: [:sub],
+          sub: [:gsub],
+          detect: [:find],
+          find: [:detect],
+          each_with_object: [:inject],
+          inject: [:each_with_object],
+          reverse_each: [:each],
+          each: [:reverse_each],
+          length: [:size],
+          size: [:length],
+          values_at: [:fetch_values],
+          fetch_values: [:values_at]
+        }.freeze
+
+        def visit_call_node(node)
+          replacements = REPLACEMENTS[node.name]
+          return super unless replacements
+          return super unless node.receiver
+
+          loc = node.message_loc
+          return super unless loc
+
+          replacements.each do |replacement|
+            add_mutation(
+              offset: loc.start_offset,
+              length: loc.length,
+              replacement: replacement.to_s,
+              node: node
+            )
+          end
+
+          super
+        end
+      end
+    end
+  end
+end

data/lib/evilution/mutator/registry.rb

@@ -30,7 +30,9 @@ module Evilution
           Operator::ConditionalFlip,
           Operator::RangeReplacement,
           Operator::RegexpMutation,
-          Operator::ReceiverReplacement
+          Operator::ReceiverReplacement,
+          Operator::SendMutation,
+          Operator::ArgumentNilSubstitution
         ].each { |op| registry.register(op) }
         registry
       end

data/lib/evilution/reporter/cli.rb

@@ -17,6 +17,7 @@ module Evilution
         lines << peak_memory_line(peak) if peak
         append_survived(lines, summary)
         append_neutral(lines, summary)
+        append_equivalent(lines, summary)
         lines << ""
         lines << "[TRUNCATED] Stopped early due to --fail-fast" if summary.truncated?
         lines << result_line(summary)
@@ -42,6 +43,14 @@ module Evilution
         summary.neutral_results.each { |result| lines << format_neutral(result) }
       end
 
+      def append_equivalent(lines, summary)
+        return unless summary.equivalent_results.any?
+
+        lines << ""
+        lines << "Equivalent mutations (provably identical behavior):"
+        summary.equivalent_results.each { |result| lines << format_neutral(result) }
+      end
+
       def header
         "Evilution v#{Evilution::VERSION} — Mutation Testing Results"
       end
@@ -50,11 +59,12 @@ module Evilution
         parts = "Mutations: #{summary.total} total, #{summary.killed} killed, " \
                 "#{summary.survived} survived, #{summary.timed_out} timed out"
         parts += ", #{summary.neutral} neutral" if summary.neutral.positive?
+        parts += ", #{summary.equivalent} equivalent" if summary.equivalent.positive?
         parts
       end
 
       def score_line(summary)
-        denominator = summary.total - summary.errors - summary.neutral
+        denominator = summary.total - summary.errors - summary.neutral - summary.equivalent
         score_pct = format_pct(summary.score)
         "Score: #{score_pct} (#{summary.killed}/#{denominator})"
       end

data/lib/evilution/reporter/html.rb

@@ -0,0 +1,252 @@
+# frozen_string_literal: true
+
+require "cgi"
+require_relative "suggestion"
+
+module Evilution
+  module Reporter
+    class HTML # rubocop:disable Metrics/ClassLength
+      def initialize
+        @suggestion = Suggestion.new
+      end
+
+      def call(summary)
+        files = group_by_file(summary.results)
+        build_html(summary, files)
+      end
+
+      private
+
+      def group_by_file(results)
+        grouped = {}
+        results.each do |result|
+          path = result.mutation.file_path
+          grouped[path] ||= []
+          grouped[path] << result
+        end
+        grouped.sort_by { |path, _| path }.to_h
+      end
+
+      def build_html(summary, files)
+        <<~HTML
+          <!DOCTYPE html>
+          <html lang="en">
+          <head>
+            <meta charset="UTF-8">
+            <meta name="viewport" content="width=device-width, initial-scale=1.0">
+            <title>Evilution Mutation Report</title>
+            #{stylesheet}
+          </head>
+          <body>
+            #{build_header(summary)}
+            #{build_summary_cards(summary)}
+            #{build_truncation_notice(summary)}
+            #{build_file_sections(files)}
+            #{build_footer}
+          </body>
+          </html>
+        HTML
+      end
+
+      def build_header(summary)
+        score_pct = format("%.2f%%", summary.score * 100)
+        score_class = score_css_class(summary.score)
+        <<~HTML
+          <header>
+            <h1>Evilution <span class="version">v#{h(Evilution::VERSION)}</span></h1>
+            <div class="score-badge #{score_class}">#{score_pct}</div>
+          </header>
+        HTML
+      end
+
+      def build_summary_cards(summary)
+        peak = summary.peak_memory_mb
+        peak_html = if peak
+                      peak_val = format("%.1f", peak)
+                      "<div class=\"card\"><span class=\"card-value\">#{peak_val} MB</span>" \
+                        "<span class=\"card-label\">Peak Memory</span></div>"
+                    else
+                      ""
+                    end
+        <<~HTML
+          <section class="summary-cards">
+            <div class="card"><span class="card-value">#{summary.total}</span><span class="card-label">Total</span></div>
+            <div class="card card-killed"><span class="card-value">#{summary.killed}</span><span class="card-label">Killed</span></div>
+            <div class="card card-survived"><span class="card-value">#{summary.survived}</span><span class="card-label">Survived</span></div>
+            <div class="card"><span class="card-value">#{summary.timed_out}</span><span class="card-label">Timed Out</span></div>
+            <div class="card"><span class="card-value">#{summary.errors}</span><span class="card-label">Errors</span></div>
+            <div class="card"><span class="card-value">#{summary.neutral}</span><span class="card-label">Neutral</span></div>
+            <div class="card"><span class="card-value">#{summary.equivalent}</span><span class="card-label">Equivalent</span></div>
+            <div class="card"><span class="card-value">#{format("%.2f", summary.duration)}s</span><span class="card-label">Duration</span></div>
+            #{peak_html}
+          </section>
+        HTML
+      end
+
+      def build_truncation_notice(summary)
+        return "" unless summary.truncated?
+
+        '<div class="truncation-notice">Truncated: Stopped early due to --fail-fast</div>'
+      end
+
+      def build_file_sections(files)
+        return '<p class="empty">No mutations generated.</p>' if files.empty?
+
+        files.map { |path, results| build_file_section(path, results) }.join("\n")
+      end
+
+      def build_file_section(path, results)
+        killed_count = results.count(&:killed?)
+        survived_count = results.count(&:survived?)
+        total = results.length
+        survived = results.select(&:survived?)
+        map_html = build_mutation_map(results)
+
+        <<~HTML
+          <section class="file-section">
+            <h2 class="file-header">
+              <span class="file-path">#{h(path)}</span>
+              <span class="file-stats">#{killed_count} killed / #{survived_count} survived / #{total} total</span>
+            </h2>
+            <div class="mutation-map">#{map_html}</div>
+            #{build_survived_details(survived)}
+          </section>
+        HTML
+      end
+
+      def build_mutation_map(results)
+        results
+          .sort_by { |r| r.mutation.line }
+          .map { |r| build_map_entry(r) }
+          .join("\n")
+      end
+
+      def build_map_entry(result)
+        mutation = result.mutation
+        status = result.status.to_s
+        <<~HTML.chomp
+          <div class="map-line #{status}">
+            <span class="line-number">line #{mutation.line}</span>
+            <span class="operator">#{h(mutation.operator_name)}</span>
+            <span class="status-badge #{status}">#{status}</span>
+          </div>
+        HTML
+      end
+
+      def build_survived_details(survived)
+        return "" if survived.empty?
+
+        entries = survived.map { |r| build_survived_entry(r) }.join("\n")
+        <<~HTML
+          <div class="survived-details">
+            <h3>Survived Mutations</h3>
+            #{entries}
+          </div>
+        HTML
+      end
+
+      def build_survived_entry(result)
+        mutation = result.mutation
+        suggestion_text = @suggestion.suggestion_for(mutation)
+        diff_html = format_diff(mutation.diff)
+        <<~HTML
+          <div class="survived-entry">
+            <div class="survived-header">
+              <span class="operator">#{h(mutation.operator_name)}</span>
+              <span class="location">#{h(mutation.file_path)}:#{mutation.line}</span>
+            </div>
+            <pre class="diff">#{diff_html}</pre>
+            <div class="suggestion">#{h(suggestion_text)}</div>
+          </div>
+        HTML
+      end
+
+      def format_diff(diff)
+        diff.split("\n").map do |line|
+          escaped = h(line)
+          css_class = if line.start_with?("- ")
+                        "diff-removed"
+                      elsif line.start_with?("+ ")
+                        "diff-added"
+                      else
+                        ""
+                      end
+          %(<span class="#{css_class}">#{escaped}</span>)
+        end.join("\n")
+      end
+
+      def build_footer
+        "<footer>Generated by Evilution v#{h(Evilution::VERSION)}</footer>"
+      end
+
+      def score_css_class(score)
+        if score >= 0.8
+          "score-high"
+        elsif score >= 0.5
+          "score-medium"
+        else
+          "score-low"
+        end
+      end
+
+      def h(text)
+        CGI.escapeHTML(text.to_s)
+      end
+
+      def stylesheet
+        <<~HTML
+          <style>
+            * { margin: 0; padding: 0; box-sizing: border-box; }
+            body { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif; background: #0d1117; color: #c9d1d9; padding: 2rem; max-width: 1200px; margin: 0 auto; }
+            header { display: flex; justify-content: space-between; align-items: center; margin-bottom: 2rem; }
+            h1 { font-size: 1.5rem; color: #f0f6fc; }
+            .version { color: #8b949e; font-weight: normal; font-size: 0.9rem; }
+            .score-badge { font-size: 1.8rem; font-weight: bold; padding: 0.3rem 1rem; border-radius: 8px; }
+            .score-high { background: #1a4731; color: #3fb950; }
+            .score-medium { background: #4a3a10; color: #d29922; }
+            .score-low { background: #4a1a1a; color: #f85149; }
+            .summary-cards { display: flex; gap: 1rem; flex-wrap: wrap; margin-bottom: 2rem; }
+            .card { background: #161b22; border: 1px solid #30363d; border-radius: 8px; padding: 1rem 1.2rem; text-align: center; min-width: 100px; }
+            .card-value { display: block; font-size: 1.4rem; font-weight: bold; color: #f0f6fc; }
+            .card-label { display: block; font-size: 0.75rem; color: #8b949e; margin-top: 0.2rem; text-transform: uppercase; }
+            .card-killed { border-color: #238636; }
+            .card-survived { border-color: #da3633; }
+            .truncation-notice { background: #4a3a10; border: 1px solid #d29922; color: #d29922; padding: 0.75rem 1rem; border-radius: 8px; margin-bottom: 2rem; }
+            .file-section { background: #161b22; border: 1px solid #30363d; border-radius: 8px; margin-bottom: 1.5rem; overflow: hidden; }
+            .file-header { display: flex; justify-content: space-between; align-items: center; padding: 0.75rem 1rem; background: #1c2129; border-bottom: 1px solid #30363d; font-size: 0.9rem; }
+            .file-path { color: #58a6ff; font-family: monospace; }
+            .file-stats { color: #8b949e; font-size: 0.8rem; font-weight: normal; }
+            .mutation-map { padding: 0.5rem 1rem; }
+            .map-line { display: flex; align-items: center; gap: 0.75rem; padding: 0.25rem 0.5rem; border-radius: 4px; font-size: 0.85rem; font-family: monospace; }
+            .map-line.killed { color: #3fb950; }
+            .map-line.survived { color: #f85149; }
+            .map-line.timeout { color: #d29922; }
+            .map-line.error { color: #f85149; }
+            .map-line.neutral { color: #8b949e; }
+            .map-line.equivalent { color: #8b949e; }
+            .line-number { min-width: 60px; color: #8b949e; }
+            .operator { flex: 1; }
+            .status-badge { font-size: 0.7rem; padding: 0.1rem 0.5rem; border-radius: 10px; text-transform: uppercase; font-weight: bold; }
+            .status-badge.killed { background: #1a4731; }
+            .status-badge.survived { background: #4a1a1a; }
+            .status-badge.timeout { background: #4a3a10; }
+            .status-badge.neutral { background: #21262d; }
+            .status-badge.equivalent { background: #21262d; }
+            .survived-details { border-top: 1px solid #30363d; padding: 1rem; }
+            .survived-details h3 { color: #f85149; font-size: 0.9rem; margin-bottom: 0.75rem; }
+            .survived-entry { background: #1c1a1a; border: 1px solid #4a1a1a; border-radius: 6px; padding: 0.75rem; margin-bottom: 0.75rem; }
+            .survived-header { display: flex; justify-content: space-between; margin-bottom: 0.5rem; font-size: 0.85rem; }
+            .survived-header .operator { color: #f85149; font-weight: bold; }
+            .survived-header .location { color: #8b949e; font-family: monospace; }
+            .diff { background: #0d1117; border-radius: 4px; padding: 0.5rem 0.75rem; font-size: 0.8rem; overflow-x: auto; line-height: 1.5; }
+            .diff-removed { color: #f85149; display: block; }
+            .diff-added { color: #3fb950; display: block; }
+            .suggestion { color: #d29922; font-size: 0.8rem; margin-top: 0.5rem; font-style: italic; }
+            .empty { color: #8b949e; text-align: center; padding: 2rem; }
+            footer { text-align: center; color: #484f58; font-size: 0.75rem; margin-top: 2rem; padding-top: 1rem; border-top: 1px solid #21262d; }
+          </style>
+        HTML
+      end
+    end
+  end
+end

data/lib/evilution/reporter/json.rb

@@ -17,6 +17,7 @@ module Evilution
 
       private
 
+      # rubocop:disable Metrics/PerceivedComplexity
       def build_report(summary)
         {
           version: Evilution::VERSION,
@@ -26,9 +27,11 @@ module Evilution
           killed: summary.killed_results.map { |r| build_mutation_detail(r) },
           neutral: summary.neutral_results.map { |r| build_mutation_detail(r) },
           timed_out: summary.results.select(&:timeout?).map { |r| build_mutation_detail(r) },
-          errors: summary.results.select(&:error?).map { |r| build_mutation_detail(r) }
+          errors: summary.results.select(&:error?).map { |r| build_mutation_detail(r) },
+          equivalent: summary.equivalent_results.map { |r| build_mutation_detail(r) }
         }
       end
+      # rubocop:enable Metrics/PerceivedComplexity
 
       def build_summary(summary)
         data = {
@@ -38,6 +41,7 @@ module Evilution
           timed_out: summary.timed_out,
           errors: summary.errors,
           neutral: summary.neutral,
+          equivalent: summary.equivalent,
           score: summary.score.round(4),
           duration: summary.duration.round(4)
         }

data/lib/evilution/result/mutation_result.rb

@@ -3,7 +3,7 @@
 module Evilution
   module Result
     class MutationResult
-      STATUSES = %i[killed survived timeout error neutral].freeze
+      STATUSES = %i[killed survived timeout error neutral equivalent].freeze
 
       attr_reader :mutation, :status, :duration, :killing_test, :test_command,
                   :child_rss_kb, :memory_delta_kb
@@ -41,6 +41,10 @@ module Evilution
       def neutral?
         status == :neutral
       end
+
+      def equivalent?
+        status == :equivalent
+      end
     end
   end
 end

data/lib/evilution/result/summary.rb

@@ -40,8 +40,12 @@ module Evilution
         results.count(&:neutral?)
       end
 
+      def equivalent
+        results.count(&:equivalent?)
+      end
+
       def score
-        denominator = total - errors - neutral
+        denominator = total - errors - neutral - equivalent
         return 0.0 if denominator.zero?
 
         killed.to_f / denominator
@@ -63,6 +67,10 @@ module Evilution
         results.select(&:neutral?)
       end
 
+      def equivalent_results
+        results.select(&:equivalent?)
+      end
+
       def peak_memory_mb
         max_rss = nil
         results.each do |result|

data/lib/evilution/runner.rb

@@ -9,9 +9,9 @@ require_relative "isolation/in_process"
 require_relative "integration/rspec"
 require_relative "reporter/json"
 require_relative "reporter/cli"
+require_relative "reporter/html"
 require_relative "reporter/suggestion"
-require_relative "diff/parser"
-require_relative "diff/file_filter"
+require_relative "equivalent/detector"
 require_relative "git/changed_files"
 require_relative "result/mutation_result"
 require_relative "result/summary"
@@ -37,13 +37,18 @@ module Evilution
       subjects = parse_subjects
       subjects = filter_by_target(subjects) if config.target?
       subjects = filter_by_line_ranges(subjects) if config.line_ranges?
-      subjects = filter_by_diff(subjects) if config.diff?
       log_memory("after parse_subjects", "#{subjects.length} subjects")
 
       baseline_result = run_baseline(subjects)
 
       mutations = generate_mutations(subjects)
+      equivalent_mutations, mutations = filter_equivalent(mutations)
+      release_subject_nodes(subjects)
       results, truncated = run_mutations(mutations, baseline_result)
+      results += equivalent_mutations.map do |m|
+        m.strip_sources!
+        equivalent_result(m)
+      end
       log_memory("after run_mutations", "#{results.length} results")
 
       duration = Process.clock_gettime(Process::CLOCK_MONOTONIC) - start_time
@@ -91,20 +96,24 @@ module Evilution
       end
     end
 
-    def filter_by_diff(subjects)
-      diff_parser = Diff::Parser.new
-      changed_ranges = diff_parser.parse(config.diff_base)
-      Diff::FileFilter.new.filter(subjects, changed_ranges)
-    end
-
     def generate_mutations(subjects)
       subjects.flat_map do |subject|
-        mutations = registry.mutations_for(subject)
-        subject.release_node!
-        mutations
+        registry.mutations_for(subject)
       end
     end
 
+    def filter_equivalent(mutations)
+      Equivalent::Detector.new.call(mutations)
+    end
+
+    def release_subject_nodes(subjects)
+      subjects.each(&:release_node!)
+    end
+
+    def equivalent_result(mutation)
+      Result::MutationResult.new(mutation: mutation, status: :equivalent, duration: 0.0)
+    end
+
     def run_baseline(subjects)
       return nil unless config.baseline? && subjects.any?
 
@@ -281,7 +290,15 @@ module Evilution
       return unless reporter
 
       output = reporter.call(summary)
-      $stdout.puts(output) unless config.quiet
+      return if config.quiet
+
+      if config.html?
+        path = "evilution-report.html"
+        File.write(path, output)
+        warn "HTML report written to #{path}"
+      else
+        $stdout.puts(output)
+      end
     end
 
     def log_baseline_start
@@ -350,6 +367,8 @@ module Evilution
         Reporter::JSON.new
       when :text
         Reporter::CLI.new
+      when :html
+        Reporter::HTML.new
       end
     end
 

data/lib/evilution/version.rb

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

data/lib/evilution.rb

@@ -33,12 +33,13 @@ require_relative "evilution/mutator/operator/conditional_flip"
 require_relative "evilution/mutator/operator/range_replacement"
 require_relative "evilution/mutator/operator/regexp_mutation"
 require_relative "evilution/mutator/operator/receiver_replacement"
+require_relative "evilution/mutator/operator/send_mutation"
+require_relative "evilution/mutator/operator/argument_nil_substitution"
 require_relative "evilution/mutator/registry"
+require_relative "evilution/equivalent/detector"
 require_relative "evilution/isolation/fork"
 require_relative "evilution/isolation/in_process"
 require_relative "evilution/parallel/pool"
-require_relative "evilution/diff/parser"
-require_relative "evilution/diff/file_filter"
 require_relative "evilution/git/changed_files"
 require_relative "evilution/integration/base"
 require_relative "evilution/integration/rspec"
@@ -46,9 +47,8 @@ require_relative "evilution/result/mutation_result"
 require_relative "evilution/result/summary"
 require_relative "evilution/reporter/json"
 require_relative "evilution/reporter/cli"
+require_relative "evilution/reporter/html"
 require_relative "evilution/reporter/suggestion"
-require_relative "evilution/coverage/collector"
-require_relative "evilution/coverage/test_map"
 require_relative "evilution/spec_resolver"
 require_relative "evilution/baseline"
 require_relative "evilution/cache"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: evilution
 version: !ruby/object:Gem::Version
-  version: 0.9.0
+  version: 0.10.0
 platform: ruby
 authors:
 - Denis Kiselev
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-03-19 00:00:00.000000000 Z
+date: 2026-03-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: diff-lcs
@@ -84,10 +84,11 @@ files:
 - lib/evilution/cache.rb
 - lib/evilution/cli.rb
 - lib/evilution/config.rb
-- lib/evilution/coverage/collector.rb
-- lib/evilution/coverage/test_map.rb
-- lib/evilution/diff/file_filter.rb
-- lib/evilution/diff/parser.rb
+- lib/evilution/equivalent/detector.rb
+- lib/evilution/equivalent/heuristic/alias_swap.rb
+- lib/evilution/equivalent/heuristic/dead_code.rb
+- lib/evilution/equivalent/heuristic/method_body_nil.rb
+- lib/evilution/equivalent/heuristic/noop_source.rb
 - lib/evilution/git/changed_files.rb
 - lib/evilution/integration/base.rb
 - lib/evilution/integration/rspec.rb
@@ -99,6 +100,7 @@ files:
 - lib/evilution/memory/leak_check.rb
 - lib/evilution/mutation.rb
 - lib/evilution/mutator/base.rb
+- lib/evilution/mutator/operator/argument_nil_substitution.rb
 - lib/evilution/mutator/operator/argument_removal.rb
 - lib/evilution/mutator/operator/arithmetic_replacement.rb
 - lib/evilution/mutator/operator/array_literal.rb
@@ -121,12 +123,14 @@ files:
 - lib/evilution/mutator/operator/receiver_replacement.rb
 - lib/evilution/mutator/operator/regexp_mutation.rb
 - lib/evilution/mutator/operator/return_value_removal.rb
+- lib/evilution/mutator/operator/send_mutation.rb
 - lib/evilution/mutator/operator/statement_deletion.rb
 - lib/evilution/mutator/operator/string_literal.rb
 - lib/evilution/mutator/operator/symbol_literal.rb
 - lib/evilution/mutator/registry.rb
 - lib/evilution/parallel/pool.rb
 - lib/evilution/reporter/cli.rb
+- lib/evilution/reporter/html.rb
 - lib/evilution/reporter/json.rb
 - lib/evilution/reporter/suggestion.rb
 - lib/evilution/result/mutation_result.rb

data/lib/evilution/coverage/collector.rb

@@ -1,47 +0,0 @@
-# frozen_string_literal: true
-
-require "coverage"
-require "stringio"
-
-module Evilution
-  module Coverage
-    class Collector
-      def call(test_files:)
-        read_io, write_io = IO.pipe
-
-        pid = ::Process.fork do
-          read_io.close
-          result = collect_coverage(test_files)
-          Marshal.dump(result, write_io)
-          write_io.close
-          exit!(0)
-        end
-
-        write_io.close
-        data = read_io.read
-        read_io.close
-        ::Process.wait(pid)
-
-        Marshal.load(data) # rubocop:disable Security/MarshalLoad
-      ensure
-        read_io&.close
-        write_io&.close
-      end
-
-      private
-
-      def collect_coverage(test_files)
-        ::Coverage.start
-        return ::Coverage.result if test_files.empty?
-
-        require "rspec/core"
-        ::RSpec.reset
-        ::RSpec::Core::Runner.run(
-          ["--format", "progress", "--no-color", "--order", "defined", *test_files],
-          StringIO.new, StringIO.new
-        )
-        ::Coverage.result
-      end
-    end
-  end
-end

data/lib/evilution/coverage/test_map.rb

@@ -1,25 +0,0 @@
-# frozen_string_literal: true
-
-module Evilution
-  module Coverage
-    class TestMap
-      def initialize(coverage_data)
-        @coverage_data = coverage_data
-      end
-
-      # Returns true if the given source line was executed during tests.
-      # file_path should be an absolute path matching coverage data keys.
-      # line is 1-based (editor line numbers).
-      def covered?(file_path, line)
-        line_data = @coverage_data[file_path]
-        return false unless line_data
-
-        index = line - 1
-        return false if index.negative? || index >= line_data.length
-
-        count = line_data[index]
-        !count.nil? && count.positive?
-      end
-    end
-  end
-end

data/lib/evilution/diff/file_filter.rb

@@ -1,29 +0,0 @@
-# frozen_string_literal: true
-
-module Evilution
-  module Diff
-    class FileFilter
-      # Filters subjects to only those whose methods overlap with changed lines.
-      #
-      # @param subjects [Array<Subject>] All extracted subjects
-      # @param changed_ranges [Array<Hash>] Output from Diff::Parser#parse
-      # @return [Array<Subject>] Subjects overlapping with changes
-      def filter(subjects, changed_ranges)
-        lookup = build_lookup(changed_ranges)
-
-        subjects.select do |subject|
-          ranges = lookup[subject.file_path]
-          next false unless ranges
-
-          ranges.any? { |range| range.cover?(subject.line_number) }
-        end
-      end
-
-      private
-
-      def build_lookup(changed_ranges)
-        changed_ranges.to_h { [_1[:file], _1[:lines]] }
-      end
-    end
-  end
-end

data/lib/evilution/diff/parser.rb

@@ -1,47 +0,0 @@
-# frozen_string_literal: true
-
-module Evilution
-  module Diff
-    class Parser
-      # Parses git diff output to extract changed file paths and line ranges.
-      #
-      # @param diff_base [String] Git ref to diff against (e.g., "HEAD~1", "main")
-      # @return [Array<Hash>] Array of { file: String, lines: Array<Range> }
-      def parse(diff_base)
-        output = run_git_diff(diff_base)
-        parse_diff_output(output)
-      end
-
-      private
-
-      def run_git_diff(diff_base)
-        `git diff --unified=0 #{diff_base}..HEAD -- '*.rb' 2>/dev/null`
-      end
-
-      def parse_diff_output(output)
-        result = {}
-        current_file = nil
-
-        output.each_line do |line|
-          case line
-          when %r{^diff --git a/.+ b/(.+)$}
-            current_file = Regexp.last_match(1)
-          when /^@@\s+-\d+(?:,\d+)?\s+\+(\d+)(?:,(\d+))?\s+@@/
-            next unless current_file
-
-            start_line = Regexp.last_match(1).to_i
-            count = (Regexp.last_match(2) || "1").to_i
-
-            next if count.zero? # Pure deletion, no new lines
-
-            end_line = start_line + count - 1
-            result[current_file] ||= []
-            result[current_file] << (start_line..end_line)
-          end
-        end
-
-        result.map { |file, lines| { file: file, lines: lines } }
-      end
-    end
-  end
-end