kettle-jem 7.1.8 → 7.1.11

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f6c5f5fc9bc53f2126159023d8c5648b14d48bf686a3db540d79468848fb3d30
-  data.tar.gz: f44a05f17df8cb139e53b1bae7be96c439eada3e4f958387175e161ba08bf93b
+  metadata.gz: 4557a45c40575cf35c6a6630ca4f15694407df55cae707f4187c282111a5fe6e
+  data.tar.gz: df10a122743e47d9236115a4e7d44fbc0342a70de1da7643b863da983f9d800e
 SHA512:
-  metadata.gz: fdafbae49efd6f2858c718ee4b7df6a14502c561e8d98b9bf11c96d5b1795b4710f2eb0aeddb3951392d9ec164afb533aa7db4d56ea6ea7cb44da21bc9398efa
-  data.tar.gz: 186e8070d0d5aed6c18d6db8937e3d267ac38bef6703f2e5445b6bdfffc6cf2da9a097f63b580084c7eabce82fe7631eaa6da18c45ddfe09da1fe2133bb7a55f
+  metadata.gz: 77dfdae1740bbe776afb7d9f181a34244c6bd594cc0b9d6d274e9183c8d1be60894c7c112243c9f5d064f9cf4a57b2ec043e0bb84d55eb4dfe86b48008f535c7
+  data.tar.gz: 17fac3e17f62555dc40598d641007ce21c05c7968cb9745409b3eeaf153c86648b47dde2abaee0b2ed1a82cab268e267eeeac1ce31fbf2d69d493119de03d9bc

data/CHANGELOG.md

@@ -30,6 +30,89 @@ Please file a bug if you notice a violation of semantic versioning.
 
 ### Security
 
+## [7.1.11] - 2026-08-29
+
+- TAG: [v7.1.11][7.1.11t]
+- COVERAGE: 93.64% -- 11027/11776 lines in 16 files
+- BRANCH COVERAGE: 76.95% -- 4698/6105 branches in 16 files
+- 17.95% documented
+
+### Changed
+
+- [kc] kettle-jem/template: updated 398 project files:
+  - code and tests (20)
+  - configuration (12)
+  - dependencies (147)
+  - documentation (9)
+  - other (123)
+  - workflows (87)
+
+- [kc] kettle-jem-deps-floor: Update kettle-jem template dependency floors:
+  - kettle-changelog (>= 1.0.5 -> >= 1.0.6)
+  - kettle-jem (>= 7.1.8 -> >= 7.1.10)
+  - turbo_tests2 (>= 3.2.6 -> >= 3.2.7)
+
+- Raise first-party dependency minimums to their latest released versions.
+
+### Fixed
+
+- Preserve inherited version namespaces by declaring their superclass before loading version.rb.
+
+- Template-manage default local test bundles independently from appraisal and framework CI matrices.
+
+## [7.1.10] - 2026-08-29
+
+- TAG: [v7.1.10][7.1.10t]
+- COVERAGE: 93.56% -- 10937/11690 lines in 16 files
+- BRANCH COVERAGE: 76.95% -- 4658/6053 branches in 16 files
+- 17.92% documented
+
+### Changed
+
+- Record template-run changelog updates before the bootstrap commit so generated changes and their maintenance summary are committed together.
+
+- [kc] kettle-jem-deps-floor: Update kettle-jem template dependency floors:
+  - kettle-changelog (>= 1.0.3 -> >= 1.0.5)
+  - kettle-dev (>= 3.0.13 -> >= 3.0.16)
+  - kettle-drift (>= 1.0.12 -> >= 1.0.13)
+  - kettle-family (>= 1.2.62 -> >= 1.2.63)
+  - kettle-jem (>= 7.1.7 -> >= 7.1.8)
+  - kettle-soup-cover (>= 3.0.9 -> >= 3.0.10)
+  - kettle-test (>= 2.0.20 -> >= 2.0.21)
+  - nomono (>= 1.1.4 -> >= 1.1.5)
+
+- [kc] kettle-jem-workflow-pins: Update pinned GitHub Actions in kettle-jem templates:
+  - apache/skywalking-eyes/dependency v0.8.0 (61275cc80d0798a405cb070f7d3a8aaf7cf2c2c1) -> v0.9.0 (a196742f472feaffafea537ce5a2a4c3c53a8de4)
+  - github/codeql-action/analyze v4.37.8 (db488ddef3bf6cb639b32c2e9a7c0a7ea8271d28) -> v4.37.9 (cdf488f595d80d6e07e03d4674febd5ab45fa938)
+  - github/codeql-action/autobuild v4.37.8 (db488ddef3bf6cb639b32c2e9a7c0a7ea8271d28) -> v4.37.9 (cdf488f595d80d6e07e03d4674febd5ab45fa938)
+  - github/codeql-action/init v4.37.8 (db488ddef3bf6cb639b32c2e9a7c0a7ea8271d28) -> v4.37.9 (cdf488f595d80d6e07e03d4674febd5ab45fa938)
+
+- [kc] kettle-jem/template: updated 1194 project files:
+  - code and tests (60)
+  - configuration (36)
+  - dependencies (441)
+  - documentation (27)
+  - other (369)
+  - workflows (261)
+
+- [kc] kettle-jem-deps-floor: Update kettle-jem template dependency floors:
+  - kettle-dev (>= 3.0.16 -> >= 3.0.17)
+  - kettle-family (>= 1.2.63 -> >= 1.2.64)
+
+- [kc] kettle-jem/prepare: updated 13 project files:
+  - dependencies (13)
+
+- [kc] kettle-jem/template: updated 3 project files:
+  - code and tests (1)
+  - dependencies (1)
+  - other (1)
+
+### Fixed
+
+- Keep external superclass expressions out of generated standalone version files.
+
+- Skip template changelog recording for partial destination projects that do not contain a changelog.
+
 ## [7.1.8] - 2026-08-26
 
 - TAG: [v7.1.8][7.1.8t]
@@ -1621,7 +1704,11 @@ Please file a bug if you notice a violation of semantic versioning.
 - Released kettle-jem as part of the initial StructuredMerge Ruby 7.0.0 gem set.
 - Included packaged templates and parser-backed merge support for Ruby gem templating.
 
-[Unreleased]: https://github.com/structuredmerge/structuredmerge-ruby/compare/v7.1.8...HEAD
+[Unreleased]: https://github.com/structuredmerge/structuredmerge-ruby/compare/v7.1.11...HEAD
+[7.1.11]: https://github.com/structuredmerge/structuredmerge-ruby/compare/v7.1.10...v7.1.11
+[7.1.11t]: https://github.com/structuredmerge/structuredmerge-ruby/releases/tag/v7.1.11
+[7.1.10]: https://github.com/structuredmerge/structuredmerge-ruby/compare/v7.1.8...v7.1.10
+[7.1.10t]: https://github.com/structuredmerge/structuredmerge-ruby/releases/tag/v7.1.10
 [7.1.8]: https://github.com/structuredmerge/structuredmerge-ruby/compare/v7.1.7...v7.1.8
 [7.1.8t]: https://github.com/structuredmerge/structuredmerge-ruby/releases/tag/v7.1.8
 [7.1.7]: https://github.com/structuredmerge/structuredmerge-ruby/compare/v7.1.6...v7.1.7

data/README.md

@@ -268,7 +268,77 @@ good fit when you want kettle-jem to generate framework-version modular gemfiles
 
 If you need a deeper or more complex matrix, prefer
 **`kettle-jem-appraisals`**, which generates `Appraisals` entries and is the
-better fit for Appraisals-style combinations.
+better fit for Appraisals-style combinations. Its `appraisal_matrix` config is
+the source of truth for the generated matrix: use `mode` (or per-gem `mode`),
+`freshness_ttl`, `exec_cmd`, `appraisal_gemfiles`, `standard_appraisal_role`,
+and `gems.tier1` / `gems.tier2` as documented in the
+[`kettle-jem-appraisals` configuration reference](https://github.com/appraisal-rb/kettle-jem-appraisals#%EF%B8%8F-configuration).
+
+Neither `appraisal_matrix` nor `framework_matrix` implicitly changes the root
+local development bundle. Pair either policy with `test_bundle` when the
+default local test command needs a specific framework or harness.
+
+### Default Local Test Bundle
+
+The root `Gemfile` is the default bundle for local commands such as
+`bundle exec kettle-test`. It is intentionally separate from Appraisals and
+CI, which run with their own generated Gemfiles. Declare its project-specific
+test dependencies with `test_bundle`; kettle-jem will add them to the root
+`Gemfile` on every template run.
+
+Use `test_bundle.gemfiles` for a modular fragment. A mapping may name direct
+dependencies that the fragment replaces, so kettle-jem removes stale root
+declarations before adding the `eval_gemfile` call:
+
+```yaml
+test_bundle:
+  gemfiles:
+    - path: gemfiles/rails_7_2.gemfile
+      replaces:
+        - combustion
+        - actionmailer
+        - railties
+```
+
+Use `test_bundle.gems` for a small, explicit local test dependency that does
+not warrant a modular fragment. Use either `requirement` or `requirements`; set
+`require: false` only when the dependency must be available to Bundler but
+should not be automatically required:
+
+```yaml
+test_bundle:
+  gems:
+    - name: activerecord
+      requirement: "~> 7.2"
+    - name: debug
+      requirement: "~> 1.11"
+      require: false
+```
+
+For a simple `workflows.framework_matrix`, mark exactly one version as
+`default: true` to load that generated framework gemfile into the root
+`Gemfile` as the local default. The matrix still controls Appraisals and CI;
+the flag only selects the root local bundle. `appraisal_matrix` deliberately
+has no implicit default selector: use `test_bundle` to name the stable local
+Gemfile fragment or direct dependencies while the plugin continues to generate
+the full appraisal matrix.
+
+```yaml
+workflows:
+  preset: framework
+  framework_matrix:
+    dimension: rails
+    gem: rails
+    gemfile_pattern: "rails_{version}.gemfile"
+    versions:
+      - label: "7.2"
+        slug: "7_2"
+        requirement: "~> 7.2.2"
+        default: true
+```
+
+Do not use freeze markers for any of these declarations. The configuration is
+the source of truth, and templating keeps the root bundle synchronized with it.
 
 ### Strategies
 
@@ -794,7 +864,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-11.606-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
+[🧮kloc-img]: https://img.shields.io/badge/KLOC-11.776-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
 [🔐security]: https://github.com/structuredmerge/structuredmerge-ruby/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/jem/cli.rb

@@ -234,6 +234,8 @@ module Kettle
         end
         return result unless %w[setup prepare apply template install].include?(command)
 
+        return result if result.is_a?(Hash) && result.key?(:changelog)
+
         Kettle::Jem::MaintenanceChangelog.record_template_run(
           project_root: project_root,
           report: result,

data/lib/kettle/jem/maintenance_changelog.rb

@@ -95,6 +95,10 @@ module Kettle
           return report.merge(changelog: {status: "skipped", reason: "no_template_changes", changed_files: []})
         end
 
+        unless File.file?(File.join(project_root, "CHANGELOG.md"))
+          return report.merge(changelog: {status: "skipped", reason: "missing_changelog"})
+        end
+
         key = TEMPLATE_CHANGELOG_KEYS.fetch(label, "kettle-jem/template")
         entry = ->(matches) { template_run_entry(changed_files, matches) }
         result = upsert_unreleased_entry(project_root: project_root, section: "Changed", key: key, entry: entry)

data/lib/kettle/jem/tasks/install_task.rb

@@ -8,6 +8,7 @@ require "toml-rb"
 require "uri"
 require "yaml"
 require "kettle/rb/compat_matrix"
+require "kettle/jem/maintenance_changelog"
 
 module Kettle
   module Jem
@@ -48,7 +49,6 @@ module Kettle
           install_steps << rubocop_gradual_autocorrect_step(project_root, env: setup_env, run_options: effective_run_options)
           install_steps << normalize_lockfile_step(project_root, env: setup_env, run_options: effective_run_options)
           install_steps << bundled_handoff_step(project_root: project_root, env: env, run_options: effective_run_options)
-          install_steps << bootstrap_commit_step(project_root, run_options: effective_run_options)
           install_steps = execute_orchestration_steps(install_steps, project_root: project_root, env: setup_env, run_options: effective_run_options, command_runner: command_runner)
 
           final_report = report.merge(
@@ -62,6 +62,26 @@ module Kettle
               message: "kettle:jem:install applied templates, completed local post-template checks, and executed available orchestration steps."
             }]
           )
+          final_report = Kettle::Jem::MaintenanceChangelog.record_template_run(
+            project_root: project_root,
+            report: final_report,
+            run_options: effective_run_options
+          )
+          bootstrap_commit = bootstrap_commit_step(project_root, run_options: effective_run_options)
+          install_steps.concat(
+            execute_orchestration_steps(
+              [bootstrap_commit],
+              project_root: project_root,
+              env: setup_env,
+              run_options: effective_run_options,
+              command_runner: command_runner
+            )
+          )
+          final_report = final_report.merge(
+            install_steps: install_steps,
+            install_phase_reports: install_phase_reports(install_steps),
+            install_summary: install_step_summary(install_steps)
+          )
           Kettle::Jem.emit_summary_event(Kettle::Jem.event_stream_from_options(effective_run_options), final_report)
           final_report
         end

data/lib/kettle/jem/templates/.github/workflows/license-eye.yml.example

@@ -33,7 +33,7 @@ jobs:
           persist-credentials: false
 
       - name: Check Dependencies' License
-        uses: apache/skywalking-eyes/dependency@61275cc80d0798a405cb070f7d3a8aaf7cf2c2c1 # v0.8.0
+        uses: apache/skywalking-eyes/dependency@a196742f472feaffafea537ce5a2a4c3c53a8de4 # v0.9.0
         with:
           config: .licenserc.yaml
           mode: "{KJ|LICENSE_EYE:MODE}"

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

@@ -215,6 +215,11 @@ rubyforum:
 #                   label       - display value used in CI
 #                   slug        - path-safe value used in gemfile_pattern
 #                   requirement - Bundler requirement written to the gemfile
+#                   default     - true for the one generated framework
+#                                 gemfile loaded by the root Gemfile for local
+#                                 `bundle exec kettle-test` commands
+#                   replaces    - direct root Gemfile dependencies replaced by
+#                                 the default framework gemfile
 #   gemfile_pattern — pattern for gemfile paths; {version} is replaced
 #                     with each version slug (dots replaced by underscores
 #                     when the pattern contains an underscore placeholder).
@@ -225,7 +230,9 @@ rubyforum:
 #                       "rails_{version}"      → gemfiles/rails_7_0.gemfile
 #   Use this when you need a simple 2D matrix: Ruby × one framework gem/version axis.
 #   For deeper or more complex matrices that are better modeled as Appraisals entries,
-#   prefer kettle-jem-appraisals instead.
+#   prefer the kettle-jem-appraisals plugin instead. Its appraisal_matrix config
+#   controls generated Appraisals and CI strategy; pair it with test_bundle below
+#   when the root local Gemfile needs a stable framework or harness.
 #
 workflows:
   # Default command used by generated test workflows.
@@ -247,6 +254,35 @@ workflows:
   #       requirement: ">= 8.0"
   #   gemfile_pattern: "ar-{version}.x"
 
+# Appraisal matrices are owned by the kettle-jem-appraisals plugin. It uses
+# appraisal_matrix.mode, freshness_ttl, exec_cmd, appraisal_gemfiles,
+# standard_appraisal_role, and gems.tier1 / gems.tier2 to generate the full
+# Appraisals and CI matrix. It does not implicitly select the root local bundle;
+# configure test_bundle below for that purpose.
+
+# Default local test bundle.
+# The root Gemfile is used by local bundle commands and is separate from
+# Appraisals and CI, which use their own generated Gemfiles. Declare the
+# project-specific test stack here instead of preserving it with freeze markers.
+#
+# gemfiles accepts either a path string or a mapping. `replaces` removes direct
+# root Gemfile declarations that are supplied by the modular fragment.
+# gems adds a direct declaration when a modular fragment is not warranted.
+#
+# test_bundle:
+#   gemfiles:
+#     - path: gemfiles/rails_7_2.gemfile
+#       replaces:
+#         - combustion
+#         - actionmailer
+#         - railties
+#   gems:
+#     - name: activerecord
+#       requirement: "~> 7.2"
+#     - name: debug
+#       requirement: "~> 1.11"
+#       require: false
+
 # Project-level third-party integrations.
 # Disabling an integration removes its upload/check action, suppresses its
 # README badges, skips templating its packaged config/workflow, and cleans up

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.0", ">= 3.0.13")             # ruby >= {KJ|MIN_TEST_RUBY}
+  spec.add_development_dependency("kettle-dev", "~> 3.0", ">= 3.0.17")             # ruby >= {KJ|MIN_TEST_RUBY}
 
   # Security
   spec.add_development_dependency("bundler-audit", "~> 0.9.3")                      # ruby >= 2.0.0
@@ -133,8 +133,8 @@ Gem::Specification.new do |spec|
   # 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.2")               # ruby >= 1.8.7, for testing against multiple versions of dependencies
-  spec.add_development_dependency("kettle-test", "~> 2.0", ">= 2.0.20")            # ruby >= {KJ|MIN_TEST_RUBY}
-  spec.add_development_dependency("turbo_tests2", "~> 3.2", ">= 3.2.6")           # ruby >= 2.4.0, default kettle-test runner
+  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
 
   # Releasing
   spec.add_development_dependency("ruby-progressbar", "~> 1.13")                    # ruby >= 0

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.9", require: false
+    gem "kettle-soup-cover", "~> 3.0", ">= 3.0.10", require: false
   end
 else
   eval_gemfile "coverage_local.gemfile"

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

@@ -23,7 +23,7 @@ end
 
 if kettle_remote
   # Template/plugin checks for released installs.
-  gem "kettle-drift", "~> 1.0", ">= 1.0.12", require: false
+  gem "kettle-drift", "~> 1.0", ">= 1.0.13", require: false
 end
 
 # Set STRUCTUREDMERGE_DEV=/path/to/structuredmerge/ruby/gems for local development with path-based dependencies.

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

@@ -6,7 +6,7 @@ shimmed_gem_path = ENV["KETTLE_JEM_SHIMMED_GEM_PATH"].to_s
 gem "{KJ|SHIMMED_GEM_NAME}", path: shimmed_gem_path unless shimmed_gem_path.empty?
 
 # Local workspace dependency wiring for templating_local.gemfile overrides.
-gem "nomono", "~> 1.1", ">= 1.1.4", require: false # ruby >= 3.2.0
+gem "nomono", "~> 1.1", ">= 1.1.5", require: false # ruby >= 3.2.0
 
 # 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?

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

@@ -30,13 +30,13 @@ Gem::Specification.new do |spec|
   spec.add_dependency "{KJ|SHIMMED_GEM_NAME}"
 
   # Dev, Test, & Release Tasks
-  spec.add_development_dependency("kettle-dev", "~> 3.0", ">= 3.0.13")             # ruby >= {KJ|MIN_TEST_RUBY}
+  spec.add_development_dependency("kettle-dev", "~> 3.0", ">= 3.0.17")             # ruby >= {KJ|MIN_TEST_RUBY}
 
   # Tasks
   spec.add_development_dependency "rake", "~> 13.0"
 
   # Testing
-  spec.add_development_dependency("kettle-test", "~> 2.0", ">= 2.0.20")            # ruby >= {KJ|MIN_TEST_RUBY}
+  spec.add_development_dependency("kettle-test", "~> 2.0", ">= 2.0.21")            # ruby >= {KJ|MIN_TEST_RUBY}
   spec.add_development_dependency "rspec", "~> 3.12"
 
   # Releasing

data/lib/kettle/jem/version.rb

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