kettle-dev 3.0.18 → 3.0.19

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4dc02c70ec8eb1cdf707e6cbef542a3117258006a83a9f6ac15261388c05b147
-  data.tar.gz: 6c4a8431553b479404d1a3d4264e633fd54e9154fbb305e7f10b80167da53220
+  metadata.gz: d876b80536e92761ec39671fee1b416885fceba475be7ade298e9dd8985df29e
+  data.tar.gz: d9075edc61ba1b98e98b7a4024d53d8c57e4beb0a0239059eeb0ddc6ec597c35
 SHA512:
-  metadata.gz: 0e400e4b0bcfe3019606b4954b91430818ff760f69497dbe5c18a2a9a9f2f82755a496a2773db82c830477eb4e7785344108cb93294224b70dc249c37dc10dae
-  data.tar.gz: 8163c6e8ff99e586bc2085184968509ae28bbb6c547c0189a08c2a48780e6b8260598421a695a089a1e856dd1d82beff34d8122583f21e3762e808daac6f4114
+  metadata.gz: aa04b5dc3afa36b4dfdb5c7671ec2fba75fbb0bf73a1d88ee00c0e66d0c81bea453e57670f659a830a4042c98199d9f0fb280602bca5e0840395a998761e3fcd
+  data.tar.gz: 57ba7e91a1130bcb673b40b1c278b9206157163121a7bac829cf784641d2095153577bae43595d0fcba02f2f7ddb4b008c741f7599819f98e7678ebf36e45ce5

data/CHANGELOG.md

@@ -30,6 +30,21 @@ Please file a bug if you notice a violation of semantic versioning.
 
 ### Security
 
+## [3.0.19] - 2026-08-30
+
+- TAG: [v3.0.19][3.0.19t]
+- COVERAGE: 91.50% -- 5855/6399 lines in 47 files
+- BRANCH COVERAGE: 76.21% -- 2249/2951 branches in 47 files
+- 50.97% documented
+
+### Fixed
+
+- Run changelog coverage with the disposable release lockfile so host platform reconciliation cannot dirty a release.
+
+- Normalize release lockfiles before changelog coverage runs.
+
+- Isolate changelog coverage with the selected coverage Gemfile lockfile during release.
+
 ## [3.0.18] - 2026-08-30
 
 - TAG: [v3.0.18][3.0.18t]
@@ -3651,7 +3666,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-dev/kettle-dev/compare/v3.0.18...HEAD
+[Unreleased]: https://github.com/kettle-dev/kettle-dev/compare/v3.0.19...HEAD
+[3.0.19]: https://github.com/kettle-dev/kettle-dev/compare/v3.0.18...v3.0.19
+[3.0.19t]: https://github.com/kettle-dev/kettle-dev/releases/tag/v3.0.19
 [3.0.18]: https://github.com/kettle-dev/kettle-dev/compare/v3.0.17...v3.0.18
 [3.0.18t]: https://github.com/kettle-dev/kettle-dev/releases/tag/v3.0.18
 [3.0.17]: https://github.com/kettle-dev/kettle-dev/compare/v3.0.16...v3.0.17

data/README.md

@@ -1048,7 +1048,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-6.390-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
+[🧮kloc-img]: https://img.shields.io/badge/KLOC-6.399-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/lib/kettle/dev/release_cli.rb

@@ -218,7 +218,7 @@ module Kettle
         @started_at = nil
         @finished_report = nil
         @changelog_generated_coverage = false
-        @release_task_lockfile_path = nil
+        @release_task_lockfile_paths = {}
       end
 
       def run
@@ -251,6 +251,11 @@ module Kettle
       attr_reader :finished_report
 
       def run_with_release_environment
+        # Changelog generation at step 0 runs the target project's test bundle
+        # to collect coverage. Normalize its canonical release lockfile before
+        # that subprocess starts; otherwise a local development PATH lock can
+        # force Bundler to resolve an invalid mixed local/released graph.
+        prepare_release_lockfiles_for_release_tasks! if release_lockfile_preflight_needed?
         run_pre_release_checks! if run_step?(0)
 
         # 1. Ensure Bundler version and record its current release in the
@@ -357,7 +362,6 @@ module Kettle
         end
 
         prepare_rubocop_lts_local_branch! if rubocop_lts_release_preflight_needed?
-        prepare_release_lockfiles_for_release_tasks! if release_lockfile_preflight_needed?
 
         # 3. bin/setup
         run_cmd!(release_setup_command) if run_step?(3)
@@ -602,7 +606,10 @@ module Kettle
       end
 
       def release_lockfile_preflight_needed?
-        (3..5).any? { |step| run_step?(step) }
+        # Step 0 invokes kettle-changelog, which runs `bundle exec kettle-test`
+        # for fresh coverage. It therefore needs the same registry-backed
+        # release lockfile as later setup, task, and documentation steps.
+        run_step?(0) || (3..5).any? { |step| run_step?(step) }
       end
 
       def prepare_rubocop_lts_local_branch!
@@ -927,6 +934,14 @@ module Kettle
         return release_child_command("bundle exec kettle-changelog") unless gemfile
 
         environment = {"BUNDLE_GEMFILE" => gemfile}
+        coverage_gemfile = changelog_coverage_gemfile
+        environment["K_CHANGELOG_COVERAGE_GEMFILE"] = coverage_gemfile if coverage_gemfile
+        # Changelog coverage runs the target project's bundle. Give that nested
+        # invocation a disposable lockfile for its selected coverage Gemfile so
+        # Bundler's host-platform reconciliation cannot dirty the prep commit.
+        if (lockfile = release_task_lockfile_path(gemfile: coverage_gemfile || File.join(@root, "Gemfile")))
+          environment["KETTLE_CHANGELOG_COVERAGE_LOCKFILE"] = lockfile
+        end
         if (local_root = release_changelog_local_root)
           environment["KETTLE_CHANGELOG_DEV_ROOT"] = local_root
         end
@@ -960,6 +975,18 @@ module Kettle
         File.expand_path(local_root)
       end
 
+      # A generated coverage appraisal is intentionally smaller than the root
+      # development bundle and therefore avoids release-only tool dependency
+      # conflicts. Let kettle-changelog retain the root-Gemfile fallback when
+      # a project has not generated this optional bundle.
+      def changelog_coverage_gemfile
+        configured = ENV["K_CHANGELOG_COVERAGE_GEMFILE"].to_s.strip
+        return File.expand_path(configured, @root) unless configured.empty?
+
+        generated = File.join(@root, "gemfiles", "coverage.gemfile")
+        generated if File.file?(generated)
+      end
+
       # Monorepo subprojects commonly disable their local hard coverage gate
       # because their narrow test suite cannot satisfy the aggregate root
       # thresholds. Preserve an explicit changelog policy, otherwise derive
@@ -1036,26 +1063,26 @@ module Kettle
       # bundler/gem_tasks' release:guard_clean check. Keep that reconciliation
       # in a disposable lockfile so the committed, normalized lockfile remains
       # unchanged throughout build and publication.
-      def release_task_lockfile_path
-        return @release_task_lockfile_path if @release_task_lockfile_path
+      def release_task_lockfile_path(gemfile: File.join(@root, "Gemfile"))
+        return @release_task_lockfile_paths[gemfile] if @release_task_lockfile_paths.key?(gemfile)
 
-        source = File.join(@root, "Gemfile.lock")
+        source = "#{gemfile}.lock"
         return unless File.file?(source)
 
         directory = File.join(@root, "tmp", "kettle-release", "lockfiles")
         FileUtils.mkdir_p(directory)
-        @release_task_lockfile_path = File.join(directory, "Gemfile-#{$$}.lock")
-        FileUtils.cp(source, @release_task_lockfile_path)
-        @release_task_lockfile_path
+        path = File.join(directory, "#{File.basename(gemfile)}-#{$$}.lock")
+        FileUtils.cp(source, path)
+        @release_task_lockfile_paths[gemfile] = path
       rescue SystemCallError => error
         abort("Unable to isolate the release task lockfile: #{error.message}")
       end
 
       def cleanup_release_task_lockfile!
-        return unless @release_task_lockfile_path
+        return if @release_task_lockfile_paths.empty?
 
-        FileUtils.rm_f(@release_task_lockfile_path)
-        @release_task_lockfile_path = nil
+        @release_task_lockfile_paths.each_value { |path| FileUtils.rm_f(path) }
+        @release_task_lockfile_paths.clear
       end
 
       def confirm_yes!(message, prompt, abort_message)

data/lib/kettle/dev/version.rb

@@ -5,7 +5,7 @@ module Kettle
     # Version namespace for this gem.
     module Version
       # Current gem version.
-      VERSION = "3.0.18"
+      VERSION = "3.0.19"
     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-dev
 version: !ruby/object:Gem::Version
-  version: 3.0.18
+  version: 3.0.19
 platform: ruby
 authors:
 - Peter H. Boling
@@ -400,10 +400,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/v3.0.18
-  changelog_uri: https://github.com/kettle-dev/kettle-dev/blob/v3.0.18/CHANGELOG.md
+  source_code_uri: https://github.com/kettle-dev/kettle-dev/tree/v3.0.19
+  changelog_uri: https://github.com/kettle-dev/kettle-dev/blob/v3.0.19/CHANGELOG.md
   bug_tracker_uri: https://github.com/kettle-dev/kettle-dev/issues
-  documentation_uri: https://www.rubydoc.info/gems/kettle-dev/3.0.18
+  documentation_uri: https://www.rubydoc.info/gems/kettle-dev/3.0.19
   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