13.3 变体的可玩性闸门

// snippet: out/gd_proto_13_gate.json 的头部（逐字；variants 数组见下）
{
  "id": "gd_proto_13_gate",
  "gateVersion": 1,
  "criteria": [
    "determinism",
    "invariants",
    "terminal_reachable",
    "contract_isomorphic",
    "perturbation_spread"
  ],
  "minDistinctBuckets": 2,
  "contractSlots": [
    "block",
    "cardCount",
    "damageConserved",
    "dealt",
    "enemyHp",
    "energy",
    "hand",
    "over",
    "played",
    "playerHp",
    "turn",
    "won"
  ],
  "proxyFields": [
    "spread.winPermille",
    "spread.dominantPermille",
    "seedAxis.winPermille",
    "seedAxis.dominantPermille"
  ],
  "proxyNote": "winPermille / dominantPermille 是代理指标（proxy），只做相对比较，禁绝对化",

// snippet: out/gd_proto_13_gate.json 里 platformer 那条记录（逐字，注意 seedAxis）
{
  "genre": "platformer",
  "label": "平台跳跃",
  "spec": "config/gd_proto_08_platformer.json",
  "specId": "gd_proto_08_platformer",
  "kernel": "core/genre/platformer.ts",
  "axis": "timing",
  "axisPoints": 81,
  "terminalKind": "goalX|frameLimit|fallLimit",
  "determinism": {
    "runs": 2,
    "digestsEqual": true,
    "digest": "{\"block\":4750,\"cardCount\":3,\"damageConserved\":true,\"dealt\":30000,\"enemyHp\":0,\"energy\":250,\"hand\":[\"P1\",\"P2\"],\"over\":true,\"played\":2,\"playerHp\":0,\"turn\":120,\"won\":true}"
  },
  "invariants": {
    "checked": 81,
    "held": 81
  },
  "terminal": {
    "checked": 81,
    "reached": 81
  },
  "contract": {
    "slots": 12,
    "matches": true
  },
  "spread": {
    "distinctBuckets": 5,
    "dominantPermille": 888,
    "winPermille": 888
  },
  "seedAxis": {
    "distinctBuckets": 1,
    "dominantPermille": 1000,
    "points": 16,
    "winPermille": 1000
  },
  "criteria": {
    "determinism": true,
    "invariants": true,
    "terminal_reachable": true,
    "contract_isomorphic": true,
    "perturbation_spread": true
  },
  "failed": [],
  "pass": true
}

# snippet: 跑 13.3 的 P 层闸门（写 out/gd_proto_13_gate.json）
node --test 'core/test/gd_proto_13_3_variant_gate.test.ts'

  genre            axis    轴点  桶  主桶‰  胜率‰  种子轴桶  种子轴胜率‰  通过
  deckbuilder      seed      16  16     62   1000        16        1000  是
  tower-defense    seed      16  10    187   1000        10        1000  是
  match3           seed      16  16     62      0        16           0  是
  platformer       timing    81   5    888    888         1        1000  是
  autobattler      seed      16  16     62   1000        16        1000  是
  idle             seed      16  16     62      0        16           0  是
  passed=6 failed=[] allPass=true
ℹ tests 8
ℹ suites 0
ℹ pass 8
ℹ fail 0
ℹ cancelled 0
ℹ skipped 0
ℹ todo 0
ℹ duration_ms 242.872792

# snippet: 读 out/gd_proto_13_gate.json，复算一致性并画记分卡
/opt/homebrew/bin/python3 sim/gd_proto_13_3_gate_report.py

gate=gd_proto_13_gate version=1
criteria=determinism|invariants|terminal_reachable|contract_isomorphic|perturbation_spread minBuckets=2
variants=6 passed=6 failed=0 allPass=True
totalAxisChecks=161  maxSpreadBuckets=16
  deckbuilder    axis=seed    pts= 16 buckets=16 domPermille= 62 winPermille=1000 seedBuckets=16 PASS
  tower-defense  axis=seed    pts= 16 buckets=10 domPermille=187 winPermille=1000 seedBuckets=10 PASS
  match3         axis=seed    pts= 16 buckets=16 domPermille= 62 winPermille=   0 seedBuckets=16 PASS
  platformer     axis=timing  pts= 81 buckets= 5 domPermille=888 winPermille= 888 seedBuckets= 1 PASS
  autobattler    axis=seed    pts= 16 buckets=16 domPermille= 62 winPermille=1000 seedBuckets=16 PASS
  idle           axis=seed    pts= 16 buckets=16 domPermille= 62 winPermille=   0 seedBuckets=16 PASS
svg=11061 B csv=6 rows
OK 闸门报告自洽，6/6 通过

// file: out/gd_proto_13_wcheck.mjs
// tier: W
// verify: NODE_PATH=/opt/homebrew/lib/node_modules node out/gd_proto_13_wcheck.mjs
//
// 13.2 的 W 层加断言：通用验证器只调一次 __ashdeck.run()（默认品类），本脚本把**六个品类
// 逐个**在无头浏览器里跑一遍，断言每个品类的页面 digest == 构建期 Node 侧算出的 digest
// （即 out/gd_proto_13_build.json 里冻结的那条），并断言同一品类两遍逐字一致。
// 预热页是必需的：Playwright 冷启动首个 page 读 canvas 像素恒为空白。

import { createRequire } from "node:module";
import { readFileSync } from "node:fs";
import { fileURLToPath } from "node:url";
import { dirname, join, resolve } from "node:path";

const require = createRequire(import.meta.url);
const { chromium } = require("playwright");

const HERE = dirname(fileURLToPath(import.meta.url));
const ROOT = join(HERE, "..");
const PAGE = resolve(join(ROOT, "out", "proto13.html"));
const BUILD = JSON.parse(readFileSync(join(ROOT, "out", "gd_proto_13_build.json"), "utf8"));
const GENRES = BUILD.genres;

const fails = [];
const check = (c, m) => { console.log(`  ${c ? "ok  " : "FAIL"} ${m}`); if (!c) fails.push(m); };

const browser = await chromium.launch();
try {
  const warm = await browser.newPage();
  await warm.goto("about:blank");
  await warm.evaluate(() => {
    const c = document.createElement("canvas");
    c.width = 8; c.height = 8;
    c.getContext("2d").getImageData(0, 0, 8, 8).data.length;
  });
  await warm.close();

  const open = async () => {
    const p = await browser.newPage({ viewport: { width: 900, height: 760 } });
    await p.goto("file://" + PAGE);
    await p.waitForFunction(() => globalThis.__ashdeck && globalThis.__ashdeck.canvasDrawn === true,
      null, { timeout: 15000 });
    return p;
  };

  const a = await open();
  check(JSON.stringify(await a.evaluate(() => globalThis.__ashdeck.genres())) === JSON.stringify(GENRES),
    "页面暴露的六个品类名与注册表逐个相同");
  for (const g of GENRES) {
    const d = String(await a.evaluate((x) => globalThis.__ashdeck.run(x), g));
    check(d === BUILD.nodeDigests[g], `浏览器 ${g} 的 digest == 构建期 Node 侧 digest`);
  }
  const first = String(await a.evaluate(() => globalThis.__ashdeck.run("idle")));
  const again = String(await a.evaluate(() => globalThis.__ashdeck.run("idle")));
  check(first === again, "同一品类两遍逐字一致（确定性）");
  await a.close();

  const b = await open();
  const d2 = String(await b.evaluate(() => globalThis.__ashdeck.run("autobattler")));
  await b.close();
  check(d2 === BUILD.nodeDigests.autobattler, "独立第二次加载的 autobattler digest 仍一致");
} finally {
  await browser.close();
}
console.log(fails.length === 0 ? "OK W 层加断言通过（6/6 品类）" : `FAIL ${fails.length} 条`);
process.exit(fails.length === 0 ? 0 : 1);

  ok   页面暴露的六个品类名与注册表逐个相同
  ok   浏览器 deckbuilder 的 digest == 构建期 Node 侧 digest
  ok   浏览器 tower-defense 的 digest == 构建期 Node 侧 digest
  ok   浏览器 match3 的 digest == 构建期 Node 侧 digest
  ok   浏览器 platformer 的 digest == 构建期 Node 侧 digest
  ok   浏览器 autobattler 的 digest == 构建期 Node 侧 digest
  ok   浏览器 idle 的 digest == 构建期 Node 侧 digest
  ok   同一品类两遍逐字一致（确定性）
  ok   独立第二次加载的 autobattler digest 仍一致
OK W 层加断言通过（6/6 品类）