Dependency snapshots

Как brt связывает зависимости с target и восстанавливает generated state.

brt генерирует локальный snapshot интеграций и плагинов выбранного target. Обычно этот каталог не требует ручного вмешательства.

Источники данных

Источник	Содержимое
Git	`agent.config.ts`, `src/` и другие входы сборки.
Платформа	Установленные интеграции и plugins конкретного бота.
`.adk/dependencies/`	Локальное отражение платформы для генерации.

Платформа остаётся источником правды. Каждый brt dev и brt deploy --adk обновляет snapshot до сборки.

Привязка к target

Snapshot принадлежит точной комбинации:

environment + workspaceId + botId

Dev и production используют разные файлы. Snapshot другого бота или воркспейса не применяется как fallback.

Не копируйте .adk/ между проектами и машинами. CLI восстановит каталог из проверенного target.

Install и register

brt integrations install и brt integrations register меняют состояние на платформе.

С --dev запущенный watcher обновляет dev-сборку автоматически.
Без --dev выполните brt deploy --adk после изменения интеграции.

Изменение snapshot само по себе не загружает production bundle.

Read-only проверка dev

brt dev --check
brt dev --check --json

Команда проверяет уже подготовленный dev target. Она сравнивает link, snapshot, generated packages и состояние платформы.

Платформа также возвращает версионированный контракт runtime-возможностей: devReadiness.runtimeContract. В нём указаны уровни протоколов для eval manifest, table fixtures, dev-target routing и traces. CLI проверяет их, а не считает эти возможности готовыми по умолчанию. Несовместимый или отсутствующий контракт диагностируется отдельно от состояния интеграций. Новое поле дополняет readiness schema v1, поэтому старые версии CLI игнорируют его при server-first rollout.

dev --check не создаёт бота и не исправляет расхождения. На новом проекте сначала запустите обычный brt dev.

Повторная загрузка артефакта

brt deploy --adk --noBuild

Этот режим повторно загружает существующий bundle. Рядом должен находиться provenance sidecar с координатами target и SHA-256 файла.

Используйте обычный deploy после изменения исходников, конфигурации сборки или зависимостей. Provenance подтверждает артефакт и target, но не свежесть кода.

Восстановление

Ошибка	Действие
Snapshot отсутствует	Повторите `brt dev` или `brt deploy --adk` для нужного target.
Интеграция имеет `pending` или `failed`	Исправьте config, повторите `register`, затем повторите основную команду.
Generated packages расходятся	Перезапустите `brt dev`; не редактируйте `.adk/` вручную.
`--noBuild` отклоняет provenance	Выполните обычный deploy и используйте новый bundle с sidecar.
Профиль не совпадает с link	Выберите правильный профиль или выполните явный `brt link`.

Если ошибка повторяется, сохраните безопасный текст ошибки и вывод brt dev --check --json. Не прикладывайте токены и содержимое config.