ratatui_ruby-devtools 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5e42c1eb334a8258f81be914b98c98d561eb88cbbd994bafdf1c795dc6eea976
-  data.tar.gz: 89c0cc556e030abc3c218842afd01c1320f9ee43adec14b5c8eddb62ac4f9cad
+  metadata.gz: 57fc1bc3e22f7db96b7434687a5ba68ebd2e791af094ca8c7b0fa93046c0c8e0
+  data.tar.gz: ce0771ddec4a189df1e9ec5de19a9bc2fad461b6265575380d1c15a8120e6939
 SHA512:
-  metadata.gz: e6d0b98c938b05cec67b959334be558e3b134c3ebc18297bd286168c35ddf6d5a2482891855dae53da7809e923ba996bc416dfe444f088c6cc9d7e83d59dbb76
-  data.tar.gz: b09df8f84796a39206e541540d793a635bbec3c6553cb0efeb9032f59caa96179ebe36d3962c073a007de6c66c8543c7cdc2f0fd013d86da0bd068c5136ef0d4
+  metadata.gz: ee73b0da8bbe0f1ae17c266f7320a6795036e7c8e9a2b9c2c0ecb2f4c125a788a319ed475a76e759e7531805fdafda9372ec6dd20baed006dc95fe95b00fc8a4
+  data.tar.gz: 14d72b6a59018d202eba6e175d4cf8716a4c42791ac759402a6367b23168fe6d6678e2199384cf34269b6d67899d7610ee19c0c8c73f6b5238b8506b28cebc72

data/CHANGELOG.md

@@ -21,6 +21,21 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Removed
 
+## [0.4.0] - 2026-10-23
+
+### Added
+
+- **Changes too small for copyright**: The license tasks wrote a copyright notice for every commit author whose lines remained in a file, even when all they changed was a path or a typo, which no one can hold copyright in. List such commits in `.git-blame-ignore-revs`, and the license tasks blame their lines on the commits before them. Git reads that file only when each contributor configures it, so the license tasks pass it to `git blame` themselves.
+
+### Changed
+
+### Fixed
+
+- **Scaffolded gem builds on Node.js 24**: The scaffolded `build-gems` workflow used versions of `actions/checkout`, `jdx/mise-action`, and the artifact actions that run on Node.js 20, which GitHub removed on September 16, 2026, so it could no longer build your precompiled gems. It now uses their Node.js 24 versions. Run `scaffold --update` to pick it up.
+- **License headers deleted lines above them**: When the license tasks rewrote a header, they deleted every line above it except `# frozen_string_literal: true`, such as a `# rubocop:disable` directive or a Rust `//!` comment. A Ruby script that opened with a shebang lost it, and one without a header got its new header above the shebang, so the script no longer ran. A file that opened with an encoding comment got `# frozen_string_literal: true` above it, and Ruby ignores an encoding comment below that line. Those lines now stay above the header, with the shebang first and the encoding comment right after it.
+
+### Removed
+
 ## [0.3.0] - 2026-10-22
 
 ### Added
@@ -141,6 +156,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Removed
 
 [Unreleased]: https://github.com/setdef/ratatui_ruby-devtools/tree/HEAD
+[0.4.0]: https://github.com/setdef/ratatui_ruby-devtools/releases/tag/v0.4.0
 [0.3.0]: https://github.com/setdef/ratatui_ruby-devtools/releases/tag/v0.3.0
 [0.2.1]: https://github.com/setdef/ratatui_ruby-devtools/releases/tag/v0.2.1
 [0.2.0]: https://github.com/setdef/ratatui_ruby-devtools/releases/tag/v0.2.0

data/README.md

@@ -219,6 +219,19 @@ RatatuiRuby::Devtools.install_gem_tasks!(
 ```
 <!-- SPDX-SnippetEnd -->
 
+Each header names the commit authors whose lines remain in the file, with the last year each touched them. Copyright protects only original expression, so a change too small to hold it, such as a corrected path, needs no notice. List its commit in `.git-blame-ignore-revs`, and the license tasks blame its lines on the commits before it, as GitHub's blame view does:
+
+<!-- SPDX-SnippetBegin -->
+<!--
+  SPDX-SnippetCopyrightText: 2026 Kerrick Long
+  SPDX-License-Identifier: MIT-0
+-->
+```text
+# Corrects the relative paths to examples/
+0123456789abcdef0123456789abcdef01234567
+```
+<!-- SPDX-SnippetEnd -->
+
 `rake reuse:fix` gives Ruby, RBS, Rust, and Markdown files the same headers the license tasks write. Environment variables set what it writes for other files:
 
 | Variable | Default |

data/lib/ratatui_ruby/devtools/tasks/license/blame.rb

@@ -16,8 +16,13 @@ require_relative "contribution"
 # Only commit authors count. Co-Authored-By trailers credit AI tools, which
 # can't hold copyright, and people whose idea a commit took up without their
 # code; git history already credits both.
+#
+# Commits listed in .git-blame-ignore-revs count for no one, so a change too
+# small to hold copyright, such as a corrected path, adds no notice. Git reads
+# that file only when each contributor configures it, so blame names it here.
 class Blame < Data.define(:path, :contents) # :nodoc:
   UNCOMMITTED = "0" * 40
+  IGNORE_REVS = ".git-blame-ignore-revs"
 
   def initialize(path:, contents: nil)
     super
@@ -54,6 +59,7 @@ class Blame < Data.define(:path, :contents) # :nodoc:
     command = %w[git blame --porcelain]
     command += ["-L", range.join(",")] if range
     command += ["--contents", "-"] if contents
+    command += ["--ignore-revs-file", IGNORE_REVS] if File.exist?(IGNORE_REVS)
     output, status = Open3.capture2(*command, "--", path, stdin_data: contents.to_s, err: File::NULL)
     return unless status.success?
 

data/lib/ratatui_ruby/devtools/tasks/license/rbs_header_syntax.rb

@@ -25,7 +25,9 @@ class RbsHeaderSyntax # :nodoc:
     "#{block(header)}\n#{lines.drop_while { |line| line.strip.empty? }.join}"
   end
 
+  # A magic comment means nothing in RBS.
   def replaced(header, lines, end_line)
-    "#{block(header)}\n#{after_header(lines, end_line).join}"
+    opening = preamble(lines, end_line).reject { |line| line.include?("frozen_string_literal") }
+    "#{opening.join}#{"\n" if opening.any?}#{block(header)}\n#{after_header(lines, end_line).join}"
   end
 end

data/lib/ratatui_ruby/devtools/tasks/license/ruby_comment_header.rb

@@ -46,4 +46,12 @@ module RubyCommentHeader # :nodoc:
   private def block(header)
     "#--\n#{header.commented('#')}#++\n"
   end
+
+  # The file's own lines among the header's, such as a shebang or a linter
+  # directive, which stay above the new header.
+  private def preamble(lines, end_line)
+    lines.take(end_line + 1).reject do |line|
+      line.match?(COPYRIGHT) || line.match?(LICENSE) || line.match?(/^#(--|\+\+)?\s*$/) || line.strip.empty?
+    end
+  end
 end

data/lib/ratatui_ruby/devtools/tasks/license/ruby_header_syntax.rb

@@ -13,6 +13,10 @@ class RubyHeaderSyntax # :nodoc:
   include RubyCommentHeader
 
   FROZEN_STRING_LITERAL = "# frozen_string_literal: true\n"
+  # Ruby finds an encoding wherever "coding" meets a colon or equals sign, as
+  # in Emacs and Vim modelines.
+  ENCODING_COMMENT = /\A#.*coding[:=]/
+  MAGIC_COMMENT = /\A#.*(coding[:=]|\b(frozen_string_literal|warn_indent|shareable_constant_value)\s*:)/
 
   def extensions
     %w[rb]
@@ -23,17 +27,21 @@ class RubyHeaderSyntax # :nodoc:
   end
 
   def added(header, lines)
-    frozen = frozen_string_literal_in(lines)
-    body = (frozen ? lines.drop(1) : lines).drop_while { |line| line.strip.empty? }
-    "#{frozen || FROZEN_STRING_LITERAL}\n#{block(header)}\n#{body.join}"
+    opening = lines.take_while { |line| line.start_with?("#!") || line.match?(MAGIC_COMMENT) }
+    body = lines.drop(opening.length).drop_while { |line| line.strip.empty? }
+    "#{frozen(opening).join}\n#{block(header)}\n#{body.join}"
   end
 
   def replaced(header, lines, end_line)
-    frozen = frozen_string_literal_in(lines)
-    "#{frozen || FROZEN_STRING_LITERAL}\n#{block(header)}\n#{after_header(lines, end_line).join}"
+    "#{frozen(preamble(lines, end_line)).join}\n#{block(header)}\n#{after_header(lines, end_line).join}"
   end
 
-  private def frozen_string_literal_in(lines)
-    lines.first if lines.first&.include?("frozen_string_literal")
+  # Ruby reads a shebang only on the first line, and an encoding comment only
+  # on the first line or right after a shebang.
+  private def frozen(opening)
+    return opening if opening.any? { |line| line.include?("frozen_string_literal") }
+
+    first_lines = opening.take_while { |line| line.start_with?("#!") || line.match?(ENCODING_COMMENT) }
+    opening.dup.insert(first_lines.length, FROZEN_STRING_LITERAL)
   end
 end

data/lib/ratatui_ruby/devtools/tasks/license/rust_header_syntax.rb

@@ -54,6 +54,15 @@ class RustHeaderSyntax # :nodoc:
   end
 
   def replaced(header, lines, end_line)
-    "#{header.commented('//')}\n#{after_header(lines, end_line).join}"
+    opening = preamble(lines, end_line)
+    "#{opening.join}#{"\n" if opening.any?}#{header.commented('//')}\n#{after_header(lines, end_line).join}"
+  end
+
+  # The file's own comments among the header's, which stay above the new
+  # header.
+  private def preamble(lines, end_line)
+    lines.take(end_line + 1).reject do |line|
+      line.match?(COPYRIGHT) || line.match?(LICENSE) || line.match?(%r{^//\s*$}) || line.strip.empty?
+    end
   end
 end

data/lib/ratatui_ruby/devtools/templates/.github/workflows/build-gems.yml.erb

@@ -23,7 +23,7 @@ jobs:
       CI: "true"
       BINDGEN_EXTRA_CLANG_ARGS: "-include stdbool.h"
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Override Ruby version in mise.toml
         shell: bash
@@ -47,7 +47,7 @@ jobs:
           rustup target add x86_64-pc-windows-gnu
 
       - name: Install toolchain via mise
-        uses: jdx/mise-action@v2
+        uses: jdx/mise-action@v4
 
       - name: Setup (Unix)
         if: runner.os != 'Windows'
@@ -63,7 +63,7 @@ jobs:
         run: mise x -- bundle exec rake
 
       - name: Upload compiled binary
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@v7
         with:
           name: native-${{ matrix.os }}-ruby${{ matrix.ruby }}
           path: lib/<%= ext_name %>/<%= ext_name %>.*
@@ -78,7 +78,7 @@ jobs:
       matrix:
         os: [ubuntu-latest, macos-latest, windows-latest]
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v6
 
       - name: Install Ruby via RubyInstaller (Windows)
         if: runner.os == 'Windows'
@@ -93,7 +93,7 @@ jobs:
 
       - name: Install toolchain via mise (Unix)
         if: runner.os != 'Windows'
-        uses: jdx/mise-action@v2
+        uses: jdx/mise-action@v4
 
       - name: Configure Windows mise (skip Ruby)
         if: runner.os == 'Windows'
@@ -103,11 +103,11 @@ jobs:
 
       - name: Install toolchain via mise (Windows)
         if: runner.os == 'Windows'
-        uses: jdx/mise-action@v2
+        uses: jdx/mise-action@v4
 
 <%- rubies.map { |r| r.split(".")[0..1].join(".") }.uniq.each do |minor| -%>
       - name: Download Ruby <%= minor %> binary
-        uses: actions/download-artifact@v4
+        uses: actions/download-artifact@v8
         with:
           name: native-${{ matrix.os }}-ruby<%= minor %>
           path: lib/<%= ext_name %>/<%= minor %>
@@ -123,7 +123,7 @@ jobs:
         run: mise x -- bundle exec rake release:platform_gem
 
       - name: Upload gem artifact
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@v7
         with:
           name: gem-${{ matrix.os }}
           path: pkg/*.gem

data/lib/ratatui_ruby/devtools/version.rb

@@ -8,6 +8,6 @@
 module RatatuiRuby
   module Devtools
     # Current version of the ratatui_ruby-devtools gem.
-    VERSION = "0.3.0"
+    VERSION = "0.4.0"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ratatui_ruby-devtools
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Kerrick Long