kettle-family 1.3.30 → 1.3.31

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: e1834021ad7c719f89aee9e9c7408bb2fd772797bf85087620e913f2d0b5cbc5
4
- data.tar.gz: abcb663c3eaffcebd396befa0443c3d5eb331cfdbcce6de417881cbda9e15679
3
+ metadata.gz: 2e33765024c5355ceb460600f38a4699aa8b6ac1940520313b1e8ca5dc3de80e
4
+ data.tar.gz: 3b51fc7b19a05a471fffb8d3c6f6e4136af611e7b0857f55769825ca04edf328
5
5
  SHA512:
6
- metadata.gz: fd431e1b40c4c7b7119461eabb4cf55625a2ebea4f37e9c553ee96f3fb7f66af690441f063a33b2118a1d60ed7fdd48be98e9a6c85016cbbc106946206a152b8
7
- data.tar.gz: b91b8eeb298ec02137d844df600e1ac2fe8ffefc5ff3c94fd055c8f10f57c162499deb1118a2c4034cd7ced3e2b0154b005255f2d95cdafe74744323ae9e6fb1
6
+ metadata.gz: 765c430983dcc06ec76ffd956f7352b0b81149ebd6dbd36fadaa960a3ba528fdd226a4489863dcd1a0ddf2f78a5dd2679313bd4e9c6fe5b55c6f0c9ef1290136
7
+ data.tar.gz: 69b1ad005954541847254deb17c8bdc83574d41c48c55d5d7cb1f745fa4565afef6797c82f8d832b01aa8c194053bbba0d603050c3de25ffab26dc1e762a8a11
checksums.yaml.gz.sig CHANGED
Binary file
data/CHANGELOG.md CHANGED
@@ -30,6 +30,17 @@ Please file a bug if you notice a violation of semantic versioning.
30
30
 
31
31
  ### Security
32
32
 
33
+ ## [1.3.31] - 2026-10-23
34
+
35
+ - TAG: [v1.3.31][1.3.31t]
36
+ - COVERAGE: 93.06% -- 7540/8102 lines in 45 files
37
+ - BRANCH COVERAGE: 77.65% -- 3029/3901 branches in 45 files
38
+ - 38.57% documented
39
+
40
+ ### Added
41
+
42
+ - release.preflight_commands family config: a list of {name, command} maintenance hooks run at the family root, in declaration order, as the FIRST release preflight phase — so template dependency floors, workflow pins, and similar generated-state maintenance land before version/state validation instead of failing the wave mid-publish. Commands may be strings or argv arrays; a failing command blocks the release; dry-run plans without executing. kettle-family ships only the mechanism — each family declares its own maintenance in its own .kettle-family.yml.
43
+
33
44
  ## [1.3.30] - 2026-10-22
34
45
 
35
46
  - TAG: [v1.3.30][1.3.30t]
@@ -3214,7 +3225,9 @@ Please file a bug if you notice a violation of semantic versioning.
3214
3225
  - Fixed CI load failures on engines without compatible `pty` support by falling back to Open3 for interactive release commands.
3215
3226
  - Fixed Ruby 3.2 version-bump support by loading Prism lazily and wiring the Prism gem only for MRI versions that need it.
3216
3227
 
3217
- [Unreleased]: https://github.com/kettle-dev/kettle-family/compare/v1.3.30...HEAD
3228
+ [Unreleased]: https://github.com/kettle-dev/kettle-family/compare/v1.3.31...HEAD
3229
+ [1.3.31]: https://github.com/kettle-dev/kettle-family/compare/v1.3.30...v1.3.31
3230
+ [1.3.31t]: https://github.com/kettle-dev/kettle-family/releases/tag/v1.3.31
3218
3231
  [1.3.30]: https://github.com/kettle-dev/kettle-family/compare/v1.3.29...v1.3.30
3219
3232
  [1.3.30t]: https://github.com/kettle-dev/kettle-family/releases/tag/v1.3.30
3220
3233
  [1.3.29]: https://github.com/kettle-dev/kettle-family/compare/v1.3.28...v1.3.29
data/README.md CHANGED
@@ -1225,7 +1225,7 @@ Thanks for RTFM. ☺️
1225
1225
  [📌gitmoji]: https://gitmoji.dev
1226
1226
  [📌gitmoji-img]: https://img.shields.io/badge/gitmoji_commits-%20%F0%9F%98%9C%20%F0%9F%98%8D-34495e.svg?style=flat-square
1227
1227
  [🧮kloc]: https://www.youtube.com/watch?v=dQw4w9WgXcQ
1228
- [🧮kloc-img]: https://img.shields.io/badge/KLOC-8.088-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
1228
+ [🧮kloc-img]: https://img.shields.io/badge/KLOC-8.102-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
1229
1229
  [🔐security]: https://github.com/kettle-dev/kettle-family/blob/main/SECURITY.md
1230
1230
  [🔐security-img]: https://img.shields.io/badge/security-policy-259D6C.svg?style=flat
1231
1231
  [📄copyright-notice-explainer]: https://opensource.stackexchange.com/questions/5778/why-do-licenses-such-as-the-mit-license-specify-a-single-year
@@ -272,6 +272,28 @@ module Kettle
272
272
  fetch_path("release", "publish_command") || command_for("release_publish") || "bundle exec kettle-release"
273
273
  end
274
274
 
275
+ # Family-declared pre-release maintenance commands (e.g. template
276
+ # dependency floors and workflow pins). Each entry is a map with `name`
277
+ # (displayed in preflight output) and `command` (run at the family root,
278
+ # raw — no mise exec wrapping). Commands run in declaration order before
279
+ # every other release preflight phase, so maintenance that edits floors
280
+ # or generated files lands before version/state validation. A failing
281
+ # command blocks the release. Tools that write are expected to
282
+ # self-commit; the hook does not commit on their behalf.
283
+ def release_preflight_commands
284
+ entries = fetch_path("release", "preflight_commands") || []
285
+ Array(entries).map do |entry|
286
+ map = entry.is_a?(Hash) ? stringify_keys(entry) : {}
287
+ name = map["name"].to_s
288
+ command = map["command"]
289
+ command = command.map(&:to_s) if command.is_a?(Array)
290
+ command = command.to_s unless command.is_a?(Array)
291
+ next nil if name.empty? || command.empty?
292
+
293
+ {"name" => name, "command" => command}
294
+ end.compact
295
+ end
296
+
275
297
  def release_required_remotes
276
298
  fetch_path("release", "required_remotes")
277
299
  end
@@ -5,7 +5,7 @@ module Kettle
5
5
  # Version namespace for this gem.
6
6
  module Version
7
7
  # Current gem version.
8
- VERSION = "1.3.30"
8
+ VERSION = "1.3.31"
9
9
  end
10
10
  # Current gem version exposed at the traditional constant location.
11
11
  VERSION = Version::VERSION # Traditional Constant Location
@@ -2021,13 +2021,31 @@ module Kettle
2021
2021
  end
2022
2022
 
2023
2023
  def release_preflight_phases
2024
+ maintenance_phase = {label: "pre-release maintenance", method: :release_preflight_maintenance_results} unless config.release_preflight_commands.empty?
2024
2025
  bump_phase = {label: "release version bump", method: :release_preflight_version_bump_results} unless release_state_results.empty?
2025
2026
  dirty_phase = {label: "branch checkout readiness", method: :release_preflight_branch_checkout_dirty_results}
2026
2027
  signing_phase = {label: "gem signing password", method: :release_preflight_signing_password_results}
2027
2028
  secrets_phase = release_secrets_authorization_required? ? {label: "secrets provider authorization", method: :release_preflight_secrets_authorization_results} : nil
2028
2029
  gha_sha_pins_phase = release_gha_sha_pins_review_required? ? {label: "GitHub Actions SHA pins", method: :release_preflight_gha_sha_pins_results} : nil
2029
2030
 
2030
- [bump_phase, secrets_phase, gha_sha_pins_phase, dirty_phase, signing_phase].compact
2031
+ [maintenance_phase, bump_phase, secrets_phase, gha_sha_pins_phase, dirty_phase, signing_phase].compact
2032
+ end
2033
+
2034
+ # Family-declared pre-release maintenance hooks (release.preflight_commands
2035
+ # in the family config): run at the family root in declaration order,
2036
+ # before any other preflight phase, so maintenance that edits floors or
2037
+ # generated files lands before version/state validation. kettle-family
2038
+ # ships only the mechanism — each family declares its own commands.
2039
+ def release_preflight_maintenance_results
2040
+ config.release_preflight_commands.map do |entry|
2041
+ command_runner.call(
2042
+ member: family_member,
2043
+ phase: "release_preflight_command",
2044
+ command: entry.fetch("command"),
2045
+ env: command_env,
2046
+ raw: true
2047
+ )
2048
+ end
2031
2049
  end
2032
2050
 
2033
2051
  def release_preflight_version_bump_results
data.tar.gz.sig CHANGED
Binary file
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: kettle-family
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.3.30
4
+ version: 1.3.31
5
5
  platform: ruby
6
6
  authors:
7
7
  - Peter H. Boling
@@ -568,10 +568,10 @@ licenses:
568
568
  - AGPL-3.0-only
569
569
  metadata:
570
570
  homepage_uri: https://kettle-family.galtzo.com
571
- source_code_uri: https://github.com/kettle-dev/kettle-family/tree/v1.3.30
572
- changelog_uri: https://github.com/kettle-dev/kettle-family/blob/v1.3.30/CHANGELOG.md
571
+ source_code_uri: https://github.com/kettle-dev/kettle-family/tree/v1.3.31
572
+ changelog_uri: https://github.com/kettle-dev/kettle-family/blob/v1.3.31/CHANGELOG.md
573
573
  bug_tracker_uri: https://github.com/kettle-dev/kettle-family/issues
574
- documentation_uri: https://www.rubydoc.info/gems/kettle-family/1.3.30
574
+ documentation_uri: https://www.rubydoc.info/gems/kettle-family/1.3.31
575
575
  funding_uri: https://github.com/sponsors/pboling
576
576
  wiki_uri: https://github.com/kettle-dev/kettle-family/wiki
577
577
  news_uri: https://www.railsbling.com/tags/kettle-family
metadata.gz.sig CHANGED
Binary file