kettle-family 1.0.0 → 1.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5bca5a6ab33a2d894ba06b7b75827b8849476922494bbf02df50efb0d9a0edac
-  data.tar.gz: 9dc491d15e3f89e737961bf87f103a982bddafc6183dc26f8d2287b84dce7d12
+  metadata.gz: 19486d91816150dae28ac5f1e8b31ef3f43b0f4f7004337681f08819fb41b27d
+  data.tar.gz: e2bf61a97f739f211accb4fc5cbfe91acc4121077c5f620786d30d217b4cc803
 SHA512:
-  metadata.gz: 9ebfabcd00bbb7631fe7ef8f3aae71e283b2bfda98a7c60e8b28551e7e3401f219916408c0fafa7321a62dc3ff44fd02a9a44a7461684399a672df9af89d0adf
-  data.tar.gz: 9d72e678c1f451b101b3dc297da6b320321a2fec0b1c723a6c174a5e2a5f5f1d0175ef120c276ca1f52df115a70f87a8d6f76a4a7e30eba7fb2b137eade11b29
+  metadata.gz: e8826e083336b3de83e313fc3207c60461e494fc8c1c4ad22b8148b861024ca78adcefa1b5c357d7ed90af79dddb3cda59dc4900434e862739d8d2f930e8e0c3
+  data.tar.gz: 1d735e6c84877eab971381d22226c96871e2fa0198bab1d9895bf771abdbbe2d5bf2c69a0d16bd04c0a3cdfdc830c7e7354f526313a5f0b8dbeec2a96df7d908

data/CHANGELOG.md

@@ -30,6 +30,93 @@ Please file a bug if you notice a violation of semantic versioning.
 
 ### Security
 
+## [1.0.2] - 2026-07-21
+
+- TAG: [v1.0.2][1.0.2t]
+- COVERAGE: 95.51% -- 2637/2761 lines in 23 files
+- BRANCH COVERAGE: 77.98% -- 928/1190 branches in 23 files
+- 28.63% documented
+
+### Added
+
+- `kettle-family template` now passes family-level `readme.corporate_sponsors`
+  config into member `kettle-jem` runs for template-managed README sponsor logos.
+- `kettle-family state` is now an alias for `kettle-family release-state`.
+- `kettle-family sync` now fetches the remote default branch, rebases the local
+  default branch onto it, then rebases the original checked-out branch onto the
+  updated local default branch.
+
+### Changed
+
+- `kettle-family release-state` now reports the checked-out branch and displays
+  release distance as local/remote ahead and behind counts.
+- kettle-jem-template-20260720-001 - Generated READMEs can now render
+  template-managed corporate sponsor logos from project or family config.
+- kettle-jem-template-20260720-002 - Generated development Gemfiles now use the
+  released `tree_sitter_language_pack` gem 1.13.3 or newer by default.
+- kettle-jem-template-20260720-003 - Generated StructuredMerge Git diff driver
+  config now uses the installed `smorg-rb` Ruby driver name.
+- kettle-jem-template-20260720-004 - Generated multi-engine workflow files now
+  omit JRuby and TruffleRuby jobs when project config declares MRI-only engines.
+- kettle-jem-template-20260720-005 - Generated README Support & Community rows
+  now include a RubyForum help badge.
+
+### Fixed
+
+- Default member discovery now excludes benchmark fixture gemspecs so benchmark
+  projects are not treated as install/template/release family members.
+- `kettle-family template` now keeps non-verbose `kettle-jem --events` progress
+  compact and omits raw NDJSON event streams from failed text reports.
+- Generated HEAD and runtime dependency HEAD CI workflows no longer include
+  JRuby or TruffleRuby jobs for this MRI-only gem.
+
+## [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 +823,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.0.0...HEAD
+[Unreleased]: https://github.com/kettle-dev/kettle-family/compare/v1.0.2...HEAD
+[1.0.2]: https://github.com/kettle-dev/kettle-family/compare/v1.0.1...v1.0.2
+[1.0.2t]: https://github.com/kettle-dev/kettle-family/releases/tag/v1.0.2
+[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

@@ -45,7 +45,7 @@ while RubyGems MFA prompts remain interactive.
 | Tokens to Remember | [![Gem name][⛳️name-img]][⛳️gem-name] [![Gem namespace][⛳️namespace-img]][⛳️gem-namespace] |
 |-------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
 | Works with MRI Ruby 4 | [![Ruby current Compat][💎ruby-c-i]][🚎11-c-wf] [![Ruby HEAD Compat][💎ruby-headi]][🚎3-hd-wf]|
-| Support & Community | [![Join Me on Daily.dev's RubyFriends][✉️ruby-friends-img]][✉️ruby-friends] [![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] |
+| Support & Community | [![Join Me on Daily.dev's RubyFriends][✉️ruby-friends-img]][✉️ruby-friends] [![Get help from RubyForum][✉️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] |
 | Source | [![Source on GitLab.com][📜src-gl-img]][📜src-gl] [![Source on CodeBerg.org][📜src-cb-img]][📜src-cb] [![Source on Github.com][📜src-gh-img]][📜src-gh] [![The best SHA: dQw4w9WgXcQ!][🧮kloc-img]][🧮kloc] |
 | Documentation | [![Current release on RubyDoc.info][📜docs-cr-rd-img]][🚎yard-current] [![YARD on Galtzo.com][📜docs-head-rd-img]][🚎yard-head] [![Maintainer Blog][🚂maint-blog-img]][🚂maint-blog] [![GitLab Wiki][📜gl-wiki-img]][📜gl-wiki] [![GitHub Wiki][📜gh-wiki-img]][📜gh-wiki] |
 | Compliance | [![License: AGPL-3.0-only][📄license-img]][📄license] [![Apache license compatibility: Category X][📄license-compat-img]][📄license-compat] [![📄ilo-declaration-img]][📄ilo-declaration] [![Security Policy][🔐security-img]][🔐security] [![Contributor Covenant 2.1][🪇conduct-img]][🪇conduct] [![SemVer 2.0.0][📌semver-img]][📌semver] |
@@ -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">
@@ -476,6 +560,8 @@ Thanks for RTFM. ☺️
 [✉️discord-invite-img-ftb]: https://img.shields.io/discord/1373797679469170758?style=for-the-badge&logo=discord
 [✉️ruby-friends-img]: https://img.shields.io/badge/daily.dev-%F0%9F%92%8E_Ruby_Friends-0A0A0A?style=for-the-badge&logo=dailydotdev&logoColor=white
 [✉️ruby-friends]: https://app.daily.dev/squads/rubyfriends
+[✉️ruby-forum-img]: https://img.shields.io/badge/RubyForum-Help-CC342D?style=for-the-badge&logo=ruby&logoColor=white
+[✉️ruby-forum]: https://www.rubyforum.org/c/help/8
 
 [✇bundle-group-pattern]: https://gist.github.com/pboling/4564780
 [⛳️gem-namespace]: https://github.com/kettle-dev/kettle-family
@@ -583,7 +669,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.761-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,8 +10,8 @@ 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
-      WORKFLOW_COMMANDS = %w[check test lint docs template gha-sha-pins bup bupb bex release push pull up].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 sync up branch-lanes release-state state].freeze
+      WORKFLOW_COMMANDS = %w[check test lint docs template gha-sha-pins bup bupb bex release push pull sync up].freeze
 
       command_name "kettle-family"
       usage "[options] COMMAND [ARGS...]"
@@ -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,
@@ -251,6 +254,16 @@ module Kettle
         end
       end
 
+      class State < ReleaseState
+        command_name "state"
+        description "Alias for release-state."
+
+        def run(*args)
+          unexpected_arguments!(args)
+          run_family("release-state")
+        end
+      end
+
       class WorkflowCommand < BaseCommand
         include ExecutionOptions
         include WorkflowOptions
@@ -353,11 +366,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 +379,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 +442,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 +464,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),
@@ -448,6 +485,12 @@ module Kettle
         description "Plan or execute git pull --rebase per member."
       end
 
+      class Sync < WorkflowCommand
+        command_name "sync"
+        usage "[options]"
+        description "Plan or execute default-branch fetch/rebase and branch rebase per member."
+      end
+
       class Up < WorkflowCommand
         command_name "up"
         usage "[options]"
@@ -468,14 +511,17 @@ module Kettle
       command Bupb
       command Bex
       command Install
+      command Bump
       command BumpVersion
       command AddChangelog
       command Release
       command Push
       command Pull
+      command Sync
       command Up
       command BranchLanes
       command ReleaseState
+      command State
 
       prepend ReturningMain
 
@@ -514,7 +560,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 +589,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 +620,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 +648,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 +741,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

@@ -9,6 +9,8 @@ module Kettle
       DEFAULT_MEMBER_EXCLUDES = [
         "vendor/**",
         "**/vendor/**",
+        "benchmarks/**",
+        "**/benchmarks/**",
         "tmp/**",
         "**/tmp/**",
         "spec/**",
@@ -190,6 +192,13 @@ module Kettle
         fetch_path("template", "jobs")
       end
 
+      def readme_corporate_sponsors
+        raw = fetch_path("readme", "corporate_sponsors") ||
+          fetch_path("sponsorships", "corporate") ||
+          fetch_path("corporate_sponsors")
+        normalize_corporate_sponsors(raw)
+      end
+
       def normalize_lockfiles?
         fetch_path("template", "normalize_lockfiles") == true
       end
@@ -278,9 +287,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
@@ -306,6 +315,28 @@ module Kettle
           .select { |path| File.directory?(path) }
       end
 
+      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"
+          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"
+          end
+
+          {
+            "name" => name,
+            "url" => url,
+            "img_src" => img_src
+          }
+        end
+      end
+
       def fetch_path(*keys)
         keys.reduce(data) do |memo, key|
           break nil unless memo.is_a?(Hash)