kettle-dev 1.0.8 → 1.0.10

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 88b6d217fb45ef184853b27880054985424c38f1d43da10e7c0b68125016b1d4
-  data.tar.gz: 927a1e7a443ecb14f4b9b295dd3b88392656185f14482bdabcbf7e156c63f6b2
+  metadata.gz: 6e64251f36de1db3a3f0c71d1436758db8a13223b3a5740062a04fa169ae9875
+  data.tar.gz: afb492c0d27d008b779e426f081c0be491dff7616120115668468f9ff2c1872c
 SHA512:
-  metadata.gz: bd4d59e6bc6931b67e915d278fbd34f022721a9fd1a9fa9c0fa9f1aac39fd5c04f1749dccb9638aed1066e1c8ae9f0a42915ec00b1b291e83397ffdda095cfe5
-  data.tar.gz: 2b8a93690ec0853df92b6da7a22d7ee59dd51f5b9fb24d8fe231076a7233a5ce20513831b6ce50bc85ca94bd1ddc1c4f67d542ecd838b45cafbadf621f593cd0
+  metadata.gz: 0cc6afa5e3543bab0de8682f0d9a2d45df99a442e2253fe8f028ef190c59cb44710969b9f22e63c4ef4a0e604f96243b616589683ec6ff5d68273cfd2fe0ac40
+  data.tar.gz: 9d5253d1aac3f87db2e76ae013c16a5a71ebfd649f8bbaf882b74f90af2e5bdfe2c99cb6fbb9f83cc4efa094117d26dfd7e898d902fc0eb60a74559dca6f9af7

data/.envrc

@@ -1,6 +1,7 @@
 # Run any command in this library's bin/ without the bin/ prefix!
-PATH_add bin
+# Prefer exe version over binstub
 PATH_add exe
+PATH_add bin
 
 # Only add things to this file that should be shared with the team.
 
@@ -20,8 +21,8 @@ export K_SOUP_COV_DO=true # Means you want code coverage
 export K_SOUP_COV_COMMAND_NAME="Test Coverage"
 # Available formats are html, xml, rcov, lcov, json, tty
 export K_SOUP_COV_FORMATTERS="html,xml,rcov,lcov,json,tty"
-export K_SOUP_COV_MIN_BRANCH=96 # Means you want to enforce X% branch coverage
-export K_SOUP_COV_MIN_LINE=100 # Means you want to enforce X% line coverage
+export K_SOUP_COV_MIN_BRANCH=77 # Means you want to enforce X% branch coverage
+export K_SOUP_COV_MIN_LINE=97 # Means you want to enforce X% line coverage
 export K_SOUP_COV_MIN_HARD=true # Means you want the build to fail if the coverage thresholds are not met
 export K_SOUP_COV_MULTI_FORMATTERS=true
 export K_SOUP_COV_OPEN_BIN= # Means don't try to open coverage results in browser

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

@@ -7,8 +7,8 @@ permissions:
 
 env:
   # Lower than local, which is at 100/100, because rubocop-lts isn't installed in the coverage workflow
-  K_SOUP_COV_MIN_BRANCH: 90
-  K_SOUP_COV_MIN_LINE: 95
+  K_SOUP_COV_MIN_BRANCH: 72
+  K_SOUP_COV_MIN_LINE: 94
   K_SOUP_COV_MIN_HARD: true
   K_SOUP_COV_FORMATTERS: "xml,rcov,lcov,tty"
   K_SOUP_COV_DO: true
@@ -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') }}
@@ -118,7 +116,7 @@ jobs:
           hide_complexity: true
           indicators: true
           output: both
-          thresholds: '95 90'
+          thresholds: '94 72'
         continue-on-error: ${{ matrix.experimental != 'false' }}
 
       - name: Add Coverage PR Comment

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/.junie/guidelines.md

@@ -120,13 +120,14 @@ This document captures project-specific knowledge to streamline setup, testing,
 
 Quick start
 1) bundle install
-2) K_SOUP_COV_FORMATTERS="xml,rcov,lcov,json" bin/rspec (generates coverage reports in coverage/ in the specified formats, only choose the formats you need)
-3) Optional local HTML coverage report: K_SOUP_COV_FORMATTERS="html" bin/rspec (generates HTML coverage report in coverage/ - but this is too verbose for AI, so Junie should use one of the more terse formats, like rcov, lcov, or json)
-4) Static analysis: bundle exec rake rubocop_gradual:check && bundle exec rake reek
+2) K_SOUP_COV_FORMATTERS="json" bin/rspec (generates a JSON coverage report with both line and branch data in coverage/. Use this single format.)
+3) Static analysis: bundle exec rake rubocop_gradual:check && bundle exec rake reek
 
 Notes
 - ALWAYS Run bundle exec rake rubocop_gradual:autocorrect as the final step before completing a task, to lint and autocorrect any remaining issues. Then if there are new lint failures, attempt to correct them manually.
 - NEVER run vanilla rubocop, as it won't handle the linting config properly. Always run rubocop_gradual:autocorrect or rubocop_gradual.
 - Running only a subset of specs is supported but in order to bypass the hard failure due to coverage thresholds, you need to run with K_SOUP_COV_MIN_HARD=false.
 - When adding code that writes to STDOUT, remember most specs silence output unless tagged with :check_output or DEBUG=true.
+- Coverage reports: NEVER review the HTML report. Use JSON (preferred), XML, LCOV, or RCOV. For this project, always run tests with K_SOUP_COV_FORMATTERS set to "json".
+- Do NOT modify .envrc in tasks; when running tests locally or in scripts, manually prefix each run, e.g.: K_SOUP_COV_FORMATTERS="json" bin/rspec
 - For all the kettle-soup-cover options, see .envrc and find the K_SOUP_COV_* env vars.

data/.simplecov

@@ -4,4 +4,8 @@ require "kettle/soup/cover/config"
 # It is controlled by ENV variables, which are set in .envrc and loaded via `direnv allow`
 # If the values for minimum coverage need to change, they should be changed both there,
 #   and in 2 places in .github/workflows/coverage.yml.
-SimpleCov.start
+SimpleCov.start do
+  track_files "lib/**/*.rb"
+  track_files "lib/**/*.rake"
+  track_files "exe/*.rb"
+end

data/Appraisals

@@ -79,12 +79,15 @@ appraise "ruby-3-0" do
 end
 
 appraise "ruby-3-1" do
+  # all versions of git gem are incompatible with truffleruby v23.0, syntactically.
   gem "erb"
   gem "mutex_m", "~> 0.2"
   gem "stringio", "~> 3.0"
 end
 
 appraise "ruby-3-2" do
+  # all versions of git gem are incompatible with truffleruby v23.1, syntactically.
+  gem "git", "< 3"
   gem "erb"
   gem "mutex_m", "~> 0.2"
   gem "stringio", "~> 3.0"

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,37 @@ and this project adheres to [Semantic Versioning v2](https://semver.org/spec/v2.
 ### Fixed
 ### Security
 
+## [1.0.10] - 2025-08-24
+- TAG: [v1.0.10][1.0.10t]
+- COVERAGE:  97.68% -- 1685/1725 lines in 17 files
+- BRANCH COVERAGE:  77.54% -- 618/797 branches in 17 files- 95.35% documented
+- 77.00% documented
+### Added
+- runs git add --all before git commit, to ensure all files are committed.
+### Changed
+- This gem is now loaded via Ruby's standard `autoload` feature.
+- Bundler is always expected, and most things probably won't work without it.
+- exe/ scripts and rake tasks logic is all now moved into classes for testability, and is nearly fully covered by tests.
+- New Kettle::Dev::GitAdapter class is an adapter pattern wrapper for git commands
+- New Kettle::Dev::ExitAdapter class is an adapter pattern wrapper for Kernel.exit and Kernel.abort within this codebase.
+### Removed
+- attempts to make exe/* scripts work without bundler. Bundler is required.
+### Fixed
+- `Kettle::Dev::ReleaseCLI#detect_version` handles gems with multiple VERSION constants
+- `kettle:dev:template` task was fixed to copy `.example` files with the destination filename lacking the `.example` extension, except for `.env.local.example`
+
+## [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
@@ -116,7 +159,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.8...HEAD
+[Unreleased]: https://gitlab.com/kettle-rb/kettle-dev/-/compare/v1.0.10...HEAD
+[1.0.10]: https://gitlab.com/kettle-rb/kettle-dev/-/compare/v1.0.9...v1.0.10
+[1.0.10t]: https://gitlab.com/kettle-rb/kettle-dev/-/tags/v1.0.10
+[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

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/CONTRIBUTING.md

@@ -51,6 +51,12 @@ To run all tests
 bundle exec rake test
 ```
 
+### Spec organization (required)
+
+- For each class or module under `lib/`, keep all of its unit tests in a single spec file under `spec/` that mirrors the path and file name (e.g., specs for `lib/kettle/dev/release_cli.rb` live in `spec/kettle/dev/release_cli_spec.rb`).
+- Do not create ad-hoc "_more" or split spec files for the same class/module. Consolidate all unit tests into the main spec file for that class/module.
+- Only integration scenarios that intentionally span multiple classes belong in `spec/integration/`.
+
 ## Lint It
 
 Run all the default tasks, which includes running the gradually autocorrecting linter, `rubocop-gradual`.

data/README.md

@@ -21,11 +21,16 @@ OTOH, if `ci_badges.map(&:color).all? { it == "green"}` 👇️ send money so I
 
 ## 🌻 Synopsis
 
-Add to your `Rakefile`:
+This gem integrates tightly with [kettle-test](https://github.com/kettle-rb/kettle-test).
+
+```ruby
+require "kettle/test/rspec"
+```
+
+Then, add to your `Rakefile`:
 
 ```ruby
 require "kettle/dev"
-Kettle::Dev.install_tasks
 ```
 
 Now you have many powerful development and testing tools at your disposal, all fully [documented](#-configuration) and tested.
@@ -136,11 +141,20 @@ NOTE: Be prepared to track down certs for signed gems and add them the same way
 
 ## ⚙️ Configuration
 
+### RSpec
+
+This gem integrates tightly with [kettle-test](https://github.com/kettle-rb/kettle-test).
+
+```ruby
+require "kettle/test/rspec"
+```
+
+### Rakefile
+
 Add to your `Rakefile`:
 
 ```ruby
 require "kettle/dev"
-Kettle::Dev.install_tasks
 ```
 
 That’s it. When installed, kettle-dev:
@@ -231,6 +245,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 +264,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).
 
@@ -283,7 +302,6 @@ Tip: The commit message helper `exe/kettle-commit-msg` prefers project-local `.g
     - Note: When used with the provided `.git-hooks`, the subject should start with a gitmoji character (see [gitmoji][📌gitmoji]).
 - Tip: Run this locally before committing to keep your README current, or schedule it in CI to refresh periodically.
 
-
 ## 🦷 FLOSS Funding
 
 While kettle-rb tools are free software and will always be, the project would benefit immensely from some funding.
@@ -641,7 +659,7 @@ Thanks for RTFM. ☺️
 [📌gitmoji]:https://gitmoji.dev
 [📌gitmoji-img]:https://img.shields.io/badge/gitmoji_commits-%20😜%20😍-34495e.svg?style=flat-square
 [🧮kloc]: https://www.youtube.com/watch?v=dQw4w9WgXcQ
-[🧮kloc-img]: https://img.shields.io/badge/KLOC-0.130-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
+[🧮kloc-img]: https://img.shields.io/badge/KLOC-1.725-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
 [🔐security]: 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