kettle-family 1.3.0 → 1.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c2e7e86419a5d960e83f3e8f7cb5aa1348f5acbe217b02b43e27ca479b9dafd9
-  data.tar.gz: cb5de478d104da8759b0746db6a58f415afb768aae9cd6622e3b4d2a42cdbd09
+  metadata.gz: ce61863e305027b86eef8097ce594d8a9b77ba0e9e043ecb1617be9722a5ae38
+  data.tar.gz: 2b61292cbe3fcabb567c8f47ab7bac6170782dcedf75366452bb171b29b5a96a
 SHA512:
-  metadata.gz: a60488bf1fc40699a0317e52d6b62318bf0eb243cc42f6950b39b1f7e2e785e7be4de6163a436057d2fcef5a602446dd1acbce249f6ecad7912ccfbc947d7526
-  data.tar.gz: 7c35f5fb09c6edbd5dc63235c0e3a97b69e9aa21a2dffff7c453fa557ab54f9383b7d1d69a9d08972bd1a7f078352dff5cc32991e203d588765570eaecc3ed18
+  metadata.gz: 47d6f2b5ebe4cbb0480c75037f702aba4eacf8185758df0724922d5cf2780d15a6c742d92e4d0bbdb55e64d3272c41a9ee3db8d46ad4e3bb39fedcc82427c25e
+  data.tar.gz: 1b0db917fd48cfe90aee4f6d00909ea667b9aab0bd9ac13704039a0117878f0f46d6ef6a5f1ef3f7e23a81858ef6f3aa2966d219127826a664c7c640f15da160

data/CHANGELOG.md

@@ -30,6 +30,21 @@ Please file a bug if you notice a violation of semantic versioning.
 
 ### Security
 
+## [1.3.1] - 2026-09-10
+
+- TAG: [v1.3.1][1.3.1t]
+- COVERAGE: 93.48% -- 6352/6795 lines in 36 files
+- BRANCH COVERAGE: 77.98% -- 2582/3311 branches in 36 files
+- 33.49% documented
+
+### Fixed
+
+- Honor configured ordering in release-state reports, emit all five phases for shared-changelog members, and distinguish missing exact GitHub releases from lookup errors.
+
+- Publish shared monorepo GitHub releases incrementally after each finalized member, retain successful workers from interrupted waves, attach both checksum formats, and report redundant family state cells once.
+
+- Keep independent monorepo GitHub release identities exact and avoid false unlisted-member warnings during filtered state inspection.
+
 ## [1.3.0] - 2026-09-10
 
 - TAG: [v1.3.0][1.3.0t]
@@ -2731,7 +2746,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.3.0...HEAD
+[Unreleased]: https://github.com/kettle-dev/kettle-family/compare/v1.3.1...HEAD
+[1.3.1]: https://github.com/kettle-dev/kettle-family/compare/v1.3.0...v1.3.1
+[1.3.1t]: https://github.com/kettle-dev/kettle-family/releases/tag/v1.3.1
 [1.3.0]: https://github.com/kettle-dev/kettle-family/compare/v1.2.100...v1.3.0
 [1.3.0t]: https://github.com/kettle-dev/kettle-family/releases/tag/v1.3.0
 [1.2.100]: https://github.com/kettle-dev/kettle-family/compare/v1.2.99...v1.2.100

data/README.md

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

@@ -684,10 +684,10 @@ module Kettle
         members = discovery.members
         ordered = if command == "install"
           install_order(members, config)
-        elsif %w[metadata release-state].include?(command)
+        elsif command == "metadata"
           members.sort_by(&:name)
         else
-          Orderer.new(members: members, mode: config.order_mode, hints: config.order_hints).ordered
+          Orderer.new(members: members, mode: config.order_mode, hints: config.order_hints).ordered(allow_cycles: command == "release-state")
         end
         state_event_tape = release_state_event_tape(command: command, config: config, options: options)
         Selection.validate_release_state_only_filter!(effective_only)

data/lib/kettle/family/discovery.rb

@@ -92,7 +92,9 @@ module Kettle
       def warn_unlisted_discovered_members(discovered, configured)
         return unless config.configured_member_roots? || config.explicit_members.any?
 
-        configured_roots = configured.map { |member| normalized_path(member.root) }
+        # Selection limits evaluation, not membership in the configuration.
+        roots = configured.map(&:root) + config.configured_member_roots + config.explicit_members.map { |entry| entry.fetch("root") }
+        configured_roots = roots.map { |root| normalized_path(root) }
         discovered.each do |member|
           next if configured_roots.include?(normalized_path(member.root))
 

data/lib/kettle/family/orderer.rb

@@ -14,7 +14,7 @@ module Kettle
         @by_name = members.to_h { |member| [member.name, member] }
       end
 
-      def ordered
+      def ordered(allow_cycles: false)
         case mode
         when "dependency"
           tsort
@@ -24,6 +24,9 @@ module Kettle
           raise Error, "unknown order mode #{mode.inspect}"
         end
       rescue TSort::Cyclic => error
+        # Read-only state inspection must remain available to diagnose cycles.
+        return hinted_members if allow_cycles
+
         raise Error, "dependency cycle detected: #{error.message}"
       end
 

data/lib/kettle/family/release_state_check.rb

@@ -152,8 +152,11 @@ module Kettle
         success = status.success?
         emit_event(event_handler, member: member, branch: branch, action: "changelog_command", status: success ? "ok" : "failed", elapsed_seconds: elapsed, status_code: status.exitstatus)
         state = success ? JSON.parse(stdout) : {}
+        emit_event(event_handler, member: member, branch: branch, action: "computed_booleans", status: "running") if success
         state = state_with_computed_booleans(state) if success
+        state["shared_changelog_root"] = File.expand_path(config.root) if success
         state = branch_filtered_state(member, state, branch) if success && branch
+        emit_event(event_handler, member: member, branch: branch, action: "computed_booleans", status: "ok") if success
         emit_event(event_handler, member: member, branch: branch, action: "git_state", status: "running") if success
         state = enrich_git_state(member.root, state, branch: branch) if success
         emit_event(event_handler, member: member, branch: branch, action: "git_state", status: "ok") if success
@@ -391,11 +394,12 @@ module Kettle
       end
 
       def enrich_github_release(root, state, branch: nil, member: nil)
-        tag = if branch || shared_root_member?(member)
-          github_release_for_version(root, state["latest_released"])
-        else
-          github_latest_release(root)
+        # A shared repository can publish an independent member after (or
+        # before) the cohort. Repository-wide "latest" cannot identify either.
+        if branch || shared_changelog?
+          return state.merge(github_release_for_version(root, state["latest_released"]))
         end
+        tag = github_latest_release(root)
         return state unless tag
 
         state.merge("github_latest_release" => tag)
@@ -406,16 +410,24 @@ module Kettle
       end
 
       def github_release_for_version(root, version)
-        return nil if version.to_s.empty?
+        return {} if version.to_s.empty?
 
         repo = github_repo_slug(root)
-        return nil unless repo
+        return {} unless repo
 
         tag = "v#{version.to_s.delete_prefix("v")}"
-        stdout, _stderr, status = Open3.capture3("gh", "release", "view", tag, "--repo", repo, "--json", "tagName", "--jq", ".tagName")
-        status.success? ? normalize_github_release_tag(stdout) : nil
-      rescue SystemCallError
-        nil
+        stdout, stderr, status = Open3.capture3("gh", "release", "view", tag, "--repo", repo, "--json", "tagName", "--jq", ".tagName")
+        return {"github_latest_release" => normalize_github_release_tag(stdout)} if status.success?
+
+        # A missing exact release is not a failed lookup, nor permission to
+        # substitute an independently versioned member's latest release.
+        {
+          "github_release_status" => (stderr.strip == "release not found") ? "missing" : "error",
+          "github_expected_release" => tag,
+          "github_release_error" => stderr.strip
+        }
+      rescue SystemCallError => error
+        {"github_release_status" => "error", "github_release_error" => error.message}
       end
 
       def enrich_transfer_changelog_lag(root, state)

data/lib/kettle/family/report.rb

@@ -554,9 +554,28 @@ module Kettle
         lines << "  count columns:"
         lines << "    T(n): filter-aware kettle-jem transfer changelog lag; n is the total source entry count and row values are missing / applicable (x excluded-present)"
         rows = release_state_header
+        shared_rows = {}
         results.each do |result|
-          rows << release_state_row(result)
+          row = release_state_row(result)
+          state = result.state || {}
+          shared_root = state["shared_changelog_root"]
+          if shared_root
+            # Only explicit shared-changelog cohorts share presentation. Keep
+            # member versions, registry state, transfer filters and flags intact.
+            key = [shared_root, result.branch, state["latest_released"]]
+            offset = release_state_has_branches? ? 1 : 0
+            shared_columns = [1, 3, 5, 7]
+            if shared_rows.key?(key)
+              shared_columns.each do |column|
+                row[column + offset] = "-" if row[column + offset] == shared_rows[key][column + offset]
+              end
+            else
+              shared_rows[key] = row.dup
+            end
+          end
+          rows << row
         end
+        lines << "  -: shared family value reported on the first matching cohort row" unless shared_rows.empty?
         lines.concat(format_table(rows).map { |line| "  #{line}" })
         failures = results.reject(&:ok?)
         return if failures.empty?
@@ -615,6 +634,9 @@ module Kettle
       end
 
       def release_state_github_release(state)
+        lookup_status = state["github_release_status"]
+        return lookup_status if %w[missing error].include?(lookup_status)
+
         github_release = state.fetch("github_latest_release", nil).to_s
         return "unknown" if github_release.empty?
 

data/lib/kettle/family/version.rb

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

data/lib/kettle/family/workflow.rb

@@ -533,7 +533,7 @@ module Kettle
           return results unless results.all?(&:ok?)
 
           results.concat(release_member_results(workflow_members, include_family_changelog: !skip_changelog))
-          return results unless explicit_monorepo_mode? && results.all?(&:ok?)
+          return results unless !execute && explicit_monorepo_mode? && results.all?(&:ok?)
 
           selected_aggregate_members = aggregate_release_members(workflow_members)
           results << aggregate_monorepo_github_release(aggregate_github_release_members) unless selected_aggregate_members.empty?
@@ -2128,6 +2128,9 @@ module Kettle
               results.concat(release_results_for_member(member, runner: runner, wave_jobs: 1))
               break unless results.last.ok?
 
+              append_member_github_release(member, results)
+              break unless results.last.ok?
+
               remaining_members = ordered_members.drop(ordered_members.index(member) + 1)
               @release_completed_member_names << member.name
               append_dependency_floor_results(released_members: [member], dependent_members: remaining_members, runner: runner, memo: results)
@@ -2217,10 +2220,15 @@ module Kettle
             unless aggregate_members.empty?
               worker_results = run_monorepo_release_wave(aggregate_members, wave_jobs: release_jobs(aggregate_members))
               results.concat(worker_results.flatten)
-              break unless worker_results.all? { |member_results| member_results.all?(&:ok?) }
-
-              finalization_results = finalize_monorepo_release_wave(aggregate_members)
+              # Finalize published successes even when another worker failed.
+              # Otherwise interruption strands registry gems without GH assets.
+              successful_members = aggregate_members.select do |member|
+                member_results = worker_results.flatten.select { |result| result.member_name == member.name }
+                member_results.any? { |result| result.phase == "release_publish" && result.ok? } && member_results.all?(&:ok?)
+              end
+              finalization_results = finalize_monorepo_release_wave(successful_members)
               results.concat(finalization_results)
+              break unless worker_results.all? { |member_results| member_results.all?(&:ok?) }
               break unless finalization_results.all?(&:ok?)
             end
 
@@ -2425,17 +2433,28 @@ module Kettle
             passthrough_output: release_command_passthrough_output?
           )
           break unless results.last.ok?
-        end
-        return results unless results.all?(&:ok?)
 
-        results << runner.call(
-          member: monorepo_release_control_member,
-          phase: "release_shared_push",
-          command: config.release_push_command
-        )
+          results << runner.call(
+            member: monorepo_release_control_member,
+            phase: "release_shared_push",
+            command: config.release_push_command
+          )
+          break unless results.last.ok?
+
+          append_member_github_release(member, results)
+          break unless results.last.ok?
+        end
         results
       end
 
+      def append_member_github_release(member, results)
+        return unless execute && publish && aggregate_monorepo_github_release? && aggregate_release_member?(member)
+
+        # Existing assets are retained by kettle-gh-release. Only contribute
+        # this successfully published member, never a merely built future gem.
+        results << aggregate_monorepo_github_release([member])
+      end
+
       def ensure_monorepo_release_tag(member, runner:)
         version = member.version.to_s
         tag = release_tag_name(version)
@@ -3762,8 +3781,8 @@ module Kettle
 
         assets = members.flat_map do |member|
           gem_path = Dir[File.join(member.root, "pkg", "*.gem")].select { |path| File.basename(path).end_with?("-#{version.first}.gem") }
-          checksum_path = File.join(member.root, "checksums", "#{member.name}-#{version.first}.gem.sha256")
-          gem_path + (File.file?(checksum_path) ? [checksum_path] : [])
+          checksum_paths = %w[sha256 sha512].map { |algorithm| File.join(member.root, "checksums", "#{member.name}-#{version.first}.gem.#{algorithm}") }
+          gem_path + checksum_paths.select { |path| File.file?(path) }
         end
         command = ["bundle", "exec", "kettle-gh-release", "--allow-unpublished", "--events", "--release-version", version.first]
         assets.each { |asset| command.concat(["--asset", asset]) }

data.tar.gz.sig

@@ -1,3 +1 @@
-]ez��h(F>Lb��1��_��ޭ��&2V����1����
�m�����4_�C�M�W�����`8��7���x7XF�
���`;�MD��!����2��D`!р�����JV\����"�>�T�7´۱b����n¯�
-K������f�j6�/;kA�z���T�^%m�qOJ�L�e��K2(`Q��"��C�AdM��9$Ȍ/�����*�
-�Ҙ#�+C)�p?)�á�%(*�:��M�p���T��CZv�Iw��}���:y��w1�&ُ:{H�׫��]d~��6G�g=�ԃ2&
ZL���0[�b��)P��7�����W�u�y�\jNes�w�rK�ePN����
+������փw54|���5\3�™�}%�sA���K&��yTt�U��[�ZV}x�����Ao��1��°QW;8��}b�yoau�\���O:4��ތК?�E(��4��~�ܶZ��N�r��pl�u4�M�Qf�&^�Y��j��K�]�5!�`Y�“X?;�wD�;1j��S��X*oЍ�������F�*VU0�]��ע���F������R�QA��|4��7��$��&�2�F*di���C��s�����rB�

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: kettle-family
 version: !ruby/object:Gem::Version
-  version: 1.3.0
+  version: 1.3.1
 platform: ruby
 authors:
 - Peter H. Boling
@@ -444,10 +444,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.3.0
-  changelog_uri: https://github.com/kettle-dev/kettle-family/blob/v1.3.0/CHANGELOG.md
+  source_code_uri: https://github.com/kettle-dev/kettle-family/tree/v1.3.1
+  changelog_uri: https://github.com/kettle-dev/kettle-family/blob/v1.3.1/CHANGELOG.md
   bug_tracker_uri: https://github.com/kettle-dev/kettle-family/issues
-  documentation_uri: https://www.rubydoc.info/gems/kettle-family/1.3.0
+  documentation_uri: https://www.rubydoc.info/gems/kettle-family/1.3.1
   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