16.3 交付卷三

#!/usr/bin/env python3
# file: sim/ne_16_3_handoff.py
# tier: S
# verify: /opt/homebrew/bin/python3 sim/ne_16_3_handoff.py
"""卷二 16.3 交付卷三：把交给卷三《叙事体验与路径度量》的接口整理成清单并逐项自检。

交付五类：规格段 / 内核函数 / 仿真产物 / 原型产物 / 判据与容差。每一项都要在
磁盘上找得到 —— 规格段在 story_spec.json 顶层键里、函数在 engine.ts 的
`export function` 里、产物在 out/ 下、原型在 web/dist/ 下、判据在 spec.metrics 里。
缺一即 FAIL 并非零退出。本卷只交**结构量**；体验类度量（情感曲线、结局分布熵、
张力曲线）是卷三的事，本脚本不产出、不引用卷三的任何 slug。
"""
from __future__ import annotations

import json
import os
import sys

HERE = os.path.dirname(os.path.abspath(__file__))
ROOT = os.path.dirname(HERE)

SEGMENTS = ["meta", "world", "characters", "beats", "scene_graph",
            "dialogue", "conditions", "state", "endings", "metrics"]
FUNCS = ["clamp", "initState", "nodeById", "condOk", "applyEffects", "applyChoice",
         "canonical", "digest", "replay", "samplePaths"]
ARTIFACTS = ["out/ne_16_1_assembly.json", "out/ne_16_2_integration.json",
             "out/ne_05_2_reachable.json", "out/ne_01_3_py.json"]
PROTOTYPES = ["web/dist/ne09.html", "web/dist/ne10.html"]
CRITERIA = ["coverage_target_permille", "ending_entropy_min_milli_bits",
            "affinity_mae_max", "tension_mae_max"]


def main() -> int:
    with open(os.path.join(ROOT, "config/story_spec.json"), encoding="utf-8") as fh:
        spec = json.load(fh)
    engine = open(os.path.join(ROOT, "core/src/inkwell/engine.ts"), encoding="utf-8").read()
    fails: list[str] = []

    seg_ok = [s for s in SEGMENTS if s in spec]
    fn_ok = [f for f in FUNCS if f"export function {f}(" in engine]
    art_ok = [a for a in ARTIFACTS if os.path.exists(os.path.join(ROOT, a))]
    pro_ok = [p for p in PROTOTYPES if os.path.exists(os.path.join(ROOT, p))]
    crit_ok = [c for c in CRITERIA if c in spec["metrics"]]

    for name, got, want in (("规格段", seg_ok, SEGMENTS), ("内核函数", fn_ok, FUNCS),
                            ("仿真产物", art_ok, ARTIFACTS), ("原型产物", pro_ok, PROTOTYPES),
                            ("判据容差", crit_ok, CRITERIA)):
        miss = [x for x in want if x not in got]
        if miss:
            fails.append(f"{name}缺 {miss}")

    print("交付清单（卷二《叙事引擎与分支系统》→ 卷三《叙事体验与路径度量》）")
    print(f"① 规格段  config/story_spec.json  {len(seg_ok)}/{len(SEGMENTS)}")
    print(f"② 内核函数 core/src/inkwell/engine.ts  {len(fn_ok)}/{len(FUNCS)}")
    print("   " + "、".join(fn_ok))
    print(f"③ 仿真产物  {len(art_ok)}/{len(ARTIFACTS)}")
    for a in art_ok:
        print(f"   {a:<32} {os.path.getsize(os.path.join(ROOT, a))} B")
    print(f"④ 原型产物  {len(pro_ok)}/{len(PROTOTYPES)}")
    for p in pro_ok:
        print(f"   {p:<32} {os.path.getsize(os.path.join(ROOT, p))} B")
    print(f"⑤ 判据容差 spec.metrics  {len(crit_ok)}/{len(CRITERIA)}")
    for c in crit_ok:
        print(f"   {c:<32} {spec['metrics'][c]}")
    print("给卷三的接口：规格段（只读真源）+ 内核函数（重放 / 摘要）+ 产物（基线）+ 判据（契约）")
    print("本卷没做的：体验度量 / 情感曲线 / 结局分布熵 / 张力曲线 —— 归卷三")
    total_ok = len(seg_ok) + len(fn_ok) + len(art_ok) + len(pro_ok) + len(crit_ok)
    total_want = len(SEGMENTS) + len(FUNCS) + len(ARTIFACTS) + len(PROTOTYPES) + len(CRITERIA)
    print(f"交付自检 {'PASS' if not fails else 'FAIL'}（{total_ok}/{total_want}）")
    for f in fails:
        print(f"  FAIL {f}")
    return 1 if fails else 0


if __name__ == "__main__":
    sys.exit(main())

交付清单（卷二《叙事引擎与分支系统》→ 卷三《叙事体验与路径度量》）
① 规格段  config/story_spec.json  10/10
② 内核函数 core/src/inkwell/engine.ts  10/10
   clamp、initState、nodeById、condOk、applyEffects、applyChoice、canonical、digest、replay、samplePaths
③ 仿真产物  4/4
   out/ne_16_1_assembly.json        1393 B
   out/ne_16_2_integration.json     1712 B
   out/ne_05_2_reachable.json       3112 B
   out/ne_01_3_py.json              2999 B
④ 原型产物  2/2
   web/dist/ne09.html               41641 B
   web/dist/ne10.html               41406 B
⑤ 判据容差 spec.metrics  4/4
   coverage_target_permille         850
   ending_entropy_min_milli_bits    1500
   affinity_mae_max                 12
   tension_mae_max                  1
给卷三的接口：规格段（只读真源）+ 内核函数（重放 / 摘要）+ 产物（基线）+ 判据（契约）
本卷没做的：体验度量 / 情感曲线 / 结局分布熵 / 张力曲线 —— 归卷三
交付自检 PASS（30/30）

// file: web/verify_ne16.mjs
// tier: W
// verify: node web/build_ne10.mjs && NODE_PATH=/opt/homebrew/lib/node_modules node web/verify_ne16.mjs
// 卷二 16.2 三宿主联调：Python 产物 / TS 内核 / 浏览器页面在同一条锚点路径上给出同一个摘要。
// 复用 web/build_ne10.mjs 产出的 dist/ne10.html（只读，不改）；NODE_PATH 对 ESM 无效 → createRequire。

import { createRequire } from "node:module";
import { readFileSync, mkdirSync } from "node:fs";
import { join, dirname } from "node:path";
import { fileURLToPath, pathToFileURL } from "node:url";
import { replay, digest } from "../core/src/inkwell/engine.ts";

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

const HERE = dirname(fileURLToPath(import.meta.url));
const ROOT = join(HERE, "..");
const SHOTS = join(ROOT, "out/shots");
mkdirSync(SHOTS, { recursive: true });

const spec = JSON.parse(readFileSync(join(ROOT, "config/story_spec.json"), "utf8"));
const py = JSON.parse(readFileSync(join(ROOT, "out/ne_16_2_integration.json"), "utf8"));
const url = pathToFileURL(join(HERE, "dist/ne10.html")).href;

let fail = 0;
function check(name, got, want) {
  const ok = got === want;
  if (!ok) fail += 1;
  console.log(`${ok ? "OK  " : "FAIL"} ${name}: ${got}${ok ? "" : " != " + want}`);
}

const browser = await chromium.launch();
const ctx = await browser.newContext({ viewport: { width: 820, height: 1000 } });
// 冷启动预热页：首个 page 读像素恒为空白，先画一次 8x8 再丢弃
const warm = await ctx.newPage();
await warm.setContent('<canvas id="w" width="8" height="8"></canvas>');
await warm.evaluate(() => {
  const g = document.getElementById("w").getContext("2d");
  g.fillStyle = "#38bdf8";
  g.fillRect(0, 0, 8, 8);
});
await warm.close();

const page = await ctx.newPage();
await page.goto(url);
await page.evaluate(() => window.__ne10.reset());
for (const c of py.choices) await page.click(`[data-choice-id="${c}"]`);
const got = await page.evaluate(() => ({
  node: window.__ne10.node, ending: window.__ne10.ending, digest: window.__ne10.digest,
}));

check("TS 内核摘要 == Python 产物", digest(replay(spec, py.choices)), py.digest);
check("浏览器摘要 == Python 产物", got.digest, py.digest);
check("浏览器终局节点 == Python 产物", got.node, py.node);
check("浏览器结局 == Python 产物", got.ending, py.ending);

await page.goto(url);
await page.evaluate(() => window.__ne10.reset());
for (const c of py.choices) await page.click(`[data-choice-id="${c}"]`);
check("两遍渲染摘要一致", await page.evaluate(() => window.__ne10.digest), py.digest);

const shot = await page.screenshot({ path: join(SHOTS, "ne16_three_host.png"), fullPage: true });
console.log(`OK   截图 out/shots/ne16_three_host.png ${shot.length} bytes`);
if (shot.length < 1) { fail += 1; console.log("FAIL 截图为空"); }

await browser.close();
console.log(`== verify_ne16: 三宿主摘要 ${got.digest}，失败 ${fail}`);
process.exit(fail ? 1 : 0);

wrote web/dist/ne10.html 41406 bytes
(node:38468) ExperimentalWarning: stripTypeScriptTypes is an experimental feature and might change at any time
(Use `node --trace-warnings ...` to show where the warning was created)
OK   TS 内核摘要 == Python 产物: 4162796975
OK   浏览器摘要 == Python 产物: 4162796975
OK   浏览器终局节点 == Python 产物: e_lit
OK   浏览器结局 == Python 产物: 灯守
OK   两遍渲染摘要一致: 4162796975
OK   截图 out/shots/ne16_three_host.png 43536 bytes
== verify_ne16: 三宿主摘要 4162796975，失败 0