kettle-dev 2.5.19 → 2.5.21

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a8ffb38694a14518e416b497413025d417137ce7b7cf8673dd31f68aa46c8539
-  data.tar.gz: 71d1ff523dc11ba20f72994792ad3edd4ff43a0ceea2c8c84e46e65b77e72977
+  metadata.gz: 75484cde250c1d87c9c5b85180972c7eb9596874b2d04ec1901d0bf9b60313cc
+  data.tar.gz: f71c7e5bfcf8411b2545d3a6d0875c323a8f90f6374d8a21a839ecafa6389b5b
 SHA512:
-  metadata.gz: a7cf27e978644578be5e2839670c4981343b9d84646d59ece70e4d83eb388404dcd52b77c3f90929164ff86f698bc6bfc93ecfa42f8bfc9a2ec342d764030aa3
-  data.tar.gz: 59de547a4f7a50905bed8bc66c8b919eca375ff9d4d31bd079371dfee717d540bf800477bae8dad644a2efe7935d7cb44b53e059cb4554a99c54d5655d372dc2
+  metadata.gz: 7418829b37e194a8a248e9ea7a2a4e2e48040d55d0008b0e0f86e939815576b3c6715b364f4f2c686031c644c41a80306e24f46cbc9ced3771ab0de2e60e8f48
+  data.tar.gz: f6910b5d7315bd82a8cfea7cc07aa581b6cf654b994ad6463d07952bfec95cb427e2ba225fd3fce009ad6083ed7cc133c875c056a5872c15a4664ce0701a1b4e

data/CHANGELOG.md

@@ -30,6 +30,32 @@ Please file a bug if you notice a violation of semantic versioning.
 
 ### Security
 
+## [2.5.21] - 2026-08-07
+
+- TAG: [v2.5.21][2.5.21t]
+- COVERAGE: 91.99% -- 5469/5945 lines in 47 files
+- BRANCH COVERAGE: 76.14% -- 2058/2703 branches in 47 files
+- 50.77% documented
+
+### Fixed
+
+- Release coverage now honors a project that disables hard coverage thresholds.
+
+- Release-state version lookups now refresh when the cached RubyGems data predates the requested version.
+
+## [2.5.20] - 2026-08-07
+
+- TAG: [v2.5.20][2.5.20t]
+- COVERAGE: 91.75% -- 5440/5929 lines in 47 files
+- BRANCH COVERAGE: 76.14% -- 2049/2691 branches in 47 files
+- 50.77% documented
+
+### Fixed
+
+- Prefer non-cancelled exact-commit GitHub Actions runs when workflow concurrency creates duplicate runs.
+
+- Skip YARD lint when a project has no .yard-lint.yml policy.
+
 ## [2.5.19] - 2026-08-06
 
 - TAG: [v2.5.19][2.5.19t]
@@ -3259,7 +3285,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.5.19...HEAD
+[Unreleased]: https://github.com/kettle-dev/kettle-dev/compare/v2.5.21...HEAD
+[2.5.21]: https://github.com/kettle-dev/kettle-dev/compare/v2.5.20...v2.5.21
+[2.5.21t]: https://github.com/kettle-dev/kettle-dev/releases/tag/v2.5.21
+[2.5.20]: https://github.com/kettle-dev/kettle-dev/compare/v2.5.19...v2.5.20
+[2.5.20t]: https://github.com/kettle-dev/kettle-dev/releases/tag/v2.5.20
 [2.5.19]: https://github.com/kettle-dev/kettle-dev/compare/v2.5.18...v2.5.19
 [2.5.19t]: https://github.com/kettle-dev/kettle-dev/releases/tag/v2.5.19
 [2.5.18]: https://github.com/kettle-dev/kettle-dev/compare/v2.5.17...v2.5.18

data/README.md

@@ -1007,7 +1007,7 @@ 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-5.946-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
+[🧮kloc-img]: https://img.shields.io/badge/KLOC-5.945-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

data/lib/kettle/dev/ci_helpers.rb

@@ -104,9 +104,10 @@ module Kettle
         return unless data
 
         runs = Array(data["workflow_runs"]) || []
-        # Try to match by head_sha first; fall back to first run (branch-scoped) if none matches yet.
+        # Try to match by head_sha first; GitHub may return a cancelled duplicate
+        # before the replacement run created by workflow concurrency.
         run = if sha
-          match = runs.find { |r| r["head_sha"] == sha }
+          match = preferred_head_run(runs.select { |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
@@ -134,9 +135,18 @@ module Kettle
         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
+        preferred_head_run(
+          Array(data["workflow_runs"]).select do |run|
+            run["head_sha"] == head_sha && run["path"] == workflow_path
+          end
+        )
+      end
+
+      # Concurrency cancellation can leave an older run for the exact same
+      # commit ahead of its replacement in GitHub's API response. Prefer the
+      # replacement so a cancelled duplicate cannot mask a valid run.
+      def preferred_head_run(runs)
+        runs.find { |run| run["conclusion"] != "cancelled" } || runs.first
       end
 
       def github_get_json(url, token:)

data/lib/kettle/dev/rakelib/appraisal.rake

@@ -219,5 +219,7 @@ begin
     end
   end
 rescue LoadError
+  # simplecov:disable -- Appraisal is an optional development dependency.
   warn("[kettle-dev][appraisal.rake] failed to load appraisal/tasks") if Kettle::Dev::DEBUGGING
+  # simplecov:enable
 end

data/lib/kettle/dev/rakelib/bundle_audit.rake

@@ -27,10 +27,12 @@ else
     Kettle::Dev.register_default("bundle:audit:update")
     Kettle::Dev.register_default("bundle:audit")
   rescue LoadError
+    # simplecov:disable -- bundler-audit is an optional development dependency.
     warn("[kettle-dev][bundle_audit.rake] failed to load bundle/audit/task") if Kettle::Dev::DEBUGGING
     define_bundle_audit_stub_tasks.call(
       "(stub)",
       ->(_task_name) { "NOTE: bundler-audit isn't installed, or is disabled for #{RUBY_VERSION} in the current environment" }
     )
+    # simplecov:enable
   end
 end

data/lib/kettle/dev/rakelib/reek.rake

@@ -31,9 +31,11 @@ begin
   end
   Kettle::Dev.register_default("reek:update") unless Kettle::Dev::IS_CI
 rescue LoadError
+  # simplecov:disable -- Reek is an optional development dependency.
   warn("[kettle-dev][reek.rake] failed to load reek/rake/task") if Kettle::Dev::DEBUGGING
   desc("(stub) reek is unavailable")
   task(:reek) do
     warn("NOTE: reek isn't installed, or is disabled for #{RUBY_VERSION} in the current environment")
   end
+  # simplecov:enable
 end

data/lib/kettle/dev/rakelib/require_bench.rake

@@ -3,5 +3,7 @@
 begin
   require "require_bench/tasks" if Kettle::Dev::REQUIRE_BENCH
 rescue LoadError
+  # simplecov:disable -- require_bench is an opt-in development dependency.
   warn("[kettle-dev][require_bench.rake] failed to load require_bench/tasks") if Kettle::Dev::DEBUGGING
+  # simplecov:enable
 end

data/lib/kettle/dev/rakelib/rubocop_gradual.rake

@@ -7,5 +7,7 @@ begin
     t.options = ["--debug"]
   end
 rescue LoadError
+  # simplecov:disable -- RuboCop Gradual is an optional development dependency.
   warn("[kettle-dev][rubocop_gradual.rake] failed to load rubocop/gradual/rake_task") if Kettle::Dev::DEBUGGING
+  # simplecov:enable
 end

data/lib/kettle/dev/rakelib/spec_test.rake

@@ -24,6 +24,7 @@ begin
     Kettle::Dev.register_default("test") unless Kettle::Dev.default_registered?("coverage")
   end
 rescue LoadError
+  # simplecov:disable -- Rake's optional test task integration varies by runtime.
   warn("[kettle-dev][spec_test.rake] failed to load rake/testtask") if Kettle::Dev::DEBUGGING
   unless Rake::Task.task_defined?(:test)
     desc("test task stub")
@@ -31,6 +32,7 @@ rescue LoadError
       warn("NOTE: minitest isn't installed, or is disabled for #{RUBY_VERSION} in the current environment")
     end
   end
+  # simplecov:enable
 end
 
 setup_spec_task = ->(default:) {

data/lib/kettle/dev/rakelib/yard.rake

@@ -14,20 +14,26 @@ begin
   begin
     require "yard/fence"
     Yard::Fence.install_rake_tasks!(:yard)
+    # simplecov:disable -- optional plugin availability is environment-specific.
   rescue LoadError
     # yard-fence not available - that's fine
+    # simplecov:enable
   end
 
   begin
     require "yard/timekeeper"
     Yard::Timekeeper.install_rake_tasks!(:yard)
+    # simplecov:disable -- optional plugin availability is environment-specific.
   rescue LoadError
     # yard-timekeeper not available - that's fine
+    # simplecov:enable
   end
 
   namespace :yard do
     desc "Lint YARD Documentation"
     task :lint do
+      next unless File.file?(".yard-lint.yml")
+
       # Keep warning-only lint runs compact in default/release flows, but rerun
       # with full output when lint fails so the blocking diagnostics are visible.
       sh("bundle", "exec", "yard-lint", "lib") unless system("bundle", "exec", "yard-lint", "--quiet", "lib")
@@ -39,10 +45,12 @@ begin
   Kettle::Dev.register_default("yard:lint")
   Kettle::Dev.register_default("yard")
 rescue LoadError
+  # simplecov:disable -- YARD is an optional development dependency.
   warn("[kettle-dev][yard.rake] failed to load yard") if Kettle::Dev::DEBUGGING
   desc("(stub) yard is unavailable")
   task(:yard) do # rubocop:disable Rake/DuplicateTask -- fallback when the real YARD task cannot load
     warn("NOTE: yard isn't installed, or is disabled for #{RUBY_VERSION} in the current environment")
   end
   Kettle::Dev.register_default("yard")
+  # simplecov:enable
 end

data/lib/kettle/dev/release_cli.rb

@@ -794,10 +794,25 @@ module Kettle
         cmd = "#{cmd} --version #{Shellwords.escape(@version_override)}" if @version_override
         cmd = "#{cmd} --yes" if @yes
         cmd = "#{cmd} --events=changelog" if @event_stream
-        run_cmd!(cmd)
+        with_project_changelog_coverage_policy { run_cmd!(cmd) }
         @changelog_generated_coverage = true
       end
 
+      # Monorepo subprojects commonly disable their local hard coverage gate
+      # because their narrow test suite cannot satisfy the aggregate root
+      # thresholds. Preserve an explicit changelog policy, otherwise derive
+      # the changelog coverage policy from the project's coverage setting.
+      def with_project_changelog_coverage_policy
+        original = ENV["K_CHANGELOG_COVERAGE_HARD"]
+        changed = original.nil? && ENV["K_SOUP_COV_MIN_HARD"].to_s.casecmp?("false")
+        return yield unless changed
+
+        ENV["K_CHANGELOG_COVERAGE_HARD"] = "false"
+        yield
+      ensure
+        ENV["K_CHANGELOG_COVERAGE_HARD"] = original if changed
+      end
+
       def release_default_task_command
         # `kettle-changelog` generates strict coverage by running `bundle exec kettle-test`.
         # When that happened during this same release invocation, the default task can skip

data/lib/kettle/dev/ruby_gems_versions.rb

@@ -23,7 +23,7 @@ module Kettle
         def fetch(gem_name, version_hint: nil, refresh: false)
           name = gem_name.to_s
           cached = cached_versions(name)
-          cache_bust = refresh || env_refresh? || fresh_release_marker?(name, version_hint)
+          cache_bust = refresh || env_refresh? || fresh_release_marker?(name, version_hint) || cached_behind_version?(cached, version_hint)
           return cached if cached && !cache_bust
 
           uri = versions_uri(gem_name, cache_bust: cache_bust)
@@ -104,6 +104,22 @@ module Kettle
           false
         end
 
+        def cached_behind_version?(cached, version_hint)
+          return false unless cached && version_hint
+
+          cached_versions = cached.each_with_object([]) do |entry, versions|
+            value = entry["number"] if entry.is_a?(Hash)
+            next if value.to_s.empty? || value.to_s =~ /[a-zA-Z]/
+
+            versions << Gem::Version.new(value)
+          end
+          return false if cached_versions.empty?
+
+          cached_versions.max < Gem::Version.new(version_hint)
+        rescue ArgumentError
+          false
+        end
+
         def read_marker(path)
           return {} unless File.file?(path)
 

data/lib/kettle/dev/version.rb

@@ -5,7 +5,7 @@ module Kettle
     # Version namespace for this gem.
     module Version
       # Current gem version.
-      VERSION = "2.5.19"
+      VERSION = "2.5.21"
     end
     # Current gem version exposed at the traditional constant location.
     VERSION = Version::VERSION # Traditional Constant Location

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: kettle-dev
 version: !ruby/object:Gem::Version
-  version: 2.5.19
+  version: 2.5.21
 platform: ruby
 authors:
 - Peter H. Boling
@@ -402,10 +402,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.5.19
-  changelog_uri: https://github.com/kettle-dev/kettle-dev/blob/v2.5.19/CHANGELOG.md
+  source_code_uri: https://github.com/kettle-dev/kettle-dev/tree/v2.5.21
+  changelog_uri: https://github.com/kettle-dev/kettle-dev/blob/v2.5.21/CHANGELOG.md
   bug_tracker_uri: https://github.com/kettle-dev/kettle-dev/issues
-  documentation_uri: https://www.rubydoc.info/gems/kettle-dev/2.5.19
+  documentation_uri: https://www.rubydoc.info/gems/kettle-dev/2.5.21
   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