Maguyva의 Groovy 지원: Gradle과 Jenkins 코드를 위한 코드 그래프

Groovy가 얕은 AI 도구를 넘어뜨리는 지점

Groovy는 흔히 설정 파일처럼 읽힙니다. Gradle 빌드에서 dependencies { implementation ... }는 클로저가 붙은 메서드 호출의 연쇄이고, 선언형 Jenkinsfile도 마찬가지입니다. 빌더는 임의의 이름을 호출로 바꾸고, GDK는 each, collect 같은 메서드를 모든 객체에 추가합니다. 모든 호출을 기록하는 도구는 이 잡음에 묻혀 버립니다.

Maguyva는 DSL과 GDK 계층을 걸러 내므로 여러분의 메서드와 클래스가 드러납니다.

Maguyva가 Groovy에서 추출하는 것

Maguyva는 .groovy와 .gradle 파일, 그리고 Jenkinsfile를 지원합니다. 클래스, 함수, 메서드가 추출되고, 임포트는 import static와 as 별칭을 정규화합니다. 호출 이름에서는 끝에 붙은 클로저 블록과 ?. 안전 탐색 연산자가 제거되므로, repo?.save(order) { ... }는 save에 대한 호출로 기록됩니다. 클래스 안에서 리시버 없이 호출하면 그 클래스 자신의 메서드로 해석됩니다.

잡음은 여러 층으로 걸러집니다.

• dependencies, implementation, task, given, when, then, Mock 같은 약 140개의 표준 라이브러리, Gradle, Spock 이름.
• each, collect, inject, eachLine 같은 약 260개의 GDK 메서드.
• pipeline, stage, steps, sh 같은 Jenkins 단계를 포함한 빌더 DSL 이름. 괄호와 함께 호출되지 않고 빌더 방식으로 쓰일 때 걸러집니다.
• @CompileStatic, @Immutable, @Autowired 같은 AST 변환 및 프레임워크 애너테이션. 이들은 결코 호출로 기록되지 않습니다.

그래프에는 상속, 인스턴스화, 읽기와 쓰기도 기록됩니다.

에이전트 프롬프트 예시

• “deployToStaging를 누가 호출하고, 어떤 파이프라인에서 호출하나요?” (find_symbol, 그다음 dependency_search incoming)
• “BaseIntegrationSpec를 상속하는 클래스는 무엇인가요?” (dependency_search)
• “릴리스 태스크가 아티팩트를 어떻게 빌드하고 게시하는지 설명해 줘.” (get_task_context)

알려진 한계

• Groovy의 메서드와 자유 함수는 하나의 구문 노드를 공유하므로, structural_search의 methods 프리셋은 아무것도 선택하지 않습니다. 대신 functions 프리셋이나 find_symbol를 사용하세요.
• collect나 stage처럼 GDK 또는 DSL 메서드와 이름이 같은 사용자 메서드는 함께 걸러질 수 있습니다. 호출자가 빠진 것처럼 보이면 text_pattern_search를 사용하세요.

다음 단계

빠른 시작으로 저장소를 연결한 다음, 호환성 페이지에서 지원 매트릭스를 확인하세요. 빌드가 컴파일하는 JVM 코드라면 Java 가이드와 Kotlin 가이드를 읽어 보세요.