kettle-dev 2.3.10 → 2.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 043a73e1a2fb35f02748261dc4d5f81865e233a982c10b73d6b957ef7a7ce66d
-  data.tar.gz: 4695065e3a9a9ce34f586fb4baeb76064b59048914a7c12e5e1590435dfe5862
+  metadata.gz: dc6dd6b412d11d659d2f5ed0916372e599642a82640335700f3e723937638cba
+  data.tar.gz: 86114a4e096dd7da0934477c06aee521372d6eeb5f2114377d0a035b32be42f1
 SHA512:
-  metadata.gz: 555075c8b24c72b0a3ae955d790d0af6b97f265a5fcd00dd3aad16bf3c46ca315081b64d6a39553039e70c438774553826eb7e2a7ecc358e441fa1a066cadeb1
-  data.tar.gz: 896b19afe31b86aaed964605cf63767ec1d8bc4d8c214e1599835781c2f86919d1510d1601a7597cb53cf57713812779b07de550d710e0d7ac40c3c4f7d28d4b
+  metadata.gz: f056c2d67dee284c734c2b0bf5cb06ce957d981cc7c8f922108b2cf1c3b3a8acf5c0c2a1fe8b7b3347ae92c85f780f82ab1e14cf677e12591ece125522bdf967
+  data.tar.gz: 1c5db4b16afe9840dca06f5a6a1528fe3afa3dadb68b727c2b95c43bfa3240d19625aad892a792000841b42640d07451136f0f87a18f2e711aba5f7107721368

data/CHANGELOG.md

@@ -30,6 +30,39 @@ Please file a bug if you notice a violation of semantic versioning.
 
 ### Security
 
+## [2.4.0] - 2026-07-23
+
+- TAG: [v2.4.0][2.4.0t]
+- COVERAGE: 92.49% -- 3830/4141 lines in 38 files
+- BRANCH COVERAGE: 76.22% -- 1516/1989 branches in 38 files
+- 58.66% documented
+
+### Added
+
+- Packaged executables now answer `-v` and bare `--version` with the
+  `kettle-dev` gem version they shipped with.
+
+### Changed
+
+- Raised the runtime dependency floor for `kettle-gha-pins` to `0.3.1`.
+- Packaged executables now share a consistent startup header on normal
+  execution paths.
+- Markdown image URL cache/live/skipped progress now uses the same multi-line
+  `tty-progressbar` output as GitHub Actions pin checks.
+
+## [2.3.11] - 2026-07-23
+
+- TAG: [v2.3.11][2.3.11t]
+- COVERAGE: 92.17% -- 3791/4113 lines in 37 files
+- BRANCH COVERAGE: 75.80% -- 1500/1979 branches in 37 files
+- 59.51% documented
+
+### Fixed
+
+- GitHub Actions release monitoring now falls back to repository-level workflow
+  runs when a per-workflow endpoint lags for the pushed HEAD, and waits up to
+  five minutes by default for workflows to appear.
+
 ## [2.3.10] - 2026-07-23
 
 - TAG: [v2.3.10][2.3.10t]
@@ -2613,7 +2646,11 @@ Please file a bug if you notice a violation of semantic versioning.
   - Selecting will run the selected workflow via `act`
   - This may move to its own gem in the future.
 
-[Unreleased]: https://github.com/kettle-dev/kettle-dev/compare/v2.3.10...HEAD
+[Unreleased]: https://github.com/kettle-dev/kettle-dev/compare/v2.4.0...HEAD
+[2.4.0]: https://github.com/kettle-dev/kettle-dev/compare/v2.3.11...v2.4.0
+[2.4.0t]: https://github.com/kettle-dev/kettle-dev/releases/tag/v2.4.0
+[2.3.11]: https://github.com/kettle-dev/kettle-dev/compare/v2.3.10...v2.3.11
+[2.3.11t]: https://github.com/kettle-dev/kettle-dev/releases/tag/v2.3.11
 [2.3.10]: https://github.com/kettle-dev/kettle-dev/compare/v2.3.9...v2.3.10
 [2.3.10t]: https://github.com/kettle-dev/kettle-dev/releases/tag/v2.3.10
 [2.3.9]: https://github.com/kettle-dev/kettle-dev/compare/v2.3.8...v2.3.9

data/LICENSE.md

@@ -3,7 +3,7 @@
 This project is made available under the following license.
 Choose the option that best fits your use case:
 
-- [AGPL-3.0-only](AGPL-3.0-only.md)
+- [AGPL-3.0-only](https://github.com/kettle-dev/kettle-dev/blob/main/AGPL-3.0-only.md)
 
 If none of the above licenses fit your use case, please [contact us](mailto:floss@galtzo.com) to discuss a custom commercial license.
 

data/README.md

@@ -94,7 +94,7 @@ bin/kettle-release
 | Works with MRI Ruby 3 | [![Ruby 3.0 Compat][💎ruby-3.0i]][🚎ruby-3.0-wf] [![Ruby 3.1 Compat][💎ruby-3.1i]][🚎ruby-3.1-wf] [![Ruby 3.2 Compat][💎ruby-3.2i]][🚎ruby-3.2-wf] [![Ruby 3.3 Compat][💎ruby-3.3i]][🚎ruby-3.3-wf] [![Ruby 3.4 Compat][💎ruby-3.4i]][🚎ruby-3.4-wf]|
 | Works with MRI Ruby 2 | [![Ruby 2.4 Compat][💎ruby-2.4i]][🚎ruby-2.4-wf] [![Ruby 2.5 Compat][💎ruby-2.5i]][🚎ruby-2.5-wf] [![Ruby 2.6 Compat][💎ruby-2.6i]][🚎ruby-2.6-wf] [![Ruby 2.7 Compat][💎ruby-2.7i]][🚎ruby-2.7-wf]|
 | Support & Community | [![Join Me on Daily.dev's RubyFriends][✉️ruby-friends-img]][✉️ruby-friends] [![Get help from RubyForum][✉️ruby-forum-img]][✉️ruby-forum] [![Live Chat on Discord][✉️discord-invite-img-ftb]][✉️discord-invite] [![Get help from me on Upwork][👨🏼‍🏫expsup-upwork-img]][👨🏼‍🏫expsup-upwork] [![Get help from me on Codementor][👨🏼‍🏫expsup-codementor-img]][👨🏼‍🏫expsup-codementor] |
-| Source | [![Source on GitLab.com][📜src-gl-img]][📜src-gl] [![Source on CodeBerg.org][📜src-cb-img]][📜src-cb] [![Source on Github.com][📜src-gh-img]][📜src-gh] [![The best SHA: dQw4w9WgXcQ!][🧮kloc-img]][🧮kloc] |
+| Source | [![Source on GitLab.com][📜src-gl-img]][📜src-gl] [![Source on CodeBerg.org][📜src-cb-img]][📜src-cb] [![Source on GitHub.com][📜src-gh-img]][📜src-gh] [![The best SHA: dQw4w9WgXcQ!][🧮kloc-img]][🧮kloc] |
 | Documentation | [![Current release on RubyDoc.info][📜docs-cr-rd-img]][🚎yard-current] [![YARD on Galtzo.com][📜docs-head-rd-img]][🚎yard-head] [![Maintainer Blog][🚂maint-blog-img]][🚂maint-blog] [![GitLab Wiki][📜gl-wiki-img]][📜gl-wiki] [![GitHub Wiki][📜gh-wiki-img]][📜gh-wiki] |
 | Compliance | [![License: AGPL-3.0-only][📄license-img]][📄license] [![Apache license compatibility: Category X][📄license-compat-img]][📄license-compat] [![📄ilo-declaration-img]][📄ilo-declaration] [![Security Policy][🔐security-img]][🔐security] [![Contributor Covenant 2.1][🪇conduct-img]][🪇conduct] [![SemVer 2.0.0][📌semver-img]][📌semver] |
 | Style | [![Enforced Code Style Linter][💎rlts-img]][💎rlts] [![Keep-A-Changelog 1.0.0][📗keep-changelog-img]][📗keep-changelog] [![Gitmoji Commits][📌gitmoji-img]][📌gitmoji] [![Compatibility appraised by: appraisal2][💎appraisal2-img]][💎appraisal2] |
@@ -666,7 +666,7 @@ See [CHANGELOG.md][📌changelog] for a list of releases.
 
 ## 📄 License
 
-The gem is available under the following license: [AGPL-3.0-only](AGPL-3.0-only.md).
+The gem is available under the following license: [AGPL-3.0-only](https://github.com/kettle-dev/kettle-dev/blob/main/AGPL-3.0-only.md).
 See [LICENSE.md][📄license] for details.
 
 If none of the available licenses suit your use case, please [contact us](mailto:floss@galtzo.com) to discuss a custom commercial license.
@@ -783,7 +783,7 @@ Thanks for RTFM. ☺️
 [📜src-gl]: https://gitlab.com/kettle-dev/kettle-dev
 [📜src-cb-img]: https://img.shields.io/badge/CodeBerg-4893CC?style=for-the-badge&logo=CodeBerg&logoColor=blue
 [📜src-cb]: https://codeberg.org/kettle-dev/kettle-dev
-[📜src-gh-img]: https://img.shields.io/badge/GitHub-238636?style=for-the-badge&logo=Github&logoColor=green
+[📜src-gh-img]: https://img.shields.io/badge/GitHub-238636?style=for-the-badge&logo=GitHub&logoColor=green
 [📜src-gh]: https://github.com/kettle-dev/kettle-dev
 [📜docs-cr-rd-img]: https://img.shields.io/badge/RubyDoc-Current_Release-943CD2?style=for-the-badge&logo=readthedocs&logoColor=white
 [📜docs-head-rd-img]: https://img.shields.io/badge/YARD_on_Galtzo.com-HEAD-943CD2?style=for-the-badge&logo=readthedocs&logoColor=white
@@ -891,12 +891,12 @@ Thanks for RTFM. ☺️
 [📌gitmoji]: https://gitmoji.dev
 [📌gitmoji-img]: https://img.shields.io/badge/gitmoji_commits-%20%F0%9F%98%9C%20%F0%9F%98%8D-34495e.svg?style=flat-square
 [🧮kloc]: https://www.youtube.com/watch?v=dQw4w9WgXcQ
-[🧮kloc-img]: https://img.shields.io/badge/KLOC-4.104-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
+[🧮kloc-img]: https://img.shields.io/badge/KLOC-4.141-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
 [🔐security]: https://github.com/kettle-dev/kettle-dev/blob/main/SECURITY.md
 [🔐security-img]: https://img.shields.io/badge/security-policy-259D6C.svg?style=flat
 [📄copyright-notice-explainer]: https://opensource.stackexchange.com/questions/5778/why-do-licenses-such-as-the-mit-license-specify-a-single-year
 [📄license]: LICENSE.md
-[📄license-ref]: AGPL-3.0-only.md
+[📄license-ref]: https://github.com/kettle-dev/kettle-dev/blob/main/AGPL-3.0-only.md
 [📄license-img]: https://img.shields.io/badge/License-AGPL--3.0--only-259D6C.svg
 [📄license-compat]: https://www.apache.org/legal/resolved.html#category-x
 [📄license-compat-img]: https://img.shields.io/badge/Apache_Incompatible:_Category_X-%E2%9C%97-C0392B.svg?style=flat&logo=Apache

data/exe/kettle-bump

@@ -15,10 +15,14 @@ rescue LoadError
 end
 
 script_basename = File.basename(__FILE__)
+repo_lib = File.expand_path("../lib", __dir__)
+$LOAD_PATH.unshift(repo_lib) if File.directory?(repo_lib) && !$LOAD_PATH.include?(repo_lib)
 
 begin
   require "kettle/dev"
-  puts "== #{script_basename} v#{Kettle::Dev::Version::VERSION} =="
+  require "kettle/dev/executable_version"
+  Kettle::Dev::ExecutableVersion.print_and_exit!(script_basename, ARGV)
+  Kettle::Dev::ExecutableVersion.print_header(script_basename)
 rescue LoadError => e
   warn("#{script_basename}: could not load dependency: #{e.class}: #{e.message}")
   warn("Hint: Ensure the host project has kettle-dev as a dependency and run bundle install.")

data/exe/kettle-changelog

@@ -36,6 +36,8 @@ rescue LoadError
 end
 
 script_basename = File.basename(__FILE__)
+repo_lib = File.expand_path("../lib", __dir__)
+$LOAD_PATH.unshift(repo_lib) if File.directory?(repo_lib) && !$LOAD_PATH.include?(repo_lib)
 
 begin
   # Standard library
@@ -46,7 +48,9 @@ begin
 
   # This library
   require "kettle/dev"
-  puts "== #{script_basename} v#{Kettle::Dev::Version::VERSION} ==" unless ARGV.include?("--json")
+  require "kettle/dev/executable_version"
+  Kettle::Dev::ExecutableVersion.print_and_exit!(script_basename, ARGV, value_option: true)
+  Kettle::Dev::ExecutableVersion.print_header(script_basename) unless ARGV.include?("--json")
 rescue LoadError => e
   warn("#{script_basename}: could not load dependency: #{e.class}: #{e.message}")
   warn("Hint: Ensure the host project has kettle-dev as a dependency and run bundle install.")

data/exe/kettle-check-eof

@@ -1,6 +1,18 @@
 #!/usr/bin/env ruby
 # frozen_string_literal: true
 
+$stdout.sync = true
+$stderr.sync = true
+
+repo_lib = File.expand_path("../lib", __dir__)
+$LOAD_PATH.unshift(repo_lib) if File.directory?(repo_lib) && !$LOAD_PATH.include?(repo_lib)
+
+require "kettle/dev/executable_version"
+
+script_basename = File.basename(__FILE__)
+Kettle::Dev::ExecutableVersion.print_and_exit!(script_basename, ARGV)
+Kettle::Dev::ExecutableVersion.print_header(script_basename)
+
 bin_dir = File.expand_path(__dir__)
 bash_script = File.join(bin_dir, "kettle-check-eof.sh")
 

data/exe/kettle-commit-msg

@@ -16,6 +16,8 @@ rescue LoadError
 end
 
 script_basename = File.basename(__FILE__)
+repo_lib = File.expand_path("../lib", __dir__)
+$LOAD_PATH.unshift(repo_lib) if File.directory?(repo_lib) && !$LOAD_PATH.include?(repo_lib)
 
 begin
   # Standard library
@@ -25,11 +27,12 @@ begin
     require "kettle/dev"
   rescue LoadError
     # Fallback: allow running from a checkout without bundler by adding ./lib to the load path
-    repo_lib = File.expand_path("../lib", __dir__)
     $LOAD_PATH.unshift(repo_lib) unless $LOAD_PATH.include?(repo_lib)
     require "kettle/dev"
   end
-  puts "== #{script_basename} v#{Kettle::Dev::Version::VERSION} =="
+  require "kettle/dev/executable_version"
+  Kettle::Dev::ExecutableVersion.print_and_exit!(script_basename, ARGV)
+  Kettle::Dev::ExecutableVersion.print_header(script_basename)
 rescue LoadError => e
   warn("#{script_basename}: could not load dependency: #{e.class}: #{e.message}")
   warn("Hint: Install the kettle-dev gem (`gem install kettle-dev`) or add it to your Gemfile. Bundler is not required for this script.")

data/exe/kettle-dev-setup

@@ -6,6 +6,15 @@
 # kettle-dev-setup has been replaced by kettle-jem setup.
 # All setup and templating functionality has moved to the kettle-jem gem.
 
+repo_lib = File.expand_path("../lib", __dir__)
+$LOAD_PATH.unshift(repo_lib) if File.directory?(repo_lib) && !$LOAD_PATH.include?(repo_lib)
+
+require "kettle/dev/executable_version"
+
+script_basename = File.basename(__FILE__)
+Kettle::Dev::ExecutableVersion.print_and_exit!(script_basename, ARGV)
+Kettle::Dev::ExecutableVersion.print_header(script_basename)
+
 warn <<~MSG
   kettle-dev-setup has been removed.
   Setup and templating functionality has moved to the kettle-jem gem.

data/exe/kettle-dvcs

@@ -20,10 +20,14 @@ rescue LoadError
 end
 
 script_basename = File.basename(__FILE__)
+repo_lib = File.expand_path("../lib", __dir__)
+$LOAD_PATH.unshift(repo_lib) if File.directory?(repo_lib) && !$LOAD_PATH.include?(repo_lib)
 
 begin
   require "kettle/dev"
-  puts "== #{script_basename} v#{Kettle::Dev::Version::VERSION} =="
+  require "kettle/dev/executable_version"
+  Kettle::Dev::ExecutableVersion.print_and_exit!(script_basename, ARGV)
+  Kettle::Dev::ExecutableVersion.print_header(script_basename)
 rescue LoadError => e
   warn("#{script_basename}: could not load dependency: #{e.class}: #{e.message}")
   warn("Hint: Ensure the host project has kettle-dev as a dependency and run bundle install.")

data/exe/kettle-gh-release

@@ -21,10 +21,14 @@ rescue LoadError
 end
 
 script_basename = File.basename(__FILE__)
+repo_lib = File.expand_path("../lib", __dir__)
+$LOAD_PATH.unshift(repo_lib) if File.directory?(repo_lib) && !$LOAD_PATH.include?(repo_lib)
 
 begin
   require "kettle/dev"
-  puts "== #{script_basename} v#{Kettle::Dev::Version::VERSION} =="
+  require "kettle/dev/executable_version"
+  Kettle::Dev::ExecutableVersion.print_and_exit!(script_basename, ARGV)
+  Kettle::Dev::ExecutableVersion.print_header(script_basename)
 rescue LoadError => e
   warn("#{script_basename}: could not load dependency: #{e.class}: #{e.message}")
   warn("Hint: Ensure the host project has kettle-dev as a dependency and run bundle install.")

data/exe/kettle-gha-sha-pins

@@ -3,9 +3,18 @@
 
 # vim: set syntax=ruby
 
+$stdout.sync = true
+$stderr.sync = true
+
 script_basename = File.basename(__FILE__)
+repo_lib = File.expand_path("../lib", __dir__)
+$LOAD_PATH.unshift(repo_lib) if File.directory?(repo_lib) && !$LOAD_PATH.include?(repo_lib)
 
 begin
+  require "kettle/dev/executable_version"
+  Kettle::Dev::ExecutableVersion.print_and_exit!(script_basename, ARGV)
+  Kettle::Dev::ExecutableVersion.print_header(script_basename)
+
   Kernel.exec(Gem.ruby, Gem.bin_path("kettle-gha-pins", "kettle-gha-pins"), *ARGV)
 rescue Gem::Exception, LoadError => e
   warn("#{script_basename}: could not load kettle-gha-pins executable: #{e.class}: #{e.message}")

data/exe/kettle-pre-release

@@ -23,10 +23,14 @@ rescue LoadError
 end
 
 script_basename = File.basename(__FILE__)
+repo_lib = File.expand_path("../lib", __dir__)
+$LOAD_PATH.unshift(repo_lib) if File.directory?(repo_lib) && !$LOAD_PATH.include?(repo_lib)
 
 begin
   require "kettle/dev"
-  puts "== #{script_basename} v#{Kettle::Dev::Version::VERSION} =="
+  require "kettle/dev/executable_version"
+  Kettle::Dev::ExecutableVersion.print_and_exit!(script_basename, ARGV)
+  Kettle::Dev::ExecutableVersion.print_header(script_basename)
 rescue => e
   warn("#{script_basename}: could not load dependency: #{e.class}: #{e.message}")
   warn("Hint: Ensure the host project has kettle-dev as a dependency and run bundle install.")

data/exe/kettle-readme-backers

@@ -14,10 +14,14 @@ rescue LoadError
 end
 
 script_basename = File.basename(__FILE__)
+repo_lib = File.expand_path("../lib", __dir__)
+$LOAD_PATH.unshift(repo_lib) if File.directory?(repo_lib) && !$LOAD_PATH.include?(repo_lib)
 
 begin
   require "kettle/dev"
-  puts "== #{script_basename} v#{Kettle::Dev::Version::VERSION} =="
+  require "kettle/dev/executable_version"
+  Kettle::Dev::ExecutableVersion.print_and_exit!(script_basename, ARGV)
+  Kettle::Dev::ExecutableVersion.print_header(script_basename)
 rescue LoadError => e
   warn("kettle/dev: failed to load: #{e.message}")
   warn("Hint: Ensure the host project has kettle-dev as a dependency and run bundle install.")

data/exe/kettle-release

@@ -29,10 +29,14 @@ rescue LoadError
 end
 
 script_basename = File.basename(__FILE__)
+repo_lib = File.expand_path("../lib", __dir__)
+$LOAD_PATH.unshift(repo_lib) if File.directory?(repo_lib) && !$LOAD_PATH.include?(repo_lib)
 
 begin
   require "kettle/dev"
-  puts "== #{script_basename} v#{Kettle::Dev::Version::VERSION} =="
+  require "kettle/dev/executable_version"
+  Kettle::Dev::ExecutableVersion.print_and_exit!(script_basename, ARGV, value_option: true)
+  Kettle::Dev::ExecutableVersion.print_header(script_basename)
 rescue LoadError => e
   warn("#{script_basename}: could not load dependency: #{e.class}: #{e.message}")
   warn("Hint: Ensure the host project has kettle-dev as a dependency and run bundle install.")

data/lib/kettle/dev/cache_progress.rb

@@ -1,47 +1,60 @@
 # frozen_string_literal: true
 
-require "ruby-progressbar"
+require "tty-progressbar"
 
 module Kettle
   module Dev
     class CacheProgress
-      FORMAT = "%t %b %c/%C"
-      LENGTH = 30
+      FORMAT = "%<title>s [:bar] :current/:total"
+      WIDTH = 30
 
       def initialize(total:, cached_title:, live_title:, output:, enabled: true, skipped_title: nil)
         @total = total.to_i
         @cached_count = 0
         @live_count = 0
         @skipped_count = 0
-        @cached_bar = progress_bar(cached_title, output, enabled)
-        @live_bar = progress_bar(live_title, output, enabled)
-        @skipped_bar = skipped_title ? progress_bar(skipped_title, output, enabled) : nil
+        @multibar = progress_enabled?(enabled, output) ? TTY::ProgressBar::Multi.new(output: output, width: WIDTH) : nil
+        @cached_bar = progress_bar(cached_title)
+        @live_bar = progress_bar(live_title)
+        @skipped_bar = skipped_title ? progress_bar(skipped_title) : nil
       end
 
       attr_reader :cached_count, :live_count, :skipped_count
 
       def cached
         @cached_count += 1
-        @cached_bar&.increment
+        @cached_bar&.advance
       end
 
       def live
         @live_count += 1
-        @live_bar&.increment
+        @live_bar&.advance
       end
 
       def skipped
         @skipped_count += 1
-        @skipped_bar&.increment
+        @skipped_bar&.advance
+      end
+
+      def stop
+        @multibar&.stop
       end
 
       private
 
-      def progress_bar(title, output, enabled)
-        return unless enabled
+      def progress_enabled?(enabled, output)
+        enabled && @total.positive? && output.respond_to?(:tty?) && output.tty?
+      end
+
+      def progress_bar(title)
+        return unless @multibar
         return unless @total.positive?
 
-        ProgressBar.create(title: title, total: @total, format: FORMAT, length: LENGTH, output: output)
+        @multibar.register(bar_format(title), total: @total)
+      end
+
+      def bar_format(title)
+        Kernel.format(FORMAT, title: title)
       end
     end
   end

data/lib/kettle/dev/ci_helpers.rb

@@ -97,19 +97,17 @@ module Kettle
 
         # Scope to the exact commit SHA when available to avoid picking up a previous run on the same branch.
         sha = head_sha || current_head_sha
-        base_url = "https://api.github.com/repos/#{owner}/#{repo}/actions/workflows/#{workflow_file}/runs?branch=#{URI.encode_www_form_component(b)}&per_page=5"
-        uri = URI(base_url)
-        req = Net::HTTP::Get.new(uri)
-        req["User-Agent"] = "kettle-dev/ci-helpers"
-        req["Authorization"] = "token #{token}" if token && !token.empty?
-        res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(req) }
-        return unless res.is_a?(Net::HTTPSuccess)
+        data = github_get_json(
+          "https://api.github.com/repos/#{owner}/#{repo}/actions/workflows/#{workflow_file}/runs?branch=#{URI.encode_www_form_component(b)}&per_page=5",
+          token: token
+        )
+        return unless data
 
-        data = JSON.parse(res.body)
         runs = Array(data["workflow_runs"]) || []
         # Try to match by head_sha first; fall back to first run (branch-scoped) if none matches yet.
         run = if sha
           match = runs.find { |r| r["head_sha"] == sha }
+          match ||= latest_repository_workflow_run(owner: owner, repo: repo, workflow_file: workflow_file, branch: b, head_sha: sha, token: token)
           require_head ? match : (match || runs.first)
         else
           runs.first unless require_head
@@ -128,6 +126,30 @@ module Kettle
         nil
       end
 
+      def latest_repository_workflow_run(owner:, repo:, workflow_file:, branch:, head_sha:, token:)
+        data = github_get_json(
+          "https://api.github.com/repos/#{owner}/#{repo}/actions/runs?branch=#{URI.encode_www_form_component(branch)}&per_page=100",
+          token: token
+        )
+        return unless data
+
+        workflow_path = ".github/workflows/#{workflow_file}"
+        Array(data["workflow_runs"]).find do |run|
+          run["head_sha"] == head_sha && run["path"] == workflow_path
+        end
+      end
+
+      def github_get_json(url, token:)
+        uri = URI(url)
+        req = Net::HTTP::Get.new(uri)
+        req["User-Agent"] = "kettle-dev/ci-helpers"
+        req["Authorization"] = "token #{token}" if token && !token.empty?
+        res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(req) }
+        return unless res.is_a?(Net::HTTPSuccess)
+
+        JSON.parse(res.body)
+      end
+
       # Whether a run has completed successfully.
       # @param run [Hash, nil]
       # @return [Boolean]

data/lib/kettle/dev/ci_monitor.rb

@@ -352,7 +352,7 @@ module Kettle
         rescue
           nil
         end
-        (seconds && seconds >= 0) ? seconds : 120
+        (seconds && seconds >= 0) ? seconds : 300
       end
       module_function :github_start_timeout
 

data/lib/kettle/dev/executable_version.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+require_relative "version"
+
+module Kettle
+  module Dev
+    module ExecutableVersion
+      module_function
+
+      def print_and_exit!(script_basename, argv, value_option: false)
+        return unless requested?(argv, value_option: value_option)
+
+        puts "#{script_basename} #{Kettle::Dev::Version::VERSION}"
+        exit(0)
+      end
+
+      def print_header(script_basename)
+        puts header(script_basename)
+      end
+
+      def header(script_basename)
+        "== #{script_basename} v#{Kettle::Dev::Version::VERSION} =="
+      end
+
+      def requested?(argv, value_option: false)
+        argv.each_with_index.any? do |arg, index|
+          arg == "-v" || bare_long_version?(argv, arg, index, value_option: value_option)
+        end
+      end
+
+      def bare_long_version?(argv, arg, index, value_option:)
+        return false unless arg == "--version"
+        return true unless value_option
+
+        index == argv.length - 1 || argv[index + 1].to_s.start_with?("-")
+      end
+    end
+  end
+end

data/lib/kettle/dev/pre_release_cli.rb

@@ -375,25 +375,29 @@ module Kettle
           output: $stdout
         )
         failures = []
-        urls.each do |url|
-          if image_url_skipped?(url)
-            skipped << url
-            progress.skipped
-            next
-          end
+        begin
+          urls.each do |url|
+            if image_url_skipped?(url)
+              skipped << url
+              progress.skipped
+              next
+            end
 
-          if cache && !@refresh_image_url_cache && cache.fresh_success?(url)
-            progress.cached
-            next
-          end
+            if cache && !@refresh_image_url_cache && cache.fresh_success?(url)
+              progress.cached
+              next
+            end
 
-          ok = HTTP.head_ok?(url)
-          progress.live
-          if ok
-            cache&.write_success(url)
-          else
-            failures << url
+            ok = HTTP.head_ok?(url)
+            progress.live
+            if ok
+              cache&.write_success(url)
+            else
+              failures << url
+            end
           end
+        ensure
+          progress.stop
         end
         puts "[kettle-pre-release] Image URL checks: #{progress.cached_count} cached, #{progress.live_count} live."
         puts "[kettle-pre-release] Skipped #{progress.skipped_count} image URL check(s)." if skipped.any?

data/lib/kettle/dev/version.rb

@@ -3,7 +3,7 @@
 module Kettle
   module Dev
     module Version
-      VERSION = "2.3.10"
+      VERSION = "2.4.0"
     end
     VERSION = Version::VERSION # Traditional Constant Location
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: kettle-dev
 version: !ruby/object:Gem::Version
-  version: 2.3.10
+  version: 2.4.0
 platform: ruby
 authors:
 - Peter H. Boling
@@ -57,20 +57,20 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.2'
+        version: '0.3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.2.1
+        version: 0.3.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.2'
+        version: '0.3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.2.1
+        version: 0.3.1
 - !ruby/object:Gem::Dependency
   name: kettle-rb
   requirement: !ruby/object:Gem::Requirement
@@ -125,6 +125,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.13'
+- !ruby/object:Gem::Dependency
+  name: tty-progressbar
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.18'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.18'
 - !ruby/object:Gem::Dependency
   name: bundler-audit
   requirement: !ruby/object:Gem::Requirement
@@ -301,6 +315,7 @@ files:
 - lib/kettle/dev/ci_monitor.rb
 - lib/kettle/dev/commit_msg.rb
 - lib/kettle/dev/dvcs_cli.rb
+- lib/kettle/dev/executable_version.rb
 - lib/kettle/dev/exit_adapter.rb
 - lib/kettle/dev/gem_coop_versions.rb
 - lib/kettle/dev/gem_spec_reader.rb
@@ -334,10 +349,10 @@ licenses:
 - AGPL-3.0-only
 metadata:
   homepage_uri: https://kettle-dev.galtzo.com
-  source_code_uri: https://github.com/kettle-dev/kettle-dev/tree/v2.3.10
-  changelog_uri: https://github.com/kettle-dev/kettle-dev/blob/v2.3.10/CHANGELOG.md
+  source_code_uri: https://github.com/kettle-dev/kettle-dev/tree/v2.4.0
+  changelog_uri: https://github.com/kettle-dev/kettle-dev/blob/v2.4.0/CHANGELOG.md
   bug_tracker_uri: https://github.com/kettle-dev/kettle-dev/issues
-  documentation_uri: https://www.rubydoc.info/gems/kettle-dev/2.3.10
+  documentation_uri: https://www.rubydoc.info/gems/kettle-dev/2.4.0
   funding_uri: https://github.com/sponsors/pboling
   wiki_uri: https://github.com/kettle-dev/kettle-dev/wiki
   news_uri: https://www.railsbling.com/tags/kettle-dev