hecks 2.6.0 → 2.8.0

data/lib/hecks/vendoring.rb

@@ -0,0 +1,102 @@
+require "fileutils"
+require "tmpdir"
+require_relative "vendoring/git_environment"
+require_relative "vendoring/git_source"
+
+module Hecks
+  # Pins an exact commit of one directory of another repository into a
+  # project's own tree.
+  #
+  # ## What it is
+  #
+  # A project that consumes a package from a private repository cannot clone
+  # that repository when its image builds, and a live pull would make the build
+  # depend on whatever is checked out. So the files are exported from one
+  # commit, committed into the consumer, and a marker file beside them records
+  # which commit they came from. Only the files directly inside the named
+  # subtree are taken; the source's own specs, ports, adapters and data stay
+  # where they are.
+  #
+  # ## Marker
+  #
+  # `VENDORED_COMMIT` holds the full 40-character commit id and a newline, so
+  # `git -C <source> show <id>:<subtree>` reproduces the vendored files. The
+  # marker sits in `into`, beside the exported directory.
+  #
+  # ## Whole-directory replacement
+  #
+  # A pin replaces `into` entirely, so a file the source dropped does not
+  # linger. Nothing is touched until the export succeeded and the optional
+  # block accepted it.
+  module Vendoring
+    # Raised when a pin cannot be made or is refused.
+    class Error < StandardError; end
+
+    # File name of the commit marker written into every pinned directory.
+    MARKER = "VENDORED_COMMIT".freeze
+
+    # What a pin produced.
+    #
+    # @!attribute [r] commit
+    #   @return [String] the full commit id the files were exported from
+    # @!attribute [r] dir
+    #   @return [String] the directory holding the exported subtree
+    # @!attribute [r] files
+    #   @return [Array<String>] the exported files' names, sorted
+    Pin = Struct.new(:commit, :dir, :files, keyword_init: true)
+
+    # Exports the top-level files of one directory at one commit into `into`.
+    #
+    # The exported files land in `into/<last segment of subtree>/`; the marker
+    # lands in `into` itself. The optional block sees the staged files before
+    # anything is replaced and may raise to refuse the pin.
+    #
+    # @param from [String] path of the local source repository
+    # @param ref [String] the commit-ish to export (branch, tag or commit id)
+    # @param subtree [String] repository-relative directory to export, such as
+    #   `"payments/bluebook"`
+    # @param into [String] the directory to replace with the export
+    # @param glob [String] `File.fnmatch` pattern each exported file's name must match
+    # @param marker [String] name of the file recording the commit
+    # @yield [staged, commit] the staged files, before `into` is touched
+    # @yieldparam staged [String] directory holding the exported files
+    # @yieldparam commit [String] the resolved commit id
+    # @yieldreturn [Hash{String => String}, nil] extra files to write into `into`,
+    #   keyed by file name; nil for none
+    # @return [Pin] the commit and where the files landed
+    # @raise [Vendoring::Error] if the source is missing, `ref` names no commit,
+    #   the subtree holds no matching file, or the block refuses
+    def self.pin(from:, ref:, subtree:, into:, glob: "*", marker: MARKER)
+      source = GitSource.new(from)
+      commit = source.commit(ref)
+      files = source.files(commit, subtree, glob)
+      raise Error, "no #{glob} files in #{subtree} at #{ref} in #{source.path}" if files.empty?
+
+      Dir.mktmpdir("hecks-vendoring") do |stage|
+        source.export(commit, files, stage)
+        staged = File.join(stage, subtree)
+        extras = block_given? ? yield(staged, commit) : nil
+        install(staged, into, marker, commit, extras || {})
+        Pin.new(commit: commit, dir: File.join(into, File.basename(subtree)),
+                files: files.map { |file| File.basename(file) })
+      end
+    end
+
+    # Replaces `into` with the staged files, the marker and any extras.
+    #
+    # @param staged [String] directory holding the exported files
+    # @param into [String] the directory to replace
+    # @param marker [String] marker file name
+    # @param commit [String] commit id the marker records
+    # @param extras [Hash{String => String}] more files to write into `into`
+    # @return [void]
+    def self.install(staged, into, marker, commit, extras)
+      FileUtils.rm_rf(into)
+      FileUtils.mkdir_p(into)
+      FileUtils.cp_r(staged, File.join(into, File.basename(staged)))
+      File.write(File.join(into, marker), "#{commit}\n")
+      extras.each { |name, text| File.write(File.join(into, name), text) }
+    end
+    private_class_method :install
+  end
+end

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.6.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,10 +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`/
@@ -57,7 +63,7 @@ module Hecks
     # `environments/<name>.hecksagon` / `.world` overlay it loads —
     # see Adapters::Folder#load_domain) existed on a prior commit of
     # this repo (933d1dd), was vendored out to a real consumer
-    # (lifeadelics/domain), and was then lost from this repo's own
+    # (a client site's domain), and was then lost from this repo's own
     # history (no branch here reaches that commit). Ported forward
     # from the consumer's vendor snapshot — the only surviving copy —
     # and generalized: the original only loaded a `.hecksagon`

metadata

@@ -1,12 +1,12 @@
 --- !ruby/object:Gem::Specification
 name: hecks
 version: !ruby/object:Gem::Version
-  version: 2.6.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,14 +190,27 @@ 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
+- lib/hecks/embryonaut_bluebook/vendor.rb
+- lib/hecks/embryonaut_bluebook/vendor_cli.rb
 - lib/hecks/facade.rb
 - lib/hecks/facade/cli_door.rb
 - lib/hecks/facade/cli_runner.rb
@@ -242,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
@@ -314,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
@@ -353,6 +318,7 @@ files:
 - lib/hecks/ports/persistence/plugins/era/era_guard.rb
 - lib/hecks/ports/persistence/plugins/era/era_guard/shape_diff.rb
 - lib/hecks/ports/persistence/plugins/era/era_tamper.rb
+- lib/hecks/ports/persistence/plugins/era/expected_era.rb
 - lib/hecks/ports/persistence/plugins/era/lineage.rb
 - lib/hecks/ports/persistence/plugins/era/postgres_era.rb
 - lib/hecks/ports/persistence/plugins/era/postgres_era/lineage.rb
@@ -382,6 +348,8 @@ files:
 - lib/hecks/ports/persistence/plugins/era/translation/scaffold/differ.rb
 - lib/hecks/ports/persistence/plugins/era/translation/scaffold/renderer.rb
 - lib/hecks/ports/persistence/plugins/era/translation/scaffold/writer.rb
+- lib/hecks/ports/persistence/postgres_dump.rb
+- lib/hecks/ports/persistence/postgres_dump/connection.rb
 - lib/hecks/ports/persistence/remote_runtime.rb
 - lib/hecks/ports/persistence/repository_factory.rb
 - lib/hecks/ports/persistence/state_codec.rb
@@ -393,8 +361,39 @@ files:
 - lib/hecks/projections.rb
 - lib/hecks/projections/bootstrap_table.rb
 - lib/hecks/projections/deploy/fargate.rb
+- lib/hecks/projections/deploy/fargate/assembly.rb
+- lib/hecks/projections/deploy/fargate/cdn.rb
+- lib/hecks/projections/deploy/fargate/cdn_default.rb
+- lib/hecks/projections/deploy/fargate/check.rb
+- lib/hecks/projections/deploy/fargate/containers.rb
+- lib/hecks/projections/deploy/fargate/extras.rb
+- lib/hecks/projections/deploy/fargate/monitoring.rb
+- lib/hecks/projections/deploy/fargate/settings.rb
+- lib/hecks/projections/deploy/fargate/yaml.rb
 - lib/hecks/projections/deploy/lambda.rb
+- lib/hecks/projections/deploy/preview.rb
+- lib/hecks/projections/deploy/preview/access_yaml.rb
+- lib/hecks/projections/deploy/preview/containers.rb
+- lib/hecks/projections/deploy/preview/preview.sh.erb
+- lib/hecks/projections/deploy/preview/routing_yaml.rb
+- lib/hecks/projections/deploy/preview/script.rb
+- lib/hecks/projections/deploy/preview/settings.rb
+- lib/hecks/projections/deploy/preview/task_yaml.rb
+- lib/hecks/projections/deploy/preview/template.rb
+- lib/hecks/projections/deploy/preview/yaml_text.rb
+- lib/hecks/projections/deploy/scripts.rb
+- lib/hecks/projections/deploy/scripts/deploy-service.sh.tmpl
+- lib/hecks/projections/deploy/scripts/expected-era.header
+- lib/hecks/projections/deploy/scripts/hosting.mk.tmpl
+- lib/hecks/projections/deploy/scripts/settings.rb
+- lib/hecks/projections/deploy/scripts/smoke-after-deploy.sh.tmpl
 - lib/hecks/projections/deploy/shared.rb
+- lib/hecks/projections/deploy/smoke.rb
+- lib/hecks/projections/deploy/smoke/harness.js
+- lib/hecks/projections/deploy/smoke/workflow.yml.tmpl
+- lib/hecks/projections/deploy/template_diff.rb
+- lib/hecks/projections/deploy/template_diff/comparer.rb
+- lib/hecks/projections/deploy/template_diff/loader.rb
 - lib/hecks/projections/diagrams.rb
 - lib/hecks/projections/glossary.rb
 - lib/hecks/projections/glossary/html.rb
@@ -422,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
@@ -441,6 +439,18 @@ files:
 - lib/hecks/query_specification/field_path.rb
 - lib/hecks/query_specification/hop_path.rb
 - 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
@@ -481,6 +491,7 @@ files:
 - lib/hecks/runtime/registry.rb
 - lib/hecks/runtime/registry/saga_persistence.rb
 - lib/hecks/runtime/registry/verification.rb
+- lib/hecks/runtime/registry/world_defaults.rb
 - lib/hecks/runtime/remote_dispatcher.rb
 - lib/hecks/runtime/routing.rb
 - lib/hecks/runtime/saga_interpreter.rb
@@ -496,6 +507,9 @@ files:
 - lib/hecks/storehouse.rb
 - lib/hecks/tenancy/bluebook/tenancy.bluebook
 - lib/hecks/tenancy/bluebook/tenancy.hecksagon
+- lib/hecks/vendoring.rb
+- lib/hecks/vendoring/git_environment.rb
+- lib/hecks/vendoring/git_source.rb
 - lib/hecks/version.rb
 - lib/hecks/vocabulary.rb
 - lib/rubocop/cop/hecks/fallback_hash_lookup.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