vimp-engine 0.38.2 → 0.39.0

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

@@ -1,17 +1,16 @@
 import { WARN, skip, verdict } from '../result.js';
 import { resolveProjectUrl } from '../../../lib/packageLink.js';
 
-// Игра без объявленного homepage/repository собирается и играется — это не
-// отказ. Но движок показывает ссылку на проект в футере формы входа, и берёт
-// он её только из этих полей (фолбэка нет, см. lib/packageLink.js): без них
-// ячейка футера у игроков останется пустой, а заметить это без подсказки негде.
+// Игра без объявленного repository собирается и играется — это не
+// отказ. Но реестр игр в лобби показывает ссылку на проект, и берёт он её
+// только из него (фолбэка нет, см. lib/packageLink.js): без них строка
+// игры останется без ссылки, а заметить это без подсказки негде.
 // Отсюда warn — под --strict он становится ошибкой.
 export default {
   id: 'A7',
   name: 'packageRepository',
   level: WARN,
-  title:
-    'package.json declares homepage or repository (the #auth footer links to it)',
+  title: 'package.json declares repository (the games registry links to it)',
 
   check(ctx) {
     if (!ctx.pkg) {
@@ -23,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/b11-voice-config.js

@@ -0,0 +1,34 @@
+import { inspectVoiceConfig } from '../../../lib/voiceConfig.js';
+import { WARN, skip, verdict } from '../result.js';
+
+// Блок voice необязателен: без него связь выключена. Но объявленный блок с
+// опечаткой — тихий откат на дефолт (или зажим числа). Разбор берётся из
+// lib/voiceConfig.js — того же модуля, что читает рантайм, иначе правило и
+// движок разошлись бы. Хуки voiceSounds/voiceFilter статически не
+// проверяются: их ответ виден только в браузере, и его проверяет рантайм.
+export default {
+  id: 'B11',
+  name: 'voiceConfig',
+  level: WARN,
+  title: 'the voice block is well-formed',
+
+  check(ctx) {
+    if (!ctx.gameConfig) {
+      return skip('no gameConfig');
+    }
+
+    if (ctx.gameConfig.voice === undefined || ctx.gameConfig.voice === null) {
+      return skip('no voice block — voice is off');
+    }
+
+    const { problems } = inspectVoiceConfig(ctx.gameConfig.voice);
+
+    // забытый enabled: блок есть, связи нет, и ни одно правило не скажет.
+    // enabled: false — осознанное выключение, не нарушение
+    if (ctx.gameConfig.voice.enabled === undefined) {
+      problems.push('voice block is declared but voice.enabled is not set');
+    }
+
+    return verdict(problems);
+  },
+};

package/src/devtools/contract/rules/c12-voice-hotkey.js

@@ -0,0 +1,70 @@
+import clientDefaults from '../../../config/clientDefaults.js';
+import { VOTE_ANSWER_KEYS } from '../../../config/voteKeys.js';
+import { inspectVoiceConfig } from '../../../lib/voiceConfig.js';
+import { ERROR, skip, verdict } from '../result.js';
+
+// Клавиша связи не должна совпасть ни с режимом/командой движка или игры,
+// ни с клавишей игрового набора: ControlsModel.addKey забирает её раньше
+// всех — совпавший режим (чат, стата, escape), команда или действие игры
+// перестали бы работать. Коды движка берутся из clientDefaults, а не
+// списком: правило не отстаёт от движка.
+export default {
+  id: 'C12',
+  name: 'voiceHotkey',
+  level: ERROR,
+  title: 'the push-to-talk key collides with no other key',
+
+  check(ctx) {
+    const { config } = inspectVoiceConfig(ctx.gameConfig?.voice);
+
+    if (!config.enabled) {
+      return skip('voice is off');
+    }
+
+    const code = String(config.hotkey);
+    const violations = [];
+    const engine = clientDefaults.modules.controls;
+    const game = ctx.clientConfig?.modules?.controls;
+
+    for (const [owner, controls] of [
+      ['the engine', engine],
+      ['the game', game],
+    ]) {
+      for (const group of ['modes', 'cmds']) {
+        const name = controls?.[group]?.[code];
+
+        if (name) {
+          violations.push(
+            `voice.hotkey ${code} is bound by ${owner} (${group}: ${name})`,
+          );
+        }
+      }
+    }
+
+    // клиент отдаёт клавишу связи раньше, чем публикует код в голосование,
+    // а Vote принимает цифры 0..9: такая клавиша не выбрала бы вариант
+    if (
+      config.hotkey >= VOTE_ANSWER_KEYS[0] &&
+      config.hotkey <= VOTE_ANSWER_KEYS[1]
+    ) {
+      violations.push(`voice.hotkey ${code} is a vote answer key (digits 0-9)`);
+    }
+
+    const keySetList = game?.keySetList;
+
+    if (Array.isArray(keySetList)) {
+      keySetList.forEach((set, index) => {
+        const action = set?.[code];
+
+        if (action) {
+          violations.push(
+            `voice.hotkey ${code} is bound in keySetList[${index}] ` +
+              `("${action}")`,
+          );
+        }
+      });
+    }
+
+    return verdict(violations);
+  },
+};

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

@@ -15,6 +15,7 @@ import b7 from './b7-chat-commands.js';
 import b8 from './b8-system-messages.js';
 import b9 from './b9-vote-names.js';
 import b10 from './b10-respawns.js';
+import b11 from './b11-voice-config.js';
 import c1 from './c1-client-shape.js';
 import c2 from './c2-parts-registered.js';
 import c3 from './c3-game-sets-coverage.js';
@@ -26,6 +27,7 @@ import c8 from './c8-baked-assets.js';
 import c9 from './c9-chat-messages.js';
 import c10 from './c10-auth-schema.js';
 import c11 from './c11-stat-mode.js';
+import c12 from './c12-voice-hotkey.js';
 import d1 from './d1-snapshot-ids.js';
 import d2 from './d2-snapshot-classes.js';
 import d3 from './d3-snapshot-interp.js';
@@ -38,7 +40,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,
@@ -57,6 +59,7 @@ export const rules = [
   b8,
   b9,
   b10,
+  b11,
   c1,
   c2,
   c3,
@@ -68,6 +71,7 @@ export const rules = [
   c9,
   c10,
   c11,
+  c12,
   d1,
   d2,
   d3,

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'],

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

@@ -5,6 +5,7 @@ import Stat from './meta/modules/Stat.js';
 import Chat from './meta/modules/chat/index.js';
 import { registerCodes } from './meta/modules/chat/systemMessages.js';
 import Vote from './meta/modules/Vote.js';
+import Voice from './meta/modules/voice/index.js';
 import RTTManager from './meta/modules/RTTManager.js';
 import TimerManager from './meta/modules/TimerManager.js';
 import ParticipantManager from './meta/player/ParticipantManager.js';
@@ -12,10 +13,12 @@ import VoteCoordinator from './meta/core/VoteCoordinator.js';
 import RoundManager from './meta/core/RoundManager.js';
 import CommandProcessor from './meta/core/CommandProcessor.js';
 import { sanitizeMessage } from '../lib/sanitizers.js';
+import { parseFloorMessage } from '../lib/voiceMessages.js';
 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' };
 
@@ -249,10 +252,24 @@ export default class HostGame {
 
     this._socketManager = socketManager;
 
+    // голосовая связь: эфир решается здесь, аудио сюда не
+    // попадает — его раздаёт ретранслятор транспортного уровня по маршрутам
+    // модуля. Эфир не выдаётся, пока матч стоит: заморозка плановой передачи,
+    // пауза эстафеты Worker'ов, ожидание старта из контрольной точки, закрытие
+    this._voice = new Voice(data.voice, {
+      participants: this._participants,
+      socketManager: this._socketManager,
+      isAvailable: () =>
+        !this._frozen &&
+        !this._handoffPaused &&
+        !this._restorePending &&
+        !this._isDestroying,
+    });
+
     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 +334,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 +369,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 } — точка на ближайшем кадре
@@ -358,6 +379,9 @@ export default class HostGame {
     this._restoreMode = null; // 'midRound' | 'soft'
     this._restoredTimers = null;
     this._frozen = false;
+    // эстафета Worker'ов прошла границу раунда: игра стоит до terminate()
+    // этого Worker'а или resumeAfterHandoff()
+    this._handoffPaused = false;
     // точка снята на замороженном хосте: pack_body осушил тело кадра вне
     // цикла, и его события (удаления, взрывы) никому не ушли
     this._drainedWhileFrozen = false;
@@ -603,6 +627,11 @@ export default class HostGame {
       }
     });
 
+    // эфиры: таймауты, отзыв, слушатели — с частотой снапшотов; после цикла
+    // рассылки, потому что getCamera в нём исправляет watchedGameId
+    // наблюдателей
+    this._voice.tick();
+
     // граница кадра: pack_body опустошил накопители снапшота — единственный
     // момент, когда дамп ядра корректен
     this._maybeCheckpoint();
@@ -738,7 +767,7 @@ export default class HostGame {
     this._mapList.push(...Object.keys(this._maps));
   }
 
-  // ***** отладочный контур (этап 6 плана plan/done/ai-debug) ***** //
+  // ***** отладочный контур ***** //
   // Всё ниже живёт под флагом isDevMode: в проде рекордера нет, а дамп
   // отдаёт только то, что и так знает мета.
 
@@ -810,6 +839,7 @@ export default class HostGame {
         })),
         activeList: this._participants.getActiveList(),
       },
+      voice: this._voice.debugState(),
       core: this._game.debugJson(),
     };
   }
@@ -835,6 +865,8 @@ export default class HostGame {
    */
   async destroy() {
     this._isDestroying = true;
+    // комната закрывается, сообщать некому
+    this._voice.reset({ notify: false });
 
     if (this._resumeWait) {
       clock.clearTimeout(this._resumeWait.timer);
@@ -877,6 +909,11 @@ export default class HostGame {
     this._roundManager.requestHandoff(() => {
       this._timerManager.stopGameTimers();
       this._timerManager.stopIdleCheckTimer();
+      // без тиков эфир не закончился бы сам, а новый Worker начинает без
+      // эфиров: говорящие получают END, слушатели — STOP; до terminate()
+      // или resumeAfterHandoff() запрос получает UNAVAILABLE
+      this._handoffPaused = true;
+      this._voice.reset();
       this._flushBeforeHandoff().then(() => cb(this._collectHandoff()));
     });
   }
@@ -923,6 +960,7 @@ export default class HostGame {
   // отказ от эстафеты (новый Worker не поднялся): вернуть таймеры и
   // продолжить жить на старой версии кода
   resumeAfterHandoff() {
+    this._handoffPaused = false;
     this._roundManager.cancelHandoff();
     this._timerManager.startIdleCheckTimer();
     this._timerManager.resumeGameTimers(this._timerManager.getMapTimeLeft());
@@ -1042,6 +1080,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 }.
@@ -1052,6 +1105,15 @@ export default class HostGame {
     this._healthSink = typeof sink === 'function' ? sink : null;
   }
 
+  /**
+   * Приёмник маршрутов голосовых эфиров для ретранслятора:
+   * ({ speakerSocketId, route }) => void, route === null — маршрут снят.
+   * @param {Function|null} sink
+   */
+  setVoiceRouteSink(sink) {
+    this._voice.setRouteSink(sink);
+  }
+
   // RTT — только удалённые люди: хост-игрок на loopback связь хоста не мерит
   _onLoopStats(stats) {
     if (!this._healthSink) {
@@ -1523,6 +1585,9 @@ export default class HostGame {
 
     this._frozen = true;
     this._timerManager.pause();
+    // без тиков эфир не закончился бы сам: говорящие получают END,
+    // слушатели — STOP
+    this._voice.reset();
   }
 
   // разморозка (передача сорвалась): отсчёты продолжаются с остатков.
@@ -1652,6 +1717,7 @@ export default class HostGame {
     this._stat.removeUser(gameId, teamId);
     this._chat.removeUser(gameId);
     this._vote.removeUser(gameId);
+    this._voice.removeUser(gameId);
     this._panel.removeUser(gameId);
 
     // финальная синхронизация профиля перед уходом участника (Этап B4):
@@ -1682,6 +1748,18 @@ export default class HostGame {
     }
   }
 
+  // управление эфиром: [1] — запрос, [0, talkId] — отпускание. В рекордер не
+  // пишется: на симуляцию не влияет
+  voiceFloor(gameId, data) {
+    const message = parseFloorMessage(data);
+
+    if (message?.op === 'request') {
+      this._voice.request(gameId);
+    } else if (message?.op === 'release') {
+      this._voice.release(gameId, message.talkId);
+    }
+  }
+
   // обновляет команды (формат wire: 'seq:action:name', указатель —
   // 'seq:aim:x:y:flags')
   updateKeys(gameId, keyStr) {

package/src/host/PortMachine.js

@@ -25,8 +25,10 @@ const PC_PONG = wsports.client.PONG;
 const PC_RESUME_REQUEST = wsports.client.RESUME_REQUEST;
 const PC_LEAVE = wsports.client.LEAVE;
 const PC_TOKEN_REFRESH = wsports.client.TOKEN_REFRESH;
+const PC_VOICE_FLOOR = wsports.client.VOICE_FLOOR;
 
-const PORT_COUNT = 12;
+// VOICE_AUDIO (13) бинарный и порт-машиной не разбирается
+const PORT_COUNT = 13;
 
 // версии формата RESUME_REQUEST, которые понимает хост
 const RESUME_VERSION = 1;
@@ -41,6 +43,7 @@ const IN_GAME_PORTS = [
   PC_PONG,
   PC_LEAVE,
   PC_TOKEN_REFRESH,
+  PC_VOICE_FLOOR,
 ];
 
 export default class PortMachine {
@@ -244,8 +247,18 @@ export default class PortMachine {
       return;
     }
 
-    if (msg && state.enabled[msg[0]]) {
-      state.methods[msg[0]](msg[1]);
+    const port = Array.isArray(msg) ? msg[0] : null;
+
+    // номер порта — только целое из диапазона: строковый ключ вроде
+    // '__proto__' или 'constructor' прошёл бы проверку `enabled[...]` по
+    // прототипу массива и вызвал бы не обработчик
+    if (
+      Number.isInteger(port) &&
+      port >= 0 &&
+      port < PORT_COUNT &&
+      state.enabled[port]
+    ) {
+      state.methods[port](msg[1]);
     }
   }
 
@@ -603,6 +616,9 @@ export default class PortMachine {
 
       // 11: token refresh
       data => this._refreshToken(socketId, state, data),
+
+      // 12: управление эфиром ([1] / [0, talkId]); разбор — HostGame.voiceFloor
+      data => host.voiceFloor(state.gameId, data),
     ];
   }
 }

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

@@ -135,6 +135,8 @@ async function onInit(room, handoff = null, checkpointBytes = null, seqFloor) {
   // общая с headless-runner'ом сборка (lib/createHostRuntime.js) — чтобы
   // отладочный прогон крутил ровно тот код, что и прод
   const runtime = await createHostRuntime(room, {
+    // ретранслятор голоса — в главном потоке (HostController)
+    voiceRelay: true,
     hostOptions: {
       // map_changed остаётся для главного потока до host-migration этапа 2
       onMapChange: mapName =>
@@ -151,6 +153,17 @@ async function onInit(room, handoff = null, checkpointBytes = null, seqFloor) {
   // здоровье хоста (host-migration этап 9a): главный поток решает, не пора
   // ли отдать роль
   host.setHealthSink(health => self.postMessage({ type: 'health', health }));
+  // голосовая связь: маршруты эфиров — ретранслятору главного потока
+  // (VoiceRelay). Сам голос Worker не видит никогда
+  host.setVoiceRouteSink(({ speakerSocketId, route }) =>
+    self.postMessage({ type: 'voice_route', speakerSocketId, route }),
+  );
+
+  // сбой кода игры, пойманный хостом (чат-команда): в журнал клиентских
+  // ошибок тем же сообщением, что и необработанный reject
+  host.setDiagnosticSink(report =>
+    self.postMessage({ type: 'diagnostic', ...report }),
+  );
 
   // в лобби личность игрока — claim identity-токена, проверенного по JWKS
   // мастера (Этап B3); свободного ввода имени в форме игры нет
@@ -238,7 +251,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 +338,7 @@ self.onmessage = async event => {
       host?.setRoom({ roomId: msg.hostId, roomSecret: msg.hostSecret });
       break;
 
-    // отладочный контур (этап 6 плана plan/done/ai-debug): единственный вход в
+    // отладочный контур: единственный вход в
     // авторитетную половину из главного потока — запрос/ответ по requestId
     case 'debug':
       onDebug(msg);