vimp-engine 0.38.2 → 0.38.3

package/core/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "vimp-engine-core"
-version = "0.23.3"
+version = "0.23.4"
 edition = "2024"
 description = "VIMP engine simulation core: physics, map, snapshot framing, interpolation/prediction/raycast primitives, navigation utilities. No wasm-bindgen — the game crate builds the WASM ABI wrappers."
 license = "MIT"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vimp-engine",
-  "version": "0.38.2",
+  "version": "0.38.3",
   "description": "VIMP engine SDK: browser host and client runtime, standalone mode and CLI tools (vimp-sim, vimp-contract) for VIMP game plugins",
   "license": "MIT",
   "repository": {
@@ -35,6 +35,8 @@
     "!src/client/_*",
     "src/standalone",
     "src/devtools",
+    "!src/devtools/surface/abiParse.js",
+    "!src/devtools/surface/collect.js",
     "tests/fixtures",
     "core/Cargo.toml",
     "bin",

package/src/client/boot.js

@@ -11,8 +11,14 @@
 // window не вводим: они переживают перезагрузку бандла и ломают вторую
 // вкладку SDK в том же документе.
 
+import {
+  bodyReadFailure,
+  fetchRetrying,
+  isNetworkFailure,
+} from './lib/retryOnNetworkError.js';
+
 // эндпоинт режима: его отдаёт dedicated-сервер, у мастера его нет —
-// 404/сеть/мусор означают прод-лобби (обратная совместимость)
+// 404 и мусор означают прод-лобби; сбой сети — отказ загрузки
 const CONFIG_URL = '/config';
 
 // умолчание игрового WS dedicated-сервера: тот же хост, путь /game
@@ -65,23 +71,40 @@ export function resetBootConfig() {
 /**
  * Разрешает режим загрузки: инъекция SDK → GET /config → лобби.
  * @param {Function} [fetchImpl] - Реализация fetch (тесты подставляют свою).
- * @returns {Promise<Object>} Конфиг загрузки.
+ * @param {Object} [retry] - Параметры fetchRetrying (тесты отключают паузы).
+ * @returns {Promise<Object>} Конфиг загрузки; отклоняется NetworkFailure, если
+ *   сеть не ответила после повторов.
  */
-export async function resolveBootConfig(fetchImpl) {
+export async function resolveBootConfig(fetchImpl, retry) {
   if (bootConfig) {
     return bootConfig;
   }
 
   const doFetch = fetchImpl ?? ((...args) => fetch(...args));
+  let res = null;
 
   try {
-    const res = await doFetch(CONFIG_URL);
+    res = await fetchRetrying(doFetch, CONFIG_URL, retry);
+  } catch (e) {
+    // сети нет: режим неизвестен, и лобби здесь — догадка, а не факт
+    if (isNetworkFailure(e)) {
+      throw e;
+    }
+  }
 
-    if (res.ok) {
+  if (res?.ok) {
+    try {
       bootConfig = normalize(await res.json());
+    } catch (e) {
+      // мусор в JSON — лобби; обрыв при чтении тела — сбой сети
+      const failure = bodyReadFailure(e);
+
+      if (isNetworkFailure(failure)) {
+        throw failure;
+      }
+
+      bootConfig = null;
     }
-  } catch (e) {
-    // сети/эндпоинта нет — это и есть прод-лобби, шуметь не о чем
   }
 
   bootConfig = bootConfig ?? { mode: 'lobby' };

package/src/client/components/controller/ClientReports.js

@@ -2,7 +2,7 @@
 
 let clientReportsCtrl;
 
-// Контроллер журнала клиентских ошибок (plan/client-reports, этап 5):
+// Контроллер журнала клиентских ошибок:
 // связывает view-события с моделью, собственного сетевого I/O не делает
 export default class ClientReportsCtrl {
   constructor(model, view) {

package/src/client/components/controller/Games.js

@@ -95,7 +95,7 @@ export default class GamesCtrl {
   }
 
   approve({ id }) {
-    this._model.moderate(id, { status: 'approved' });
+    this._model.approve(id);
   }
 
   reject({ id, note }) {

package/src/client/components/model/ClientReports.js

@@ -4,7 +4,7 @@ import Publisher from '../../../lib/Publisher.js';
 
 let clientReportsModel;
 
-// Модель журнала клиентских ошибок в лобби (plan/client-reports, этап 5):
+// Модель журнала клиентских ошибок в лобби:
 // страницы журнала, фильтры и решение админа по строке. Как GamesModel,
 // сетевые запросы делает сама (простой REST к мастеру) и DOM не трогает.
 // Наружу — одно событие 'changed' с полным состоянием: список, счётчик,

package/src/client/components/model/Games.js

@@ -222,6 +222,24 @@ export default class GamesModel {
     await this.loadAdmin();
   }
 
+  // одобрение называет заявку, которую модератор видит в карточке
+  // (this._all — то, что нарисовано): переподанная после загрузки очереди
+  // заявка вернёт 409 moderationStale
+  async approve(id) {
+    const game = this._all.find(item => item.id === id);
+
+    if (!game) {
+      this._fail('admin', { error: 'unknownGame' });
+      return;
+    }
+
+    await this.moderate(id, {
+      status: 'approved',
+      expectedPendingVersion: game.pendingVersion ?? null,
+      expectedPendingRepoUrl: game.pendingRepoUrl ?? null,
+    });
+  }
+
   async moderate(id, patch) {
     const { ok, json } = await this._request(this._config.urls.moderate(id), {
       method: 'PATCH',
@@ -229,6 +247,12 @@ export default class GamesModel {
     });
 
     if (!ok) {
+      // карточка устарела: показать свежую и только потом отказ — иначе
+      // перерисовка сотрёт его тем же тиком
+      if (json?.error === 'moderationStale') {
+        await this.loadAdmin();
+      }
+
       this._fail('admin', json);
       return;
     }

package/src/client/components/view/ClientReports.js

@@ -57,7 +57,7 @@ function truncate(text, max) {
   return text.length > max ? `${text.slice(0, max - 1)}…` : text;
 }
 
-// Представление журнала клиентских ошибок (plan/client-reports, этап 5).
+// Представление журнала клиентских ошибок.
 //
 // ***** БЕЗОПАСНОСТЬ *****
 //

package/src/client/components/view/Games.js

@@ -19,6 +19,9 @@ const ERROR_MESSAGES = {
   gameExists: 'A game with this id already exists',
   tooManyGames: 'Too many submissions from one author',
   unknownGame: 'Game is not in the registry',
+  // автор переподал заявку, пока модератор смотрел карточку
+  moderationStale:
+    'The request changed while you were reviewing it — check the refreshed card',
   gamePublished: 'Published game — ask an admin to disable it first',
   unknownUser: 'No player with this nick',
   invalidGameId: 'Invalid game id',
@@ -270,6 +273,7 @@ export default class GamesView {
       );
       item.appendChild(this._line(this._statusLine(game)));
       this._appendRepo(item, game.repoUrl);
+      this._appendPendingRepo(item, game);
 
       if (game.moderatorNote) {
         item.appendChild(this._line(`Note: ${game.moderatorNote}`));
@@ -390,6 +394,7 @@ export default class GamesView {
       ),
     );
     this._appendRepo(item, game.repoUrl);
+    this._appendPendingRepo(item, game);
     item.appendChild(
       this._line(
         `Served: ${game.version ?? '—'}; requested: ${game.pendingVersion ?? '—'}` +
@@ -460,7 +465,7 @@ export default class GamesView {
   // принимает только http(s): href — единственное место представления, где
   // содержимое поля становится исполняемым (javascript:), и полагаться на
   // одну проверку на другой стороне сети тут не стоит
-  _appendRepo(item, url) {
+  _appendRepo(item, url, prefix = '') {
     if (typeof url !== 'string' || !/^https?:\/\//i.test(url)) {
       return;
     }
@@ -472,10 +477,23 @@ export default class GamesView {
     link.textContent = url;
     link.target = '_blank';
     link.rel = 'noopener noreferrer';
+
+    if (prefix) {
+      line.append(prefix);
+    }
+
     line.appendChild(link);
     item.appendChild(line);
   }
 
+  // адрес, который версия на модерации принесёт при одобрении: строка
+  // появляется, только если он отличается от текущего
+  _appendPendingRepo(item, game) {
+    if (game.pendingRepoUrl && game.pendingRepoUrl !== game.repoUrl) {
+      this._appendRepo(item, game.pendingRepoUrl, 'After approval: ');
+    }
+  }
+
   _statusLine(game) {
     const status = STATUS_TITLES[game.status] ?? game.status;
     const date = game.createdAt

package/src/client/components/view/Lobby.js

@@ -1,6 +1,5 @@
 import Publisher from '../../../lib/Publisher.js';
-import { ENGINE_PROJECT_URL, ENGINE_VERSION } from '../../lib/engineVersion.js';
-import { renderProjectLink } from '../../lib/footerLink.js';
+import { ENGINE_VERSION } from '../../lib/engineVersion.js';
 import { absoluteLink, formatRoomLink } from '../../lib/roomLink.js';
 
 // Singleton LobbyView
@@ -65,11 +64,6 @@ export default class LobbyView {
       version.textContent = ENGINE_VERSION;
     }
 
-    renderProjectLink(
-      document.getElementById(elems.linkId),
-      ENGINE_PROJECT_URL,
-    );
-
     // заголовок игры для "<TITLE> TOP-N" (SVG-ориентир) — задаётся controller'ом
     // при выборе игры (сама модель не хранит title манифеста)
     this._gameTitle = '';

package/src/client/debug.js

@@ -1,4 +1,4 @@
-// Браузерная половина отладочного контура (этап 6 плана plan/done/ai-debug).
+// Браузерная половина отладочного контура.
 //
 // Всё, что headless-прогон не воспроизводит — реальный WebRTC, PixiJS, живой
 // ввод человека — читается и записывается отсюда: `window.__vimpDebug`

package/src/client/lib/authApi.js

@@ -1,4 +1,4 @@
-// REST-клиент auth-сервиса (packages/auth): регистрация, сессия, OAuth,
+// REST-клиент auth-сервиса: регистрация, сессия, OAuth,
 // управление профилем. Без DOM; fetch инъектируется (тесты).
 //
 // Каждый метод возвращает { ok: true, status, data } или

package/src/client/lib/diagnostics.js

@@ -1,4 +1,4 @@
-// Журнал клиентских ошибок (plan/client-reports, этап 3): неперехваченные
+// Журнал клиентских ошибок: неперехваченные
 // ошибки и отклонения страницы, ошибки Worker'а хоста, нарушения CSP и явные
 // warn/capture плагинов уходят на свой же бокс (POST /client-reports), а тот
 // пересылает их в центральный журнал.
@@ -175,7 +175,7 @@ function noop() {}
  * @param {number} [opts.flushDelayMs=2000] - задержка первой отправки
  * @param {number} [opts.minIntervalMs=10000] - интервал между отправками по
  *   таймеру; прямой flush() его не ждёт
- * @returns {{ capture, warn, flush, setContext, install }}
+ * @returns {{ capture, ignore, warn, flush, setContext, install }}
  */
 export function createDiagnostics({
   url,
@@ -189,6 +189,7 @@ export function createDiagnostics({
   if (!url) {
     return {
       capture: noop,
+      ignore: noop,
       warn: noop,
       flush: noop,
       setContext: noop,
@@ -211,7 +212,7 @@ export function createDiagnostics({
   let busy = false;
 
   function record(item) {
-    const key = `${item.source}|${item.kind}|${item.code ?? item.message}|${topFrame(item.stack)}`;
+    const key = `${item.source}|${item.kind}|${item.code ?? item.message}|${item.code ? '' : topFrame(item.stack)}`;
     const at = now();
     const known = records.get(key);
 
@@ -276,8 +277,22 @@ export function createDiagnostics({
     }
   }
 
+  // ошибки, о которых вызывающий уже позаботился сам (сбой сети при
+  // загрузке): перехватчик окна их не записывает
+  const ignored = new WeakSet();
+
+  function ignore(error) {
+    if (error !== null && typeof error === 'object') {
+      ignored.add(error);
+    }
+  }
+
   function capture(error, { source = 'client', kind = 'error' } = {}) {
     guarded(() => {
+      if (error !== null && typeof error === 'object' && ignored.has(error)) {
+        return;
+      }
+
       const raw =
         error !== null && error !== undefined && error.message !== undefined
           ? error.message
@@ -485,5 +500,5 @@ export function createDiagnostics({
     };
   }
 
-  return { capture, warn, flush, setContext, install };
+  return { capture, ignore, warn, flush, setContext, install };
 }

package/src/client/lib/engineVersion.js

@@ -7,11 +7,5 @@
 // бандлу (в npm-тарболле vimp-engine package.json есть всегда, поэтому
 // standalone SDK собирается у игры тем же импортом).
 import pkg from '../../../package.json' with { type: 'json' };
-import { resolveProjectUrl } from '../../lib/packageLink.js';
 
 export const ENGINE_VERSION = pkg.version;
-
-// адрес проекта для ссылки в футере лобби — то же поле, что мастер отдаёт
-// про пакет игры (GameCatalog.packageUrl), чтобы оба футера строил один
-// projectLink
-export const ENGINE_PROJECT_URL = resolveProjectUrl(pkg);

package/src/client/lib/footerLink.js

@@ -1,29 +1,30 @@
-import { projectLink } from '../../lib/packageLink.js';
-
-// Ссылка в футере лобби и формы входа. Один рендер на оба экрана: лобби
-// подставляет адрес проекта движка, форма входа — адрес игры из манифеста.
-//
-// Адреса нет (пакет не объявил repository/homepage) — якорь гасится, а не
-// прячется: ячейка футера остаётся пустой, и раскладка space-between не едет.
+// Ссылка на документацию в футере формы входа игры. Показывается только в
+// dev-сборке: разработчик игры при локальном запуске видит, где читать
+// документацию, а игрок на проде — нет. Футер лобби несёт ту же ссылку
+// статичной разметкой (lobby.pug). Тот же адрес — литералом в lobby.pug и в
+// `homepage` пакета; совпадение сторожит tests/client/footerLink.test.js.
+export const DOCS_URL = 'https://docs.vimp.lgick.dev';
 
 /**
  * @param {HTMLAnchorElement|null} anchor - якорь футера
- * @param {string|null} url - адрес проекта (resolveProjectUrl)
+ * @param {boolean} enabled - true только в dev-сборке
  */
-export function renderProjectLink(anchor, url) {
+export function renderDocsLink(anchor, enabled) {
   if (!anchor) {
     return;
   }
 
-  const link = projectLink(url);
-
-  if (!link) {
+  if (!enabled) {
     anchor.textContent = '';
     anchor.removeAttribute('href');
+    anchor.removeAttribute('target');
+    anchor.removeAttribute('rel');
 
     return;
   }
 
-  anchor.textContent = link.label;
-  anchor.href = link.url;
+  anchor.textContent = 'docs';
+  anchor.href = DOCS_URL;
+  anchor.target = '_blank';
+  anchor.rel = 'noopener';
 }

package/src/client/lib/retryOnNetworkError.js

@@ -0,0 +1,60 @@
+// Повтор запроса загрузки при сбое сети. fetch отклоняется TypeError'ом,
+// только когда ответа нет вовсе (обрыв, смена сети, вкладка из фона);
+// HTTP-статус и разбор ответа сбоем сети не являются и не повторяются.
+// Повторяется только сам вызов fetch: TypeError из разбора ответа — ошибка
+// кода, а не сети.
+
+// паузы перед повторами: три запроса, отказ не позже ~2 с сверх самих запросов
+export const BOOT_RETRY_DELAYS_MS = [500, 1500];
+
+const defaultSleep = ms => new Promise(resolve => setTimeout(resolve, ms));
+
+/** Сбой сети, оставшийся после повторов; отличает его от ошибок кода. */
+export class NetworkFailure extends Error {
+  constructor(cause) {
+    super(cause?.message ?? 'Network failure', { cause });
+    this.name = 'NetworkFailure';
+  }
+}
+
+export const isNetworkFailure = error => error instanceof NetworkFailure;
+
+/**
+ * Оборачивает отказ чтения тела ответа: SyntaxError — это мусор в JSON,
+ * любой другой отказ (TypeError обрыва) — сбой сети.
+ * @param {Error} error
+ * @returns {Error}
+ */
+export const bodyReadFailure = error =>
+  error instanceof SyntaxError ? error : new NetworkFailure(error);
+
+/**
+ * @param {Function} doFetch - (...args) => Promise<Response>: сам fetch.
+ * @param {*} url
+ * @param {Object} [options]
+ * @param {number[]} [options.delaysMs] - паузы перед повторами, мс.
+ * @param {Function} [options.sleep] - (ms) => Promise (тесты подставляют свою).
+ * @returns {Promise<Response>} ответ первой удавшейся попытки; отклоняется
+ *   NetworkFailure, когда сеть не ответила во всех попытках.
+ */
+export async function fetchRetrying(
+  doFetch,
+  url,
+  { delaysMs = BOOT_RETRY_DELAYS_MS, sleep = defaultSleep } = {},
+) {
+  for (let attempt = 0; ; attempt += 1) {
+    try {
+      return await doFetch(url);
+    } catch (e) {
+      if (!(e instanceof TypeError)) {
+        throw e;
+      }
+
+      if (attempt >= delaysMs.length) {
+        throw new NetworkFailure(e);
+      }
+
+      await sleep(delaysMs[attempt]);
+    }
+  }
+}

package/src/client/main.js

@@ -32,7 +32,7 @@ import {
   bindLiveErrors,
 } from './lib/formBuilder.js';
 import { normalizeAuthParams } from './lib/authParams.js';
-import { renderProjectLink } from './lib/footerLink.js';
+import { renderDocsLink } from './lib/footerLink.js';
 import { createGameActivator } from './lib/gameActivator.js';
 import createAutostart from './lib/autostart.js';
 import { applyCatalogState } from './lib/catalogState.js';
@@ -46,6 +46,7 @@ import { createContextTracker } from './lib/contextTracker.js';
 import { createLocalPlayer } from './lib/localPlayer.js';
 import { createAccolades } from './lib/accolades.js';
 import { createDiagnostics } from './lib/diagnostics.js';
+import { fetchRetrying, isNetworkFailure } from './lib/retryOnNetworkError.js';
 import { dispatchSocketMessage } from './lib/socketDispatch.js';
 import { pickActiveGame, isGameAvailable } from './lib/pickActiveGame.js';
 import { readCoreAbi, dispatchCoreOp, ABI_UNKNOWN } from '../lib/coreAbi.js';
@@ -183,13 +184,25 @@ function bindActiveGame(manifest, plugin) {
 const injectedBoot = getBootConfig();
 const manifestPromise = injectedBoot
   ? null
-  : fetchGamesManifest(lobbyConfig.gamesManifestUrl).catch(err => err);
+  : fetchGamesManifest(lobbyConfig.gamesManifestUrl, (...args) =>
+      fetchRetrying(fetch, ...args),
+    ).catch(err => err);
+
+let boot;
+
+try {
+  boot = injectedBoot ?? (await resolveBootConfig());
+} catch (e) {
+  // сети нет и режим неизвестен: репортёр ещё не создан (ему нужен режим),
+  // игроку остаётся надпись отказа
+  showBootFailure(`Failed to load the game: ${e.message}`);
+  throw e;
+}
 
-const boot = injectedBoot ?? (await resolveBootConfig());
 const bootMode = boot.mode;
 const isLobbyMode = bootMode === 'lobby';
 
-// журнал клиентских ошибок (plan/client-reports): ставится как можно
+// журнал клиентских ошибок: ставится как можно
 // раньше, чтобы ловить и сбои самого старта. Лобби и dedicated шлют на
 // свой бокс; SDK (solo) — только если встраивающий передал reportUrl
 const diagnostics = createDiagnostics({
@@ -273,6 +286,12 @@ try {
   }
 } catch (e) {
   showBootFailure(`Failed to load the game: ${e.message}`, gameContainer);
+
+  // сбой сети — не ошибка кода: в журнал он не уходит
+  if (isNetworkFailure(e)) {
+    diagnostics.ignore(e);
+  }
+
   throw e;
 }
 
@@ -348,8 +367,8 @@ const renderContexts = {};
 // контекста (хост её повторно не пришлёт)
 let lastMapData = null;
 
-// dev-сборка (Vite подставляет константу): включает отладочный контур этапа 6
-// плана plan/done/ai-debug — рекордер в комнате и window.__vimpDebug. В прод-бандле
+// dev-сборка (Vite подставляет константу): включает отладочный контур —
+// рекордер в комнате и window.__vimpDebug. В прод-бандле
 // ветка вырезается сборкой, поведение не меняется
 const isDevBuild =
   typeof import.meta.env !== 'undefined' && import.meta.env.DEV === true;
@@ -527,7 +546,7 @@ socketMethods[PS_CONFIG_DATA] = async data => {
       // part, объявивший сервис в componentDependencies, строит URL сам —
       // движок не знает ни имён файлов, ни их раскладки внутри пакета
       assetsBase: activeGameManifest.assetsBase,
-      // журнал клиентских ошибок для партов игры (plan/client-reports):
+      // журнал клиентских ошибок для партов игры:
       // warn(code, details) — своё предупреждение, capture(error) — пойманная
       // ошибка. Сервис опционален: игра не пишет его в requires
       diagnostics: {
@@ -577,21 +596,19 @@ socketMethods[PS_AUTH_DATA] = data => {
 
   document.getElementById('logo').textContent = texts?.title || 'VIMP';
 
-  // футер формы входа: версия и ссылка пакета ИГРЫ. Здесь, а не в AuthView:
-  // его elems приходят из authSchema.elems игрового плагина, и футер каркаса
-  // — не его забота. Метаданные кладёт в манифест мастер (GameCatalog читает
-  // package.json пакета); в standalone-манифесте их может не быть — тогда
-  // ячейки пустые, раскладку space-between это не ломает
+  // футер формы входа: версия пакета ИГРЫ и (в dev-сборке) ссылка на
+  // документацию. Здесь, а не в AuthView: его elems приходят из
+  // authSchema.elems игрового плагина, и футер каркаса — не его забота.
+  // Версию кладёт в манифест мастер (GameCatalog читает package.json
+  // пакета); в standalone-манифесте её может не быть — тогда ячейка пустая,
+  // раскладку space-between это не ломает
   const authVersion = document.getElementById('auth-version');
 
   if (authVersion) {
     authVersion.textContent = activeGameManifest?.packageVersion ?? '';
   }
 
-  renderProjectLink(
-    document.getElementById('auth-package-link'),
-    activeGameManifest?.packageUrl,
-  );
+  renderDocsLink(document.getElementById('auth-docs-link'), isDevBuild);
 
   // память клиента (localStorage) + принудительное значение поля с
   // единственным вариантом. Здесь, а не в AuthView: solo-путь ниже отвечает
@@ -1034,7 +1051,7 @@ socketMethods[PS_RESUME_RESULT] = data => {
 };
 
 // console: логи авторитетной половины (Worker изолирован от DevTools вкладки —
-// иначе его события в браузере не видны вовсе, этап 6 плана plan/done/ai-debug)
+// иначе его события в браузере не видны вовсе)
 socketMethods[PS_CONSOLE] = data => {
   console.log(`${DEBUG_PREFIX}[host]`, data);
 };
@@ -2478,7 +2495,7 @@ function initLobby() {
   // сам, по нику из VIMP_ADMIN_NICKS
   games.setAdmin(lobbyAuthModel.getRole() === 'admin');
 
-  // журнал клиентских ошибок (plan/client-reports, этап 5): кнопку «Errors»
+  // журнал клиентских ошибок: кнопку «Errors»
   // видит только админ; фильтр по игре — каталог вкладки
   const clientReportsModel = new ClientReportsModel(
     lobbyConfig.clientReports,

package/src/client/network/HiddenHostHealthLog.js

@@ -7,8 +7,14 @@
 // Эпизод закрывается возвратом видимости, потерей роли хоста или
 // выгрузкой страницы (flush). Следующие эпизоды той же сессии журнал
 // склеивает с первым: растёт счётчик, details остаются первого — осознанно.
-// Эпизод без единой метрики (матч стоял, скрытие короче окна цикла) не
-// пишется. Без DOM: видимость сообщает владелец.
+// Пишется только эпизод, в котором матч просел (потеряно время или частота
+// ниже порога), это задело удалённых игроков (peers > 0), а передача хоста
+// не началась без видимой причины (handoff 'unexplained'): просадка без
+// игроков, ожидаемый отказ (нет преемника, срок роли, кулдаун, выключено) и
+// начатая передача — штатный троттлинг, а сводка здорового эпизода заняла бы
+// место details первой записи. Эпизод без единой метрики (матч стоял,
+// скрытие короче окна цикла) не пишется. Без DOM: видимость и исход
+// передачи сообщает владелец.
 
 export const HIDDEN_HEALTH_CODE = 'engine.host.hiddenHealth';
 
@@ -16,11 +22,22 @@ export default class HiddenHostHealthLog {
   /**
    * @param {Object} options
    * @param {Function} options.warn - (code, summary) запись в журнал.
+   * @param {number} options.minHealthyTickRate - ниже — эпизод просел.
+   * @param {Function} options.handoffOutcome - () => исход автопередачи
+   *   (HostHealthPolicy.hiddenHandoff).
    * @param {boolean} [options.hidden] - вкладка скрыта в момент создания.
    * @param {Function} [options.now] - монотонные часы, мс.
    */
-  constructor({ warn, hidden = false, now = () => performance.now() }) {
+  constructor({
+    warn,
+    minHealthyTickRate,
+    handoffOutcome,
+    hidden = false,
+    now = () => performance.now(),
+  }) {
     this._warn = warn;
+    this._minHealthyTickRate = minHealthyTickRate;
+    this._handoffOutcome = handoffOutcome;
     this._now = now;
     this._episode = null;
 
@@ -35,6 +52,7 @@ export default class HiddenHostHealthLog {
         minTickRate: Infinity,
         maxGapMs: 0,
         lostMs: 0,
+        peers: 0,
       };
     } else if (!hidden) {
       this.flush();
@@ -53,6 +71,11 @@ export default class HiddenHostHealthLog {
     episode.minTickRate = Math.min(episode.minTickRate, health.tickRate);
     episode.maxGapMs = Math.max(episode.maxGapMs, health.maxGapMs);
     episode.lostMs += health.lostMs;
+
+    // peers — по просевшим метрикам: сколько игроков задела просадка
+    if (health.lostMs > 0 || health.tickRate < this._minHealthyTickRate) {
+      episode.peers = Math.max(episode.peers, health.peerCount ?? 0);
+    }
   }
 
   // закрыть эпизод (если идёт) и записать сводку
@@ -65,12 +88,26 @@ export default class HiddenHostHealthLog {
       return;
     }
 
+    // peers считается по просевшим метрикам: 0 — здоровый эпизод либо
+    // просадка без удалённых игроков
+    if (episode.peers === 0) {
+      return;
+    }
+
+    const handoff = this._handoffOutcome();
+
+    if (handoff !== 'unexplained') {
+      return;
+    }
+
     this._warn(HIDDEN_HEALTH_CODE, {
       hiddenMs: Math.round(this._now() - episode.startedAt),
       samples: episode.samples,
       minTickRate: episode.minTickRate,
       maxGapMs: episode.maxGapMs,
       lostMs: episode.lostMs,
+      peers: episode.peers,
+      handoff,
     });
   }
 }