kettle-dev 2.2.6 → 2.2.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b8c22a00d9dde1e8574e1b8018fcf356b683c5a0c558b304bfac6d4b307d2de1
-  data.tar.gz: 69b132d5faa7e4d07f52344491295fb349e1453b2aa43b2de2ae25fbff21a9a2
+  metadata.gz: 20e42b5ed4a5e7b52a046fa7cfdfe63c08963947c2414aa4cf22251419ffb853
+  data.tar.gz: e578b54456e497e115ccdb9bb54efc4d32be13e2b294d2b0857964b75bc5c7ff
 SHA512:
-  metadata.gz: 0f0c9b87d7bc0cf30712c3e6cbbedabd66d6af631ed39586fe7853f78970b3b8ea80e18c78130394c323f3d09d61cf7b5c39d9c1927ed71fe9fb30a3e1c7453d
-  data.tar.gz: 7eb506783c68f81ac54ae37b54d4b415d996f1a2f50ce112c2733cd0726ca55088b3875c281743aa8eed389243d4049ca01f07f2a0211cc99b4f462ff17a4c5e
+  metadata.gz: 676baf6a4ecffe8745d94c3016b402e8c002f98ca61f9ea478b9e629d42c7c57a82795682d49c853c19fff74982e8c70af5cf75b1e0eb6b28ce2fb904995762e
+  data.tar.gz: a000e3b43e2ea900fcdb03cb2471db4a8c312113c753524ca7be658119c81bba1cfb7113e0ccb576a2cf6b471c472fc01c6b71afc4eebf7322b3760e3a848c4c

data/CHANGELOG.md

@@ -30,6 +30,40 @@ Please file a bug if you notice a violation of semantic versioning.
 
 ### Security
 
+## [2.2.8] - 2026-06-13
+
+- TAG: [v2.2.8][2.2.8t]
+- COVERAGE: 92.40% -- 3854/4171 lines in 28 files
+- BRANCH COVERAGE: 73.37% -- 1521/2073 branches in 28 files
+- 66.02% documented
+
+### Fixed
+
+#### Changelog
+
+- `kettle-changelog --release-state` now reports a clear family-root hint when
+  run outside a single gem instead of raising a missing `CHANGELOG.md` stack
+  trace.
+- `kettle-changelog --release-state` now reports a successful no-changelog state
+  for individual gems that do not have a `CHANGELOG.md`.
+
+## [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]
@@ -2075,7 +2109,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.6...HEAD
+[Unreleased]: https://github.com/kettle-dev/kettle-dev/compare/v2.2.8...HEAD
+[2.2.8]: https://github.com/kettle-dev/kettle-dev/compare/v2.2.7...v2.2.8
+[2.2.8t]: https://github.com/kettle-dev/kettle-dev/releases/tag/v2.2.8
+[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

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.154-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
+[🧮kloc-img]: https://img.shields.io/badge/KLOC-4.171-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] [--pending-release] [--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:
@@ -63,6 +63,9 @@ 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
 
@@ -92,14 +95,29 @@ begin
   strict_mode = !ARGV.include?("--no-strict") && ENV.fetch("K_CHANGELOG_STRICT", "true").downcase != "false"
   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"
 
   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
-    status = cli.pending_release_status
-    puts status.fetch(:pending) ? "true" : "false"
-    exit(status.fetch(:pending) ? 0 : 1)
+    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

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
@@ -136,46 +136,101 @@ module Kettle
       end
 
       def pending_release_status
+        release_state
+      end
+
+      def release_state
+        changelog_present = ensure_changelog_for_release_state!
+        version = detect_version
+        gem_name = detect_gem_name
+        unless changelog_present
+          latest_overall, latest_for_series = latest_released_versions(gem_name, version)
+          latest_target = latest_release_target(version, latest_overall, latest_for_series)
+          return {
+            root: @root,
+            gem_name: gem_name,
+            version: version,
+            changelog_present: false,
+            pending: false,
+            pending_release: false,
+            unreleased_entries: false,
+            prepared_release_pending: false,
+            latest_changelog_version: nil,
+            latest_released: latest_overall,
+            latest_released_for_current_series: latest_for_series,
+            latest_release_target: latest_target
+          }
+        end
+
         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
+        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,
+          changelog_present: true,
           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,
-          gem_name: gem_name
+          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 ensure_changelog_for_release_state!
+        return true if File.file?(@changelog_path)
+
+        if File.file?(File.join(@root, "Gemfile")) && Dir.glob(File.join(@root, "*", "*.gemspec")).any?
+          abort("Could not find CHANGELOG.md in #{Kettle::Dev.display_path(@root)}. This looks like a gem-family root; run `kettle-family release-state` from this directory, or run `kettle-changelog --release-state` from an individual gem directory.")
+        end
+
+        false
+      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.6"
+      VERSION = "2.2.8"
     end
     VERSION = Version::VERSION # Traditional Constant Location
   end

data/sig/kettle/dev/changelog_cli.rbs

@@ -10,13 +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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: kettle-dev
 version: !ruby/object:Gem::Version
-  version: 2.2.6
+  version: 2.2.8
 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.6
-  changelog_uri: https://github.com/kettle-dev/kettle-dev/blob/v2.2.6/CHANGELOG.md
+  source_code_uri: https://github.com/kettle-dev/kettle-dev/tree/v2.2.8
+  changelog_uri: https://github.com/kettle-dev/kettle-dev/blob/v2.2.8/CHANGELOG.md
   bug_tracker_uri: https://github.com/kettle-dev/kettle-dev/issues
-  documentation_uri: https://www.rubydoc.info/gems/kettle-dev/2.2.6
+  documentation_uri: https://www.rubydoc.info/gems/kettle-dev/2.2.8
   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