kettle-family 1.3.32 → 1.3.34

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '08c77450947a59e4d899708d9ea06ac1f6a3ecdbca9f1875697a111221c8a513'
-  data.tar.gz: 39bab3f859dffecd3c7c7bf218bf60a31d593d174f7bf35cc78ee00120796e77
+  metadata.gz: 0f998250246be593256749a248a7ae97b9e22eada3f522aeee55a760c7c69286
+  data.tar.gz: 5260947209c6e41c32d71daac0efc7aed14def50a68c6f26c9d7faf0934ce501
 SHA512:
-  metadata.gz: e11ec34af3513c579f0de85e0ac3967736d9296edd3181c824661d0e77c958dba7fde98870a37b8ab0e030776f24ff8f90cee743e989b174ded6745f6c589363
-  data.tar.gz: f3420d41b085ff447bc05e0f4976fa4ee12b1eba42b73047a1afb5cadf8966b82f7a17430a2e9a5c7923f66ef6498646bcb7225aa71677264ed57cbf8c10fda6
+  metadata.gz: 83195b27096a7dc07f64984d5c28db5e5bbfbe101662216478550c644f90eba7eacc0d6fb86251dc6b8a88a48d39d3519582a9f038448bfea899c2b3507116c6
+  data.tar.gz: 512e1cb879df1ceb8e2dc1913e915beef55f696f0c6e97c453c3800e9bccb66293c178d9a30ce0a6384a20d6d48b8a83d6991311f23aa985109abb391fed2654

data/CHANGELOG.md

@@ -30,6 +30,48 @@ Please file a bug if you notice a violation of semantic versioning.
 
 ### Security
 
+## [1.3.34] - 2026-10-25
+
+- TAG: [v1.3.34][1.3.34t]
+- COVERAGE: 93.08% -- 7556/8118 lines in 45 files
+- BRANCH COVERAGE: 77.48% -- 3017/3894 branches in 45 files
+- 38.89% documented
+
+### Changed
+
+- [kc] shared-dependency-floor-engine: Family workflows now emit and tape NDJSON through kettle-ndjson; the family runtime and local bundle declare kettle-ndjson directly. Dependency-floor updates use kettle-deps-floor with explicit sibling release targets and no registry lookups. Nomono bootstrap raises Gemfile and local activation-array floors.
+
+- [kc] shared-ndjson-event-integration: Use kettle-ndjson for family command summaries and per-member event tape serialization; family child-event names and payloads remain compatible with downstream progress/report handling. Declare kettle-ndjson as a direct runtime and local development dependency.
+
+- [kc] kettle-jem/prepare: updated 19 project files:
+  - dependencies (19)
+
+- [kc] kettle-jem/template: updated 3 project files:
+  - code and tests (1)
+  - documentation (1)
+  - other (1)
+
+## [1.3.33] - 2026-10-24
+
+- TAG: [v1.3.33][1.3.33t]
+- COVERAGE: 93.11% -- 7579/8140 lines in 45 files
+- BRANCH COVERAGE: 77.55% -- 3036/3915 branches in 45 files
+- 38.81% documented
+
+### Changed
+
+- [kc] local-template-bundles-and-family-sponsors: kettle-family: managed tasks generate local-template for current member bundles and unreleased-template for stale destinations using the family-root Gemfile; family sponsor configuration preserves target_href/image_src, sponsorship windows, and umbrella members when passed to kettle-jem.
+
+- [kc] kettle-jem/prepare: updated 9 project files:
+  - dependencies (9)
+
+- [kc] kettle-jem/template: updated 13 project files:
+  - code and tests (2)
+  - dependencies (7)
+  - documentation (1)
+  - other (1)
+  - workflows (2)
+
 ## [1.3.32] - 2026-10-23
 
 - TAG: [v1.3.32][1.3.32t]
@@ -3236,7 +3278,11 @@ 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.32...HEAD
+[Unreleased]: https://github.com/kettle-dev/kettle-family/compare/v1.3.34...HEAD
+[1.3.34]: https://github.com/kettle-dev/kettle-family/compare/v1.3.33...v1.3.34
+[1.3.34t]: https://github.com/kettle-dev/kettle-family/releases/tag/v1.3.34
+[1.3.33]: https://github.com/kettle-dev/kettle-family/compare/v1.3.32...v1.3.33
+[1.3.33t]: https://github.com/kettle-dev/kettle-family/releases/tag/v1.3.33
 [1.3.32]: https://github.com/kettle-dev/kettle-family/compare/v1.3.31...v1.3.32
 [1.3.32t]: https://github.com/kettle-dev/kettle-family/releases/tag/v1.3.32
 [1.3.31]: https://github.com/kettle-dev/kettle-family/compare/v1.3.30...v1.3.31

data/README.md

@@ -66,6 +66,7 @@ configuration, create their own GitHub Release through `kettle-release`.
 
 Compatible with MRI Ruby 4.0.0+.
 CI workflows and Appraisals are generated for MRI Ruby 4.0.0+.
+The current MRI CI lane runs on Linux and macOS.
 This test floor is configured by `ruby.test_minimum` in `.kettle-jem.yml` and
 may be higher than the gem's runtime compatibility floor when legacy Rubies are
 not practical for the current toolchain.
@@ -90,21 +91,6 @@ The _amazing_ test matrix is powered by the kettle-dev stack.
 
 </details>
 
-### Runtime and Platform Support
-
-Support tiers describe what this project's CI actually exercises, not what may
-work in an untested environment:
-
-- **Parallel support**: CI runs the test suite with multiple workers available.
-- **Unsupported**: the engine/platform combination is not covered by CI and is
- not a project compatibility claim.
-
-| Ruby engine/version | Linux | macOS | Windows | Notes |
-|---------------------|-------|-------|---------|-------|
-| MRI 4.0-4.0 | Parallel support | Unsupported | Unsupported | Versioned Ruby workflows run on Linux. |
-| MRI current | Parallel support | Parallel support | Unsupported | Current Ruby workflow covers the declared OS platforms. |
-| MRI head | Parallel support | Unsupported | Unsupported | CI is allowed to fail while Ruby is in development. |
-
 ### Federated DVCS
 
 <details markdown="1">
@@ -120,29 +106,12 @@ work in an untested environment:
 
 ### Enterprise Support
 
-[![Tidelift](https://tidelift.com/badges/package/rubygems/kettle-family)](https://tidelift.com/subscription/pkg/rubygems-kettle-family?utm_source=rubygems-kettle-family&utm_medium=referral&utm_campaign=readme)
-
-Available as part of the Tidelift Subscription.
-
-<details markdown="1">
- <summary>Need enterprise-level guarantees?</summary>
-
-The maintainers of this and thousands of other packages are working with Tidelift to deliver commercial support and maintenance for the open source packages you use to build your applications. Save time, reduce risk, and improve code health, while paying the maintainers of the exact packages you use.
-
-[![Get help from me on Tidelift][🏙️entsup-tidelift-img]][🏙️entsup-tidelift]
+For enterprise support from the maintainer, use [Upwork][👨🏼‍🏫expsup-upwork] or [CodeMentor][👨🏼‍🏫expsup-codementor].
 
-- 💡Subscribe for support guarantees covering _all_ your FLOSS dependencies
-- 💡Tidelift is part of [Sonar][🏙️entsup-tidelift-sonar]
-- 💡Tidelift pays maintainers to maintain the software you depend on!<br/>📊`@`Pointy Haired Boss: An [enterprise support][🏙️entsup-tidelift] subscription is "[never gonna let you down][🧮kloc]", and *supports* open source maintainers
-
-Alternatively:
+Other support channels:
 
 - [![Ruby Users Forum][✉️ruby-forum-img]][✉️ruby-forum]
 - [![Live Chat on Discord][✉️discord-invite-img-ftb]][✉️discord-invite]
-- [![Get help from me on Upwork][👨🏼‍🏫expsup-upwork-img]][👨🏼‍🏫expsup-upwork]
-- [![Get help from me on Codementor][👨🏼‍🏫expsup-codementor-img]][👨🏼‍🏫expsup-codementor]
-
-</details>
 
 ## ✨ Installation
 
@@ -1154,9 +1123,6 @@ Thanks for RTFM. ☺️
 [👨🏼‍🏫expsup-upwork-img]: https://img.shields.io/badge/UpWork-13544E?style=for-the-badge&logo=Upwork&logoColor=white
 [👨🏼‍🏫expsup-codementor]: https://www.codementor.io/peterboling?utm_source=github&utm_medium=button&utm_term=peterboling&utm_campaign=github
 [👨🏼‍🏫expsup-codementor-img]: https://img.shields.io/badge/CodeMentor-Get_Help-1abc9c?style=for-the-badge&logo=CodeMentor&logoColor=white
-[🏙️entsup-tidelift]: https://tidelift.com/subscription/pkg/rubygems-kettle-family?utm_source=rubygems-kettle-family&utm_medium=referral&utm_campaign=readme
-[🏙️entsup-tidelift-img]: https://img.shields.io/badge/Tidelift_and_Sonar-Enterprise_Support-FD3456?style=for-the-badge&logo=sonar&logoColor=white
-[🏙️entsup-tidelift-sonar]: https://blog.tidelift.com/tidelift-joins-sonar
 [💁🏼‍♂️peterboling]: http://www.peterboling.com
 [🚂railsbling]: http://www.railsbling.com
 [📜src-gl-img]: https://img.shields.io/badge/GitLab-FBA326?style=for-the-badge&logo=Gitlab&logoColor=orange
@@ -1225,7 +1191,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-8.107-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
+[🧮kloc-img]: https://img.shields.io/badge/KLOC-8.118-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
@@ -1255,5 +1221,5 @@ Thanks for RTFM. ☺️
 | Homepage | https://github.com/kettle-dev/kettle-family |
 | Source | https://github.com/kettle-dev/kettle-family |
 | License | `AGPL-3.0-only` |
-| Funding | https://github.com/sponsors/pboling, https://ko-fi.com/pboling, https://liberapay.com/pboling/donate, https://opencollective.com/kettle-dev, https://thanks.dev/u/gh/pboling, https://tidelift.com/funding/github/rubygems/kettle-family, https://www.buymeacoffee.com/pboling |
+| Funding | https://github.com/sponsors/pboling, https://ko-fi.com/pboling, https://liberapay.com/pboling/donate, https://opencollective.com/kettle-dev, https://thanks.dev/u/gh/pboling, https://www.buymeacoffee.com/pboling |
 <!-- kettle-jem:metadata:end -->

data/lib/kettle/family/cli.rb

@@ -3,6 +3,7 @@
 require "command_kit"
 require "command_kit/commands"
 require "fileutils"
+require "kettle/ndjson"
 require "optparse"
 
 module Kettle
@@ -814,8 +815,11 @@ module Kettle
       def run_command(command, options)
         report = build_report(command, options)
         write_report(report, options)
-        if options[:events] && command == "release-state"
-          stdout.puts(JSON.generate("event_version" => 1, "type" => "summary", "report" => report.to_h))
+        if options[:events]
+          Kettle::Ndjson.emit_summary_event(
+            Kettle::Ndjson.event_stream(stdout, types: "summary"),
+            report: report.to_h
+          )
         else
           stdout.puts(options[:json] ? report.to_json : report.to_text)
         end
@@ -827,6 +831,33 @@ module Kettle
 
       private
 
+      def emit_command_result_events(event_tape, command, results)
+        return unless event_tape
+
+        results.each do |result|
+          event_tape.call(
+            "type" => "command_step",
+            "command" => command,
+            "name" => result.phase,
+            "member" => result.member_name,
+            "branch" => result.branch,
+            "phase" => result.phase,
+            "status" => command_result_event_status(result),
+            "status_code" => result.status,
+            "elapsed_seconds" => result.elapsed_seconds,
+            "reason" => result.reason,
+            "result" => result.to_h
+          )
+        end
+      end
+
+      def command_result_event_status(result)
+        return "skipped" if result.skipped
+        return "ok" if result.ok?
+
+        "failed"
+      end
+
       def build_report(command, options)
         config = Config.load(root: options[:root], path: options[:config])
         start_at = parse_start_at(options[:start_at])
@@ -888,6 +919,7 @@ module Kettle
           release_state_results: release_state_results
         )
         state_progress&.finish
+        emit_command_result_events(state_event_tape, command, results)
         elapsed_seconds = Process.clock_gettime(Process::CLOCK_MONOTONIC) - started_at
         Report.new(
           family_name: config.family_name,
@@ -1562,13 +1594,13 @@ module Kettle
       end
 
       def release_state_event_tape(command:, config:, options:)
-        return unless %w[release release-state].include?(command)
+        return unless %w[release release-state].include?(command) || options[:events]
         # Release event taping requires execute mode: dry-run release has no
         # child event streams to tape.
         return if command == "release" && !options[:execute]
 
         tape = ReleaseStateEventTape.new(root: config.root, stream: options[:events] ? stdout : nil)
-        stderr.puts("release state event tapes: #{tape.directory}") unless options[:events]
+        stderr.puts("family event tapes: #{tape.directory}") unless options[:events]
         tape
       end
 

data/lib/kettle/family/command_runner.rb

@@ -199,7 +199,6 @@ module Kettle
           event_handler.call(
             member_name,
             {
-              "event_version" => 1,
               "type" => "secret_provider",
               "action" => action,
               "label" => label,

data/lib/kettle/family/config.rb

@@ -208,6 +208,20 @@ module Kettle
         fetch_path("template", "jobs")
       end
 
+      # Additional local dependency selectors used by the generated
+      # `local-template` task. Values may use Mise's `{{config_root}}` token.
+      def template_local_env
+        configured = fetch_path("template", "local_env") || {}
+        raise Error, "template.local_env must be a mapping of ENV names to values" unless configured.is_a?(Hash)
+
+        configured.each_with_object({}) do |(name, value), env|
+          key = name.to_s
+          raise Error, "template.local_env cannot override #{key}" if %w[BUNDLE_GEMFILE RUBYOPT K_JEM_TEMPLATING].include?(key)
+
+          env[key] = value.to_s
+        end
+      end
+
       # A monorepo commonly has one root suite that covers every subgem. The
       # configured owner is optional; an --only invocation never expands its
       # own selection solely to reach that owner.
@@ -453,25 +467,63 @@ module Kettle
       def normalize_corporate_sponsors(raw)
         Array(raw).filter_map do |entry|
           unless entry.is_a?(Hash)
-            raise ArgumentError, "corporate sponsor entries must be mappings with name, url, and img_src"
+            raise ArgumentError, "corporate sponsor entries must be mappings with name, target_href, and image_src (legacy url and img_src are also accepted)"
           end
 
           sponsor = stringify_keys(entry)
           name = sponsor["name"].to_s.strip
-          url = sponsor["url"].to_s.strip
-          img_src = sponsor["img_src"].to_s.strip
-          if name.empty? || url.empty? || img_src.empty?
-            raise ArgumentError, "corporate sponsor entries require name, url, and img_src"
+          target_href = (sponsor["target_href"] || sponsor["url"]).to_s.strip
+          image_src = (sponsor["image_src"] || sponsor["img_src"]).to_s.strip
+          if name.empty? || target_href.empty? || image_src.empty?
+            raise ArgumentError, "corporate sponsor entries require name, target_href, and image_src (legacy url and img_src are also accepted)"
+          end
+
+          sponsor.merge(
+            "name" => name,
+            "target_href" => target_href,
+            "image_src" => image_src,
+            "url" => target_href,
+            "img_src" => image_src,
+            "since" => normalize_sponsor_date(sponsor["since"]),
+            "until" => normalize_sponsor_date(sponsor["until"]),
+            "members" => normalize_corporate_sponsor_members(sponsor["members"], name)
+          ).compact
+        end
+      end
+
+      def normalize_corporate_sponsor_members(raw, sponsor_name)
+        return nil if raw.nil?
+
+        Array(raw).filter_map do |entry|
+          unless entry.is_a?(Hash)
+            raise ArgumentError, "corporate sponsor #{sponsor_name.inspect} members must be mappings with name and target_href"
           end
+          member = stringify_keys(entry)
+          raise ArgumentError, "corporate sponsor #{sponsor_name.inspect} members cannot themselves have members" if member.key?("members")
 
-          {
+          name = member["name"].to_s.strip
+          target_href = (member["target_href"] || member["url"]).to_s.strip
+          raise ArgumentError, "corporate sponsor #{sponsor_name.inspect} members require name and target_href" if name.empty? || target_href.empty?
+
+          image_src = (member["image_src"] || member["img_src"]).to_s.strip
+          member.merge(
             "name" => name,
-            "url" => url,
-            "img_src" => img_src
-          }
+            "target_href" => target_href,
+            "url" => target_href,
+            "image_src" => image_src.empty? ? nil : image_src,
+            "img_src" => image_src.empty? ? nil : image_src,
+            "since" => normalize_sponsor_date(member["since"]),
+            "until" => normalize_sponsor_date(member["until"])
+          ).compact
         end
       end
 
+      def normalize_sponsor_date(value)
+        return nil if value.nil? || value.to_s.strip.empty?
+
+        value.respond_to?(:iso8601) ? value.iso8601 : value.to_s.strip
+      end
+
       def fetch_path(*keys)
         keys.reduce(data) do |memo, key|
           break nil unless memo.is_a?(Hash)

data/lib/kettle/family/dependency_floor.rb

@@ -1,27 +1,21 @@
 # frozen_string_literal: true
 
-require "kettle/dev"
+require "kettle/deps/floor"
 
 module Kettle
   module Family
+    # Adapts family release versions and workflow results to the shared
+    # kettle-deps-floor updater. Parsing, floor eligibility, and AST edits live
+    # in the generic gem; this class supplies family context only.
     class DependencyFloor
-      DEPENDENCY_METHODS = %i[add_dependency add_runtime_dependency add_development_dependency].freeze
-
-      # Return only dependencies declared by the gemspec itself. Release
-      # ordering also observes Gemfile-only tooling dependencies, but those
-      # cannot have their published floor rewritten by this class.
       def self.gemspec_dependency_names(member)
         return [] unless member.gemspec_path && File.file?(member.gemspec_path)
 
-        source = File.read(member.gemspec_path)
-        parse_result = Kettle::Dev::VersionBump.parse_source(source, member.gemspec_path)
-        Kettle::Dev::VersionBump.each_node(parse_result.value).filter_map do |node|
-          next unless node.is_a?(Prism::CallNode) && DEPENDENCY_METHODS.include?(node.name)
-
-          name_node = node.arguments&.arguments&.first
-          name_node.unescaped if name_node.is_a?(Prism::StringNode)
-        end.uniq
-      rescue Kettle::Dev::Error => error
+        Kettle::Deps::Floor::Updater.dependency_names(
+          project_root: member.root,
+          sources: [File.basename(member.gemspec_path)]
+        )
+      rescue Kettle::Deps::Floor::Error => error
         raise Error, error.message
       end
 
@@ -29,7 +23,7 @@ module Kettle
         @released_members = released_members
         @dependent_members = dependent_members
         @mode = mode
-        @released_versions = released_members.to_h { |member| [member.name, Gem::Version.new(member.version.to_s)] }
+        @released_versions = released_members.to_h { |member| [member.name, member.version.to_s] }
       end
 
       def results
@@ -41,10 +35,18 @@ module Kettle
       attr_reader :released_members, :dependent_members, :mode, :released_versions
 
       def result_for(member)
-        edits = collect_edits(member)
-        return if edits.empty?
+        return unless member.gemspec_path && File.file?(member.gemspec_path)
+
+        updater = Kettle::Deps::Floor::Updater.new(
+          project_root: member.root,
+          sources: [File.basename(member.gemspec_path)],
+          target_versions: released_versions,
+          registry_updates: false,
+          write: mode == :execute
+        )
+        changes = updater.run.fetch(:planned_changes)
+        return if changes.empty?
 
-        write_edits(edits) if mode == :execute
         CommandResult.new(
           member_name: member.name,
           phase: "dependency_floor",
@@ -52,79 +54,20 @@ module Kettle
           workdir: member.root,
           status: 0,
           success: true,
-          stdout: edit_summary(member: member, edits: edits),
+          stdout: edit_summary(member: member, changes: changes),
           stderr: "",
           elapsed_seconds: 0.0,
           skipped: mode != :execute,
           reason: (mode == :execute) ? nil : "dry-run; pass --execute to write"
         )
+      rescue Kettle::Deps::Floor::Error => error
+        raise Error, error.message
       end
 
-      def collect_edits(member)
-        return [] unless member.gemspec_path && File.file?(member.gemspec_path)
-
-        source = File.read(member.gemspec_path)
-        parse_result = with_dev_errors { Kettle::Dev::VersionBump.parse_source(source, member.gemspec_path) }
-        Kettle::Dev::VersionBump.each_node(parse_result.value).filter_map do |node|
-          dependency_edit_for(member.gemspec_path, source, node)
-        end
-      end
-
-      def dependency_edit_for(path, source, node)
-        return unless node.is_a?(Prism::CallNode) && DEPENDENCY_METHODS.include?(node.name)
-
-        args = node.arguments&.arguments || []
-        name_node = args.first
-        return unless name_node.is_a?(Prism::StringNode)
-
-        dependency_name = name_node.unescaped
-        released_version = released_versions[dependency_name]
-        return unless released_version
-
-        floor_node = requirement_nodes(args.drop(1)).find do |requirement_node|
-          requirement_node.unescaped.start_with?(">= ")
-        end
-        return unless floor_node
-
-        current_floor = floor_node.unescaped.delete_prefix(">= ").strip
-        return unless floor_lower_than?(current_floor, released_version)
-
-        replacement = Kettle::Dev::VersionBump.quote_like(floor_node.location.slice, ">= #{released_version}")
-        Kettle::Dev::VersionBump.file_edit(path, source, floor_node.location.start_offset, floor_node.location.end_offset, replacement)
-      end
-
-      def requirement_nodes(nodes)
-        nodes.flat_map do |node|
-          case node
-          when Prism::StringNode
-            [node]
-          when Prism::ArrayNode
-            requirement_nodes(node.elements)
-          else
-            []
-          end
-        end
-      end
-
-      def floor_lower_than?(current_floor, released_version)
-        Gem::Version.new(current_floor) < released_version
-      rescue ArgumentError
-        false
-      end
-
-      def write_edits(edits)
-        Kettle::Dev::VersionBump.write_edits(edits)
-      end
-
-      def edit_summary(member:, edits:)
+      def edit_summary(member:, changes:)
         verb = (mode == :execute) ? "updated" : "would update"
-        ["#{verb} #{edits.length} family dependency floor(s) for #{member.name}", *edits.map { |edit| "#{verb} #{edit.fetch(:path)}" }.uniq].join("\n")
-      end
-
-      def with_dev_errors
-        yield
-      rescue Kettle::Dev::Error => error
-        raise Error, error.message
+        paths = changes.map { |change| change.fetch(:relative_path) }.uniq
+        ["#{verb} #{changes.length} family dependency floor(s) for #{member.name}", *paths.map { |path| "#{verb} #{path}" }].join("\n")
       end
     end
   end

data/lib/kettle/family/mise_tasks.rb

@@ -3,6 +3,8 @@
 require "ast/crispr"
 require "ast/crispr/toml"
 require "psych/merge"
+require "pathname"
+require "shellwords"
 
 module Kettle
   module Family
@@ -355,6 +357,8 @@ module Kettle
           "state" => "Report release state for every family member",
           "release-state" => "Report changelog release state for every family member",
           "template" => "Apply kettle-jem templates across family members",
+          "local-template" => "Apply templates using member-local Nomono and local workspace gems",
+          "unreleased-template" => "Apply templates to stale members using the family-root bundle",
           "bump" => "Bump member gem versions",
           "changelog" => "Add a structured entry to the family changelog",
           "bup" => "Update dependencies and commit lockfiles; pass gems or options after --",
@@ -393,6 +397,8 @@ module Kettle
           tasks["bup"] = "bundle exec kettle-family bup --execute --commit"
           tasks["bupb"] = "bundle exec kettle-family update-bundler --execute --commit"
           tasks["update-bundler"] = tasks["bupb"]
+          tasks["local-template"] = local_template_command(member_bundle: "Gemfile")
+          tasks["unreleased-template"] = local_template_command(member_bundle: "{{config_root}}/Gemfile")
 
           neutral = neutralize_assignments
           wiring = env_wiring_flags
@@ -407,6 +413,39 @@ module Kettle
 
         private
 
+        def local_template_command(member_bundle:)
+          local_env = config.template_local_env.dup
+          if (family_env = config.family_local_path_env_name)
+            relative_root = Pathname.new(config.family_local_path_root)
+              .relative_path_from(Pathname.new(config.root)).to_s
+            family_path = if relative_root == "."
+              "{{config_root}}"
+            else
+              "{{config_root}}/#{relative_root}"
+            end
+            local_env[family_env] = family_path
+          end
+          local_env["K_JEM_TEMPLATING"] = "true"
+
+          root_env = local_env.merge(
+            "RUBYOPT" => "-rbundler/setup",
+            "BUNDLE_GEMFILE" => "Gemfile"
+          )
+          child_env = local_env.merge(
+            "RUBYOPT" => "-rbundler/setup",
+            "BUNDLE_GEMFILE" => member_bundle
+          )
+          assignments = root_env.map { |key, value| "#{key}=#{escape_mise_value(value)}" }.join(" ")
+          forwarded = child_env.map { |key, value| "--env #{escape_mise_value("#{key}=#{value}")}" }.join(" ")
+          "#{assignments} bundle exec kettle-family template --execute #{forwarded}"
+        end
+
+        def escape_mise_value(value)
+          token = "{{config_root}}"
+          marker = "KETTLE_FAMILY_CONFIG_ROOT_TOKEN"
+          Shellwords.escape(value.to_s.gsub(token, marker)).gsub(marker, token)
+        end
+
         # Neutralize ambient local-path wiring so the command starts from the
         # family config, then hand kettle-family the intended overrides.
         def neutralize_assignments

data/lib/kettle/family/nomono_bootstrap.rb

@@ -89,9 +89,11 @@ module Kettle
         edits = if File.file?(gemfile)
           source = File.read(gemfile)
           parse_result = Kettle::Dev::VersionBump.parse_source(source, gemfile)
-          Kettle::Dev::VersionBump.each_node(parse_result.value).filter_map do |node|
-            nomono_floor_edit(gemfile, source, node)
-          end
+          nodes = Kettle::Dev::VersionBump.each_node(parse_result.value)
+          [
+            *nodes.filter_map { |node| nomono_floor_edit(gemfile, source, node) },
+            *nodes.filter_map { |node| local_nomono_floor_edit(gemfile, source, node) }
+          ]
         else
           []
         end

data/lib/kettle/family/release_state_event_tape.rb

@@ -1,8 +1,8 @@
 # frozen_string_literal: true
 
 require "fileutils"
-require "json"
 require "time"
+require "kettle/ndjson"
 
 module Kettle
   module Family
@@ -34,10 +34,8 @@ module Kettle
         @mutex.synchronize do
           @sequence_by_member[target] += 1
           payload["sequence"] = @sequence_by_member.fetch(target)
-          line = JSON.generate(payload)
-          File.open(path_for(target), "a") { |file| file.puts(line) }
-          @stream&.puts(line)
-          @stream.flush if @stream&.respond_to?(:flush)
+          File.open(path_for(target), "a") { |file| emit_ndjson(file, payload) }
+          emit_ndjson(@stream, payload) if @stream
         end
         payload
       rescue
@@ -46,6 +44,17 @@ module Kettle
 
       private
 
+      def emit_ndjson(io, payload)
+        type = payload.fetch("type").to_s
+        stream = Kettle::Ndjson.event_stream(io, types: type, event_types: [type], aliases: {})
+        attributes = payload.each_with_object({}) do |(key, value), result|
+          next if %w[type event_version].include?(key.to_s)
+
+          result[key.to_sym] = value
+        end
+        Kettle::Ndjson.emit_event(stream, type, attributes)
+      end
+
       def target_key(payload)
         member = payload.fetch("member", "family").to_s
         branch = payload["branch"].to_s

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

data/lib/kettle/family/workflow.rb

@@ -4864,26 +4864,6 @@ module Kettle
         File.file?(candidate) ? candidate : nil
       end
 
-      def local_kettle_jem_gemfile
-        executable = local_kettle_jem_executable
-        return unless executable
-
-        gemfile = File.expand_path("../Gemfile", File.dirname(executable))
-        gemfile if File.file?(gemfile)
-      end
-
-      def local_nomono_path_locked?(member)
-        lockfile = File.join(member.root, "Gemfile.lock")
-        return false unless File.file?(lockfile)
-
-        spec = Bundler::LockfileParser.new(Bundler.read_file(lockfile)).specs.find do |locked_spec|
-          locked_spec.name == NomonoBootstrap::GEM_NAME
-        end
-        spec&.source.is_a?(Bundler::Source::Path)
-      rescue Bundler::LockfileError, Errno::ENOENT
-        false
-      end
-
       def template_local_kettle_jem_root
         values = [
           env_overrides["STRUCTUREDMERGE_DEV"],
@@ -5142,18 +5122,17 @@ module Kettle
       end
 
       def gha_sha_pins_event_line_handler(member)
-        return nil unless progress_io
+        return nil unless progress_io || @event_tape
 
         lambda do |line|
           event = parse_template_event(line)
           next false unless event && event["type"].to_s.start_with?("gha_sha_pins")
 
-          if progress_io
-            if verbose || debug
-              emit_gha_sha_pins_event_progress(member, event)
-            elsif @gha_sha_pins_progress
-              emit_gha_sha_pins_event_status(member, event, progress: @gha_sha_pins_progress)
-            end
+          @event_tape&.call(event.merge("member" => member.name))
+          if progress_io && (verbose || debug)
+            emit_gha_sha_pins_event_progress(member, event)
+          elsif progress_io && @gha_sha_pins_progress
+            emit_gha_sha_pins_event_status(member, event, progress: @gha_sha_pins_progress)
           end
           true
         end
@@ -5991,12 +5970,10 @@ module Kettle
             env["K_CHANGELOG_PATH"] = File.join(member.root, "CHANGELOG.md")
           end
         end
-        tool_gemfile = local_kettle_jem_gemfile if member && local_nomono_path_locked?(member)
-        # Nomono's existing generated bootstrap can activate an installed
-        # release before Bundler resolves a path-locked local Nomono. Start
-        # local Kettle Jem from its own bundle so prepare can repair that
-        # bootstrap before it loads the destination bundle.
-        env["BUNDLE_GEMFILE"] = tool_gemfile if tool_gemfile
+        # Preserve the task-selected bundle exactly. Modern members use their
+        # own Gemfile with local Nomono wiring; stale-member recovery selects
+        # the family-root Gemfile. In both cases kettle-jem must not switch to
+        # its own Gemfile during preflight.
         env
       end
 
@@ -6005,15 +5982,21 @@ module Kettle
       end
 
       def template_bundler_update_env(env, member)
-        return env unless member&.name == NomonoBootstrap::GEM_NAME
-
-        # While nomono itself is being version-bumped, its Gemfile/gemspec can
-        # require the new version while Gemfile.lock still records the old
-        # self-version. Eager RUBYOPT setup activates that old lock before a
-        # Bundler update can reconcile it. Keep the setting for Kettle Jem:
-        # its standalone bootstrap needs it to activate local template gems.
-        # Bundler update initializes its own bundle, so remove only this token
-        # for nomono's lockfile-update commands and preserve all other options.
+        return env unless member
+
+        # Bundler update/normalize/recovery commands operate on the MEMBER's
+        # own bundle (its nomono floor and lockfile), so they must target the
+        # member Gemfile — not the bundle the template task selected to launch
+        # kettle-family. Under unreleased-template that launcher bundle is the
+        # family-root Gemfile, which does not declare nomono, so
+        # `bundle update nomono` fails with "Could not find gem 'nomono'".
+        env["BUNDLE_GEMFILE"] = File.join(member.root, "Gemfile")
+        # Eager RUBYOPT setup would activate the member's possibly-stale
+        # lockfile before Bundler can reconcile it (and, while nomono itself is
+        # being version-bumped, its Gemfile/gemspec can require the new version
+        # while Gemfile.lock still records the old self-version). Bundler
+        # update/lock/install commands initialize their own bundle, so drop
+        # only this token and preserve all other options.
         options = Shellwords.split(env.fetch("RUBYOPT", ""))
         options.reject! { |option| option == "-rbundler/setup" }
         if options.empty?

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: kettle-family
 version: !ruby/object:Gem::Version
-  version: 1.3.32
+  version: 1.3.34
 platform: ruby
 authors:
 - Peter H. Boling
@@ -114,7 +114,7 @@ dependencies:
         version: '1.0'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.0.13
+        version: 1.0.14
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -124,7 +124,27 @@ dependencies:
         version: '1.0'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.0.13
+        version: 1.0.14
+- !ruby/object:Gem::Dependency
+  name: kettle-deps-floor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.1.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.1.1
 - !ruby/object:Gem::Dependency
   name: kettle-dev
   requirement: !ruby/object:Gem::Requirement
@@ -134,7 +154,7 @@ dependencies:
         version: '3.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.1.23
+        version: 3.1.25
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -144,7 +164,7 @@ dependencies:
         version: '3.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.1.23
+        version: 3.1.25
 - !ruby/object:Gem::Dependency
   name: kettle-gha-pins
   requirement: !ruby/object:Gem::Requirement
@@ -185,6 +205,26 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: 7.1.28
+- !ruby/object:Gem::Dependency
+  name: kettle-ndjson
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.1.20
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.1.20
 - !ruby/object:Gem::Dependency
   name: kettle-test
   requirement: !ruby/object:Gem::Requirement
@@ -296,7 +336,7 @@ dependencies:
         version: '1.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.1.15
+        version: 1.1.16
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -306,7 +346,7 @@ dependencies:
         version: '1.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.1.15
+        version: 1.1.16
 - !ruby/object:Gem::Dependency
   name: bundler-audit
   requirement: !ruby/object:Gem::Requirement
@@ -364,7 +404,7 @@ dependencies:
         version: '0.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.1.3
+        version: 0.1.4
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -374,7 +414,7 @@ dependencies:
         version: '0.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.1.3
+        version: 0.1.4
 - !ruby/object:Gem::Dependency
   name: appraisal2
   requirement: !ruby/object:Gem::Requirement
@@ -384,7 +424,7 @@ dependencies:
         version: '3.2'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.2.5
+        version: 3.2.6
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -394,7 +434,7 @@ dependencies:
         version: '3.2'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.2.5
+        version: 3.2.6
 - !ruby/object:Gem::Dependency
   name: turbo_tests2
   requirement: !ruby/object:Gem::Requirement
@@ -568,10 +608,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.32
-  changelog_uri: https://github.com/kettle-dev/kettle-family/blob/v1.3.32/CHANGELOG.md
+  source_code_uri: https://github.com/kettle-dev/kettle-family/tree/v1.3.34
+  changelog_uri: https://github.com/kettle-dev/kettle-family/blob/v1.3.34/CHANGELOG.md
   bug_tracker_uri: https://github.com/kettle-dev/kettle-family/issues
-  documentation_uri: https://www.rubydoc.info/gems/kettle-family/1.3.32
+  documentation_uri: https://www.rubydoc.info/gems/kettle-family/1.3.34
   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