kettle-changelog 1.0.6 → 1.0.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 91116b5db1a2ec7a70b8bb798aae0e19222ee9eded29fc26b8bdf80e0efd0d0d
-  data.tar.gz: f1dd9b8ff5dc27c2393a87f4fa74c2323910248fe8765755a2a47ca74aabe105
+  metadata.gz: 954993bd18dd105416e4030d44c81ae52514d3354ac795e6e4033fb04bc4da29
+  data.tar.gz: afdda2a8c30bf4416a53a6c0663f661e694f4dbb355dbbbcb04ed2d6d7c92949
 SHA512:
-  metadata.gz: 383cbcaed4483a26f407bb7f9b433cddb77799f8f6c91b7f241e07c893f8ef41c2982ba071694d5197017bac689eb7c2b7afd82d6feb0d0384cdc565be37c9bf
-  data.tar.gz: 2b3233ceb38ae67fd12e82d03fa56590f028b5738aa5ebaaf731e6e6a071f5cc849c3ad1843535305184122cfa3478a7ca5d398312e02d726a890b78a740d9a1
+  metadata.gz: 9e14f5a627c219d4b8bbe6588358f63703b3bd4a3c740a92f7dda8f58bfcd717bbff7d5045bcf06732518af663db4dadc9966e306f8f64783127fc45f36b40cd
+  data.tar.gz: 56a72538485c91e0e0f744e4438d4954cf437c12bcfc7e9d2a0de0e20bd55ce703edea21b77694c7498f039728b2648545f590cb8608f141cca88413826f3740

data/CHANGELOG.md

@@ -30,6 +30,51 @@ Please file a bug if you notice a violation of semantic versioning.
 
 ### Security
 
+## [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]
+- COVERAGE: 94.35% -- 1136/1204 lines in 6 files
+- BRANCH COVERAGE: 77.73% -- 398/512 branches in 6 files
+- 38.89% documented
+
+### Fixed
+
+- Honor the release-provided disposable lockfile when generating strict changelog coverage.
+
+- Use generated coverage bundles for changelog coverage when available, with explicit bundle selection overrides.
+
 ## [1.0.6] - 2026-08-29
 
 - TAG: [v1.0.6][1.0.6t]
@@ -192,7 +237,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.6...HEAD
+[Unreleased]: https://github.com/kettle-dev/kettle-changelog/compare/v1.0.8...HEAD
+[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
 [1.0.6t]: https://github.com/kettle-dev/kettle-changelog/releases/tag/v1.0.6
 [1.0.5]: https://github.com/kettle-dev/kettle-changelog/compare/v1.0.4...v1.0.5

data/README.md

@@ -123,6 +123,7 @@ gem install kettle-changelog
 
 - `K_CHANGELOG_PATH` selects a changelog outside the current project root.
 - `K_CHANGELOG_COVERAGE_ROOT` selects the project root used for coverage generation.
+- `K_CHANGELOG_COVERAGE_GEMFILE` selects the target-project Gemfile used for coverage generation. It is resolved relative to the coverage root; absent an explicit setting, `gemfiles/coverage.gemfile` is preferred when generated by Appraisal, then the root `Gemfile` is used.
 - `K_CHANGELOG_VERSION_FILE` selects the version file when the project has more than one version tree.
 - `K_CHANGELOG_GEM_NAME` overrides the gem name used for release lookups.
 - `K_CHANGELOG_STRICT=false` allows missing coverage or YARD data.
@@ -137,6 +138,10 @@ Run the release preparation command from the gem root:
 bundle exec kettle-changelog
 ```
 
+Use `--coverage-gemfile PATH` to select a different target-project coverage
+bundle for one invocation. This is intentionally separate from `BUNDLE_GEMFILE`,
+which may be required to run `kettle-changelog` itself from a release bundle.
+
 Use `--yes` for non-interactive release automation. Add a note without preparing a release with:
 
 ```console
@@ -397,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.187-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
+[🧮kloc-img]: https://img.shields.io/badge/KLOC-1.207-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/exe/kettle-changelog

@@ -63,7 +63,7 @@ end
 
 if ARGV.include?("-h") || ARGV.include?("--help")
   puts <<~USAGE
-    Usage: kettle-changelog [--version VERSION] [--yes] [--update-prep|--reformat|--backfill-released-version VERSION] [--pending-release] [--release-state] [--refresh-cache] [--add-unreleased-entry --section SECTION --entry TEXT] [--upsert-unreleased-entry --section SECTION --key KEY --entry TEXT] [--json|--events[=TYPES]] [--no-strict] [--no-coverage-threshold]
+    Usage: kettle-changelog [--version VERSION] [--yes] [--coverage-gemfile PATH] [--update-prep|--reformat|--backfill-released-version VERSION] [--pending-release] [--release-state] [--refresh-cache] [--add-unreleased-entry --section SECTION --entry TEXT] [--upsert-unreleased-entry --section SECTION --key KEY --entry TEXT] [--json|--events[=TYPES]] [--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:
@@ -93,12 +93,14 @@ if ARGV.include?("-h") || ARGV.include?("--help")
       --events[=TYPES]          Print newline-delimited JSON changelog events
       --no-strict               Allow missing coverage and yard data (warnings only, no errors)
       --no-coverage-threshold   Generate coverage without hard-failing below configured thresholds
+      --coverage-gemfile PATH   Run coverage through this target-project Gemfile
 
     Environment:
       K_CHANGELOG_STRICT=false              Disable strict mode (equivalent to --no-strict flag)
       K_CHANGELOG_COVERAGE_HARD=false       Disable coverage threshold hard-failure
       K_CHANGELOG_PATH=path                 Read and write this changelog instead of ./CHANGELOG.md
       K_CHANGELOG_COVERAGE_ROOT=path        Run/read coverage from this root instead of the gem root
+      K_CHANGELOG_COVERAGE_GEMFILE=path     Target-project Gemfile for coverage; defaults to gemfiles/coverage.gemfile, then Gemfile
       K_CHANGELOG_VERSION_FILE=path         Read VERSION from this file instead of lib/**/version.rb
       K_CHANGELOG_GEM_NAME=name             Read live release data as this gem instead of root .gemspec
       KETTLE_GEM_COOP_REFRESH=true          Bypass cached gem.coop version data
@@ -206,6 +208,7 @@ begin
   end
 
   historical_backfill_version = extract_option_arg!(ARGV, "--backfill-released-version")
+  coverage_gemfile = extract_option_arg!(ARGV, "--coverage-gemfile")
 
   if upsert_unreleased_entry
     section = extract_option_arg!(ARGV, "--section")
@@ -240,7 +243,7 @@ begin
   end
 
   event_stream = events_output ? Kettle::Ndjson.event_stream($stdout, types: event_types) : nil
-  cli = Kettle::Changelog::CLI.new(strict: strict_mode, enforce_coverage_thresholds: coverage_hard, update_prep: update_prep, reformat_only: reformat_only, historical_backfill_version: historical_backfill_version, version: version_override, refresh_cache: refresh_cache, yes: yes, event_stream: event_stream)
+  cli = Kettle::Changelog::CLI.new(strict: strict_mode, enforce_coverage_thresholds: coverage_hard, update_prep: update_prep, reformat_only: reformat_only, historical_backfill_version: historical_backfill_version, version: version_override, refresh_cache: refresh_cache, yes: yes, event_stream: event_stream, coverage_gemfile: coverage_gemfile)
   if release_state_query
     state = cli.release_state
     puts(json_output ? JSON.pretty_generate(state) : cli.release_state_table(state))

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
@@ -35,10 +36,11 @@ module Kettle
       # @param historical_backfill_version [String, nil] tagged release to document without moving Unreleased entries
       # @param version [String, nil] explicit version override for gems without a literal VERSION constant
       # @param yes [Boolean] when true, approve the selected release plan without prompting
-      def initialize(strict: true, enforce_coverage_thresholds: true, update_prep: false, reformat_only: false, historical_backfill_version: nil, version: nil, root: Kettle::Dev::CIHelpers.project_root, refresh_cache: false, yes: false, event_stream: nil)
+      def initialize(strict: true, enforce_coverage_thresholds: true, update_prep: false, reformat_only: false, historical_backfill_version: nil, version: nil, root: Kettle::Dev::CIHelpers.project_root, refresh_cache: false, yes: false, event_stream: nil, coverage_gemfile: nil)
         @root = root
         @changelog_path = resolved_changelog_path
         @coverage_root = resolved_coverage_root
+        @coverage_gemfile = resolved_coverage_gemfile(coverage_gemfile)
         @coverage_path = File.join(@coverage_root, "coverage", "coverage.json")
         @strict = strict
         @enforce_coverage_thresholds = enforce_coverage_thresholds
@@ -939,11 +941,42 @@ module Kettle
           env[key] = nil
         end
         env.merge!(changelog_coverage_workflow_thresholds)
-        gemfile = File.join(@coverage_root, "Gemfile")
-        env["BUNDLE_GEMFILE"] = gemfile if File.file?(gemfile)
+        env["BUNDLE_GEMFILE"] = @coverage_gemfile if @coverage_gemfile
+        coverage_lockfile = ENV.fetch("KETTLE_CHANGELOG_COVERAGE_LOCKFILE", "").to_s.strip
+        unless coverage_lockfile.empty?
+          raise "Configured changelog coverage lockfile does not exist: #{coverage_lockfile}" unless File.file?(coverage_lockfile)
+
+          env["BUNDLE_LOCKFILE"] = coverage_lockfile
+        end
+        # This is a release-tool handoff, not target-project configuration.
+        env["KETTLE_CHANGELOG_COVERAGE_LOCKFILE"] = nil
         env
       end
 
+      # Coverage has a deliberately smaller bundle than the project's normal
+      # development bundle when Appraisal generated gemfiles/coverage.gemfile.
+      # Keep the explicit setting separate from BUNDLE_GEMFILE: that variable
+      # commonly belongs to the outer kettle-changelog release bundle.
+      def resolved_coverage_gemfile(explicit_gemfile)
+        requested = explicit_gemfile.to_s.strip
+        requested = ENV.fetch("K_CHANGELOG_COVERAGE_GEMFILE", "").to_s.strip if requested.empty?
+
+        unless requested.empty?
+          path = File.expand_path(requested, @coverage_root)
+          raise "Configured changelog coverage Gemfile does not exist: #{path}" unless File.file?(path)
+
+          return path
+        end
+
+        generated = File.join(@coverage_root, "gemfiles", "coverage.gemfile")
+        return generated if File.file?(generated)
+
+        root_gemfile = File.join(@coverage_root, "Gemfile")
+        return root_gemfile if File.file?(root_gemfile)
+
+        nil
+      end
+
       # The changelog coverage run is the final local test gate before a
       # release commit is pushed. Reuse the checked-in CI workflow thresholds
       # rather than silently falling back to kettle-soup-cover defaults.
@@ -990,7 +1023,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))
@@ -1047,9 +1080,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
@@ -1060,9 +1095,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.6"
+      VERSION = "1.0.8"
     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.6
+  version: 1.0.8
 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.17
-    - - "<"
+        version: '3.1'
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 4.0.0
+        version: 3.1.2
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 3.0.17
-    - - "<"
+        version: '3.1'
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 4.0.0
+        version: 3.1.2
 - !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.4
   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.4
 - !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.23
   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.23
 - !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.12
   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.12
 - !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.13
   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.13
 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.6
-  changelog_uri: https://github.com/kettle-dev/kettle-changelog/blob/v1.0.6/CHANGELOG.md
+  source_code_uri: https://github.com/kettle-dev/kettle-changelog/tree/v1.0.8
+  changelog_uri: https://github.com/kettle-dev/kettle-changelog/blob/v1.0.8/CHANGELOG.md
   bug_tracker_uri: https://github.com/kettle-dev/kettle-changelog/issues
-  documentation_uri: https://www.rubydoc.info/gems/kettle-changelog/1.0.6
+  documentation_uri: https://www.rubydoc.info/gems/kettle-changelog/1.0.8
   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: []