kettle-family 1.1.8 → 1.1.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 168c6823b78ae99fcbe6066d6d923b4111ea9a01fb208e100addfad6914dfb06
-  data.tar.gz: ca1d7f9dda6ab6a9324db3fb0dfbb911a166b842f8d76c6ade2165be03be7f2a
+  metadata.gz: a7a1fef6a9376e6ea7f3d4f2ecd61bf5a610fdb1585037ce63631ef106ec6e24
+  data.tar.gz: aa9c89f697651bf26926575dde900f6ab070b487191f2ca6436ce04a3ad231c6
 SHA512:
-  metadata.gz: 6ff9056c21b70d0cb7d218906ea402f8ede543649d4d41292a9f434271a3bfeccc6bccf02db87bca8c3526d69a9fdb99a34a7e084d332ddd4045a6d4ff39f736
-  data.tar.gz: be9ee1ee76ac7a5b2b9d346fe54a48205e164ee6d9e89a7e9794543f23a6ef1663c5e8ad598faf4483774ee846a34bb1beffad0b441551e0a28a708fc4461b54
+  metadata.gz: 11993355cf52d83e6bbbdae954983f7e10233968fece69a812c62ea5c1787112ba825e2eed207c12a06d44abb3af6199af5f3a11647733845abd8ba76ed25335
+  data.tar.gz: 7abbd03f4c8f434c8a069dc92d6c4eb66b06b81adb73d2454cf5fc0be9dbcb5335201b248173c15d91fcff699761e408303be2c7887fdabd1a07b2dd63e38ec8

data/CHANGELOG.md

@@ -30,6 +30,35 @@ Please file a bug if you notice a violation of semantic versioning.
 
 ### Security
 
+## [1.1.9] - 2026-07-25
+
+- TAG: [v1.1.9][1.1.9t]
+- COVERAGE: 95.23% -- 3197/3357 lines in 25 files
+- BRANCH COVERAGE: 77.20% -- 1192/1544 branches in 25 files
+- 28.16% documented
+
+### Added
+
+- `kettle-family state` now marks mismatched GitHub release tags and reports
+  kettle-jem transfer changelog replay lag in a `T📰` column.
+
+### Changed
+
+- Bare `kettle-family bump` now defaults to `--only bump`, and bare
+  `kettle-family release` now defaults to `--only pending`.
+
+- kettle-jem-template-20260725-002 - Generated gemspec templates now include
+  `anonymous_loader` as a development dependency, and version specs use it to
+  execute generated `version.rb` files for coverage without redefining package
+  constants. Managed version specs are removed when `version_gem` is disabled
+  or incompatible with the project's runtime Ruby floor.
+
+### Fixed
+
+- Monorepo templating now passes a shared Git operation lock to `kettle-jem`,
+  allowing template workers to serialize repo-wide Git config/index mutations
+  instead of only bootstrap commits.
+
 ## [1.1.8] - 2026-07-25
 
 - TAG: [v1.1.8][1.1.8t]
@@ -1043,7 +1072,9 @@ Please file a bug if you notice a violation of semantic versioning.
 - Fixed CI load failures on engines without compatible `pty` support by falling back to Open3 for interactive release commands.
 - Fixed Ruby 3.2 version-bump support by loading Prism lazily and wiring the Prism gem only for MRI versions that need it.
 
-[Unreleased]: https://github.com/kettle-dev/kettle-family/compare/v1.1.8...HEAD
+[Unreleased]: https://github.com/kettle-dev/kettle-family/compare/v1.1.9...HEAD
+[1.1.9]: https://github.com/kettle-dev/kettle-family/compare/v1.1.8...v1.1.9
+[1.1.9t]: https://github.com/kettle-dev/kettle-family/releases/tag/v1.1.9
 [1.1.8]: https://github.com/kettle-dev/kettle-family/compare/v1.1.7...v1.1.8
 [1.1.8t]: https://github.com/kettle-dev/kettle-family/releases/tag/v1.1.8
 [1.1.7]: https://github.com/kettle-dev/kettle-family/compare/v1.1.6...v1.1.7

data/README.md

@@ -669,7 +669,7 @@ Thanks for RTFM. ☺️
 [📌gitmoji]: https://gitmoji.dev
 [📌gitmoji-img]: https://img.shields.io/badge/gitmoji_commits-%20%F0%9F%98%9C%20%F0%9F%98%8D-34495e.svg?style=flat-square
 [🧮kloc]: https://www.youtube.com/watch?v=dQw4w9WgXcQ
-[🧮kloc-img]: https://img.shields.io/badge/KLOC-3.296-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
+[🧮kloc-img]: https://img.shields.io/badge/KLOC-3.357-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
 [🔐security]: https://github.com/kettle-dev/kettle-family/blob/main/SECURITY.md
 [🔐security-img]: https://img.shields.io/badge/security-policy-259D6C.svg?style=flat
 [📄copyright-notice-explainer]: https://opensource.stackexchange.com/questions/5778/why-do-licenses-such-as-the-mit-license-specify-a-single-year

data/lib/kettle/family/cli.rb

@@ -560,8 +560,9 @@ module Kettle
         else
           Orderer.new(members: members, mode: config.order_mode, hints: config.order_hints).ordered
         end
-        release_state_results = release_state_results_for_selection(config: config, members: ordered, only: options[:only])
-        selected = Selection.new(members: ordered, release_state_results: release_state_results).apply(only: options[:only], exclude: options[:exclude], start_at: start_at.member)
+        effective_only = default_only_filter(command: command, only: options[:only])
+        release_state_results = release_state_results_for_selection(config: config, members: ordered, only: effective_only)
+        selected = Selection.new(members: ordered, release_state_results: release_state_results).apply(only: effective_only, exclude: options[:exclude], start_at: start_at.member)
         result_members = selected
         results = command_results(command: command, config: config, members: result_members, options: options, start_at: start_at)
         Report.new(
@@ -595,6 +596,14 @@ module Kettle
         ReleaseStateCheck.new(config: config, members: members).results
       end
 
+      def default_only_filter(command:, only:)
+        return only unless only.to_s.empty?
+        return "bump" if %w[bump bump-version].include?(command)
+        return "pending" if command == "release"
+
+        only
+      end
+
       def command_results_for_current_branch(command:, config:, members:, options:, start_at: StartAt.new(nil, nil))
         return bump_version_results(members: members, options: options, phase: command) if %w[bump bump-version].include?(command)
         return add_changelog_results(members: members, options: options) if command == "add-changelog"

data/lib/kettle/family/release_state_check.rb

@@ -6,14 +6,18 @@ require "open3"
 require "rbconfig"
 require "rubygems"
 require "securerandom"
+require "yaml"
 
 module Kettle
   module Family
     class ReleaseStateCheck
+      KETTLE_JEM_CONFIG_PATHS = [".structuredmerge/kettle-jem.yml", ".kettle-jem.yml"].freeze
+
       def initialize(members:, config: nil)
         @members = members
         @config = config
         @github_latest_release_by_repo = {}
+        @transfer_changelog_lag_by_key = {}
       end
 
       def results
@@ -63,6 +67,7 @@ module Kettle
         state = state_with_computed_booleans(state) if success
         state = enrich_git_state(member.root, state) if success
         state = enrich_github_release(member.root, state) if success
+        state = enrich_transfer_changelog_lag(member.root, state) if success
         result(member: member, command: command, stdout: stdout, stderr: stderr, status: status.exitstatus, elapsed: elapsed, success: success, state: state, branch: branch)
       rescue JSON::ParserError => error
         result(member: member, command: command || release_state_command, stdout: stdout, stderr: stderr, status: 1, elapsed: elapsed || 0.0, success: false, state: {}, reason: "invalid release-state JSON: #{error.message}", branch: branch)
@@ -88,6 +93,7 @@ module Kettle
         state = branch_filtered_state(member, state, branch) if success && branch
         state = enrich_git_state(member.root, state) if success
         state = enrich_github_release(member.root, state) if success
+        state = enrich_transfer_changelog_lag(member.root, state) if success
         result(
           member: member,
           command: command,
@@ -283,7 +289,7 @@ module Kettle
         unreleased_entries = unreleased_entries?(content)
         prepared_release_pending = !version.to_s.empty? && latest_changelog_version == version
         ahead = commits_ahead_of_release(root, latest_changelog_version)
-        enrich_github_release(root, state_with_computed_booleans(enrich_git_state(root, {
+        state = enrich_github_release(root, state_with_computed_booleans(enrich_git_state(root, {
           "gem_name" => config.family_name,
           "version" => version,
           "latest_released" => nil,
@@ -293,6 +299,7 @@ module Kettle
           "prepared_release_pending" => prepared_release_pending,
           "pending_release" => unreleased_entries || prepared_release_pending
         })))
+        enrich_transfer_changelog_lag(root, state)
       end
 
       def state_with_computed_booleans(state)
@@ -312,6 +319,74 @@ module Kettle
         state.merge("github_latest_release" => tag)
       end
 
+      def enrich_transfer_changelog_lag(root, state)
+        kettle_jem_state = kettle_jem_config_state(root)
+        return state unless kettle_jem_state
+
+        replay = kettle_jem_state["changelog_replay"]
+        replay = replay.is_a?(Hash) ? replay : {}
+        last_entry_key = replay["last_entry_key"] || replay[:last_entry_key]
+        lag = transfer_changelog_lag(last_entry_key)
+        return state unless lag
+
+        state.merge("transfer_changelog_lag" => lag.fetch("missing_count", 0).to_i)
+      end
+
+      def kettle_jem_config_state(root)
+        path = KETTLE_JEM_CONFIG_PATHS.map { |relative| File.join(root.to_s, relative) }.find { |candidate| File.file?(candidate) }
+        return nil unless path
+
+        data = YAML.safe_load_file(path, permitted_classes: [], aliases: false)
+        state = data.is_a?(Hash) ? data["kettle-jem"] : nil
+        state.is_a?(Hash) ? state : {}
+      rescue Psych::Exception, SystemCallError
+        nil
+      end
+
+      def transfer_changelog_lag(last_entry_key)
+        cache_key = last_entry_key.to_s
+        @transfer_changelog_lag_by_key.fetch(cache_key) do
+          @transfer_changelog_lag_by_key[cache_key] = in_process_transfer_changelog_lag(last_entry_key) || external_transfer_changelog_lag(cache_key)
+        end
+      rescue
+        nil
+      end
+
+      def in_process_transfer_changelog_lag(last_entry_key)
+        return nil unless load_kettle_jem_transfer_api
+
+        normalize_transfer_changelog_lag(::Kettle::Jem.transfer_changelog_lag(last_entry_key))
+      rescue
+        nil
+      end
+
+      def load_kettle_jem_transfer_api
+        return true if defined?(::Kettle::Jem) && ::Kettle::Jem.respond_to?(:transfer_changelog_lag)
+
+        require "kettle/jem"
+        defined?(::Kettle::Jem) && ::Kettle::Jem.respond_to?(:transfer_changelog_lag)
+      rescue LoadError
+        false
+      end
+
+      def external_transfer_changelog_lag(cache_key)
+        code = <<~RUBY
+          last_entry_key = ARGV.fetch(0, "")
+          last_entry_key = nil if last_entry_key.empty?
+          puts JSON.generate(Kettle::Jem.transfer_changelog_lag(last_entry_key))
+        RUBY
+        stdout, _stderr, status = Open3.capture3(RbConfig.ruby, "-rjson", "-rkettle/jem", "-e", code, cache_key)
+        status.success? ? normalize_transfer_changelog_lag(JSON.parse(stdout)) : nil
+      rescue JSON::ParserError, SystemCallError
+        nil
+      end
+
+      def normalize_transfer_changelog_lag(lag)
+        return nil unless lag.is_a?(Hash)
+
+        lag.each_with_object({}) { |(key, value), memo| memo[key.to_s] = value }
+      end
+
       def github_latest_release(root)
         repo = github_repo_slug(root)
         return nil unless repo

data/lib/kettle/family/report.rb

@@ -421,6 +421,7 @@ module Kettle
         lines << "    prep: V.ch.md matches V.rb and is ready to publish"
         lines << "    pend: unrel or prep"
         lines << "    bump: unrel is yes and V.rb matches V.rel"
+        lines << "    T📰: kettle-jem transfer changelog entries not yet replayed"
         rows = release_state_header
         results.each do |result|
           rows << release_state_row(result)
@@ -444,7 +445,8 @@ module Kettle
           state.fetch("version", "unknown").to_s,
           state.fetch("latest_changelog_version", nil).to_s.empty? ? "none" : state.fetch("latest_changelog_version").to_s,
           state.fetch("latest_released", nil).to_s.empty? ? "unknown" : state.fetch("latest_released").to_s,
-          state.fetch("github_latest_release", nil).to_s.empty? ? "unknown" : state.fetch("github_latest_release").to_s,
+          release_state_github_release(state),
+          state.fetch("transfer_changelog_lag", 0).to_i.to_s,
           release_state_ahead_behind(state),
           yes_no(state.fetch("unreleased_entries", nil)),
           yes_no(state.fetch("prepared_release_pending", nil)),
@@ -457,12 +459,26 @@ module Kettle
       end
 
       def release_state_header
-        header = [["gem", "checkout", "V.rb", "V.ch.md", "V.rel", "GH.rel", "🔼 / 🔽", "unrel", "prep", "pend", "bump"]]
+        header = [["gem", "checkout", "V.rb", "V.ch.md", "V.rel", "GH.rel", "T📰", "🔼 / 🔽", "unrel", "prep", "pend", "bump"]]
         return header unless release_state_has_branches?
 
         [["branch", *header.first]]
       end
 
+      def release_state_github_release(state)
+        github_release = state.fetch("github_latest_release", nil).to_s
+        return "unknown" if github_release.empty?
+
+        latest_released = state.fetch("latest_released", nil).to_s
+        return github_release if latest_released.empty? || latest_released == "unknown"
+
+        release_state_release_versions_match?(latest_released, github_release) ? github_release : "🔴 #{github_release}"
+      end
+
+      def release_state_release_versions_match?(latest_released, github_release)
+        latest_released.to_s.delete_prefix("v") == github_release.to_s.delete_prefix("v")
+      end
+
       def release_state_checkout(state)
         branch = state.fetch("current_branch", nil).to_s
         branch.empty? ? "unknown" : branch[0, 10]

data/lib/kettle/family/version.rb

@@ -3,7 +3,7 @@
 module Kettle
   module Family
     module Version
-      VERSION = "1.1.8"
+      VERSION = "1.1.9"
     end
     VERSION = Version::VERSION # Traditional Constant Location
   end

data/lib/kettle/family/workflow.rb

@@ -1059,7 +1059,11 @@ module Kettle
           if command == "template"
             env["KETTLE_JEM_TEMPLATE_PROFILE"] = config.template_profile if config.template_profile
             env["KJ_REPOSITORY_TOPOLOGY"] = config.template_repository_topology if config.template_repository_topology
-            env["KETTLE_JEM_GIT_COMMIT_LOCK"] = template_git_commit_lock_path if monorepo_template?
+            if monorepo_template?
+              template_git_lock_path = template_git_commit_lock_path
+              env["KETTLE_JEM_GIT_LOCK"] = template_git_lock_path
+              env["KETTLE_JEM_GIT_COMMIT_LOCK"] = template_git_lock_path
+            end
             corporate_sponsors = config.readme_corporate_sponsors
             unless corporate_sponsors.empty?
               env["KETTLE_JEM_CORPORATE_SPONSORS_JSON"] = JSON.generate(corporate_sponsors)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: kettle-family
 version: !ruby/object:Gem::Version
-  version: 1.1.8
+  version: 1.1.9
 platform: ruby
 authors:
 - Peter H. Boling
@@ -181,6 +181,26 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: 1.0.4
+- !ruby/object:Gem::Dependency
+  name: anonymous_loader
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.1.3
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.1.3
 - !ruby/object:Gem::Dependency
   name: appraisal2
   requirement: !ruby/object:Gem::Requirement
@@ -319,10 +339,10 @@ licenses:
 - AGPL-3.0-only
 metadata:
   homepage_uri: https://kettle-family.galtzo.com
-  source_code_uri: https://github.com/kettle-dev/kettle-family/tree/v1.1.8
-  changelog_uri: https://github.com/kettle-dev/kettle-family/blob/v1.1.8/CHANGELOG.md
+  source_code_uri: https://github.com/kettle-dev/kettle-family/tree/v1.1.9
+  changelog_uri: https://github.com/kettle-dev/kettle-family/blob/v1.1.9/CHANGELOG.md
   bug_tracker_uri: https://github.com/kettle-dev/kettle-family/issues
-  documentation_uri: https://www.rubydoc.info/gems/kettle-family/1.1.8
+  documentation_uri: https://www.rubydoc.info/gems/kettle-family/1.1.9
   funding_uri: https://github.com/sponsors/pboling
   wiki_uri: https://github.com/kettle-dev/kettle-family/wiki
   news_uri: https://www.railsbling.com/tags/kettle-family