ratatui_ruby-devtools 0.2.1 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c1befd01f5a77d88a9f412a2391e5d63313ae753f911a40559a5f224a34ff689
-  data.tar.gz: 468f3157501a4d3db5bec7f5792a78a62ef6c9f0331c2653cc27022f544a6186
+  metadata.gz: 5e42c1eb334a8258f81be914b98c98d561eb88cbbd994bafdf1c795dc6eea976
+  data.tar.gz: 89c0cc556e030abc3c218842afd01c1320f9ee43adec14b5c8eddb62ac4f9cad
 SHA512:
-  metadata.gz: 5626c5277c857d8672a0755d8e65f885802aea22d70ef241992b70bf486cc391d91e87de04c2dcf9548ba14604a3d02038d0271156a955e2030bfffc603e8711
-  data.tar.gz: 6629beaf798067670830272e51ea5d78e8fd06c86432d7560995d65848cab37b2ea8ac42ab90e6595ac7ea44771e6180ba9e29faa9037a634cb1eea5ed096b7d
+  metadata.gz: e6d0b98c938b05cec67b959334be558e3b134c3ebc18297bd286168c35ddf6d5a2482891855dae53da7809e923ba996bc416dfe444f088c6cc9d7e83d59dbb76
+  data.tar.gz: b09df8f84796a39206e541540d793a635bbec3c6553cb0efeb9032f59caa96179ebe36d3962c073a007de6c66c8543c7cdc2f0fd013d86da0bd068c5136ef0d4

data/.rubocop.yml

@@ -5,4 +5,4 @@ inherit_from:
   - ./vendor/goodcop/base.yml
 
 AllCops:
-  TargetRubyVersion: "3.2"
+  TargetRubyVersion: "3.3"

data/AGENTS.md

@@ -35,7 +35,7 @@ This gem provides Rake tasks, linters, license enforcement, version bumping, and
 
 ### Ruby Standards
 
-- Use `Data.define` for all value objects (Ruby 3.2+).
+- Use `Data.define` for all value objects (Ruby 3.3+).
 - Define types in `.rbs` files. Don't use `untyped` just because it's easy; be comprehensive and accurate.
 - Every public Ruby class/method must be documented for humans in RDoc.
 

data/CHANGELOG.md

@@ -21,6 +21,51 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Removed
 
+## [0.3.0] - 2026-10-22
+
+### Added
+
+- **Rust SPDX headers**: Rust files in `ext/` had no license task, so you annotated them by hand and a wrong license slipped through easily. `rake license:headers:rs` now writes their SPDX headers, and `license:headers:all` and `license:new` run it too.
+- **RBS SPDX headers**: The Ruby header task also wrote headers into `.rbs` files, opening them with a `# frozen_string_literal: true` comment that means nothing in RBS. `rake license:headers:rbs` now writes their headers without it, and `license:headers:all` and `license:new` run it too. A signature loses the comment the next time its header changes.
+- **Lockfile Ruby check**: Bundler checks locked gems only against the Ruby that resolves them. A lockfile updated on your newest Ruby could hold gems your oldest supported Ruby can't install, and nothing failed until CI. `rake lint` now catches these gems and prints the `bundle lock` command that relocks them on the oldest Ruby.
+- **Link check**: Broken links in your docs fail silently, so your readers find them before you do. `rake doc:check_links` scans your gem's RDoc and Markdown for relative links to files that don't exist and for `file://` URLs that only work on your machine. It asks whether to check web URLs too, and fails when it finds a broken link.
+- **Prerelease versions**: Give a bump a label to release a candidate for the version it would release: `rake 'bump:minor[beta]'` takes `1.1.3` to `1.2.0-beta.1`, and again to `1.2.0-beta.2`. Another label starts again at `.1`, so `rake 'bump:minor[rc]'` then releases `1.2.0-rc.1`, and a label that would sort before the current one stops the bump. A bump without a label ships the candidate, so `rake bump:patch` takes `1.2.0-rc.1` to `1.2.0` instead of skipping to `1.2.1`. `rake bump:exact[1.0.0-rc.1]` still sets any prerelease by hand. A prerelease that isn't valid SemVer, such as `1.0.0-alpha.001`, stops the bump with an error that shows the right form.
+
+### Changed
+
+- **Settings move to `install_gem_tasks!`**: `RatatuiRuby::Devtools.gem_name`, `gemspec_file`, and `version_file`, and their setters, read as settings of devtools rather than of your gem. Pass them to `install_gem_tasks!` instead, as in `RatatuiRuby::Devtools.install_gem_tasks!(gem_name: "my_gem")`, along with the new `non_runtime_license:` and `snippet_paths:`. Devtools now finds your gemspec when it installs the tasks, so a gem with more than one gemspec passes `gemspec_file:` before any task runs.
+- **Each version's docs build with its own bundle**: `rake website:build` ran every version's doc tasks with the bundle you built from, so updating devtools or RDoc there changed the docs of every release on your site. Each version now builds with its own Ruby, bundle, and tasks, using RDoc 7.2.0 if it locked an older one. A version whose bundle no longer installs, such as one that locked a yanked gem or names a gem by a relative path, still builds with yours.
+- **RDoc 8**: RDoc 8 changed how its HTML formatter starts, so the doc tasks now need RDoc 8.1 or later. Change the `rdoc` development dependency in your gemspec to `"~> 8.1"`, or run `scaffold --update`; until then, Bundler can't install this release beside your gem. RDoc 8 renders your README only as `index.html` but still links `README.md` to `README_md.html`, so `rake rdoc` now writes that page as a redirect to `index.html`.
+- **Release branches from 1.0 on**: Minor and major releases happened on trunk, so a patch for an older series had no branch to land on. Once your gem reaches 1.0, a bump that releases a new minor or major version, one ending in `.0`, creates a `release/X.Y` branch from trunk, releases there, and imports the release into trunk. A bump that releases a patch runs on the release branch you have checked out and refuses to run on trunk. Finishing a prerelease such as `1.2.0-rc.1` releases `1.2.0`, so it runs on trunk whichever bump you use. Before 1.0, every bump releases on trunk. Every bump, `rake bump:exact` included, now follows these branch rules, commits for you instead of printing a suggested commit message, and stops if your working tree has uncommitted changes.
+- **Snippet copyright notices**: REUSE 3.3 requires copyright notices inside a code snippet to use `SPDX-SnippetCopyrightText`, and recommends a contact address. The scaffolded documentation's snippets now use that tag with your name and email. `rake license:snippets:all` writes new snippets the same way, crediting each author of the snippet's lines, and converts the tag in the snippets your docs already have. Run `scaffold --update` and then `rake license:snippets:all` to pick it up.
+- **License for each file**: The license tasks gave `lib/`, `ext/`, and `test/` the LGPL and everything else the AGPL, whatever your gem's license, and gave MIT-0 to examples whose names start with `widget_` or `verify_`. Code apps link, from your gemspec's `require_paths` and `extensions`, now takes the license in your gemspec. Everything else, including tests, `sig/`, and `exe/`, takes AGPL-3.0-or-later, or the `non_runtime_license:` you pass to `install_gem_tasks!`. Examples get MIT-0 only under the path prefixes you pass as `snippet_paths:`, so pass them in your Rakefile before running `rake license:headers:all`, or those examples become AGPL.
+- **Minitest 6**: Devtools required minitest 5, so your gem couldn't move to minitest 6. It now works with minitest 5.16 or later, up to 6, and the scaffolded `Gemfile` asks for `~> 6.0`. Minitest 6 moved `Minitest::Mock` and `stub` into the `minitest-mock` gem, which scaffolded gems already list as a development dependency; add it if your tests use either. Run `scaffold --update` to pick up the `Gemfile`.
+- **Scaffolded gems start at 0.0.0**: The scaffold started a new gem at `0.0.1.pre.1` and called it pre-release. A gem below 1.0 is in initial development, but its releases are normal versions that `gem install` and Bundler find. A prerelease is a candidate users install only with `--pre`. New gems now start at `0.0.0`, so your first `rake bump:patch` or `rake bump:minor` releases `0.0.1` or `0.1.0`, and their README and docs say "initial development". Run `scaffold --update` to pick up the wording.
+- **Scaffolded `bin/setup`**: Installs the bundle in `vendor/bundle` instead of the shared per-user gem directory, so native gems always match the project's Ruby. Run `scaffold --update` to pick it up.
+
+### Fixed
+
+- **License and bump tasks on Windows**: Devtools ran git through the shell with Unix quoting and redirection, which the Windows shell doesn't understand. On Windows, the license tasks found no files to license, and bumps failed to commit. They now run git directly. The license tasks also wrote every file they changed with Windows line endings, which made `git blame` see each line as new and date snippets to the current year; they now keep each file's own line endings. `rake reuse:fix` read the REUSE Tool's Windows paths as unknown files and gave them the tool's own headers; it now gives them devtools' headers, as everywhere else.
+- **License check in scaffolded CI on macOS and Windows**: The scaffolded `bin/setup` and `bin/setup.ps1` installed the REUSE Tool with no way to detect file encodings. On runners without libmagic, such as macOS and Windows, `reuse lint` stopped with `NoEncodingModuleError`. They now install its `charset-normalizer` extra. Run `scaffold --update` to pick it up.
+- **Scaffolded CI on Ruby 4.0**: The scaffold pinned your CI's newest Ruby to one patch release, so CI never tested a later 4.0.x. It now names 4.0, which CI resolves to the newest 4.0 patch release, as it already did for 3.3 and 3.4. Run `scaffold --update` to pick it up.
+- **Version links on GitHub**: `rake bump:*` only understood SourceHut's changelog links, so a gem on GitHub got no link for each new version, and nothing said so. On GitHub, the Unreleased link now browses `HEAD`, and the new version links to its release. A link into any other forge now gets a warning. The scaffolded `CHANGELOG.md` starts with an Unreleased link to your GitHub repository, so your first bump links your first release. Versions bumped before this have no link; add theirs by hand.
+- **Scaffolded copyright notices**: The scaffold credited Kerrick Long, not you, in the SPDX headers of `CHANGELOG.md` and `.gitignore` and in the `REUSE.toml` annotation for `doc/images/`. It now credits you, as it does everywhere else. Run `scaffold --update` to fix `.gitignore` and `REUSE.toml`, and fix `CHANGELOG.md` by hand, since the update leaves it alone.
+- **First bump of a scaffolded gem**: The scaffold's `CHANGELOG.md` has nothing released yet and no version links, so every `rake bump:*` stopped with `Could not parse CHANGELOG.md`. Bumps now release into a changelog without either. Every bump also dropped the changelog's final newline, and now keeps it.
+- **First release of a scaffolded gem**: The scaffold creates a `stable` branch but doesn't push it. `rake release` then failed at its last step, pushing `stable` to origin, because git couldn't tell the name was meant as a new branch. The release now creates `stable` on origin when it isn't there yet.
+- **Bumping a Rust gem with a dash in its name**: The scaffold puts a gem's crate in `ext/` under the gem's name with underscores, as Cargo wants, but `rake bump:*` looked under the name with its dash. For a gem like `my-gem`, the bump left the crate's `Cargo.toml` and `Cargo.lock` at the old version. It now finds the crate where the scaffold puts it and refreshes the package its `Cargo.toml` names.
+- **`rake website:build` ignored `gemspec_file`**: The other tasks read the gemspec you named. The website build read the first `*.gemspec` in your gem's directory instead, so a gem with more than one could get a site titled after the wrong one. It now reads the gemspec you pass as `gemspec_file:`, like the other tasks.
+- **Platform gems in your gem's CI**: The scaffolded `build-gems` workflow packaged precompiled gems with `ruby tasks/release/platform_gem.rb`, a script that only exists inside devtools, so the Package job failed. The job now installs your bundle and runs `rake release:platform_gem`, and the gem it builds for Apple Silicon installs on every macOS version. Run `scaffold --update` to pick it up.
+- **License tasks in your gem**: The `license:headers:*` and `license:snippets:*` tasks ran their scripts from your gem's own `tasks/license/` directory, which only exists in the gem devtools came from, so they failed with `No such file or directory`. They now run the scripts devtools ships.
+- **`rake reuse:fix` credited Kerrick Long**: It annotated every file it fixed with Kerrick Long's copyright, no matter who ran it. It now uses the identity git gives your commits, from `user.name` and `user.email` or the `GIT_AUTHOR_*` variables, and stops with instructions when git doesn't know who you are. `REUSE_COPYRIGHT` still overrides it.
+- **`rake reuse:fix` wrote the wrong headers**: It gave every code file AGPL-3.0-or-later, even in `lib/` of an LGPL gem, in the REUSE Tool's header format rather than yours. It also quit at the first `.rbs` file, `Gemfile.lock`, or `.txt` file, which the REUSE Tool can't comment, leaving the files after it bare. On Windows it failed on every file, because the shell there ignores single quotes and split your name at its spaces. Ruby, RBS, Rust, and Markdown files now get the headers the license tasks write, and other code takes the license the license tasks would choose unless you set `REUSE_CODE_LICENSE`. `Gemfile.lock` and plain text get a `.license` file beside them, and the REUSE Tool gets your name without a shell in between.
+- **Short and RubyGems-style versions**: A version like `1.2` crashed `rake bump:patch`. A RubyGems-style prerelease like `1.0.0.beta.1` was read as `1.0.0`, so the next bump skipped past the release. `1.2` now bumps as `1.2.0`, and `1.0.0.beta.1` stops the bump with an error asking for `1.0.0-beta.1`. `rake release` stops on either form before Bundler tags or publishes anything, and says how to write the version in full. A gem scaffolded by an earlier devtools starts at `0.0.1.pre.1`, which the bump now stops on too, so change its version to `0.0.0` before your first release.
+
+### Removed
+
+- **Ruby 3.2**: Ruby 3.2 reached end of life on 2026-03-31, so devtools now needs Ruby 3.3.11 or later. Scaffolded gems test on Ruby 3.3, 3.4, and 4.0, and RuboCop checks them as Ruby 3.3. On Ruby 3.2, keep using devtools 0.2.
+- **Unused scaffolded files**: The scaffold wrote `tasks/resources/rubies.yml`, which only the old SourceHut build generator read, and `tasks/resources/index.html.erb`, which the website build never reads because it uses the copy inside devtools. New gems no longer get either; delete them from yours.
+- **`rake reuse:normalize_ruby`**: It moved the bare SPDX lines the REUSE Tool wrote into Ruby files below the magic comment and between `#--` and `#++`. `rake reuse:fix` now writes Ruby headers that way itself, so there is nothing left to normalize.
+
 ## [0.2.1] - 2026-02-16
 
 ### Added
@@ -95,10 +140,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Removed
 
-[Unreleased]: https://git.sr.ht/~kerrick/ratatui_ruby-devtools/refs/HEAD
-[0.2.1]: https://git.sr.ht/~kerrick/ratatui_ruby-devtools/refs/v0.2.1
-[0.2.0]: https://git.sr.ht/~kerrick/ratatui_ruby-devtools/refs/v0.2.0
-[0.1.3]: https://git.sr.ht/~kerrick/ratatui_ruby-devtools/refs/v0.1.3
-[0.1.2]: https://git.sr.ht/~kerrick/ratatui_ruby-devtools/refs/v0.1.2
-[0.1.1]: https://git.sr.ht/~kerrick/ratatui_ruby-devtools/refs/v0.1.1
-[0.1.0]: https://git.sr.ht/~kerrick/ratatui_ruby-devtools/refs/v0.1.0
+[Unreleased]: https://github.com/setdef/ratatui_ruby-devtools/tree/HEAD
+[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
+[0.1.3]: https://github.com/setdef/ratatui_ruby-devtools/releases/tag/v0.1.3
+[0.1.2]: https://github.com/setdef/ratatui_ruby-devtools/releases/tag/v0.1.2
+[0.1.1]: https://github.com/setdef/ratatui_ruby-devtools/releases/tag/v0.1.1
+[0.1.0]: https://github.com/setdef/ratatui_ruby-devtools/releases/tag/v0.1.0

data/README.md

@@ -5,15 +5,15 @@
 # ratatui_ruby-devtools
 
 [![
-builds.sr.ht status](https://builds.sr.ht/~kerrick/ratatui_ruby-devtools.svg)](https://builds.sr.ht/~kerrick/ratatui_ruby-devtools?) [![
+CI](https://github.com/setdef/ratatui_ruby-devtools/actions/workflows/ci.yml/badge.svg?branch=stable)](https://github.com/setdef/ratatui_ruby-devtools/actions/workflows/ci.yml) [![
 License](https://img.shields.io/badge/License-AGPL--3.0--or--later-a2c93e)](https://spdx.org/licenses/AGPL-3.0-or-later.html) [![
 Gem Version](https://img.shields.io/gem/v/ratatui_ruby-devtools)](https://rubygems.org/gems/ratatui_ruby-devtools) [![
-Mailing List: Development](https://img.shields.io/badge/mailing_list-development-4954d5.svg?logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIyNCIgaGVpZ2h0PSIyNCIgdmlld0JveD0iMCAwIDI0IDI0IiBmaWxsPSJub25lIiBzdHJva2U9IiNmZmZmZmYiIHN0cm9rZS13aWR0aD0iMiIgc3Ryb2tlLWxpbmVjYXA9InJvdW5kIiBzdHJva2UtbGluZWpvaW49InJvdW5kIiBjbGFzcz0iaWNvbiBpY29uLXRhYmxlciBpY29ucy10YWJsZXItb3V0bGluZSBpY29uLXRhYmxlci1tYWlsIj48cGF0aCBzdHJva2U9Im5vbmUiIGQ9Ik0wIDBoMjR2MjRIMHoiIGZpbGw9Im5vbmUiLz48cGF0aCBkPSJNMyA3YTIgMiAwIDAgMSAyIC0yaDE0YTIgMiAwIDAgMSAyIDJ2MTBhMiAyIDAgMCAxIC0yIDJoLTE0YTIgMiAwIDAgMSAtMiAtMnYtMTB6IiAvPjxwYXRoIGQ9Ik0zIDdsOSA2bDkgLTYiIC8+PC9zdmc+Cg==)](https://lists.sr.ht/~kerrick/ratatui_ruby-devel)
+Issues](https://img.shields.io/github/issues/setdef/ratatui_ruby-devtools)](https://github.com/setdef/ratatui_ruby-devtools/issues)
 
 
 ## Introduction
 
-**ratatui_ruby-devtools** provides shared development tooling for the [RatatuiRuby ecosystem](https://sr.ht/~kerrick/ratatui_ruby/). It includes Rake tasks, linters, license enforcement, and build tooling used across all RatatuiRuby gems.
+**ratatui_ruby-devtools** provides shared development tooling for the [RatatuiRuby ecosystem](https://www.ratatui-ruby.dev). It includes Rake tasks, linters, license enforcement, and build tooling used across all RatatuiRuby gems.
 
 This is a **non-runtime** gem. It provides build tooling—not application features. Add it to your `:development` group only.
 
@@ -23,15 +23,15 @@ This is a **non-runtime** gem. It provides build tooling—not application featu
 
 ### The Ecosystem
 
-**RatatuiRuby:** [Core engine](https://git.sr.ht/~kerrick/ratatui_ruby) • **Tea:** [MVU architecture](https://github.com/setdef/Rooibos) • **Kit:** [Component architecture](https://git.sr.ht/~kerrick/ratatui_ruby-kit) (Planned) • **DSL:** [Glimmer syntax](https://sr.ht/~kerrick/ratatui_ruby/#chapter-4-the-syntax) (Planned) • **Framework:** [Omakase framework](https://git.sr.ht/~kerrick/ratatui_ruby-framework) (Planned) • **UI:** [Polished widgets](https://git.sr.ht/~kerrick/ratatui_ruby-ui) (Planned) • **UI Pro:** [More polished widgets](https://sr.ht/~kerrick/ratatui_ruby#chapter-6-licensing) (Planned)
+**RatatuiRuby:** [Core engine](https://github.com/setdef/RatatuiRuby) • **Rooibos:** [MVU architecture](https://www.rooibos.run) • **Kit:** [Component architecture](https://git.sr.ht/~kerrick/ratatui_ruby-kit) (Planned) • **DSL:** [Glimmer syntax](https://sr.ht/~kerrick/ratatui_ruby/#chapter-4-the-syntax) (Planned) • **Framework:** [Omakase framework](https://git.sr.ht/~kerrick/ratatui_ruby-framework) (Planned) • **UI:** [Polished widgets](https://git.sr.ht/~kerrick/ratatui_ruby-ui) (Planned) • **UI Pro:** [More polished widgets](https://sr.ht/~kerrick/ratatui_ruby#chapter-6-licensing) (Planned)
 
 ### For App Developers
 
-**Get Started:** [Quickstart](https://git.sr.ht/~kerrick/ratatui_ruby/tree/stable/item/doc/getting_started/quickstart.md) • [Examples](https://git.sr.ht/~kerrick/ratatui_ruby/tree/stable/item/examples) ⸺ **Stay Informed:** [Announce List](https://lists.sr.ht/~kerrick/ratatui_ruby-announce) • [FAQ](https://man.sr.ht/~kerrick/ratatui_ruby/troubleshooting.md) ⸺ **Reach Out:** [Discuss List](https://lists.sr.ht/~kerrick/ratatui_ruby-discuss) • [Bug Tracker](https://todo.sr.ht/~kerrick/ratatui_ruby)
+**Get Started:** [Quickstart](https://github.com/setdef/RatatuiRuby/blob/stable/doc/getting_started/quickstart.md) • [Examples](https://github.com/setdef/RatatuiRuby/blob/stable/examples/app_all_events/README.md) ⸺ **Stay Informed:** [Announcements](https://forum.setdef.com/tags/c/ratatui-ruby/6/announcement) • [FAQ](https://man.sr.ht/~kerrick/ratatui_ruby/troubleshooting.md) ⸺ **Reach Out:** [Forum](https://forum.setdef.com/c/ratatui-ruby/6) • [Bug Tracker](https://forum.setdef.com/tags/c/ratatui-ruby/6/bug)
 
 ### For Contributors
 
-**Get Started:** [Contributing Guide](https://man.sr.ht/~kerrick/ratatui_ruby/contributing.md) • [Code of Conduct](https://man.sr.ht/~kerrick/ratatui_ruby/code_of_conduct.md) ⸺ **Stay Informed:** [Announce List](https://lists.sr.ht/~kerrick/ratatui_ruby-announce) • [Project History](https://man.sr.ht/~kerrick/ratatui_ruby/history/index.md) ⸺ **Reach Out:** [Development List](https://lists.sr.ht/~kerrick/ratatui_ruby-devel) • [Bug Tracker](https://todo.sr.ht/~kerrick/ratatui_ruby)
+**Get Started:** [Contributing Guide](https://man.sr.ht/~kerrick/ratatui_ruby/contributing.md) • [Code of Conduct](https://man.sr.ht/~kerrick/ratatui_ruby/code_of_conduct.md) ⸺ **Stay Informed:** [Announcements](https://forum.setdef.com/tags/c/ratatui-ruby/6/announcement) • [Project History](https://man.sr.ht/~kerrick/ratatui_ruby/history/index.md) ⸺ **Reach Out:** [Issues](https://github.com/setdef/ratatui_ruby-devtools/issues)
 
 ---
 
@@ -41,7 +41,7 @@ Add this line to your application's Gemfile:
 
 <!-- SPDX-SnippetBegin -->
 <!--
-  SPDX-FileCopyrightText: 2026 Kerrick Long
+  SPDX-SnippetCopyrightText: 2026 Kerrick Long
   SPDX-License-Identifier: MIT-0
 -->
 ```ruby
@@ -55,7 +55,7 @@ And then execute:
 
 <!-- SPDX-SnippetBegin -->
 <!--
-  SPDX-FileCopyrightText: 2026 Kerrick Long
+  SPDX-SnippetCopyrightText: 2026 Kerrick Long
   SPDX-License-Identifier: MIT-0
 -->
 ```bash
@@ -70,7 +70,7 @@ In your `Rakefile`:
 
 <!-- SPDX-SnippetBegin -->
 <!--
-  SPDX-FileCopyrightText: 2026 Kerrick Long
+  SPDX-SnippetCopyrightText: 2026 Kerrick Long
   SPDX-License-Identifier: MIT-0
 -->
 ```ruby
@@ -96,7 +96,9 @@ This imports all devtools rake tasks into your project.
 | `rake lint:fix` | Auto-fix all linting issues |
 | `rake rubocop` | Run RuboCop |
 | `rake rubycritic` | Run RubyCritic |
+| `rake lint:lockfile_ruby` | Check that every locked gem installs on the oldest supported Ruby |
 | `rake doc:suggest` | Suggest documentation improvements |
+| `rake doc:check_links` | Check for broken links in RDoc and Markdown files |
 
 ### License Enforcement
 
@@ -115,8 +117,19 @@ This imports all devtools rake tasks into your project.
 | `rake bump:major` | Bump major version |
 | `rake bump:minor` | Bump minor version |
 | `rake bump:patch` | Bump patch version |
+| `rake 'bump:minor[rc]'` | Bump to a prerelease, such as `1.2.0-rc.1` |
 | `rake bump:exact[0.1.0]` | Set exact version |
 
+Every bump commits the release for you and refuses to start on the wrong branch or with uncommitted changes.
+
+Before 1.0, your gem is in initial development, and its API can change in any release. Those releases are still normal versions, so `gem install` and Bundler find them. A new gem starts at `0.0.0`, so its first `bump:patch` or `bump:minor` releases `0.0.1` or `0.1.0`.
+
+A prerelease is different. `1.2.0-beta.1` is a candidate for `1.2.0`, and users get it only with `gem install --pre` or a requirement that names a prerelease. A bump makes one only when you give it a label: `rake 'bump:minor[beta]'` takes `1.1.3` to `1.2.0-beta.1`, and again to `1.2.0-beta.2`. Another label starts again at `.1`, so `rake 'bump:minor[rc]'` then releases `1.2.0-rc.1`. A label has to sort after the one you're on, because SemVer compares labels as text: `rc` follows `beta`, but `beta` doesn't follow `dev`. A bump without a label ships the candidate, so `bump:minor` or `bump:patch` takes `1.2.0-rc.1` to `1.2.0`. Candidates release on trunk.
+
+Before 1.0, every release comes from trunk. Run any bump there.
+
+From 1.0 on, each minor version gets a release branch, so its users can take patch releases without the next minor's changes. A bump that releases a new minor or major version, one ending in `.0`, runs on trunk: it creates `release/X.Y`, commits the release there, imports the release into trunk, and commits that too. A bump that releases a patch runs on the release branch it fixes. The version decides, not the task: finishing `1.2.0-beta.1` releases `1.2.0`, so even `bump:patch` runs on trunk and creates `release/1.2`. The first release of 1.0 starts this workflow.
+
 
 ## Executables
 
@@ -126,7 +139,7 @@ An AI-friendly wrapper for `bundle exec rake` that captures all output and only
 
 <!-- SPDX-SnippetBegin -->
 <!--
-  SPDX-FileCopyrightText: 2026 Kerrick Long
+  SPDX-SnippetCopyrightText: 2026 Kerrick Long
   SPDX-License-Identifier: MIT-0
 -->
 ```bash
@@ -153,8 +166,6 @@ Devtools includes templates for scaffolding new ecosystem gems:
 | `AGENTS.md.erb` | AI agent instructions |
 | `.pre-commit-config.yaml` | Pre-commit hooks |
 | `Rakefile.erb` | Standard Rakefile |
-| `sourcehut.rake.erb` | SourceHut CI task |
-| `build.yml.erb` | SourceHut build manifest |
 | `gemspec.erb` | Standard gemspec |
 | `bin/setup.erb` | Setup script |
 | `mise.toml.erb` | Toolchain versions |
@@ -166,7 +177,7 @@ Access templates via:
 
 <!-- SPDX-SnippetBegin -->
 <!--
-  SPDX-FileCopyrightText: 2026 Kerrick Long
+  SPDX-SnippetCopyrightText: 2026 Kerrick Long
   SPDX-License-Identifier: MIT-0
 -->
 ```ruby
@@ -178,31 +189,48 @@ RatatuiRuby::Devtools.templates_path
 
 ## Configuration
 
-Tasks auto-discover gem configuration from your `*.gemspec`. Override if needed:
+Tasks find your gemspec, your gem's name, and its version file from your gem's files. Pass any of them when you install the tasks, if your gem keeps them elsewhere:
+
+<!-- SPDX-SnippetBegin -->
+<!--
+  SPDX-SnippetCopyrightText: 2026 Kerrick Long
+  SPDX-License-Identifier: MIT-0
+-->
+```ruby
+RatatuiRuby::Devtools.install_gem_tasks!(
+  gem_name: "my_gem",
+  version_file: "lib/my_gem/version.rb"
+)
+```
+<!-- SPDX-SnippetEnd -->
+
+The license tasks give the code apps link, from your gemspec's `require_paths` and `extensions`, the license in your gemspec. Everything else, such as tests, tasks, and type signatures, gets AGPL-3.0-or-later. Examples that app developers copy whole are snippets grown large, so you can give them MIT-0 like the snippets in your docs. A commercial gem can license its other code differently:
 
 <!-- SPDX-SnippetBegin -->
 <!--
-  SPDX-FileCopyrightText: 2026 Kerrick Long
+  SPDX-SnippetCopyrightText: 2026 Kerrick Long
   SPDX-License-Identifier: MIT-0
 -->
 ```ruby
-RatatuiRuby::Devtools.gem_name = "my_gem"
-RatatuiRuby::Devtools.version_file = "lib/my_gem/version.rb"
+RatatuiRuby::Devtools.install_gem_tasks!(
+  snippet_paths: %w[examples/widget_ examples/verify_],
+  non_runtime_license: "LicenseRef-Commercial"
+)
 ```
 <!-- SPDX-SnippetEnd -->
 
-Environment variables for REUSE tasks:
+`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 |
 |----------|---------|
-| `REUSE_COPYRIGHT` | `Kerrick Long <me@kerricklong.com>` |
-| `REUSE_CODE_LICENSE` | `AGPL-3.0-or-later` |
+| `REUSE_COPYRIGHT` | Your git `user.name` and `user.email` |
+| `REUSE_CODE_LICENSE` | The license the license tasks would choose |
 | `REUSE_DOC_LICENSE` | `CC-BY-SA-4.0` |
 
 
 ## Contributing
 
-Bug reports and pull requests are welcome on [sourcehut](https://sourcehut.org) at https://sr.ht/~kerrick/ratatui_ruby/. This project is intended to be a safe, productive collaboration, and contributors are expected to adhere to the [Code of Conduct](https://man.sr.ht/~kerrick/ratatui_ruby/code_of_conduct.md).
+Bug reports and pull requests are welcome on [GitHub](https://github.com/setdef/ratatui_ruby-devtools/issues). This project is intended to be a safe, productive collaboration, and contributors are expected to adhere to the [Code of Conduct](https://man.sr.ht/~kerrick/ratatui_ruby/code_of_conduct.md).
 
 Want to help develop **ratatui_ruby-devtools**? Check out the [contribution guide on the wiki](https://man.sr.ht/~kerrick/ratatui_ruby/contributing.md).
 

data/Rakefile

@@ -10,4 +10,4 @@ require_relative "lib/ratatui_ruby/devtools"
 
 RatatuiRuby::Devtools.install!
 
-task default: %i[lint]
+task default: %i[test lint]

data/bin/setup

@@ -6,12 +6,26 @@ set -euo pipefail
 IFS=$'\n\t'
 set -vx
 
-if command -v mise >/dev/null 2>&1; then
-  mise install
-  mise x -- pip install reuse
-  mise x -- bundle install
-  pre-commit install
-else
+if ! command -v mise >/dev/null 2>&1; then
   echo "mise isn't installed. Please install it to continue." >&2
   exit 1
 fi
+
+mise install
+mise x -- pip install 'reuse[charset-normalizer]'
+mise x -- gem install bundler:4.0.3
+
+# A gem in the per-user gem directory may have been built for another Ruby,
+# so install the bundle inside the repo instead.
+mise x -- bundle config set --local path vendor/bundle
+
+if [ "${CI:-}" = "true" ]; then
+  bundle config set --local frozen 'true'
+fi
+
+mise x -- bundle install
+
+if [ "${CI:-}" != "true" ]; then
+  pre-commit install
+  bundle exec rake rdoc
+fi

data/bin/setup.ps1

@@ -0,0 +1,74 @@
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+
+$ErrorActionPreference = "Stop"
+Set-StrictMode -Version Latest
+
+if (-not (Get-Command mise -ErrorAction SilentlyContinue)) {
+  Write-Error "mise isn't installed. Please install it to continue: https://mise.jdx.dev"
+  exit 1
+}
+
+# Read the Ruby version from mise.toml so we install the matching RubyInstaller.
+$rubyVersion = (Select-String -Path mise.toml -Pattern 'ruby\s*=\s*"([^"]+)"').Matches.Groups[1].Value
+$rubyMajorMinor = ($rubyVersion -split '\.')[0..1] -join '.'
+
+# mise cannot compile Ruby from source on Windows (ruby-build produces broken
+# native extension support). Install Ruby via RubyInstaller, which bundles the
+# MSYS2 devkit for native gem compilation.
+if (-not (Get-Command ruby -ErrorAction SilentlyContinue) -or -not ((ruby --version) -match $rubyMajorMinor)) {
+  Write-Host "Ruby $rubyMajorMinor is required but not installed."
+  if ($env:CI -ne "true") {
+    $answer = Read-Host "Install it now via RubyInstaller (winget)? This will require administrator privileges. [Y/n]"
+    if ($answer -and $answer -notmatch '^[Yy]') {
+      Write-Error "Cannot continue without Ruby."
+      exit 1
+    }
+  }
+  winget install --id "RubyInstallerTeam.RubyWithDevKit.$rubyMajorMinor" --accept-source-agreements --accept-package-agreements
+  # Refresh PATH so ruby is available
+  $env:Path = [System.Environment]::GetEnvironmentVariable("Path", "Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path", "User")
+}
+
+# Create .mise.local.toml (gitignored) with Windows-specific overrides:
+#   - disable_tools: prevents mise from installing its own (broken) Ruby
+if (-not (Test-Path .mise.local.toml) -or -not (Select-String -Path .mise.local.toml -Pattern 'disable_tools' -Quiet)) {
+  $localToml = @"
+
+[settings]
+disable_tools = ["ruby"]
+"@
+  Add-Content -Path .mise.local.toml -Value $localToml
+}
+
+# mise handles Python and pre-commit. Ruby is disabled above.
+mise install
+mise x -- python -m pip install 'reuse[charset-normalizer]'
+
+# pip installs scripts (like reuse.exe) to Python's Scripts directory,
+# which mise does not add to PATH.
+if (-not (Select-String -Path .mise.local.toml -Pattern '\[env\]' -Quiet -ErrorAction SilentlyContinue)) {
+  $scriptsDir = (mise x -- python -c "import sysconfig; print(sysconfig.get_path('scripts'))").Trim()
+  $envToml = @"
+
+[env]
+_.path = ["$($scriptsDir -replace '\\', '/')"]
+"@
+  Add-Content -Path .mise.local.toml -Value $envToml
+}
+gem install bundler:4.0.3
+
+# A gem in the per-user gem directory may have been built for another Ruby,
+# so install the bundle inside the repo instead.
+bundle config set --local path vendor/bundle
+
+if ($env:CI -eq "true") {
+  bundle config set --local frozen true
+}
+
+bundle install
+
+if ($env:CI -ne "true") {
+  pre-commit install
+  bundle exec rake rdoc
+}

data/doc/contributors/documentation_style.md

@@ -34,7 +34,7 @@ Every public class must begin with a **Context-Problem-Solution** narrative.
 **Bad (Generic/Descriptive):**
 <!-- SPDX-SnippetBegin -->
 <!--
-  SPDX-FileCopyrightText: 2025 Kerrick Long
+  SPDX-SnippetCopyrightText: 2025 Kerrick Long
   SPDX-License-Identifier: MIT-0
 -->
 ```ruby
@@ -47,7 +47,7 @@ Every public class must begin with a **Context-Problem-Solution** narrative.
 **Good (Alexandrian/Zinsser/Plain Language):**
 <!-- SPDX-SnippetBegin -->
 <!--
-  SPDX-FileCopyrightText: 2025 Kerrick Long
+  SPDX-SnippetCopyrightText: 2025 Kerrick Long
   SPDX-License-Identifier: MIT-0
 -->
 ```ruby
@@ -87,7 +87,7 @@ Every public class must begin with a **Context-Problem-Solution** narrative.
 
 <!-- SPDX-SnippetBegin -->
 <!--
-  SPDX-FileCopyrightText: 2025 Kerrick Long
+  SPDX-SnippetCopyrightText: 2025 Kerrick Long
   SPDX-License-Identifier: MIT-0
 -->
 ```ruby
@@ -106,7 +106,6 @@ Every public class must begin with a **Context-Problem-Solution** narrative.
 
 ## 4. RDoc Specifics
 
-*   **No Endless Methods:** Do **not** use Ruby 3.0+ endless method definitions (`def foo = bar`). RDoc currently has a bug where it fails to correctly parse the end of the method, causing subsequent methods to be nested incorrectly in the documentation tree. Always use standard `def ... end` blocks.
 *   **No YARD:** Do not use `@param`, `@return`, or other YARD tags. Use standard RDoc formats.
 *   **Directives:** Use `:nodoc:` for private or internal methods that should not appear in the API docs.
 *   **Headings:** Use `===` for section headers like `=== Examples`.