kettle-dev 1.2.4 → 2.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 73ca5267629934af0b0f044598295a93c287cbace6c0ac2f5e2d1a701a72ca89
-  data.tar.gz: 1743ac37975a516f979d135d52c62b8a9fa28171d6df1a82fb58cce4d1676ea1
+  metadata.gz: 423e786ae241791214751d2cd3496033ba0986b4279d738d62feda1eb197837b
+  data.tar.gz: 7c7436dcf0a65dea2d9241263bfd6d357c64a5f4a1a12432325fb5aecfe2cd38
 SHA512:
-  metadata.gz: afd0cdb05a6f08db4665b634cf38d4f959d08ea73ff526f1757d9168d3aab0a6a6d81ba90a5f20905f8888bd88bbbe55c1c53d15f0d1898202448dac0f204bd3
-  data.tar.gz: 92a005b6bb76771bffe3e0e3e3762bc6e11699286119dc009cb61e4c72278666552e07cf0a547c215c586caf7abeea7305767fce2d008342758b5d8fe80cc676
+  metadata.gz: 2f7e35c2eedd5a7f4b75bd9ce4bfb0e98e269a05694875a6c53311aaab885d5a3d8839283b3ca986cd3b694f1f48b3bc3ed0dc28171decb1e5391ef61b0df0c2
+  data.tar.gz: abd66bf76d22b3d13303228bf46d22b4fbb7f69c26d0740e54ec6c693f3f31d10b34f9cc4491fb12be0e073777af8ca812d57eb740cd27af65b644bb445bba60

data/CHANGELOG.md

@@ -22,14 +22,237 @@ Please file a bug if you notice a violation of semantic versioning.
 
 ### Changed
 
+- **BREAKING**: Raised the minimum Ruby version to 2.4.0, matching
+  `kettle-test` 2.x and its runtime `turbo_tests2` dependency.
+- `kettle-test` is now declared as a runtime dependency because the shipped rake
+  and changelog tasks invoke `bundle exec kettle-test`.
+- Refreshed generated template output for README badge formatting and
+  Ruby 2.4-targeted RuboCop LTS style dependencies.
+
 ### Deprecated
 
 ### Removed
 
+- Removed Ruby 2.3 and JRuby 9.1 CI workflows and appraisal gemfiles.
+
 ### Fixed
 
+- Appraisal-based CI gemfiles now load the version-appropriate VCR/WebMock
+  recording dependencies required by the spec helper without falling back to the
+  root Gemfile.
+- Reek, RuboCop-LTS, and coverage task specs now run in coverage CI without
+  requiring style-only dependencies.
+- Reek rake task specs no longer change the process working directory, avoiding
+  cross-spec project root leakage under turbo workers.
+- `rake reek:update` now raises a normal task error on unexpected reek exits
+  instead of calling `Kernel.abort`, so specs can assert the failure path without
+  poisoning the process exit status.
+- Coverage CI thresholds now match the repository `mise.toml` thresholds instead
+  of requiring unreachable 100% line and branch coverage.
+- Regenerated templating now keeps `kettle-test` as a runtime dependency only
+  instead of duplicating it as both runtime and development dependency.
+- Replaced non-capturing `=~` checks with `Regexp#match?` so unlocked/style CI
+  stays clean with newer RuboCop performance cops.
+- Cleared the remaining `rubocop_gradual` backlog and removed the lock file.
+
 ### Security
 
+## [2.0.1] - 2026-05-25
+
+- TAG: [v2.0.1][2.0.1t]
+- COVERAGE: 94.88% -- 2911/3068 lines in 21 files
+- BRANCH COVERAGE: 78.43% -- 1200/1530 branches in 21 files
+- 76.25% documented
+
+### Added
+
+- Added `kettle-changelog --update-prep` to refresh the most recent prepared
+  release section in place, including date, coverage, documentation stats, and
+  any follow-up Unreleased notes.
+
+### Changed
+
+- `kettle-changelog` now generates strict coverage data with
+  `bundle exec kettle-test`, preserving the faster `turbo_tests2` runner.
+- `kettle-changelog` now treats configured coverage thresholds as a changelog
+  preparation gate by default; use `--no-coverage-threshold` or
+  `K_CHANGELOG_COVERAGE_HARD=false` to generate changelog metadata without
+  threshold enforcement.
+- The shared `rake spec` task now delegates to `bundle exec kettle-test`, so
+  projects using kettle-dev automatically pick up kettle-test's default
+  `turbo_tests2` runner and summary output.
+- The shared `:yard` task now installs `yard-fence` and `yard-timekeeper` integrations explicitly so documentation prep and post-processing only run during `rake yard`
+
+- Refreshed generated kettle-jem templates, CI workflows, curated binstubs, and
+  local modular Gemfile wiring.
+- `kettle-changelog` now auto-selects the correct no-argument action by
+  comparing `version.rb`, the latest live release, and the most recent
+  CHANGELOG.md release section before prompting for confirmation.
+- Updated the development dependency on `kettle-test` to require 2.0.1 or newer.
+
+### Fixed
+
+- Loading YARD during unrelated rake tasks no longer triggers documentation plugin side effects that rewrite or clear `docs/`
+
+- `rake reek:update` now resolves the Reek gem executable directly instead of
+  shelling through `bundle exec reek`, avoiding stale project binstubs, and no
+  longer fails the default task solely because Reek reported smells while
+  refreshing the `REEK` backlog file.
+- `rake reek:update` now keeps `REEK` zero-byte when Reek reports no smells
+  instead of writing a single blank line.
+
+## [2.0.0] - 2026-02-25
+
+- TAG: [v2.0.0][2.0.0t]
+- COVERAGE: 96.06% -- 2683/2793 lines in 20 files
+- BRANCH COVERAGE: 79.16% -- 1113/1406 branches in 20 files
+- 80.25% documented
+
+### Added
+
+- New `kettle-gh-release` executable for standalone GitHub release creation
+  - Extracted from `kettle-release` step 18
+  - Useful when RubyGems release succeeded but GitHub release failed
+  - Supports explicit version via `version=<VERSION>` argument
+  - Auto-detects version from `lib/**/version.rb` if not specified
+  - Requires `GITHUB_TOKEN` with `repo:public_repo` (classic) or `contents:write` scope
+- Added `.kettle-dev.yml` configuration file for per-file merge options
+  - Hybrid format: `defaults` for shared merge options, `patterns` for glob fallbacks, `files` for per-file config
+  - Nested directory structure under `files` allows individual file configuration
+  - Supports all `Prism::Merge::SmartMerger` options: `preference`, `add_template_only_nodes`, `freeze_token`, `max_recursion_depth`
+  - Added `TemplateHelpers.kettle_config`, `.config_for`, `.find_file_config` methods
+  - Added spec coverage in `template_helpers_config_spec.rb`
+
+### Changed
+
+- Updated documentation on hostile takeover of RubyGems
+  - https://dev.to/galtzo/hostile-takeover-of-rubygems-my-thoughts-5hlo
+- **BREAKING**: Replaced `template_manifest.yml` with `.kettle-dev.yml`
+  - New hybrid format supports both glob patterns and per-file configuration
+  - `TemplateHelpers.load_manifest` now reads from `.kettle-dev.yml` patterns section
+  - `TemplateHelpers.strategy_for` checks explicit file configs before falling back to patterns
+- **BREAKING**: Simplified `SourceMerger` to fully rely on prism-merge for AST merging
+  - Reduced from ~610 lines to ~175 lines (71% reduction)
+  - Removed custom newline normalization - prism-merge preserves original formatting
+  - Removed custom comment deduplication logic - prism-merge handles this natively
+  - All strategies (`:skip`, `:replace`, `:append`, `:merge`) now use prism-merge consistently
+  - Freeze blocks (`kettle-dev:freeze` / `kettle-dev:unfreeze`) handled by prism-merge's `freeze_token` option
+
+### Removed
+
+- Removed all `.example` template files from the kettle-dev root and subdirectories
+  (27 files). Template files now live exclusively in kettle-jem's `template/` directory.
+  Only `.env.local.example` is retained as a dev resource for all destination gems.
+- Removed unused methods from `SourceMerger`:
+  - `normalize_source` - replaced by prism-merge
+  - `normalize_newlines` - prism-merge preserves original formatting
+  - `shebang?`, `magic_comment?`, `ruby_magic_comment_key?` - no longer needed
+  - Comment extraction/deduplication: `extract_magic_comments`, `extract_file_leading_comments`,
+    `create_comment_tuples`, `deduplicate_comment_sequences`, `deduplicate_sequences_pass1`,
+    `deduplicate_singles_pass2`, `extract_nodes_with_comments`, `count_blank_lines_before`,
+    `build_source_from_nodes`
+  - Unused comment restoration: `restore_custom_leading_comments`, `deduplicate_leading_comment_block`,
+    `extract_comment_lines`, `normalize_comment`, `leading_comment_block`
+- Removed unused constants: `RUBY_MAGIC_COMMENT_KEYS`, `MAGIC_COMMENT_REGEXES`
+
+### Fixed
+
+- Fixed `PrismAppraisals` various comment chunk spacing
+  - extract_block_header:
+    - skips the blank spacer immediately above an `appraise` block
+    - treats any following blank line as the stop boundary once comment lines have been collected
+    - prevents preamble comments from being pulled into the first block’s header
+  - restores expected ordering:
+    - magic comments and their blank line stay at the top
+    - block headers remain adjacent to their blocks
+    - preserves blank lines between comment chunks
+- Fixed `SourceMerger` freeze block location preservation
+  - Freeze blocks now stay in their original location in the file structure
+  - Skip normalization for files with existing freeze blocks to prevent movement
+  - Only include contiguous comments immediately before freeze markers (no arbitrary 3-line lookback)
+  - Don't add freeze reminder to files that already have freeze/unfreeze blocks
+  - Prevents unrelated comments from being incorrectly captured in freeze block ranges
+  - Added comprehensive test coverage for multiple freeze blocks at different nesting levels
+- Fixed `TemplateTask` to not override template summary/description with empty strings from destination gemspec
+  - Only carries over summary/description when they contain actual content (non-empty)
+  - Allows token replacements to work correctly (e.g., `kettle-dev summary` → `my-gem summary`)
+  - Prevents empty destination fields from erasing meaningful template values
+- Fixed `SourceMerger` magic comment ordering and freeze block protection
+  - Magic comments now preserve original order
+  - No blank lines inserted between consecutive magic comments
+  - Freeze reminder block properly separated from magic comments (not merged)
+  - Leverages Prism's built-in `parse_result.magic_comments` API for accurate detection
+  - Detects `kettle-dev:freeze/unfreeze` pairs using Prism, then reclassifies as file-level comments to keep blocks intact
+  - Removed obsolete `is_magic_comment?` method in favor of Prism's native detection
+- Fixed `PrismGemspec` and `PrismGemfile` to use pure Prism AST traversal instead of regex fallbacks
+  - Removed regex-based `extract_gemspec_emoji` that parsed `spec.summary =` and `spec.description =` with regex
+  - Now traverses Prism AST to find Gem::Specification block, extracts summary/description nodes, and gets literal values
+  - Removed regex-based source line detection in `PrismGemfile.merge_gem_calls`
+  - Now uses `PrismUtils.statement_key` to find source statements via AST instead of `ln =~ /^\s*source\s+/`
+  - Aligns with project goal: move away from regex parsing toward proper AST manipulation with Prism
+  - All functionality preserved, tested, and working correctly
+- Fixed `PrismGemspec.replace_gemspec_fields` block parameter extraction to use Prism AST
+  - **CRITICAL**: Was using regex fallback that incorrectly captured entire block body as parameter name
+  - Removed buggy regex fallback in favor of pure Prism AST traversal
+  - Now properly extracts block parameter from Prism::BlockParametersNode → Prism::ParametersNode → Prism::RequiredParameterNode
+- Fixed `PrismGemspec.replace_gemspec_fields` insert offset calculation for emoji-containing gemspecs
+  - **CRITICAL**: Was using character length (`String#length`) instead of byte length (`String#bytesize`) to calculate insert offset
+  - When gemspecs contain multi-byte UTF-8 characters (emojis like 🍲), character length != byte length
+  - This caused fields to be inserted at wrong byte positions, resulting in truncated strings and massive corruption
+  - Changed `body_src.rstrip.length` to `body_src.rstrip.bytesize` for correct byte-offset calculations
+  - Prevents gemspec templating from producing corrupted output with truncated dependency lines
+  - Added comprehensive debug logging to trace byte offset calculations and edit operations
+- Fixed `SourceMerger` variable assignment duplication during merge operations
+  - `node_signature` now identifies variable/constant assignments by name only, not full source
+  - Previously used full source text as signature, causing duplicates when assignment bodies differed
+  - Added specific handlers for: LocalVariableWriteNode, InstanceVariableWriteNode, ClassVariableWriteNode, ConstantWriteNode, GlobalVariableWriteNode
+  - Also added handlers for ClassNode and ModuleNode to match by name
+  - Example: `gem_version = ...` assignments with different bodies now correctly merge instead of duplicating
+  - Prevents `bin/kettle-dev-setup` from creating duplicate variable assignments in gemspecs and other files
+  - Added comprehensive specs for variable assignment deduplication and idempotency
+- Fixed `SourceMerger` conditional block duplication during merge operations
+  - `node_signature` now identifies conditional nodes (if/unless/case) by their predicate only
+  - Previously used full source text, causing duplicate blocks when template updates conditional bodies
+  - Example: if ENV["FOO"] blocks with different bodies now correctly merge instead of duplicating
+  - Prevents `bin/kettle-dev-setup` from creating duplicate if/else blocks in gemfiles
+  - Added comprehensive specs for conditional merging behavior and idempotency
+- Fixed `PrismGemspec.replace_gemspec_fields` to use byte-aware string operations
+  - **CRITICAL**: Was using character-based `String#[]=` with Prism's byte offsets
+  - This caused catastrophic corruption when emojis or multi-byte UTF-8 characters were present
+  - Symptoms: gemspec blocks duplicated/fragmented, statements escaped outside blocks
+  - Now uses `byteslice` and byte-aware concatenation for all edit operations
+  - Prevents gemspec templating from producing mangled output with duplicated Gem::Specification blocks
+- Fixed `PrismGemspec.replace_gemspec_fields` to correctly handle multi-byte UTF-8 characters (e.g., emojis)
+  - Prism uses byte offsets, not character offsets, when parsing Ruby code
+  - Changed string slicing from `String#[]` to `String#byteslice` for all offset-based operations
+  - Added validation to use `String#bytesize` instead of `String#length` for offset bounds checking
+  - Prevents `TypeError: no implicit conversion of nil into String` when gemspecs contain emojis
+  - Ensures gemspec field carryover works correctly with emoji in summary/description fields
+  - Enhanced error reporting to show backtraces when debug mode is enabled
+
+## [1.2.5] - 2025-11-28
+
+- TAG: [v1.2.5][1.2.5t]
+- COVERAGE: 93.53% -- 4726/5053 lines in 31 files
+- BRANCH COVERAGE: 76.62% -- 1924/2511 branches in 31 files
+- 69.89% documented
+
+### Added
+
+- Comprehensive newline normalization in templated Ruby files:
+  - Magic comments (frozen_string_literal, encoding, etc.) always followed by single blank line
+  - No more than one consecutive blank line anywhere in file
+  - Single newline at end of file (no trailing blank lines)
+  - Freeze reminder block now includes blank line before and empty comment line after for better visual separation
+
+### Changed
+
+- Updated `FREEZE_REMINDER` constant to include blank line before and empty comment line after
+
+### Fixed
+
+- Fixed `reminder_present?` to correctly detect freeze reminder when it has leading blank line
+
 ## [1.2.4] - 2025-11-28
 
 - TAG: [v1.2.4][1.2.4t]
@@ -45,7 +268,7 @@ Please file a bug if you notice a violation of semantic versioning.
   - Ensures truly idempotent behavior when running templating multiple times on the same file
   - Example: `frozen_string_literal` comments no longer multiply from 1→4→5→6 on repeated runs
 
-## [1.2.3] - 2025-11-28
+## [1.2.3] - 2025-11-28vari
 
 - TAG: [v1.2.3][1.2.3t]
 - COVERAGE: 93.43% -- 4681/5010 lines in 31 files
@@ -1138,7 +1361,7 @@ Please file a bug if you notice a violation of semantic versioning.
   - <!-- RELEASE-NOTES-FOOTER-END -->
 - truffle workflow: Repeat attempts for bundle install and appraisal bundle before failure
 - global token replacement during kettle:dev:install
-  - {KETTLE|DEV|GEM} => kettle-dev
+  - kettle-dev => kettle-dev
   - {RUBOCOP|LTS|CONSTRAINT} => dynamic
   - {RUBOCOP|RUBY|GEM} => dynamic
   - default to rubocop-ruby1_8 if no minimum ruby specified
@@ -1522,7 +1745,13 @@ 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-rb/kettle-dev/compare/v1.2.4...HEAD
+[Unreleased]: https://github.com/kettle-rb/kettle-dev/compare/v2.0.1...HEAD
+[2.0.1]: https://github.com/kettle-rb/kettle-dev/compare/v2.0.0...v2.0.1
+[2.0.1t]: https://github.com/kettle-rb/kettle-dev/releases/tag/v2.0.1
+[2.0.0]: https://github.com/kettle-rb/kettle-dev/compare/v1.2.5...v2.0.0
+[2.0.0t]: https://github.com/kettle-rb/kettle-dev/releases/tag/v2.0.0
+[1.2.5]: https://github.com/kettle-rb/kettle-dev/compare/v1.2.4...v1.2.5
+[1.2.5t]: https://github.com/kettle-rb/kettle-dev/releases/tag/v1.2.5
 [1.2.4]: https://github.com/kettle-rb/kettle-dev/compare/v1.2.3...v1.2.4
 [1.2.4t]: https://github.com/kettle-rb/kettle-dev/releases/tag/v1.2.4
 [1.2.3]: https://github.com/kettle-rb/kettle-dev/compare/v1.2.2...v1.2.3

data/CITATION.cff

@@ -1,19 +1,19 @@
 cff-version: 1.2.0
-title: kettle-dev
+title: "kettle-dev"
 message: >-
   If you use this work and you want to cite it,
   then you can use the metadata from this file.
 type: software
 authors:
-  - given-names: Peter Hurn
-    family-names: Boling
-    email: peter@railsbling.com
-    affiliation: railsbling.com
+  - given-names: "Peter H."
+    family-names: "Boling"
+    email: "floss@galtzo.com"
+    affiliation: "galtzo.com"
     orcid: 'https://orcid.org/0009-0008-8519-441X'
 identifiers:
   - type: url
     value: 'https://github.com/kettle-rb/kettle-dev'
-    description: kettle-dev
+    description: "kettle-dev"
 repository-code: 'https://github.com/kettle-rb/kettle-dev'
 abstract: >-
   kettle-dev

data/CONTRIBUTING.md

@@ -8,25 +8,34 @@ To submit a patch, please fork the project, create a patch with tests, and send
 
 Remember to [![Keep A Changelog][📗keep-changelog-img]][📗keep-changelog] if you make changes.
 
+## Developer Certificate of Origin
+
+In order to protect users of this project, we require all contributors to comply with the
+[Developer Certificate of Origin](https://developercertificate.org/).
+This ensures that all contributions are properly licensed and attributed.
+
 ## Help out!
 
-Take a look at the `reek` list which is the file called `REEK` and find something to improve.
+Take a look at the open issues and pull requests, or use the gem and find something to improve.
 
 Follow these instructions:
 
-1. Fork the repository
-2. Create a feature branch (`git checkout -b my-new-feature`)
-3. Make some fixes.
-4. Commit changes (`git commit -am 'Added some feature'`)
-5. Push to the branch (`git push origin my-new-feature`)
-6. Make sure to add tests for it. This is important, so it doesn't break in a future release.
-7. Create new Pull Request.
+1. Join the Discord: [![Live Chat on Discord][✉️discord-invite-img]][✉️discord-invite]
+2. Fork the repository
+3. Create your feature branch (`git checkout -b my-new-feature`)
+4. Make some fixes.
+5. Commit your changes (`git commit -am 'Added some feature'`)
+6. Push to the branch (`git push origin my-new-feature`)
+7. Make sure to add tests for it. This is important, so it doesn't break in a future release.
+8. Create new Pull Request.
+9. Announce it in the channel for this org in the [Discord][✉️discord-invite]!
 
 ## Executables vs Rake tasks
 
-Executables shipped by kettle-dev can be used with or without generating the binstubs.
-They will work when kettle-dev is installed globally (i.e., `gem install kettle-dev`) and do not require that kettle-dev be in your bundle.
+Executables shipped by dependencies, such as kettle-dev, and stone_checksums, are available
+after running `bin/setup`. These include:
 
+- gem_checksums
 - kettle-changelog
 - kettle-commit-msg
 - kettle-dev-setup
@@ -35,20 +44,26 @@ They will work when kettle-dev is installed globally (i.e., `gem install kettle-
 - kettle-readme-backers
 - kettle-release
 
-However, the rake tasks provided by kettle-dev do require kettle-dev to be added as a development dependency and loaded in your Rakefile.
-See the full list of rake tasks in head of Rakefile
+There are many Rake tasks available as well. You can see them by running:
 
-**Gemfile**
-```ruby
-group :development do
-  gem "kettle-dev", require: false
-end
+```shell
+bin/rake -T
 ```
 
-**Rakefile**
-```ruby
-# Rakefile
-require "kettle/dev"
+## Code quality checks
+
+Run the Reek task when you want a smell check that fails on current findings:
+
+```shell
+bin/rake reek
+```
+
+Refresh the checked-in `REEK` backlog through the rake task, not by redirecting
+the raw `reek` executable output. The rake task uses the project bundle and
+avoids stale generated binstubs shadowing the Reek gem executable:
+
+```shell
+bin/rake reek:update
 ```
 
 ## Environment Variables for Local Development
@@ -61,7 +76,7 @@ General/runtime
 - CI: When set to true, adjusts default rake tasks toward CI behavior
 
 Coverage (kettle-soup-cover / SimpleCov)
-- K_SOUP_COV_DO: Enable coverage collection (default: true in .envrc)
+- K_SOUP_COV_DO: Enable coverage collection (default: true in `mise.toml`)
 - K_SOUP_COV_FORMATTERS: Comma-separated list of formatters (html, xml, rcov, lcov, json, tty)
 - K_SOUP_COV_MIN_LINE: Minimum line coverage threshold (integer, e.g., 100)
 - K_SOUP_COV_MIN_BRANCH: Minimum branch coverage threshold (integer, e.g., 100)
@@ -77,7 +92,9 @@ GitHub API and CI helpers
 Releasing and signing
 - SKIP_GEM_SIGNING: If set, skip gem signing during build/release
 - GEM_CERT_USER: Username for selecting your public cert in `certs/<USER>.pem` (defaults to $USER)
-- SOURCE_DATE_EPOCH: Reproducible build timestamp. `kettle-release` will set this automatically for the session.
+- SOURCE_DATE_EPOCH: Reproducible build timestamp.
+  - `kettle-release` will set this automatically for the session.
+  - Not needed on bundler >= 2.7.0, as reproducible builds have become the default.
 
 Git hooks and commit message helpers (exe/kettle-commit-msg)
 - GIT_HOOK_BRANCH_VALIDATE: Branch name validation mode (e.g., `jira`) or `false` to disable
@@ -85,7 +102,7 @@ Git hooks and commit message helpers (exe/kettle-commit-msg)
 - GIT_HOOK_FOOTER_SENTINEL: Required when footer append is enabled — a unique first-line sentinel to prevent duplicates
 - GIT_HOOK_FOOTER_APPEND_DEBUG: Extra debug output in the footer template (true/false)
 
-For a quick starting point, this repository’s `.envrc` shows sane defaults, and `.env.local` can override them locally.
+For a quick starting point, this repository’s `mise.toml` defines the shared defaults, and `.env.local` can override them locally. Copy `.env.local.example` to `.env.local`, use `KEY=value` lines, and either activate `mise` in your shell or run commands through `mise exec -C /path/to/project -- ...`.
 
 ## Appraisals
 
@@ -104,22 +121,20 @@ bin/rake appraisal:reset
 
 When adding an appraisal to CI, check the [runner tool cache][🏃‍♂️runner-tool-cache] to see which runner to use.
 
-## The Reek List
-
-Take a look at the `reek` list which is the file called `REEK` and find something to improve.
+## Run Tests
 
-To refresh the `reek` list:
+Run tests via `kettle-test` (provided by `kettle-test`). It runs RSpec, writes the full log to
+`tmp/kettle-test/rspec-TIMESTAMP.log`, and prints a compact highlight block with timing, seed,
+pass/fail count, failing example list, and SimpleCov coverage percentages.
 
 ```console
-bundle exec reek > REEK
+bundle exec kettle-test
 ```
 
-## Run Tests
-
-To run all tests
+For targeted runs, disable the hard coverage threshold to avoid false failures:
 
 ```console
-bundle exec rake test
+K_SOUP_COV_MIN_HARD=false bundle exec kettle-test spec/path/to/spec.rb
 ```
 
 ### Spec organization (required)
@@ -148,7 +163,7 @@ For more detailed information about using RuboCop in this project, please see th
 Never add `# rubocop:disable ...` / `# rubocop:enable ...` comments to code or specs (except when following the few existing `rubocop:disable` patterns for a rule already being disabled elsewhere in the code). Instead:
 
 - Prefer configuration-based exclusions when a rule should not apply to certain paths or files (e.g., via `.rubocop.yml`).
-- When a violation is temporary and you plan to fix it later, record it in `.rubocop_gradual.lock` using the gradual workflow:
+- When a violation is temporary, and you plan to fix it later, record it in `.rubocop_gradual.lock` using the gradual workflow:
   - `bundle exec rake rubocop_gradual:autocorrect` (preferred)
   - `bundle exec rake rubocop_gradual:force_update` (only when you cannot fix the violations immediately)
 
@@ -183,39 +198,41 @@ NOTE: To build without signing the gem set `SKIP_GEM_SIGNING` to any value in th
 1. Update version.rb to contain the correct version-to-be-released.
 2. Run `bundle exec kettle-changelog`.
 3. Run `bundle exec kettle-release`.
+4. Stay awake and monitor the release process for any errors, and answer any prompts.
 
 #### Manual process
 
 1. Run `bin/setup && bin/rake` as a "test, coverage, & linting" sanity check
 2. Update the version number in `version.rb`, and ensure `CHANGELOG.md` reflects changes
 3. Run `bin/setup && bin/rake` again as a secondary check, and to update `Gemfile.lock`
-4. Run `git commit -am "🔖 Prepare release v<VERSION>"` to commit the changes
-5. Run `git push` to trigger the final CI pipeline before release, and merge PRs
+4. Run `bin/rake yard` to regenerate the docs site using the canonical docs task
+5. Run `git commit -am "🔖 Prepare release v<VERSION>"` to commit the changes
+6. Run `git push` to trigger the final CI pipeline before release, and merge PRs
     - NOTE: Remember to [check the build][🧪build].
-6. Run `export GIT_TRUNK_BRANCH_NAME="$(git remote show origin | grep 'HEAD branch' | cut -d ' ' -f5)" && echo $GIT_TRUNK_BRANCH_NAME`
-7. Run `git checkout $GIT_TRUNK_BRANCH_NAME`
-8. Run `git pull origin $GIT_TRUNK_BRANCH_NAME` to ensure latest trunk code
-9. Optional for older Bundler (< 2.7.0): Set `SOURCE_DATE_EPOCH` so `rake build` and `rake release` use the same timestamp and generate the same checksums
+7. Run `export GIT_TRUNK_BRANCH_NAME="$(git remote show origin | grep 'HEAD branch' | cut -d ' ' -f5)" && echo $GIT_TRUNK_BRANCH_NAME`
+8. Run `git checkout $GIT_TRUNK_BRANCH_NAME`
+9. Run `git pull origin $GIT_TRUNK_BRANCH_NAME` to ensure latest trunk code
+10. Optional for older Bundler (< 2.7.0): Set `SOURCE_DATE_EPOCH` so `rake build` and `rake release` use the same timestamp and generate the same checksums
     - If your Bundler is >= 2.7.0, you can skip this; builds are reproducible by default.
     - Run `export SOURCE_DATE_EPOCH=$EPOCHSECONDS && echo $SOURCE_DATE_EPOCH`
     - If the echo above has no output, then it didn't work.
     - Note: `zsh/datetime` module is needed, if running `zsh`.
     - In older versions of `bash` you can use `date +%s` instead, i.e. `export SOURCE_DATE_EPOCH=$(date +%s) && echo $SOURCE_DATE_EPOCH`
-10. Run `bundle exec rake build`
-11. Run `bin/gem_checksums` (more context [1][🔒️rubygems-checksums-pr], [2][🔒️rubygems-guides-pr])
+11. Run `bundle exec rake build`
+12. Run `bin/gem_checksums` (more context [1][🔒️rubygems-checksums-pr], [2][🔒️rubygems-guides-pr])
     to create SHA-256 and SHA-512 checksums. This functionality is provided by the `stone_checksums`
     [gem][💎stone_checksums].
     - The script automatically commits but does not push the checksums
-12. Sanity check the SHA256, comparing with the output from the `bin/gem_checksums` command:
+13. Sanity check the SHA256, comparing with the output from the `bin/gem_checksums` command:
     - `sha256sum pkg/<gem name>-<version>.gem`
-13. Run `bundle exec rake release` which will create a git tag for the version,
+14. Run `bundle exec rake release` which will create a git tag for the version,
     push git commits and tags, and push the `.gem` file to the gem host configured in the gemspec.
 
-[📜src-gl]: https://gitlab.com/kettle-rb/kettle-dev/
+[📜src-gl]: https://gitlab.com/kettle-rb/kettle-dev
 [📜src-cb]: https://codeberg.org/kettle-rb/kettle-dev
 [📜src-gh]: https://github.com/kettle-rb/kettle-dev
 [🧪build]: https://github.com/kettle-rb/kettle-dev/actions
-[🤝conduct]: https://gitlab.com/kettle-rb/kettle-dev/-/blob/main/CODE_OF_CONDUCT.md
+[🤝conduct]: https://github.com/kettle-rb/kettle-dev/blob/main/CODE_OF_CONDUCT.md
 [🖐contrib-rocks]: https://contrib.rocks
 [🖐contributors]: https://github.com/kettle-rb/kettle-dev/graphs/contributors
 [🚎contributors-gl]: https://gitlab.com/kettle-rb/kettle-dev/-/graphs/main
@@ -231,3 +248,4 @@ NOTE: To build without signing the gem set `SKIP_GEM_SIGNING` to any value in th
 [📌major-versions-not-sacred]: https://tom.preston-werner.com/2022/05/23/major-version-numbers-are-not-sacred.html
 [🚎appraisal2]: https://github.com/appraisal-rb/appraisal2
 [🏃‍♂️runner-tool-cache]: https://github.com/ruby/ruby-builder/releases/tag/toolcache
+[✉️discord-invite]: https://discord.gg/3qme4XHNKN

data/FUNDING.md

@@ -19,7 +19,7 @@ Many paths lead to being a sponsor or a backer of this project. Are you on such
 [🖇polar-img]: https://img.shields.io/badge/polar-donate-a51611.svg?style=flat
 [🖇polar]: https://polar.sh/pboling
 [🖇kofi-img]: https://img.shields.io/badge/ko--fi-%E2%9C%93-a51611.svg?style=flat
-[🖇kofi]: https://ko-fi.com/O5O86SNP4
+[🖇kofi]: https://ko-fi.com/pboling
 [🖇patreon-img]: https://img.shields.io/badge/patreon-donate-a51611.svg?style=flat
 [🖇patreon]: https://patreon.com/galtzo
 [🖇buyme-small-img]: https://img.shields.io/badge/buy_me_a_coffee-%E2%9C%93-a51611.svg?style=flat

data/LICENSE.md

@@ -0,0 +1,12 @@
+# License
+
+This project is made available under the following license.
+Choose the option that best fits your use case:
+
+- [AGPL-3.0-only](AGPL-3.0-only.md)
+
+If none of the above licenses fit your use case, please [contact us](mailto:floss@galtzo.com) to discuss a custom commercial license.
+
+## Copyright Notice
+
+Copyright (c) 2023, 2025-2026 Peter H. Boling