kettle-dev 2.2.4 → 2.2.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e1c6a0d6e39d7d8fe607a9b19f147ef63a32a24bae13abfe0fe29e1d63d5850b
-  data.tar.gz: 6fbe922eb16885678ce44cbb55c6caef1c71cc3053a6e7d7624fa0b6c3ecd72a
+  metadata.gz: b8c22a00d9dde1e8574e1b8018fcf356b683c5a0c558b304bfac6d4b307d2de1
+  data.tar.gz: 69b132d5faa7e4d07f52344491295fb349e1453b2aa43b2de2ae25fbff21a9a2
 SHA512:
-  metadata.gz: 31f868d8ea6bf2b83cc8aab8b56f52726dd96cea08ddf49d38aacab0ac6e7712e69a7d3f9944946ed575a9246c3e0c4b00756ed512dd5d124a0abfdff342f4de
-  data.tar.gz: a7a5d8b99c80b173e97f014029f1972ee74190d7fa4ae97a8bc468606e80d0e87625838312b62fa8a69f2d16ff373c11bb4bc10e73a5cf0872da3287bba69ad7
+  metadata.gz: 0f0c9b87d7bc0cf30712c3e6cbbedabd66d6af631ed39586fe7853f78970b3b8ea80e18c78130394c323f3d09d61cf7b5c39d9c1927ed71fe9fb30a3e1c7453d
+  data.tar.gz: 7eb506783c68f81ac54ae37b54d4b415d996f1a2f50ce112c2733cd0726ca55088b3875c281743aa8eed389243d4049ca01f07f2a0211cc99b4f462ff17a4c5e

data/CHANGELOG.md

@@ -30,6 +30,39 @@ Please file a bug if you notice a violation of semantic versioning.
 
 ### Security
 
+## [2.2.6] - 2026-06-13
+
+- TAG: [v2.2.6][2.2.6t]
+- COVERAGE: 92.27% -- 3833/4154 lines in 28 files
+- BRANCH COVERAGE: 73.51% -- 1518/2065 branches in 28 files
+- 66.67% documented
+
+### Added
+
+#### Changelog
+
+- Added `kettle-changelog --pending-release`, a non-mutating query that exits
+  successfully when `CHANGELOG.md` has unreleased entries or its most recent
+  release section has not been published yet.
+
+## [2.2.5] - 2026-06-13
+
+- TAG: [v2.2.5][2.2.5t]
+- COVERAGE: 92.29% -- 3818/4137 lines in 28 files
+- BRANCH COVERAGE: 73.49% -- 1516/2063 branches in 28 files
+- 67.00% documented
+
+### Changed
+
+- `kettle-gha-sha-pins --upgrade major` now supports major-line action tags
+  such as `v2`, while patch and minor upgrade targeting remain limited to full
+  `x.y.z` SemVer tags.
+
+### Fixed
+
+- `kettle-gha-sha-pins` persistent cache writes no longer crash for actions
+  whose releases and tags only include major-line versions such as `v2`.
+
 ## [2.2.4] - 2026-06-12
 
 - TAG: [v2.2.4][2.2.4t]
@@ -2042,7 +2075,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.2.4...HEAD
+[Unreleased]: https://github.com/kettle-dev/kettle-dev/compare/v2.2.6...HEAD
+[2.2.6]: https://github.com/kettle-dev/kettle-dev/compare/v2.2.5...v2.2.6
+[2.2.6t]: https://github.com/kettle-dev/kettle-dev/releases/tag/v2.2.6
+[2.2.5]: https://github.com/kettle-dev/kettle-dev/compare/v2.2.4...v2.2.5
+[2.2.5t]: https://github.com/kettle-dev/kettle-dev/releases/tag/v2.2.5
 [2.2.4]: https://github.com/kettle-dev/kettle-dev/compare/v2.2.3...v2.2.4
 [2.2.4t]: https://github.com/kettle-dev/kettle-dev/releases/tag/v2.2.4
 [2.2.3]: https://github.com/kettle-dev/kettle-dev/compare/v2.2.2...v2.2.3

data/README.md

@@ -854,7 +854,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-4.129-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
+[🧮kloc-img]: https://img.shields.io/badge/KLOC-4.154-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
@@ -882,7 +882,7 @@ Thanks for RTFM. ☺️
 | Package | kettle-dev |
 | Description | 🍲 Kettle::Dev is a meta tool from kettle-rb to streamline development and testing. Acts as a shim dependency, pulling in many other dependencies, to give you OOTB productivity with a RubyGem, or Ruby app project. Configures a complete set of Rake tasks, for all the libraries is brings in, so they arrive ready to go. Fund overlooked open source projects - bottom of stack, dev/test dependencies: floss-funding.dev |
 | Homepage | https://github.com/kettle-dev/kettle-dev |
-| Source | https://github.com/kettle-dev/kettle-dev/tree/v2.2.3 |
+| Source | https://github.com/kettle-dev/kettle-dev/tree/v2.2.4 |
 | License | `AGPL-3.0-only` |
 | Funding | https://github.com/sponsors/pboling, https://issuehunt.io/u/pboling, https://ko-fi.com/pboling, https://liberapay.com/pboling/donate, https://opencollective.com/kettle-dev, https://opencollective.com/kettle-rb, https://patreon.com/galtzo, https://polar.sh/pboling, https://thanks.dev/u/gh/pboling, https://tidelift.com/funding/github/rubygems/kettle-dev, https://www.buymeacoffee.com/pboling |
 <!-- kettle-jem:metadata:end -->

data/exe/kettle-changelog

@@ -51,7 +51,7 @@ end
 begin
   if ARGV.include?("-h") || ARGV.include?("--help")
     puts <<~USAGE
-      Usage: kettle-changelog [--update-prep] [--no-strict] [--no-coverage-threshold]
+      Usage: kettle-changelog [--update-prep] [--pending-release] [--no-strict] [--no-coverage-threshold]
 
       Detects the current version from lib/**/version.rb, the latest live release, and
       the most recent CHANGELOG.md release section, then prompts to confirm the selected plan:
@@ -62,6 +62,7 @@ begin
 
       Options:
         --update-prep             Force updating the most recent prepared release section in place
+        --pending-release         Query whether the changelog has release work pending; exits 0 for yes, 1 for no
         --no-strict               Allow missing coverage and yard data (warnings only, no errors)
         --no-coverage-threshold   Generate coverage without hard-failing below configured thresholds
 
@@ -89,11 +90,19 @@ end
 begin
   # Determine if strict mode is enabled (default: true)
   strict_mode = !ARGV.include?("--no-strict") && ENV.fetch("K_CHANGELOG_STRICT", "true").downcase != "false"
-  update_prep = ARGV.include?("--update-prep")
+  update_prep = ARGV.delete("--update-prep")
+  pending_release_query = ARGV.delete("--pending-release")
   coverage_threshold_disabled = ARGV.include?("--no-coverage-threshold") || ARGV.include?("--no-coverage-thresholds")
   coverage_hard = !coverage_threshold_disabled && ENV.fetch("K_CHANGELOG_COVERAGE_HARD", "true").downcase != "false"
 
-  Kettle::Dev::ChangelogCLI.new(strict: strict_mode, enforce_coverage_thresholds: coverage_hard, update_prep: update_prep).run
+  cli = Kettle::Dev::ChangelogCLI.new(strict: strict_mode, enforce_coverage_thresholds: coverage_hard, update_prep: update_prep)
+  if pending_release_query
+    status = cli.pending_release_status
+    puts status.fetch(:pending) ? "true" : "false"
+    exit(status.fetch(:pending) ? 0 : 1)
+  end
+
+  cli.run
 rescue LoadError => e
   warn("#{script_basename}: could not load dependency: #{e.class}: #{e.message}")
   warn(e.backtrace.join("\n")) if ENV["DEBUG"]

data/lib/kettle/dev/changelog_cli.rb

@@ -135,6 +135,41 @@ module Kettle
         puts "CHANGELOG.md updated with v#{version} section."
       end
 
+      def pending_release_status
+        changelog = File.read(@changelog_path)
+        unreleased_block, _before, after = extract_unreleased(changelog)
+        unreleased_entries = unreleased_block_has_entries?(unreleased_block)
+        latest_changelog_version = detect_previous_version(after.to_s)
+        gem_name = nil
+        latest_overall = nil
+        latest_for_series = nil
+        latest_target = nil
+
+        if latest_changelog_version && !unreleased_entries
+          begin
+            gem_name = detect_gem_name
+            latest_overall, latest_for_series = latest_released_versions(gem_name, latest_changelog_version)
+            latest_target = latest_release_target(latest_changelog_version, latest_overall, latest_for_series)
+          rescue => e
+            warn("[kettle-changelog] gem.coop release check failed: #{e.class}: #{e.message}")
+            warn("Treating the most recent CHANGELOG.md release section as pending because live release info is unavailable.")
+          end
+        end
+
+        prepared_release_pending = !unreleased_entries && !!latest_changelog_version && latest_target != latest_changelog_version
+
+        {
+          pending: unreleased_entries || prepared_release_pending,
+          unreleased_entries: unreleased_entries,
+          prepared_release_pending: prepared_release_pending,
+          latest_changelog_version: latest_changelog_version,
+          latest_released: latest_overall,
+          latest_released_for_current_series: latest_for_series,
+          latest_release_target: latest_target,
+          gem_name: gem_name
+        }
+      end
+
       private
 
       def abort(msg)

data/lib/kettle/dev/gha_sha_pins_cli.rb

@@ -478,7 +478,7 @@ module Kettle
 
       def parse_release_version(value)
         normalized = value.to_s.sub(/\A[vV]/, "")
-        return nil unless normalized.match?(/\A\d+\.\d+\.\d+(?:[-.]?[0-9A-Za-z.-]+)?\z/)
+        return nil unless normalized.match?(/\A(?:\d+|\d+\.\d+\.\d+(?:[-.]?[0-9A-Za-z.-]+)?)\z/)
 
         Gem::Version.new(normalized)
       rescue ArgumentError
@@ -504,11 +504,13 @@ module Kettle
       def choose_upgrade_target(current_version, versions, level)
         current = parse_release_version(current_version)
         return nil if current.nil?
+        return nil if level != "major" && major_line_version?(current_version)
 
         candidates = versions.select do |entry|
           next false unless entry[:version_obj].is_a?(Gem::Version)
           next false unless entry[:version_obj] > current
           next false if entry[:version_obj].prerelease? && !current.prerelease?
+          next false if level != "major" && major_line_version?(entry[:version])
 
           case level
           when "patch"
@@ -523,6 +525,10 @@ module Kettle
         candidates.max_by { |entry| entry[:version_obj] }
       end
 
+      def major_line_version?(value)
+        value.to_s.match?(/\A\d+\z/)
+      end
+
       def latest_outdated_target(current_version, versions)
         current = parse_release_version(current_version)
         return nil if current.nil?
@@ -1051,11 +1057,13 @@ module Kettle
 
             deserialized.merge(cached_at: entry["cached_at"].to_s)
           end
+          return {} if entries.empty?
 
+          full_semver_entries = entries.reject { |entry| major_line_version?(entry[:version]) }
           {
-            "patch" => entries.group_by { |entry| entry[:version_obj].segments[0, 2].join(".") }
+            "patch" => full_semver_entries.group_by { |entry| entry[:version_obj].segments[0, 2].join(".") }
               .transform_values { |group| serialize_target(group.max_by { |entry| entry[:version_obj] }) },
-            "minor" => entries.group_by { |entry| entry[:version_obj].segments[0].to_s }
+            "minor" => full_semver_entries.group_by { |entry| entry[:version_obj].segments[0].to_s }
               .transform_values { |group| serialize_target(group.max_by { |entry| entry[:version_obj] }) },
             "major" => {"*" => serialize_target(entries.max_by { |entry| entry[:version_obj] })}
           }
@@ -1076,6 +1084,10 @@ module Kettle
           nil
         end
 
+        def major_line_version?(value)
+          value.to_s.match?(/\A\d+\z/)
+        end
+
         def fresh_entry?(entry)
           cached_at = Time.iso8601(entry["cached_at"].to_s)
           cached_at >= @clock.call - @ttl_seconds
@@ -1191,7 +1203,7 @@ module Kettle
 
         def parse_release_version_text(value)
           normalized = value.to_s.sub(/\A[vV]/, "")
-          return nil unless normalized.match?(/\A\d+\.\d+\.\d+(?:[-.]?[0-9A-Za-z.-]+)?\z/)
+          return nil unless normalized.match?(/\A(?:\d+|\d+\.\d+\.\d+(?:[-.]?[0-9A-Za-z.-]+)?)\z/)
 
           Gem::Version.new(normalized)
         rescue ArgumentError

data/lib/kettle/dev/version.rb

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

data/sig/kettle/dev/changelog_cli.rbs

@@ -15,6 +15,8 @@ module Kettle
       # Main entry point that updates CHANGELOG.md
       def run: () -> void
 
+      def pending_release_status: () -> Hash[Symbol, untyped]
+
       private
 
       # Abort with error message
@@ -61,4 +63,3 @@ module Kettle
     end
   end
 end
-

metadata

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