kettle-dev 2.2.18 → 2.2.20

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9f361805b0355ac14c6b5a3f5d2555feb722b8c640a2550f46d2a8f7ab0c80c6
-  data.tar.gz: a39ee59b4404715e976240bca10e818f9b2b85e88575bac566ba02cd1116c4c9
+  metadata.gz: 22a0bb59de4bca05c100302f2050a300c2a60a90a2124f2f5aa07c215c6b6919
+  data.tar.gz: 6b314236d27b59baa482317413c5b5c95303b9530b33693ee03841491ed00bc6
 SHA512:
-  metadata.gz: af5802350e819dcf37618a8cc3eac5c1ee98ad1e8f14f3e724ac1083875746139565ee34ccd697d6dd5c8950d2bf17e58b4b98416014a190cde2e62bd316df09
-  data.tar.gz: 7407dd36a674f8271b645e2bb97c3b84a15461cd14010e870f1036a53ebfb8ba00d959a341694c43ae1d8cf884d97d1a758815080f90fc4e65aebc46579668a2
+  metadata.gz: 1f8a2d831b26d101a1ea8e381ff3cfc7bbce6d88682e70ec43c22a37b3ba047da5376247b5f32b1184f088514da8a1377f54ffcbe4def383b249515c70c3c518
+  data.tar.gz: 1aa2b1ceb5886238f9034491256e3c7fbdd5cbba121c27393288bced653f92051e43fec7f242a35b4cab7e316731e422a46c73c054548c96ee4b1537c6b371ac

data/CHANGELOG.md

@@ -30,6 +30,48 @@ Please file a bug if you notice a violation of semantic versioning.
 
 ### Security
 
+## [2.2.20] - 2026-06-27
+
+- TAG: [v2.2.20][2.2.20t]
+- COVERAGE: 91.82% -- 4131/4499 lines in 33 files
+- BRANCH COVERAGE: 72.73% -- 1632/2244 branches in 33 files
+- 61.04% documented
+
+### Added
+
+- `kettle-release` now accepts `skip_steps=...` / `--skip-steps ...` to skip
+  selected numbered release steps while running the rest of the release flow.
+
+### Fixed
+
+- `kettle-release` now suppresses inherited Bundler/debug verbosity when running
+  release child commands and Appraisal bundle installs.
+
+- `kettle-release` now switches a local `RUBOCOP_LTS_LOCAL` checkout to the
+  branch matching the project's selected `rubocop-rubyN_N` style gem before
+  running setup and default rake tasks.
+
+- Restored Ruby 2.4 parser compatibility for recent release and CI helper code.
+
+### Changed
+
+- `kettle-release` now reads RuboCop LTS branch selection from
+  `Kettle::Rb::CompatMatrix`.
+
+## [2.2.19] - 2026-06-26
+
+- TAG: [v2.2.19][2.2.19t]
+- COVERAGE: 91.75% -- 4082/4449 lines in 33 files
+- BRANCH COVERAGE: 72.94% -- 1615/2214 branches in 33 files
+- 61.84% documented
+
+### Changed
+
+- `kettle-release` now runs `bin/rake appraisal:generate` by default when
+  `Appraisals` is present; use `--appraisal-update` or
+  `KETTLE_RELEASE_APPRAISAL_TASK=appraisal:update` for the slower lock-resolving
+  update path.
+
 ## [2.2.18] - 2026-06-24
 
 - TAG: [v2.2.18][2.2.18t]
@@ -2279,7 +2321,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.18...HEAD
+[Unreleased]: https://github.com/kettle-dev/kettle-dev/compare/v2.2.20...HEAD
+[2.2.20]: https://github.com/kettle-dev/kettle-dev/compare/v2.2.19...v2.2.20
+[2.2.20t]: https://github.com/kettle-dev/kettle-dev/releases/tag/v2.2.20
+[2.2.19]: https://github.com/kettle-dev/kettle-dev/compare/v2.2.18...v2.2.19
+[2.2.19t]: https://github.com/kettle-dev/kettle-dev/releases/tag/v2.2.19
 [2.2.18]: https://github.com/kettle-dev/kettle-dev/compare/v2.2.17...v2.2.18
 [2.2.18t]: https://github.com/kettle-dev/kettle-dev/releases/tag/v2.2.18
 [2.2.17]: https://github.com/kettle-dev/kettle-dev/compare/v2.2.16...v2.2.17

data/CONTRIBUTING.md

@@ -131,9 +131,12 @@ toolchain, and it may be higher than the gemspec runtime floor.
 They are created and updated with the commands:
 
 ```console
-bin/rake appraisal:update
+bin/rake appraisal:generate
 ```
 
+Use `bin/rake appraisal:update` when you intentionally need to resolve fresh
+appraisal locks.
+
 If you need to reset all gemfiles/*.gemfile.lock files:
 
 ```console

data/README.md

@@ -874,7 +874,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.446-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
+[🧮kloc-img]: https://img.shields.io/badge/KLOC-4.499-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

@@ -52,59 +52,57 @@ rescue LoadError => e
   exit(1)
 end
 
-begin
-  if ARGV.include?("-h") || ARGV.include?("--help")
-    puts <<~USAGE
-      Usage: kettle-changelog [--version VERSION] [--update-prep] [--pending-release] [--release-state] [--add-unreleased-entry --section SECTION --entry TEXT] [--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:
-      create a new release section, update the prepared release section in place, or reformat only.
-
-      Release plans add coverage and documentation stats, move entries from [Unreleased],
-      and update bottom link references to GitHub style.
-
-      Options:
-        --version VERSION         Use this version instead of detecting VERSION from lib/**/version.rb
-        --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
-        --add-unreleased-entry    Add one entry to an existing section under ## [Unreleased]
-        --section SECTION         Unreleased section to receive the entry (Added, Changed, Deprecated, Removed, Fixed, Security)
-        --entry TEXT              Changelog entry text; "- " is added when omitted
-        --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
-
-      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_VERSION_FILE=path         Read VERSION from this file instead of lib/**/version.rb
-
-      Data generation:
-        Strict mode is the default. Release plans remove stale coverage output,
-        run bundle exec kettle-test with JSON coverage enabled, read the resulting
-        coverage/coverage.json, and collect documentation stats from bin/rake yard
-        or bin/yard.
-
-        Strict mode fails if specs fail, coverage JSON is not produced, coverage
-        is below the configured project thresholds, or documentation stats cannot
-        be collected.
-
-        Non-strict mode does not generate missing coverage or documentation data;
-        it warns and leaves unavailable stats blank.
-
-      Runtime requirements:
-        - bundle exec kettle-test available for strict coverage generation
-        - bin/rake yard or bin/yard available for strict documentation stats
-
-      Use --no-strict or K_CHANGELOG_STRICT=false to allow missing data.
-      Use --no-coverage-threshold or K_CHANGELOG_COVERAGE_HARD=false to run fresh
-      coverage without hard-failing below configured thresholds.
-    USAGE
-    exit(0)
-  end
+if ARGV.include?("-h") || ARGV.include?("--help")
+  puts <<~USAGE
+    Usage: kettle-changelog [--version VERSION] [--update-prep] [--pending-release] [--release-state] [--add-unreleased-entry --section SECTION --entry TEXT] [--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:
+    create a new release section, update the prepared release section in place, or reformat only.
+
+    Release plans add coverage and documentation stats, move entries from [Unreleased],
+    and update bottom link references to GitHub style.
+
+    Options:
+      --version VERSION         Use this version instead of detecting VERSION from lib/**/version.rb
+      --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
+      --add-unreleased-entry    Add one entry to an existing section under ## [Unreleased]
+      --section SECTION         Unreleased section to receive the entry (Added, Changed, Deprecated, Removed, Fixed, Security)
+      --entry TEXT              Changelog entry text; "- " is added when omitted
+      --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
+
+    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_VERSION_FILE=path         Read VERSION from this file instead of lib/**/version.rb
+
+    Data generation:
+      Strict mode is the default. Release plans remove stale coverage output,
+      run bundle exec kettle-test with JSON coverage enabled, read the resulting
+      coverage/coverage.json, and collect documentation stats from bin/rake yard
+      or bin/yard.
+
+      Strict mode fails if specs fail, coverage JSON is not produced, coverage
+      is below the configured project thresholds, or documentation stats cannot
+      be collected.
+
+      Non-strict mode does not generate missing coverage or documentation data;
+      it warns and leaves unavailable stats blank.
+
+    Runtime requirements:
+      - bundle exec kettle-test available for strict coverage generation
+      - bin/rake yard or bin/yard available for strict documentation stats
+
+    Use --no-strict or K_CHANGELOG_STRICT=false to allow missing data.
+    Use --no-coverage-threshold or K_CHANGELOG_COVERAGE_HARD=false to run fresh
+    coverage without hard-failing below configured thresholds.
+  USAGE
+  exit(0)
 end
 
 begin

data/exe/kettle-release

@@ -43,7 +43,7 @@ end
 # Do not guard with __FILE__ == $PROGRAM_NAME because binstubs use Kernel.load.
 if ARGV.include?("-h") || ARGV.include?("--help")
   puts <<~USAGE
-    Usage: kettle-release [--version VERSION] [--local-ci] [start_step=<0-19>]
+    Usage: kettle-release [--version VERSION] [--local-ci] [--appraisal-update] [--skip-steps STEPS] [start_step=<0-19>]
 
     Automates the release flow for a Ruby gem in the host project.
 
@@ -58,7 +58,7 @@ if ARGV.include?("-h") || ARGV.include?("--help")
       2. Detect version; RubyGems sanity check; confirm CHANGELOG/version; sync copyright years; update badges/headers
       3. Run bin/setup
       4. Run bin/rake (default task)
-      5. Run bin/rake appraisal:update if Appraisals present
+      5. Run bin/rake appraisal:generate if Appraisals present
       6. Ensure git user configured; commit release prep
       7. Optional local CI with `act` (controlled by K_RELEASE_LOCAL_CI)
       8. Ensure trunk in sync across remotes; rebase feature as needed
@@ -76,7 +76,10 @@ if ARGV.include?("-h") || ARGV.include?("--help")
 
     Options:
       start_step=<number>         # Begin at the numbered step above (e.g., 10 to resume at CI monitoring)
+      skip_steps=<numbers>        # Comma-separated numbered steps to skip while running the rest
+      --skip-steps NUMBERS        # Alias for skip_steps=NUMBERS (e.g., --skip-steps 10 or --skip-steps 10,18)
       --version VERSION           # Use this version instead of detecting VERSION from lib/**/version.rb
+      --appraisal-update          # Use slower appraisal:update instead of default appraisal:generate
       --local-ci                  # Sensitive release mode: run act locally, publish before any git push,
                                   # create the git tag locally, then push commits and tags after publish
 
@@ -85,6 +88,8 @@ if ARGV.include?("-h") || ARGV.include?("--help")
       GEM_CERT_USER=<user>        # Select certs/<user>.pem for signing
       K_RELEASE_LOCAL_CI=ask|1|0  # Use 'act' locally before push; 'ask' prompts, '1' forces, default off
       K_RELEASE_LOCAL_CI_WORKFLOW # Name of workflow (without .yml) for local CI; defaults to locked_deps or first
+      KETTLE_RELEASE_APPRAISAL_TASK=appraisal:update
+                                  # Use slower appraisal:update instead of default appraisal:generate
       GITHUB_TOKEN / GH_TOKEN     # Optional; enables GitHub release creation and API queries
       GITLAB_TOKEN / GL_TOKEN     # Optional; enables GitLab API queries when applicable
       DEBUG=true                  # Print backtraces on errors
@@ -94,12 +99,13 @@ if ARGV.include?("-h") || ARGV.include?("--help")
       kettle-release --local-ci            # run local act CI, publish gem, then push commits/tags
       kettle-release start_step=1          # skip pre-release checks and start numbered release steps
       kettle-release start_step=10         # resume by monitoring CI for the current branch
+      kettle-release skip_steps=10         # run the release but skip remote CI monitoring
       SKIP_GEM_SIGNING=true kettle-release start_step=14  # build+release without signing
   USAGE
   exit 0
 end
 
-# Parse start_step=<n> from ARGV
+# Parse release options from ARGV
 def extract_version_arg!(argv)
   version = nil
   if (idx = argv.index("--version"))
@@ -118,13 +124,33 @@ def extract_version_arg!(argv)
   Kettle::Dev::Versioning.normalize_explicit_version(version)
 end
 
+def extract_skip_steps_arg!(argv)
+  skip_steps = nil
+  if (idx = argv.index("--skip-steps"))
+    skip_steps = argv[idx + 1]
+    Kettle::Dev::ExitAdapter.abort("--skip-steps requires a comma-separated step list") if skip_steps.to_s.empty?
+    argv.slice!(idx, 2)
+  end
+  argv.delete_if do |arg|
+    if arg.start_with?("--skip-steps=", "skip_steps=")
+      skip_steps = arg.split("=", 2)[1]
+      true
+    else
+      false
+    end
+  end
+  skip_steps
+end
+
 local_ci = ARGV.include?("--local-ci")
+appraisal_task = ARGV.delete("--appraisal-update") ? "appraisal:update" : nil
 start_step_arg = ARGV.find { |a| a.start_with?("start_step=") }
 start_step = start_step_arg ? start_step_arg.split("=", 2)[1].to_i : 0
 version_override = extract_version_arg!(ARGV)
+skip_steps = extract_skip_steps_arg!(ARGV)
 
 begin
-  Kettle::Dev::ReleaseCLI.new(start_step: start_step, local_ci: local_ci, version: version_override).run
+  Kettle::Dev::ReleaseCLI.new(start_step: start_step, local_ci: local_ci, version: version_override, appraisal_task: appraisal_task, skip_steps: skip_steps).run
 rescue LoadError => e
   warn("#{script_basename}: could not load dependency: #{e.class}: #{e.message}")
   warn(Array(e.backtrace).join("\n")) if ENV["DEBUG"]

data/lib/kettle/dev/ci_monitor.rb

@@ -297,13 +297,13 @@ module Kettle
         end
         # Small initial delay to allow GitHub to register the newly pushed commit and enqueue workflows.
         # Configurable via K_RELEASE_CI_INITIAL_SLEEP (seconds); defaults to 3s.
-        begin
-          initial_sleep = begin
-            Integer(ENV["K_RELEASE_CI_INITIAL_SLEEP"])
-          rescue
-            nil
-          end
+
+        initial_sleep = begin
+          Integer(ENV["K_RELEASE_CI_INITIAL_SLEEP"])
+        rescue
+          nil
         end
+
         sleep((initial_sleep && initial_sleep >= 0) ? initial_sleep : 3)
         start_timeout = github_start_timeout
         poll_interval = github_poll_interval

data/lib/kettle/dev/gha_sha_pins_cli.rb

@@ -6,7 +6,6 @@ require "net/http"
 require "open3"
 require "optparse"
 require "pathname"
-require "set"
 require "time"
 require "uri"
 

data/lib/kettle/dev/git_adapter.rb

@@ -53,26 +53,24 @@ module Kettle
       # Create a new adapter rooted at the current working directory.
       # @return [void]
       def initialize
-        begin
-          # Allow users/CI to opt out of using the 'git' gem even when available.
-          # Set KETTLE_DEV_DISABLE_GIT_GEM to a truthy value ("1", "true", "yes") to force CLI backend.
-          env_val = ENV["KETTLE_DEV_DISABLE_GIT_GEM"]
-          # Ruby 2.3 compatibility: String#match? was added in 2.4; use Regexp#=== / =~ instead
-          disable_gem = env_val && !!(/\A(1|true|yes)\z/i =~ env_val)
-          if disable_gem
-            @backend = :cli
-          else
-            Kernel.require "git"
-            @backend = :gem
-            @git = ::Git.open(Dir.pwd)
-          end
-        rescue LoadError => e
-          Kettle::Dev.debug_error(e, __method__, backtrace: false)
-          # Optional dependency: fall back to CLI
+        # Allow users/CI to opt out of using the 'git' gem even when available.
+        # Set KETTLE_DEV_DISABLE_GIT_GEM to a truthy value ("1", "true", "yes") to force CLI backend.
+        env_val = ENV["KETTLE_DEV_DISABLE_GIT_GEM"]
+        # Ruby 2.3 compatibility: String#match? was added in 2.4; use Regexp#=== / =~ instead
+        disable_gem = env_val && !!(/\A(1|true|yes)\z/i =~ env_val)
+        if disable_gem
           @backend = :cli
-        rescue => e
-          raise Kettle::Dev::Error, "Failed to open git repository: #{e.message}"
+        else
+          Kernel.require "git"
+          @backend = :gem
+          @git = ::Git.open(Dir.pwd)
         end
+      rescue LoadError => e
+        Kettle::Dev.debug_error(e, __method__, backtrace: false)
+        # Optional dependency: fall back to CLI
+        @backend = :cli
+      rescue => e
+        raise Kettle::Dev::Error, "Failed to open git repository: #{e.message}"
       end
 
       # Push a branch to a remote.

data/lib/kettle/dev/git_commit_footer.rb

@@ -5,7 +5,7 @@ module Kettle
     class GitCommitFooter
       # Regex to extract `name = "value"` assignments from a gemspec.
       # @return [Regexp]
-      NAME_ASSIGNMENT_REGEX = /\bname\s*=\s*(["'])([^"']+)\1/.freeze
+      NAME_ASSIGNMENT_REGEX = /\bname\s*=\s*(["'])([^"']+)\1/
 
       # Whether footer appending is enabled (via GIT_HOOK_FOOTER_APPEND=true)
       # @return [Boolean]

data/lib/kettle/dev/open_collective_config.rb

@@ -44,14 +44,14 @@ module Kettle
 
         ypath = yaml_path(root)
         if strict
-          yml = YAML.safe_load(File.read(ypath))
+          yml = YAML.safe_load_file(ypath)
           if yml.is_a?(Hash)
             handle = yml["collective"] || yml[:collective] || yml["org"] || yml[:org]
             return handle.to_s unless handle.nil? || handle.to_s.strip.empty? || handle.to_s.match?(/\{KJ\|[^}]+}/)
           end
         elsif File.file?(ypath)
           begin
-            yml = YAML.safe_load(File.read(ypath))
+            yml = YAML.safe_load_file(ypath)
             if yml.is_a?(Hash)
               handle = yml["collective"] || yml[:collective] || yml["org"] || yml[:org]
               return handle.to_s unless handle.nil? || handle.to_s.strip.empty? || handle.to_s.match?(/\{KJ\|[^}]+}/)

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

@@ -5,7 +5,27 @@ begin
   require "appraisal/task"
 
   bundle = "bundle"
-  appraisal_env = {"BUNDLE_GEMFILE" => "Appraisal.root.gemfile"}
+  quiet_env = {
+    "KETTLE_JEM_QUIET" => "true",
+    "KETTLE_JEM_DEBUG" => "false",
+    "KETTLE_DEV_DEBUG" => "false",
+    "SMORG_RB_DEBUG" => "false",
+    "DEBUG" => nil,
+    "BUNDLE_QUIET" => "true",
+    "BUNDLE_DEBUG" => "false",
+    "BUNDLER_DEBUG" => "false",
+    "BUNDLE_VERBOSE" => "false",
+    "DEBUG_RESOLVER" => nil,
+    "DEBUG_RESOLVER_TREE" => nil,
+    "BUNDLER_DEBUG_RESOLVER" => nil,
+    "BUNDLER_DEBUG_RESOLVER_TREE" => nil,
+    "DEBUG_COMPACT_INDEX" => nil,
+    "MOLINILLO_DEBUG" => nil,
+    "BUNDLE_SILENCE_DEPRECATIONS" => "true",
+    "BUNDLE_SILENCE_ROOT_WARNING" => "true",
+    "BUNDLE_SUPPRESS_INSTALL_USING_MESSAGES" => "true"
+  }
+  appraisal_env = quiet_env.merge("BUNDLE_GEMFILE" => "Appraisal.root.gemfile")
 
   run_command = lambda do |failure_message, *args|
     ok = system(*args)
@@ -18,7 +38,8 @@ begin
       "appraisal:generate failed: BUNDLE_GEMFILE=Appraisal.root.gemfile bundle install",
       appraisal_env,
       bundle,
-      "install"
+      "install",
+      "--quiet"
     )
 
     # 2) BUNDLE_GEMFILE=Appraisal.root.gemfile bundle exec appraisal generate
@@ -60,7 +81,8 @@ begin
             "appraisal:install failed: BUNDLE_GEMFILE=Appraisal.root.gemfile bundle install",
             appraisal_env,
             bundle,
-            "install"
+            "install",
+            "--quiet"
           )
 
           # 2) BUNDLE_GEMFILE=Appraisal.root.gemfile bundle exec appraisal generate-install
@@ -107,7 +129,8 @@ begin
             "appraisal:update failed: BUNDLE_GEMFILE=Appraisal.root.gemfile bundle install",
             appraisal_env,
             bundle,
-            "install"
+            "install",
+            "--quiet"
           )
 
           # 2) BUNDLE_GEMFILE=Appraisal.root.gemfile bundle update --bundler
@@ -124,7 +147,8 @@ begin
             "appraisal:update failed: BUNDLE_GEMFILE=Appraisal.root.gemfile bundle install",
             appraisal_env,
             bundle,
-            "install"
+            "install",
+            "--quiet"
           )
 
           # 4) BUNDLE_GEMFILE=Appraisal.root.gemfile bundle exec appraisal generate-update

data/lib/kettle/dev/readme_backers.rb

@@ -5,7 +5,6 @@ require "yaml"
 require "json"
 require "uri"
 require "net/http"
-require "set"
 
 module Kettle
   module Dev
@@ -244,7 +243,7 @@ module Kettle
 
         if File.file?(OC_YML_PATH)
           begin
-            yml = YAML.safe_load(File.read(OC_YML_PATH))
+            yml = YAML.safe_load_file(OC_YML_PATH)
             if yml.is_a?(Hash)
               from_yml = yml["readme-osc-tag"] || yml[:"readme-osc-tag"]
               from_yml = from_yml.to_s if from_yml
@@ -660,7 +659,7 @@ module Kettle
 
         if File.file?(OC_YML_PATH)
           begin
-            yml = YAML.safe_load(File.read(OC_YML_PATH))
+            yml = YAML.safe_load_file(OC_YML_PATH)
             if yml.is_a?(Hash)
               from_yml = yml["readme-backers-commit-subject"] || yml[:"readme-backers-commit-subject"]
               from_yml = from_yml.to_s if from_yml

data/lib/kettle/dev/release_cli.rb

@@ -11,11 +11,33 @@ require "json"
 require "uri"
 
 # External gems
+require "kettle/rb/compat_matrix"
 require "ruby-progressbar"
 
 module Kettle
   module Dev
     class ReleaseCLI
+      QUIET_ENV = {
+        "KETTLE_JEM_QUIET" => "true",
+        "KETTLE_JEM_DEBUG" => "false",
+        "KETTLE_DEV_DEBUG" => "false",
+        "SMORG_RB_DEBUG" => "false",
+        "DEBUG" => nil,
+        "BUNDLE_QUIET" => "true",
+        "BUNDLE_DEBUG" => "false",
+        "BUNDLER_DEBUG" => "false",
+        "BUNDLE_VERBOSE" => "false",
+        "DEBUG_RESOLVER" => nil,
+        "DEBUG_RESOLVER_TREE" => nil,
+        "BUNDLER_DEBUG_RESOLVER" => nil,
+        "BUNDLER_DEBUG_RESOLVER_TREE" => nil,
+        "DEBUG_COMPACT_INDEX" => nil,
+        "MOLINILLO_DEBUG" => nil,
+        "BUNDLE_SILENCE_DEPRECATIONS" => "true",
+        "BUNDLE_SILENCE_ROOT_WARNING" => "true",
+        "BUNDLE_SUPPRESS_INSTALL_USING_MESSAGES" => "true"
+      }.freeze
+      DEBUG_TRUE_VALUES = %w[1 true yes on].freeze
       class << self
         def run_cmd!(cmd)
           # For Bundler-invoked build/release, explicitly prefix SKIP_GEM_SIGNING so
@@ -26,7 +48,7 @@ module Kettle
           end
           puts "$ #{cmd}"
           # Pass a plain Hash for the environment to satisfy tests and avoid ENV object oddities
-          env_hash = ENV.respond_to?(:to_hash) ? ENV.to_hash : ENV.to_h
+          env_hash = command_env
 
           # Some commands are interactive (e.g., `bundle exec rake release` prompting for RubyGems MFA).
           # Using capture3 detaches STDIN, preventing prompts from working. For such commands, use system
@@ -62,6 +84,19 @@ module Kettle
             abort("Command failed: #{cmd} (exit #{exit_code})#{diag}")
           end
         end
+
+        private
+
+        def command_env
+          env_hash = ENV.respond_to?(:to_hash) ? ENV.to_hash : ENV.to_h
+          return env_hash if debug_env_enabled?
+
+          env_hash.merge(QUIET_ENV)
+        end
+
+        def debug_env_enabled?
+          DEBUG_TRUE_VALUES.include?(ENV.fetch("KETTLE_DEV_DEBUG", "").downcase)
+        end
       end
 
       private
@@ -72,20 +107,22 @@ module Kettle
 
       public
 
-      def initialize(start_step: 0, local_ci: false, version: nil)
+      def initialize(start_step: 0, local_ci: false, version: nil, appraisal_task: nil, skip_steps: nil)
         @root = Kettle::Dev::CIHelpers.project_root
         @git = Kettle::Dev::GitAdapter.new
         @start_step = (start_step || 0).to_i
         @start_step = 0 if @start_step < 0
+        @skip_steps = normalize_skip_steps(skip_steps)
         @local_ci = !!local_ci
         @version_override = Kettle::Dev::Versioning.normalize_explicit_version(version)
+        @appraisal_task = normalize_appraisal_task(appraisal_task || ENV["KETTLE_RELEASE_APPRAISAL_TASK"])
       end
 
       def run
-        run_pre_release_checks! if @start_step <= 0
+        run_pre_release_checks! if run_step?(0)
 
         # 1. Ensure Bundler version ✓
-        ensure_bundler_2_7_plus!
+        ensure_bundler_2_7_plus! if run_step?(1)
 
         version = nil
         committed = nil
@@ -93,7 +130,7 @@ module Kettle
         feature = nil
 
         # 2. Version detection and sanity checks + prompt
-        if @start_step <= 2
+        if run_step?(2)
           version = detect_version
           puts "Detected version: #{version.inspect}"
 
@@ -185,19 +222,21 @@ module Kettle
           end
         end
 
+        prepare_rubocop_lts_local_branch! if rubocop_lts_release_preflight_needed?
+
         # 3. bin/setup
-        run_cmd!("bin/setup") if @start_step <= 3
+        run_cmd!("bin/setup") if run_step?(3)
         # 4. bin/rake
-        run_cmd!("bin/rake") if @start_step <= 4
+        run_cmd!("bin/rake") if run_step?(4)
 
-        # 5. appraisal:update (optional) + canonical docs build
-        if @start_step <= 5
+        # 5. appraisal:generate (optional) + canonical docs build
+        if run_step?(5)
           appraisals_path = File.join(@root, "Appraisals")
           if File.file?(appraisals_path)
-            puts "Appraisals detected at #{Kettle::Dev.display_path(appraisals_path)}. Running: bin/rake appraisal:update"
-            run_cmd!("bin/rake appraisal:update")
+            puts "Appraisals detected at #{Kettle::Dev.display_path(appraisals_path)}. Running: bin/rake #{@appraisal_task}"
+            run_cmd!("bin/rake #{@appraisal_task}")
           else
-            puts "No Appraisals file found; skipping appraisal:update"
+            puts "No Appraisals file found; skipping #{@appraisal_task}"
           end
 
           puts "Generating docs site via canonical task: bin/rake yard"
@@ -205,47 +244,47 @@ module Kettle
         end
 
         # 6. git user + commit release prep
-        if @start_step <= 6
+        if run_step?(6)
           ensure_git_user!
           version ||= detect_version
           committed = commit_release_prep!(version)
         end
 
         # 7. optional local CI via act
-        maybe_run_local_ci_before_push!(committed, force: local_ci?) if @start_step <= 7
+        maybe_run_local_ci_before_push!(committed, force: local_ci?) if run_step?(7)
 
         # 8. ensure trunk synced
-        if @start_step <= 8 && !local_ci?
+        if run_step?(8) && !local_ci?
           trunk = detect_trunk_branch
           feature = current_branch
           puts "Trunk branch detected: #{trunk}"
           ensure_trunk_synced_before_push!(trunk, feature)
-        elsif @start_step <= 8
+        elsif run_step?(8)
           puts "Local CI release mode: skipping remote trunk sync before publishing."
         end
 
         # 9. push branches
-        push! if @start_step <= 9 && !local_ci?
+        push! if run_step?(9) && !local_ci?
 
         # 10. monitor CI after push
-        monitor_workflows_after_push! if @start_step <= 10 && !local_ci?
+        monitor_workflows_after_push! if run_step?(10) && !local_ci?
 
         # 11. merge feature into trunk and push
-        if @start_step <= 11 && !local_ci?
+        if run_step?(11) && !local_ci?
           trunk ||= detect_trunk_branch
           feature ||= current_branch
           merge_feature_into_trunk_and_push!(trunk, feature)
         end
 
         # 12. checkout trunk and pull
-        if @start_step <= 12 && !local_ci?
+        if run_step?(12) && !local_ci?
           trunk ||= detect_trunk_branch
           checkout!(trunk)
           pull!(trunk)
         end
 
         # 13. signing guidance and checks
-        if @start_step <= 13
+        if run_step?(13)
           if ENV.fetch("SKIP_GEM_SIGNING", "false").casecmp("false").zero?
             puts "TIP: For local dry-runs or testing the release workflow, set SKIP_GEM_SIGNING=true to avoid PEM password prompts."
             if Kettle::Dev::InputAdapter.tty?
@@ -266,13 +305,13 @@ module Kettle
         end
 
         # 14. build
-        if @start_step <= 14
+        if run_step?(14)
           puts "Running build (you may be prompted for the signing key password)..."
           run_cmd!("bundle exec rake build")
         end
 
         # 15. release and tag
-        if @start_step <= 15
+        if run_step?(15)
           if local_ci?
             version ||= detect_version
             release_gem_and_tag_locally!(version)
@@ -286,7 +325,7 @@ module Kettle
         #    Checksums are generated after release to avoid including checksums/ in gem package
         #    Rationale: Running gem_checksums before release may commit checksums/ and cause Bundler's
         #    release build to include them in the gem, thus altering the artifact, and invalidating the checksums.
-        if @start_step <= 16
+        if run_step?(16)
           # Generate checksums for the just-built artifact, commit them, then validate
           run_cmd!("bin/gem_checksums")
           version ||= detect_version
@@ -294,19 +333,19 @@ module Kettle
         end
 
         # 17. push checksum commit (gem_checksums already commits)
-        if @start_step <= 17
+        if run_step?(17)
           push!
           push_tags! if local_ci?
         end
 
         # 18. create GitHub release (optional)
-        if @start_step <= 18
+        if run_step?(18)
           version ||= detect_version
           maybe_create_github_release!(version)
         end
 
         # 19. push tags to remotes (final step)
-        push_tags! if @start_step <= 19 && !local_ci?
+        push_tags! if run_step?(19) && !local_ci?
 
         # Final success message
         begin
@@ -320,12 +359,81 @@ module Kettle
         end
       end
 
+      def normalize_appraisal_task(value)
+        task = value.to_s.strip
+        return "appraisal:generate" if task.empty?
+        return "appraisal:generate" if task == "generate" || task == "appraisal:generate"
+        return "appraisal:update" if task == "update" || task == "appraisal:update"
+
+        abort("Unsupported appraisal task #{value.inspect}; use appraisal:generate or appraisal:update.")
+      end
+
+      def normalize_skip_steps(value)
+        raw_steps = Array(value).flat_map { |part| part.to_s.split(",") }.map(&:strip).reject(&:empty?)
+        raw_steps.map do |raw|
+          abort("Invalid skip_steps value #{raw.inspect}; use comma-separated release step numbers from 0 to 19.") unless raw.match?(/\A\d+\z/)
+
+          step = raw.to_i
+          abort("Invalid skip_steps value #{raw.inspect}; release steps are numbered 0 to 19.") unless step.between?(0, 19)
+
+          step
+        end.uniq
+      end
+
       private
 
       def local_ci?
         @local_ci
       end
 
+      def run_step?(step)
+        @start_step <= step && !@skip_steps.include?(step)
+      end
+
+      def rubocop_lts_release_preflight_needed?
+        (3..5).any? { |step| run_step?(step) }
+      end
+
+      def prepare_rubocop_lts_local_branch!
+        local_root = rubocop_lts_local_root
+        return unless local_root
+
+        ruby_gem = selected_rubocop_lts_ruby_gem
+        return unless ruby_gem
+
+        branch = Kettle::Rb::CompatMatrix.rubocop_lts_branch_for_gem(ruby_gem)
+        abort("Cannot select RUBOCOP_LTS_LOCAL branch for #{ruby_gem.inspect}.") unless branch
+
+        checkout = File.join(local_root, "rubocop-lts")
+        current, ok = git_output(["-C", checkout, "branch", "--show-current"])
+        abort("Cannot inspect RUBOCOP_LTS_LOCAL checkout at #{checkout}.") unless ok
+        return if current == branch
+
+        puts "Switching RUBOCOP_LTS_LOCAL checkout #{checkout} to #{branch} for #{ruby_gem}."
+        _stdout, switched = git_output(["-C", checkout, "switch", branch])
+        abort("Cannot switch RUBOCOP_LTS_LOCAL checkout at #{checkout} to #{branch}. Commit or stash local changes, then retry.") unless switched
+      end
+
+      def rubocop_lts_local_root
+        value = ENV["RUBOCOP_LTS_LOCAL"].to_s.strip
+        return nil if value.empty? || %w[false 0 no off].include?(value.downcase)
+        return File.join(Dir.home, "src", "rubocop-lts") if %w[true 1 yes on].include?(value.downcase)
+        return value if value.start_with?("/")
+
+        File.join(Dir.home, value)
+      end
+
+      def selected_rubocop_lts_ruby_gem
+        path = File.join(@root, "gemfiles", "modular", "style_local.gemfile")
+        return nil unless File.file?(path)
+
+        content = File.read(path)
+        # This reads the generated kettle-jem style_local.gemfile declaration
+        # without evaluating the Gemfile during release preflight.
+        local_gems = content[/\blocal_gems\s*=\s*%w\[(.*?)\]/m, 1].to_s.split
+        local_gems.find { |gem_name| Kettle::Rb::CompatMatrix.rubocop_ruby_gem?(gem_name) }
+      end
+
       def run_pre_release_checks!
         puts "Running pre-release checks via kettle-pre-release..."
         Kettle::Dev::PreReleaseCLI.new(check_num: 1).run
@@ -405,7 +513,6 @@ module Kettle
       # This helps ensure docs are kept in sync when bumping the years.
       # Aborts with a helpful message when they differ.
       def validate_copyright_years!
-        require "set"
         readme = File.join(@root, "README.md")
         license = File.join(@root, "LICENSE.txt")
         unless File.file?(readme) && File.file?(license)
@@ -446,7 +553,6 @@ module Kettle
       # then parses four-digit years and year ranges like "2012-2015" (hyphen or en dash).
       # Returns Set[Integer].
       def extract_years_from_file(path)
-        require "set"
         years = Set.new
         content = File.read(path)
         # Only consider lines that look like copyright notices to reduce false positives

data/lib/kettle/dev/version.rb

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

data/lib/kettle/dev.rb

@@ -177,38 +177,34 @@ module Kettle
       # Set up rubocop-lts, which cascades to rubocop-rubyX_X => rubocop_gradual)
       # @return [void]
       def linting_tasks
-        begin
-          # Lazy loaded because it won't be installed for Ruby < 2.7
-          require "rubocop/lts"
-
-          Rubocop::Lts.install_tasks
-          if Kettle::Dev::IS_CI
-            Kettle::Dev.register_default("rubocop_gradual:check")
-          else
-            Kettle::Dev.register_default("rubocop_gradual:autocorrect")
-          end
-        rescue LoadError
-          # OK, no styles for you.
+        # Lazy loaded because it won't be installed for Ruby < 2.7
+        require "rubocop/lts"
+
+        Rubocop::Lts.install_tasks
+        if Kettle::Dev::IS_CI
+          Kettle::Dev.register_default("rubocop_gradual:check")
+        else
+          Kettle::Dev.register_default("rubocop_gradual:autocorrect")
         end
+      rescue LoadError
+        # OK, no styles for you.
       end
 
       ### TEST COVERAGE TASKS
       # Set up kettle-soup-cover
       # @return [void]
       def coverage_tasks
-        begin
-          # Lazy loaded because it won't be installed for Ruby < 2.7
-          require "kettle-soup-cover"
-
-          Kettle::Soup::Cover.install_tasks
-          # NOTE: Coverage on CI is configured independent of this task.
-          #       This task is for local development, as it opens results in browser
-          # simplecov:disable
-          Kettle::Dev.register_default("coverage") unless Kettle::Dev::IS_CI
-          # simplecov:enable
-        rescue LoadError
-          # OK, no soup for you.
-        end
+        # Lazy loaded because it won't be installed for Ruby < 2.7
+        require "kettle-soup-cover"
+
+        Kettle::Soup::Cover.install_tasks
+        # NOTE: Coverage on CI is configured independent of this task.
+        #       This task is for local development, as it opens results in browser
+        # simplecov:disable
+        Kettle::Dev.register_default("coverage") unless Kettle::Dev::IS_CI
+        # simplecov:enable
+      rescue LoadError
+        # OK, no soup for you.
       end
     end
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: kettle-dev
 version: !ruby/object:Gem::Version
-  version: 2.2.18
+  version: 2.2.20
 platform: ruby
 authors:
 - Peter H. Boling
@@ -37,6 +37,26 @@ cert_chain:
   -----END CERTIFICATE-----
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: kettle-rb
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.1.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.1.0
 - !ruby/object:Gem::Dependency
   name: kettle-test
   requirement: !ruby/object:Gem::Requirement
@@ -339,10 +359,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.18
-  changelog_uri: https://github.com/kettle-dev/kettle-dev/blob/v2.2.18/CHANGELOG.md
+  source_code_uri: https://github.com/kettle-dev/kettle-dev/tree/v2.2.20
+  changelog_uri: https://github.com/kettle-dev/kettle-dev/blob/v2.2.20/CHANGELOG.md
   bug_tracker_uri: https://github.com/kettle-dev/kettle-dev/issues
-  documentation_uri: https://www.rubydoc.info/gems/kettle-dev/2.2.18
+  documentation_uri: https://www.rubydoc.info/gems/kettle-dev/2.2.20
   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