kettle-dev 3.0.21 → 3.0.23

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b954b64713359f0955f303327bccadeff89c0d9e56733e325404c04774530550
-  data.tar.gz: ccb2a4329abb25e1e2e9999c15f86572f52bc0baa65a0702c8a1e779ee046f07
+  metadata.gz: b985d06999d067d64979c99918110a0203d706c53392e498ab667126e9388d68
+  data.tar.gz: 73b20adeb029d70f67152d6ae8ee4377629c846c851ac1a6c484fc2ff6add583
 SHA512:
-  metadata.gz: b521c0a0b72e751b3ec1f4633dce08e6b5b1d53a4a09e48690a57041dc81c0d515f656bcc4ab5fb9a0f3861ab595e71f76af21eec8116fa25a16f599775700cc
-  data.tar.gz: 71ff4f43113cca27f09047d9252b761edf5f734f7d562ef49178ffc2025e1b9057a4f4dc79061a4ce9966320557929fab21e5ae18f1e5481fa6646da8c8a483b
+  metadata.gz: 4af9b35a01651eb7eab623ea2f7d1a2829fee953467fd92f3fe27886333dc417397ddb430485b74dc1413d2aeb5553d840636fef9cab83425f32eaccd283ce99
+  data.tar.gz: 8d73396e1a95de0eac8a19ec6625830779505144d9dc7bb4852de362e9f3f83bcbc2190b221b971687459e6b7e2b2a3aa7c6453b71e87479a4b14d5ec805d2e1

data/CHANGELOG.md

@@ -30,6 +30,28 @@ Please file a bug if you notice a violation of semantic versioning.
 
 ### Security
 
+## [3.0.23] - 2026-08-30
+
+- TAG: [v3.0.23][3.0.23t]
+- COVERAGE: 91.35% -- 5881/6438 lines in 47 files
+- BRANCH COVERAGE: 76.01% -- 2250/2960 branches in 47 files
+- 50.47% documented
+
+### Fixed
+
+- Add an explicit reset option for release graphs that must omit the optional changelog dependency.
+
+## [3.0.22] - 2026-08-30
+
+- TAG: [v3.0.22][3.0.22t]
+- COVERAGE: 91.58% -- 5893/6435 lines in 47 files
+- BRANCH COVERAGE: 76.32% -- 2259/2960 branches in 47 files
+- 50.47% documented
+
+### Changed
+
+- Add an appraisal-only release skip while preserving documentation generation.
+
 ## [3.0.21] - 2026-08-30
 
 - TAG: [v3.0.21][3.0.21t]
@@ -3688,7 +3710,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/v3.0.21...HEAD
+[Unreleased]: https://github.com/kettle-dev/kettle-dev/compare/v3.0.23...HEAD
+[3.0.23]: https://github.com/kettle-dev/kettle-dev/compare/v3.0.22...v3.0.23
+[3.0.23t]: https://github.com/kettle-dev/kettle-dev/releases/tag/v3.0.23
+[3.0.22]: https://github.com/kettle-dev/kettle-dev/compare/v3.0.21...v3.0.22
+[3.0.22t]: https://github.com/kettle-dev/kettle-dev/releases/tag/v3.0.22
 [3.0.21]: https://github.com/kettle-dev/kettle-dev/compare/v3.0.20...v3.0.21
 [3.0.21t]: https://github.com/kettle-dev/kettle-dev/releases/tag/v3.0.21
 [3.0.20]: https://github.com/kettle-dev/kettle-dev/compare/v3.0.19...v3.0.20

data/README.md

@@ -415,7 +415,7 @@ What it does:
       Markdown fixtures under `spec/` and `test/`, along with `tmp/`, are intentionally excluded.
     - Skips pre-release checks for any `start_step` greater than `0`, so resumptions begin directly at the requested numbered step.
     - Verifies Bundler >= 2.7, updates the primary and appraisal bundles with `bundle update --bundler`, and commits those lockfiles separately as `🔒️ Update bundle` before release preparation.
-    - Runs sanity checks (`bin/setup`, `bin/rake`), confirms version/changelog, optionally updates Appraisals, regenerates docs via `bin/rake yard`, and commits “🔖 Prepare release vX.Y.Z”.
+    - Runs sanity checks (`bin/setup`, `bin/rake`), confirms version/changelog, optionally updates Appraisals, regenerates docs via `bin/rake yard`, and commits “🔖 Prepare release vX.Y.Z”. Use `--skip-appraisals` only to omit appraisal generation while retaining documentation generation.
     - Optionally runs your CI locally with `act` before any push:
         - Enable with env: `K_RELEASE_LOCAL_CI="true"` (run automatically) or `K_RELEASE_LOCAL_CI="ask"` (prompt \[Y/n\]).
         - Select workflow with `K_RELEASE_LOCAL_CI_WORKFLOW` (with or without .yml/.yaml). Defaults to `locked_deps.yml` if present; otherwise the first workflow discovered.
@@ -446,9 +446,10 @@ What it does:
         18. Create GitHub Release (requires `GITHUB_TOKEN`)
         19. Push tags to remotes (final)
 - Examples:
-    - After a transient CI or provider failure with no code, version, changelog, or lockfile changes, restart from monitoring: `bundle exec kettle-release --start-step 10` (the legacy `start_step=10` spelling remains supported)
+    - After a transient CI or provider failure with no code, version, changelog, or lockfile changes, restart at the failed step: for example, `bundle exec kettle-release --start-step 10` for CI monitoring or `bundle exec kettle-release --start-step 15` for RubyGems publication. The legacy `start_step=10` spelling remains supported.
     - If the failure required a code or release-metadata change, rerun `bundle exec kettle-release` from step 0 so the release checks, prep metadata, commit, and CI all describe the new release commit.
     - For an intentional same-commit CI bypass, use `bundle exec kettle-release --skip-ci` (or `--skip-steps 10`); this skips remote CI monitoring only and does not claim that CI passed.
+    - To retain release documentation generation while bypassing a known Appraisal-only issue, use `bundle exec kettle-release --skip-appraisals`.
     - After fixing a failed pre-release gate, rerun from step 0: `bundle exec kettle-release`
     - After intentionally handling a failed pre-release gate, skip it and start numbered release steps: `bundle exec kettle-release --start-step 1`
     - Auto-approve release confirmation prompts: `bundle exec kettle-release --yes`
@@ -471,10 +472,11 @@ What it does:
       `kettle-changelog` depends on `kettle-dev`, so including it in
       `kettle-dev`'s development bundle creates a downstream development-cycle
       when sibling versions are unpublished. The
-      `KETTLE_DEV_SKIP_CHANGELOG_DEPENDENCY=true` switch remains available for
-      an explicit bootstrap/release graph that cannot resolve that downstream
-      tool, but it is not used while rewriting the tracked development
-      lockfiles.
+      `--skip-changelog-dependency` (or the equivalent
+      `KETTLE_DEV_SKIP_CHANGELOG_DEPENDENCY=true` Gemfile switch) is available
+      for an explicit bootstrap/release graph that cannot resolve that
+      downstream tool. It is intentionally not the default for standalone
+      tracked development lockfiles.
     - At release step 1, `kettle-release` runs the equivalent of
       `kettle-family bupb`: it updates the primary lockfile and, when present,
       `Appraisal.root.gemfile.lock`, resets appraisal locks, and commits only
@@ -1056,7 +1058,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.430-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
+[🧮kloc-img]: https://img.shields.io/badge/KLOC-6.438-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-release

@@ -49,7 +49,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] [--yes] [--appraisal-update] [--skip-changelog] [--skip-bundle-audit] [--start-step STEP] [--skip-ci] [--skip-steps STEPS] [--ci-workflows WORKFLOWS] [--skip-remotes REMOTES] [--required-remotes REMOTES] [--secrets-provider NAME] [--json|--events[=TYPES]] [--report PATH] [start_step=<0-19>]
+    Usage: kettle-release [--version VERSION] [--local-ci] [--yes] [--appraisal-update] [--skip-changelog] [--skip-appraisals] [--skip-bundle-audit] [--start-step STEP] [--skip-ci] [--skip-steps STEPS] [--ci-workflows WORKFLOWS] [--skip-remotes REMOTES] [--required-remotes REMOTES] [--secrets-provider NAME] [--json|--events[=TYPES]] [--report PATH] [start_step=<0-19>]
 
     Automates the release flow for a Ruby gem in the host project.
 
@@ -91,6 +91,7 @@ if ARGV.include?("-h") || ARGV.include?("--help")
       --yes                       # Auto-approve release confirmation prompts
       --appraisal-update          # Use slower appraisal:update instead of default appraisal:generate
       --skip-changelog            # Skip kettle-changelog but retain pre-release gates and the default task
+      --skip-appraisals           # Skip appraisal generation at step 5 but still generate documentation
       --skip-bundle-audit         # Skip bundle:audit/update during release rake checks
       --ci-workflows WORKFLOWS    # Comma-separated workflow files or stems to monitor at CI step 10
       --skip-remotes REMOTES      # Comma-separated git remote names to exclude from release fetch/push parity
@@ -227,6 +228,19 @@ def extract_skip_changelog_arg!(argv)
   skip_changelog
 end
 
+def extract_skip_appraisals_arg!(argv)
+  skip_appraisals = !!argv.delete("--skip-appraisals")
+  argv.delete_if do |arg|
+    if arg.start_with?("skip_appraisals=")
+      skip_appraisals = arg.split("=", 2)[1].to_s.downcase != "false"
+      true
+    else
+      false
+    end
+  end
+  skip_appraisals
+end
+
 def extract_ci_workflows_arg!(argv)
   workflows = nil
   if (idx = argv.index("--ci-workflows"))
@@ -353,6 +367,7 @@ yes = !!ARGV.delete("--yes")
 appraisal_task = ARGV.delete("--appraisal-update") ? "appraisal:update" : nil
 skip_bundle_audit = !!ARGV.delete("--skip-bundle-audit")
 skip_changelog = extract_skip_changelog_arg!(ARGV)
+skip_appraisals = extract_skip_appraisals_arg!(ARGV)
 json_output = !!ARGV.delete("--json")
 events_output, event_types = extract_events_arg!(ARGV)
 Kettle::Dev::ExitAdapter.abort("--events cannot be combined with --json") if events_output && json_output
@@ -369,7 +384,7 @@ secrets_provider = extract_secrets_provider_arg!(ARGV)
 
 begin
   event_stream = events_output ? Kettle::Ndjson.event_stream($stdout, types: event_types) : nil
-  Kettle::Dev::ReleaseCLI.new(start_step: start_step, local_ci: local_ci, version: version_override, appraisal_task: appraisal_task, skip_steps: skip_steps, skip_changelog: skip_changelog, skip_bundle_audit: skip_bundle_audit, ci_workflows: ci_workflows, skip_remotes: skip_remotes, required_remotes: required_remotes, secrets_provider_name: secrets_provider, yes: yes, event_stream: event_stream, json_output: json_output, json_io: $stdout, report_path: report_path).run
+  Kettle::Dev::ReleaseCLI.new(start_step: start_step, local_ci: local_ci, version: version_override, appraisal_task: appraisal_task, skip_steps: skip_steps, skip_changelog: skip_changelog, skip_appraisals: skip_appraisals, skip_bundle_audit: skip_bundle_audit, ci_workflows: ci_workflows, skip_remotes: skip_remotes, required_remotes: required_remotes, secrets_provider_name: secrets_provider, yes: yes, event_stream: event_stream, json_output: json_output, json_io: $stdout, report_path: report_path).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/release_cli.rb

@@ -191,13 +191,14 @@ module Kettle
 
       public
 
-      def initialize(start_step: 0, local_ci: false, version: nil, appraisal_task: nil, skip_steps: nil, skip_changelog: nil, skip_bundle_audit: nil, ci_workflows: nil, skip_remotes: nil, required_remotes: nil, secrets_provider_name: nil, yes: false, **options)
+      def initialize(start_step: 0, local_ci: false, version: nil, appraisal_task: nil, skip_steps: nil, skip_changelog: nil, skip_appraisals: nil, skip_bundle_audit: nil, ci_workflows: nil, skip_remotes: nil, required_remotes: nil, secrets_provider_name: nil, yes: false, **options)
         @root = Kettle::Dev::CIHelpers.project_root
         @git = Kettle::Dev::GitAdapter.new(@root)
         @start_step = (start_step || 0).to_i
         @start_step = 0 if @start_step < 0
         @skip_steps = normalize_skip_steps(skip_steps)
         @skip_changelog = truthy_value?(skip_changelog) || truthy_value?(ENV["KETTLE_DEV_SKIP_CHANGELOG"])
+        @skip_appraisals = truthy_value?(skip_appraisals) || truthy_value?(ENV["KETTLE_DEV_SKIP_APPRAISALS"])
         @ci_workflows = normalize_ci_workflows(ci_workflows || ENV["K_RELEASE_CI_WORKFLOWS"])
         @skip_remotes = normalize_remote_names(skip_remotes || ENV["K_RELEASE_SKIP_REMOTES"], "skip remotes")
         @required_remotes = normalize_required_remotes(required_remotes)
@@ -371,7 +372,9 @@ module Kettle
         # 5. appraisal:generate (optional) + canonical docs build
         if run_step?(5)
           appraisals_path = File.join(@root, "Appraisals")
-          if File.file?(appraisals_path)
+          if skip_appraisals?
+            puts "Skipping #{@appraisal_task} because --skip-appraisals was provided."
+          elsif File.file?(appraisals_path)
             puts "Appraisals detected at #{Kettle::Dev.display_path(appraisals_path)}. Running: bin/rake #{@appraisal_task}"
             run_cmd!(release_project_command("bin/rake #{@appraisal_task}"))
           else
@@ -680,6 +683,10 @@ module Kettle
         @skip_changelog
       end
 
+      def skip_appraisals?
+        @skip_appraisals
+      end
+
       def prepare_release_lockfiles_for_commit!
         # Release setup and documentation tasks can re-materialize local PATH
         # sources in the parent development bundle after the preflight reset.

data/lib/kettle/dev/reset_cli.rb

@@ -9,6 +9,7 @@ module Kettle
         @argv = Array(argv).dup
         @root = root
         @check = false
+        @skip_changelog_dependency = false
       end
 
       def run!
@@ -25,7 +26,7 @@ module Kettle
             puts "#{target} is already reset."
             return 0
           end
-          resetter.reset(target)
+          resetter.reset(target, skip_changelog_dependency: skip_changelog_dependency)
           puts "Reset #{target}."
         end
         0
@@ -33,7 +34,7 @@ module Kettle
 
       private
 
-      attr_reader :argv, :root, :check
+      attr_reader :argv, :root, :check, :skip_changelog_dependency
 
       def parse!
         parser.parse!(argv)
@@ -43,9 +44,12 @@ module Kettle
 
       def parser
         OptionParser.new do |opts|
-          opts.banner = "Usage: kettle-reset [--check] TARGET"
+          opts.banner = "Usage: kettle-reset [--check] [--skip-changelog-dependency] TARGET"
           opts.separator "Targets: Gemfile.lock, Appraisal.root.gemfile.lock, release-lockfiles"
           opts.on("--check", "Validate TARGET without changing it") { @check = true }
+          opts.on("--skip-changelog-dependency", "Omit optional kettle-changelog while resetting a bootstrap/release graph") do
+            @skip_changelog_dependency = true
+          end
           opts.on("-h", "--help", "Show this help") do
             puts opts
             exit(0)

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.21"
+      VERSION = "3.0.23"
     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.21
+  version: 3.0.23
 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.21
-  changelog_uri: https://github.com/kettle-dev/kettle-dev/blob/v3.0.21/CHANGELOG.md
+  source_code_uri: https://github.com/kettle-dev/kettle-dev/tree/v3.0.23
+  changelog_uri: https://github.com/kettle-dev/kettle-dev/blob/v3.0.23/CHANGELOG.md
   bug_tracker_uri: https://github.com/kettle-dev/kettle-dev/issues
-  documentation_uri: https://www.rubydoc.info/gems/kettle-dev/3.0.21
+  documentation_uri: https://www.rubydoc.info/gems/kettle-dev/3.0.23
   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