Kotlin в Maguyva: графы кода для Android и JVM

Где Kotlin сбивает с толку поверхностные ИИ-инструменты

Kotlin лаконичен, потому что прячет связи. apply, let, also, run и with меняют смысл this и it. Функции-расширения добавляют поведение типам, определённым в другом месте. Корутины переносят работу между launch, async и withContext. Агент, читающий по одному файлу, видит вызовы, но не получателей за ними.

Maguyva разрешает больше такой структуры ещё при индексации, поэтому агент может спросить, кто вызывает функцию, и получить настоящий ответ.

Что Maguyva извлекает из Kotlin

Maguyva охватывает .kt и .kts. Извлекаются функции, классы, объекты и объекты-компаньоны, а сигнатуры функций фиксируют получателей расширений, имена параметров, значения по умолчанию и параметры vararg.

Связи вызовов сохраняют имена с квалификацией классом, поэтому OrderRepository.save отличается от любого другого save. Типизация получателей отслеживает this внутри apply и run, it внутри let и also, а также аргумент with, так что вызовы внутри функций области видимости разрешаются в правильный тип. Билдеры корутин и операторы Flow (launch, async, withContext, coroutineScope, supervisorScope, flow, emit, delay, Channel) намеренно остаются в графе.

Граф также фиксирует наследование, реализацию интерфейсов, переопределения, создание экземпляров, аннотации, ссылки на типы, чтения и записи, а также рёбра выброса и перехвата исключений.

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

• «Кто вызывает CheckoutUseCase.invoke и из каких ViewModel?» (find_symbol, затем dependency_search incoming)
• «Проследи поток синхронизации от SyncWorker до сетевого клиента.» (get_task_context)
• «Какие классы реализуют PaymentGateway?» (dependency_search)

Известные ограничения

• Около 250 вызовов стандартной библиотеки Kotlin и платформы отфильтровываются из связей, поэтому вспомогательные функции вроде listOf, map, filter и println не становятся рёбрами графа. Для них используйте text_pattern_search.

Следующие шаги

Подключите репозиторий по быстрому старту, затем изучите матрицу поддержки на странице совместимости. Для смешанных кодовых баз прочитайте и руководство по Java.