update

Назначение

Повторно проверить конфигурацию, очистить кэш и перезагрузить все файлы спецификаций. Это полное обновление рабочей области — оно гарантирует, что все кэшированные спецификации актуальны, а индекс перестроен.

Когда использовать

• Удалённые файлы спецификаций изменились, и вы хотите получить последнюю версию
• После редактирования swag2mcp.yaml для добавления или изменения location спецификаций
• При диагностике проблем с устаревшим или повреждённым кэшем
• Перед запуском mcp для обеспечения свежести всех данных

Синтаксис

swag2mcp update [path]

Аргументы

Аргумент	Позиция	Обязательно	Описание
path	1	Нет	Директория рабочей области. Если не указан, разрешается по правилам разрешения пути.

Флаги

Нет.

Как это работает

Команда update выполняет конвейер операций:

1. Загрузка конфига — читает swag2mcp.yaml из рабочей области
2. Проверка — выполняет те же проверки, что и validate (синтаксис YAML, структура, доступность файлов спецификаций, формат, auth, HTTP-клиент)
3. Очистка — удаляет всё содержимое cache/ и responses/
4. Перекэширование — загружает все удалённые файлы спецификаций и копирует локальные файлы в кэш
5. Переиндексация — перестраивает индекс полнотекстового поиска для всех эндпоинтов
6. Скрипты аутентификации — создаёт скрипты-заглушки для спецификаций, использующих ScriptAuth
7. Очистка осиротевших скриптов — удаляет скрипты аутентификации для спецификаций, которые больше не существуют

swag2mcp update
swag2mcp update ./my-workspace

Что происходит с отключёнными коллекциями

Коллекции с disable: true полностью пропускаются — они не кэшируются и не индексируются.

Проверка после команды

swag2mcp ls [path]
# Все спецификации должны по-прежнему отображаться и быть доступными

Нюансы

• Нет автоинициализации: Если файл конфигурации не существует, update возвращает ошибку: "configuration not found at <path>". Сначала выполните init.
• Сетевая зависимость: Все удалённые URL спецификаций должны быть доступны. Если какая-либо загрузка не удалась, весь update завершается ошибкой с понятным сообщением.
• Создание скриптов аутентификации: Если спецификация использует ScriptAuth и скрипт-заглушка не существует, update создаёт его. Если создание не удалось, update завершается ошибкой.
• update vs clean: clean только удаляет кэш. update удаляет кэш и перезагружает всё. Используйте clean, когда нужно просто освободить место; используйте update, когда нужно обновить данные.