kimera 0.1.1 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3c0b6544c638890d575523723b8d86dcac500e247c22a989fda9fa13b9f8d68b
-  data.tar.gz: 4b354333f7a2173a49932c9761f1731e034cd0a91df2a6534081412bd0598f92
+  metadata.gz: 042a730e48edfef4744060425cd10f04e34006025af3f36db3ab17f0be59e0bc
+  data.tar.gz: 97a3914ca3f803f01e68564af89ee07667703aadfa6ec74269bbf37470add0fb
 SHA512:
-  metadata.gz: 84b6ffd6aac361151843796089b6a4b85e1aa34aafdc8b9a78caf407ef18e774b72527235d4596649b08c52454d2a743e1e35d032240d7eaf6c577f6ad80a3d9
-  data.tar.gz: 0b1cd61f82643207a14f2fff230b46e05de8be433f8989a8e55df6e9e5e7af0198f55cd009d411a6beeeeedd5f4c68946d119ba1aa77326e27f12cb3406fe566
+  metadata.gz: 2c2d774a35384621bca26d92d5c9e77550f3b08ecf1304019b37e695eeacbbc5566622de50fbae65077f61035fa25e241817aa31e917c0455e8ad23b26c00f9b
+  data.tar.gz: 7ebd3017fd0edbd7a2abb3c585ee347dfe0b66a03111ffa9efb322b835b6661d29bd2554f863bc075035f242da3bf66f514f098ebaf2b64339b39b90f8dde558

data/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## 0.1.2 (2026-09-26)
+
+- Kimera sets `KIMERA=1` in its own process before loading the suite, and in
+  the `kimera doctor` test commands. A coverage floor gated on
+  `ENV["KIMERA"]` no longer fails a passing warm run with exit 2 or blocks
+  doctor's dry run. (#6)
+- A string interpolating a local bound by a pattern (`in [:ok, chosen]`,
+  `=> chosen`), a `&block` parameter, or a regexp named capture no longer
+  sinks its file's mutants. unparser 0.9 could not round-trip it; Kimera now
+  teaches unparser those bindings. (#7)
+- The per-method splice fallback now claims mutants in an endless method
+  (`def big? = value > 10`), and reopens `Data.define` / `Struct.new`
+  constants instead of redefining them, so spliced guards are reached. (#7)
+- Mutants Kimera could not instrument are reported as `unmutatable`, with the
+  reason, instead of `no_coverage`. They never gate and stay out of the score,
+  so `--fail-on-no-coverage` again means "no test executes this". (#7)
+- `kimera run --since` no longer crashes with "invalid byte sequence in
+  US-ASCII" when the locale isn't UTF-8 (e.g. `LANG` unset) and the diff
+  contains non-ASCII text. Git's diff output is read as UTF-8, with invalid
+  bytes replaced. (#9)
+
 ## 0.1.1 (2026-09-26)
 
 - Fix a boot crash on case-sensitive filesystems (Linux): `require "English"`

data/README.md

@@ -221,8 +221,9 @@ selector and Kimera's own harness-critical files (see below).
 An isolated child is judged on its failed tests, not its exit status. A child
 that exits non-zero with no failing test is `harness_error` (unjudged, gated
 by `--max-errors`), not a kill. The usual cause is a coverage floor such as
-SimpleCov's `minimum_coverage`, which a partial run always trips. Children run
-with `KIMERA=1` set, so skip the floor there:
+SimpleCov's `minimum_coverage`, which a partial run always trips. Kimera sets
+`KIMERA=1` wherever it loads your suite (the warm process, `--isolated`
+children, and `kimera doctor`'s test commands), so skip the floor there:
 
 ```ruby
 SimpleCov.start { minimum_coverage(line: 100, branch: 100) unless ENV["KIMERA"] }
@@ -504,8 +505,11 @@ source ──Prism──▶ registry (mutation points, JSON) ──┬─▶ syn
   baseline, or worse, as kills that are really collisions.
 - **Score definition.** `score = killed / evaluable`.
   - Killed includes timeouts and errors (observable misbehaviour).
-  - Evaluable excludes `no_coverage`, `ignored`, `isolated_only`, and
-    `harness_error` mutants. Each is reported separately.
+  - Evaluable excludes `no_coverage`, `ignored`, `isolated_only`,
+    `unmutatable`, and `harness_error` mutants. Each is reported separately.
+  - An `unmutatable` mutant is one Kimera could not instrument for the warm
+    run (its file or method failed to re-emit or load); the detail says why.
+    It never gates, and it is not `no_coverage`: a test may well run it.
   - A `harness_error` is a mutant Kimera could not judge: its worker died, or
     its reply was unreadable. It is not a kill. It gates via `--max-errors`
     (default 0). A pool that never produces a result aborts the run.

data/lib/kimera/cli/doctor.rb

@@ -96,8 +96,8 @@ class Kimera::CLI::Doctor
   end
 
   def floored(helper)
-    "Coverage floor: minimum_coverage in #{helper} fails partial --isolated runs; " \
-      "skip it when ENV[\"KIMERA\"] is set"
+    "Coverage floor: minimum_coverage in #{helper} fails Kimera's partial runs; " \
+      "skip it when ENV[\"KIMERA\"] is set (Kimera sets it)"
   end
 
   def floor?(path)

data/lib/kimera/cli/run/cycle.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+require_relative "../../execution/suite_env"
 require_relative "../../incremental/selection"
 require_relative "../../incremental/session"
 require_relative "digest"
@@ -71,7 +72,8 @@ class Kimera::CLI::Run::Cycle
       .transform_keys(&:to_s)
   end
 
-  def harness(remaining, loaded)
+  def harness(remaining, loaded, env: ENV)
+    env.update(Kimera::Execution::SUITE_ENV)
     adapter = Kimera::Frameworks::Adapter.load(@options[:framework])
     Kimera::CLI::Run::Pass.new(@registry, @options, adapter).call(remaining, loaded)
   end

data/lib/kimera/cli/survivors.rb

@@ -15,7 +15,7 @@ class Kimera::CLI::Survivors
       Kimera::Flag.build(
         "--status NAME", :status,
         "List a different status (survived, no_coverage, " \
-          "timeout, error, killed, isolated_only)"
+          "timeout, error, killed, isolated_only, unmutatable)"
       )
     ]
   )

data/lib/kimera/cli/test_command.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require "open3"
+require_relative "../execution/suite_env"
 
 class Kimera::CLI::TestCommand
   LOADER = "ARGV.map { |f| File.expand_path(f) }.tap { ARGV.clear }.each { |f| require(f) }"
@@ -30,7 +31,7 @@ class Kimera::CLI::TestCommand
   end
 
   def check(command, passed)
-    output, status = Open3.capture2e(*command, chdir: @root)
+    output, status = Open3.capture2e(Kimera::Execution::SUITE_ENV, *command, chdir: @root)
     status.success? ? ["✓", passed] : yield(summary(output))
   rescue Errno::ENOENT
     yield(nil)

data/lib/kimera/execution/isolated_child_command.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require_relative "suite_env"
+
 module Kimera
   module Execution
   end
@@ -16,11 +18,9 @@ class Kimera::Execution::IsolatedPlan::ChildCommand
     @test_files = test_files
   end
 
-  ENV_FLAG = { "KIMERA" => "1" }.freeze
-
   def command(mirror, locations, ledger:, paths:)
     includes = paths.flat_map { |path| ["-I", path] }
-    bundled(mirror, ENV_FLAG.dup, ["ruby", *includes, "-I", helpers, *argv(locations, ledger)])
+    bundled(mirror, Kimera::Execution::SUITE_ENV.dup, ["ruby", *includes, "-I", helpers, *argv(locations, ledger)])
   end
 
   def argv(locations, ledger)

data/lib/kimera/execution/schemata.rb

@@ -39,7 +39,12 @@ class Kimera::Execution::Schemata
     @skipped.keys.select { |path| @skipped[path].start_with?("NameError:") }.each { |path| @skipped.delete(path) }
   end
 
-  def announce = @skipped.each { |path, reason| notice(path, reason) }
+  def announce
+    @skipped.each do |path, reason|
+      notice(path, reason)
+      @registry.at(path).select(&:safe?).each { |point| point.unmutatable!("schemata setup failed (#{reason})") }
+    end
+  end
 
   def load(path)
     file = File.join(root, path)
@@ -72,7 +77,7 @@ class Kimera::Execution::Schemata
   def notice(path, reason)
     errors.puts(
       "kimera: #{path} cannot run in warm workers — schemata setup failed " \
-        "(#{reason}); its mutants are reported no_coverage"
+        "(#{reason}); its mutants are reported unmutatable"
     )
   end
 

data/lib/kimera/execution/suite_env.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Kimera
+  module Execution
+    SUITE_ENV = { "KIMERA" => "1" }.freeze
+  end
+end

data/lib/kimera/execution/verdicts.rb

@@ -18,7 +18,7 @@ class Kimera::Execution::Verdicts
   end
 
   def reloadable?(id)
-    !point(id).body?
+    point(id).reloadable?
   end
 
   def reclassify!(results)
@@ -45,7 +45,9 @@ class Kimera::Execution::Verdicts
   end
 
   def quarantine(id)
-    Kimera::MutantResult.new(mutant_id: id, status: :isolated_only, file: path(id), detail: point(id).unsafe_reason)
+    found = point(id)
+    status = found.unmutatable? ? :unmutatable : :isolated_only
+    Kimera::MutantResult.new(mutant_id: id, status: status, file: found.file, detail: found.unsafe_reason)
   end
 
   def point(id)

data/lib/kimera/incremental/git_diff.rb

@@ -27,12 +27,14 @@ class Kimera::Incremental::GitDiff
     def parse(text)
       files = {}
       current = nil
-      text.each_line { |line| current = advance(files, current, line) }
+      decoded(text).each_line { |line| current = advance(files, current, line) }
       files
     end
 
     private
 
+    def decoded(text) = text.dup.force_encoding(Encoding::UTF_8).scrub
+
     def advance(files, current, line)
       header = line.match(FILE_HEADER)
       return named(header) if header

data/lib/kimera/registry/mutation_point.rb

@@ -17,7 +17,7 @@ module Kimera
       end
 
       def within?(from, to)
-        interior = ((from + 1)...to)
+        interior = ((from + 1)..to)
         interior.cover?(start_offset) && interior.cover?(finish)
       end
 
@@ -66,6 +66,7 @@ end
 
 class Kimera::MutationPoint
   CLASS_BODY_REASON = "class-body DSL (runs at load; evaluate with --isolated)"
+  UNMUTATABLE = "unmutatable: "
   SAFE = true
 
   FIELDS = %i[point_id file operator node_type location original_source method_name mutants unsafe_reason].freeze
@@ -98,6 +99,18 @@ class Kimera::MutationPoint
     unsafe_reason == CLASS_BODY_REASON
   end
 
+  def reloadable?
+    !body? && !unmutatable?
+  end
+
+  def unmutatable?
+    unsafe_reason.to_s.start_with?(UNMUTATABLE)
+  end
+
+  def unmutatable!(detail)
+    unsafe!("#{UNMUTATABLE}#{detail}")
+  end
+
   def safe
     @attributes.fetch(:schema_safe, SAFE)
   end

data/lib/kimera/results/result.rb

@@ -4,9 +4,10 @@ module Kimera
   module Status
     KILLING = %i[killed timeout error].freeze
 
-    UNJUDGED = %i[no_coverage ignored isolated_only harness_error].freeze
+    UNJUDGED = %i[no_coverage ignored isolated_only unmutatable harness_error].freeze
 
-    REPORTED = ([:survived] + (KILLING - [:killed]) + %i[no_coverage harness_error ignored isolated_only]).freeze
+    REPORTED =
+      ([:survived] + (KILLING - [:killed]) + %i[no_coverage harness_error ignored isolated_only unmutatable]).freeze
 
     SELF_SUSPECT = ((KILLING - [:killed]) + [:survived]).freeze
   end

data/lib/kimera/results/run_report.rb

@@ -10,7 +10,7 @@ end
 class Kimera::RunReport
   attr_reader :results, :leaks, :registry
 
-  CONDITIONAL = %i[harness_error ignored isolated_only leaks].freeze
+  CONDITIONAL = %i[harness_error ignored isolated_only unmutatable leaks].freeze
   LABELS = { total: "mutants", harness_error: "unjudged" }.freeze
   SCHEMA_VERSION = 1
 

data/lib/kimera/support/unparse.rb

@@ -11,5 +11,32 @@ module Kimera
     def parse(source) = Kimera::Warnings.silence { Unparser.parse(source) }
 
     def unparse(node) = Kimera::Warnings.silence { Unparser.unparse(node) }
+
+    module Binders
+      private
+
+      def enter(node)
+        super
+        Binders.names(node).each { |name| define(name) }
+      end
+
+      class << self
+        def names(node)
+          case node.type
+          when :match_var, :blockarg then [node.children.first].compact
+          when :match_with_lvasgn then captures(node.children.first)
+          else []
+          end
+        end
+
+        def captures(regexp)
+          *parts, options = regexp.children
+          flags = options.children.include?(:x) ? Regexp::EXTENDED : 0
+          Regexp.new(parts.sum("") { |part| part.children.first }, flags).names.map(&:to_sym)
+        end
+      end
+    end
   end
 end
+
+Unparser::AST::LocalVariableScopeEnumerator.prepend(Kimera::Unparse::Binders)

data/lib/kimera/support/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Kimera
-  VERSION = "0.1.1"
+  VERSION = "0.1.2"
 end

data/lib/kimera/synthesis/file_weave.rb

@@ -6,6 +6,8 @@ require_relative "overlay_splice"
 class Kimera::Overlay::FileWeave
   include Kimera::OverlaySplice
 
+  UNGUARDABLE = "unparser could not round-trip its guard"
+
   def initialize(file, map, safe, unsafe)
     @file = file
     @map = map
@@ -43,16 +45,15 @@ class Kimera::Overlay::FileWeave
   def finish(viable)
     dropped = @safe - viable
     notice(dropped)
-    result = attempt(viable)
-    result.skipped_unsafe.concat(dropped.flat_map(&:ids))
-    result
+    dropped.each { |point| point.unmutatable!(UNGUARDABLE) }
+    attempt(viable).tap { |result| result.skipped_unsafe.concat(dropped.flat_map(&:ids)) }
   end
 
   def notice(dropped)
     io.puts(
       "kimera: #{@file}: #{dropped.size} mutation point(s) at " \
         "#{dropped.map { |p| "line #{p.location.start_line}" }.uniq.join(", ")} " \
-        "are unguardable (unparser round-trip); their mutants are reported no_coverage"
+        "are unguardable (unparser round-trip); their mutants are reported unmutatable"
     )
   end
 

data/lib/kimera/synthesis/overlay_splice.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require_relative "splice_reopening"
+
 module Kimera
   module OverlaySplice
     private
@@ -13,7 +15,7 @@ module Kimera
       return unless ready?
       edits, dropped = gather
       return if edits.empty?
-      source = apply(edits)
+      source = apply(edits + reopenings)
       [edits, dropped, source] if Kimera::Syntax.parse(source).success?
     end
 
@@ -24,6 +26,8 @@ module Kimera
       [edits, dropped + (@safe - claimed)]
     end
 
+    def reopenings = Kimera::SpliceReopening.new(@map).edits
+
     def collect(definition, points, edits, dropped)
       rewritten = rewrite(definition, points)
       rewritten ? edits << rewritten : dropped.concat(points)
@@ -32,6 +36,7 @@ module Kimera
     def report(edits, dropped, source)
       applied = edits.flat_map(&:last)
       announce(applied, dropped)
+      dropped.each { |point| point.unmutatable!("unparser could not round-trip its method") }
       build(applied, dropped, source)
     end
 
@@ -46,7 +51,7 @@ module Kimera
       io.puts(
         "kimera: #{@file}: file-level round-trip failed; " \
           "#{applied.size} mutant(s) spliced per method, " \
-          "#{dropped.flat_map(&:ids).size} reported no_coverage"
+          "#{dropped.flat_map(&:ids).size} reported unmutatable"
       )
     end
 

data/lib/kimera/synthesis/splice_reopening.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+require_relative "../rewrite/ast_walk"
+require_relative "guardrail_value_objects"
+
+class Kimera::SpliceReopening
+  FACTORIES = Kimera::GuardrailValueObjects::VALUE_OBJECT_FACTORIES
+  LEXICAL = "(is_a?(::Module) ? self : ::Object)"
+
+  Assignment =
+    Data.define(:scope, :name, :value, :location) do
+      def edit = [location.expression.begin_pos, value.location.begin.begin_pos, header, []]
+
+      def header
+        owner = base
+        "#{constant} = (#{owner}.const_defined?(:#{name}, false) ? #{owner}.const_get(:#{name}) : " \
+          "#{factory}); #{constant}.class_eval "
+      end
+
+      def constant = location.expression.begin.join(location.name).source
+
+      def factory = value.children.first.location.expression.source
+
+      def base
+        return LEXICAL unless scope
+        scope.type == :cbase ? "::Object" : scope.location.expression.source
+      end
+    end
+
+  def initialize(map)
+    @map = map
+  end
+
+  def edits = constants.map(&:edit)
+
+  private
+
+  def constants
+    found = []
+    Kimera::Rewrite::AstWalk.visit(@map.ast) { |node| found << assignment(node) if reopenable?(node) }
+    found
+  end
+
+  def assignment(node) = Assignment.new(*node, node.location)
+
+  def reopenable?(node)
+    return false unless node.type == :casgn
+    value = node.children.last
+    value.is_a?(Parser::AST::Node) && value.type == :block && factory?(value.children.first)
+  end
+
+  def factory?(call)
+    receiver, selector = call.children
+    call.type == :send && receiver.is_a?(Parser::AST::Node) && receiver.type == :const &&
+      FACTORIES[receiver.children.last] == selector
+  end
+end

data/skills/kimera/SKILL.md

@@ -72,7 +72,8 @@ bundle exec kimera run --isolated --jobs 4      # oracle mode (see Strengthen)
 - Rails `enum` models overlay warm (the re-declaration is idempotent), so
   their method-body mutants are judged like any other. A file labeled
   `unmutatable` could not be overlaid (a distinct, reported reason); it is not
-  an `--isolated` case.
+  an `--isolated` case. Its mutants report as `unmutatable` (never gating,
+  never scored, with the reason in the detail), not `no_coverage`.
 
 ## Triage a surviving mutant: the only four verdicts
 
@@ -118,9 +119,10 @@ bundle exec kimera run --isolated --jobs 4      # oracle mode (see Strengthen)
   suppress the warm path.
 - `--isolated` judges on failed tests, not the exit status. A child that
   exits non-zero with zero failures (typically a SimpleCov `minimum_coverage`
-  floor tripped by the partial run) is `harness_error`, not a kill. Children
-  run with `KIMERA=1`, so gate the floor on it (`minimum_coverage ... unless
-  ENV["KIMERA"]`); `kimera doctor` warns when it isn't.
+  floor tripped by the partial run) is `harness_error`, not a kill. Kimera
+  sets `KIMERA=1` wherever it loads the suite (warm, `--isolated`, doctor), so
+  gate the floor on it (`minimum_coverage ... unless ENV["KIMERA"]`); `kimera
+  doctor` warns when it isn't.
 - A cluster of `error`/`timeout` verdicts in one region usually means harness
   fragility or a missing guard, not test strength. Read the cluster before
   counting the detections.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: kimera
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.2
 platform: ruby
 authors:
 - Giacomo GK
@@ -131,6 +131,7 @@ files:
 - lib/kimera/execution/shift/coverage_channel.rb
 - lib/kimera/execution/shift/killer_memory.rb
 - lib/kimera/execution/shift/leak_guard.rb
+- lib/kimera/execution/suite_env.rb
 - lib/kimera/execution/sweep.rb
 - lib/kimera/execution/transaction_isolation.rb
 - lib/kimera/execution/trial.rb
@@ -231,6 +232,7 @@ files:
 - lib/kimera/synthesis/overlay_splice.rb
 - lib/kimera/synthesis/project.rb
 - lib/kimera/synthesis/source_map.rb
+- lib/kimera/synthesis/splice_reopening.rb
 - lib/kimera/synthesis/superclass_pin.rb
 - lib/kimera/version.rb
 - skills/kimera/SKILL.md