Kotlin in Maguyva: Code-Graphen für Android und die JVM

Wo Kotlin oberflächliche KI-Tools ins Stolpern bringt

Kotlin ist knapp, weil es Verdrahtung versteckt. apply, let, also, run und with ändern, was this und it bedeuten. Extension Functions hängen Verhalten an Typen, die anderswo definiert sind. Coroutines verschieben Arbeit über launch, async und withContext. Ein Agent, der eine Datei nach der anderen liest, sieht die Aufrufe, aber nicht die Receiver dahinter.

Maguyva löst einen größeren Teil dieser Struktur schon beim Indexieren auf, sodass ein Agent fragen kann, wer eine Funktion aufruft, und die echte Antwort bekommt.

Was Maguyva in Kotlin extrahiert

Maguyva deckt .kt und .kts ab. Funktionen, Klassen, Objekte und Companion Objects werden extrahiert, und Funktionssignaturen erfassen Extension Receiver, Parameternamen, Standardwerte und vararg-Parameter.

Aufrufbeziehungen behalten klassenqualifizierte Namen, sodass OrderRepository.save von einem anderen save unterscheidbar bleibt. Die Receiver-Typisierung folgt this innerhalb von apply und run, it innerhalb von let und also sowie dem Argument von with, damit Aufrufe in Scope Functions auf den richtigen Typ aufgelöst werden. Coroutine-Builder und Flow-Operatoren (launch, async, withContext, coroutineScope, supervisorScope, flow, emit, delay, Channel) bleiben bewusst im Graphen.

Der Graph erfasst außerdem Vererbung, Interface-Implementierung, Overrides, Instanziierung, Annotationen, Typreferenzen, Lese- und Schreibzugriffe sowie Kanten für das Werfen und Fangen von Ausnahmen.

Beispiel-Prompts für Agenten

• „Wer ruft CheckoutUseCase.invoke auf, und aus welchen ViewModels?“ (find_symbol, dann dependency_search incoming)
• „Verfolge den Sync-Ablauf von SyncWorker bis zum Netzwerk-Client.“ (get_task_context)
• „Welche Klassen implementieren PaymentGateway?“ (dependency_search)

Bekannte Grenzen

• Etwa 250 Aufrufe der Kotlin-Standardbibliothek und der Plattform werden aus den Beziehungen gefiltert, daher sind Helfer wie listOf, map, filter und println keine Graphkanten. Verwende dafür text_pattern_search.

Nächste Schritte

Verbinde ein Repository über den Schnellstart und prüfe dann die Unterstützungsmatrix auf der Kompatibilitätsseite. Bei gemischten Codebasen lies auch den Java-Leitfaden.