kettle-family 1.2.98 → 1.2.99

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a170049375aa0330277e878596e92a61b58655a29ca9aeba1e9ab0006fa46c04
-  data.tar.gz: 5bfcd0c99c774fad470b8510188e6eaad700c2ca3157f64eb1a9b52ac320d6c6
+  metadata.gz: e3fff3ab628dc6f5338ddf0a820485b986ce5f40aec27a905f1ee15e18450ab9
+  data.tar.gz: fa34533d50ee506f05e2f1cd9f865c011d12e91996b1c38cbabfe76eb0f9c676
 SHA512:
-  metadata.gz: c527202894d4bca3ada36684b9a7f3700052ebd53967ebb7ea7a65cc0db5cc20a5bf04eec6730f380a444fd69ed6828428fc29e16a1718371eab48eea0647601
-  data.tar.gz: b147945409bca869bf23ea6ab8773b7fc8fc6c7677ef877367d2970b3c73edb1efe628606c267de48f58af8cb4db761d527ce8df457b1fe6d4f729ae8c662229
+  metadata.gz: 81f62b1263cd2afbe483f7af09d0a4c1b3e4efac0328938592c84e381d5d731188031e1e9dad97ce343573b025a50d9de62424ce92d12be7245beced5de9996d
+  data.tar.gz: 95713fbc85dd8e285b7b94364bfe799735df2d2b9f19b1205d2ad0819d793f66c94e39aa3b3816826b2987dacabc14519e24f01a0447f29af1edb55567d49f95

data/CHANGELOG.md

@@ -30,6 +30,19 @@ Please file a bug if you notice a violation of semantic versioning.
 
 ### Security
 
+## [1.2.99] - 2026-09-09
+
+- TAG: [v1.2.99][1.2.99t]
+- COVERAGE: 93.52% -- 6261/6695 lines in 35 files
+- BRANCH COVERAGE: 78.19% -- 2542/3251 branches in 35 files
+- 32.75% documented
+
+### Fixed
+
+- Keep resumed family releases on the prepared CI commit by skipping dependency-floor reconciliation and disabling sibling paths for child release validation.
+
+- Scope branch-stack release resumes to the prepared branch so later targets run their complete release lifecycle before CI monitoring.
+
 ## [1.2.98] - 2026-09-09
 
 - TAG: [v1.2.98][1.2.98t]
@@ -2692,7 +2705,9 @@ Please file a bug if you notice a violation of semantic versioning.
 - Fixed CI load failures on engines without compatible `pty` support by falling back to Open3 for interactive release commands.
 - Fixed Ruby 3.2 version-bump support by loading Prism lazily and wiring the Prism gem only for MRI versions that need it.
 
-[Unreleased]: https://github.com/kettle-dev/kettle-family/compare/v1.2.98...HEAD
+[Unreleased]: https://github.com/kettle-dev/kettle-family/compare/v1.2.99...HEAD
+[1.2.99]: https://github.com/kettle-dev/kettle-family/compare/v1.2.98...v1.2.99
+[1.2.99t]: https://github.com/kettle-dev/kettle-family/releases/tag/v1.2.99
 [1.2.98]: https://github.com/kettle-dev/kettle-family/compare/v1.2.97...v1.2.98
 [1.2.98t]: https://github.com/kettle-dev/kettle-family/releases/tag/v1.2.98
 [1.2.97]: https://github.com/kettle-dev/kettle-family/compare/v1.2.96...v1.2.97

data/README.md

@@ -435,6 +435,12 @@ metadata fix requires a new full release run from step 0:
 kettle-family release --publish --start-step 10 --local-ci
 ```
 
+For `release.target_branches`, a resume position applies only to the first
+selected branch, which is the one whose already-pushed release commit is being
+resumed. Each later branch starts from step 0 so it creates, commits, and pushes
+its own release candidate before `kettle-release` begins remote CI monitoring.
+Use `--start-at member@branch` when the resumed branch is not the first target.
+
 `--skip-changelog` skips only `kettle-changelog`; `--skip-appraisals` skips
 only the Appraisal generation portion of release step 5 and still runs
 `bin/rake yard`; and `--skip-ci` skips only remote CI monitoring. The generic
@@ -1180,7 +1186,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.679-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
+[🧮kloc-img]: https://img.shields.io/badge/KLOC-6.695-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
 [🔐security]: https://github.com/kettle-dev/kettle-family/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/family/version.rb

@@ -5,7 +5,7 @@ module Kettle
     # Version namespace for this gem.
     module Version
       # Current gem version.
-      VERSION = "1.2.98"
+      VERSION = "1.2.99"
     end
     # Current gem version exposed at the traditional constant location.
     VERSION = Version::VERSION # Traditional Constant Location

data/lib/kettle/family/workflow.rb

@@ -1492,7 +1492,7 @@ module Kettle
             memo.concat(template_branch_sync_results(branch_members, runner: runner))
             break memo unless memo.last&.ok?
           end
-          branch_results = current_branch_results(branch_members)
+          branch_results = with_release_branch_resume_scope { current_branch_results(branch_members) }
           tag_branch_results(branch_results, branch)
           memo.concat(branch_results)
 
@@ -2604,6 +2604,10 @@ module Kettle
       end
 
       def release_dependency_floor_reconciliation_results(release_members)
+        # A step resume must continue the already-prepared release commit.
+        # Reconciliation can rewrite lockfiles and create a new commit, which
+        # invalidates the CI SHA selected by the caller's --start-step.
+        return [] if release_step_resume?
         return [] unless execute && auto_dependency_floors
         # Monorepo members intentionally keep their family dependencies as
         # paths in the canonical development lockfile. Registry reconciliation
@@ -2671,6 +2675,7 @@ module Kettle
       end
 
       def append_dependency_floor_results(released_members:, dependent_members:, runner:, memo:)
+        return if release_step_resume?
         return unless auto_dependency_floors
         return if dependent_members.empty?
 
@@ -3486,11 +3491,33 @@ module Kettle
       end
 
       def release_start_step_for(member)
+        return nil if release_branch_resume_scoped? && !@release_branch_resume_active
         return start_step unless fast_recovery_for?(member)
 
         (fast_recovery == "retry-ci") ? 10 : 11
       end
 
+      # A release resume identifies one already-prepared branch commit. Later
+      # branches in the same stack still need their complete lifecycle: build,
+      # commit, push, and only then CI monitoring. Do not carry start_step (or
+      # named CI recovery) beyond that first branch.
+      def with_release_branch_resume_scope
+        return yield unless release_branch_resume_scoped?
+
+        previous = @release_branch_resume_active
+        @release_branch_resume_active = !@release_branch_resume_consumed
+        yield
+      ensure
+        @release_branch_resume_consumed = true if @release_branch_resume_active
+        @release_branch_resume_active = previous
+      end
+
+      def release_branch_resume_scoped?
+        command == "release" &&
+          !config.release_target_branches.empty? &&
+          (!start_step.nil? || !fast_recovery.nil?)
+      end
+
       def release_skip_steps_for(member)
         steps = Array(skip_steps).flat_map { |entry| entry.to_s.split(",") }.map(&:strip).reject(&:empty?)
         steps << "10" if skip_ci
@@ -3641,6 +3668,13 @@ module Kettle
         env = execution_profile(release_bootstrap_execution_profile, release_env)
         env.merge!(release_wave_local_path_env_for(member, family_root: family_root))
         env.merge!(release_local_path_policy_env(family_root: family_root))
+        # A resumed child kettle-release starts in the member's mise
+        # environment after the release candidate was already prepared.
+        # Disable sibling paths so mise cannot reactivate them before the
+        # resumed release validates that immutable lockfile. A new release
+        # retains the staged local-graph policy until kettle-release reaches
+        # its own release-lockfile boundary.
+        env.merge!(release_lockfile_local_path_env_overrides(member)) if release_step_resume?
         # Family release performs one live pin review before member releases.
         # Child kettle-release must consume that reviewed cache instead of
         # repeating the GitHub API lookup for every member.
@@ -5390,6 +5424,10 @@ module Kettle
         !start_step.nil? || !skip_steps.to_s.empty? || fast_recovery || skip_ci
       end
 
+      def release_step_resume?
+        !start_step.nil? || !skip_steps.to_s.empty?
+      end
+
       def execution_profile(profile, env)
         profile = ExecutionProfile.fetch(profile) unless profile.is_a?(ExecutionProfile::Definition)
         env = env.dup

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: kettle-family
 version: !ruby/object:Gem::Version
-  version: 1.2.98
+  version: 1.2.99
 platform: ruby
 authors:
 - Peter H. Boling
@@ -443,10 +443,10 @@ licenses:
 - AGPL-3.0-only
 metadata:
   homepage_uri: https://kettle-family.galtzo.com
-  source_code_uri: https://github.com/kettle-dev/kettle-family/tree/v1.2.98
-  changelog_uri: https://github.com/kettle-dev/kettle-family/blob/v1.2.98/CHANGELOG.md
+  source_code_uri: https://github.com/kettle-dev/kettle-family/tree/v1.2.99
+  changelog_uri: https://github.com/kettle-dev/kettle-family/blob/v1.2.99/CHANGELOG.md
   bug_tracker_uri: https://github.com/kettle-dev/kettle-family/issues
-  documentation_uri: https://www.rubydoc.info/gems/kettle-family/1.2.98
+  documentation_uri: https://www.rubydoc.info/gems/kettle-family/1.2.99
   funding_uri: https://github.com/sponsors/pboling
   wiki_uri: https://github.com/kettle-dev/kettle-family/wiki
   news_uri: https://www.railsbling.com/tags/kettle-family