kettle-jem 7.1.28 → 7.1.30

data/lib/kettle/jem/templates/.github/workflows/truffleruby-23.1.yml.example

@@ -5,6 +5,15 @@ permissions:
 
 env:
   K_SOUP_COV_DO: false
+  # TruffleRuby intermittently stalls the parallel test worker pool; keep
+  # this lane serial while maintained runtimes exercise the parallel runner.
+  # Two workers: TruffleRuby parallelism is spawn-based like every other
+  # engine; serial-only lanes waste CI time and trip the stall watchdog on
+  # legitimately long tests.
+  TURBO_TESTS2_MAX_PROCESSES: 2
+  # Serial lanes can legitimately run one long, silent test; give the stall
+  # watchdog a wider berth than the 4.0 default of 900s.
+  TURBO_TESTS2_WATCHDOG_SECONDS: 1500
 
 on:
   push:
@@ -27,9 +36,10 @@ concurrency:
 
 jobs:
   test:
-    if: "(github.event_name != 'push' || (!contains(github.event.head_commit.message, '[ci skip]') && !contains(github.event.head_commit.message, '[skip ci]'))) && (github.event_name != 'pull_request' || startsWith(github.head_ref, 'engines/') || startsWith(github.head_ref, 'truffleruby/') || startsWith(github.head_ref, 'feature/release'))"
+    if: "(github.event_name != 'push' || (!contains(github.event.head_commit.message, '[ci skip]') && !contains(github.event.head_commit.message, '[skip ci]'))) && (github.event_name != 'pull_request' || startsWith(github.head_ref, 'engines/') || startsWith(github.head_ref, 'truffleruby/') || startsWith(github.head_ref, 'feature/release') || startsWith(github.event.pull_request.title, 'Release '))"
     name: Specs ${{ matrix.ruby }}@${{ matrix.appraisal }}
     runs-on: ubuntu-22.04
+    timeout-minutes: 30
     continue-on-error: ${{ matrix.experimental || endsWith(matrix.ruby, 'head') }}
     env: # $BUNDLE_GEMFILE must be set at job level, so it is set for all steps
       BUNDLE_GEMFILE: ${{ github.workspace }}/gemfiles/ruby_3_2.gemfile
@@ -54,7 +64,7 @@ jobs:
 
       - name: Setup Ruby & RubyGems
         if: ${{ !env.ACT }}
-        uses: appraisal-rb/setup-ruby-flash@925395edf973d2dc0a629919f407f3547a03d4b5 # v2.1 compatibility bundle installation
+        uses: appraisal-rb/setup-ruby-flash@6f8ad36ba7488db591541483afb5464d01e8861b # v2.14 compatibility bundle installation
         with:
           ruby-version: ${{ matrix.ruby }}
           rubygems: ${{ matrix.rubygems }}

data/lib/kettle/jem/templates/.github/workflows/truffleruby-24.2.yml.example

@@ -5,6 +5,15 @@ permissions:
 
 env:
   K_SOUP_COV_DO: false
+  # TruffleRuby intermittently stalls the parallel test worker pool; keep
+  # this lane serial while maintained runtimes exercise the parallel runner.
+  # Two workers: TruffleRuby parallelism is spawn-based like every other
+  # engine; serial-only lanes waste CI time and trip the stall watchdog on
+  # legitimately long tests.
+  TURBO_TESTS2_MAX_PROCESSES: 2
+  # Serial lanes can legitimately run one long, silent test; give the stall
+  # watchdog a wider berth than the 4.0 default of 900s.
+  TURBO_TESTS2_WATCHDOG_SECONDS: 1500
 
 on:
   push:
@@ -27,9 +36,10 @@ concurrency:
 
 jobs:
   test:
-    if: "(github.event_name != 'push' || (!contains(github.event.head_commit.message, '[ci skip]') && !contains(github.event.head_commit.message, '[skip ci]'))) && (github.event_name != 'pull_request' || startsWith(github.head_ref, 'engines/') || startsWith(github.head_ref, 'truffleruby/') || startsWith(github.head_ref, 'feature/release'))"
+    if: "(github.event_name != 'push' || (!contains(github.event.head_commit.message, '[ci skip]') && !contains(github.event.head_commit.message, '[skip ci]'))) && (github.event_name != 'pull_request' || startsWith(github.head_ref, 'engines/') || startsWith(github.head_ref, 'truffleruby/') || startsWith(github.head_ref, 'feature/release') || startsWith(github.event.pull_request.title, 'Release '))"
     name: Specs ${{ matrix.ruby }}@${{ matrix.appraisal }}
     runs-on: ubuntu-22.04
+    timeout-minutes: 30
     continue-on-error: ${{ matrix.experimental || endsWith(matrix.ruby, 'head') }}
     env: # $BUNDLE_GEMFILE must be set at job level, so it is set for all steps
       BUNDLE_GEMFILE: ${{ github.workspace }}/Appraisal.root.gemfile
@@ -53,7 +63,7 @@ jobs:
 
       - name: Setup Ruby & RubyGems
         if: ${{ !env.ACT }}
-        uses: appraisal-rb/setup-ruby-flash@925395edf973d2dc0a629919f407f3547a03d4b5 # v2.1 compatibility bundle installation
+        uses: appraisal-rb/setup-ruby-flash@6f8ad36ba7488db591541483afb5464d01e8861b # v2.14 compatibility bundle installation
         with:
           ruby-version: ${{ matrix.ruby }}
           rubygems: ${{ matrix.rubygems }}
@@ -74,7 +84,10 @@ jobs:
         id: bundleAppraisalAttempt2
         # If bundleAppraisalAttempt1 failed, try again here; Otherwise skip.
         if: ${{ steps.bundleAppraisalAttempt1.outcome == 'failure' && !env.ACT }}
-        run: bundle exec appraisal ${{ matrix.appraisal }} install
+        run: |
+          rm -f gemfiles/${{ matrix.appraisal }}.gemfile.lock
+          rm -rf vendor/bundle "$HOME/.bundle/cache"
+          bundle exec appraisal ${{ matrix.appraisal }} install
 
       - name: Restore RSpec status log
         if: "${{!env.ACT}}"

data/lib/kettle/jem/templates/.github/workflows/truffleruby-25.0.yml.example

@@ -5,6 +5,15 @@ permissions:
 
 env:
   K_SOUP_COV_DO: false
+  # TruffleRuby intermittently stalls the parallel test worker pool; keep
+  # this lane serial while maintained runtimes exercise the parallel runner.
+  # Two workers: TruffleRuby parallelism is spawn-based like every other
+  # engine; serial-only lanes waste CI time and trip the stall watchdog on
+  # legitimately long tests.
+  TURBO_TESTS2_MAX_PROCESSES: 2
+  # Serial lanes can legitimately run one long, silent test; give the stall
+  # watchdog a wider berth than the 4.0 default of 900s.
+  TURBO_TESTS2_WATCHDOG_SECONDS: 1500
 
 on:
   push:
@@ -27,9 +36,10 @@ concurrency:
 
 jobs:
   test:
-    if: "(github.event_name != 'push' || (!contains(github.event.head_commit.message, '[ci skip]') && !contains(github.event.head_commit.message, '[skip ci]'))) && (github.event_name != 'pull_request' || startsWith(github.head_ref, 'engines/') || startsWith(github.head_ref, 'truffleruby/') || startsWith(github.head_ref, 'feature/release'))"
+    if: "(github.event_name != 'push' || (!contains(github.event.head_commit.message, '[ci skip]') && !contains(github.event.head_commit.message, '[skip ci]'))) && (github.event_name != 'pull_request' || startsWith(github.head_ref, 'engines/') || startsWith(github.head_ref, 'truffleruby/') || startsWith(github.head_ref, 'feature/release') || startsWith(github.event.pull_request.title, 'Release '))"
     name: Specs ${{ matrix.ruby }}@${{ matrix.appraisal }}
     runs-on: ubuntu-22.04
+    timeout-minutes: 30
     continue-on-error: ${{ matrix.experimental || endsWith(matrix.ruby, 'head') }}
     env: # $BUNDLE_GEMFILE must be set at job level, so it is set for all steps
       BUNDLE_GEMFILE: ${{ github.workspace }}/Appraisal.root.gemfile
@@ -53,7 +63,7 @@ jobs:
 
       - name: Setup Ruby & RubyGems
         if: ${{ !env.ACT }}
-        uses: appraisal-rb/setup-ruby-flash@925395edf973d2dc0a629919f407f3547a03d4b5 # v2.1 compatibility bundle installation
+        uses: appraisal-rb/setup-ruby-flash@6f8ad36ba7488db591541483afb5464d01e8861b # v2.14 compatibility bundle installation
         with:
           ruby-version: ${{ matrix.ruby }}
           rubygems: ${{ matrix.rubygems }}
@@ -79,7 +89,10 @@ jobs:
         id: bundleAppraisalAttempt2
         # If bundleAppraisalAttempt1 failed, try again here; Otherwise skip.
         if: ${{ steps.bundleAppraisalAttempt1.outcome == 'failure' && !env.ACT }}
-        run: bundle exec appraisal ${{ matrix.appraisal }} install
+        run: |
+          rm -f gemfiles/${{ matrix.appraisal }}.gemfile.lock
+          rm -rf vendor/bundle "$HOME/.bundle/cache"
+          bundle exec appraisal ${{ matrix.appraisal }} install
 
       - name: Restore RSpec status log
         if: "${{!env.ACT}}"

data/lib/kettle/jem/templates/.github/workflows/truffleruby-33.0.yml.example

@@ -5,6 +5,15 @@ permissions:
 
 env:
   K_SOUP_COV_DO: false
+  # TruffleRuby intermittently stalls the parallel test worker pool; keep
+  # this lane serial while maintained runtimes exercise the parallel runner.
+  # Two workers: TruffleRuby parallelism is spawn-based like every other
+  # engine; serial-only lanes waste CI time and trip the stall watchdog on
+  # legitimately long tests.
+  TURBO_TESTS2_MAX_PROCESSES: 2
+  # Serial lanes can legitimately run one long, silent test; give the stall
+  # watchdog a wider berth than the 4.0 default of 900s.
+  TURBO_TESTS2_WATCHDOG_SECONDS: 1500
 
 on:
   push:
@@ -27,9 +36,10 @@ concurrency:
 
 jobs:
   test:
-    if: "(github.event_name != 'push' || (!contains(github.event.head_commit.message, '[ci skip]') && !contains(github.event.head_commit.message, '[skip ci]'))) && (github.event_name != 'pull_request' || startsWith(github.head_ref, 'engines/') || startsWith(github.head_ref, 'truffleruby/') || startsWith(github.head_ref, 'feature/release'))"
+    if: "(github.event_name != 'push' || (!contains(github.event.head_commit.message, '[ci skip]') && !contains(github.event.head_commit.message, '[skip ci]'))) && (github.event_name != 'pull_request' || startsWith(github.head_ref, 'engines/') || startsWith(github.head_ref, 'truffleruby/') || startsWith(github.head_ref, 'feature/release') || startsWith(github.event.pull_request.title, 'Release '))"
     name: Specs ${{ matrix.ruby }}@${{ matrix.appraisal }}
     runs-on: ubuntu-22.04
+    timeout-minutes: 30
     continue-on-error: ${{ matrix.experimental || endsWith(matrix.ruby, 'head') }}
     env: # $BUNDLE_GEMFILE must be set at job level, so it is set for all steps
       BUNDLE_GEMFILE: ${{ github.workspace }}/Appraisal.root.gemfile
@@ -53,7 +63,7 @@ jobs:
 
       - name: Setup Ruby & RubyGems
         if: ${{ !env.ACT }}
-        uses: appraisal-rb/setup-ruby-flash@925395edf973d2dc0a629919f407f3547a03d4b5 # v2.1 compatibility bundle installation
+        uses: appraisal-rb/setup-ruby-flash@6f8ad36ba7488db591541483afb5464d01e8861b # v2.14 compatibility bundle installation
         with:
           ruby-version: ${{ matrix.ruby }}
           rubygems: ${{ matrix.rubygems }}
@@ -74,7 +84,10 @@ jobs:
         id: bundleAppraisalAttempt2
         # If bundleAppraisalAttempt1 failed, try again here; Otherwise skip.
         if: ${{ steps.bundleAppraisalAttempt1.outcome == 'failure' && !env.ACT }}
-        run: bundle exec appraisal ${{ matrix.appraisal }} install
+        run: |
+          rm -f gemfiles/${{ matrix.appraisal }}.gemfile.lock
+          rm -rf vendor/bundle "$HOME/.bundle/cache"
+          bundle exec appraisal ${{ matrix.appraisal }} install
 
       - name: Restore RSpec status log
         if: "${{!env.ACT}}"

data/lib/kettle/jem/templates/.github/workflows/unlocked_deps.yml.example

@@ -47,6 +47,7 @@ jobs:
     if: "github.event_name != 'push' || (!contains(github.event.head_commit.message, '[ci skip]') && !contains(github.event.head_commit.message, '[skip ci]'))"
     name: Default rake task w/ unlocked deps ${{ matrix.name_extra || '' }}
     runs-on: ubuntu-latest
+    timeout-minutes: 30
     continue-on-error: ${{ matrix.experimental || endsWith(matrix.ruby, 'head') }}
     env: # $BUNDLE_GEMFILE must be set at job level, so it is set for all steps
       BUNDLE_GEMFILE: ${{ github.workspace }}/Appraisal.root.gemfile
@@ -67,7 +68,7 @@ jobs:
           persist-credentials: false
 
       - name: Setup Ruby & RubyGems
-        uses: appraisal-rb/setup-ruby-flash@925395edf973d2dc0a629919f407f3547a03d4b5 # v2.1 compatibility bundle installation
+        uses: appraisal-rb/setup-ruby-flash@6f8ad36ba7488db591541483afb5464d01e8861b # v2.14 compatibility bundle installation
         with:
           ruby-version: ${{ matrix.ruby }}
           rubygems: ${{ matrix.rubygems }}
@@ -87,7 +88,10 @@ jobs:
         id: bundleAppraisalAttempt2
         # If bundleAppraisalAttempt1 failed, try again here; Otherwise skip.
         if: ${{ steps.bundleAppraisalAttempt1.outcome == 'failure' }}
-        run: bundle exec appraisal ${{ matrix.appraisal }} install
+        run: |
+          rm -f gemfiles/${{ matrix.appraisal }}.gemfile.lock
+          rm -rf vendor/bundle "$HOME/.bundle/cache"
+          bundle exec appraisal ${{ matrix.appraisal }} install
 
       - name: Run ${{ matrix.exec_cmd }} on ${{ matrix.ruby }}@${{ matrix.appraisal }}
         run: bundle exec appraisal ${{ matrix.appraisal }} bundle exec ${{ matrix.exec_cmd }}

data/lib/kettle/jem/templates/.structuredmerge/kettle-jem.yml.example

@@ -101,6 +101,8 @@ author_aliases:
 # Supported actions (the destination project must explicitly choose one):
 #   remove_modular_gem       - remove the modular Gemfile's direct gem call.
 #   remove_x_std_lib_eval    - remove x_std_libs eval references for the gem.
+#   remove_direct_gem        - remove the gemspec's or Gemfile's direct
+#                              declaration, keeping the modular Gemfile's.
 #   keep_both                - retain both declarations when their requirements
 #                              overlap. This is intended for a broad direct
 #                              requirement narrowed by framework/engine Gemfiles;
@@ -143,6 +145,20 @@ engines:
   - jruby
   - truffleruby
 
+# List the OS platforms this project's CI exercises. kettle-jem uses this to
+# generate the current.yml OS matrix and the README platform tier table.
+# Windows applies only when declared: the `if: matrix.os` guards and the
+# Windows-only test step are emitted solely for destinations that opt in.
+#
+# Supported values: linux, macos, windows
+# Default (when key is absent): linux, macos
+# These are CI OS families, a distinct vocabulary from Gem::Platform strings
+# and Gemfile DSL platform symbols; never reuse them for
+# `bundle lock --add-platform`.
+platforms:
+  - linux
+  - macos
+
 # Ruby version policy.
 ruby:
   # Lowest MRI Ruby version for generated CI workflows, Appraisals, and
@@ -556,6 +572,9 @@ patterns:
     strategy: raw_copy
   - path: ".github/workflows/**"
     strategy: accept_template
+  # Signature stub files are fully generated; there is nothing here to hand-edit.
+  - path: "sig/**/*.rbs"
+    strategy: accept_template
 
 # Per-file configuration (nested directory structure)
 # Only files that need overrides belong here. Everything else defaults to merge.

data/lib/kettle/jem/templates/Appraisal.root.gemfile.example

@@ -15,7 +15,8 @@ source "https://gem.coop"
 
 gemspec
 
-if Gem::Version.new(RUBY_VERSION) >= Gem::Version.new("3.2")
+# The style toolchain includes dependencies that require Ruby 3.3 or newer.
+if Gem::Version.new(RUBY_VERSION) >= Gem::Version.new("3.3")
   if respond_to?(:generator_only)
     generator_only do
       eval_gemfile "gemfiles/modular/style.gemfile"

data/lib/kettle/jem/templates/Appraisals.example

@@ -48,6 +48,10 @@ appraise "unlocked_deps" do
   eval_gemfile "modular/documentation.gemfile"
   eval_gemfile "modular/optional.gemfile"
   eval_gemfile "modular/recording/r4/recording.gemfile"
+  # Development dependencies shunted out of the gemspec - see
+  # gemfiles/modular/shunted.gemfile's own header for exactly which ones
+  # and why.
+  eval_gemfile "modular/shunted.gemfile"
   eval_gemfile "modular/style.gemfile"
   eval_gemfile "modular/x_std_libs.gemfile"
 end
@@ -99,7 +103,6 @@ end
 
 appraise "ruby-3-0" do
   eval_gemfile "modular/json/truffleruby_22_3.gemfile"
-  eval_gemfile "modular/json/truffleruby_23_0.gemfile"
   eval_gemfile "modular/recording/r3/recording.gemfile"
   eval_gemfile "modular/x_std_libs/r3.1/libs.gemfile"
 end

data/lib/kettle/jem/templates/CHANGELOG.transfer.md

@@ -40,6 +40,12 @@ the other fields accept `=` or `!=`.
 - kettle-jem-template-20260729-005 [if feature.rubyforum_project_tag=true] - Gemspec metadata now publishes this
   project's RubyForum tag as `mailing_list_uri`, and support docs link to the
   tagged RubyForum community alongside Discord.
+- kettle-jem-template-20260913-001 - Templating now also surfaces a review
+  entry in `dependency_conflicts.resolve` when a direct development
+  dependency doesn't support one or more of this project's declared
+  `engines:` and has no template-managed modular home (e.g. `sqlite3` on
+  `jruby`). Review each entry and pick a resolution per the project's own
+  engine support needs.
 
 ## Changed
 

data/lib/kettle/jem/templates/Gemfile.example

@@ -8,7 +8,6 @@
 
 source "https://gem.coop"
 
-git_source(:github) { |repo_name| "git@github.com:#{repo_name}.git" }
 git_source(:codeberg) { |repo_name| "https://codeberg.org/#{repo_name}" }
 git_source(:gitlab) { |repo_name| "https://gitlab.com/#{repo_name}" }
 
@@ -25,8 +24,18 @@ gemspec
 
 {KJ|MAIN_GEMFILE_DIRECT_SIBLING_BLOCK}
 
-# Templating (env-switched: STRUCTUREDMERGE_DEV=/path/to/structuredmerge/ruby/gems for local paths)
-eval_gemfile "gemfiles/modular/templating.gemfile" if ENV.fetch("K_JEM_TEMPLATING", "false").casecmp("true").zero?
+# Templating and the StructuredMerge family share this modular Gemfile.
+# kettle-jem needs StructuredMerge to template, and kettle-changelog needs it at
+# runtime (ast-crispr-markdown-markly -> markdown-merge -> tree_haver), so the
+# test, lint, and release bundles resolve the family too. While the family is
+# only partially released, registry copies pin the last published version exactly
+# and cannot be satisfied alongside a local lockstep version, so a partial local
+# wiring fails version solving for every command in the bundle.
+#
+# (env-switched: STRUCTUREDMERGE_DEV=/path/to/structuredmerge/ruby/gems for local paths)
+eval_gemfile "gemfiles/modular/templating.gemfile" if
+  ENV.fetch("K_JEM_TEMPLATING", "false").casecmp("true").zero? ||
+  ENV.fetch("STRUCTUREDMERGE_DEV", "false").casecmp("false") != 0
 
 # Debugging
 eval_gemfile "gemfiles/modular/debug.gemfile"

data/lib/kettle/jem/templates/README.md.example

@@ -35,7 +35,7 @@ I've summarized my thoughts in [this blog post](https://dev.to/galtzo/hostile-ta
 | Tokens to Remember      | [![Gem name][⛳️name-img]][⛳️gem-name] [![Gem namespace][⛳️namespace-img]][⛳️gem-namespace]                                                                                                                                                                                                                                                                          |
 |-------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
 | Works with JRuby        | [![JRuby 9.1 Compat][💎jruby-9.1i]][🚎jruby-9.1-wf] [![JRuby 9.2 Compat][💎jruby-9.2i]][🚎jruby-9.2-wf] [![JRuby 9.3 Compat][💎jruby-9.3i]][🚎jruby-9.3-wf] <br/> [![JRuby 9.4 Compat][💎jruby-9.4i]][🚎jruby-9.4-wf] [![JRuby 10.0 Compat][💎jruby-10.0i]][🚎jruby-10.0-wf] [![JRuby current Compat][💎jruby-c-i]][🚎10-j-wf] [![JRuby HEAD Compat][💎jruby-headi]][🚎3-hd-wf]                                                                                                       |
-| Works with Truffle Ruby | [![Truffle Ruby 22.3 Compat][💎truby-22.3i]][🚎truby-22.3-wf] [![Truffle Ruby 23.0 Compat][💎truby-23.0i]][🚎truby-23.0-wf] [![Truffle Ruby 23.1 Compat][💎truby-23.1i]][🚎truby-23.1-wf] <br/> [![Truffle Ruby 24.2 Compat][💎truby-24.2i]][🚎truby-24.2-wf] [![Truffle Ruby 25.0 Compat][💎truby-25.0i]][🚎truby-25.0-wf] [![Truffle Ruby 33.0 Compat][💎truby-33.0i]][🚎truby-33.0-wf] [![Truffle Ruby current Compat][💎truby-c-i]][🚎9-t-wf] [![Truffle Ruby HEAD Compat][💎truby-headi]][🚎3-hd-wf]                                                                                                                 |
+| Works with Truffle Ruby | [![Truffle Ruby 22.3 Compat][💎truby-22.3i]][🚎truby-22.3-wf] [![Truffle Ruby 23.1 Compat][💎truby-23.1i]][🚎truby-23.1-wf] <br/> [![Truffle Ruby 24.2 Compat][💎truby-24.2i]][🚎truby-24.2-wf] [![Truffle Ruby 25.0 Compat][💎truby-25.0i]][🚎truby-25.0-wf] [![Truffle Ruby 33.0 Compat][💎truby-33.0i]][🚎truby-33.0-wf] [![Truffle Ruby current Compat][💎truby-c-i]][🚎9-t-wf]                                                                                                                 |
 | Works with MRI Ruby 4   | [![Ruby current Compat][💎ruby-c-i]][🚎11-c-wf] [![Ruby HEAD Compat][💎ruby-headi]][🚎3-hd-wf]                                                                                                                                                                                                                  |
 | Works with MRI Ruby 3   | [![Ruby 3.0 Compat][💎ruby-3.0i]][🚎ruby-3.0-wf] [![Ruby 3.1 Compat][💎ruby-3.1i]][🚎ruby-3.1-wf] [![Ruby 3.2 Compat][💎ruby-3.2i]][🚎ruby-3.2-wf] [![Ruby 3.3 Compat][💎ruby-3.3i]][🚎ruby-3.3-wf] [![Ruby 3.4 Compat][💎ruby-3.4i]][🚎ruby-3.4-wf]                                                                                                            |
 | Works with MRI Ruby 2   | ![Ruby 2.0 Compat][💎ruby-2.0i] ![Ruby 2.1 Compat][💎ruby-2.1i] ![Ruby 2.2 Compat][💎ruby-2.2i] ![Ruby 2.3 Compat][💎ruby-2.3i] <br/> [![Ruby 2.4 Compat][💎ruby-2.4i]][🚎ruby-2.4-wf] [![Ruby 2.5 Compat][💎ruby-2.5i]][🚎ruby-2.5-wf] [![Ruby 2.6 Compat][💎ruby-2.6i]][🚎ruby-2.6-wf] [![Ruby 2.7 Compat][💎ruby-2.7i]][🚎ruby-2.7-wf]                              |
@@ -64,6 +64,10 @@ The _amazing_ test matrix is powered by the kettle-dev stack.
 
 {KJ|README:FAMILY_INTRO_BACKEND_MATRIX}
 
+### Runtime and Platform Support
+
+{KJ|README:PLATFORM_SUPPORT_TABLE}
+
 ### Federated DVCS
 
 <details markdown="1">
@@ -441,8 +445,6 @@ Thanks for RTFM. ☺️
 [🚎jruby-10.0-wfi]: {KJ|README:GH_REPOSITORY_URL}/actions/workflows/jruby-10.0.yml/badge.svg
 [🚎truby-22.3-wf]: {KJ|README:GH_REPOSITORY_URL}/actions/workflows/truffleruby-22.3.yml
 [🚎truby-22.3-wfi]: {KJ|README:GH_REPOSITORY_URL}/actions/workflows/truffleruby-22.3.yml/badge.svg
-[🚎truby-23.0-wf]: {KJ|README:GH_REPOSITORY_URL}/actions/workflows/truffleruby-23.0.yml
-[🚎truby-23.0-wfi]: {KJ|README:GH_REPOSITORY_URL}/actions/workflows/truffleruby-23.0.yml/badge.svg
 [🚎truby-23.1-wf]: {KJ|README:GH_REPOSITORY_URL}/actions/workflows/truffleruby-23.1.yml
 [🚎truby-23.1-wfi]: {KJ|README:GH_REPOSITORY_URL}/actions/workflows/truffleruby-23.1.yml/badge.svg
 [🚎truby-24.2-wf]: {KJ|README:GH_REPOSITORY_URL}/actions/workflows/truffleruby-24.2.yml
@@ -490,13 +492,11 @@ Thanks for RTFM. ☺️
 [💎ruby-c-i]: https://img.shields.io/badge/Ruby-current-CC342D?style=for-the-badge&logo=ruby&logoColor=green
 [💎ruby-headi]: https://img.shields.io/badge/Ruby-HEAD-CC342D?style=for-the-badge&logo=ruby&logoColor=blue
 [💎truby-22.3i]: https://img.shields.io/badge/Truffle_Ruby-22.3-34BCB1?style=for-the-badge&logo=ruby&logoColor=pink
-[💎truby-23.0i]: https://img.shields.io/badge/Truffle_Ruby-23.0-34BCB1?style=for-the-badge&logo=ruby&logoColor=pink
 [💎truby-23.1i]: https://img.shields.io/badge/Truffle_Ruby-23.1-34BCB1?style=for-the-badge&logo=ruby&logoColor=pink
 [💎truby-24.2i]: https://img.shields.io/badge/Truffle_Ruby-24.2-34BCB1?style=for-the-badge&logo=ruby&logoColor=pink
 [💎truby-25.0i]: https://img.shields.io/badge/Truffle_Ruby-25.0-34BCB1?style=for-the-badge&logo=ruby&logoColor=pink
 [💎truby-33.0i]: https://img.shields.io/badge/Truffle_Ruby-33.0-34BCB1?style=for-the-badge&logo=ruby&logoColor=pink
 [💎truby-c-i]: https://img.shields.io/badge/Truffle_Ruby-current-34BCB1?style=for-the-badge&logo=ruby&logoColor=green
-[💎truby-headi]: https://img.shields.io/badge/Truffle_Ruby-HEAD-34BCB1?style=for-the-badge&logo=ruby&logoColor=blue
 [💎jruby-9.1i]: https://img.shields.io/badge/JRuby-9.1-FBE742?style=for-the-badge&logo=ruby&logoColor=red
 [💎jruby-9.2i]: https://img.shields.io/badge/JRuby-9.2-FBE742?style=for-the-badge&logo=ruby&logoColor=red
 [💎jruby-9.3i]: https://img.shields.io/badge/JRuby-9.3-FBE742?style=for-the-badge&logo=ruby&logoColor=red

data/lib/kettle/jem/templates/Rakefile.example

@@ -64,6 +64,8 @@ task :default do
   puts "Default task complete."
 end
 
+{KJ|RAKE:TOP_LEVEL_DOCS_TASK}
+
 # simplecov:disable
 ### MONOREPO FAMILY TASKS
 if Dir.exist?(File.join(__dir__, "gems"))

data/lib/kettle/jem/templates/bin/turbo_tests2.example

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+#
+# This file is generated by Kettle Jem.
+# It loads turbo_tests2 from the active bundle for Windows CI.
+#
+
+ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../Gemfile", __dir__)
+
+require "rubygems"
+require "bundler/setup"
+
+load Gem.bin_path("turbo_tests2", "turbo_tests2")

data/lib/kettle/jem/templates/gem.gemspec.example

@@ -118,7 +118,7 @@ Gem::Specification.new do |spec|
   #       and preferably a modular one (see gemfiles/modular/*.gemfile).
 
   # Dev, Test, & Release Tasks
-  spec.add_development_dependency("kettle-dev", "~> 3.1", ">= 3.1.0")             # ruby >= {KJ|MIN_TEST_RUBY}
+  spec.add_development_dependency("kettle-dev", "~> 3.1", ">= 3.1.13")             # ruby >= {KJ|MIN_TEST_RUBY}
 
   # Security
   spec.add_development_dependency("bundler-audit", "~> 0.9.3")                      # ruby >= 2.0.0
@@ -132,13 +132,13 @@ Gem::Specification.new do |spec|
   # Testing
   # Loads version files in anonymous namespaces for coverage without constant redefinition warnings.
   spec.add_development_dependency("anonymous_loader", "~> 0.1", ">= 0.1.3")         # ruby >= 2.2.0
-  spec.add_development_dependency("appraisal2", "~> 3.2", ">= 3.2.3")               # ruby >= 1.8.7, for testing against multiple versions of dependencies
-  spec.add_development_dependency("kettle-test", "~> 2.0", ">= 2.0.21")            # ruby >= {KJ|MIN_TEST_RUBY}
-  spec.add_development_dependency("turbo_tests2", "~> 3.2", ">= 3.2.7")           # ruby >= 2.4.0, default kettle-test runner
+  spec.add_development_dependency("appraisal2", "~> 3.2", ">= 3.2.5")               # ruby >= 1.8.7, for testing against multiple versions of dependencies
+  spec.add_development_dependency("kettle-test", "~> 2.0", ">= 2.0.25")            # ruby >= {KJ|MIN_TEST_RUBY}
+  spec.add_development_dependency("turbo_tests2", "~> 4.0", ">= 4.0.0")           # ruby >= 2.4.0, default kettle-test runner
 
   # Releasing
   spec.add_development_dependency("ruby-progressbar", "~> 1.13")                    # ruby >= 0
-  spec.add_development_dependency("stone_checksums", "~> 1.0", ">= 1.0.8")          # ruby >= 2.2.0
+  spec.add_development_dependency("stone_checksums", "~> 1.0", ">= 1.0.9")          # ruby >= 2.2.0
 
   # Git integration (optional)
   # The 'git' gem is optional; {KJ|GEM_NAME} falls back to shelling out to `git` if it is not present.
@@ -150,7 +150,7 @@ Gem::Specification.new do |spec|
   # This means we have no choice but to use the erb that shipped with Ruby 2.3
   # /opt/hostedtoolcache/Ruby/2.3.8/x64/lib/ruby/gems/2.3.0/gems/erb-2.2.2/lib/erb.rb:670:in `prepare_trim_mode': undefined method `match?' for "-":String (NoMethodError)
   # spec.add_development_dependency("erb", ">= 2.2")                                  # ruby >= 2.3.0, not SemVer, old rubies get dropped in a patch.
-  spec.add_development_dependency("gitmoji-regex", "~> 2.0", ">= 2.0.12")            # ruby >= 2.4
+  spec.add_development_dependency("gitmoji-regex", "~> 2.0", ">= 2.0.15")            # ruby >= 2.4
 
   # HTTP recording for deterministic specs
   # In Ruby 3.5 (HEAD) the CGI library has been pared down, so we also need to depend on gem "cgi" for ruby@head

data/lib/kettle/jem/templates/gemfiles/modular/coverage.gemfile.example

@@ -7,7 +7,7 @@
 if ENV.fetch("KETTLE_DEV_DEV", "false").casecmp("false").zero?
   # Coverage (remote/released)
   platform :mri do
-    gem "kettle-soup-cover", "~> 3.0", ">= 3.0.10", require: false
+    gem "kettle-soup-cover", "~> 3.0", ">= 3.0.12", require: false
   end
 else
   eval_gemfile "coverage_local.gemfile"

data/lib/kettle/jem/templates/gemfiles/modular/coverage_local.gemfile.example

@@ -6,6 +6,14 @@
 {KJ|LOCAL_GEMFILE_NOMONO_BOOTSTRAP}
 
 local_gems = %w[{KJ|KETTLE_DEV_LOCAL_GEMS}]
+kettle_dev_nomono_options = {
+  prefix: "KETTLE_DEV",
+  path_env: "KETTLE_DEV_DEV",
+  vendored_gems_env: "VENDORED_GEMS",
+  vendor_gem_dir_env: "VENDOR_GEM_DIR",
+  debug_env: "KETTLE_DEV_DEBUG",
+  root: ["src", "my", "kettle-dev"]
+}
 
 # export KETTLE_DEV_DEV=/path/to/my
 platform :mri do
@@ -14,12 +22,7 @@ platform :mri do
   kettle_dev_dependency = instance_variable_get(:@dependencies).to_a.find { |dependency| dependency.name == "kettle-dev" }
   kettle_dev_local_path = nomono_gems(
     gems: %w[kettle-dev],
-    prefix: "KETTLE_DEV",
-    path_env: "KETTLE_DEV_DEV",
-    vendored_gems_env: "VENDORED_GEMS",
-    vendor_gem_dir_env: "VENDOR_GEM_DIR",
-    debug_env: "KETTLE_DEV_DEBUG",
-    root: ["src", "my", "kettle-dev"]
+    **kettle_dev_nomono_options
   ).fetch("kettle-dev", nil)
   if kettle_dev_dependency && kettle_dev_local_path
     instance_variable_get(:@dependencies).delete(kettle_dev_dependency)
@@ -31,12 +34,7 @@ platform :mri do
 
   eval_nomono_gems(
     gems: local_gems_to_eval,
-    prefix: "KETTLE_DEV",
-    path_env: "KETTLE_DEV_DEV",
-    vendored_gems_env: "VENDORED_GEMS",
-    vendor_gem_dir_env: "VENDOR_GEM_DIR",
-    debug_env: "KETTLE_DEV_DEBUG",
-    root: ["src", "my", "kettle-dev"]
+    **kettle_dev_nomono_options
   )
 
   if ENV.fetch("GALTZO_FLOSS_DEV", "false").casecmp("false") != 0

data/lib/kettle/jem/templates/gemfiles/modular/documentation.gemfile.example

@@ -9,16 +9,16 @@
 # Documentation
 gem "kramdown", "~> 2.5", ">= 2.5.2", require: false # Ruby >= 2.5
 gem "kramdown-parser-gfm", "~> 1.1", require: false # Ruby >= 2.3
-gem "yaml-converter", "~> 0.2", ">= 0.2.5", require: false # Ruby >= 3.2
+gem "yaml-converter", "~> 0.2", ">= 0.2.7", require: false # Ruby >= 3.2
 gem "yard", "~> 0.9", ">= 0.9.45", require: false
 gem "yard-junk", "~> 0.1", ">= 0.1.0", require: false # Ruby >= 3.1
-gem "yard-lint", "~> 1.11", ">= 1.11.0", require: false # Ruby >= 3.3
+gem "yard-lint", "~> 1.12", ">= 1.12.0", require: false # Ruby >= 3.3
 gem "yard-relative_markdown_links", "~> 0.6", require: false
 
 if ENV.fetch("GALTZO_FLOSS_DEV", "false").casecmp("false").zero?
-  gem "yard-fence", "~> 0.9", ">= 0.9.8", require: false # Ruby >= 3.2
-  gem "yard-timekeeper", "~> 0.2", ">= 0.2.6", require: false
-  gem "yard-yaml", "~> 0.2", ">= 0.2.5", require: false
+  gem "yard-fence", "~> 0.9", ">= 0.9.10", require: false # Ruby >= 3.2
+  gem "yard-timekeeper", "~> 0.2", ">= 0.2.9", require: false
+  gem "yard-yaml", "~> 0.2", ">= 0.2.6", require: false
 else
   eval_gemfile "documentation_local.gemfile"
 end

data/lib/kettle/jem/templates/gemfiles/modular/ostruct/r4/v0.6.gemfile.example

@@ -0,0 +1,2 @@
+# Ruby >= 2.5
+gem "ostruct", "~> 0.6"

data/lib/kettle/jem/templates/gemfiles/modular/style.gemfile.example

@@ -9,23 +9,30 @@
 # Style tasks run on the latest Ruby; RuboCop-LTS selects the compatibility
 # rules for the configured Ruby floor independently from task dependency floors.
 
-gem "reek", "~> 6.5", ">= 6.5.0"
+gem "reek", "~> 6.6", ">= 6.6.0"
 
 platform :mri do
-  gem "appraisal2-rubocop", "~> 1.0", ">= 1.0.2", require: false
+  gem "appraisal2-rubocop", "~> 1.0", ">= 1.0.4", require: false
   gem "rubocop-gradual", "~> 0.4", ">= 0.4.0"
+  # rubocop-minitest floor held at 0.40: 0.41.0 requires rubocop >= 1.89.0,
+  # but standard (~> 1.56) caps rubocop at ~> 1.88.0, making the pair
+  # unsatisfiable. This gem is registered in KettleJemDepsFloor::FLOOR_HOLDS,
+  # so kettle-jem-deps-floor will not auto-raise it. Remove the hold (and
+  # raise the floor) once standard supports rubocop >= 1.89.
   gem "rubocop-minitest", "~> 0.40", ">= 0.40.0"
-  gem "rubocop-on-rbs", "~> 2.0", ">= 2.0.0"        # ruby >= 3.2.0
+  if Gem::Version.new(RUBY_VERSION) >= Gem::Version.new("3.3.0")
+    gem "rubocop-on-rbs", "~> 2.2", ">= 2.2.0"      # ruby >= 3.3.0
+  end
   # gem "rubocop", "~> 1.73", ">= 1.73.2" # constrained by standard
-  gem "rubocop-packaging",
-    github: "pboling/rubocop-packaging",
-    ref: "3539ba858d379740d638566faee9e56b2b854145"
-  gem "standard", "~> 1.56", ">= 1.56.0"
+  gem "standard", "~> 1.57", ">= 1.57.0"
 
   if ENV.fetch("RUBOCOP_LTS_DEV", "false").casecmp("false").zero?
+    gem "rubocop-packaging",
+      github: "pboling/rubocop-packaging",
+      ref: "3539ba858d379740d638566faee9e56b2b854145"
     declared_gems = instance_variable_get(:@dependencies).to_a.map(&:name)
     gem "rubocop-lts", {KJ|RUBOCOP_LTS_CONSTRAINT} unless declared_gems.include?("rubocop-lts")
-    gem "rubocop-lts-rspec", "~> 1.0", ">= 1.0.6" unless declared_gems.include?("rubocop-lts-rspec")
+    gem "rubocop-lts-rspec", "~> 1.0", ">= 1.0.7" unless declared_gems.include?("rubocop-lts-rspec")
     gem "{KJ|RUBOCOP_RUBY_GEM}", {KJ|RUBOCOP_RUBY_CONSTRAINT} unless declared_gems.include?("{KJ|RUBOCOP_RUBY_GEM}")
   else
     eval_gemfile("style_local.gemfile")

data/lib/kettle/jem/templates/gemfiles/modular/style_local.gemfile.example

@@ -12,6 +12,12 @@ local_gems = %w[rubocop-lts rubocop-lts-rspec {KJ|RUBOCOP_RUBY_GEM} standard-rub
 declared_gems = instance_variable_get(:@dependencies).to_a.map(&:name)
 local_gems_to_eval = local_gems - %w[{KJ|PACKAGE_NAME}] - declared_gems
 
+# The generated RuboCop config loads this plugin in both local and released
+# style modes, so the local bundle must provide it too.
+gem "rubocop-packaging",
+  github: "pboling/rubocop-packaging",
+  ref: "3539ba858d379740d638566faee9e56b2b854145"
+
 # export VENDORED_GEMS=rubocop-lts,rubocop-lts-rspec,{KJ|RUBOCOP_RUBY_GEM},standard-rubocop-lts
 platform :mri do
   eval_nomono_gems(
@@ -21,6 +27,6 @@ platform :mri do
     vendored_gems_env: "VENDORED_GEMS",
     vendor_gem_dir_env: "VENDOR_GEM_DIR",
     debug_env: "RUBOCOP_LTS_DEBUG",
-    root: ["src", "rubocop-lts"]
+    root: ["src", "my", "rubocop-lts"]
   )
 end

data/lib/kettle/jem/templates/gemfiles/modular/templating.gemfile.example

@@ -17,13 +17,14 @@ if structuredmerge_remote || !tslp_dev.to_s.empty?
 end
 
 if structuredmerge_remote
-  # Merge recipes for released installs.
+  # Keep the released floor when templating with local StructuredMerge paths;
+  # kettle-jem-deps-floor advances this requirement from published versions.
   gem "kettle-jem", {KJ|KETTLE_JEM_DEPENDENCY_ARGUMENTS}
 end
 
 if kettle_remote
   # Template/plugin checks for released installs.
-  gem "kettle-drift", "~> 1.0", ">= 1.0.13", require: false
+  gem "kettle-drift", "~> 1.0", ">= 1.0.16", require: false
 end
 
 # Set STRUCTUREDMERGE_DEV=/path/to/structuredmerge/ruby/gems for local development with path-based dependencies.