kettle-dev 3.0.12 → 3.0.13

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 778a9528095541a29e4c6a15022c1fe312cf32ccb8f336972c046b02134bae32
-  data.tar.gz: bcc27b14726e3f17ad56b4e305e324c4ccb38df57df754f5f41b73e121f33a41
+  metadata.gz: a082b4a2994774e072557058c17670f3f4252e98bf4c406c38265233e37f10df
+  data.tar.gz: c09ac0a7de3fda62be5676f735a170c6577816cdfde710cbcf48d8805e5e6040
 SHA512:
-  metadata.gz: 4f4b916aeb6714071d76ab84ae57e08650e42fe0607df2e7b366855932c66019ad3f8a2ba37befa0089b9261eb38092ab3bc33cce61237b0d9880139da3399de
-  data.tar.gz: 238a0802ae743f219f919a9fbdd2d1500aeea06ad8a756e5e377c4bc8c275e0d80bf07911f9a78b94e0095e9809afbb8eaeb9f98d9ee2e6db72242cfc2aa5fd9
+  metadata.gz: 41b0bf2772bd39e1f164b82dc1bf0f07accc07a3310a7e642c75ba1729b2c3cca5db0030b16b0af015e63c6902b596276f79470fc2f646be964a03ec485e565c
+  data.tar.gz: 57a42e46f0dfb6ad000c952e82a46a3f39308d9e3036363f21a8664b00fbb30e3a5a2e96eef8d88bf6a7aa5a68d9b935e934d450796962688ddba216af7ac92a

data/CHANGELOG.md

@@ -30,6 +30,17 @@ Please file a bug if you notice a violation of semantic versioning.
 
 ### Security
 
+## [3.0.13] - 2026-08-25
+
+- TAG: [v3.0.13][3.0.13t]
+- COVERAGE: 91.54% -- 5758/6290 lines in 47 files
+- BRANCH COVERAGE: 76.44% -- 2210/2891 branches in 47 files
+- 50.74% documented
+
+### Changed
+
+- Add named standalone release aliases for CI bypass and numbered-step recovery.
+
 ## [3.0.12] - 2026-08-25
 
 - TAG: [v3.0.12][3.0.12t]
@@ -3557,7 +3568,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.12...HEAD
+[Unreleased]: https://github.com/kettle-dev/kettle-dev/compare/v3.0.13...HEAD
+[3.0.13]: https://github.com/kettle-dev/kettle-dev/compare/v3.0.12...v3.0.13
+[3.0.13t]: https://github.com/kettle-dev/kettle-dev/releases/tag/v3.0.13
 [3.0.12]: https://github.com/kettle-dev/kettle-dev/compare/v3.0.11...v3.0.12
 [3.0.12t]: https://github.com/kettle-dev/kettle-dev/releases/tag/v3.0.12
 [3.0.11]: https://github.com/kettle-dev/kettle-dev/compare/v3.0.10...v3.0.11

data/README.md

@@ -443,11 +443,11 @@ 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`
+    - 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)
     - 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_steps=10` or `--skip-steps 10`; this skips remote CI monitoring only and does not claim that CI passed.
+    - 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.
     - 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`
+    - 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`
     - Run direct release with 1Password secrets: `bundle exec kettle-release --secrets-provider 1password`
 - Lockfile recovery:

data/exe/kettle-release

@@ -49,16 +49,16 @@ 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] [--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-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.
 
     Full releases start at step 0 and run `kettle-pre-release` plus
-    `kettle-changelog` before the numbered release steps. Any start_step
+    `kettle-changelog` before the numbered release steps. Any start step
     greater than 0 skips pre-release prep and resumes directly at the
     requested numbered step.
 
-    Start steps (use start_step=<n> to begin at that step):
+    Start steps (use --start-step <n>; start_step=<n> remains supported):
       0. Run kettle-pre-release gates and kettle-changelog
       1. Verify Bundler >= 2.7 (start at 1 to skip pre-release checks)
       2. Detect version; RubyGems sanity check; confirm CHANGELOG/version; sync copyright years; update badges/headers
@@ -82,7 +82,9 @@ if ARGV.include?("-h") || ARGV.include?("--help")
      19. Push tags to remotes (final)
 
     Options:
-      start_step=<number>         # Begin at the numbered step above; use 10 only for a transient CI failure on the same commit
+      --start-step NUMBER         # Begin at the numbered step above; use 10 only for a transient CI failure on the same commit
+      start_step=<number>         # Legacy alias for --start-step
+      --skip-ci                   # Alias for --skip-steps 10; skips remote CI monitoring while running the rest
       skip_steps=<numbers>        # Comma-separated numbered steps to skip while running the rest; 10 skips remote CI monitoring
       --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
@@ -101,9 +103,11 @@ if ARGV.include?("-h") || ARGV.include?("--help")
                                   # create the git tag locally, then push commits and tags after publish
 
     Recovery guidance:
-      start_step=10                # Retry only CI monitoring after a transient CI/provider failure; do not use after code or metadata changes
-      start_step=11                # Continue after CI monitoring only when that same release commit was intentionally accepted
-      skip_steps=10                # Skip remote CI monitoring for the same prepared release commit; this does not rerun or replace CI
+      --start-step 10              # Retry only CI monitoring after a transient CI/provider failure; do not use after code or metadata changes
+      --start-step 11              # Continue after CI monitoring only when that same release commit was intentionally accepted
+      --skip-ci                    # Skip remote CI monitoring for the same prepared release commit; this does not rerun or replace CI
+      start_step=10                # Legacy spelling of --start-step 10
+      skip_steps=10                # Legacy spelling of --skip-ci
       kettle-release               # After code, version, changelog, or lockfile changes, rerun the complete flow from step 0
 
     Environment:
@@ -139,10 +143,11 @@ if ARGV.include?("-h") || ARGV.include?("--help")
     Examples:
       kettle-release                       # full flow from the top (start_step=0)
       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         # retry CI monitoring after a transient failure on the unchanged release commit
-      kettle-release skip_steps=10         # intentionally skip remote CI monitoring for the unchanged release commit
-      SKIP_GEM_SIGNING=true kettle-release start_step=14  # build+release without signing
+      kettle-release --start-step 1      # skip pre-release checks and start numbered release steps
+      kettle-release --start-step 10     # retry CI monitoring after a transient failure on the unchanged release commit
+      kettle-release --skip-ci           # intentionally skip remote CI monitoring for the unchanged release commit
+      kettle-release start_step=10       # legacy spelling of --start-step 10
+      SKIP_GEM_SIGNING=true kettle-release --start-step 14  # build+release without signing
   USAGE
   exit 0
 end
@@ -184,6 +189,31 @@ def extract_skip_steps_arg!(argv)
   skip_steps
 end
 
+def extract_start_step_arg!(argv)
+  start_step = nil
+  if (idx = argv.index("--start-step"))
+    start_step = argv[idx + 1]
+    if start_step.to_s.empty? || start_step.to_s.start_with?("-")
+      Kettle::Dev::ExitAdapter.abort("--start-step requires a numbered release step")
+    end
+    argv.slice!(idx, 2)
+  end
+  argv.delete_if do |arg|
+    if arg.start_with?("--start-step=", "start_step=")
+      start_step = arg.split("=", 2)[1]
+      Kettle::Dev::ExitAdapter.abort("--start-step requires a numbered release step") if start_step.to_s.empty?
+      true
+    else
+      false
+    end
+  end
+  start_step
+end
+
+def extract_skip_ci_arg!(argv)
+  !!argv.delete("--skip-ci")
+end
+
 def extract_skip_changelog_arg!(argv)
   skip_changelog = !!argv.delete("--skip-changelog")
   argv.delete_if do |arg|
@@ -326,10 +356,11 @@ skip_changelog = extract_skip_changelog_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
-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
+start_step = extract_start_step_arg!(ARGV) || 0
+skip_ci = extract_skip_ci_arg!(ARGV)
 version_override = extract_version_arg!(ARGV)
 skip_steps = extract_skip_steps_arg!(ARGV)
+skip_steps = [skip_steps, "10"].compact.join(",") if skip_ci
 ci_workflows = extract_ci_workflows_arg!(ARGV)
 skip_remotes = extract_skip_remotes_arg!(ARGV)
 required_remotes = extract_required_remotes_arg!(ARGV)

data/lib/kettle/dev/ci_monitor.rb

@@ -49,7 +49,7 @@ module Kettle
       #
       # @param restart_hint [String] guidance command shown on failure
       # @return [Boolean] whether all configured CI providers passed
-      def monitor_all!(restart_hint: "bundle exec kettle-release start_step=10", workflows: nil, keepalive: nil, event_recorder: nil, **options)
+      def monitor_all!(restart_hint: "bundle exec kettle-release --start-step 10", workflows: nil, keepalive: nil, event_recorder: nil, **options)
         results = [
           monitor_github_internal!(restart_hint: restart_hint, workflows: workflows, keepalive: keepalive, event_recorder: event_recorder),
           monitor_gitlab_internal!(restart_hint: restart_hint, keepalive: keepalive, event_recorder: event_recorder)
@@ -69,7 +69,7 @@ module Kettle
       # Returns false when GitLab is not configured for this repo/branch.
       # @param restart_hint [String]
       # @return [Boolean]
-      def monitor_gitlab!(restart_hint: "bundle exec kettle-release start_step=10")
+      def monitor_gitlab!(restart_hint: "bundle exec kettle-release --start-step 10")
         result = monitor_gitlab_internal!(restart_hint: restart_hint)
         result.nil? ? false : result
       end
@@ -138,7 +138,7 @@ module Kettle
       # Designed for kettle-release.
       # @param restart_hint [String]
       # @return [void]
-      def monitor_and_prompt_for_release!(restart_hint: "bundle exec kettle-release start_step=10")
+      def monitor_and_prompt_for_release!(restart_hint: "bundle exec kettle-release --start-step 10")
         results = collect_all
         any_checks = !(results[:github].nil? || results[:github].empty?) || !!results[:gitlab]
         abort("CI configuration not detected (GitHub or GitLab). Ensure CI is configured and remotes point to the correct hosts.") unless any_checks

data/lib/kettle/dev/release_cli.rb

@@ -1253,7 +1253,7 @@ module Kettle
       def monitor_workflows_after_push!
         ensure_github_pull_request_for_ci!
         keep_release_secrets_alive!("CI monitoring")
-        restart_hint = "bundle exec kettle-release start_step=10"
+        restart_hint = "bundle exec kettle-release --start-step 10"
         emit_ci_monitor_event(action: "start", status: "started", workflows: @ci_workflows, restart_hint: restart_hint)
         # The monitor preserves fail-fast behavior by default and returns false
         # when K_RELEASE_CI_CONTINUE explicitly allows failed CI checks.

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.12"
+      VERSION = "3.0.13"
     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.12
+  version: 3.0.13
 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.12
-  changelog_uri: https://github.com/kettle-dev/kettle-dev/blob/v3.0.12/CHANGELOG.md
+  source_code_uri: https://github.com/kettle-dev/kettle-dev/tree/v3.0.13
+  changelog_uri: https://github.com/kettle-dev/kettle-dev/blob/v3.0.13/CHANGELOG.md
   bug_tracker_uri: https://github.com/kettle-dev/kettle-dev/issues
-  documentation_uri: https://www.rubydoc.info/gems/kettle-dev/3.0.12
+  documentation_uri: https://www.rubydoc.info/gems/kettle-dev/3.0.13
   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