vimp-engine 0.35.5 → 0.36.0

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),
   );
 }

package/src/devtools/contract/rules/a2-package-scripts.js

@@ -29,8 +29,6 @@ export default {
     const scripts = ctx.pkg.scripts ?? {};
     const missing = REQUIRED.filter(name => !scripts[name]);
 
-    return verdict(
-      missing.map(name => `script "${name}" is missing`),
-    );
+    return verdict(missing.map(name => `script "${name}" is missing`));
   },
 };

package/src/devtools/contract/rules/b8-system-messages.js

@@ -4,7 +4,7 @@ import { ERROR, skip, verdict } from '../result.js';
 // реестра: код в зарезервированном диапазоне затирает движковое сообщение
 // без предупреждения, и вместо «Vote passed» игрок видит игровой текст.
 // Диапазоны — длины движковых групп (client/config/chat messages).
-const RESERVED = { s: 6, v: 5, m: 1, c: 1, n: 1 };
+const RESERVED = { s: 11, v: 15, m: 1, c: 1, n: 1 };
 
 export default {
   id: 'B8',

package/src/devtools/contract/rules/b9-vote-names.js

@@ -8,11 +8,19 @@ import { ERROR, skip, verdict } from '../result.js';
 const ENGINE_MENU = ['teamChange', 'mapChange'];
 const ENGINE_TEMPLATES = ['teamChange', 'mapChangeBySystem', 'mapChangeByUser'];
 
+// Имена с '@' — голосования самого движка (host-migration этап 10:
+// '@changeHost' — окно «Change host?» от мастера). Ответ на голосование с
+// таким именем клиент перехватывает до хоста — игровое голосование под ним
+// не дошло бы до игры никогда
+const ENGINE_PREFIX = '@';
+const isEngineName = name =>
+  typeof name === 'string' && name.startsWith(ENGINE_PREFIX);
+
 export default {
   id: 'B9',
   name: 'voteNames',
   level: ERROR,
-  title: 'custom votes do not reuse the reserved vote names',
+  title: 'custom votes do not reuse the reserved vote names or the @ prefix',
 
   check(ctx) {
     const vote = ctx.clientConfig?.modules?.vote?.params;
@@ -25,6 +33,14 @@ export default {
     const violations = [];
 
     for (const name of templates) {
+      if (isEngineName(name)) {
+        violations.push(
+          `vote template "${name}" starts with "${ENGINE_PREFIX}" — names ` +
+            `with this prefix are reserved for engine votes`,
+        );
+        continue;
+      }
+
       if (ENGINE_MENU.includes(name) && !ENGINE_TEMPLATES.includes(name)) {
         violations.push(
           `vote template "${name}" reuses a reserved vote name — the engine ` +
@@ -36,6 +52,14 @@ export default {
     for (const entry of vote.menu ?? []) {
       const name = Array.isArray(entry) ? entry[0] : entry;
 
+      if (isEngineName(name)) {
+        violations.push(
+          `vote menu entry "${name}" starts with "${ENGINE_PREFIX}" — names ` +
+            `with this prefix are reserved for engine votes`,
+        );
+        continue;
+      }
+
       if (!ENGINE_MENU.includes(name) && !templates.includes(name)) {
         violations.push(
           `vote menu entry "${name}" has no template — the vote renders empty`,

package/src/devtools/contract/rules/c11-stat-mode.js

@@ -33,7 +33,10 @@ export default {
     const host = ctx.gameConfig.statMode ?? null;
 
     if (client === host) {
-      return verdict([], client ? `both declare '${client}'` : 'the room table');
+      return verdict(
+        [],
+        client ? `both declare '${client}'` : 'the room table',
+      );
     }
 
     if (client && !host) {

package/src/devtools/contract/rules/c6-stat-columns.js

@@ -100,7 +100,7 @@ export default {
     // ли игра свои стили под этот список
     if (params.mode === 'leaderboard') {
       return styledLeaderboard(ctx.clientPlugin?.styles)
-        ? verdict([], 'leaderboard list, laid out by the plugin\'s own styles')
+        ? verdict([], "leaderboard list, laid out by the plugin's own styles")
         : verdict([
             "stat declares mode 'leaderboard', but ClientPlugin.styles says " +
               'nothing about #stat .stat-leaderboard: the engine CSS gives ' +

package/src/devtools/contract/rules/c7-key-sets.js

@@ -4,7 +4,13 @@ import { ERROR, skip, verdict } from '../result.js';
 // prevPlayer наблюдатель заперт на одной камере; занятый движковый код
 // (чат, голосование, статистика, escape, enter) до игры не доходит;
 // расхождение имён с playerKeys даёт клавишу, которая ничего не шлёт.
-const ENGINE_CODES = { 9: 'stat', 13: 'enter', 27: 'escape', 67: 'chat', 77: 'vote' };
+const ENGINE_CODES = {
+  9: 'stat',
+  13: 'enter',
+  27: 'escape',
+  67: 'chat',
+  77: 'vote',
+};
 const SPECTATOR_ACTIONS = ['nextPlayer', 'prevPlayer'];
 
 export default {
@@ -51,9 +57,7 @@ export default {
 
       for (const action of declared) {
         if (!bound.has(action)) {
-          violations.push(
-            `playerKeys."${action}" has no key in keySetList[1]`,
-          );
+          violations.push(`playerKeys."${action}" has no key in keySetList[1]`);
         }
       }
 

package/src/devtools/contract/rules/d3-snapshot-interp.js

@@ -12,7 +12,8 @@ export default {
   id: 'D3',
   name: 'snapshotInterp',
   level: ERROR,
-  title: "interp only on f32 fields of class 'hot' blocks; role 'state' is a u8 right after the row head",
+  title:
+    "interp only on f32 fields of class 'hot' blocks; role 'state' is a u8 right after the row head",
 
   check(ctx) {
     const snapshot = ctx.gameConfig?.snapshot;

package/src/devtools/contract/rules/e1-sound-pairs.js

@@ -30,7 +30,9 @@ export default {
         'mp3',
       ]) {
         if (!ctx.distFiles.has(`sounds/${file}.${codec}`)) {
-          violations.push(`sound "${name}": dist/sounds/${file}.${codec} is missing`);
+          violations.push(
+            `sound "${name}": dist/sounds/${file}.${codec} is missing`,
+          );
         }
       }
     }

package/src/devtools/contract/rules/e4-map-layers.js

@@ -133,7 +133,13 @@ function checkMap(name, map, violations) {
     }
 
     // 8. тайл рендер-слоя обязан существовать в тайл-листе по индексу
-    checkLayerFrames(at, `level ${key}`, level?.layers, map.spriteSheet, violations);
+    checkLayerFrames(
+      at,
+      `level ${key}`,
+      level?.layers,
+      map.spriteSheet,
+      violations,
+    );
 
     // 11. высоты объёмов уровня
     checkVolumes(at, key, level?.layers, level?.volumes, violations);
@@ -325,7 +331,12 @@ function rampRunExits(grid, tile, dir) {
   return out;
 }
 
-const NEIGHBOURS = [[1, 0], [-1, 0], [0, 1], [0, -1]];
+const NEIGHBOURS = [
+  [1, 0],
+  [-1, 0],
+  [0, 1],
+  [0, -1],
+];
 
 function checkLevelEdges(at, map, violations) {
   for (const [key, level] of Object.entries(map.levels ?? {})) {

package/src/devtools/contract/rules/e5-map-radar-walls.js

@@ -43,7 +43,13 @@ export default {
 function checkMap(at, map, violations) {
   let checked = 0;
 
-  checked += checkGrid(at, 'level 0', map?.layers, map?.physicsStatic, violations);
+  checked += checkGrid(
+    at,
+    'level 0',
+    map?.layers,
+    map?.physicsStatic,
+    violations,
+  );
 
   for (const [key, level] of Object.entries(map?.levels ?? {})) {
     checked += checkGrid(