kettle-dev 2.3.4 → 2.3.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f7172c979c02777b2a8844c66fd3af014b2fe18662b898c316859779cdd85f06
-  data.tar.gz: 4c618b9fad44e5745be41022796cea545c45e182b1c372cfffbf94dd5abffcfe
+  metadata.gz: 273f836980d8c8210b2aa13b46a7e8abe3c20890caaff4be48303f807ece69bb
+  data.tar.gz: 2cc93d325d82e8f82af073115f5063d684468dbf15978c5300ce44c1384ae9ab
 SHA512:
-  metadata.gz: 94627c6be29716a603b7b07ebb3d122fb8d41cdee4829838674048e6145c0610b61969e15dacb0c8f592ef20ebcbc25befcc81d47f28fbc7f58ef2e38ea90522
-  data.tar.gz: fc9482cf2a3af6daad305f2ec6341d9649be9aade0329c4d91f4498f3c373ac6af99244ed00abbf218ee1337d220222495e1c8a5200c7d04a900ea2986bd2d33
+  metadata.gz: 891edcb0fde5e40b98f8f221065e5fa283d249700dfb9e216fc8da6668c6dabfc9cf0ba6892b9f202285d03304a31056dc62e5ee6f56a1a760629d971606d07a
+  data.tar.gz: 10de64450794d5b99b0db2b455a8ed05589e18dacafd1299eb6d01546a7ca759dae64739213b4b64dbc2acbf80c0095d39553027496128977de4eab3267a293f

data/CHANGELOG.md

@@ -30,6 +30,50 @@ Please file a bug if you notice a violation of semantic versioning.
 
 ### Security
 
+## [2.3.6] - 2026-07-17
+
+- TAG: [v2.3.6][2.3.6t]
+- COVERAGE: 91.85% -- 4292/4673 lines in 36 files
+- BRANCH COVERAGE: 73.94% -- 1685/2279 branches in 36 files
+- 56.67% documented
+
+### Added
+
+- `kettle-release` now accepts `--ci-workflows` and
+  `K_RELEASE_CI_WORKFLOWS` to monitor an explicit workflow subset at the CI
+  wait step while retaining the default behavior of waiting for all applicable
+  workflows.
+
+### Changed
+
+- kettle-jem-template-20260716-001 - Shim gemspec manifests now include
+  `LICENSE.md` instead of nonexistent `LICENSE.txt`.
+- kettle-jem-template-20260716-002 - Generated gemspec manifests now ship fewer
+  repository-only files by default to reduce downstream distro packaging churn.
+
+### Fixed
+
+- `kettle-release --ci-workflows` now rejects a missing value when the next
+  token is another flag, and the release CI workflow subset APIs now have
+  matching RBS signatures.
+
+## [2.3.5] - 2026-07-16
+
+- TAG: [v2.3.5][2.3.5t]
+- COVERAGE: 92.03% -- 4297/4669 lines in 36 files
+- BRANCH COVERAGE: 74.02% -- 1684/2275 branches in 36 files
+- 56.88% documented
+
+### Changed
+
+- Updated the `kettle-rb` runtime dependency floor to `>= 0.1.2`.
+
+### Fixed
+
+- `kettle-changelog` now honors `K_CHANGELOG_GEM_NAME` before root gemspec
+  discovery, allowing root changelogs for gem families to query live release
+  data without requiring a synthetic root gemspec.
+
 ## [2.3.4] - 2026-07-14
 
 - TAG: [v2.3.4][2.3.4t]
@@ -2479,7 +2523,11 @@ Please file a bug if you notice a violation of semantic versioning.
   - Selecting will run the selected workflow via `act`
   - This may move to its own gem in the future.
 
-[Unreleased]: https://github.com/kettle-dev/kettle-dev/compare/v2.3.4...HEAD
+[Unreleased]: https://github.com/kettle-dev/kettle-dev/compare/v2.3.6...HEAD
+[2.3.6]: https://github.com/kettle-dev/kettle-dev/compare/v2.3.5...v2.3.6
+[2.3.6t]: https://github.com/kettle-dev/kettle-dev/releases/tag/v2.3.6
+[2.3.5]: https://github.com/kettle-dev/kettle-dev/compare/v2.3.4...v2.3.5
+[2.3.5t]: https://github.com/kettle-dev/kettle-dev/releases/tag/v2.3.5
 [2.3.4]: https://github.com/kettle-dev/kettle-dev/compare/v2.3.3...v2.3.4
 [2.3.4t]: https://github.com/kettle-dev/kettle-dev/releases/tag/v2.3.4
 [2.3.3]: https://github.com/kettle-dev/kettle-dev/compare/v2.3.2...v2.3.3
@@ -2730,25 +2778,25 @@ Please file a bug if you notice a violation of semantic versioning.
 [1.0.12t]: https://github.com/kettle-dev/kettle-dev/releases/tag/v1.0.12
 [1.0.11]: https://github.com/kettle-dev/kettle-dev/compare/v1.0.10...v1.0.11
 [1.0.11t]: https://github.com/kettle-dev/kettle-dev/releases/tag/v1.0.11
-[1.0.10]: https://gitlab.com/kettle-rb/kettle-dev/-/compare/v1.0.9...v1.0.10
+[1.0.10]: https://gitlab.com/kettle-dev/kettle-dev/-/compare/v1.0.9...v1.0.10
 [1.0.10t]: https://github.com/kettle-dev/kettle-dev/releases/tag/v1.0.10
-[1.0.9]: https://gitlab.com/kettle-rb/kettle-dev/-/compare/v1.0.8...v1.0.9
+[1.0.9]: https://gitlab.com/kettle-dev/kettle-dev/-/compare/v1.0.8...v1.0.9
 [1.0.9t]: https://github.com/kettle-dev/kettle-dev/releases/tag/v1.0.9
-[1.0.8]: https://gitlab.com/kettle-rb/kettle-dev/-/compare/v1.0.7...v1.0.8
+[1.0.8]: https://gitlab.com/kettle-dev/kettle-dev/-/compare/v1.0.7...v1.0.8
 [1.0.8t]: https://github.com/kettle-dev/kettle-dev/releases/tag/v1.0.8
-[1.0.7]: https://gitlab.com/kettle-rb/kettle-dev/-/compare/v1.0.6...v1.0.7
+[1.0.7]: https://gitlab.com/kettle-dev/kettle-dev/-/compare/v1.0.6...v1.0.7
 [1.0.7t]: https://github.com/kettle-dev/kettle-dev/releases/tag/v1.0.7
-[1.0.6]: https://gitlab.com/kettle-rb/kettle-dev/-/compare/v1.0.5...v1.0.6
+[1.0.6]: https://gitlab.com/kettle-dev/kettle-dev/-/compare/v1.0.5...v1.0.6
 [1.0.6t]: https://github.com/kettle-dev/kettle-dev/releases/tag/v1.0.6
-[1.0.5]: https://gitlab.com/kettle-rb/kettle-dev/-/compare/v1.0.4...v1.0.5
+[1.0.5]: https://gitlab.com/kettle-dev/kettle-dev/-/compare/v1.0.4...v1.0.5
 [1.0.5t]: https://github.com/kettle-dev/kettle-dev/releases/tag/v1.0.5
-[1.0.4]: https://gitlab.com/kettle-rb/kettle-dev/-/compare/v1.0.3...v1.0.4
+[1.0.4]: https://gitlab.com/kettle-dev/kettle-dev/-/compare/v1.0.3...v1.0.4
 [1.0.4t]: https://github.com/kettle-dev/kettle-dev/releases/tag/v1.0.4
-[1.0.3]: https://gitlab.com/kettle-rb/kettle-dev/-/compare/v1.0.2...v1.0.3
+[1.0.3]: https://gitlab.com/kettle-dev/kettle-dev/-/compare/v1.0.2...v1.0.3
 [1.0.3t]: https://github.com/kettle-dev/kettle-dev/releases/tag/v1.0.3
-[1.0.2]: https://gitlab.com/kettle-rb/kettle-dev/-/compare/v1.0.1...v1.0.2
+[1.0.2]: https://gitlab.com/kettle-dev/kettle-dev/-/compare/v1.0.1...v1.0.2
 [1.0.2t]: https://github.com/kettle-dev/kettle-dev/releases/tag/v1.0.2
-[1.0.1]: https://gitlab.com/kettle-rb/kettle-dev/-/compare/v1.0.0...v1.0.1
+[1.0.1]: https://gitlab.com/kettle-dev/kettle-dev/-/compare/v1.0.0...v1.0.1
 [1.0.1t]: https://github.com/kettle-dev/kettle-dev/releases/tag/v1.0.1
 [1.0.0]: https://github.com/kettle-dev/kettle-dev/compare/a427c302df09cfe4253a7c8d400333f9a4c1a208...v1.0.0
 [1.0.0t]: https://github.com/kettle-dev/kettle-dev/releases/tag/v1.0.0

data/README.md

@@ -458,6 +458,11 @@ What it does:
     - `kettle-changelog`
 - Behavior:
     - Reads version from the unique `lib/**/version.rb` in the project.
+    - Reads the gem name from the root `.gemspec`; set
+      `K_CHANGELOG_GEM_NAME` when a root changelog represents a family instead
+      of a single gem checkout.
+    - Set `K_CHANGELOG_VERSION_FILE` when a root changelog should use a specific
+      version file outside the default `lib/**/version.rb` discovery path.
     - Moves entries from the `[Unreleased]` section into a new `[#.#.#] - YYYY-MM-DD` section.
     - Prepends 4 lines with TAG, line coverage, branch coverage, and percent documented.
     - Converts any GitLab-style compare links at the bottom to GitHub style, adds new tag/compare links for the new release and a temporary tag reference `[X.Y.Zt]`.
@@ -882,7 +887,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-4.667-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
+[🧮kloc-img]: https://img.shields.io/badge/KLOC-4.673-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
 [🔐security]: https://github.com/kettle-dev/kettle-dev/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
@@ -908,7 +913,7 @@ Thanks for RTFM. ☺️
 | Field | Value |
 |---|---|
 | Package | kettle-dev |
-| Description | 🍲 Kettle::Dev is a meta tool from kettle-rb to streamline development and testing. Acts as a shim dependency, pulling in many other dependencies, to give you OOTB productivity with a RubyGem, or Ruby app project. Configures a complete set of Rake tasks, for all the libraries is brings in, so they arrive ready to go. Fund overlooked open source projects - bottom of stack, dev/test dependencies: floss-funding.dev |
+| Description | 🍲 Kettle::Dev is a meta tool from kettle-dev to streamline development and testing. Acts as a shim dependency, pulling in many other dependencies, to give you OOTB productivity with a RubyGem, or Ruby app project. Configures a complete set of Rake tasks, for all the libraries is brings in, so they arrive ready to go. Fund overlooked open source projects - bottom of stack, dev/test dependencies: floss-funding.dev |
 | Homepage | https://github.com/kettle-dev/kettle-dev |
 | Source | https://github.com/kettle-dev/kettle-dev |
 | License | `AGPL-3.0-only` |

data/exe/kettle-changelog

@@ -6,6 +6,7 @@
 # kettle-changelog: Generate a CHANGELOG.md entry for the current VERSION.
 # - Reads VERSION from lib/**/version.rb (must be unique across files)
 # - Set K_CHANGELOG_VERSION_FILE to use a specific version.rb for monorepo roots
+# - Set K_CHANGELOG_GEM_NAME to use a specific gem name for root changelogs
 # - Moves entries from the "Unreleased" section into a new versioned section
 # - Prepends 4 heading lines:
 #   - TAG
@@ -80,6 +81,7 @@ if ARGV.include?("-h") || ARGV.include?("--help")
       K_CHANGELOG_STRICT=false              Disable strict mode (equivalent to --no-strict flag)
       K_CHANGELOG_COVERAGE_HARD=false       Disable coverage threshold hard-failure
       K_CHANGELOG_VERSION_FILE=path         Read VERSION from this file instead of lib/**/version.rb
+      K_CHANGELOG_GEM_NAME=name             Read live release data as this gem instead of root .gemspec
 
     Data generation:
       Strict mode is the default. Release plans remove stale coverage output,

data/exe/kettle-release

@@ -43,7 +43,7 @@ end
 # Do not guard with __FILE__ == $PROGRAM_NAME because binstubs use Kernel.load.
 if ARGV.include?("-h") || ARGV.include?("--help")
   puts <<~USAGE
-    Usage: kettle-release [--version VERSION] [--local-ci] [--appraisal-update] [--skip-bundle-audit] [--skip-steps STEPS] [start_step=<0-19>]
+    Usage: kettle-release [--version VERSION] [--local-ci] [--appraisal-update] [--skip-bundle-audit] [--skip-steps STEPS] [--ci-workflows WORKFLOWS] [start_step=<0-19>]
 
     Automates the release flow for a Ruby gem in the host project.
 
@@ -81,6 +81,7 @@ if ARGV.include?("-h") || ARGV.include?("--help")
       --version VERSION           # Use this version instead of detecting VERSION from lib/**/version.rb
       --appraisal-update          # Use slower appraisal:update instead of default appraisal:generate
       --skip-bundle-audit         # Skip bundle:audit/update during release rake checks
+      --ci-workflows WORKFLOWS    # Comma-separated workflow files or stems to monitor at CI step 10
       --local-ci                  # Sensitive release mode: run act locally, publish before any git push,
                                   # create the git tag locally, then push commits and tags after publish
 
@@ -89,6 +90,7 @@ if ARGV.include?("-h") || ARGV.include?("--help")
       GEM_CERT_USER=<user>        # Select certs/<user>.pem for signing
       K_RELEASE_LOCAL_CI=ask|1|0  # Use 'act' locally before push; 'ask' prompts, '1' forces, default off
       K_RELEASE_LOCAL_CI_WORKFLOW # Name of workflow (without .yml) for local CI; defaults to locked_deps or first
+      K_RELEASE_CI_WORKFLOWS      # Comma-separated workflow files or stems to monitor at CI step 10
       KETTLE_RELEASE_APPRAISAL_TASK=appraisal:update
                                   # Use slower appraisal:update instead of default appraisal:generate
       KETTLE_DEV_SKIP_BUNDLE_AUDIT=true
@@ -145,6 +147,27 @@ def extract_skip_steps_arg!(argv)
   skip_steps
 end
 
+def extract_ci_workflows_arg!(argv)
+  workflows = nil
+  if (idx = argv.index("--ci-workflows"))
+    workflows = argv[idx + 1]
+    if workflows.to_s.empty? || workflows.to_s.start_with?("-")
+      Kettle::Dev::ExitAdapter.abort("--ci-workflows requires a comma-separated workflow list")
+    end
+    argv.slice!(idx, 2)
+  end
+  argv.delete_if do |arg|
+    if arg.start_with?("--ci-workflows=", "ci_workflows=")
+      workflows = arg.split("=", 2)[1]
+      Kettle::Dev::ExitAdapter.abort("--ci-workflows requires a comma-separated workflow list") if workflows.to_s.empty?
+      true
+    else
+      false
+    end
+  end
+  workflows
+end
+
 local_ci = ARGV.include?("--local-ci")
 appraisal_task = ARGV.delete("--appraisal-update") ? "appraisal:update" : nil
 skip_bundle_audit = !!ARGV.delete("--skip-bundle-audit")
@@ -152,9 +175,10 @@ start_step_arg = ARGV.find { |a| a.start_with?("start_step=") }
 start_step = start_step_arg ? start_step_arg.split("=", 2)[1].to_i : 0
 version_override = extract_version_arg!(ARGV)
 skip_steps = extract_skip_steps_arg!(ARGV)
+ci_workflows = extract_ci_workflows_arg!(ARGV)
 
 begin
-  Kettle::Dev::ReleaseCLI.new(start_step: start_step, local_ci: local_ci, version: version_override, appraisal_task: appraisal_task, skip_steps: skip_steps, skip_bundle_audit: skip_bundle_audit).run
+  Kettle::Dev::ReleaseCLI.new(start_step: start_step, local_ci: local_ci, version: version_override, appraisal_task: appraisal_task, skip_steps: skip_steps, skip_bundle_audit: skip_bundle_audit, ci_workflows: ci_workflows).run
 rescue LoadError => e
   warn("#{script_basename}: could not load dependency: #{e.class}: #{e.message}")
   warn(Array(e.backtrace).join("\n")) if ENV["DEBUG"]

data/lib/kettle/dev/changelog_cli.rb

@@ -353,6 +353,9 @@ module Kettle
       end
 
       def detect_gem_name
+        env_gem_name = ENV.fetch("K_CHANGELOG_GEM_NAME", "").to_s.strip
+        return env_gem_name unless env_gem_name.empty?
+
         gemspecs = Dir[File.join(@root, "*.gemspec")]
         abort("Could not find a .gemspec in project root.") if gemspecs.empty?
         path = gemspecs.min

data/lib/kettle/dev/ci_monitor.rb

@@ -47,9 +47,9 @@ module Kettle
       #
       # @param restart_hint [String] guidance command shown on failure
       # @return [void]
-      def monitor_all!(restart_hint: "bundle exec kettle-release start_step=10")
+      def monitor_all!(restart_hint: "bundle exec kettle-release start_step=10", workflows: nil, **options)
         checks_any = false
-        checks_any |= monitor_github_internal!(restart_hint: restart_hint)
+        checks_any |= monitor_github_internal!(restart_hint: restart_hint, workflows: workflows)
         checks_any |= monitor_gitlab_internal!(restart_hint: restart_hint)
         abort("CI configuration not detected (GitHub or GitLab). Ensure CI is configured and remotes point to the correct hosts.") unless checks_any
       end
@@ -269,9 +269,9 @@ module Kettle
 
       # -- internals (abort-on-failure legacy paths used elsewhere) --
 
-      def monitor_github_internal!(restart_hint:)
+      def monitor_github_internal!(restart_hint:, workflows: nil)
         root = Kettle::Dev::CIHelpers.project_root
-        workflows = Kettle::Dev::CIHelpers.workflows_list(root)
+        workflows = Array(workflows).empty? ? Kettle::Dev::CIHelpers.workflows_list(root) : Array(workflows)
         gh_remote = preferred_github_remote
         return false unless gh_remote && !workflows.empty?
 

data/lib/kettle/dev/release_cli.rb

@@ -108,12 +108,13 @@ module Kettle
 
       public
 
-      def initialize(start_step: 0, local_ci: false, version: nil, appraisal_task: nil, skip_steps: nil, skip_bundle_audit: nil)
+      def initialize(start_step: 0, local_ci: false, version: nil, appraisal_task: nil, skip_steps: nil, skip_bundle_audit: nil, ci_workflows: nil, **options)
         @root = Kettle::Dev::CIHelpers.project_root
         @git = Kettle::Dev::GitAdapter.new
         @start_step = (start_step || 0).to_i
         @start_step = 0 if @start_step < 0
         @skip_steps = normalize_skip_steps(skip_steps)
+        @ci_workflows = normalize_ci_workflows(ci_workflows || ENV["K_RELEASE_CI_WORKFLOWS"])
         @local_ci = !!local_ci
         @skip_bundle_audit = truthy_value?(skip_bundle_audit) || truthy_value?(ENV["KETTLE_DEV_SKIP_BUNDLE_AUDIT"])
         @version_override = Kettle::Dev::Versioning.normalize_explicit_version(version)
@@ -405,6 +406,11 @@ module Kettle
         end.uniq
       end
 
+      def normalize_ci_workflows(value)
+        workflows = Array(value).flat_map { |part| part.to_s.split(",") }.map(&:strip).reject(&:empty?)
+        workflows.map { |workflow| workflow.match?(/\.ya?ml\z/) ? workflow : "#{workflow}.yml" }.uniq
+      end
+
       private
 
       def local_ci?
@@ -714,7 +720,7 @@ module Kettle
 
       def monitor_workflows_after_push!
         # Use abort-on-failure CI monitor to match historical behavior and specs
-        Kettle::Dev::CIMonitor.monitor_all!(restart_hint: "bundle exec kettle-release start_step=10")
+        Kettle::Dev::CIMonitor.monitor_all!(restart_hint: "bundle exec kettle-release start_step=10", workflows: @ci_workflows)
       end
 
       def run_cmd!(cmd)

data/lib/kettle/dev/version.rb

@@ -3,7 +3,7 @@
 module Kettle
   module Dev
     module Version
-      VERSION = "2.3.4"
+      VERSION = "2.3.6"
     end
     VERSION = Version::VERSION # Traditional Constant Location
   end