Ruby dans Maguyva : des graphes de code pour Rails et les apps Ruby

Pourquoi les dépôts Ruby posent problème aux outils d’IA superficiels

Ruby s’appuie fortement sur les conventions et la métaprogrammation. Des méthodes sont générées par attr_accessor, des classes sont rouvertes dans d’autres fichiers, et les espaces de noms imbriquent plusieurs niveaux de modules. La surface lisible cache la méthode qu’un appel atteint réellement, et une recherche textuelle brute renvoie chaque call et chaque perform de l’application.

Maguyva donne à l’agent classes, modules, méthodes et appelants sous forme de structure, pour qu’il suive un changement à travers l’application au lieu de deviner.

Ce que Maguyva extrait en Ruby

Maguyva couvre les fichiers .rb, .rbw, .rake et .gemspec, ainsi que Gemfile et Rakefile. Les méthodes d’instance et les méthodes singleton (def self.call) sont extraites, les méthodes singleton étant marquées comme statiques. Les déclarations attr_reader, attr_writer et attr_accessor comptent comme méthodes d’accès, et les symboles sont qualifiés par leur espace de noms de module et de classe.

ClassName.new et Namespace::ClassName.new comptent comme instanciation, et le typage des receveurs suit les affectations locales et les @instance_variables, de sorte qu’un appel sur un objet affecté peut se résoudre vers sa classe. Le graphe enregistre aussi l’héritage, l’inclusion de modules, les surcharges, les arêtes raise et rescue, ainsi que les lectures et écritures.

Les appels de métaprogrammation (define_method, send, method_missing, class_eval et similaires), les helpers de type T:: de Sorbet et les appels énumérables courants (each, collect, reject et similaires) sont filtrés des relations pour faire ressortir le code applicatif.

Exemples de prompts pour agents

• « Qui appelle Billing::ChargeCustomer.call, et depuis quels jobs et contrôleurs ? » (find_symbol, puis dependency_search en incoming)
• « Quels modèles héritent de ApplicationRecord et incluent Auditable ? » (dependency_search)
• « Retrace ce qui se passe après qu’une commande est marquée comme payée. » (get_task_context)

Limites connues

• En Ruby, require et load sont des appels de méthode ordinaires ; le préréglage imports de structural_search ne sélectionne donc rien. Utilisez text_pattern_search pour les lister.
• Les méthodes créées à l’exécution avec define_method ou traitées par method_missing ne sont pas extraites comme symboles, et ces appels sont filtrés comme bruit de métaprogrammation.
• Ruby n’a pas de syntaxe de décorateur ; les relations de décorateur sont donc marquées comme non applicables.

Étapes suivantes

Connectez un dépôt avec le démarrage rapide, puis consultez la matrice de prise en charge sur la page de compatibilité. Pour d’autres dépôts en langages dynamiques, comparez avec le guide Python.