kettle-changelog 1.0.3 → 1.0.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3053fe44758bbd5eb1217aaabd7631a6b7822b83daab32973e594984cb2a2433
-  data.tar.gz: 8012ad13a243eb193dd1a887e97beaf88c3c48e734aeea36ffea06d8df5a8a34
+  metadata.gz: 987f0528fbdee3c91c47d9675fe79fe3e4993f69c4b759ee7413a07c0b6eece9
+  data.tar.gz: d20d9e1fff2153b932cb3961d8bb56fd8bd02b0e9257b4b2844eaaa70ac7cb11
 SHA512:
-  metadata.gz: 56ae1f5f0398fb33416d10a20c4c09e8179a92cfee4c318ef3964dde113ca9c3f591d476b840c1571ad98b4304e7e43787b78460ec9735de25b9707f6888d4ac
-  data.tar.gz: 9ef331e0733f7775bb4b2d789b495b842d660ae14278d2f8c38d1ce7225378d09bc057f233e4fba66fa050e3d2088f0c50d8cc1b181b314d784e0ad448d85783
+  metadata.gz: d379f0164efc1c4d7214607eb2e745895dce3cb5e0702da2d27d63f62f376ec077b842061e74d98a93ca4ad9015cc3200e4daf8ca73a3d9ba338e8bbb339fc61
+  data.tar.gz: 21ecb7793e5b0ebc36d2e0987419a3b9f900267ce04e1edabdfa18c5c3f3e72bc112d6456a95bdc2b8f79df77dc7cf58cd7b2057049aa90238ebd501d1796a8d

data/CHANGELOG.md

@@ -30,6 +30,36 @@ 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]
+- COVERAGE: 93.96% -- 1058/1126 lines in 6 files
+- BRANCH COVERAGE: 76.68% -- 365/476 branches in 6 files
+- 37.50% documented
+
+### Changed
+
+- [kc] kettle-jem/prepare: updated 9 project files:
+  - configuration (1)
+  - dependencies (8)
+
+- [kc] kettle-jem/template: updated 5 project files:
+  - configuration (1)
+  - dependencies (1)
+  - documentation (2)
+  - other (1)
+
 ## [1.0.3] - 2026-08-25
 
 - TAG: [v1.0.3][1.0.3t]
@@ -149,7 +179,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.3...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
 [1.0.3t]: https://github.com/kettle-dev/kettle-changelog/releases/tag/v1.0.3
 [1.0.2]: https://github.com/kettle-dev/kettle-changelog/compare/v1.0.1...v1.0.2

data/README.md

@@ -77,7 +77,9 @@ The _amazing_ test matrix is powered by the kettle-dev stack.
 
 </details>
 
-### Enterprise Support [![Tidelift](https://tidelift.com/badges/package/rubygems/kettle-changelog)](https://tidelift.com/subscription/pkg/rubygems-kettle-changelog?utm_source=rubygems-kettle-changelog&utm_medium=referral&utm_campaign=readme)
+### Enterprise Support
+
+[![Tidelift](https://tidelift.com/badges/package/rubygems/kettle-changelog)](https://tidelift.com/subscription/pkg/rubygems-kettle-changelog?utm_source=rubygems-kettle-changelog&utm_medium=referral&utm_campaign=readme)
 
 Available as part of the Tidelift Subscription.
 
@@ -395,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.3"
+      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.3
+  version: 1.0.5
 platform: ruby
 authors:
 - Peter H. Boling
@@ -63,7 +63,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.0.11
+        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.11
+        version: 3.0.15
     - - "<"
       - !ruby/object:Gem::Version
         version: 4.0.0
@@ -194,7 +194,7 @@ dependencies:
         version: '2.0'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.0.20
+        version: 2.0.21
   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.20
+        version: 2.0.21
 - !ruby/object:Gem::Dependency
   name: turbo_tests2
   requirement: !ruby/object:Gem::Requirement
@@ -214,7 +214,7 @@ dependencies:
         version: '3.2'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.2.5
+        version: 3.2.6
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -224,7 +224,7 @@ dependencies:
         version: '3.2'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.2.5
+        version: 3.2.6
 - !ruby/object:Gem::Dependency
   name: ruby-progressbar
   requirement: !ruby/object:Gem::Requirement
@@ -268,7 +268,7 @@ dependencies:
         version: '2.0'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.0.11
+        version: 2.0.12
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -278,7 +278,7 @@ dependencies:
         version: '2.0'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.0.11
+        version: 2.0.12
 description: "\U0001F4DD kettle-changelog formats release sections, manages Unreleased
   entries, and emits machine-readable release events for Ruby gems."
 email:
@@ -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.3
-  changelog_uri: https://github.com/kettle-dev/kettle-changelog/blob/v1.0.3/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.3
+  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