ratatui_ruby-devtools 0.1.3 → 0.2.0

data/lib/ratatui_ruby/devtools/tasks/release/ci_run.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+#--
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+#++
+
+require "open3"
+require "json"
+require "tmpdir"
+
+# A completed GitHub Actions workflow run for a specific commit.
+class CIRun < Data.define(:id)
+  ##
+  # The GitHub Actions workflow name that produces native gem artifacts.
+  WORKFLOW_NAME = "Build Gems"
+
+  # Finds the most recent successful run for the given commit SHA.
+  def self.for_commit(sha)
+    out, status = Open3.capture2(
+      "gh", "run", "list",
+      "--workflow", WORKFLOW_NAME,
+      "--commit", sha,
+      "--status", "completed",
+      "--json", "databaseId,conclusion",
+      "--limit", "1"
+    )
+    return nil unless status.success?
+
+    runs = JSON.parse(out)
+    run = runs.first
+    return nil unless run
+    return nil unless run.fetch("conclusion") == "success"
+
+    new(id: run.fetch("databaseId"))
+  end
+
+  # Downloads artifacts into +dir+ and returns paths to the .gem files.
+  def download(dir)
+    puts "Downloading native gem artifacts from run #{id}..."
+    system("gh", "run", "download", id.to_s, "--dir", dir, exception: true)
+    Dir.glob("#{dir}/**/*.gem")
+  end
+end

data/lib/ratatui_ruby/devtools/tasks/release/github_cli.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+#--
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+#++
+
+# GitHubCli wraps availability and authentication checks for the `gh` CLI.
+class GitHubCli
+  # Whether the +gh+ binary is on PATH.
+  def available?
+    system("command", "-v", "gh", out: File::NULL, err: File::NULL)
+  end
+
+  # Whether +gh auth status+ reports a valid session.
+  def authenticated?
+    system("gh", "auth", "status", out: File::NULL, err: File::NULL)
+  end
+
+  # Whether the CLI is both installed and authenticated.
+  def ready?
+    available? && authenticated?
+  end
+
+  # Prints advisory when the +gh+ binary cannot be found.
+  def warn_unavailable
+    warn "\n⚠  'gh' CLI not found — skipping native gem push."
+    warn "   Install: https://cli.github.com\n\n"
+  end
+
+  # Prints advisory when +gh+ is installed but not logged in.
+  def warn_unauthenticated
+    warn "\n⚠  'gh' is not authenticated — skipping native gem push."
+    warn "   Run: gh auth login\n\n"
+  end
+end

data/lib/ratatui_ruby/devtools/tasks/release/native_gem_version.rb

@@ -0,0 +1,70 @@
+# frozen_string_literal: true
+
+#--
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+#++
+
+require "tmpdir"
+
+require_relative "github_cli"
+require_relative "ci_run"
+
+# A native gem version identified by its version string and commit SHA.
+# Knows how to release itself by downloading CI artifacts and pushing to RubyGems.
+class NativeGemVersion < Data.define(:version, :sha)
+  ##
+  # Downloads CI artifacts for this version and pushes them to RubyGems.org.
+  def release
+    cli = GitHubCli.new
+
+    unless cli.available?
+      cli.warn_unavailable
+      return
+    end
+
+    unless cli.authenticated?
+      cli.warn_unauthenticated
+      return
+    end
+
+    run = CIRun.for_commit(sha)
+
+    unless run
+      warn "\n⚠  No completed '#{CIRun::WORKFLOW_NAME}' run found for v#{version} (#{sha[0, 7]})."
+      warn "   Native gems were not pushed to RubyGems.org.\n\n"
+      return
+    end
+
+    Dir.mktmpdir("native-gems") do |dir|
+      gem_paths = run.download(dir)
+
+      if gem_paths.empty?
+        warn "\n⚠  No .gem files found in artifacts for run #{run.id}."
+        warn "   Native gems were not pushed to RubyGems.org.\n\n"
+      else
+        verify_versions!(gem_paths)
+        push(gem_paths)
+      end
+    end
+  end
+
+  private def verify_versions!(gem_paths)
+    expected = Gem::Version.new(version).to_s
+    mismatched = gem_paths.reject { |path| File.basename(path).include?(expected) }
+    return if mismatched.empty?
+
+    names = mismatched.map { |path| "  - #{File.basename(path)}" }.join("\n")
+    abort "Fatal: Version mismatch in downloaded artifacts!\n" \
+      "Expected version #{expected} but found:\n#{names}"
+  end
+
+  private def push(gem_paths)
+    gem_paths.each do |gem_path|
+      name = File.basename(gem_path)
+      puts "Pushing #{name} to RubyGems.org..."
+      system("gem", "push", gem_path, exception: true)
+    end
+    puts "\n✓ Pushed #{gem_paths.size} native gem#{'s' if gem_paths.size != 1} to RubyGems.org."
+  end
+end

data/lib/ratatui_ruby/devtools/tasks/release/platform_gem.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+#--
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+#++
+
+require "rubygems"
+require "rubygems/package"
+require "fileutils"
+
+require_relative "versioned_binary"
+
+# A platform-specific gem assembled from pre-compiled versioned binaries.
+#
+# CI builds produce one compiled binary per Ruby version per OS.
+# A PlatformGem collects those binaries and packages them into a single
+# installable gem that serves all supported Ruby versions.
+class PlatformGem
+  # Loads the gemspec and scans for compiled binaries.
+  def initialize(
+    spec = Gem::Specification.load(RatatuiRuby::Devtools.gemspec_file),
+    lib_dir = "lib/#{RatatuiRuby::Devtools.gem_name.tr('-', '_')}"
+  )
+    @spec = spec
+    @lib_dir = lib_dir
+    @binaries = VersionedBinary.scan(lib_dir, RatatuiRuby::Devtools.gem_name)
+  end
+
+  # Packages the platform gem into +pkg/+.
+  def build
+    abort "No versioned binaries found in #{@lib_dir}/*/" if @binaries.empty?
+
+    @spec.platform = Gem::Platform.local
+    @spec.extensions.clear
+    @spec.files += @binaries.map(&:path)
+
+    #--
+    # SPDX-SnippetBegin
+    # SPDX-SnippetCopyrightText: rake-compiler contributors
+    # SPDX-License-Identifier: MIT
+    #
+    # Version constraint pattern derived from rake-compiler's
+    # ExtensionTask#define_native_tasks (lib/rake/extensiontask.rb).
+    #++
+    @spec.required_ruby_version = [
+      ">= #{@binaries.first.api_version}",
+      "< #{@binaries.last.api_version.succ}.dev",
+    ]
+    #--
+    # SPDX-SnippetEnd
+    #++
+
+    FileUtils.mkdir_p("pkg")
+    gem_file = Gem::Package.build(@spec)
+    FileUtils.mv(gem_file, "pkg")
+    puts "Built pkg/#{File.basename(gem_file)}"
+  end
+end
+
+if $PROGRAM_NAME == __FILE__
+  PlatformGem.new.build
+end

data/lib/ratatui_ruby/devtools/tasks/release/versioned_binary.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+#--
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+#++
+
+require_relative "../bump/sem_ver"
+
+# A compiled native extension binary for a specific Ruby version.
+class VersionedBinary < Data.define(:path)
+  ##
+  # Returns sorted VersionedBinary instances found under +lib_dir+.
+  def self.scan(lib_dir, gem_name = RatatuiRuby::Devtools.gem_name)
+    Dir.glob("#{lib_dir}/*/#{gem_name.tr('-', '_')}.*")
+      .reject { |p| p.end_with?(".rb") }
+      .map { |p| new(path: p) }
+      .sort
+  end
+
+  # The full Ruby version string extracted from the directory name.
+  def ruby_version
+    File.basename(File.dirname(path))
+  end
+
+  # The major.minor API version used for Ruby version constraints.
+  def api_version
+    semver = SemVer.parse(ruby_version)
+    "#{semver.major}.#{semver.minor}"
+  end
+
+  # Sorts by API version so the binary list is in ascending Ruby order.
+  def <=>(other)
+    api_version <=> other.api_version
+  end
+end

data/lib/ratatui_ruby/devtools/tasks/release.rake

@@ -0,0 +1,87 @@
+# frozen_string_literal: true
+
+#--
+# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
+# SPDX-License-Identifier: AGPL-3.0-or-later
+#++
+
+require_relative "release/native_gem_version"
+
+namespace :release do
+  desc "Update stable branch to match release and set as default"
+  task :update_stable do
+    # Read version to determine tag
+    version_file = RatatuiRuby::Devtools.version_file
+    version_content = File.read(version_file)
+    version = version_content.match(/VERSION = "(.+?)"/)[1]
+    tag_name = "v#{version}"
+
+    # Verify that the version file matches the actual git tag
+    # This prevents updating stable to the wrong version if the release failed
+    latest_tag = `git describe --tags --abbrev=0`.strip
+    if latest_tag != tag_name
+      abort "Fatal: Version mismatch! '#{version_file}' says #{tag_name}, but the latest git tag is #{latest_tag}."
+    end
+
+    # Get current stable version (if stable branch exists)
+    stable_version_str = `git show stable:#{version_file} 2>/dev/null`.match(/VERSION = "(.+?)"/)&.[](1)
+    if stable_version_str
+      stable_version = Gem::Version.new(stable_version_str)
+      new_version = Gem::Version.new(version)
+
+      if new_version <= stable_version
+        puts "Skipping stable update: #{version} is not newer than current stable #{stable_version_str}"
+        next
+      end
+    end
+
+    puts "Updating stable branch to point to #{tag_name}..."
+    # Resolve the tag to a commit hash (peel annotated tags)
+    # This renders a commit SHA that can be pushed to a branch head
+    commit_sha = `git rev-parse #{tag_name}^{}`.strip
+
+    # Update local stable branch to match
+    sh "git branch -f stable #{commit_sha}"
+
+    # Push the commit to remote stable branch
+    # Force-push because stable is reset to each release, not fast-forwarded.
+    sh "git push --force origin #{commit_sha}:stable"
+  end
+end
+
+if Rake::Task.task_defined?("release")
+  Rake::Task["release"].enhance do
+    # Replace Bundler's normalized tag with semver-style for prerelease versions.
+    # Bundler creates tags using normalized Gem::Version (e.g., v1.0.0.pre.beta.1).
+    # Semver uses hyphens (e.g., v1.0.0-beta.1). We want only the semver tag.
+    version_file = RatatuiRuby::Devtools.version_file
+    version_content = File.read(version_file)
+    version = version_content.match(/VERSION = "(.+?)"/)[1]
+
+    if version.include?("-")
+      normalized_tag = "v#{Gem::Version.new(version)}"
+      semver_tag = "v#{version}"
+
+      if normalized_tag != semver_tag
+        puts "Replacing normalized tag #{normalized_tag} with semver tag #{semver_tag}..."
+        # Delete the normalized tag locally and remotely
+        sh "git tag -d #{normalized_tag}"
+        sh "git push origin :refs/tags/#{normalized_tag}"
+        # Create the semver tag pointing to the same commit
+        sh "git tag #{semver_tag} HEAD"
+        sh "git push origin #{semver_tag}"
+      end
+    end
+
+    gem_name = RatatuiRuby::Devtools.gem_name
+    has_rust = File.exist?("ext/#{gem_name}/Cargo.toml") ||
+      File.exist?("ext/#{gem_name.tr('-', '_')}/Cargo.toml")
+
+    if has_rust
+      release_sha = `git rev-parse v#{version}^{}`.strip
+      NativeGemVersion.new(version:, sha: release_sha).release
+    end
+
+    Rake::Task["release:update_stable"].invoke
+  end
+end

data/lib/ratatui_ruby/devtools/tasks/resources/rubies.yml

@@ -4,4 +4,4 @@
 - "3.2"
 - "3.3"
 - "3.4"
-- "4.0.0"
+- "4.0"

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

@@ -0,0 +1,124 @@
+<%# REUSE-IgnoreStart -%>
+# SPDX-FileCopyrightText: <%= Time.now.year %> <%= copyright_holder %>
+# SPDX-License-Identifier: <%= license %>
+<%# REUSE-IgnoreEnd -%>
+
+name: Build Gems
+
+on:
+  push:
+    branches:
+      - "release/*"
+
+jobs:
+  build:
+    name: Build (${{ matrix.os }}, Ruby ${{ matrix.ruby }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        ruby: <%= rubies.map { |r| r.split(".")[0..1].join(".") }.uniq.inspect %>
+        os: [ubuntu-latest, macos-latest, windows-latest]
+    env:
+      CI: "true"
+      BINDGEN_EXTRA_CLANG_ARGS: "-include stdbool.h"
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Override Ruby version in mise.toml
+        shell: bash
+        run: sed -i.bak 's/ruby = .*/ruby = "${{ matrix.ruby }}"/' mise.toml
+
+      - name: Install Ruby via RubyInstaller (Windows)
+        if: runner.os == 'Windows'
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby }}
+
+      - name: Configure Windows build environment
+        if: runner.os == 'Windows'
+        shell: pwsh
+        run: |
+          Add-Content -Path .mise.local.toml -Value "[settings]`ndisable_tools = [`"ruby`"]"
+          $msysRoot = (Join-Path $env:RI_DEVKIT "ucrt64") -replace '\\', '/'
+          $clangArgs = "-include stdbool.h --target=x86_64-w64-mingw32 --sysroot=$msysRoot -I$msysRoot/include"
+          Add-Content -Path $env:GITHUB_ENV -Value "BINDGEN_EXTRA_CLANG_ARGS=$clangArgs"
+          Add-Content -Path $env:GITHUB_ENV -Value "CARGO_BUILD_TARGET=x86_64-pc-windows-gnu"
+          rustup target add x86_64-pc-windows-gnu
+
+      - name: Install toolchain via mise
+        uses: jdx/mise-action@v2
+
+      - name: Setup (Unix)
+        if: runner.os != 'Windows'
+        shell: bash
+        run: bin/setup
+
+      - name: Setup (Windows)
+        if: runner.os == 'Windows'
+        shell: pwsh
+        run: bin/setup.ps1
+
+      - name: Default task
+        run: mise x -- bundle exec rake
+
+      - name: Upload compiled binary
+        uses: actions/upload-artifact@v4
+        with:
+          name: native-${{ matrix.os }}-ruby${{ matrix.ruby }}
+          path: lib/<%= ext_name %>/<%= ext_name %>.*
+          if-no-files-found: error
+
+  package:
+    name: Package (${{ matrix.os }})
+    needs: build
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install Ruby via RubyInstaller (Windows)
+        if: runner.os == 'Windows'
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: "3.4"
+
+      - name: Override Ruby version in mise.toml (Unix)
+        if: runner.os != 'Windows'
+        shell: bash
+        run: sed -i.bak 's/ruby = .*/ruby = "3.4"/' mise.toml
+
+      - name: Install toolchain via mise (Unix)
+        if: runner.os != 'Windows'
+        uses: jdx/mise-action@v2
+
+      - name: Configure Windows mise (skip Ruby)
+        if: runner.os == 'Windows'
+        shell: pwsh
+        run: |
+          Add-Content -Path .mise.local.toml -Value "[settings]`ndisable_tools = [`"ruby`"]"
+
+      - name: Install toolchain via mise (Windows)
+        if: runner.os == 'Windows'
+        uses: jdx/mise-action@v2
+
+<%- rubies.map { |r| r.split(".")[0..1].join(".") }.uniq.each do |minor| -%>
+      - name: Download Ruby <%= minor %> binary
+        uses: actions/download-artifact@v4
+        with:
+          name: native-${{ matrix.os }}-ruby<%= minor %>
+          path: lib/<%= ext_name %>/<%= minor %>
+
+<%- end -%>
+      - name: Build platform gem
+        run: ruby tasks/release/platform_gem.rb
+
+      - name: Upload gem artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: gem-${{ matrix.os }}
+          path: pkg/*.gem
+          if-no-files-found: error

data/lib/ratatui_ruby/devtools/templates/.github/workflows/ci.yml.erb

@@ -0,0 +1,77 @@
+<%# REUSE-IgnoreStart -%>
+# SPDX-FileCopyrightText: <%= Time.now.year %> <%= copyright_holder %>
+# SPDX-License-Identifier: <%= license %>
+<%# REUSE-IgnoreEnd -%>
+
+name: CI
+
+on:
+  push:
+<%- if has_rust -%>
+    branches-ignore:
+      - "release/*"
+<%- end -%>
+  pull_request:
+
+jobs:
+  test:
+    name: Test (Ruby ${{ matrix.ruby }}, ${{ matrix.os }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        ruby: <%= rubies.inspect %>
+        os: [ubuntu-latest, macos-latest, windows-latest]
+    env:
+      CI: "true"
+<%- if has_rust -%>
+      BINDGEN_EXTRA_CLANG_ARGS: "-include stdbool.h"
+<%- end -%>
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Override Ruby version in mise.toml
+        shell: bash
+        run: sed -i.bak 's/ruby = .*/ruby = "${{ matrix.ruby }}"/' mise.toml
+
+      - name: Install Ruby via RubyInstaller (Windows)
+        if: runner.os == 'Windows'
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby }}
+
+<%- if has_rust -%>
+      - name: Configure Windows build environment
+        if: runner.os == 'Windows'
+        shell: pwsh
+        run: |
+          Add-Content -Path .mise.local.toml -Value "[settings]`ndisable_tools = [`"ruby`"]"
+          $msysRoot = (Join-Path $env:RI_DEVKIT "ucrt64") -replace '\\', '/'
+          $clangArgs = "-include stdbool.h --target=x86_64-w64-mingw32 --sysroot=$msysRoot -I$msysRoot/include"
+          Add-Content -Path $env:GITHUB_ENV -Value "BINDGEN_EXTRA_CLANG_ARGS=$clangArgs"
+          Add-Content -Path $env:GITHUB_ENV -Value "CARGO_BUILD_TARGET=x86_64-pc-windows-gnu"
+          rustup target add x86_64-pc-windows-gnu
+
+<%- else -%>
+      - name: Configure Windows Ruby (non-mise)
+        if: runner.os == 'Windows'
+        shell: pwsh
+        run: |
+          Add-Content -Path .mise.local.toml -Value "[settings]`ndisable_tools = [`"ruby`"]"
+
+<%- end -%>
+      - name: Install toolchain via mise
+        uses: jdx/mise-action@v2
+
+      - name: Setup (Unix)
+        if: runner.os != 'Windows'
+        shell: bash
+        run: bin/setup
+
+      - name: Setup (Windows)
+        if: runner.os == 'Windows'
+        shell: pwsh
+        run: bin/setup.ps1
+
+      - name: Default task
+        run: mise x -- bundle exec rake

data/lib/ratatui_ruby/devtools/templates/.gitignore.erb

@@ -3,6 +3,7 @@
 
 **/.idea/
 **/.DS_Store
+.mise.local.toml
 /.bundle/
 /.yardoc/
 /_yardoc/
@@ -10,6 +11,7 @@
 /pkg/
 /spec/reports/
 /tmp/
+/www/
 <%- if has_rust -%>
 /ext/<%= gem_name %>/target/
 *.bundle

data/lib/ratatui_ruby/devtools/templates/.rubocop.yml.erb

@@ -1,8 +1,10 @@
-# SPDX-FileCopyrightText: 2026 Kerrick Long <me@kerricklong.com>
-# SPDX-License-Identifier: AGPL-3.0-or-later
+<%# REUSE-IgnoreStart -%>
+# SPDX-FileCopyrightText: <%= Time.now.year %> <%= copyright_holder %>
+# SPDX-License-Identifier: <%= license %>
+<%# REUSE-IgnoreEnd -%>
 
-inherit_from:
-  - ./vendor/goodcop/base.yml
+inherit_gem:
+  <%= gem_name %>: lib/<%= require_path %>/rubocop.yml
 
 AllCops:
   TargetRubyVersion: "3.2"