vimp-engine 0.38.2 → 0.38.3

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, ... }) или бросает исключение.

package/src/lib/packageLink.js

@@ -1,63 +1,31 @@
-// Ссылка на проект для футеров лобби и формы входа: движок показывает рядом
-// npm-версию, и клик по соседней ячейке ведёт на страницу проекта этого пакета.
+// Адрес проекта пакета — его `repository`: ссылка ведёт на саму игру, в том
+// числе закрытую. `homepage` не читается. Фолбэка нет: пакет без repository
+// адреса не получает — страница пакета в npm маскировала бы недостающие
+// метаданные. О пропущенном поле предупреждает правило контракта A7.
 //
-// Источник — `homepage` его package.json (иначе `repository`). Фолбэка нет:
-// пакет, не объявивший ни того, ни другого, ссылки не получает, и ячейка
-// футера остаётся пустой. Это сознательно — прежний фолбэк на страницу пакета
-// в npm давал разнобой («GitHub» у одной игры, «npm» у другой) и молча
-// маскировал недостающие метаданные вместо того, чтобы показать их отсутствие.
-// О пропущенном поле предупреждает правило контракта A7.
-//
-// Хостинг не ограничен github.com: подпись выводится из хоста, поэтому чужой
-// плагин на GitLab получает честную ссылку, а не пустую ячейку.
-//
-// Модуль изоморфный: мастер зовёт resolveProjectUrl для пакета игры
-// (GameCatalog), клиент — для собственного package.json движка
-// (client/lib/engineVersion.js).
+// Хостинг не ограничен github.com. Модуль изоморфный: мастер зовёт
+// resolveProjectUrl для метаданных пакета игры (адрес уходит в реестр игр),
+// devtools — для package.json игры (правило A7).
 
 /**
- * Адрес проекта из package.json, приведённый к https: homepage, иначе
- * repository.
+ * Адрес проекта из package.json, приведённый к http(s): поле repository.
  * @param {Object} pkg - разобранный package.json
- * @returns {string|null} https-URL либо null, если поля нет или это не адрес
+ * @returns {string|null} http(s)-URL либо null, если поля нет или это не адрес
  */
 export function resolveProjectUrl(pkg) {
   if (!pkg || typeof pkg !== 'object') {
     return null;
   }
 
-  const { homepage, repository } = pkg;
+  const { repository } = pkg;
 
   // repository бывает и строкой ("github:user/repo"), и объектом {type, url}
-  const declared =
-    typeof repository === 'string' ? repository : repository?.url;
-
-  // homepage важнее repository: поле repository обязано называть
-  // репозиторий публикации (его сверяет npm Trusted Publishing), и у пакета
-  // из закрытого репозитория такая ссылка отдаёт игроку 404
-  return normalize(homepage) ?? normalizeRepository(declared);
-}
-
-/**
- * Ссылка футера по готовому адресу проекта.
- * @param {string|null} [url] - результат resolveProjectUrl
- * @returns {{url: string, label: string}|null} null, если адреса нет
- */
-export function projectLink(url) {
-  // адрес перепроверяется, хотя свои вызовы приходят уже из
-  // resolveProjectUrl: функция — публичный экспорт ("./lib/*"), а результат
-  // уходит прямо в href якоря (client/lib/footerLink.js)
-  const value = typeof url === 'string' ? url.trim() : '';
-
-  if (!/^https?:\/\//.test(value)) {
-    return null;
-  }
-
-  return { url: value, label: labelFor(value) };
+  return normalizeRepository(
+    typeof repository === 'string' ? repository : repository?.url,
+  );
 }
 
-// шорткат "user/repo" — семантика поля repository (так его читает npm), в
-// homepage такая строка означала бы относительный путь, а не адрес на GitHub
+// шорткат "user/repo" — семантика поля repository (так его читает npm)
 function normalizeRepository(raw) {
   const value = typeof raw === 'string' ? raw.trim() : '';
 
@@ -94,6 +62,9 @@ function normalize(raw) {
 
   url = url.replace(/^git\+/, '');
 
+  // порт SSH (ssh://host:2222/…) к адресу https не относится
+  url = url.replace(/^(ssh:\/\/(?:[^/@]*@)?[^/:@]+):\d+(?=\/|$)/, '$1');
+
   // scp-форма git@host:user/repo (в том числе с лишним ssh://, как её
   // нередко пишет npm) — двоеточие здесь разделитель, не порт
   const scp = /^(?:ssh:\/\/)?git@([^:/]+):(.+)$/.exec(url);
@@ -117,22 +88,8 @@ function normalize(raw) {
       // в href он уехал бы в DOM и историю браузера
       .replace(/^(https?:\/\/)[^/@]*@/, '$1')
       .replace(/\.git(?=$|[#?])/, '')
-      // npm сам дописывает "#readme" в homepage при генерации package.json
+      // якорь #readme в адресе репозитория ссылке не нужен
       .replace(/#readme$/, '')
       .replace(/\/+$/, '')
   );
 }
-
-// подпись ячейки: у наших пакетов это всегда GitHub, у чужого хостинга —
-// его хост, чтобы подпись не врала об источнике
-function labelFor(url) {
-  let host;
-
-  try {
-    host = new URL(url).hostname.replace(/^www\./, '');
-  } catch {
-    return 'Website';
-  }
-
-  return host === 'github.com' ? 'GitHub' : host;
-}

package/src/lib/validators.js

@@ -13,7 +13,7 @@ const NAME_REGEXP = new RegExp('^[a-zA-Z]([\\w\\s#]{0,13})[\\w]{1}$');
 export const isValidName = name =>
   typeof name === 'string' && NAME_REGEXP.test(name);
 
-// ник профиля: копия правила auth-сервиса (packages/auth/src/lib/validators.js)
+// ник профиля: копия правила auth-сервиса (валидаторы auth-сервиса)
 // — общей рантайм-зависимости у пакетов нет. Строже isValidName: внутри ника
 // допустим только обычный пробел, не любой \s
 const NICK_REGEXP = new RegExp('^[a-zA-Z]([\\w #]{0,13})[\\w]{1}$');
@@ -272,8 +272,8 @@ export const clampLimit = (value, fallback, max) => {
 // на его стороне — минута (lobbyConfig.playerData.minFlushInterval), столько
 // игр в неё не влезает.
 //
-// Множитель СВЯЗАН с rank.maxPoints auth-сервиса (packages/auth/src/config/
-// auth.js): мастер не должен пропускать то, что auth отклонит. Отклонённое
+// Множитель СВЯЗАН с rank.maxPoints из конфига auth-сервиса: мастер
+// не должен пропускать то, что auth отклонит. Отклонённое
 // тело для хоста неустранимо — PlayerDataSync повторял бы его до конца жизни
 // комнаты, — поэтому при правке per-game maxGameScore проверяется и потолок
 // суммы на той стороне.

package/src/standalone/index.js

@@ -10,7 +10,7 @@ import { ensureGameShell } from '../client/views/gameShell.js';
 // репозитория игры — `npm run dev` открывает вкладку с работающим матчем без
 // мастера, без входа и без экрана лобби.
 //
-// Отличия от прода (осознанные, см. plan/standalone-sdk/README.md):
+// Отличия от прода (осознанные):
 //   - хост крутится в главном потоке (inline), а не в Worker'е: HostPlugin
 //     непередаваем постмесседжем, а SDK получает живой объект плагина;
 //   - личность гостевая (ник из формы или из playerName), рейтинг и

package/tests/fixtures/generations/gen-api3/README.md

@@ -1,7 +1,7 @@
 # gen-api3 — ЗАМОРОЖЕНО
 
 Снимок плагина 2026-08-29, поколение `engineApi: 3`.
-Не править: правка фикстуры маскирует слом совместимости
-(этап 1 плана `plan/plugin-forward-compat`). Новое поколение
+Не править: правка фикстуры маскирует слом совместимости.
+Новое поколение
 добавляется копированием текущего `../../miniGame`, а не правкой
 этого каталога.

package/tests/fixtures/generations/gen-api4/README.md

@@ -1,7 +1,7 @@
 # gen-api4 — ЗАМОРОЖЕНО
 
 Снимок плагина 2026-08-29, поколение `engineApi: 4`.
-Не править: правка фикстуры маскирует слом совместимости
-(этап 1 плана `plan/plugin-forward-compat`). Новое поколение
+Не править: правка фикстуры маскирует слом совместимости.
+Новое поколение
 добавляется копированием текущего `../../miniGame`, а не правкой
 этого каталога.