Откат работы агента

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

Предпосылки

Перед работой агента был сделан снапшот — snapshot_write с операцией create. Снапшотов по умолчанию Кванта не делает.
Правки в открытых редакторах EDT сохранены.

Шаги

1. Найти снапшот

snapshot_read

{ "operation": "list", "filter": "до отчёта" }

Список снапшотов с метками, датами и числом изменённых файлов; filter ищет по метке. Идентификатор нужного снапшота — из этого списка.

2. Что изменилось — по объектам

snapshot_read

{ "operation": "diff_semantic", "snapshot_id": "<идентификатор>" }

Изменения языком метаданных: реквизиты и их типы, элементы и обработчики форм, права ролей. Сузить до файлов — paths, например ["**/Forms/**"].

3. Что изменилось — построчно

snapshot_read

{ "operation": "diff", "snapshot_id": "<идентификатор>" }

Обычный diff, по умолчанию — с текущим состоянием; against сравнивает с другим снапшотом.

4а. Откатить всё

snapshot_action

{ "operation": "restore", "snapshot_id": "<идентификатор>" }

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

"skip_changed": true — вернуть только безопасные файлы, конфликтные оставить;
"force": true — перезаписать всё; ручные правки останутся в страховочном снапшоте.

4б. Вернуть один файл

snapshot_action

{
  "operation": "revert_file",
  "snapshot_id": "<идентификатор>",
  "path": "УТ2020/src/Catalogs/Контрагенты/Forms/ФормаЭлемента/Form.form"
}

Путь — от папки рабочей области: <проект>/src/…. Страховочный снапшот здесь не делается, конфликт возвращается агенту как есть.

5. История файла

snapshot_read

{ "operation": "history", "path": "УТ2020/src/Catalogs/Контрагенты/Forms/ФормаЭлемента/Form.form" }

Все снапшоты, в которых менялся файл, — помогает найти последнюю хорошую версию.

Проверка

snapshot_read с операцией diff и идентификатором снапшота после отката показывает пустую разницу по откатанным файлам.
Инструменты чтения — metadata_read, form_read — показывают прежнее состояние объектов.

Откат отката

Страховочный снапшот с меткой auto: before restore … лежит в списке. Откат к нему возвращает состояние до шага 4.

Без агента

То же доступно человеку во вью Window → Show View → Кванта (Quanta) → Снапшоты Кванты: список снапшотов, файлы, сравнение двойным кликом, семантический diff и откат. Подробно о механике — Снапшоты.