From 2558e48ee771ab72b1751f738257a4eb3c147c14 Mon Sep 17 00:00:00 2001
From: qiann <qiann0512@gmail.com>
Date: Sat, 6 Jun 2026 21:27:23 +0800
Subject: [PATCH] Make web lab tests use explicit UTF-8 encoding

---
 tests/test_web_lab.py | 803 ++++++++++++++++++++----------------------
 1 file changed, 379 insertions(+), 424 deletions(-)

diff --git a/tests/test_web_lab.py b/tests/test_web_lab.py
index 8c6bd65..8742961 100644
--- a/tests/test_web_lab.py
+++ b/tests/test_web_lab.py
@@ -1,426 +1,381 @@
-"""Smoke tests for the agent-payments canvas lab (``web/agents-demo.html``).
-
-The canvas lab is intentionally a no-build single-file frontend, so the test
-surface here is correspondingly small but load-bearing:
-
-- the file parses as HTML and contains the structural anchors we depend on
-- every scene wired into ``SCENE_ORDER`` has a matching ``SCENES.<id>``
-  definition with a name + caption
-- the named cast (Patty, Abhi, Tridib) is wired through the canonical
-  agent registry
-- the home page links to the multi-page lab and canvas lab
-- the embedded JavaScript has no syntax errors (run via ``node --check``)
-
-Skip the node check if a ``node`` binary isn't on PATH.
-"""
-
-from __future__ import annotations
-
-import html.parser
-import re
-import shutil
-import subprocess
-import tempfile
-from pathlib import Path
-
-import pytest
-
-
-HERE = Path(__file__).resolve().parent
-WEB = HERE.parent / "web"
-LAB = WEB / "agents-demo.html"
-MULTIPAGE_LAB = WEB / "lab"
-HOME = WEB / "index.html"
-SIMULATOR = WEB / "simulator.html"
-
-LAB_PAGES = [
-    "index.html",
-    "x402.html",
-    "escrow.html",
-    "streaming.html",
-    "auction.html",
-    "taxi.html",
-    "cafe.html",
-    "delivery.html",
-    "trip.html",
-    "multichain.html",
-    "pq.html",
-    "rails.html",
-    "tools.html",
-]
-
-
-@pytest.fixture(scope="module")
+"""Smoke tests for the agent-payments lab (``web/agents-demo.html``).
+
+The lab is intentionally a no-build single-file frontend, so the test
+surface here is correspondingly small but load-bearing:
+
+- the file parses as HTML and contains the structural anchors we depend on
+- every scene wired into ``SCENE_ORDER`` has a matching ``SCENES.<id>``
+  definition with a name + caption
+- the named cast (Patty, Abhi, Tridib) is wired through the canonical
+  agent registry
+- the home page links to the lab and the lab links back
+- the embedded JavaScript has no syntax errors (run via ``node --check``)
+
+Skip the node check if a ``node`` binary isn't on PATH.
+"""
+
+from __future__ import annotations
+
+import html.parser
+import re
+import shutil
+import subprocess
+import tempfile
+from pathlib import Path
+
+import pytest
+
+
+HERE = Path(__file__).resolve().parent
+WEB = HERE.parent / "web"
+LAB = WEB / "agents-demo.html"
+HOME = WEB / "index.html"
+
+
+@pytest.fixture(scope="module")
 def lab_html() -> str:
-    return LAB.read_text()
-
-
-@pytest.fixture(scope="module")
+    return LAB.read_text(encoding="utf-8")
+
+
+@pytest.fixture(scope="module")
 def home_html() -> str:
-    return HOME.read_text()
-
-
-@pytest.fixture(scope="module")
-def simulator_html() -> str:
-    return SIMULATOR.read_text()
-
-
-@pytest.fixture(scope="module")
-def lab_script(lab_html: str) -> str:
-    m = re.search(r"<script>(.*?)</script>", lab_html, re.DOTALL)
-    assert m, "expected one <script> block in lab HTML"
-    return m.group(1)
-
-
-def runnable_node() -> str | None:
-    node = shutil.which("node")
-    if node is None:
-        return None
-    try:
-        subprocess.run([node, "--version"], capture_output=True, check=False, timeout=5)
-    except OSError:
-        return None
-    return node
-
-
-# ─── shape ────────────────────────────────────────────────────────────────
-
-def test_files_exist() -> None:
-    assert LAB.is_file(), f"missing {LAB}"
-    assert HOME.is_file(), f"missing {HOME}"
-    for page in LAB_PAGES:
-        assert (MULTIPAGE_LAB / page).is_file(), f"missing {MULTIPAGE_LAB / page}"
-
-
-def test_html_parses(lab_html: str) -> None:
-    class P(html.parser.HTMLParser):
-        def __init__(self) -> None:
-            super().__init__()
-            self.errors: list[str] = []
-
-        def error(self, message: str) -> None:    # pragma: no cover
-            self.errors.append(message)
-
-    p = P()
-    p.feed(lab_html)
-    assert not p.errors, p.errors
-
-
-def test_structural_anchors(lab_html: str) -> None:
-    must_contain = [
-        '<canvas id="canvas">',
-        '<div class="scene-bar" id="sceneBar">',
-        '<div class="tt" id="tooltip">',
-        'id="sbTitle"',
-        'class="sb-char"',
-    ]
-    for s in must_contain:
-        assert s in lab_html, f"missing structural anchor: {s}"
-
-
-# ─── split-flap title ─────────────────────────────────────────────────────
-
-def test_switchboard_title_letters(lab_html: str) -> None:
-    matches = re.findall(r'data-target="([^"]+)"', lab_html)
-    # First 11 letters are the title; trailing ones may belong to scenes.
-    title_letters = "".join(matches[:11])
-    assert title_letters == "switchboard", title_letters
-
-
-def test_scramble_logic_present(lab_script: str) -> None:
-    assert "scrambleSwitchboard" in lab_script
-    assert "mouseenter" in lab_script
-    assert "settled" in lab_script and "scrambling" in lab_script
-
-
-# ─── scenes ───────────────────────────────────────────────────────────────
-
-EXPECTED_SCENES = [
-    "x402", "escrow", "stream", "auction", "hitl", "fanout", "oracle", "pq", "stack",
-    "taxi", "cafe", "delivery", "split", "ethEscrow", "subscribe", "trip",
-    "oracleGame_soon",
-]
-
-
-def test_scene_order_matches(lab_script: str) -> None:
-    m = re.search(r"SCENE_ORDER\s*=\s*\[([^\]]+)\]", lab_script)
-    assert m, "SCENE_ORDER array not found"
-    order = re.findall(r'"([^"]+)"', m.group(1))
-    assert order == EXPECTED_SCENES, order
-
-
-def test_every_scene_has_definition(lab_script: str) -> None:
-    for scene_id in EXPECTED_SCENES:
-        # accept either `SCENES.x = {` (inline scene def) or
-        # `SCENES.x = makeComingSoonScene({` (factory pattern for placeholders)
-        inline  = f"SCENES.{scene_id} = {{" in lab_script
-        factory = f"SCENES.{scene_id} = make" in lab_script
-        assert inline or factory, f"SCENES.{scene_id} missing (neither inline nor factory)"
-        # each should have a name and short label somewhere in its def
-        block_m = re.search(
-            rf"SCENES\.{scene_id}\s*=.*?id:\s*\"{scene_id}\".*?name:\s*\"([^\"]+)\".*?short:\s*\"([^\"]+)\"",
-            lab_script, re.DOTALL,
-        )
-        assert block_m, f"scene {scene_id} missing name/short"
-        name, short = block_m.group(1), block_m.group(2)
-        assert name and short, f"scene {scene_id} has empty name or short"
-
-
-def test_scene_short_codes_are_zero_padded(lab_script: str) -> None:
-    shorts = re.findall(r'short:\s*"(\d+)"', lab_script)
-    assert len(shorts) == len(EXPECTED_SCENES), shorts
-    for s in shorts:
-        assert len(s) == 2 and s.isdigit(), s
-
-
-# ─── cast ─────────────────────────────────────────────────────────────────
-
-def test_named_cast_includes_team(lab_script: str) -> None:
-    for name in ("Patty", "Abhi", "Tridib"):
-        assert f'name: "{name}"' in lab_script, f"agent display name {name!r} missing"
-
-
-def test_no_stale_old_names_in_captions(lab_script: str) -> None:
-    """Bob/Eli/Gus should have been swapped out everywhere they were
-    rendered to the user."""
-    # Inspect only string literals (caption / log / desc), not identifiers.
-    rendered = re.findall(r'"((?:[^"\\]|\\.)*)"', lab_script)
-    bag = " ".join(rendered)
-    for stale in ("Bob ", " Eli ", " Gus ", "Bob's", "Eli's", "Gus's"):
-        assert stale not in bag, f"stale name fragment still visible: {stale!r}"
-
-
-# ─── home page link ───────────────────────────────────────────────────────
-
-def test_home_links_to_lab(home_html: str) -> None:
-    assert 'href="./lab/index.html"' in home_html, "home page missing multi-page lab link"
-    assert 'href="./agents-demo.html"' in home_html, "home page missing canvas lab link"
-
-
-def test_simulator_links_to_multipage_lab(simulator_html: str) -> None:
-    assert 'href="./lab/index.html"' in simulator_html, "simulator missing multi-page lab link"
-    assert 'href="./agents-demo.html"' in simulator_html, "simulator missing canvas playground link"
-
-
-def test_lab_links_back_to_home(lab_html: str) -> None:
-    assert 'href="./index.html"' in lab_html
-
-
-# ─── JS syntax ────────────────────────────────────────────────────────────
-
-def test_js_has_no_syntax_errors(lab_script: str) -> None:
-    """Run the embedded script through ``node --check``.
-
-    We pass it as ``module`` syntax via a temp ``.mjs`` so top-level returns
-    aren't an issue. The script is wrapped in an IIFE so it parses standalone.
-    """
-    node = runnable_node()
-    if node is None:
-        pytest.skip("node not runnable on PATH")
-
-    with tempfile.NamedTemporaryFile("w", suffix=".mjs", delete=False) as f:
-        f.write(lab_script)
-        path = f.name
-    try:
-        proc = subprocess.run(
-            [node, "--check", path],
-            capture_output=True, text=True, check=False, timeout=15,
-        )
-    finally:
-        Path(path).unlink(missing_ok=True)
-    assert proc.returncode == 0, proc.stderr or proc.stdout
-
-
-# ─── tooltip + hover affordances ──────────────────────────────────────────
-
-def test_tooltip_wired(lab_script: str) -> None:
-    assert "renderTooltip" in lab_script
-    assert "ttEl.classList.add(\"show\")" in lab_script
-
-
-def test_hover_ripple_and_scale(lab_script: str) -> None:
-    # ripple state + hover ease are both required by the new hover treatment
-    assert "_ripples" in lab_script
-    assert "_hoverEase" in lab_script
-
-
-# ─── kinds, shapes, informatics ────────────────────────────────────────────
-
-def test_three_kinds_present(lab_script: str) -> None:
-    """human / bot / contract — every agent should be tagged with one."""
-    for kind in ('"human"', '"bot"', '"contract"'):
-        assert f"kind: {kind}" in lab_script, f"no agents declared as {kind}"
-
-
-def test_shape_dispatch_present(lab_script: str) -> None:
-    """drawAgent should dispatch on the three new shape branches."""
-    for branch in ("squircle", "octagon", "hex"):
-        assert branch in lab_script, f"shape `{branch}` not referenced"
-    assert "drawSquircleBody" in lab_script
-    assert "drawOctagonBody"  in lab_script
-    assert "drawHexBody"      in lab_script
-
-
-def test_tooltip_includes_informatics(lab_script: str) -> None:
-    """Tooltip should surface protocols, sig alg, kind, last seen."""
-    must_contain = ["protocols", "sigAlg", "lastSeen",
-                    "ttproto", "ttdesc"]
-    for s in must_contain:
-        assert s in lab_script, f"tooltip missing informatics field: {s}"
-
-
-def test_scene_groups_present(lab_script: str) -> None:
-    """Pill bar should be grouped: primitives / use cases / meta."""
-    assert "SCENE_GROUPS" in lab_script
-    for label in ('"primitives"', '"use cases"', '"meta"'):
-        assert label in lab_script, f"scene group {label} missing"
-
-
-def test_add_scene_cta_present(lab_script: str, lab_html: str) -> None:
-    """`+ Add your scene` CTA should link to SCENES.md."""
-    assert "add-scene" in lab_script or "add-scene" in lab_html
-    assert "SCENES.md" in lab_script
-
-
-def test_scenes_md_file_exists() -> None:
-    md = WEB / "SCENES.md"
-    assert md.is_file(), "web/SCENES.md missing — scene-template doc is required"
-    body = md.read_text()
-    # contract checks — these are load-bearing for contributors
-    for hook in ("SCENES.myScene", "enter()", "tick(t)", "EXPECTED_SCENES"):
-        assert hook in body, f"SCENES.md missing required example: {hook}"
-
-
-# ─── cast refinement ───────────────────────────────────────────────────────
-
-def test_sara_added_as_human(lab_script: str) -> None:
-    """Split-bill scene now uses Sara instead of an AI agent."""
-    assert 'name: "Sara"' in lab_script
-    assert 'kind: "human"' in lab_script   # at least one explicit human kind
-
-
-# ─── scene-controls + live tooltip + why-card ──────────────────────────────
-
-def test_scene_controls_mechanism(lab_script: str) -> None:
-    """Scenes can declare controls; renderer mounts them in #ctlPanel."""
-    assert "renderControls" in lab_script
-    assert "scene.ctl" in lab_script
-    # auction scene declares the new controls
-    assert 'id: "scenario"' in lab_script
-    assert 'id: "bid_eli"' in lab_script
-    assert 'id: "bid_gus"' in lab_script
-    assert 'id: "bid_hana"' in lab_script
-
-
-def test_auction_has_scenario_presets(lab_script: str) -> None:
-    """Three documented scenarios available as preset buttons."""
-    for preset in ('"cheapestWins"', '"overBudget"', '"tie"'):
-        assert preset in lab_script, f"auction preset {preset} missing"
-
-
-def test_tooltip_live_refresh(lab_script: str) -> None:
-    """rAF loop should refresh tooltip while hover is active."""
-    assert "lastClient" in lab_script
-    # The live-refresh hook is inside step(); ensure renderTooltip is called
-    # from inside the loop body, not just from the mousemove handler.
-    step_block = lab_script.split("function step()")[1].split("function renderInfo()")[0]
-    assert "renderTooltip" in step_block, "renderTooltip not called from step() loop"
-
-
-def test_why_card_supported(lab_script: str) -> None:
-    """Scenes can declare a why-card; renderer mounts it under the desc."""
-    assert "renderWhyCard" in lab_script
-    assert "why-card" in lab_script
-    # Escrow scene + auction scene both publish a why
-    assert 'why: "' in lab_script or 'why: `' in lab_script
-
-
-# ─── theme toggle ─────────────────────────────────────────────────────────
-
-def test_theme_toggle_present(lab_html: str, lab_script: str) -> None:
-    """Sun/moon toggle in header, light tokens defined."""
-    assert 'id="themeBtn"' in lab_html
-    assert "data-theme=\"light\"" in lab_html
-    assert "applyTheme" in lab_script
-    assert "localStorage" in lab_script
-
-
-# ─── transport / step controls ────────────────────────────────────────────
-
-def test_transport_bar_present(lab_html: str, lab_script: str) -> None:
-    """Restart / play-pause / step / speed all wired."""
-    for needle in ('id="btnRestart"', 'id="btnPlayPause"', 'id="btnStep"', 'id="speedSel"'):
-        assert needle in lab_html, f"transport bar missing element: {needle}"
-    assert "stepOneEvent" in lab_script
-    assert "stepWatcher" in lab_script
-    assert "speedMul" in lab_script
-
-
-# ─── neobrutalist agents ──────────────────────────────────────────────────
-
-def test_neobrutalist_renderer(lab_script: str) -> None:
-    """Solid two-tone fills + block shadow + ink outlines, no radial gradients."""
-    assert "brutFills" in lab_script
-    assert "shadowInk()" in lab_script
-    assert "inkColor()" in lab_script
-    # The previous soft halo + soft radial gradient on the body has been
-    # removed. We assert this directly: drawCircleBody should no longer
-    # call createRadialGradient.
-    body_block = lab_script.split("function drawCircleBody")[1].split("function drawSquircleBody")[0]
-    assert "createRadialGradient" not in body_block, "agent body still uses radial gradient (not brutalist)"
-
-
-# ─── responsive layout ────────────────────────────────────────────────────
-
-def test_responsive_layout(lab_html: str, lab_script: str) -> None:
-    """Media queries + drawer toggles wired for narrow viewports."""
-    assert "@media (max-width: 1100px)" in lab_html
-    assert "@media (max-width: 800px)" in lab_html
-    assert 'id="logToggleBtn"' in lab_html
-    assert 'id="infoToggleBtn"' in lab_html
-    assert "log-open" in lab_script
-    assert "info-open" in lab_script
-
-
-# ─── elaborated taxi scene ────────────────────────────────────────────────
-
-def test_taxi_is_elaborated(lab_script: str) -> None:
-    """Multi-waypoint route, animated taxi icon, fare + ETA controls + HUD."""
-    taxi_block = lab_script.split("SCENES.taxi = {")[1].split("SCENES.cafe")[0]
-    for needle in ("wp = [", "wpTotal", "drawTaxi", "posAtDistance",
-                   "fareBase", "perKm", "tripKm", "RIDE TELEMETRY"):
-        assert needle in taxi_block, f"taxi scene missing: {needle}"
-
-
-def test_cafe_walkby(lab_script: str) -> None:
-    """Café scene reworked: Patty walks past, agent pre-orders ahead, coffee ready on arrival."""
-    cafe_block = lab_script.split("SCENES.cafe = {")[1].split("SCENES.delivery")[0]
-    # named after Work-In-Progress (real shop)
-    assert "Work-In-Progress" in cafe_block, "café scene must reference Work-In-Progress"
-    # walking + brewing both modeled
-    for needle in ("walkT", "brewT", "brewing", "ready", "handover",
-                   "proximity ping", "Siolim"):
-        assert needle in cafe_block, f"café walk-by missing: {needle}"
-
-
-def test_venues_renamed(lab_script: str) -> None:
-    """Real Siolim venues named in the registry."""
-    assert 'name: "Work-In-Progress POS"' in lab_script
-    assert 'name: "Eat Pray Love POS"' in lab_script
-
-
-def test_trip_scene(lab_script: str) -> None:
-    """Multi-city trip scene: 5 cities, rolling escrow, plane animation,
-    agents ride the plane, delay/rebook branch, working pulse during stay."""
-    trip_block = lab_script.split("SCENES.trip = {")[1].split("// ─── scene registry")[0]
-    # core scaffolding
-    for needle in ("tokyo", "la", "goa", "london", "dubai",
-                   "drawPlane", "planeT", "nightsLeft", "advanceLeg",
-                   "ITINERARY", "rolling escrow"):
-        assert needle in trip_block, f"trip scene missing: {needle}"
-    # polish — agents on the plane, delay branch, working state, slot helpers
-    for needle in ("_slotAt", "_hotelSlot", "_planeXY",
-                   "boarding", "_delayed", "rebook",
-                   "WORKING", "_workingPulse",
-                   "delayRate"):
-        assert needle in trip_block, f"trip-scene polish element missing: {needle}"
+    return HOME.read_text(encoding="utf-8")
+
+
+@pytest.fixture(scope="module")
+def lab_script(lab_html: str) -> str:
+    m = re.search(r"<script>(.*?)</script>", lab_html, re.DOTALL)
+    assert m, "expected one <script> block in lab HTML"
+    return m.group(1)
+
+
+# ─── shape ────────────────────────────────────────────────────────────────
+
+def test_files_exist() -> None:
+    assert LAB.is_file(), f"missing {LAB}"
+    assert HOME.is_file(), f"missing {HOME}"
+
+
+def test_html_parses(lab_html: str) -> None:
+    class P(html.parser.HTMLParser):
+        def __init__(self) -> None:
+            super().__init__()
+            self.errors: list[str] = []
+
+        def error(self, message: str) -> None:    # pragma: no cover
+            self.errors.append(message)
+
+    p = P()
+    p.feed(lab_html)
+    assert not p.errors, p.errors
+
+
+def test_structural_anchors(lab_html: str) -> None:
+    must_contain = [
+        '<canvas id="canvas">',
+        '<div class="scene-bar" id="sceneBar">',
+        '<div class="tt" id="tooltip">',
+        'id="sbTitle"',
+        'class="sb-char"',
+    ]
+    for s in must_contain:
+        assert s in lab_html, f"missing structural anchor: {s}"
+
+
+# ─── split-flap title ─────────────────────────────────────────────────────
+
+def test_switchboard_title_letters(lab_html: str) -> None:
+    matches = re.findall(r'data-target="([^"]+)"', lab_html)
+    # First 11 letters are the title; trailing ones may belong to scenes.
+    title_letters = "".join(matches[:11])
+    assert title_letters == "switchboard", title_letters
+
+
+def test_scramble_logic_present(lab_script: str) -> None:
+    assert "scrambleSwitchboard" in lab_script
+    assert "mouseenter" in lab_script
+    assert "settled" in lab_script and "scrambling" in lab_script
+
+
+# ─── scenes ───────────────────────────────────────────────────────────────
+
+EXPECTED_SCENES = [
+    "x402", "escrow", "stream", "auction", "hitl", "fanout", "oracle", "pq", "stack",
+    "taxi", "cafe", "delivery", "split", "ethEscrow", "subscribe", "trip",
+    "oracleGame_soon",
+]
+
+
+def test_scene_order_matches(lab_script: str) -> None:
+    m = re.search(r"SCENE_ORDER\s*=\s*\[([^\]]+)\]", lab_script)
+    assert m, "SCENE_ORDER array not found"
+    order = re.findall(r'"([^"]+)"', m.group(1))
+    assert order == EXPECTED_SCENES, order
+
+
+def test_every_scene_has_definition(lab_script: str) -> None:
+    for scene_id in EXPECTED_SCENES:
+        # accept either `SCENES.x = {` (inline scene def) or
+        # `SCENES.x = makeComingSoonScene({` (factory pattern for placeholders)
+        inline  = f"SCENES.{scene_id} = {{" in lab_script
+        factory = f"SCENES.{scene_id} = make" in lab_script
+        assert inline or factory, f"SCENES.{scene_id} missing (neither inline nor factory)"
+        # each should have a name and short label somewhere in its def
+        block_m = re.search(
+            rf"SCENES\.{scene_id}\s*=.*?id:\s*\"{scene_id}\".*?name:\s*\"([^\"]+)\".*?short:\s*\"([^\"]+)\"",
+            lab_script, re.DOTALL,
+        )
+        assert block_m, f"scene {scene_id} missing name/short"
+        name, short = block_m.group(1), block_m.group(2)
+        assert name and short, f"scene {scene_id} has empty name or short"
+
+
+def test_scene_short_codes_are_zero_padded(lab_script: str) -> None:
+    shorts = re.findall(r'short:\s*"(\d+)"', lab_script)
+    assert len(shorts) == len(EXPECTED_SCENES), shorts
+    for s in shorts:
+        assert len(s) == 2 and s.isdigit(), s
+
+
+# ─── cast ─────────────────────────────────────────────────────────────────
+
+def test_named_cast_includes_team(lab_script: str) -> None:
+    for name in ("Patty", "Abhi", "Tridib"):
+        assert f'name: "{name}"' in lab_script, f"agent display name {name!r} missing"
+
+
+def test_no_stale_old_names_in_captions(lab_script: str) -> None:
+    """Bob/Eli/Gus should have been swapped out everywhere they were
+    rendered to the user."""
+    # Inspect only string literals (caption / log / desc), not identifiers.
+    rendered = re.findall(r'"((?:[^"\\]|\\.)*)"', lab_script)
+    bag = " ".join(rendered)
+    for stale in ("Bob ", " Eli ", " Gus ", "Bob's", "Eli's", "Gus's"):
+        assert stale not in bag, f"stale name fragment still visible: {stale!r}"
+
+
+# ─── home page link ───────────────────────────────────────────────────────
+
+def test_home_links_to_lab(home_html: str) -> None:
+    assert 'href="./agents-demo.html"' in home_html, "home page missing lab link"
+
+
+def test_lab_links_back_to_home(lab_html: str) -> None:
+    assert 'href="./index.html"' in lab_html
+
+
+# ─── JS syntax ────────────────────────────────────────────────────────────
+
+@pytest.mark.skipif(shutil.which("node") is None, reason="node not on PATH")
+def test_js_has_no_syntax_errors(lab_script: str) -> None:
+    """Run the embedded script through ``node --check``.
+
+    We pass it as ``module`` syntax via a temp ``.mjs`` so top-level returns
+    aren't an issue. The script is wrapped in an IIFE so it parses standalone.
+    """
+    with tempfile.NamedTemporaryFile("w", suffix=".mjs", delete=False, encoding="utf-8") as f:
+        f.write(lab_script)
+        path = f.name
+    try:
+        proc = subprocess.run(
+            ["node", "--check", path],
+            capture_output=True, text=True, check=False, timeout=15,
+        )
+    finally:
+        Path(path).unlink(missing_ok=True)
+    assert proc.returncode == 0, proc.stderr or proc.stdout
+
+
+# ─── tooltip + hover affordances ──────────────────────────────────────────
+
+def test_tooltip_wired(lab_script: str) -> None:
+    assert "renderTooltip" in lab_script
+    assert "ttEl.classList.add(\"show\")" in lab_script
+
+
+def test_hover_ripple_and_scale(lab_script: str) -> None:
+    # ripple state + hover ease are both required by the new hover treatment
+    assert "_ripples" in lab_script
+    assert "_hoverEase" in lab_script
+
+
+# ─── kinds, shapes, informatics ────────────────────────────────────────────
+
+def test_three_kinds_present(lab_script: str) -> None:
+    """human / bot / contract — every agent should be tagged with one."""
+    for kind in ('"human"', '"bot"', '"contract"'):
+        assert f"kind: {kind}" in lab_script, f"no agents declared as {kind}"
+
+
+def test_shape_dispatch_present(lab_script: str) -> None:
+    """drawAgent should dispatch on the three new shape branches."""
+    for branch in ("squircle", "octagon", "hex"):
+        assert branch in lab_script, f"shape `{branch}` not referenced"
+    assert "drawSquircleBody" in lab_script
+    assert "drawOctagonBody"  in lab_script
+    assert "drawHexBody"      in lab_script
+
+
+def test_tooltip_includes_informatics(lab_script: str) -> None:
+    """Tooltip should surface protocols, sig alg, kind, last seen."""
+    must_contain = ["protocols", "sigAlg", "lastSeen",
+                    "ttproto", "ttdesc"]
+    for s in must_contain:
+        assert s in lab_script, f"tooltip missing informatics field: {s}"
+
+
+def test_scene_groups_present(lab_script: str) -> None:
+    """Pill bar should be grouped: primitives / use cases / meta."""
+    assert "SCENE_GROUPS" in lab_script
+    for label in ('"primitives"', '"use cases"', '"meta"'):
+        assert label in lab_script, f"scene group {label} missing"
+
+
+def test_add_scene_cta_present(lab_script: str, lab_html: str) -> None:
+    """`+ Add your scene` CTA should link to SCENES.md."""
+    assert "add-scene" in lab_script or "add-scene" in lab_html
+    assert "SCENES.md" in lab_script
+
+
+def test_scenes_md_file_exists() -> None:
+    md = WEB / "SCENES.md"
+    assert md.is_file(), "web/SCENES.md missing — scene-template doc is required"
+    body = md.read_text(encoding="utf-8")
+    # contract checks — these are load-bearing for contributors
+    for hook in ("SCENES.myScene", "enter()", "tick(t)", "EXPECTED_SCENES"):
+        assert hook in body, f"SCENES.md missing required example: {hook}"
+
+
+# ─── cast refinement ───────────────────────────────────────────────────────
+
+def test_sara_added_as_human(lab_script: str) -> None:
+    """Split-bill scene now uses Sara instead of an AI agent."""
+    assert 'name: "Sara"' in lab_script
+    assert 'kind: "human"' in lab_script   # at least one explicit human kind
+
+
+# ─── scene-controls + live tooltip + why-card ──────────────────────────────
+
+def test_scene_controls_mechanism(lab_script: str) -> None:
+    """Scenes can declare controls; renderer mounts them in #ctlPanel."""
+    assert "renderControls" in lab_script
+    assert "scene.ctl" in lab_script
+    # auction scene declares the new controls
+    assert 'id: "scenario"' in lab_script
+    assert 'id: "bid_eli"' in lab_script
+    assert 'id: "bid_gus"' in lab_script
+    assert 'id: "bid_hana"' in lab_script
+
+
+def test_auction_has_scenario_presets(lab_script: str) -> None:
+    """Three documented scenarios available as preset buttons."""
+    for preset in ('"cheapestWins"', '"overBudget"', '"tie"'):
+        assert preset in lab_script, f"auction preset {preset} missing"
+
+
+def test_tooltip_live_refresh(lab_script: str) -> None:
+    """rAF loop should refresh tooltip while hover is active."""
+    assert "lastClient" in lab_script
+    # The live-refresh hook is inside step(); ensure renderTooltip is called
+    # from inside the loop body, not just from the mousemove handler.
+    step_block = lab_script.split("function step()")[1].split("function renderInfo()")[0]
+    assert "renderTooltip" in step_block, "renderTooltip not called from step() loop"
+
+
+def test_why_card_supported(lab_script: str) -> None:
+    """Scenes can declare a why-card; renderer mounts it under the desc."""
+    assert "renderWhyCard" in lab_script
+    assert "why-card" in lab_script
+    # Escrow scene + auction scene both publish a why
+    assert 'why: "' in lab_script or 'why: `' in lab_script
+
+
+# ─── theme toggle ─────────────────────────────────────────────────────────
+
+def test_theme_toggle_present(lab_html: str, lab_script: str) -> None:
+    """Sun/moon toggle in header, light tokens defined."""
+    assert 'id="themeBtn"' in lab_html
+    assert "data-theme=\"light\"" in lab_html
+    assert "applyTheme" in lab_script
+    assert "localStorage" in lab_script
+
+
+# ─── transport / step controls ────────────────────────────────────────────
+
+def test_transport_bar_present(lab_html: str, lab_script: str) -> None:
+    """Restart / play-pause / step / speed all wired."""
+    for needle in ('id="btnRestart"', 'id="btnPlayPause"', 'id="btnStep"', 'id="speedSel"'):
+        assert needle in lab_html, f"transport bar missing element: {needle}"
+    assert "stepOneEvent" in lab_script
+    assert "stepWatcher" in lab_script
+    assert "speedMul" in lab_script
+
+
+# ─── neobrutalist agents ──────────────────────────────────────────────────
+
+def test_neobrutalist_renderer(lab_script: str) -> None:
+    """Solid two-tone fills + block shadow + ink outlines, no radial gradients."""
+    assert "brutFills" in lab_script
+    assert "shadowInk()" in lab_script
+    assert "inkColor()" in lab_script
+    # The previous soft halo + soft radial gradient on the body has been
+    # removed. We assert this directly: drawCircleBody should no longer
+    # call createRadialGradient.
+    body_block = lab_script.split("function drawCircleBody")[1].split("function drawSquircleBody")[0]
+    assert "createRadialGradient" not in body_block, "agent body still uses radial gradient (not brutalist)"
+
+
+# ─── responsive layout ────────────────────────────────────────────────────
+
+def test_responsive_layout(lab_html: str, lab_script: str) -> None:
+    """Media queries + drawer toggles wired for narrow viewports."""
+    assert "@media (max-width: 1100px)" in lab_html
+    assert "@media (max-width: 800px)" in lab_html
+    assert 'id="logToggleBtn"' in lab_html
+    assert 'id="infoToggleBtn"' in lab_html
+    assert "log-open" in lab_script
+    assert "info-open" in lab_script
+
+
+# ─── elaborated taxi scene ────────────────────────────────────────────────
+
+def test_taxi_is_elaborated(lab_script: str) -> None:
+    """Multi-waypoint route, animated taxi icon, fare + ETA controls + HUD."""
+    taxi_block = lab_script.split("SCENES.taxi = {")[1].split("SCENES.cafe")[0]
+    for needle in ("wp = [", "wpTotal", "drawTaxi", "posAtDistance",
+                   "fareBase", "perKm", "tripKm", "RIDE TELEMETRY"):
+        assert needle in taxi_block, f"taxi scene missing: {needle}"
+
+
+def test_cafe_walkby(lab_script: str) -> None:
+    """Café scene reworked: Patty walks past, agent pre-orders ahead, coffee ready on arrival."""
+    cafe_block = lab_script.split("SCENES.cafe = {")[1].split("SCENES.delivery")[0]
+    # named after Work-In-Progress (real shop)
+    assert "Work-In-Progress" in cafe_block, "café scene must reference Work-In-Progress"
+    # walking + brewing both modeled
+    for needle in ("walkT", "brewT", "brewing", "ready", "handover",
+                   "proximity ping", "Siolim"):
+        assert needle in cafe_block, f"café walk-by missing: {needle}"
+
+
+def test_venues_renamed(lab_script: str) -> None:
+    """Real Siolim venues named in the registry."""
+    assert 'name: "Work-In-Progress POS"' in lab_script
+    assert 'name: "Eat Pray Love POS"' in lab_script
+
+
+def test_trip_scene(lab_script: str) -> None:
+    """Multi-city trip scene: 5 cities, rolling escrow, plane animation,
+    agents ride the plane, delay/rebook branch, working pulse during stay."""
+    trip_block = lab_script.split("SCENES.trip = {")[1].split("// ─── scene registry")[0]
+    # core scaffolding
+    for needle in ("tokyo", "la", "goa", "london", "dubai",
+                   "drawPlane", "planeT", "nightsLeft", "advanceLeg",
+                   "ITINERARY", "rolling escrow"):
+        assert needle in trip_block, f"trip scene missing: {needle}"
+    # polish — agents on the plane, delay branch, working state, slot helpers
+    for needle in ("_slotAt", "_hotelSlot", "_planeXY",
+                   "boarding", "_delayed", "rebook",
+                   "WORKING", "_workingPulse",
+                   "delayRate"):
+        assert needle in trip_block, f"trip-scene polish element missing: {needle}"