active_mutator 0.1.1 → 0.2.0

data/lib/active_mutator/timeout_calibrator.rb

@@ -0,0 +1,75 @@
+module ActiveMutator
+  # Adaptive timeout budgets (#9). Static budgets derive from baseline times
+  # measured warm and unloaded; under parallel load they misclassify
+  # slow-but-honest kills as timeouts. The Scheduler feeds this with the
+  # observed wall time of every KILLED fork (errors exit artificially fast,
+  # survivors run their whole covering set — both would bias the median;
+  # timed-out forks have no known wall time at all). One instance per lane:
+  # parallel and serial run under different load regimes.
+  #
+  # Utilization is elapsed / the EFFECTIVE budget the fork ran under (the
+  # value budget_for returned at its spawn), not the static item.timeout —
+  # otherwise a pinned-high scale could never observe recovery (ratchet).
+  # Once WARMUP observations exist, remaining budgets' variable part is
+  # scaled by the clamped median utilization. The fixed part (timeout_floor
+  # + browser boot) is never scaled: fork boot cost does not shrink because
+  # examples run fast.
+  #
+  # The scale is grow-only (MIN_SCALE = 1.0): budgets may only extend beyond
+  # the static value, never fall below it. Downscaling has no recovery signal
+  # because timeouts are CENSORED samples — the scheduler skips them (they have
+  # no known wall time), so only killed forks feed the window. A low median
+  # utilization would shrink the budget, causing a legitimately slow kill to be
+  # reaped as a timeout; that censored kill never enters the window, so nothing
+  # ever pushes utilization back up. The shrink self-sustains — an asymmetric
+  # ratchet. Growing is safe (a too-large budget still records a real kill and
+  # relaxes); shrinking is not, so we forbid it.
+  class TimeoutCalibrator
+    WARMUP = 5
+    # A real sliding window, not full-run history: a 500-mutant run's early
+    # load regime must age out completely instead of anchoring the median
+    # forever. 30 samples is enough for a stable median and small enough to
+    # track load changes within a few dozen finishes.
+    WINDOW = 30
+    TARGET_UTILIZATION = 0.25
+    MIN_SCALE = 1.0
+    MAX_SCALE = 4.0
+
+    def initialize
+      @utilizations = []
+    end
+
+    def record(elapsed_seconds, budget)
+      return unless budget.positive?
+
+      @utilizations << elapsed_seconds / budget
+      @utilizations.shift while @utilizations.size > WINDOW
+    end
+
+    def warmed? = @utilizations.size >= WARMUP
+
+    def budget_for(item)
+      return item.timeout unless warmed?
+
+      fixed = item.timeout - item.variable
+      item.variable * scale + fixed
+    end
+
+    def scale
+      # An empty window has no median; a caller invoking scale without warmed?
+      # (median of [] is nil) would otherwise raise. Neutral scale = no change.
+      return 1.0 if @utilizations.empty?
+
+      s = median(@utilizations) / TARGET_UTILIZATION
+      s.clamp(MIN_SCALE, MAX_SCALE)
+    end
+
+    private
+
+    def median(values)
+      sorted = values.sort
+      mid = sorted.size / 2
+      sorted.size.odd? ? sorted[mid] : (sorted[mid - 1] + sorted[mid]) / 2.0
+    end
+  end
+end

data/lib/active_mutator/version.rb

@@ -1,3 +1,3 @@
 module ActiveMutator
-  VERSION = "0.1.1"
+  VERSION = "0.2.0"
 end

data/lib/active_mutator/work_item.rb

@@ -1,4 +1,11 @@
 module ActiveMutator
   # lane: :parallel (default pool) | :serial (browser-covered, one at a time)
-  WorkItem = Data.define(:mutation, :example_ids, :timeout, :lane)
+  # timeout:    static total budget (variable + fixed), kept for --debug-plan and compat
+  # variable:   the baseline-estimate-derived part (estimate * timeout_factor) — the
+  #             only part the TimeoutCalibrator scales
+  WorkItem = Data.define(:mutation, :example_ids, :timeout, :lane, :variable) do
+    def initialize(mutation:, example_ids:, timeout:, lane:, variable: 0.0)
+      super
+    end
+  end
 end

data/lib/active_mutator/worker.rb

@@ -24,6 +24,9 @@ module ActiveMutator
       devnull = File.open(File::NULL, "w")
       runner = RSpec::Core::Runner.new(RSpec::Core::ConfigurationOptions.new(@example_ids))
       runner.setup(devnull, devnull)   # loads spec files -> loads the app
+      # One failure kills the mutant; running the rest of the covering set
+      # is pure waste inside the fork.
+      RSpec.configuration.fail_fast = 1
       Inserter.new.insert(@mutation)   # now the target constant exists
       after_fork_hygiene
       code = runner.run_specs(covering_groups)

data/lib/active_mutator.rb

@@ -11,6 +11,7 @@ require_relative "active_mutator/edit"
 require_relative "active_mutator/splicer"
 require_relative "active_mutator/subject"
 require_relative "active_mutator/subject_finder"
+require_relative "active_mutator/subject_matcher"
 require_relative "active_mutator/operators/base"
 require_relative "active_mutator/operators/conditional_boundary"
 require_relative "active_mutator/operators/condition_forcing"
@@ -27,16 +28,23 @@ require_relative "active_mutator/atomic_file"
 require_relative "active_mutator/coverage_map"
 require_relative "active_mutator/baseline"
 require_relative "active_mutator/baseline_delta"
+require_relative "active_mutator/defined_constants"
 require_relative "active_mutator/inserter"
 require_relative "active_mutator/worker"
 require_relative "active_mutator/result"
 require_relative "active_mutator/work_item"
+require_relative "active_mutator/timeout_calibrator"
 require_relative "active_mutator/scheduler"
+require_relative "active_mutator/reporter/operator_stats"
 require_relative "active_mutator/reporter/terminal"
+require_relative "active_mutator/reporter/github"
 require_relative "active_mutator/reporter/json"
+require_relative "active_mutator/source_location"
 require_relative "active_mutator/since_filter"
 require_relative "active_mutator/fingerprint"
 require_relative "active_mutator/accepted_ledger"
+require_relative "active_mutator/reporter/stryker_json"
 require_relative "active_mutator/config"
 require_relative "active_mutator/runner"
+require_relative "active_mutator/config_file"
 require_relative "active_mutator/cli"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: active_mutator
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.0
 platform: ruby
 authors:
 - Daniel John
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-07-14 00:00:00.000000000 Z
+date: 2026-07-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: prism
@@ -74,7 +74,9 @@ files:
 - lib/active_mutator/baseline_hooks.rb
 - lib/active_mutator/cli.rb
 - lib/active_mutator/config.rb
+- lib/active_mutator/config_file.rb
 - lib/active_mutator/coverage_map.rb
+- lib/active_mutator/defined_constants.rb
 - lib/active_mutator/edit.rb
 - lib/active_mutator/engine.rb
 - lib/active_mutator/fingerprint.rb
@@ -89,15 +91,21 @@ files:
 - lib/active_mutator/operators/logical_operator.rb
 - lib/active_mutator/operators/negation_removal.rb
 - lib/active_mutator/operators/statement_deletion.rb
+- lib/active_mutator/reporter/github.rb
 - lib/active_mutator/reporter/json.rb
+- lib/active_mutator/reporter/operator_stats.rb
+- lib/active_mutator/reporter/stryker_json.rb
 - lib/active_mutator/reporter/terminal.rb
 - lib/active_mutator/result.rb
 - lib/active_mutator/runner.rb
 - lib/active_mutator/scheduler.rb
 - lib/active_mutator/since_filter.rb
+- lib/active_mutator/source_location.rb
 - lib/active_mutator/splicer.rb
 - lib/active_mutator/subject.rb
 - lib/active_mutator/subject_finder.rb
+- lib/active_mutator/subject_matcher.rb
+- lib/active_mutator/timeout_calibrator.rb
 - lib/active_mutator/version.rb
 - lib/active_mutator/work_item.rb
 - lib/active_mutator/worker.rb