Ruby i Maguyva: kodegrafer til Rails- og Ruby-apps

Hvorfor Ruby-repositories er svære for overfladiske AI-værktøjer

Ruby læner sig tungt op ad konventioner og metaprogrammering. Metoder genereres af attr_accessor, klasser genåbnes i andre filer, og navnerum indlejrer flere moduler. Den læsbare overflade skjuler, hvilken metode et kald faktisk rammer, og en grov tekstsøgning returnerer hvert call og perform i appen.

Maguyva giver agenten klasser, moduler, metoder og deres kaldere som struktur, så den kan følge en ændring gennem appen i stedet for at gætte.

Hvad Maguyva udtrækker i Ruby

Maguyva dækker .rb-, .rbw-, .rake- og .gemspec-filer samt Gemfile og Rakefile. Instansmetoder og singleton-metoder (def self.call) udtrækkes, og singleton-metoder markeres som statiske. Erklæringer med attr_reader, attr_writer og attr_accessor tæller som accessor-metoder, og symboler kvalificeres med deres modul- og klassenavnerum.

ClassName.new og Namespace::ClassName.new tæller som instansiering, og modtagertypningen følger lokale tildelinger og @instance_variables, så et kald på et tildelt objekt kan opløses til dets klasse. Grafen registrerer også nedarvning, modulinklusion, overskrivninger, raise- og rescue-kanter samt læsninger og skrivninger.

Metaprogrammeringskald (define_method, send, method_missing, class_eval og lignende), Sorbets T::-typehjælpere og almindelige enumerable-kald (each, collect, reject og lignende) filtreres fra relationerne, så applikationskoden træder frem.

Eksempler på prompts til agenter

• “Hvem kalder Billing::ChargeCustomer.call, og fra hvilke jobs og controllers?” (find_symbol, derefter dependency_search incoming)
• “Hvilke modeller arver fra ApplicationRecord og inkluderer Auditable?” (dependency_search)
• “Spor, hvad der sker, efter at en ordre er markeret som betalt.” (get_task_context)

Kendte begrænsninger

• require og load er almindelige metodekald i Ruby, så forudindstillingen imports i structural_search vælger intet. Brug text_pattern_search til at liste dem.
• Metoder, der oprettes ved kørsel med define_method eller håndteres af method_missing, udtrækkes ikke som symboler, og de kald filtreres som metaprogrammeringsstøj.
• Ruby har ingen dekoratorsyntaks, så dekoratorrelationer er markeret som ikke relevante.

Næste skridt

Tilslut et repository med hurtigstarten, og se derefter understøttelsesmatricen på kompatibilitetssiden. For andre repositories i dynamiske sprog, sammenlign med guiden til Python.