kettle-jem 7.1.1 → 7.1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 332ff145199ec3a4f39506cdcdfcf5517d9eab1fb5145ac32c9e1468d9789305
-  data.tar.gz: c7f5fc56417b4802f9608525bbf8699ef6d34911e630e8b99e5f05707c8a403d
+  metadata.gz: 3900eae88b47a873cae6083d0465467ebd57842a12ed7e4b8cab28d37092fef7
+  data.tar.gz: a0df0ddab136eb1079901cda7ee1715ddb574b5392d2ee314196fd54b2042d7c
 SHA512:
-  metadata.gz: 4973314437e5d2d1cfdbede91915f68540effce4de9336c8e9f9ba3ea188f9c0afd0304f87d6c0bf1ce18d7aa42475837ba7017b513c646779c088e6f74da7f8
-  data.tar.gz: bcef0d250bfa17745271cd768de5eefe0d6f942d92d4f3fb577abf05b4fbea63ad4e822fa889b9719611f7dd41495fa046a50abb74515e69ffde3bf1b8664c2a
+  metadata.gz: 47a922c1ad1fdd9f57838b74de337777129ed2127752c5d579f0070b084fd7973c50ea68f7dd7258cad159229958d611185e4ef3470557f86412a9b53af77211
+  data.tar.gz: e05ba9400554b325770fcad5bc79c94180c626188c41d003fc1dbd368c322e474fb4ea9484b97fc717e6d8e4b4f6c4b94cda5d29543d5f9418bcd544d7abbb6b

checksums.yaml.gz.sig

@@ -1,3 +1,4 @@
-W(���f6|�5�݃{�F;��O�-l(�|�I�n؟�@Һ�g>��{�l��*��W��.z[��=X�c�,�<`BK��;��5,>�@�|3��M(��$�
-�Iwb�u�,�_�vc��s�6o`����p�T����ᮎ�n�;��������r�S�R�
��`��ii�Z����WCU����:�����y�u;I�{Ȋј��Wh��n���W	F<�n�\�[t�>�K8|N�h��#��]Ѡpp�Z�qA7G�������d#"T"vٜ���8��;p�yp�n[�ME��%^�R����q,1�h��8[��i�$�of
-�����K���…3����}�9�מ�[
+F��(m�T���>�0���o#HCe�(�5�S���
+W�"��b-����3��7�?��+Y	���U�)Z��)��E�,�gnd�9��b���i]%N���hA².we��i���M�B�
+'A�s�A�y����<&f�.��Z��-o���j� 8����:�־jܦO��~-������)&r^�.M6�b����:�NַB
+��6�5	� ���Ti�'��xH�Է�-�w�]E�#�	���

data/CHANGELOG.md

@@ -30,6 +30,112 @@ Please file a bug if you notice a violation of semantic versioning.
 
 ### Security
 
+## [7.1.4] - 2026-08-12
+
+- TAG: [v7.1.4][7.1.4t]
+- COVERAGE: 93.57% -- 10753/11492 lines in 16 files
+- BRANCH COVERAGE: 77.10% -- 4599/5965 branches in 16 files
+- 18.00% documented
+
+### Changed
+
+- Write-mode dependency-floor and workflow-pin maintenance tools now document their updates in CHANGELOG.md by default.
+
+- [kc] kettle-jem-deps-floor: Update kettle-jem template dependency floors:
+  - kettle-dev (~> 3.0, >= 3.0.0 -> ~> 3.0, >= 3.0.6)
+  - kettle-family (~> 1.2, >= 1.2.44 -> ~> 1.2, >= 1.2.51)
+  - kettle-jem (~> 7.1, >= 7.1.1 -> ~> 7.1, >= 7.1.3)
+  - yard-lint (~> 1.10, >= 1.10.3 -> ~> 1.11, >= 1.11.0)
+
+- [kc] kettle-jem-workflow-pins: Update pinned GitHub Actions in kettle-jem templates:
+  - github/codeql-action/analyze v4.37.4 (f205ea1c3313d32999d8d6a48b4f6530d4437b38) -> v4.37.6 (5595ccaf912efad79be6eef63a5619ff05969be3)
+  - github/codeql-action/autobuild v4.37.4 (f205ea1c3313d32999d8d6a48b4f6530d4437b38) -> v4.37.6 (5595ccaf912efad79be6eef63a5619ff05969be3)
+  - github/codeql-action/init v4.37.4 (f205ea1c3313d32999d8d6a48b4f6530d4437b38) -> v4.37.6 (5595ccaf912efad79be6eef63a5619ff05969be3)
+
+- Declare kettle-changelog as a runtime dependency for packaged maintenance commands.
+
+- Main templating commands now record an aggregate Changed entry through kettle-changelog only when template files change, while transfer replay uses kettle-changelog's structural merger.
+
+### Fixed
+
+- Restore source-checkout loading for the repository-local dependency-floor and workflow-pin maintenance tools.
+
+## [7.1.3] - 2026-08-11
+
+- TAG: [v7.1.3][7.1.3t]
+- COVERAGE: 93.99% -- 10757/11445 lines in 15 files
+- BRANCH COVERAGE: 77.39% -- 4605/5950 branches in 15 files
+- 18.01% documented
+
+### Changed
+
+- Generate README star-history embeds with the revived star-history.dera.page service.
+
+- Generate the README Star History section only for GitHub repositories with at least 150 stars.
+
+### Fixed
+
+- Handle comment-only YAML documents while pruning disabled engine workflow jobs.
+
+- Remove disabled engine workflow badge references from generated README files.
+
+- Gemspec templating now discards untouched Bundler allowed-push-host placeholders while preserving destination-specific metadata.
+
+- Prepare profile synchronization now materializes newly added modular Gemfiles before Bundler bootstrapping.
+
+- Generate modular changelog Gemfiles with the released kettle-changelog 1.x dependency floor.
+
+- Synchronize monorepo subgem profiles with a template-owned Rakefile so legacy generated task blocks are replaced instead of duplicated.
+
+- Preserve local Gemfile indentation when removing destination package entries from multiline word arrays.
+
+- Add the generated frozen-string-literal comment to Ruby 3.1 extracted stdlib Gemfiles.
+
+- Retain the MRI runtime floor when normalizing multi-engine README compatibility text.
+
+- Include html-merge in generated StructuredMerge local dependency wiring.
+
+## [7.1.2] - 2026-08-10
+
+- TAG: [v7.1.2][7.1.2t]
+- COVERAGE: 93.86% -- 10679/11378 lines in 15 files
+- BRANCH COVERAGE: 77.21% -- 4569/5918 branches in 15 files
+- 18.04% documented
+
+### Added
+
+- Template generated projects now receive kettle-changelog as a development dependency; kettle-changelog itself is excluded to avoid a self-dependency.
+
+- Local templating dependency wiring now resolves the standalone kettle-changelog development tool alongside the Kettle development stack.
+
+### Changed
+
+- Align generated compatibility workflows with the Ruby 4.0 runtime floor by excluding unsupported TruffleRuby targets
+
+- Resolve kettle-changelog through a Ruby-compatible modular development Gemfile instead of every generated gemspec.
+
+- Keep the standalone kettle-changelog tool in a Ruby-compatible modular Gemfile with explicit local-path wiring, rather than adding it to every generated gemspec.
+
+- Allow kettle-jem to resolve kettle-dev 3.x while retaining compatibility with supported kettle-dev 2.x releases.
+
+- Allow kettle-jem to update independently within the StructuredMerge 7.1 dependency series instead of requiring every sibling gem to share its patch version.
+
+### Fixed
+
+- Preserve enabled engine workflow jobs when pruning disabled jobs from generated YAML
+
+- Generate README compatibility prose from the configured Ruby engine set
+
+- Honor disabled README integrations after destination content is merged
+
+- Temporarily pin generated RuboCop Packaging style Gemfiles to the nested-project config-root fix.
+
+- Keep scoped kettle-jem template runs from applying unselected post-template mutations.
+
+- Preserve destination-only gemspec metadata when the template does not define that key.
+
+- Keep aggregate standard-library Gemfile references available when Ruby-floor pruning would otherwise remove their targets, and generate Appraisal Gemfiles during full kettle-jem installs.
+
 ## [7.1.1] - 2026-08-08
 
 - TAG: [v7.1.1][7.1.1t]
@@ -1255,9 +1361,6 @@ Please file a bug if you notice a violation of semantic versioning.
 - kettle-jem-template-20260726-003 - Coverage upload steps now treat Coveralls,
   QLTY, and Codecov as optional, so provider outages do not fail CI when local
   coverage thresholds still pass.
-- kettle-jem-template-20260728-003 - Generated dep-heads workflows now run
-  TruffleRuby jobs with current RubyGems and Bundler, avoiding setup failures
-  before the test suite starts.
 - kettle-jem-template-20260728-004 - Generated dep-heads workflows now use the
   setup-ruby Bundler install path for direct appraisal Gemfiles, avoiding rv
   lockfile parser failures on Git and path dependencies.
@@ -1421,7 +1524,13 @@ 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.1...HEAD
+[Unreleased]: https://github.com/structuredmerge/structuredmerge-ruby/compare/v7.1.4...HEAD
+[7.1.4]: https://github.com/structuredmerge/structuredmerge-ruby/compare/v7.1.3...v7.1.4
+[7.1.4t]: https://github.com/structuredmerge/structuredmerge-ruby/releases/tag/v7.1.4
+[7.1.3]: https://github.com/structuredmerge/structuredmerge-ruby/compare/v7.1.2...v7.1.3
+[7.1.3t]: https://github.com/structuredmerge/structuredmerge-ruby/releases/tag/v7.1.3
+[7.1.2]: https://github.com/structuredmerge/structuredmerge-ruby/compare/v7.1.1...v7.1.2
+[7.1.2t]: https://github.com/structuredmerge/structuredmerge-ruby/releases/tag/v7.1.2
 [7.1.1]: https://github.com/structuredmerge/structuredmerge-ruby/compare/v7.0.0...v7.1.1
 [7.1.1t]: https://github.com/structuredmerge/structuredmerge-ruby/releases/tag/v7.1.1
 [7.0.0]: https://github.com/structuredmerge/structuredmerge-ruby/compare/0aae485e7ca20583b73f8c146f467a64e526ca41...v7.0.0

data/README.md

@@ -57,7 +57,7 @@ to build `kettle-jem` extension gems against the supported plugin seam.
 
 ### Compatibility
 
-Compatible with MRI Ruby 4.0.0+, and concordant releases of JRuby, and TruffleRuby.
+Compatible with MRI Ruby 4.0.0+, and JRuby.
 CI workflows and Appraisals are generated for MRI Ruby 4.0.0+.
 This test floor is configured by `ruby.test_minimum` in `.kettle-jem.yml` and
 may be higher than the gem's runtime compatibility floor when legacy Rubies are
@@ -584,19 +584,6 @@ Made with [contributors-img][🖐contrib-rocks].
 
 Also see GitLab Contributors: [https://gitlab.com/structuredmerge/structuredmerge-ruby/-/graphs/main][🚎contributors-gl]
 
-<details markdown="1">
- <summary>⭐️ Star History</summary>
-
-<a href="https://star-history.com/structuredmerge/structuredmerge-ruby&Date">
- <picture>
- <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=structuredmerge/structuredmerge-ruby&type=Date&theme=dark" />
- <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=structuredmerge/structuredmerge-ruby&type=Date" />
- <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=structuredmerge/structuredmerge-ruby&type=Date" />
- </picture>
-</a>
-
-</details>
-
 ## 📌 Versioning
 
 This library follows [![Semantic Versioning 2.0.0][📌semver-img]][📌semver] for its public API where practical.
@@ -773,7 +760,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.320-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
+[🧮kloc-img]: https://img.shields.io/badge/KLOC-11.492-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

@@ -9,13 +9,13 @@ module Kettle
     module CLI
       USAGE = <<~USAGE
         Usage:
-          kettle-jem [PROJECT_ROOT] [--accept-config] [--bootstrap-mode] [--quiet|--verbose]
-          kettle-jem setup [PROJECT_ROOT] [--accept-config] [--bootstrap-mode] [--quiet|--verbose]
-          kettle-jem prepare [PROJECT_ROOT] [--json|--events[=TYPE,...]] [--report PATH] [--accept|--force] [--quiet|--verbose]
+          kettle-jem [PROJECT_ROOT] [--accept-config] [--bootstrap-mode] [--changelog|--no-changelog] [--quiet|--verbose]
+          kettle-jem setup [PROJECT_ROOT] [--accept-config] [--bootstrap-mode] [--changelog|--no-changelog] [--quiet|--verbose]
+          kettle-jem prepare [PROJECT_ROOT] [--json|--events[=TYPE,...]] [--report PATH] [--accept|--force] [--changelog|--no-changelog] [--quiet|--verbose]
           kettle-jem plan [PROJECT_ROOT] [--json|--events[=TYPE,...]] [--report PATH] [--accept|--force|--interactive] [--failure-mode MODE] [--prompt-answer ID=ACTION]
-          kettle-jem apply [PROJECT_ROOT] [--json|--events[=TYPE,...]] [--report PATH] [--accept|--force|--interactive] [--failure-mode MODE] [--prompt-answer ID=ACTION]
-          kettle-jem template [PROJECT_ROOT] [--json|--events[=TYPE,...]] [--report PATH] [--accept|--force|--interactive] [--failure-mode MODE] [--prompt-answer ID=ACTION]
-          kettle-jem install [PROJECT_ROOT] [--json|--events[=TYPE,...]] [--report PATH] [--accept|--force|--interactive] [--failure-mode MODE] [--prompt-answer ID=ACTION]
+          kettle-jem apply [PROJECT_ROOT] [--json|--events[=TYPE,...]] [--report PATH] [--accept|--force|--interactive] [--failure-mode MODE] [--prompt-answer ID=ACTION] [--changelog|--no-changelog]
+          kettle-jem template [PROJECT_ROOT] [--json|--events[=TYPE,...]] [--report PATH] [--accept|--force|--interactive] [--failure-mode MODE] [--prompt-answer ID=ACTION] [--changelog|--no-changelog]
+          kettle-jem install [PROJECT_ROOT] [--json|--events[=TYPE,...]] [--report PATH] [--accept|--force|--interactive] [--failure-mode MODE] [--prompt-answer ID=ACTION] [--changelog|--no-changelog]
           kettle-jem manifest [PROJECT_ROOT] [--json]
           kettle-jem selftest [PROJECT_ROOT] [--json] [--report PATH] [--destination PATH] [--template-root PATH] [--selftest-output PATH]
           kettle-jem version
@@ -146,6 +146,9 @@ module Kettle
           opts.on("--skip-rubocop-gradual", "Skip post-template RuboCop Gradual autocorrect.") do
             options[:run_options][:skip_rubocop_gradual] = true
           end
+          opts.on("--[no-]changelog", "Add a Changed entry summarizing actual template changes (default).") do |value|
+            options[:run_options][:skip_changelog] = !value
+          end
           opts.on("--skip-binstubs", "Skip post-template curated Bundler binstub generation.") do
             options[:run_options][:skip_binstubs] = true
           end
@@ -199,7 +202,7 @@ module Kettle
             types: options[:event_types]
           )
         end
-        case command
+        result = case command
         when "setup"
           Kettle::Jem.setup_project(project_root, env: env, run_options: run_options)
         when "prepare"
@@ -229,6 +232,14 @@ module Kettle
         else
           raise ArgumentError, "Unsupported kettle-jem command #{command.inspect}"
         end
+        return result unless %w[setup prepare apply template install].include?(command)
+
+        Kettle::Jem::MaintenanceChangelog.record_template_run(
+          project_root: project_root,
+          report: result,
+          run_options: run_options,
+          label: (command == "prepare") ? "Prepare project for kettle-jem templates" : "Apply kettle-jem templates"
+        )
       end
 
       def scoped_template_run?(run_options)

data/lib/kettle/jem/maintenance_changelog.rb

@@ -0,0 +1,136 @@
+# frozen_string_literal: true
+
+require "json"
+require "open3"
+require "rbconfig"
+require "rubygems"
+
+module Kettle
+  module Jem
+    module MaintenanceChangelog
+      TEMPLATE_CHANGELOG_INTERNAL_PATHS = %w[
+        CHANGELOG.md
+        .structuredmerge/kettle-jem.lock
+        .kettle-jem.lock
+      ].freeze
+      TEMPLATE_CHANGE_CATEGORIES = {
+        workflows: ->(path) { path.start_with?(".github/workflows/") },
+        dependencies: ->(path) {
+          path == "Gemfile" || path == "Appraisals" || path.end_with?(".gemspec", ".gemfile", ".gemfile.lock") ||
+            path.start_with?("gemfiles/")
+        },
+        documentation: ->(path) { %w[README.md CONTRIBUTING.md SECURITY.md].include?(path) || path.start_with?("docs/") },
+        configuration: ->(path) { path.start_with?(".structuredmerge/") || path == "mise.toml" || path == ".gitignore" },
+        code_and_tests: ->(path) { path.start_with?("lib/", "spec/", "test/", "bin/") || path == "Rakefile" }
+      }.freeze
+      BUNDLER_ENVIRONMENT = %w[
+        BUNDLE_BIN_PATH
+        BUNDLE_FROZEN
+        BUNDLE_GEMFILE
+        BUNDLE_LOCKFILE
+        BUNDLER_SETUP
+        BUNDLER_VERSION
+        RUBYLIB
+        RUBYOPT
+      ].freeze
+
+      module_function
+
+      def add_unreleased_entry(project_root:, section:, entry:)
+        command = [
+          RbConfig.ruby,
+          "-rrubygems",
+          "-e",
+          'exec Gem.ruby, Gem.bin_path("kettle-changelog", "kettle-changelog"), *ARGV',
+          "--",
+          "--add-unreleased-entry",
+          "--json",
+          "--section",
+          section.to_s,
+          "--entry",
+          entry.to_s
+        ]
+        environment = BUNDLER_ENVIRONMENT.to_h { |key| [key, nil] }
+        stdout, stderr, status = Open3.capture3(environment, *command, chdir: project_root)
+        unless status.success?
+          detail = [stdout, stderr].reject(&:empty?).join("\n")
+          raise "kettle-changelog failed (exit #{status.exitstatus}): #{detail}"
+        end
+
+        result = JSON.parse(stdout)
+        {
+          status: result.fetch("changed") ? "updated" : "unchanged",
+          section: result.fetch("section"),
+          entry: result.fetch("entry")
+        }
+      rescue JSON::ParserError => error
+        raise "kettle-changelog returned invalid JSON: #{error.message}"
+      rescue Gem::Exception => error
+        raise "kettle-changelog executable is not installed: #{error.message}"
+      end
+
+      def upsert_unreleased_entry(project_root:, section:, key:, entry:, legacy_prefixes: [])
+        result = Kettle::Changelog::KeyedEntryUpserter.new(
+          root: project_root,
+          section: section,
+          key: key,
+          entry: entry,
+          legacy_prefixes: legacy_prefixes
+        ).run
+        result.merge(status: result.fetch(:changed) ? "updated" : "unchanged")
+      end
+
+      def record_template_run(project_root:, report:, run_options: {}, label: "Apply kettle-jem templates")
+        report = report.to_h
+        if template_changelog_disabled?(run_options) || bootstrap_only_report?(report)
+          return report.merge(changelog: {status: "skipped", reason: template_changelog_disabled?(run_options) ? "disabled" : "bootstrap_only"})
+        end
+
+        changed_files = template_changed_files(report.fetch(:changed_files, []))
+        if changed_files.empty?
+          return report.merge(changelog: {status: "skipped", reason: "no_template_changes", changed_files: []})
+        end
+
+        entry = template_run_entry(label, changed_files)
+        result = add_unreleased_entry(project_root: project_root, section: "Changed", entry: entry)
+        changelog = result.merge(changed_files: changed_files, entry: entry)
+        changed_files_with_changelog = if result.fetch(:status) == "updated"
+          (Array(report.fetch(:changed_files, [])) + ["CHANGELOG.md"]).uniq.sort
+        else
+          Array(report.fetch(:changed_files, [])).uniq.sort
+        end
+        report.merge(changelog: changelog, changed_files: changed_files_with_changelog)
+      end
+
+      def template_changed_files(changed_files)
+        Array(changed_files).map(&:to_s).uniq.sort.reject do |path|
+          TEMPLATE_CHANGELOG_INTERNAL_PATHS.include?(path)
+        end
+      end
+
+      def template_run_entry(label, changed_files)
+        counts = changed_files.group_by { |path| template_change_category(path) }
+          .sort_by { |category, _paths| category.to_s }
+          .map { |category, paths| "#{category.to_s.tr("_", " ")} (#{paths.length})" }
+        areas = counts.empty? ? "project files" : counts.join(", ")
+        "#{label}: updated #{changed_files.length} project file#{"s" unless changed_files.length == 1} across #{areas}."
+      end
+
+      def template_change_category(path)
+        TEMPLATE_CHANGE_CATEGORIES.each do |category, matcher|
+          return category if matcher.call(path)
+        end
+        :other
+      end
+
+      def template_changelog_disabled?(run_options)
+        options = run_options.to_h
+        DecisionPolicy.value_to_boolean(options[:skip_changelog] || options["skip_changelog"])
+      end
+
+      def bootstrap_only_report?(report)
+        report.fetch(:setup_status, "").to_s.start_with?("bootstrap_")
+      end
+    end
+  end
+end

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

@@ -44,6 +44,7 @@ module Kettle
           install_steps << rubocop_lts_branch_step if rubocop_lts_branch_step
           install_steps << run_distinct_bundle_install_step(project_root, env: env, setup_env: setup_env, run_options: effective_run_options, command_runner: command_runner)
           install_steps.concat(run_bundle_setup_commands(project_root, env: setup_env, run_options: effective_run_options, command_runner: command_runner))
+          install_steps << appraisal_generate_step(project_root, env: setup_env, run_options: effective_run_options)
           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)
@@ -188,6 +189,7 @@ module Kettle
               git_drivers
               rubocop_lts_local_branch
               bundle_install_requested_env
+              appraisal_generate
               bin_setup_executable
               bin_setup
               bundle_binstubs
@@ -629,6 +631,47 @@ module Kettle
           steps
         end
 
+        def appraisal_generate_step(project_root, env: nil, run_options: {})
+          if Kettle::Jem::DecisionPolicy.value_to_boolean((run_options || {})[:skip_appraisal_generate])
+            return {
+              name: "appraisal_generate",
+              status: "skipped",
+              reason: "skip_appraisal_generate"
+            }
+          end
+
+          unless Array((run_options || {})[:only]).empty?
+            return {
+              name: "appraisal_generate",
+              status: "skipped",
+              reason: "template_selection"
+            }
+          end
+
+          unless File.file?(File.join(project_root.to_s, "Appraisals")) && File.file?(File.join(project_root.to_s, "bin", "rake"))
+            return {
+              name: "appraisal_generate",
+              status: "skipped",
+              reason: "missing_appraisals_entrypoint"
+            }
+          end
+
+          unless rake_task_available?(project_root, "appraisal:generate", env: env)
+            return {
+              name: "appraisal_generate",
+              status: "skipped",
+              reason: "missing_appraisal_generate_task"
+            }
+          end
+
+          {
+            name: "appraisal_generate",
+            command: ["bin/rake", "appraisal:generate"],
+            status: "ready",
+            reason: "post_template_appraisal_generation"
+          }
+        end
+
         def bundle_binstubs_command(project_root = Dir.pwd, env: ENV)
           %w[bundle binstubs] + curated_binstub_gems_in_bundle(project_root, env: env)
         end
@@ -1093,6 +1136,8 @@ module Kettle
               execute_ready_command_step(step, project_root: project_root, env: env, quiet: quiet, command_runner: command_runner)
             when "bundle_install_requested_env"
               execute_ready_command_step(step, project_root: project_root, env: env, quiet: quiet, command_runner: command_runner)
+            when "appraisal_generate"
+              execute_ready_command_step(step, project_root: project_root, env: env, quiet: quiet, command_runner: command_runner)
             when "rubocop_gradual_autocorrect"
               execute_ready_command_step(step, project_root: project_root, env: env, quiet: quiet, command_runner: command_runner)
             when "hook_templates"

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

@@ -31,6 +31,11 @@ module Kettle
           )
           events = Kettle::Jem.event_stream_from_options(effective_run_options)
           report = Kettle::Jem.apply_project(project_root, env: env, run_options: prepare_run_options)
+          profile_sync_step = synchronize_monorepo_subgem_profile_step(project_root, report)
+          supplemental_report = if profile_sync_step && profile_sync_step.fetch(:status) == "applied"
+            Kettle::Jem.apply_project(project_root, env: env, run_options: prepare_run_options)
+          end
+          report = merge_supplemental_prepare_report(report, supplemental_report)
           nomono_bootstrap_step = normalize_existing_local_gemfile_bootstraps_step(project_root, events: events)
           setup_env = Kettle::Jem::Tasks::InstallTask.setup_command_env(project_root, env)
           setup_env["BUNDLE_DISABLE_CHECKSUM_VALIDATION"] = "true"
@@ -76,7 +81,7 @@ module Kettle
               %w[skipped succeeded].include?(reset_step.fetch(:status)) &&
               %w[skipped succeeded].include?(bundle_step.fetch(:status)),
             prepare_only: PREPARE_ONLY_PATHS,
-            prepare_steps: [nomono_bootstrap_step, reset_step, bootstrap_step, bundle_step],
+            prepare_steps: [profile_sync_step, nomono_bootstrap_step, reset_step, bootstrap_step, bundle_step].compact,
             changed_files: (
               report.fetch(:changed_files, []) +
                 nomono_bootstrap_step.fetch(:changed_files, []) +
@@ -94,6 +99,24 @@ module Kettle
           final_report
         end
 
+        def synchronize_monorepo_subgem_profile_step(project_root, report)
+          facts = report.fetch(:facts, {})
+          return unless Kettle::Jem.send(:monorepo_subgem_template_profile?, facts)
+
+          Kettle::Jem.send(:monorepo_subgem_kettle_config_profile_sync_step, project_root, report)
+        end
+
+        def merge_supplemental_prepare_report(report, supplemental_report)
+          return report unless supplemental_report
+
+          report.merge(
+            changed_files: (
+              report.fetch(:changed_files, []) + supplemental_report.fetch(:changed_files, [])
+            ).uniq.sort,
+            diagnostics: report.fetch(:diagnostics, []) + supplemental_report.fetch(:diagnostics, [])
+          )
+        end
+
         def normalize_existing_local_gemfile_bootstraps_step(project_root, events:)
           paths = Dir.glob(File.join(project_root.to_s, "gemfiles/modular/**/*_local.gemfile")).sort
           changed_files = paths.filter_map do |path|

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

@@ -66,7 +66,9 @@ module Kettle
             skip_drift_check: truthy?(env["KETTLE_JEM_SKIP_DRIFT_CHECK"]),
             skip_rubocop_gradual: truthy?(env["KETTLE_JEM_SKIP_RUBOCOP_GRADUAL"]),
             skip_binstubs: truthy?(env["KETTLE_JEM_SKIP_BINSTUBS"]),
+            skip_appraisal_generate: truthy?(env["KETTLE_JEM_SKIP_APPRAISAL_GENERATE"]),
             skip_lock_normalization: truthy?(env["KETTLE_JEM_SKIP_LOCK_NORMALIZATION"]),
+            skip_changelog: truthy?(env["KETTLE_JEM_SKIP_CHANGELOG"]),
             checksums: env["KETTLE_JEM_CHECKSUMS"],
             accept_config: truthy?(env["KETTLE_JEM_ACCEPT_CONFIG"]),
             bootstrap_mode: truthy?(env["KETTLE_JEM_BOOTSTRAP_MODE"]),

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

@@ -5,8 +5,8 @@
 *.gem
 
 # Bundler
-/vendor/bundle/
 /.bundle/
+/vendor/bundle*/
 /gemfiles/*.lock
 /gemfiles/**/*.gemfile.lock
 /gemfiles/.bundle/

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

@@ -95,7 +95,6 @@ This gem is part of the **StructuredMerge** ecosystem. Key development tools:
 |-----------|---------|
 | `kettle-release` | Full gem release workflow |
 | `kettle-pre-release` | Pre-release validation |
-| `kettle-changelog` | Changelog generation |
 | `kettle-dvcs` | DVCS (git) workflow automation |
 | `kettle-commit-msg` | Commit message validation |
 | `kettle-check-eof` | EOF newline validation |

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

@@ -39,6 +39,9 @@ eval_gemfile "gemfiles/modular/style.gemfile"
 # Documentation
 eval_gemfile "gemfiles/modular/documentation.gemfile"
 
+# Changelog release tooling (available on Ruby versions supported by kettle-changelog)
+eval_gemfile "gemfiles/modular/changelog.gemfile"
+
 # Optional
 eval_gemfile "gemfiles/modular/optional.gemfile"
 

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

@@ -194,8 +194,7 @@ See [SECURITY.md][🔐security].
 ## 🤝 Contributing
 
 If you need some ideas of where to help, you could work on adding more code coverage,
-or if it is already 💯 (see [below](#code-coverage)) check [issues][🤝gh-issues] or [PRs][🤝gh-pulls],
-or use the gem and think about how it could be better.
+check [issues][🤝gh-issues] or [PRs][🤝gh-pulls], or use the gem and think about how it could be better.
 
 We [![Keep A Changelog][📗keep-changelog-img]][📗keep-changelog] so if you make changes, remember to update it.
 
@@ -234,11 +233,11 @@ Also see GitLab Contributors: [{KJ|README:GL_CONTRIBUTORS_URL}][🚎contributors
 <details markdown="1">
     <summary>⭐️ Star History</summary>
 
-<a href="https://star-history.com/{KJ|README:STAR_HISTORY_REPO}&Date">
+<a href="https://star-history.dera.page/#{KJ|README:STAR_HISTORY_REPO}&type=date&legend=top-left">
  <picture>
-   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos={KJ|README:STAR_HISTORY_REPO}&type=Date&theme=dark" />
-   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos={KJ|README:STAR_HISTORY_REPO}&type=Date" />
-   <img alt="Star History Chart" src="https://api.star-history.com/svg?repos={KJ|README:STAR_HISTORY_REPO}&type=Date" />
+   <source media="(prefers-color-scheme: dark)" srcset="https://star-history.dera.page/svg?repos={KJ|README:STAR_HISTORY_REPO}&type=date&theme=dark&legend=top-left" />
+   <source media="(prefers-color-scheme: light)" srcset="https://star-history.dera.page/svg?repos={KJ|README:STAR_HISTORY_REPO}&type=date&legend=top-left" />
+   <img alt="Star History Chart" src="https://star-history.dera.page/svg?repos={KJ|README:STAR_HISTORY_REPO}&type=date&legend=top-left" />
  </picture>
 </a>
 

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", "~> 2.5", ">= 2.5.24")             # ruby >= {KJ|MIN_TEST_RUBY}
+  spec.add_development_dependency("kettle-dev", "~> 3.0", ">= 3.0.6")             # ruby >= {KJ|MIN_TEST_RUBY}
 
   # Security
   spec.add_development_dependency("bundler-audit", "~> 0.9.3")                      # ruby >= 2.0.0
@@ -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.19")            # ruby >= {KJ|MIN_TEST_RUBY}
-  spec.add_development_dependency("turbo_tests2", "~> 3.2", ">= 3.2.4")           # ruby >= 2.4.0, default kettle-test runner
+  spec.add_development_dependency("turbo_tests2", "~> 3.2", ">= 3.2.5")           # 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/changelog.gemfile.example

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+# kettle-changelog depends on the current kettle-dev APIs and the structured
+# Markdown merger. Keep it out of older appraisal jobs whose Ruby cannot load
+# its runtime dependency floor.
+{KJ|KETTLE_CHANGELOG_GEMFILE_DEPENDENCY}

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.4", require: false # Ruby >= 3.2
+gem "yaml-converter", "~> 0.2", ">= 0.2.5", 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.10", ">= 1.10.3", require: false # Ruby >= 3.3
+gem "yard-lint", "~> 1.11", ">= 1.11.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.7", require: false # Ruby >= 3.2
-  gem "yard-timekeeper", "~> 0.2", ">= 0.2.5", require: false
-  gem "yard-yaml", "~> 0.2", ">= 0.2.4", require: false
+  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
 else
   eval_gemfile "documentation_local.gemfile"
 end

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

@@ -17,7 +17,9 @@ platform :mri do
   gem "rubocop-minitest", "~> 0.40", ">= 0.40.0"
   gem "rubocop-on-rbs", "~> 2.0", ">= 2.0.0"        # ruby >= 3.2.0
   # gem "rubocop", "~> 1.73", ">= 1.73.2" # constrained by standard
-  gem "rubocop-packaging", "~> 0.6", ">= 0.6.0"
+  gem "rubocop-packaging",
+    github: "pboling/rubocop-packaging",
+    ref: "3539ba858d379740d638566faee9e56b2b854145"
   gem "standard", "~> 1.56", ">= 1.56.0"
 
   if ENV.fetch("RUBOCOP_LTS_LOCAL", "false").casecmp("false").zero?