vimp-engine 0.38.1 → 0.38.3

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-путь ниже отвечает
@@ -934,7 +951,8 @@ socketMethods[PS_GAME_INFORM_DATA] = data => {
 };
 
 // проигрывает shimmer-волну по логотипу в начале раунда; логотип живёт вне
-// PanelView.containerId, поэтому панель им не управляет (см. docs/en/client.md)
+// PanelView.containerId, поэтому панель им не управляет
+// (см. docs.vimp.lgick.dev/en/client-api)
 const playLogoRoundStart = () => {
   const logo = document.getElementById('logo');
 
@@ -1033,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);
 };
@@ -2182,8 +2200,8 @@ let roomFormFields = new Map();
 let roomFormDescriptors = [];
 
 // генерирует форму создания комнаты по явной схеме манифеста (roomForm,
-// docs/en/plugin-api.md "Form schema") — движок не выводит контролы из типа
-// значения, схема плагина полностью описывает форму
+// docs.vimp.lgick.dev/en/plugin-api "Form schema") — движок не выводит контролы
+// из типа значения, схема плагина полностью описывает форму
 function populateRoomForm(manifest) {
   const container = document.getElementById(lobbyConfig.elems.fieldsId);
 
@@ -2477,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,
@@ -2569,13 +2587,13 @@ function initLobby() {
   hostBtn?.addEventListener('click', async () => {
     // валидация (pattern/required/min/max) — единственная граница
     // room-формы: она едет клиенту как JSON манифеста, JS-валидаторы
-    // (как в auth-форме) туда не сериализуются (docs/en/plugin-api.md
-    // "Form schema"); авторитетный клампинг всё равно в applyRoomOverrides.js
-    // (вызывается из host.worker.js при создании комнаты). Проверяем до
-    // активации игры: неверная форма не должна стоить загрузки плагина.
-    // arm() и рисует ошибки, и снимает фильтр «только тронутые поля»: клик —
-    // это ответ за форму целиком, включая поля, которых игрок не касался.
-    // Он же чистит блок, когда ошибок нет
+    // (как в auth-форме) туда не сериализуются
+    // (docs.vimp.lgick.dev/en/plugin-api "Form schema"); авторитетный клампинг
+    // всё равно в applyRoomOverrides.js (вызывается из host.worker.js при
+    // создании комнаты). Проверяем до активации игры: неверная форма не должна
+    // стоить загрузки плагина. arm() и рисует ошибки, и снимает фильтр «только
+    // тронутые поля»: клик — это ответ за форму целиком, включая поля, которых
+    // игрок не касался. Он же чистит блок, когда ошибок нет
     if (liveErrors.arm().length) {
       return;
     }

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

package/src/client/network/HostController.js

@@ -56,7 +56,7 @@ export default class HostController {
    * @param {Function} [opts.onLobbyInfoChange] - смена строки карточки
    *   комнаты в лобби (string|null) — для актуализации info у мастера.
    * @param {Object} [opts.diagnostics] - журнал клиентских ошибок
-   *   (lib/diagnostics.js, plan/client-reports): туда уходят ошибки Worker'а.
+   *   (lib/diagnostics.js): туда уходят ошибки Worker'а.
    * @param {Uint8Array} [opts.checkpoint] - сжатая контрольная точка
    *   (host-migration этап 5): Worker поднимает матч из неё на паузе, старт —
    *   startAfterRestore(). Буфер передаётся списком переноса — после
@@ -114,7 +114,7 @@ export default class HostController {
     // подписчики метрик здоровья хоста (host-migration этап 9a)
     this._healthListeners = new Set();
 
-    // отладочные запросы в Worker (этап 6 плана plan/done/ai-debug):
+    // отладочные запросы в Worker:
     // requestId → { resolve, reject }
     this._debugRequests = new Map();
     this._debugRequestId = 0;
@@ -149,7 +149,7 @@ export default class HostController {
         });
   }
 
-  // журнал клиентских ошибок (plan/client-reports): неперехваченная ошибка
+  // журнал клиентских ошибок: неперехваченная ошибка
   // Worker'а приходит сюда. preventDefault не зовётся — консольный вывод
   // браузера остаётся как есть
   _watchWorkerErrors(worker) {
@@ -456,7 +456,7 @@ export default class HostController {
   }
 
   /**
-   * Отладочный контур (этап 6 плана plan/done/ai-debug): начинает запись живого
+   * Отладочный контур: начинает запись живого
    * матча в формат сценария headless-runner'а.
    * @returns {Promise<boolean>} false — dev-режим в комнате выключен.
    */

package/src/client/network/HostHealthPolicy.js

@@ -56,6 +56,7 @@ export default class HostHealthPolicy {
     this._successor = false;
     this._hiddenSince = null;
     this._hiddenTimer = null;
+    this._hiddenOutcome = null;
     this._lastAutoAt = null;
     this._cooldownBefore = null;
     this._samples = [];
@@ -80,6 +81,12 @@ export default class HostHealthPolicy {
     this._successor = false;
     this._resetSamples();
 
+    // исход прошлой роли уже прочитан её журналом (flush при потере роли);
+    // новой роли он не принадлежит
+    if (isHost) {
+      this._hiddenOutcome = null;
+    }
+
     // роль получена скрытой вкладкой: скрытие отсчитывается от получения
     if (isHost && this._hiddenSince !== null) {
       this._hiddenSince = this._hostSince;
@@ -98,6 +105,7 @@ export default class HostHealthPolicy {
   setHidden(hidden) {
     if (hidden && this._hiddenSince === null) {
       this._hiddenSince = this._now();
+      this._hiddenOutcome = null;
       this._armHiddenTimer();
     } else if (!hidden) {
       this._hiddenSince = null;
@@ -105,6 +113,19 @@ export default class HostHealthPolicy {
     }
   }
 
+  /**
+   * Исход передачи для последнего эпизода скрытия (живёт до следующего
+   * скрытия или новой роли хоста, переживает возврат видимости и потерю
+   * роли — его читает журнал закрываемого эпизода): null — порог
+   * hiddenHandoffMs не достигнут; 'started' — передача началась;
+   * 'disabled' | 'no-successor' | 'blocked' (срок роли или кулдаун) —
+   * ожидаемый отказ; 'unexplained' — всё разрешено, а передача не началась.
+   * @returns {string|null}
+   */
+  hiddenHandoff() {
+    return this._hiddenOutcome;
+  }
+
   // сэмпл здоровья Worker'а
   addHealth(health) {
     if (this._hostSince === null || !health) {
@@ -182,6 +203,8 @@ export default class HostHealthPolicy {
     }
 
     if (this._handOverNow('hidden')) {
+      this._hiddenOutcome = 'started';
+
       return true;
     }
 
@@ -191,9 +214,27 @@ export default class HostHealthPolicy {
       this._armHiddenTimer(waitMs);
     }
 
+    // начатая передача исход не меняет: следующие проверки её уже не стартуют
+    if (this._hiddenOutcome !== 'started') {
+      this._hiddenOutcome = this._refusal(waitMs);
+    }
+
     return false;
   }
 
+  // почему передача со скрытой вкладки не началась
+  _refusal(waitMs) {
+    if (!this._enabled()) {
+      return 'disabled';
+    }
+
+    if (!this._successor) {
+      return 'no-successor';
+    }
+
+    return waitMs > 0 ? 'blocked' : 'unexplained';
+  }
+
   // немедленная передача: ждущую границы — ускорить, иначе начать
   _handOverNow(reason) {
     if (!this._enabled() || !this._successor) {

package/src/client/network/InlineHostBridge.js

@@ -11,7 +11,7 @@ import { createGuestIdentity } from '../../host/identity.js';
 // Почему inline, а не Worker: HostPlugin принципиально непередаваем в Worker
 // (postMessage не несёт функции), а standalone SDK получает от репозитория
 // игры именно живой объект плагина. Прод-путь (хост в Worker'е) не меняется —
-// расхождение dev/prod осознанное, см. plan/standalone-sdk/README.md.
+// расхождение dev/prod осознанное.
 //
 // Мастера в этом контуре нет: личность гостевая (ник из формы, identity.js),
 // профиль offline-заглушкой (lib/offlinePlayerData.js).
@@ -102,6 +102,13 @@ export default class InlineHostBridge {
 
     this._runtime = runtime;
 
+    // сбой чат-команды игры виден в консоли вкладки вместе с кадрами обработчика
+    runtime.host.setDiagnosticSink(report =>
+      console.error(
+        `[vimp] ${report.message}${report.stack ? `\n${report.stack}` : ''}`,
+      ),
+    );
+
     this._portMachine = new PortMachine({
       host: runtime.host,
       socketManager: runtime.socketManager,

package/src/client/network/WebSocketTransport.js

@@ -5,7 +5,7 @@ import Publisher from '../../lib/Publisher.js';
 // publisher с 'message'/'close', connect/send/close, — поэтому клиентский код
 // про него не знает.
 //
-// Отличия от WebRTC, которые надо держать в голове (см. docs/en/network.md):
+// Отличия от WebRTC, которые надо держать в голове:
 // разделения meta/state тут нет, флаг reliable игнорируется. Значит PING/PONG
 // идут надёжным каналом (замер RTT становится замером TCP-пути), а бэкпрешер
 // вместо дропа позиционных кадров живёт на серверной стороне.

package/src/client/session/HandoffFlow.js

@@ -261,6 +261,11 @@ export default class HandoffFlow {
     this._policy?.addHealth(health);
   }
 
+  // исход передачи для последнего эпизода скрытия (HostHealthPolicy)
+  hiddenHandoff() {
+    return this._policy?.hiddenHandoff() ?? null;
+  }
+
   // «Leave server» из меню комнаты (этап 8.3). Хост при других людях отдаёт
   // роль бете без отката и уходит; один в комнате — закрывает её
   // (host_leaving: людей нет — мастер закрывает комнату сразу). Гость

package/src/client/session/HostRole.js

@@ -321,11 +321,14 @@ export default class HostRole {
       onStats: this._debug ? stats => this._debug('standby sent', stats) : null,
     });
 
-    // метрики здоровья Worker'а (этап 9a): скрытая вкладка троттлит цикл —
-    // насколько, уходит в журнал одной сводкой за эпизод
+    // метрики здоровья Worker'а: эпизод скрытия, в котором матч просел,
+    // задел удалённых игроков, а автопередача не началась без видимой
+    // причины, уходит в журнал одной сводкой (HiddenHostHealthLog)
     this._hiddenLog = this._factories.hiddenLog({
       warn: (code, summary) =>
         this._diagnostics.warn(code, summary, { source: 'client' }),
+      minHealthyTickRate: migration.auto.overloadTickRate,
+      handoffOutcome: () => this._getHandoff().hiddenHandoff(),
       hidden: this._ui.isHidden(),
     });
     this._healthReporter = this._isLobbyMode

package/src/client/style.css

@@ -1,10 +1,9 @@
 @charset "UTF-8";
 
-/* База страницы: раньше жила инлайном в packages/engine/index.html, но в
-   репозитории игры этого файла нет — а без правил ниже интерфейс движка
-   остался бы без своей типографики и раскладки. Standalone SDK импортирует
-   этот файл целиком, поэтому всё, что здесь есть, применяется и к
-   встраивающей странице. */
+/* База страницы: типографика и раскладка интерфейса движка живут здесь, а
+   не в index.html, потому что в репозитории игры такого файла нет.
+   Standalone SDK импортирует этот файл целиком, поэтому всё, что здесь
+   есть, применяется и к встраивающей странице. */
 html,
 body {
   width: 100%;
@@ -1329,7 +1328,7 @@ body.hide-cursor {
   color: #d66;
 }
 
-/* журнал клиентских ошибок (plan/client-reports, этап 5): тот же каркас и
+/* журнал клиентских ошибок: тот же каркас и
    палитра, что у панели реестра игр; графы — .games-filters/.games-filter-btn */
 #reports-panel {
   background-color: #222;

package/src/client/views/gameShell.js

@@ -55,9 +55,9 @@ const SHELL = [
             tag: 'div',
             id: 'auth-link',
             children: [
-              // ссылка и версия пакета ИГРЫ — заполняет main.js по AUTH_DATA
-              // из метаданных пакета в манифесте
-              { tag: 'p', children: [{ tag: 'a', id: 'auth-package-link' }] },
+              // версия пакета ИГРЫ (из манифеста) и ссылка на документацию
+              // (только в dev-сборке) — заполняет main.js по AUTH_DATA
+              { tag: 'p', children: [{ tag: 'a', id: 'auth-docs-link' }] },
               { tag: 'p', id: 'auth-version' },
               { tag: 'p', text: `© ${new Date().getFullYear()} VIMP` },
             ],

package/src/client/views/includes/auth.pug

@@ -15,10 +15,10 @@ div#auth
     div#auth-informs
 
     div#auth-link
-      //- ссылка и версия пакета ИГРЫ (мастер кладёт их в манифест, читая
-      //- package.json пакета) — проставляет main.js по AUTH_DATA; без данных
-      //- ячейки остаются пустыми
+      //- версия пакета ИГРЫ (мастер кладёт её в манифест, читая package.json
+      //- пакета) и ссылка на документацию (только в dev-сборке) —
+      //- проставляет main.js по AUTH_DATA; без данных ячейки остаются пустыми
       p
-        a#auth-package-link
+        a#auth-docs-link
       p#auth-version
       p © #{new Date().getFullYear()} VIMP

package/src/client/views/includes/lobby.pug

@@ -21,7 +21,7 @@ div#lobby(style='display:none')
             input#profile-open(type='button', value='Profile')
             input#games-open-mine(type='button', value='My games')
             input#games-open-moderation(type='button', value='Moderation', style='display:none')
-            //- журнал клиентских ошибок (plan/client-reports, этап 5): только админ
+            //- журнал клиентских ошибок: только админ
             input#reports-open(type='button', value='Errors', style='display:none')
         hr.lobby-divider
         h3.lobby-section-title= 'HOST A GAME'
@@ -32,7 +32,8 @@ div#lobby(style='display:none')
             label.form-label(for='lobby-game')= 'Select game'
             select#lobby-game.field-select
           //- поля настроек комнаты генерируются по явной схеме roomForm
-          //- манифеста активной игры (docs/en/plugin-api.md "Form schema")
+          //- манифеста активной игры (docs.vimp.lgick.dev/en/plugin-api "Form
+          //- schema")
           div#lobby-fields
           //- ошибки формы (formBuilder.renderFormErrors) и отказ загрузки
           //- плагина выбранной игры — строкой в форме, а не в #tech-informer:
@@ -66,8 +67,8 @@ div#lobby(style='display:none')
               span#leaderboard-total
             ol#lobby-leaderboard-list
             p#lobby-my-placement
-    //- футер: ссылку и версию пакета движка проставляет LobbyView
-    //- (engineVersion.js + lib/packageLink.js)
+    //- футер: ссылка на документацию статична, версию пакета движка
+    //- проставляет LobbyView (engineVersion.js)
     div#lobby-footer
       p
         a#lobby-terms-link(target='_blank', rel='noopener') Terms of Service
@@ -75,6 +76,6 @@ div#lobby(style='display:none')
         |
         a#lobby-privacy-link(target='_blank', rel='noopener') Privacy Policy
       p
-        a#lobby-link
+        a#lobby-link(href='https://docs.vimp.lgick.dev', target='_blank', rel='noopener') docs
       p#lobby-version
       p © #{new Date().getFullYear()} VIMP

package/src/client/views/includes/reports.pug

@@ -1,4 +1,4 @@
-//- Журнал клиентских ошибок (plan/client-reports, этап 5): только админ.
+//- Журнал клиентских ошибок: только админ.
 //- Панель скрыта по умолчанию — открывается кнопкой «Errors» бейджа
 //- пользователя (#lobby-user в lobby.pug); id элементов перечислены в
 //- config/lobby.js. Подписи — по-английски, как и остальное лобби

package/src/config/authClient.js

@@ -1,10 +1,9 @@
 // Конфиг клиента профиля лобби. Бандлится в клиентскую сборку, как
 // config/lobby.js — auth-сервис живёт на отдельном домене/порте, поэтому
-// serviceUrl подставляется под конкретный деплой при сборке (см.
-// docs/en/auth.md).
+// serviceUrl подставляется под конкретный деплой при сборке.
 export default {
-  // базовый URL центрального auth-сервиса (packages/auth). Дефолт — dev-порт
-  // из packages/auth/src/config/auth.js; в проде подставляется Vite'ом из
+  // базовый URL центрального auth-сервиса. Дефолт — dev-порт
+  // из конфига auth-сервиса; в проде подставляется Vite'ом из
   // VITE_AUTH_SERVICE_URL (см. Dockerfile — тот же VIMP_AUTH_SERVICE_URL,
   // что и серверный master/main.js). Этот модуль импортируется и серверным
   // master/main.js под чистым Node, где import.meta.env не определён —
@@ -15,7 +14,7 @@ export default {
     'http://localhost:3010',
 
   // issuer, которым central auth-сервис подписывает identity-токен; должен
-  // совпадать с packages/auth/src/config/auth.js: jwt.issuer — хост сверяет
+  // совпадать с jwt.issuer из конфига auth-сервиса — хост сверяет
   // claim iss токена с этим значением при проверке подписи по /jwks
   issuer: 'vimp-auth',
 

package/src/config/gameCodes.js

@@ -1,6 +1,6 @@
 // коды игровых информ-сообщений (порт GAME_INFORM_DATA, см.
-// docs/en/network.md) — общий контракт хоста (SocketManager) и клиента
-// (main.js): значение не должно расходиться между ними молча
+// docs.vimp.lgick.dev/en/snapshot) — общий контракт хоста (SocketManager) и
+// клиента (main.js): значение не должно расходиться между ними молча
 export default {
   winnerTeam: [0],
   roundStart: [1],

package/src/config/lobby.js

@@ -300,11 +300,11 @@ export default {
     joinRetryWindowMs: 45000,
   },
 
-  // приёмник выгрузок отладочного контура (этап 6 плана plan/done/ai-debug):
+  // приёмник выгрузок отладочного контура:
   // маршрут поднимается мастером только в dev, в проде вернёт 404
   debugReportUrl: '/debug/report',
 
-  // журнал клиентских ошибок (plan/client-reports): приём на том же боксе,
+  // журнал клиентских ошибок: приём на том же боксе,
   // что раздал страницу, — лобби-мастер или dedicated
   clientReportUrl: '/client-reports',
 
@@ -350,9 +350,8 @@ export default {
     myPlacementId: 'lobby-my-placement',
 
     // футер: версия npm-пакета движка, запечённая в бандл при сборке
-    // (client/lib/engineVersion.js), и ссылка на его страницу
+    // (client/lib/engineVersion.js)
     versionId: 'lobby-version',
-    linkId: 'lobby-link',
   },
 
   // реестр игр (master-game-registry, этап 4): заявка разработчика и панель
@@ -489,7 +488,7 @@ export default {
     },
   },
 
-  // журнал клиентских ошибок (plan/client-reports, этап 5): только админ.
+  // журнал клиентских ошибок: только админ.
   // URL и id элементов — здесь, как у панели реестра игр (reports.pug)
   clientReports: {
     urls: {

package/src/config/opcodes.js

@@ -1,6 +1,7 @@
 // Разметка бинарного snapshot-протокола (порт SHOT_DATA).
 // Единый источник для хоста (упаковка) и клиента (распаковка) — обе стороны
-// живут в Rust-ядре: packages/engine/core/src/snapshot.rs (pack) и packages/engine/core/src/client/unpack.rs.
+// живут в Rust-ядре: vimp-engine-core/src/snapshot.rs (pack) и
+// vimp-engine-core/src/client/unpack.rs.
 
 // версия контракта движок ↔ игра-плагин (GameManifest, HostPlugin,
 // ClientPlugin, Wasm Host ABI — docs/{en,ru}/plugin-api.md).

package/src/config/wsports.js

@@ -1,5 +1,5 @@
-// Номера портов JSON-канала (docs/en/network.md). Реестр append-only, как и
-// остальные словари плагинной поверхности (этап 3 плана
+// Номера портов JSON-канала (docs.vimp.lgick.dev/en/snapshot). Реестр
+// append-only, как и остальные словари плагинной поверхности (этап 3 плана
 // plugin-forward-compat): номер НИКОГДА не переиспользуется и не
 // перенумеровывается — уже опубликованная сборка игры шлёт и слушает те
 // номера, что видела при сборке, и её dist больше никто не тронет.