Синхронизация

Предпросмотр, push, merge и pull приватного потока аккаунта.

Синхронизация

Sync перемещает локальные ревизии паспортов в и из приватного потока учётной записи. Это не публичный каталог, не Git и не установка. Предпросмотр никогда не изменяет head. Push, merge и pull — явные, безопасные для повторного воспроизведения записи.

Повседневный sync — intent account. Движок спрашивает, прежде чем загружать. Не набирайте sync push, чтобы форсировать upload.

ai-stp task start --intent account --idempotency-key account-session-01 --json

Expert preview / push / merge / pull ниже — для операторов, у которых уже есть id ревизии.

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

Таблица команд

--json — глобальный флаг. Всегда передавайте его. Push, merge и pull требуют --confirm.

Preview

ai-stp sync preview --id <stable_id> --json

--id — стабильный идентификатор, чьи локальные head сравниваются.

Поля успеха: stable_id, state, head_revision_ids, common_ancestor_revision_id, candidate_revision_id, server_head_revision_id, affected_fields.

state — это следующий механический ход:

Preview не пушит. Конфликт — это честный отчёт, а не сбой. Один локальный head плюс отклонённый push, который указывает head сервера, которого нет на этом устройстве, — это тоже conflict, а не up_to_date.

Push

ai-stp sync push --id <stable_id> --confirm --json

--id и --confirm обязательны. Событие устойчиво и безопасно для воспроизведения: второй push того же head не создаёт второй эффект.

Поля успеха: stable_id, state, processed_events, event_id, local_revision_id, remote_revision_id, server_head_revision_id, conflicting_entity_id, conflict_fields.

Если state сообщает конфликт, остановитесь и выполните preview снова. Не пушьте в цикле.

Merge

ai-stp sync merge --id <stable_id> --confirm --json

--id и --confirm обязательны. Merge фиксирует механически чистый мёрж двух head разработческих паспортов. Он не изобретает значения полей. Если preview был conflict или manual_resolution, merge отклоняется.

Ответ — это предпросмотр результирующих head: та же схема, что и у sync preview. Запушьте после, если новый head должен покинуть это устройство.

Pull

ai-stp sync pull --confirm --json
ai-stp sync pull --page-size 20 --confirm --json
ai-stp sync pull --skip-event <event_id> --confirm --json

--confirm обязателен. --page-size — максимальное количество событий на этой странице. --skip-event повторяем: каждое значение — это точный id отклонённого события, через которое нужно пройти, отбрасывая его ревизию. Пропуск запоминается этим устройством, поэтому последующий pull проходит мимо него без запроса.

Поля успеха: received, applied, replayed, next_cursor, skipped. Выполняйте pull, пока next_cursor не станет пустым, если намерены опустошить поток. Каждая страница атомарна.

Счастливый путь

task start --intent account --idempotency-key account-session-01 --json
→ follow continuations until there are none

Expert (уже есть id ревизии):

auth status
→ sync preview --id <stable_id>
→ sync pull --confirm          # если поток впереди
→ sync merge --confirm         # только когда preview говорит merge
→ sync push --id <stable_id> --confirm
→ sync preview --id <stable_id>

Читайте preview после каждой записи. Не пушьте и не pull'ите в одном действии, не прочитав state.

Именованные поля успеха

Отказы

Не помещайте токены потока в командную строку. Не принимайте sync за бэкап таргета харнеса. Копии таргета живут у провайдера; см. Target.

Связанные ссылки

• Вход
• Паспорта
• Устройство
• Объекты владельца
• Карта команд

Флаги берутся из continuation argv

ai-stp task intents --json

Не дампьте help --agent как прелюдию. Флаги текущей задачи — в continuation argv.

Эта страница группирует команды синхронизации, чтобы человек мог их найти. Если эта страница и CLI расходятся, следуйте CLI.