Ruby w Maguyva: grafy kodu dla Rails i aplikacji Ruby

Dlaczego repozytoria Ruby sprawiają kłopot powierzchownym narzędziom AI

Ruby mocno opiera się na konwencjach i metaprogramowaniu. Metody są generowane przez attr_accessor, klasy są ponownie otwierane w innych plikach, a przestrzenie nazw zagnieżdżają kilka poziomów modułów. Czytelna powierzchnia ukrywa, do której metody naprawdę trafia wywołanie, a toporne wyszukiwanie tekstowe zwraca każde call i każde perform w aplikacji.

Maguyva daje agentowi klasy, moduły, metody i ich wywołujących jako strukturę, aby śledził zmianę w całej aplikacji zamiast zgadywać.

Co Maguyva wyodrębnia w Ruby

Maguyva obejmuje pliki .rb, .rbw, .rake i .gemspec oraz Gemfile i Rakefile. Wyodrębniane są metody instancji i metody singletonowe (def self.call), przy czym metody singletonowe są oznaczane jako statyczne. Deklaracje attr_reader, attr_writer i attr_accessor liczą się jako metody dostępowe, a symbole są kwalifikowane przestrzenią nazw modułu i klasy.

ClassName.new i Namespace::ClassName.new liczą się jako tworzenie instancji, a typowanie odbiorców śledzi lokalne przypisania i @instance_variables, dzięki czemu wywołanie na przypisanym obiekcie można rozwiązać do jego klasy. Graf zapisuje też dziedziczenie, dołączanie modułów, nadpisania, krawędzie raise i rescue oraz odczyty i zapisy.

Wywołania metaprogramowania (define_method, send, method_missing, class_eval i podobne), pomocnicze typy T:: z Sorbeta oraz typowe wywołania enumerable (each, collect, reject i podobne) są filtrowane z relacji, aby wyróżnić kod aplikacji.

Przykładowe prompty dla agentów

• „Kto wywołuje Billing::ChargeCustomer.call i z których zadań i kontrolerów?” (find_symbol, potem dependency_search incoming)
• „Które modele dziedziczą po ApplicationRecord i dołączają Auditable?” (dependency_search)
• „Prześledź, co się dzieje po oznaczeniu zamówienia jako opłacone.” (get_task_context)

Znane ograniczenia

• W Ruby require i load to zwykłe wywołania metod, więc preset imports w structural_search niczego nie wybiera. Aby je wypisać, użyj text_pattern_search.
• Metody tworzone w czasie działania przez define_method lub obsługiwane przez method_missing nie są wyodrębniane jako symbole, a te wywołania są filtrowane jako szum metaprogramowania.
• Ruby nie ma składni dekoratorów, więc relacje dekoratorów są oznaczone jako nie dotyczy.

Kolejne kroki

Podłącz repozytorium za pomocą szybkiego startu, a potem sprawdź macierz obsługi na stronie zgodności. W przypadku innych repozytoriów w językach dynamicznych porównaj z przewodnikiem po języku Python.