Обновления: сначала starter, затем пакет
Понятный путь установки и сопровождения.
Начните с публичного шаблона. Совместимые обновления пакета устанавливаются через npm update @anglefeint/astro-theme, затем npm run doctor.
npm update соблюдает диапазон package.json: ^0.5.1 не включает 0.6.0. Читайте заметки и при необходимости устанавливайте конкретную версию вместо слепого @latest. npm ls @anglefeint/astro-theme astro показывает установленные версии.
Пакет не обновляет локальные настройки, маршруты, адаптеры и интеграции starter. При структурных изменениях создайте новый starter в другой папке и перенесите контент и личные настройки. Не заменяйте новые вспомогательные файлы старыми.
doctor уже включает проверки и сборку. Затем используйте npm run preview. Запускайте npm run sync-adapters только при расхождении созданных адаптеров с локальными шаблонами: новые шаблоны он не скачивает. В старых проектах команды могут отличаться.
При переходе на новую основную версию Astro сначала следуйте официальной миграции. Подробности — в руководстве по обновлению.