vimp-engine 0.35.6 → 0.36.0

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

@@ -40,11 +40,44 @@ import e7 from './e7-map-game-field.js';
 // Порядок групп — порядок отчёта: A пакет и сборка, B host, C client,
 // D снапшот, E ассеты (plan/create-vimp-game/stage_1.md).
 export const rules = [
-  a1, a2, a3, a4, a5, a6, a7,
-  b1, b2, b3, b4, b5, b6, b7, b8, b9, b10,
-  c1, c2, c3, c4, c5, c6, c7, c8, c9, c10, c11,
-  d1, d2, d3,
-  e1, e2, e3, e4, e5, e6, e7,
+  a1,
+  a2,
+  a3,
+  a4,
+  a5,
+  a6,
+  a7,
+  b1,
+  b2,
+  b3,
+  b4,
+  b5,
+  b6,
+  b7,
+  b8,
+  b9,
+  b10,
+  c1,
+  c2,
+  c3,
+  c4,
+  c5,
+  c6,
+  c7,
+  c8,
+  c9,
+  c10,
+  c11,
+  d1,
+  d2,
+  d3,
+  e1,
+  e2,
+  e3,
+  e4,
+  e5,
+  e6,
+  e7,
 ];
 
 export default rules;

package/src/devtools/invariants.js

@@ -35,7 +35,9 @@ const CHECKS = [
   [12, 'determinism', 'two runs produce a byte-identical frame stream'],
 ];
 
-const TITLES = new Map(CHECKS.map(([id, name, title]) => [name, { id, title }]));
+const TITLES = new Map(
+  CHECKS.map(([id, name, title]) => [name, { id, title }]),
+);
 
 /**
  * Выполняет проверки 1–11 по итогам прогона (12 — только по требованию,
@@ -223,7 +225,9 @@ function frameFormat({ clients, socketManager }) {
 
   for (const client of clients) {
     for (const error of client.decodeErrors) {
-      violations.push(`${client.socketId}: push_frame threw — ${error.message}`);
+      violations.push(
+        `${client.socketId}: push_frame threw — ${error.message}`,
+      );
     }
   }
 
@@ -277,7 +281,7 @@ function hotLayout({ clients }) {
         item.message
           ? `${client.socketId}: ${item.message} (len ${item.len})`
           : `${client.socketId}: hot buffer len ${item.len}, traversal consumed ` +
-            `${item.consumed} — record width or group order drifted`,
+              `${item.consumed} — record width or group order drifted`,
       );
     }
 
@@ -463,7 +467,9 @@ function predictionDrift({ clients, scenario }) {
       (client.divergenceStats.dropped ?? 0);
 
     if (hidden) {
-      violations.push(`${client.socketId}: +${hidden} more divergence record(s)`);
+      violations.push(
+        `${client.socketId}: +${hidden} more divergence record(s)`,
+      );
     }
   }
 

package/src/devtools/pluginLoader.js

@@ -16,10 +16,7 @@ import { loadGamePackage } from '../lib/loadGamePackage.js';
 // пути в манифесте. Его отсутствие не ошибка — просто игра не прогоняется
 // headless своим настоящим ядром.
 
-const FIXTURE_DIR = new URL(
-  '../../tests/fixtures/miniGame/',
-  import.meta.url,
-);
+const FIXTURE_DIR = new URL('../../tests/fixtures/miniGame/', import.meta.url);
 
 // значение поля source у фикстуры: по нему отличается «своя игра, схему
 // которой инструмент знает» от чужого плагина (см. builtinScenario.js)

package/src/devtools/report.js

@@ -103,6 +103,20 @@ export function formatMarkdown(report) {
     }
   }
 
+  // смены хоста через контрольную точку: 'soft' у игры, которая ждала
+  // 'midRound', — первое, что автор должен увидеть
+  if (report.checkpointRestores?.length) {
+    lines.push('');
+    lines.push('## Host checkpoints');
+    lines.push('');
+
+    for (const restore of report.checkpointRestores) {
+      lines.push(
+        `- tick ${restore.tick}: \`${restore.mode}\`, ${restore.bytes} B`,
+      );
+    }
+  }
+
   lines.push('');
 
   return `${lines.join('\n')}\n`;
@@ -191,7 +205,9 @@ function invariantSection(report) {
     const mark = { pass: '✅', fail: '❌', skip: '⏭️' }[check.status];
     const note = check.note ? ` — ${check.note}` : '';
 
-    lines.push(`- ${mark} ${check.id}. \`${check.name}\`: ${check.title}${note}`);
+    lines.push(
+      `- ${mark} ${check.id}. \`${check.name}\`: ${check.title}${note}`,
+    );
 
     for (const violation of check.violations) {
       lines.push(`  - ${violation}`);

package/src/host/DebugRecorder.js

@@ -48,7 +48,12 @@ export default class DebugRecorder {
    * @param {Array} [params.participants] - [{ gameId, name, model, socketId,
    *   team }] — люди, уже находящиеся в комнате.
    */
-  start({ seed = null, map = null, networkSendRate = null, participants = [] }) {
+  start({
+    seed = null,
+    map = null,
+    networkSendRate = null,
+    participants = [],
+  }) {
     this._reset();
 
     this._recording = true;

package/src/host/GameCoreAdapter.js

@@ -241,6 +241,45 @@ export default class GameCoreAdapter {
     );
   }
 
+  // ***** контрольная точка (host-migration этап 5) ***** //
+
+  /**
+   * Дамп состояния ядра (замороженный ABI `serialize_state`). Звать только
+   * на границе кадра — сразу после packBody: накопители снапшота должны
+   * быть опустошены (предусловие ядра).
+   * @returns {Uint8Array} Собственная копия байтов в JS-куче.
+   * @throws {Error} Ядро не смогло сериализовать мир — точка пропускается.
+   */
+  serializeState() {
+    let bytes;
+
+    try {
+      bytes = this._core.serialize_state();
+    } catch (e) {
+      throw new Error(`core serialize_state failed: ${errorText(e)}`);
+    }
+
+    if (!(bytes instanceof Uint8Array)) {
+      throw new Error('core serialize_state returned no bytes');
+    }
+
+    return bytes;
+  }
+
+  /**
+   * Поднимает мир ядра из дампа. Конфиг ядра обязан совпадать с конфигом
+   * ядра, снявшего дамп.
+   * @param {Uint8Array} bytes
+   * @throws {Error} Битый или несовместимый дамп.
+   */
+  deserializeState(bytes) {
+    try {
+      this._core.deserialize_state(bytes);
+    } catch (e) {
+      throw new Error(`core deserialize_state failed: ${errorText(e)}`);
+    }
+  }
+
   // ***** отладка ***** //
 
   /**
@@ -296,3 +335,9 @@ export default class GameCoreAdapter {
     return Boolean(participant && participant.isScripted);
   }
 }
+
+// JsError wasm-bindgen и обычный Error — у обоих есть message; строка из
+// throw внутри фейка — тоже ответ
+function errorText(e) {
+  return e && e.message ? e.message : String(e);
+}