kettle-family 1.0.0 → 1.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5bca5a6ab33a2d894ba06b7b75827b8849476922494bbf02df50efb0d9a0edac
-  data.tar.gz: 9dc491d15e3f89e737961bf87f103a982bddafc6183dc26f8d2287b84dce7d12
+  metadata.gz: ddbeefcf7d7d90e52b0fadb3f09358c14baaa3eade9b03685e36868bd608e810
+  data.tar.gz: a75ce0508f27ba21ee30cf7a23fb95b97479ce1f6f03242a0fcc3210b2d2092f
 SHA512:
-  metadata.gz: 9ebfabcd00bbb7631fe7ef8f3aae71e283b2bfda98a7c60e8b28551e7e3401f219916408c0fafa7321a62dc3ff44fd02a9a44a7461684399a672df9af89d0adf
-  data.tar.gz: 9d72e678c1f451b101b3dc297da6b320321a2fec0b1c723a6c174a5e2a5f5f1d0175ef120c276ca1f52df115a70f87a8d6f76a4a7e30eba7fb2b137eade11b29
+  metadata.gz: '02850c92673ac9c330561be7e9b7cba733683aa952312cdf17bab8a299e4dbcd002ee9f75c5f08cd68c4650dcfea57399e04713523890822a50ce6278bf0536a'
+  data.tar.gz: a4b1e30e093fb889d26755250bc035243436a2e272288575991b9fcb83003288b4cb665363633711b20e4c7e1ce13103c7cd038d1b0e721dbd78a805af3ec4c9

data/CHANGELOG.md

@@ -28,8 +28,58 @@ Please file a bug if you notice a violation of semantic versioning.
 
 ### Fixed
 
+- Generated HEAD and runtime dependency HEAD CI workflows no longer include
+  JRuby or TruffleRuby jobs for this MRI-only gem.
+
 ### Security
 
+## [1.0.1] - 2026-07-20
+
+- TAG: [v1.0.1][1.0.1t]
+- COVERAGE: 95.44% -- 2534/2655 lines in 23 files
+- BRANCH COVERAGE: 77.89% -- 877/1126 branches in 23 files
+- 29.10% documented
+
+### Added
+
+- `kettle-family release-state` now includes an `ahead` column counting commits
+  from the latest release tag to the local default branch when available.
+- `kettle-family release` now accepts `--skip-remotes` and forwards the
+  comma-separated remote skip list to member `kettle-release` runs.
+- `kettle-family --only` now accepts release-state tokens `unreleased`,
+  `prepared`, and `pending`; multiple tokens are combined with logical AND.
+- `kettle-family template` now accepts `--verbose` and forwards verbose mode to
+  member `kettle-jem` runs instead of forcing quiet JSON output.
+
+- `kettle-family template` now runs `kettle-jem prepare` before full templating
+  for Kettle Jem-powered members so templating-only dependency bootstraps, such
+  as parser packages, are available before the full template command loads.
+
+- `kettle-family template` now uses `kettle-jem --events` as its default
+  templating interface, including verbose and single-job runs, and streams
+  newline-delimited JSON template phase, recipe, post-apply, command-step,
+  diagnostic, and summary events as member-prefixed progress lines.
+
+### Deprecated
+
+- `kettle-family bump-version` is now deprecated in favor of `kettle-family bump`.
+
+### Fixed
+
+- The templating prepare phase now disables only the implicit family local path
+  environment variable unless it was explicitly provided, avoiding stale local
+  Gemfile activation failures before the prepare payload can refresh generated
+  modular Gemfiles.
+- The templating prepare phase now runs outside each member's Bundler context so
+  it can repair stale generated Gemfiles before Bundler evaluates them.
+
+- `kettle-family` template preparation now handles custom non-`kettle-jem`
+  template commands without treating no-op dependency preparation as failure.
+- `kettle-family release-state` now counts `ahead` from the release tag to the
+  checked-out member `HEAD`.
+- Generated docs now retain the YARD `_index.html` content wrapper after
+  regeneration with the shared YARD postprocessing stack.
+
 ## [1.0.0] - 2026-07-17
 
 - TAG: [v1.0.0][1.0.0t]
@@ -736,7 +786,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.0.0...HEAD
+[Unreleased]: https://github.com/kettle-dev/kettle-family/compare/v1.0.1...HEAD
+[1.0.1]: https://github.com/kettle-dev/kettle-family/compare/v1.0.0...v1.0.1
+[1.0.1t]: https://github.com/kettle-dev/kettle-family/releases/tag/v1.0.1
 [1.0.0]: https://github.com/kettle-dev/kettle-family/compare/v0.2.7...v1.0.0
 [1.0.0t]: https://github.com/kettle-dev/kettle-family/releases/tag/v1.0.0
 [0.2.7]: https://github.com/kettle-dev/kettle-family/compare/v0.2.6...v0.2.7

data/README.md

@@ -211,7 +211,7 @@ changelog:
 
 release:
   env:
-    KETTLE_RB_DEV: false
+    KETTLE_DEV_DEV: false
   family_changelog:
     enabled: true
     command: bundle exec kettle-changelog
@@ -273,8 +273,28 @@ kettle-family release-state
 ```
 
 The release-state report lists each gem's current `version.rb`, latest published
-release, latest versioned `CHANGELOG.md` section, and whether pending changelog
-work exists in either `Unreleased` or an unpublished prepared release section.
+release, latest versioned `CHANGELOG.md` section, whether pending changelog work
+exists in either `Unreleased` or an unpublished prepared release section, and
+how many commits the current branch is ahead of the latest release tag.
+
+Use release-state tokens with `--only` to select gems by state instead of by
+name. Multiple tokens are combined with logical AND, so this selects only gems
+that are both unreleased and pending. Status tokens cannot be mixed with member
+names in the same `--only` value.
+
+```console
+kettle-family release-state --only pending
+kettle-family release-state --only unreleased,prepared
+kettle-family release --execute --only unreleased,pending
+```
+
+The supported release-state tokens are:
+
+| Token | Meaning |
+|-------|---------|
+| `unreleased` | The current `version.rb` is not the latest published gem version. |
+| `prepared` | The changelog already has a versioned section for the current `version.rb`. |
+| `pending` | The member has unreleased changelog work or an unpublished prepared release. |
 
 Plan or update GitHub Actions workflow SHA pins across the selected family
 members:
@@ -291,6 +311,15 @@ Run release prep/build phases without publishing:
 kettle-family release --execute
 ```
 
+When a remote mirror is temporarily unavailable, skip it for the underlying
+`kettle-release` fetch/parity gate instead of removing the remote from each
+member repository:
+
+```console
+kettle-family release --execute --publish --skip-remotes cb
+kettle-family release --execute --publish --skip-remotes cb,mirror2
+```
+
 Publish through `kettle-release`. A full publish first runs the
 `kettle-pre-release` gate, then prompts once for the gem signing key password
 and leaves RubyGems MFA prompts interactive:
@@ -321,6 +350,61 @@ If you intentionally need to continue after CI failures, opt in explicitly:
 kettle-family release --publish --execute --continue-ci-failures
 ```
 
+Bump aligned member versions with `bump`. The older `bump-version` command still
+works as a deprecated alias.
+
+```console
+kettle-family bump --execute --only pending patch
+kettle-family bump --execute --only unreleased minor
+```
+
+Run `kettle-jem` templating across the selected family members. Planning shows
+the commands that would run; `--execute` runs them. Executed templating defaults
+to a parallel job count based on CPU cores, capped for readability, and can be
+overridden with `--jobs`.
+
+```console
+kettle-family template
+kettle-family template --execute --jobs 4
+kettle-family template --execute --only kettle-family
+```
+
+Templating uses `kettle-jem --events` as the default child interface, so
+executed runs stream member-prefixed progress while still keeping the final
+family report. Progress marks include:
+
+| Mark | Meaning |
+|------|---------|
+| `>` | A phase or command step started. |
+| `.` | A phase, recipe, or step completed without changing files. |
+| `*` | A recipe or step changed files. |
+| `!` | A diagnostic was emitted. |
+| `F` | A phase or step failed. |
+| `done` | The member summary was emitted. |
+
+Example progress:
+
+```text
+templating 1 member with 1 job:
+[kettle-family] > recipes
+[kettle-family] * Gemfile
+[kettle-family] * post_apply:git_hooks_executable
+[kettle-family] done 2 files changed
+.
+template summary: 1/1 members ok, 2 files changed
+```
+
+Use `--verbose` when you need `kettle-jem` verbose diagnostics layered on top of
+the event stream. Environment overrides pass through to every member workflow
+command, which is useful when templating against local unreleased dependencies.
+
+```console
+kettle-family template --execute --verbose --jobs 1
+kettle-family template --execute \
+  --env K_JEM_TEMPLATING=true \
+  --env STRUCTUREDMERGE_DEV=/home/me/src/structuredmerge/ruby/gems
+```
+
 ## 🔐 Security
 
 See [SECURITY.md][🔐security].
@@ -386,7 +470,7 @@ For most applications, prefer the [Pessimistic Version Constraint][📌pvc] with
 For example:
 
 ```ruby
-spec.add_dependency("kettle-family", "~> 0.0")
+spec.add_dependency("kettle-family", "~> 1.0")
 ```
 
 <details markdown="1">
@@ -583,7 +667,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-2.489-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
+[🧮kloc-img]: https://img.shields.io/badge/KLOC-2.655-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

@@ -10,7 +10,7 @@ module Kettle
     class CLI < CommandKit::Command
       include CommandKit::Commands
 
-      COMMANDS = %w[discover plan report metadata check test lint docs template gha-sha-pins bup bupb bex install bump-version add-changelog release push pull up branch-lanes release-state].freeze
+      COMMANDS = %w[discover plan report metadata check test lint docs template gha-sha-pins bup bupb bex install bump bump-version add-changelog release push pull up branch-lanes release-state].freeze
       WORKFLOW_COMMANDS = %w[check test lint docs template gha-sha-pins bup bupb bex release push pull up].freeze
 
       command_name "kettle-family"
@@ -37,7 +37,7 @@ module Kettle
 
       module SelectionOptions
         def self.included(base)
-          base.option :only, value: {type: String, usage: "MEMBERS"}, desc: "Select comma-separated members"
+          base.option :only, value: {type: String, usage: "MEMBERS"}, desc: "Select comma-separated members, or release-state tokens: unreleased, prepared, pending"
           base.option :exclude, value: {type: String, usage: "MEMBERS"}, desc: "Exclude comma-separated members"
           base.option :start_at, long: "--start-at", value: {type: String, usage: "MEMBER[@BRANCH]"}, desc: "Select from member through the end of order"
         end
@@ -65,6 +65,7 @@ module Kettle
       module WorkflowOptions
         def self.included(base)
           base.option :debug, desc: "Preserve debug environment for workflow commands"
+          base.option :verbose, desc: "Pass verbose mode through to supported workflow commands"
           base.option :jobs, value: {type: Integer, usage: "N"}, desc: "Parallel jobs for supported executed workflows"
           base.option :env, value: {type: String, usage: "KEY=VALUE"}, desc: "Override an environment variable for each member workflow command" do |value|
             parse_env_override(value, workflow_env)
@@ -134,6 +135,7 @@ module Kettle
             report: options[:report],
             execute: truthy_option?(:execute),
             debug: truthy_option?(:debug),
+            verbose: truthy_option?(:verbose),
             jobs: options[:jobs],
             workflow_env: workflow_env,
             changelog_section: nil,
@@ -148,6 +150,7 @@ module Kettle
             release_continue_ci_failures: false,
             release_ci_workflows: nil,
             release_skip_bundle_audit: false,
+            release_skip_remotes: nil,
             accept: true,
             tag: false,
             push: false,
@@ -353,11 +356,11 @@ module Kettle
         end
       end
 
-      class BumpVersion < BaseCommand
+      class Bump < BaseCommand
         include ExecutionOptions
         include CommitOptions
 
-        command_name "bump-version"
+        command_name "bump"
         usage "[options] VERSION|major|minor|patch|pre"
         description "Check, plan, or execute family version alignment."
         argument :target_version, required: false, usage: "VERSION|major|minor|patch|pre", desc: "Version or bump target"
@@ -366,9 +369,31 @@ module Kettle
         option :from, value: {type: String, usage: "VERSION"}, desc: "Require selected members to currently match VERSION"
 
         def run(target_version = nil)
-          raise Error, "bump-version requires VERSION, major, minor, patch, or pre" unless target_version
+          raise Error, "#{workflow_command_name} requires VERSION, major, minor, patch, or pre" unless target_version
+
+          run_family(workflow_command_name, target_version: target_version, from_version: options[:from])
+        end
+
+        private
+
+        def workflow_command_name
+          "bump"
+        end
+      end
+
+      class BumpVersion < Bump
+        command_name "bump-version"
+        description "Deprecated alias for bump."
+
+        def run(target_version = nil)
+          stderr.puts("kettle-family: bump-version is deprecated; use bump instead.")
+          super
+        end
+
+        private
 
-          run_family("bump-version", target_version: target_version, from_version: options[:from])
+        def workflow_command_name
+          "bump-version"
         end
       end
 
@@ -407,6 +432,7 @@ module Kettle
         option :continue_ci_failures, long: "--continue-ci-failures", desc: "Set K_RELEASE_CI_CONTINUE=true for release commands"
         option :ci_workflows, long: "--ci-workflows", value: {type: String, usage: "LIST"}, desc: "Pass a comma-separated CI workflow monitor subset through to kettle-release commands"
         option :skip_bundle_audit, long: "--skip-bundle-audit", desc: "Skip bundle:audit/update during release rake checks"
+        option :skip_remotes, long: "--skip-remotes", value: {type: String, usage: "LIST"}, desc: "Pass a comma-separated git remote skip list through to kettle-release commands"
         option :no_auto_floors, long: "--no-auto-floors", desc: "Do not raise family dependency floors between member releases" do
           options[:no_auto_floors] = true
         end
@@ -428,6 +454,7 @@ module Kettle
             release_continue_ci_failures: truthy_option?(:continue_ci_failures),
             release_ci_workflows: options[:ci_workflows],
             release_skip_bundle_audit: truthy_option?(:skip_bundle_audit),
+            release_skip_remotes: options[:skip_remotes],
             release_auto_dependency_floors: !truthy_option?(:no_auto_floors),
             accept: !options.key?(:accept) || options[:accept],
             tag: truthy_option?(:tag),
@@ -468,6 +495,7 @@ module Kettle
       command Bupb
       command Bex
       command Install
+      command Bump
       command BumpVersion
       command AddChangelog
       command Release
@@ -514,7 +542,8 @@ module Kettle
         else
           Orderer.new(members: members, mode: config.order_mode, hints: config.order_hints).ordered
         end
-        selected = Selection.new(members: ordered).apply(only: options[:only], exclude: options[:exclude], start_at: start_at.member)
+        release_state_results = release_state_results_for_selection(config: config, members: ordered, only: options[:only])
+        selected = Selection.new(members: ordered, release_state_results: release_state_results).apply(only: options[:only], exclude: options[:exclude], start_at: start_at.member)
         result_members = selected
         results = command_results(command: command, config: config, members: result_members, options: options, start_at: start_at)
         Report.new(
@@ -542,8 +571,14 @@ module Kettle
         command_results_for_current_branch(command: command, config: config, members: members, options: options, start_at: start_at)
       end
 
+      def release_state_results_for_selection(config:, members:, only:)
+        return nil unless only.to_s.split(",").map(&:strip).any? { |token| Selection.status_token?(token) }
+
+        ReleaseStateCheck.new(config: config, members: members).results
+      end
+
       def command_results_for_current_branch(command:, config:, members:, options:, start_at: StartAt.new(nil, nil))
-        return bump_version_results(members: members, options: options) if command == "bump-version"
+        return bump_version_results(members: members, options: options, phase: command) if %w[bump bump-version].include?(command)
         return add_changelog_results(members: members, options: options) if command == "add-changelog"
         return branch_lane_results(config: config, members: members) if command == "branch-lanes"
         return release_state_results(config: config, members: members) if command == "release-state"
@@ -567,11 +602,13 @@ module Kettle
           continue_ci_failures: options[:release_continue_ci_failures],
           ci_workflows: options[:release_ci_workflows],
           skip_bundle_audit: options[:release_skip_bundle_audit],
+          skip_remotes: options[:release_skip_remotes],
           auto_dependency_floors: options[:release_auto_dependency_floors],
           gha_sha_pins_upgrade: options[:gha_sha_pins_upgrade],
           gha_sha_pins_check: options[:check],
           env_overrides: options[:workflow_env],
           debug: options[:debug],
+          verbose: options[:verbose],
           jobs: options[:jobs],
           progress_io: progress_io(command, options),
           bup_args: options[:bup_args],
@@ -593,14 +630,14 @@ module Kettle
         return false if config.release_target_branches.empty?
         return false if command == "release-state"
         return false if command == "branch-lanes"
-        return false unless WORKFLOW_COMMANDS.include?(command) || %w[bump-version install add-changelog].include?(command)
+        return false unless WORKFLOW_COMMANDS.include?(command) || %w[bump bump-version install add-changelog].include?(command)
 
         !WORKFLOW_COMMANDS.include?(command)
       end
 
       def member_local_branch_target_command?(command, config, members)
         return false if !config.release_target_branches.empty?
-        return false unless %w[bump-version install add-changelog].include?(command)
+        return false unless %w[bump bump-version install add-changelog].include?(command)
 
         members.any? { |member| member_release_config(member: member, config: config) }
       end
@@ -686,14 +723,15 @@ module Kettle
         StartAt.new(member, branch)
       end
 
-      def bump_version_results(members:, options:)
+      def bump_version_results(members:, options:, phase:)
         require_relative "version_bump"
 
         results = VersionBump.new(
           members: members,
           target_version: options[:target_version],
           from_version: options[:from_version],
-          mode: bump_version_mode(options)
+          mode: bump_version_mode(options),
+          phase: phase
         ).results
         return results if options[:check] || !options[:commit]
         return results unless results.all?(&:ok?)

data/lib/kettle/family/command_runner.rb

@@ -111,7 +111,7 @@ module Kettle
         @otp_coordinator = otp_coordinator
       end
 
-      def call(member:, phase:, command:, env: {}, interactive: false)
+      def call(member:, phase:, command:, env: {}, interactive: false, stdout_line_handler: nil)
         argv = command_argv(member: member, command: command, env: env)
         process_env = process_env(member: member, env: env)
         spawn_options = process_options
@@ -120,6 +120,8 @@ module Kettle
         started = Process.clock_gettime(Process::CLOCK_MONOTONIC)
         stdout, stderr, status = if interactive
           run_interactive(env: process_env, argv: argv, chdir: member.root, member_name: member.name, process_options: spawn_options)
+        elsif stdout_line_handler
+          run_streaming(env: process_env, argv: argv, chdir: member.root, process_options: spawn_options, stdout_line_handler: stdout_line_handler)
         else
           Open3.capture3(process_env, *argv, chdir: member.root, **spawn_options)
         end
@@ -145,6 +147,41 @@ module Kettle
 
       attr_reader :execute, :accept, :gem_signing_password, :otp_coordinator
 
+      def run_streaming(env:, argv:, chdir:, process_options:, stdout_line_handler:)
+        captured_stdout = +""
+        captured_stderr = +""
+        stdout_line_buffer = +""
+        status = nil
+        Open3.popen3(env, *argv, chdir: chdir, **process_options) do |_input, output, error, wait_thread|
+          readers = [output, error]
+          until readers.empty?
+            ready = IO.select(readers)
+            ready.first.each do |reader|
+              if reader.equal?(output)
+                chunk = reader.readpartial(1024)
+                captured_stdout << chunk
+                stdout_line_buffer = stream_stdout_lines(stdout_line_buffer, chunk, stdout_line_handler)
+              else
+                captured_stderr << reader.readpartial(1024)
+              end
+            rescue EOFError
+              readers.delete(reader)
+            end
+          end
+          stdout_line_handler.call(stdout_line_buffer) unless stdout_line_buffer.empty?
+          status = wait_thread.value
+        end
+        [captured_stdout, captured_stderr, status]
+      end
+
+      def stream_stdout_lines(buffer, chunk, handler)
+        pending = buffer + chunk
+        lines = pending.lines
+        remainder = pending.end_with?("\n") ? +"" : lines.pop.to_s
+        lines.each { |line| handler.call(line.chomp) }
+        remainder
+      end
+
       def run_interactive(env:, argv:, chdir:, member_name:, process_options:)
         return run_interactive_pty(env: env, argv: argv, chdir: chdir, member_name: member_name, process_options: process_options) if pty_available?
 

data/lib/kettle/family/config.rb

@@ -278,9 +278,9 @@ module Kettle
       def default_release_disable_local_path_env
         local_envs = %w[
           K_JEM_TEMPLATING
-          SMORG_RB_DEV
+          STRUCTUREDMERGE_DEV
           TSLP_DEV
-          KETTLE_RB_DEV
+          KETTLE_DEV_DEV
           RUBOCOP_LTS_DEV
           PBOLING_DEV
           GALTZO_FLOSS_DEV

data/lib/kettle/family/release_state_check.rb

@@ -125,7 +125,10 @@ module Kettle
         latest_released = branch_latest_released(member, state["latest_changelog_version"])
         return state unless latest_released
 
-        state.merge("latest_released" => latest_released)
+        state.merge(
+          "latest_released" => latest_released,
+          "ahead" => commits_ahead_of_release(member.root, latest_released)
+        )
       rescue ArgumentError
         state
       end
@@ -160,6 +163,25 @@ module Kettle
         Gem::Version.new(value)
       end
 
+      def commits_ahead_of_release(root, version)
+        tag = release_tag_for_version(root, version)
+        return nil unless tag && git_ref_exists?(root, "HEAD")
+
+        stdout, _stderr, status = Open3.capture3("git", "rev-list", "--count", "#{tag}..HEAD", chdir: root)
+        status.success? ? stdout.to_i : nil
+      end
+
+      def release_tag_for_version(root, version)
+        return nil if version.to_s.empty?
+
+        ["v#{version}", version.to_s].find { |tag| git_ref_exists?(root, "refs/tags/#{tag}^{commit}") }
+      end
+
+      def git_ref_exists?(root, ref)
+        _stdout, _stderr, status = Open3.capture3("git", "rev-parse", "--verify", "--quiet", ref, chdir: root)
+        status.success?
+      end
+
       def family_changelog_state(root)
         changelog = File.expand_path(config.changelog_path, root)
         raise Error, "missing root changelog #{config.changelog_path}" unless File.file?(changelog)
@@ -169,11 +191,13 @@ module Kettle
         latest_changelog_version = latest_changelog_version(content)
         unreleased_entries = unreleased_entries?(content)
         prepared_release_pending = !version.to_s.empty? && latest_changelog_version == version
+        ahead = commits_ahead_of_release(root, latest_changelog_version)
         {
           "gem_name" => config.family_name,
           "version" => version,
           "latest_released" => nil,
           "latest_changelog_version" => latest_changelog_version,
+          "ahead" => ahead,
           "unreleased_entries" => unreleased_entries,
           "prepared_release_pending" => prepared_release_pending,
           "pending_release" => unreleased_entries || prepared_release_pending

data/lib/kettle/family/report.rb

@@ -316,6 +316,7 @@ module Kettle
           state.fetch("version", "unknown").to_s,
           state.fetch("latest_released", nil).to_s.empty? ? "unknown" : state.fetch("latest_released").to_s,
           state.fetch("latest_changelog_version", nil).to_s.empty? ? "none" : state.fetch("latest_changelog_version").to_s,
+          state.fetch("ahead", nil).nil? ? "unknown" : state.fetch("ahead").to_s,
           yes_no(state.fetch("unreleased_entries", nil)),
           yes_no(state.fetch("prepared_release_pending", nil)),
           yes_no(state.fetch("pending_release", nil))
@@ -326,7 +327,7 @@ module Kettle
       end
 
       def release_state_header
-        header = [["gem", "version.rb", "latest released", "latest changelog", "unreleased", "prepared", "pending"]]
+        header = [["gem", "version.rb", "latest released", "latest changelog", "ahead", "unreleased", "prepared", "pending"]]
         return header unless release_state_has_branches?
 
         [["branch", *header.first]]

data/lib/kettle/family/selection.rb

@@ -3,8 +3,23 @@
 module Kettle
   module Family
     class Selection
-      def initialize(members:)
+      STATUS_TOKEN_KEYS = {
+        "unreleased" => "unreleased_entries",
+        "prepared" => "prepared_release_pending",
+        "pending" => "pending_release"
+      }.freeze
+
+      def self.status_tokens
+        STATUS_TOKEN_KEYS.keys
+      end
+
+      def self.status_token?(value)
+        STATUS_TOKEN_KEYS.key?(value.to_s)
+      end
+
+      def initialize(members:, release_state_results: nil)
         @members = members
+        @release_state_results = release_state_results
       end
 
       def apply(only: nil, exclude: nil, start_at: nil)
@@ -19,12 +34,20 @@ module Kettle
 
       private
 
-      attr_reader :members
+      attr_reader :members, :release_state_results
 
       def select_only(selected, only)
         names = only.split(",").map(&:strip).reject(&:empty?)
         raise Error, "--only requires at least one member" if names.empty?
 
+        status_tokens = names.select { |name| self.class.status_token?(name) }
+        unless status_tokens.empty?
+          member_names = names - status_tokens
+          raise Error, "--only release-state tokens cannot be combined with member names: #{member_names.join(", ")}" unless member_names.empty?
+
+          return select_release_state_status(selected, status_tokens)
+        end
+
         unknown = names - members.map(&:name)
         raise Error, "unknown member(s): #{unknown.join(", ")}" unless unknown.empty?
 
@@ -47,6 +70,29 @@ module Kettle
 
         selected.drop(index)
       end
+
+      def select_release_state_status(selected, status_tokens)
+        results_by_member = release_state_results_by_member
+        failed = results_by_member.values.select { |result| !result.ok? }
+        raise Error, "release-state check failed for: #{failed.map(&:member_name).join(", ")}" unless failed.empty?
+
+        selected.select do |candidate|
+          result = results_by_member[candidate.name]
+          result && status_tokens.all? { |token| truthy_state?(result.state[STATUS_TOKEN_KEYS.fetch(token)]) }
+        end
+      end
+
+      def release_state_results_by_member
+        raise Error, "--only release-state tokens require release-state results" unless release_state_results
+
+        release_state_results.each_with_object({}) do |result, memo|
+          memo[result.member_name] = result
+        end
+      end
+
+      def truthy_state?(value)
+        value == true
+      end
     end
   end
 end

data/lib/kettle/family/version.rb

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

data/lib/kettle/family/version_bump.rb

@@ -7,12 +7,13 @@ module Kettle
     class VersionBump
       DEPENDENCY_METHODS = %i[add_dependency add_runtime_dependency].freeze
 
-      def initialize(members:, target_version:, from_version: nil, mode: :dry_run)
+      def initialize(members:, target_version:, from_version: nil, mode: :dry_run, phase: "bump-version")
         @members = members
         @target_version = target_version.to_s
         @explicit_target_version = validate_version(target_version) unless Kettle::Dev::VersionBump::BUMP_TYPES.include?(@target_version)
         @from_version = validate_version(from_version) if from_version
         @mode = mode
+        @phase = phase
         @member_names = members.map(&:name)
         @member_target_versions = members.each_with_object({}) do |member, memo|
           memo[member.name] = resolve_target_version(member)
@@ -25,7 +26,7 @@ module Kettle
 
       private
 
-      attr_reader :members, :target_version, :explicit_target_version, :from_version, :mode, :member_names, :member_target_versions
+      attr_reader :members, :target_version, :explicit_target_version, :from_version, :mode, :phase, :member_names, :member_target_versions
 
       def validate_version(version)
         with_dev_errors { Kettle::Dev::VersionBump.validate_version(version) }
@@ -39,8 +40,8 @@ module Kettle
         write_edits(edits) if mode == :execute
         CommandResult.new(
           member_name: member.name,
-          phase: "bump-version",
-          command: ["internal", "bump-version", member_target_version],
+          phase: phase,
+          command: ["internal", phase, member_target_version],
           workdir: member.root,
           status: check_failed?(edits) ? 1 : 0,
           success: !check_failed?(edits),

data/lib/kettle/family/workflow.rb

@@ -27,7 +27,7 @@ module Kettle
         "KETTLE_JEM_QUIET" => "true",
         "KETTLE_JEM_DEBUG" => "false",
         "KETTLE_DEV_DEBUG" => "false",
-        "SMORG_RB_DEBUG" => "false",
+        "STRUCTUREDMERGE_DEBUG" => "false",
         "DEBUG" => nil,
         "BUNDLE_QUIET" => "true",
         "BUNDLE_DEBUG" => "false",
@@ -46,7 +46,7 @@ module Kettle
       REGISTRY_WAIT_ATTEMPTS = 15
       REGISTRY_WAIT_INTERVAL_SECONDS = 15
 
-      def initialize(command:, config:, members:, execute: false, accept: true, commit: true, allow_dirty: false, publish: false, push: false, tag: false, start_step: nil, skip_steps: nil, local_ci: false, continue_ci_failures: false, ci_workflows: nil, skip_bundle_audit: false, auto_dependency_floors: nil, gha_sha_pins_upgrade: "patch", gha_sha_pins_check: false, env_overrides: {}, debug: false, gem_signing_password: nil, jobs: nil, progress_io: nil, bup_args: [], bex_args: [], start_member: nil, start_branch: nil, **options)
+      def initialize(command:, config:, members:, execute: false, accept: true, commit: true, allow_dirty: false, publish: false, push: false, tag: false, start_step: nil, skip_steps: nil, local_ci: false, continue_ci_failures: false, ci_workflows: nil, skip_bundle_audit: false, skip_remotes: nil, auto_dependency_floors: nil, gha_sha_pins_upgrade: "patch", gha_sha_pins_check: false, env_overrides: {}, debug: false, verbose: false, gem_signing_password: nil, jobs: nil, progress_io: nil, bup_args: [], bex_args: [], start_member: nil, start_branch: nil, **options)
         @command = command
         @config = config
         @members = members
@@ -63,11 +63,13 @@ module Kettle
         @continue_ci_failures = continue_ci_failures
         @ci_workflows = validate_ci_workflows(ci_workflows)
         @skip_bundle_audit = skip_bundle_audit
+        @skip_remotes = validate_skip_remotes(skip_remotes)
         @auto_dependency_floors = auto_dependency_floors.nil? ? config.release_auto_dependency_floors? : auto_dependency_floors
         @gha_sha_pins_upgrade = gha_sha_pins_upgrade
         @gha_sha_pins_check = gha_sha_pins_check
         @env_overrides = env_overrides
         @debug = debug
+        @verbose = verbose
         @gem_signing_password = gem_signing_password
         @jobs = jobs
         @progress_io = progress_io
@@ -90,7 +92,7 @@ module Kettle
 
       private
 
-      attr_reader :command, :config, :members, :execute, :accept, :commit, :allow_dirty, :publish, :push, :tag, :start_step, :skip_steps, :local_ci, :continue_ci_failures, :ci_workflows, :skip_bundle_audit, :auto_dependency_floors, :gha_sha_pins_upgrade, :gha_sha_pins_check, :env_overrides, :debug, :jobs, :progress_io, :bup_args, :bex_args, :start_member, :start_branch
+      attr_reader :command, :config, :members, :execute, :accept, :commit, :allow_dirty, :publish, :push, :tag, :start_step, :skip_steps, :local_ci, :continue_ci_failures, :ci_workflows, :skip_bundle_audit, :skip_remotes, :auto_dependency_floors, :gha_sha_pins_upgrade, :gha_sha_pins_check, :env_overrides, :debug, :verbose, :jobs, :progress_io, :bup_args, :bex_args, :start_member, :start_branch
 
       def current_branch_results(workflow_members)
         return check_results(workflow_members) if command == "check"
@@ -101,7 +103,7 @@ module Kettle
       end
 
       def member_workflow_results(workflow_members)
-        return template_member_workflow_results(workflow_members) if command == "template" && execute && template_jobs(workflow_members) > 1
+        return template_member_workflow_results(workflow_members) if command == "template" && execute
 
         runner = CommandRunner.new(execute: execute, accept: accept)
         workflow_members.each_with_object([]) do |member, memo|
@@ -110,6 +112,11 @@ module Kettle
             break memo unless memo.last.ok?
           end
 
+          if command == "template"
+            prepared = prepare_template_dependencies(member: member, runner: runner, memo: memo)
+            break memo if prepared == false
+          end
+
           command_text = workflow_command(member)
           result = runner.call(member: member, phase: command, command: command_text, env: workflow_env)
           memo << result
@@ -158,7 +165,16 @@ module Kettle
             return memo unless memo.last.ok?
           end
 
-          memo << runner.call(member: member, phase: command, command: workflow_command(member), env: workflow_env)
+          prepared = prepare_template_dependencies(member: member, runner: runner, memo: memo)
+          return memo if prepared == false
+
+          memo << runner.call(
+            member: member,
+            phase: command,
+            command: workflow_command(member),
+            env: workflow_env,
+            stdout_line_handler: template_event_line_handler(member)
+          )
           return memo unless memo.last.ok?
 
           normalize_lockfiles(member: member, runner: runner, memo: memo, phase: "normalize_lockfiles")
@@ -646,6 +662,7 @@ module Kettle
         args << "--ci-workflows=#{ci_workflows}" if ci_workflows && !ci_workflows.to_s.empty?
         args << "--local-ci" if local_ci
         args << "--skip-bundle-audit" if skip_bundle_audit
+        args << "--skip-remotes=#{skip_remotes}" if skip_remotes && !skip_remotes.to_s.empty?
         return command if args.empty?
 
         command.is_a?(Array) ? [*command, *args] : "#{command} #{args.join(" ")}"
@@ -661,6 +678,16 @@ module Kettle
         workflows.join(",")
       end
 
+      def validate_skip_remotes(value)
+        return nil if value.nil? || value.to_s.empty?
+
+        remotes = value.to_s.split(",").map(&:strip)
+        invalid = remotes.find { |remote| remote.empty? || !remote.match?(/\A[A-Za-z0-9_.-]+\z/) }
+        raise Error, "invalid --skip-remotes value #{value.inspect}" if invalid
+
+        remotes.join(",")
+      end
+
       def release_env
         env = base_release_env
         env.merge!(env_overrides)
@@ -674,6 +701,7 @@ module Kettle
         env["K_RELEASE_CI_CONTINUE"] = "true" if continue_ci_failures
         env["K_RELEASE_CI_WORKFLOWS"] = ci_workflows if ci_workflows && !ci_workflows.to_s.empty?
         env["KETTLE_DEV_SKIP_BUNDLE_AUDIT"] = "true" if skip_bundle_audit
+        env["K_RELEASE_SKIP_REMOTES"] = skip_remotes if skip_remotes && !skip_remotes.to_s.empty?
         env
       end
 
@@ -886,6 +914,16 @@ module Kettle
       def template_command(member)
         command_text = config.template_command || default_template_command(member)
         command_text = append_template_family_args(command_text) if kettle_jem_template_command?(command_text)
+        append_template_skip_commit(command_text)
+      end
+
+      def template_prepare_command(member)
+        command_text = "kettle-jem prepare"
+        command_text = append_template_family_args(command_text)
+        append_template_skip_commit(command_text)
+      end
+
+      def append_template_skip_commit(command_text)
         return command_text if commit
         return command_text if command_text.is_a?(Array) && command_text.include?("--skip-commit")
         return [*command_text, "--skip-commit"] if command_text.is_a?(Array)
@@ -916,7 +954,11 @@ module Kettle
             env["KJ_REPOSITORY_TOPOLOGY"] = config.template_repository_topology if config.template_repository_topology
           end
           env.merge!(env_overrides)
-          env.merge!(TEMPLATE_QUIET_ENV) if command == "template" && !debug
+          if command == "template" && verbose
+            env["KETTLE_JEM_VERBOSE"] = "true"
+          elsif command == "template" && !debug
+            env.merge!(TEMPLATE_QUIET_ENV)
+          end
         end
       end
 
@@ -926,8 +968,12 @@ module Kettle
 
       def append_template_family_args(command_text)
         args = []
-        args << "--quiet" unless command_includes_arg?(command_text, "--quiet")
-        args << "--json" unless command_includes_arg?(command_text, "--json")
+        if verbose
+          args << "--verbose" unless command_includes_arg?(command_text, "--verbose")
+        else
+          args << "--quiet" unless command_includes_arg?(command_text, "--quiet")
+        end
+        args << "--events" unless command_includes_arg?(command_text, "--events")
         append_command_args(command_text, args)
       end
 
@@ -946,6 +992,72 @@ module Kettle
         progress_io.flush if progress_io.respond_to?(:flush)
       end
 
+      def template_event_line_handler(member)
+        return nil unless progress_io
+
+        lambda do |line|
+          event = parse_template_event(line)
+          next unless event
+
+          emit_template_event_progress(member, event)
+        end
+      end
+
+      def parse_template_event(line)
+        payload = JSON.parse(line.to_s)
+        (payload.is_a?(Hash) && payload["event_version"]) ? payload : nil
+      rescue JSON::ParserError
+        nil
+      end
+
+      def emit_template_event_progress(member, event)
+        case event["type"]
+        when "phase_start"
+          emit_template_event_line(member, ">", event["phase"].to_s)
+        when "phase_finish"
+          emit_template_event_line(member, phase_finish_event_mark(event), event["phase"].to_s)
+        when "recipe"
+          path = event["path"].to_s
+          emit_template_event_line(member, template_event_mark(event, changed_mark: "*"), path)
+        when "post_apply_step", "command_step"
+          label = [event["phase"], event["name"]].map(&:to_s).reject(&:empty?).join(":")
+          emit_template_event_line(member, template_event_mark(event), label)
+        when "diagnostic"
+          message = event["message"].to_s
+          label = message.empty? ? event["kind"].to_s : message
+          emit_template_event_line(member, "!", label)
+        when "summary"
+          emit_template_event_line(member, "done", "#{event["changed_count"].to_i} file#{"s" unless event["changed_count"].to_i == 1} changed")
+        end
+      end
+
+      def emit_template_event_line(member, mark, label)
+        return if label.to_s.empty?
+
+        synchronize_template_progress do
+          progress_io.puts("[#{member.name}] #{mark} #{label}")
+          progress_io.flush if progress_io.respond_to?(:flush)
+        end
+      end
+
+      def template_event_mark(event, changed_mark: ".")
+        mark = event["mark"].to_s
+        return mark unless mark.empty?
+
+        event["changed"] ? changed_mark : "."
+      end
+
+      def phase_finish_event_mark(event)
+        return "F" if event["status"].to_s == "failed"
+
+        "."
+      end
+
+      def synchronize_template_progress(&block)
+        @template_progress_mutex ||= Mutex.new
+        @template_progress_mutex.synchronize(&block)
+      end
+
       def emit_template_progress_summary(results)
         return unless progress_io
 
@@ -957,6 +1069,9 @@ module Kettle
       end
 
       def template_changed_file_count(result)
+        event_count = template_changed_file_count_from_events(result.stdout)
+        return event_count if event_count
+
         payload = JSON.parse(result.stdout.to_s)
         Array(payload["changed_files"] || payload[:changed_files]).length if payload.is_a?(Hash)
       rescue JSON::ParserError
@@ -966,6 +1081,16 @@ module Kettle
         0
       end
 
+      def template_changed_file_count_from_events(output)
+        summaries = output.to_s.lines.filter_map do |line|
+          event = parse_template_event(line)
+          event if event && event["type"] == "summary"
+        end
+        return nil if summaries.empty?
+
+        summaries.last["changed_count"].to_i
+      end
+
       def normalize_lockfiles(member:, runner:, memo:, phase:)
         return unless config.normalize_lockfiles?
 
@@ -978,6 +1103,27 @@ module Kettle
         memo << result
       end
 
+      def prepare_template_dependencies(member:, runner:, memo:)
+        command_text = config.template_command || default_template_command(member)
+        return true unless kettle_jem_template_command?(command_text)
+
+        result = runner.call(
+          member: member,
+          phase: "prepare_template_dependencies",
+          command: template_prepare_command(member),
+          env: template_prepare_env
+        )
+        memo << result
+        result.ok?
+      end
+
+      def template_prepare_env
+        env = workflow_env
+        family_env_name = config.family_local_path_env_name
+        env[family_env_name] = "false" if family_env_name && !env_overrides.key?(family_env_name)
+        env
+      end
+
       def normalize_release_lockfiles(member:, runner:, memo:)
         result = runner.call(
           member: member,

data/sig/kettle/family.rbs

@@ -1,68 +1,5 @@
 module Kettle
   module Family
-    # See the writing guide of rbs: https://github.com/ruby/rbs#guides
-    # See the writing guide of rbs: https://github.com/ruby/rbs#guides
-    # See the writing guide of rbs: https://github.com/ruby/rbs#guides
-    # See the writing guide of rbs: https://github.com/ruby/rbs#guides
-    # See the writing guide of rbs: https://github.com/ruby/rbs#guides
-    # See the writing guide of rbs: https://github.com/ruby/rbs#guides
-    # See the writing guide of rbs: https://github.com/ruby/rbs#guides
-    # See the writing guide of rbs: https://github.com/ruby/rbs#guides
-    # See the writing guide of rbs: https://github.com/ruby/rbs#guides
-    # See the writing guide of rbs: https://github.com/ruby/rbs#guides
-    # See the writing guide of rbs: https://github.com/ruby/rbs#guides
-    # See the writing guide of rbs: https://github.com/ruby/rbs#guides
-    # See the writing guide of rbs: https://github.com/ruby/rbs#guides
-    # See the writing guide of rbs: https://github.com/ruby/rbs#guides
-    # See the writing guide of rbs: https://github.com/ruby/rbs#guides
-    # See the writing guide of rbs: https://github.com/ruby/rbs#guides
-    # See the writing guide of rbs: https://github.com/ruby/rbs#guides
-    # See the writing guide of rbs: https://github.com/ruby/rbs#guides
-    # See the writing guide of rbs: https://github.com/ruby/rbs#guides
-    # See the writing guide of rbs: https://github.com/ruby/rbs#guides
-    # See the writing guide of rbs: https://github.com/ruby/rbs#guides
-    # See the writing guide of rbs: https://github.com/ruby/rbs#guides
-    # See the writing guide of rbs: https://github.com/ruby/rbs#guides
-    # See the writing guide of rbs: https://github.com/ruby/rbs#guides
-    # See the writing guide of rbs: https://github.com/ruby/rbs#guides
-    # See the writing guide of rbs: https://github.com/ruby/rbs#guides
-    # See the writing guide of rbs: https://github.com/ruby/rbs#guides
-    # See the writing guide of rbs: https://github.com/ruby/rbs#guides
-    # See the writing guide of rbs: https://github.com/ruby/rbs#guides
-    # See the writing guide of rbs: https://github.com/ruby/rbs#guides
-    # See the writing guide of rbs: https://github.com/ruby/rbs#guides
-    # See the writing guide of rbs: https://github.com/ruby/rbs#guides
-    # See the writing guide of rbs: https://github.com/ruby/rbs#guides
-    # See the writing guide of rbs: https://github.com/ruby/rbs#guides
-    # See the writing guide of rbs: https://github.com/ruby/rbs#guides
-    # See the writing guide of rbs: https://github.com/ruby/rbs#guides
-    # See the writing guide of rbs: https://github.com/ruby/rbs#guides
-    # See the writing guide of rbs: https://github.com/ruby/rbs#guides
-    # See the writing guide of rbs: https://github.com/ruby/rbs#guides
-    # See the writing guide of rbs: https://github.com/ruby/rbs#guides
-    # See the writing guide of rbs: https://github.com/ruby/rbs#guides
-    # See the writing guide of rbs: https://github.com/ruby/rbs#guides
-    # See the writing guide of rbs: https://github.com/ruby/rbs#guides
-    # See the writing guide of rbs: https://github.com/ruby/rbs#guides
-    # See the writing guide of rbs: https://github.com/ruby/rbs#guides
-    # See the writing guide of rbs: https://github.com/ruby/rbs#guides
-    # See the writing guide of rbs: https://github.com/ruby/rbs#guides
-    # See the writing guide of rbs: https://github.com/ruby/rbs#guides
-    # See the writing guide of rbs: https://github.com/ruby/rbs#guides
-    # See the writing guide of rbs: https://github.com/ruby/rbs#guides
-    # See the writing guide of rbs: https://github.com/ruby/rbs#guides
-    # See the writing guide of rbs: https://github.com/ruby/rbs#guides
-    # See the writing guide of rbs: https://github.com/ruby/rbs#guides
-    # See the writing guide of rbs: https://github.com/ruby/rbs#guides
-    # See the writing guide of rbs: https://github.com/ruby/rbs#guides
-    # See the writing guide of rbs: https://github.com/ruby/rbs#guides
-    # See the writing guide of rbs: https://github.com/ruby/rbs#guides
-    # See the writing guide of rbs: https://github.com/ruby/rbs#guides
-    # See the writing guide of rbs: https://github.com/ruby/rbs#guides
-    # See the writing guide of rbs: https://github.com/ruby/rbs#guides
-    # See the writing guide of rbs: https://github.com/ruby/rbs#guides
-    # See the writing guide of rbs: https://github.com/ruby/rbs#guides
-    # See the writing guide of rbs: https://github.com/ruby/rbs#guides
     # See the writing guide of rbs: https://github.com/ruby/rbs#guides
     module Version
       VERSION: String

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: kettle-family
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.0.1
 platform: ruby
 authors:
 - Peter H. Boling
@@ -173,40 +173,40 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.1'
+        version: '3.2'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.1.4
+        version: 3.2.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.1'
+        version: '3.2'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.1.4
+        version: 3.2.0
 - !ruby/object:Gem::Dependency
   name: turbo_tests2
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.1'
+        version: '3.2'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.1.14
+        version: 3.2.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.1'
+        version: '3.2'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.1.14
+        version: 3.2.0
 - !ruby/object:Gem::Dependency
   name: ruby-progressbar
   requirement: !ruby/object:Gem::Requirement
@@ -303,10 +303,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.0.0
-  changelog_uri: https://github.com/kettle-dev/kettle-family/blob/v1.0.0/CHANGELOG.md
+  source_code_uri: https://github.com/kettle-dev/kettle-family/tree/v1.0.1
+  changelog_uri: https://github.com/kettle-dev/kettle-family/blob/v1.0.1/CHANGELOG.md
   bug_tracker_uri: https://github.com/kettle-dev/kettle-family/issues
-  documentation_uri: https://www.rubydoc.info/gems/kettle-family/1.0.0
+  documentation_uri: https://www.rubydoc.info/gems/kettle-family/1.0.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