kettle-dev 1.1.47 → 1.1.49

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ce61aa17df248a723743179807ea6da8b1c139dbd2555459a69035b4a33338bd
-  data.tar.gz: 7eb08bdf8772350131a62caa2ac893de26871ab093d671ee798b5a1edb7a97b0
+  metadata.gz: f95a45a4ef2762a84b2f36e6824a97e34c050368c6125f74b41efcabd2465549
+  data.tar.gz: 49899dfdd780feb8134b5999aad8c3e5230361b70e8e99caf4d3529e1e46387e
 SHA512:
-  metadata.gz: 7936fd630aab1b64ab97ae9b52a570524b5c20ddc576bddbb10df3ee6dd05e26a736e33c34cbe3ba7cebd903c112d68440d9863f5ade11ae7c18f84cc1d08b68
-  data.tar.gz: cec2cbdcab872105c822f07d0539ccd08c8ad66aa1a1e7ded93a1c8d3f790a1efc48449f0810dc4128e201d32aa517fde4c5054f4a7e604c1b4e0cda630d3155
+  metadata.gz: 85cb8912a3fc282d2985c901635ed57336e195cc98fad631931bb04488623f5274c057b9b7c55ab24bb1a4ea256dd2c3ec48b95010403bb3b697297c838822d5
+  data.tar.gz: ee8ffd0f7f5bbc36c5d81bc2dc122666a10dd7b4c4b50f34c79fc5e65308354e28e980466af60e95d5d99527412428d161147ee9a2f71f00967d59f9c1468e96

checksums.yaml.gz.sig

@@ -1,4 +1,4 @@
-?H�3UW�	�<D
-����1t4�`����$a���%���Z!p��̰���Ʉ�_�D��u�	��cF��1��1q`e%<G#�
-��܃�gE���֜m��.57q���<��i����, ��!�k��?woW/�6�B�3�%+\
��T���bn�y���63���\�<%ȱ����I���I��'���a����e�xPo`7XUI%ި�ۧ�5_*�j��M/U%O�ehx	ҫӑ��#6E���j���qO�^VĤ(:^�F��tn�JE�7T�@5�Ծ�
-�3�uȴ�Cf&�K>�� _M��ãou�3����wƙ��N_.���_a������)���g���	��۹�\Q�l��
+|� �K� �O��nE�G����@�����*Й����Z�;�����D�=P[Ec�M��1�؝^�!MWΎ�A��f�a
+��>V)<
+���Q#�|�c��jOE|3��J����{˔x��W��ې�:0�"�?���|IrM��ks�Z���~+���8TTD��M*��Igc���M���^�ԖD�� z�e�|5)�� �s�5{����UC��H���ŕ�a�r�ULN�����N]�����*���{��	_�8�w���X�����-�#{;ǰ"��v�y�|��g/��������zdr�K��;���X'����\�Ѩ������
+��oWj��	�

data/.envrc

@@ -21,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=79 # Means you want to enforce X% branch coverage
-export K_SOUP_COV_MIN_LINE=95 # 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=92 # 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/coverage.yml

@@ -6,9 +6,8 @@ permissions:
   id-token: write
 
 env:
-  # Lower than local, which is at 100/100, because rubocop-lts isn't installed in the coverage workflow
-  K_SOUP_COV_MIN_BRANCH: 78
-  K_SOUP_COV_MIN_LINE: 93
+  K_SOUP_COV_MIN_BRANCH: 77
+  K_SOUP_COV_MIN_LINE: 92
   K_SOUP_COV_MIN_HARD: true
   K_SOUP_COV_FORMATTERS: "xml,rcov,lcov,tty"
   K_SOUP_COV_DO: true
@@ -116,7 +115,7 @@ jobs:
           hide_complexity: true
           indicators: true
           output: both
-          thresholds: '93 78'
+          thresholds: '92 77'
         continue-on-error: ${{ matrix.experimental != 'false' }}
 
       - name: Add Coverage PR Comment

data/.junie/guidelines.md

@@ -47,7 +47,6 @@ This document captures project-specific knowledge to streamline setup, testing,
   - RSpec 3.13 with custom spec/spec_helper.rb configuration:
     - silent_stream: STDOUT is silenced by default for examples to keep logs clean.
       - To explicitly test console output, tag the example or group with :check_output.
-    - Global state hygiene: Around each example, FlossFunding.namespaces and FlossFunding.silenced are snapshotted and restored to prevent cross-test pollution.
     - DEBUG toggle: Set DEBUG=true to require 'debug' and avoid silencing output during your run.
     - ENV seeding: The suite sets ENV["FLOSS_FUNDING_FLOSS_FUNDING"] = "Free-as-in-beer" so that the library’s own namespace is considered activated (avoids noisy warnings).
     - Coverage: kettle-soup-cover integrates SimpleCov; .simplecov is invoked from spec_helper when enabled by Kettle::Soup::Cover::DO_COV, which is controlled by K_SOUP_COV_DO being set to true / false.
@@ -73,10 +72,11 @@ This document captures project-specific knowledge to streamline setup, testing,
   - Output visibility
     - To see STDOUT from the code under test, use the :check_output tag on the example or group.
       Example:
-      RSpec.describe "output", :check_output do
-        it "prints" do
-          puts "This output should be visible"
-          expect(true).to be true
+      RSpec.describe "with output", :check_output do
+        it "has output" do
+          output = capture(:stderr) {kernel.warn("This is a warning")}
+          logs = [ "This is a warning\n" ]
+          expect(output).to(include(*logs))
         end
       end
     - Alternatively, run with DEBUG=true to disable silencing for the entire run.

data/.junie/guidelines.md.example

@@ -47,9 +47,7 @@ This document captures project-specific knowledge to streamline setup, testing,
   - RSpec 3.13 with custom spec/spec_helper.rb configuration:
     - silent_stream: STDOUT is silenced by default for examples to keep logs clean.
       - To explicitly test console output, tag the example or group with :check_output.
-    - Global state hygiene: Around each example, FlossFunding.namespaces and FlossFunding.silenced are snapshotted and restored to prevent cross-test pollution.
     - DEBUG toggle: Set DEBUG=true to require 'debug' and avoid silencing output during your run.
-    - ENV seeding: The suite sets ENV["FLOSS_FUNDING_FLOSS_FUNDING"] = "Free-as-in-beer" so that the library’s own namespace is considered activated (avoids noisy warnings).
     - Coverage: kettle-soup-cover integrates SimpleCov; .simplecov is invoked from spec_helper when enabled by Kettle::Soup::Cover::DO_COV, which is controlled by K_SOUP_COV_DO being set to true / false.
     - RSpec.describe usage:
       - Use `describe "#<method_name>"` to contain a block of specs that test instance method behavior.
@@ -73,10 +71,11 @@ This document captures project-specific knowledge to streamline setup, testing,
   - Output visibility
     - To see STDOUT from the code under test, use the :check_output tag on the example or group.
       Example:
-      RSpec.describe "output", :check_output do
-        it "prints" do
-          puts "This output should be visible"
-          expect(true).to be true
+      RSpec.describe "with output", :check_output do
+        it "has output" do
+          output = capture(:stderr) {kernel.warn("This is a warning")}
+          logs = [ "This is a warning\n" ]
+          expect(output).to(include(*logs))
         end
       end
     - Alternatively, run with DEBUG=true to disable silencing for the entire run.

data/.rubocop_rspec.yml

@@ -18,7 +18,7 @@ RSpec/InstanceVariable:
 
 RSpec/NestedGroups:
   Enabled: false
-  
+
 RSpec/ExpectInHook:
   Enabled: false
 

data/.yardopts

@@ -1,11 +1,12 @@
+--plugin fence
+-e yard/fence/hoist.rb
 --plugin junk
 --plugin relative_markdown_links
---readme README.md
+--readme tmp/yard-fence/README.md
 --charset utf-8
 --markup markdown
 --output docs
---load .yard_gfm_support.rb
 'lib/**/*.rb'
 -
-'*.md'
-'*.txt'
+'tmp/yard-fence/*.md'
+'tmp/yard-fence/*.txt'

data/Appraisals

@@ -136,6 +136,8 @@ appraise "coverage" do
   eval_gemfile "modular/optional.gemfile"
   eval_gemfile "modular/recording/r3/recording.gemfile"
   eval_gemfile "modular/x_std_libs.gemfile"
+  # Normally style is included in coverage runs only, but we need it for the test suite to get full coverage
+  eval_gemfile "modular/style.gemfile"
   # Dependencies injected by the kettle-dev-setup script & kettle:dev:install rake task
   #  eval_gemfile "modular/injected.gemfile"
 end

data/CHANGELOG.md

@@ -30,6 +30,30 @@ Please file a bug if you notice a violation of semantic versioning.
 
 ### Security
 
+## [1.1.49] - 2025-11-07
+
+- TAG: [v1.1.49][1.1.49t]
+- COVERAGE: 94.39% -- 4038/4278 lines in 26 files
+- BRANCH COVERAGE: 78.93% -- 1663/2107 branches in 26 files
+- 79.89% documented
+
+### Added
+
+- yard-fence for handling braces in fenced code blocks in yard docs
+- Improved documentation
+
+## [1.1.48] - 2025-11-06
+
+- TAG: [v1.1.48][1.1.48t]
+- COVERAGE: 94.39% -- 4038/4278 lines in 26 files
+- BRANCH COVERAGE: 78.93% -- 1663/2107 branches in 26 files
+- 79.89% documented
+
+### Fixed
+
+- Typo in markdown link
+- Handling of pre-existing gemfile
+
 ## [1.1.47] - 2025-11-06
 
 - TAG: [v1.1.47][1.1.47t]
@@ -1283,7 +1307,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.47...HEAD
+[Unreleased]: https://github.com/kettle-rb/kettle-dev/compare/v1.1.49...HEAD
+[1.1.49]: https://github.com/kettle-rb/kettle-dev/compare/v1.1.48...v1.1.49
+[1.1.49t]: https://github.com/kettle-rb/kettle-dev/releases/tag/v1.1.49
+[1.1.48]: https://github.com/kettle-rb/kettle-dev/compare/v1.1.47...v1.1.48
+[1.1.48t]: https://github.com/kettle-rb/kettle-dev/releases/tag/v1.1.48
 [1.1.47]: https://github.com/kettle-rb/kettle-dev/compare/v1.1.46...v1.1.47
 [1.1.47t]: https://github.com/kettle-rb/kettle-dev/releases/tag/v1.1.47
 [1.1.46]: https://github.com/kettle-rb/kettle-dev/compare/v1.1.45...v1.1.46

data/FUNDING.md

@@ -31,11 +31,11 @@ Many paths lead to being a sponsor or a backer of this project. Are you on such
 
 <!-- RELEASE-NOTES-FOOTER-END -->
 
-# 🤑 Request for Help
+# 🤑 A request for help
 
 Maintainers have teeth and need to pay their dentists.
-After getting laid off in an RIF in March and filled with many dozens of rejections,
-I'm now spending ~60+ hours a week building open source tools.
+After getting laid off in an RIF in March, and encountering difficulty finding a new one,
+I began spending most of my time building open source tools.
 I'm hoping to be able to pay for my kids' health insurance this month,
 so if you value the work I am doing, I need your support.
 Please consider sponsoring me or the project.
@@ -44,16 +44,13 @@ To join the community or get help 👇️ Join the Discord.
 
 [![Live Chat on Discord][✉️discord-invite-img-ftb]][✉️discord-invite]
 
-To say "thanks for maintaining such a great tool" ☝️ Join the Discord or 👇️ send money.
+To say "thanks!" ☝️ Join the Discord or 👇️ send money.
 
 [![Sponsor kettle-rb/kettle-dev on Open Source Collective][🖇osc-all-bottom-img]][🖇osc] 💌 [![Sponsor me on GitHub Sponsors][🖇sponsor-bottom-img]][🖇sponsor] 💌 [![Sponsor me on Liberapay][⛳liberapay-bottom-img]][⛳liberapay] 💌 [![Donate on PayPal][🖇paypal-bottom-img]][🖇paypal]
 
 # Another Way to Support Open Source Software
 
-> How wonderful it is that nobody need wait a single moment before starting to improve the world.<br/>
->—Anne Frank
-
-I’m driven by a passion to foster a thriving open-source community – a space where people can tackle complex problems, no matter how small.  Revitalizing libraries that have fallen into disrepair, and building new libraries focused on solving real-world challenges, are my passions — totaling 79 hours of FLOSS coding over just the past seven days, a pretty regular week for me.  I was recently affected by layoffs, and the tech jobs market is unwelcoming. I’m reaching out here because your support would significantly aid my efforts to provide for my family, and my farm (11 🐔 chickens, 2 🐶 dogs, 3 🐰 rabbits, 8 🐈‍ cats).
+I’m driven by a passion to foster a thriving open-source community – a space where people can tackle complex problems, no matter how small.  Revitalizing libraries that have fallen into disrepair, and building new libraries focused on solving real-world challenges, are my passions.  I was recently affected by layoffs, and the tech jobs market is unwelcoming. I’m reaching out here because your support would significantly aid my efforts to provide for my family, and my farm (11 🐔 chickens, 2 🐶 dogs, 3 🐰 rabbits, 8 🐈‍ cats).
 
 If you work at a company that uses my work, please encourage them to support me as a corporate sponsor. My work on gems you use might show up in `bundle fund`.
 

data/FUNDING.md.no-osc.example

@@ -27,11 +27,11 @@ Many paths lead to being a sponsor or a backer of this project. Are you on such
 
 <!-- RELEASE-NOTES-FOOTER-END -->
 
-# 🤑 Request for Help
+# 🤑 A request for help
 
 Maintainers have teeth and need to pay their dentists.
-After getting laid off in an RIF in March and filled with many dozens of rejections,
-I'm now spending ~60+ hours a week building open source tools.
+After getting laid off in an RIF in March, and encountering difficulty finding a new one,
+I began spending most of my time building open source tools.
 I'm hoping to be able to pay for my kids' health insurance this month,
 so if you value the work I am doing, I need your support.
 Please consider sponsoring me or the project.
@@ -40,16 +40,13 @@ To join the community or get help 👇️ Join the Discord.
 
 [![Live Chat on Discord][✉️discord-invite-img-ftb]][✉️discord-invite]
 
-To say "thanks for maintaining such a great tool" ☝️ Join the Discord or 👇️ send money.
+To say "thanks!" ☝️ Join the Discord or 👇️ send money.
 
-[![Sponsor me on GitHub Sponsors][🖇sponsor-bottom-img]][🖇sponsor] 💌 [![Sponsor me on Liberapay][⛳liberapay-bottom-img]][⛳liberapay-img] 💌 [![Donate on PayPal][🖇paypal-bottom-img]][🖇paypal-img]
+[![Sponsor me on GitHub Sponsors][🖇sponsor-bottom-img]][🖇sponsor] 💌 [![Sponsor me on Liberapay][⛳liberapay-bottom-img]][⛳liberapay] 💌 [![Donate on PayPal][🖇paypal-bottom-img]][🖇paypal]
 
 # Another Way to Support Open Source Software
 
-> How wonderful it is that nobody need wait a single moment before starting to improve the world.<br/>
->—Anne Frank
-
-I’m driven by a passion to foster a thriving open-source community – a space where people can tackle complex problems, no matter how small.  Revitalizing libraries that have fallen into disrepair, and building new libraries focused on solving real-world challenges, are my passions — totaling 79 hours of FLOSS coding over just the past seven days, a pretty regular week for me.  I was recently affected by layoffs, and the tech jobs market is unwelcoming. I’m reaching out here because your support would significantly aid my efforts to provide for my family, and my farm (11 🐔 chickens, 2 🐶 dogs, 3 🐰 rabbits, 8 🐈‍ cats).
+I’m driven by a passion to foster a thriving open-source community – a space where people can tackle complex problems, no matter how small.  Revitalizing libraries that have fallen into disrepair, and building new libraries focused on solving real-world challenges, are my passions.  I was recently affected by layoffs, and the tech jobs market is unwelcoming. I’m reaching out here because your support would significantly aid my efforts to provide for my family, and my farm (11 🐔 chickens, 2 🐶 dogs, 3 🐰 rabbits, 8 🐈‍ cats).
 
 If you work at a company that uses my work, please encourage them to support me as a corporate sponsor. My work on gems you use might show up in `bundle fund`.
 

data/README.md

@@ -54,6 +54,8 @@ Run the one-time project bootstrapper:
 
 ```console
 kettle-dev-setup
+# Or if your middle name is "danger":
+# kettle-dev-setup --allowed=true --force
 ```
 
 This gem integrates tightly with [kettle-test](https://github.com/kettle-rb/kettle-test).
@@ -106,7 +108,7 @@ Compatible with MRI Ruby 2.3+, and concordant releases of JRuby, and TruffleRuby
 
 ### Federated DVCS
 
-<details>
+<details markdown="1">
   <summary>Find this repo on federated forges (Coming soon!)</summary>
 
 | Federated [DVCS][💎d-in-dvcs] Repository        | Status                                                                | Issues                    | PRs                      | Wiki                      | CI                       | Discussions                  |
@@ -124,7 +126,7 @@ Compatible with MRI Ruby 2.3+, and concordant releases of JRuby, and TruffleRuby
 
 Available as part of the Tidelift Subscription.
 
-<details>
+<details markdown="1">
   <summary>Need enterprise-level guarantees?</summary>
 
 The maintainers of this and thousands of other packages are working with Tidelift to deliver commercial support and maintenance for the open source packages you use to build your applications. Save time, reduce risk, and improve code health, while paying the maintainers of the exact packages you use.
@@ -159,7 +161,7 @@ gem install kettle-dev
 
 ### 🔒 Secure Installation
 
-<details>
+<details markdown="1">
   <summary>For Medium or High Security Installations</summary>
 
 This gem is cryptographically signed, and has verifiable [SHA-256 and SHA-512][💎SHA_checksums] checksums by
@@ -728,12 +730,11 @@ For example:
 spec.add_dependency("kettle-dev", "~> 1.0")
 ```
 
-<details>
+<details markdown="1">
 <summary>📌 Is "Platform Support" part of the public API? More details inside.</summary>
 
 SemVer should, IMO, but doesn't explicitly, say that dropping support for specific Platforms
-is a *breaking change* to an API.
-It is obvious to many, but not all, and since the spec is silent, the bike shedding is endless.
+is a *breaking change* to an API, and for that reason the bike shedding is endless.
 
 To get a better understanding of how SemVer is intended to work over a project's lifetime,
 read this article from the creator of SemVer:
@@ -964,10 +965,10 @@ Thanks for RTFM. ☺️
 [📌changelog]: CHANGELOG.md
 [📗keep-changelog]: https://keepachangelog.com/en/1.0.0/
 [📗keep-changelog-img]: https://img.shields.io/badge/keep--a--changelog-1.0.0-34495e.svg?style=flat
-[📌gitmoji]:https://gitmoji.dev
+[📌gitmoji]: https://gitmoji.dev
 [📌gitmoji-img]: https://img.shields.io/badge/gitmoji_commits-%20%F0%9F%98%9C%20%F0%9F%98%8D-34495e.svg?style=flat-square
 [🧮kloc]: https://www.youtube.com/watch?v=dQw4w9WgXcQ
-[🧮kloc-img]: https://img.shields.io/badge/KLOC-4.237-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
+[🧮kloc-img]: https://img.shields.io/badge/KLOC-4.278-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

@@ -78,7 +78,7 @@ Compatible with MRI Ruby {K_D_MIN_RUBY}+, and concordant releases of JRuby, and
 
 ### Federated DVCS
 
-<details>
+<details markdown="1">
   <summary>Find this repo on federated forges (Coming soon!)</summary>
 
 | Federated [DVCS][💎d-in-dvcs] Repository        | Status                                                                | Issues                    | PRs                      | Wiki                      | CI                       | Discussions                  |
@@ -96,7 +96,7 @@ Compatible with MRI Ruby {K_D_MIN_RUBY}+, and concordant releases of JRuby, and
 
 Available as part of the Tidelift Subscription.
 
-<details>
+<details markdown="1">
   <summary>Need enterprise-level guarantees?</summary>
 
 The maintainers of this and thousands of other packages are working with Tidelift to deliver commercial support and maintenance for the open source packages you use to build your applications. Save time, reduce risk, and improve code health, while paying the maintainers of the exact packages you use.
@@ -131,7 +131,7 @@ gem install kettle-dev
 
 ### 🔒 Secure Installation
 
-<details>
+<details markdown="1">
   <summary>For Medium or High Security Installations</summary>
 
 This gem is cryptographically signed, and has verifiable [SHA-256 and SHA-512][💎SHA_checksums] checksums by
@@ -301,12 +301,11 @@ For example:
 spec.add_dependency("kettle-dev", "~> 1.0")
 ```
 
-<details>
+<details markdown="1">
 <summary>📌 Is "Platform Support" part of the public API? More details inside.</summary>
 
 SemVer should, IMO, but doesn't explicitly, say that dropping support for specific Platforms
-is a *breaking change* to an API.
-It is obvious to many, but not all, and since the spec is silent, the bike shedding is endless.
+is a *breaking change* to an API, and for that reason the bike shedding is endless.
 
 To get a better understanding of how SemVer is intended to work over a project's lifetime,
 read this article from the creator of SemVer:
@@ -542,10 +541,10 @@ Thanks for RTFM. ☺️
 [📌changelog]: CHANGELOG.md
 [📗keep-changelog]: https://keepachangelog.com/en/1.0.0/
 [📗keep-changelog-img]: https://img.shields.io/badge/keep--a--changelog-1.0.0-34495e.svg?style=flat
-[📌gitmoji]:https://gitmoji.dev
+[📌gitmoji]: https://gitmoji.dev
 [📌gitmoji-img]: https://img.shields.io/badge/gitmoji_commits-%20%F0%9F%98%9C%20%F0%9F%98%8D-34495e.svg?style=flat-square
 [🧮kloc]: https://www.youtube.com/watch?v=dQw4w9WgXcQ
-[🧮kloc-img]: https://img.shields.io/badge/KLOC-4.237-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
+[🧮kloc-img]: https://img.shields.io/badge/KLOC-4.278-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.no-osc.example

@@ -78,7 +78,7 @@ Compatible with MRI Ruby {K_D_MIN_RUBY}+, and concordant releases of JRuby, and
 
 ### Federated DVCS
 
-<details>
+<details markdown="1">
   <summary>Find this repo on federated forges (Coming soon!)</summary>
 
 | Federated [DVCS][💎d-in-dvcs] Repository        | Status                                                                | Issues                    | PRs                      | Wiki                      | CI                       | Discussions                  |
@@ -96,7 +96,7 @@ Compatible with MRI Ruby {K_D_MIN_RUBY}+, and concordant releases of JRuby, and
 
 Available as part of the Tidelift Subscription.
 
-<details>
+<details markdown="1">
   <summary>Need enterprise-level guarantees?</summary>
 
 The maintainers of this and thousands of other packages are working with Tidelift to deliver commercial support and maintenance for the open source packages you use to build your applications. Save time, reduce risk, and improve code health, while paying the maintainers of the exact packages you use.
@@ -131,7 +131,7 @@ gem install kettle-dev
 
 ### 🔒 Secure Installation
 
-<details>
+<details markdown="1">
   <summary>For Medium or High Security Installations</summary>
 
 This gem is cryptographically signed, and has verifiable [SHA-256 and SHA-512][💎SHA_checksums] checksums by
@@ -278,12 +278,11 @@ For example:
 spec.add_dependency("kettle-dev", "~> 1.0")
 ```
 
-<details>
+<details markdown="1">
 <summary>📌 Is "Platform Support" part of the public API? More details inside.</summary>
 
 SemVer should, IMO, but doesn't explicitly, say that dropping support for specific Platforms
-is a *breaking change* to an API.
-It is obvious to many, but not all, and since the spec is silent, the bike shedding is endless.
+is a *breaking change* to an API, and for that reason the bike shedding is endless.
 
 To get a better understanding of how SemVer is intended to work over a project's lifetime,
 read this article from the creator of SemVer:
@@ -508,7 +507,7 @@ Thanks for RTFM. ☺️
 [📌changelog]: CHANGELOG.md
 [📗keep-changelog]: https://keepachangelog.com/en/1.0.0/
 [📗keep-changelog-img]: https://img.shields.io/badge/keep--a--changelog-1.0.0-34495e.svg?style=flat
-[📌gitmoji]:https://gitmoji.dev
+[📌gitmoji]: https://gitmoji.dev
 [📌gitmoji-img]: https://img.shields.io/badge/gitmoji_commits-%20%F0%9F%98%9C%20%F0%9F%98%8D-34495e.svg?style=flat-square
 [🧮kloc]: https://www.youtube.com/watch?v=dQw4w9WgXcQ
 [🧮kloc-img]: https://img.shields.io/badge/KLOC-4.076-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue

data/Rakefile.example

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-# kettle-dev Rakefile v1.1.47 - 2025-11-06
+# kettle-dev Rakefile v1.1.49 - 2025-11-07
 # Ruby 2.3 (Safe Navigation) or higher required
 #
 # MIT License (see License.txt)

data/gemfiles/modular/documentation.gemfile

@@ -1,11 +1,12 @@
 # frozen_string_literal: true
 
 # Documentation
-gem "kramdown", "~> 2.5", ">= 2.5.1" # Ruby >= 2.5
-gem "kramdown-parser-gfm", "~> 1.1" # Ruby >= 2.3
+gem "kramdown", "~> 2.5", ">= 2.5.1", require: false # Ruby >= 2.5
+gem "kramdown-parser-gfm", "~> 1.1", require: false # Ruby >= 2.3
 gem "yard", "~> 0.9", ">= 0.9.37", require: false
+gem "yard-fence", "~> 0.4", require: false # Ruby >= 3.2
 gem "yard-junk", "~> 0.0", ">= 0.0.10", github: "pboling/yard-junk", branch: "next", require: false
-gem "yard-relative_markdown_links", "~> 0.5.0"
+gem "yard-relative_markdown_links", "~> 0.6", require: false
 
 # Std Lib extractions
-gem "rdoc", "~> 6.11"
+gem "rdoc", "~> 6.11", require: false

data/lib/kettle/dev/ci_monitor.rb

@@ -66,10 +66,12 @@ module Kettle
 
       # Non-aborting collection across GH and GL, returning a compact results hash.
       # Results format:
+      # ```ruby
       #   {
       #     github: [ {workflow: "file.yml", status: "completed", conclusion: "success"|"failure"|nil, url: String} ],
       #     gitlab: { status: "success"|"failed"|"blocked"|"unknown"|nil, url: String }
       #   }
+      # ```
       # @return [Hash]
       def collect_all
         results = {github: [], gitlab: nil}

data/lib/kettle/dev/template_helpers.rb

@@ -353,9 +353,84 @@ module Kettle
             end
           end
 
-          # Index existing gems in destination
+          # --- Handle `source` replacement/insertion ---
+          src_source_line = nil
+          src_content.each_line do |ln|
+            next if ln.strip.start_with?("#")
+            if ln =~ /^\s*source\s+['"][^'"]+['"]\s*$/
+              src_source_line = ln.rstrip + "\n"
+              break
+            end
+          end
+
+          dest_lines = dest_content.lines.dup
+
+          if src_source_line
+            dest_source_idx = dest_lines.index do |ln|
+              !ln.strip.start_with?("#") && ln =~ /^\s*source\s+['"][^'"]+['"]\s*$/
+            end
+            if dest_source_idx
+              dest_lines[dest_source_idx] = src_source_line
+            else
+              # Insert after any leading contiguous comment/blank block at top of file
+              insert_idx = 0
+              while insert_idx < dest_lines.length && (dest_lines[insert_idx].strip.empty? || dest_lines[insert_idx].lstrip.start_with?("#"))
+                insert_idx += 1
+              end
+              dest_lines.insert(insert_idx, src_source_line)
+            end
+          end
+
+          # --- Handle `git_source` replacement/insertion ---
+          # Collect non-comment git_source lines from source (preserve order)
+          src_git_lines = src_content.each_line.select { |ln| !ln.strip.start_with?("#") && ln =~ /^\s*git_source\s*\(/ }
+          if src_git_lines.any?
+            # Insert new git_source lines in the same order as they appear in the source
+            # When inserting (not replacing), place them immediately after the source line if present
+            insert_after_source_idx = dest_lines.index { |ln| !ln.strip.start_with?("#") && ln =~ /^\s*source\s+['"][^'"]+['"]\s*$/ }
+
+            # Iterate source git lines in reverse for insertion so order is preserved when inserting at same index
+            src_git_lines.reverse_each do |gln|
+              # Attempt to extract the git_source "name" (handles forms like git_source(:github) or git_source :github)
+              name_match = gln.match(/^\s*git_source\s*\(?\s*:?(\w+)\b/)
+              name = name_match ? name_match[1].to_s : nil
+
+              replaced = false
+              if name
+                # Try to find a git_source in destination with the same name
+                dest_same_idx = dest_lines.index do |dln|
+                  !dln.strip.start_with?("#") && dln =~ /^\s*git_source\s*\(?\s*:?#{Regexp.escape(name)}\b/
+                end
+                if dest_same_idx
+                  dest_lines[dest_same_idx] = gln.rstrip + "\n"
+                  replaced = true
+                end
+              end
+
+              unless replaced
+                # If destination has a github git_source, replace that
+                dest_github_idx = dest_lines.index do |dln|
+                  !dln.strip.start_with?("#") && dln =~ /^\s*git_source\s*\(?\s*:?github\b/
+                end
+                if dest_github_idx
+                  dest_lines[dest_github_idx] = gln.rstrip + "\n"
+                else
+                  # Insert below the source line if present, otherwise at top (after comments)
+                  insert_idx =
+                    if insert_after_source_idx
+                      insert_after_source_idx + 1
+                    else
+                      0
+                    end
+                  dest_lines.insert(insert_idx, gln.rstrip + "\n")
+                end
+              end
+            end
+          end
+
+          # Index existing gems in destination (after potential source/git_source changes)
           dest_gems = {}
-          dest_content.each_line do |ln|
+          dest_lines.join.each_line do |ln|
             next if ln.strip.start_with?("#")
             if (m = ln.match(gem_re))
               dest_gems[m[1]] = true
@@ -363,12 +438,17 @@ module Kettle
           end
 
           missing = src_gems.keys.reject { |n| dest_gems.key?(n) }
-          return dest_content if missing.empty?
+          # If nothing to change, return original destination content
+          if missing.empty? && src_source_line.nil? && src_git_lines.empty?
+            return dest_content
+          end
 
-          out = dest_content.dup
+          out = dest_lines.join
           out << "\n" unless out.end_with?("\n") || out.empty?
-          out << missing.map { |n| src_gems[n] }.join("\n")
-          out << "\n"
+          if missing.any?
+            out << missing.map { |n| src_gems[n] }.join("\n")
+            out << "\n"
+          end
           out
         rescue StandardError => e
           Kettle::Dev.debug_error(e, __method__)

data/lib/kettle/dev/version.rb

@@ -6,7 +6,7 @@ module Kettle
     module Version
       # The gem version.
       # @return [String]
-      VERSION = "1.1.47"
+      VERSION = "1.1.49"
 
       module_function
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: kettle-dev
 version: !ruby/object:Gem::Version
-  version: 1.1.47
+  version: 1.1.49
 platform: ruby
 authors:
 - Peter H. Boling
@@ -396,10 +396,10 @@ licenses:
 - MIT
 metadata:
   homepage_uri: https://kettle-dev.galtzo.com/
-  source_code_uri: https://github.com/kettle-rb/kettle-dev/tree/v1.1.47
-  changelog_uri: https://github.com/kettle-rb/kettle-dev/blob/v1.1.47/CHANGELOG.md
+  source_code_uri: https://github.com/kettle-rb/kettle-dev/tree/v1.1.49
+  changelog_uri: https://github.com/kettle-rb/kettle-dev/blob/v1.1.49/CHANGELOG.md
   bug_tracker_uri: https://github.com/kettle-rb/kettle-dev/issues
-  documentation_uri: https://www.rubydoc.info/gems/kettle-dev/1.1.47
+  documentation_uri: https://www.rubydoc.info/gems/kettle-dev/1.1.49
   funding_uri: https://github.com/sponsors/pboling
   wiki_uri: https://github.com/kettle-rb/kettle-dev/wiki
   news_uri: https://www.railsbling.com/tags/kettle-dev