kettle-jem 7.1.10 → 7.1.11

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cc954a9b2e13ecec8a5dbf0858c76b7a7157f92fabd6f07092024690ab163048
-  data.tar.gz: '0628e48c05357df4f752ef7e252cb3992d380ab578faaeee44801d7e818ed39f'
+  metadata.gz: 4557a45c40575cf35c6a6630ca4f15694407df55cae707f4187c282111a5fe6e
+  data.tar.gz: df10a122743e47d9236115a4e7d44fbc0342a70de1da7643b863da983f9d800e
 SHA512:
-  metadata.gz: 1c549dd026691dbfc28854df99784f1b3c8904237d19f23eaab450de64983c5f9116102811e385f997a661c443e4efe01b6832613dbef6da5c1d9b30eeaad451
-  data.tar.gz: 54991a0795b8d7da63318264a5dcefec11cbe78e0ba151a9a53ab56ff8c39b4b6375070b80007d0c446b59c4bc7ad2ee8756c63c25a209f3cf0edfd79b6e900e
+  metadata.gz: 77dfdae1740bbe776afb7d9f181a34244c6bd594cc0b9d6d274e9183c8d1be60894c7c112243c9f5d064f9cf4a57b2ec043e0bb84d55eb4dfe86b48008f535c7
+  data.tar.gz: 17fac3e17f62555dc40598d641007ce21c05c7968cb9745409b3eeaf153c86648b47dde2abaee0b2ed1a82cab268e267eeeac1ce31fbf2d69d493119de03d9bc

data/CHANGELOG.md

@@ -30,6 +30,36 @@ 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]
@@ -1674,7 +1704,9 @@ 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.10...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

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.690-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/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

@@ -134,7 +134,7 @@ Gem::Specification.new do |spec|
   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.21")            # 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("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/version.rb

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

data/lib/kettle/jem.rb

@@ -3539,6 +3539,8 @@ module Kettle
       facts[:ci][:coverage] = coverage_config unless coverage_config.empty?
       framework_matrix = github_actions_framework_matrix(kettle_config)
       facts[:ci][:framework_matrix] = framework_matrix unless framework_matrix.empty?
+      default_test_bundle = default_test_bundle_config(kettle_config, framework_matrix)
+      facts[:ci][:default_test_bundle] = default_test_bundle unless default_test_bundle.empty?
       template_facts = {}
       template_preferences = template_source_preferences(
         project_root,
@@ -5399,12 +5401,12 @@ module Kettle
         {name: "kettle-dev", source: %(gem "kettle-dev", "~> 3.0", ">= 3.0.17"\n)},
         {name: "kettle-drift", source: %(gem "kettle-drift", "~> 1.0", ">= 1.0.13"\n)},
         {name: "kettle-family", source: %(gem "kettle-family", "~> 1.2", ">= 1.2.64"\n)},
-        {name: "kettle-jem", source: %(gem "kettle-jem", "~> 7.1", ">= 7.1.8"\n)},
+        {name: "kettle-jem", source: %(gem "kettle-jem", "~> 7.1", ">= 7.1.10"\n)},
         {name: "kettle-test", source: %(gem "kettle-test", "~> 2.0", ">= 2.0.21"\n)},
         {name: "rake", source: %(gem "rake", "~> 13.0"\n)},
         {name: "rspec", source: %(gem "rspec", "~> 3.0"\n)},
         {name: "stone_checksums", source: %(gem "stone_checksums", "~> 1.0", ">= 1.0.8"\n)},
-        {name: "turbo_tests2", source: %(gem "turbo_tests2", "~> 3.2", ">= 3.2.6"\n)}
+        {name: "turbo_tests2", source: %(gem "turbo_tests2", "~> 3.2", ">= 3.2.7"\n)}
       ].freeze
     end
 
@@ -5549,8 +5551,9 @@ module Kettle
         namespace,
         preferred_path: entrypoint_path
       )
-      entrypoint_namespace_superclasses = namespace_superclass_details.fetch(:superclasses)
-      entrypoint_namespace_superclasses = entrypoint_namespace_superclasses.merge(
+      entrypoint_namespace_superclasses = version_namespace_superclasses_from_facts(facts).merge(
+        namespace_superclass_details.fetch(:superclasses)
+      ).merge(
         entrypoint_namespace_superclasses_from_facts(facts)
       )
       fact_superclass_path = facts.dig(:rubygems, :entrypoint_namespace_superclass_path).to_s
@@ -7976,6 +7979,7 @@ module Kettle
           output = preserve_destination_gemfile_source(output, destination_content)
         end
         output = inject_main_gemfile_recording_eval(output, facts)
+        output = inject_main_gemfile_default_test_bundle(output, facts)
         output = remove_stale_main_gemfile_tree_sitter_language_pack(output, template_content)
         output = remove_stale_main_gemfile_direct_sibling_block(output, template_content)
         output = deduplicate_main_gemfile_direct_sibling_blocks(output)
@@ -9310,6 +9314,43 @@ module Kettle
       ensure_trailing_newline(lines.join.gsub(/\n{3,}/, "\n\n"))
     end
 
+    # The root Gemfile is the local-development bundle. Appraisals and CI use
+    # their own Gemfiles, so a project that needs a framework or application
+    # harness locally must declare that dependency separately in test_bundle.
+    def inject_main_gemfile_default_test_bundle(content, facts)
+      bundle = facts.to_h.dig(:ci, :default_test_bundle).to_h
+      return content if bundle.empty?
+
+      managed_gems = bundle.fetch(:managed_gems, [])
+      output = remove_gemfile_dependency_blocks(content, managed_gems)
+      existing_paths = gemfile_eval_paths(output).to_set
+      additions = bundle.fetch(:gemfiles, []).filter_map do |path|
+        next if existing_paths.include?(path)
+
+        %(eval_gemfile "#{path}")
+      end
+      additions.concat(bundle.fetch(:gems, []).map { |gem| default_test_bundle_gem_source(gem) })
+      return output if additions.empty?
+
+      lines = output.to_s.lines
+      insert_at = main_gemfile_default_test_bundle_insertion_index(output) || lines.length
+      block = ["# Default local test bundle", *additions].join("\n")
+      lines.insert(insert_at, "#{block}\n\n")
+      ensure_trailing_newline(lines.join.gsub(/\n{3,}/, "\n\n"))
+    end
+
+    def default_test_bundle_gem_source(gem)
+      arguments = [gem.fetch(:name).inspect, *gem.fetch(:requirements, []).map(&:inspect)]
+      arguments << "require: false" if gem[:require] == false
+      "gem #{arguments.join(", ")}"
+    end
+
+    def main_gemfile_default_test_bundle_insertion_index(content)
+      main_gemfile_templating_eval_line(content) ||
+        main_gemfile_first_eval_gemfile_line(content) ||
+        main_gemfile_after_gemspec_line(content)
+    end
+
     def main_gemfile_recording_insertion_index(content)
       lines = content.to_s.lines
       call = ruby_call_records(content, :eval_gemfile).find do |candidate|
@@ -14198,7 +14239,7 @@ module Kettle
               root: ["src", "my", "kettle-dev"]
             )
           elsif Gem::Version.new(RUBY_VERSION) >= Gem::Version.new("4.0.0")
-            gem "kettle-changelog", "~> 1.0", ">= 1.0.5"
+            gem "kettle-changelog", "~> 1.0", ">= 1.0.6"
           end
         end
       RUBY
@@ -15341,8 +15382,9 @@ module Kettle
         namespace,
         preferred_path: entrypoint_path
       )
-      entrypoint_namespace_superclasses = namespace_superclass_details.fetch(:superclasses)
-      entrypoint_namespace_superclasses = entrypoint_namespace_superclasses.merge(
+      entrypoint_namespace_superclasses = version_namespace_superclasses_from_facts(facts).merge(
+        namespace_superclass_details.fetch(:superclasses)
+      ).merge(
         entrypoint_namespace_superclasses_from_facts(facts)
       )
       fact_superclass_path = facts.dig(:rubygems, :entrypoint_namespace_superclass_path).to_s
@@ -15832,13 +15874,31 @@ module Kettle
     end
 
     def version_gem_bootstrap_entrypoint_content(content, namespace:, entrypoint_require:, namespace_superclasses: {}, version_require_path: nil)
-      current = normalize_entrypoint_version_require(
-        content,
-        entrypoint_require: entrypoint_require,
-        version_require_path: version_require_path,
-        after_declarations: !namespace_superclasses.empty?
-      )
-      current = remove_version_gem_class_eval_references(current) unless ruby_version_class_eval_namespaces(current).include?(namespace.to_s)
+      current = if namespace_superclasses.empty?
+        # Preserve the existing relative-require position when there is no
+        # declaration ordering constraint.
+        normalize_entrypoint_version_require(
+          content,
+          entrypoint_require: entrypoint_require,
+          version_require_path: version_require_path
+        )
+      else
+        # A namesake superclass is a declaration-order constraint: establish
+        # the class, load version.rb, then extend its Version module.
+        source = remove_version_gem_class_eval_references(content)
+        source = ensure_entrypoint_namespace_superclass_declarations(
+          source,
+          namespace: namespace,
+          namespace_superclasses: namespace_superclasses
+        )
+        normalize_entrypoint_version_require(
+          source,
+          entrypoint_require: entrypoint_require,
+          version_require_path: version_require_path,
+          after_declarations: true
+        )
+      end
+      current = remove_version_gem_class_eval_references(current)
       lines = current.lines
       insert_lines = []
       if File.basename(entrypoint_require) != "version_gem" && !ruby_top_level_require?(current, "require", "version_gem")
@@ -15857,6 +15917,34 @@ module Kettle
       collapse_excess_blank_lines(updated)
     end
 
+    def ensure_entrypoint_namespace_superclass_declarations(content, namespace:, namespace_superclasses: {})
+      # A version file must only reopen a namesake class.  When legacy source
+      # declared that class and its superclass in version.rb, establish the
+      # class in the entrypoint before requiring version.rb, then render the
+      # version file without a superclass.
+      segments = namespace.to_s.split("::").reject(&:empty?)
+      return content.to_s if segments.empty? || namespace_superclasses.empty?
+
+      missing_superclass_declaration = namespace_superclasses.any? do |index, _superclass|
+        ruby_namespace_declaration_node(content, segments.first(index + 1).join("::")).nil?
+      end
+      return content.to_s unless missing_superclass_declaration
+
+      namespace_kinds = segments.each_index.each_with_object({}) do |index, kinds|
+        prefix = segments.first(index + 1).join("::")
+        kinds[index] = ruby_namespace_declaration_kind(content, prefix) || :module
+        kinds[index] = :class if namespace_superclasses.key?(index)
+      end
+      declaration = wrap_ruby_namespace(
+        namespace,
+        [],
+        namespace_kinds: namespace_kinds,
+        namespace_superclasses: namespace_superclasses
+      ).join("\n")
+      current = trim_trailing_blank_lines(content)
+      current.empty? ? "#{declaration}\n" : "#{current}\n\n#{declaration}\n"
+    end
+
     def version_gem_free_entrypoint_content(content, entrypoint_require:, ensure_version_require: true, after_declarations: false, version_require_path: nil)
       current = remove_version_gem_entrypoint_references(content)
       unless ensure_version_require
@@ -18681,13 +18769,17 @@ module Kettle
       appraisal_gemfiles = framework_matrix_appraisal_gemfiles(raw)
       gemfiles = version_entries.map do |entry|
         gemfile = expand_framework_gemfile_pattern(pattern, entry.fetch(:slug))
-        {
+        gemfile_entry = {
           path: framework_gemfile_path(gemfile),
           gem: framework_gem,
           requirement: entry.fetch(:requirement),
           env: entry.fetch(:env, {})
         }
+        gemfile_entry[:default] = true if entry[:default]
+        gemfile_entry[:replaces] = entry[:replaces] unless entry.fetch(:replaces, []).empty?
+        gemfile_entry
       end.uniq { |entry| entry.fetch(:path) }
+      default_gemfiles = gemfiles.select { |entry| entry[:default] }
       gemfiles.reject! { |entry| template_keep_destination_path?(config, entry.fetch(:path)) }
       {
         dimension: dimension,
@@ -18715,7 +18807,9 @@ module Kettle
             replaces: framework_matrix_replaced_appraisal_names(dimension, entry, name)
           }
         end
-      }
+      }.tap do |matrix|
+        matrix[:default_gemfiles] = default_gemfiles unless default_gemfiles.empty?
+      end
     end
 
     def framework_matrix_replaced_appraisal_names(dimension, entry, name)
@@ -18756,12 +18850,16 @@ module Kettle
         requirement = raw.fetch("requirement", default_framework_matrix_requirement(label)).to_s.strip
         appraisal_name = (raw["appraisal"] || raw["appraisal_name"] || raw["standard_appraisal"]).to_s.strip
         env = framework_matrix_env(raw["env"])
+        default = DecisionPolicy.value_to_boolean(raw["default"]) == true
+        replaces = Array(raw["replaces"]).filter_map { |name| nonempty_string(name) }
       else
         label = raw.to_s.strip
         slug = label
         requirement = default_framework_matrix_requirement(label)
         appraisal_name = ""
         env = {}
+        default = false
+        replaces = []
       end
       return if label.empty? || slug.empty? || requirement.empty?
 
@@ -18773,9 +18871,75 @@ module Kettle
       entry[:appraisal_name] = appraisal_name unless appraisal_name.empty?
       entry[:standard_appraisal] = true if raw.is_a?(Hash) && raw["standard_appraisal"]
       entry[:env] = env unless env.empty?
+      entry[:default] = true if default
+      entry[:replaces] = replaces unless replaces.empty?
       entry
     end
 
+    # Configures the dependencies used by `bundle exec kettle-test` without a
+    # BUNDLE_GEMFILE override. This intentionally does not alter Appraisals or
+    # CI matrices: those are owned by appraisal_matrix/framework_matrix.
+    def default_test_bundle_config(config, framework_matrix)
+      raw = config["test_bundle"]
+      raw = {} unless raw.is_a?(Hash)
+
+      gemfiles = Array(raw["gemfiles"]).filter_map { |entry| default_test_bundle_gemfile_entry(entry) }
+      gems = Array(raw["gems"]).filter_map { |entry| default_test_bundle_gem_entry(entry) }
+      framework_defaults = framework_matrix.to_h.fetch(:default_gemfiles, []).select { |entry| entry[:default] }
+      if framework_defaults.length > 1
+        paths = framework_defaults.map { |entry| entry.fetch(:path) }.join(", ")
+        raise ArgumentError, "workflows.framework_matrix has multiple default versions: #{paths}"
+      end
+      if (framework_default = framework_defaults.first)
+        gemfiles << {
+          path: framework_default.fetch(:path),
+          replaces: framework_default.fetch(:replaces, [])
+        }
+      end
+
+      return {} if gemfiles.empty? && gems.empty?
+
+      {
+        gemfiles: gemfiles.map { |entry| entry.fetch(:path) }.uniq,
+        gems: gems,
+        managed_gems: (gems.map { |entry| entry.fetch(:name) } + gemfiles.flat_map { |entry| entry.fetch(:replaces, []) }).uniq
+      }
+    end
+
+    def default_test_bundle_gemfile_entry(raw)
+      if raw.is_a?(Hash)
+        path = raw["path"].to_s.strip
+        replaces = Array(raw["replaces"]).filter_map { |name| nonempty_string(name) }
+      else
+        path = raw.to_s.strip
+        replaces = []
+      end
+      return if path.empty?
+
+      {path: path.start_with?("gemfiles/") ? path : "gemfiles/#{path}", replaces: replaces}
+    end
+
+    def default_test_bundle_gem_entry(raw)
+      return unless raw.is_a?(Hash)
+
+      name = (raw["name"] || raw["gem"]).to_s.strip
+      return if name.empty?
+
+      requirements = raw.key?("requirements") ? Array(raw["requirements"]) : [raw["requirement"]]
+      entry = {
+        name: name,
+        requirements: requirements.filter_map { |requirement| nonempty_string(requirement) }
+      }
+      require_value = DecisionPolicy.value_to_boolean(raw["require"])
+      entry[:require] = false if require_value == false
+      entry
+    end
+
+    def nonempty_string(value)
+      normalized = value.to_s.strip
+      normalized unless normalized.empty?
+    end
+
     def framework_matrix_env(raw)
       return {} unless raw.is_a?(Hash)
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: kettle-jem
 version: !ruby/object:Gem::Version
-  version: 7.1.10
+  version: 7.1.11
 platform: ruby
 authors:
 - Peter H. Boling
@@ -226,7 +226,7 @@ dependencies:
         version: '1.0'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.0.2
+        version: 1.0.6
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -236,14 +236,14 @@ dependencies:
         version: '1.0'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.0.2
+        version: 1.0.6
 - !ruby/object:Gem::Dependency
   name: kettle-dev
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.3.5
+        version: 3.0.17
     - - "<"
       - !ruby/object:Gem::Version
         version: 4.0.0
@@ -253,7 +253,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.3.5
+        version: 3.0.17
     - - "<"
       - !ruby/object:Gem::Version
         version: 4.0.0
@@ -266,7 +266,7 @@ dependencies:
         version: '0.3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.3.3
+        version: 0.3.14
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -276,7 +276,7 @@ dependencies:
         version: '0.3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.3.3
+        version: 0.3.14
 - !ruby/object:Gem::Dependency
   name: kettle-ndjson
   requirement: !ruby/object:Gem::Requirement
@@ -286,7 +286,7 @@ dependencies:
         version: '0.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.1.3
+        version: 0.1.13
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -296,7 +296,7 @@ dependencies:
         version: '0.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.1.3
+        version: 0.1.13
 - !ruby/object:Gem::Dependency
   name: kettle-rb
   requirement: !ruby/object:Gem::Requirement
@@ -306,7 +306,7 @@ dependencies:
         version: '0.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.1.7
+        version: 0.1.11
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -316,7 +316,7 @@ dependencies:
         version: '0.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.1.7
+        version: 0.1.11
 - !ruby/object:Gem::Dependency
   name: kramdown-merge
   requirement: !ruby/object:Gem::Requirement
@@ -494,7 +494,7 @@ dependencies:
         version: '2.0'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.0.4
+        version: 2.0.10
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -504,7 +504,7 @@ dependencies:
         version: '2.0'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.0.4
+        version: 2.0.10
 - !ruby/object:Gem::Dependency
   name: toml-merge
   requirement: !ruby/object:Gem::Requirement
@@ -696,7 +696,7 @@ dependencies:
         version: '3.2'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.2.6
+        version: 3.2.7
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -706,7 +706,7 @@ dependencies:
         version: '3.2'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.2.6
+        version: 3.2.7
 - !ruby/object:Gem::Dependency
   name: ruby-progressbar
   requirement: !ruby/object:Gem::Requirement
@@ -976,10 +976,10 @@ licenses:
 - PolyForm-Small-Business-1.0.0
 metadata:
   homepage_uri: https://structuredmerge.org
-  source_code_uri: https://github.com/structuredmerge/structuredmerge-ruby/tree/v7.1.10
-  changelog_uri: https://github.com/structuredmerge/structuredmerge-ruby/blob/v7.1.10/CHANGELOG.md
+  source_code_uri: https://github.com/structuredmerge/structuredmerge-ruby/tree/v7.1.11
+  changelog_uri: https://github.com/structuredmerge/structuredmerge-ruby/blob/v7.1.11/CHANGELOG.md
   bug_tracker_uri: https://github.com/structuredmerge/structuredmerge-ruby/issues
-  documentation_uri: https://www.rubydoc.info/gems/kettle-jem/7.1.10
+  documentation_uri: https://www.rubydoc.info/gems/kettle-jem/7.1.11
   funding_uri: https://github.com/sponsors/pboling
   wiki_uri: https://github.com/structuredmerge/structuredmerge-ruby/wiki
   news_uri: https://www.railsbling.com/tags/kettle-jem