Quando Usar Esta Habilidade

Analisa aplicações Rails e fornece avaliações de atualização

Use esta habilidade ao trabalhar com a análise de aplicações Rails e a oferta de avaliações de atualização.

Analisador de Atualização Rails

Analisa a aplicação Rails atual e fornece uma avaliação de atualização abrangente com mesclagem seletiva de arquivos.

Passo 1: Verificar Aplicação Rails

Verifica se estamos em uma aplicação Rails procurando por estes arquivos:

• Gemfile (deve existir e conter 'rails')
• config/application.rb (configuração da aplicação Rails)
• config/environment.rb (ambiente Rails)

Se algum destes estiver faltando ou não indicar uma aplicação Rails, pare e informe ao usuário que isto não parece ser uma aplicação Rails.

Passo 2: Obter Versão Atual do Rails

Extrai a versão atual do Rails de:

1. Primeiro, verifique Gemfile.lock para a versão exata instalada (procure por rails (x.y.z))
2. Se não for encontrado, verifique Gemfile para a restrição de versão

Relata a versão atual exata (por exemplo, 7.1.3).

Passo 3: Encontrar Última Versão do Rails

Usa o GitHub CLI para buscar a última versão do Rails:

gh api repos/rails/rails/releases/latest --jq '.tag_name'

Isso retorna a tag da última versão estável (por exemplo, v8.0.1). Remove o prefixo 'v' para comparação.

Também verifica tags recentes para entender o cenário de lançamentos:

gh api repos/rails/rails/tags --jq '.[0:10] | .[].name'

Passo 4: Determinar Tipo de Atualização

Compara as versões atual e a última para classificar a atualização:

• Atualização de patch: Mesma major.minor, patch diferente (por exemplo, 7.1.3 → 7.1.5)
• Atualização menor: Mesma major, minor diferente (por exemplo, 7.1.3 → 7.2.0)
• Atualização maior: Versão major diferente (por exemplo, 7.1.3 → 8.0.0)

Passo 5: Obter Guia de Atualização

Usa WebFetch para obter o guia oficial de atualização do Rails:

URL: https://guides.rubyonrails.org/upgrading_ruby_on_rails.html

Procure por seções relevantes para o salto de versão. O guia é organizado por versão de destino com seções como:

• "Atualizando de Rails X.Y para Rails X.Z"
• Mudanças que quebram compatibilidade (Breaking changes)
• Avisos de depreciação (Deprecation warnings)
• Mudanças de configuração
• Migrações necessárias

Extrai e resume as seções relevantes para o caminho de atualização específico do usuário.

Passo 6: Obter Diff do Rails

Usa WebFetch para obter o diff entre versões do railsdiff.org:

URL: https://railsdiff.org/{current_version}/{target_version}

Por exemplo: https://railsdiff.org/7.1.3/8.0.0

Isso mostra:

• Mudanças em arquivos de configuração padrão
• Novos arquivos que precisam ser adicionados
• Initializers modificados
• Dependências atualizadas
• Mudanças em scripts bin/

Resume as principais mudanças de arquivo.

Passo 7: Verificar Dependências JavaScript

Aplicações Rails frequentemente incluem pacotes JavaScript que devem ser atualizados junto com o Rails. Verifica e relata sobre estas dependências.

7.1: Identificar Gerenciador de Pacotes JS

Verifica qual gerenciador de pacotes a aplicação usa:

# Check for package.json (npm/yarn)
ls package.json 2>/dev/null

# Check for importmap (Rails 7+)
ls config/importmap.rb 2>/dev/null

7.2: Verificar Pacotes JS Relacionados ao Rails

Se package.json existir, verifica estes pacotes relacionados ao Rails:

# Extract current versions of Rails-related packages
cat package.json | grep -E '"@hotwired/|"@rails/|"stimulus"|"turbo-rails"' || echo "No Rails JS packages found"

Pacotes chave para verificar:

7.3: Verificar Atualizações

Para projetos npm/yarn, verifica atualizações disponíveis:

# Using npm
npm outdated @hotwired/turbo-rails @hotwired/stimulus @rails/actioncable @rails/activestorage 2>/dev/null

# Or check latest versions directly
npm view @hotwired/turbo-rails version 2>/dev/null
npm view @rails/actioncable version 2>/dev/null

7.4: Verificar Pinos do Importmap (se aplicável)

Se a aplicação usa importmap-rails, verifica config/importmap.rb para versões fixadas (pinned):

cat config/importmap.rb | grep -E 'pin.*turbo|pin.*stimulus|pin.*@rails' || echo "No importmap pins found"

Para atualizar os pinos do importmap:

…