kettle-dev 2.0.1 → 2.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 423e786ae241791214751d2cd3496033ba0986b4279d738d62feda1eb197837b
-  data.tar.gz: 7c7436dcf0a65dea2d9241263bfd6d357c64a5f4a1a12432325fb5aecfe2cd38
+  metadata.gz: 79a49f87b3b9af1b0aa2cb1b9d8f3b026a923df0ab1164df416a5dc3af72dc42
+  data.tar.gz: b989207755b131704aec4e5a76e29c1a2e236efbe9fa7717939111d21c475a74
 SHA512:
-  metadata.gz: 2f7e35c2eedd5a7f4b75bd9ce4bfb0e98e269a05694875a6c53311aaab885d5a3d8839283b3ca986cd3b694f1f48b3bc3ed0dc28171decb1e5391ef61b0df0c2
-  data.tar.gz: abd66bf76d22b3d13303228bf46d22b4fbb7f69c26d0740e54ec6c693f3f31d10b34f9cc4491fb12be0e073777af8ca812d57eb740cd27af65b644bb445bba60
+  metadata.gz: ffd633d7aab286c63bbdbb039621fd0512ce4d4d478b9af5bcb37b7c9202bbab8e7cf4ab41fecb5b6306da2ba2d42bf7f20770066131ac19344655ff3f9c7b58
+  data.tar.gz: ce2c0ed8704aa2aa0aaa248f0a2269a74ac2fe9e765117cb96e80004a98c20c7420ebddd876d887543895240732c5edf64ad2fc417efdf9cd19bc4ae6390791f

data/CHANGELOG.md

@@ -22,6 +22,47 @@ Please file a bug if you notice a violation of semantic versioning.
 
 ### Changed
 
+### Deprecated
+
+### Removed
+
+### Fixed
+
+- The `yard` rake spec now reloads the task file directly and uses Ruby
+  2.4-compatible cleanup syntax, fixing order-dependent CI failures across the
+  appraisal matrix.
+- The `yard` rake fallback task now remains registered with kettle-dev defaults
+  when the optional `yard` gem is unavailable in an appraisal environment.
+- The Rakefile now falls back to a stub `kettle:jem:selftest` task when the
+  installed `kettle-jem` package does not expose rake task installation.
+
+### Security
+
+## [2.0.3] - 2026-05-27
+
+- TAG: [v2.0.3][2.0.3t]
+- COVERAGE: 94.62% -- 2956/3124 lines in 24 files
+- BRANCH COVERAGE: 78.21% -- 1206/1542 branches in 24 files
+- 76.40% documented
+
+### Fixed
+
+- The default rake task now includes documentation generation via `yard`, so
+  documentation plugin post-processing runs during `bin/rake`.
+- `kettle-changelog` now updates the current changelog release in place when
+  Unreleased has pending entries or the release section is missing generated
+  coverage/documentation metadata, even if the version is already the latest
+  known release.
+
+## [2.0.2] - 2026-05-27
+
+- TAG: [v2.0.2][2.0.2t]
+- COVERAGE: 94.71% -- 2937/3101 lines in 23 files
+- BRANCH COVERAGE: 78.23% -- 1200/1534 branches in 23 files
+- 76.40% documented
+
+### 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
@@ -29,14 +70,14 @@ Please file a bug if you notice a violation of semantic versioning.
 - 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
 
+- `ci:act` and release CI monitoring now detect GitHub and GitLab repositories
+  when remotes use `git+ssh://` or `ssh://` URLs.
 - 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.
@@ -49,14 +90,15 @@ Please file a bug if you notice a violation of semantic versioning.
   poisoning the process exit status.
 - Coverage CI thresholds now match the repository `mise.toml` thresholds instead
   of requiring unreachable 100% line and branch coverage.
+- `kettle-changelog` now fails closed when `kettle-test` does not produce the
+  expected collated `coverage/coverage.json`, instead of merging worker coverage
+  files itself and hiding a coverage integration failure.
 - 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]
@@ -1745,7 +1787,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/v2.0.1...HEAD
+[Unreleased]: https://github.com/kettle-rb/kettle-dev/compare/v2.0.3...HEAD
+[2.0.3]: https://github.com/kettle-rb/kettle-dev/compare/v2.0.2...v2.0.3
+[2.0.3t]: https://github.com/kettle-rb/kettle-dev/releases/tag/v2.0.3
+[2.0.2]: https://github.com/kettle-rb/kettle-dev/compare/v2.0.1...v2.0.2
+[2.0.2t]: https://github.com/kettle-rb/kettle-dev/releases/tag/v2.0.2
 [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

data/CONTRIBUTING.md

@@ -107,6 +107,11 @@ For a quick starting point, this repository’s `mise.toml` defines the shared d
 ## Appraisals
 
 From time to time the [appraisal2][🚎appraisal2] gemfiles in `gemfiles/` will need to be updated.
+Generated appraisal and CI workflow floors are controlled by `ruby.test_minimum`
+in `.kettle-jem.yml`; this project was templated with `ruby.test_minimum: 2.4`.
+That value describes the lowest Ruby version expected to run the test/development
+toolchain, and it may be higher than the gemspec runtime floor.
+
 They are created and updated with the commands:
 
 ```console

data/README.md

@@ -228,6 +228,10 @@ tree_haver supports multiple parsing backends, but not all backends work on all
 ### Compatibility
 
 Compatible with MRI Ruby 2.4.0+, and concordant releases of JRuby, and TruffleRuby.
+CI workflows and Appraisals are generated for MRI Ruby 2.4+.
+This test floor is configured by `ruby.test_minimum` in `.kettle-jem.yml` and
+may be higher than the gem's runtime compatibility floor when legacy Rubies are
+not practical for the current toolchain.
 
 | 🚚 _Amazing_ test matrix was brought to you by | 🔎 appraisal2 🔎 and the color 💚 green 💚 |
 |------------------------------------------------|--------------------------------------------------------|
@@ -1006,7 +1010,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.068-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
+[🧮kloc-img]: https://img.shields.io/badge/KLOC-3.124-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
 [🔐security]: https://github.com/kettle-rb/kettle-dev/blob/main/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
@@ -1015,6 +1019,7 @@ Thanks for RTFM. ☺️
 [📄license-img]: https://img.shields.io/badge/License-AGPL--3.0--only-259D6C.svg
 [📄license-compat]: https://www.apache.org/legal/resolved.html#category-x
 [📄license-compat-img]: https://img.shields.io/badge/Apache_Incompatible:_Category_X-%E2%9C%97-C0392B.svg?style=flat&logo=Apache
+
 [📄ilo-declaration]: https://www.ilo.org/declaration/lang--en/index.htm
 [📄ilo-declaration-img]: https://img.shields.io/badge/ILO_Fundamental_Principles-✓-259D6C.svg?style=flat
 [🚎yard-current]: http://rubydoc.info/gems/kettle-dev

data/lib/kettle/dev/changelog_cli.rb

@@ -4,6 +4,7 @@ require "open3"
 require "json"
 require "net/http"
 require "uri"
+require "fileutils"
 
 module Kettle
   module Dev
@@ -152,7 +153,7 @@ module Kettle
           warn("Proceeding without live release info.")
         end
 
-        _unreleased_block, _before, after = extract_unreleased(changelog)
+        unreleased_block, _before, after = extract_unreleased(changelog)
         latest_changelog_version = detect_previous_version(after.to_s)
         section_exists = release_section_exists?(changelog, version)
         latest_target = latest_release_target(version, latest_overall, latest_for_series)
@@ -166,7 +167,7 @@ module Kettle
         end
 
         action = if section_exists && latest_target == version
-          :reformat_only
+          current_release_needs_update?(changelog, version, unreleased_block) ? :update_prepared_release : :reformat_only
         elsif section_exists
           :update_prepared_release
         elsif latest_target == version
@@ -503,6 +504,28 @@ module Kettle
         out.join
       end
 
+      def current_release_needs_update?(changelog, version, unreleased_block)
+        return true if unreleased_block_has_entries?(unreleased_block)
+
+        !release_metadata_complete?(release_body_for(changelog, version))
+      end
+
+      def unreleased_block_has_entries?(unreleased_block)
+        !filter_unreleased_sections(unreleased_block.to_s).strip.empty?
+      end
+
+      def release_body_for(changelog, version)
+        pattern = /^## \[#{Regexp.escape(version)}\][^\n]*\n(?<body>.*?)(?=^## \[|\z)/m
+        changelog.match(pattern)&.[](:body).to_s
+      end
+
+      def release_metadata_complete?(release_body)
+        stripped_body = release_body.to_s
+        stripped_body.match?(/^- COVERAGE: /) &&
+          stripped_body.match?(/^- BRANCH COVERAGE: /) &&
+          stripped_body.match?(/^- \d+(?:\.\d+)?%\s+documented$/)
+      end
+
       def coverage_lines
         if @strict
           # Always generate fresh coverage data in strict mode
@@ -525,14 +548,11 @@ module Kettle
 
           puts "Coverage generation complete."
 
-          # Check if coverage.json was generated
-          unless File.file?(@coverage_path)
-            raise "Coverage JSON not found at #{Kettle::Dev.display_path(@coverage_path)} after running bundle exec kettle-test"
-          end
+          ensure_changelog_coverage_json!
         else
           # Non-strict mode: check if coverage.json exists, warn if not
           unless File.file?(@coverage_path)
-            warn("Coverage JSON not found at #{Kettle::Dev.display_path(@coverage_path)}.")
+            warn(coverage_json_missing_message)
             warn("Run: K_SOUP_COV_FORMATTERS=json bundle exec kettle-test to generate it")
             return [nil, nil]
           end
@@ -597,26 +617,43 @@ module Kettle
         }
       end
 
+      def ensure_changelog_coverage_json!
+        return if File.file?(@coverage_path)
+
+        raise coverage_json_missing_message
+      end
+
+      def coverage_json_missing_message
+        [
+          "Coverage JSON not found at #{Kettle::Dev.display_path(@coverage_path)} after running bundle exec kettle-test.",
+          "kettle-test runs specs in parallel and is expected to collate parallel SimpleCov results into this canonical file.",
+          "If it is missing, coverage was not enabled in ENV config or the rake/task hooks did not load the coverage integration.",
+        ].join(" ")
+      end
+
       def yard_percent_documented
-        cmd = File.join(@root, "bin", "rake")
-        unless File.executable?(cmd)
+        commands = yard_documentation_commands
+        if commands.empty?
           if @strict
-            raise "bin/rake not found or not executable; ensure rake is installed via bundler"
+            raise "bin/rake and bin/yard not found or not executable; ensure rake and yard are installed via bundler"
           else
-            warn("bin/rake not found or not executable; ensure rake is installed via bundler")
+            warn("bin/rake and bin/yard not found or not executable; ensure rake and yard are installed via bundler")
             return
           end
         end
 
         begin
           # Run the canonical docs task to get the documentation percentage.
-          out, _ = Open3.capture2(cmd, "yard", {chdir: @root})
-          # Look for a line containing e.g., "95.35% documented"
-          line = out.lines.find { |l| /\d+(?:\.\d+)?%\s+documented/.match?(l) }
+          out = +""
+          commands.each do |command|
+            prepare_yard_fence_tmp_files if command == [File.join(@root, "bin", "yard")]
+            output, _status = Open3.capture2(*command, {chdir: @root})
+            out << output
+            line = documented_percent_line(output)
+            return line if line
+          end
 
-          if line
-            line.strip
-          elsif @strict
+          if @strict
             raise "Could not find documented percentage in bin/rake yard output"
           else
             warn("Could not find documented percentage in bin/rake yard output.")
@@ -632,6 +669,38 @@ module Kettle
         end
       end
 
+      def yard_documentation_commands
+        commands = []
+        rake = File.join(@root, "bin", "rake")
+        commands << [rake, "yard"] if File.executable?(rake)
+        yard = File.join(@root, "bin", "yard")
+        commands << [yard] if File.executable?(yard)
+        commands
+      end
+
+      def prepare_yard_fence_tmp_files
+        yardopts = File.join(@root, ".yardopts")
+        return unless File.file?(yardopts)
+        return unless File.read(yardopts).include?("tmp/yard-fence")
+
+        require "yard/fence"
+        outdir = File.join(@root, "tmp", "yard-fence")
+        FileUtils.rm_rf(outdir)
+        FileUtils.mkdir_p(outdir)
+        Dir.glob(File.join(@root, Yard::Fence::GLOB_PATTERN)).each do |src|
+          next unless File.file?(src)
+
+          content = File.read(src)
+          sanitized = Yard::Fence.sanitize_text(content)
+          File.write(File.join(outdir, File.basename(src)), sanitized)
+        end
+      end
+
+      def documented_percent_line(output)
+        line = output.lines.find { |l| /\d+(?:\.\d+)?%\s+documented/.match?(l) }
+        line&.strip
+      end
+
       # Transform legacy release headings that include a tag suffix, e.g.:
       #   "## [1.2.3] 2022-08-29 ([tag][1.2.3t])"
       # into a heading followed by a list item:

data/lib/kettle/dev/ci_helpers.rb

@@ -29,19 +29,13 @@ module Kettle
       end
 
       # Parse the GitHub owner/repo from the configured origin remote.
-      # Supports SSH (git@github.com:owner/repo(.git)) and HTTPS
-      # (https://github.com/owner/repo(.git)) forms.
+      # Supports SSH and HTTPS remote URL forms.
       # @return [Array(String, String), nil] [owner, repo] or nil when unavailable
       def repo_info
         out, status = Open3.capture2("git", "config", "--get", "remote.origin.url")
         return unless status.success?
 
-        url = out.strip
-        if url =~ %r{git@github.com:(.+?)/(.+?)(\.git)?$}
-          [Regexp.last_match(1), Regexp.last_match(2).sub(/\.git\z/, "")]
-        elsif url =~ %r{https://github.com/(.+?)/(.+?)(\.git)?$}
-          [Regexp.last_match(1), Regexp.last_match(2).sub(/\.git\z/, "")]
-        end
+        parse_hosted_repo(out.strip, "github.com")
       end
 
       # Current git branch name, or nil when not in a repository.
@@ -160,11 +154,7 @@ module Kettle
         url = origin_url
         return unless url
 
-        if url =~ %r{git@gitlab.com:(.+?)/(.+?)(\.git)?$}
-          [Regexp.last_match(1), Regexp.last_match(2).sub(/\.git\z/, "")]
-        elsif url =~ %r{https://gitlab.com/(.+?)/(.+?)(\.git)?$}
-          [Regexp.last_match(1), Regexp.last_match(2).sub(/\.git\z/, "")]
-        end
+        parse_hosted_repo(url, "gitlab.com")
       end
 
       # Default GitLab token from environment
@@ -243,6 +233,29 @@ module Kettle
       def gitlab_failed?(pipeline)
         pipeline && pipeline["status"] == "failed"
       end
+
+      # Parse owner/repo from common hosted Git remote URL shapes.
+      # @param url [String, nil]
+      # @param host [String]
+      # @return [Array(String, String), nil]
+      def parse_hosted_repo(url, host)
+        return unless url
+
+        if url =~ %r{\Agit@#{Regexp.escape(host)}:(.+?)/(.+?)(?:\.git)?\z}
+          return [Regexp.last_match(1), Regexp.last_match(2).sub(/\.git\z/, "")]
+        end
+
+        uri = URI.parse(url)
+        return unless uri.host == host
+
+        path = uri.path.to_s.sub(%r{\A/}, "")
+        owner, repo = path.split("/", 2)
+        return unless owner && repo && !owner.empty? && !repo.empty?
+
+        [owner, repo.sub(/\.git\z/, "")]
+      rescue URI::InvalidURIError
+        nil
+      end
     end
   end
 end

data/lib/kettle/dev/ci_monitor.rb

@@ -410,15 +410,7 @@ module Kettle
       module_function :preferred_github_remote
 
       def parse_github_owner_repo(url)
-        return [nil, nil] unless url
-
-        if url =~ %r{git@github.com:(.+?)/(.+?)(\.git)?$}
-          [Regexp.last_match(1), Regexp.last_match(2).sub(/\.git\z/, "")]
-        elsif url =~ %r{https://github.com/(.+?)/(.+?)(\.git)?$}
-          [Regexp.last_match(1), Regexp.last_match(2).sub(/\.git\z/, "")]
-        else
-          [nil, nil]
-        end
+        Kettle::Dev::CIHelpers.parse_hosted_repo(url, "github.com") || [nil, nil]
       end
       module_function :parse_github_owner_repo
     end

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

@@ -24,10 +24,13 @@ begin
   rescue LoadError
     # yard-timekeeper not available - that's fine
   end
+
+  Kettle::Dev.register_default("yard")
 rescue LoadError
   warn("[kettle-dev][yard.rake] failed to load yard") if Kettle::Dev::DEBUGGING
   desc("(stub) yard is unavailable")
   task(:yard) do
     warn("NOTE: yard isn't installed, or is disabled for #{RUBY_VERSION} in the current environment")
   end
+  Kettle::Dev.register_default("yard")
 end

data/lib/kettle/dev/release_cli.rb

@@ -791,15 +791,7 @@ module Kettle
       end
 
       def parse_github_owner_repo(url)
-        return [nil, nil] unless url
-
-        if url =~ %r{git@github.com:(.+?)/(.+?)(\.git)?$}
-          [Regexp.last_match(1), Regexp.last_match(2).sub(/\.git\z/, "")]
-        elsif url =~ %r{https://github.com/(.+?)/(.+?)(\.git)?$}
-          [Regexp.last_match(1), Regexp.last_match(2).sub(/\.git\z/, "")]
-        else
-          [nil, nil]
-        end
+        Kettle::Dev::CIHelpers.parse_hosted_repo(url, "github.com") || [nil, nil]
       end
 
       def has_remote?(name)

data/lib/kettle/dev/version.rb

@@ -3,7 +3,7 @@
 module Kettle
   module Dev
     module Version
-      VERSION = "2.0.1"
+      VERSION = "2.0.3"
     end
     VERSION = Version::VERSION # Traditional Constant Location
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: kettle-dev
 version: !ruby/object:Gem::Version
-  version: 2.0.1
+  version: 2.0.3
 platform: ruby
 authors:
 - Peter H. Boling
@@ -185,20 +185,20 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: '2.0'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.0.3
+        version: 2.0.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
+        version: '2.0'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.0.3
+        version: 2.0.0
 description: "\U0001F372 Kettle::Dev is a meta tool from kettle-rb to streamline development
   and testing. Acts as a shim dependency, pulling in many other dependencies, to give
   you OOTB productivity with a RubyGem, or Ruby app project. Configures a complete
@@ -312,10 +312,10 @@ licenses:
 - AGPL-3.0-only
 metadata:
   homepage_uri: https://kettle-dev.galtzo.com
-  source_code_uri: https://github.com/kettle-rb/kettle-dev/tree/v2.0.1
-  changelog_uri: https://github.com/kettle-rb/kettle-dev/blob/v2.0.1/CHANGELOG.md
+  source_code_uri: https://github.com/kettle-rb/kettle-dev/tree/v2.0.3
+  changelog_uri: https://github.com/kettle-rb/kettle-dev/blob/v2.0.3/CHANGELOG.md
   bug_tracker_uri: https://github.com/kettle-rb/kettle-dev/issues
-  documentation_uri: https://www.rubydoc.info/gems/kettle-dev/2.0.1
+  documentation_uri: https://www.rubydoc.info/gems/kettle-dev/2.0.3
   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