kettle-changelog 1.0.4 → 1.0.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 42ae636c33d71f79fe63d7f59eaffc962a3bab7bd2fb1df78ccffaa5814806a5
-  data.tar.gz: 698fab6d1d3a7755322fd41757f094e9f43442f3c3f87634d623c5bee703eabd
+  metadata.gz: 987f0528fbdee3c91c47d9675fe79fe3e4993f69c4b759ee7413a07c0b6eece9
+  data.tar.gz: d20d9e1fff2153b932cb3961d8bb56fd8bd02b0e9257b4b2844eaaa70ac7cb11
 SHA512:
-  metadata.gz: b85f5235a110584809417c49ca301d9e1e13997297c13cf269caccaeaf5471b58a60b32588be6be6e482a0f8d84ce856225189082915dec3802cd6b121bf9c1b
-  data.tar.gz: 9b84ef165516207a14726dae25b8754ab9bcfb017ef458e3b0b2e60f2c90bae55c712ea02c867ee2959a25f657be8f0bd767ffd115659b31bc3fa934e1725945
+  metadata.gz: d379f0164efc1c4d7214607eb2e745895dce3cb5e0702da2d27d63f62f376ec077b842061e74d98a93ca4ad9015cc3200e4daf8ca73a3d9ba338e8bbb339fc61
+  data.tar.gz: 21ecb7793e5b0ebc36d2e0987419a3b9f900267ce04e1edabdfa18c5c3f3e72bc112d6456a95bdc2b8f79df77dc7cf58cd7b2057049aa90238ebd501d1796a8d

checksums.yaml.gz.sig

@@ -1,3 +1,2 @@
-,8�v�
-��-)�������U���c��HkH�FuT��L+V��~���®���Z
<���ƚ�s4����Q$F]9ؼ*q�%���L����f�M���p�	�v,���iI�C�֐�,�}$"
-^�ǡ-�6Z�ꃳ��
�,�$��.\�ambU6�@�XuN �ѹ��}�T
+���{щ��\�6��"c�[
G�s�Znʢ�
}/V�s���b�m��qB�{Θ@#��j�Ahe�?·*9��Zd����Y�C��4�;�a�8
�^�̲�Rh �zNRяTjG�J��,��w�`�>D����#h嫗b�
~�b�Vf�'Fm#
+?>Gc��õ~1g&L?3�ŵy ��Ny�S��������+���Fo
I��?
B�j_4�3��m_7����m���0{���̊��U2F�8IJN ?V���f�Ni�ʤM�
Ѧx��QD�')E��踷V�?���"K�b��dQvvf�*��#�Ro�,	->&�R{ �����Aah�
��L4�4r
 w���z��cs�
��V�����

data/CHANGELOG.md

@@ -30,6 +30,17 @@ Please file a bug if you notice a violation of semantic versioning.
 
 ### Security
 
+## [1.0.5] - 2026-08-28
+
+- TAG: [v1.0.5][1.0.5t]
+- COVERAGE: 94.05% -- 1075/1143 lines in 6 files
+- BRANCH COVERAGE: 76.95% -- 374/486 branches in 6 files
+- 39.39% documented
+
+### Fixed
+
+- Backfill missing release-tag Markdown references only when the matching local Git tag exists.
+
 ## [1.0.4] - 2026-08-28
 
 - TAG: [v1.0.4][1.0.4t]
@@ -168,7 +179,9 @@ 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.4...HEAD
+[Unreleased]: https://github.com/kettle-dev/kettle-changelog/compare/v1.0.5...HEAD
+[1.0.5]: https://github.com/kettle-dev/kettle-changelog/compare/v1.0.4...v1.0.5
+[1.0.5t]: https://github.com/kettle-dev/kettle-changelog/releases/tag/v1.0.5
 [1.0.4]: https://github.com/kettle-dev/kettle-changelog/compare/v1.0.3...v1.0.4
 [1.0.4t]: https://github.com/kettle-dev/kettle-changelog/releases/tag/v1.0.4
 [1.0.3]: https://github.com/kettle-dev/kettle-changelog/compare/v1.0.2...v1.0.3

data/README.md

@@ -397,7 +397,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.126-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
+[🧮kloc-img]: https://img.shields.io/badge/KLOC-1.143-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

@@ -23,6 +23,8 @@ module Kettle
       LINK_REF_DEF_RE = /^\s*\[[^\]]+\]:\s+\S+/
       # Matches an ATX heading at H4 or deeper (####, #####, ...)
       DEEP_HEADING_RE = /^\#{4,}\s/
+      # Matches the canonical release-tag row emitted for each release section.
+      TAG_REFERENCE_USAGE_RE = /^ {0,3}- TAG: \[v(#{CHANGELOG_VERSION_PATTERN_SOURCE})\]\[\1t\]\s*$/o
 
       # Initialize the changelog CLI
       # Sets up paths for CHANGELOG.md and coverage.json
@@ -146,7 +148,7 @@ module Kettle
             # Keep all content prior to the link-ref (older releases and interspersed refs)
             preserved_body = after_lines[0...unreleased_ref_idx].join
             # Then append the tail starting from the Unreleased link-ref line to preserve the footer refs
-            preserved_footer = after_lines[unreleased_ref_idx..-1].join
+            preserved_footer = after_lines[unreleased_ref_idx..].join
             updated << preserved_body << preserved_footer
           else
             # No Unreleased ref found; just append the remainder as-is
@@ -594,7 +596,7 @@ module Kettle
         # Now next_i points to the next section heading or EOF
         before = lines[0..(start_i - 1)].join
         unreleased_body = lines[(start_i + 1)..(next_i - 1)] || []
-        after_lines = lines[next_i..-1] || []
+        after_lines = lines[next_i..] || []
 
         # When this is the very first release there is no `## [X.Y.Z]` heading to act
         # as a boundary, so the footer link-ref block ([Unreleased]: ...) sits at the
@@ -603,7 +605,7 @@ module Kettle
         if next_i == lines.length
           footer_i = unreleased_body.index { |l| l.start_with?(UNRELEASED_SECTION_HEADING) }
           if footer_i
-            after_lines = unreleased_body[footer_i..-1] + after_lines
+            after_lines = unreleased_body[footer_i..] + after_lines
             unreleased_body = unreleased_body[0...footer_i]
           end
         end
@@ -630,12 +632,12 @@ module Kettle
 
         prepared_version = release_heading[1]
         release_and_tail = after.lines
-        next_release_index = release_and_tail[1..-1].to_a.index { |line| line.start_with?("## [") }
+        next_release_index = release_and_tail[1..].to_a.index { |line| line.start_with?("## [") }
         release_line_count = next_release_index ? next_release_index + 1 : release_and_tail.length
         release_lines = release_and_tail[0...release_line_count]
-        tail = release_and_tail[release_line_count..-1].to_a.join
+        tail = release_and_tail[release_line_count..].to_a.join
 
-        release_body = release_lines[1..-1].to_a.join
+        release_body = release_lines[1..].to_a.join
         merged_body = merge_release_body_with_unreleased(release_body, unreleased_block)
 
         release_section = +""
@@ -1103,7 +1105,7 @@ module Kettle
         scan_start = lines.index { |l| l.start_with?(UNRELEASED_SECTION_HEADING) } || lines.length
         t_versions = {}
         non_t_tag_refs = {}
-        lines[scan_start..-1].to_a.each do |l|
+        lines[scan_start..].to_a.each do |l|
           # Case A: explicit tag ref key like [1.2.3t]: ...
           if (m = l.match(/^\[(#{CHANGELOG_VERSION_PATTERN_SOURCE})t\]:\s+(\S+)/o))
             t_versions[m[1]] = true
@@ -1237,6 +1239,8 @@ module Kettle
         end
 
         if owner && repo
+          add_missing_tag_link_refs!(lines, owner, repo, except: new_version)
+
           # Add compare link for the new version
           from = prev_version ? "v#{prev_version}" : detect_initial_compare_base(lines)
           new_compare = "[#{new_version}]: https://github.com/#{owner}/#{repo}/compare/#{from}...v#{new_version}\n"
@@ -1251,7 +1255,7 @@ module Kettle
         end
 
         # Rebuild and sort the reference block so Unreleased is first, then newest to oldest versions, preserving everything above first_ref
-        ref_lines = lines[first_ref..-1].select { |l| /^\[[^\]]+\]:\s+http/.match?(l) }
+        ref_lines = lines[first_ref..].select { |l| /^\[[^\]]+\]:\s+http/.match?(l) }
         # Deduplicate by key (text inside the square brackets)
         by_key = {}
         ref_lines.each do |l|
@@ -1291,6 +1295,35 @@ module Kettle
         rebuilt.join
       end
 
+      # Historical sections can contain the canonical TAG row while lacking the
+      # matching Markdown reference definition. Reconcile those records rather
+      # than limiting reference generation to the release currently being
+      # prepared.
+      def add_missing_tag_link_refs!(lines, owner, repo, except: nil)
+        tag_versions = lines.filter_map do |line|
+          line.match(TAG_REFERENCE_USAGE_RE)&.[](1)
+        end.uniq
+
+        tag_versions.each do |version|
+          next if version == except
+          next if lines.any? { |line| line.start_with?("[#{version}t]:") }
+          unless local_release_tag?(version)
+            warn("kettle-changelog: local git tag v#{version} is absent; leaving its TAG reference unresolved")
+            next
+          end
+
+          lines << "[#{version}t]: https://github.com/#{owner}/#{repo}/releases/tag/v#{version}\n"
+        end
+      end
+
+      def local_release_tag?(version)
+        @local_release_tags ||= begin
+          output, status = Open3.capture2e("git", "tag", "--list", "v*", chdir: @root)
+          status.success? ? output.lines.map(&:strip) : []
+        end
+        @local_release_tags.include?("v#{version}")
+      end
+
       # Ensure every Markdown atx-style heading line (e.g., "# ", "## ") has exactly one blank line
       # before and after it, skipping content inside fenced code blocks.
       def normalize_heading_spacing(text)
@@ -1335,7 +1368,7 @@ module Kettle
         idx = lines.index { |l| l.start_with?(UNRELEASED_SECTION_HEADING) }
         return text unless idx
         head = lines[0...idx]
-        tail = lines[idx..-1]
+        tail = lines[idx..]
         # Ensure exactly one blank line between body and refs
         if head.any? && head.last.to_s.strip != ""
           head << ""

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.4"
+      VERSION = "1.0.5"
     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.4
+  version: 1.0.5
 platform: ruby
 authors:
 - Peter H. Boling
@@ -63,7 +63,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.0.14
+        version: 3.0.15
     - - "<"
       - !ruby/object:Gem::Version
         version: 4.0.0
@@ -73,7 +73,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.0.14
+        version: 3.0.15
     - - "<"
       - !ruby/object:Gem::Version
         version: 4.0.0
@@ -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.4
-  changelog_uri: https://github.com/kettle-dev/kettle-changelog/blob/v1.0.4/CHANGELOG.md
+  source_code_uri: https://github.com/kettle-dev/kettle-changelog/tree/v1.0.5
+  changelog_uri: https://github.com/kettle-dev/kettle-changelog/blob/v1.0.5/CHANGELOG.md
   bug_tracker_uri: https://github.com/kettle-dev/kettle-changelog/issues
-  documentation_uri: https://www.rubydoc.info/gems/kettle-changelog/1.0.4
+  documentation_uri: https://www.rubydoc.info/gems/kettle-changelog/1.0.5
   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