kettle-dev 1.1.6 → 1.1.8

data/Appraisals.example

@@ -24,79 +24,77 @@ appraise "unlocked_deps" do
   eval_gemfile "modular/documentation.gemfile"
   eval_gemfile "modular/style.gemfile"
   eval_gemfile "modular/optional.gemfile"
+  eval_gemfile "modular/x_std_libs.gemfile"
 end
 
 # Used for head (nightly) releases of ruby, truffleruby, and jruby.
 # Split into discrete appraisals if one of them needs a dependency locked discretely.
 appraise "head" do
-  gem "mutex_m", ">= 0.2"
-  gem "stringio", ">= 3.0"
   gem "benchmark", "~> 0.4", ">= 0.4.1"
+  eval_gemfile "modular/x_std_libs.gemfile"
 end
 
 # Used for current releases of ruby, truffleruby, and jruby.
 # Split into discrete appraisals if one of them needs a dependency locked discretely.
 appraise "current" do
-  gem "mutex_m", ">= 0.2"
-  gem "stringio", ">= 3.0"
+  eval_gemfile "modular/x_std_libs.gemfile"
+end
+
+# Test current Rubies against head versions of runtime dependencies
+appraise "dep-heads" do
+  eval_gemfile "modular/runtime_heads.gemfile"
 end
 
 appraise "ruby-2-3" do
+  eval_gemfile "modular/x_std_libs/r2.3/libs.gemfile"
 end
 
 appraise "ruby-2-4" do
+  eval_gemfile "modular/x_std_libs/r2.4/libs.gemfile"
 end
 
 appraise "ruby-2-5" do
+  eval_gemfile "modular/x_std_libs/r2.6/libs.gemfile"
 end
 
 appraise "ruby-2-6" do
-  gem "mutex_m", "~> 0.2"
-  gem "stringio", "~> 3.0"
+  eval_gemfile "modular/x_std_libs/r2.6/libs.gemfile"
 end
 
 appraise "ruby-2-7" do
-  gem "mutex_m", "~> 0.2"
-  gem "stringio", "~> 3.0"
+  eval_gemfile "modular/x_std_libs/r3.1/libs.gemfile"
 end
 
 appraise "ruby-3-0" do
-  gem "mutex_m", "~> 0.2"
-  gem "stringio", "~> 3.0"
+  eval_gemfile "modular/x_std_libs/r3.1/libs.gemfile"
 end
 
 appraise "ruby-3-1" do
-  gem "mutex_m", "~> 0.2"
-  gem "stringio", "~> 3.0"
+  eval_gemfile "modular/x_std_libs/r3.1/libs.gemfile"
 end
 
 appraise "ruby-3-2" do
-  gem "mutex_m", "~> 0.2"
-  gem "stringio", "~> 3.0"
+  eval_gemfile "modular/x_std_libs/3/libs.gemfile"
 end
 
 appraise "ruby-3-3" do
-  gem "mutex_m", "~> 0.2"
-  gem "stringio", "~> 3.0"
+  eval_gemfile "modular/x_std_libs/r3/libs.gemfile"
 end
 
 # Only run security audit on the latest version of Ruby
 appraise "audit" do
-  gem "mutex_m", "~> 0.2"
-  gem "stringio", "~> 3.0"
+  eval_gemfile "modular/x_std_libs/r3/libs.gemfile"
 end
 
 # Only run coverage on the latest version of Ruby
 appraise "coverage" do
-  gem "mutex_m", "~> 0.2"
-  gem "stringio", "~> 3.0"
   eval_gemfile "modular/coverage.gemfile"
   eval_gemfile "modular/optional.gemfile"
+  eval_gemfile "modular/x_std_libs/r3/libs.gemfile"
 end
 
 # Only run linter on the latest version of Ruby (but, in support of oldest supported Ruby version)
 appraise "style" do
-  gem "mutex_m", "~> 0.2"
-  gem "stringio", "~> 3.0"
   eval_gemfile "modular/style.gemfile"
+  eval_gemfile "modular/x_std_libs/r3/libs.gemfile"
 end

data/CHANGELOG.md

@@ -24,6 +24,45 @@ Please file a bug if you notice a violation of semantic versioning.
 ### Fixed
 ### Security
 
+## [1.1.8] - 2025-09-07
+- TAG: [v1.1.8][1.1.8t]
+- COVERAGE: 97.16% -- 3246/3341 lines in 23 files
+- BRANCH COVERAGE: 81.95% -- 1344/1640 branches in 23 files
+- 76.97% documented
+### Added
+- add .aiignore to the template
+- add .rubocop_rspec.yml to the template
+- gemfiles/modular/x_std_libs pattern to template, including:
+  - erb
+  - mutex_m
+  - stringio
+- gemfiles/modular/debug.gemfile
+- gemfiles/modular/runtime_heads.gemfile
+- .github/workflows/dep-heads.yml
+- (performance) filter and prioritize example files in the `.github` directory
+- added codecov config to the template
+- Kettle::Dev.default_registered?
+### Fixed
+- run specs as part of the test task
+
+## [1.1.7] - 2025-09-06
+- TAG: [v1.1.7][1.1.7t]
+- COVERAGE: 97.12% -- 3237/3333 lines in 23 files
+- BRANCH COVERAGE: 81.95% -- 1344/1640 branches in 23 files
+- 76.97% documented
+### Added
+- rake task - `appraisal:install`
+  - initial setup for projects that didn't previously use Appraisal
+### Changed
+- .git-hooks/commit-msg allows commit if gitmoji-regex is unavailable
+- simplified `*Task` classes' `task_abort` methods to just raise Kettle::Dev::Error
+  - Allows caller to decide how to handle.
+### Removed
+- addressable, rake runtime dependencies
+  - moved to optional, or development dependencies
+### Fixed
+- Fix local CI via act for templated workflows (skip JRuby in nektos/act locally)
+
 ## [1.1.6] - 2025-09-05
 - TAG: [v1.1.6][1.1.6t]
 - COVERAGE: 97.06% -- 3241/3339 lines in 23 files
@@ -53,7 +92,7 @@ Please file a bug if you notice a violation of semantic versioning.
 ### Removed
 - defensive NameError handling in ChangelogCLI.abort method
 ### Fixed
-- replace token {OPENCOLLECTIVE|ORG_NAME} with funding org name
+- replace token `{OPENCOLLECTIVE|ORG_NAME}` with funding org name
 - prefer .example version of .git-hooks
 - kettle-commit-msg now runs via rubygems (not bundler) so it will work via a system gem
 - fixed logic for handling derivation of forge and funding URLs
@@ -504,7 +543,11 @@ Please file a bug if you notice a violation of semantic versioning.
   - Selecting will run the selected workflow via `act`
   - This may move to its own gem in the future.
 
-[Unreleased]: https://github.com/kettle-rb/kettle-dev/compare/v1.1.6...HEAD
+[Unreleased]: https://github.com/kettle-rb/kettle-dev/compare/v1.1.8...HEAD
+[1.1.8]: https://github.com/kettle-rb/kettle-dev/compare/v1.1.7...v1.1.8
+[1.1.8t]: https://github.com/kettle-rb/kettle-dev/releases/tag/v1.1.8
+[1.1.7]: https://github.com/kettle-rb/kettle-dev/compare/v1.1.6...v1.1.7
+[1.1.7t]: https://github.com/kettle-rb/kettle-dev/releases/tag/v1.1.7
 [1.1.6]: https://github.com/kettle-rb/kettle-dev/compare/v1.1.5...v1.1.6
 [1.1.6t]: https://github.com/kettle-rb/kettle-dev/releases/tag/v1.1.6
 [1.1.5]: https://github.com/kettle-rb/kettle-dev/compare/v1.1.4...v1.1.5

data/Gemfile

@@ -12,15 +12,8 @@ git_source(:gitlab) { |repo_name| "https://gitlab.com/#{repo_name}" }
 # Include dependencies from <gem name>.gemspec
 gemspec
 
-platform :mri do
-  # Debugging - Ensure ENV["DEBUG"] == "true" to use debuggers within spec suite
-  # Use binding.break, binding.b, or debugger in code
-  gem "debug", ">= 1.0.0"                  # ruby >= 2.7
-  gem "gem_bench", "~> 2.0", ">= 2.0.5"
-
-  # Dev Console - Binding.pry - Irb replacement
-  gem "pry", "~> 0.14"                     # ruby >= 2.0
-end
+# Debugging
+eval_gemfile "gemfiles/modular/debug.gemfile"
 
 # Code Coverage
 eval_gemfile "gemfiles/modular/coverage.gemfile"
@@ -37,5 +30,8 @@ eval_gemfile "gemfiles/modular/documentation.gemfile"
 # Optional
 eval_gemfile "gemfiles/modular/optional.gemfile"
 
+### Std Lib Extracted Gems
+eval_gemfile "gemfiles/modular/x_std_libs.gemfile"
+
 # Dependencies injected by the kettle-dev-setup script & kettle:dev:install rake task
 # eval_gemfile "gemfiles/modular/injected.gemfile"

data/Gemfile.example

@@ -12,15 +12,8 @@ git_source(:gitlab) { |repo_name| "https://gitlab.com/#{repo_name}" }
 # Include dependencies from <gem name>.gemspec
 gemspec
 
-platform :mri do
-  # Debugging - Ensure ENV["DEBUG"] == "true" to use debuggers within spec suite
-  # Use binding.break, binding.b, or debugger in code
-  gem "debug", ">= 1.0.0"                  # ruby >= 2.7
-  gem "gem_bench", "~> 2.0", ">= 2.0.5"
-
-  # Dev Console - Binding.pry - Irb replacement
-  gem "pry", "~> 0.14"                     # ruby >= 2.0
-end
+# Debugging
+eval_gemfile "gemfiles/modular/debug.gemfile"
 
 # Code Coverage
 eval_gemfile "gemfiles/modular/coverage.gemfile"
@@ -33,3 +26,6 @@ eval_gemfile "gemfiles/modular/documentation.gemfile"
 
 # Optional
 eval_gemfile "gemfiles/modular/optional.gemfile"
+
+### Std Lib Extracted Gems
+eval_gemfile "gemfiles/modular/x_std_libs.gemfile"

data/README.md

@@ -9,7 +9,7 @@
 
 # 🍲 Kettle::Dev
 
-[![Version][👽versioni]][👽version] [![GitHub tag (latest SemVer)][⛳️tag-img]][⛳️tag] [![License: MIT][📄license-img]][📄license-ref] [![Downloads Rank][👽dl-ranki]][👽dl-rank] [![Open Source Helpers][👽oss-helpi]][👽oss-help] [![CodeCov Test Coverage][🔑codecovi]][🔑codecov] [![Coveralls Test Coverage][🔑coveralls-img]][🔑coveralls] [![QLTY Test Coverage][🔑qlty-covi]][🔑qlty-cov] [![QLTY Maintainability][🔑qlty-mnti]][🔑qlty-mnt] [![CI Heads][🚎3-hd-wfi]][🚎3-hd-wf] [![CI Current][🚎11-c-wfi]][🚎11-c-wf] [![CI Truffle Ruby][🚎9-t-wfi]][🚎9-t-wf] [![CI JRuby][🚎10-j-wfi]][🚎10-j-wf] [![Deps Locked][🚎13-🔒️-wfi]][🚎13-🔒️-wf] [![Deps Unlocked][🚎14-🔓️-wfi]][🚎14-🔓️-wf] [![CI Supported][🚎6-s-wfi]][🚎6-s-wf] [![CI Legacy][🚎4-lg-wfi]][🚎4-lg-wf] [![CI Unsupported][🚎7-us-wfi]][🚎7-us-wf] [![CI Ancient][🚎1-an-wfi]][🚎1-an-wf] [![CI Test Coverage][🚎2-cov-wfi]][🚎2-cov-wf] [![CI Style][🚎5-st-wfi]][🚎5-st-wf] [![CodeQL][🖐codeQL-img]][🖐codeQL]
+[![Version][👽versioni]][👽version] [![GitHub tag (latest SemVer)][⛳️tag-img]][⛳️tag] [![License: MIT][📄license-img]][📄license-ref] [![Downloads Rank][👽dl-ranki]][👽dl-rank] [![Open Source Helpers][👽oss-helpi]][👽oss-help] [![CodeCov Test Coverage][🔑codecovi]][🔑codecov] [![Coveralls Test Coverage][🔑coveralls-img]][🔑coveralls] [![QLTY Test Coverage][🔑qlty-covi]][🔑qlty-cov] [![QLTY Maintainability][🔑qlty-mnti]][🔑qlty-mnt] [![CI Heads][🚎3-hd-wfi]][🚎3-hd-wf] [![CI Runtime Dependencies @ HEAD][🚎12-crh-wfi]][🚎12-crh-wf] [![CI Current][🚎11-c-wfi]][🚎11-c-wf] [![CI Truffle Ruby][🚎9-t-wfi]][🚎9-t-wf] [![CI JRuby][🚎10-j-wfi]][🚎10-j-wf] [![Deps Locked][🚎13-🔒️-wfi]][🚎13-🔒️-wf] [![Deps Unlocked][🚎14-🔓️-wfi]][🚎14-🔓️-wf] [![CI Supported][🚎6-s-wfi]][🚎6-s-wf] [![CI Legacy][🚎4-lg-wfi]][🚎4-lg-wf] [![CI Unsupported][🚎7-us-wfi]][🚎7-us-wf] [![CI Ancient][🚎1-an-wfi]][🚎1-an-wf] [![CI Test Coverage][🚎2-cov-wfi]][🚎2-cov-wf] [![CI Style][🚎5-st-wfi]][🚎5-st-wf] [![CodeQL][🖐codeQL-img]][🖐codeQL]
 
 If ☝️ `ci_badges.map(&:color).detect { it != "green"}`  [let me know][🖼️galtzo-discord], as I may have missed the [discord notification][🖼️galtzo-discord].
 
@@ -853,6 +853,8 @@ Thanks for RTFM. ☺️
 [🚎10-j-wfi]: https://github.com/kettle-rb/kettle-dev/actions/workflows/jruby.yml/badge.svg
 [🚎11-c-wf]: https://github.com/kettle-rb/kettle-dev/actions/workflows/current.yml
 [🚎11-c-wfi]: https://github.com/kettle-rb/kettle-dev/actions/workflows/current.yml/badge.svg
+[🚎12-crh-wf]: https://github.com/kettle-rb/kettle-dev/actions/workflows/dep-heads.yml
+[🚎12-crh-wfi]: https://github.com/kettle-rb/kettle-dev/actions/workflows/dep-heads.yml/badge.svg
 [🚎13-🔒️-wf]: https://github.com/kettle-rb/kettle-dev/actions/workflows/locked_deps.yml
 [🚎13-🔒️-wfi]: https://github.com/kettle-rb/kettle-dev/actions/workflows/locked_deps.yml/badge.svg
 [🚎14-🔓️-wf]: https://github.com/kettle-rb/kettle-dev/actions/workflows/unlocked_deps.yml
@@ -905,7 +907,7 @@ Thanks for RTFM. ☺️
 [📌gitmoji]:https://gitmoji.dev
 [📌gitmoji-img]:https://img.shields.io/badge/gitmoji_commits-%20%F0%9F%98%9C%20%F0%9F%98%8D-34495e.svg?style=flat-square
 [🧮kloc]: https://www.youtube.com/watch?v=dQw4w9WgXcQ
-[🧮kloc-img]: https://img.shields.io/badge/KLOC-3.339-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
+[🧮kloc-img]: https://img.shields.io/badge/KLOC-3.341-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

data/README.md.example

@@ -505,7 +505,7 @@ Thanks for RTFM. ☺️
 [📌gitmoji]:https://gitmoji.dev
 [📌gitmoji-img]:https://img.shields.io/badge/gitmoji_commits-%20%F0%9F%98%9C%20%F0%9F%98%8D-34495e.svg?style=flat-square
 [🧮kloc]: https://www.youtube.com/watch?v=dQw4w9WgXcQ
-[🧮kloc-img]: https://img.shields.io/badge/KLOC-3.339-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
+[🧮kloc-img]: https://img.shields.io/badge/KLOC-3.341-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

data/Rakefile.example

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# kettle-dev Rakefile v1.1.6 - 2025-09-05
+# kettle-dev Rakefile v1.1.8 - 2025-09-07
 # Ruby 2.3 (Safe Navigation) or higher required
 #
 # MIT License (see License.txt)

data/gemfiles/modular/debug.gemfile

@@ -0,0 +1,13 @@
+# Ex-Standard Library gems
+gem "irb", "~> 1.15", ">= 1.15.2" # removed from stdlib in 3.5
+
+platform :mri do
+  # Debugging - Ensure ENV["DEBUG"] == "true" to use debuggers within spec suite
+  # Use binding.break, binding.b, or debugger in code
+  gem "debug", ">= 1.1"                     # ruby >= 2.7
+
+  # Dev Console - Binding.pry - Irb replacement
+  # gem "pry", "~> 0.14"                     # ruby >= 2.0
+end
+
+gem "gem_bench", "~> 2.0", ">= 2.0.5"

data/gemfiles/modular/erb/r2/v3.0.gemfile

@@ -0,0 +1 @@
+gem "erb", "~> 3.0"   # ruby >= 2.7.0

data/gemfiles/modular/erb/r2.3/default.gemfile

@@ -0,0 +1,6 @@
+# The cake is a lie.
+# erb v2.2, the oldest release on RubyGems.org, was never compatible with Ruby 2.3.
+# In addition, erb does not follow SemVer, and old rubies get dropped in a patch.
+# This means we have no choice but to use the erb that shipped with Ruby 2.3
+# /opt/hostedtoolcache/Ruby/2.3.8/x64/lib/ruby/gems/2.3.0/gems/erb-2.2.2/lib/erb.rb:670:in `prepare_trim_mode': undefined method `match?' for "-":String (NoMethodError)
+# gem "erb", ">= 2.2"   # ruby >= 2.3.0

data/gemfiles/modular/erb/r2.6/v2.2.gemfile

@@ -0,0 +1,3 @@
+# Ruby >= 2.3.0 (claimed, but not true, minimum support is Ruby 2.4)
+# Last version supporting Ruby <= 2.6
+gem "erb", "~> 2.2.2"

data/gemfiles/modular/erb/r3/v5.0.gemfile

@@ -0,0 +1 @@
+gem "erb", "~> 5.0"   # ruby >= 3.2.0

data/gemfiles/modular/erb/r3.1/v4.0.gemfile

@@ -0,0 +1,2 @@
+# last version compatible with Ruby 3.1
+gem "erb", "~> 4.0"   # ruby >= 2.7.0

data/gemfiles/modular/erb/vHEAD.gemfile

@@ -0,0 +1,2 @@
+# Ruby >= 3.2 (dependency of kettle-dev)
+gem "erb", github: "ruby/erb", branch: "master"

data/gemfiles/modular/mutex_m/r2/v0.3.gemfile

@@ -0,0 +1,2 @@
+# Ruby >= 2.5
+gem "mutex_m", "~> 0.2"

data/gemfiles/modular/mutex_m/r2.4/v0.1.gemfile

@@ -0,0 +1,3 @@
+# Ruby >= 0
+# Last version supporting Ruby <= 2.4
+gem "mutex_m", "~> 0.1"

data/gemfiles/modular/mutex_m/r3/v0.3.gemfile

@@ -0,0 +1,2 @@
+# Ruby >= 2.5
+gem "mutex_m", "~> 0.2"

data/gemfiles/modular/mutex_m/vHEAD.gemfile

@@ -0,0 +1,2 @@
+# Ruby >= 2.5 (dependency of omniauth)
+gem "mutex_m", github: "ruby/mutex_m", branch: "master"

data/gemfiles/modular/optional.gemfile

@@ -2,4 +2,7 @@
 # git gem is not a direct dependency for two reasons:
 # 1. it is incompatible with Truffleruby v23
 # 2. it depends on activesupport, which is too heavy
-gem "git", ">= 1.19.1"    # ruby >= 2.3
+gem "git", ">= 1.19.1"             # ruby >= 2.3
+
+# URL parsing with Unicode support (falls back to URI if not available)
+gem "addressable", ">= 2.8", "< 3" # ruby >= 2.2

data/gemfiles/modular/runtime_heads.gemfile

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+# Test against HEAD of runtime dependencies so we can proactively file bugs
+
+# Ruby >= 2.2
+gem "version_gem", github: "ruby-oauth/version_gem", branch: "main"
+
+eval_gemfile("x_std_libs/vHEAD.gemfile")
+
+eval_gemfile("recording/vHEAD.gemfile")

data/gemfiles/modular/stringio/r2/v3.0.gemfile

@@ -0,0 +1,5 @@
+# !!WARNING!!
+#   NOT SEMVER
+# Version 3.0.7 dropped support for Ruby <= 2.7
+# Version 3.0.0 dropped support for Ruby <= 2.4
+gem "stringio", ">= 3.0"

data/gemfiles/modular/stringio/r2.4/v0.0.2.gemfile

@@ -0,0 +1,4 @@
+# !!WARNING!!
+#   NOT SEMVER
+# Last version to support Ruby <= 2.5
+gem "stringio", ">= 0.0.2"

data/gemfiles/modular/stringio/r3/v3.0.gemfile

@@ -0,0 +1,5 @@
+# !!WARNING!!
+#   NOT SEMVER
+# Version 3.0.7 dropped support for Ruby <= 2.7
+# Version 3.0.0 dropped support for Ruby <= 2.4
+gem "stringio", ">= 3.0"

data/gemfiles/modular/stringio/vHEAD.gemfile

@@ -0,0 +1,2 @@
+# Ruby >= 2.5 (dependency of omniauth)
+gem "stringio", github: "ruby/stringio", branch: "master"

data/gemfiles/modular/x_std_libs/r2/libs.gemfile

@@ -0,0 +1,3 @@
+eval_gemfile "../../erb/r2/v3.0.gemfile"
+eval_gemfile "../../mutex_m/r2/v0.3.gemfile"
+eval_gemfile "../../stringio/r2/v3.0.gemfile"

data/gemfiles/modular/x_std_libs/r2.3/libs.gemfile

@@ -0,0 +1,3 @@
+eval_gemfile "../../erb/r2.3/default.gemfile"
+eval_gemfile "../../mutex_m/r2.4/v0.1.gemfile"
+eval_gemfile "../../stringio/r2.4/v0.0.2.gemfile"

data/gemfiles/modular/x_std_libs/r2.4/libs.gemfile

@@ -0,0 +1,3 @@
+eval_gemfile "../../erb/r2.6/v2.2.gemfile"
+eval_gemfile "../../mutex_m/r2.4/v0.1.gemfile"
+eval_gemfile "../../stringio/r2.4/v0.0.2.gemfile"

data/gemfiles/modular/x_std_libs/r2.6/libs.gemfile

@@ -0,0 +1,3 @@
+eval_gemfile "../../erb/r2.6/v2.2.gemfile"
+eval_gemfile "../../mutex_m/r2/v0.3.gemfile"
+eval_gemfile "../../stringio/r2/v3.0.gemfile"

data/gemfiles/modular/x_std_libs/r3/libs.gemfile

@@ -0,0 +1,3 @@
+eval_gemfile "../../erb/r3/v5.0.gemfile"
+eval_gemfile "../../mutex_m/r3/v0.3.gemfile"
+eval_gemfile "../../stringio/r3/v3.0.gemfile"

data/gemfiles/modular/x_std_libs/r3.1/libs.gemfile

@@ -0,0 +1,3 @@
+eval_gemfile "../../erb/r3.1/v4.0.gemfile"
+eval_gemfile "../../mutex_m/r3/v0.3.gemfile"
+eval_gemfile "../../stringio/r3/v3.0.gemfile"

data/gemfiles/modular/x_std_libs/vHEAD.gemfile

@@ -0,0 +1,3 @@
+eval_gemfile "../erb/vHEAD.gemfile"
+eval_gemfile "../mutex_m/vHEAD.gemfile"
+eval_gemfile "../stringio/vHEAD.gemfile"

data/gemfiles/modular/x_std_libs.gemfile

@@ -0,0 +1,2 @@
+### Std Lib Extracted Gems
+eval_gemfile "x_std_libs/r3/libs.gemfile"

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

@@ -4,6 +4,33 @@
 begin
   require "appraisal/task"
 
+  desc("Install Appraisal gemfiles (initial setup for projects that didn't previously use Appraisal)")
+  task("appraisal:install") do
+    bundle = Gem.bindir ? File.join(Gem.bindir, "bundle") : "bundle"
+
+    run_in_unbundled = proc do
+      env = {"BUNDLE_GEMFILE" => "Appraisal.root.gemfile"}
+
+      # 1) bundle install --gemfile Appraisal.root.gemfile
+      ok = system(bundle, "install", "--gemfile", "Appraisal.root.gemfile")
+      abort("appraisal:install failed: bundle install --gemfile Appraisal.root.gemfile") unless ok
+
+      # 2) BUNDLE_GEMFILE=Appraisal.root.gemfile bundle exec appraisal install
+      ok = system(env, bundle, "exec", "appraisal", "install")
+      abort("appraisal:install failed: bundle exec appraisal install") unless ok
+
+      # 3) bundle exec rake rubocop_gradual:autocorrect
+      ok = system(bundle, "exec", "rake", "rubocop_gradual:autocorrect")
+      abort("appraisal:update failed: rubocop_gradual:autocorrect") unless ok
+    end
+
+    if defined?(Bundler)
+      Bundler.with_unbundled_env(&run_in_unbundled)
+    else
+      run_in_unbundled.call
+    end
+  end
+
   desc("Update Appraisal gemfiles and run RuboCop Gradual autocorrect")
   task("appraisal:update") do
     bundle = Gem.bindir ? File.join(Gem.bindir, "bundle") : "bundle"

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

@@ -2,22 +2,8 @@
 
 require "fileutils"
 
-# Setup RSpec
-begin
-  require "rspec/core/rake_task"
-
-  RSpec::Core::RakeTask.new(:spec)
-  # This takes the place of `coverage` task when running as CI=true
-  Kettle::Dev.register_default("spec") if Kettle::Dev::IS_CI
-rescue LoadError
-  warn("[kettle-dev][spec_test.rake] failed to load rspec/core/rake_task") if Kettle::Dev::DEBUGGING
-  desc("spec task stub")
-  task(:spec) do
-    warn("NOTE: rspec isn't installed, or is disabled for #{RUBY_VERSION} in the current environment")
-  end
-end
-
-# Setup MiniTest
+# rubocop:disable Rake/DuplicateTask
+# Set up MiniTest
 begin
   require "rake/testtask"
 
@@ -26,6 +12,7 @@ begin
     t.test_files = FileList["test/**/*test*.rb"]
     t.verbose = true
   end
+  Kettle::Dev.register_default("test")
 rescue LoadError
   warn("[kettle-dev][spec_test.rake] failed to load rake/testtask") if Kettle::Dev::DEBUGGING
   desc("test task stub")
@@ -33,3 +20,35 @@ rescue LoadError
     warn("NOTE: minitest isn't installed, or is disabled for #{RUBY_VERSION} in the current environment")
   end
 end
+
+# Setup RSpec
+begin
+  require "rspec/core/rake_task"
+
+  RSpec::Core::RakeTask.new(:spec)
+  # This takes the place of `coverage` task it hasn't been registered yet.
+  Kettle::Dev.register_default("spec") unless Kettle::Dev.default_registered?("coverage")
+rescue LoadError
+  warn("[kettle-dev][spec_test.rake] failed to load rspec/core/rake_task") if Kettle::Dev::DEBUGGING
+  desc("spec task stub")
+  task(:spec) do
+    warn("NOTE: rspec isn't installed, or is disabled for #{RUBY_VERSION} in the current environment")
+  end
+end
+
+spec_registered = Kettle::Dev.default_registered?("spec")
+coverage_registered = Kettle::Dev.default_registered?("coverage")
+test_registered = Kettle::Dev.default_registered?("test")
+spec_or_coverage = spec_registered || coverage_registered
+
+if spec_or_coverage && !test_registered
+  task test: :spec
+elsif test_registered && !spec_or_coverage
+  task spec: :test
+elsif test_registered && spec_or_coverage
+  # When we have both tasks registered, make spec run as part of the test task
+  task test: :spec
+else
+  puts "No test task is registered."
+end
+# rubocop:enable Rake/DuplicateTask

data/lib/kettle/dev/tasks/ci_task.rb

@@ -15,11 +15,7 @@ module Kettle
 
         # Local abort indirection to enable mocking via ExitAdapter
         def task_abort(msg)
-          if defined?(RSpec)
-            raise Kettle::Dev::Error, msg
-          else
-            Kettle::Dev::ExitAdapter.abort(msg)
-          end
+          raise Kettle::Dev::Error, msg
         end
 
         # Runs `act` for a selected workflow. Option can be a short code or workflow basename.

data/lib/kettle/dev/tasks/install_task.rb

@@ -6,13 +6,11 @@ module Kettle
       module InstallTask
         module_function
 
-        # Abort wrapper that avoids terminating the entire process during specs
+        # Abort wrapper that avoids terminating the current rake task process.
+        # Always raise Kettle::Dev::Error so callers can decide whether to handle
+        # it without terminating the process (e.g., in tests or non-interactive runs).
         def task_abort(msg)
-          if defined?(RSpec)
-            raise Kettle::Dev::Error, msg
-          else
-            Kettle::Dev::ExitAdapter.abort(msg)
-          end
+          raise Kettle::Dev::Error, msg
         end
 
         def run

data/lib/kettle/dev/tasks/template_task.rb

@@ -10,11 +10,7 @@ module Kettle
 
         # Abort wrapper that avoids terminating the entire process during specs
         def task_abort(msg)
-          if defined?(RSpec)
-            raise Kettle::Dev::Error, msg
-          else
-            Kettle::Dev::ExitAdapter.abort(msg)
-          end
+          raise Kettle::Dev::Error, msg
         end
 
         # Execute the template operation into the current project.
@@ -45,9 +41,21 @@ module Kettle
           # 2) .github/**/*.yml with FUNDING.yml customizations
           source_github_dir = File.join(gem_checkout_root, ".github")
           if Dir.exist?(source_github_dir)
-            files = Dir.glob(File.join(source_github_dir, "**", "*.yml")) +
+            # Build a unique set of logical .yml paths, preferring the .example variant when present
+            candidates = Dir.glob(File.join(source_github_dir, "**", "*.yml")) +
               Dir.glob(File.join(source_github_dir, "**", "*.yml.example"))
-            files.uniq.each do |orig_src|
+            selected = {}
+            candidates.each do |path|
+              # Key by the path without the optional .example suffix
+              key = path.sub(/\.example\z/, "")
+              # Prefer example: overwrite a plain selection with .example, but do not downgrade
+              if path.end_with?(".example")
+                selected[key] = path
+              else
+                selected[key] ||= path
+              end
+            end
+            selected.values.each do |orig_src|
               src = helpers.prefer_example(orig_src)
               # Destination path should never include the .example suffix.
               rel = orig_src.sub(/^#{Regexp.escape(gem_checkout_root)}\/?/, "").sub(/\.example\z/, "")
@@ -155,6 +163,20 @@ module Kettle
             end
           end
 
+          # 4b) Additional modular gemfiles to include
+          ["debug.gemfile", "runtime_heads.gemfile"].each do |fname|
+            src = helpers.prefer_example(File.join(gem_checkout_root, "gemfiles/modular", fname))
+            dest = File.join(project_root, "gemfiles/modular", fname)
+            helpers.copy_file_with_prompt(src, dest, allow_create: true, allow_replace: true)
+          end
+
+          # 4c) Copy modular directories with nested/versioned files
+          %w[erb mutex_m stringio x_std_libs].each do |dir|
+            src_dir = File.join(gem_checkout_root, "gemfiles/modular", dir)
+            dest_dir = File.join(project_root, "gemfiles/modular", dir)
+            helpers.copy_dir_with_prompt(src_dir, dest_dir)
+          end
+
           # 5) spec/spec_helper.rb (no create)
           dest_spec_helper = File.join(project_root, "spec/spec_helper.rb")
           if File.file?(dest_spec_helper)
@@ -351,16 +373,20 @@ module Kettle
           end
 
           files_to_copy = %w[
+            .aiignore
             .envrc
             .gitignore
             .gitlab-ci.yml
+            .junie/guidelines-rbs.md
+            .junie/guidelines.md
+            .opencollective.yml
             .rspec
             .rubocop.yml
+            .rubocop_rspec.yml
             .simplecov
             .tool-versions
             .yard_gfm_support.rb
             .yardopts
-            .opencollective.yml
             Appraisal.root.gemfile
             Appraisals
             CHANGELOG.md
@@ -369,12 +395,10 @@ module Kettle
             CONTRIBUTING.md
             FUNDING.md
             Gemfile
-            Rakefile
             README.md
             RUBOCOP.md
+            Rakefile
             SECURITY.md
-            .junie/guidelines.md
-            .junie/guidelines-rbs.md
           ]
 
           # Snapshot existing README content once (for H1 prefix preservation after write)