kettle-changelog 1.0.5 → 1.0.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 987f0528fbdee3c91c47d9675fe79fe3e4993f69c4b759ee7413a07c0b6eece9
-  data.tar.gz: d20d9e1fff2153b932cb3961d8bb56fd8bd02b0e9257b4b2844eaaa70ac7cb11
+  metadata.gz: 91116b5db1a2ec7a70b8bb798aae0e19222ee9eded29fc26b8bdf80e0efd0d0d
+  data.tar.gz: f1dd9b8ff5dc27c2393a87f4fa74c2323910248fe8765755a2a47ca74aabe105
 SHA512:
-  metadata.gz: d379f0164efc1c4d7214607eb2e745895dce3cb5e0702da2d27d63f62f376ec077b842061e74d98a93ca4ad9015cc3200e4daf8ca73a3d9ba338e8bbb339fc61
-  data.tar.gz: 21ecb7793e5b0ebc36d2e0987419a3b9f900267ce04e1edabdfa18c5c3f3e72bc112d6456a95bdc2b8f79df77dc7cf58cd7b2057049aa90238ebd501d1796a8d
+  metadata.gz: 383cbcaed4483a26f407bb7f9b433cddb77799f8f6c91b7f241e07c893f8ef41c2982ba071694d5197017bac689eb7c2b7afd82d6feb0d0384cdc565be37c9bf
+  data.tar.gz: 2b3233ceb38ae67fd12e82d03fa56590f028b5738aa5ebaaf731e6e6a071f5cc849c3ad1843535305184122cfa3478a7ca5d398312e02d726a890b78a740d9a1

data/CHANGELOG.md

@@ -30,6 +30,19 @@ Please file a bug if you notice a violation of semantic versioning.
 
 ### Security
 
+## [1.0.6] - 2026-08-29
+
+- TAG: [v1.0.6][1.0.6t]
+- COVERAGE: 94.27% -- 1119/1187 lines in 6 files
+- BRANCH COVERAGE: 77.31% -- 385/498 branches in 6 files
+- 38.89% documented
+
+### Fixed
+
+- Consolidate repeated keyed project-file summaries when updating a prepared release section.
+
+- Consolidate repeated keyed project-file summaries within each published release during changelog reformatting.
+
 ## [1.0.5] - 2026-08-28
 
 - TAG: [v1.0.5][1.0.5t]
@@ -179,7 +192,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.5...HEAD
+[Unreleased]: https://github.com/kettle-dev/kettle-changelog/compare/v1.0.6...HEAD
+[1.0.6]: https://github.com/kettle-dev/kettle-changelog/compare/v1.0.5...v1.0.6
+[1.0.6t]: https://github.com/kettle-dev/kettle-changelog/releases/tag/v1.0.6
 [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

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

@@ -425,6 +425,7 @@ module Kettle
         updated = convert_heading_tag_suffix_to_list(changelog)
         updated = normalize_legacy_release_headings(updated)
         updated = remove_redundant_historical_placeholders(updated)
+        updated = collapse_keyed_project_file_updates_by_release(updated)
         updated = normalize_heading_spacing(updated)
         updated = ensure_footer_spacing(updated)
         updated = updated.rstrip + "\n"
@@ -460,6 +461,15 @@ module Kettle
         lines.each_with_index.reject { |_line, index| removals.any? { |range| range.cover?(index) } }.map(&:first).join
       end
 
+      def collapse_keyed_project_file_updates_by_release(changelog)
+        lines = changelog.to_s.lines
+        changelog_release_sections(lines).sort_by { |section| section.fetch(:start) }.reverse_each do |section|
+          range = section.fetch(:start)...section.fetch(:finish)
+          lines[range] = KeyedEntryUpserter.collapse_project_file_updates(lines[range].join).lines
+        end
+        lines.join
+      end
+
       def changelog_release_sections(lines)
         headings = lines.each_index.filter_map do |index|
           match = lines[index].match(/^## \[(#{CHANGELOG_VERSION_PATTERN_SOURCE})\]/o)
@@ -710,7 +720,8 @@ module Kettle
           end
         end
 
-        ([leading] + sections.map { |section| section.fetch(:heading) + trim_blank_lines(section.fetch(:lines)).join }).join.rstrip + "\n"
+        merged = ([leading] + sections.map { |section| section.fetch(:heading) + trim_blank_lines(section.fetch(:lines)).join }).join.rstrip + "\n"
+        KeyedEntryUpserter.collapse_project_file_updates(merged)
       end
 
       def strip_release_metadata(release_body)

data/lib/kettle/changelog/keyed_entry_upserter.rb

@@ -5,6 +5,67 @@ module Kettle
     class KeyedEntryUpserter
       SECTIONS = %w[Added Changed Deprecated Removed Fixed Security].freeze
       KEY_PREFIX = "[kc]"
+      PROJECT_FILE_UPDATE_FIRST_LINE = /\A[-*]\s+\[kc\]\s+([^\s:]+):\s+updated\s+\d+\s+project\s+files?:\s*\z/
+      PROJECT_FILE_UPDATE_CATEGORY_LINE = /\A\s{2,}[-*]\s+(.+?)\s+\((\d+)\)\s*\z/
+
+      class << self
+        # Consolidates repeated maintenance summaries after a prepared release
+        # is updated in place. The AST supplies list-item boundaries; the two
+        # regular expressions only parse the stable text payload inside those
+        # already-classified Markdown items.
+        def collapse_project_file_updates(source)
+          require "ast/crispr/markdown/markly"
+          context = Ast::Crispr::Markdown::Markly.document_context(content: source.to_s, source_label: "CHANGELOG.md")
+          updates = context.structural_owners(owner_scope: :list_items)
+            .select { |item| item.depth == 1 }
+            .filter_map { |item| project_file_update_record(item) }
+          duplicate_groups = updates.group_by { |update| update.fetch(:key) }.values.select { |group| group.length > 1 }
+          return source.to_s if duplicate_groups.empty?
+
+          lines = source.to_s.lines
+          duplicate_groups.flatten.sort_by { |update| update.fetch(:start_line) }.reverse_each do |update|
+            group = duplicate_groups.find { |candidate| candidate.include?(update) }
+            first = group.min_by { |candidate| candidate.fetch(:start_line) }
+            replacement = (update == first) ? project_file_update_entry(group).lines : []
+            lines[(update.fetch(:start_line) - 1)...update.fetch(:end_line)] = replacement
+          end
+          lines.join
+        end
+
+        private
+
+        def project_file_update_record(item)
+          lines = item.source.to_s.lines
+          key_match = PROJECT_FILE_UPDATE_FIRST_LINE.match(lines.shift.to_s.strip)
+          return unless key_match
+
+          counts = lines.filter_map do |line|
+            match = PROJECT_FILE_UPDATE_CATEGORY_LINE.match(line)
+            next unless match
+
+            [match[1].tr(" ", "_").to_sym, match[2].to_i]
+          end.to_h
+          return if counts.empty?
+
+          {
+            key: key_match[1],
+            counts: counts,
+            start_line: item.location.start_line,
+            end_line: item.location.end_line
+          }
+        end
+
+        def project_file_update_entry(entries)
+          counts = entries.each_with_object(Hash.new(0)) do |entry, totals|
+            entry.fetch(:counts).each { |category, count| totals[category] += count }
+          end
+          total = counts.values.sum
+          details = counts.sort_by { |category, _count| category.to_s }.map do |category, count|
+            "  - #{category.to_s.tr("_", " ")} (#{count})"
+          end
+          ["- #{KEY_PREFIX} #{entries.first.fetch(:key)}: updated #{total} project file#{"s" unless total == 1}:", *details, ""].join("\n")
+        end
+      end
 
       def initialize(section:, key:, entry:, legacy_prefixes: [], root: Kettle::Dev::CIHelpers.project_root)
         @root = root

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