gem_changelog_diff 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: f774074fe0186c0efa8cd2aef588301c81441f20de1c1b75cd64e0da40bdcb0a
+  data.tar.gz: cca9f1421c6e505a7b137727e8948e3d5fa7749c226e6e43c51fcd29d1781a2c
+SHA512:
+  metadata.gz: cfe4e6aadaa4310be3a007ed61ae85d0a3aad6938599030b9914f35f41b066e9ed04cef679762faedfc8ebd406156c45688e13f84864645e9168aa73eaf22a54
+  data.tar.gz: 76f9ea402f5cab49fbe8ecf9466ee73fc633e4a3a35c8dc77aee54fe79763cacd40f775c039c1cde51f8e8f49efbe8cebaa8420da6d7cac549097f4f18a2a85a

data/.github/workflows/main.yml

@@ -0,0 +1,80 @@
+name: CI
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+
+jobs:
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v5
+
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: "3.3"
+          bundler-cache: true
+
+      - name: Run Rubocop
+        run: bundle exec rubocop
+
+  security:
+    name: Security audit
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v5
+
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: "3.3"
+          bundler-cache: true
+
+      - name: Run bundler-audit
+        run: bundle exec rake bundle:audit:update bundle:audit:check
+
+  test:
+    name: Ruby ${{ matrix.ruby }}
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        ruby:
+          - "3.3"
+          - "3.4"
+          - "4.0"
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v5
+
+      - name: Set up Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby }}
+          bundler-cache: true
+
+      - name: Run test suite
+        run: bundle exec rake spec
+
+      - name: Upload coverage to Codecov
+        uses: codecov/codecov-action@v6
+        if: matrix.ruby == '3.4'
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          files: coverage/coverage.json

data/.github/workflows/publish.yml

@@ -0,0 +1,41 @@
+name: Publish
+
+on:
+  push:
+    tags:
+      - "v*"
+
+env:
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+
+jobs:
+  publish:
+    name: Publish to RubyGems
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      id-token: write
+
+    steps:
+      - uses: actions/checkout@v5
+
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: "3.4"
+          bundler-cache: true
+
+      - name: Run test suite
+        run: bundle exec rake
+
+      - name: Create GitHub Release
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          gh release create "${{ github.ref_name }}" \
+            --title "${{ github.ref_name }}" \
+            --notes "See [CHANGELOG.md](https://github.com/${{ github.repository }}/blob/main/CHANGELOG.md) for details." \
+            --verify-tag
+
+      - name: Publish to RubyGems
+        uses: rubygems/release-gem@v1
+        

data/CHANGELOG.md

@@ -0,0 +1,20 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.1.0] - 2026-06-17
+
+### Added
+
+- CLI entry point via Thor (`exe/gem_changelog_diff`) with `check` default command and `version` command
+- Outdated gem detection by parsing `bundle outdated --parseable`
+- `OutdatedGem` data object for representing outdated gem info
+- RubyGems API client to look up each gem's GitHub repository
+- GitHub API client to fetch releases between locked and latest versions
+- Plain text formatter for changelog output
+- Full end-to-end pipeline: detect → lookup → fetch → format

data/CLAUDE.md

@@ -0,0 +1,47 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project
+
+gem_changelog_diff is a Ruby gem CLI that shows changelog diffs for each gem before you `bundle update`, pulled from GitHub releases. Requires Ruby >= 3.3.
+
+## Commands
+
+```bash
+bundle exec rake              # Run all checks (bundler-audit, rubocop, rspec)
+bundle exec rake spec         # Run tests only
+bundle exec rspec spec/path_spec.rb        # Run a single test file
+bundle exec rspec spec/path_spec.rb:42     # Run a single example by line
+bundle exec rubocop           # Lint
+bundle exec rubocop -a        # Lint with auto-correct
+bundle exec rake bundle:audit:check        # Security audit
+```
+
+## Workflow
+
+All feature work lives on `feature/<version>-<scope>` branches (e.g. `feature/0.1.0-core`). Every branch produces two commits before pushing:
+
+1. **Feature commit** — implementation + specs. Run `bundle exec rake` and fix all failures before committing.
+2. **Docs commit** — add shipped items to `CHANGELOG.md`, remove them from `ROADMAP.md`, update `README.md`. Run `bundle exec rake` again before this commit.
+
+## Code Style
+
+- RuboCop with `rubocop-rake` plugin; double quotes for strings
+- Target Ruby version: 3.3
+- `frozen_string_literal: true` on all Ruby files
+- `Style/Documentation` is disabled
+
+## Testing
+
+- RSpec with `--format documentation`
+- SimpleCov for coverage (HTML + JSON output); JSON uploaded to Codecov in CI
+- Coverage filters: `spec/` and `version.rb` excluded; tracks `lib/**/*.rb`
+
+## CI
+
+GitHub Actions runs on push to main and PRs: Lint, Security audit, and tests across Ruby 3.3, 3.4, and 4.0. Branch protection requires all five jobs to pass.
+
+## Releasing
+
+Update `lib/gem_changelog_diff/version.rb`, tag with `v*`, and push. The publish workflow runs tests, creates a GitHub Release, and publishes to RubyGems via trusted publishing.

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026 Chuck Smith
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,50 @@
+# GemChangelogDiff
+
+[![CI](https://github.com/eclectic-coding/gem_changelog_diff/actions/workflows/main.yml/badge.svg)](https://github.com/eclectic-coding/gem_changelog_diff/actions/workflows/main.yml)
+[![Gem Version](https://img.shields.io/gem/v/gem_changelog_diff)](https://rubygems.org/gems/gem_changelog_diff)
+[![Gem Downloads](https://img.shields.io/gem/dt/gem_changelog_diff)](https://rubygems.org/gems/gem_changelog_diff)
+[![Ruby](https://img.shields.io/badge/ruby-%3E%3D%203.3.0-ruby)](https://www.ruby-lang.org)
+[![Codecov](https://img.shields.io/codecov/c/github/eclectic-coding/gem_changelog_diff)](https://codecov.io/gh/eclectic-coding/gem_changelog_diff)
+
+CLI that shows you the changelog diff for each gem before you `bundle update`, pulled from GitHub releases.
+
+## Installation
+
+Install the gem by executing:
+
+```bash
+gem install gem_changelog_diff
+```
+
+Or add it to your Gemfile:
+
+```bash
+bundle add gem_changelog_diff
+```
+
+## Usage
+
+```bash
+gem_changelog_diff
+```
+
+Run from a project directory with a `Gemfile.lock`. The tool detects outdated gems via `bundle outdated`, looks up their GitHub repositories, fetches release notes, and displays a formatted changelog diff.
+
+```bash
+gem_changelog_diff version    # Print version
+gem_changelog_diff --version  # Same as above
+```
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`.
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/eclectic-coding/gem_changelog_diff.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/ROADMAP.md

@@ -0,0 +1,130 @@
+# Roadmap
+
+Feature roadmap for gem_changelog_diff. Each section is auto-pruned by `bin/release` when that version ships.
+
+## 0.2.0 -- Error Handling & GitHub Authentication
+
+Handle real-world failures and unblock power users hitting the 60 req/hr unauthenticated rate limit.
+
+- GitHub personal access token via `--token` flag or `GITHUB_TOKEN` env var
+- Custom error hierarchy (`RepoNotFoundError`, `GitHubAPIError`, `RateLimitError`, `NetworkError`)
+- Graceful degradation: skip failed gems with a warning, do not abort the run
+- Rate limit awareness: read `X-RateLimit-Remaining` headers, warn when approaching the limit
+- `--verbose` and `--quiet` flags
+
+**New files:** `errors.rb`, `configuration.rb`
+
+---
+
+## 0.3.0 -- CHANGELOG.md Fallback & Colored Output
+
+Many gems do not use GitHub Releases. Fall back to parsing CHANGELOG.md from the repository.
+
+- Fetch raw CHANGELOG.md via GitHub Contents API; try common variants (`CHANGELOG.md`, `CHANGES.md`, `History.md`, `NEWS.md`)
+- Parse Keep-a-Changelog and common freeform formats; extract entries between current and target versions
+- Colorized terminal output via `tty-color` (gem names, versions, warnings); respect `$NO_COLOR` and `--no-color`
+- Summary line: "X gems outdated, Y with changelogs found, Z skipped"
+
+**New files:** `changelog_parser.rb`, `source_resolver.rb`
+**Dependencies:** `tty-color` (runtime)
+
+---
+
+## 0.4.0 -- Lockfile Parsing Fallback & Filtering
+
+Support environments where `bundle outdated` is unavailable. Let users narrow which gems to inspect.
+
+- Parse `Gemfile.lock` directly via `Bundler::LockfileParser` and query RubyGems API for latest versions
+- Automatic fallback when `bundle outdated` fails
+- Positional args to inspect specific gems: `gem_changelog_diff check rails sidekiq`
+- `--group`, `--ignore`, `--lockfile`, `--strategy` flags
+
+**New files:** `lockfile_parser.rb`
+
+---
+
+## 0.5.0 -- Caching & Performance
+
+Avoid redundant API calls. Make repeated runs fast on large dependency trees.
+
+- Disk cache at `~/.cache/gem_changelog_diff/` with configurable TTL (default 24h)
+- ETag conditional requests to avoid consuming rate limit on revalidation
+- Concurrent fetching via Ruby threads (default concurrency: 4, configurable via `--concurrency`)
+- Progress indicator via `tty-spinner`
+- `cache clear` subcommand, `--no-cache` and `--cache-ttl` flags
+
+**New files:** `cache.rb`, `concurrent_fetcher.rb`
+**Dependencies:** `tty-spinner` (runtime)
+
+---
+
+## 0.6.0 -- Interactive Mode & Output Formats
+
+Let users selectively browse changelogs. Support machine-readable output for CI and scripting.
+
+- Interactive gem selection via `tty-prompt` (`--interactive` / `-i` flag)
+- JSON output (`--format=json`) for piping to `jq` or CI tools
+- Markdown output (`--format=markdown`) for PR descriptions
+- `show` subcommand: `gem_changelog_diff show rails 7.0.0 7.1.0`
+- `--output` flag to write to a file
+
+**New files:** `interactive.rb`, `formatters/base.rb`, `formatters/text.rb`, `formatters/json.rb`, `formatters/markdown.rb`
+**Dependencies:** `tty-prompt` (runtime)
+
+---
+
+## 0.7.0 -- Configuration File & Polish
+
+Persistent preferences so users don't repeat flags every run.
+
+- Config file: `.gem_changelog_diff.yml` (project root) and `~/.config/gem_changelog_diff/config.yml` (user); project overrides user
+- Supported keys: `github_token`, `default_format`, `cache_ttl`, `concurrency`, `ignore_gems`, `no_color`
+- `init` subcommand: generate a commented config template
+- `version` subcommand
+- `--dry-run` flag: show which gems would be checked without fetching
+
+**New files:** `config_loader.rb`
+
+---
+
+## 0.8.0 -- Robustness & Edge Cases
+
+Handle the long tail of real-world gem repository patterns.
+
+- Source URI resolution: detect and skip GitLab/Codeberg gracefully, follow redirects for renamed repos, handle monorepo subdirectory URIs
+- Tag format normalization: `v1.2.3`, `1.2.3`, `gem_name-1.2.3`, `release-1.2.3`
+- Proper version comparison via `Gem::Version` (handles pre-release: `1.0.0.rc1`, `1.0.0.beta2`)
+- GitHub API pagination for gems with 100+ releases
+- Per-request timeout (10s default), total timeout (120s default), configurable via `--timeout`
+
+**New files:** `tag_matcher.rb`, `uri_resolver.rb`
+
+---
+
+## 0.9.0 -- Pre-1.0 Stabilization
+
+Freeze the public API. Harden the test suite. Prepare documentation for stable release.
+
+- Integration test suite with VCR-recorded HTTP fixtures against well-known gems
+- RBS type signatures in `sig/gem_changelog_diff.rbs`
+- Defined exit codes: 0 (success), 1 (error), 2 (partial failure)
+- Add `rubocop-rspec` for spec linting
+- README overhaul with examples for every subcommand and flag
+
+**Dependencies:** `vcr`, `rubocop-rspec` (development)
+
+---
+
+## 1.0.0 -- Stable Release
+
+Public API is frozen. Semantic versioning contract begins.
+
+- API stability guarantee: breaking changes require a major version bump
+- YARD documentation on all public classes and methods
+- `CONTRIBUTING.md` with development setup, testing, and architecture overview
+- `SECURITY.md` with vulnerability reporting instructions
+- Document future Bundler plugin possibility (`bundler-changelog-diff`)
+
+**Dependencies:** `yard` (development)
+
+---

data/Rakefile

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "bundler/audit/task"
+require "rspec/core/rake_task"
+require "rubocop/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+RuboCop::RakeTask.new
+Bundler::Audit::Task.new
+
+task default: ["bundle:audit:update", "bundle:audit:check", :rubocop, :spec]

data/codecov.yml

@@ -0,0 +1,14 @@
+comment:
+  layout: "reach, diff, flags, files"
+  behavior: default
+  # Only post or update the comment if the coverage drops
+  require_changes: "coverage_drop"
+
+coverage:
+  status:
+    project:
+      default:
+        informational: false
+    patch:
+      default:
+        informational: false

data/exe/gem_changelog_diff

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "gem_changelog_diff"
+
+GemChangelogDiff::CLI.start(ARGV)

data/lib/gem_changelog_diff/cli.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+require "thor"
+
+module GemChangelogDiff
+  class CLI < Thor
+    def self.exit_on_failure?
+      true
+    end
+
+    default_task :check
+
+    desc "check", "Show changelog diffs for outdated gems"
+    def check
+      gems = Detector.new.detect
+
+      if gems.empty?
+        say "All gems are up to date!"
+        return
+      end
+
+      reports = build_reports(gems)
+      say Formatter.new.format(reports)
+    end
+
+    desc "version", "Print version"
+    def version
+      say "gem_changelog_diff #{VERSION}"
+    end
+    map "--version" => :version
+    map "-v" => :version
+
+    private
+
+    def build_reports(gems)
+      rubygems_client = RubygemsClient.new
+      github_client = GithubClient.new
+
+      gems.map { |gem| build_gem_report(gem, rubygems_client, github_client) }
+    end
+
+    def build_gem_report(gem, rubygems_client, github_client)
+      repo = rubygems_client.repo_url(gem.name)
+      return { gem: gem, releases: [], error: "  Could not find GitHub repository." } if repo.nil?
+
+      releases = github_client.releases_between(repo, gem.current_version, gem.newest_version)
+      { gem: gem, releases: releases }
+    end
+  end
+end

data/lib/gem_changelog_diff/detector.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+require "open3"
+
+module GemChangelogDiff
+  class Detector
+    PARSEABLE_REGEX = /\A(\S+)\s+\(newest\s+([^,]+),\s+installed\s+([^,)]+)/
+
+    def detect
+      output = run_bundle_outdated
+      parse(output)
+    end
+
+    private
+
+    def run_bundle_outdated
+      output, status = Open3.capture2("bundle", "outdated", "--parseable")
+      raise Error, "bundle outdated failed (exit #{status.exitstatus})" unless [0, 1].include?(status.exitstatus)
+
+      output
+    end
+
+    def parse(output)
+      output.each_line.filter_map do |line|
+        match = line.match(PARSEABLE_REGEX)
+        next unless match
+
+        OutdatedGem.new(
+          name: match[1],
+          current_version: match[3],
+          newest_version: match[2]
+        )
+      end
+    end
+  end
+end

data/lib/gem_changelog_diff/formatter.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module GemChangelogDiff
+  class Formatter
+    def format(gem_reports)
+      gem_reports.map { |report| format_gem(report) }.join("\n")
+    end
+
+    private
+
+    def format_gem(report)
+      header = "== #{report[:gem].name} (#{report[:gem].current_version} → #{report[:gem].newest_version}) =="
+
+      body = if report[:releases].empty?
+               report[:error] || "  No GitHub releases found."
+             else
+               report[:releases].map { |r| format_release(r) }.join("\n")
+             end
+
+      "#{header}\n#{body}\n"
+    end
+
+    def format_release(release)
+      title = "--- #{release[:tag_name]}"
+      title += " (#{release[:published_at][0..9]})" if release[:published_at]
+      title += " ---"
+      body = release[:body]&.strip.to_s
+      body = "(no release notes)" if body.empty?
+      "#{title}\n#{body}\n"
+    end
+  end
+end

data/lib/gem_changelog_diff/github_client.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+require "net/http"
+require "json"
+
+module GemChangelogDiff
+  class GithubClient
+    RELEASES_URL = "https://api.github.com/repos/%<repo>s/releases"
+    TAG_VERSION_REGEX = /\Av?(\d+\..+)\z/
+
+    def releases_between(repo, current_version, newest_version)
+      releases = fetch_releases(repo)
+      filter_releases(releases, current_version, newest_version)
+    end
+
+    private
+
+    def fetch_releases(repo)
+      uri = URI(format(RELEASES_URL, repo: repo))
+      uri.query = URI.encode_www_form(per_page: 30)
+
+      request = Net::HTTP::Get.new(uri)
+      request["Accept"] = "application/vnd.github.v3+json"
+      request["User-Agent"] = "gem_changelog_diff/#{VERSION}"
+
+      response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
+        http.request(request)
+      end
+
+      return [] unless response.is_a?(Net::HTTPSuccess)
+
+      JSON.parse(response.body)
+    end
+
+    def filter_releases(releases, current_version, newest_version)
+      current = Gem::Version.new(current_version)
+      newest = Gem::Version.new(newest_version)
+
+      matched = releases.filter_map { |r| build_release(r, current, newest) }
+      sort_releases(matched)
+    end
+
+    def build_release(release, current, newest)
+      version = extract_version(release["tag_name"])
+      return unless version
+
+      gem_version = Gem::Version.new(version)
+      return unless gem_version > current && gem_version <= newest
+
+      { tag_name: release["tag_name"], name: release["name"],
+        published_at: release["published_at"], body: release["body"] }
+    end
+
+    def sort_releases(releases)
+      releases.sort_by { |r| Gem::Version.new(extract_version(r[:tag_name])) }.reverse
+    end
+
+    def extract_version(tag)
+      match = tag&.match(TAG_VERSION_REGEX)
+      match ? match[1] : nil
+    end
+  end
+end

data/lib/gem_changelog_diff/outdated_gem.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module GemChangelogDiff
+  OutdatedGem = Data.define(:name, :current_version, :newest_version)
+end

data/lib/gem_changelog_diff/rubygems_client.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+require "net/http"
+require "json"
+
+module GemChangelogDiff
+  class RubygemsClient
+    RUBYGEMS_API = "https://rubygems.org/api/v1/gems/%<name>s.json"
+    GITHUB_REPO_REGEX = %r{github\.com/([^/]+)/([^/]+)}
+
+    def repo_url(gem_name)
+      uri = URI(format(RUBYGEMS_API, name: gem_name))
+      response = Net::HTTP.get_response(uri)
+      return nil unless response.is_a?(Net::HTTPSuccess)
+
+      data = JSON.parse(response.body)
+      extract_github_repo(data)
+    end
+
+    private
+
+    def extract_github_repo(data)
+      %w[source_code_uri homepage_uri bug_tracker_uri].each do |field|
+        url = data[field]
+        next if url.nil? || url.empty?
+
+        match = url.match(GITHUB_REPO_REGEX)
+        next unless match
+
+        owner = match[1]
+        repo = match[2].sub(/\.git\z/, "").sub(%r{/.*}, "")
+        return "#{owner}/#{repo}"
+      end
+
+      nil
+    end
+  end
+end

data/lib/gem_changelog_diff/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module GemChangelogDiff
+  VERSION = "0.1.0"
+end

data/lib/gem_changelog_diff.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+require_relative "gem_changelog_diff/version"
+require_relative "gem_changelog_diff/outdated_gem"
+require_relative "gem_changelog_diff/detector"
+require_relative "gem_changelog_diff/rubygems_client"
+require_relative "gem_changelog_diff/github_client"
+require_relative "gem_changelog_diff/formatter"
+require_relative "gem_changelog_diff/cli"
+
+module GemChangelogDiff
+  class Error < StandardError; end
+end

data/sig/gem_changelog_diff.rbs

@@ -0,0 +1,85 @@
+module GemChangelogDiff
+  VERSION: String
+
+  class Error < StandardError
+  end
+
+  class OutdatedGem
+    attr_reader name: String
+    attr_reader current_version: String
+    attr_reader newest_version: String
+
+    def self.new: (name: String, current_version: String, newest_version: String) -> OutdatedGem
+  end
+
+  class Detector
+    PARSEABLE_REGEX: Regexp
+
+    def detect: () -> Array[OutdatedGem]
+
+    private
+
+    def run_bundle_outdated: () -> String
+    def parse: (String output) -> Array[OutdatedGem]
+  end
+
+  class RubygemsClient
+    RUBYGEMS_API: String
+    GITHUB_REPO_REGEX: Regexp
+
+    def repo_url: (String gem_name) -> String?
+
+    private
+
+    def extract_github_repo: (Hash[String, untyped] data) -> String?
+  end
+
+  type release_hash = {
+    tag_name: String,
+    name: String?,
+    published_at: String?,
+    body: String?
+  }
+
+  class GithubClient
+    RELEASES_URL: String
+    TAG_VERSION_REGEX: Regexp
+
+    def releases_between: (String repo, String current_version, String newest_version) -> Array[release_hash]
+
+    private
+
+    def fetch_releases: (String repo) -> Array[Hash[String, untyped]]
+    def filter_releases: (Array[Hash[String, untyped]] releases, String current_version, String newest_version) -> Array[release_hash]
+    def build_release: (Hash[String, untyped] release, Gem::Version current, Gem::Version newest) -> release_hash?
+    def sort_releases: (Array[release_hash] releases) -> Array[release_hash]
+    def extract_version: (String? tag) -> String?
+  end
+
+  type gem_report = {
+    gem: OutdatedGem,
+    releases: Array[release_hash],
+    ?error: String
+  }
+
+  class Formatter
+    def format: (Array[gem_report] gem_reports) -> String
+
+    private
+
+    def format_gem: (gem_report report) -> String
+    def format_release: (release_hash release) -> String
+  end
+
+  class CLI < Thor
+    def self.exit_on_failure?: () -> bool
+
+    def check: () -> void
+    def version: () -> void
+
+    private
+
+    def build_reports: (Array[OutdatedGem] gems) -> Array[gem_report]
+    def build_gem_report: (OutdatedGem gem, RubygemsClient rubygems_client, GithubClient github_client) -> gem_report
+  end
+end

metadata

@@ -0,0 +1,80 @@
+--- !ruby/object:Gem::Specification
+name: gem_changelog_diff
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Chuck Smith
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+description: CLI that shows you the changelog diff for each gem before you bundle
+  update, pulled from GitHub releases.
+email:
+- eclectic-coding@users.noreply.github.com
+executables:
+- gem_changelog_diff
+extensions: []
+extra_rdoc_files: []
+files:
+- ".github/workflows/main.yml"
+- ".github/workflows/publish.yml"
+- CHANGELOG.md
+- CLAUDE.md
+- LICENSE.txt
+- README.md
+- ROADMAP.md
+- Rakefile
+- codecov.yml
+- exe/gem_changelog_diff
+- lib/gem_changelog_diff.rb
+- lib/gem_changelog_diff/cli.rb
+- lib/gem_changelog_diff/detector.rb
+- lib/gem_changelog_diff/formatter.rb
+- lib/gem_changelog_diff/github_client.rb
+- lib/gem_changelog_diff/outdated_gem.rb
+- lib/gem_changelog_diff/rubygems_client.rb
+- lib/gem_changelog_diff/version.rb
+- sig/gem_changelog_diff.rbs
+homepage: https://github.com/eclectic-coding/gem_changelog_diff
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/eclectic-coding/gem_changelog_diff
+  source_code_uri: https://github.com/eclectic-coding/gem_changelog_diff
+  changelog_uri: https://github.com/eclectic-coding/gem_changelog_diff/blob/main/CHANGELOG.md
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.3.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: Show changelog diffs for outdated gems before you bundle update.
+test_files: []