vimp-engine 0.35.6 → 0.37.0

package/src/config/lobby.js

@@ -5,6 +5,39 @@ export default {
   // REST-эндпоинт мастера со списком серверов (GET /servers)
   serversUrl: '/servers',
 
+  // комната по прямому id (GET /rooms/:roomId, host-migration этап 3):
+  // прямая ссылка #/<gameId>/<roomId> проверяется до входа
+  roomUrl: roomId => `/rooms/${encodeURIComponent(roomId)}`,
+
+  // быстрая игра (GET /quickplay/:gameId, ревью F16): лучшая комната игры
+  // от мастера вместо всего списка; недоступен — GET /servers?search
+  quickPlayUrl: gameId => `/quickplay/${encodeURIComponent(gameId)}`,
+
+  // быстрая игра по ссылке #/<gameId>: подходящей комнаты нет — создать
+  // свою с настройками формы по умолчанию (false — показать лобби этой игры);
+  // createDelayMinMs…createDelayMaxMs — случайная пауза перед созданием и
+  // повторный GET /servers (host-migration этап 7): гости закрытой комнаты
+  // уходят в быструю игру разом, и без паузы каждый создал бы свою
+  quickPlay: {
+    autoCreate: true,
+    createDelayMinMs: 500,
+    createDelayMaxMs: 2000,
+  },
+
+  // меню комнаты внутри матча (только лобби-режим, roomMenu.pug)
+  roomMenu: {
+    elems: {
+      // кнопка меню живёт в панели, справа от таблицы
+      panelId: 'panel',
+      menuId: 'room-menu',
+      toggleId: 'room-menu-toggle',
+      listId: 'room-menu-list',
+      leaveId: 'room-menu-leave',
+      handoverId: 'room-menu-handover',
+      statusId: 'room-menu-status',
+    },
+  },
+
   // каталог игр мастера (Этап 6.3, GameCatalog): roomDefaults формы создания
   // комнаты и ClientPlugin берутся отсюда вместо статической композиции
   gamesManifestUrl: '/games/manifest.json',
@@ -31,6 +64,10 @@ export default {
   // (деплой игры мог обновиться независимо от деплоя движка)
   game: {
     manifestUrl: gameId => `/games/${gameId}/manifest.json`,
+    // манифест конкретной версии: прогрев преемника (host-migration этап 6)
+    // поднимает ту версию игры, что крутится в комнате
+    versionManifestUrl: (gameId, version) =>
+      `/games/${gameId}/${encodeURIComponent(version)}/manifest.json`,
   },
 
   // манифест worker-бандла мастера (Этап 5.2): Worker комнаты создаётся по
@@ -141,6 +178,123 @@ export default {
     maxDelay: 30000,
   },
 
+  // установка P2P-соединения с хостом (host-migration этап 4): каналы не
+  // открылись за connectTimeoutMs — попытка считается провалившейся;
+  // offerRetryMs — пауза перед повтором оффера, отклонённого мастером на
+  // время плановой передачи хоста (error migrating, этап 8)
+  webrtc: {
+    connectTimeoutMs: 10000,
+    offerRetryMs: 1000,
+  },
+
+  // миграция хоста (host-migration этап 6; значения — замеры этапа 0):
+  // checkpointIntervalMs — период контрольных точек хоста для беты (поток
+  // ≤ ~150 КБ/с, serialize ≤ 25 % бюджета тика); standbyChunkBytes — кусок
+  // точки в канале standby (≤ минимального maxMessageSize с запасом);
+  // standbyHighWaterBytes — bufferedAmount, выше которого периодическая
+  // точка пропускается; standbyStatusIntervalMs — как часто бета сообщает
+  // мастеру свою последнюю точку (с её возрастом); maxRestoreAgeMs — точку,
+  // полученную раньше, преемник не поднимает (promote_failed → холодный
+  // старт; больше master:room:checkpointMaxAgeMs на дорогу статуса);
+  // standbyReopenDelayMs…standbyReopenMaxDelayMs — экспоненциальная пауза
+  // перед повторным открытием канала standby, закрывшегося при живом пире
+  // беты; finalWaitMs — сколько бета при плановой
+  // передаче (этап 8) ждёт финальную точку замороженного хоста, прежде чем
+  // взять последнюю периодическую; handoffSlowMs — нет handoff_go за это
+  // время — «медленная связь» (передача продолжается); handoffDeadlineMs —
+  // общий дедлайн плановой передачи от handoff_begin (master:room:
+  // handoffTimeoutMs + запас на дорогу ответа мастера); deferMaxMs — потолок
+  // ожидания границы раунда передачей в игре без migration.midRound (этап 8d);
+  // peersReportIntervalMs — период повтора room_peers хоста мастеру (кто
+  // подключён по WebRTC; при смене состава отчёт уходит сразу, с дебаунсом);
+  // minTokenLifetimeMs — вкладка, чей вход истечёт раньше, не объявляет
+  // canHost и отказывается от промоушена (токен предъявляется мастеру
+  // посреди матча, продления нет); tokenHandoffLeadMs — за столько до
+  // истечения входа хост с бетой сам передаёт роль (плановая передача на
+  // границе раунда); tokenHandoffRetryMs — через сколько повторить её, если
+  // беты ещё нет, идёт эстафета Worker'ов или передача сорвалась (повторы —
+  // до истечения входа); leaveFlushTimeoutMs — сколько «Leave
+  // server» хоста без людей ждёт записи очков участников перед закрытием
+  // комнаты (HostController.shutdown)
+  migration: {
+    checkpointIntervalMs: 500,
+    standbyChunkBytes: 65536,
+    standbyHighWaterBytes: 1024 * 1024,
+    standbyStatusIntervalMs: 5000,
+    maxRestoreAgeMs: 15000,
+    standbyReopenDelayMs: 1000,
+    standbyReopenMaxDelayMs: 10000,
+    finalWaitMs: 3000,
+    handoffSlowMs: 3000,
+    handoffDeadlineMs: 10000,
+    deferMaxMs: 30000,
+    peersReportIntervalMs: 15000,
+    minTokenLifetimeMs: 600000,
+    tokenHandoffLeadMs: 300000,
+    tokenHandoffRetryMs: 5000,
+    leaveFlushTimeoutMs: 3000,
+
+    // автотриггеры передачи (этап 9b, HostHealthPolicy; сэмпл — сообщение
+    // health Worker'а раз в ~1 с): мягкая перегрузка — среднее tickRate за
+    // overloadWindowMs ниже overloadTickRate (передача ждёт границы раунда);
+    // жёсткая — среднее за criticalWindowMs ниже criticalTickRate или
+    // lostMs > 0 у lostWindows сэмплов подряд (сразу); отложенная
+    // отменяется, когда все сэмплы за recoverWindowMs выше recoverTickRate
+    // (гистерезис); hiddenHandoffMs — скрытая вкладка хоста (этап 0:
+    // троттлинг Worker'а за 1–3 с); autoHandoffCooldownMs — между
+    // авто-передачами вкладки; minHostTenureMs — не отдавать роль, только
+    // что её получив; enabled — общий выключатель
+    auto: {
+      enabled: true,
+      overloadTickRate: 100,
+      overloadWindowMs: 5000,
+      criticalTickRate: 60,
+      criticalWindowMs: 3000,
+      lostWindows: 3,
+      recoverTickRate: 110,
+      recoverWindowMs: 5000,
+      hiddenHandoffMs: 1500,
+      autoHandoffCooldownMs: 90000,
+      minHostTenureMs: 30000,
+      // этап 9c: host_health мастеру (правило сетевого лага) не чаще
+      // hostHealthIntervalMs; гость шлёт свой FPS рендера (caps.fps) раз в
+      // fpsReportIntervalMs. Просьбу мастера request_handoff хост
+      // выполняет, только если enabled
+      hostHealthIntervalMs: 2000,
+      fpsReportIntervalMs: 10000,
+    },
+  },
+
+  // супервизор сессии гостя (host-migration этап 4, SessionSupervisor):
+  // reconnectWindowMs — сколько после обрыва транспорта пытаться вернуться в
+  // матч (повторы с бэкоффом reconnectBaseDelayMs…reconnectMaxDelayMs);
+  // hostSilenceMs — молчание хоста в игре, после которого транспорт
+  // считается мёртвым (кадры идут ~30/с, PING — раз в 3 с);
+  // migrationWaitMs — сколько после host_migrating ждать host_changed, затем
+  // комната считается закрытой (быструю игру); migrationPollMs — период
+  // повторного GET /rooms/:roomId, пока комната по ссылке в 'migrating';
+  // host_migrating.waitMs мастера (сколько он ещё ищет преемника) ожидание
+  // продлевает, но не укорачивает; linkWaitMaxMs — крайний срок ожидания
+  // комнаты по ссылке, пока она меняет хоста; resumeSilenceGraceMs — фора
+  // сторожку тишины после возобновления до первого кадра: восстановленный
+  // матч стоит до hostDefaults.resumeWaitMs, ожидая остальных. Связки с
+  // таймингами мастера и Worker'а — tests/config/migrationTimings.test.js;
+  // joinRetryWindowMs — сколько гость повторяет join_room на unknownRoom
+  // после рестарта мастера, пока хост не вернёт комнату reclaim_host (больше
+  // reconnect.maxDelay — бэкоффа сигналинга хоста — с запасом на его
+  // reclaim_host)
+  session: {
+    reconnectWindowMs: 15000,
+    reconnectBaseDelayMs: 500,
+    reconnectMaxDelayMs: 4000,
+    hostSilenceMs: 3000,
+    migrationWaitMs: 40000,
+    migrationPollMs: 1000,
+    linkWaitMaxMs: 90000,
+    resumeSilenceGraceMs: 3000,
+    joinRetryWindowMs: 45000,
+  },
+
   // приёмник выгрузок отладочного контура (этап 6 плана plan/done/ai-debug):
   // маршрут поднимается мастером только в dev, в проде вернёт 404
   debugReportUrl: '/debug/report',
@@ -163,7 +317,6 @@ export default {
     searchId: 'lobby-search',
     moreId: 'lobby-more',
     emptyId: 'lobby-empty',
-    nameId: 'lobby-name',
     hostBtnId: 'lobby-host',
     // строка отказа под кнопкой: загрузка ClientPlugin выбранной игры может
     // не удаться, и лобби обязано остаться рабочим
@@ -327,8 +480,6 @@ export default {
   // раунда-карты/огонь по своим/карта по умолчанию — из roomDefaults
   // манифеста активной игры (Этап 6.3), не бандлятся здесь
   create: {
-    defaultName: 'My Server',
-
     // каталог платформы пуст: реестр ещё ничего не одобрил либо модератор
     // снял с раздачи последнюю игру. Комнату создавать не на чем, но лобби
     // живо — и текст называет то единственное, что выводит его из этого

package/src/config/master.js

@@ -2,7 +2,14 @@ import path from 'path';
 import { fileURLToPath } from 'url';
 
 // корень репозитория — якорь от расположения файла, не от cwd
-const rootDir = path.resolve(fileURLToPath(import.meta.url), '..', '..', '..', '..', '..');
+const rootDir = path.resolve(
+  fileURLToPath(import.meta.url),
+  '..',
+  '..',
+  '..',
+  '..',
+  '..',
+);
 
 export default {
   name: 'VIMP Master Server',
@@ -66,14 +73,106 @@ export default {
 
   // ограничения регистрируемых комнат
   host: {
-    maxNameLength: 30, // длина имени комнаты
     // санитарная рамка вместимости комнаты для случая, когда игра комнаты
     // неизвестна мастеру (gameId: null у старых хостов или id не из
     // каталога). Потолок известной игры задаёт её манифест
     // (roomDefaults.maxPlayers) — движок его не ограничивает
     maxPlayersLimit: 8,
-    heartbeatTimeout: 30000, // нет heartbeat дольше — комната удаляется
-    sweepInterval: 10000, // период проверки протухших комнат
+    heartbeatTimeout: 30000, // нет heartbeat дольше — хост потерян
+    sweepInterval: 10000, // период уборки реестра комнат
+  },
+
+  // жизнь комнаты (host-migration, этап 2): комната живёт, пока в ней есть
+  // участник
+  room: {
+    // отсоединённый участник ещё считается в комнате (реконнект сигналинга)
+    memberGraceMs: 15000,
+    // обрыв WS хоста запускает миграцию сразу (reclaim_host до регистрации
+    // преемника её отменяет, этап 7.0); если повысить некого — комната
+    // ждёт reclaim_host столько, потом уборка мигрирует или закрывает её
+    hostReclaimGraceMs: 10000,
+    // потолок строки карточки комнаты в лобби (gameConfig.lobbyInfo игры)
+    maxInfoLength: 48,
+    // RTT участников (host-migration этап 6): ws.ping() каждой сессии с
+    // этим периодом; EMA RTT и джиттера — единая линейка связности для
+    // хоста и кандидатов
+    rttProbeIntervalMs: 5000,
+    // сессия без pong дольше — terminate(): «тихо умерший» хост находится
+    // быстрее, чем по heartbeatTimeout
+    wsDeadAfterMs: 12000,
+    // преемник (бета): кандидат должен пробыть в комнате не меньше этого
+    minMemberAgeMs: 10000,
+    // плановый пересчёт преемника (помимо join/leave/member_update)
+    successorReviewMs: 15000,
+    // гистерезис смены беты: лучший кандидат держит score не хуже
+    // successorSwitchRatio × score текущего дольше successorSwitchSustainMs
+    successorSwitchSustainMs: 30000,
+    successorSwitchRatio: 0.65,
+    // аварийная миграция (этап 7): бета — преемник с точкой, если она
+    // получила её не раньше checkpointMaxAgeMs назад (по standby_status.ageMs;
+    // статус идёт раз в 5 с — окно больше двух периодов), иначе cold-промоушен любого
+    // способного; преемник не занял комнату за promotionTimeoutMs
+    // (coldPromotionTimeoutMs — он перезагружает страницу) — следующий
+    checkpointMaxAgeMs: 12000,
+    promotionTimeoutMs: 10000,
+    coldPromotionTimeoutMs: 25000,
+    // отчёты host_unreachable: хост не ответил на probe за probeTimeoutMs —
+    // потерян; ответил, но за reportWindowMs отчиталась половина гостей —
+    // принудительная миграция, не чаще forcedMigrationCooldownMs на комнату.
+    // Гости и отчёты считаются по аккаунтам; кворум — не меньше
+    // minUnreachableReporters разных пользователей (в паре с плохим P2P один
+    // гость не снимает хоста — иначе роль «пинг-понгом» ходит по кругу)
+    probeTimeoutMs: 2000,
+    reportWindowMs: 5000,
+    forcedMigrationCooldownMs: 30000,
+    minUnreachableReporters: 2,
+    // плановая передача (этап 8): преемник не занял комнату за
+    // handoffTimeoutMs — передача отменяется, хост размораживает матч
+    handoffTimeoutMs: 8000,
+    // host_migrating.waitMs — дедлайн текущей попытки промоушена (передачи)
+    // плюс migrationNoticeMarginMs: столько гость ждёт host_changed
+    migrationNoticeMarginMs: 5000,
+    // автотриггеры (этап 9c). Сетевой лаг хоста: медиана его RTT до гостей
+    // (host_health) выше lagRttThresholdMs непрерывно lagSustainMs, а score
+    // беты лучше score хоста хотя бы на lagImprovementRatio — хосту
+    // request_handoff. Не раньше autoMigrationCooldownMs с прошлой
+    // авто-смены хоста в комнате (overload/hidden/network — кулдаун общий)
+    // и с получения роли текущим хостом
+    lagRttThresholdMs: 250,
+    lagSustainMs: 10000,
+    lagImprovementRatio: 0.35,
+    autoMigrationCooldownMs: 90000,
+    // бета — не ниже этого FPS рендера (caps.fps гостя; неизвестный FPS не
+    // отсеивает). Аварийный промоушен порог не применяет
+    minSuccessorFps: 30,
+    // голосование «Change host» (этап 10, /changehost; только лобби-режим):
+    // голоса считает мастер. Длительность голосования; повторный старт в
+    // комнате и тем же пользователем — не раньше кулдаунов; прошедшее
+    // голосование просит хоста отдать роль, не начал за voteForceAfterMs —
+    // принудительная миграция; снятый хост не бета и не хост комнаты
+    // demotedCooldownMs (кроме случая, когда больше принять некому).
+    // Один голос на аккаунт; голосует и начинает участник, пробывший в
+    // комнате не меньше minVoterAgeMs (свежие вкладки не накручивают голоса).
+    // После смены хоста голосование ждёт первого room_peers нового хоста —
+    // до него подтверждёнными считаются все, и фантомы попали бы в число
+    // голосующих, — но не дольше peersReportGraceMs (больше
+    // lobby.migration.peersReportIntervalMs: потерянный первый отчёт
+    // повторится внутри окна; хост старше room_peers отчёта не пришлёт)
+    vote: {
+      hostVoteDurationMs: 15000,
+      roomVoteCooldownMs: 120000,
+      userStartCooldownMs: 60000,
+      voteForceAfterMs: 5000,
+      demotedCooldownMs: 600000,
+      minVoterAgeMs: 30000,
+      peersReportGraceMs: 20000,
+    },
+    // GET /rooms/:roomId (прямая ссылка, этап 3) на IP: открытие ссылки —
+    // один запрос, лимит только против перебора roomId
+    lookupRateLimit: {
+      limit: 20,
+      windowMs: 1000,
+    },
   },
 
   // GET /auth/leaderboard (code review L2): TTL кэша на мастере (мс) и
@@ -97,7 +196,7 @@ export default {
   // стороне хоста, а мастер держит потолок для сломанного или злонамеренного
   // сервера, который этот интервал обошёл
   playerData: {
-    // PUT /auth/rank + /auth/state на комнату (проверенный hostId) в минуту.
+    // PUT /auth/rank + /auth/state на комнату (проверенный roomId) в минуту.
     // Честная комната на 32 при lobbyConfig.playerData.minFlushInterval в
     // 5 минут пишет 64 запроса за эти 5 минут, то есть ~13/мин; остальное —
     // запас на срочные границы (уход участника обходит интервал), и его
@@ -110,22 +209,6 @@ export default {
     maxGameScore: 10000,
   },
 
-  // рейтинг хостера комнаты (server-rating этап 2, plan/server-rating/
-  // stage_2.md): /like·/unlike гостей комнаты вместо соц-модерации /ban.
-  // Дефолт движка для всех игр; auth-сервис хранит и клампит рейтинг
-  // персистентно и глобально (нужно и для аннулирования rank/skills, этап 4) —
-  // это значение зеркалируется в packages/auth/src/config/auth.js:rating,
-  // фактический кламп/blocked считает auth, не мастер
-  rating: {
-    min: -10,
-    max: 10,
-    blockAt: -10,
-    // период опроса auth за актуальным рейтингом активных хостеров (этап 3,
-    // stage_3.md) — держит кэш GET /servers свежим (счёт мог измениться на
-    // другом мастере), голос/регистрация на этом мастере обновляют кэш сразу
-    refreshInterval: 30000,
-  },
-
   // заголовки безопасности (гигиена среды, Этап 5.4). CSP на статику/.wasm в
   // проде ставит Nginx (см. docs/deployment.md) — здесь single source of truth
   // политики; мастер применяет её к своим ответам только в проде (в dev CSP

package/src/config/wsports.js

@@ -31,6 +31,10 @@ export default {
     // места участников в глобальном топе (snakes-v3 этап 4): косметика
     // для parts игры, в снапшот не идёт
     ACCOLADES_DATA: 18,
+    // возобновление сессии (host-migration этап 4): секрет участника
+    // { resumeKey, gameId } и ответ на RESUME_REQUEST
+    SESSION_DATA: 19,
+    RESUME_RESULT: 20,
   },
   // порты получения данных от клиента
   client: {
@@ -43,5 +47,9 @@ export default {
     CHAT_DATA: 6,
     VOTE_DATA: 7,
     PONG: 8,
+    // возобновление места после обрыва транспорта (host-migration этап 4)
+    RESUME_REQUEST: 9,
+    // игрок уходит сам: хост снимает его сразу, без ожидания возврата
+    LEAVE: 10,
   },
 };

package/src/devtools/RecordingSocketManager.js

@@ -14,8 +14,9 @@ import SocketManager from '../host/meta/SocketManager.js';
 
 // имена отправителей берутся из прототипа: ручной список неизбежно отстаёт
 // от боевого класса, что уже случалось
-const SENDER_METHODS = Object.getOwnPropertyNames(SocketManager.prototype)
-  .filter(name => name.startsWith('send'));
+const SENDER_METHODS = Object.getOwnPropertyNames(
+  SocketManager.prototype,
+).filter(name => name.startsWith('send'));
 
 class RecordingSocketManager extends SocketManager {
   /**

package/src/devtools/ScenarioRunner.js

@@ -1,5 +1,7 @@
 import { createHostRuntime } from '../lib/createHostRuntime.js';
+import { encodeCheckpoint, decodeCheckpoint } from '../lib/checkpointCodec.js';
 import { offlinePlayerData } from '../lib/offlinePlayerData.js';
+import { resumeKeysEqual } from '../lib/resumeKey.js';
 import VirtualClock, { flushMicrotasks } from './VirtualClock.js';
 import RecordingSocketManager from './RecordingSocketManager.js';
 import VirtualClient from './VirtualClient.js';
@@ -51,7 +53,9 @@ export function parseScenario(raw) {
   }
 
   if (raw.version !== 1) {
-    throw new Error(`scenario: unsupported version ${raw.version} (expected 1)`);
+    throw new Error(
+      `scenario: unsupported version ${raw.version} (expected 1)`,
+    );
   }
 
   if (!Array.isArray(raw.participants) || !raw.participants.length) {
@@ -77,6 +81,15 @@ export function parseScenario(raw) {
     );
   }
 
+  const checkpointEvery = raw.checkpointEvery ?? null;
+
+  if (
+    checkpointEvery !== null &&
+    !(Number.isFinite(checkpointEvery) && checkpointEvery > 0)
+  ) {
+    throw new Error('scenario: checkpointEvery must be a positive number (ms)');
+  }
+
   return {
     version: 1,
     seed: raw.seed ?? 1,
@@ -96,6 +109,9 @@ export function parseScenario(raw) {
     ticks: raw.ticks ?? 600,
     dumpTicks: raw.dumpTicks ?? null,
     room: raw.room ?? {},
+    // смена хоста через контрольную точку каждые N мс матча (host-migration
+    // этап 5); то же разово — шаг таймлайна { op: 'checkpointRestore' }
+    checkpointEvery,
   };
 }
 
@@ -169,7 +185,13 @@ async function execute(scenario, plugin, virtualClock, { captureFrames }) {
     },
   };
 
-  const runtime = await createHostRuntime(room, {
+  const hostOptions = {
+    onMapChange: mapName =>
+      mapChanges.push({ tick: currentTick, map: mapName }),
+    playerDataFetch: emptyProfileFetch,
+  };
+
+  let runtime = await createHostRuntime(room, {
     loadHostPlugin: () => plugin.hostPlugin,
     // транспорт собирается той же фабрикой, что и боевой: наследник обязан
     // получить те же порты и ту же игровую параметризацию
@@ -182,11 +204,7 @@ async function execute(scenario, plugin, virtualClock, { captureFrames }) {
       return socketManager;
     },
     overrideGameConfig: game => mergeConfig(game, scenario.config),
-    hostOptions: {
-      onMapChange: mapName =>
-        mapChanges.push({ tick: currentTick, map: mapName }),
-      playerDataFetch: emptyProfileFetch,
-    },
+    hostOptions,
   });
 
   const { clientCfg, game, seed } = runtime;
@@ -194,6 +212,78 @@ async function execute(scenario, plugin, virtualClock, { captureFrames }) {
 
   host = runtime.host;
 
+  // смены хоста через контрольную точку (host-migration этап 5)
+  const checkpointRestores = [];
+
+  // Старый хост замораживается и отдаёт финальную точку; точка проходит
+  // боевой кодек (сжатие → распаковка), из неё поднимается НОВЫЙ runtime на
+  // том же транспорте, и каждый клиент возвращается в своё место RESUME'ом —
+  // ровно как к преемнику в проде. Сбой любого шага — исключение: прогон
+  // красный, а не тихо продолжившийся на старом хосте
+  const restoreFromCheckpoint = async tick => {
+    let taken = null;
+
+    host.setCheckpointSink(checkpoint => {
+      taken = checkpoint;
+    });
+    host.freeze();
+    host.requestCheckpoint({ final: true });
+    host.setCheckpointSink(null);
+
+    if (!taken) {
+      throw new Error(`scenario: no checkpoint taken at tick ${tick}`);
+    }
+
+    const bytes = await encodeCheckpoint(taken.meta, taken.core);
+    const checkpoint = await decodeCheckpoint(bytes);
+
+    resetHostSingletons();
+
+    runtime = await createHostRuntime(room, {
+      loadHostPlugin: () => plugin.hostPlugin,
+      createSocketManager: () => socketManager,
+      overrideGameConfig: next => mergeConfig(next, scenario.config),
+      hostOptions: { ...hostOptions, checkpoint, seqFloor: taken.meta.seq },
+    });
+    host = runtime.host;
+
+    for (const client of clients.values()) {
+      const target = host.getResumeTarget(client.gameId);
+      const request = client.resumeRequest();
+
+      if (!target || !resumeKeysEqual(request.resumeKey, target.resumeKey)) {
+        throw new Error(
+          `scenario: participant ${client.gameId} cannot resume after ` +
+            `checkpoint at tick ${tick}`,
+        );
+      }
+
+      host.resumeUser(client.gameId, client.socketId, null);
+    }
+
+    host.startAfterRestore();
+    checkpointRestores.push({
+      tick,
+      mode: checkpoint.meta.mode,
+      bytes: bytes.byteLength,
+    });
+
+    await flushMicrotasks();
+  };
+
+  const checkpointTicks = new Set();
+
+  if (scenario.checkpointEvery) {
+    for (let tick = 1; tick <= scenario.ticks; tick += 1) {
+      if (
+        Math.floor((tick * stepMs) / scenario.checkpointEvery) >
+        Math.floor(((tick - 1) * stepMs) / scenario.checkpointEvery)
+      ) {
+        checkpointTicks.add(tick);
+      }
+    }
+  }
+
   // очередь операций сценария, разложенная по номеру тика: ввод хост
   // применяет синхронно при приходе сообщения (HostGame.updateKeys), очереди
   // у него нет — значит сценарий обязан задавать именно границу тика
@@ -216,7 +306,16 @@ async function execute(scenario, plugin, virtualClock, { captureFrames }) {
     currentTick = tick;
     socketManager.tick = tick;
 
+    if (checkpointTicks.has(tick)) {
+      await restoreFromCheckpoint(tick);
+    }
+
     for (const op of opsByTick.get(tick) ?? []) {
+      if (op.op === 'checkpointRestore') {
+        await restoreFromCheckpoint(tick);
+        continue;
+      }
+
       await applyOp(op, {
         host,
         clientCfg,
@@ -269,6 +368,7 @@ async function execute(scenario, plugin, virtualClock, { captureFrames }) {
     seed,
     stepMs,
     host,
+    checkpointRestores,
     core: runtime.core,
     game,
     clientCfg,
@@ -336,6 +436,11 @@ function routeFrame(frame, clients, pendingShots, virtualClock, host) {
     return;
   }
 
+  if (frame.method === 'sendSessionData') {
+    client.noteSession(frame.args[0]);
+    return;
+  }
+
   const bucket = RECORDED_PORTS[frame.method];
 
   if (bucket) {
@@ -463,7 +568,9 @@ async function joinParticipant(op, ctx) {
   const participant = scenario.participants.find(p => p.id === op.who);
 
   if (!participant) {
-    throw new Error(`scenario: join references unknown participant '${op.who}'`);
+    throw new Error(
+      `scenario: join references unknown participant '${op.who}'`,
+    );
   }
 
   const socketId = participant.socketId ?? `sock-${participant.id}`;
@@ -502,6 +609,11 @@ async function joinParticipant(op, ctx) {
   host.sendMap(gameId);
   host.mapReady(gameId);
   host.firstShotReady(gameId);
+
+  // секрет места — как SESSION_DATA порт-машины лобби на первом кадре:
+  // с ним клиент вернётся к новому хосту после смены (checkpointRestore)
+  client.noteSession({ resumeKey: host.issueResumeKey(gameId), gameId });
+
   byParticipant.set(op.who, { socketId, gameId });
   participantLog.push({
     who: op.who,
@@ -550,6 +662,7 @@ function buildReport(ctx) {
     seed,
     stepMs,
     host,
+    checkpointRestores,
     core,
     game,
     clientCfg,
@@ -599,6 +712,8 @@ function buildReport(ctx) {
     durationMs: stepMs * scenario.ticks,
     currentMap: host.currentMap,
     mapChanges,
+    // смены хоста через контрольную точку: тик, режим, размер сжатой точки
+    checkpointRestores,
     participants: [...byParticipant.entries()].map(([id, entry]) => ({
       id,
       ...entry,

package/src/devtools/VirtualClient.js

@@ -98,6 +98,10 @@ class VirtualClient {
     this.frameCount = 0;
     this.decodeErrors = [];
 
+    // секрет места (SESSION_DATA): с ним клиент возвращается к новому хосту
+    // после смены (RESUME, host-migration этапы 4–5)
+    this.resumeKey = null;
+
     // материал проверок инвариантов (devtools/invariants.js): что реально
     // доехало до сцены за весь прогон, а не только к финальному тику —
     // сущность могла появиться и исчезнуть между дампами
@@ -116,6 +120,22 @@ class VirtualClient {
     this.truncated = { nonFinite: 0, hotLayoutErrors: 0, divergence: 0 };
   }
 
+  // SESSION_DATA { resumeKey, gameId }: хост выдал (или ротировал) секрет
+  noteSession(data) {
+    if (data && typeof data.resumeKey === 'string') {
+      this.resumeKey = data.resumeKey;
+    }
+
+    if (data && data.gameId !== undefined) {
+      this.gameId = data.gameId;
+    }
+  }
+
+  // тело RESUME_REQUEST — то же, что шлёт браузерный клиент
+  resumeRequest() {
+    return { v: 1, gameId: this.gameId, resumeKey: this.resumeKey };
+  }
+
   // байты кадра из sendShot — ровно то, что ушло бы в data channel
   pushFrame(bytes, localNow) {
     const data = toUint8(bytes);

package/src/devtools/contract/format.js

@@ -13,7 +13,10 @@ const MARKS = { [PASS]: '✅', [FAIL]: '❌', [SKIP]: '⏭️' };
  */
 export function formatContract(report, { quiet = false } = {}) {
   const { summary } = report;
-  const lines = [`# Contract report — ${report.game.id ?? '(unknown game)'}`, ''];
+  const lines = [
+    `# Contract report — ${report.game.id ?? '(unknown game)'}`,
+    '',
+  ];
 
   lines.push(`- game: \`${report.game.dir}\``);
   lines.push(`- engine API: v${report.game.engineApi}`);

package/src/devtools/contract/index.js

@@ -86,7 +86,6 @@ export function runRules(ctx, ruleList = rules) {
  */
 export function hasBlockingFailure(report, strict = false) {
   return report.results.some(
-    result =>
-      result.status === FAIL && (strict || result.level === ERROR),
+    result => result.status === FAIL && (strict || result.level === ERROR),
   );
 }