kettle-dev 2.1.0 → 2.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d0939e7fbe918113808390ac5a59aa00eb55ef29f3cc5333e97891f934413027
-  data.tar.gz: ef89c8c3ba19f7da27e08c882f1484d78b40e820371c70cc14d343ca7aa74f17
+  metadata.gz: 41074cb0fabc348cfb17e29cfb521661c4492792a7c5e3fab1ff32815f960355
+  data.tar.gz: d65ce417666381f6cf72ac7f6cdcd6bea0be35c996c820d16765789229408bc9
 SHA512:
-  metadata.gz: 2458f3f267ecf17c4a6badd5ff6e52a2ab5c7480dab066634eb192ded14b551b72681dd7ec3e009d51f2ab51f405e3387c539ad65290e8043a7493ec2852b869
-  data.tar.gz: 75c6af98860bf08b8c807db3bc12dab3aa7a86cb557100b67d195a9630f8d141ca0a50d3e2fec51f715248ded501a46c2dd2fe18b039a840da95134abe97061b
+  metadata.gz: 100dc6197c4a9329d3ae4e483feb7e3c643160a9a446939c7a3d6bb789a0ca8ba6c41f8231971548b4ba91916e55481469d17b6623998046a1cc302bf96e7825
+  data.tar.gz: cd82a9b3ad27598611f94798fa1187171092017cbf8d28b44ff5fd3c82ed021251ba35053683276ac8dc49a77c33035ec02f3c379a42d79fbabd749d25221bba

data/CHANGELOG.md

@@ -30,6 +30,25 @@ Please file a bug if you notice a violation of semantic versioning.
 
 ### Security
 
+## [2.1.1] - 2026-06-06
+
+- TAG: [v2.1.1][2.1.1t]
+- COVERAGE: 93.11% -- 2988/3209 lines in 25 files
+- BRANCH COVERAGE: 77.58% -- 1218/1570 branches in 25 files
+- 75.93% documented
+
+### Added
+
+- `kettle-release --local-ci` for sensitive releases that run `act` locally,
+  publish the gem before any git push, create the release tag locally, and push
+  commits and tags only after publishing succeeds.
+
+### Changed
+
+- Refreshed kettle-jem template output, including Appraisal2 plugin wiring and
+  current dependency floors for `appraisal2`, `appraisal2-rubocop`, and
+  `version_gem`.
+
 ## [2.1.0] - 2026-06-06
 
 - TAG: [v2.1.0][2.1.0t]
@@ -1894,7 +1913,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-rb/kettle-dev/compare/v2.1.0...HEAD
+[Unreleased]: https://github.com/kettle-rb/kettle-dev/compare/v2.1.1...HEAD
+[2.1.1]: https://github.com/kettle-rb/kettle-dev/compare/v2.1.0...v2.1.1
+[2.1.1t]: https://github.com/kettle-rb/kettle-dev/releases/tag/v2.1.1
 [2.1.0]: https://github.com/kettle-rb/kettle-dev/compare/v2.0.8...v2.1.0
 [2.1.0t]: https://github.com/kettle-rb/kettle-dev/releases/tag/v2.1.0
 [2.0.8]: https://github.com/kettle-rb/kettle-dev/compare/v2.0.7...v2.0.8

data/README.md

@@ -811,7 +811,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-3.179-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
+[🧮kloc-img]: https://img.shields.io/badge/KLOC-3.209-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
 [🔐security]: https://github.com/kettle-rb/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

@@ -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 [start_step=<1-19>]
+    Usage: kettle-release [--local-ci] [start_step=<1-19>]
 
     Automates the release flow for a Ruby gem in the host project.
 
@@ -70,6 +70,8 @@ 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)
+      --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
 
     Environment:
       SKIP_GEM_SIGNING=true       # Build/release unsigned; avoids PEM password prompts
@@ -82,6 +84,7 @@ if ARGV.include?("-h") || ARGV.include?("--help")
 
     Examples:
       kettle-release                       # full flow from the top (start_step=1)
+      kettle-release --local-ci            # run local act CI, publish gem, then push commits/tags
       kettle-release start_step=10         # resume by monitoring CI for the current branch
       SKIP_GEM_SIGNING=true kettle-release start_step=14  # build+release without signing
   USAGE
@@ -89,11 +92,12 @@ if ARGV.include?("-h") || ARGV.include?("--help")
 end
 
 # Parse start_step=<n> from ARGV
+local_ci = ARGV.include?("--local-ci")
 start_step_arg = ARGV.find { |a| a.start_with?("start_step=") }
 start_step = start_step_arg ? start_step_arg.split("=", 2)[1].to_i : 1
 
 begin
-  Kettle::Dev::ReleaseCLI.new(start_step: start_step).run
+  Kettle::Dev::ReleaseCLI.new(start_step: start_step, local_ci: local_ci).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

@@ -70,11 +70,12 @@ module Kettle
 
       public
 
-      def initialize(start_step: 1)
+      def initialize(start_step: 1, local_ci: false)
         @root = Kettle::Dev::CIHelpers.project_root
         @git = Kettle::Dev::GitAdapter.new
         @start_step = (start_step || 1).to_i
         @start_step = 1 if @start_step < 1
+        @local_ci = !!local_ci
       end
 
       def run
@@ -206,31 +207,33 @@ module Kettle
         end
 
         # 7. optional local CI via act
-        maybe_run_local_ci_before_push!(committed) if @start_step <= 7
+        maybe_run_local_ci_before_push!(committed, force: local_ci?) if @start_step <= 7
 
         # 8. ensure trunk synced
-        if @start_step <= 8
+        if @start_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
+          puts "Local CI release mode: skipping remote trunk sync before publishing."
         end
 
         # 9. push branches
-        push! if @start_step <= 9
+        push! if @start_step <= 9 && !local_ci?
 
         # 10. monitor CI after push
-        monitor_workflows_after_push! if @start_step <= 10
+        monitor_workflows_after_push! if @start_step <= 10 && !local_ci?
 
         # 11. merge feature into trunk and push
-        if @start_step <= 11
+        if @start_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
+        if @start_step <= 12 && !local_ci?
           trunk ||= detect_trunk_branch
           checkout!(trunk)
           pull!(trunk)
@@ -265,8 +268,13 @@ module Kettle
 
         # 15. release and tag
         if @start_step <= 15
-          puts "Running release (you may be prompted for signing key password and RubyGems MFA OTP)..."
-          run_cmd!("bundle exec rake release")
+          if local_ci?
+            version ||= detect_version
+            release_gem_and_tag_locally!(version)
+          else
+            puts "Running release (you may be prompted for signing key password and RubyGems MFA OTP)..."
+            run_cmd!("bundle exec rake release")
+          end
         end
 
         # 16. generate checksums
@@ -281,7 +289,10 @@ module Kettle
         end
 
         # 17. push checksum commit (gem_checksums already commits)
-        push! if @start_step <= 17
+        if @start_step <= 17
+          push!
+          push_tags! if local_ci?
+        end
 
         # 18. create GitHub release (optional)
         if @start_step <= 18
@@ -290,7 +301,7 @@ module Kettle
         end
 
         # 19. push tags to remotes (final step)
-        push_tags! if @start_step <= 19
+        push_tags! if @start_step <= 19 && !local_ci?
 
         # Final success message
         begin
@@ -306,6 +317,10 @@ module Kettle
 
       private
 
+      def local_ci?
+        @local_ci
+      end
+
       # Update the README KLOC badge number based on the denominator in the current version's COVERAGE line in CHANGELOG.md.
       # - Parses the current version section of CHANGELOG.md
       # - Finds a line matching: "- COVERAGE: ... -- <tested>/<total> lines ..."
@@ -552,17 +567,22 @@ module Kettle
         end
       end
 
-      def maybe_run_local_ci_before_push!(committed)
+      def maybe_run_local_ci_before_push!(committed, force: false)
         mode = (ENV["K_RELEASE_LOCAL_CI"] || "").strip.downcase
-        run_it = case mode
-        when "true", "1", "yes", "y" then true
-        when "ask"
-          print("Run local CI with 'act' before pushing? [Y/n] ")
-          ans = Kettle::Dev::InputAdapter.gets&.strip
-          ans.nil? || ans.empty? || /\Ay(es)?\z/i.match?(ans)
-        else
-          false
-        end
+        run_it =
+          if force
+            true
+          else
+            case mode
+            when "true", "1", "yes", "y" then true
+            when "ask"
+              print("Run local CI with 'act' before pushing? [Y/n] ")
+              ans = Kettle::Dev::InputAdapter.gets&.strip
+              ans.nil? || ans.empty? || /\Ay(es)?\z/i.match?(ans)
+            else
+              false
+            end
+          end
         return unless run_it
 
         act_ok = begin
@@ -572,6 +592,8 @@ module Kettle
           false
         end
         unless act_ok
+          msg = "Local CI requires 'act'. Install https://github.com/nektos/act to enable."
+          abort(msg) if force
           puts "Skipping local CI: 'act' command not found. Install https://github.com/nektos/act to enable."
           return
         end
@@ -594,12 +616,16 @@ module Kettle
         end
 
         unless chosen
+          msg = "Local CI requires at least one workflow under .github/workflows."
+          abort(msg) if force
           puts "Skipping local CI: no workflows found under .github/workflows."
           return
         end
 
         file_path = File.join(workflows_dir, chosen)
         unless File.file?(file_path)
+          msg = "Local CI selected workflow not found: #{Kettle::Dev.display_path(file_path)}"
+          abort(msg) if force
           puts "Skipping local CI: selected workflow not found: #{Kettle::Dev.display_path(file_path)}"
           return
         end
@@ -618,6 +644,25 @@ module Kettle
         end
       end
 
+      def release_gem_and_tag_locally!(version)
+        tag = "v#{version}"
+        gem_path = gem_file_for_version(version)
+        unless gem_path && File.file?(gem_path)
+          abort("Unable to locate built gem for version #{version} in pkg/. Did the build succeed?")
+        end
+
+        _out, tag_exists = git_output(["rev-parse", "-q", "--verify", "refs/tags/#{tag}"])
+        if tag_exists
+          puts "Local tag #{tag} already exists."
+        else
+          puts "Creating local git tag #{tag} without pushing it."
+          run_cmd!("git tag -a #{Shellwords.escape(tag)} -m #{Shellwords.escape(tag)}")
+        end
+
+        puts "Publishing #{File.basename(gem_path)} to RubyGems without pushing git refs..."
+        run_cmd!("gem push #{Shellwords.escape(gem_path)}")
+      end
+
       def detect_version
         Kettle::Dev::Versioning.detect_version(@root)
       end

data/lib/kettle/dev/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: kettle-dev
 version: !ruby/object:Gem::Version
-  version: 2.1.0
+  version: 2.1.1
 platform: ruby
 authors:
 - Peter H. Boling
@@ -66,7 +66,7 @@ dependencies:
         version: '1.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.1.10
+        version: 1.1.11
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -76,7 +76,7 @@ dependencies:
         version: '1.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.1.10
+        version: 1.1.11
 - !ruby/object:Gem::Dependency
   name: bundler-audit
   requirement: !ruby/object:Gem::Requirement
@@ -134,7 +134,7 @@ dependencies:
         version: '3.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.1.0
+        version: 3.1.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -144,7 +144,7 @@ dependencies:
         version: '3.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.1.0
+        version: 3.1.1
 - !ruby/object:Gem::Dependency
   name: turbo_tests2
   requirement: !ruby/object:Gem::Requirement
@@ -332,10 +332,10 @@ licenses:
 - AGPL-3.0-only
 metadata:
   homepage_uri: https://kettle-dev.galtzo.com
-  source_code_uri: https://github.com/kettle-rb/kettle-dev/tree/v2.1.0
-  changelog_uri: https://github.com/kettle-rb/kettle-dev/blob/v2.1.0/CHANGELOG.md
+  source_code_uri: https://github.com/kettle-rb/kettle-dev/tree/v2.1.1
+  changelog_uri: https://github.com/kettle-rb/kettle-dev/blob/v2.1.1/CHANGELOG.md
   bug_tracker_uri: https://github.com/kettle-rb/kettle-dev/issues
-  documentation_uri: https://www.rubydoc.info/gems/kettle-dev/2.1.0
+  documentation_uri: https://www.rubydoc.info/gems/kettle-dev/2.1.1
   funding_uri: https://github.com/sponsors/pboling
   wiki_uri: https://github.com/kettle-rb/kettle-dev/wiki
   news_uri: https://www.railsbling.com/tags/kettle-dev