vimp-engine 0.38.1 → 0.38.3

package/src/devtools/builtinScenario.js

@@ -13,8 +13,8 @@ import { isFixture } from './pluginLoader.js';
 // Ввод начинается на 40-м тике, а не сразу: кадр спавна с force_reset
 // приходит примерно на interpolation.delay (движковый дефолт — 100 мс, тут
 // ~3× запаса) позже входа и чистит удержанные клавиши предиктора
-// (docs/en/debugging.md) — встроенный сценарий не должен демонстрировать
-// ровно ту ловушку, от которой предостерегает документация
+// (docs.vimp.lgick.dev/en/debugging) — встроенный сценарий не должен
+// демонстрировать ровно ту ловушку, от которой предостерегает документация
 const INPUT_DOWN_TICK = 40;
 const INPUT_UP_TICK = 100;
 const TICKS = 120;
@@ -26,7 +26,7 @@ const FIXTURE_UNUSED_KEYS = ['e1'];
 const firstKey = dict => Object.keys(dict ?? {})[0];
 
 // Клавиша для смоука обязана быть удерживаемой: по конвенции playerKeys
-// (docs/en/plugin-api.md) `type: 1` — триггер, у которого 'up'
+// (docs.vimp.lgick.dev/en/plugin-api) `type: 1` — триггер, у которого 'up'
 // игнорируется, и «нажал — отпустил» не даёт ни удержания, ни движения.
 // Порядок объявления в playerKeys контрактом не задан, поэтому берём первую
 // без type; если игра объявила одни триггеры — первую любую, смоук всё равно

package/src/devtools/contract/loadContext.js

@@ -14,7 +14,7 @@ import { createGameConfigView } from '../../lib/gameConfigView.js';
 // модули; исходники читаются только там, где проверяется буква кода
 // (engineApi литералом или импортом).
 
-// каталог движка (packages/engine) — из него берётся версия крейта, с
+// каталог пакета движка — из него берётся версия крейта, с
 // которой сверяется пин игры. core/Cargo.toml числится в "files"
 // package.json именно ради этого: иначе в установке из npm версии крейта
 // нет, и правило A5 проверяло бы пин только внутри монорепозитория
@@ -170,7 +170,7 @@ async function readEngineCoreVersion() {
 // версия пакета в секции [package] — первый `version = "…"` до следующей
 // секции; TOML-парсера в зависимостях движка нет, а формат здесь наш.
 //
-// Копия живёт в packages/create-vimp-game/src/versions.js: скаффолдер
+// Копия живёт в create-vimp-game (src/versions.js): скаффолдер
 // ставится через `npm create` и обязан работать без движка в зависимостях.
 // Разбор обязан совпадать — правьте обе или ни одной (см. тест
 // tests/scaffold/versions.test.js).

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

@@ -1,8 +1,9 @@
 import { ERROR, skip, verdict } from '../result.js';
 
-// Набор npm-скриптов пакета игры (docs/en/packaging.md). Это не вкусовое
-// требование: инструкции движка и CI сгенерированной игры зовут их по имени,
-// а отсутствующий core:build:node тихо оставляет headless-прогон без ядра.
+// Набор npm-скриптов пакета игры (docs.vimp.lgick.dev/en/packaging). Это не
+// вкусовое требование: инструкции движка и CI сгенерированной игры зовут их по
+// имени, а отсутствующий core:build:node тихо оставляет headless-прогон без
+// ядра.
 const REQUIRED = [
   'build',
   'build:client',

package/src/devtools/contract/rules/a4-vite-config.js

@@ -2,9 +2,10 @@ import { ERROR, skip, verdict } from '../result.js';
 
 // vite.config.js проверяется как текст, а не импортом: конфиг —
 // функция от mode и вне Vite не исполняется. Каждый пункт здесь ловит
-// молчаливую поломку сборки, а не стилистику (docs/en/packaging.md):
-// без preserveEntrySignatures default-экспорт плагина вытряхивает
-// tree-shaking, а build.lib всегда инлайнит ассеты.
+// молчаливую поломку сборки, а не стилистику
+// (docs.vimp.lgick.dev/en/packaging): без preserveEntrySignatures
+// default-экспорт плагина вытряхивает tree-shaking, а build.lib всегда инлайнит
+// ассеты.
 const REQUIRED = [
   [/emptyOutDir\s*:\s*false/, 'emptyOutDir: false (two builds share dist/)'],
   [/assetsInlineLimit\s*:\s*0/, 'assetsInlineLimit: 0'],

package/src/devtools/contract/rules/a7-package-repository.js

@@ -1,16 +1,16 @@
 import { WARN, skip, verdict } from '../result.js';
 import { resolveProjectUrl } from '../../../lib/packageLink.js';
 
-// Игра без объявленного репозитория собирается и играется — это не отказ.
-// Но движок показывает ссылку на проект в футере формы входа, и берёт он её
-// только отсюда (фолбэка нет, см. lib/packageLink.js): без поля ячейка
-// футера у игроков останется пустой, а заметить это без подсказки негде.
+// Игра без объявленного repository собирается и играется — это не
+// отказ. Но реестр игр в лобби показывает ссылку на проект, и берёт он её
+// только из него (фолбэка нет, см. lib/packageLink.js): без них строка
+// игры останется без ссылки, а заметить это без подсказки негде.
 // Отсюда warn — под --strict он становится ошибкой.
 export default {
   id: 'A7',
   name: 'packageRepository',
   level: WARN,
-  title: 'package.json declares repository (the #auth footer links to it)',
+  title: 'package.json declares repository (the games registry links to it)',
 
   check(ctx) {
     if (!ctx.pkg) {
@@ -22,8 +22,8 @@ export default {
     }
 
     return verdict([
-      'neither "repository" nor "homepage" resolves to a project URL — ' +
-        "the game's entry form will show no project link",
+      '"repository" does not resolve to a project URL — ' +
+        "the game's registry entry will show no project link",
     ]);
   },
 };

package/src/devtools/contract/rules/c4-component-dependencies.js

@@ -4,11 +4,11 @@ import { SERVICES } from '../../../config/clientServices.js';
 // Движковый пул сервисов держит реестр (config/clientServices.js), но пул
 // ими не исчерпывается: игра доливает туда свои через
 // ClientPlugin.hooks.services(core) — например геометрию предсказанной
-// динамики карты (docs/en/plugin-api.md «hooks.services»). Незнакомое имя не
-// ошибка для движка: part получает undefined и рисует пустоту — карта без
-// assetsBase выглядит как чистый холст без единой строки в консоли, ради
-// этого правило и существует. Правило остаётся ERROR: оно работает на этапе
-// разработки игры, а не в рантайме.
+// динамики карты (docs.vimp.lgick.dev/en/plugin-api «hooks.services»).
+// Незнакомое имя не ошибка для движка: part получает undefined и рисует пустоту
+// — карта без assetsBase выглядит как чистый холст без единой строки в консоли,
+// ради этого правило и существует. Правило остаётся ERROR: оно работает на
+// этапе разработки игры, а не в рантайме.
 //
 // Что именно возвращает `hooks.services(core)`, статически не видно — хук
 // требует живого ядра. Поэтому у плагина есть необязательное поле

package/src/devtools/contract/rules/index.js

@@ -38,7 +38,7 @@ import e6 from './e6-sound-spatial.js';
 import e7 from './e7-map-game-field.js';
 
 // Порядок групп — порядок отчёта: A пакет и сборка, B host, C client,
-// D снапшот, E ассеты (plan/create-vimp-game/stage_1.md).
+// D снапшот, E ассеты.
 export const rules = [
   a1,
   a2,

package/src/devtools/invariants.js

@@ -19,7 +19,7 @@ export const SKIP = 'skip';
 // не берётся судить покрытие схемы» (встроенный смоук на чужой игре)
 export const ALL_KEYS_UNAUDITED = '*';
 
-// список проверок в порядке plan/done/ai-debug/stage_3.md
+// список проверок
 const CHECKS = [
   [1, 'finiteValues', 'no NaN/Infinity in decoded fields and hot buffer'],
   [2, 'snapshotKeysUsed', 'every snapshot key produced at least one row'],
@@ -484,7 +484,7 @@ function predictionDrift({ clients, scenario }) {
 // Компоненты player-блока — игровая раскладка, движок знает только их
 // порядок, поэтому нарушение адресуется индексом. Исключение — уровень 0
 // (source 'camera'): там движок сравнивает ровно мировые x/y, и называть их
-// «#0/#1» значит прятать причину (см. docs/en/debugging.md).
+// «#0/#1» значит прятать причину (см. docs.vimp.lgick.dev/en/debugging).
 const CAMERA_COMPONENTS = ['x', 'y'];
 
 function formatDivergence(record) {

package/src/devtools/pluginLoader.js

@@ -12,9 +12,9 @@ import { loadGamePackage } from '../lib/loadGamePackage.js';
 //   3. ничего         — фикстура miniGame из этого репозитория.
 //
 // entries.wasmNode — новое ОПЦИОНАЛЬНОЕ поле манифеста: конвенция
-// core/pkg-node/ уже описана в docs/en/packaging.md, не хватало только
-// пути в манифесте. Его отсутствие не ошибка — просто игра не прогоняется
-// headless своим настоящим ядром.
+// core/pkg-node/ уже описана в docs.vimp.lgick.dev/en/packaging, не хватало
+// только пути в манифесте. Его отсутствие не ошибка — просто игра не
+// прогоняется headless своим настоящим ядром.
 
 const FIXTURE_DIR = new URL('../../tests/fixtures/miniGame/', import.meta.url);
 

package/src/host/DebugRecorder.js

@@ -1,6 +1,6 @@
 import clock from '../lib/clock.js';
 
-// Рекордер живого матча (этап 6 плана plan/done/ai-debug): пишет то, что headless
+// Рекордер живого матча: пишет то, что headless
 // не воспроизводит — реальный WebRTC, PixiJS и живой ввод человека — ровно в
 // формат сценария headless-runner'а (devtools/ScenarioRunner.js). Баг,
 // пойманный человеком в браузере, догоняется потом `npm run sim:replay`

package/src/host/HostGame.js

@@ -16,6 +16,7 @@ import closeCodes from '../config/closeCodes.js';
 import clock from '../lib/clock.js';
 import { createResumeKey } from '../lib/resumeKey.js';
 import GameCoreAdapter from './GameCoreAdapter.js';
+import { commandFailureReport } from './commandFailure.js';
 import DebugRecorder from './DebugRecorder.js';
 import enginePkg from '../../package.json' with { type: 'json' };
 
@@ -252,7 +253,7 @@ export default class HostGame {
     this._networkSendRate = data.timers.networkSendRate;
     this._snapshotManager = new SnapshotThrottle(this._networkSendRate);
 
-    // рекордер живого матча (этап 6 плана plan/done/ai-debug) — только в dev-режиме;
+    // рекордер живого матча — только в dev-режиме;
     // в проде null, и все точки записи ниже вырождаются в ?.
     this._recorder = this._isDevMode ? new DebugRecorder() : null;
 
@@ -317,19 +318,22 @@ export default class HostGame {
       currentMap: data.currentMap,
     });
 
-    this._commandProcessor = new CommandProcessor({
-      participants: this._participants,
-      chat: this._chat,
-      scripted: this._scripted,
-      roundManager: this._roundManager,
-      voteCoordinator: this._voteCoordinator,
-      timerManager: this._timerManager,
-      playerDataSync: this._playerDataSync,
-      teams: this._teams,
-      spectatorTeam: this._spectatorTeam,
-      spectatorId: this._spectatorId,
-      isDevMode: this._isDevMode,
-    });
+    this._commandProcessor = new CommandProcessor(
+      {
+        participants: this._participants,
+        chat: this._chat,
+        scripted: this._scripted,
+        roundManager: this._roundManager,
+        voteCoordinator: this._voteCoordinator,
+        timerManager: this._timerManager,
+        playerDataSync: this._playerDataSync,
+        teams: this._teams,
+        spectatorTeam: this._spectatorTeam,
+        spectatorId: this._spectatorId,
+        isDevMode: this._isDevMode,
+      },
+      { onError: (command, error) => this._reportCommandError(command, error) },
+    );
 
     // игровые чат-команды и коды системных сообщений из HostPlugin
     for (const command of hostPlugin.chatCommands) {
@@ -349,6 +353,7 @@ export default class HostGame {
     this._checkpointSink = null; // ({ meta, core, final }) => void
     // здоровье хоста (host-migration этап 9a): раз в окно цикла
     this._healthSink = null; // (health) => void
+    this._diagnosticSink = null; // ({ kind, message, stack }) => void
     this._checkpointIntervalMs = 0; // 0 — периодических точек нет
     this._lastCheckpointAt = 0;
     this._checkpointRequest = null; // { final } — точка на ближайшем кадре
@@ -738,7 +743,7 @@ export default class HostGame {
     this._mapList.push(...Object.keys(this._maps));
   }
 
-  // ***** отладочный контур (этап 6 плана plan/done/ai-debug) ***** //
+  // ***** отладочный контур ***** //
   // Всё ниже живёт под флагом isDevMode: в проде рекордера нет, а дамп
   // отдаёт только то, что и так знает мета.
 
@@ -1042,6 +1047,21 @@ export default class HostGame {
 
   // ***** здоровье хоста (host-migration этап 9a) ***** //
 
+  /**
+   * Приёмник сбоев кода игры, пойманных хостом: { kind, message, stack }.
+   * @param {Function|null} sink
+   */
+  setDiagnosticSink(sink) {
+    this._diagnosticSink = typeof sink === 'function' ? sink : null;
+  }
+
+  // сбой чат-команды игры: отчёт собирает commandFailure.js (одна строка
+  // сообщения, стек без текста ошибки); бросок приёмника гасит
+  // CommandProcessor._fail
+  _reportCommandError(command, error) {
+    this._diagnosticSink?.(commandFailureReport(command, error));
+  }
+
   /**
    * Приёмник метрик здоровья: раз в окно игрового цикла (~1 с) —
    * { tickRate, maxGapMs, lostMs, windowMs, peerRttMedian, peerCount }.

package/src/host/PortMachine.js

@@ -1,9 +1,10 @@
 // Хендшейк-машина клиента, вынутая из host.worker.js: автомат по клиентским
-// портам 0–10 (см. docs/en/network.md). Изоморфна — ни self, ни postMessage,
-// ни DOM: всё, что знает про транспорт, приходит через makeSocket. Поэтому её
-// крутит и Worker браузерного хоста, и inline-хост standalone SDK, и
-// Node-процесс dedicated-сервера: копий автомата быть не должно, иначе они
-// разъедутся ровно так, как разъезжались бы копии createHostRuntime.
+// портам (таблица портов — docs.vimp.lgick.dev/en/snapshot). Изоморфна — ни
+// self, ни postMessage, ни DOM: всё, что знает про транспорт, приходит через
+// makeSocket. Поэтому её крутит и Worker браузерного хоста, и inline-хост
+// standalone SDK, и Node-процесс dedicated-сервера: копий автомата быть не
+// должно, иначе они разъедутся ровно так, как разъезжались бы копии
+// createHostRuntime.
 
 import wsports from '../config/wsports.js';
 import closeCodes from '../config/closeCodes.js';

package/src/host/commandFailure.js

@@ -0,0 +1,140 @@
+// Отчёт о сбое чат-команды игры для приёмника диагностики
+// (HostGame.setDiagnosticSink): сообщение в одну строку и стек без текста
+// ошибки. Один отчёт на все среды — Worker (журнал платформы), dedicated
+// (лог процесса), standalone (консоль вкладки). Чистые функции, без DOM и
+// Node API: модуль работает в Worker'е
+
+// символы, подделывающие строки лога: управляющие (перевод строки, ESC),
+// невидимые форматные (bidi-переопределения, нулевая ширина, BOM), разделители
+// строк и абзацев (U+2028/2029)
+const LOG_UNSAFE = /[\p{Cc}\p{Cf}\p{Zl}\p{Zp}\u180E]/gu;
+const MAX_STACK = 2000;
+
+// обрезка до limit единиц UTF-16 без разрыва суррогатной пары; выполняется
+// до очистки, чтобы огромная строка не проходила regex целиком
+const clip = (value, limit) => {
+  if (value.length <= limit) {
+    return value;
+  }
+
+  const text = value.slice(0, limit);
+
+  return /[\uD800-\uDBFF]$/.test(text) ? text.slice(0, -1) : text;
+};
+
+// одна строка лога: текст от игрока или из кода игры без LOG_UNSAFE
+const oneLine = (value, limit) =>
+  clip(String(value), limit).replace(LOG_UNSAFE, ' ');
+
+// стек сохраняет переводы строк, остальное LOG_UNSAFE заменяется; длина
+// ограничена
+const cleanStack = stack =>
+  clip(stack, MAX_STACK)
+    .split(/\r\n|\r|\n/)
+    .map(line => line.replace(LOG_UNSAFE, ' '))
+    .join('\n');
+
+// кадры стека (V8: «    at …»). Заголовок «имя: текст» снимается по числу
+// строк текста — ввод игрока в тексте не отличить от кадра по виду, поиск
+// «at» его бы не отсёк. Не сошлось (текст изменён после создания, цепочка
+// cause, другой движок) — остаётся хвост из подряд идущих кадров; ни кадров
+// V8, ни кадров SpiderMonkey/JSC — стек сводится к одной строке, чтобы текст
+// из него не подделал строки лога
+const V8_FRAME = /^ {4}at /;
+
+// кадр SpiderMonkey/JavaScriptCore: «имя@место», текста ошибки в таком стеке
+// нет. Имя — без пробелов, кроме служебных имён JSC (global/eval/module code,
+// «async имя», у анонимной функции — «async »): заголовок V8 «имя: текст» за
+// кадр не сойдёт. Место — URL со схемой, [native code] или кадр Wasm у JSC:
+// wasm-function[N] с именем модуля или без, у WebKit до 2025-08 — [wasm code]
+// (имя тогда «модуль.wasm-function[N]»). Голый [native code] — тоже кадр
+const FRAME_NAME = [
+  String.raw`[^\s@]*`,
+  '(?:global|eval|module) code',
+  String.raw`async [^\s@]*`,
+].join('|');
+const FRAME_PLACE = [
+  String.raw`[a-z][a-z0-9+.-]*:\S+`,
+  String.raw`\[native code\]`,
+  String.raw`\[wasm code\]`,
+  String.raw`(?:[^\s@:[\]]+:)?wasm-function\[\d+\]`,
+].join('|');
+const AT_FRAME = new RegExp(
+  String.raw`^(?:(?:${FRAME_NAME})@(?:${FRAME_PLACE})|\[native code\])$`,
+  'i',
+);
+const STACK_SCAN = 10 * MAX_STACK;
+
+const stackFrames = (stack, message) => {
+  const lines = clip(stack, STACK_SCAN).split('\n');
+
+  // обрезка по STACK_SCAN рвёт последнюю строку: неполный кадр не
+  // распознала бы ни одна ветка, и весь стек свернулся бы в строку
+  if (stack.length > STACK_SCAN && lines.length > 1) {
+    lines.pop();
+  }
+
+  // SpiderMonkey/JavaScriptCore: стек — одни кадры, без заголовка; Firefox
+  // заканчивает его переводом строки
+  let end = lines.length;
+
+  while (end > 0 && lines[end - 1] === '') {
+    end -= 1;
+  }
+
+  const body = lines.slice(0, end);
+
+  if (body.length > 0 && body.every(line => AT_FRAME.test(line))) {
+    return body.join('\n');
+  }
+
+  const rest = lines.slice(message.split('\n').length);
+
+  if (rest.length > 0 && rest.every(line => V8_FRAME.test(line))) {
+    return rest.join('\n');
+  }
+
+  let start = lines.length;
+
+  while (start > 0 && V8_FRAME.test(lines[start - 1])) {
+    start -= 1;
+  }
+
+  return start < lines.length
+    ? lines.slice(start).join('\n')
+    : lines.join(' | ');
+};
+
+// сбой чат-команды → { kind, message, stack }. Не бросает: недоступный
+// message/toString — текст «[unprintable error]», недоступный стек — null.
+// Имя команды приходит из ввода игрока, текст — из кода игры, который вправе
+// вставить в него аргументы игрока: оба приводятся к одной строке и
+// обрезаются. V8 повторяет текст ошибки первой строкой стека — она
+// снимается, остаются кадры
+export function commandFailureReport(command, error) {
+  let text;
+  let stack = null;
+
+  try {
+    // message читается один раз: геттер мог бы вернуть разное
+    const message = error && error.message ? String(error.message) : '';
+
+    text = message || String(error);
+
+    if (error && typeof error.stack === 'string') {
+      stack = stackFrames(error.stack, message);
+      stack = cleanStack(stack) || null;
+    }
+  } catch {
+    text ??= '[unprintable error]';
+    stack = null;
+  }
+
+  const commandText = oneLine(command, 32);
+
+  return {
+    kind: 'error',
+    message: `chat command ${commandText} failed: ${oneLine(text, 400)}`,
+    stack,
+  };
+}

package/src/host/host.worker.js

@@ -152,6 +152,12 @@ async function onInit(room, handoff = null, checkpointBytes = null, seqFloor) {
   // ли отдать роль
   host.setHealthSink(health => self.postMessage({ type: 'health', health }));
 
+  // сбой кода игры, пойманный хостом (чат-команда): в журнал клиентских
+  // ошибок тем же сообщением, что и необработанный reject
+  host.setDiagnosticSink(report =>
+    self.postMessage({ type: 'diagnostic', ...report }),
+  );
+
   // в лобби личность игрока — claim identity-токена, проверенного по JWKS
   // мастера (Этап B3); свободного ввода имени в форме игры нет
   portMachine = new PortMachine({
@@ -238,7 +244,7 @@ function onDebug({ requestId, action }) {
   self.postMessage({ type: 'debug_result', requestId, result, error });
 }
 
-// журнал клиентских ошибок (plan/client-reports): необработанный reject в
+// журнал клиентских ошибок: необработанный reject в
 // Worker не всплывает в worker.onerror главного потока — пересылаем сами.
 // Отдельный тип сообщения: 'error' занят сбоем init и запускает откат эстафеты
 self.addEventListener('unhandledrejection', event => {
@@ -325,7 +331,7 @@ self.onmessage = async event => {
       host?.setRoom({ roomId: msg.hostId, roomSecret: msg.hostSecret });
       break;
 
-    // отладочный контур (этап 6 плана plan/done/ai-debug): единственный вход в
+    // отладочный контур: единственный вход в
     // авторитетную половину из главного потока — запрос/ответ по requestId
     case 'debug':
       onDebug(msg);

package/src/host/meta/SocketManager.js

@@ -311,8 +311,8 @@ export default class SocketManager {
   }
 
   /**
-   * Отправка отладочного лога хоста в консоль клиента (порт CONSOLE,
-   * этап 6 плана plan/done/ai-debug). Worker изолирован от DevTools вкладки —
+   * Отправка отладочного лога хоста в консоль клиента (порт CONSOLE).
+   * Worker изолирован от DevTools вкладки —
    * без этого канала его события в браузере не видны вовсе.
    * @param {string} socketId
    * @param {*} data

package/src/host/meta/core/CommandProcessor.js

@@ -4,11 +4,19 @@
 // разных играх может делать разное или отсутствовать вовсе; незнакомая
 // команда — COMMANDS_NOT_FOUND.
 //
-// Всё, что раньше разбирал движковый switch, доступно играм через контекст:
-// roundManager (смена ника, новый раунд, текущая карта), timerManager
-// (остаток времени карты), playerDataSync (ранг), chat, isDevMode.
+// Контекст команд: roundManager (новый раунд, текущая карта, смена карты),
+// timerManager (остаток времени карты), playerDataSync (ранг), chat,
+// isDevMode и остальные поля deps.
+//
+// Обработчик — код игры и вызывается под защитой: его сбой (исключение или
+// отклонённый промис) уходит в onError, матч продолжается.
 class CommandProcessor {
-  constructor(deps) {
+  /**
+   * @param {Object} deps - контекст игровых команд.
+   * @param {Object} [options]
+   * @param {Function} [options.onError] - (command, error) сбой обработчика.
+   */
+  constructor(deps, { onError = null } = {}) {
     this._chat = deps.chat;
 
     // контекст игровых команд (participants, chat, scripted, roundManager,
@@ -17,6 +25,7 @@ class CommandProcessor {
     this._ctx = deps;
 
     this._commands = new Map();
+    this._onError = onError;
   }
 
   /**
@@ -36,10 +45,31 @@ class CommandProcessor {
     const cmd = arr.shift();
     const handler = this._commands.get(cmd);
 
-    if (handler) {
-      handler(this._ctx, gameId, arr);
-    } else {
+    if (!handler) {
       this._chat.pushSystemByUser(gameId, 'COMMANDS_NOT_FOUND');
+
+      return;
+    }
+
+    // в Worker'е сбой стал бы необработанным reject'ом, в dedicated-процессе —
+    // uncaughtException, то есть падением матча всех игроков
+    try {
+      const result = handler(this._ctx, gameId, arr);
+
+      if (result && typeof result.then === 'function') {
+        result.then(null, error => this._fail(cmd, error));
+      }
+    } catch (error) {
+      this._fail(cmd, error);
+    }
+  }
+
+  // сбой приёмника не должен породить новый сбой
+  _fail(command, error) {
+    try {
+      this._onError?.(command, error);
+    } catch {
+      // приёмник молчит о своих сбоях
     }
   }
 }

package/src/lib/applyRoomOverrides.js

@@ -54,7 +54,7 @@ export function applyRoomOverrides(
     game.timers.mapTime = clampTime(room.mapTime);
   }
 
-  // dev-режим вкладки хоста (этап 6 плана plan/done/ai-debug): включает рекордер
+  // dev-режим вкладки хоста: включает рекордер
   // и хостовый CONSOLE-лог. Прод-бандл его не выставляет — поведение то же
   if (typeof room.isDevMode === 'boolean') {
     game.isDevMode = room.isDevMode;

package/src/lib/capabilities.js

@@ -43,7 +43,7 @@ export const ENGINE_CAPABILITIES = createRegistry('engine-capabilities', [
   // `SimCtx::map_body_state`) и доступ игры к телам карты по индексу
   // (хэндл, индекс по хэндлу, отключение тела)
   { value: 'map.bodyState', since: '0.34.0' },
-  // сервис пула `diagnostics` (журнал клиентских ошибок, plan/client-reports);
+  // сервис пула `diagnostics` (журнал клиентских ошибок);
   // опционален — игра не пишет его в `requires`
   { value: 'diagnostics', since: '0.35.0' },
   // контрольная точка хоста посреди раунда (host-migration этап 5):

package/src/lib/checkpointCodec.js

@@ -4,8 +4,7 @@
 //
 // Контейнер до сжатия: [u32 metaLen LE][meta JSON utf-8][байты дампа ядра];
 // весь буфер — gzip. Дамп ядра сам по себе JSON (serialize_state), и без
-// сжатия точка tanks весит ~420 КБ, с ним ~21 КБ (plan/host-migration,
-// spike-results).
+// сжатия точка tanks весит ~420 КБ, с ним ~21 КБ.
 
 import hostDefaults from '../config/hostDefaults.js';
 

package/src/lib/coreConfig.js

@@ -2,7 +2,7 @@ import { SNAPSHOT_FORMAT_VERSION } from '../config/opcodes.js';
 import hostDefaults from '../config/hostDefaults.js';
 import wsports from '../config/wsports.js';
 
-// Сборка JSON-конфига Rust-ядра (packages/engine/core + core/ в репозитории
+// Сборка JSON-конфига Rust-ядра (крейт vimp-engine-core + core/ в репозитории
 // игры, например vimp-tanks): движковая половина
 // (timeStep/mapScale/mapSetId/snapshot/seed) + игровая
 // (models/weapons/playerKeys/panel/friendlyFire) — форма {engine, game} из

package/src/lib/createHostRuntime.js

@@ -87,7 +87,7 @@ export async function createHostRuntime(room, options = {}) {
     // преемник собирает из них тот же конфиг ядра
     roomSettings: pickRoomSettings(room),
     mapsVersion: room?.mapsVersion ?? null,
-    // рекордер (этап 6 плана plan/done/ai-debug) кладёт seed в сценарий — без него
+    // рекордер кладёт seed в сценарий — без него
     // записанный матч невоспроизводим
     seed,
     ...hostOptions,

package/src/lib/gameId.js

@@ -1,6 +1,6 @@
 // Формат id игры — изоморфно: его проверяет мастер (реестр, раздача, каталог)
 // и клиентский роутер ссылок (client/lib/roomLink.js) до похода в сеть.
-// Значение обязано совпадать с packages/auth/src/config/auth.js:games
+// Значение обязано совпадать с games из конфига auth-сервиса
 // (см. master/gameRefs.js — он реэкспортирует отсюда)
 export const GAME_ID_PATTERN = /^[a-z][a-z0-9-]{1,30}$/;
 

package/src/lib/gamePlugin.js

@@ -7,8 +7,12 @@ import { createGameConfigView } from './gameConfigView.js';
 // entries.client из манифеста.
 
 // каталог всех игр мастера (GameCatalog, см. Этап 6.2) — массив манифестов
-export async function fetchGamesManifest(url = '/games/manifest.json') {
-  const res = await fetch(url);
+// doFetch подставляет клиент: загрузка страницы повторяет сбой сети
+export async function fetchGamesManifest(
+  url = '/games/manifest.json',
+  doFetch = fetch,
+) {
+  const res = await doFetch(url);
 
   if (!res.ok) {
     throw new Error(`games manifest: HTTP ${res.status}`);

package/src/lib/jwt.js

@@ -41,7 +41,7 @@ export function decodeJwtPayload(token) {
 }
 
 // Авторитетная проверка identity-токена (Этап B3): подпись RS256 по JWKS
-// central auth-сервиса (packages/auth), issuer и срок годности. Работает через
+// central auth-сервиса, issuer и срок годности. Работает через
 // Web Crypto API (crypto.subtle) — доступен в браузере, Worker'е хоста и в
 // Node ≥19 глобально, отдельной JWT-библиотеки не требует. Возвращает
 // проверенный payload ({ sub, nick, iss, exp, ... }) или бросает исключение.