kettle-changelog 1.0.7 → 1.0.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2ecd249c6b061cc317b81a854a766b92f0f8563ec986d46ba301c91aa0e03be9
-  data.tar.gz: 5aa44defac27dbce2d14a0b52f24647a700f9910980ab5dea0ed194586c2bb26
+  metadata.gz: 8a256a56bf5f4ac6880b6f58afa62ddb214d34b9b3b6aa2a87fdd01c4a6a4b19
+  data.tar.gz: f9fa4e2f31cc74bc7b11c613ed17ca60d0776a2ea47f66d3619a9f744b760ccc
 SHA512:
-  metadata.gz: 4f2695df4b42baf349133ce330e7e35ea80ec0060a7d50e6373249717cd171fdbbc50898f89dfdbfc2e5fab4d698bcc60b30512f170d0bccbd9bf33a5cd3c7d9
-  data.tar.gz: 85cc9764d62f271e046efec6730b491c0a124d78a52dea7732f4fd31f94ebb4bd2e2b8d994147d51b1fe92ccfdd20d3289cad70681ca1883a65d2a11ba3154c5
+  metadata.gz: 7f4d67bd8ce4b4c9b0db783928cfbb8039bae82180baaae22a16434b99749ab0ed0fa1189f20a92c3bf846e70b4db9964db30241d9e00d9ef7ebe11b349aa746
+  data.tar.gz: 8908cc25431735377fb4b1b87c7d0375e1cc08b820007d6f6ccb8b098bc7c48c20018cb637a71edb51f5623184af4e2c132ceafb10f3a20d2c982ea9f185203b

data/CHANGELOG.md

@@ -30,6 +30,60 @@ Please file a bug if you notice a violation of semantic versioning.
 
 ### Security
 
+## [1.0.9] - 2026-10-10
+
+- TAG: [v1.0.9][1.0.9t]
+- COVERAGE: 94.26% -- 1149/1219 lines in 6 files
+- BRANCH COVERAGE: 77.78% -- 406/522 branches in 6 files
+- 38.89% documented
+
+### Changed
+
+- [kc] kettle-jem/prepare: updated 10 project files:
+  - dependencies (10)
+
+- [kc] kettle-jem/template: updated 4 project files:
+  - dependencies (1)
+  - documentation (1)
+  - other (1)
+  - workflows (1)
+
+### Fixed
+
+- prepare-release (strict coverage): delete the stale Appraisal-generated coverage lockfile (gemfiles/coverage.gemfile.lock) before running the coverage child. That lockfile is a gitignored local artifact that drifts after dependency bumps; a stale pin killed the coverage bundle with an opaque Bundler::GemNotFound (observed: kettle-rb 0.1.16 pinned while 0.1.17 was the only installed/source version). Deleting it mirrors rake appraisal:reset for exactly this lockfile, so the coverage bundle re-resolves fresh from the gemfile.
+
+## [1.0.8] - 2026-09-27
+
+- TAG: [v1.0.8][1.0.8t]
+- COVERAGE: 94.37% -- 1139/1207 lines in 6 files
+- BRANCH COVERAGE: 77.52% -- 400/516 branches in 6 files
+- 38.89% documented
+
+### Added
+
+- kettle-jem-template-20260913-001 - Templating now also surfaces a review
+  entry in `dependency_conflicts.resolve` when a direct development
+  dependency doesn't support one or more of this project's declared
+  `engines:` and has no template-managed modular home (e.g. `sqlite3` on
+  `jruby`). Review each entry and pick a resolution per the project's own
+  engine support needs.
+
+### Changed
+
+- [kc] kettle-jem/prepare: updated 15 project files:
+  - configuration (1)
+  - dependencies (14)
+
+- [kc] kettle-jem/template: updated 15 project files:
+  - code and tests (1)
+  - dependencies (2)
+  - other (3)
+  - workflows (9)
+
+### Fixed
+
+- Run YARD binstubs through Ruby so release metadata checks work on Windows without Unix executable bits.
+
 ## [1.0.7] - 2026-08-30
 
 - TAG: [v1.0.7][1.0.7t]
@@ -205,7 +259,11 @@ Please file a bug if you notice a violation of semantic versioning.
 
 - Initial release
 
-[Unreleased]: https://github.com/kettle-dev/kettle-changelog/compare/v1.0.7...HEAD
+[Unreleased]: https://github.com/kettle-dev/kettle-changelog/compare/v1.0.9...HEAD
+[1.0.9]: https://github.com/kettle-dev/kettle-changelog/compare/v1.0.8...v1.0.9
+[1.0.9t]: https://github.com/kettle-dev/kettle-changelog/releases/tag/v1.0.9
+[1.0.8]: https://github.com/kettle-dev/kettle-changelog/compare/v1.0.7...v1.0.8
+[1.0.8t]: https://github.com/kettle-dev/kettle-changelog/releases/tag/v1.0.8
 [1.0.7]: https://github.com/kettle-dev/kettle-changelog/compare/v1.0.6...v1.0.7
 [1.0.7t]: https://github.com/kettle-dev/kettle-changelog/releases/tag/v1.0.7
 [1.0.6]: https://github.com/kettle-dev/kettle-changelog/compare/v1.0.5...v1.0.6

data/README.md

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

@@ -6,6 +6,7 @@ require "net/http"
 require "uri"
 require "fileutils"
 require "yaml"
+require "rbconfig"
 require "kettle/ndjson"
 
 module Kettle
@@ -826,6 +827,8 @@ module Kettle
             emit_changelog_event(action: "coverage_clean", status: "ok", path: Kettle::Dev.display_path(coverage_dir))
           end
 
+          reset_stale_appraisal_lockfile!
+
           puts "Generating fresh coverage data by running: bundle exec kettle-test"
           emit_changelog_event(action: "coverage", status: "started", command: "bundle exec kettle-test", root: Kettle::Dev.display_path(@coverage_root))
 
@@ -921,6 +924,35 @@ module Kettle
         )
       end
 
+      # The coverage child runs against the Appraisal-generated coverage
+      # gemfile (gemfiles/coverage.gemfile) when present, and Bundler uses the
+      # lockfile sitting next to it. That lockfile is a local build artifact
+      # (gitignored, regenerated by appraisal workflows) and drifts silently:
+      # after a dependency bump it can pin a version that no longer exists
+      # anywhere, and the coverage child dies with an opaque
+      # Bundler::GemNotFound pointing at the pinned version. Deleting it here
+      # mirrors rake appraisal:reset for exactly one lockfile: Bundler then
+      # resolves fresh from the gemfile, which is the same contract every
+      # other consumer of this gemfile has.
+      def reset_stale_appraisal_lockfile!
+        return unless @coverage_gemfile
+
+        coverage_dir = File.dirname(@coverage_gemfile)
+        return unless File.basename(coverage_dir) == "gemfiles"
+
+        lockfile = "#{@coverage_gemfile}.lock"
+        return unless File.file?(lockfile)
+
+        File.delete(lockfile)
+        puts "Deleted stale appraisal lockfile #{Kettle::Dev.display_path(lockfile)}; the coverage bundle will re-resolve."
+        emit_changelog_event(action: "coverage_lockfile_reset", status: "ok", path: Kettle::Dev.display_path(lockfile))
+      rescue => e
+        # Best effort: a lockfile we cannot delete is not fatal — resolution
+        # may still succeed if the lock happens to be current.
+        warn("Could not delete stale appraisal lockfile #{lockfile}: #{e.class}: #{e.message}")
+        emit_changelog_event(action: "coverage_lockfile_reset", status: "failed", path: Kettle::Dev.display_path(lockfile), reason: e.message)
+      end
+
       def changelog_coverage_env
         env = Kettle::Dev::BundlerEnvGuard.unbundled_env.merge(
           "PATH" => ENV.fetch("PATH", ""),
@@ -1022,7 +1054,7 @@ module Kettle
 
         # Run the canonical docs task to get the documentation percentage.
         commands.each do |command|
-          prepare_yard_fence_tmp_files if command == [File.join(@root, "bin", "yard")]
+          prepare_yard_fence_tmp_files if command == [RbConfig.ruby, File.join(@root, "bin", "yard")]
           output, status = capture_yard_command(command)
           unless command_successful?(status)
             return handle_yard_documentation_failure(yard_command_failure_message(command, output, status))
@@ -1079,9 +1111,11 @@ module Kettle
 
       def yard_command_label(command)
         command = Array(command)
-        bin = command.first.to_s
+        ruby_script = command.first == RbConfig.ruby
+        bin = ruby_script ? command[1].to_s : command.first.to_s
+        arguments = ruby_script ? command.drop(2) : command.drop(1)
         if bin == File.join(@root, "bin", "rake")
-          "bin/rake #{command.drop(1).join(" ")}".strip
+          "bin/rake #{arguments.join(" ")}".strip
         elsif bin == File.join(@root, "bin", "yard")
           "bin/yard"
         else
@@ -1092,9 +1126,9 @@ module Kettle
       def yard_documentation_commands
         commands = []
         rake = File.join(@root, "bin", "rake")
-        commands << [rake, "yard"] if File.executable?(rake)
+        commands << [RbConfig.ruby, rake, "yard"] if File.file?(rake)
         yard = File.join(@root, "bin", "yard")
-        commands << [yard] if File.executable?(yard)
+        commands << [RbConfig.ruby, yard] if File.file?(yard)
         commands
       end
 

data/lib/kettle/changelog/version.rb

@@ -5,7 +5,7 @@ module Kettle
     # Version namespace for this gem.
     module Version
       # Current gem version.
-      VERSION = "1.0.7"
+      VERSION = "1.0.9"
     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-changelog
 version: !ruby/object:Gem::Version
-  version: 1.0.7
+  version: 1.0.9
 platform: ruby
 authors:
 - Peter H. Boling
@@ -61,22 +61,22 @@ dependencies:
   name: kettle-dev
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 3.0.19
-    - - "<"
+        version: '3.1'
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 4.0.0
+        version: 3.1.9
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 3.0.19
-    - - "<"
+        version: '3.1'
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 4.0.0
+        version: 3.1.9
 - !ruby/object:Gem::Dependency
   name: version_gem
   requirement: !ruby/object:Gem::Requirement
@@ -174,7 +174,7 @@ dependencies:
         version: '3.2'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.2.2
+        version: 3.2.5
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -184,7 +184,7 @@ dependencies:
         version: '3.2'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.2.2
+        version: 3.2.5
 - !ruby/object:Gem::Dependency
   name: kettle-test
   requirement: !ruby/object:Gem::Requirement
@@ -194,7 +194,7 @@ dependencies:
         version: '2.0'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.0.21
+        version: 2.0.24
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -204,7 +204,7 @@ dependencies:
         version: '2.0'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.0.21
+        version: 2.0.24
 - !ruby/object:Gem::Dependency
   name: turbo_tests2
   requirement: !ruby/object:Gem::Requirement
@@ -214,7 +214,7 @@ dependencies:
         version: '3.2'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.2.6
+        version: 3.2.14
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -224,7 +224,7 @@ dependencies:
         version: '3.2'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.2.6
+        version: 3.2.14
 - !ruby/object:Gem::Dependency
   name: ruby-progressbar
   requirement: !ruby/object:Gem::Requirement
@@ -248,7 +248,7 @@ dependencies:
         version: '1.0'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.0.8
+        version: 1.0.9
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -258,7 +258,7 @@ dependencies:
         version: '1.0'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.0.8
+        version: 1.0.9
 - !ruby/object:Gem::Dependency
   name: gitmoji-regex
   requirement: !ruby/object:Gem::Requirement
@@ -268,7 +268,7 @@ dependencies:
         version: '2.0'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.0.12
+        version: 2.0.15
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -278,7 +278,7 @@ dependencies:
         version: '2.0'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.0.12
+        version: 2.0.15
 description: "\U0001F4DD kettle-changelog formats release sections, manages Unreleased
   entries, and emits machine-readable release events for Ruby gems."
 email:
@@ -304,10 +304,10 @@ licenses:
 - AGPL-3.0-only
 metadata:
   homepage_uri: https://kettle-changelog.galtzo.com
-  source_code_uri: https://github.com/kettle-dev/kettle-changelog/tree/v1.0.7
-  changelog_uri: https://github.com/kettle-dev/kettle-changelog/blob/v1.0.7/CHANGELOG.md
+  source_code_uri: https://github.com/kettle-dev/kettle-changelog/tree/v1.0.9
+  changelog_uri: https://github.com/kettle-dev/kettle-changelog/blob/v1.0.9/CHANGELOG.md
   bug_tracker_uri: https://github.com/kettle-dev/kettle-changelog/issues
-  documentation_uri: https://www.rubydoc.info/gems/kettle-changelog/1.0.7
+  documentation_uri: https://www.rubydoc.info/gems/kettle-changelog/1.0.9
   funding_uri: https://github.com/sponsors/pboling
   wiki_uri: https://github.com/kettle-dev/kettle-changelog/wiki
   news_uri: https://www.railsbling.com/tags/kettle-changelog
@@ -337,7 +337,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.17
+rubygems_version: 4.0.20
 specification_version: 4
 summary: "\U0001F4DD Release and maintain structured CHANGELOG.md files."
 test_files: []