kettle-dev 2.5.19 → 2.5.20

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a8ffb38694a14518e416b497413025d417137ce7b7cf8673dd31f68aa46c8539
-  data.tar.gz: 71d1ff523dc11ba20f72994792ad3edd4ff43a0ceea2c8c84e46e65b77e72977
+  metadata.gz: 7f642698f24dc241a8f3286ff20b151dcdb30333c436290681740ffe24fb6148
+  data.tar.gz: 578361645c3b639cca69d6c120a7990b38afcbb55bc6c5c55df95e4ba998e292
 SHA512:
-  metadata.gz: a7cf27e978644578be5e2839670c4981343b9d84646d59ece70e4d83eb388404dcd52b77c3f90929164ff86f698bc6bfc93ecfa42f8bfc9a2ec342d764030aa3
-  data.tar.gz: 59de547a4f7a50905bed8bc66c8b919eca375ff9d4d31bd079371dfee717d540bf800477bae8dad644a2efe7935d7cb44b53e059cb4554a99c54d5655d372dc2
+  metadata.gz: bfd379df162aa902b96ba7f5fefc28170aee8f1995230d24268baccd8603dfa4a596cf4f29acf2a0230c8d1e755ec8a91ddc193cd4139a18e9bfc69143bd59e7
+  data.tar.gz: 62bd06604b31ea2d042e87ebb67ab9815d251c29e4606ea61cdcd5aad983868229e932dfad3bce5ea304e5a54523816723d1da3ce8a618f6e7eca88714f0aea0

data/CHANGELOG.md

@@ -30,6 +30,19 @@ Please file a bug if you notice a violation of semantic versioning.
 
 ### Security
 
+## [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 +3272,9 @@ 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.20...HEAD
+[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.929-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/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.20"
     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.20
 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.20
+  changelog_uri: https://github.com/kettle-dev/kettle-dev/blob/v2.5.20/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.20
   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