evilution 0.1.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 34fdc4c7cf9abac2c71dc0aa7d1aa4e4452e6237b8f1564c2dd92db2f5746cf5
-  data.tar.gz: 6d7bb8ef692815bbc62d8ca2a3446ee642bdc2c1834856064a48e4c311256b63
+  metadata.gz: 646e7a441c39108d413a0b33cb28234b090e16c1614d343c40be84581fb45adf
+  data.tar.gz: fc65d99be854a51dc0354a77db413d90a8344611dc8d94a5e97ef61e91e764a9
 SHA512:
-  metadata.gz: 9f08ab9b14a0b43e26a15e499d65ce819f5443efa77311ff45bccf3ae230b3f4fc61bc1d20cf4beb464b6c70ca82964a21a5f8d889edb30b5ab2f18f8af3ca44
-  data.tar.gz: 84ba0567669d197cc56a2723a5e0fdeca84cf2b74085b5a273d9d7279211d156397ae520e7986fba81562393d25e21e3c99a1b6626cf472f79eeae11fede48ba
+  metadata.gz: 38954ff26a4f48a050ca7a5d4270307157f7482836718152e03d17642df566110144c2773a5ce62ea8877ed2bdc97e6b2ccc33d49e9521e2074ad7cfc2b46b1e
+  data.tar.gz: c4a4bcbf1f59e2f8ff01138bf690132dcb183330009340b76b4d8db1d8807411c04dcb8f3a52820857b9563158a49147903a7274e1395b0f4f76047f239d625e

data/.beads/.migration-hint-ts

@@ -1 +1 @@
-1772686671
+1773300459

data/.beads/issues.jsonl

@@ -5,10 +5,16 @@
 {"id":"EV-1.4","title":"Delete services.md prompt","description":"Remove .claude/prompts/services.md — not applicable to a gem project.","status":"closed","priority":2,"issue_type":"task","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-02T00:05:17.649482526+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-02T10:41:19.226636126+07:00","closed_at":"2026-03-02T10:41:19.226636126+07:00","close_reason":"Closed","dependencies":[{"issue_id":"EV-1.4","depends_on_id":"EV-1","type":"parent-child","created_at":"0001-01-01T00:00:00Z"}]}
 {"id":"EV-1.5","title":"Update gemspec metadata","description":"Fill in summary, description, homepage, source_code_uri, changelog_uri. Add runtime dependency: diff-lcs (>= 1.5, < 3). Set allowed_push_host to rubygems.org.","status":"closed","priority":2,"issue_type":"task","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-02T00:05:17.756448433+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-02T10:41:47.168270415+07:00","closed_at":"2026-03-02T10:41:47.168270415+07:00","close_reason":"Closed","dependencies":[{"issue_id":"EV-1.5","depends_on_id":"EV-1","type":"parent-child","created_at":"0001-01-01T00:00:00Z"}]}
 {"id":"EV-1.6","title":"Update .rubocop.yml for gem conventions","description":"Configure rubocop for gem: enable NewCops, set reasonable line length, exclude spec fixtures.","status":"closed","priority":2,"issue_type":"task","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-02T00:05:17.855784448+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-02T10:42:03.456572349+07:00","closed_at":"2026-03-02T10:42:03.456572349+07:00","close_reason":"Closed","dependencies":[{"issue_id":"EV-1.6","depends_on_id":"EV-1","type":"parent-child","created_at":"0001-01-01T00:00:00Z"}]}
-{"id":"EV-10","title":"Publish v0.1.0 gem release","description":"Gemspec is ready. Tag v0.1.0, build the gem, and publish to RubyGems. Steps: verify gemspec metadata, run rake release (or manual gem build + gem push), create GitHub release with CHANGELOG notes.","status":"open","priority":3,"issue_type":"task","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-02T16:21:53.571182801+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-02T16:21:53.571182801+07:00"}
+{"id":"EV-10","title":"Publish v0.1.0 gem release","description":"Gemspec is ready. Tag v0.1.0, build the gem, and publish to RubyGems. Steps: verify gemspec metadata, run rake release (or manual gem build + gem push), create GitHub release with CHANGELOG notes.","status":"closed","priority":3,"issue_type":"task","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-02T16:21:53.571182801+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-06T11:44:35.748868691+07:00","closed_at":"2026-03-06T11:44:35.748868691+07:00","close_reason":"Published to RubyGems"}
 {"id":"EV-11","title":"Wire coverage-based filtering into Runner","description":"Collector and TestMap exist and pass specs, but Runner never calls them. When config.coverage is true, Runner collects aggregate line-level coverage via Coverage::Collector, builds a Coverage::TestMap, and skips mutations on lines that no test exercises (marking them as survived with zero duration). Note: Ruby Coverage provides aggregate per-file line hit counts, not per-test-file tracking, so we filter out uncovered mutations rather than selecting specific test files.","status":"closed","priority":2,"issue_type":"task","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-04T11:52:42.607616728+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-06T11:02:25.4848637+07:00","closed_at":"2026-03-05T14:53:24.894588088+07:00","close_reason":"Coverage-based test selection wired into Runner"}
 {"id":"EV-12","title":"Resolve suggestion gap","description":"The workflow section instructs agents to read a suggestion field from survived[], but the JSON reporter output does not include suggestion (lib/evilution/reporter/json.rb only emits operator/file/line/status/duration/diff). Either add suggestion to the JSON output/schema or update the workflow steps to match the actual report fields. See GitHub issue #12.","status":"closed","priority":2,"issue_type":"bug","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-05T12:33:23.674094791+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-05T13:05:48.785616141+07:00","closed_at":"2026-03-05T13:05:48.785616141+07:00","close_reason":"Wired Suggestion into JSON reporter for survived mutations, updated README schema, added specs"}
 {"id":"EV-13","title":"Enable true per-mutation isolation with temp file copies","description":"Replace direct file writes with temp-dir + $LOAD_PATH isolation so multiple workers can mutate the same file in parallel. Remove per-file grouping from Pool#partition.","status":"closed","priority":2,"issue_type":"feature","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-05T13:42:04.711580397+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-05T13:44:34.779951959+07:00","closed_at":"2026-03-05T13:44:34.779951959+07:00","close_reason":"Implemented temp file isolation via $LOAD_PATH and round-robin partition"}
+{"id":"EV-14","title":"Add changelog_uri to gemspec metadata","description":"The published gem on RubyGems is missing the Changelog link. Add changelog_uri to spec.metadata in evilution.gemspec pointing to CHANGELOG.md on master.","status":"closed","priority":2,"issue_type":"bug","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-06T11:46:12.648668594+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-06T11:47:41.23691915+07:00","closed_at":"2026-03-06T11:47:41.23691915+07:00","close_reason":"Added changelog_uri to gemspec"}
+{"id":"EV-15","title":"Add line-range targeting (file:line-line syntax)","description":"Parse line-range syntax in CLI, store in Config, filter subjects in Runner. GH #29.","status":"closed","priority":2,"issue_type":"feature","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-08T00:36:29.164188342+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-08T00:38:02.739833414+07:00","closed_at":"2026-03-08T00:38:02.739833414+07:00","close_reason":"Implemented line-range targeting in CLI, Config, and Runner with full test coverage"}
+{"id":"EV-16","title":"Remove file-discovery logic from Integration::RSpec (GH #33)","description":"Integration::RSpec has detect_test_files, spec_file_candidates, and fallback_spec_dir that guess which specs to run. With precise targeting, agents can pass spec files directly. Simplify or remove this guessing logic, possibly adding a --spec flag.","status":"closed","priority":2,"issue_type":"task","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-08T19:17:27.268579626+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-09T18:13:46.899195957+07:00","closed_at":"2026-03-09T18:13:46.899195957+07:00","close_reason":"Completed via PR #38 (tracked as EV-17)"}
+{"id":"EV-17","title":"Remove file-discovery logic from Integration::RSpec","description":"Add --spec flag, simplify RSpec integration by removing detect_test_files heuristics. GH #33","status":"closed","priority":2,"issue_type":"task","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-09T00:41:29.880486333+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-09T00:43:21.229172712+07:00","closed_at":"2026-03-09T00:43:21.229172712+07:00","close_reason":"Removed ~60 lines of file-discovery logic from Integration::RSpec, added --spec CLI flag, spec_files config, and wired through Runner"}
+{"id":"EV-18","title":"Add method-name targeting (Class#method) (GH #30)","description":"Allow specifying a fully-qualified method name: evilution run Foo::Bar#calculate. Resolve name to file and line range, then mutate only that method. Lower priority since it requires name-to-file resolution which can be ambiguous with reopened classes or metaprogramming. Update README, --help, and CHANGELOG.","status":"in_progress","priority":3,"issue_type":"feature","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-09T23:49:31.827723147+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-10T00:05:22.381962628+07:00"}
+{"id":"EV-19","title":"Add method-name targeting (--target flag)","description":"Users can target a specific method for mutation testing via --target METHOD flag. Matches against Subject.name.","status":"closed","priority":2,"issue_type":"feature","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-10T00:09:57.091870734+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-10T00:10:02.637447023+07:00","closed_at":"2026-03-10T00:10:02.637447023+07:00","close_reason":"Implemented --target flag in CLI, Config.target? predicate, Runner.filter_by_target, README docs, and specs"}
 {"id":"EV-2","title":"Phase 1: Foundation — End-to-End Single Mutation","description":"Build the core pipeline: parse Ruby with Prism, generate mutations, fork-based isolation, RSpec integration, JSON reporting. Milestone: Runner.new(files: ['lib/user.rb']).call produces JSON output.","status":"closed","priority":2,"issue_type":"epic","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-02T00:04:58.737191467+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-02T11:02:00.342745637+07:00","closed_at":"2026-03-02T11:02:00.342745637+07:00","close_reason":"Phase 1 Foundation complete: Config, AST::Parser, Subject, SourceSurgeon, Mutation, Mutator::Base+Registry, ComparisonReplacement, Isolation::Fork, Integration::RSpec, Result objects, Reporter::JSON, Runner — all 13 tasks done"}
 {"id":"EV-2.1","title":"Implement Evilution::Config","description":"Immutable configuration value object. Fields: target_files, jobs (default: Etc.nprocessors), timeout (default: 10s), format (:json/:text), diff_base (nil), min_score (0.0), integration (:rspec), config_file path. Merge from defaults + YAML + CLI flags. File: lib/evilution/config.rb + spec.","status":"closed","priority":2,"issue_type":"task","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-02T00:05:50.275297792+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-02T10:43:14.688620834+07:00","closed_at":"2026-03-02T10:43:14.688620834+07:00","close_reason":"Closed","dependencies":[{"issue_id":"EV-2.1","depends_on_id":"EV-2","type":"parent-child","created_at":"0001-01-01T00:00:00Z"}]}
 {"id":"EV-2.10","title":"Implement Evilution::Integration::Base and RSpec adapter","description":"Base: abstract adapter with interface #call(test_files) -> {passed: bool, example_count: int, failure_count: int}. RSpec: programmatic runner using RSpec::Core::Runner.run with StringIO for capture. Auto-detects spec/ directory. Files: lib/evilution/integration/base.rb, lib/evilution/integration/rspec.rb + specs.","status":"closed","priority":2,"issue_type":"task","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-02T00:05:51.246990324+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-02T10:58:18.324768622+07:00","closed_at":"2026-03-02T10:58:18.324768622+07:00","close_reason":"Integration::Base and Integration::RSpec implemented with 8 passing specs","dependencies":[{"issue_id":"EV-2.10","depends_on_id":"EV-2","type":"parent-child","created_at":"0001-01-01T00:00:00Z"}]}
@@ -23,6 +29,16 @@
 {"id":"EV-2.7","title":"Implement ComparisonReplacement operator","description":"First mutation operator. Targets CallNode where name is :>, :<, :>=, :<=, :==, :!=. Replacements: > -> [>=, ==], < -> [<=, ==], >= -> [>, ==], <= -> [<, ==], == -> [!=], != -> [==]. Uses SourceSurgeon to apply text replacement at message_loc offsets. File: lib/evilution/mutator/operator/comparison_replacement.rb + spec.","status":"closed","priority":2,"issue_type":"task","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-02T00:05:50.917501278+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-02T10:50:01.327985674+07:00","closed_at":"2026-03-02T10:50:01.327985674+07:00","close_reason":"Closed","dependencies":[{"issue_id":"EV-2.7","depends_on_id":"EV-2","type":"parent-child","created_at":"0001-01-01T00:00:00Z"},{"issue_id":"EV-2.7","depends_on_id":"EV-2.6","type":"blocks","created_at":"0001-01-01T00:00:00Z"},{"issue_id":"EV-2.7","depends_on_id":"EV-2.4","type":"blocks","created_at":"0001-01-01T00:00:00Z"}]}
 {"id":"EV-2.8","title":"Implement Evilution::Result::MutationResult and Summary","description":"MutationResult: value object with fields: mutation, status (:killed/:survived/:timeout/:error), duration, killing_test (optional). Summary: aggregates MutationResult array into total/killed/survived/timed_out/errors/score/duration. Files: lib/evilution/result/mutation_result.rb, lib/evilution/result/summary.rb + specs.","status":"closed","priority":2,"issue_type":"task","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-02T00:05:51.022249568+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-02T10:51:08.482621898+07:00","closed_at":"2026-03-02T10:51:08.482621898+07:00","close_reason":"Closed","dependencies":[{"issue_id":"EV-2.8","depends_on_id":"EV-2","type":"parent-child","created_at":"0001-01-01T00:00:00Z"}]}
 {"id":"EV-2.9","title":"Implement Evilution::Isolation::Fork","description":"Fork-based process isolation. Method: run(mutation, test_command, timeout:) -> MutationResult. Flow: create pipe, fork child, child applies mutation via eval, child runs test command, marshal result back via pipe, parent reads with IO.select timeout, SIGKILL on deadline. File: lib/evilution/isolation/fork.rb + spec.","status":"closed","priority":2,"issue_type":"task","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-02T00:05:51.142167275+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-02T10:54:08.819310594+07:00","closed_at":"2026-03-02T10:54:08.819310594+07:00","close_reason":"Fork isolation implemented with 6 passing specs","dependencies":[{"issue_id":"EV-2.9","depends_on_id":"EV-2","type":"parent-child","created_at":"0001-01-01T00:00:00Z"},{"issue_id":"EV-2.9","depends_on_id":"EV-2.8","type":"blocks","created_at":"0001-01-01T00:00:00Z"}]}
+{"id":"EV-20","title":"Deprecate coverage filtering","description":"With line-range and method-name targeting, coverage collection adds overhead for little benefit. Deprecate --no-coverage flag, coverage config key, and remove coverage logic from runner.","status":"closed","priority":2,"issue_type":"task","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-10T00:30:58.837659684+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-10T00:33:06.453669976+07:00","closed_at":"2026-03-10T00:33:06.453669976+07:00","close_reason":"Deprecated coverage filtering: CLI warns on --no-coverage, config warns on coverage key, runner no longer uses coverage logic"}
+{"id":"EV-21","title":"Epic: Speed & Performance","description":"Reduce mutation testing wall-clock time for fast agent feedback loops. Includes fail-fast, parallel execution, and per-mutation spec targeting.","status":"open","priority":1,"issue_type":"feature","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-10T06:17:26.608316104+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-10T06:17:26.608316104+07:00","dependencies":[{"issue_id":"EV-21","depends_on_id":"EV-22","type":"blocks","created_at":"0001-01-01T00:00:00Z"},{"issue_id":"EV-21","depends_on_id":"EV-23","type":"blocks","created_at":"0001-01-01T00:00:00Z"}]}
+{"id":"EV-22","title":"Add --fail-fast flag with survivor threshold","description":"Add --fail-fast [N] CLI flag and fail_fast config option to stop mutation testing after N surviving mutants (default N=1 when flag given without value). Agents fix gaps iteratively, so discovering all survivors upfront is wasted work. A threshold gives control over the speed/thoroughness tradeoff: --fail-fast 1 for quick checks, --fail-fast 5 for CI gates, omit for full scans. Runner#call should stop running mutations and return a partial Summary once the threshold is reached. JSON output should include a 'truncated: true' field when fail-fast triggered.","status":"open","priority":2,"issue_type":"feature","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-10T06:17:28.018733235+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-10T10:29:42.228568154+07:00"}
+{"id":"EV-23","title":"Per-mutation spec targeting","description":"Instead of running the full spec suite for every mutation, map each mutated source file to its relevant spec file(s) using convention-based resolution (e.g. lib/foo/bar.rb -> spec/foo/bar_spec.rb) and only run those. This dramatically reduces per-mutation test time. Depends on convention-based spec file resolution being implemented first.","status":"open","priority":2,"issue_type":"feature","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-10T06:17:28.98620973+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-10T06:17:28.98620973+07:00","dependencies":[{"issue_id":"EV-23","depends_on_id":"EV-34","type":"blocks","created_at":"0001-01-01T00:00:00Z"}]}
+{"id":"EV-24","title":"Epic: JSON Output Improvements","description":"Make JSON output fully machine-parseable in all scenarios, including errors. Add diagnostic fields that help agents debug failures.","status":"open","priority":2,"issue_type":"feature","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-10T06:17:37.450686472+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-10T06:17:37.450686472+07:00","dependencies":[{"issue_id":"EV-24","depends_on_id":"EV-25","type":"blocks","created_at":"0001-01-01T00:00:00Z"},{"issue_id":"EV-24","depends_on_id":"EV-26","type":"blocks","created_at":"0001-01-01T00:00:00Z"}]}
+{"id":"EV-25","title":"Structured error responses in JSON mode","description":"When --format json is used and exit code is 2 (error), output a JSON object with error details instead of unstructured stderr text. Schema: { \"error\": { \"type\": \"config_error|parse_error|runtime_error\", \"message\": \"...\", \"file\": \"...\" } }. Agents currently have to regex-parse stderr which is fragile.","status":"open","priority":2,"issue_type":"feature","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-10T06:17:38.283715502+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-10T06:17:38.283715502+07:00"}
+{"id":"EV-26","title":"Include test command in mutation result JSON","description":"Add a 'test_command' field to each mutation result in JSON output showing the exact command that was run to test that mutation. Helps agents debug when a mutation errors out or times out.","status":"open","priority":3,"issue_type":"feature","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-10T06:17:39.227881462+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-10T06:17:39.227881462+07:00"}
+{"id":"EV-27","title":"Epic: Workflow Integration","description":"Make evilution easier to invoke from AI agent toolchains — MCP server for direct tool calls, stdin mode for piping.","status":"open","priority":2,"issue_type":"feature","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-10T06:17:43.883767452+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-10T06:17:43.883767452+07:00","dependencies":[{"issue_id":"EV-27","depends_on_id":"EV-28","type":"blocks","created_at":"0001-01-01T00:00:00Z"},{"issue_id":"EV-27","depends_on_id":"EV-29","type":"blocks","created_at":"0001-01-01T00:00:00Z"}]}
+{"id":"EV-28","title":"MCP server for direct tool invocation","description":"Implement a Model Context Protocol (MCP) server that exposes evilution as a tool. Agents could call evilution directly instead of shelling out and parsing output. The server should expose a 'mutate' tool that accepts target files, options, and returns structured results.","status":"open","priority":2,"issue_type":"feature","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-10T06:17:45.29866593+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-10T06:17:45.29866593+07:00"}
+{"id":"EV-29","title":"Add --stdin flag to accept file list from stdin","description":"Add a --stdin flag that reads target file paths (one per line) from stdin. Enables workflows like: git diff --name-only | evilution run --stdin --format json. Each line can include line-range syntax (e.g. lib/foo.rb:15-30).","status":"open","priority":3,"issue_type":"feature","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-10T06:17:46.306306092+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-10T06:17:46.306306092+07:00"}
 {"id":"EV-3","title":"Phase 2: Mutation Operators & CLI","description":"Implement remaining 17 mutation operators, build CLI with OptionParser, exe/evilution executable, human-readable reporter. Milestone: bundle exec evilution run lib/user.rb --format json","status":"closed","priority":2,"issue_type":"epic","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-02T00:05:00.492971295+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-02T11:21:32.168384165+07:00","closed_at":"2026-03-02T11:21:32.168384165+07:00","close_reason":"Phase 2 complete: all 18 operators, CLI, Reporter::CLI, Registry registration, executable","dependencies":[{"issue_id":"EV-3","depends_on_id":"EV-2","type":"blocks","created_at":"0001-01-01T00:00:00Z"}]}
 {"id":"EV-3.1","title":"Implement ArithmeticReplacement operator","description":"Targets CallNode where name is :+, :-, :*, :/, :%, :**. Replacements: + <-> -, * <-> /, % -> /, ** -> *. File: lib/evilution/mutator/operator/arithmetic_replacement.rb + spec.","status":"closed","priority":2,"issue_type":"task","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-02T00:06:13.025649082+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-02T11:06:10.922412304+07:00","closed_at":"2026-03-02T11:06:10.922412304+07:00","close_reason":"All 3 operators implemented with passing specs","dependencies":[{"issue_id":"EV-3.1","depends_on_id":"EV-3","type":"parent-child","created_at":"0001-01-01T00:00:00Z"},{"issue_id":"EV-3.1","depends_on_id":"EV-2.6","type":"blocks","created_at":"0001-01-01T00:00:00Z"}]}
 {"id":"EV-3.10","title":"Implement SymbolLiteral operator","description":"Targets SymbolNode. Mutation: :foo -> :__evilution_mutated__. File: lib/evilution/mutator/operator/symbol_literal.rb + spec.","status":"closed","priority":2,"issue_type":"task","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-02T00:06:13.935877816+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-02T11:13:36.541040613+07:00","closed_at":"2026-03-02T11:13:36.541040613+07:00","close_reason":"All 3 operators implemented with passing specs","dependencies":[{"issue_id":"EV-3.10","depends_on_id":"EV-3","type":"parent-child","created_at":"0001-01-01T00:00:00Z"},{"issue_id":"EV-3.10","depends_on_id":"EV-2.6","type":"blocks","created_at":"0001-01-01T00:00:00Z"}]}
@@ -30,7 +46,7 @@
 {"id":"EV-3.12","title":"Implement ConditionalBranch operator","description":"Targets IfNode with both if and else branches. Mutations: replace entire if/else with if-branch only, replace with else-branch only. File: lib/evilution/mutator/operator/conditional_branch.rb + spec.","status":"closed","priority":2,"issue_type":"task","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-02T00:06:14.138508575+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-02T11:13:36.541106251+07:00","closed_at":"2026-03-02T11:13:36.541106251+07:00","close_reason":"All 3 operators implemented with passing specs","dependencies":[{"issue_id":"EV-3.12","depends_on_id":"EV-3","type":"parent-child","created_at":"0001-01-01T00:00:00Z"},{"issue_id":"EV-3.12","depends_on_id":"EV-2.6","type":"blocks","created_at":"0001-01-01T00:00:00Z"}]}
 {"id":"EV-3.13","title":"Implement StatementDeletion operator","description":"Targets StatementsNode bodies with 2+ statements. For each statement, produce a mutation that removes it. File: lib/evilution/mutator/operator/statement_deletion.rb + spec.","status":"closed","priority":2,"issue_type":"task","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-02T00:06:14.240151154+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-02T11:16:08.954716442+07:00","closed_at":"2026-03-02T11:16:08.954716442+07:00","close_reason":"All 3 operators implemented with passing specs","dependencies":[{"issue_id":"EV-3.13","depends_on_id":"EV-3","type":"parent-child","created_at":"0001-01-01T00:00:00Z"},{"issue_id":"EV-3.13","depends_on_id":"EV-2.6","type":"blocks","created_at":"0001-01-01T00:00:00Z"}]}
 {"id":"EV-3.14","title":"Implement MethodBodyReplacement operator","description":"Targets DefNode with body. Mutations: replace body with nil, replace with raise NotImplementedError. File: lib/evilution/mutator/operator/method_body_replacement.rb + spec.","status":"closed","priority":2,"issue_type":"task","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-02T00:06:14.333934644+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-02T11:16:08.954887847+07:00","closed_at":"2026-03-02T11:16:08.954887847+07:00","close_reason":"All 3 operators implemented with passing specs","dependencies":[{"issue_id":"EV-3.14","depends_on_id":"EV-3","type":"parent-child","created_at":"0001-01-01T00:00:00Z"},{"issue_id":"EV-3.14","depends_on_id":"EV-2.6","type":"blocks","created_at":"0001-01-01T00:00:00Z"}]}
-{"id":"EV-3.15","title":"Implement NegationInsertion operator","description":"Targets CallNode with predicate method names (ending in ?). Mutation: x.empty? -> !x.empty?. File: lib/evilution/mutator/operator/negation_insertion.rb + spec.","status":"closed","priority":2,"issue_type":"task","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-02T00:06:14.438532333+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-02T11:16:08.95490096+07:00","closed_at":"2026-03-02T11:16:08.95490096+07:00","close_reason":"All 3 operators implemented with passing specs","dependencies":[{"issue_id":"EV-3.15","depends_on_id":"EV-3","type":"parent-child","created_at":"0001-01-01T00:00:00Z"},{"issue_id":"EV-3.15","depends_on_id":"EV-2.6","type":"blocks","created_at":"0001-01-01T00:00:00Z"}]}
+{"id":"EV-3.15","title":"Implement NegationInsertion operator","description":"Targets CallNode with predicate method names (ending in ?). Mutation: x.empty? -> !x.empty?. File: lib/evilution/mutator/operator/negation_insertion.rb + spec.","status":"closed","priority":2,"issue_type":"task","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-02T00:06:14.438532333+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-06T16:11:55.50396051+07:00","closed_at":"2026-03-02T11:16:08.95490096+07:00","close_reason":"Commands now listed in --help output","dependencies":[{"issue_id":"EV-3.15","depends_on_id":"EV-3","type":"parent-child","created_at":"0001-01-01T00:00:00Z"},{"issue_id":"EV-3.15","depends_on_id":"EV-2.6","type":"blocks","created_at":"0001-01-01T00:00:00Z"}]}
 {"id":"EV-3.16","title":"Implement ReturnValueRemoval operator","description":"Targets ReturnNode with arguments. Mutations: return x -> return, return x -> return nil. File: lib/evilution/mutator/operator/return_value_removal.rb + spec.","status":"closed","priority":2,"issue_type":"task","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-02T00:06:14.541333631+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-02T11:18:14.396683739+07:00","closed_at":"2026-03-02T11:18:14.396683739+07:00","close_reason":"Both operators implemented with passing specs","dependencies":[{"issue_id":"EV-3.16","depends_on_id":"EV-3","type":"parent-child","created_at":"0001-01-01T00:00:00Z"},{"issue_id":"EV-3.16","depends_on_id":"EV-2.6","type":"blocks","created_at":"0001-01-01T00:00:00Z"}]}
 {"id":"EV-3.17","title":"Implement CollectionReplacement operator","description":"Targets CallNode where name matches collection methods. Replacements: map->each, select<->reject, all?<->any?, first<->last, min<->max, flat_map->map. File: lib/evilution/mutator/operator/collection_replacement.rb + spec.","status":"closed","priority":2,"issue_type":"task","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-02T00:06:14.635444378+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-02T11:18:14.396880048+07:00","closed_at":"2026-03-02T11:18:14.396880048+07:00","close_reason":"Both operators implemented with passing specs","dependencies":[{"issue_id":"EV-3.17","depends_on_id":"EV-3","type":"parent-child","created_at":"0001-01-01T00:00:00Z"},{"issue_id":"EV-3.17","depends_on_id":"EV-2.6","type":"blocks","created_at":"0001-01-01T00:00:00Z"}]}
 {"id":"EV-3.18","title":"Implement Evilution::CLI","description":"OptionParser-based CLI. Commands: run [FILES...], version, init. Flags: --jobs/-j, --timeout/-t, --format/-f (json/text), --diff BASE, --target PATTERN, --min-score FLOAT, --no-coverage, --config FILE, --verbose/-v, --quiet/-q. Parses args into Config, delegates to Runner. File: lib/evilution/cli.rb + spec.","status":"closed","priority":2,"issue_type":"task","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-02T00:06:26.540459363+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-02T11:20:50.084035782+07:00","closed_at":"2026-03-02T11:20:50.084035782+07:00","close_reason":"CLI, Reporter::CLI, and Registry registration all implemented","dependencies":[{"issue_id":"EV-3.18","depends_on_id":"EV-3","type":"parent-child","created_at":"0001-01-01T00:00:00Z"},{"issue_id":"EV-3.18","depends_on_id":"EV-2.1","type":"blocks","created_at":"0001-01-01T00:00:00Z"},{"issue_id":"EV-3.18","depends_on_id":"EV-2.12","type":"blocks","created_at":"0001-01-01T00:00:00Z"}]}
@@ -45,6 +61,16 @@
 {"id":"EV-3.7","title":"Implement StringLiteral operator","description":"Targets StringNode. Mutations: non-empty -> empty string, empty -> 'mutation'. File: lib/evilution/mutator/operator/string_literal.rb + spec.","status":"closed","priority":2,"issue_type":"task","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-02T00:06:13.633726423+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-02T11:10:56.39748015+07:00","closed_at":"2026-03-02T11:10:56.39748015+07:00","close_reason":"All 3 operators implemented with passing specs","dependencies":[{"issue_id":"EV-3.7","depends_on_id":"EV-3","type":"parent-child","created_at":"0001-01-01T00:00:00Z"},{"issue_id":"EV-3.7","depends_on_id":"EV-2.6","type":"blocks","created_at":"0001-01-01T00:00:00Z"}]}
 {"id":"EV-3.8","title":"Implement ArrayLiteral operator","description":"Targets ArrayNode with elements. Mutation: [a, b, c] -> []. File: lib/evilution/mutator/operator/array_literal.rb + spec.","status":"closed","priority":2,"issue_type":"task","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-02T00:06:13.734617709+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-02T11:10:56.397565925+07:00","closed_at":"2026-03-02T11:10:56.397565925+07:00","close_reason":"All 3 operators implemented with passing specs","dependencies":[{"issue_id":"EV-3.8","depends_on_id":"EV-3","type":"parent-child","created_at":"0001-01-01T00:00:00Z"},{"issue_id":"EV-3.8","depends_on_id":"EV-2.6","type":"blocks","created_at":"0001-01-01T00:00:00Z"}]}
 {"id":"EV-3.9","title":"Implement HashLiteral operator","description":"Targets HashNode with pairs. Mutation: {k: v} -> {}. File: lib/evilution/mutator/operator/hash_literal.rb + spec.","status":"closed","priority":2,"issue_type":"task","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-02T00:06:13.840779748+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-02T11:10:56.397570989+07:00","closed_at":"2026-03-02T11:10:56.397570989+07:00","close_reason":"All 3 operators implemented with passing specs","dependencies":[{"issue_id":"EV-3.9","depends_on_id":"EV-3","type":"parent-child","created_at":"0001-01-01T00:00:00Z"},{"issue_id":"EV-3.9","depends_on_id":"EV-2.6","type":"blocks","created_at":"0001-01-01T00:00:00Z"}]}
+{"id":"EV-30","title":"Epic: Smarter Suggestions","description":"Improve the suggestion field in mutation results to provide concrete, actionable test code that agents can use directly.","status":"open","priority":2,"issue_type":"feature","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-10T06:18:03.590579846+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-10T06:18:03.590579846+07:00","dependencies":[{"issue_id":"EV-30","depends_on_id":"EV-31","type":"blocks","created_at":"0001-01-01T00:00:00Z"}]}
+{"id":"EV-31","title":"Generate concrete RSpec test code in suggestions","description":"Replace prose suggestions like 'add a test that checks the boundary' with actual RSpec code snippets that would kill the mutant. Use the mutation's operator, file context, and method signature to generate a concrete test example. The suggestion should be a valid RSpec 'it' block that an agent can drop into a spec file.","status":"open","priority":2,"issue_type":"feature","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-10T06:18:05.964542284+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-10T06:18:05.964542284+07:00"}
+{"id":"EV-32","title":"Epic: Zero-friction Defaults","description":"Make evilution work well with zero configuration. Auto-detect what to mutate and which specs to run based on git state and file conventions.","status":"open","priority":2,"issue_type":"feature","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-10T06:18:06.843446356+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-10T06:18:06.843446356+07:00","dependencies":[{"issue_id":"EV-32","depends_on_id":"EV-33","type":"blocks","created_at":"0001-01-01T00:00:00Z"},{"issue_id":"EV-32","depends_on_id":"EV-34","type":"blocks","created_at":"0001-01-01T00:00:00Z"}]}
+{"id":"EV-33","title":"Auto-detect changed files from git merge base","description":"When evilution is run with no file arguments, default to mutating files changed since the merge base of the current branch (git merge-base HEAD main). This makes 'evilution run --format json' just work in a feature branch without specifying files. Should be skippable if explicit files are provided.","status":"open","priority":2,"issue_type":"feature","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-10T06:18:08.235421922+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-10T06:18:08.235421922+07:00"}
+{"id":"EV-34","title":"Convention-based spec file resolution","description":"Implement a mapping from source files to their spec files using Ruby/RSpec conventions: lib/foo/bar.rb -> spec/foo/bar_spec.rb, app/models/user.rb -> spec/models/user_spec.rb. This is a foundational piece used by both zero-friction defaults (auto-detect specs) and per-mutation spec targeting (run only relevant specs). Should handle common Rails and gem layouts.","status":"open","priority":2,"issue_type":"feature","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-10T06:18:09.380269033+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-10T06:18:09.380269033+07:00"}
+{"id":"EV-35","title":"File left in mutated state on timeout","description":"Epic: File left in mutated state on timeout. Root cause: SIGKILL (fork.rb:45) is untrappable — child's ensure block (rspec.rb:24-26) never runs, so restore_original never executes. Affects Strategy B (direct file write) with data corruption and Strategy A (temp dir) with resource leaks. Decomposed into EV-37, EV-38, EV-39.","status":"closed","priority":1,"issue_type":"bug","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-12T14:27:59.54425065+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-13T00:34:44.130203912+07:00","closed_at":"2026-03-13T00:34:44.130203912+07:00","close_reason":"All sub-issues (EV-37, EV-38, EV-39) completed","dependencies":[{"issue_id":"EV-35","depends_on_id":"EV-37","type":"blocks","created_at":"0001-01-01T00:00:00Z"},{"issue_id":"EV-35","depends_on_id":"EV-38","type":"blocks","created_at":"0001-01-01T00:00:00Z"},{"issue_id":"EV-35","depends_on_id":"EV-39","type":"blocks","created_at":"0001-01-01T00:00:00Z"}]}
+{"id":"EV-36","title":"Raise default timeout from 10s to 30s","description":"Default 10s timeout is too low when running the full test suite per mutation (no smart test selection yet). Agent testing showed 30s was needed. Raising the default prevents confusing timeout failures for new users.","status":"closed","priority":2,"issue_type":"task","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-12T14:27:59.761882257+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-12T14:45:27.102490973+07:00","closed_at":"2026-03-12T14:45:27.102490973+07:00","close_reason":"Closed"}
+{"id":"EV-37","title":"Parent-side backup & restore for direct-write mutations","description":"Root cause: SIGKILL is untrappable, so when a mutation times out the child's ensure block (rspec.rb:24-26) never runs. If Strategy B (direct file write, rspec.rb:50-58) was used, the original file is left in a mutated state on disk. Fix: before forking, the parent must save a backup of the original file content. After the child exits (normally or via kill), the parent verifies the file is restored and restores it if not. This is the primary fix for EV-35.","status":"closed","priority":0,"issue_type":"bug","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-12T14:32:49.590919391+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-12T23:04:21.990924732+07:00","closed_at":"2026-03-12T23:04:21.990924732+07:00","close_reason":"Implemented parent-side restore in Fork#call ensure block with read-before-write guard"}
+{"id":"EV-38","title":"Use SIGTERM with grace period before SIGKILL on timeout","description":"Defense-in-depth for EV-35. Currently fork.rb:45 sends SIGKILL immediately on timeout. SIGKILL is untrappable so the child gets no chance to run ensure blocks. Fix: send SIGTERM first (trappable), wait a short grace period (1-2s), then SIGKILL if still alive. This lets the child's ensure block restore files naturally in most timeout cases.","status":"closed","priority":0,"issue_type":"bug","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-12T14:32:52.463953548+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-13T00:34:44.01894518+07:00","closed_at":"2026-03-13T00:34:44.01894518+07:00","close_reason":"Implemented SIGTERM with grace period before SIGKILL fallback"}
+{"id":"EV-39","title":"Clean up leaked temp directories after child timeout (Strategy A)","description":"When Strategy A (temp dir, rspec.rb:44-49) is used and the child is killed on timeout, the temp directory is never cleaned up because the child's ensure block doesn't run. The parent should track and clean up any temp dirs created for mutation runs. Minor resource leak, not data corruption.","status":"closed","priority":0,"issue_type":"bug","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-12T14:32:54.466514555+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-13T00:34:31.932452641+07:00","closed_at":"2026-03-13T00:34:31.932452641+07:00","close_reason":"Implemented per-run sandbox TMPDIR for child processes, cleaned up by parent in ensure block"}
 {"id":"EV-4","title":"Phase 3: Performance Features","description":"Parallel execution pool, coverage-based mutation filtering, git diff-based targeting. Milestone: evilution run --diff HEAD~1 --jobs 4","status":"closed","priority":2,"issue_type":"epic","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-02T00:05:02.252877807+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-06T11:02:29.997677574+07:00","closed_at":"2026-03-02T11:54:32.782829837+07:00","close_reason":"Closed","dependencies":[{"issue_id":"EV-4","depends_on_id":"EV-3","type":"blocks","created_at":"0001-01-01T00:00:00Z"}]}
 {"id":"EV-4.1","title":"Implement Evilution::Parallel::Pool","description":"Thread-based worker pool distributing fork workers. Initialize with job_count. Method: #run(mutations, test_command, timeout:) -> [MutationResult]. Uses Queue to distribute work to N threads, each thread calls Isolation::Fork. File: lib/evilution/parallel/pool.rb + spec.","status":"closed","priority":2,"issue_type":"task","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-02T00:06:44.984077473+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-02T11:46:46.640997276+07:00","closed_at":"2026-03-02T11:46:46.640997276+07:00","close_reason":"Pool implementation and tests already exist and pass","dependencies":[{"issue_id":"EV-4.1","depends_on_id":"EV-4","type":"parent-child","created_at":"0001-01-01T00:00:00Z"},{"issue_id":"EV-4.1","depends_on_id":"EV-2.9","type":"blocks","created_at":"0001-01-01T00:00:00Z"}]}
 {"id":"EV-4.2","title":"Implement Evilution::Parallel::Worker","description":"Individual worker abstraction managing fork lifecycle. Wraps Isolation::Fork with queue consumption loop. File: lib/evilution/parallel/worker.rb + spec.","status":"closed","priority":2,"issue_type":"task","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-02T00:06:45.08570827+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-02T11:54:21.51846223+07:00","closed_at":"2026-03-02T11:54:21.51846223+07:00","close_reason":"Closed","dependencies":[{"issue_id":"EV-4.2","depends_on_id":"EV-4","type":"parent-child","created_at":"0001-01-01T00:00:00Z"},{"issue_id":"EV-4.2","depends_on_id":"EV-4.1","type":"blocks","created_at":"0001-01-01T00:00:00Z"}]}
@@ -63,6 +89,6 @@
 {"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-6","title":"Fix pool fork tests hanging in CI and WSL2","description":"The spec/evilution/parallel/pool_spec.rb fork-based tests hang on both WSL2 and GitHub Actions. CI currently excludes them via --exclude-pattern. Root cause is likely double-fork (Pool forks workers, each Worker uses Isolation::Fork which forks again) causing pipe/process management issues. Needs investigation and fix so pool tests run reliably in CI.","status":"closed","priority":1,"issue_type":"bug","owner":"denis.kiselyov@gmail.com","created_at":"2026-03-02T16:21:43.62587758+07:00","created_by":"Denis Kiselev","updated_at":"2026-03-05T12:31:51.831163433+07:00","closed_at":"2026-03-05T12:31:51.831163433+07:00","close_reason":"Closed"}
-{"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":"open","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-02T16:21:46.820210376+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-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/.claude/prompts/architect.md

@@ -73,7 +73,6 @@ Evilution
   ::Coverage::TestMap      # Source line → test file mapping
   ::Diff::Parser           # Git diff output parser
   ::Diff::FileFilter       # Filter subjects to changed code
-  ::Parallel::Pool         # Thread-based worker pool
   ::Result::MutationResult # Single mutation outcome
   ::Result::Summary        # Aggregated results
   ::Reporter::JSON         # Structured output for AI agents

data/CHANGELOG.md

@@ -1,5 +1,28 @@
 # Changelog
 
+## [0.2.0] - 2026-03-10
+
+### Added
+
+- **Line-range targeting** — scope mutations to exact lines: `lib/foo.rb:15-30`, `lib/foo.rb:15`, `lib/foo.rb:15-`
+- **Method-name targeting** (`--target`) — mutate a single method by fully-qualified name (e.g. `Foo::Bar#calculate`)
+- **Commands section** in `--help` output
+
+### Changed
+
+- Added `changelog_uri` to gemspec metadata
+- Added GitHub publish workflow
+
+### Deprecated
+
+- **`--diff` flag** — use line-range targeting instead
+- **Coverage-based filtering flags/config** (`--no-coverage` flag and `coverage` config key) — deprecated and now ignored; coverage-based filtering behavior has been removed from `Runner`
+
+### Removed
+
+- **Parallel execution** (`--jobs` flag) — simplifies codebase for AI-agent-first design; will be reintroduced later
+- **File-discovery logic** from `Integration::RSpec` — spec files are now passed explicitly or default to `spec/`
+
 ## [0.1.0] - 2026-03-02
 
 ### Added

data/README.md

@@ -1,11 +1,13 @@
+[![Gem Version](https://badge.fury.io/rb/evilution.svg)](https://badge.fury.io/rb/evilution)
+
 # Evilution — Mutation Testing for Ruby
 
 > **Purpose**: Validate test suite quality by injecting small code changes (mutations) and checking whether tests detect them. Surviving mutations indicate gaps in test coverage.
 
-**License**: MIT (free, no commercial restrictions)
-**Language**: Ruby >= 3.3
-**Parser**: Prism (Ruby's official AST parser, ships with Ruby 3.3+)
-**Test framework**: RSpec (currently the only supported integration)
+* **License**: MIT (free, no commercial restrictions)
+* **Language**: Ruby >= 3.3
+* **Parser**: Prism (Ruby's official AST parser, ships with Ruby 3.3+)
+* **Test framework**: RSpec (currently the only supported integration)
 
 ## Installation
 
@@ -37,12 +39,13 @@ evilution [command] [options] [files...]
 
 | Flag                    | Type    | Default      | Description                                       |
 |-------------------------|---------|--------------|---------------------------------------------------|
-| `-j`, `--jobs N`        | Integer | CPU cores    | Parallel worker count. Use `1` for sequential.    |
 | `-t`, `--timeout N`     | Integer | 10           | Per-mutation timeout in seconds.                   |
 | `-f`, `--format FORMAT` | String  | `text`       | Output format: `text` or `json`.                  |
-| `--diff BASE`           | String  | _(none)_     | Git ref. Only mutate methods whose definition line changed since BASE. |
+| `--target METHOD`       | String  | _(none)_     | Only mutate the named method (e.g. `Foo::Bar#calculate`). |
+| `--diff BASE`           | String  | _(none)_     | **DEPRECATED**: Use line-range targeting instead. Git ref. Only mutate methods whose definition line changed since BASE. |
 | `--min-score FLOAT`     | Float   | 0.0          | Minimum mutation score (0.0–1.0) to pass.         |
-| `--no-coverage`         | Boolean | false        | Reserved; currently has no effect.                |
+| `--spec FILES`          | Array   | _(none)_     | Spec files to run (comma-separated). Defaults to `spec/`. |
+| `--no-coverage`         | Boolean | false        | **DEPRECATED, NO-OP**: Kept for backward compatibility. Will be removed. |
 | `-v`, `--verbose`       | Boolean | false        | Verbose output.                                    |
 | `-q`, `--quiet`         | Boolean | false        | Suppress output.                                   |
 
@@ -61,12 +64,10 @@ Generate default config: `bundle exec evilution init`
 Creates `.evilution.yml`:
 
 ```yaml
-# jobs: 4            # parallel workers
 # timeout: 10        # seconds per mutation
 # format: text       # text | json
 # min_score: 0.0     # 0.0–1.0
 # integration: rspec # test framework
-# coverage: true     # skip mutations on uncovered lines
 ```
 
 **Precedence**: CLI flags override `.evilution.yml` values.
@@ -137,20 +138,51 @@ Each operator name is stable and appears in JSON output under `survived[].operat
 ### 1. Full project scan
 
 ```bash
-bundle exec evilution run lib/ --format json --jobs 4 --min-score 0.8
+bundle exec evilution run lib/ --format json --min-score 0.8
 ```
 
 Parse JSON output. Exit code 0 = pass, 1 = surviving mutants to address.
 
-### 2. PR / diff-only scan (fast feedback)
+### 2. PR / changed-lines scan (fast feedback)
+
+```bash
+bundle exec evilution run lib/foo.rb:15-30 lib/bar.rb:5-20 --format json --min-score 0.9
+```
+
+Target the exact lines you changed for fast, focused mutation testing. See line-range syntax below.
+
+> **Note**: `--diff BASE` is deprecated and will be removed in a future version. Prefer line-range targeting for new workflows.
+
+### 3. Line-range targeted scan (fastest)
+
+```bash
+bundle exec evilution run lib/foo.rb:15-30 --format json
+```
+
+Target exact lines you changed. Supports multiple syntaxes:
+
+```bash
+evilution run lib/foo.rb:15-30    # lines 15 through 30
+evilution run lib/foo.rb:15       # single line 15
+evilution run lib/foo.rb:15-      # from line 15 to end of file
+evilution run lib/foo.rb          # whole file (existing behavior)
+```
+
+Methods whose body overlaps the requested range are included. Mix targeted and whole-file arguments freely:
+
+```bash
+evilution run lib/foo.rb:15-30 lib/bar.rb --format json
+```
+
+### 4. Method-name targeted scan
 
 ```bash
-bundle exec evilution run lib/ --format json --diff main --min-score 0.9
+bundle exec evilution run lib/foo.rb --target Foo::Bar#calculate --format json
 ```
 
-Mutates methods whose definition (starting) line is changed compared to `main` (the diff filter is based on the method’s first line, not any line in its body). Use this for incremental checks — it's fast and focused on newly added or moved methods and changed signatures.
+Target a specific method by its fully-qualified name. Useful when you want to focus on a single method without knowing its exact line numbers.
 
-### 3. Single-file targeted scan
+### 5. Single-file targeted scan
 
 ```bash
 bundle exec evilution run lib/specific_file.rb --format json
@@ -158,7 +190,7 @@ bundle exec evilution run lib/specific_file.rb --format json
 
 Use when you know which file was modified and want to verify its test coverage.
 
-### 4. Fixing surviving mutants
+### 6. Fixing surviving mutants
 
 For each entry in `survived[]`:
 1. Read `file` at `line` to understand the code context
@@ -167,7 +199,7 @@ For each entry in `survived[]`:
 4. Write a test that would fail if the mutation were applied
 5. Re-run evilution on just that file to verify the mutant is now killed
 
-### 5. CI gate
+### 7. CI gate
 
 ```bash
 bundle exec evilution run lib/ --format json --min-score 0.8 --quiet

data/lib/evilution/cli.rb

@@ -11,7 +11,27 @@ module Evilution
       @options = {}
       @command = :run
       argv = argv.dup
+      argv = extract_command(argv)
+      argv = warn_removed_flags(argv)
+      raw_args = build_option_parser.parse!(argv)
+      @files, @line_ranges = parse_file_args(raw_args)
+    end
 
+    def call
+      case @command
+      when :version
+        $stdout.puts(VERSION)
+        0
+      when :init
+        run_init
+      when :run
+        run_mutations
+      end
+    end
+
+    private
+
+    def extract_command(argv)
       case argv.first
       when "version"
         @command = :version
@@ -22,37 +42,65 @@ module Evilution
       when "run"
         argv.shift
       end
+      argv
+    end
+
+    def warn_removed_flags(argv)
+      result = []
+      i = 0
+      while i < argv.length
+        arg = argv[i]
+        if %w[--jobs -j].include?(arg)
+          warn("Warning: --jobs is no longer supported and will be ignored.")
+          next_arg = argv[i + 1]
+          i += next_arg&.match?(/\A-?\d+\z/) ? 2 : 1
+        elsif arg.start_with?("--jobs=") || arg.match?(/\A-j-?\d+\z/)
+          warn("Warning: --jobs is no longer supported and will be ignored.")
+          i += 1
+        else
+          result << arg
+          i += 1
+        end
+      end
+      result
+    end
 
-      parser = OptionParser.new do |opts|
+    def build_option_parser
+      OptionParser.new do |opts|
         opts.banner = "Usage: evilution [command] [options] [files...]"
-
-        opts.on("-j", "--jobs N", Integer, "Number of parallel workers") { |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", "Only mutate code changed since BASE") { |b| @options[:diff_base] = b }
-        opts.on("--min-score FLOAT", Float, "Minimum mutation score to pass") { |s| @options[:min_score] = s }
-        opts.on("--no-coverage", "Disable coverage-based filtering of uncovered mutations") { @options[:coverage] = false }
-        opts.on("-v", "--verbose", "Verbose output") { @options[:verbose] = true }
-        opts.on("-q", "--quiet", "Suppress output") { @options[:quiet] = true }
+        add_separators(opts)
+        add_options(opts)
       end
+    end
 
-      @files = parser.parse!(argv)
+    def add_separators(opts)
+      opts.separator ""
+      opts.separator "Line-range targeting: lib/foo.rb:15-30, lib/foo.rb:15, lib/foo.rb:15-"
+      opts.separator ""
+      opts.separator "Commands: run (default), init, version"
+      opts.separator ""
+      opts.separator "Options:"
     end
 
-    def call
-      case @command
-      when :version
-        $stdout.puts(VERSION)
-        0
-      when :init
-        run_init
-      when :run
-        run_mutations
+    def add_options(opts)
+      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("--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
+      opts.on("-v", "--verbose", "Verbose output") { @options[:verbose] = true }
+      opts.on("-q", "--quiet", "Suppress output") { @options[:quiet] = true }
     end
 
-    private
-
     def run_init
       path = ".evilution.yml"
       if File.exist?(path)
@@ -65,8 +113,35 @@ module Evilution
       0
     end
 
+    def parse_file_args(raw_args)
+      files = []
+      ranges = {}
+
+      raw_args.each do |arg|
+        file, range_str = arg.split(":", 2)
+        files << file
+        next unless range_str
+
+        ranges[file] = parse_line_range(range_str)
+      end
+
+      [files, ranges]
+    end
+
+    def parse_line_range(str)
+      if str.include?("-")
+        start_str, end_str = str.split("-", 2)
+        start_line = Integer(start_str)
+        end_line = end_str.empty? ? Float::INFINITY : Integer(end_str)
+        start_line..end_line
+      else
+        line = Integer(str)
+        line..line
+      end
+    end
+
     def run_mutations
-      config = Config.new(**@options, target_files: @files)
+      config = Config.new(**@options, target_files: @files, line_ranges: @line_ranges)
       runner = Runner.new(config: config)
       summary = runner.call
       summary.success?(min_score: config.min_score) ? 0 : 1

data/lib/evilution/config.rb

@@ -7,8 +7,7 @@ module Evilution
     CONFIG_FILES = %w[.evilution.yml config/evilution.yml].freeze
 
     DEFAULTS = {
-      jobs: nil,
-      timeout: 10,
+      timeout: 30,
       format: :text,
       diff_base: nil,
       target: nil,
@@ -16,17 +15,20 @@ module Evilution
       integration: :rspec,
       coverage: true,
       verbose: false,
-      quiet: false
+      quiet: false,
+      line_ranges: {},
+      spec_files: []
     }.freeze
 
-    attr_reader :target_files, :jobs, :timeout, :format, :diff_base,
-                :target, :min_score, :integration, :coverage, :verbose, :quiet
+    attr_reader :target_files, :timeout, :format, :diff_base,
+                :target, :min_score, :integration, :coverage, :verbose, :quiet,
+                :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)
       @target_files = Array(merged[:target_files])
-      @jobs = merged[:jobs] || default_jobs
       @timeout = merged[:timeout]
       @format = merged[:format].to_sym
       @diff_base = merged[:diff_base]
@@ -36,6 +38,8 @@ module Evilution
       @coverage = merged[:coverage]
       @verbose = merged[:verbose]
       @quiet = merged[:quiet]
+      @line_ranges = merged[:line_ranges] || {}
+      @spec_files = Array(merged[:spec_files])
       freeze
     end
 
@@ -51,17 +55,22 @@ module Evilution
       !diff_base.nil?
     end
 
+    def line_ranges?
+      !line_ranges.empty?
+    end
+
+    def target?
+      !target.nil?
+    end
+
     # Generates a default config file template.
     def self.default_template
       <<~YAML
         # Evilution configuration
         # See: https://github.com/marinazzio/evilution
 
-        # Number of parallel workers (default: number of CPU cores)
-        # jobs: 4
-
-        # Per-mutation timeout in seconds (default: 10)
-        # timeout: 10
+        # Per-mutation timeout in seconds (default: 30)
+        # timeout: 30
 
         # Output format: text or json (default: text)
         # format: text
@@ -72,13 +81,30 @@ module Evilution
         # Test integration: rspec (default: rspec)
         # integration: rspec
 
-        # Skip mutations on uncovered lines (default: true)
+        # DEPRECATED: Coverage filtering is deprecated and will be removed
         # coverage: true
       YAML
     end
 
     private
 
+    def warn_removed_options(merged, file_options)
+      if merged.key?(:jobs)
+        warn("Warning: 'jobs' option is no longer supported and will be ignored. " \
+             "Remove it from your configuration or invocation.")
+      end
+
+      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
       CONFIG_FILES.each do |path|
         next unless File.exist?(path)
@@ -89,10 +115,5 @@ module Evilution
 
       {}
     end
-
-    def default_jobs
-      require "etc"
-      Etc.nprocessors
-    end
   end
 end

data/lib/evilution/integration/rspec.rb

@@ -108,77 +108,10 @@ module Evilution
         { passed: false, error: e.message }
       end
 
-      def build_args(mutation)
-        files = test_files || detect_test_files(mutation)
+      def build_args(_mutation)
+        files = test_files || ["spec"]
         ["--format", "progress", "--no-color", "--order", "defined", *files]
       end
-
-      def detect_test_files(mutation)
-        # Convention: lib/foo/bar.rb -> spec/foo/bar_spec.rb
-        candidates = spec_file_candidates(mutation.file_path)
-        found = candidates.select { |f| File.exist?(f) }
-        return found unless found.empty?
-
-        # Fallback: find spec/ directory relative to the mutation's project root
-        fallback = fallback_spec_dir(mutation.file_path)
-        return [fallback] if fallback
-
-        []
-      end
-
-      def fallback_spec_dir(source_path)
-        expanded = File.expand_path(source_path)
-
-        # Derive spec/ from mutation's project, not CWD
-        if expanded.include?("/lib/")
-          project_root = expanded.split(%r{/lib/}, 2).first
-          spec_dir = File.join(project_root, "spec")
-          return spec_dir if Dir.exist?(spec_dir)
-        end
-
-        # Walk up from the file's directory looking for spec/
-        dir = File.dirname(expanded)
-        loop do
-          spec_dir = File.join(dir, "spec")
-          return spec_dir if Dir.exist?(spec_dir)
-
-          parent = File.dirname(dir)
-          break if parent == dir
-
-          dir = parent
-        end
-
-        nil
-      end
-
-      def spec_file_candidates(source_path)
-        candidates = []
-
-        if source_path.start_with?("lib/")
-          # lib/foo/bar.rb -> spec/foo/bar_spec.rb
-          relative = source_path.sub(%r{^lib/}, "")
-          spec_name = relative.sub(/\.rb$/, "_spec.rb")
-          candidates << File.join("spec", spec_name)
-          candidates << File.join("spec", "unit", spec_name)
-        elsif source_path.include?("/lib/")
-          # /absolute/path/lib/foo/bar.rb -> /absolute/path/spec/foo/bar_spec.rb
-          prefix, relative = source_path.split(%r{/lib/}, 2)
-          spec_name = relative.sub(/\.rb$/, "_spec.rb")
-          candidates << File.join(prefix, "spec", spec_name)
-          candidates << File.join(prefix, "spec", "unit", spec_name)
-        end
-
-        # Same directory: foo/bar.rb -> foo/bar_spec.rb
-        sibling_spec = source_path.sub(/\.rb$/, "_spec.rb")
-        candidates << sibling_spec
-
-        # Subdirectory spec/ variant: foo/bar.rb -> foo/spec/bar_spec.rb
-        dir = File.dirname(source_path)
-        base = File.basename(source_path, ".rb")
-        candidates << File.join(dir, "spec", "#{base}_spec.rb")
-
-        candidates.uniq
-      end
     end
   end
 end

data/lib/evilution/isolation/fork.rb

@@ -1,13 +1,20 @@
 # frozen_string_literal: true
 
+require "fileutils"
+require "tmpdir"
+
 module Evilution
   module Isolation
     class Fork
+      GRACE_PERIOD = 2
+
       def call(mutation:, test_command:, timeout:)
+        sandbox_dir = Dir.mktmpdir("evilution-run")
         start_time = Process.clock_gettime(Process::CLOCK_MONOTONIC)
         read_io, write_io = IO.pipe
 
         pid = ::Process.fork do
+          ENV["TMPDIR"] = sandbox_dir
           read_io.close
           result = execute_in_child(mutation, test_command)
           Marshal.dump(result, write_io)
@@ -23,10 +30,20 @@ module Evilution
       ensure
         read_io&.close
         write_io&.close
+        restore_original_source(mutation)
+        FileUtils.rm_rf(sandbox_dir) if sandbox_dir
       end
 
       private
 
+      def restore_original_source(mutation)
+        return if File.read(mutation.file_path) == mutation.original_source
+
+        File.write(mutation.file_path, mutation.original_source)
+      rescue StandardError => e
+        warn("Warning: failed to restore #{mutation.file_path}: #{e.message}")
+      end
+
       def execute_in_child(mutation, test_command)
         test_command.call(mutation)
       rescue StandardError => e
@@ -42,12 +59,24 @@ module Evilution
           ::Process.wait(pid) rescue nil # rubocop:disable Style/RescueModifier
           { timeout: false, passed: false, error: "empty result from child" }
         else
-          ::Process.kill("KILL", pid) rescue nil # rubocop:disable Style/RescueModifier
-          ::Process.wait(pid) rescue nil # rubocop:disable Style/RescueModifier
+          terminate_child(pid)
           { timeout: true }
         end
       end
 
+      def terminate_child(pid)
+        ::Process.kill("TERM", pid) rescue nil # rubocop:disable Style/RescueModifier
+        _, status = ::Process.waitpid2(pid, ::Process::WNOHANG)
+        return if status
+
+        sleep(GRACE_PERIOD)
+        _, status = ::Process.waitpid2(pid, ::Process::WNOHANG)
+        return if status
+
+        ::Process.kill("KILL", pid) rescue nil # rubocop:disable Style/RescueModifier
+        ::Process.wait(pid) rescue nil # rubocop:disable Style/RescueModifier
+      end
+
       def build_mutation_result(mutation, result, duration)
         status = if result[:timeout]
                    :timeout

data/lib/evilution/runner.rb

@@ -4,13 +4,10 @@ require_relative "config"
 require_relative "ast/parser"
 require_relative "mutator/registry"
 require_relative "isolation/fork"
-require_relative "parallel/pool"
 require_relative "integration/rspec"
 require_relative "reporter/json"
 require_relative "reporter/cli"
 require_relative "reporter/suggestion"
-require_relative "coverage/collector"
-require_relative "coverage/test_map"
 require_relative "diff/parser"
 require_relative "diff/file_filter"
 require_relative "result/mutation_result"
@@ -31,12 +28,11 @@ module Evilution
       start_time = Process.clock_gettime(Process::CLOCK_MONOTONIC)
 
       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?
       mutations = generate_mutations(subjects)
-      test_map = collect_coverage if config.coverage && config.integration == :rspec
-      mutations, skipped = filter_by_coverage(mutations, test_map) if test_map
       results = run_mutations(mutations)
-      results.concat(skipped) if skipped
       duration = Process.clock_gettime(Process::CLOCK_MONOTONIC) - start_time
 
       summary = Result::Summary.new(results: results, duration: duration)
@@ -53,6 +49,24 @@ module Evilution
       config.target_files.flat_map { |file| parser.call(file) }
     end
 
+    def filter_by_target(subjects)
+      matched = subjects.select { |s| s.name == config.target }
+      raise Error, "no method found matching '#{config.target}'" if matched.empty?
+
+      matched
+    end
+
+    def filter_by_line_ranges(subjects)
+      subjects.select do |subject|
+        range = config.line_ranges[subject.file_path]
+        next true unless range
+
+        subject_start = subject.line_number
+        subject_end = subject_start + subject.source.count("\n")
+        subject_start <= range.last && subject_end >= range.first
+      end
+    end
+
     def filter_by_diff(subjects)
       diff_parser = Diff::Parser.new
       changed_ranges = diff_parser.parse(config.diff_base)
@@ -63,37 +77,9 @@ module Evilution
       subjects.flat_map { |subject| registry.mutations_for(subject) }
     end
 
-    def collect_coverage
-      test_files = Dir.glob("spec/**/*_spec.rb")
-      return nil if test_files.empty?
-
-      data = Coverage::Collector.new.call(test_files: test_files)
-      Coverage::TestMap.new(data)
-    end
-
-    def filter_by_coverage(mutations, test_map)
-      covered, uncovered = mutations.partition do |m|
-        test_map.covered?(File.expand_path(m.file_path), m.line)
-      end
-
-      skipped = uncovered.map do |m|
-        Result::MutationResult.new(mutation: m, status: :survived, duration: 0.0)
-      end
-
-      [covered, skipped]
-    end
-
     def run_mutations(mutations)
       integration = build_integration
 
-      if config.jobs > 1 && mutations.size > 1
-        run_parallel(mutations, integration)
-      else
-        run_sequential(mutations, integration)
-      end
-    end
-
-    def run_sequential(mutations, integration)
       mutations.map do |mutation|
         test_command = ->(m) { integration.call(m) }
         isolator.call(
@@ -104,16 +90,11 @@ module Evilution
       end
     end
 
-    def run_parallel(mutations, integration)
-      pool = Parallel::Pool.new(jobs: config.jobs)
-      test_command_builder = ->(_mutation) { ->(m) { integration.call(m) } }
-      pool.call(mutations: mutations, test_command_builder: test_command_builder, timeout: config.timeout)
-    end
-
     def build_integration
       case config.integration
       when :rspec
-        Integration::RSpec.new
+        test_files = config.spec_files.empty? ? nil : config.spec_files
+        Integration::RSpec.new(test_files: test_files)
       else
         raise Error, "unknown integration: #{config.integration}"
       end

data/lib/evilution/version.rb

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

data/lib/evilution.rb

@@ -27,8 +27,6 @@ require_relative "evilution/mutator/operator/return_value_removal"
 require_relative "evilution/mutator/operator/collection_replacement"
 require_relative "evilution/mutator/registry"
 require_relative "evilution/isolation/fork"
-require_relative "evilution/parallel/worker"
-require_relative "evilution/parallel/pool"
 require_relative "evilution/diff/parser"
 require_relative "evilution/diff/file_filter"
 require_relative "evilution/integration/base"

metadata

@@ -1,13 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: evilution
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Denis Kiselev
+autorequire:
 bindir: exe
 cert_chain: []
-date: 1980-01-02 00:00:00.000000000 Z
+date: 2026-03-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: diff-lcs
@@ -89,8 +90,6 @@ files:
 - 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/parallel/worker.rb
 - lib/evilution/reporter/cli.rb
 - lib/evilution/reporter/json.rb
 - lib/evilution/reporter/suggestion.rb
@@ -107,9 +106,11 @@ metadata:
   allowed_push_host: https://rubygems.org
   bug_tracker_uri: https://github.com/marinazzio/evilution/issues
   documentation_uri: https://github.com/marinazzio/evilution/blob/master/README.md
+  changelog_uri: https://github.com/marinazzio/evilution/blob/master/CHANGELOG.md
   homepage_uri: https://github.com/marinazzio/evilution
   rubygems_mfa_required: 'true'
   source_code_uri: https://github.com/marinazzio/evilution
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -124,7 +125,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.3
+rubygems_version: 3.5.22
+signing_key:
 specification_version: 4
 summary: Free, MIT-licensed mutation testing for Ruby
 test_files: []

data/lib/evilution/parallel/pool.rb

@@ -1,98 +0,0 @@
-# frozen_string_literal: true
-
-module Evilution
-  module Parallel
-    class Pool
-      def initialize(jobs:)
-        @jobs = jobs
-      end
-
-      # Executes mutations in parallel across N worker processes.
-      #
-      # @param mutations [Array] Array of mutation objects to run
-      # @param test_command_builder [#call] Callable that receives a mutation and returns a test command callable
-      # @param timeout [Numeric] Per-mutation timeout in seconds
-      # @return [Array<Result::MutationResult>]
-      def call(mutations:, test_command_builder:, timeout:)
-        return [] if mutations.empty?
-
-        worker_count = [@jobs, mutations.size].min
-        chunks = partition(mutations, worker_count)
-
-        pipes = worker_count.times.map { IO.pipe }
-
-        pids = chunks.each_with_index.map do |chunk, index|
-          _, write_io = pipes[index]
-
-          pid = Process.fork do
-            # Close all read ends in the child; close sibling write ends too
-            pipes.each_with_index do |(r, w), i|
-              if i == index
-                r.close
-              else
-                r.close
-                w.close
-              end
-            end
-
-            results = run_chunk(chunk, test_command_builder, timeout)
-            Marshal.dump(results, write_io)
-            write_io.close
-            exit!(0)
-          end
-
-          write_io.close
-          pid
-        end
-
-        results = collect_results(pipes.map(&:first), pids)
-
-        results
-      ensure
-        # Ensure all pipes are closed even if something goes wrong
-        pipes&.each do |read_io, write_io|
-          read_io.close unless read_io.closed?
-          write_io.close unless write_io.closed?
-        end
-      end
-
-      private
-
-      attr_reader :jobs
-
-      # Distributes mutations across N chunks using round-robin.
-      # File isolation is handled by Integration::RSpec via temp directories
-      # and $LOAD_PATH, so same-file mutations can safely run in parallel.
-      def partition(mutations, n)
-        chunks = Array.new(n) { [] }
-        mutations.each_with_index { |m, i| chunks[i % n] << m }
-        chunks
-      end
-
-      # Runs a chunk of mutations sequentially inside a worker process.
-      def run_chunk(mutations, test_command_builder, timeout)
-        worker = Worker.new
-        worker.call(mutations: mutations, test_command_builder: test_command_builder, timeout: timeout)
-      end
-
-      # Reads results from all worker pipes and waits for workers to finish.
-      def collect_results(read_ios, pids)
-        results = []
-
-        read_ios.each_with_index do |read_io, _index|
-          data = read_io.read
-          read_io.close
-
-          unless data.empty?
-            chunk_results = Marshal.load(data) # rubocop:disable Security/MarshalLoad
-            results.concat(chunk_results)
-          end
-        end
-
-        pids.each { |pid| Process.wait(pid) rescue nil } # rubocop:disable Style/RescueModifier
-
-        results
-      end
-    end
-  end
-end

data/lib/evilution/parallel/worker.rb

@@ -1,24 +0,0 @@
-# frozen_string_literal: true
-
-module Evilution
-  module Parallel
-    class Worker
-      def initialize(isolator: Isolation::Fork.new)
-        @isolator = isolator
-      end
-
-      # Runs a batch of mutations sequentially using fork isolation.
-      #
-      # @param mutations [Array<Mutation>] Mutations to execute
-      # @param test_command_builder [#call] Receives a mutation, returns a test command callable
-      # @param timeout [Numeric] Per-mutation timeout in seconds
-      # @return [Array<Result::MutationResult>]
-      def call(mutations:, test_command_builder:, timeout:)
-        mutations.map do |mutation|
-          test_command = test_command_builder.call(mutation)
-          @isolator.call(mutation: mutation, test_command: test_command, timeout: timeout)
-        end
-      end
-    end
-  end
-end