kettle-family 0.1.28 → 0.1.29

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 064f3f14703f9a178aba7cb549a0c55139f52397caa413adafa1137e44e504bb
-  data.tar.gz: c1c7ae833d6b815d7f7a52ba287fa186d51be53b09ab4e91d442b2cc6e94ab44
+  metadata.gz: 8f2d2daae978ae39fac490631b4c3e50177da30f9d386eb1bc51aa6e97e00cee
+  data.tar.gz: 2f054f861e0f108fae73f251bf1b95402f9500d9aafeea012bc2b0eff116fd26
 SHA512:
-  metadata.gz: 9c71cc770c2d719561d0d6ef91d4c43a329ac75559cebaaf62732efbc0dd02f03e52684d9fa60ff26ac5ea1ad785c51af7e33e56573dc270b6def694d9bfec39
-  data.tar.gz: 9a4bc82e5d51c3ff52ccc5b93243c6c36a55e4769b29c0f17f320f1386f1336908acddca9e7dcf508e04680717262a63e6e80c47d5d5aaafdd569ba87fc0d12a
+  metadata.gz: 7aeb45976878075ff4ab19b00e01bf664d105307e9494d36bcff52ef0967b989b6526689dcfbeed7492b7bbad2f639f4ef3a78fe5948937c241362e5849c57f8
+  data.tar.gz: 7f90c138396b126b1d12768a1a04cd737b8b1699584de3d79148dbee01f4cbed02bab85f503aa3772f193deff792e2be6e5029450c9827f4e2c6dc57b3bbb41b

data/CHANGELOG.md

@@ -30,6 +30,25 @@ Please file a bug if you notice a violation of semantic versioning.
 
 ### Security
 
+## [0.1.29] - 2026-06-28
+
+- TAG: [v0.1.29][0.1.29t]
+- COVERAGE: 95.29% -- 1922/2017 lines in 21 files
+- BRANCH COVERAGE: 75.14% -- 668/889 branches in 21 files
+- 38.37% documented
+
+### Added
+
+- `kettle-family --only` now accepts comma-separated member names for subset
+  workflows.
+- Parallel `kettle-family release` output now includes derived release waves so
+  dependency-safe release groups are visible.
+
+### Fixed
+
+- Parallel `kettle-family release` waves now stop assigning queued releases as
+  soon as any member fails.
+
 ## [0.1.28] - 2026-06-28
 
 - TAG: [v0.1.28][0.1.28t]
@@ -495,7 +514,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/v0.1.28...HEAD
+[Unreleased]: https://github.com/kettle-dev/kettle-family/compare/v0.1.29...HEAD
+[0.1.29]: https://github.com/kettle-dev/kettle-family/compare/v0.1.28...v0.1.29
+[0.1.29t]: https://github.com/kettle-dev/kettle-family/releases/tag/v0.1.29
 [0.1.28]: https://github.com/kettle-dev/kettle-family/compare/v0.1.27...v0.1.28
 [0.1.28t]: https://github.com/kettle-dev/kettle-family/releases/tag/v0.1.28
 [0.1.27]: https://github.com/kettle-dev/kettle-family/compare/v0.1.26...v0.1.27

data/README.md

@@ -571,7 +571,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-1.994-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
+[🧮kloc-img]: https://img.shields.io/badge/KLOC-2.017-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/cli.rb

@@ -80,7 +80,7 @@ module Kettle
           Options:
               --root PATH      Workspace or family root (default: current directory)
               --config PATH    Family config path
-              --only MEMBER    Select exactly one member
+              --only MEMBERS   Select comma-separated members
               --start-at NAME  Select from member through the end of order; use MEMBER@BRANCH for branch stacks
               --json           Print JSON report to stdout
               --report PATH    Write JSON report to PATH

data/lib/kettle/family/report.rb

@@ -59,6 +59,7 @@ module Kettle
           marker = selected_names.include?(member.name) ? "*" : "-"
           lines << "  #{marker} #{member.name} #{member.version} #{member.root}"
         end
+        append_release_waves(lines)
         append_results(lines)
         lines.join("\n")
       end
@@ -74,8 +75,11 @@ module Kettle
         return if results.empty?
         return append_release_state_results(lines) if command == "release-state"
 
+        visible_results = results.reject { |result| release_wave_result?(result) }
+        return if visible_results.empty?
+
         lines << "results:"
-        results.each do |result|
+        visible_results.each do |result|
           lines << "  #{result_state(result)} #{result.member_name} #{result.phase} #{result.reason || ""}".rstrip
           append_indented_output(lines, result.stdout) unless suppress_success_output?(result)
           append_indented_output(lines, result.stderr) if !result.ok? && !result.stderr.to_s.empty?
@@ -84,6 +88,20 @@ module Kettle
         append_template_summary(lines) if command == "template"
       end
 
+      def append_release_waves(lines)
+        wave_results = results.select { |result| release_wave_result?(result) }
+        return if wave_results.empty?
+
+        lines << "release waves:"
+        wave_results.each do |result|
+          lines << "  #{result.member_name}: #{result.stdout} (#{result.reason})"
+        end
+      end
+
+      def release_wave_result?(result)
+        result.phase == "release_wave"
+      end
+
       def append_indented_output(lines, output)
         output.to_s.each_line(chomp: true) { |line| lines << "    #{line}" }
       end

data/lib/kettle/family/selection.rb

@@ -21,10 +21,13 @@ module Kettle
       attr_reader :members
 
       def select_only(selected, only)
-        member = selected.find { |candidate| candidate.name == only }
-        raise Error, "unknown member #{only.inspect}" unless member
+        names = only.split(",").map(&:strip).reject(&:empty?)
+        raise Error, "--only requires at least one member" if names.empty?
 
-        [member]
+        unknown = names - members.map(&:name)
+        raise Error, "unknown member(s): #{unknown.join(", ")}" unless unknown.empty?
+
+        selected.select { |candidate| names.include?(candidate.name) }
       end
 
       def select_start_at(selected, start_at)

data/lib/kettle/family/version.rb

@@ -3,7 +3,7 @@
 module Kettle
   module Family
     module Version
-      VERSION = "0.1.28"
+      VERSION = "0.1.29"
     end
     VERSION = Version::VERSION # Traditional Constant Location
   end

data/lib/kettle/family/workflow.rb

@@ -268,7 +268,9 @@ module Kettle
 
       def parallel_release_member_results(release_members, initial_results)
         results = initial_results.dup
-        release_waves(release_members).each do |wave|
+        waves = release_waves(release_members)
+        waves.each_with_index do |wave, index|
+          results << release_wave_result(wave, index: index, total: waves.length)
           wave_results = run_release_wave(wave)
           results.concat(wave_results.flatten)
           break unless wave_results.all? { |member_results| member_results.all?(&:ok?) }
@@ -281,13 +283,21 @@ module Kettle
         wave.each_with_index { |member, index| queue << [index, member] }
         ordered_results = Array.new(wave.length)
         wave_jobs = release_jobs(wave)
+        mutex = Mutex.new
+        stop = false
         release_otp_coordinator&.queue_total = wave_jobs
         Array.new(wave_jobs) do
           Thread.new do # rubocop:disable ThreadSafety/NewThread -- family release intentionally runs independent members concurrently.
             runner = release_command_runner
             loop do
+              break if mutex.synchronize { stop }
+
               index, member = queue.pop(true)
-              ordered_results[index] = release_results_for_member(member, runner: runner)
+              member_results = release_results_for_member(member, runner: runner)
+              mutex.synchronize do
+                ordered_results[index] = member_results
+                stop = true unless member_results.all?(&:ok?)
+              end
             rescue ThreadError
               break
             end
@@ -296,6 +306,22 @@ module Kettle
         ordered_results.compact
       end
 
+      def release_wave_result(wave, index:, total:)
+        CommandResult.new(
+          member_name: "wave #{index + 1}",
+          phase: "release_wave",
+          command: ["internal", "release-wave"],
+          workdir: config.root,
+          status: 0,
+          success: true,
+          stdout: wave.map(&:name).join(", "),
+          stderr: "",
+          elapsed_seconds: 0.0,
+          skipped: false,
+          reason: "jobs=#{release_jobs(wave)} total=#{total}"
+        )
+      end
+
       def release_results_for_member(member, runner:)
         [].tap do |memo|
           if skip_already_released?(member)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: kettle-family
 version: !ruby/object:Gem::Version
-  version: 0.1.28
+  version: 0.1.29
 platform: ruby
 authors:
 - Peter H. Boling
@@ -80,7 +80,7 @@ dependencies:
         version: '2.2'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.2.20
+        version: 2.2.23
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -90,7 +90,7 @@ dependencies:
         version: '2.2'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.2.20
+        version: 2.2.23
 - !ruby/object:Gem::Dependency
   name: bundler-audit
   requirement: !ruby/object:Gem::Requirement
@@ -222,7 +222,7 @@ dependencies:
         version: '1.0'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.0.3
+        version: 1.0.4
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -232,7 +232,7 @@ dependencies:
         version: '1.0'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.0.3
+        version: 1.0.4
 - !ruby/object:Gem::Dependency
   name: gitmoji-regex
   requirement: !ruby/object:Gem::Requirement
@@ -310,10 +310,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/v0.1.28
-  changelog_uri: https://github.com/kettle-dev/kettle-family/blob/v0.1.28/CHANGELOG.md
+  source_code_uri: https://github.com/kettle-dev/kettle-family/tree/v0.1.29
+  changelog_uri: https://github.com/kettle-dev/kettle-family/blob/v0.1.29/CHANGELOG.md
   bug_tracker_uri: https://github.com/kettle-dev/kettle-family/issues
-  documentation_uri: https://www.rubydoc.info/gems/kettle-family/0.1.28
+  documentation_uri: https://www.rubydoc.info/gems/kettle-family/0.1.29
   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