Groovy w Maguyva: grafy kodu dla Gradle i Jenkinsa

Gdzie Groovy sprawia kłopot powierzchownym narzędziom AI

Groovy często czyta się jak konfigurację. W buildzie Gradle dependencies { implementation ... } to łańcuch wywołań metod z domknięciami, podobnie jak deklaratywny Jenkinsfile. Buildery zamieniają dowolne nazwy w wywołania, a GDK dodaje do każdego obiektu metody takie jak each i collect. Narzędzie, które zapisuje każde wywołanie, tonie w tym szumie.

Maguyva odfiltrowuje warstwę DSL i GDK, żeby twoje własne metody i klasy były widoczne.

Co Maguyva wyodrębnia w Groovy

Maguyva obejmuje pliki .groovy i .gradle oraz Jenkinsfile. Wyodrębniane są klasy, funkcje i metody, a importy normalizują aliasy import static i as. Nazwy wywołań są oczyszczane z końcowych bloków domknięć i operatora bezpiecznej nawigacji ?., więc repo?.save(order) { ... } zapisuje się jako wywołanie save. Wywołanie bez odbiorcy wewnątrz klasy jest rozwiązywane do jej własnej metody.

Szum jest filtrowany warstwami:

• Około 140 nazw z biblioteki standardowej, Gradle i Spocka, takich jak dependencies, implementation, task, given, when, then i Mock.
• Około 260 metod GDK, takich jak each, collect, inject i eachLine.
• Nazwy DSL builderów, w tym kroki Jenkinsa, takie jak pipeline, stage, steps i sh, gdy są używane w stylu buildera, a nie wywoływane z nawiasami.
• Adnotacje transformacji AST i frameworków, takie jak @CompileStatic, @Immutable i @Autowired, które nigdy nie są zapisywane jako wywołania.

Graf zapisuje też dziedziczenie, tworzenie instancji oraz odczyty i zapisy.

Przykładowe prompty dla agentów

• „Kto wywołuje deployToStaging i z których potoków?” (find_symbol, potem dependency_search incoming)
• „Które klasy dziedziczą po BaseIntegrationSpec?” (dependency_search)
• „Wyjaśnij, jak zadanie release buduje i publikuje artefakty.” (get_task_context)

Znane ograniczenia

• Metody i wolne funkcje w Groovy współdzielą jeden węzeł składni, więc preset methods w structural_search niczego nie wybiera. Zamiast niego użyj presetu functions lub find_symbol.
• Twoja metoda o tej samej nazwie co metoda GDK lub DSL, na przykład collect albo stage, może zostać odfiltrowana razem z nimi. Gdy wydaje się, że brakuje wywołującego, użyj text_pattern_search.

Kolejne kroki

Podłącz repozytorium za pomocą szybkiego startu, a potem sprawdź macierz obsługi na stronie zgodności. W przypadku kodu JVM kompilowanego przez twoje buildy przeczytaj przewodnik po Javie i przewodnik po Kotlinie.