kettle-family 1.2.41 → 1.2.42

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 06e650b41451e42fa21f02b33415452f6150a28f23a7201476d7b53898985836
-  data.tar.gz: 78d0efc3990b00ae0f89e9fb0e4ea1f187248cdfb23280492495cd119e4b5e42
+  metadata.gz: 157856f222f5dac0c7e19ebd7d09eda5f53d9e5653bed4f3639749233aa4463d
+  data.tar.gz: 4e39b78d092ed3047ac7a53b278bd5917f7becdb498166e0f5a5157a91f54000
 SHA512:
-  metadata.gz: 73a92a80cfa7c1774bdf4af3cdd36f5e9d56eaab91a350b3ef9ac2478d3c142f8843c732b2d7a5c5690dfb317a0fad2d855bead22054e5044cd08504d978e87d
-  data.tar.gz: 3266c134547b5a0001c1979d706b2d68bee48deea4b4f4fa787a833e8a47379c5d94e4b121885f5f99a9f81c0b1fedcd1099babbce9807c91ee269a9c5c403d9
+  metadata.gz: 3cd3ccf5433ec8a181a0ff453475ed76b7fcdd162e8496fdedf1b64b2469b3aa91e27492af034dcbb7e5005f877ff26e77bce5b62e9878ed83793046312977ae
+  data.tar.gz: c51400cee32ece6b7b8c1b5b978bbb98e7bc1c04cb8a1372578e03fd3a9ee4811884911e05aca3065d6831e8397f4d4688dabc8a1c8df1c609fbefd07936be2a

data/CHANGELOG.md

@@ -30,6 +30,23 @@ Please file a bug if you notice a violation of semantic versioning.
 
 ### Security
 
+## [1.2.42] - 2026-08-07
+
+- TAG: [v1.2.42][1.2.42t]
+- COVERAGE: 93.58% -- 5047/5393 lines in 32 files
+- BRANCH COVERAGE: 76.05% -- 2019/2655 branches in 32 files
+- 29.72% documented
+
+### Added
+
+- Support wave-aware release environments that shrink local sibling paths as selected dependencies become available from the registry.
+
+### Fixed
+
+- Preserve explicitly requested local dependency paths during family bundle updates while keeping default updates release-safe.
+
+- Keep aggregate monorepo GitHub-release execution out of release dry-runs.
+
 ## [1.2.41] - 2026-08-07
 
 - TAG: [v1.2.41][1.2.41t]
@@ -1924,7 +1941,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.41...HEAD
+[Unreleased]: https://github.com/kettle-dev/kettle-family/compare/v1.2.42...HEAD
+[1.2.42]: https://github.com/kettle-dev/kettle-family/compare/v1.2.41...v1.2.42
+[1.2.42t]: https://github.com/kettle-dev/kettle-family/releases/tag/v1.2.42
 [1.2.41]: https://github.com/kettle-dev/kettle-family/compare/v1.2.40...v1.2.41
 [1.2.41t]: https://github.com/kettle-dev/kettle-family/releases/tag/v1.2.41
 [1.2.40]: https://github.com/kettle-dev/kettle-family/compare/v1.2.39...v1.2.40

data/README.md

@@ -232,6 +232,7 @@ changelog:
 release:
   env:
     KETTLE_DEV_DEV: false
+  local_path_strategy: waves
   disable_local_path_env:
     - TSLP_DEV
   family_changelog:
@@ -249,6 +250,13 @@ env name is not the default derived from `family.name`.
 normalization shutoff list for path-injecting env vars that are not themselves
 discoverable as family roots, such as vendored parser/tooling paths.
 
+`release.local_path_strategy: waves` allows a release task to provide the
+family local-path environment as its default. Member release commands keep
+that path only while they have a selected sibling dependency that has not
+completed an earlier release wave; once the dependency is available, the
+member resolves it from the registry. Release lockfile normalization always
+disables local paths regardless of this strategy.
+
 For `changelog.mode: root`, release commands pass `K_CHANGELOG_GEM_NAME` as the
 configured family name and `K_CHANGELOG_VERSION_FILE` when `version_file` is
 configured, so `kettle-changelog` can operate from a repository root without a
@@ -837,7 +845,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-5.366-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
+[🧮kloc-img]: https://img.shields.io/badge/KLOC-5.393-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/config.rb

@@ -266,6 +266,10 @@ module Kettle
         stringify_env(fetch_path("release", "env") || {})
       end
 
+      def release_local_path_strategy
+        fetch_path("release", "local_path_strategy").to_s
+      end
+
       def release_secrets
         stringify_keys(fetch_path("release", "secrets") || {})
       end

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.41"
+      VERSION = "1.2.42"
     end
     # Current gem version exposed at the traditional constant location.
     VERSION = Version::VERSION # Traditional Constant Location

data/lib/kettle/family/workflow.rb

@@ -1013,6 +1013,7 @@ module Kettle
       def release_member_results(release_members, include_family_changelog: false)
         runner = release_command_runner
         results = []
+        @release_completed_member_names = []
         append_family_changelog_result(runner: runner, memo: results) if include_family_changelog
         return results unless results.all?(&:ok?)
         return parallel_release_member_results(release_members, results) if parallel_release_members?(release_members)
@@ -1025,6 +1026,7 @@ module Kettle
             break memo unless memo.last.ok?
 
             remaining_members = release_members.drop(release_members.index(member) + 1)
+            @release_completed_member_names << member.name
             append_dependency_floor_results(released_members: [member], dependent_members: remaining_members, runner: runner, memo: memo)
             break memo unless memo.last&.ok?
           end
@@ -1038,6 +1040,7 @@ module Kettle
         results = initial_results.dup
         waves = release_waves(release_members)
         completed_members = []
+        @release_completed_member_names = []
         release_progress = start_release_progress(release_members)
         @release_progress = release_progress
         begin
@@ -1048,6 +1051,7 @@ module Kettle
             break unless wave_results.all? { |member_results| member_results.all?(&:ok?) }
 
             completed_members.concat(wave)
+            @release_completed_member_names.concat(wave.map(&:name))
             remaining_members = release_members - completed_members
             append_dependency_floor_results(released_members: wave, dependent_members: remaining_members, runner: release_command_runner, memo: results)
             break unless results.last&.ok?
@@ -1936,6 +1940,7 @@ module Kettle
       # member release phase as well as to the separate family phase.
       def release_env_for_member(member)
         env = release_env
+        env.merge!(release_wave_local_path_env_for(member))
         if config.family_mode == "monorepo"
           # Monorepo members release from subdirectories, while CI workflows
           # live at the shared repository root.
@@ -1962,6 +1967,29 @@ module Kettle
         )
       end
 
+      # A release task may start with local sibling paths so a member can
+      # consume a selected dependency that has not been published yet. Once
+      # that dependency is complete in an earlier wave, use its registry
+      # release for the next member. Dependencies outside the selected set are
+      # already treated as registry dependencies; this is what makes resume
+      # runs work after an earlier wave has been published.
+      def release_wave_local_path_env_for(member)
+        return {} unless config.release_local_path_strategy == "waves"
+
+        env_name = config.family_local_path_env_name
+        return {} if env_name.to_s.empty?
+
+        local_value = release_env[env_name]
+        return {} unless local_path_env_value?(local_value)
+
+        selected_names = members.map(&:name)
+        completed_names = Array(@release_completed_member_names)
+        unresolved_selected_dependency = release_dependency_names(member).any? do |dependency|
+          selected_names.include?(dependency) && !completed_names.include?(dependency)
+        end
+        {env_name => unresolved_selected_dependency ? local_value : "false"}
+      end
+
       # simplecov:disable Covered by monorepo release integration, not sibling-repository suite.
       def aggregate_monorepo_github_release(members)
         version = members.map { |member| member.version.to_s }.uniq
@@ -1974,6 +2002,8 @@ module Kettle
         end
         command = ["bundle", "exec", "kettle-gh-release", "--allow-unpublished", "--release-version", version.first]
         assets.each { |asset| command.concat(["--asset", asset]) }
+        return aggregate_release_dry_run_result(command) unless execute
+
         env = release_env.merge(
           "K_CHANGELOG_GEM_NAME" => config.family_name.to_s,
           "K_CHANGELOG_PATH" => File.expand_path(config.changelog_path, config.root),
@@ -2019,6 +2049,22 @@ module Kettle
         )
       end
 
+      def aggregate_release_dry_run_result(command)
+        CommandResult.new(
+          member_name: config.family_name,
+          phase: "aggregate_github_release",
+          command: command,
+          workdir: config.root,
+          status: 0,
+          success: true,
+          stdout: "aggregate GitHub release dry-run; pass --execute to run\n",
+          stderr: "",
+          elapsed_seconds: 0.0,
+          skipped: true,
+          reason: "dry-run; pass --execute to run"
+        )
+      end
+
       def base_release_env
         env = config.release_env
         env["KETTLE_FAMILY_CONFIG"] = config.path if config.path
@@ -2401,7 +2447,18 @@ module Kettle
       end
 
       def bundle_update_env
-        workflow_env.merge(release_lockfile_local_path_env_overrides)
+        env = workflow_env.merge(release_lockfile_local_path_env_overrides)
+        explicit_local_path_env_overrides.each { |key, value| env[key] = value }
+        env
+      end
+
+      def explicit_local_path_env_overrides
+        ENV.to_h.merge(env_overrides).each_with_object({}) do |(key, value), overrides|
+          next unless key.end_with?("_DEV", "_LOCAL") || config.release_disable_local_path_env.include?(key)
+          next unless local_path_env_requested?(key)
+
+          overrides[key] = value
+        end
       end
 
       def monorepo_template?

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: kettle-family
 version: !ruby/object:Gem::Version
-  version: 1.2.41
+  version: 1.2.42
 platform: ruby
 authors:
 - Peter H. Boling
@@ -74,7 +74,7 @@ dependencies:
         version: '2.3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.5.24
+        version: 2.5.25
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -84,7 +84,7 @@ dependencies:
         version: '2.3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.5.24
+        version: 2.5.25
 - !ruby/object:Gem::Dependency
   name: kettle-test
   requirement: !ruby/object:Gem::Requirement
@@ -360,10 +360,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.41
-  changelog_uri: https://github.com/kettle-dev/kettle-family/blob/v1.2.41/CHANGELOG.md
+  source_code_uri: https://github.com/kettle-dev/kettle-family/tree/v1.2.42
+  changelog_uri: https://github.com/kettle-dev/kettle-family/blob/v1.2.42/CHANGELOG.md
   bug_tracker_uri: https://github.com/kettle-dev/kettle-family/issues
-  documentation_uri: https://www.rubydoc.info/gems/kettle-family/1.2.41
+  documentation_uri: https://www.rubydoc.info/gems/kettle-family/1.2.42
   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