evilution 0.8.0 → 0.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 134f193b4bce22007d6af782bd885129aafb9104a763cfec5e9a70c322be25ec
-  data.tar.gz: 7031e18d9eacd96886200b1c598b346d4256177045c7d639c54c3020c3f61f63
+  metadata.gz: bd6e8e6df2bd5ec7096d3d8ddf35106323f25fab3a7e0aa0ad215aab2081a43d
+  data.tar.gz: 3178e1d157672ad425758e9122b7c151e899ea561af9a00b0e40d6f899b97bbd
 SHA512:
-  metadata.gz: ab72d51bfae90aca49ccca456a4d576a3caf30ceaa6c1d51b6f489548458f56cf86c7038fd9bfb69aa7452fe4ec81efbebbddaf0e4e5961f82262f31bc501690
-  data.tar.gz: 3ca5fa2951e70df43e4e56b611115ae1d4c2611132c53e5a26af92a90737be231a0bb3c62d3bab7444fc0de22f1210284ec8365d7134353eddf550ddbb417522
+  metadata.gz: 178f85a6accb6c0e5a844e2b3b749909b9ee1f68a7e660fe88a79eeb8624cd6a6b7112443fc35ac9a0d1401477fd986b51d4b7055be654443f1f5e0da2626cf1
+  data.tar.gz: 0f5f209a4073f8de346baf2252f318dbefd40609eb163e2cd17b8339c311cfe2b520e53c23ac9d97de009a3788af7f0618a3d870afc76aeb6185374441c0275d

data/.beads/.migration-hint-ts

@@ -1 +1 @@
-1773850606
+1773937412

data/.beads/issues.jsonl

@@ -101,8 +101,15 @@
 {"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-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":"open","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-19T15:45:33.9293301+07:00","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-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"}]}
+{"id":"EV-54.1","title":"Add nil variants to literal operators","description":"Add nil as a mutation variant to IntegerLiteral, FloatLiteral, StringLiteral, BooleanLiteralReplacement, ArrayLiteral, HashLiteral, and SymbolLiteral operators. Nil-safety is one of the most common sources of production bugs in Ruby, making this the highest-ROI expansion.","status":"open","priority":2,"issue_type":"task","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-19T21:21:06.464726693+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-19T21:22:01.743744776+07:00","external_ref":"gh-167","dependencies":[{"issue_id":"EV-54.1","depends_on_id":"EV-54","type":"parent-child","created_at":"0001-01-01T00:00:00Z"}]}
+{"id":"EV-54.2","title":"Expand NilReplacement with false, 0, and empty string variants","description":"Currently nil only mutates to true. Add false, 0, and empty string variants since nil is commonly used in boolean, numeric, and string contexts.","status":"open","priority":2,"issue_type":"task","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-19T21:21:20.731673229+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-19T21:22:01.844521612+07:00","external_ref":"gh-168","dependencies":[{"issue_id":"EV-54.2","depends_on_id":"EV-54","type":"parent-child","created_at":"0001-01-01T00:00:00Z"}]}
+{"id":"EV-54.3","title":"Expand CollectionReplacement with more method swaps","description":"Add sort↔sort_by, find↔detect, any?↔all?, count↔length swaps. These are very common collection methods with subtle behavioral differences.","status":"open","priority":3,"issue_type":"task","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-19T21:21:20.842448904+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-19T21:22:01.9421689+07:00","external_ref":"gh-169","dependencies":[{"issue_id":"EV-54.3","depends_on_id":"EV-54","type":"parent-child","created_at":"0001-01-01T00:00:00Z"}]}
+{"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-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"}
@@ -113,9 +120,9 @@
 {"id":"EV-61","title":"Concrete suggestions: Nil operator","description":"Generate concrete RSpec it block for NilReplacement mutations. Test should assert non-nil return value.","status":"open","priority":3,"issue_type":"feature","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-17T09:58:33.882878252+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-17T09:58:33.882878252+07:00"}
 {"id":"EV-62","title":"Neutral mutation detection","description":"Run the original unmutated code once before mutation testing. Flag any tests that already fail, so surviving mutants caused by pre-broken tests are reported as neutral rather than gaps. Eliminates false positives in mutation score.","status":"closed","priority":2,"issue_type":"feature","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-17T10:15:03.670730866+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-17T23:16:28.920679692+07:00","closed_at":"2026-03-17T23:16:28.920679692+07:00","close_reason":"Merged"}
 {"id":"EV-63","title":"In-process mutation for performance","description":"Replace fork+file-write isolation with in-memory mutation (constant replacement or load-path override) for the common case. Current approach: 3.0 mutations/s vs mutant's 17.6 mutations/s (6x slower). Fork overhead is the main bottleneck. Keep fork as fallback for safety.","status":"closed","priority":2,"issue_type":"feature","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-17T10:15:03.765021194+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-18T18:31:15.344270883+07:00","closed_at":"2026-03-18T18:31:15.344270883+07:00","close_reason":"GH issue #114 closed, PR #123 merged"}
-{"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":"open","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-17T10:15:03.858147999+07:00"}
-{"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":"open","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-17T10:15:03.95132569+07:00"}
-{"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":"open","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-17T10:15:04.04579177+07:00"}
+{"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-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"}
@@ -135,5 +142,7 @@
 {"id":"EV-70.7","title":"Eliminate double forking in parallel mode","description":"When jobs>1 with auto isolation, Pool already forks workers. Using Isolation::Fork inside each worker creates a redundant second fork. Fix: use in-process isolation inside pool workers (they already have process isolation from the pool fork). This is likely the single biggest contributor to 17 GB memory usage.","status":"closed","priority":1,"issue_type":"bug","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-18T18:52:02.309469841+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-19T00:06:16.517207415+07:00","closed_at":"2026-03-19T00:06:16.517207415+07:00","close_reason":"Eliminated double forking: parallel pool workers now use InProcess isolation since Pool already provides fork-based process isolation. Simplified resolve_isolation to never auto-select Fork.","external_ref":"gh-131","labels":["v0.7.0"],"dependencies":[{"issue_id":"EV-70.7","depends_on_id":"EV-70","type":"parent-child","created_at":"0001-01-01T00:00:00Z"}]}
 {"id":"EV-70.8","title":"Lazy/streaming mutation generation","description":"Currently generate_mutations builds ALL mutations into an array before any are executed (runner.rb:38). For large codebases this holds thousands of Mutation objects (each with 2x full source strings + AST node) in memory simultaneously. Change to lazy enumeration so mutations are generated per-subject as needed.","status":"closed","priority":1,"issue_type":"bug","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-18T18:52:05.552816007+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-19T00:26:32.161184282+07:00","closed_at":"2026-03-19T00:26:32.161184282+07:00","close_reason":"Changed generate_mutations to lazy enumerator (subjects.lazy.flat_map). Mutations generated per-subject on demand, not all materialized upfront. Baseline now receives subjects instead of mutations. Pre-computed mutation_count passed to run methods for progress/fail_fast.","external_ref":"gh-132","labels":["v0.7.0"],"dependencies":[{"issue_id":"EV-70.8","depends_on_id":"EV-70","type":"parent-child","created_at":"0001-01-01T00:00:00Z"}]}
 {"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-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,18 @@
 # Changelog
 
+## [0.9.0] - 2026-03-19
+
+### Added
+
+- **ReceiverReplacement operator** — new mutation operator that drops explicit `self` receiver from method calls (e.g. `self.foo` → `foo`); catches untested self-dispatch semantics
+- **Class-level `--target` filtering** — `--target Foo` now matches all methods in the `Foo` class, not just `Foo#method`; instance method targeting (`Foo#bar`) continues to work as before
+- **Incremental mode** (`--incremental`) — caches killed/timeout results keyed by file content SHA256 + mutation fingerprint; skips re-running unchanged mutations on subsequent runs; atomic file-based cache in `tmp/evilution_cache/`
+- **Scope-aware spec resolution** — `SpecResolver` now walks up the directory tree when an exact spec file isn't found (e.g. `app/models/game/round.rb` → `spec/models/game_spec.rb`); works with both stripped (`spec/`) and kept (`spec/lib/`) layouts
+
+### Changed
+
+- **MCP tool response trimming** — diffs are stripped from killed and neutral mutation entries to reduce context window usage (~36% smaller responses); survived, timed_out, and errors retain full diffs for actionability
+
 ## [0.8.0] - 2026-03-19
 
 ### Added

data/lib/evilution/cache.rb

@@ -0,0 +1,85 @@
+# frozen_string_literal: true
+
+require "digest"
+require "json"
+require "fileutils"
+
+module Evilution
+  class Cache
+    DEFAULT_DIR = "tmp/evilution_cache"
+
+    def initialize(cache_dir: DEFAULT_DIR)
+      @cache_dir = cache_dir
+    end
+
+    def fetch(mutation)
+      return nil if mutation.original_source.nil?
+
+      file_key = file_key(mutation)
+      entry_key = entry_key(mutation)
+      data = read_file(file_key)
+      return nil unless data
+
+      entry = data[entry_key]
+      return nil unless entry.is_a?(Hash) && entry["status"].is_a?(String)
+
+      { status: entry["status"].to_sym, duration: entry["duration"],
+        killing_test: entry["killing_test"], test_command: entry["test_command"] }
+    end
+
+    def store(mutation, result_data)
+      file_key = file_key(mutation)
+      entry_key = entry_key(mutation)
+      data = read_file(file_key) || {}
+
+      data[entry_key] = {
+        "status" => result_data[:status].to_s,
+        "duration" => result_data[:duration],
+        "killing_test" => result_data[:killing_test],
+        "test_command" => result_data[:test_command]
+      }
+
+      write_file(file_key, data)
+    end
+
+    def clear
+      FileUtils.rm_rf(@cache_dir)
+    end
+
+    private
+
+    def file_key(mutation)
+      content_hash = Digest::SHA256.hexdigest(mutation.original_source)
+      "#{safe_filename(mutation.file_path)}_#{content_hash[0, 16]}"
+    end
+
+    def entry_key(mutation)
+      "#{mutation.operator_name}:#{mutation.line}:#{mutation.column}"
+    end
+
+    def safe_filename(path)
+      path.gsub(%r{[/\\]}, "_").gsub(/[^a-zA-Z0-9._-]/, "")
+    end
+
+    def read_file(file_key)
+      path = cache_path(file_key)
+      return nil unless File.exist?(path)
+
+      JSON.parse(File.read(path))
+    rescue JSON::ParserError
+      nil
+    end
+
+    def write_file(file_key, data)
+      FileUtils.mkdir_p(@cache_dir)
+      path = cache_path(file_key)
+      tmp = "#{path}.#{Process.pid}.tmp"
+      File.write(tmp, JSON.generate(data))
+      File.rename(tmp, path)
+    end
+
+    def cache_path(file_key)
+      File.join(@cache_dir, "#{file_key}.json")
+    end
+  end
+end

data/lib/evilution/cli.rb

@@ -128,6 +128,7 @@ module Evilution
       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("--isolation STRATEGY", "Isolation: auto, fork, in_process (default: auto)") { |s| @options[:isolation] = s }
       opts.on("--stdin", "Read target file paths from stdin (one per line)") { @options[:stdin] = true }
       opts.on("-v", "--verbose", "Verbose output") { @options[:verbose] = true }

data/lib/evilution/config.rb

@@ -20,13 +20,14 @@ module Evilution
       fail_fast: nil,
       baseline: true,
       isolation: :auto,
+      incremental: false,
       line_ranges: {},
       spec_files: []
     }.freeze
 
     attr_reader :target_files, :timeout, :format, :diff_base,
                 :target, :min_score, :integration, :coverage, :verbose, :quiet,
-                :jobs, :fail_fast, :baseline, :isolation, :line_ranges, :spec_files
+                :jobs, :fail_fast, :baseline, :isolation, :incremental, :line_ranges, :spec_files
 
     def initialize(**options)
       file_options = options.delete(:skip_config_file) ? {} : load_config_file
@@ -64,6 +65,10 @@ module Evilution
       baseline
     end
 
+    def incremental?
+      incremental
+    end
+
     def self.file_options
       CONFIG_FILES.each do |path|
         next unless File.exist?(path)
@@ -136,6 +141,7 @@ module Evilution
       @fail_fast = validate_fail_fast(merged[:fail_fast])
       @baseline = merged[:baseline]
       @isolation = validate_isolation(merged[:isolation])
+      @incremental = merged[:incremental]
       @line_ranges = merged[:line_ranges] || {}
       @spec_files = Array(merged[:spec_files])
     end

data/lib/evilution/mcp/mutate_tool.rb

@@ -50,8 +50,9 @@ module Evilution
           runner = Runner.new(config: config)
           summary = runner.call
           report = Reporter::JSON.new.call(summary)
+          compact = trim_report(report)
 
-          ::MCP::Tool::Response.new([{ type: "text", text: report }])
+          ::MCP::Tool::Response.new([{ type: "text", text: compact }])
         rescue Evilution::Error => e
           error_payload = build_error_payload(e)
           ::MCP::Tool::Response.new([{ type: "text", text: ::JSON.generate(error_payload) }], error: true)
@@ -98,6 +99,19 @@ module Evilution
           opts
         end
 
+        def trim_report(json_string)
+          data = ::JSON.parse(json_string)
+          strip_diffs(data, "killed")
+          strip_diffs(data, "neutral")
+          ::JSON.generate(data)
+        end
+
+        def strip_diffs(data, key)
+          return unless data[key]
+
+          data[key].each { |entry| entry.delete("diff") }
+        end
+
         def build_error_payload(error)
           error_type = case error
                        when ConfigError then "config_error"

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

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Evilution
+  module Mutator
+    module Operator
+      class ReceiverReplacement < Base
+        def visit_call_node(node)
+          if node.receiver.is_a?(Prism::SelfNode)
+            call_without_self = @file_source.byteslice(
+              node.message_loc.start_offset,
+              node.location.start_offset + node.location.length - node.message_loc.start_offset
+            )
+
+            add_mutation(
+              offset: node.location.start_offset,
+              length: node.location.length,
+              replacement: call_without_self,
+              node: node
+            )
+          end
+
+          super
+        end
+      end
+    end
+  end
+end

data/lib/evilution/mutator/registry.rb

@@ -29,7 +29,8 @@ module Evilution
           Operator::BlockRemoval,
           Operator::ConditionalFlip,
           Operator::RangeReplacement,
-          Operator::RegexpMutation
+          Operator::RegexpMutation,
+          Operator::ReceiverReplacement
         ].each { |op| registry.register(op) }
         registry
       end

data/lib/evilution/runner.rb

@@ -16,6 +16,7 @@ require_relative "git/changed_files"
 require_relative "result/mutation_result"
 require_relative "result/summary"
 require_relative "baseline"
+require_relative "cache"
 require_relative "parallel/pool"
 
 module Evilution
@@ -27,6 +28,7 @@ module Evilution
       @parser = AST::Parser.new
       @registry = Mutator::Registry.default
       @isolator = build_isolator
+      @cache = config.incremental? ? Cache.new : nil
     end
 
     def call
@@ -54,7 +56,7 @@ module Evilution
 
     private
 
-    attr_reader :parser, :registry, :isolator
+    attr_reader :parser, :registry, :isolator, :cache
 
     def parse_subjects
       files = resolve_target_files
@@ -68,7 +70,11 @@ module Evilution
     end
 
     def filter_by_target(subjects)
-      matched = subjects.select { |s| s.name == config.target }
+      matched = if config.target.include?("#")
+                  subjects.select { |s| s.name == config.target }
+                else
+                  subjects.select { |s| s.name.start_with?("#{config.target}#") }
+                end
       raise Error, "no method found matching '#{config.target}'" if matched.empty?
 
       matched
@@ -125,12 +131,10 @@ module Evilution
       truncated = false
 
       mutations.each_with_index do |mutation, index|
-        test_command = ->(m) { integration.call(m) }
-        result = isolator.call(
-          mutation: mutation,
-          test_command: test_command,
-          timeout: config.timeout
-        )
+        result = execute_or_fetch(mutation) do
+          test_command = ->(m) { integration.call(m) }
+          isolator.call(mutation: mutation, test_command: test_command, timeout: config.timeout)
+        end
         mutation.strip_sources!
         result = neutralize_if_baseline_failed(result, baseline_result, spec_resolver)
         results << result
@@ -157,20 +161,34 @@ module Evilution
       mutations.each_slice(config.jobs) do |batch|
         break if state[:truncated]
 
-        compact_results = pool.map(batch) do |mutation|
-          test_command = ->(m) { integration.call(m) }
-          result = worker_isolator.call(mutation: mutation, test_command: test_command, timeout: config.timeout)
-          compact_result(result)
-        end
-
-        batch.each(&:strip_sources!)
-        batch_results = rebuild_results(batch, compact_results)
+        batch_results = run_parallel_batch(batch, pool, worker_isolator, integration)
         process_batch(batch_results, baseline_result, spec_resolver, state)
       end
 
       [state[:results], state[:truncated]]
     end
 
+    def run_parallel_batch(batch, pool, worker_isolator, integration)
+      uncached_indices, cached_results = partition_cached(batch)
+      worker_results = run_uncached_workers(batch, uncached_indices, pool, worker_isolator, integration)
+      compact_results = merge_parallel_results(batch, uncached_indices, cached_results, worker_results)
+      batch.each(&:strip_sources!)
+      batch_results = rebuild_results(batch, compact_results)
+      batch_results.each { |r| store_cached_result(r.mutation, r) }
+      batch_results
+    end
+
+    def run_uncached_workers(batch, uncached_indices, pool, worker_isolator, integration)
+      return [] if uncached_indices.empty?
+
+      uncached = uncached_indices.map { |i| batch[i] }
+      pool.map(uncached) do |mutation|
+        test_command = ->(m) { integration.call(m) }
+        result = worker_isolator.call(mutation: mutation, test_command: test_command, timeout: config.timeout)
+        compact_result(result)
+      end
+    end
+
     def process_batch(batch_results, baseline_result, spec_resolver, state)
       batch_results.each do |result|
         result = neutralize_if_baseline_failed(result, baseline_result, spec_resolver)
@@ -334,5 +352,63 @@ module Evilution
         Reporter::CLI.new
       end
     end
+
+    def partition_cached(batch)
+      uncached_indices = []
+      cached_results = {}
+
+      batch.each_with_index do |mutation, i|
+        cached = fetch_cached_result(mutation)
+        if cached
+          cached_results[i] = compact_result(cached)
+        else
+          uncached_indices << i
+        end
+      end
+
+      [uncached_indices, cached_results]
+    end
+
+    def merge_parallel_results(batch, uncached_indices, cached_results, worker_results)
+      result_map = cached_results.dup
+      uncached_indices.each_with_index { |batch_idx, worker_idx| result_map[batch_idx] = worker_results[worker_idx] }
+      batch.each_index.map { |i| result_map[i] }
+    end
+
+    def execute_or_fetch(mutation)
+      cached = fetch_cached_result(mutation)
+      return cached if cached
+
+      result = yield
+      store_cached_result(mutation, result)
+      result
+    end
+
+    def fetch_cached_result(mutation)
+      return nil unless cache
+
+      data = cache.fetch(mutation)
+      return nil unless data
+      return nil unless %i[killed timeout].include?(data[:status])
+
+      Result::MutationResult.new(
+        mutation: mutation,
+        status: data[:status],
+        duration: data[:duration],
+        killing_test: data[:killing_test],
+        test_command: data[:test_command]
+      )
+    end
+
+    def store_cached_result(mutation, result)
+      return unless cache
+      return unless result.killed? || result.timeout?
+
+      cache.store(mutation,
+                  status: result.status,
+                  duration: result.duration,
+                  killing_test: result.killing_test,
+                  test_command: result.test_command)
+    end
   end
 end

data/lib/evilution/spec_resolver.rb

@@ -28,13 +28,35 @@ module Evilution
       base = source_path.sub(/\.rb\z/, "_spec.rb")
       prefix = STRIPPABLE_PREFIXES.find { |p| source_path.start_with?(p) }
 
-      if prefix
-        stripped = "spec/#{base.delete_prefix(prefix)}"
-        kept = "spec/#{base}"
-        [stripped, kept]
-      else
-        ["spec/#{base}"]
+      candidates = if prefix
+                     stripped = base.delete_prefix(prefix)
+                     ["spec/#{stripped}", "spec/#{base}"]
+                   else
+                     ["spec/#{base}"]
+                   end
+
+      fallbacks = candidates.flat_map { |c| parent_fallback_candidates(c) }.uniq
+      candidates + fallbacks
+    end
+
+    def parent_fallback_candidates(spec_path)
+      parts = spec_path.split("/")
+      # parts: ["spec", "foo", "bar_spec.rb"] — need at least 3 parts for fallback
+      return [] if parts.length < 3
+
+      candidates = []
+      # Remove filename, then progressively remove directories
+      dir_parts = parts[1..-2] # ["models", "game"]
+      (dir_parts.length - 1).downto(0) do |i|
+        file = "#{dir_parts[i]}_spec.rb"
+        if i.zero?
+          candidates << "spec/#{file}"
+        else
+          parent = dir_parts[0...i].join("/")
+          candidates << "spec/#{parent}/#{file}"
+        end
       end
+      candidates
     end
   end
 end

data/lib/evilution/version.rb

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

data/lib/evilution.rb

@@ -32,6 +32,7 @@ require_relative "evilution/mutator/operator/block_removal"
 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/registry"
 require_relative "evilution/isolation/fork"
 require_relative "evilution/isolation/in_process"
@@ -50,6 +51,7 @@ require_relative "evilution/coverage/collector"
 require_relative "evilution/coverage/test_map"
 require_relative "evilution/spec_resolver"
 require_relative "evilution/baseline"
+require_relative "evilution/cache"
 require_relative "evilution/cli"
 require_relative "evilution/runner"
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: evilution
 version: !ruby/object:Gem::Version
-  version: 0.8.0
+  version: 0.9.0
 platform: ruby
 authors:
 - Denis Kiselev
@@ -81,6 +81,7 @@ files:
 - lib/evilution/ast/parser.rb
 - lib/evilution/ast/source_surgeon.rb
 - lib/evilution/baseline.rb
+- lib/evilution/cache.rb
 - lib/evilution/cli.rb
 - lib/evilution/config.rb
 - lib/evilution/coverage/collector.rb
@@ -117,6 +118,7 @@ files:
 - lib/evilution/mutator/operator/negation_insertion.rb
 - lib/evilution/mutator/operator/nil_replacement.rb
 - lib/evilution/mutator/operator/range_replacement.rb
+- 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/statement_deletion.rb