Жизненный цикл документа

Семь шагов от передачи DOCX хостом до cold reopen, а также основные объекты API: Session, Command, ResultEnvelope, Event, CapabilityProfile, Artifact.

Интеграция строится вокруг сессии, команд, revision и событий — не вокруг прямого доступа к внутреннему DOM редактора.

Host получает документ. Система партнёра проверяет пользователя и передаёт разрешённые DOCX bytes либо безопасный локальный путь.
A4 открывает session. Rust разбирает пакет, формирует canonical model, capability profile и начальную revision.
Web показывает документ. Пользователь видит страницы и доступные команды. Host получает ready.
Приходит intent. Команда содержит тип операции, stable target и expectedRevision; shell не патчит XML самостоятельно.
Rust применяет или отклоняет. Успех создаёт новую revision и dirty state. Отказ не оставляет частично изменённый документ.
Host сохраняет результат. Rust выполняет writeback; A4 отдаёт DOCX, а host создаёт версию и запись аудита.
Cold reopen подтверждает. Сохранённый файл открывается заново; это доказывает persistence, а не только изменение на экране.

Основные объекты API

Объект	Назначение
Session	Изолированный жизненный цикл открытого документа.
Command / Intent	Типизированное действие с target и expectedRevision.
ResultEnvelope	Успех, warnings, typed refusal, diagnostics и correlation id.
Event	Ready, dirty, saved, error и изменения состояния.
CapabilityProfile	Честный перечень доступных команд и ограничений.
Artifact	DOCX bytes, checkpoint или диагностика, которыми владеет host.