kettle-dev 2.2.5 → 2.2.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ba33ed9512e4bc65a82886c163c0c01c3b8c59895326fb64c64b01c97fbbbf77
-  data.tar.gz: 9c14bb68844fd3c46315215b6e60a9f35b3ebd9c416a8fad96552e361e061f30
+  metadata.gz: 3468f777c78fb3017468fbb76728ee056aa1924738b8935d1fd748d41c91f3ff
+  data.tar.gz: 10386b28122fb17e85f555c70784a398d0f8692f3b02d77ebafab8540ae74cc6
 SHA512:
-  metadata.gz: fd4cb6930f617bcbc033d1366a69a0f11911b6293145e37a30d149ecb7a3b54fc2c2cda287294105ca4a5d1b9598765318a9291e5999bafefe6a066be27b1ecb
-  data.tar.gz: 9cf023ac4edeb2d13bb063e62f5fb73b61405e3e7d12e63b5350de1dab920ff5fa8a9bb3425f76648e4fa8bc1254392d1fb0a7b7dbfb13603cf8dc77415ad2d3
+  metadata.gz: 3de744ea449a1f6f738b6b19704bbf48a996a67c835201310bfd60b9127fa3b3a2634fd52c9f3d8f2ce45a571e6caf316f91d902f2f8fab8a8d3511bc21c13bc
+  data.tar.gz: 1efa9c2da744cdd3fa16d0676b06b78836df3d4194ee6908a756ad479d63c5c50e015a8dde67f416d0cd2e2da3e3c9bff4971c980840603db4613c9bf9f37cc3

data/CHANGELOG.md

@@ -30,6 +30,38 @@ Please file a bug if you notice a violation of semantic versioning.
 
 ### Security
 
+## [2.2.7] - 2026-06-13
+
+- TAG: [v2.2.7][2.2.7t]
+- COVERAGE: 92.36% -- 3843/4161 lines in 28 files
+- BRANCH COVERAGE: 73.54% -- 1520/2067 branches in 28 files
+- 66.02% documented
+
+### Added
+
+#### Changelog
+
+- Added `kettle-changelog --release-state` / `--release-status` with optional
+  `--json` output for single-gem changelog release state reporting.
+- Added a richer `Kettle::Dev::ChangelogCLI#release_state` API that reports the
+  latest released version, latest changelog release section, and pending
+  changelog sources.
+
+## [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]
@@ -2060,7 +2092,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.5...HEAD
+[Unreleased]: https://github.com/kettle-dev/kettle-dev/compare/v2.2.7...HEAD
+[2.2.7]: https://github.com/kettle-dev/kettle-dev/compare/v2.2.6...v2.2.7
+[2.2.7t]: https://github.com/kettle-dev/kettle-dev/releases/tag/v2.2.7
+[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

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.137-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
+[🧮kloc-img]: https://img.shields.io/badge/KLOC-4.161-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/exe/kettle-changelog

@@ -41,7 +41,7 @@ begin
 
   # This library
   require "kettle/dev"
-  puts "== #{script_basename} v#{Kettle::Dev::Version::VERSION} =="
+  puts "== #{script_basename} v#{Kettle::Dev::Version::VERSION} ==" 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.")
@@ -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] [--release-state] [--json] [--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,10 @@ 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
+        --release-state,
+        --release-status          Print changelog release state, including latest published release and pending sources
+        --json                    Print query output as JSON
         --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 +93,34 @@ 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")
+  release_state_query = ARGV.delete("--release-state") || ARGV.delete("--release-status")
+  json_output = ARGV.delete("--json")
   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 release_state_query
+    state = cli.release_state
+    puts(json_output ? JSON.pretty_generate(state) : cli.release_state_table(state))
+    exit(0)
+  end
+
+  if pending_release_query
+    state = cli.pending_release_status
+    output = if json_output
+      JSON.pretty_generate(state)
+    elsif state.fetch(:pending_release)
+      "true"
+    else
+      "false"
+    end
+    puts(output)
+    exit(state.fetch(:pending_release) ? 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

@@ -24,8 +24,8 @@ module Kettle
       # @param strict [Boolean] when true (default), require coverage and yard data; raise errors if unavailable
       # @param enforce_coverage_thresholds [Boolean] when true, fail strict coverage generation below project thresholds
       # @param update_prep [Boolean] when true, update the most recent prepared release section in place
-      def initialize(strict: true, enforce_coverage_thresholds: true, update_prep: false)
-        @root = Kettle::Dev::CIHelpers.project_root
+      def initialize(strict: true, enforce_coverage_thresholds: true, update_prep: false, root: Kettle::Dev::CIHelpers.project_root)
+        @root = root
         @changelog_path = File.join(@root, "CHANGELOG.md")
         @coverage_path = File.join(@root, "coverage", "coverage.json")
         @strict = strict
@@ -135,12 +135,71 @@ module Kettle
         puts "CHANGELOG.md updated with v#{version} section."
       end
 
+      def pending_release_status
+        release_state
+      end
+
+      def release_state
+        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)
+        version = detect_version
+        gem_name = detect_gem_name
+        release_lookup_version = latest_changelog_version || version
+        latest_overall, latest_for_series = latest_released_versions(gem_name, release_lookup_version)
+        latest_target = latest_release_target(release_lookup_version, latest_overall, latest_for_series)
+        prepared_release_pending = !!latest_changelog_version && latest_target != latest_changelog_version
+
+        {
+          root: @root,
+          gem_name: gem_name,
+          version: version,
+          pending: unreleased_entries || prepared_release_pending,
+          pending_release: 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
+        }
+      end
+
+      def release_state_table(state = release_state)
+        rows = [
+          ["gem", "version.rb", "latest released", "latest changelog", "unreleased", "prepared", "pending"],
+          [
+            state.fetch(:gem_name),
+            state.fetch(:version),
+            state.fetch(:latest_released) || "unknown",
+            state.fetch(:latest_changelog_version) || "none",
+            yes_no(state.fetch(:unreleased_entries)),
+            yes_no(state.fetch(:prepared_release_pending)),
+            yes_no(state.fetch(:pending_release))
+          ]
+        ]
+        widths = rows.transpose.map { |column| column.map(&:length).max }
+        rows.map.with_index do |row, index|
+          line = row.each_with_index.map { |value, i| value.ljust(widths.fetch(i)) }.join("  ").rstrip
+          if index == 0
+            [line, widths.map { |width| "-" * width }.join("  ")].join("\n")
+          else
+            line
+          end
+        end.join("\n")
+      end
+
       private
 
       def abort(msg)
         Kettle::Dev::ExitAdapter.abort(msg)
       end
 
+      def yes_no(value)
+        value ? "yes" : "no"
+      end
+
       def detect_plan(changelog, version)
         latest_overall = nil
         latest_for_series = nil

data/lib/kettle/dev/version.rb

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

data/sig/kettle/dev/changelog_cli.rbs

@@ -10,11 +10,17 @@ module Kettle
       @changelog_path: String
       @coverage_path: String
 
-      def initialize: () -> void
+      def initialize: (?strict: bool, ?enforce_coverage_thresholds: bool, ?update_prep: bool, ?root: String) -> void
 
       # Main entry point that updates CHANGELOG.md
       def run: () -> void
 
+      def pending_release_status: () -> Hash[Symbol, untyped]
+
+      def release_state: () -> Hash[Symbol, untyped]
+
+      def release_state_table: (?Hash[Symbol, untyped] state) -> String
+
       private
 
       # Abort with error message
@@ -61,4 +67,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.5
+  version: 2.2.7
 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.5
-  changelog_uri: https://github.com/kettle-dev/kettle-dev/blob/v2.2.5/CHANGELOG.md
+  source_code_uri: https://github.com/kettle-dev/kettle-dev/tree/v2.2.7
+  changelog_uri: https://github.com/kettle-dev/kettle-dev/blob/v2.2.7/CHANGELOG.md
   bug_tracker_uri: https://github.com/kettle-dev/kettle-dev/issues
-  documentation_uri: https://www.rubydoc.info/gems/kettle-dev/2.2.5
+  documentation_uri: https://www.rubydoc.info/gems/kettle-dev/2.2.7
   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