Как проверить зависимости сайта после вайбкодинга?

Как проверить зависимости сайта после вайбкодинга?

Чтобы проверить зависимости сайта после вайбкодинга, сохраните рабочую версию, составьте список пакетов и запустите проверку известных уязвимостей. Затем выясните, какие библиотеки нужны проекту, удалите лишние и обновляйте остальные небольшими группами на копии сайта. После каждого изменения проверяйте сборку и действия посетителя. Ниже разберём порядок работы на примере проекта с JavaScript и npm: что поручить ИИ-агенту, какие результаты проверить вручную и как подготовить откат, если обновление сломает сайт.

Что проверять в зависимостях и с чего начать?

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

Риски чужих зависимостей рассматриваются отдельно от утечки ключей и лишних прав агента: это разные задачи проверки (источник: «Безопасность вайбкодинга: ключи, права и откат»). Для пакетов полезно разделить работу на поиск известных уязвимостей, проверку необходимости и оценку последствий обновления.

Начните с рабочей копии проекта и сохраните текущее состояние в системе контроля версий. Зафиксируйте также версию среды выполнения и команду сборки. Если сайт уже работает, запишите короткий маршрут проверки: открыть каталог, перейти в карточку, отправить тестовую заявку. После изменений вы повторите тот же маршрут.

  • Найдите файл со списком зависимостей. В проекте на npm это package.json.
  • Найдите lock-файл, который фиксирует конкретные версии пакетов. Для npm это package-lock.json.
  • Проверьте, какой менеджер пакетов использует проект. Не переключайтесь между npm и другими инструментами без отдельной причины.
  • Сохраните исходный результат сборки и тестов, чтобы отличать старые ошибки от новых.

Дайте агенту ограниченное задание: «Изучи зависимости и подготовь отчёт. Не устанавливай пакеты, не меняй файлы и не запускай исправления. Для каждого замечания укажи пакет, причину проверки и место его использования». Даже режим анализа требует контроля: настройки разрешений агента должны соответствовать этому заданию.

Как найти уязвимости и понять отчёт сканера?

В проекте на npm для начальной проверки используют команду npm audit. Она сопоставляет сведения о зависимостях с базой известных уязвимостей. Перед запуском проверьте, что команда работает в нужной папке и использует реестр пакетов, который предусмотрен проектом. Не передавайте агенту рабочие ключи ради такой проверки.

Отчёт сканера — начало разбора. Отсутствие предупреждений не доказывает безопасность сайта, а найденная уязвимость ещё требует оценки: затронута ли установленная версия, как пакет попал в проект и выполняются ли условия атаки.

  • Запишите название пакета и диапазон версий, к которым относится предупреждение.
  • Выясните, указан ли пакет прямо в проекте или приходит через другую библиотеку. Для npm цепочку помогает посмотреть команда npm explain с названием пакета.
  • Прочитайте описание проблемы: какой компонент затронут и что нужно для её использования.
  • Проверьте, существует ли исправление и требует ли оно перехода на несовместимую версию.
  • Зафиксируйте решение: обновить, заменить, удалить либо отложить с объяснением и условием повторной проверки.

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

Попросите агента приводить основание для каждого вывода. Формулировка «этот пакет безопасен, потому что напрямую не используется» недостаточна: он может работать через другую библиотеку. Для более широкого разбора этапов пригодится проверка зависимостей перед запуском сайта.

Как удалить лишние пакеты без поломки сайта?

После работы ИИ-агента в проекте могут остаться библиотеки от отвергнутого варианта решения. Например, агент добавил инструмент для формы, затем переписал её, но запись в зависимостях сохранил. Это повод проверить пакет, а не сразу удалять его.

Поиск по исходному коду помогает найти прямые обращения к библиотеке. Однако пакет также может подключаться в настройках сборки, командах запуска или через механизм плагинов. Удаляйте его только после проверки этих мест.

  1. Попросите агента перечислить кандидатов на удаление и показать, где он искал их использование.
  2. Проверьте конфигурационные файлы, команды в package.json и динамические подключения.
  3. Удалите один кандидат штатной командой менеджера пакетов на рабочей копии.
  4. Запустите сборку, тесты и ручной маршрут проверки сайта.
  5. Просмотрите изменения в списке зависимостей и lock-файле, затем сохраните результат отдельно.

Если после удаления перестал открываться календарь или исчезла обработка формы, верните изменение и выясните связь. Не поручайте агенту одновременно удалить библиотеку и переписать функцию: так труднее понять причину сбоя.

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

Как обновлять зависимости и подготовить откат?

Начинайте с исправлений, для которых понятны причина и порядок проверки. Прочитайте примечания к выпуску: даже небольшое изменение версии требует теста. Массовое обновление затрудняет поиск виновника, если после него сайт перестанет собираться.

Команда npm audit fix --force не подходит для автоматического первого шага. Она допускает изменения за пределами текущих ограничений версий, включая переходы, которые нарушают совместимость. Если агент предлагает её запустить, сначала попросите список ожидаемых изменений и план проверки каждого затронутого компонента.

  • Обновляйте отдельный пакет или связанную группу, если библиотеки требуют согласованных версий.
  • Сохраняйте изменения исходного кода и lock-файла вместе, когда они относятся к одному обновлению.
  • После обновления повторяйте аудит, сборку и проверку рабочих сценариев.
  • Перед публикацией проверьте чистую установку зависимостей по lock-файлу. В проекте на npm для этого обычно используют npm ci.
  • Подготовьте возврат к предыдущему выпуску: нужны совместимые исходники, зависимости и настройки запуска.

Успешная сборка не проверяет все действия посетителя. Если обновление затронуло обмен с сервером, отдельно проверьте API сайта после вайбкодинга. Изменения библиотек интерфейса стоит дополнить проверкой мобильной версии: откройте меню, форму и всплывающие окна на узком экране.

Для передачи работы разработчику подготовьте короткое задание: проверить цепочки зависимостей, разобрать предупреждения, предложить изменения и подтвердить их тестами. Результатом такой проверки должен быть список решений с причинами, журнал изменений и инструкция по откату. Скриншота с отсутствием предупреждений для приёмки недостаточно.

Типичные ошибки при проверке зависимостей

  • Обновлять пакеты сразу на рабочем сайте. Начните с копии, где сбой не прервёт приём заявок.
  • Удалять lock-файл ради исчезновения ошибки. Сначала выясните причину: новый набор версий изменит условия проверки.
  • Принимать вывод агента без подтверждений. Запрашивайте команды, результаты и объяснение каждого изменения.
  • Считать пакет лишним только потому, что поиск не нашёл его название в исходниках. Проверьте конфигурацию и команды запуска.
  • Разрешать агенту бесконтрольно устанавливать инструменты для аудита. Согласуйте их список и права до запуска.
  • Заканчивать работу на успешной сборке. Повторите действия посетителя и проверьте ошибки в браузере и на сервере.

Начните с сохранения рабочей версии и отчёта без автоматических исправлений. Затем выберите одно понятное изменение, проверьте его на копии и зафиксируйте результат. Перед публикацией у вас должны быть воспроизводимая сборка, проверенные сценарии сайта и готовый способ вернуться к предыдущему выпуску.