kettle-dev 1.0.7 → 1.0.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 757457767d7c4dce99cfbb226f4c8a2a0f94b9a9aadd601b55f21c48a53cda30
-  data.tar.gz: e06421edd27c37161d6438f47809828914b2abd6c1b09722d0f7154eaacf078c
+  metadata.gz: 32a4bff14544feed4dc60644fe0bb8d0ed1a76cb1f49c0144c8f9748e23ea993
+  data.tar.gz: d574fb5dc72da3caf7ee83f64fb064606930d33df23ff6f9a6a907692a21fbe8
 SHA512:
-  metadata.gz: 16c04f9745823ca90d1c22e0e471942fc81469fc8022cb6bdf3c064eee5c1f656d077e54ea283906f117d31f0101daf3057f18d7ef472c4373bbe1441c4b4672
-  data.tar.gz: 4a6ca6d6fe40cd1c694d73b6527e62d4dc44f97fe72a9b41a796f920b8a1c42a78e2c49f2040dae22d5c277b545b356a592f1ee54c1e28fca4ff6173a4ed1c78
+  metadata.gz: f68fef35d7bd888e0132e68e27cfcf31f18ba6098ecbccebeadab0cb4154f1fd12ce32fdce828a5699a18362893059ea4302224084a7446fb90b7a12aaee00b5
+  data.tar.gz: ac0dea1fca1ea03add3375fa9f8b884f5b57394d45db39c1b00caebe8bcb33f79a66b9d88ef020a4edc3b19d4630086625fda371522953a48f1f38c5994307af

data/.github/workflows/ancient.yml

@@ -4,12 +4,10 @@ on:
   push:
     branches:
       - 'main'
+      - "*-stable"
     tags:
       - '!*' # Do not execute on tags
   pull_request:
-    # types specification prevents double build on push & pull request
-    # See: https://github.com/Shopify/ruby-style-guide/pull/235#issuecomment-777623642
-    types: [opened, synchronize]
     branches:
       - '*'
   # Allow manually triggering the workflow.
@@ -23,7 +21,7 @@ concurrency:
 
 jobs:
   test:
-    if: (github.event_name == 'push' || github.event.pull_request.head.repo.owner.login != 'kettle-rb') && !contains(github.event.commits[0].message, '[ci skip]') && !contains(github.event.commits[0].message, '[skip ci]')
+    if: "!contains(github.event.commits[0].message, '[ci skip]') && !contains(github.event.commits[0].message, '[skip ci]')"
     name: Specs ${{ matrix.ruby }} ${{ matrix.appraisal }}${{ matrix.name_extra || '' }}
     runs-on: ubuntu-22.04
     continue-on-error: ${{ matrix.experimental || endsWith(matrix.ruby, 'head') }}

data/.github/workflows/coverage.yml

@@ -19,12 +19,10 @@ on:
   push:
     branches:
       - 'main'
+      - "*-stable"
     tags:
       - '!*' # Do not execute on tags
   pull_request:
-    # types specification prevents double build on push & pull request
-    # See: https://github.com/Shopify/ruby-style-guide/pull/235#issuecomment-777623642
-    types: [opened, synchronize]
     branches:
       - '*'
   # Allow manually triggering the workflow.
@@ -38,7 +36,7 @@ concurrency:
 
 jobs:
   coverage:
-    if: (github.event_name == 'push' || github.event.pull_request.head.repo.owner.login != 'kettle-rb') && !contains(github.event.commits[0].message, '[ci skip]') && !contains(github.event.commits[0].message, '[skip ci]')
+    if: "!contains(github.event.commits[0].message, '[ci skip]') && !contains(github.event.commits[0].message, '[skip ci]')"
     name: Code Coverage on ${{ matrix.ruby }}@current
     runs-on: ubuntu-latest
     continue-on-error: ${{ matrix.experimental || endsWith(matrix.ruby, 'head') }}

data/.github/workflows/current.yml

@@ -8,12 +8,10 @@ on:
   push:
     branches:
       - 'main'
+      - "*-stable"
     tags:
       - '!*' # Do not execute on tags
   pull_request:
-    # types specification prevents double build on push & pull request
-    # See: https://github.com/Shopify/ruby-style-guide/pull/235#issuecomment-777623642
-    types: [opened, synchronize]
     branches:
       - '*'
   # Allow manually triggering the workflow.
@@ -30,7 +28,7 @@ concurrency:
 
 jobs:
   test:
-    if: (github.event_name == 'push' || github.event.pull_request.head.repo.owner.login != 'kettle-rb') && !contains(github.event.commits[0].message, '[ci skip]') && !contains(github.event.commits[0].message, '[skip ci]')
+    if: "!contains(github.event.commits[0].message, '[ci skip]') && !contains(github.event.commits[0].message, '[skip ci]')"
     name: Specs ${{ matrix.ruby }}@${{ matrix.appraisal }}
     runs-on: ubuntu-latest
     continue-on-error: ${{ matrix.experimental || endsWith(matrix.ruby, 'head') }}

data/.github/workflows/heads.yml

@@ -7,12 +7,10 @@ on:
   push:
     branches:
       - 'main'
+      - "*-stable"
     tags:
       - '!*' # Do not execute on tags
   pull_request:
-    # types specification prevents double build on push & pull request
-    # See: https://github.com/Shopify/ruby-style-guide/pull/235#issuecomment-777623642
-    types: [opened, synchronize]
     branches:
       - '*'
   # Allow manually triggering the workflow.
@@ -29,7 +27,7 @@ concurrency:
 
 jobs:
   test:
-    if: (github.event_name == 'push' || github.event.pull_request.head.repo.owner.login != 'kettle-rb') && !contains(github.event.commits[0].message, '[ci skip]') && !contains(github.event.commits[0].message, '[skip ci]')
+    if: "!contains(github.event.commits[0].message, '[ci skip]') && !contains(github.event.commits[0].message, '[skip ci]')"
     name: Specs ${{ matrix.ruby }}@${{ matrix.appraisal }}${{ matrix.name_extra || '' }}
     runs-on: ubuntu-latest
     continue-on-error: ${{ matrix.experimental || endsWith(matrix.ruby, 'head') }}

data/.github/workflows/jruby.yml

@@ -7,12 +7,10 @@ on:
   push:
     branches:
       - 'main'
+      - "*-stable"
     tags:
       - '!*' # Do not execute on tags
   pull_request:
-    # types specification prevents double build on push & pull request
-    # See: https://github.com/Shopify/ruby-style-guide/pull/235#issuecomment-777623642
-    types: [opened, synchronize]
     branches:
       - '*'
   # Allow manually triggering the workflow.
@@ -29,7 +27,7 @@ concurrency:
 
 jobs:
   test:
-    if: (github.event_name == 'push' || github.event.pull_request.head.repo.owner.login != 'kettle-rb') && !contains(github.event.commits[0].message, '[ci skip]') && !contains(github.event.commits[0].message, '[skip ci]')
+    if: "!contains(github.event.commits[0].message, '[ci skip]') && !contains(github.event.commits[0].message, '[skip ci]')"
     name: Specs ${{ matrix.ruby }} ${{ matrix.appraisal }}${{ matrix.name_extra || '' }}
     runs-on: ubuntu-22.04
     continue-on-error: ${{ matrix.experimental || endsWith(matrix.ruby, 'head') }}

data/.github/workflows/legacy.yml

@@ -7,12 +7,10 @@ on:
   push:
     branches:
       - 'main'
+      - "*-stable"
     tags:
       - '!*' # Do not execute on tags
   pull_request:
-    # types specification prevents double build on push & pull request
-    # See: https://github.com/Shopify/ruby-style-guide/pull/235#issuecomment-777623642
-    types: [opened, synchronize]
     branches:
       - '*'
   # Allow manually triggering the workflow.
@@ -29,7 +27,7 @@ concurrency:
 
 jobs:
   test:
-    if: (github.event_name == 'push' || github.event.pull_request.head.repo.owner.login != 'kettle-rb') && !contains(github.event.commits[0].message, '[ci skip]') && !contains(github.event.commits[0].message, '[skip ci]')
+    if: "!contains(github.event.commits[0].message, '[ci skip]') && !contains(github.event.commits[0].message, '[skip ci]')"
     name: Specs ${{ matrix.ruby }} ${{ matrix.appraisal }}${{ matrix.name_extra || '' }}
     runs-on: ubuntu-22.04
     continue-on-error: ${{ matrix.experimental || endsWith(matrix.ruby, 'head') }}

data/.github/workflows/locked_deps.yml

@@ -41,9 +41,6 @@ on:
     tags:
       - '!*' # Do not execute on tags
   pull_request:
-    # types specification prevents double build on push & pull request
-    # See: https://github.com/Shopify/ruby-style-guide/pull/235#issuecomment-777623642
-    types: [opened, synchronize]
     branches:
       - '*'
   # Allow manually triggering the workflow.
@@ -57,7 +54,7 @@ concurrency:
 
 jobs:
   test:
-    if: (github.event_name == 'push' || github.event.pull_request.head.repo.owner.login != 'kettle-rb') && !contains(github.event.commits[0].message, '[ci skip]') && !contains(github.event.commits[0].message, '[skip ci]')
+    if: "!contains(github.event.commits[0].message, '[ci skip]') && !contains(github.event.commits[0].message, '[skip ci]')"
     name: Default rake task w/ main Gemfile.lock ${{ matrix.name_extra || '' }}
     runs-on: ubuntu-latest
     continue-on-error: ${{ matrix.experimental }}

data/.github/workflows/style.yml

@@ -4,12 +4,10 @@ on:
   push:
     branches:
       - 'main'
+      - "*-stable"
     tags:
       - '!*' # Do not execute on tags
   pull_request:
-    # types specification prevents double build on push & pull request
-    # See: https://github.com/Shopify/ruby-style-guide/pull/235#issuecomment-777623642
-    types: [opened, synchronize]
     branches:
       - '*'
   # Allow manually triggering the workflow.
@@ -26,7 +24,7 @@ concurrency:
 
 jobs:
   rubocop:
-    if: (github.event_name == 'push' || github.event.pull_request.head.repo.owner.login != 'kettle-rb') && !contains(github.event.commits[0].message, '[ci skip]') && !contains(github.event.commits[0].message, '[skip ci]')
+    if: "!contains(github.event.commits[0].message, '[ci skip]') && !contains(github.event.commits[0].message, '[skip ci]')"
     name: Style on ${{ matrix.ruby }}@current
     runs-on: ubuntu-latest
     continue-on-error: ${{ matrix.experimental || endsWith(matrix.ruby, 'head') }}

data/.github/workflows/supported.yml

@@ -7,12 +7,10 @@ on:
   push:
     branches:
       - 'main'
+      - "*-stable"
     tags:
       - '!*' # Do not execute on tags
   pull_request:
-    # types specification prevents double build on push & pull request
-    # See: https://github.com/Shopify/ruby-style-guide/pull/235#issuecomment-777623642
-    types: [opened, synchronize]
     branches:
       - '*'
   # Allow manually triggering the workflow.
@@ -29,7 +27,7 @@ concurrency:
 
 jobs:
   test:
-    if: (github.event_name == 'push' || github.event.pull_request.head.repo.owner.login != 'kettle-rb') && !contains(github.event.commits[0].message, '[ci skip]') && !contains(github.event.commits[0].message, '[skip ci]')
+    if: "!contains(github.event.commits[0].message, '[ci skip]') && !contains(github.event.commits[0].message, '[skip ci]')"
     name: Specs ${{ matrix.ruby }} ${{ matrix.appraisal }}${{ matrix.name_extra || '' }}
     runs-on: ubuntu-latest
     continue-on-error: ${{ matrix.experimental || endsWith(matrix.ruby, 'head') }}

data/.github/workflows/truffle.yml

@@ -7,12 +7,10 @@ on:
   push:
     branches:
       - 'main'
+      - "*-stable"
     tags:
       - '!*' # Do not execute on tags
   pull_request:
-    # types specification prevents double build on push & pull request
-    # See: https://github.com/Shopify/ruby-style-guide/pull/235#issuecomment-777623642
-    types: [opened, synchronize]
     branches:
       - '*'
   # Allow manually triggering the workflow.
@@ -29,7 +27,7 @@ concurrency:
 
 jobs:
   test:
-    if: (github.event_name == 'push' || github.event.pull_request.head.repo.owner.login != 'kettle-rb') && !contains(github.event.commits[0].message, '[ci skip]') && !contains(github.event.commits[0].message, '[skip ci]')
+    if: "!contains(github.event.commits[0].message, '[ci skip]') && !contains(github.event.commits[0].message, '[skip ci]')"
     name: Specs ${{ matrix.ruby }} ${{ matrix.appraisal }}${{ matrix.name_extra || '' }}
     runs-on: ubuntu-22.04
     continue-on-error: ${{ matrix.experimental || endsWith(matrix.ruby, 'head') }}

data/.github/workflows/unlocked_deps.yml

@@ -31,9 +31,6 @@ on:
     tags:
       - '!*' # Do not execute on tags
   pull_request:
-    # types specification prevents double build on push & pull request
-    # See: https://github.com/Shopify/ruby-style-guide/pull/235#issuecomment-777623642
-    types: [opened, synchronize]
     branches:
       - '*'
   # Allow manually triggering the workflow.
@@ -47,7 +44,7 @@ concurrency:
 
 jobs:
   test:
-    if: (github.event_name == 'push' || github.event.pull_request.head.repo.owner.login != 'kettle-rb') && !contains(github.event.commits[0].message, '[ci skip]') && !contains(github.event.commits[0].message, '[skip ci]')
+    if: "!contains(github.event.commits[0].message, '[ci skip]') && !contains(github.event.commits[0].message, '[skip ci]')"
     name: Default rake task w/ unlocked deps ${{ matrix.name_extra || '' }}
     runs-on: ubuntu-latest
     continue-on-error: ${{ matrix.experimental || endsWith(matrix.ruby, 'head') }}

data/.github/workflows/unsupported.yml

@@ -7,12 +7,10 @@ on:
   push:
     branches:
       - 'main'
+      - "*-stable"
     tags:
       - '!*' # Do not execute on tags
   pull_request:
-    # types specification prevents double build on push & pull request
-    # See: https://github.com/Shopify/ruby-style-guide/pull/235#issuecomment-777623642
-    types: [opened, synchronize]
     branches:
       - '*'
   # Allow manually triggering the workflow.
@@ -29,7 +27,7 @@ concurrency:
 
 jobs:
   test:
-    if: (github.event_name == 'push' || github.event.pull_request.head.repo.owner.login != 'kettle-rb') && !contains(github.event.commits[0].message, '[ci skip]') && !contains(github.event.commits[0].message, '[skip ci]')
+    if: "!contains(github.event.commits[0].message, '[ci skip]') && !contains(github.event.commits[0].message, '[skip ci]')"
     name: Specs ${{ matrix.ruby }} ${{ matrix.appraisal }}${{ matrix.name_extra || '' }}
     runs-on: ubuntu-22.04
     continue-on-error: ${{ matrix.experimental || endsWith(matrix.ruby, 'head') }}

data/CHANGELOG.md

@@ -1,8 +1,20 @@
 # Changelog
+
+[![SemVer 2.0.0][📌semver-img]][📌semver] [![Keep-A-Changelog 1.0.0][📗keep-changelog-img]][📗keep-changelog]
+
 All notable changes to this project will be documented in this file.
 
-The format is based on [Keep a Changelog v1](https://keepachangelog.com/en/1.0.0/),
-and this project adheres to [Semantic Versioning v2](https://semver.org/spec/v2.0.0.html).
+The format is based on [Keep a Changelog][📗keep-changelog],
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html),
+and [yes][📌major-versions-not-sacred], platform and engine support are part of the [public API][📌semver-breaking].
+Please file a bug if you notice a violation of semantic versioning.
+
+[📌semver]: https://semver.org/spec/v2.0.0.html
+[📌semver-img]: https://img.shields.io/badge/semver-2.0.0-FFDD67.svg?style=flat
+[📌semver-breaking]: https://github.com/semver/semver/issues/716#issuecomment-869336139
+[📌major-versions-not-sacred]: https://tom.preston-werner.com/2022/05/23/major-version-numbers-are-not-sacred.html
+[📗keep-changelog]: https://keepachangelog.com/en/1.0.0/
+[📗keep-changelog-img]: https://img.shields.io/badge/keep--a--changelog-1.0.0-FFDD67.svg?style=flat
 
 ## [Unreleased]
 ### Added
@@ -12,6 +24,26 @@ and this project adheres to [Semantic Versioning v2](https://semver.org/spec/v2.
 ### Fixed
 ### Security
 
+## [1.0.9] - 2025-08-24
+- TAG: [v1.0.9][1.0.9t]
+- COVERAGE: 100.00% -- 130/130 lines in 7 files
+- BRANCH COVERAGE:  96.00% -- 48/50 branches in 7 files
+- 95.35% documented
+### Added
+- kettle-release: Add a sanity check for the latest released version of the gem being released, and display it during the confirmation with user that CHANGELOG.md and version.rb have been updated, so they can compare the value in version.rb with the value of the latest released version.
+    - If the value in version.rb is less than the latest released version's major or minor, then check for the latest released version that matches the major + minor of what is in version.rb.
+    - This way a stable branch intended to release patch updates to older versions is able to work use the script.
+- kettle-release: optional pre-push local CI run using `act`, controlled by env var `K_RELEASE_LOCAL_CI` ("true" to run, "ask" to prompt) and `K_RELEASE_LOCAL_CI_WORKFLOW` to choose a workflow; defaults to `locked_deps.yml` when present; on failure, soft-resets the release prep commit and aborts.
+- template task: now copies `certs/pboling.pem` into the host project when available.
+
+## [1.0.8] - 2025-08-24
+- TAG: [v1.0.8][1.0.8t]
+- COVERAGE: 100.00% -- 130/130 lines in 7 files
+- BRANCH COVERAGE:  96.00% -- 48/50 branches in 7 files
+- 95.35% documented
+### Fixed
+- Can't add checksums to the gem package, because it changes the checksum (duh!)
+
 ## [1.0.7] - 2025-08-24
 - TAG: [v1.0.7][1.0.7t]
 - COVERAGE: 100.00% -- 130/130 lines in 7 files
@@ -108,7 +140,11 @@ and this project adheres to [Semantic Versioning v2](https://semver.org/spec/v2.
   - Selecting will run the selected workflow via `act`
   - This may move to its own gem in the future.
 
-[Unreleased]: https://gitlab.com/kettle-rb/kettle-dev/-/compare/v1.0.7...HEAD
+[Unreleased]: https://gitlab.com/kettle-rb/kettle-dev/-/compare/v1.0.9...HEAD
+[1.0.9]: https://gitlab.com/kettle-rb/kettle-dev/-/compare/v1.0.8...v1.0.9
+[1.0.9t]: https://gitlab.com/kettle-rb/kettle-dev/-/tags/v1.0.9
+[1.0.8]: https://gitlab.com/kettle-rb/kettle-dev/-/compare/v1.0.7...v1.0.8
+[1.0.8t]: https://gitlab.com/kettle-rb/kettle-dev/-/tags/v1.0.8
 [1.0.7]: https://gitlab.com/kettle-rb/kettle-dev/-/compare/v1.0.6...v1.0.7
 [1.0.7t]: https://gitlab.com/kettle-rb/kettle-dev/-/tags/v1.0.7
 [1.0.6]: https://gitlab.com/kettle-rb/kettle-dev/-/compare/v1.0.5...v1.0.6

data/CHANGELOG.md.example

@@ -0,0 +1,47 @@
+# Changelog
+
+[![SemVer 2.0.0][📌semver-img]][📌semver] [![Keep-A-Changelog 1.0.0][📗keep-changelog-img]][📗keep-changelog]
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog][📗keep-changelog],
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html),
+and [yes][📌major-versions-not-sacred], platform and engine support are part of the [public API][📌semver-breaking].
+Please file a bug if you notice a violation of semantic versioning.
+
+[📌semver]: https://semver.org/spec/v2.0.0.html
+[📌semver-img]: https://img.shields.io/badge/semver-2.0.0-FFDD67.svg?style=flat
+[📌semver-breaking]: https://github.com/semver/semver/issues/716#issuecomment-869336139
+[📌major-versions-not-sacred]: https://tom.preston-werner.com/2022/05/23/major-version-numbers-are-not-sacred.html
+[📗keep-changelog]: https://keepachangelog.com/en/1.0.0/
+[📗keep-changelog-img]: https://img.shields.io/badge/keep--a--changelog-1.0.0-FFDD67.svg?style=flat
+
+## [Unreleased]
+### Added
+### Changed
+### Deprecated
+### Removed
+### Fixed
+### Security
+
+## [1.0.1] - 2025-08-24
+- TAG: [v1.0.1][1.0.1t]
+- COVERAGE: 100.00% -- 130/130 lines in 7 files
+- BRANCH COVERAGE:  96.00% -- 48/50 branches in 7 files
+- 100% documented
+### Fixed
+- bugfix: oopsie
+
+## [1.0.0] - 2025-08-24
+- TAG: [v1.0.0][1.0.0t]
+- COVERAGE: 100.00% -- 130/130 lines in 7 files
+- BRANCH COVERAGE:  96.00% -- 48/50 branches in 7 files
+- 100% documented
+### Added
+- Initial release
+
+[Unreleased]: https://gitlab.com/kettle-rb/kettle-dev/-/compare/v1.0.0...HEAD
+[1.0.1]: https://gitlab.com/kettle-rb/kettle-dev/-/compare/v1.0.0...v1.0.1
+[1.0.1t]: https://gitlab.com/kettle-rb/kettle-dev/-/tags/v1.0.1
+[1.0.0]: https://gitlab.com/kettle-rb/kettle-dev/-/compare/a427c302df09cfe4253a7c8d400333f9a4c1a208...v1.0.0
+[1.0.0t]: https://gitlab.com/kettle-rb/kettle-dev/-/tags/v1.0.0

data/README.md

@@ -231,6 +231,7 @@ GitHub Actions local runner helper
 Project automation bootstrap
 - `bundle exec rake kettle:dev:install` — copies the library’s `.github` folder into your project and offers to install `.git-hooks` templates locally or globally.
 - `bundle exec rake kettle:dev:template` — runs only the templating step used by install; useful to re-apply updates to templates (.github workflows, .devcontainer, .qlty, modular Gemfiles, README, and friends) without the `install` task’s extra prompts.
+  - Also copies maintainer certificate `certs/pboling.pem` into your project when present (used for signed gem builds).
   - README carry-over during templating: when your project’s README.md is replaced by the template, selected sections from your existing README are preserved and merged into the new one. Specifically, the task carries over the following sections (matched case-insensitively):
     - "Synopsis"
     - "Configuration"
@@ -249,6 +250,10 @@ Project automation bootstrap
 Releasing (maintainers)
 - `exe/kettle-release` — guided release helper that:
   - Runs sanity checks (`bin/setup`, `bin/rake`), confirms version/changelog, optionally updates Appraisals, commits “🔖 Prepare release vX.Y.Z”.
+  - Optionally runs your CI locally with `act` before any push:
+    - Enable with env: `K_RELEASE_LOCAL_CI="true"` (run automatically) or `K_RELEASE_LOCAL_CI="ask"` (prompt [Y/n]).
+    - Select workflow with `K_RELEASE_LOCAL_CI_WORKFLOW` (with or without .yml/.yaml). Defaults to `locked_deps.yml` if present; otherwise the first workflow discovered.
+    - On failure, the release prep commit is soft-rolled-back (`git reset --soft HEAD^`) and the process aborts.
   - Ensures trunk sync and rebases feature as needed, pushes, monitors GitHub Actions with a progress bar, and merges feature to trunk on success.
   - Exports `SOURCE_DATE_EPOCH`, builds (optionally signed), creates gem checksums, and runs `bundle exec rake release` (prompts for signing key + RubyGems MFA OTP as needed).
 

data/Rakefile

@@ -1,22 +1,8 @@
 # frozen_string_literal: true
 
-# Galtzo FLOSS Rakefile v1.0.11 - 2025-08-19
+# kettle-dev Rakefile v1.0.0 - 2025-08-23
 # Ruby 2.3 (Safe Navigation) or higher required
 #
-# CHANGELOG
-# v1.0.0 - initial release w/ support for rspec, minitest, rubocop, reek, yard, and stone_checksums
-# v1.0.1 - fix test / spec tasks running 2x
-# v1.0.2 - fix duplicate task warning from RuboCop
-# v1.0.3 - add bench tasks to run mini benchmarks (add scripts to /benchmarks)
-# v1.0.4 - add support for floss_funding:install
-# v1.0.5 - add support for halting in Rake tasks with binding.b (from debug gem)
-# v1.0.6 - add RBS files and checksums to YARD-generated docs site
-# v1.0.7 - works with vanilla ruby, non-gem, bundler-managed, projects
-# v1.0.8 - improved Dir globs, add back and document rbconfig dependency
-# v1.0.9 - add appraisal:update task to update Appraisal gemfiles and autocorrect with RuboCop Gradual
-# v1.0.10 - add ci:act to run GHA workflows locally, and get status of remote workflows
-# v1.0.11 - ci:act workflows are populated entirely dynamically, based on existing files
-#
 # MIT License (see License.txt)
 #
 # Copyright (c) 2025 Peter H. Boling (galtzo.com)
@@ -25,34 +11,41 @@
 #
 # Sets up tasks for appraisal, floss_funding, rspec, minitest, rubocop, reek, yard, and stone_checksums.
 #
-# rake appraisal:update                 # Update Appraisal gemfiles and run RuboCop Gradual autocorrect
-# rake bench                            # Run all benchmarks (alias for bench:run)
-# rake bench:list                       # List available benchmark scripts
-# rake bench:run                        # Run all benchmark scripts (skips on CI)
-# rake build                            # Build gitmoji-regex-1.0.2.gem into the pkg directory
-# rake build:checksum                   # Generate SHA512 checksum of gitmoji-regex-1.0.2.gem into the checksums directory
-# rake build:generate_checksums         # Generate both SHA256 & SHA512 checksums into the checksums directory, and git...
-# rake bundle:audit:check               # Checks the Gemfile.lock for insecure dependencies
-# rake bundle:audit:update              # Updates the bundler-audit vulnerability database
-# rake ci:act[opt]                      # Run 'act' with a selected workflow
-# rake clean                            # Remove any temporary products
-# rake clobber                          # Remove any generated files
-# rake coverage                         # Run specs w/ coverage and open results in browser
-# rake floss_funding:install            # (stub) floss_funding is unavailable
-# rake install                          # Build and install gitmoji-regex-1.0.2.gem into system gems
-# rake install:local                    # Build and install gitmoji-regex-1.0.2.gem into system gems without network ac...
-# rake reek                             # Check for code smells
-# rake reek:update                      # Run reek and store the output into the REEK file
-# rake release[remote]                  # Create tag v1.0.2 and build and push gitmoji-regex-1.0.2.gem to rubygems.org
-# rake rubocop                          # alias rubocop task to rubocop_gradual
-# rake rubocop_gradual                  # Run RuboCop Gradual
-# rake rubocop_gradual:autocorrect      # Run RuboCop Gradual with autocorrect (only when it's safe)
-# rake rubocop_gradual:autocorrect_all  # Run RuboCop Gradual with autocorrect (safe and unsafe)
-# rake rubocop_gradual:check            # Run RuboCop Gradual to check the lock file
-# rake rubocop_gradual:force_update     # Run RuboCop Gradual to force update the lock file
-# rake spec                             # Run RSpec code examples
-# rake test                             # Run tests
-# rake yard                             # Generate YARD Documentation
+# rake appraisal:update                       # Update Appraisal gemfiles and run RuboCop...
+# rake bench                                  # Run all benchmarks (alias for bench:run)
+# rake bench:list                             # List available benchmark scripts
+# rake bench:run                              # Run all benchmark scripts (skips on CI)
+# rake build                                  # Build kettle-dev-1.0.0.gem into the pkg d...
+# rake build:checksum                         # Generate SHA512 checksum of kettle-dev-1....
+# rake build:generate_checksums               # Generate both SHA256 & SHA512 checksums i...
+# rake bundle:audit:check                     # Checks the Gemfile.lock for insecure depe...
+# rake bundle:audit:update                    # Updates the bundler-audit vulnerability d...
+# rake ci:act[opt]                            # Run 'act' with a selected workflow
+# rake clean                                  # Remove any temporary products
+# rake clobber                                # Remove any generated files
+# rake coverage                               # Run specs w/ coverage and open results in...
+# rake default                                # Default tasks aggregator
+# rake install                                # Build and install kettle-dev-1.0.0.gem in...
+# rake install:local                          # Build and install kettle-dev-1.0.0.gem in...
+# rake kettle:dev:install                     # Install kettle-dev GitHub automation and ...
+# rake kettle:dev:template                    # Template kettle-dev files into the curren...
+# rake reek                                   # Check for code smells
+# rake reek:update                            # Run reek and store the output into the RE...
+# rake release[remote]                        # Create tag v1.0.0 and build and push kett...
+# rake rubocop_gradual                        # Run RuboCop Gradual
+# rake rubocop_gradual:autocorrect            # Run RuboCop Gradual with autocorrect (onl...
+# rake rubocop_gradual:autocorrect_all        # Run RuboCop Gradual with autocorrect (saf...
+# rake rubocop_gradual:check                  # Run RuboCop Gradual to check the lock file
+# rake rubocop_gradual:force_update           # Run RuboCop Gradual to force update the l...
+# rake rubocop_gradual_debug                  # Run RuboCop Gradual
+# rake rubocop_gradual_debug:autocorrect      # Run RuboCop Gradual with autocorrect (onl...
+# rake rubocop_gradual_debug:autocorrect_all  # Run RuboCop Gradual with autocorrect (saf...
+# rake rubocop_gradual_debug:check            # Run RuboCop Gradual to check the lock file
+# rake rubocop_gradual_debug:force_update     # Run RuboCop Gradual to force update the l...
+# rake spec                                   # Run RSpec code examples
+# rake test                                   # Run tests
+# rake yard                                   # Generate YARD Documentation
+#
 
 # External gems
 require "bundler/gem_tasks" if !Dir[File.join(__dir__, "*.gemspec")].empty?

data/exe/kettle-commit-msg

@@ -1,10 +1,12 @@
 #!/usr/bin/env ruby
 # vim: set syntax=ruby
 
-ENV["BUNDLE_GEMFILE"] ||= File.expand_path("../Gemfile", __dir__)
-
 require "rubygems"
-require "bundler/setup"
+begin
+  require "bundler/setup"
+rescue LoadError
+  # Allow running outside of Bundler; runtime deps should still be available via rubygems
+end
 
 # Standard library
 require "erb"
@@ -51,7 +53,7 @@ class GitCommitFooter
   NAME_ASSIGNMENT_REGEX = /\bname\s*=\s*(["'])([^"']+)\1/.freeze
   FOOTER_APPEND = ENV.fetch("GIT_HOOK_FOOTER_APPEND", "false").casecmp("true").zero?
   SENTINEL = ENV["GIT_HOOK_FOOTER_SENTINEL"] # No default to avoid accidental duplicate commit of a footer via ammended commits
-  raise "Set GIT_HOOK_FOOTER_SENTINEL=<footer sentinel> in .env.local (e.g., '⚡️ A message from a fellow meat-based-AI ⚡️')" if FOOTER_APPEND && SENTINEL.nil? || SENTINEL.empty?
+  raise "Set GIT_HOOK_FOOTER_SENTINEL=<footer sentinel> in .env.local (e.g., '⚡️ A message from a fellow meat-based-AI ⚡️')" if FOOTER_APPEND && (SENTINEL.nil? || SENTINEL.to_s.empty?)
 
   class << self
     def git_toplevel

data/exe/kettle-readme-backers

@@ -20,7 +20,11 @@
 #   # or ensure .opencollective.yml exists with collective: "kettle-rb"
 
 require "rubygems"
-require "bundler/setup"
+begin
+  require "bundler/setup"
+rescue LoadError
+  # Allow running outside of Bundler; runtime deps should still be available via rubygems
+end
 
 require "yaml"
 require "json"

data/exe/kettle-release

@@ -51,11 +51,47 @@ module Kettle
 
         ensure_bundler_2_7_plus!
 
-        run_cmd!("bin/setup")
-        run_cmd!("bin/rake")
-
         version = detect_version
         puts "Detected version: #{version.inspect}"
+
+        # Sanity check against latest released gem version (RubyGems)
+        begin
+          gem_name = detect_gem_name
+          latest_overall, latest_for_series = latest_released_versions(gem_name, version)
+          if latest_overall
+            msg = "Latest released: #{latest_overall}"
+            if latest_for_series && latest_for_series != latest_overall
+              msg += " | Latest for series #{Gem::Version.new(version).segments[0, 2].join(".")}.x: #{latest_for_series}"
+            elsif latest_for_series
+              msg += " (matches current series)"
+            end
+            puts msg
+
+            # Choose the comparison target:
+            # - If current series (MAJOR.MINOR) is behind overall latest, compare against the latest for the current series.
+            # - Otherwise (same or ahead), compare against overall latest.
+            cur = Gem::Version.new(version)
+            overall = Gem::Version.new(latest_overall)
+            cur_series = cur.segments[0, 2]
+            overall_series = overall.segments[0, 2]
+            target = if (cur_series <=> overall_series) == -1
+              latest_for_series # may be nil if no prior release in this series
+            else
+              latest_overall
+            end
+            if target && Gem::Version.new(version) <= Gem::Version.new(target)
+              series = cur_series.join(".")
+              warn("version.rb (#{version}) must be greater than the latest released version for series #{series}. Latest for series: #{target}.")
+              warn("Tip: bump PATCH for a stable branch release, or bump MINOR/MAJOR when on trunk.")
+              abort("Aborting: version bump required.")
+            end
+          else
+            puts "Could not determine latest released version from RubyGems (offline?). Proceeding without sanity check."
+          end
+        rescue StandardError => e
+          warn("Warning: failed to check RubyGems for latest version (#{e.class}: #{e.message}). Proceeding.")
+        end
+
         puts "Have you updated lib/**/version.rb and CHANGELOG.md for v#{version}? [y/N]"
         print("> ")
         ans = $stdin.gets&.strip
@@ -75,7 +111,10 @@ module Kettle
         end
 
         ensure_git_user!
-        commit_release_prep!(version)
+        committed = commit_release_prep!(version)
+
+        # Optional: run a local CI check with 'act' prior to pushing
+        maybe_run_local_ci_before_push!(committed)
 
         trunk = detect_trunk_branch
         feature = current_branch
@@ -234,6 +273,86 @@ module Kettle
         end
       end
 
+      # Run a local CI workflow using 'act' before pushing the release prep commit, if enabled.
+      # Controlled by env var K_RELEASE_LOCAL_CI:
+      #   - "true" => run without prompt
+      #   - "ask"  => prompt user [Y/n]
+      #   - anything else or unset => skip
+      # Workflow selection:
+      #   - If .github/workflows/locked_deps.yml (or .yaml) exists, default to it.
+      #   - Else, use the first workflow from CIHelpers.workflows_list unless K_RELEASE_LOCAL_CI_WORKFLOW points to another file.
+      # On failure, soft reset the last commit if one was created, then abort.
+      def maybe_run_local_ci_before_push!(committed)
+        mode = (ENV["K_RELEASE_LOCAL_CI"] || "").strip.downcase
+        run_it = case mode
+        when "true", "1", "yes", "y" then true
+        when "ask"
+          print("Run local CI with 'act' before pushing? [Y/n] ")
+          ans = $stdin.gets&.strip
+          ans.nil? || ans.empty? || ans =~ /\Ay(es)?\z/i
+        else
+          false
+        end
+        return unless run_it
+
+        # Check for 'act'
+        act_ok = begin
+          system("act", "--version", out: File::NULL, err: File::NULL)
+        rescue StandardError
+          false
+        end
+        unless act_ok
+          puts "Skipping local CI: 'act' command not found. Install https://github.com/nektos/act to enable."
+          return
+        end
+
+        root = Kettle::Dev::CIHelpers.project_root
+        workflows_dir = File.join(root, ".github", "workflows")
+        candidates = Kettle::Dev::CIHelpers.workflows_list(root)
+
+        # Explicit override via env
+        chosen = (ENV["K_RELEASE_LOCAL_CI_WORKFLOW"] || "").strip
+        if !chosen.empty?
+          # Normalize to a basename with extension
+          if chosen !~ /\.ya?ml\z/
+            chosen = "#{chosen}.yml"
+          end
+        else
+          # Default to locked_deps if present
+          chosen = if candidates.include?("locked_deps.yml")
+            "locked_deps.yml"
+          elsif candidates.include?("locked_deps.yaml")
+            "locked_deps.yaml"
+          else
+            candidates.first
+          end
+        end
+
+        unless chosen
+          puts "Skipping local CI: no workflows found under .github/workflows."
+          return
+        end
+
+        file_path = File.join(workflows_dir, chosen)
+        unless File.file?(file_path)
+          puts "Skipping local CI: selected workflow not found: #{file_path}"
+          return
+        end
+
+        puts "== Running local CI with act on #{chosen} =="
+        ok = system("act", "-W", file_path)
+        if ok
+          puts "Local CI succeeded for #{chosen}."
+        else
+          puts "Local CI failed for #{chosen}."
+          if committed
+            puts "Rolling back release prep commit (soft reset)..."
+            system("git", "reset", "--soft", "HEAD^")
+          end
+          abort("Aborting due to local CI failure.")
+        end
+      end
+
       def detect_version
         # Look for lib/**/version.rb and extract VERSION constant string
         candidates = Dir[File.join(@root, "lib", "**", "version.rb")]
@@ -245,14 +364,48 @@ module Kettle
         m[2]
       end
 
+      def detect_gem_name
+        # Find a .gemspec in project root and extract spec.name
+        gemspecs = Dir[File.join(@root, "*.gemspec")]
+        abort("Could not find a .gemspec in project root.") if gemspecs.empty?
+        path = gemspecs.min
+        content = File.read(path)
+        m = content.match(/spec\.name\s*=\s*(["'])([^"']+)\1/)
+        abort("Could not determine gem name from #{path}.") unless m
+        m[2]
+      end
+
+      # Returns [latest_overall, latest_for_series] as strings (or nils)
+      def latest_released_versions(gem_name, current_version)
+        uri = URI("https://rubygems.org/api/v1/versions/#{gem_name}.json")
+        res = Net::HTTP.get_response(uri)
+        return [nil, nil] unless res.is_a?(Net::HTTPSuccess)
+        data = JSON.parse(res.body)
+        versions = data.map { |h| h["number"] }.compact
+        # Drop pre-releases if API indicates; fall back to simple filter by '-' pattern
+        versions.reject! { |v| v.to_s.include?("-pre") || v.to_s.include?(".pre") || v.to_s =~ /[a-zA-Z]/ }
+        gversions = versions.map { |s| Gem::Version.new(s) }.sort
+        latest_overall = gversions.last&.to_s
+
+        cur = Gem::Version.new(current_version)
+        series = cur.segments[0, 2]
+        series_versions = gversions.select { |gv| gv.segments[0, 2] == series }
+        latest_series = series_versions.last&.to_s
+        [latest_overall, latest_series]
+      rescue StandardError
+        [nil, nil]
+      end
+
       def commit_release_prep!(version)
         msg = "🔖 Prepare release v#{version}"
         # Only commit if there are changes (version/changelog)
         out, _ = git_output(["status", "--porcelain"])
         if out.empty?
           puts "No changes to commit for release prep (continuing)."
+          false
         else
           run_cmd!(%(git commit -am #{Shellwords.escape(msg)}))
+          true
         end
       end
 

data/lib/kettle/dev/rakelib/ci.rake

@@ -65,6 +65,21 @@ namespace :ci do
       end
     end
 
+    get_sha = proc do
+      out, status = Open3.capture2("git", "rev-parse", "--short", "HEAD")
+      status.success? ? out.strip : nil
+    end
+
+    get_upstream = proc do
+      out, status = Open3.capture2("git", "rev-parse", "--abbrev-ref", "--symbolic-full-name", "@{u}")
+      if status.success?
+        out.strip
+      else
+        br = get_branch.call
+        br ? "origin/#{br}" : nil
+      end
+    end
+
     status_emoji = proc do |status, conclusion|
       case status
       when "queued"
@@ -196,6 +211,20 @@ namespace :ci do
     owner, repo = org if org
     token = ENV["GITHUB_TOKEN"] || ENV["GH_TOKEN"]
 
+    # Header with remote branch and SHA
+    upstream = get_upstream.call
+    sha = get_sha.call
+    if org && branch
+      puts "Repo: #{owner}/#{repo}"
+    elsif org
+      puts "Repo: #{owner}/#{repo}"
+    else
+      puts "Repo: n/a"
+    end
+    puts "Upstream: #{upstream || "n/a"}"
+    puts "HEAD: #{sha || "n/a"}"
+    puts
+
     puts "Select a workflow to run with 'act':"
 
     # Render initial menu with placeholder statuses
@@ -239,16 +268,40 @@ namespace :ci do
             Thread.exit
           end
           uri = URI("https://api.github.com/repos/#{ow}/#{rp}/actions/workflows/#{f}/runs?branch=#{URI.encode_www_form_component(br)}&per_page=1")
-          req = Net::HTTP::Get.new(uri)
-          req["User-Agent"] = "ci:act rake task"
-          req["Authorization"] = "token #{tk}" if tk && !tk.empty?
-          res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(req) }
-          status_q <<
-            if res.is_a?(Net::HTTPSuccess)
-              process_success_response(res, c, f)
-            else
-              [c, f, "fail #{res.code}"]
+          poll_interval = Integer(ENV["CI_ACT_POLL_INTERVAL"] || 5)
+          loop do
+            begin
+              req = Net::HTTP::Get.new(uri)
+              req["User-Agent"] = "ci:act rake task"
+              req["Authorization"] = "token #{tk}" if tk && !tk.empty?
+              res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(req) }
+              if res.is_a?(Net::HTTPSuccess)
+                data = JSON.parse(res.body)
+                run = data["workflow_runs"]&.first
+                if run
+                  st = run["status"]
+                  con = run["conclusion"]
+                  emoji = case st
+                  when "queued" then "⏳️"
+                  when "in_progress" then "👟"
+                  when "completed" then ((con == "success") ? "✅" : "🍅")
+                  else "⏳️"
+                  end
+                  details = [st, con].compact.join("/")
+                  status_q << [c, f, "#{emoji} (#{details})"]
+                  break if st == "completed"
+                else
+                  status_q << [c, f, "none"]
+                  break
+                end
+              else
+                status_q << [c, f, "fail #{res.code}"]
+              end
+            rescue StandardError
+              status_q << [c, f, "err"]
             end
+            sleep(poll_interval)
+          end
         rescue StandardError
           status_q << [c, f, "err"]
         end

data/lib/kettle/dev/rakelib/template.rake

@@ -329,6 +329,17 @@ namespace :kettle do
         end
       end
 
+      # 7b) certs/pboling.pem
+      begin
+        cert_src = File.join(gem_checkout_root, "certs", "pboling.pem")
+        cert_dest = File.join(project_root, "certs", "pboling.pem")
+        if File.exist?(cert_src)
+          helpers.copy_file_with_prompt(cert_src, cert_dest, allow_create: true, allow_replace: true)
+        end
+      rescue StandardError => e
+        puts "WARNING: Skipped copying certs/pboling.pem due to #{e.class}: #{e.message}"
+      end
+
       # After creating or replacing .envrc or .env.local.example, require review and exit unless allowed
       begin
         envrc_path = File.join(project_root, ".envrc")

data/lib/kettle/dev/version.rb

@@ -6,7 +6,7 @@ module Kettle
     module Version
       # The gem version.
       # @return [String]
-      VERSION = "1.0.7"
+      VERSION = "1.0.9"
     end
   end
 end

data/sig/kettle/dev/ci_helpers.rbs

@@ -24,6 +24,25 @@ module Kettle
       def self.failed?: ({ "status" => String?, "conclusion" => String? } | nil run) -> bool
 
       def self.default_token: () -> String?
+
+      # GitLab support
+      def self.origin_url: () -> String?
+
+      def self.repo_info_gitlab: () -> [String, String]?
+
+      def self.default_gitlab_token: () -> String?
+
+      def self.gitlab_latest_pipeline: (
+        owner: String,
+        repo: String,
+        ?branch: String?,
+        ?host: String,
+        ?token: String?
+      ) -> { "status" => String?, "web_url" => String?, "id" => untyped }?
+
+      def self.gitlab_success?: ({ "status" => String? } | nil pipeline) -> bool
+
+      def self.gitlab_failed?: ({ "status" => String? } | nil pipeline) -> bool
     end
   end
 end

data.tar.gz.sig

@@ -1 +1,2 @@
-[�@|�(�����*��n�po��jvԤ�{E�dۥ��)=U�����i���O�|+��=k7��£@�uܝ�e�M�,������Vv}��*T9t�EfqY���o��6�x��Nz`�N�E��.�&�o�
+2�j��"z:,K<�j�(�c��Z�l��n:gmm�&�(�#d����*�h�B�<DVHS�(w��ݜX��5�D�/�4�!l$ʉݨ3���l��P8Q��� '��������z(R���S4�O�˦l��Bs:L�����߁&����QXx���2��KH1��/y��C�KE𢡄C��ß�p�a�K����Q�S��]>�<Jڒ��b��T�}�1}p\hnv(Ng��R	Lb���ܘ��@�4�����ٷ��i�Y�&I�bY<}��Z����"3(�R�~wI<��X#G�/"�z�_۪�,��!���[���۔����Z�0(7#1��_tGԸޯ<?�d�l
+��4�Vc���#�����M�m�V��������

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: kettle-dev
 version: !ruby/object:Gem::Version
-  version: 1.0.7
+  version: 1.0.9
 platform: ruby
 authors:
 - Peter H. Boling
@@ -35,7 +35,7 @@ cert_chain:
   DVjBtqT23eugOqQ73umLcYDZkc36vnqGxUBSsXrzY9pzV5gGr2I8YUxMqf6ATrZt
   L9nRqA==
   -----END CERTIFICATE-----
-date: 2025-08-24 00:00:00.000000000 Z
+date: 2025-08-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: version_gem
@@ -203,8 +203,6 @@ extra_rdoc_files:
 - REEK
 - RUBOCOP.md
 - SECURITY.md
-- checksums/kettle-dev-1.0.7.gem.sha256
-- checksums/kettle-dev-1.0.7.gem.sha512
 files:
 - ".devcontainer/devcontainer.json"
 - ".envrc"
@@ -246,6 +244,7 @@ files:
 - Appraisal.root.gemfile
 - Appraisals
 - CHANGELOG.md
+- CHANGELOG.md.example
 - CITATION.cff
 - CODE_OF_CONDUCT.md
 - CONTRIBUTING.md
@@ -256,8 +255,6 @@ files:
 - RUBOCOP.md
 - Rakefile
 - SECURITY.md
-- checksums/kettle-dev-1.0.7.gem.sha256
-- checksums/kettle-dev-1.0.7.gem.sha512
 - exe/kettle-commit-msg
 - exe/kettle-readme-backers
 - exe/kettle-release
@@ -290,10 +287,10 @@ licenses:
 - MIT
 metadata:
   homepage_uri: https://kettle-dev.galtzo.com/
-  source_code_uri: https://github.com/galtzo-floss/kettle-dev/tree/v1.0.7
-  changelog_uri: https://github.com/galtzo-floss/kettle-dev/blob/v1.0.7/CHANGELOG.md
+  source_code_uri: https://github.com/galtzo-floss/kettle-dev/tree/v1.0.9
+  changelog_uri: https://github.com/galtzo-floss/kettle-dev/blob/v1.0.9/CHANGELOG.md
   bug_tracker_uri: https://github.com/galtzo-floss/kettle-dev/issues
-  documentation_uri: https://www.rubydoc.info/gems/kettle-dev/1.0.7
+  documentation_uri: https://www.rubydoc.info/gems/kettle-dev/1.0.9
   funding_uri: https://github.com/sponsors/pboling
   wiki_uri: https://github.com/galtzo-floss/kettle-dev/wiki
   news_uri: https://www.railsbling.com/tags/kettle-dev

data/checksums/kettle-dev-1.0.7.gem.sha256

@@ -1 +0,0 @@
-f5a4e19daf87b88e9f61c4bfec481ea915f5f734cf665dbcbd34be6979718c89

data/checksums/kettle-dev-1.0.7.gem.sha512

@@ -1 +0,0 @@
-7b99485e9d4411f2766d7cf53121923e26284f455146a7ba281982634cc534384d91739d83113618852f8abd5093dbc465362afff62e5da041f996bed2bd3a4b