mutineer 0.6.1 → 0.6.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 88e7dbea9ba80b3fed23d634e30830372c89e2f42cf7403d8fa5860d80ba17dd
-  data.tar.gz: ac519c7e8c6e301e46242af5bd6a94672aa0a95f2d8dc46dfbd5e3b2611c366c
+  metadata.gz: b549b3640aa316aa715732f4e91f3be669b7ab8e7ad877b8207d0e31ac12b4aa
+  data.tar.gz: a626241007cf47b4fb0ef3c68dc1fba7f0c8679d0c41db516dca888893fc5f51
 SHA512:
-  metadata.gz: 5e49d3e6fef7dddc74b93c6e1216a5740e556f0c9b1ba1d684cc28b61c3f464063669ad04468dc0d0882a1a141050d62c96e6f9995b8b0e541f38e94d9fbac7a
-  data.tar.gz: d70b8231caef83f5b55a9ee840cb77cdf16b8c93c8f227d7f278266db44584577eb17ca589eba677d3896dceae03b8e71a43f8b7747f7046060aa659d9b55d58
+  metadata.gz: ba4d45a6ba52ead7da7f580452eb610bfc23b368501c496e80ffa56e2e364a62fcf896a1e9d37c50b1216727eb8a6a02386ba0917c85397ac61a3f2a9f41d694
+  data.tar.gz: 6be383459b367be9b72135b1672d57c63bd4e4a6c032c3301532f50a1bcb96dff2cc6ecf764979d6009fab9e4c1e4d327fbb1e81cf3652232cb38a2eb6a82558

data/CHANGELOG.md

@@ -4,6 +4,20 @@ All notable changes to this project are documented here. The format is based on
 [Keep a Changelog](https://keepachangelog.com/), and this project adheres to
 [Semantic Versioning](https://semver.org/).
 
+## [0.6.2] - 2026-06-29
+
+### Fixed
+- **`--rails` defaults `RAILS_ENV` to `test`** (#7) — an unset `RAILS_ENV` booted
+  development, where the suite isn't loaded, so every mutant was falsely reported
+  `no_coverage` (score N/A, exit 0). An explicit `RAILS_ENV` is respected.
+- **`--rails` defaults to `--jobs 1`** (#12) — parallel mutant forks share one
+  database and deadlock on transactional fixtures; explicit `--jobs N` opts back
+  into parallelism.
+
+### Added
+- **Tier-2 operator discoverability** (#14) — the human-format run summary now
+  lists the available opt-in tier-2 operators and how to enable them.
+
 ## [0.6.1] - 2026-06-29
 
 ### Changed
@@ -86,6 +100,7 @@ All notable changes to this project are documented here. The format is based on
 - `.mutineer.yml` configuration (CLI > config > default precedence).
 - Byte-correct source handling for multibyte (UTF-8) sources.
 
+[0.6.2]: https://github.com/davidteren/mutineer/releases/tag/v0.6.2
 [0.6.1]: https://github.com/davidteren/mutineer/releases/tag/v0.6.1
 [0.6.0]: https://github.com/davidteren/mutineer/releases/tag/v0.6.0
 [0.5.0]: https://github.com/davidteren/mutineer/releases/tag/v0.5.0

data/README.md

@@ -1,5 +1,7 @@
 # Mutineer
 
+[![Socket Badge](https://badge.socket.dev/rubygems/package/mutineer/0.6.2?platform=ruby)](https://socket.dev/rubygems/package/mutineer/overview/0.6.2?platform=ruby)
+
 A clean-room mutation-testing tool for Ruby. Mutineer mutates your source one
 change at a time, runs your test suite (Minitest or RSpec) against each mutant, and reports the
 ones your tests failed to catch — the gaps where your suite isn't actually

data/lib/mutineer/cli.rb

@@ -257,9 +257,27 @@ module Mutineer
       reporter = Reporter.new(aggregate, source_map)
       reporter.report(out: $stdout, err: $stderr, threshold: config.threshold,
                       format: config.format, output: config.output)
+
+      # #14: nudge toward the opt-in tier-2 operators (human report only — never
+      # pollute JSON output).
+      if config.format != "json" && (hint = tier2_hint(config.operators))
+        puts hint
+      end
+
       exit reporter.exit_code(threshold: config.threshold)
     end
 
+    # The tier-2 operators not in the active set, as a one-line hint (or nil when
+    # they're all already enabled). `active` nil means the default (Tier-1) set.
+    def self.tier2_hint(active)
+      active ||= MutatorRegistry::DEFAULT_NAMES
+      unused = MutatorRegistry::TIER2_NAMES - active
+      return if unused.empty?
+
+      "#{unused.size} tier-2 operators available (#{unused.join(', ')}) — " \
+        "enable with --operators <list>."
+    end
+
     def self.dry_run(config)
       operator_classes = MutatorRegistry.resolve(config.operators || MutatorRegistry::DEFAULT_NAMES)
       sources = {}

data/lib/mutineer/config.rb

@@ -108,6 +108,11 @@ module Mutineer
       if config.rails
         config.boot ||= "config/environment"
         config.strategy = "redefine" unless explicit.include?(:strategy)
+        # #12: parallel mutant forks share one database; transactional-fixture
+        # setup/teardown across processes contends and deadlocks. Default to
+        # serial under --rails; an explicit --jobs N opts back into parallelism
+        # (with the per-worker DB-isolation that implies).
+        config.jobs = 1 unless explicit.include?(:jobs)
       end
 
       # Auto-detect the framework only when neither CLI nor config file set it

data/lib/mutineer/runner.rb

@@ -40,6 +40,11 @@ module Mutineer
       # parse that needs nothing loaded. Standalone mode requires the sources as
       # before so their classes exist for the children to inherit.
       if config.boot
+        # #7: under --rails an unset RAILS_ENV boots development, where the test
+        # suite isn't loaded — coverage comes back empty and EVERY mutant is
+        # falsely reported no_coverage (score N/A, exit 0). Default it to test.
+        ensure_rails_env(config)
+
         # Coverage instruments only files loaded AFTER it starts. Start it BEFORE
         # the boot require so the entire app loaded during boot is instrumented;
         # forked children then measure each test's coverage delta against it.
@@ -152,6 +157,17 @@ module Mutineer
       end.uniq
     end
 
+    # #7: when --rails is on and RAILS_ENV is unset, default it to "test" (and
+    # say so) before the app boots — otherwise it boots development and nothing
+    # is measured. An explicitly-set RAILS_ENV is always respected.
+    def self.ensure_rails_env(config)
+      return unless config.rails
+      return unless ENV["RAILS_ENV"].nil? || ENV["RAILS_ENV"].empty?
+
+      ENV["RAILS_ENV"] = "test"
+      warn "[mutineer] RAILS_ENV was unset; defaulting to 'test' for --rails."
+    end
+
     def self.sweep_orphans(dirs)
       dirs.each do |dir|
         Dir.glob(File.join(dir, "mutineer_mutant*.rb")).each do |f|

data/lib/mutineer/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Mutineer
-  VERSION = "0.6.1"
+  VERSION = "0.6.2"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: mutineer
 version: !ruby/object:Gem::Version
-  version: 0.6.1
+  version: 0.6.2
 platform: ruby
 authors:
 - David Teren