gem_radar 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6a7c235545aa90c12bd62cc2adcc11f3ba3ed212863e4dc3b94240c1311658eb
-  data.tar.gz: e9c2b3cff58d9a03af3af57f8e1db3c3ad8d6d1a5a4da9b09bd1114f05ca065d
+  metadata.gz: fd10085592b6dd19c31f335c1db17bab91f7560c872fcc2f22e04d44cff5277b
+  data.tar.gz: 614f4cb6f16377b96bc57f638009d3f1e80648ea3d0b5d035f7c54fafc82576d
 SHA512:
-  metadata.gz: f893e96da321bec629f7c8c05f7533112b612c1f5bdfab3900494a130c1024c69ef3ccfdb1d0a8c8a9df3a2bfd263d97ad30dea65272f2aa77505dafa421bcab
-  data.tar.gz: 412a70978527836e6fc4e2e20beedd010a7485c21d275e7e6ee268ca637b3535fda19c4d0bc5a4db49f3508ad376591b9e09067d2a532560f2ffcd833e2b842e
+  metadata.gz: 2284fb0a8557cc8b08d1a2396341874f76f5589218d454f4192f58833231afaf6dd05ab90ca4bc5d96a9b83b6b11e053ed730da8de491e905a3686485361ef98
+  data.tar.gz: f31e50cee88d03e1d06d3d7f286a74a67f61142257ac9b4df058bb22a3b2ff4782c1eafd06f47ef2219bd811916fc223ea247b1f04525002f16802606de44cee

data/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,12 @@
+## Why
+
+<!-- What problem does this solve, or what's the motivation? -->
+
+## What
+
+<!-- What did you change, at a high level? -->
+
+## Evidence
+
+<!-- Test output, logs, or screenshots showing it works (e.g. a run of
+     `bundle exec rspec`, or a sample report generated with your change). -->

data/.github/workflows/ci.yml

@@ -0,0 +1,31 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: ruby/setup-ruby@v1
+        with:
+          bundler-cache: true
+
+      - name: Run tests
+        run: bundle exec rspec
+
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: ruby/setup-ruby@v1
+        with:
+          bundler-cache: true
+
+      - name: Run rubocop
+        run: bundle exec rubocop

data/.gitignore

@@ -1,4 +0,0 @@
-*.md
-!README.md
-!CHANGELOG.md
-*.gem

data/.rspec

@@ -0,0 +1,3 @@
+--require spec_helper
+--format documentation
+--color

data/.rubocop.yml

@@ -0,0 +1,37 @@
+AllCops:
+  TargetRubyVersion: 2.7
+  NewCops: enable
+  SuggestExtensions: false
+  Exclude:
+    - "vendor/**/*"
+
+Style/Documentation:
+  Enabled: false
+
+Style/StringLiterals:
+  EnforcedStyle: double_quotes
+
+Metrics/MethodLength:
+  Max: 30
+
+Metrics/AbcSize:
+  Max: 46
+
+Metrics/CyclomaticComplexity:
+  Max: 18
+
+Metrics/PerceivedComplexity:
+  Max: 18
+
+Metrics/ParameterLists:
+  Max: 6
+
+Metrics/ModuleLength:
+  Max: 350
+
+Metrics/BlockLength:
+  Exclude:
+    - "spec/**/*"
+
+Gemspec/DevelopmentDependencies:
+  EnforcedStyle: Gemfile

data/.ruby-version

@@ -0,0 +1 @@
+4.0.6

data/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## 0.1.1 (26-08-2026) - Blue Velvet
+
+[FIX]
+- A gem whose own description just mentions "deprecated" (like this one,
+which describes detecting deprecated gems) no longer flags itself as deprecated. Only actual deprecation notices are detected now.
+
+[INTERNAL]
+- Only test in current ruby version.
+- Lowered `required_ruby_version` to `>= 2.7.0` so the gem can be added to
+  older projects. Verified with a new spec (`spec/ruby_compatibility_spec.rb`) that shells out to every installed Ruby version from 2.7 up and confirms the library loads correctly.
+
 ## 0.1.0 (26-08-2026) - Brazil
 
 Initial public release.

data/Gemfile

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+
+gemspec
+
+group :development do
+  gem "rake", "~> 13.0"
+  gem "rspec", "~> 3.13"
+  gem "rubocop", "~> 1.75"
+  gem "webmock", "~> 3.19"
+end

data/Gemfile.lock

@@ -0,0 +1,113 @@
+PATH
+  remote: .
+  specs:
+    gem_radar (0.1.1)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    addressable (2.9.0)
+      public_suffix (>= 2.0.2, < 8.0)
+    ast (2.4.3)
+    bigdecimal (4.1.2)
+    crack (1.0.1)
+      bigdecimal
+      rexml
+    diff-lcs (1.6.2)
+    hashdiff (1.2.1)
+    json (2.21.2)
+    language_server-protocol (3.17.0.6)
+    lint_roller (1.1.0)
+    parallel (2.1.0)
+    parser (3.3.12.0)
+      ast (~> 2.4.1)
+      racc
+    prism (1.9.0)
+    public_suffix (7.0.5)
+    racc (1.8.1)
+    rainbow (3.1.1)
+    rake (13.4.2)
+    regexp_parser (2.12.0)
+    rexml (3.4.4)
+    rspec (3.13.2)
+      rspec-core (~> 3.13.0)
+      rspec-expectations (~> 3.13.0)
+      rspec-mocks (~> 3.13.0)
+    rspec-core (3.13.6)
+      rspec-support (~> 3.13.0)
+    rspec-expectations (3.13.5)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-mocks (3.13.8)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-support (3.13.7)
+    rubocop (1.90.0)
+      json (>= 2.3)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.1.0)
+      parallel (>= 1.10)
+      parser (>= 3.3.0.2)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 2.9.3, < 3.0)
+      rubocop-ast (>= 1.49.0, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 2.4.0, < 4.0)
+    rubocop-ast (1.50.0)
+      parser (>= 3.3.7.2)
+      prism (~> 1.7)
+    ruby-progressbar (1.13.0)
+    unicode-display_width (3.2.0)
+      unicode-emoji (~> 4.1)
+    unicode-emoji (4.2.0)
+    webmock (3.26.3)
+      addressable (>= 2.8.0)
+      crack (>= 0.3.2)
+      hashdiff (>= 0.4.0, < 2.0.0)
+
+PLATFORMS
+  ruby
+  x86_64-linux
+
+DEPENDENCIES
+  gem_radar!
+  rake (~> 13.0)
+  rspec (~> 3.13)
+  rubocop (~> 1.75)
+  webmock (~> 3.19)
+
+CHECKSUMS
+  addressable (2.9.0) sha256=7fdf6ac3660f7f4e867a0838be3f6cf722ace541dd97767fa42bc6cfa980c7af
+  ast (2.4.3) sha256=954615157c1d6a382bc27d690d973195e79db7f55e9765ac7c481c60bdb4d383
+  bigdecimal (4.1.2) sha256=53d217666027eab4280346fba98e7d5b66baaae1b9c3c1c0ffe89d48188a3fbd
+  bundler (4.0.18) sha256=02d9a17429de1847b4e0c9f27a9ee4b20c0a74c0a641b4e77195d6019e3618ac
+  crack (1.0.1) sha256=ff4a10390cd31d66440b7524eb1841874db86201d5b70032028553130b6d4c7e
+  diff-lcs (1.6.2) sha256=9ae0d2cba7d4df3075fe8cd8602a8604993efc0dfa934cff568969efb1909962
+  gem_radar (0.1.1)
+  hashdiff (1.2.1) sha256=9c079dbc513dfc8833ab59c0c2d8f230fa28499cc5efb4b8dd276cf931457cd1
+  json (2.21.2) sha256=1f1d3b7cf2b3ba1a69beca0bb6db13d5438b80bff3cd54cdaaa620b9b07c1c6a
+  language_server-protocol (3.17.0.6) sha256=5ef2c0c138f8267e1bc631d3328347d354f96724b0af22f2c79516120443b7f0
+  lint_roller (1.1.0) sha256=2c0c845b632a7d172cb849cc90c1bce937a28c5c8ccccb50dfd46a485003cc87
+  parallel (2.1.0) sha256=b35258865c2e31134c5ecb708beaaf6772adf9d5efae28e93e99260877b09356
+  parser (3.3.12.0) sha256=21a6d7f755d5a24dfbdc6e6b772e4e879a52e7631a88bc5a3a134606052c9828
+  prism (1.9.0) sha256=7b530c6a9f92c24300014919c9dcbc055bf4cdf51ec30aed099b06cd6674ef85
+  public_suffix (7.0.5) sha256=1a8bb08f1bbea19228d3bed6e5ed908d1cb4f7c2726d18bd9cadf60bc676f623
+  racc (1.8.1) sha256=4a7f6929691dbec8b5209a0b373bc2614882b55fc5d2e447a21aaa691303d62f
+  rainbow (3.1.1) sha256=039491aa3a89f42efa1d6dec2fc4e62ede96eb6acd95e52f1ad581182b79bc6a
+  rake (13.4.2) sha256=cb825b2bd5f1f8e91ca37bddb4b9aaf345551b4731da62949be002fa89283701
+  regexp_parser (2.12.0) sha256=35a916a1d63190ab5c9009457136ae5f3c0c7512d60291d0d1378ba18ce08ebb
+  rexml (3.4.4) sha256=19e0a2c3425dfbf2d4fc1189747bdb2f849b6c5e74180401b15734bc97b5d142
+  rspec (3.13.2) sha256=206284a08ad798e61f86d7ca3e376718d52c0bc944626b2349266f239f820587
+  rspec-core (3.13.6) sha256=a8823c6411667b60a8bca135364351dda34cd55e44ff94c4be4633b37d828b2d
+  rspec-expectations (3.13.5) sha256=33a4d3a1d95060aea4c94e9f237030a8f9eae5615e9bd85718fe3a09e4b58836
+  rspec-mocks (3.13.8) sha256=086ad3d3d17533f4237643de0b5c42f04b66348c28bf6b9c2d3f4a3b01af1d47
+  rspec-support (3.13.7) sha256=0640e5570872aafefd79867901deeeeb40b0c9875a36b983d85f54fb7381c47c
+  rubocop (1.90.0) sha256=9eb4c065b5c5154e4ef554c547972f3905a9eb6b53e657e580b6796b54bf8242
+  rubocop-ast (1.50.0) sha256=b9ca88300da0803ee222ad20cdb30494c0a784eed06fdc35d254b06d662788db
+  ruby-progressbar (1.13.0) sha256=80fc9c47a9b640d6834e0dc7b3c94c9df37f08cb072b7761e4a71e22cff29b33
+  unicode-display_width (3.2.0) sha256=0cdd96b5681a5949cdbc2c55e7b420facae74c4aaf9a9815eee1087cb1853c42
+  unicode-emoji (4.2.0) sha256=519e69150f75652e40bf736106cfbc8f0f73aa3fb6a65afe62fefa7f80b0f80f
+  webmock (3.26.3) sha256=77c612816bdcb2fc43db0e42fd98b19be7d4770fd708816fdde65a006664ddec
+
+BUNDLED WITH
+  4.0.18

data/README.md

@@ -8,6 +8,16 @@ compatibility and update status.
 For each gem, the report links only to its repository — it does not
 download or embed changelog content.
 
+## Ruby compatibility
+
+Works on **>= Ruby 2.7**.
+
+No runtime dependencies means adding `gem_radar` to an old project's `Gemfile` doesn't drag in anything that would clash with it.
+
+This is **deliberate**: the projects that most need help
+figuring out an upgrade path are exactly the ones still stuck on an old RoR apps.
+
+
 ## Installation
 
 Add it to your project's `Gemfile`:
@@ -73,6 +83,33 @@ whether a gem's repository has been archived.
 
 Ruby standard library only — no runtime dependencies.
 
+## How to contribute
+
+```sh
+git clone https://github.com/laurajaime/gem_radar.git
+cd gem_radar
+bundle install
+```
+
+Run the test suite:
+
+```sh
+bundle exec rspec
+```
+
+Run the linter:
+
+```sh
+bundle exec rubocop
+```
+
+Both run in CI on every push and pull request (see
+[.github/workflows/ci.yml](.github/workflows/ci.yml)).
+
+Open your PR explaining **why** the change is needed and **what** it does,
+with evidence that it works (test output, logs, or screenshots) — see the
+[PR template](.github/PULL_REQUEST_TEMPLATE.md).
+
 ## License
 
 MIT

data/Rakefile

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :spec

data/gem_radar.gemspec

@@ -9,13 +9,14 @@ Gem::Specification.new do |spec|
 
   spec.summary = "Audits your Ruby/Rails project's gems and reports their compatibility and update status."
   spec.description = "Reads a project's Gemfile.lock and reports, for each direct gem, whether it's " \
-                      "compatible with the project's Ruby/Rails, needs a mandatory update, is " \
-                      "deprecated or archived, or can be upgraded safely vs. with breaking changes."
+                     "compatible with the project's Ruby/Rails, needs a mandatory update, is " \
+                     "deprecated or archived, or can be upgraded safely vs. with breaking changes."
   spec.homepage = "https://github.com/laurajaime/gem_radar"
   spec.license = "MIT"
-  spec.required_ruby_version = ">= 3.0.0"
+  spec.required_ruby_version = ">= 2.7.0"
 
   spec.metadata["changelog_uri"] = "#{spec.homepage}/blob/main/CHANGELOG.md"
+  spec.metadata["rubygems_mfa_required"] = "true"
 
   spec.files = Dir.chdir(__dir__) do
     `git ls-files -z`.split("\x0").reject { |f| f.match(%r{\A(?:test|spec|features)/}) }

data/lib/gem_radar/cli.rb

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+
 #
 # gem_radar — generates a Markdown report on the health of a Ruby/Rails
 # project's direct gems, grouped into categories:
@@ -45,14 +46,17 @@ module GemRadar
       lock = parse_lockfile(options[:lockfile])
       ruby_version = detect_ruby_version(options, lock)
       rails_version = detect_rails_version(options, lock)
-      project = File.basename(File.expand_path(File.dirname(options[:lockfile]) == "." ? Dir.pwd : File.dirname(options[:lockfile])))
+      lockfile_dir = File.dirname(options[:lockfile])
+      project = File.basename(File.expand_path(lockfile_dir == "." ? Dir.pwd : lockfile_dir))
 
       warn "Project: #{project} · Ruby: #{ruby_version || 'not detected (use --ruby)'} · " \
            "Rails: #{rails_version || 'not detected (use --rails)'} · #{lock[:dependencies].size} direct gems"
-      warn "Warning: no GITHUB_TOKEN and no authenticated `gh`; GitHub's API is limited to 60 requests/hour." unless github_token
+      unless github_token
+        warn "Warning: no GITHUB_TOKEN and no authenticated `gh`; GitHub's API is limited to 60 requests/hour."
+      end
 
       results = lock[:dependencies].each_with_index.map do |name, i|
-        warn format("  [%d/%d] %s…", i + 1, lock[:dependencies].size, name)
+        warn format("  [%<index>d/%<total>d] %<name>s…", index: i + 1, total: lock[:dependencies].size, name: name)
         process_gem(name, lock[:specs][name], ruby_version, rails_version)
       end
 
@@ -69,12 +73,22 @@ module GemRadar
       options = { output: "gem_radar.md", lockfile: "Gemfile.lock" }
       OptionParser.new do |o|
         o.banner = "Usage: gem_radar [options]  (run from inside the project directory)"
-        o.on("--ruby VERSION", "Project's Ruby version (default: .ruby-version or Gemfile.lock)") { |v| options[:ruby] = v }
-        o.on("--rails VERSION", "Project's Rails version (default: the one in Gemfile.lock)") { |v| options[:rails] = v }
+        o.on("--ruby VERSION", "Project's Ruby version (default: .ruby-version or Gemfile.lock)") do |v|
+          options[:ruby] = v
+        end
+        o.on("--rails VERSION", "Project's Rails version (default: the one in Gemfile.lock)") do |v|
+          options[:rails] = v
+        end
         o.on("--lockfile PATH", "Path to Gemfile.lock (default: ./Gemfile.lock)") { |v| options[:lockfile] = v }
         o.on("-o", "--output PATH", "Output file (default: gem_radar.md)") { |v| options[:output] = v }
-        o.on("-h", "--help", "Shows this help") { puts o; exit }
-        o.on("--version", "Shows the version") { puts "gem_radar #{VERSION} (\"#{CODENAME}\")"; exit }
+        o.on("-h", "--help", "Shows this help") do
+          puts o
+          exit
+        end
+        o.on("--version", "Shows the version") do
+          puts "gem_radar #{VERSION} (\"#{CODENAME}\")"
+          exit
+        end
       end.parse!(argv)
       options
     end
@@ -83,12 +97,13 @@ module GemRadar
 
     def http_get(url, headers = {}, limit = 5)
       return nil if limit.zero?
+
       uri = URI(url)
       req = Net::HTTP::Get.new(uri)
       req["User-Agent"] = USER_AGENT
       headers.each { |k, v| req[k] = v }
       res = Net::HTTP.start(uri.host, uri.port, use_ssl: uri.scheme == "https",
-                            open_timeout: 10, read_timeout: 30) { |h| h.request(req) }
+                                                open_timeout: 10, read_timeout: 30) { |h| h.request(req) }
       if res.is_a?(Net::HTTPRedirection) && res["location"]
         http_get(URI.join(url, res["location"]).to_s, headers, limit - 1)
       else
@@ -101,7 +116,8 @@ module GemRadar
 
     def github_token
       return @github_token if defined?(@github_token)
-      token = ENV["GITHUB_TOKEN"] || ENV["GH_TOKEN"]
+
+      token = ENV["GITHUB_TOKEN"] || ENV.fetch("GH_TOKEN", nil)
       token ||= begin
         out = `gh auth token 2>/dev/null`.strip
         out.empty? ? nil : out
@@ -116,6 +132,7 @@ module GemRadar
       headers["Authorization"] = "Bearer #{github_token}" if github_token
       res = http_get("https://api.github.com#{path}", headers)
       return nil unless res.is_a?(Net::HTTPSuccess)
+
       JSON.parse(res.body)
     rescue JSON::ParserError
       nil
@@ -137,11 +154,11 @@ module GemRadar
         end
         case section
         when "GEM", "GIT", "PATH"
-          specs[$1] = $2 if line =~ /\A    (\S+) \(([^)\s]+)\)/
+          specs[::Regexp.last_match(1)] = ::Regexp.last_match(2) if line =~ /\A    (\S+) \(([^)\s]+)\)/
         when "DEPENDENCIES"
-          deps << $1 if line =~ /\A  ([^\s!(]+)/
+          deps << ::Regexp.last_match(1) if line =~ /\A  ([^\s!(]+)/
         when "RUBY VERSION"
-          ruby = $1 if line =~ /ruby (\d+\.\d+\.\d+)/
+          ruby = ::Regexp.last_match(1) if line =~ /ruby (\d+\.\d+\.\d+)/
         end
       end
       { dependencies: deps.uniq.sort, specs: specs, ruby: ruby }
@@ -149,6 +166,7 @@ module GemRadar
 
     def detect_ruby_version(options, lockfile_data)
       return options[:ruby] if options[:ruby]
+
       if File.file?(".ruby-version")
         v = File.read(".ruby-version").strip.sub(/\Aruby-/, "")
         return v unless v.empty?
@@ -165,6 +183,7 @@ module GemRadar
     def rubygems_info(name)
       res = http_get("https://rubygems.org/api/v1/gems/#{name}.json")
       return nil unless res.is_a?(Net::HTTPSuccess)
+
       JSON.parse(res.body)
     rescue JSON::ParserError
       nil
@@ -173,6 +192,7 @@ module GemRadar
     def rubygems_versions(name)
       res = http_get("https://rubygems.org/api/v1/versions/#{name}.json")
       return [] unless res.is_a?(Net::HTTPSuccess)
+
       JSON.parse(res.body)
     rescue JSON::ParserError
       []
@@ -182,6 +202,7 @@ module GemRadar
       @version_deps_cache ||= {}
       key = "#{name}@#{version}"
       return @version_deps_cache[key] if @version_deps_cache.key?(key)
+
       res = http_get("https://rubygems.org/api/v2/rubygems/#{name}/versions/#{version}.json")
       @version_deps_cache[key] =
         begin
@@ -199,6 +220,7 @@ module GemRadar
 
     def requirement_satisfied?(requirement_str, version)
       return true if requirement_str.nil? || requirement_str.to_s.empty?
+
       Gem::Requirement.new(*requirement_str.split(",").map(&:strip)).satisfied_by?(version)
     rescue StandardError
       true
@@ -210,8 +232,10 @@ module GemRadar
 
     def rails_requirement_satisfied?(runtime_deps, rails_version)
       return true unless rails_version
+
       rails_deps = Array(runtime_deps).select { |d| RAILS_FAMILY.include?(d["name"]) }
       return true if rails_deps.empty?
+
       rails_deps.all? { |d| requirement_satisfied?(d["requirements"], rails_version) }
     end
 
@@ -248,6 +272,7 @@ module GemRadar
     # not just a recommendation (unlike the "updatable" categories).
     def mandatory_update_reasons(name, installed, versions, ruby_version, rails_version, latest_runtime_deps)
       return [] unless installed
+
       entry = versions.find { |v| gem_version(v["number"]) == installed }
       return [] unless entry # installed version not indexed on rubygems.org (yanked, etc.)
 
@@ -280,6 +305,7 @@ module GemRadar
 
     def github_repo(url)
       return nil unless url && !url.empty?
+
       m = url.match(%r{github\.com/([^/]+)/([^/#?]+)})
       m && "#{m[1]}/#{m[2].sub(/\.git\z/, '')}"
     end
@@ -294,10 +320,24 @@ module GemRadar
       [info["source_code_uri"] || info["homepage_uri"], nil]
     end
 
+    # Matches an actual deprecation notice ("DEPRECATED: ...", "this gem is
+    # deprecated", "no longer maintained"), not just any mention of the word
+    # — a gem *about* deprecation (like this one) can otherwise flag itself.
+    DEPRECATION_NOTICE = /
+      (?:\A|[.!]\s*) \W*
+      (?: this \s gem \s (?:is|has \s been) \s deprecated
+        | deprecated \s*[:-]
+        | \[deprecated\]
+        | no \s longer \s maintained
+        | unmaintained
+      )
+    /ix.freeze
+
     def deprecated?(info, repo_info)
       return true if repo_info && repo_info["archived"]
+
       text = "#{info['info']} #{info['description']}"
-      !!(text =~ /\bdeprecat/i)
+      !!(text =~ DEPRECATION_NOTICE)
     end
 
     # --- Classification -----------------------------------------------------------
@@ -323,15 +363,17 @@ module GemRadar
       end
     end
 
-    def classify(r)
-      return :not_found unless r[:found]
-      return :mandatory if r[:mandatory_reasons] && !r[:mandatory_reasons].empty?
-      return :deprecated if r[:deprecated]
-      return :compatible unless r[:installed] && r[:latest]
+    def classify(result)
+      return :not_found unless result[:found]
+      return :mandatory if result[:mandatory_reasons] && !result[:mandatory_reasons].empty?
+      return :deprecated if result[:deprecated]
+      return :compatible unless result[:installed] && result[:latest]
 
-      if r[:compatible] && r[:compatible] > r[:installed]
-        same_compat_line?(r[:installed], r[:compatible]) ? :updatable_safe : :updatable_breaking
-      elsif r[:latest] > r[:installed] && (r[:compatible].nil? || r[:compatible] <= r[:installed])
+      no_compatible_update = result[:compatible].nil? || result[:compatible] <= result[:installed]
+
+      if result[:compatible] && result[:compatible] > result[:installed]
+        same_compat_line?(result[:installed], result[:compatible]) ? :updatable_safe : :updatable_breaking
+      elsif result[:latest] > result[:installed] && no_compatible_update
         # A newer version exists, but none was found compatible with the
         # current Ruby/Rails: updating means upgrading the framework too.
         :updatable_breaking
@@ -342,24 +384,24 @@ module GemRadar
 
     # --- Report -------------------------------------------------------------------
 
-    def format_gem_line(r)
-      parts = ["**#{r[:name]}**"]
-      parts << "installed `#{r[:installed]}`" if r[:installed]
-      if r[:compatible] && r[:installed] && r[:compatible] > r[:installed]
-        parts << "recommended `#{r[:compatible]}`"
+    def format_gem_line(result)
+      parts = ["**#{result[:name]}**"]
+      parts << "installed `#{result[:installed]}`" if result[:installed]
+      if result[:compatible] && result[:installed] && result[:compatible] > result[:installed]
+        parts << "recommended `#{result[:compatible]}`"
       end
-      if r[:latest] && (r[:compatible].nil? || r[:latest] > r[:compatible])
-        parts << "latest published `#{r[:latest]}`"
+      if result[:latest] && (result[:compatible].nil? || result[:latest] > result[:compatible])
+        parts << "latest published `#{result[:latest]}`"
       end
       line = "- #{parts.join(' · ')}"
-      line += " — [repository](#{r[:repo_url]})" if r[:repo_url]
-      line += "\n\n  > #{r[:error]}" if r[:error]
-      Array(r[:mandatory_reasons]).each { |reason| line += "\n\n  > #{reason}" }
+      line += " — [repository](#{result[:repo_url]})" if result[:repo_url]
+      line += "\n\n  > #{result[:error]}" if result[:error]
+      Array(result[:mandatory_reasons]).each { |reason| line += "\n\n  > #{reason}" }
       line
     end
 
-    def build_report(project, ruby_version, rails_version, results, options)
-      grouped = results.group_by { |r| classify(r) }
+    def build_report(project, ruby_version, rails_version, results, _options)
+      grouped = results.group_by { |result| classify(result) }
 
       lines = []
       lines << "# Gems in #{project}"
@@ -381,12 +423,13 @@ module GemRadar
       CATEGORY_ORDER.each do |cat|
         items = grouped[cat]
         next if items.nil? || items.empty?
+
         lines << ""
         lines << "## #{CATEGORY_TITLES[cat]}"
         lines << ""
-        items.each { |r| lines << format_gem_line(r) }
+        items.each { |result| lines << format_gem_line(result) }
       end
-      lines.join("\n") + "\n"
+      "#{lines.join("\n")}\n"
     end
 
     # --- Per-gem processing ------------------------------------------------------
@@ -403,7 +446,8 @@ module GemRadar
       versions = rubygems_versions(name)
       latest_runtime_deps = info.dig("dependencies", "runtime") || []
       compatible = latest_compatible(name, versions, ruby_version, rails_version, latest_runtime_deps)
-      mandatory_reasons = mandatory_update_reasons(name, installed, versions, ruby_version, rails_version, latest_runtime_deps)
+      mandatory_reasons = mandatory_update_reasons(name, installed, versions, ruby_version, rails_version,
+                                                   latest_runtime_deps)
 
       url, repo = repo_url_for(info)
       repo_info = repo && github_api("/repos/#{repo}")

data/lib/gem_radar/version.rb

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
 module GemRadar
-  VERSION = "0.1.0"
-  CODENAME = "Brazil"
+  VERSION = "0.1.1"
+  CODENAME = "Blue Velvet"
 end

metadata

@@ -1,28 +1,34 @@
 --- !ruby/object:Gem::Specification
 name: gem_radar
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Laura Jaime
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-08-26 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies: []
 description: Reads a project's Gemfile.lock and reports, for each direct gem, whether
   it's compatible with the project's Ruby/Rails, needs a mandatory update, is deprecated
   or archived, or can be upgraded safely vs. with breaking changes.
-email:
 executables:
 - gem_radar
 extensions: []
 extra_rdoc_files: []
 files:
+- ".github/PULL_REQUEST_TEMPLATE.md"
+- ".github/workflows/ci.yml"
 - ".gitignore"
+- ".rspec"
+- ".rubocop.yml"
+- ".ruby-version"
 - CHANGELOG.md
+- Gemfile
+- Gemfile.lock
 - LICENSE
 - README.md
+- Rakefile
 - assets/banner.png
 - exe/gem_radar
 - gem_radar.gemspec
@@ -34,7 +40,7 @@ licenses:
 - MIT
 metadata:
   changelog_uri: https://github.com/laurajaime/gem_radar/blob/main/CHANGELOG.md
-post_install_message:
+  rubygems_mfa_required: 'true'
 rdoc_options: []
 require_paths:
 - lib
@@ -42,15 +48,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.0.0
+      version: 2.7.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.7
-signing_key:
+rubygems_version: 4.0.16
 specification_version: 4
 summary: Audits your Ruby/Rails project's gems and reports their compatibility and
   update status.