kettle-dev 3.1.6 → 3.1.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a3eedbe026cd767bf8c441626bcb96dea0701b1c03665ae754a1c1a9d8a5145c
-  data.tar.gz: 90750eaeb7d50a06b475fc893a5184e28a9526d7a439ecd74b4804fd152c43cc
+  metadata.gz: 2de1266e7cdbbfd6174c040d8602cf8c3349a423bc301f071ba45da206cba969
+  data.tar.gz: f93264ee009dbede2c2ff3273a396916a31d51a70b1ac1cab817532e11f396f5
 SHA512:
-  metadata.gz: 46e1634ec393b5e6f4dace446165c407002d81f94841066b2da98a183f0c5251886cac9c93daf6ebbd75bd8333be6fb278aec44c137dad2c7d34a2b1de82334e
-  data.tar.gz: 1e7b236a4e37268062b4c3ac7620ddc179c35aa615f53529c5490b681335aec8d2c710a740eb34b825c9248509664c8b808e85e2932375728a24a859f9d21778
+  metadata.gz: 6a10b65136115e119f2b24eea184c114ea09ae969bed38f71005f39f0fe2f1f0ef1a9869449cf70cf895f075c0c01387918b02bafb914237ca3136d2f4ef868f
+  data.tar.gz: 9e14f9945043f4f104c65e34dae30e11301e84caa63f474555d0befe80a35508d604b331da62306808a927eb881e2a41a66562582896b4145cf22e9051db8c65

data/CHANGELOG.md

@@ -30,6 +30,37 @@ Please file a bug if you notice a violation of semantic versioning.
 
 ### Security
 
+## [3.1.7] - 2026-10-04
+
+- TAG: [v3.1.7][3.1.7t]
+- COVERAGE: 91.75% -- 6261/6824 lines in 49 files
+- BRANCH COVERAGE: 76.08% -- 2388/3139 branches in 49 files
+- 51.34% documented
+
+### Added
+
+- kettle-release warns when the current branch is not among the release branches its family declares, naming the declaring config and the declared branches, instead of silently treating it as a feature branch destined for trunk.
+
+### Fixed
+
+- Branch-stack release detection now also reads `release.member_target_branches.<gem>` from the family root config, so a member whose templated local `.kettle-family.yml` is absent (a fresh branch, or a linked worktree) no longer degrades silently into a trunk pull request and a merge into trunk.
+
+- Branch-stack release detection no longer uses block-level `rescue` or `Array#filter_map`, which are Ruby 2.6+ and 2.7+ constructs; the gem supports Ruby 2.4. YAML loading is isolated in `safe_load_kettle_family_config` with a method-level rescue, restoring the explicit `begin`/`end` contract the surrounding code relies on.
+
+- Preserve the selected Gemfile and lockfile when Bundler restarts during release lockfile reset.
+
+### Changed
+
+- [kc] kettle-jem/prepare: updated 13 project files:
+  - dependencies (13)
+
+- [kc] kettle-jem/template: updated 7 project files:
+  - code and tests (2)
+  - dependencies (1)
+  - documentation (1)
+  - other (2)
+  - workflows (1)
+
 ## [3.1.6] - 2026-10-02
 
 - TAG: [v3.1.6][3.1.6t]
@@ -3953,7 +3984,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.1.6...HEAD
+[Unreleased]: https://github.com/kettle-dev/kettle-dev/compare/v3.1.7...HEAD
+[3.1.7]: https://github.com/kettle-dev/kettle-dev/compare/v3.1.6...v3.1.7
+[3.1.7t]: https://github.com/kettle-dev/kettle-dev/releases/tag/v3.1.7
 [3.1.6]: https://github.com/kettle-dev/kettle-dev/compare/v3.1.5...v3.1.6
 [3.1.6t]: https://github.com/kettle-dev/kettle-dev/releases/tag/v3.1.6
 [3.1.5]: https://github.com/kettle-dev/kettle-dev/compare/v3.1.4...v3.1.5

data/README.md

@@ -1067,7 +1067,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.775-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
+[🧮kloc-img]: https://img.shields.io/badge/KLOC-6.824-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/lib/kettle/dev/lockfile_reset.rb

@@ -201,6 +201,13 @@ module Kettle
           "BUNDLE_GEMFILE" => gemfile,
           "BUNDLE_LOCKFILE" => path
         )
+        if update_bundler
+          # Bundler's `update --bundler` restarts itself using its original
+          # environment. Preserve this reset's selected bundle across that
+          # restart instead of falling back to the member's default Gemfile.
+          env["BUNDLER_ORIG_BUNDLE_GEMFILE"] = gemfile
+          env["BUNDLER_ORIG_BUNDLE_LOCKFILE"] = path
+        end
         env["KETTLE_DEV_SKIP_CHANGELOG_DEPENDENCY"] = "true" if skip_changelog_dependency
         if isolated_gem_home
           env["GEM_HOME"] = isolated_gem_home

data/lib/kettle/dev/release_cli.rb

@@ -2928,23 +2928,117 @@ module Kettle
         return false if branch.to_s.empty?
         return false if trunk && branch == trunk
 
-        local_kettle_family_release_target_branches.include?(branch)
+        targets = local_kettle_family_release_target_branches
+        return true if targets.include?(branch)
+
+        warn_undeclared_branch_stack_release(branch, targets)
+        false
       end
 
+      # A member whose family declares a branch stack, releasing a branch that
+      # is not in that list, gets merged into trunk and validated by a trunk
+      # PR. That is almost always a wrong-branch release, not a feature
+      # branch, so say so loudly instead of silently degrading.
+      def warn_undeclared_branch_stack_release(branch, targets)
+        declaring_root = family_declared_branch_stack_roots.first
+        return unless declaring_root
+        return if Array(@warned_undeclared_stack_branches).include?(branch)
+
+        @warned_undeclared_stack_branches = Array(@warned_undeclared_stack_branches) + [branch]
+        warn(
+          "[kettle-release] #{branch} is not a declared release branch for #{family_stack_gem_name.inspect} " \
+          "in #{Kettle::Dev.display_path(declaring_root)}; it will be treated as a feature branch and merged into trunk. " \
+          "Declared release branches: #{targets.join(", ")}"
+        )
+      end
+
+      # The member-local `.kettle-family.yml` is a templated copy that can be
+      # absent on a fresh branch or in a worktree. The family root is the
+      # authoritative declaration (`release.member_target_branches.<gem>`), so
+      # consult it too and union the two. Silently returning [] when a family
+      # config *does* declare a stack for this gem is what produced
+      # PR-against-trunk releases and trunk merges for branch-stack members.
       def local_kettle_family_release_target_branches
+        branches = []
         local_kettle_family_config_paths.each do |path|
           next unless File.file?(path)
 
-          begin
-            data = Kettle::Dev.safe_load_yaml_file(path) || {}
-            branches = Array(dig_string_keys(data, "release", "target_branches")) +
-              Array(dig_string_keys(data, "branches", "release_targets"))
-            return branches.map(&:to_s).reject(&:empty?) unless branches.empty?
-          rescue Psych::Exception => e
-            warn("Ignoring invalid kettle-family config #{Kettle::Dev.display_path(path)}: #{e.message}")
-          end
+          data = safe_load_kettle_family_config(path)
+          next unless data
+
+          branches.concat(
+            Array(dig_string_keys(data, "release", "target_branches")),
+            Array(dig_string_keys(data, "branches", "release_targets"))
+          )
+        end
+        branches.concat(family_root_release_target_branches)
+        branches.map(&:to_s).reject(&:empty?).uniq
+      end
+
+      def family_root_release_target_branches
+        family_declared_branch_stack_roots.flat_map do |path|
+          data = safe_load_kettle_family_config(path) || {}
+          Array(dig_string_keys(data, "release", "member_target_branches", family_stack_gem_name))
+        end
+      end
+
+      # Family-root configs that declare a non-empty branch stack for this gem.
+      def family_declared_branch_stack_roots
+        gem_name = family_stack_gem_name
+        return [] unless gem_name
+
+        family_root_config_paths.select do |path|
+          data = safe_load_kettle_family_config(path)
+          next false unless data
+
+          declared_stack_branches(data, gem_name).any?
+        end
+      end
+
+      # Only treat a parent directory as the family root when its config
+      # actually lists this checkout as a member root.
+      def family_root_config_paths
+        [File.expand_path("..", @root)].map do |candidate|
+          path = File.join(candidate, ".kettle-family.yml")
+          next nil unless File.file?(path)
+
+          data = safe_load_kettle_family_config(path)
+          next nil unless data
+
+          roots = Array(dig_string_keys(data, "members", "roots")).map(&:to_s)
+          path if roots.include?(File.basename(@root))
+        end.compact
+      end
+
+      def declared_stack_branches(data, gem_name)
+        Array(dig_string_keys(data, "release", "member_target_branches", gem_name)).map(&:to_s).reject(&:empty?)
+      end
+
+      # YAML loading is isolated in a method body so a malformed config is
+      # reported once instead of raising inside a block. Block-level `rescue`
+      # is a Ruby 2.6+ construct and this gem supports Ruby 2.4.
+      def safe_load_kettle_family_config(path)
+        Kettle::Dev.safe_load_yaml_file(path) || {}
+      rescue Psych::Exception => e
+        warn("Ignoring invalid kettle-family config #{Kettle::Dev.display_path(path)}: #{e.message}")
+        nil
+      end
+
+      def family_stack_gem_name
+        @family_stack_gem_name ||= begin
+          name = ENV.fetch("K_CHANGELOG_GEM_NAME", "").to_s.strip
+          name = detect_family_stack_gem_name_from_gemspec if name.empty?
+          name.empty? ? nil : name
         end
-        []
+      end
+
+      def detect_family_stack_gem_name_from_gemspec
+        gemspecs = Dir[File.join(@root, "*.gemspec")]
+        path = gemspecs.min
+        return "" unless path
+
+        match = File.read(path).match(/spec\.name\s*=\s*(["'])([^"']+)\1/)
+        match ? match[2].to_s : ""
       end
 
       def local_kettle_family_config_paths

data/lib/kettle/dev/version.rb

@@ -5,7 +5,7 @@ module Kettle
     # Version namespace for this gem.
     module Version
       # Current gem version.
-      VERSION = "3.1.6"
+      VERSION = "3.1.7"
     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.1.6
+  version: 3.1.7
 platform: ruby
 authors:
 - Peter H. Boling
@@ -256,7 +256,7 @@ dependencies:
         version: '3.2'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.2.4
+        version: 3.2.5
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -266,7 +266,7 @@ dependencies:
         version: '3.2'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.2.4
+        version: 3.2.5
 - !ruby/object:Gem::Dependency
   name: turbo_tests2
   requirement: !ruby/object:Gem::Requirement
@@ -276,7 +276,7 @@ dependencies:
         version: '3.2'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.2.11
+        version: 3.2.13
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -286,7 +286,7 @@ dependencies:
         version: '3.2'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.2.11
+        version: 3.2.13
 - !ruby/object:Gem::Dependency
   name: stone_checksums
   requirement: !ruby/object:Gem::Requirement
@@ -316,7 +316,7 @@ dependencies:
         version: '2.0'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.0.13
+        version: 2.0.15
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -326,7 +326,7 @@ dependencies:
         version: '2.0'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.0.13
+        version: 2.0.15
 description: "\U0001F372 Kettle::Dev is a meta tool from kettle-dev to streamline
   development and testing. Acts as a shim dependency, pulling in many other dependencies,
   to give you OOTB productivity with a RubyGem, or Ruby app project. Configures a
@@ -422,10 +422,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.1.6
-  changelog_uri: https://github.com/kettle-dev/kettle-dev/blob/v3.1.6/CHANGELOG.md
+  source_code_uri: https://github.com/kettle-dev/kettle-dev/tree/v3.1.7
+  changelog_uri: https://github.com/kettle-dev/kettle-dev/blob/v3.1.7/CHANGELOG.md
   bug_tracker_uri: https://github.com/kettle-dev/kettle-dev/issues
-  documentation_uri: https://www.rubydoc.info/gems/kettle-dev/3.1.6
+  documentation_uri: https://www.rubydoc.info/gems/kettle-dev/3.1.7
   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

metadata.gz.sig

@@ -1,5 +1 @@
-� a��E���R�������c�Hs�\��ſ(VO��ѻa��Y�H]��V~|�-������-��s�e9��N�O���:7W%�QC��
-)��a��]�m��Q7Ji�:V
CH����ʔ��iap3\�l���n[�+���;�j���E���מj�-�2�xʙ1
��D����f�٠r��F���v�?3DŽ�7aw�[D���j�H�䔆��H(6b3;��
-��+��_ʝ�3iiI�q��@�y.Y�o�����$�㥆7�ws;�$��'��G����e��
-r�f�.�eř�v�Ɲ%�W�GCk��l1n?
-N����G�
+Z5
-w�5��:��7�睹��%ڔ�����0cfe�Y1��w�4��Po+̆�K�,������aM΅n
�T�K�V�*E\�͕�u�M�C��v�0q�D��{@8��|�����@�W�4�0��qg�G�L��'y��k�a��B��i?���ND�&�n�	�lw��M�E�B���ݓ<��#�r��2�������E y�6�����h���M��A(G8	Q��̊�1)=9�|8�Tyo&�3Fc�Y�щ�J�P�D]NA�1bS�
Eђ��gJ�n���
e5�u�<���d�o uq�&:Ĭ)��]ve�������^����0��S��ۖ�K�J��GZ3��5��}�toe$l��яpb�	������Dz