evilution 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 34fdc4c7cf9abac2c71dc0aa7d1aa4e4452e6237b8f1564c2dd92db2f5746cf5
-  data.tar.gz: 6d7bb8ef692815bbc62d8ca2a3446ee642bdc2c1834856064a48e4c311256b63
+  metadata.gz: d8dc33cb03f8b2d2d94c2ca64ade2397c1933c1b431c5b804637949451ede95d
+  data.tar.gz: 36bf7bc0172dd6a7262f5ef8c716dbe64662c1c7c2c7a05b0ef0109d3479131d
 SHA512:
-  metadata.gz: 9f08ab9b14a0b43e26a15e499d65ce819f5443efa77311ff45bccf3ae230b3f4fc61bc1d20cf4beb464b6c70ca82964a21a5f8d889edb30b5ab2f18f8af3ca44
-  data.tar.gz: 84ba0567669d197cc56a2723a5e0fdeca84cf2b74085b5a273d9d7279211d156397ae520e7986fba81562393d25e21e3c99a1b6626cf472f79eeae11fede48ba
+  metadata.gz: d8ae3315b4c8b118e60f2a84c1d9d7854fb9f666997db5ae5697d6d9ac12838724a6be10627cc2c30bb2c8bd5e4f7babb97086fb27616b378e07e1fcc9c0ca0e
+  data.tar.gz: 557abcaebed599383335a06f913c04565513240e984f65304d4fd8f547c38dc0bc58d8c34a7f465d3947df56ba88277516970b87e791f1811d323a6f3b8562fe

data/.beads/.migration-hint-ts

@@ -1 +1 @@
-1772686671
+1773064889

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,7 @@
 {"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-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 +37,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"}]}
@@ -63,6 +70,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

@@ -37,12 +37,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 +62,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 +136,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/ --format json --diff main --min-score 0.9
+bundle exec evilution run lib/foo.rb:15-30 lib/bar.rb:5-20 --format json --min-score 0.9
 ```
 
-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 the exact lines you changed for fast, focused mutation testing. See line-range syntax below.
 
-### 3. Single-file targeted scan
+> **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/foo.rb --target Foo::Bar#calculate --format json
+```
+
+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.
+
+### 5. Single-file targeted scan
 
 ```bash
 bundle exec evilution run lib/specific_file.rb --format json
@@ -158,7 +188,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 +197,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,7 +7,6 @@ module Evilution
     CONFIG_FILES = %w[.evilution.yml config/evilution.yml].freeze
 
     DEFAULTS = {
-      jobs: nil,
       timeout: 10,
       format: :text,
       diff_base: 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,15 +55,20 @@ 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
 
@@ -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/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.2.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.2.0
 platform: ruby
 authors:
 - Denis Kiselev
+autorequire:
 bindir: exe
 cert_chain: []
-date: 1980-01-02 00:00:00.000000000 Z
+date: 2026-03-09 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