R у Maguyva: графи коду для аналітики й пакетів

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

R розміщує базові функції, функції пакетів і ваші функції в одному пласкому просторі імен. Крапки є частиною імені, а не доступом до члена: is.na, data.frame і print.summary_table є цілісними ідентифікаторами. Інструмент, що читає print.summary_table як метод у print, неправильно розуміє структуру, а інструмент, що записує кожен базовий виклик, ховає ваші функції під c() і paste().

Maguyva зберігає імена R цілими й відфільтровує шум базових функцій, щоб агент бачив функції, від яких справді залежить ваш аналіз.

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

Maguyva зіставляє файли .R, .Rmd і .Rnw з R. Функції, присвоєні імені, як-от clean_survey <- function(df), витягуються під цим ім’ям; анонімні функції не вважаються визначеннями. Імена з крапками ніколи не розбиваються на отримувача й член.

Деякі базові виклики R навмисно лишено в графі, бо вони показують, як пов’язаний аналітичний код: диспетчеризація S3 і S4 (UseMethod, standardGeneric), сімейство apply (lapply, sapply, vapply, mapply), підгонка моделей (lm, predict, anova), завантаження пакетів (library, require) та обробка помилок через tryCatch.

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

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

• «Хто викликає clean_survey і які моделі використовують її результат?» (find_symbol, потім dependency_search за вхідними зв’язками)
• «Які функції викликають fit_model?» (dependency_search)
• «Простеж шлях від load_raw_data до підсумкової регресії.» (get_task_context)

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

• Близько 800 імен із базового R, stats і graphics відфільтровано зі зв’язків, наприклад print, paste, c, data.frame, виклики побудови графіків і генератори випадкових чисел. Для них використовуйте text_pattern_search.
• R створює класи й завантажує пакети звичайними викликами функцій, тому пресети classes, imports і variables у structural_search нічого не вибирають. Використовуйте find_symbol і text_pattern_search.
• Файли .Rmd і .Rnw читаються повністю граматикою R, а не за фрагментами; для документів R Markdown і Sweave результати можуть бути неповними.
• У R немає синтаксису декораторів, тому зв’язки декораторів позначено як незастосовні.

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

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