kettle-dev 2.0.2 → 2.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c3bad017c27149d9c7bf639bf70347f639d9301b3ce355c9a20eb7466f959df0
-  data.tar.gz: 8c96fb38ea79b64d55d2813725120518e1e3bcf2dda8396c8b2da1e3aa699d23
+  metadata.gz: 79a49f87b3b9af1b0aa2cb1b9d8f3b026a923df0ab1164df416a5dc3af72dc42
+  data.tar.gz: b989207755b131704aec4e5a76e29c1a2e236efbe9fa7717939111d21c475a74
 SHA512:
-  metadata.gz: 21ad36073bf15fd42f052958148f8129138e4ab79195d524457ba5c29e206fd261f283b9b6616e7a41cc46b6455c27e1d763167f8b8e75655acf2cdaa1a5c713
-  data.tar.gz: fcef88758871ad5eb760e0671972c6ef389dd3d9037f5006ddd65d2d07c651c7778a86dd344e86815b37b0451833544ba10ef895db28c6fa5dd0221502013d95
+  metadata.gz: ffd633d7aab286c63bbdbb039621fd0512ce4d4d478b9af5bcb37b7c9202bbab8e7cf4ab41fecb5b6306da2ba2d42bf7f20770066131ac19344655ff3f9c7b58
+  data.tar.gz: ce2c0ed8704aa2aa0aaa248f0a2269a74ac2fe9e765117cb96e80004a98c20c7420ebddd876d887543895240732c5edf64ad2fc417efdf9cd19bc4ae6390791f

data/CHANGELOG.md

@@ -28,8 +28,32 @@ Please file a bug if you notice a violation of semantic versioning.
 
 ### Fixed
 
+- The `yard` rake spec now reloads the task file directly and uses Ruby
+  2.4-compatible cleanup syntax, fixing order-dependent CI failures across the
+  appraisal matrix.
+- The `yard` rake fallback task now remains registered with kettle-dev defaults
+  when the optional `yard` gem is unavailable in an appraisal environment.
+- The Rakefile now falls back to a stub `kettle:jem:selftest` task when the
+  installed `kettle-jem` package does not expose rake task installation.
+
 ### Security
 
+## [2.0.3] - 2026-05-27
+
+- TAG: [v2.0.3][2.0.3t]
+- COVERAGE: 94.62% -- 2956/3124 lines in 24 files
+- BRANCH COVERAGE: 78.21% -- 1206/1542 branches in 24 files
+- 76.40% documented
+
+### Fixed
+
+- The default rake task now includes documentation generation via `yard`, so
+  documentation plugin post-processing runs during `bin/rake`.
+- `kettle-changelog` now updates the current changelog release in place when
+  Unreleased has pending entries or the release section is missing generated
+  coverage/documentation metadata, even if the version is already the latest
+  known release.
+
 ## [2.0.2] - 2026-05-27
 
 - TAG: [v2.0.2][2.0.2t]
@@ -1763,7 +1787,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-rb/kettle-dev/compare/v2.0.2...HEAD
+[Unreleased]: https://github.com/kettle-rb/kettle-dev/compare/v2.0.3...HEAD
+[2.0.3]: https://github.com/kettle-rb/kettle-dev/compare/v2.0.2...v2.0.3
+[2.0.3t]: https://github.com/kettle-rb/kettle-dev/releases/tag/v2.0.3
 [2.0.2]: https://github.com/kettle-rb/kettle-dev/compare/v2.0.1...v2.0.2
 [2.0.2t]: https://github.com/kettle-rb/kettle-dev/releases/tag/v2.0.2
 [2.0.1]: https://github.com/kettle-rb/kettle-dev/compare/v2.0.0...v2.0.1

data/README.md

@@ -1010,7 +1010,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-3.101-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
+[🧮kloc-img]: https://img.shields.io/badge/KLOC-3.124-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
 [🔐security]: https://github.com/kettle-rb/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/changelog_cli.rb

@@ -153,7 +153,7 @@ module Kettle
           warn("Proceeding without live release info.")
         end
 
-        _unreleased_block, _before, after = extract_unreleased(changelog)
+        unreleased_block, _before, after = extract_unreleased(changelog)
         latest_changelog_version = detect_previous_version(after.to_s)
         section_exists = release_section_exists?(changelog, version)
         latest_target = latest_release_target(version, latest_overall, latest_for_series)
@@ -167,7 +167,7 @@ module Kettle
         end
 
         action = if section_exists && latest_target == version
-          :reformat_only
+          current_release_needs_update?(changelog, version, unreleased_block) ? :update_prepared_release : :reformat_only
         elsif section_exists
           :update_prepared_release
         elsif latest_target == version
@@ -504,6 +504,28 @@ module Kettle
         out.join
       end
 
+      def current_release_needs_update?(changelog, version, unreleased_block)
+        return true if unreleased_block_has_entries?(unreleased_block)
+
+        !release_metadata_complete?(release_body_for(changelog, version))
+      end
+
+      def unreleased_block_has_entries?(unreleased_block)
+        !filter_unreleased_sections(unreleased_block.to_s).strip.empty?
+      end
+
+      def release_body_for(changelog, version)
+        pattern = /^## \[#{Regexp.escape(version)}\][^\n]*\n(?<body>.*?)(?=^## \[|\z)/m
+        changelog.match(pattern)&.[](:body).to_s
+      end
+
+      def release_metadata_complete?(release_body)
+        stripped_body = release_body.to_s
+        stripped_body.match?(/^- COVERAGE: /) &&
+          stripped_body.match?(/^- BRANCH COVERAGE: /) &&
+          stripped_body.match?(/^- \d+(?:\.\d+)?%\s+documented$/)
+      end
+
       def coverage_lines
         if @strict
           # Always generate fresh coverage data in strict mode

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

@@ -24,10 +24,13 @@ begin
   rescue LoadError
     # yard-timekeeper not available - that's fine
   end
+
+  Kettle::Dev.register_default("yard")
 rescue LoadError
   warn("[kettle-dev][yard.rake] failed to load yard") if Kettle::Dev::DEBUGGING
   desc("(stub) yard is unavailable")
   task(:yard) do
     warn("NOTE: yard isn't installed, or is disabled for #{RUBY_VERSION} in the current environment")
   end
+  Kettle::Dev.register_default("yard")
 end

data/lib/kettle/dev/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: kettle-dev
 version: !ruby/object:Gem::Version
-  version: 2.0.2
+  version: 2.0.3
 platform: ruby
 authors:
 - Peter H. Boling
@@ -312,10 +312,10 @@ licenses:
 - AGPL-3.0-only
 metadata:
   homepage_uri: https://kettle-dev.galtzo.com
-  source_code_uri: https://github.com/kettle-rb/kettle-dev/tree/v2.0.2
-  changelog_uri: https://github.com/kettle-rb/kettle-dev/blob/v2.0.2/CHANGELOG.md
+  source_code_uri: https://github.com/kettle-rb/kettle-dev/tree/v2.0.3
+  changelog_uri: https://github.com/kettle-rb/kettle-dev/blob/v2.0.3/CHANGELOG.md
   bug_tracker_uri: https://github.com/kettle-rb/kettle-dev/issues
-  documentation_uri: https://www.rubydoc.info/gems/kettle-dev/2.0.2
+  documentation_uri: https://www.rubydoc.info/gems/kettle-dev/2.0.3
   funding_uri: https://github.com/sponsors/pboling
   wiki_uri: https://github.com/kettle-rb/kettle-dev/wiki
   news_uri: https://www.railsbling.com/tags/kettle-dev