kettle-family 1.3.31 → 1.3.32

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2e33765024c5355ceb460600f38a4699aa8b6ac1940520313b1e8ca5dc3de80e
-  data.tar.gz: 3b51fc7b19a05a471fffb8d3c6f6e4136af611e7b0857f55769825ca04edf328
+  metadata.gz: '08c77450947a59e4d899708d9ea06ac1f6a3ecdbca9f1875697a111221c8a513'
+  data.tar.gz: 39bab3f859dffecd3c7c7bf218bf60a31d593d174f7bf35cc78ee00120796e77
 SHA512:
-  metadata.gz: 765c430983dcc06ec76ffd956f7352b0b81149ebd6dbd36fadaa960a3ba528fdd226a4489863dcd1a0ddf2f78a5dd2679313bd4e9c6fe5b55c6f0c9ef1290136
-  data.tar.gz: 69b1ad005954541847254deb17c8bdc83574d41c48c55d5d7cb1f745fa4565afef6797c82f8d832b01aa8c194053bbba0d603050c3de25ffab26dc1e762a8a11
+  metadata.gz: e11ec34af3513c579f0de85e0ac3967736d9296edd3181c824661d0e77c958dba7fde98870a37b8ab0e030776f24ff8f90cee743e989b174ded6745f6c589363
+  data.tar.gz: f3420d41b085ff447bc05e0f4976fa4ee12b1eba42b73047a1afb5cadf8966b82f7a17430a2e9a5c7923f66ef6498646bcb7225aa71677264ed57cbf8c10fda6

data/CHANGELOG.md

@@ -30,6 +30,17 @@ Please file a bug if you notice a violation of semantic versioning.
 
 ### Security
 
+## [1.3.32] - 2026-10-23
+
+- TAG: [v1.3.32][1.3.32t]
+- COVERAGE: 93.10% -- 7548/8107 lines in 45 files
+- BRANCH COVERAGE: 77.70% -- 3034/3905 branches in 45 files
+- 38.69% documented
+
+### Fixed
+
+- MiseTasks.materialize_managed_suite no longer silently deletes root mise.toml task definitions that duplicate the managed suite. Root redefinitions shadow the managed file under mise precedence and may be deliberate local overrides; they are now REPORTED (template workflow, kettle-jem plugin, and mise-tasks CLI all warn with the same message and remediation hint) and removal stays opt-in via kettle-family mise-tasks --clean. Previously the CLI's documented warn-by-default path was dead code: materialize cleaned before the warning check ran, so redefinitions vanished without notice on every template run.
+
 ## [1.3.31] - 2026-10-23
 
 - TAG: [v1.3.31][1.3.31t]
@@ -3225,7 +3236,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.3.31...HEAD
+[Unreleased]: https://github.com/kettle-dev/kettle-family/compare/v1.3.32...HEAD
+[1.3.32]: https://github.com/kettle-dev/kettle-family/compare/v1.3.31...v1.3.32
+[1.3.32t]: https://github.com/kettle-dev/kettle-family/releases/tag/v1.3.32
 [1.3.31]: https://github.com/kettle-dev/kettle-family/compare/v1.3.30...v1.3.31
 [1.3.31t]: https://github.com/kettle-dev/kettle-family/releases/tag/v1.3.31
 [1.3.30]: https://github.com/kettle-dev/kettle-family/compare/v1.3.29...v1.3.30

data/README.md

@@ -1225,7 +1225,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-8.102-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
+[🧮kloc-img]: https://img.shields.io/badge/KLOC-8.107-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/mise_tasks.rb

@@ -8,10 +8,12 @@ module Kettle
   module Family
     # Slice-1044 family mise tasks primitive: ensure a destination root
     # `mise.toml` references the kettle-family-managed TOML task file via
-    # `[task_config] includes`, and report (optionally clean) task
-    # redefinitions between the root file and the managed file. Family
-    # refreshes migrate managed task names out of the root so old commands
-    # cannot shadow generated fixes. Other tasks and settings remain local.
+    # `[task_config] includes`, and report (never silently remove) task
+    # redefinitions between the root file and the managed file. Removal is
+    # the caller's explicit choice (`kettle-family mise-tasks --clean`): a
+    # root redefinition shadows the managed definition under mise precedence
+    # and may be a deliberate local override. Other tasks and settings remain
+    # local.
     #
     # All edits go through ast-crispr Actors with the ast-crispr-toml adapter.
     module MiseTasks
@@ -320,14 +322,23 @@ module Kettle
 
         task_file_path = File.join(root, task_file_name)
         original = File.read(root_mise)
-        included = ensure_include(root_content: original, task_file_name: task_file_name)
-        result = clean_redefinitions(
-          root_content: included.content,
-          task_file_name: task_file_name,
-          task_file_content: content
-        )
+        result = ensure_include(root_content: original, task_file_name: task_file_name, task_file_content: content)
         File.write(task_file_path, content) unless File.exist?(task_file_path) && File.read(task_file_path) == content
         File.write(root_mise, result.content) unless result.content == original
+        result
+      end
+
+      # Warn about each redefinition to the given stream. Shared by the CLI
+      # command, the template workflow, and the kettle-jem plugin so the
+      # message and remediation hint stay identical everywhere.
+      #
+      # @param redefinitions [Array<String>]
+      # @param task_file_name [String]
+      # @param err [IO]
+      def self.warn_redefinitions(redefinitions, task_file_name: DEFAULT_TASK_FILE_NAME, err: $stderr)
+        Array(redefinitions).each do |name|
+          err.puts("kettle-family: task #{name.inspect} is defined in both mise.toml and #{task_file_name}; root mise.toml wins (redefinition allowed; run `kettle-family mise-tasks --clean` to restore the managed definition)")
+        end
       end
 
       # Comprehensive managed family mise task suite, generated from family

data/lib/kettle/family/version.rb

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

data/lib/kettle/family/workflow.rb

@@ -259,7 +259,8 @@ module Kettle
         )
         results = checkout_preflight + sync_results + workflow_results + rollback_results + restore_results
         if results.all?(&:ok?)
-          MiseTasks.materialize_managed_suite(context: {project_root: config.root})
+          suite_result = MiseTasks.materialize_managed_suite(context: {project_root: config.root})
+          MiseTasks.warn_redefinitions(suite_result&.redefinitions)
           # `mise trust` requires the mise executable; spec environments and
           # minimal CI images may not have it installed. Trust is only an
           # enabler for subsequent nested mise runs, so skip when absent.

data/lib/kettle/family.rb

@@ -71,7 +71,8 @@ module Kettle
 
     def register_kettle_jem_plugin(registrar)
       registrar.on_phase("remaining_files", timing: :after) do |context:|
-        MiseTasks.materialize_managed_suite(context: context)
+        suite_result = MiseTasks.materialize_managed_suite(context: context)
+        MiseTasks.warn_redefinitions(suite_result&.redefinitions)
       end
     end
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: kettle-family
 version: !ruby/object:Gem::Version
-  version: 1.3.31
+  version: 1.3.32
 platform: ruby
 authors:
 - Peter H. Boling
@@ -568,10 +568,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.3.31
-  changelog_uri: https://github.com/kettle-dev/kettle-family/blob/v1.3.31/CHANGELOG.md
+  source_code_uri: https://github.com/kettle-dev/kettle-family/tree/v1.3.32
+  changelog_uri: https://github.com/kettle-dev/kettle-family/blob/v1.3.32/CHANGELOG.md
   bug_tracker_uri: https://github.com/kettle-dev/kettle-family/issues
-  documentation_uri: https://www.rubydoc.info/gems/kettle-family/1.3.31
+  documentation_uri: https://www.rubydoc.info/gems/kettle-family/1.3.32
   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