Perl в Maguyva: графы пакетов и подпрограмм

Почему наследие на Perl трудно безопасно менять

Код на Perl плотный, гибкий и часто написан людьми, ушедшими много лет назад. Сигилы меняют смысл имени, пакеты одновременно служат классами, а один и тот же модуль загружают скрипты из многих каталогов. Текстовый поиск находит строки, но не говорит агенту, какую подпрограмму скрипт вызывает на самом деле.

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

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

Maguyva охватывает .pl, .pm, .t, .pod и .perl. Подпрограммы извлекаются как функции, объявления package — как классы, а из имён определений удаляются сигилы ($, @, %, &, *), поэтому переменные и подпрограммы ищутся по голому имени.

Импорты строятся из операторов use, require и package. Вызовы методов вида Class->new считаются созданием экземпляров, а bless и tie намеренно остаются в графе вызовов. Граф также фиксирует наследование, переопределения, ссылки на типы, чтения и записи, а также возбуждение исключений.

Около 189 встроенных функций (print, open, die, warn и подобные) отфильтровываются из связей вызовов, чтобы код репозитория был на виду.

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

• «Какие скрипты используют Billing::Invoice и какие его подпрограммы вызывают?» (dependency_search incoming)
• «Где создаётся Report::Monthly и что происходит после ->new?» (find_symbol, затем get_task_context)
• «Найди все тестовые файлы, которые проверяют Auth::Session.» (text_pattern_search, затем find_symbol)

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

• Классические методы Perl — это обычные объявления sub внутри пакета, поэтому в структурном поиске методом считается только новый специальный синтаксис method. Для старого объектно-ориентированного Perl используйте пресет functions.
• Вызовы отфильтрованных встроенных функций не появляются как рёбра графа. Если нужен каждый вызов open или print, используйте text_pattern_search.

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

Подключите репозиторий по быстрому старту, затем изучите матрицу поддержки на странице совместимости. Если наследие переезжает на другой скриптовый язык, сравните с руководством по языку Python.