kettle-changelog 1.0.11 → 1.0.12

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 169012091c170ea705938194cea93f1a026ef922cf122182129d1b212a990b8b
-  data.tar.gz: 15641d8df63f724770e6de1a7ae8199a6648e67cb0fa8bf53ea9ee5c499ff9cd
+  metadata.gz: 46ff4a216c45f7d3e0adffbced0e534b4552a664c590d2599ce3f90214bf6c36
+  data.tar.gz: 002e92d0625e45088e477e80d1f1ee4eba4f764cea8825b019a3a76d7f4379e6
 SHA512:
-  metadata.gz: 1cd874baec21a1a193b27b6fdb67379b101a47dd0288d0bd201b17a975cadaba7fd09311992b61fb74f6ec529bed0a36f34465053b45595cae31a5f6ca22593d
-  data.tar.gz: a13c2d4b4559971f387a506ccd3afd91bedb3fe22ad03f722c929612c8ef63de94290caef182b323c90977ef15b9f2912698afab37c065136d9f71b60b619469
+  metadata.gz: a89e9d8e475663098f529fff9c844bd678ac38b17f3e4fa5c5aa6fd3646f78efc35ff094a0183e984eef5cfacb8f41e0788330cbb95b0578482f05efddada54e
+  data.tar.gz: fa23271ec915cc9f64764c533c39243d2a66d329cff31cddaca49f2eb8bfe69673abcfbaca0ede17356398445252fd4f17046aad596cbe57f3e86e379807d9e6

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,34 @@ Please file a bug if you notice a violation of semantic versioning.
 
 ### Security
 
+## [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 +308,11 @@ 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.12...HEAD
+[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.226-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?

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.12"
     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.12
 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.14
   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.14
 - !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.12
+  changelog_uri: https://github.com/kettle-dev/kettle-changelog/blob/v1.0.12/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.12
   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