Ruby i Maguyva: kodgrafer för Rails- och Ruby-appar

Varför Ruby-repon är svåra för ytliga AI-verktyg

Ruby lutar sig tungt mot konventioner och metaprogrammering. Metoder genereras av attr_accessor, klasser öppnas igen i andra filer och namnrymder nästlar flera moduler djupt. Den läsbara ytan döljer vilken metod ett anrop faktiskt når, och en trubbig textsökning returnerar varje call och perform i appen.

Maguyva ger agenten klasser, moduler, metoder och deras anropare som struktur, så att den kan följa en ändring genom appen i stället för att gissa.

Vad Maguyva extraherar i Ruby

Maguyva täcker .rb-, .rbw-, .rake- och .gemspec-filer samt Gemfile och Rakefile. Instansmetoder och singletonmetoder (def self.call) extraheras, och singletonmetoder markeras som statiska. Deklarationer med attr_reader, attr_writer och attr_accessor räknas som accessormetoder, och symboler kvalificeras med sin modul- och klassnamnrymd.

ClassName.new och Namespace::ClassName.new räknas som instansiering, och mottagartypningen följer lokala tilldelningar och @instance_variables, så ett anrop på ett tilldelat objekt kan lösas till sin klass. Grafen registrerar också arv, modulinkludering, överskrivningar, raise- och rescue-kanter samt läsningar och skrivningar.

Metaprogrammeringsanrop (define_method, send, method_missing, class_eval och liknande), Sorbets T::-typhjälpare och vanliga enumerable-anrop (each, collect, reject och liknande) filtreras bort ur relationerna så att applikationskoden syns.

Exempel på prompter för agenter

• “Vem anropar Billing::ChargeCustomer.call, och från vilka jobb och controllers?” (find_symbol, sedan dependency_search incoming)
• “Vilka modeller ärver från ApplicationRecord och inkluderar Auditable?” (dependency_search)
• “Spåra vad som händer efter att en order markerats som betald.” (get_task_context)

Kända begränsningar

• require och load är vanliga metodanrop i Ruby, så förinställningen imports i structural_search väljer ingenting. Använd text_pattern_search för att lista dem.
• Metoder som skapas vid körning med define_method eller hanteras av method_missing extraheras inte som symboler, och de anropen filtreras som metaprogrammeringsbrus.
• Ruby saknar dekoratorsyntax, så dekoratorrelationer är markerade som ej tillämpliga.

Nästa steg

Anslut ett repo med snabbstarten och kontrollera sedan stödmatrisen på kompatibilitetssidan. För andra repon i dynamiska språk, jämför med guiden för Python.