Groovy у Maguyva: графи коду для Gradle і Jenkins

Де Groovy збиває з пантелику поверхові ШІ-інструменти

Groovy часто читається як конфігурація. У збірці Gradle dependencies { implementation ... } є ланцюжком викликів методів із замиканнями, і декларативний Jenkinsfile влаштований так само. Білдери перетворюють довільні імена на виклики, а GDK додає кожному об’єктові методи на кшталт each і collect. Інструмент, що записує кожен виклик, тоне в цьому шумі.

Maguyva відфільтровує шар DSL і GDK, щоб ваші власні методи й класи було видно.

Що Maguyva витягує з Groovy

Maguyva охоплює файли .groovy і .gradle, а також Jenkinsfile. Витягуються класи, функції та методи, а імпорти нормалізують псевдоніми import static і as. Кінцеві блоки замикань і оператор безпечної навігації ?. вилучаються з імен викликів, тож repo?.save(order) { ... } записується як виклик save. Виклик без отримувача всередині класу розв’язується у власний метод цього класу.

Шум відфільтровується пошарово:

• Близько 140 імен стандартної бібліотеки, Gradle і Spock, як-от dependencies, implementation, task, given, when, then і Mock.
• Близько 260 методів GDK, як-от each, collect, inject і eachLine.
• Імена DSL білдерів, зокрема кроки Jenkins на кшталт pipeline, stage, steps і sh, коли їх використано в стилі білдера, а не викликано з дужками.
• Анотації AST-перетворень і фреймворків, як-от @CompileStatic, @Immutable і @Autowired, які ніколи не записуються як виклики.

Граф також фіксує успадкування, створення екземплярів, читання й запис.

Приклади промптів для агентів

• «Хто викликає deployToStaging і з яких конвеєрів?» (find_symbol, потім dependency_search за вхідними зв’язками)
• «Які класи успадковують від BaseIntegrationSpec?» (dependency_search)
• «Поясни, як задача випуску збирає й публікує артефакти.» (get_task_context)

Відомі обмеження

• Методи Groovy та вільні функції використовують той самий синтаксичний вузол, тому пресет methods у structural_search нічого не вибирає. Використовуйте натомість пресет functions або find_symbol.
• Ваш метод, ім’я якого збігається з методом GDK чи DSL, як-от collect або stage, може бути відфільтрований разом із ними. Якщо здається, що код виклику зник, використовуйте text_pattern_search.

Наступні кроки

Під’єднайте репозиторій за швидким стартом, потім перегляньте матрицю підтримки на сторінці сумісності. Для коду на JVM, який компілюють ваші збірки, прочитайте посібник із Java і посібник із Kotlin.