kettle-family 1.3.9 → 1.3.11

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: f74d2fca80b37d1577e7212df092067958426dc780d1e07594b545d057a7321e
4
- data.tar.gz: 23f68c9dd77d68828708ecfea9d64c87af8b12182689e9c9c15e0dfddc6648d5
3
+ metadata.gz: 766a6f829f1947a22fe1b89ac6a58319903dc6687f3d5ac5311d7ebe98f68377
4
+ data.tar.gz: b194b30f4bf64763bbcec96a04c3d26a070733f4a6b75ffe669a9bc32441be91
5
5
  SHA512:
6
- metadata.gz: 327d0135be9e3ee4fb1abea1794d3acf2e714f791b3e83063bb6290a5466ada57b0d49b969f85cbde18050499c34bb57a2334cd7b2a98857f411fe4b015147d9
7
- data.tar.gz: 21892de4191d48f57e7b9183d6a45bbb7d6ef5b3ba1b1a3a4922ba42b39da09ddb0f3d8ba30d3e6c86730a86c876023e405b1d93617896f369916245b6b45718
6
+ metadata.gz: 71cd3fe47420bb10d27af18dbe47374ac085675db49c8e0bca01e01badcaf115ccbe28bb578cf016bcf1b44ddbc51655888633dbc40e238565a6e37981158a78
7
+ data.tar.gz: c8904d6965ff22b847c0411173b2b0dfb25763b98dfeabd9144f2ab4d51a3d89ae81077945fc22a09ae03aab03221c04f8bdea734363eb6327cd0ee0de1bba63
checksums.yaml.gz.sig CHANGED
Binary file
data/CHANGELOG.md CHANGED
@@ -22,6 +22,16 @@ Please file a bug if you notice a violation of semantic versioning.
22
22
 
23
23
  ### Changed
24
24
 
25
+ - [kc] kettle-jem/prepare: updated 8 project files:
26
+ - configuration (1)
27
+ - dependencies (7)
28
+
29
+ - [kc] kettle-jem/template: updated 11 project files:
30
+ - code and tests (1)
31
+ - documentation (1)
32
+ - other (1)
33
+ - workflows (8)
34
+
25
35
  ### Deprecated
26
36
 
27
37
  ### Removed
@@ -30,6 +40,19 @@ Please file a bug if you notice a violation of semantic versioning.
30
40
 
31
41
  ### Security
32
42
 
43
+ ## [1.3.10] - 2026-10-11
44
+
45
+ - TAG: [v1.3.10][1.3.10t]
46
+ - COVERAGE: 93.42% -- 7072/7570 lines in 43 files
47
+ - BRANCH COVERAGE: 77.96% -- 2837/3639 branches in 43 files
48
+ - 35.42% documented
49
+
50
+ ### Fixed
51
+
52
+ - Family release now tapes every child and aggregate event
53
+
54
+ - the release command creates a ReleaseStateEventTape in execute mode and relays command_step, github_release, secret_provider and ci_monitor child events plus aggregate github_release events into it with the member attached; the tape preserves origin event type instead of rewriting it to release_state
55
+
33
56
  ## [1.3.9] - 2026-10-10
34
57
 
35
58
  - TAG: [v1.3.9][1.3.9t]
@@ -2964,7 +2987,9 @@ Please file a bug if you notice a violation of semantic versioning.
2964
2987
  - Fixed CI load failures on engines without compatible `pty` support by falling back to Open3 for interactive release commands.
2965
2988
  - Fixed Ruby 3.2 version-bump support by loading Prism lazily and wiring the Prism gem only for MRI versions that need it.
2966
2989
 
2967
- [Unreleased]: https://github.com/kettle-dev/kettle-family/compare/v1.3.9...HEAD
2990
+ [Unreleased]: https://github.com/kettle-dev/kettle-family/compare/v1.3.10...HEAD
2991
+ [1.3.10]: https://github.com/kettle-dev/kettle-family/compare/v1.3.9...v1.3.10
2992
+ [1.3.10t]: https://github.com/kettle-dev/kettle-family/releases/tag/v1.3.10
2968
2993
  [1.3.9]: https://github.com/kettle-dev/kettle-family/compare/v1.3.7...v1.3.9
2969
2994
  [1.3.9t]: https://github.com/kettle-dev/kettle-family/releases/tag/v1.3.9
2970
2995
  [1.3.7]: https://github.com/kettle-dev/kettle-family/compare/v1.3.6...v1.3.7
data/README.md CHANGED
@@ -90,6 +90,21 @@ The _amazing_ test matrix is powered by the kettle-dev stack.
90
90
 
91
91
  </details>
92
92
 
93
+ ### Runtime and Platform Support
94
+
95
+ Support tiers describe what this project's CI actually exercises, not what may
96
+ work in an untested environment:
97
+
98
+ - **Parallel support**: CI runs the test suite with multiple workers available.
99
+ - **Unsupported**: the engine/platform combination is not covered by CI and is
100
+ not a project compatibility claim.
101
+
102
+ | Ruby engine/version | Linux | macOS | Windows | Notes |
103
+ |---------------------|-------|-------|---------|-------|
104
+ | MRI 4.0-4.0 | Parallel support | Unsupported | Unsupported | Versioned Ruby workflows run on Linux. |
105
+ | MRI current | Parallel support | Parallel support | Unsupported | Current Ruby workflow covers the declared OS platforms. |
106
+ | MRI head | Parallel support | Unsupported | Unsupported | CI is allowed to fail while Ruby is in development. |
107
+
93
108
  ### Federated DVCS
94
109
 
95
110
  <details markdown="1">
@@ -501,6 +516,8 @@ The command names below are available from `kettle-family --help`:
501
516
  | `metadata` | Print member version, Ruby floor, license, and author metadata. |
502
517
  | `check` | Run internal read-only readiness checks. |
503
518
  | `clean-unreleased` | Uninstall locally installed family versions newer than released versions. |
519
+ | `clean-blockers` | Uninstall unreleased gems, from any family, pinned by members' lockfiles — removes cross-family blockers such as an unreleased StructuredMerge gem pinned by a kettle-dev member. |
520
+ | `clean-installed` | The deterministic inverse of `install`: uninstall each selected member's current source version (plus configured install local dependencies) when that version is unreleased, including cached `.gem` files. Sees installed-but-unpinned pollution the other two cleanups miss. |
504
521
  | `reconcile-releases` | Create verified missing GitHub Releases for published tags. |
505
522
  | `reset` | Reset a managed family artifact, such as release lockfiles. |
506
523
  | `test` | Run the configured test workflow for each selected member. |
@@ -751,6 +768,22 @@ The cleanup command compares installed local gem versions with each member's
751
768
  latest released version and uninstalls only versions newer than the release
752
769
  state reports.
753
770
 
771
+ Two companion cleanups cover what `clean-unreleased` cannot see:
772
+
773
+ ```console
774
+ kettle-family clean-blockers --execute
775
+ kettle-family clean-installed --execute
776
+ ```
777
+
778
+ `clean-blockers` targets cross-family pollution: unreleased gems from any
779
+ family whose versions are pinned by members' lockfiles (e.g. an unreleased
780
+ StructuredMerge gem pinned by a kettle-dev member). `clean-installed` is the
781
+ deterministic inverse of `install` — it uninstalls a selected member's own
782
+ current source version, and the local dependencies `install` covers, whenever
783
+ that version is unreleased, including cached `.gem` files. Use it when an
784
+ installed-but-unpinned version survives both other cleanups and breaks gem
785
+ activation with a dangling exact pin.
786
+
754
787
  If a member lockfile has captured local sibling paths or checksum-less gem
755
788
  versions from local development, reset the selected members' `Gemfile.lock`
756
789
  files:
@@ -1192,7 +1225,7 @@ Thanks for RTFM. ☺️
1192
1225
  [📌gitmoji]: https://gitmoji.dev
1193
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
1194
1227
  [🧮kloc]: https://www.youtube.com/watch?v=dQw4w9WgXcQ
1195
- [🧮kloc-img]: https://img.shields.io/badge/KLOC-7.565-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
1228
+ [🧮kloc-img]: https://img.shields.io/badge/KLOC-7.570-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
1196
1229
  [🔐security]: https://github.com/kettle-dev/kettle-family/blob/main/SECURITY.md
1197
1230
  [🔐security-img]: https://img.shields.io/badge/security-policy-259D6C.svg?style=flat
1198
1231
  [📄copyright-notice-explainer]: https://opensource.stackexchange.com/questions/5778/why-do-licenses-such-as-the-mit-license-specify-a-single-year
@@ -781,6 +781,7 @@ module Kettle
781
781
  options: options,
782
782
  start_at: start_at,
783
783
  state_event_handler: state_event_handler,
784
+ state_event_tape: state_event_tape,
784
785
  release_state_results: release_state_results
785
786
  )
786
787
  state_progress&.finish
@@ -807,7 +808,7 @@ module Kettle
807
808
 
808
809
  StartAt = Struct.new(:member, :branch)
809
810
 
810
- def command_results(command:, config:, members:, family_members:, options:, start_at:, state_event_handler: nil, release_state_results: nil)
811
+ def command_results(command:, config:, members:, family_members:, options:, start_at:, state_event_handler: nil, state_event_tape: nil, release_state_results: nil)
811
812
  if branch_target_command?(command, config)
812
813
  return branch_target_command_results(
813
814
  command: command,
@@ -839,6 +840,7 @@ module Kettle
839
840
  options: options,
840
841
  start_at: start_at,
841
842
  state_event_handler: state_event_handler,
843
+ state_event_tape: state_event_tape,
842
844
  release_state_results: release_state_results
843
845
  )
844
846
  end
@@ -879,7 +881,7 @@ module Kettle
879
881
  members
880
882
  end
881
883
 
882
- def command_results_for_current_branch(command:, config:, members:, options:, family_members: members, start_at: StartAt.new(nil, nil), state_event_handler: nil, release_state_results: nil)
884
+ def command_results_for_current_branch(command:, config:, members:, options:, family_members: members, start_at: StartAt.new(nil, nil), state_event_handler: nil, state_event_tape: nil, release_state_results: nil)
883
885
  return mise_trust_results(config: config, members: members) if command == "mise-trust"
884
886
  return bump_version_results(config: config, members: members, options: options, phase: command, release_state_results: release_state_results) if %w[bump bump-version].include?(command)
885
887
  return add_changelog_results(members: members, options: options) if command == "add-changelog"
@@ -935,6 +937,7 @@ module Kettle
935
937
  bex_args: options[:bex_args],
936
938
  start_member: start_at.member,
937
939
  start_branch: start_at.branch,
940
+ event_tape: state_event_tape,
938
941
  release_state_results: release_state_results
939
942
  ).results
940
943
  end
@@ -1398,7 +1401,10 @@ module Kettle
1398
1401
  end
1399
1402
 
1400
1403
  def release_state_event_tape(command:, config:, options:)
1401
- return unless command == "release-state"
1404
+ return unless %w[release release-state].include?(command)
1405
+ # Release event taping requires execute mode: dry-run release has no
1406
+ # child event streams to tape.
1407
+ return if command == "release" && !options[:execute]
1402
1408
 
1403
1409
  tape = ReleaseStateEventTape.new(root: config.root, stream: options[:events] ? stdout : nil)
1404
1410
  stderr.puts("release state event tapes: #{tape.directory}") unless options[:events]
@@ -21,12 +21,15 @@ module Kettle
21
21
  end
22
22
 
23
23
  def call(event)
24
+ # Preserve the origin event type when taping relayed child events
25
+ # (command_step, github_release, ...); emit our own type only for
26
+ # family-level state events that arrive without one.
24
27
  payload = event.merge(
25
28
  "event_version" => 1,
26
- "type" => "release_state",
27
29
  "timestamp" => @wall_clock.call,
28
30
  "elapsed_seconds" => @clock.call - @started_at
29
31
  )
32
+ payload["type"] = "release_state" if payload["type"].to_s.empty?
30
33
  target = target_key(payload)
31
34
  @mutex.synchronize do
32
35
  @sequence_by_member[target] += 1
@@ -297,8 +297,22 @@ module Kettle
297
297
  end
298
298
 
299
299
  def streamed_recommended_fix(result)
300
- line = streamed_output_lines(result).reverse.find { |candidate| candidate.match?(/\ARecommended fix:\s+/) }
301
- line&.sub(/\ARecommended fix:\s+/, "")
300
+ lines = streamed_output_lines(result)
301
+ line = lines.reverse.find { |candidate| candidate.match?(/\ARecommended fix:\s+/) }
302
+ return nil unless line
303
+
304
+ # Some hints are incomplete without their follow-up step (e.g. the
305
+ # kettle-gha-pins pin refresh must be committed + pushed BEFORE
306
+ # re-running the release resume command). Pull the continuation line
307
+ # immediately after the hint into the report so the operator sees the
308
+ # full ordered fix, not just the first command.
309
+ idx = lines.rindex(line)
310
+ follow_up = idx && lines[idx + 1]
311
+ if follow_up && follow_up.match?(/\A(?:Then|After|Next|Once)\b/)
312
+ "#{line.sub(/\ARecommended fix:\s+/, "")}; #{follow_up.sub(/\A\w+ /, "")}"
313
+ else
314
+ line.sub(/\ARecommended fix:\s+/, "")
315
+ end
302
316
  end
303
317
 
304
318
  def streamed_output_lines(result)
@@ -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.9"
8
+ VERSION = "1.3.11"
9
9
  end
10
10
  # Current gem version exposed at the traditional constant location.
11
11
  VERSION = Version::VERSION # Traditional Constant Location
@@ -108,7 +108,7 @@ module Kettle
108
108
  REGISTRY_WAIT_ATTEMPTS = 15
109
109
  REGISTRY_WAIT_INTERVAL_SECONDS = 15
110
110
 
111
- def initialize(command:, config:, members:, family_members: nil, execute: false, accept: true, commit: true, allow_dirty: false, autostash: true, template_cleanup: true, publish: false, push: false, tag: false, start_step: nil, skip_steps: nil, fast_recovery: nil, fast_recovery_members: nil, skip_ci: false, skip_changelog: false, skip_appraisals: false, local_ci: false, continue_ci_failures: false, ci_workflows: nil, skip_bundle_audit: false, skip_remotes: nil, required_remotes: nil, auto_dependency_floors: nil, validate_ci_bundles: nil, gha_sha_pins_upgrade: "patch", gha_sha_pins_check: false, gha_sha_pins_ttl_days: nil, env_overrides: {}, debug: false, verbose: false, gem_signing_password: nil, secrets_provider: nil, jobs: nil, progress_io: nil, reset_target: nil, bup_args: [], bex_args: [], start_member: nil, start_branch: nil, release_state_results: nil, **options)
111
+ def initialize(command:, config:, members:, family_members: nil, execute: false, accept: true, commit: true, allow_dirty: false, autostash: true, template_cleanup: true, publish: false, push: false, tag: false, start_step: nil, skip_steps: nil, fast_recovery: nil, fast_recovery_members: nil, skip_ci: false, skip_changelog: false, skip_appraisals: false, local_ci: false, continue_ci_failures: false, ci_workflows: nil, skip_bundle_audit: false, skip_remotes: nil, required_remotes: nil, auto_dependency_floors: nil, validate_ci_bundles: nil, gha_sha_pins_upgrade: "patch", gha_sha_pins_check: false, gha_sha_pins_ttl_days: nil, env_overrides: {}, debug: false, verbose: false, gem_signing_password: nil, secrets_provider: nil, jobs: nil, progress_io: nil, reset_target: nil, bup_args: [], bex_args: [], start_member: nil, start_branch: nil, release_state_results: nil, event_tape: nil, **options)
112
112
  @command = command
113
113
  @config = config
114
114
  @members = members
@@ -163,6 +163,7 @@ module Kettle
163
163
  @start_member = start_member
164
164
  @start_branch = start_branch
165
165
  @release_state_results = Array(release_state_results)
166
+ @event_tape = event_tape
166
167
  @template_commit_mutex = Mutex.new
167
168
  end
168
169
 
@@ -1349,7 +1350,7 @@ module Kettle
1349
1350
  memo << runner.call(
1350
1351
  member: member,
1351
1352
  phase: "template_bootstrap_dependencies",
1352
- command: %w[bundle update nomono --bundler],
1353
+ command: pinned_bundler_update_command(extra_gems: %w[nomono]),
1353
1354
  env: template_bootstrap_dependency_env(member)
1354
1355
  )
1355
1356
  break memo unless memo.last.ok?
@@ -3919,6 +3920,7 @@ module Kettle
3919
3920
  event = parse_template_event(line)
3920
3921
  next false unless event && event["type"] == "github_release"
3921
3922
 
3923
+ @event_tape&.call(event.merge("member" => member.name))
3922
3924
  emit_template_event_line(member, github_release_event_mark(event), github_release_event_label(event)) if progress_io
3923
3925
  true
3924
3926
  end
@@ -4261,6 +4263,16 @@ module Kettle
4261
4263
  .max
4262
4264
  end
4263
4265
 
4266
+ # A bare `--bundler` lets RubyGems resolve the NEWEST bundler including
4267
+ # prereleases — the recurring 4.1.0.betaN infection vector. Always pin
4268
+ # the update to the newest installed stable bundler.
4269
+ def pinned_bundler_update_command(extra_gems: [])
4270
+ version = stable_bundler_version
4271
+ raise Error, "bundler update requires an installed stable Bundler version" unless version
4272
+
4273
+ ["bundle", "_#{version}_", "update", *extra_gems, "--bundler=#{version}"]
4274
+ end
4275
+
4264
4276
  def bupb_appraisal_results(member:, runner:, memo:)
4265
4277
  return unless File.file?(File.join(member.root, "Appraisal.root.gemfile"))
4266
4278
 
@@ -4843,6 +4855,8 @@ module Kettle
4843
4855
  state[:failed_step] = event["resume_step"].to_i if state && event["resume_step"].to_s.match?(/\A\d+\z/)
4844
4856
  end
4845
4857
 
4858
+ @event_tape&.call(event.merge("member" => member.name))
4859
+
4846
4860
  if progress_io
4847
4861
  if suppress_release_secret_provider_event?(event, progress: progress)
4848
4862
  next true
@@ -5332,7 +5346,7 @@ module Kettle
5332
5346
  recovery = runner.call(
5333
5347
  member: member,
5334
5348
  phase: "#{phase}_bundler_recovery",
5335
- command: %w[bundle update --bundler],
5349
+ command: pinned_bundler_update_command,
5336
5350
  env: env
5337
5351
  )
5338
5352
  memo << recovery
@@ -5712,7 +5726,11 @@ module Kettle
5712
5726
  end
5713
5727
  return false unless spec&.source.is_a?(Bundler::Source::Path)
5714
5728
 
5715
- Paths.same?(spec.source.path.to_s, File.join(template_local_kettle_jem_root, "kettle-jem"))
5729
+ # The lockfile records the source path as the member Gemfile saw it —
5730
+ # often relative ("." for a gemspec-declared self), so expand it
5731
+ # against the member root before comparing with the local checkout.
5732
+ locked_path = File.expand_path(spec.source.path.to_s, member.root)
5733
+ Paths.same?(locked_path, File.join(template_local_kettle_jem_root, "kettle-jem"))
5716
5734
  rescue Bundler::LockfileError, Errno::ENOENT
5717
5735
  false
5718
5736
  end
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.9
4
+ version: 1.3.11
5
5
  platform: ruby
6
6
  authors:
7
7
  - Peter H. Boling
@@ -74,7 +74,7 @@ dependencies:
74
74
  version: '1.0'
75
75
  - - ">="
76
76
  - !ruby/object:Gem::Version
77
- version: 1.0.9
77
+ version: 1.0.10
78
78
  type: :runtime
79
79
  prerelease: false
80
80
  version_requirements: !ruby/object:Gem::Requirement
@@ -84,7 +84,7 @@ dependencies:
84
84
  version: '1.0'
85
85
  - - ">="
86
86
  - !ruby/object:Gem::Version
87
- version: 1.0.9
87
+ version: 1.0.10
88
88
  - !ruby/object:Gem::Dependency
89
89
  name: kettle-dev
90
90
  requirement: !ruby/object:Gem::Requirement
@@ -94,7 +94,7 @@ dependencies:
94
94
  version: '3.1'
95
95
  - - ">="
96
96
  - !ruby/object:Gem::Version
97
- version: 3.1.9
97
+ version: 3.1.13
98
98
  type: :runtime
99
99
  prerelease: false
100
100
  version_requirements: !ruby/object:Gem::Requirement
@@ -104,7 +104,7 @@ dependencies:
104
104
  version: '3.1'
105
105
  - - ">="
106
106
  - !ruby/object:Gem::Version
107
- version: 3.1.9
107
+ version: 3.1.13
108
108
  - !ruby/object:Gem::Dependency
109
109
  name: kettle-gha-pins
110
110
  requirement: !ruby/object:Gem::Requirement
@@ -321,20 +321,20 @@ dependencies:
321
321
  requirements:
322
322
  - - "~>"
323
323
  - !ruby/object:Gem::Version
324
- version: '3.2'
324
+ version: '4.0'
325
325
  - - ">="
326
326
  - !ruby/object:Gem::Version
327
- version: 3.2.14
327
+ version: 4.0.0
328
328
  type: :development
329
329
  prerelease: false
330
330
  version_requirements: !ruby/object:Gem::Requirement
331
331
  requirements:
332
332
  - - "~>"
333
333
  - !ruby/object:Gem::Version
334
- version: '3.2'
334
+ version: '4.0'
335
335
  - - ">="
336
336
  - !ruby/object:Gem::Version
337
- version: 3.2.14
337
+ version: 4.0.0
338
338
  - !ruby/object:Gem::Dependency
339
339
  name: ruby-progressbar
340
340
  requirement: !ruby/object:Gem::Requirement
@@ -485,10 +485,10 @@ licenses:
485
485
  - AGPL-3.0-only
486
486
  metadata:
487
487
  homepage_uri: https://kettle-family.galtzo.com
488
- source_code_uri: https://github.com/kettle-dev/kettle-family/tree/v1.3.9
489
- changelog_uri: https://github.com/kettle-dev/kettle-family/blob/v1.3.9/CHANGELOG.md
488
+ source_code_uri: https://github.com/kettle-dev/kettle-family/tree/v1.3.11
489
+ changelog_uri: https://github.com/kettle-dev/kettle-family/blob/v1.3.11/CHANGELOG.md
490
490
  bug_tracker_uri: https://github.com/kettle-dev/kettle-family/issues
491
- documentation_uri: https://www.rubydoc.info/gems/kettle-family/1.3.9
491
+ documentation_uri: https://www.rubydoc.info/gems/kettle-family/1.3.11
492
492
  funding_uri: https://github.com/sponsors/pboling
493
493
  wiki_uri: https://github.com/kettle-dev/kettle-family/wiki
494
494
  news_uri: https://www.railsbling.com/tags/kettle-family
metadata.gz.sig CHANGED
Binary file