kettle-changelog 1.0.11 → 1.0.13

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 169012091c170ea705938194cea93f1a026ef922cf122182129d1b212a990b8b
-  data.tar.gz: 15641d8df63f724770e6de1a7ae8199a6648e67cb0fa8bf53ea9ee5c499ff9cd
+  metadata.gz: 2f00bf5b7d463c4932956ca216e4f568f369544a8f029621d525551a0f4af284
+  data.tar.gz: fa2778a1d9b5136eb5882afec786077297b78f42d063a92bc9eb276c53462572
 SHA512:
-  metadata.gz: 1cd874baec21a1a193b27b6fdb67379b101a47dd0288d0bd201b17a975cadaba7fd09311992b61fb74f6ec529bed0a36f34465053b45595cae31a5f6ca22593d
-  data.tar.gz: a13c2d4b4559971f387a506ccd3afd91bedb3fe22ad03f722c929612c8ef63de94290caef182b323c90977ef15b9f2912698afab37c065136d9f71b60b619469
+  metadata.gz: 6163a5299be11fe7dd2811f9f2e640cd90427d5fe84eee371f13cc02adba421ef7513a652a520735514de9140a663994a29f695884c0f87034b3fc465d1bd81f
+  data.tar.gz: c371ebf642ce80a10fc95253f2564748205847bc65eef5d0e352e815114fe10badfbb0301dd82fd6862ec522015212980c6db2e390f436ab0ef25625170e7bd5

data/CHANGELOG.md

@@ -22,12 +22,6 @@ Please file a bug if you notice a violation of semantic versioning.
 
 ### Changed
 
-- [kc] kettle-jem/prepare: updated 4 project files:
-  - dependencies (4)
-
-- [kc] kettle-jem/template: updated 1 project file:
-  - other (1)
-
 ### Deprecated
 
 ### Removed
@@ -36,6 +30,45 @@ Please file a bug if you notice a violation of semantic versioning.
 
 ### Security
 
+## [1.0.13] - 2026-10-18
+
+- TAG: [v1.0.13][1.0.13t]
+- COVERAGE: 93.53% -- 1157/1237 lines in 6 files
+- BRANCH COVERAGE: 77.55% -- 411/530 branches in 6 files
+- 37.84% documented
+
+### Fixed
+
+- Coverage failure reports point at the kettle-test log: when the fresh-coverage kettle-test run fails, the raised error names the newest tmp/kettle-test/turbo_tests2-*.log and its rspec summary (N examples, M failures) instead of only the exit status.
+
+## [1.0.12] - 2026-10-16
+
+- TAG: [v1.0.12][1.0.12t]
+- COVERAGE: 94.29% -- 1156/1226 lines in 6 files
+- BRANCH COVERAGE: 78.14% -- 411/526 branches in 6 files
+- 37.84% documented
+
+### Fixed
+
+- --backfill-released-version now builds the compare link from the latest older release section instead of the repository initial commit when an earlier section exists
+
+- update-prep folding real Unreleased entries into a backfilled placeholder section now replaces the historical-notes placeholder instead of merging real entries alongside it
+
+## [1.0.11] - 2026-10-15
+
+- TAG: [v1.0.11][1.0.11t]
+- COVERAGE: 94.26% -- 1149/1219 lines in 6 files
+- BRANCH COVERAGE: 77.78% -- 406/522 branches in 6 files
+- 38.89% documented
+
+### Changed
+
+- [kc] kettle-jem/prepare: updated 4 project files:
+  - dependencies (4)
+
+- [kc] kettle-jem/template: updated 1 project file:
+  - other (1)
+
 ## [1.0.10] - 2026-10-14
 
 - TAG: [v1.0.10][1.0.10t]
@@ -286,7 +319,13 @@ Please file a bug if you notice a violation of semantic versioning.
 
 - Initial release
 
-[Unreleased]: https://github.com/kettle-dev/kettle-changelog/compare/v1.0.10...HEAD
+[Unreleased]: https://github.com/kettle-dev/kettle-changelog/compare/v1.0.13...HEAD
+[1.0.13]: https://github.com/kettle-dev/kettle-changelog/compare/v1.0.12...v1.0.13
+[1.0.13t]: https://github.com/kettle-dev/kettle-changelog/releases/tag/v1.0.13
+[1.0.12]: https://github.com/kettle-dev/kettle-changelog/compare/v1.0.11...v1.0.12
+[1.0.12t]: https://github.com/kettle-dev/kettle-changelog/releases/tag/v1.0.12
+[1.0.11]: https://github.com/kettle-dev/kettle-changelog/compare/v1.0.10...v1.0.11
+[1.0.11t]: https://github.com/kettle-dev/kettle-changelog/releases/tag/v1.0.11
 [1.0.10]: https://github.com/kettle-dev/kettle-changelog/compare/v1.0.9...v1.0.10
 [1.0.10t]: https://github.com/kettle-dev/kettle-changelog/releases/tag/v1.0.10
 [1.0.9]: https://github.com/kettle-dev/kettle-changelog/compare/v1.0.8...v1.0.9

data/README.md

@@ -417,7 +417,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-1.219-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
+[🧮kloc-img]: https://img.shields.io/badge/KLOC-1.237-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
 [🔐security]: https://github.com/kettle-dev/kettle-changelog/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

data/lib/kettle/changelog/cli.rb

@@ -17,6 +17,7 @@ module Kettle
     # includes coverage and YARD stats, and updates link references.
     class CLI
       UNRELEASED_SECTION_HEADING = "[Unreleased]:"
+      HISTORICAL_PLACEHOLDER_LINE = "- Historical release notes are unavailable in this changelog."
       CHANGELOG_VERSION_PATTERN = /\d+\.\d+\.\d+(?:[.-][0-9A-Za-z]+)*/
       CHANGELOG_VERSION_PATTERN_SOURCE = CHANGELOG_VERSION_PATTERN.source
       COVERAGE_CHILD_ENV_PREFIXES = %w[K_CHANGELOG_].freeze
@@ -484,7 +485,7 @@ module Kettle
           end
           finish = [next_heading&.fetch(:start), footer, lines.length].compact.min
           body = lines[heading.fetch(:start)...finish].join
-          heading.merge(finish: finish, placeholder: body.include?("Historical release notes are unavailable in this changelog."))
+          heading.merge(finish: finish, placeholder: body.include?(HISTORICAL_PLACEHOLDER_LINE))
         end
       end
 
@@ -505,11 +506,16 @@ module Kettle
 
           ### Changed
 
-          - Historical release notes are unavailable in this changelog.
+          #{HISTORICAL_PLACEHOLDER_LINE}
 
         MD
+        # Compare from the latest existing section when it is older than the
+        # backfilled version; the initial-commit base is only right when no
+        # earlier release section exists.
+        previous = detect_previous_version(after.to_s)
+        previous = nil if previous && Gem::Version.new(previous) >= Gem::Version.new(version)
         updated = before + "## [Unreleased]\n" + unreleased_block.rstrip + "\n\n" + section + after.to_s
-        updated = update_link_refs(updated, owner, repo, nil, version)
+        updated = update_link_refs(updated, owner, repo, previous, version)
         updated = normalize_heading_spacing(updated).rstrip + "\n"
         File.write(@changelog_path, updated)
         emit_changelog_event(action: "backfill", status: "ok", version: version, plan: "historical_release")
@@ -707,6 +713,9 @@ module Kettle
         incoming = filter_unreleased_sections(unreleased_block)
         return existing if incoming.strip.empty?
         return incoming if existing.strip.empty?
+        # A backfilled section holding only the historical-notes placeholder is
+        # documentation of absence; once real entries arrive they replace it.
+        return incoming if placeholder_only_release_body?(existing)
 
         leading, sections = split_h3_sections(existing)
         _incoming_leading, incoming_sections = split_h3_sections(incoming)
@@ -726,6 +735,11 @@ module Kettle
         KeyedEntryUpserter.collapse_project_file_updates(merged)
       end
 
+      def placeholder_only_release_body?(body)
+        remaining = body.lines.reject { |line| line.strip == HISTORICAL_PLACEHOLDER_LINE }
+        remaining.none? { |line| line.strip.start_with?("- ") }
+      end
+
       def strip_release_metadata(release_body)
         lines = release_body.lines
         while lines.any? && lines.first.strip.empty?
@@ -836,7 +850,7 @@ module Kettle
 
           unless success
             emit_changelog_event(action: "coverage", status: "failed", command: "bundle exec kettle-test", root: Kettle::Dev.display_path(@coverage_root), reason: "exit status #{$?.exitstatus || "unknown"}")
-            raise "bundle exec kettle-test failed with exit status #{$?.exitstatus || "unknown"}"
+            raise "bundle exec kettle-test failed with exit status #{$?.exitstatus || "unknown"}#{coverage_failure_diagnostics}"
           end
 
           puts "Coverage generation complete."
@@ -924,6 +938,25 @@ module Kettle
         )
       end
 
+      # Best-effort diagnostics for a failed coverage test run: kettle-test
+      # writes a full turbo_tests2 log under tmp/kettle-test; surface the
+      # newest one and its rspec summary so the failure presents with the
+      # spec context instead of only an exit status.
+      def coverage_failure_diagnostics
+        log_dir = File.join(@coverage_root.to_s, "tmp", "kettle-test")
+        logs = Dir.glob(File.join(log_dir, "turbo_tests2-*.log")).sort_by { |path| File.mtime(path) }
+        return "" if logs.empty?
+
+        latest = logs.last
+        summary = File.readlines(latest).reverse.find { |line| line.match?(/^\d+ examples?, \d+ failures/) }
+        diag = " (full log: #{Kettle::Dev.display_path(latest)}"
+        diag << "; #{summary.strip}" if summary
+        diag << ")"
+        diag
+      rescue => e
+        " (could not read kettle-test logs: #{e.class}: #{e.message})"
+      end
+
       # The coverage child runs against the Appraisal-generated coverage
       # gemfile (gemfiles/coverage.gemfile) when present, and Bundler uses the
       # lockfile sitting next to it. That lockfile is a local build artifact

data/lib/kettle/changelog/version.rb

@@ -5,7 +5,7 @@ module Kettle
     # Version namespace for this gem.
     module Version
       # Current gem version.
-      VERSION = "1.0.11"
+      VERSION = "1.0.13"
     end
     # Current gem version exposed at the traditional constant location.
     VERSION = Version::VERSION # Traditional Constant Location

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: kettle-changelog
 version: !ruby/object:Gem::Version
-  version: 1.0.11
+  version: 1.0.13
 platform: ruby
 authors:
 - Peter H. Boling
@@ -66,7 +66,7 @@ dependencies:
         version: '3.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.1.13
+        version: 3.1.16
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -76,7 +76,7 @@ dependencies:
         version: '3.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.1.13
+        version: 3.1.16
 - !ruby/object:Gem::Dependency
   name: version_gem
   requirement: !ruby/object:Gem::Requirement
@@ -194,7 +194,7 @@ dependencies:
         version: '2.0'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.0.25
+        version: 2.0.27
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -204,7 +204,7 @@ dependencies:
         version: '2.0'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.0.25
+        version: 2.0.27
 - !ruby/object:Gem::Dependency
   name: turbo_tests2
   requirement: !ruby/object:Gem::Requirement
@@ -304,10 +304,10 @@ licenses:
 - AGPL-3.0-only
 metadata:
   homepage_uri: https://kettle-changelog.galtzo.com
-  source_code_uri: https://github.com/kettle-dev/kettle-changelog/tree/v1.0.11
-  changelog_uri: https://github.com/kettle-dev/kettle-changelog/blob/v1.0.11/CHANGELOG.md
+  source_code_uri: https://github.com/kettle-dev/kettle-changelog/tree/v1.0.13
+  changelog_uri: https://github.com/kettle-dev/kettle-changelog/blob/v1.0.13/CHANGELOG.md
   bug_tracker_uri: https://github.com/kettle-dev/kettle-changelog/issues
-  documentation_uri: https://www.rubydoc.info/gems/kettle-changelog/1.0.11
+  documentation_uri: https://www.rubydoc.info/gems/kettle-changelog/1.0.13
   funding_uri: https://github.com/sponsors/pboling
   wiki_uri: https://github.com/kettle-dev/kettle-changelog/wiki
   news_uri: https://www.railsbling.com/tags/kettle-changelog