Ruby no Maguyva: grafos de código para Rails e apps Ruby

Por que repositórios Ruby complicam ferramentas de IA superficiais

Ruby se apoia em convenções e metaprogramação. Métodos são gerados por attr_accessor, classes são reabertas em outros arquivos, e namespaces aninham vários módulos. A superfície legível esconde qual método uma chamada realmente alcança, e uma busca textual bruta devolve cada call e cada perform do app.

O Maguyva entrega ao agente classes, módulos, métodos e seus chamadores como estrutura, para que ele siga uma mudança pelo app em vez de adivinhar.

O que o Maguyva extrai em Ruby

O Maguyva cobre arquivos .rb, .rbw, .rake e .gemspec, além de Gemfile e Rakefile. Métodos de instância e métodos singleton (def self.call) são extraídos, e os métodos singleton são marcados como estáticos. Declarações attr_reader, attr_writer e attr_accessor contam como métodos de acesso, e os símbolos são qualificados pelo namespace de módulo e classe.

ClassName.new e Namespace::ClassName.new contam como instanciação, e a tipagem de receivers segue atribuições locais e @instance_variables, de modo que uma chamada em um objeto atribuído pode ser resolvida para a sua classe. O grafo também registra herança, inclusão de módulos, sobrescritas, arestas de raise e rescue, e leituras e escritas.

Chamadas de metaprogramação (define_method, send, method_missing, class_eval e semelhantes), os helpers de tipo T:: do Sorbet e chamadas enumeráveis comuns (each, collect, reject e semelhantes) são filtrados das relações para que o código da aplicação se destaque.

Exemplos de prompts para agentes

• “Quem chama Billing::ChargeCustomer.call e a partir de quais jobs e controllers?” (find_symbol, depois dependency_search incoming)
• “Quais models herdam de ApplicationRecord e incluem Auditable?” (dependency_search)
• “Rastreie o que acontece depois que um pedido é marcado como pago.” (get_task_context)

Limitações conhecidas

• Em Ruby, require e load são chamadas de método comuns, então o preset imports de structural_search não seleciona nada. Use text_pattern_search para listá-las.
• Métodos criados em tempo de execução com define_method ou tratados por method_missing não são extraídos como símbolos, e essas chamadas são filtradas como ruído de metaprogramação.
• Ruby não tem sintaxe de decorators, então relações de decorator estão marcadas como não aplicáveis.

Próximos passos

Conecte um repositório pelo início rápido e depois confira a matriz de suporte na página de compatibilidade. Para outros repositórios em linguagens dinâmicas, compare com o guia de Python.