hecks 2.7.0 → 2.8.0

data/lib/hecks/runtime/registry.rb

@@ -39,7 +39,7 @@ module Hecks
         @event_log    = []
         @reaction_log = []
         @saga_log = []
-        # A DECLARATIVE FACT, NOT YET A DISPATCHED ONE — `AggregateDoor#
+        # A declarative fact, not yet a dispatched one — `AggregateDoor#
         # mark_sensitive` (called from a `.hecksagon` file, the same way
         # `port`/`persisted_by` already are) appends here at
         # hecksagon-build time; `Runtime::Loader.boot`'s own post-dispatcher
@@ -162,19 +162,23 @@ module Hecks
       # @return [Bluebook::Chapter] `item`, unchanged
       def add_bluebook(item) = @bluebooks[item.name] = item
 
-      # PROVENANCE, SIDE-CHANNEL — which real `.bluebook` file(s)
+      # Provenance, side-channel — which real `.bluebook` file(s)
       # contributed to a chapter name, never part of the exported IR (a
       # boot-time loading fact, not a domain fact) and never Rust-mirrored
       # (the same "additive, Ruby-only" shape `@translations` above already
-      # is). Legitimate accumulation (several files declaring the SAME
+      # is). Legitimate accumulation (several files declaring the same
       # chapter name on purpose — `lib/hecks/language/bluebook/*.bluebook`
       # all open `Hecks.bluebook "Bluebook"`) pushes more than one path
       # here too; that alone is not a problem. What this exists to let
       # `refuse_cross_package_bluebook_merge!` (registry/verification.rb)
-      # catch is TWO UNRELATED PACKAGES accumulating into the same name by
+      # catch is two unrelated packages accumulating into the same name by
       # coincidence — a stale vendored fork's own copy of a real gem's
       # chapter, still reachable on the load path, silently merging its
       # aggregates into the real one via this exact accumulation mechanism.
+      #
+      # @param name [String, Symbol] the chapter name the file contributed to
+      # @param path [String] the `.bluebook` file that declared it
+      # @return [Array<String>] every path recorded for that chapter, `path` last
       def record_bluebook_source(name, path)
         (@bluebook_sources[name.to_s] ||= []) << path
       end

data/lib/hecks/runtime/saga_interpreter.rb

@@ -425,7 +425,7 @@ module Hecks
       #
       # A compensation that is itself refused does not unwind again, and needs no
       # flag to stop it: the state moves to the compensating leg's to_state before
-      # its dispatches run, so a second refusal finds the instance no longer in
+      # its dispatches run, so a second refusal finds the instance already out of
       # from_state and records that instead. The check is the guard.
       def unwind(process_manager, event, instance, correlation, domain)
         return unless instance && process_manager.handles?(REFUSED)

data/lib/hecks/runtime/value/coercion.rb

@@ -916,11 +916,11 @@ module Hecks
         # C3.8 — the boundary check for an attribute whose type is a bare
         # primitive rather than a value object: `Integer`/`Float` by exact
         # numeric class (`NUMERIC`), `String`/booleans by rejecting only a
-        # composite shape (`COMPOSITE_SHAPES`) — not the same as
+        # composite shape (`COMPOSITE_SHAPES`) — a looser test than
         # `check_scalar_shapes` holds a value object's own `String` field to
-        # any more (QualityControl BUG#125 tightened that one to also refuse
+        # (QualityControl BUG#125 has that one also refuse
         # a non-string scalar; a bare `String` argument here still admits
-        # any other scalar, left exactly as it was — a bare-primitive
+        # any other scalar — a bare-primitive
         # attribute was never part of BUG#125's own investigation or fix,
         # and whether it needs the same tightening, and against what real
         # Judge dependency if any, is still open); worded by the same

data/lib/hecks/runtime/value/entity_list_coercion.rb

@@ -27,7 +27,7 @@ module Hecks
         # because coercion has to resolve value objects, and only the
         # root answers `.value_object` at all (Entity's own header
         # comment: an entity must not answer to it, or `Value.
-        # for_attribute` could no longer tell a piece from a head). So
+        # for_attribute` could not tell a piece from a head). So
         # a nested entity — Dispatch, inside Handler — is not a direct
         # child of the root the way Handler itself is, and a plain
         # `aggregate.entities.find` stops one level short of it.

data/lib/hecks/storehouse.rb

@@ -1,6 +1,7 @@
 require "json"
 require "fileutils"
 require "time"
+require_relative "cache_dir"
 require_relative "facade/command_request"
 require_relative "facade/json_door"
 require_relative "naming"
@@ -8,7 +9,7 @@ require_relative "projector"
 require_relative "runtime/errors"
 
 module Hecks
-  # **The bus, not a door** — `docs/hecks-survey-what-we-wish-we-had.md` and
+  # **The bus, not a door** — `docs/archive/hecks-survey-what-we-wish-we-had.md` and
   # `docs/future-features.md` both name the sibling project's own
   # "Storehouse" the single highest-priority gap this repo had: "no
   # per-command tool... the bluebook is the contract, the [door] just
@@ -90,19 +91,24 @@ module Hecks
   module Storehouse
     module_function
 
-    # The same closed set `docs/hecks-survey-what-we-wish-we-had.md`'s
+    # The same closed set `docs/archive/hecks-survey-what-we-wish-we-had.md`'s
     # `SourceTag` names — who dispatched, not what. Optional: a caller
     # that omits it gets `source: nil` recorded, honestly, rather than a
     # guessed default.
     SOURCE_TAGS = %w[process-manager operator hook sidequest-agent cascade daemon].freeze
 
-    # **The bus's own audit trail** — a JSONL file per domain, one line per
-    # `dispatch`/`query`/`state`/dry-run call, `follow` tails it back.
-    # `tmp/`, not the domain's own directory: this is the bus's record
-    # of what was asked of it, not part of the domain's own persisted
-    # state, and `tmp/` is already gitignored for exactly this kind of
-    # local, disposable-but-useful-while-it-lasts file.
-    LOG_ROOT = File.expand_path("../../tmp/storehouse", __dir__)
+    # Names the directory holding the bus's own audit trail.
+    #
+    # The trail is a JSONL file per domain, one line per
+    # `dispatch`/`query`/`state`/dry-run call, and `follow` tails it back.
+    # It is kept under `Hecks::CacheDir`, not the domain's own directory: this is
+    # the bus's record of what was asked of it, not part of the domain's own
+    # persisted state, and not the gem's own directory either, which is
+    # read-only on an installed gem.
+    #
+    # @return [String] the absolute path of the `storehouse` directory under
+    #   the cache root
+    def log_root = Hecks::CacheDir.path("storehouse")
 
     # The root every `domain:`/`under:` must resolve under — the project
     # directory by default, `HECKS_STOREHOUSE_ROOT` to widen or move it.
@@ -321,9 +327,9 @@ module Hecks
     #
     # @param domain_name [String, Symbol, #to_s] the domain name
     # @return [String] the absolute path to that domain's JSONL log file, under
-    #   `LOG_ROOT`
+    #   `log_root`
     def log_path(domain_name)
-      File.join(LOG_ROOT, "#{domain_name.to_s.gsub(/[^A-Za-z0-9_-]/, '_')}.jsonl")
+      File.join(log_root, "#{domain_name.to_s.gsub(/[^A-Za-z0-9_-]/, '_')}.jsonl")
     end
 
     # Appends one call's outcome to its domain's audit log.
@@ -351,7 +357,7 @@ module Hecks
       entry = { time: Time.now.utc.iso8601, tool: tool, verb: verb, summary: summary, source: source,
                 role: role, actor_id: actor_id,
                 ok: outcome[:ok], id: outcome[:id], error: outcome[:error], events: outcome[:events] }.compact
-      FileUtils.mkdir_p(LOG_ROOT)
+      FileUtils.mkdir_p(log_root)
       File.open(log_path(domain_name), "a") { |f| f.puts(JSON.generate(entry)) }
     rescue StandardError
       nil

data/lib/hecks/version.rb

@@ -12,5 +12,5 @@ module Hecks
   # it there, or even in the consuming Gemfile, never closed the gap,
   # because gemspec evaluation happens before anything Bundler
   # resolves is actually loadable yet.
-  VERSION = "2.7.0".freeze
+  VERSION = "2.8.0".freeze
 end

data/lib/hecks/vocabulary.rb

@@ -254,6 +254,10 @@ module Hecks
         {"refusal"=>"InvariantViolation", "site"=>"admits_declared_set", "argument"=>"offered", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
         {"refusal"=>"InvariantViolation", "site"=>"undeclared_set", "argument"=>"name", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
         {"refusal"=>"InvariantViolation", "site"=>"undeclared_set", "argument"=>"admits", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"InvariantViolation", "site"=>"group_by_collision", "argument"=>"read_model", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"InvariantViolation", "site"=>"group_by_collision", "argument"=>"fields", "shape"=>"list", "quoting"=>"none", "separator"=>", ", "sorted"=>"false", "when_empty"=>""}.freeze,
+        {"refusal"=>"InvariantViolation", "site"=>"group_by_collision", "argument"=>"ids", "shape"=>"list", "quoting"=>"inspect", "separator"=>", ", "sorted"=>"true", "when_empty"=>""}.freeze,
+        {"refusal"=>"InvariantViolation", "site"=>"group_by_collision", "argument"=>"key", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
         {"refusal"=>"Unauthorized", "site"=>"tenant_required", "argument"=>"query", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
         {"refusal"=>"Unauthorized", "site"=>"tenant_required", "argument"=>"field", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
         {"refusal"=>"Unauthorized", "site"=>"role_mismatch", "argument"=>"command", "shape"=>"scalar", "quoting"=>"none", "separator"=>"", "sorted"=>"false", "when_empty"=>""}.freeze,
@@ -314,6 +318,7 @@ module Hecks
         {"refusal"=>"InvariantViolation", "site"=>"value_object_invariant", "template"=>"{name} invariant violated — {description} (given {offered})"}.freeze,
         {"refusal"=>"InvariantViolation", "site"=>"admits_declared_set", "template"=>"{name} admits {admits} — {admitted} — got {offered}"}.freeze,
         {"refusal"=>"InvariantViolation", "site"=>"undeclared_set", "template"=>"{name} admits {admits}, which this chapter does not declare — a closed set is named Aggregate::SetName, and it must be one the bluebook actually holds"}.freeze,
+        {"refusal"=>"InvariantViolation", "site"=>"group_by_collision", "template"=>"{read_model} groups by {fields}, but rows {ids} share {key} — a group_by leaf holds one row; add a field that tells them apart"}.freeze,
         {"refusal"=>"Unauthorized", "site"=>"tenant_required", "template"=>"{query} declares authorize with tenant: {field} — pass {field}: to name which {field} this ask is scoped to"}.freeze,
         {"refusal"=>"Unauthorized", "site"=>"role_mismatch", "template"=>"{command} refused — role: {role}, and the caller stated {caller_role}"}.freeze,
         {"refusal"=>"Unauthorized", "site"=>"cross_tenant_reference", "template"=>"{aggregate} {field} is {tenant}, but {attribute} names a {target} whose own {target_field} is {other} — a cross-tenant reference"}.freeze,

data/lib/hecks.rb

@@ -32,11 +32,16 @@ require_relative "hecks/facade/cli_door"
 require_relative "hecks/facade/cli_runner"
 require_relative "hecks/storehouse"
 require_relative "hecks/mcp_stdio_guard"
+require_relative "hecks/mcp_door_scope"
 require_relative "hecks/framework"
-require_relative "hecks/corpus"
 require_relative "hecks/vendoring"
 require_relative "hecks/embryonaut_bluebook"
 
+# Repository-only tooling: the corpus table walks `examples/`, `qa/` and
+# `spec/`, which only a checkout has, so it loads on first use and the
+# packaged gem leaves it out (ADR 0066).
+Hecks.autoload(:Corpus, File.expand_path("hecks/corpus", __dir__))
+
 # The root namespace and public facade of the whole DSL/runtime: `Hecks.boot`/
 # `.boot_files` assemble a running domain from `.bluebook`/`.hecksagon`/
 # `.world` files, and `.bluebook`/`.hecksagon`/`.port`/`.adapter`/`.world`/

metadata

@@ -1,12 +1,12 @@
 --- !ruby/object:Gem::Specification
 name: hecks
 version: !ruby/object:Gem::Version
-  version: 2.7.0
+  version: 2.8.0
 platform: ruby
 authors:
 - Chris Young
 autorequire:
-bindir: bin
+bindir: exe
 cert_chain: []
 date: 2026-09-27 00:00:00.000000000 Z
 dependencies:
@@ -30,10 +30,12 @@ description: |
   Nothing is scripted: no handler body, no class you write, no schema
   you migrate.
 email:
-executables: []
+executables:
+- hecks
 extensions: []
 extra_rdoc_files: []
 files:
+- exe/hecks
 - lib/hecks.rb
 - lib/hecks/adapters.rb
 - lib/hecks/adapters/driven.rb
@@ -94,17 +96,6 @@ files:
 - lib/hecks/behaviors/ir.rb
 - lib/hecks/behaviors/rspec.rb
 - lib/hecks/behaviors/runner.rb
-- lib/hecks/bench.rb
-- lib/hecks/bench/cli.rb
-- lib/hecks/bench/environment.rb
-- lib/hecks/bench/postgres_probe.rb
-- lib/hecks/bench/report.rb
-- lib/hecks/bench/ruby_runner.rb
-- lib/hecks/bench/run.rb
-- lib/hecks/bench/rust_runner.rb
-- lib/hecks/bench/stats.rb
-- lib/hecks/bench/suite.rb
-- lib/hecks/bench/workload.rb
 - lib/hecks/bluebook.rb
 - lib/hecks/bluebook/aggregate.rb
 - lib/hecks/bluebook/assembly.rb
@@ -199,13 +190,22 @@ files:
 - lib/hecks/bluebook/synthesizer.rb
 - lib/hecks/bluebook/translation.rb
 - lib/hecks/bluebook/value_object.rb
-- lib/hecks/codemod.rb
+- lib/hecks/cache_dir.rb
+- lib/hecks/cli.rb
+- lib/hecks/cli/document.rb
+- lib/hecks/cli/ir.rb
+- lib/hecks/cli/mcp.rb
+- lib/hecks/cli/mcp_door.rb
+- lib/hecks/cli/model_check.rb
+- lib/hecks/cli/project_cli.rb
+- lib/hecks/cli/project_diagrams.rb
+- lib/hecks/cli/run.rb
+- lib/hecks/cli/smoke_test.rb
+- lib/hecks/cli/stores.rb
 - lib/hecks/construct.rb
-- lib/hecks/corpus.rb
 - lib/hecks/deploy/bluebook/deploy.bluebook
 - lib/hecks/deploy/bluebook/deploy.hecksagon
 - lib/hecks/deploy/oidc.json
-- lib/hecks/doc/reference.rb
 - lib/hecks/embryonaut_bluebook.rb
 - lib/hecks/embryonaut_bluebook/lock.rb
 - lib/hecks/embryonaut_bluebook/shape.rb
@@ -246,47 +246,7 @@ files:
 - lib/hecks/framework/bluebook/privacy.bluebook
 - lib/hecks/framework/oidc.json
 - lib/hecks/freezer.rb
-- lib/hecks/fuzzing.rb
-- lib/hecks/fuzzing/bounded_exhaustive_expressions.rb
-- lib/hecks/fuzzing/combination_miner.rb
-- lib/hecks/fuzzing/concurrent_dispatch.rb
-- lib/hecks/fuzzing/coverage_campaign.rb
-- lib/hecks/fuzzing/differential.rb
-- lib/hecks/fuzzing/domain_generator.rb
-- lib/hecks/fuzzing/era_boundary.rb
-- lib/hecks/fuzzing/form_census.rb
-- lib/hecks/fuzzing/generated_domain_check.rb
-- lib/hecks/fuzzing/invalid_value_generator.rb
-- lib/hecks/fuzzing/isolated_boot.rb
-- lib/hecks/fuzzing/nondeterministic.rb
-- lib/hecks/fuzzing/persistence_parity.rb
-- lib/hecks/fuzzing/properties.rb
-- lib/hecks/fuzzing/properties/corrections.rb
-- lib/hecks/fuzzing/properties/dispatch_and_mutations.rb
-- lib/hecks/fuzzing/properties/guards.rb
-- lib/hecks/fuzzing/properties/invariants_and_aggregation.rb
-- lib/hecks/fuzzing/properties/lifecycle_and_replay.rb
-- lib/hecks/fuzzing/properties/outbox.rb
-- lib/hecks/fuzzing/properties/querying.rb
-- lib/hecks/fuzzing/qa_settings.rb
-- lib/hecks/fuzzing/replay.rb
-- lib/hecks/fuzzing/rotation_priority.rb
-- lib/hecks/fuzzing/rust_gap_manifest.rb
-- lib/hecks/fuzzing/self_consistency.rb
-- lib/hecks/fuzzing/sequence_generator.rb
-- lib/hecks/fuzzing/sequence_generator/adversary.rb
-- lib/hecks/fuzzing/sequence_generator/catalog.rb
-- lib/hecks/fuzzing/sequence_generator/outcome_tracker.rb
-- lib/hecks/fuzzing/sequence_generator/picker.rb
-- lib/hecks/fuzzing/sequence_generator/query_binding.rb
-- lib/hecks/fuzzing/sequence_generator/step_builder.rb
-- lib/hecks/fuzzing/shrinker.rb
-- lib/hecks/fuzzing/structural_skips.rb
-- lib/hecks/fuzzing/sweep_depth.rb
-- lib/hecks/fuzzing/target_capabilities.rb
-- lib/hecks/fuzzing/value_generator.rb
 - lib/hecks/grammar.rb
-- lib/hecks/grammar/evolve.rb
 - lib/hecks/grammar/expression.bluebook
 - lib/hecks/grammar/expression_operators.json
 - lib/hecks/grammar/grammar.hecksagon
@@ -318,6 +278,7 @@ files:
 - lib/hecks/language/world/wiring.bluebook
 - lib/hecks/language/world/world.bluebook
 - lib/hecks/literal.rb
+- lib/hecks/mcp_door_scope.rb
 - lib/hecks/mcp_stdio_guard.rb
 - lib/hecks/naming.rb
 - lib/hecks/ports.rb
@@ -460,7 +421,6 @@ files:
 - lib/hecks/projector/ir_projector.rb
 - lib/hecks/projector/narrate_projector.rb
 - lib/hecks/projector/target.rb
-- lib/hecks/query_ir.rb
 - lib/hecks/query_specification.rb
 - lib/hecks/query_specification/common/authorization_spec.rb
 - lib/hecks/query_specification/common/comparators.rb
@@ -481,6 +441,16 @@ files:
 - lib/hecks/query_specification/read_model/specification.rb
 - lib/hecks/release/gem_pin.rb
 - lib/hecks/release/gem_pin/published_versions.rb
+- lib/hecks/release/runner.rb
+- lib/hecks/release/runner/ci_publisher.rb
+- lib/hecks/release/runner/commands.rb
+- lib/hecks/release/runner/console.rb
+- lib/hecks/release/runner/gem_publisher.rb
+- lib/hecks/release/runner/git.rb
+- lib/hecks/release/runner/npm_publisher.rb
+- lib/hecks/release/runner/preflight.rb
+- lib/hecks/release/runner/published.rb
+- lib/hecks/release/runner/tagger.rb
 - lib/hecks/rendering.rb
 - lib/hecks/router.rb
 - lib/hecks/router/namespace_installer.rb

data/lib/hecks/bench/cli.rb

@@ -1,74 +0,0 @@
-require "optparse"
-require_relative "suite"
-require_relative "report"
-
-module Hecks
-  module Bench
-    # The command line behind `bin/bench`: parses flags, runs the `Suite`, prints the report.
-    #
-    # Kept in `lib/` so a spec can drive it with a tiny configuration and read what it
-    # prints, rather than shelling out to a script.
-    module CLI
-      # The defaults `bin/bench` runs with when no flag says otherwise.
-      DEFAULTS = { domains: %w[pizzas banking], targets: Suite::TARGETS, warmup: 200, iterations: 1000,
-                   runs: 3 }.freeze
-
-      module_function
-
-      # Runs the benchmark described by the command line and prints its report.
-      #
-      # @param argv [Array<String>] the command-line arguments
-      # @param out [#puts] where the report goes
-      # @param err [#puts] where progress and usage errors go
-      # @return [Integer] the process exit status: 0 on success, 2 for a usage error
-      def run(argv, out: $stdout, err: $stderr)
-        options = parse(argv)
-        result = Suite.call(options.fetch(:config), log: err)
-        out.puts(options[:format] == "json" ? Report.json(result) : Report.markdown(result))
-        File.write(options[:output], Report.json(result)) if options[:output]
-        0
-      rescue OptionParser::ParseError, ArgumentError => e
-        err.puts "bin/bench: #{e.message}"
-        2
-      end
-
-      # Turns command-line arguments into a configuration and output choices.
-      #
-      # @param argv [Array<String>] the command-line arguments
-      # @return [Hash{Symbol => Object}] `:config` (a `Suite::Config`), `:format` and `:output`
-      # @raise [OptionParser::ParseError] on an unknown or malformed flag
-      def parse(argv)
-        values = DEFAULTS.dup
-        extras = { format: "markdown", output: nil, rust_binary: nil }
-        parser(values, extras).parse(argv.dup)
-        { config: Suite::Config.new(**values, rust_binary: extras[:rust_binary]),
-          format: extras[:format], output: extras[:output] }
-      end
-
-      # Builds the flag parser.
-      #
-      # @param values [Hash{Symbol => Object}] the `Suite::Config` fields, filled in as flags parse
-      # @param extras [Hash{Symbol => Object}] the output choices, filled in as flags parse
-      # @return [OptionParser] the parser
-      def parser(values, extras)
-        OptionParser.new do |opts|
-          opts.banner = "usage: bin/bench [options]"
-          opts.on("--domain NAMES", Array, "pizzas, banking (default: both)") { |v| values[:domains] = v }
-          opts.on("--targets NAMES", Array, "#{Suite::TARGETS.join(', ')} (default: all)") { |v| values[:targets] = v }
-          opts.on("--iterations N", Integer, "timed cycles per run (default #{DEFAULTS[:iterations]})") do |v|
-            values[:iterations] = v
-          end
-          opts.on("--warmup N", Integer, "discarded cycles before timing (default #{DEFAULTS[:warmup]})") do |v|
-            values[:warmup] = v
-          end
-          opts.on("--runs N", Integer, "fresh boots per target, median reported (default #{DEFAULTS[:runs]})") do |v|
-            values[:runs] = v
-          end
-          opts.on("--rust-binary PATH", "use this `rust` binary instead of building one") { |v| extras[:rust_binary] = v }
-          opts.on("--format FORMAT", %w[markdown json], "markdown (default) or json") { |v| extras[:format] = v }
-          opts.on("--output PATH", "also write the full JSON result here") { |v| extras[:output] = v }
-        end
-      end
-    end
-  end
-end

data/lib/hecks/bench/environment.rb

@@ -1,100 +0,0 @@
-require "etc"
-require "open3"
-
-module Hecks
-  module Bench
-    # A description of the machine and toolchain a benchmark ran on.
-    #
-    # A number without its hardware is not reproducible, so every report carries
-    # this. Each probe is best effort: a missing tool becomes `"unknown"` rather
-    # than an error, since the benchmark itself is still valid without it.
-    module Environment
-      module_function
-
-      # Collects the machine and toolchain facts a report should carry.
-      #
-      # @return [Hash{Symbol => Object}] `:cpu`, `:cores`, `:memory_gib`, `:os`, `:ruby`,
-      #   `:yjit`, `:rustc`, `:cargo`, `:hecks`, `:commit` and `:load_average`
-      def describe
-        {
-          cpu: cpu, cores: Etc.nprocessors, memory_gib: memory_gib, os: os,
-          ruby: RUBY_DESCRIPTION, yjit: yjit?,
-          rustc: capture("rustc", "-V"), cargo: capture("cargo", "-V"),
-          hecks: Hecks::VERSION, commit: commit, load_average: load_average
-        }
-      end
-
-      # Reads the one-minute load average, the quickest sign that something else was
-      # busy while a benchmark ran. `Suite.call` reads it before and after and reports both.
-      #
-      # @return [Float, nil] the one-minute load average, or nil when it cannot be read
-      def load_average
-        text = RUBY_PLATFORM.include?("darwin") ? capture("sysctl", "-n", "vm.loadavg").delete("{}") : File.read("/proc/loadavg")
-        text.split.first.to_f.round(2)
-      rescue SystemCallError
-        nil
-      end
-
-      # Names the processor.
-      #
-      # @return [String] the CPU model, or `"unknown"`
-      def cpu
-        return capture("sysctl", "-n", "machdep.cpu.brand_string") if RUBY_PLATFORM.include?("darwin")
-
-        model = File.foreach("/proc/cpuinfo").find { |line| line.start_with?("model name") }
-        model ? model.split(":", 2).last.strip : "unknown"
-      rescue SystemCallError
-        "unknown"
-      end
-
-      # Reads installed memory.
-      #
-      # @return [Float, String] physical memory in GiB, or `"unknown"`
-      def memory_gib
-        bytes =
-          if RUBY_PLATFORM.include?("darwin")
-            capture("sysctl", "-n", "hw.memsize").to_i
-          else
-            File.read("/proc/meminfo")[/MemTotal:\s+(\d+)/, 1].to_i * 1024
-          end
-        bytes.zero? ? "unknown" : (bytes / (1024.0**3)).round(1)
-      rescue SystemCallError
-        "unknown"
-      end
-
-      # Names the operating system.
-      #
-      # @return [String] the OS name and version, or `"unknown"`
-      def os
-        return "macOS #{capture('sw_vers', '-productVersion')} (#{capture('uname', '-m')})" if RUBY_PLATFORM.include?("darwin")
-
-        capture("uname", "-sr")
-      end
-
-      # Says whether Ruby's `YJIT` compiler was running.
-      #
-      # @return [Boolean] true when `YJIT` is enabled in this process
-      def yjit?
-        defined?(RubyVM::YJIT) ? RubyVM::YJIT.enabled? : false
-      end
-
-      # Names the Hecks source revision under test.
-      #
-      # @return [String] the short commit hash, or `"unknown"` outside a git checkout
-      def commit
-        capture("git", "-C", File.expand_path("../../..", __dir__), "rev-parse", "--short", "HEAD")
-      end
-
-      # Runs a command and returns its first line of output.
-      #
-      # @param command [Array<String>] the program and its arguments
-      # @return [String] the trimmed first line of stdout, or `"unknown"` if it cannot run
-      def capture(*command)
-        out, status = Open3.capture2(*command, err: File::NULL)
-        status.success? && !out.strip.empty? ? out.lines.first.strip : "unknown"
-      rescue SystemCallError
-        "unknown"
-      end
-    end
-  end
-end

data/lib/hecks/bench/postgres_probe.rb

@@ -1,41 +0,0 @@
-module Hecks
-  module Bench
-    # Decides whether the Postgres targets can run at all.
-    #
-    # Postgres is optional. A machine with no server, or without the `pg` gem, gets a
-    # skipped target and a sentence saying why, never a stack trace. Connection
-    # settings come from libpq's own environment (`PGHOST`, `PGPORT`, `PGUSER`,
-    # `PGPASSWORD`), the same way the fuzzer's Postgres adapters read them.
-    module PostgresProbe
-      module_function
-
-      # Tries to reach the server's maintenance database.
-      #
-      # @return [String, nil] nil when a server answered, otherwise one sentence saying why
-      #   the Postgres targets cannot run
-      def unavailable_reason
-        require "pg"
-        PG.connect(dbname: "postgres", connect_timeout: 2).close
-        nil
-      rescue LoadError
-        "the `pg` gem is not installed"
-      rescue PG::Error => e
-        "no Postgres server is reachable (#{e.message.lines.first.to_s.strip}); start one, or point " \
-        "PGHOST, PGPORT and PGUSER at one"
-      end
-
-      # Reads the server's version for the report's environment block.
-      #
-      # @return [String] the `server_version` setting, or `"unknown"` if it cannot be read
-      def server_version
-        require "pg"
-        connection = PG.connect(dbname: "postgres", connect_timeout: 2)
-        connection.exec("SHOW server_version").getvalue(0, 0)
-      rescue LoadError, PG::Error
-        "unknown"
-      ensure
-        connection&.close
-      end
-    end
-  end
-end