hecks 7.0.0 → 7.1.0

data/rust/parser/src/keywords.rs

@@ -1898,6 +1898,18 @@ pub static KEYWORDS: &[KeywordRow] = &[
         resolves_via: "",
         disambiguator: "",
     },
+    KeywordRow {
+        word: "stays_inside",
+        context: "Adapter",
+        body: "none",
+        inner: "",
+        opens: "",
+        fills: "stays_inside",
+        status: "admitted",
+        was: "",
+        resolves_via: "",
+        disambiguator: "",
+    },
     KeywordRow {
         word: "data_translation",
         context: "File",

data/rust/parser/src/main.rs

@@ -344,6 +344,7 @@ const COVERED_PAIRS: &[(&str, &str)] = &[
     ("answers_query", "Adapter"),
     ("runs", "Adapter"),
     ("provides", "Adapter"),
+    ("stays_inside", "Adapter"),
     ("world", "File"),
     ("realm", "World"),
     ("latest", "World"),

data/rust/parser/src/parse/adapter.rs

@@ -114,6 +114,7 @@ fn parse_body(
                     1,
                 )?);
             }
+            "stays_inside" => adapter.stays_inside = true,
             // A repeat replaces the earlier value, as the Ruby builder's setter does.
             "runs" => {
                 adapter.runs = Some(super::positional_text(

data/rust/parser/src/phrases.rs

@@ -1111,6 +1111,22 @@ pub static PHRASES: &[PhraseRow] = &[
         canonical: "yes",
         status: "admitted",
     },
+    PhraseRow {
+        id: "examples_goal",
+        context: "Examples",
+        pattern: "Goal: {goal:rest}",
+        opens: "Goal",
+        canonical: "yes",
+        status: "admitted",
+    },
+    PhraseRow {
+        id: "goal_example",
+        context: "Goal",
+        pattern: "Example: {title:rest}",
+        opens: "Example",
+        canonical: "yes",
+        status: "admitted",
+    },
     PhraseRow {
         id: "person_role",
         context: "Background",

data/rust/parser/src/sentence/examples.rs

@@ -148,6 +148,7 @@ impl Parser<'_> {
             match m.id {
                 "background" => self.background(&m, &mut people)?,
                 "example" => tests.extend(self.example(&m, declaration, &people)?),
+                "examples_goal" => tests.extend(self.goal(&m, declaration, &people)?),
                 _ => return Err(self.unmeant(&m)),
             }
         }
@@ -177,6 +178,67 @@ impl Parser<'_> {
         Ok(())
     }
 
+    /// Reads one `Goal:` and the examples under it (ADR 0173). The goal names a `Background:`
+    /// person who pursues it; the first example is its main scenario and the others its
+    /// extensions. The tests compile as any example does; a goal adds only its two checks.
+    fn goal(
+        &mut self,
+        header: &Matched,
+        declaration: &ir::Bluebook,
+        people: &[Person],
+    ) -> ParseResult<Vec<TestOut>> {
+        let goal = header.text_of("goal");
+        if !people.iter().any(|p| pursues(&goal, &p.name)) {
+            let names: Vec<&str> = people.iter().map(|p| p.name.as_str()).collect();
+            return Err(self.error(
+                header.line,
+                header.col_of("goal"),
+                format!(
+                    "a goal names the person who pursues it, one of the Background people ({})",
+                    names.join(", ")
+                ),
+            ));
+        }
+        let mut scenarios: Vec<(usize, Vec<TestOut>)> = Vec::new();
+        let mut scope = Scope::inside(header.indent);
+        while let Some(step) = self.step(&mut scope, "Goal", false)? {
+            let Step::Phrase(m) = step else { continue };
+            match m.id {
+                "goal_example" => scenarios.push((m.line, self.example(&m, declaration, people)?)),
+                _ => return Err(self.unmeant(&m)),
+            }
+        }
+        let Some((main_line, main)) = scenarios.first() else {
+            return Err(self.error(header.line, 1, "this goal holds no `Example:`"));
+        };
+        if main.iter().any(|test| test.expect.refused.is_some()) {
+            return Err(self.error(
+                *main_line,
+                1,
+                format!(
+                    "goal_without_success: the main scenario of '{goal}' ends in a refusal, so nothing under the goal reaches it"
+                ),
+            ));
+        }
+        let path = main_path(main);
+        for (line, extension) in scenarios.iter().skip(1) {
+            if let Some(off) = extension
+                .iter()
+                .find(|test| !path.contains(&tested_verb(test)))
+            {
+                return Err(self.error(
+                    *line,
+                    1,
+                    format!(
+                        "extension_off_path: this extension of '{goal}' tries {}, which its main scenario never does",
+                        tested_verb(off)
+                    ),
+                ));
+            }
+        }
+        Ok(scenarios.into_iter().flat_map(|(_, tests)| tests).collect())
+    }
+
     /// Reads one `Example:` and compiles it, once per row of its `Where:` table.
     fn example(
         &mut self,
@@ -779,6 +841,37 @@ impl Parser<'_> {
 
 /// Every event a command announces, including those announced by commands that policies run in
 /// answer to its events, and so on until nothing new follows.
+/// Whether a goal's sentence begins with the person's name.
+fn pursues(goal: &str, person: &str) -> bool {
+    goal.len() > person.len()
+        && goal[..person.len()].eq_ignore_ascii_case(person)
+        && goal[person.len()..].starts_with(' ')
+}
+
+/// A test's tested command as `Aggregate.Command`.
+fn tested_verb(test: &TestOut) -> String {
+    format!("{}.{}", test.aggregate, test.command)
+}
+
+/// Every command a main scenario calls, its setups and its tested step, as `Aggregate.Command`.
+fn main_path(main: &[TestOut]) -> Vec<String> {
+    main.iter()
+        .flat_map(|test| {
+            test.setups
+                .iter()
+                .map(|setup| {
+                    setup
+                        .verb
+                        .rsplit("::")
+                        .next()
+                        .unwrap_or(&setup.verb)
+                        .to_string()
+                })
+                .chain(std::iter::once(tested_verb(test)))
+        })
+        .collect()
+}
+
 fn announced_by(declaration: &ir::Bluebook, command: &ir::Command) -> Vec<String> {
     let mut events: Vec<String> = command.emits.clone();
     let mut grew = true;

data/rust/parser/src/sentence/mod.rs

@@ -250,6 +250,7 @@ fn context_label(context: &str) -> &'static str {
         "ExamplesFile" => "the top of an examples file",
         "Examples" => "an examples file",
         "Background" => "a background",
+        "Goal" => "a goal",
         "Example" => "an example",
         "Step" => "a step",
         "Outcome" => "an outcome",

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: hecks
 version: !ruby/object:Gem::Version
-  version: 7.0.0
+  version: 7.1.0
 platform: ruby
 authors:
 - Chris Young
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-11-02 00:00:00.000000000 Z
+date: 2026-11-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: prism
@@ -211,6 +211,7 @@ files:
 - lib/hecks/adapters/driving/cli_runner/tour_words.rb
 - lib/hecks/adapters/driving/cli_runner/verb_names.rb
 - lib/hecks/adapters/driving/cli_runner/verbosity.rb
+- lib/hecks/adapters/driving/cli_runner/word_help.rb
 - lib/hecks/adapters/driving/command_request.rb
 - lib/hecks/adapters/driving/context_line.rb
 - lib/hecks/adapters/driving/exit_status.rb
@@ -246,6 +247,7 @@ files:
 - lib/hecks/behaviors.rb
 - lib/hecks/behaviors/dsl.rb
 - lib/hecks/behaviors/expectations.rb
+- lib/hecks/behaviors/expectations/adapter_selection.rb
 - lib/hecks/behaviors/expectations/boot.rb
 - lib/hecks/behaviors/expectations/checks.rb
 - lib/hecks/behaviors/expectations/dispatching.rb
@@ -421,6 +423,7 @@ files:
 - lib/hecks/bluebook/model_check.rb
 - lib/hecks/bluebook/model_check/aggregate_checks.rb
 - lib/hecks/bluebook/model_check/ask_checks.rb
+- lib/hecks/bluebook/model_check/classification_checks.rb
 - lib/hecks/bluebook/model_check/client_profile.rb
 - lib/hecks/bluebook/model_check/context_checks.rb
 - lib/hecks/bluebook/model_check/context_map_checks.rb
@@ -492,6 +495,10 @@ files:
 - lib/hecks/ci_speed/adapters/local_runner/refused.rb
 - lib/hecks/ci_speed/adapters/local_runner/verdict.rb
 - lib/hecks/ci_speed/adapters/replayed_runner.rb
+- lib/hecks/ci_speed/adapters/shard_partitioner.adapter
+- lib/hecks/ci_speed/adapters/shard_partitioner.rb
+- lib/hecks/ci_speed/adapters/timings_source.adapter
+- lib/hecks/ci_speed/adapters/timings_source.rb
 - lib/hecks/ci_speed/ci_speed.behaviors
 - lib/hecks/ci_speed/ci_speed.bluebook
 - lib/hecks/ci_speed/ci_speed.hecksagon
@@ -755,8 +762,12 @@ files:
 - lib/hecks/hecks/adapter_words.json
 - lib/hecks/hecks/adapters/area_overlap.rb
 - lib/hecks/hecks/adapters/bluebook_report.rb
+- lib/hecks/hecks/adapters/ci_runs.adapter
+- lib/hecks/hecks/adapters/ci_runs.rb
+- lib/hecks/hecks/adapters/claude_agent_list.rb
 - lib/hecks/hecks/adapters/claude_agents.adapter
 - lib/hecks/hecks/adapters/claude_agents.rb
+- lib/hecks/hecks/adapters/claude_jobs.rb
 - lib/hecks/hecks/adapters/claude_transcript.rb
 - lib/hecks/hecks/adapters/codebase/batch_runs.rb
 - lib/hecks/hecks/adapters/codebase/cache_clearing.rb
@@ -843,7 +854,9 @@ files:
 - lib/hecks/hecks/adapters/git_commit.rb
 - lib/hecks/hecks/adapters/git_landing.adapter
 - lib/hecks/hecks/adapters/git_landing.rb
+- lib/hecks/hecks/adapters/git_landing/carried.rb
 - lib/hecks/hecks/adapters/git_landing/finisher.rb
+- lib/hecks/hecks/adapters/git_landing/flagged.rb
 - lib/hecks/hecks/adapters/git_landing/foreign_hold.rb
 - lib/hecks/hecks/adapters/git_landing/line.rb
 - lib/hecks/hecks/adapters/git_landing/lineup.rb
@@ -857,6 +870,8 @@ files:
 - lib/hecks/hecks/adapters/git_landing/waiting.rb
 - lib/hecks/hecks/adapters/git_launcher.adapter
 - lib/hecks/hecks/adapters/git_launcher.rb
+- lib/hecks/hecks/adapters/git_leftovers.adapter
+- lib/hecks/hecks/adapters/git_leftovers.rb
 - lib/hecks/hecks/adapters/git_main_pull.rb
 - lib/hecks/hecks/adapters/git_refs.rb
 - lib/hecks/hecks/adapters/git_rehearsal.adapter
@@ -938,6 +953,7 @@ files:
 - lib/hecks/hecks/adapters/journal_store/reconciliation.rb
 - lib/hecks/hecks/adapters/journal_store/translation_write.rb
 - lib/hecks/hecks/adapters/journal_store/translation_write/shape_edge.rb
+- lib/hecks/hecks/adapters/landed_branches.rb
 - lib/hecks/hecks/adapters/landed_work.adapter
 - lib/hecks/hecks/adapters/landed_work.rb
 - lib/hecks/hecks/adapters/ledger.adapter
@@ -946,15 +962,35 @@ files:
 - lib/hecks/hecks/adapters/ledger/journal.rb
 - lib/hecks/hecks/adapters/local_files.adapter
 - lib/hecks/hecks/adapters/local_files.rb
+- lib/hecks/hecks/adapters/main_boarding.adapter
+- lib/hecks/hecks/adapters/main_boarding.rb
+- lib/hecks/hecks/adapters/main_integration.adapter
+- lib/hecks/hecks/adapters/main_integration.rb
+- lib/hecks/hecks/adapters/main_integration/checks.rb
+- lib/hecks/hecks/adapters/main_integration/command_runner.rb
+- lib/hecks/hecks/adapters/main_integration/range_guard.rb
+- lib/hecks/hecks/adapters/main_integration/repository.rb
+- lib/hecks/hecks/adapters/main_integration/runs.rb
+- lib/hecks/hecks/adapters/main_integration/train.rb
+- lib/hecks/hecks/adapters/main_verification.adapter
+- lib/hecks/hecks/adapters/main_verification.rb
 - lib/hecks/hecks/adapters/pg_admin.adapter
 - lib/hecks/hecks/adapters/pg_admin.rb
 - lib/hecks/hecks/adapters/pg_admin/ownership.rb
 - lib/hecks/hecks/adapters/process_pool.adapter
 - lib/hecks/hecks/adapters/process_pool.rb
+- lib/hecks/hecks/adapters/push_recorder.adapter
+- lib/hecks/hecks/adapters/push_recorder.rb
 - lib/hecks/hecks/adapters/push_size.rb
 - lib/hecks/hecks/adapters/qa_quiescing.adapter
 - lib/hecks/hecks/adapters/qa_quiescing.rb
 - lib/hecks/hecks/adapters/rails_app_files.rb
+- lib/hecks/hecks/adapters/red_flag_guard.rb
+- lib/hecks/hecks/adapters/red_flag_marker.rb
+- lib/hecks/hecks/adapters/red_flag_report.rb
+- lib/hecks/hecks/adapters/red_flag_survey.rb
+- lib/hecks/hecks/adapters/red_flagging.adapter
+- lib/hecks/hecks/adapters/red_flagging.rb
 - lib/hecks/hecks/adapters/rehearsal.rb
 - lib/hecks/hecks/adapters/rehearsal/audit_report.rb
 - lib/hecks/hecks/adapters/rehearsal/census.rb
@@ -976,6 +1012,7 @@ files:
 - lib/hecks/hecks/adapters/settings_reading.adapter
 - lib/hecks/hecks/adapters/settings_reading.rb
 - lib/hecks/hecks/adapters/settings_reading/disposable_ledger.rb
+- lib/hecks/hecks/adapters/settings_reading/event_tap_row.rb
 - lib/hecks/hecks/adapters/settings_reading/push_nudge.rb
 - lib/hecks/hecks/adapters/settings_reading/stores.rb
 - lib/hecks/hecks/adapters/settings_reading/test_scope.rb
@@ -1015,6 +1052,7 @@ files:
 - lib/hecks/hecks/migrate/migrate.bluebook
 - lib/hecks/hecks/operate/operate.bluebook
 - lib/hecks/hecks/quiesce/quiesce.bluebook
+- lib/hecks/hecks/redflag/redflag.bluebook
 - lib/hecks/hecks/rehearse/rehearse.bluebook
 - lib/hecks/hecks/release/release.bluebook
 - lib/hecks/hecks/serve/serve.bluebook
@@ -1065,6 +1103,47 @@ files:
 - lib/hecks/persistence_legacy_fixture.rb
 - lib/hecks/persistence_legacy_fixture/postgres_stores.rb
 - lib/hecks/persistence_legacy_fixture/regenerate.rb
+- lib/hecks/pipeline/pipeline.bluebook
+- lib/hecks/pipeline/pipeline.hecksagon
+- lib/hecks/pipeline_board/adapters/cache.rb
+- lib/hecks/pipeline_board/adapters/pipeline_fill.rb
+- lib/hecks/pipeline_board/adapters/pipeline_git.rb
+- lib/hecks/pipeline_board/adapters/pipeline_github.adapter
+- lib/hecks/pipeline_board/adapters/pipeline_github.rb
+- lib/hecks/pipeline_board/adapters/pipeline_github/runs.rb
+- lib/hecks/pipeline_board/adapters/pipeline_jobs.adapter
+- lib/hecks/pipeline_board/adapters/pipeline_jobs.rb
+- lib/hecks/pipeline_board/adapters/pipeline_journal.adapter
+- lib/hecks/pipeline_board/adapters/pipeline_journal.rb
+- lib/hecks/pipeline_board/adapters/pipeline_journal/chain.rb
+- lib/hecks/pipeline_board/adapters/pipeline_journal/tap.rb
+- lib/hecks/pipeline_board/adapters/pipeline_stages.adapter
+- lib/hecks/pipeline_board/adapters/pipeline_stages.rb
+- lib/hecks/pipeline_board/adapters/pipeline_stages/ci_tiles.rb
+- lib/hecks/pipeline_board/adapters/pipeline_stages/fanout.rb
+- lib/hecks/pipeline_board/adapters/pipeline_stages/gather.rb
+- lib/hecks/pipeline_board/adapters/pipeline_stages/metrics.rb
+- lib/hecks/pipeline_board/adapters/pipeline_stages/strip.rb
+- lib/hecks/pipeline_board/adapters/pipeline_stages/tile_kit.rb
+- lib/hecks/pipeline_board/adapters/pipeline_stages/work_tiles.rb
+- lib/hecks/pipeline_board/adapters/pipeline_tickets.adapter
+- lib/hecks/pipeline_board/adapters/pipeline_tickets.rb
+- lib/hecks/pipeline_board/adapters/pipeline_web.adapter
+- lib/hecks/pipeline_board/adapters/pipeline_web.rb
+- lib/hecks/pipeline_board/adapters/pipeline_web/page.html
+- lib/hecks/pipeline_board/adapters/pipeline_web/sequence.html
+- lib/hecks/pipeline_board/adapters/pipeline_web/server.rb
+- lib/hecks/pipeline_board/adapters/pipeline_web/snapshot.rb
+- lib/hecks/pipeline_board/adapters/pipeline_web/stream.rb
+- lib/hecks/pipeline_board/adapters/pipeline_web/wiring.html
+- lib/hecks/pipeline_board/adapters/pipeline_wiring.adapter
+- lib/hecks/pipeline_board/adapters/pipeline_wiring.rb
+- lib/hecks/pipeline_board/adapters/pipeline_wiring/details.rb
+- lib/hecks/pipeline_board/adapters/pipeline_wiring/graph.rb
+- lib/hecks/pipeline_board/adapters/probe.rb
+- lib/hecks/pipeline_board/pipeline_board.bluebook
+- lib/hecks/pipeline_board/pipeline_board.hecksagon
+- lib/hecks/pipeline_board/pipeline_board.ports.hecksagon
 - lib/hecks/ports.rb
 - lib/hecks/ports/access_control.port
 - lib/hecks/ports/access_control.rb
@@ -1590,6 +1669,7 @@ files:
 - lib/hecks/projector/narrate_projector.rb
 - lib/hecks/projector/narrate_projector/commands.rb
 - lib/hecks/projector/narrate_projector/reactions.rb
+- lib/hecks/projector/narrate_projector/use_cases.rb
 - lib/hecks/projector/target.rb
 - lib/hecks/quality_control/adapters/agent.adapter
 - lib/hecks/quality_control/adapters/agent.rb
@@ -1814,6 +1894,8 @@ files:
 - lib/hecks/runtime/entity_interpreter/saving.rb
 - lib/hecks/runtime/errors.rb
 - lib/hecks/runtime/event.rb
+- lib/hecks/runtime/event_log.rb
+- lib/hecks/runtime/event_tap.rb
 - lib/hecks/runtime/identity.rb
 - lib/hecks/runtime/instance.rb
 - lib/hecks/runtime/interpreting.rb
@@ -1866,6 +1948,8 @@ files:
 - lib/hecks/runtime/registry/query_verification.rb
 - lib/hecks/runtime/registry/read_repository.rb
 - lib/hecks/runtime/registry/runtime_state.rb
+- lib/hecks/runtime/registry/saga_anchor.rb
+- lib/hecks/runtime/registry/saga_durability_rule.rb
 - lib/hecks/runtime/registry/saga_persistence.rb
 - lib/hecks/runtime/registry/verification.rb
 - lib/hecks/runtime/registry/world_defaults.rb
@@ -2070,7 +2154,6 @@ files:
 - lib/hecks/tools/query_ir_run.rb
 - lib/hecks/tools/reference.rb
 - lib/hecks/tools/refresh_projections.rb
-- lib/hecks/tools/refresh_rspec_runtime_baseline.rb
 - lib/hecks/tools/regeneration_run.rb
 - lib/hecks/tools/regeneration_run/pool.rb
 - lib/hecks/tools/regeneration_run/scratch.rb
@@ -2094,6 +2177,7 @@ files:
 - lib/hecks/tools/sequence_script.rb
 - lib/hecks/tools/serve_query_ir_mcp.rb
 - lib/hecks/tools/shape.rb
+- lib/hecks/tools/shard_planner.rb
 - lib/hecks/tools/site_routes.rb
 - lib/hecks/tools/site_routes/cli.rb
 - lib/hecks/tools/site_routes/editor_files.rb
@@ -2152,8 +2236,8 @@ files:
 - lib/rubocop/cop/hecks/unnamed_pipeline.rb
 - lib/rubocop/cop/hecks/untyped_raise.rb
 - lib/rubocop/cop/hecks/value_object_shorthand.rb
-- prebuilt/13c04bdc5970295b310f0a980d397ba722232c8da99cc1a0cdb383249921e871.marshal
-- prebuilt/e3857b77f47d9ecc1787b2e1f5136364f3cb3444ef4aea5479f3b98167affea2.marshal
+- prebuilt/4b81646f769ae5b1e7457f9b11c48d8bc1093e96a1dd6fb61864065121ca6f01.marshal
+- prebuilt/681890632e3f4a99646623dcae44af36b1bad66c515f5abf67a2460372b9c6fd.marshal
 - qa/settings.yml
 - rust/.cargo/config.toml
 - rust/.cargo/mutants.toml

data/lib/hecks/tools/refresh_rspec_runtime_baseline.rb

@@ -1,166 +0,0 @@
-# frozen_string_literal: true
-
-require "fileutils"
-require "json"
-require "open3"
-require "yaml"
-
-module Hecks
-  module Tools
-    # The command behind `hecks refresh_runtime_baseline`: regenerates the committed runtime
-    # baselines the sharded CI jobs group from. It prefers one CI run's timings; a local run is
-    # the fallback.
-    #
-    #   hecks refresh_runtime_baseline --from-run <run-id>   # preferred: one CI run's timings
-    #   hecks refresh_runtime_baseline [workers]             # fallback: this machine only
-    #
-    # `--from-run` reads the runtime-log artifacts of a successful run and writes a family only
-    # when every leg uploaded one; a partial set would skew the split. Runner seconds differ from a
-    # laptop's, so a local baseline misses subprocess-heavy specs. The local mode refuses a red run.
-    module RefreshRspecRuntimeBaseline
-      REPO = "heckslabs/hecks"
-      USAGE = "usage: hecks refresh_runtime_baseline --from-run <run-id> | [workers]"
-
-      # Only `spec/..._spec.rb:<seconds>` lines; RSpec's "Run options" line must not be copied
-      # into a committed file. Seconds can arrive in exponent form (`9.69e-05`).
-      RUNTIME_LINE = %r{\A(?<file>spec/\S+_spec\.rb):(?<seconds>\d+(?:\.\d+)?(?:e-?\d+)?)\z}
-
-      # What a `--from-run` refresh works with: the checkout, the CI run, where its artifacts
-      # download to, and where progress goes.
-      Download = Struct.new(:root, :run_id, :dir, :out)
-
-      module_function
-
-      # Refreshes the baselines from a CI run or a local run.
-      #
-      # @param argv [Array<String>] `--from-run RUN_ID`, or optionally the local worker count
-      # @param root [String] the checkout whose `.github/` baselines are rewritten
-      # @param out [IO] where what was written goes
-      # @return [Integer] the exit status, 0 once written
-      # @raise [SystemExit] when the run is unreadable or unsuccessful, the local suite is red, or
-      #   no artifact family is complete
-      def call(argv, root:, out: $stdout)
-        if argv.first == "--from-run"
-          from_run(root, argv.fetch(1) { abort USAGE }, out)
-        else
-          from_local(root, argv.fetch(0) { abort USAGE }, out)
-        end
-        0
-      end
-
-      # Reads the leg counts from the workflow matrix so a resize cannot leave a stale count here.
-      #
-      # @param root [String] the checkout
-      # @return [Hash{String => Hash}] each artifact family's leg count and baseline file
-      def families(root)
-        {
-          "rspec-runtime-group"       => { legs:     matrix_legs(root, "ci-rspec.yml", "rspec_shard"),
-                                           baseline: ".github/rspec_runtime_baseline.log" },
-          "postgres-io-runtime-group" => { legs:     matrix_legs(root, "ci-postgres-io-parallel.yml",
-                                                                 "rspec_postgres_io_parallel_shard"),
-                                           baseline: ".github/postgres_io_runtime_baseline.log" }
-        }
-      end
-
-      # @param root [String] the checkout
-      # @param workflow [String] the workflow file's name
-      # @param job [String] the job whose matrix is counted
-      # @return [Integer] how many groups the job's matrix has
-      def matrix_legs(root, workflow, job)
-        YAML.load_file(File.join(root, ".github/workflows", workflow)).dig("jobs", job, "strategy", "matrix", "group").size
-      end
-
-      # @param paths [Array<String>] runtime logs
-      # @return [Array<String>] one sorted `file:seconds` line per spec file
-      def baseline_lines(paths)
-        seconds_by_file = paths.flat_map { |path| File.readlines(path) }.filter_map do |line|
-          match = RUNTIME_LINE.match(line.strip) or next
-          [match[:file], Float(match[:seconds])]
-        end.to_h
-        seconds_by_file.map { |file, seconds| format("%<file>s:%<seconds>.2f", file: file, seconds: seconds) }.sort
-      end
-
-      # @param root [String] the checkout
-      # @param relative [String] the baseline's path under the checkout
-      # @param lines [Array<String>] the baseline's lines
-      # @param out [IO] where the note goes
-      # @return [void]
-      def write_baseline(root, relative, lines, out)
-        File.write(File.join(root, relative), "#{lines.join("\n")}\n")
-        out.puts "wrote #{relative}: #{lines.size} spec files"
-      end
-
-      # @param run_id [String] the CI run's id
-      # @return [void]
-      # @raise [SystemExit] when `gh` cannot read the run or it did not succeed
-      def refuse_unless_successful!(run_id)
-        out, status = Open3.capture2("gh", "run", "view", run_id, "-R", REPO, "--json", "conclusion")
-        abort "hecks refresh_runtime_baseline: could not read run #{run_id}" unless status.success?
-
-        conclusion = JSON.parse(out)["conclusion"]
-        return if conclusion == "success"
-
-        abort "hecks refresh_runtime_baseline: run #{run_id} concluded #{conclusion.inspect} — " \
-              "refusing to write a baseline from anything but a successful run"
-      end
-
-      # @param root [String] the checkout
-      # @param run_id [String] the CI run's id
-      # @param out [IO] where what was written goes
-      # @return [void]
-      # @raise [SystemExit] when no family of artifacts is complete
-      def from_run(root, run_id, out)
-        refuse_unless_successful!(run_id)
-        dir = File.join(root, "tmp/ci-runtime-#{run_id}")
-        FileUtils.rm_rf(dir)
-
-        download = Download.new(root, run_id, dir, out)
-        written = families(root).count { |prefix, family| refresh_family(download, prefix, family) }
-        return unless written.zero?
-
-        abort "hecks refresh_runtime_baseline: run #{run_id} had no complete artifact family — nothing written"
-      end
-
-      # Downloads one artifact family and writes its baseline when every leg uploaded a log.
-      #
-      # @api private
-      # @return [Boolean] whether the family was complete and written
-      def refresh_family(download, prefix, family)
-        logs = download_logs(download, prefix)
-        legs = logs.map { |path| File.basename(File.dirname(path)) }.uniq.size
-        complete = legs == family[:legs]
-        if complete
-          write_baseline(download.root, family[:baseline], baseline_lines(logs), download.out)
-        else
-          warn "skipping #{family[:baseline]}: run #{download.run_id} has #{legs} of #{family[:legs]} #{prefix}-* artifacts"
-        end
-        complete
-      end
-
-      # @api private
-      def download_logs(download, prefix)
-        system("gh", "run", "download", download.run_id, "-R", REPO, "-p", "#{prefix}-*", "-D", download.dir,
-               out: File::NULL, err: File::NULL)
-        Dir[File.join(download.dir, "#{prefix}-*", "*.log")]
-      end
-
-      # @param root [String] the checkout
-      # @param workers [String] how many `parallel_rspec` workers to time with
-      # @param out [IO] where what was written goes
-      # @return [void]
-      # @raise [SystemExit] when the local suite is red
-      def from_local(root, workers, out)
-        raw = "tmp/rspec_runtime_baseline.raw.log"
-        FileUtils.mkdir_p(File.join(root, "tmp"))
-        FileUtils.rm_f(File.join(root, raw))
-
-        formatters = "--tag ~io --tag ~fuzzing --format progress --format ParallelTests::RSpec::RuntimeLogger --out #{raw}"
-        green = system("bundle", "exec", "parallel_rspec", "spec", "-n", workers, "-o", formatters, chdir: root)
-        abort "hecks refresh_runtime_baseline: the spec run failed — not writing a baseline from a red suite" unless green
-
-        write_baseline(root, families(root).fetch("rspec-runtime-group")[:baseline],
-                       baseline_lines([File.join(root, raw)]), out)
-      end
-    end
-  end
-end