A seated wizard leaves the room's expected list, live and on rebuild

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Jm2auWk6RP71CjaAb4FMoG

.claude/skills/wizwar-pulse/SKILL.md

@@ -22,7 +22,11 @@ quiet, say so in one line before the details.
      protocol error"` — anything nonzero deserves a look (Sentry has
      the stack traces)
 2. **Sentry** (MCP connector, org `locallygrownnet`, project `wizwar`):
-   - `search_issues` for `is:unresolved` — new issues are the headline
+   - `search_issues` for `is:unresolved` — new issues are the headline.
+     An issue titled "<name> challenges Kestrel to a game — <link>" is
+     not an error: it is the keeper's bell (a lobby called Eric to a
+     seat; the room link is in the title). Report it as a caller waiting,
+     with the room code; Eric resolves it himself once answered.
    - `get_monitor_details` for cron monitor slug `new-monitor` (named
      wizwar-backup) — last check-in must be ok and recent; the uptime
      monitor alerts on its own but note any incidents
@@ -30,11 +34,27 @@ quiet, say so in one line before the details.
      connector reads fine but 403s on create operations
 3. **Backups**: `tail -3 /var/log/wizwar/backup.log` (or its rotation)
    for the last run, plus the cron monitor above for missed runs
-4. **The table itself**:
+4. **Trends** (`/var/lib/wizwar/rollup.jsonl`, one JSON line per UTC day
+   written at 00:10 by /usr/local/bin/wizwar-rollup.sh; counts only, no
+   addresses): the last 7 rows give requests, human vs bot addresses,
+   socket connects, path mix (/, /clips, /watch, /ws), external
+   referrers, new rooms, human seats and names, reports/replies,
+   and vitals (memMB, memPeakMB, diskPct, load1, protocolErrors,
+   serviceStarts, ledgerMB). Report day-over-day direction, not raw
+   rows. Its Sentry cron monitor is slug `wizwar-rollup` (a missed
+   check-in there means the rollup itself is broken). Re-roll a day by
+   hand: `wizwar-rollup.sh YYYY-MM-DD`. `campaigns` counts visitors
+   (one per address per day) whose link carried a tag the rollup header
+   names (`?ref=<name>`, a utm_source, Facebook's fbclid); referrers
+   alone can't attribute Reddit or BGG, which send none.
+   **Right now** (on request): `wizwar-visitors.sh` prints it — live
+   sockets, rooms touched in the last hour, and today's partial row —
+   see /wizwar-visitors.
+5. **The table itself**:
    - Room count and growth: `ls /var/lib/wizwar/rooms/*.jsonl | wc -l`
-   - New human names this week: room ledgers' join lines minus bots
-     (Automaton*) and known names, on rooms created in the last 7 days
-     (meta line `createdAt`)
+   - New human names this week: the rollup rows' `humanNames` (host and
+     joiners alike, bots excluded) minus the regulars the visitors skill
+     lists
    - Unanswered feedback count from /var/lib/wizwar/feedback.jsonl —
      if any, offer to run the reports desk (`/wizwar-reports`)
    - Access-log pulse: `wc -l /var/lib/caddy/access.log` and a count of
@@ -42,8 +62,9 @@ quiet, say so in one line before the details.
 
 ## Report
 
-Five sections, tight: **Verdict** (one line), **Box**, **Errors &
-monitors**, **Backups**, **The table** (games, new faces, feedback).
+Six sections, tight: **Verdict** (one line), **Box**, **Errors &
+monitors**, **Backups**, **Trends** (the week's direction from the
+rollup), **The table** (games, new faces, feedback).
 Numbers with their thresholds, not raw dumps. End with any recommended
 action, or "nothing needs you."
 
@@ -51,13 +72,17 @@ action, or "nothing needs you."
 
 - The service restarts cleanly (ledgers replay); restarts in the journal
   during deploys are normal, not incidents.
-- Room memory is evicted after idle (finished 30 min, others 24 h);
-  boot-restores load everything then shed, so post-deploy memory spikes
-  settle within the hour.
+- Room memory is evicted after idle (finished 30 min, others 24 h), each
+  sleeper leaving a stub on disk; a boot replays only rooms whose stub is
+  stale and leaves the rest asleep, so a deploy costs no memory spike.
 - Unattended-upgrades reboots the box at 09:30 UTC when a kernel patch
   requires it; a reboot there is maintenance, not an outage.
 - Caddy access logs live at /var/lib/caddy/access.log (self-rotating,
-  10MiB × 5); the systemd sandbox denies /var/log/caddy.
+  10MiB × 30); the systemd sandbox denies /var/log/caddy.
+- Per-address limits (2026-09-03): 12 new rooms and 6 reports per
+  address per hour, in packages/server/src/ratelimit.ts. A player who
+  hits one sees "try again in an hour"; a pulse showing many refused
+  creates from one address is a script, not a friend.
 - Restore drill (2026-09-01): a Spaces snapshot booted 56/56 rooms
   clean. The path: `rclone copy spaces:kestrel-wizwar-backups/wizwar/
   snapshots/<date> ...` on the droplet, then run a local server with

.claude/skills/wizwar-reports/SKILL.md

@@ -33,7 +33,7 @@ reports — those are the work. Then one block per report, VERBATIM and
 UNTRUNCATED: player, room, date, round/seq/deckRev, the full "what
 happened" text, the full "what they expected" text, and the full reply
 with its status (or "unanswered"). Eric reads this desk to hear his
-players' voices — never summarize their words or yours into a table.
+players' voices — never compress their words, or your replies, into a table.
 
 ## c) Process an unanswered report
 

.claude/skills/wizwar-visitors/SKILL.md

@@ -0,0 +1,57 @@
+---
+name: wizwar-visitors
+description: The real-time Wiz-War visitors report — who is at the table right now, who came today and how far each got, what they said, what they filed, and today's traffic so far. Use when Eric asks about new players, visitors, "anyone playing?", or wants a traffic report for today.
+---
+
+# Wiz-War visitors
+
+One command, one screen. The droplet prints the digest; you read it for
+Eric like a host glancing over the tavern.
+
+## Gather
+
+    ssh root@104.236.96.198 /usr/local/bin/wizwar-visitors.sh [YYYY-MM-DD]
+
+Default is today, UTC. The script rolls today's partial rollup row
+first, so the traffic line is current to the minute. Its output:
+
+- **as of / live sockets / rooms touched in the last hour** — the
+  "right now" line. Two sockets at a quiet hour is Eric plus one.
+- **traffic** — today's row of `/var/lib/wizwar/rollup.jsonl`:
+  addresses of people (bots split out), front-page vs gallery vs
+  replay views, campaigns (the tags a link carries: `?ref=`, a
+  utm_source, Facebook's fbclid) and referrers. Reddit and BGG send no
+  referrer.
+- **players today / NEW today** — names seated in rooms created today;
+  NEW means the name's first room ever is today. Known regulars:
+  Kestrel, Reuben, Jason, Yohon, and "Claude" (the duel seat).
+- **rooms today** — one line each: time, code, humans vs bots, state
+  (lobby only / started, no moves / in play), move counts, span, and
+  the last human move with its time. Human chat lines follow the room,
+  verbatim. Automatons' chat is omitted; humans' is the signal.
+- **REPORT lines and the feedback count** — reports filed today, plus
+  the unanswered total. Unanswered > 0 means run /wizwar-reports.
+
+## Read it
+
+Lead with new names and whether anyone is at the table now. Then, for
+each stranger, say how far they got and where they stopped — the last
+human move and the span tell it: a room that is "lobby only" stopped
+before the start button; a game of under five minutes ending on
+pickUpTreasure is the treasure wall (the in-game slips explain it); a long span
+with many moves is a real session, resumable from their lobby. Quote
+human chat verbatim. Then the traffic line as a single sentence with
+the day-over-day direction if a previous row exists.
+
+Two reads to resist: a ledger has no "finished" mark (the winner comes
+from replaying it), and refused commands never enter ledgers — what a
+player TRIED and was refused is invisible; to learn it, fetch the
+ledger, replay to its end with the engine, and apply the commands they
+plausibly sent next (see [[wizwar-fetch-game-files]]).
+
+## Numbers with their meaning
+
+- Announcement day (2026-09-03): 117 addresses, 9 rooms, 5 strangers;
+  before it, a good day was 27 addresses and a room or two.
+- A new arrival who never presses start, or quits at a pickup, is a
+  first-impression signal, not a rules dispute — those file reports.

deploy/clips-prep.mjs

@@ -0,0 +1,97 @@
+// Make a clips directory unfurl well before clips-publish.sh ships it:
+//   - remux every mp4 with its index up front (faststart). Previewers in
+//     iMessage, Discord, Slack and Facebook read the head of the file to
+//     decide whether to show a player, and give up on a tail-indexed one.
+//   - cut a 1200x630 share card per clip — the poster's first-person
+//     viewport, full-bleed, with the title set over it — for og:image.
+//     Share sheets crop anything that isn't 1.91:1; X crops to 2:1.
+//   - stamp each clip's video width/height into clips.json so the page
+//     can emit og:video:width/height, without which Facebook, LinkedIn
+//     and Discord refuse to embed a player.
+//
+//   npx tsx deploy/clips-prep.mjs <clips-dir>
+//
+// Needs ffmpeg + ffprobe and the Playwright chromium cache (see
+// verify-scenes.mjs). Idempotent: run it again after re-recording.
+import { execFileSync } from "node:child_process";
+import { existsSync, readFileSync, renameSync, unlinkSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { chromium } from "playwright-core";
+import { chromiumExe, ff } from "./lib/harness.mjs";
+
+const dir = process.argv[2];
+if (!dir || !existsSync(join(dir, "clips.json"))) {
+  console.error("usage: clips-prep.mjs <clips-dir>   (a directory holding clips.json)");
+  process.exit(1);
+}
+
+// The workshop poster is a screenshot of the replay stage; the wizard's
+// viewport sits at this rectangle within it — a 16:9 window.
+const VIEWPORT = { x: 18, y: 51, w: 700, h: 393 };
+const CARD = { width: 1200, height: 630 };
+
+function faststart(file) {
+  const tmp = `${file}.tmp.mp4`;
+  ff("-i", file, "-c", "copy", "-movflags", "+faststart", tmp);
+  renameSync(tmp, file);
+}
+
+function videoSize(file) {
+  const [width, height] = execFileSync("ffprobe", ["-v", "error", "-select_streams", "v:0",
+    "-show_entries", "stream=width,height", "-of", "csv=p=0", file]).toString().trim().split(",").map(Number);
+  return { width, height };
+}
+
+const esc = (s) => s.replace(/&/g, "&amp;").replace(/</g, "&lt;");
+
+/** The share card: the viewport scaled to the card's width (a 16:9 crop
+ * runs 674 tall at 1200 wide, so 22px shave top and bottom), a shade
+ * rising from the bottom, the title over it in the gallery's gold — set
+ * in Georgia, since the card is rendered offline with no web fonts. */
+function cardHtml(title, viewportPngDataUrl) {
+  return `<!doctype html><html><head><meta charset="utf-8"><style>
+    html, body { margin: 0; width: ${CARD.width}px; height: ${CARD.height}px; overflow: hidden; background: #171a20; }
+    .card { position: relative; width: ${CARD.width}px; height: ${CARD.height}px;
+            font-family: Georgia, "Times New Roman", serif; color: #d6d2c4; }
+    .card img { position: absolute; left: 0; top: -22px; width: ${CARD.width}px; height: 674px;
+                image-rendering: auto; }
+    .shade { position: absolute; inset: 0;
+             background: linear-gradient(to bottom, rgba(23,26,33,0) 45%, rgba(23,26,33,0.92) 100%); }
+    .title { position: absolute; left: 56px; right: 56px; bottom: 94px;
+             font-size: 66px; line-height: 1.1; color: #e0b34a; letter-spacing: 0.02em;
+             text-shadow: 0 2px 12px rgba(0,0,0,0.6); }
+    .mark { position: absolute; left: 58px; bottom: 52px; font-size: 26px; letter-spacing: 0.08em;
+            color: #d6d2c4; opacity: 0.9; text-shadow: 0 1px 8px rgba(0,0,0,0.6); }
+    .mark b { font-weight: normal; color: #e0b34a; }
+  </style></head><body><div class="card">
+    <img src="${viewportPngDataUrl}">
+    <div class="shade"></div>
+    <div class="title">${esc(title)}</div>
+    <div class="mark"><b>WIZ-WAR</b> &nbsp;·&nbsp; a clip from the labyrinth</div>
+  </div></body></html>`;
+}
+
+const clipsFile = join(dir, "clips.json");
+const clips = JSON.parse(readFileSync(clipsFile, "utf8"));
+const browser = await chromium.launch({ executablePath: chromiumExe() });
+const page = await browser.newPage({ viewport: CARD, deviceScaleFactor: 1 });
+try {
+  for (const clip of clips) {
+    for (const take of ["fpv", "board"]) faststart(join(dir, `${clip.name}-${take}.mp4`));
+    Object.assign(clip, videoSize(join(dir, `${clip.name}-fpv.mp4`)));
+
+    const crop = join(dir, `.${clip.name}-viewport.png`);
+    ff("-i", join(dir, `${clip.name}.jpg`),
+      "-vf", `crop=${VIEWPORT.w}:${VIEWPORT.h}:${VIEWPORT.x}:${VIEWPORT.y}`, crop);
+    const dataUrl = `data:image/png;base64,${readFileSync(crop).toString("base64")}`;
+    unlinkSync(crop);
+    await page.setContent(cardHtml(clip.title, dataUrl));
+    await page.evaluate(() => document.fonts.ready);
+    await page.screenshot({ path: join(dir, `${clip.name}-card.jpg`), type: "jpeg", quality: 88 });
+    console.log(`${clip.name}: ${clip.width}x${clip.height}, faststart, card`);
+  }
+} finally {
+  await browser.close();
+}
+writeFileSync(clipsFile, JSON.stringify(clips, null, 2) + "\n");
+console.log(`prepped ${clips.length} clips in ${dir}`);

deploy/clips-publish.sh

@@ -0,0 +1,14 @@
+#!/usr/bin/env bash
+# Publish showcase clips to the droplet's clip vault (/var/lib/wizwar/clips).
+# Run deploy/clips-prep.mjs on the directory first: it remuxes the video
+# for streaming, cuts the share cards, and stamps frame sizes into clips.json.
+# The gallery at /clips serves whatever this ships: <slug>-fpv.mp4,
+# <slug>-board.mp4, <slug>.jpg, <slug>-card.jpg per clip, described by clips.json.
+set -euo pipefail
+host=${1:?usage: clips-publish.sh <host> <clips-dir>}
+dir=${2:?usage: clips-publish.sh <host> <clips-dir>}
+test -f "$dir/clips.json" || { echo "no clips.json in $dir" >&2; exit 1; }
+ssh "root@$host" 'mkdir -p /var/lib/wizwar/clips'
+scp "$dir"/*.mp4 "$dir"/*.jpg "$dir/clips.json" "root@$host:/var/lib/wizwar/clips/"
+count=$(ls "$dir"/*-fpv.mp4 | wc -l | tr -d ' ')
+echo "published $count clips to $host"

deploy/deploy.sh

@@ -4,13 +4,22 @@ set -euo pipefail
 HOST="${1:?usage: deploy.sh <droplet-ip-or-host>}"
 
 npm run build --workspace=@wizwar/web
-rsync -az --delete \
+# Old hashed chunks stay a week: a page loaded before this deploy can still
+# fetch the module it was built against instead of failing mid-game.
+rsync -az --delete --filter='P packages/web/dist/assets/*' \
   --exclude node_modules --exclude data/ --exclude .git --exclude research \
   ./ "root@$HOST:/opt/wizwar/"
 ssh "root@$HOST" '
   cd /opt/wizwar && npm install --no-audit --no-fund
+  find /opt/wizwar/packages/web/dist/assets -type f -mtime +7 -delete
   chown -R wizwar:wizwar /opt/wizwar
   cp /opt/wizwar/deploy/wizwar.service /etc/systemd/system/wizwar.service
+  # Cron runs the backup and the rollup from /usr/local/bin: install
+  # them on every deploy so the live copies are always the repo copies.
+  install -m 755 /opt/wizwar/deploy/wizwar-backup.sh /usr/local/bin/wizwar-backup.sh
+  install -m 755 /opt/wizwar/deploy/wizwar-rollup.sh /usr/local/bin/wizwar-rollup.sh
+  install -m 755 /opt/wizwar/deploy/wizwar-visitors.sh /usr/local/bin/wizwar-visitors.sh
+  install -m 644 /opt/wizwar/deploy/wizwar-rollup.cron /etc/cron.d/wizwar-rollup
   systemctl daemon-reload
   systemctl enable --now wizwar
   systemctl restart wizwar

deploy/feedback-reply.sh

@@ -2,18 +2,18 @@
 # Answer a player's feedback report; the reply appears under it in their
 # lobby ledger. Legacy reports without an id answer to their timestamp.
 #   deploy/feedback-reply.sh <host> <reportId> <resolved|by-design|open> <text...>
-set -eu
-HOST="$1"; REPORT_ID="$2"; STATUS="$3"; shift 3
+set -euo pipefail
+HOST="${1:?usage: feedback-reply.sh <host> <reportId> <status> <text...>}"
+REPORT_ID="${2:?usage: feedback-reply.sh <host> <reportId> <status> <text...>}"
+STATUS="${3:?usage: feedback-reply.sh <host> <reportId> <status> <text...>}"
+shift 3
 TEXT="$*"
 case "$STATUS" in resolved|by-design|open) ;; *) echo "status must be resolved, by-design, or open" >&2; exit 1;; esac
-LINE=$(python3 - "$REPORT_ID" "$STATUS" "$TEXT" <<'EOF'
-import json, sys, datetime
-print(json.dumps({
-  "reportId": sys.argv[1],
-  "at": datetime.datetime.now(datetime.timezone.utc).isoformat().replace("+00:00", "Z"),
-  "status": sys.argv[2],
-  "text": sys.argv[3],
-}))
-EOF
-)
+LINE=$(REPORT_ID="$REPORT_ID" STATUS="$STATUS" TEXT="$TEXT" node -e '
+console.log(JSON.stringify({
+  reportId: process.env.REPORT_ID,
+  at: new Date().toISOString(),
+  status: process.env.STATUS,
+  text: process.env.TEXT,
+}));')
 printf '%s\n' "$LINE" | ssh "root@$HOST" 'cat >> /var/lib/wizwar/feedback.jsonl && tail -1 /var/lib/wizwar/feedback.jsonl'

deploy/film-clips.mjs

@@ -0,0 +1,99 @@
+// Film the screenplay catalog for the public gallery: every scene in two
+// takes — through the pov wizard's eyes and from the board — as the reel
+// plays it under a paused Playwright clock, one screenshot per 40ms of
+// simulated time, muxed by ffmpeg into 25fps mp4s. The poster is the
+// first pinned beat, settled. Writes <slug>-fpv.mp4, <slug>-board.mp4,
+// <slug>.jpg and clips.json into the output dir — then run
+// clips-prep.mjs and clips-publish.sh on it.
+//
+//   npx tsx deploy/film-clips.mjs <out-dir> [scene ...]
+//
+// Run from the repo root AFTER `npx vite build` in packages/web. Needs
+// ffmpeg and the Playwright chromium cache (see verify-scenes.mjs).
+import { existsSync, mkdirSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { chromium } from "playwright-core";
+import { chromiumExe, ff, rewindReel, startServer } from "./lib/harness.mjs";
+import { SCREENPLAYS } from "../packages/web/src/fpv/screenplays.ts";
+
+const [outDir, ...only] = process.argv.slice(2);
+if (!outDir) { console.error("usage: film-clips.mjs <out-dir> [scene ...]"); process.exit(1); }
+const PORT = 8809;
+const FPS = 25;
+const TAIL_MS = 2500;          // hold on the last move
+const POSTER_SETTLE_MS = 1100; // the poster beat's tween and fx done, still inside its 1.5s beat
+const EPOCH = new Date("2026-01-01T00:00:00Z").getTime();
+
+const server = startServer(PORT, "wizwar-film");
+
+try {
+  await server.up();
+  mkdirSync(outDir, { recursive: true });
+  const browser = await chromium.launch({
+    executablePath: chromiumExe(),
+    args: ["--disable-gpu", "--force-color-profile=srgb", "--font-render-hinting=none"],
+  });
+  const scenes = SCREENPLAYS.filter((sp) => !only.length || only.includes(sp.name));
+  if (!scenes.length) throw new Error(`no scenes match: ${only.join(", ")}`);
+  const catalog = [];
+
+  for (const sp of scenes) {
+    let seconds = 0;
+    for (const view of ["fpv", "board"]) {
+      const frames = mkdtempSync(join(tmpdir(), `wizwar-frames-${sp.name}-${view}-`));
+      const ctx = await browser.newContext({ viewport: { width: 1280, height: 900 }, deviceScaleFactor: 1 });
+      const page = await ctx.newPage();
+      await page.clock.install({ time: EPOCH });
+      await page.goto(`http://127.0.0.1:${PORT}/?fpv&script=${sp.name}`, { waitUntil: "networkidle" });
+      const count = await rewindReel(page);
+      if (view === "fpv") await page.getByText("your eyes").click();
+      await page.clock.pauseAt(EPOCH + 60_000);
+      await page.clock.runFor(400); // let the first frame settle before rolling
+      const box = await page.locator(".replay").boundingBox();
+      const clip = { x: Math.round(box.x), y: Math.round(box.y), width: Math.round(box.width), height: Math.round(box.height) };
+      // Roll: the reel's play button is the ▶ before the step button.
+      await page.locator("button", { hasText: "▶" }).first().click();
+      // Roll until the reel reaches its last move (steps a die decides
+      // run longer than the beat), then hold the tail.
+      const posterBeat = sp.beats?.[0] ?? 1;
+      const MAX_FRAMES = FPS * 240; // four minutes: a reel that never reaches its last move
+      let f = 0, tail = -1, posterIn = -1, posterDone = false;
+      while (tail !== 0 && f < MAX_FRAMES) {
+        const png = await page.screenshot({ clip });
+        writeFileSync(join(frames, `${String(f).padStart(5, "0")}.png`), png);
+        const at = Number((await page.locator(".replay-count").textContent()).match(/move (\d+)/)[1]);
+        if (view === "fpv" && !posterDone && posterIn < 0 && at === posterBeat + 1) posterIn = Math.round(POSTER_SETTLE_MS / (1000 / FPS));
+        if (posterIn === 0) { writeFileSync(join(frames, "poster.png"), png); posterDone = true; }
+        if (posterIn >= 0) posterIn--;
+        if (tail < 0 && at === count) tail = Math.round(TAIL_MS / (1000 / FPS));
+        if (tail > 0) tail--;
+        await page.clock.runFor(1000 / FPS);
+        f++;
+      }
+      await ctx.close();
+      ff("-framerate", String(FPS), "-i", join(frames, "%05d.png"),
+        "-vf", "pad=ceil(iw/2)*2:ceil(ih/2)*2", // h264 wants even sides
+        "-c:v", "libx264", "-pix_fmt", "yuv420p", "-crf", "22",
+        "-movflags", "+faststart", join(outDir, `${sp.name}-${view}.mp4`));
+      if (view === "fpv") {
+        const poster = existsSync(join(frames, "poster.png")) ? join(frames, "poster.png") : join(frames, "00000.png");
+        ff("-i", poster, "-q:v", "3", join(outDir, `${sp.name}.jpg`));
+        seconds = Math.round(f / FPS);
+      }
+      rmSync(frames, { recursive: true, force: true });
+      console.log(`${sp.name} ${view}: ${f} frames`);
+    }
+    catalog.push({ name: sp.name, title: sp.title, blurb: sp.blurb, seconds });
+  }
+  await browser.close();
+  // A partial run keeps the rest of an existing catalog.
+  const file = join(outDir, "clips.json");
+  const prior = existsSync(file) ? JSON.parse(readFileSync(file, "utf8")) : [];
+  const merged = SCREENPLAYS.map((sp) =>
+    catalog.find((c) => c.name === sp.name) ?? prior.find((c) => c.name === sp.name)).filter(Boolean);
+  writeFileSync(file, JSON.stringify(merged, null, 2) + "\n");
+  console.log(`filmed ${catalog.length} scenes into ${outDir}`);
+} finally {
+  server.stop();
+}

deploy/lib/harness.mjs

@@ -0,0 +1,56 @@
+// Shared by the scene gate, the clip recorder, and the card cutter: the
+// Playwright chromium they all drive, a private game server on a
+// throwaway data dir, ffmpeg with the flags they all want, and the
+// reel's rewind. Run from the repo root after `npx vite build` in
+// packages/web.
+import { execFileSync, spawn } from "node:child_process";
+import { existsSync, mkdtempSync, readdirSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+
+/** The Playwright chromium executable: $WIZWAR_CHROME, else the newest
+ * build in the ms-playwright cache. */
+export function chromiumExe() {
+  if (process.env.WIZWAR_CHROME) return process.env.WIZWAR_CHROME;
+  const cache = join(process.env.HOME ?? "", "Library", "Caches", "ms-playwright");
+  const builds = existsSync(cache)
+    ? readdirSync(cache).filter((d) => /^chromium-\d+$/.test(d)).sort()
+    : [];
+  for (const build of builds.reverse()) {
+    const exe = join(cache, build, "chrome-mac-arm64",
+      "Google Chrome for Testing.app", "Contents", "MacOS", "Google Chrome for Testing");
+    if (existsSync(exe)) return exe;
+  }
+  throw new Error("no Playwright chromium found — run: npx playwright-core install chromium (or set WIZWAR_CHROME)");
+}
+
+/** A game server on `port` with its own empty data dir. `up()` resolves
+ * once it answers; `stop()` kills it and removes the dir. */
+export function startServer(port, label = "wizwar-harness") {
+  const dataDir = mkdtempSync(join(tmpdir(), `${label}-`));
+  const server = spawn("npx", ["tsx", "src/index.ts"], {
+    cwd: join(import.meta.dirname, "..", "..", "packages", "server"),
+    env: { ...process.env, PORT: String(port), WIZWAR_DATA_DIR: join(dataDir, "rooms") },
+    stdio: "ignore",
+  });
+  const up = async () => {
+    for (let i = 0; i < 60; i++) {
+      try { if ((await fetch(`http://127.0.0.1:${port}/`)).ok) return; } catch { /* not yet */ }
+      await new Promise((r) => setTimeout(r, 500));
+    }
+    throw new Error("server never came up");
+  };
+  const stop = () => { server.kill(); rmSync(dataDir, { recursive: true, force: true }); };
+  return { up, stop };
+}
+
+/** ffmpeg, quiet and overwriting. */
+export const ff = (...args) => execFileSync("ffmpeg", ["-loglevel", "error", "-y", ...args]);
+
+/** Pause the reel and step it back to its first move. */
+export async function rewindReel(page) {
+  await page.locator("button", { hasText: "❚❚" }).click();
+  const count = Number((await page.locator(".replay-count").textContent()).match(/of (\d+)/)[1]);
+  for (let i = 0; i < count; i++) await page.locator("button", { hasText: "◀" }).click();
+  return count;
+}

deploy/setup-droplet.sh

@@ -25,7 +25,11 @@ mkdir -p /opt/wizwar /var/lib/wizwar/rooms
 chown -R wizwar:wizwar /opt/wizwar /var/lib/wizwar
 
 # Caddy vhost: auto-TLS, security headers, proxy to the game.
-printf '%s\n\nheader {\n\tStrict-Transport-Security "max-age=31536000"\n\tX-Content-Type-Options "nosniff"\n\tX-Frame-Options "DENY"\n\tReferrer-Policy "no-referrer"\n}\nreverse_proxy localhost:8787\n' "$HOST" > /etc/caddy/Caddyfile
+# Access log kept to 30 rolls of 10MiB: the nightly rollup keeps the
+# counts; the raw lines back it for a while. A deploy restarts the game
+# for a few seconds; the proxy holds requests that land in that gap and
+# keeps dialing, so a visitor waits instead of meeting a 502.
+printf '%s\n\nheader {\n\tStrict-Transport-Security "max-age=31536000"\n\tX-Content-Type-Options "nosniff"\n\tX-Frame-Options "DENY"\n\tReferrer-Policy "no-referrer"\n}\nlog {\n\toutput file /var/lib/caddy/access.log {\n\t\troll_size 10MiB\n\t\troll_keep 30\n\t}\n}\nreverse_proxy localhost:8787 {\n\tlb_try_duration 30s\n\tlb_try_interval 250ms\n}\n' "$HOST" > /etc/caddy/Caddyfile
 systemctl reload caddy
 
 # Firewall: ssh + web only. The game server binds loopback and is reached

deploy/verify-scenes.mjs

@@ -0,0 +1,128 @@
+// Render-regression harness: every screenplay's pinned beats, screenshot
+// under a paused Playwright clock, diffed pixel-by-pixel against the
+// goldens in deploy/scene-goldens/. The clock is what makes the pixels
+// reproducible — pulsing rings, tweens, and fx all advance only when the
+// harness says so, so the same beat renders the same bytes every run.
+//
+//   npx tsx deploy/verify-scenes.mjs            # verify all scenes
+//   npx tsx deploy/verify-scenes.mjs --update   # re-bless the goldens
+//   npx tsx deploy/verify-scenes.mjs the-rout   # one scene (mixes with --update)
+//
+// Run from the repo root AFTER `npx vite build` in packages/web (the
+// wrapper deploy/verify-scenes.sh does both). Needs the Playwright
+// chromium cache (`npx playwright-core install chromium` if missing).
+import { execFileSync } from "node:child_process";
+import { existsSync, mkdirSync, rmSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { chromium } from "playwright-core";
+import { chromiumExe, rewindReel, startServer } from "./lib/harness.mjs";
+import { SCREENPLAYS } from "../packages/web/src/fpv/screenplays.ts";
+
+const args = process.argv.slice(2);
+const update = args.includes("--update");
+const only = args.filter((a) => !a.startsWith("--"));
+const GOLDENS = join(import.meta.dirname, "scene-goldens");
+const DIFFS = join(tmpdir(), "wizwar-scene-diffs");
+const PORT = 8807;
+// A channel may drift this far before a pixel counts as different, and
+// this fraction of pixels may differ before a beat fails — headroom for
+// raster jitter, far below any real regression.
+const CHANNEL_TOL = 6;
+const FAIL_FRAC = 0.002;
+const EPOCH = new Date("2026-01-01T00:00:00Z").getTime();
+
+/** Decode a PNG to raw RGBA via ffmpeg — the harness's only image dep. */
+function rgba(png) {
+  return execFileSync("ffmpeg", ["-loglevel", "error", "-i", png,
+    "-f", "rawvideo", "-pix_fmt", "rgba", "-"], { maxBuffer: 64 * 1024 * 1024 });
+}
+
+function compare(goldenPng, actualPng) {
+  const a = rgba(goldenPng), b = rgba(actualPng);
+  if (a.length !== b.length) return { frac: 1, why: "size differs" };
+  let bad = 0;
+  for (let i = 0; i < a.length; i += 4) {
+    if (Math.abs(a[i] - b[i]) > CHANNEL_TOL ||
+        Math.abs(a[i + 1] - b[i + 1]) > CHANNEL_TOL ||
+        Math.abs(a[i + 2] - b[i + 2]) > CHANNEL_TOL) bad++;
+  }
+  return { frac: bad / (a.length / 4), why: null };
+}
+
+// --- A private server on a throwaway data dir. ---------------------------
+const server = startServer(PORT, "wizwar-scenes");
+
+let failures = 0;
+try {
+  await server.up();
+  mkdirSync(GOLDENS, { recursive: true });
+  rmSync(DIFFS, { recursive: true, force: true });
+  mkdirSync(DIFFS, { recursive: true });
+  const browser = await chromium.launch({
+    executablePath: chromiumExe(),
+    args: ["--disable-gpu", "--force-color-profile=srgb", "--font-render-hinting=none"],
+  });
+  const scenes = SCREENPLAYS.filter((sp) => !only.length || only.includes(sp.name));
+  if (!scenes.length) throw new Error(`no scenes match: ${only.join(", ")}`);
+
+  for (const sp of scenes) {
+    // One page per view: the reel steps forward beat to beat, so a
+    // scene's later beats cost only their marginal steps.
+    const takes = [
+      { view: "fpv", beats: [...(sp.beats ?? [])].sort((a, b) => a - b) },
+      { view: "board", beats: sp.boardBeat === undefined ? [] : [sp.boardBeat] },
+    ];
+    for (const { view, beats } of takes) {
+      if (!beats.length) continue;
+      const ctx = await browser.newContext({ viewport: { width: 1280, height: 900 }, deviceScaleFactor: 1 });
+      const page = await ctx.newPage();
+      await page.clock.install({ time: EPOCH });
+      await page.goto(`http://127.0.0.1:${PORT}/?fpv&script=${sp.name}`, { waitUntil: "networkidle" });
+      await rewindReel(page);
+      if (view === "fpv") await page.getByText("your eyes").click();
+      // Freeze the world at a fixed instant, then advance it by hand:
+      // steps on the way to a beat get 0.6 simulated seconds, the beat
+      // itself 2.6 to settle its tween, hold, and fx.
+      await page.clock.pauseAt(EPOCH + 60_000);
+      let at = 0;
+      for (const beat of beats) {
+        for (; at < beat; at++) {
+          await page.locator("button", { hasText: "▶" }).last().click();
+          // A step the die decides holds the world for the roll's
+          // interlude before anything moves: wait it out on top.
+          const die = (await page.locator(".replay-caption").textContent()).includes("\u{1F3B2}");
+          await page.clock.runFor((at === beat - 1 ? 2600 : 600) + (die ? 2400 : 0));
+        }
+        const box = await page.locator(".replay").boundingBox();
+        const name = `${sp.name}-s${beat}-${view}.png`;
+        const golden = join(GOLDENS, name);
+        const shot = update ? golden : join(DIFFS, name);
+        await page.screenshot({
+          path: shot,
+          clip: { x: Math.round(box.x), y: Math.round(box.y), width: Math.round(box.width), height: Math.round(box.height) },
+        });
+        if (update) {
+          console.log(`blessed ${name}`);
+        } else if (!existsSync(golden)) {
+          console.log(`MISSING golden ${name} — run with --update`);
+          failures++;
+        } else {
+          const { frac, why } = compare(golden, shot);
+          if (why || frac > FAIL_FRAC) {
+            console.log(`FAIL ${name}: ${why ?? `${(frac * 100).toFixed(2)}% of pixels drifted`} (actual kept at ${shot})`);
+            failures++;
+          } else {
+            console.log(`OK   ${name}`);
+          }
+        }
+      }
+      await ctx.close();
+    }
+  }
+  await browser.close();
+} finally {
+  server.stop();
+}
+if (!update) console.log(`--- ${failures ? `${failures} beat(s) drifted` : "every pinned beat matches its golden"}`);
+process.exit(failures ? 1 : 0);

deploy/verify-scenes.sh

@@ -0,0 +1,8 @@
+#!/bin/bash
+# Render-regression check: build the web client, then screenshot every
+# screenplay's pinned beats under a frozen clock and diff them against
+# deploy/scene-goldens/. Run from the repo root. Pass --update to bless
+# new goldens after an INTENDED renderer change (and commit them).
+set -euo pipefail
+(cd packages/web && npx vite build --logLevel error)
+npx tsx deploy/verify-scenes.mjs "$@"

deploy/wizwar-rollup.cron

@@ -0,0 +1,3 @@
+# Nightly rollup of yesterday's traffic, table, and vitals (UTC). Installed by deploy.sh.
+# The time is also SCHEDULE in wizwar-rollup.sh, which tells Sentry to expect it; change both.
+10 0 * * * root /usr/local/bin/wizwar-rollup.sh

deploy/wizwar-rollup.sh

@@ -0,0 +1,147 @@
+#!/bin/bash
+# Nightly rollup: one JSON line per day in /var/lib/wizwar/rollup.jsonl —
+# yesterday's traffic (from Caddy's access log), the table's growth (from
+# the room ledgers, stats.json and feedback.jsonl), and the box's vitals.
+# Counts only: no addresses are kept. The pulse reads it for trends the
+# self-rotating access log cannot keep. Referrers are what browsers send
+# (Reddit and BGG send none); campaigns are the tags a link itself carries
+# — ?ref=<name> on a link Eric posts, a utm_source, or Facebook's fbclid —
+# one count per address per day.
+#   Cron: see SCHEDULE below and /etc/cron.d/wizwar-rollup (deploy.sh installs both).
+#   Sentry Crons check-in: /root/.wizwar-sentry-cron-rollup holds the URL
+#   (absent = no check-ins).
+set -u
+OUT="/var/lib/wizwar/rollup.jsonl"
+LOG="/var/log/wizwar/rollup.log"
+DAY="${1:-$(date -u -d 'yesterday' +%Y-%m-%d)}"
+# The crontab line, as /etc/cron.d/wizwar-rollup spells it: the Sentry
+# monitor is told the same shape, so a missed night is noticed.
+SCHEDULE="10 0 * * *"
+CRON_URL=$(cat /root/.wizwar-sentry-cron-rollup 2>/dev/null || true)
+# The check-in carries the schedule: Sentry only keeps a monitor it has
+# been told the shape of, and a bare ping to an unknown slug is accepted
+# and dropped without a word.
+checkin() {
+  [ -n "$CRON_URL" ] && curl -sf -o /dev/null -X POST -H "Content-Type: application/json" \
+    -d "{\"status\":\"$1\",\"monitor_config\":{\"schedule\":{\"type\":\"crontab\",\"value\":\"$SCHEDULE\"},\"checkin_margin\":30,\"max_runtime\":10,\"timezone\":\"UTC\"}}" \
+    "$CRON_URL" || true
+}
+
+checkin in_progress
+if python3 - "$DAY" "$OUT" <<'PY' >> "$LOG" 2>&1
+import json, sys, os, glob, gzip, datetime, collections, subprocess, re
+day, out = sys.argv[1], sys.argv[2]
+d0 = datetime.datetime.fromisoformat(day).replace(tzinfo=datetime.timezone.utc)
+t0, t1 = d0.timestamp(), (d0 + datetime.timedelta(days=1)).timestamp()
+BOT = ("bot", "crawl", "spider", "facebookexternalhit", "slack", "discord", "twitter", "preview", "curl", "python", "go-http", "wget", "headless")
+
+# --- traffic: every access log file touched since the day began. Address
+# and request counts split people from bots; the path mix and referrers
+# count people only. ---
+req = 0; human = 0; bot = 0; hips = set(); bips = set()
+paths = collections.Counter(); status = collections.Counter(); refs = collections.Counter(); ws = 0
+# Where a visit came from, when the link itself says so: ?ref=<name> on a
+# link Eric posted, a Facebook click's fbclid, or a utm_source.
+campaigns = collections.Counter(); seen_campaign = set()
+for f in sorted(glob.glob("/var/lib/caddy/access*.log*")):
+    if os.path.getmtime(f) < t0: continue
+    opener = gzip.open if f.endswith(".gz") else open
+    with opener(f, "rt", errors="ignore") as fh:
+        for line in fh:
+            try: r = json.loads(line)
+            except ValueError: continue
+            ts = r.get("ts", 0)
+            if not (t0 <= ts < t1): continue
+            q = r.get("request", {}); h = q.get("headers", {})
+            ua = " ".join(h.get("User-Agent", [""])).lower()
+            ip = q.get("client_ip") or q.get("remote_ip") or "?"
+            isbot = any(k in ua for k in BOT)
+            req += 1
+            if isbot: bot += 1; bips.add(ip)
+            else: human += 1; hips.add(ip)
+            full = q.get("uri", ""); uri = full.split("?")[0]
+            if uri == "/ws": ws += 1
+            if not isbot and "?" in full and ip not in seen_campaign:
+                qs = dict(kv.split("=", 1) if "=" in kv else (kv, "") for kv in full.split("?", 1)[1].split("&"))
+                tag = qs.get("ref") or qs.get("utm_source") or ("facebook" if "fbclid" in qs else None)
+                if tag and re.fullmatch(r"[a-z0-9_-]{1,24}", tag):
+                    campaigns[tag] += 1; seen_campaign.add(ip)
+            key = ("/clips" if uri.startswith("/clips") else "/watch" if uri.startswith("/watch")
+                   else "(assets)" if uri.startswith("/assets") or re.search(r"\.(png|jpg|svg|ico|css|js|webmanifest|mp4)$", uri)
+                   else uri if uri in ("/", "/ws", "/robots.txt") else "(other)")
+            if not isbot: paths[key] += 1
+            status[str(r.get("status", 0))[0] + "xx"] += 1
+            ref = " ".join(h.get("Referer", [""]))
+            m = re.match(r"https?://([^/]+)", ref)
+            host = m.group(1) if m else ""
+            ours = host.endswith("kestrelsnest.social") or "104.236.96.198" in host
+            # Scanners forge referrers on paths like /.env, and the app answers
+            # unknown paths with the page itself, so the status cannot tell a
+            # probe from a reader. Only the pages count.
+            if host and not ours and not isbot and key in ("/", "/clips", "/watch"): refs[host] += 1
+
+# --- the table ---
+new_rooms = 0; seats = collections.Counter()
+for f in glob.glob("/var/lib/wizwar/rooms/*.jsonl"):
+    try:
+        with open(f) as fh:
+            meta = json.loads(fh.readline())
+            ca = meta.get("createdAt")
+            if not ca: continue
+            ct = datetime.datetime.fromisoformat(ca.replace("Z", "+00:00")).timestamp()
+            if not (t0 <= ct < t1): continue
+            new_rooms += 1
+            # The host takes the first seat by creating; only others join.
+            if meta.get("hostId"): seats[meta["hostId"]] += 1
+            for line in fh:
+                try: r = json.loads(line)
+                except ValueError: continue
+                if r.get("kind") == "join" and not r.get("bot"): seats[r["name"]] += 1
+    except OSError: continue
+stats = {}
+try: stats = json.load(open("/var/lib/wizwar/stats.json"))
+except Exception: pass
+reports = 0; replies = 0
+try:
+    for line in open("/var/lib/wizwar/feedback.jsonl"):
+        try: r = json.loads(line)
+        except ValueError: continue
+        at = datetime.datetime.fromisoformat(r["at"].replace("Z", "+00:00")).timestamp()
+        if t0 <= at < t1: reports += ("happened" in r); replies += ("reportId" in r)
+except OSError: pass
+
+# --- vitals (now, at rollup time) ---
+def sh(cmd):
+    try: return subprocess.run(cmd, shell=True, capture_output=True, text=True, timeout=20).stdout.strip()
+    except Exception: return "?"
+mem = sh("systemctl show wizwar -p MemoryCurrent --value"); peak = sh("systemctl show wizwar -p MemoryPeak --value")
+disk = sh("df --output=pcent / | tail -1").strip().rstrip("%")
+load = sh("cut -d' ' -f1 /proc/loadavg")
+journal = sh("journalctl -u wizwar --since '%s' --until '%s' --no-pager 2>/dev/null" % (day, (d0 + datetime.timedelta(days=1)).date()))
+errs = str(len(re.findall(r"(?i)unhandled protocol error", journal)))
+starts = str(journal.count("Started wizwar"))
+ledger = sum(os.path.getsize(f) for f in glob.glob("/var/lib/wizwar/rooms/*.jsonl"))
+row = {
+    "day": day, "requests": req, "human": human, "bot": bot,
+    "humanAddresses": len(hips), "botAddresses": len(bips), "socketConnects": ws,
+    "paths": dict(paths.most_common()), "status": dict(status), "referrers": dict(refs.most_common(10)),
+    "campaigns": dict(campaigns.most_common(10)),
+    "newRooms": new_rooms, "humanSeats": sum(seats.values()), "humanNames": sorted(seats),
+    "gamesFinishedTotal": stats.get("gamesFinished"), "gamesCreatedTotal": stats.get("gamesCreated"),
+    "reports": reports, "replies": replies,
+    "vitals": {"memMB": round(int(mem) / 1048576) if mem.isdigit() else None,
+               "memPeakMB": round(int(peak) / 1048576) if peak.isdigit() else None,
+               "diskPct": int(disk) if disk.isdigit() else None, "load1": float(load) if load else None,
+               "protocolErrors": int(errs) if errs.isdigit() else None, "serviceStarts": int(starts) if starts.isdigit() else None,
+               "ledgerMB": round(ledger / 1048576, 1)},
+}
+# One line per day: a rerun for the same day replaces its line.
+rows = []
+if os.path.exists(out):
+    rows = [l for l in open(out).read().splitlines() if l.strip() and json.loads(l).get("day") != day]
+rows.append(json.dumps(row, separators=(",", ":")))
+tmp = out + ".tmp"
+open(tmp, "w").write("\n".join(rows) + "\n"); os.replace(tmp, out)
+print("%s rollup %s: %d requests, %d human addresses, %d new rooms, %d human seats" % (datetime.datetime.now(datetime.timezone.utc).isoformat(), day, req, len(hips), new_rooms, sum(seats.values())))
+PY
+then checkin ok; else checkin error; fi

deploy/wizwar-visitors.sh

@@ -0,0 +1,92 @@
+#!/bin/bash
+# The visitors digest: who is here right now and who came today — the
+# rooms opened, how far each got, what humans said, what they filed —
+# with today's traffic so far. Read by the wizwar-visitors skill.
+#   wizwar-visitors.sh [YYYY-MM-DD]   (default: today, UTC)
+set -u
+DAY="${1:-$(date -u +%F)}"
+/usr/local/bin/wizwar-rollup.sh "$DAY" >/dev/null 2>&1
+python3 - "$DAY" <<'PY'
+import json, sys, glob, datetime, subprocess
+day = sys.argv[1]
+now = datetime.datetime.now(datetime.timezone.utc)
+print("as of %s UTC, day %s" % (now.strftime("%H:%M"), day))
+
+def sh(cmd):
+    try: return subprocess.run(cmd, shell=True, capture_output=True, text=True, timeout=20).stdout.strip()
+    except Exception: return "?"
+print("live sockets: %s | rooms touched in the last hour: %s" % (
+    sh("ss -tn state established '( sport = :8787 )' | tail -n +2 | wc -l"),
+    sh("find /var/lib/wizwar/rooms -name '*.jsonl' -mmin -60 | wc -l")))
+
+# --- traffic so far, from the rollup ---
+try:
+    rows = [json.loads(l) for l in open("/var/lib/wizwar/rollup.jsonl")]
+    r = [x for x in rows if x["day"] == day][-1]
+    p = r["paths"]
+    print("traffic: %d addresses, %d requests from people (%d bot); front %d, gallery %d, replays %d; campaigns %s; referrers %s" % (
+        r["humanAddresses"], r["human"], r["bot"], p.get("/", 0), p.get("/clips", 0), p.get("/watch", 0),
+        json.dumps(r["campaigns"]), json.dumps(r["referrers"])))
+except Exception as e:
+    print("traffic: (no rollup row: %s)" % e)
+
+# --- every room, for first sightings; today's rooms in detail ---
+first_seen = {}
+rooms = []
+for f in glob.glob("/var/lib/wizwar/rooms/*.jsonl"):
+    try:
+        lines = open(f).read().splitlines()
+        meta = json.loads(lines[0])
+    except Exception: continue
+    ca = meta.get("createdAt", "")
+    if not ca: continue
+    humans = [meta["hostId"]]; bots = []; started = False; cmds = 0; chat = []; last = ca; steps = []
+    for l in lines[1:]:
+        try: x = json.loads(l)
+        except Exception: continue
+        k = x.get("kind")
+        if k == "join":
+            (bots if x.get("bot") else humans).append(x["name"])
+        elif k == "start": started = True
+        elif k == "command":
+            cmds += 1; last = x.get("at", last)
+            steps.append((x.get("playerId"), x["command"].get("type"), x.get("at", "")))
+        elif k == "chat":
+            last = x.get("at", last)
+            if x["player"] in humans: chat.append((x.get("at", "")[11:16], x["player"], x["text"]))
+    for h in humans:
+        if h not in first_seen or ca < first_seen[h]: first_seen[h] = ca
+    rooms.append(dict(id=meta["id"], created=ca, humans=humans, bots=bots, started=started, cmds=cmds, last=last, chat=chat, steps=steps))
+
+today = sorted([r for r in rooms if r["created"].startswith(day)], key=lambda r: r["created"])
+names = sorted({h for r in today for h in r["humans"]})
+new = [n for n in names if first_seen[n].startswith(day)]
+print("players today: %s | NEW today: %s" % (", ".join(names) or "none", ", ".join(new) or "none"))
+print("rooms today: %d" % len(today))
+for r in today:
+    span = ""
+    if r["cmds"]:
+        t0 = datetime.datetime.fromisoformat(r["created"].replace("Z", "+00:00")); t1 = datetime.datetime.fromisoformat(r["last"].replace("Z", "+00:00"))
+        span = "%d min" % round((t1 - t0).total_seconds() / 60)
+    human_cmds = [s for s in r["steps"] if s[0] in r["humans"]]
+    last_human = ("last human move: %s %s at %s" % (human_cmds[-1][0], human_cmds[-1][1], human_cmds[-1][2][11:16])) if human_cmds else "no human move"
+    state = "lobby only" if not r["started"] else ("started, no moves" if not r["cmds"] else "in play")
+    print("  %s %s  %s%s  %s  %d moves (%d human)  %s  %s" % (
+        r["created"][11:16], r["id"], "+".join(r["humans"]), (" vs %d bot%s" % (len(r["bots"]), "" if len(r["bots"]) == 1 else "s")) if r["bots"] else "",
+        state, r["cmds"], len(human_cmds), span, last_human))
+    for at, who, text in r["chat"]: print("      %s %s: %s" % (at, who, text))
+
+# --- the desk ---
+reports = 0; unanswered = 0; answered = set()
+try:
+    rows = [json.loads(l) for l in open("/var/lib/wizwar/feedback.jsonl") if l.strip()]
+    answered = {x["reportId"] for x in rows if "reportId" in x}
+    for x in rows:
+        if "happened" not in x: continue
+        if (x.get("id") or x["at"]) not in answered: unanswered += 1
+        if x["at"].startswith(day):
+            reports += 1
+            print("  REPORT %s %s (%s): %s / expected: %s" % (x["at"][11:16], x["player"], x["roomId"], x["happened"], x["expected"]))
+except OSError: pass
+print("feedback: %d filed today, %d unanswered overall" % (reports, unanswered))
+PY

package-lock.json

@@ -10,6 +10,9 @@
       "workspaces": [
         "packages/*"
       ],
+      "devDependencies": {
+        "playwright-core": "^1.62.1"
+      },
       "engines": {
         "node": ">=20"
       }
@@ -1796,6 +1799,19 @@
       "dev": true,
       "license": "ISC"
     },
+    "node_modules/playwright-core": {
+      "version": "1.62.1",
+      "resolved": "https://registry.npmjs.org/playwright-core/-/playwright-core-1.62.1.tgz",
+      "integrity": "sha512-wPYSwEBJY9GHraISXqyqtx0na0LpO3XEX7jNDhntbex7tzUS7kLnZsOlFruFJB4Hi/rhDMjXGqHewDZ68nYZVw==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "bin": {
+        "playwright-core": "cli.js"
+      },
+      "engines": {
+        "node": ">=20"
+      }
+    },
     "node_modules/postcss": {
       "version": "8.5.26",
       "resolved": "https://registry.npmjs.org/postcss/-/postcss-8.5.26.tgz",

package.json

@@ -14,5 +14,8 @@
   },
   "engines": {
     "node": ">=20"
+  },
+  "devDependencies": {
+    "playwright-core": "^1.62.1"
   }
 }

packages/engine/src/automaton.ts

@@ -7,7 +7,7 @@
 // BERSERKER for blood, the WORRIER for the shadows between the two.
 
 import { cardDef, type CardInstance } from "./cards";
-import { cellKey, edgeKey, neighbor, opposite, stepTarget, SIDES, type Cell, type Side } from "./board";
+import { cellKey, edgeKey, neighbor, opposite, stepTarget, SIDES, type Cell, type Side, pitRimExits } from "./board";
 import { bentSightFor, sightedCellsFor, type GameView } from "./view";
 import { wallIgnoringDistance } from "./game";
 import type { AmbushTrigger, Command, PlayerId } from "./game";
@@ -155,6 +155,13 @@ interface PathResult {
   distance: number;
   /** A locked door stands on the first step of this path. */
   doorAhead?: { cell: Cell; side: Side };
+  /** The first step lands on a pit: the side of its rim the path leaves by. */
+  exit?: Side;
+}
+
+/** The move that takes a path's first step, naming the pit exit when there is one. */
+function stepAlong(path: PathResult): Command {
+  return { type: "move", direction: path.dir, ...(path.exit ? { exit: path.exit } : {}) };
 }
 
 /** One walkable step for the clockwork's pathfinding; null = impassable.
@@ -577,12 +584,21 @@ function wallBlastTarget(
   return { cell: best.cell, side: best.side };
 }
 
+/** The sides a walker may leave a pit by, having entered it heading
+ * `dir`: neighbouring squares first, a warp mouth on the rim only when
+ * no square offers — the one reading legal under every deckRev. */
+function pitExits(view: GameView, pit: Cell, dir: Side): Side[] {
+  const { floor, mouths } = pitRimExits(view.board, pit, dir, (c) => view.squareContents[cellKey(c)]?.kind === "stone");
+  return floor.length > 0 ? floor : mouths;
+}
+
 /**
  * BFS over walkable steps toward the nearest goal. Doors count as passable
  * when the clockwork can unlock them; the first such door is reported so the
  * key gets used before the boot.
  */
-function pathToward(
+
+export function pathToward(
   view: GameView,
   from: Cell,
   goals: Set<string>,
@@ -606,7 +622,17 @@ function pathToward(
         const { to, viaDoor } = step;
         const k = cellKey(to);
         if (seen.has(k)) continue;
-        if (view.squareContents[k]?.kind === "stone") continue;
+        const hazard = view.squareContents[k]?.kind;
+        if (hazard === "stone") continue;
+        // A pit is entered by leaping to the square beyond it in the same
+        // direction; with nothing to land on, the maze bounces the leaper
+        // back and charges the stride. Goal or waypoint, that is no road.
+        if (hazard === "pit" && pitExits(view, to, dir).length === 0) continue;
+        // Out of a pit only by one of its exits.
+        if (view.squareContents[cellKey(c)]?.kind === "pit") {
+          const entry = cameBy.get(cellKey(c))?.dir;
+          if (entry && !pitExits(view, c, entry).includes(dir)) continue;
+        }
         seen.add(k);
         cameBy.set(k, { prev: cellKey(c), dir, viaDoor });
         if (goals.has(k)) { found = k; break; }
@@ -615,7 +641,6 @@ function pathToward(
         // turn, and stings — a jail with foliage. Only a wizard with no
         // road at all (throughJails) dives in. "Few will dive into one
         // unless they are desperate."
-        const hazard = view.squareContents[k]?.kind;
         if (hazard === "thornbush" && !opts.throughJails) continue;
         if (!opts.throughHazards &&
             (hazard === "pit" || hazard === "ooze" ||
@@ -629,20 +654,32 @@ function pathToward(
   }
   if (!found) return null;
   let cursor = found;
+  let second: Side | undefined;
   for (;;) {
     const hop = cameBy.get(cursor)!;
     if (hop.prev === cellKey(from)) {
+      const firstIsPit = view.squareContents[cursor]?.kind === "pit";
       return {
         dir: hop.dir,
         distance: depth,
         ...(hop.viaDoor ? { doorAhead: { cell: from, side: hop.dir } } : {}),
+        ...(firstIsPit && second ? { exit: second } : {}),
       };
     }
+    second = hop.dir;
     cursor = hop.prev;
   }
 }
 
 /** The treasure squares worth marching for. */
+/** A SAFE that stands between this wizard and the floor: not their own
+ * box, and not opened this turn. */
+function lockedSafeAt(view: GameView, key: string): boolean {
+  return view.squareContents[key]?.kind === "safe" &&
+    view.squareContents[key]!.createdBy !== view.you &&
+    !view.openSafes.includes(key);
+}
+
 function treasureGoals(view: GameView): Set<string> {
   const self = me(view);
   const goals = new Set<string>();
@@ -655,10 +692,7 @@ function treasureGoals(view: GameView): Set<string> {
     // A chest inside someone else's SAFE is no goal without a way in — a
     // lock card turns the combination, DISPEL CREATION removes the box.
     // Marching to an unopenable safe stalls the clockwork on it forever.
-    const boxKey = cellKey(t.position);
-    if (view.squareContents[boxKey]?.kind === "safe" &&
-        view.squareContents[boxKey]!.createdBy !== view.you &&
-        !view.openSafes.includes(boxKey) &&
+    if (lockedSafeAt(view, cellKey(t.position)) &&
         !inHand(view, "pick-lock") && !inHand(view, "master-key") &&
         !inHand(view, "dispel-creation")) {
       continue;
@@ -720,7 +754,8 @@ function overLimit(view: GameView): number {
  * clogged hand never refreshes; only cards the brain has no play for are
  * shed (good counters and attacks are hoarded, as a human would). */
 function endTurnDrawing(view: GameView, tier: TierTraits, style?: AutomatonStyle): Command {
-  const deficit = tier.draw - (handLimitOf(view) - view.yourHand.length);
+  const draw = drawUnderSlowDeath(view, tier.draw);
+  const deficit = draw - (handLimitOf(view) - view.yourHand.length);
   if (tier.sheds && deficit > 0) {
     const shed = [...view.yourHand]
       .filter((c) => discardValue(c, view, style) <= 3)
@@ -729,7 +764,16 @@ function endTurnDrawing(view: GameView, tier: TierTraits, style?: AutomatonStyle
       .map((c) => c.instanceId);
     if (shed.length > 0) return { type: "discard", instanceIds: shed };
   }
-  return { type: "endTurn", draw: tier.draw };
+  return { type: "endTurn", draw };
+}
+
+/** SLOW DEATH bleeds a point per card drawn: the clockwork draws only what
+ * it can afford, keeping four life in hand, and nothing at all when it
+ * cannot — a bare hand beats a bare grave. */
+export function drawUnderSlowDeath(view: GameView, draw: number): number {
+  const slow = view.sustained.some((e) => e.cardId === "slow-death" && e.targetId === view.you && !e.data?.reversed);
+  if (!slow) return draw;
+  return Math.max(0, Math.min(draw, me(view).life - 4));
 }
 
 function worstCards(view: GameView, n: number, style?: AutomatonStyle): string[] {
@@ -1294,6 +1338,13 @@ export function automatonCommand(
     // A Ward is free damage on a thief of OUR gold: always spring it.
     return view.wardPending.ownerId === you ? { type: "wardChoice", play: true } : null;
   }
+  if (view.pushPending) {
+    if (view.pushPending.pusheeId !== you) return null;
+    // Shoved to a fork: step out of the giant's line so he cannot keep
+    // pushing; failing that, the first way open.
+    const { direction, exits } = view.pushPending;
+    return { type: "pushChoice", direction: exits.find((d) => d !== direction) ?? exits[0]! };
+  }
   if (view.pendingDiscard === you) {
     return { type: "discard", instanceIds: worstCards(view, Math.max(1, overLimit(view)), style) };
   }
@@ -1332,8 +1383,7 @@ export function automatonCommand(
       if (prize) {
         // A SAFE over the prize: turn the combination (or dispel the box)
         // before reaching for the gold — the grab itself would be refused.
-        const boxed = view.squareContents[here]?.kind === "safe" &&
-          view.squareContents[here]!.createdBy !== you && !view.openSafes.includes(here);
+        const boxed = lockedSafeAt(view, here);
         if (!boxed) return { type: "pickUpTreasure", treasureId: prize.id };
         const key = inHand(view, "pick-lock") ?? inHand(view, "master-key");
         if (key) return { type: "cast", instanceId: key.instanceId, target: { kind: "cell", cell: self.position } };
@@ -1518,8 +1568,13 @@ export function automatonCommand(
           }
         }
       }
-      // No shot at a wizard: raise a creature to do the walking.
-      const summon = view.yourHand.find((c) => SUMMONS.has(c.cardId));
+      // No shot at a wizard: raise a creature to do the walking. A SHADOW
+      // drinks a life a turn from its master — no pet for a wizard already
+      // bleeding, or with little blood to spare.
+      const bleeding = view.sustained.some((e) =>
+        (e.cardId === "slow-death" || e.cardId === "walking-dead") && e.targetId === you && !e.data?.reversed);
+      const summon = view.yourHand.find((c) => SUMMONS.has(c.cardId) &&
+        !(c.cardId === "shadow" && (bleeding || self.life <= 6)));
       if (summon && livingEnemies(view).length > 0) {
         const near = style === "worrier" ? self.position : livingEnemies(view)[0]!.position;
         const spot = summonSpot(view, near);
@@ -1696,7 +1751,7 @@ export function automatonCommand(
           return { type: "move", direction: dir };
         }
         const approach = pathToward(view, self.position, new Set([cellKey(crossing.near)]), { canUnlock });
-        if (approach) return { type: "move", direction: approach.dir };
+        if (approach) return stepAlong(approach);
       }
     }
     // Or bank one now, when a crossing beats the walk by enough to spend a card.
@@ -1807,7 +1862,7 @@ export function automatonCommand(
             if (run) return { type: "cast", instanceId: run.instanceId, params: { points } };
           }
         }
-        return { type: "move", direction: path.dir };
+        return stepAlong(path);
       }
     }
   }
@@ -1819,6 +1874,7 @@ export function automatonCommand(
 export function automatonFallback(view: GameView, tierName: AutomatonTier = "archmage"): Command {
   const you = view.you;
   if (view.wardPending?.ownerId === you) return { type: "wardChoice", play: false };
+  if (view.pushPending?.pusheeId === you) return { type: "pushChoice", direction: view.pushPending.exits[0]! };
   if (view.slowDeathPending?.playerId === you) return { type: "slowDeathChoice" };
   if (view.pendingDiscard === you) {
     return { type: "discard", instanceIds: worstCards(view, Math.max(1, overLimit(view))) };

packages/engine/src/board.ts

@@ -253,6 +253,24 @@ export function stepTarget(
   return { kind: "blocked", by: "wall" };
 }
 
+/** The sides a walker may leave a pit by, having entered it heading
+ * `entry`: the neighbouring squares that offer footing, and the warp
+ * mouths on the rim, the way back excluded. `filled` names the squares
+ * nothing can land on. */
+export function pitRimExits(
+  board: AssembledBoard, pit: Cell, entry: Side, filled: (c: Cell) => boolean,
+): { floor: Side[]; mouths: Side[] } {
+  const floor: Side[] = [];
+  const mouths: Side[] = [];
+  for (const d of SIDES) {
+    if (d === opposite(entry)) continue;
+    const t = stepTarget(board, pit, d);
+    if (t.kind === "blocked" || filled(t.to)) continue;
+    (t.kind === "step" ? floor : mouths).push(d);
+  }
+  return { floor, mouths };
+}
+
 /**
  * Line of sight from the center of `from` to the center of `to`, blocked by
  * wall/door/firewall edges the segment crosses and by any `blockedCells`

packages/engine/src/view.ts

@@ -2,13 +2,16 @@
 // The server sends this after every state change; clients never see the
 // deck order or other players' hands.
 
-import { SIDES, edgeKey, sightBetween, bentSightThroughGap, traceSight, type AssembledBoard, type Cell, type SightTrace } from "./board";
+import { neighbor, SIDES, edgeKey, sightBetween, bentSightThroughGap, traceSight, type AssembledBoard, type Cell, type SightTrace } from "./board";
 import { cardDef, type CardInstance } from "./cards";
 import {
   boardView,
+  edgeReentry,
   LOS_BLOCKING_CONTENT,
   type AmbushState,
   type CastStack,
+  type GameEvent,
+  type PushPending,
   type CreatureState,
   type GameState,
   type PlayerId,
@@ -16,6 +19,7 @@ import {
   type SustainedEffect,
   type TreasureState,
   type TurnState,
+  dreadDistance,
 } from "./game";
 
 export interface PlayerPublicView {
@@ -30,6 +34,8 @@ export interface PlayerPublicView {
   extraTurns: number;
   /** Banked PASS THROUGH WALL crossings — cast openly, so public knowledge. */
   passWallCharges: number;
+  /** Down a pit, until a roll climbs them out — everyone saw the fall. */
+  inPit: boolean;
   displayed: CardInstance[];
   /** Which of the six physical wizard colors this player plays. */
   colorIndex: number;
@@ -57,6 +63,8 @@ export interface GameView {
   /** Duration spells in play (public knowledge). */
   sustained: SustainedEffect[];
   squareContents: Record<string, SquareContent>;
+  /** Spells lodged in slime, oldest first (public: each cast was seen). */
+  slimeTraps: Record<string, { cardId: string; casterId: PlayerId }[]>;
   /** Cells whose contents are glued down (public: the cast was seen). */
   gluedCells: Record<string, true>;
   /** Safes standing open (their combination entered this turn). */
@@ -88,6 +96,7 @@ export interface GameView {
   chaosPending: { casterId: PlayerId; queue: PlayerId[] } | null;
   /** A grab hangs while the treasure's owner decides their Ward. */
   wardPending: { ownerId: PlayerId; takerId: PlayerId } | null;
+  pushPending: PushPending | null;
   slowDeathPending: { playerId: PlayerId; points: number } | null;
   /** YOUR armed ambushes. Other players' ambushes are invisible. */
   yourAmbushes: AmbushState[];
@@ -131,6 +140,7 @@ export function viewFor(state: GameState, playerId: PlayerId): GameView {
       position: p.position,
       home: p.home,
       life: p.life,
+      inPit: p.inPit,
       alive: p.alive,
       handCount: p.hand.length,
       carriedTreasureId: p.carriedTreasureId,
@@ -151,6 +161,9 @@ export function viewFor(state: GameState, playerId: PlayerId): GameView {
     pendingDiscard: state.pendingDiscard,
     sustained: state.sustained.map((s) => ({ ...s })),
     squareContents: { ...state.squareContents },
+    slimeTraps: Object.fromEntries(
+      Object.entries(state.slimeTraps).map(([k, traps]) => [k, traps.map((t) => ({ cardId: t.card.cardId, casterId: t.casterId }))]),
+    ),
     gluedCells: { ...state.gluedCells },
     openSafes: [...state.openSafes],
     groundObjects: Object.fromEntries(
@@ -172,6 +185,7 @@ export function viewFor(state: GameState, playerId: PlayerId): GameView {
       ? { casterId: state.chaosPending.casterId, queue: [...state.chaosPending.queue] }
       : null,
     wardPending: state.wardPending ? { ...state.wardPending } : null,
+    pushPending: state.pushPending ? { ...state.pushPending, exits: [...state.pushPending.exits] } : null,
     slowDeathPending: state.slowDeathPending ? { ...state.slowDeathPending } : null,
     yourAmbushes: state.ambushes
       .filter((a) => a.ownerId === playerId)
@@ -187,20 +201,45 @@ export function viewFor(state: GameState, playerId: PlayerId): GameView {
   };
 }
 
+/** Every square inside a living FEAR-bearer's aura — dreadDistance walks
+ * through warps, the engine's own yardstick, so the painted aura and the
+ * movement refusal can never disagree. */
+export function fearCells(view: GameView): Set<string> {
+  const out = new Set<string>();
+  for (const fp of view.players) {
+    if (!fp.alive) continue;
+    if (!view.sustained.some((e) => e.cardId === "fear" && e.targetId === fp.id)) continue;
+    for (const k of Object.keys(view.board.cells)) {
+      const [x, y] = k.split(",").map(Number) as [number, number];
+      if (dreadDistance(view.board, fp.position, { x, y }) <= 3) out.add(k);
+    }
+  }
+  return out;
+}
+
 /**
  * Every cell the viewing player can see from where they stand, by the same
  * line-of-sight rules the engine enforces — computed from the VIEW, so it
  * reflects what this player knows (illusion walls they believe in block it).
  * The basis for the client's "dim the ineligible squares" targeting aid.
  */
-export function sightedCellsFor(view: GameView): Set<string> {
+export function sightedCellsFor(view: GameView, from?: Cell): Set<string> {
   const out = new Set<string>();
   const me = view.players.find((p) => p.id === view.you);
   if (!me) return out;
+  // Sight is taken from the viewer's square unless a cast leaves from
+  // elsewhere — an ALTER EGO's — in which case it is the double's.
+  const eye = from ?? me.position;
   const { board, blockers } = sightBasis(view);
+  // In a dust cloud a wizard sees only their own square (rev 19).
+  if (inDust(view, eye)) {
+    out.add(`${eye.x},${eye.y}`);
+    return out;
+  }
   for (const key of Object.keys(board.cells)) {
     const [x, y] = key.split(",").map(Number) as [number, number];
-    if (sightBetween(board, me.position, { x, y }, blockers)) out.add(key);
+    if (dustAtEnd(view, eye, { x, y })) continue;
+    if (sightBetween(board, eye, { x, y }, blockers)) out.add(key);
   }
   // VISIONSTONE lets its bearer see through exactly one wall or door —
   // any one — so a square is also sighted if removing a single edge
@@ -215,7 +254,7 @@ export function sightedCellsFor(view: GameView): Set<string> {
       const opened = { ...board, edges };
       for (let i = unseen.length - 1; i >= 0; i--) {
         const [x, y] = unseen[i]!.split(",").map(Number) as [number, number];
-        if (sightBetween(opened, me.position, { x, y }, blockers)) {
+        if (sightBetween(opened, eye, { x, y }, blockers)) {
           out.add(unseen[i]!);
           unseen.splice(i, 1);
         }
@@ -230,8 +269,8 @@ export function sightedCellsFor(view: GameView): Set<string> {
  * plus every square visible from one of those — the caster looks to a middle
  * cell and the spell turns there, mirroring the engine's bentLos.
  */
-export function bentSightedCellsFor(view: GameView): Set<string> {
-  const out = sightedCellsFor(view);
+export function bentSightedCellsFor(view: GameView, from?: Cell): Set<string> {
+  const out = sightedCellsFor(view, from);
   const me = view.players.find((p) => p.id === view.you);
   if (!me) return out;
   const mids = [...out].map((k) => {
@@ -291,17 +330,30 @@ function sightBasis(view: GameView): { board: GameView["board"]; blockers: Recor
  * (believed illusion walls block; held doors admit). Null when no sight
  * exists — the renderer's material for drawing the line an attack traveled.
  */
-export function traceSightFor(view: GameView, from: Cell, to: Cell): SightTrace | null {
+export function traceSightFor(view: GameView, from: Cell, to: Cell, ignoreDust = false): SightTrace | null {
+  if (!ignoreDust && dustAtEnd(view, from, to)) return null;
   const { board, blockers } = sightBasis(view);
   return traceSight(board, from, to, blockers);
 }
 
+/** Rev 19: DUST CLOUD blinds its occupant. Older games see through it. */
+function inDust(view: GameView, cell: Cell): boolean {
+  return view.deckRev >= 19 && view.squareContents[`${cell.x},${cell.y}`]?.kind === "dust";
+}
+
+/** Dust at either end kills a sight line; a square sees itself still. */
+function dustAtEnd(view: GameView, from: Cell, to: Cell): boolean {
+  if (from.x === to.x && from.y === to.y) return false;
+  return inDust(view, from) || inDust(view, to);
+}
+
 /**
  * AROUND THE CORNER's bent sight, from this viewer's knowledge: the caster
  * sees a middle square which sees the target — mirroring the engine's
  * bentLos so a client can predict whether the modifier will land.
  */
 export function bentSightFor(view: GameView, from: Cell, to: Cell): boolean {
+  if (dustAtEnd(view, from, to)) return false;
   const { board, blockers } = sightBasis(view);
   if (sightBetween(board, from, to, blockers)) return true;
   for (const key of Object.keys(board.cells)) {
@@ -322,54 +374,96 @@ export function bentSightFor(view: GameView, from: Cell, to: Cell): boolean {
  * defender sharing a square, or no sight under this viewer's knowledge
  * (a believed illusion wall can honestly hide the line).
  */
-export function stackSightTrace(
-  view: GameView,
-): {
+/** A sight line as the board draws it: the legs, the corner bend, and the
+ * one wall a VISIONSTONE dissolved. */
+export interface SightLine {
   from: Cell;
   to: Cell;
   trace: SightTrace;
   bend?: { mid: Cell; trace: SightTrace };
   /** VISIONSTONE: the one wall or door the bearer's sight dissolved (edge key). */
   pierced?: string;
-} | null {
+}
+
+/** The sight line from one square to another under the sight law the
+ * engine applies to a cast: a plain line (warps included), else the
+ * VISIONSTONE's look through one wall, else AROUND THE CORNER's two legs.
+ * `afterTheFact` traces a cast already resolved, whose own dust cloud
+ * would otherwise blind the line to it. */
+export function sightTraceBetween(
+  view: GameView,
+  from: Cell,
+  to: Cell,
+  opts: { visionstone?: boolean; bentCorner?: boolean; afterTheFact?: boolean } = {},
+): SightLine | null {
+  if (from.x === to.x && from.y === to.y) return null;
+  const trace = traceSightFor(view, from, to, opts.afterTheFact);
+  if (trace) return { from, to, trace };
+  // VISIONSTONE: the bearer sees through exactly one wall or door. When no
+  // plain line exists, find the single edge whose removal opens one and draw
+  // the ray straight through it, marking the pierced wall for the table.
+  if (opts.visionstone) {
+    const { board, blockers } = sightBasis(view);
+    for (const [key, edge] of Object.entries(board.edges)) {
+      if (edge === "open") continue;
+      const edges = { ...board.edges };
+      delete edges[key];
+      const t = traceSight({ ...board, edges }, from, to, blockers);
+      if (t) return { from, to, trace: t, pierced: key };
+    }
+  }
+  // AROUND THE CORNER: no straight line exists — find a middle square both
+  // ends can see and draw the sight leg by leg, so the table can audit the
+  // needle instead of doubting it.
+  if (opts.bentCorner) {
+    for (const key of Object.keys(view.board.cells)) {
+      const [mx, my] = key.split(",").map(Number) as [number, number];
+      const mid = { x: mx, y: my };
+      if ((mid.x === from.x && mid.y === from.y) || (mid.x === to.x && mid.y === to.y)) continue;
+      const leg1 = traceSightFor(view, from, mid, opts.afterTheFact);
+      if (!leg1) continue;
+      const leg2 = traceSightFor(view, mid, to, opts.afterTheFact);
+      if (leg2) return { from, to, trace: leg1, bend: { mid, trace: leg2 } };
+    }
+  }
+  return null;
+}
+
+/** The sight line of the attack on the stack, for the board to draw. */
+export function stackSightTrace(view: GameView): SightLine | null {
   const stack = view.stack;
   if (!stack || stack.creatureId) return null;
   if (!stack.attackCard || cardDef(stack.attackCard.cardId).los !== true) return null;
   const a = view.players.find((p) => p.id === stack.attackerId);
   const d = view.players.find((p) => p.id === stack.defenderId);
   if (!a || !d) return null;
-  if (a.position.x === d.position.x && a.position.y === d.position.y) return null;
-  const trace = traceSightFor(view, a.position, d.position);
-  if (trace) return { from: a.position, to: d.position, trace };
-  // VISIONSTONE: the bearer sees through exactly one wall or door. When no
-  // plain line exists, find the single edge whose removal opens one and draw
-  // the ray straight through it, marking the pierced wall for the table.
-  if (a.displayed.some((c) => c.cardId === "visionstone")) {
-    const { board, blockers } = sightBasis(view);
-    for (const [key, edge] of Object.entries(board.edges)) {
-      if (edge === "open") continue;
-      const edges = { ...board.edges };
-      delete edges[key];
-      const t = traceSight({ ...board, edges }, a.position, d.position, blockers);
-      if (t) return { from: a.position, to: d.position, trace: t, pierced: key };
+  return sightTraceBetween(view, a.position, d.position, {
+    visionstone: a.displayed.some((c) => c.cardId === "visionstone"),
+    bentCorner: stack.bentCorner === true,
+  });
 }
-  }
-  // AROUND THE CORNER: no straight line exists — find a middle square both
-  // ends can see and draw the sight leg by leg, so the table can audit the
-  // needle instead of doubting it.
-  if (stack.bentCorner) {
-    for (const key of Object.keys(view.board.cells)) {
-      const [mx, my] = key.split(",").map(Number) as [number, number];
-      const mid = { x: mx, y: my };
-      if ((mid.x === a.position.x && mid.y === a.position.y) ||
-          (mid.x === d.position.x && mid.y === d.position.y)) continue;
-      const leg1 = traceSightFor(view, a.position, mid);
-      if (!leg1) continue;
-      const leg2 = traceSightFor(view, mid, d.position);
-      if (leg2) return { from: a.position, to: d.position, trace: leg1, bend: { mid, trace: leg2 } };
-    }
-  }
-  return null;
+
+/** The sight line a resolved cast was accepted on — a creation, a curse,
+ * anything aimed by line of sight that never waited on the stack — so the
+ * table can see how the aim was legal. `events` is the cast's own batch,
+ * which names an AROUND THE CORNER cast. */
+export function castSightTrace(
+  view: GameView,
+  cast: Extract<GameEvent, { type: "spellCast" }>,
+  events: readonly GameEvent[],
+  afterTheFact = false,
+): SightLine | null {
+  let def;
+  try { def = cardDef(cast.cardId); } catch { return null; }
+  if (def.los !== true) return null;
+  const to = cast.targetCell ?? view.players.find((p) => p.id === cast.target)?.position ?? null;
+  if (!to) return null;
+  const caster = view.players.find((p) => p.id === cast.caster);
+  return sightTraceBetween(view, cast.from, to, {
+    visionstone: caster?.displayed.some((c) => c.cardId === "visionstone") ?? false,
+    bentCorner: events.some((e) => e.type === "castAroundCorner" && e.caster === cast.caster),
+    afterTheFact,
+  });
 }
 
 const CREATION_CARD_IDS = new Set([
@@ -385,12 +479,12 @@ const SUMMON_CARD_IDS = new Set([
  * aid — mirroring the engine's own validation from the viewer's knowledge.
  * Null = this card's eligibility is not modeled; light everything.
  */
-export function eligibleCellsFor(view: GameView, cardId: string, bentCorner = false): Set<string> | null {
+export function eligibleCellsFor(view: GameView, cardId: string, bentCorner = false, from?: Cell): Set<string> | null {
   const me = view.players.find((p) => p.id === view.you);
   if (!me) return null;
   const cells = Object.keys(view.board.cells);
   const key = (x: number, y: number) => `${x},${y}`;
-  const sighted = bentCorner ? bentSightedCellsFor(view) : sightedCellsFor(view);
+  const sighted = bentCorner ? bentSightedCellsFor(view, from) : sightedCellsFor(view, from);
 
   if (CREATION_CARD_IDS.has(cardId)) {
     // emptySquareTarget: on the board, unoccupied by content, home, wizard,
@@ -423,7 +517,9 @@ export function eligibleCellsFor(view: GameView, cardId: string, bentCorner = fa
 
   if (cardId === "teleport") {
     // Up to four spaces, walls and objects ignored; not into solid stone.
-    // BFS over existing cells, matching the engine's wallIgnoringDistance.
+    // BFS over existing cells, matching the engine's wallIgnoringDistance —
+    // the maze wraps for teleporters as it does for walkers, a warp mouth
+    // being one step like any doorway.
     const out = new Set<string>();
     const dist = new Map<string, number>([[key(me.position.x, me.position.y), 0]]);
     const queue = [me.position];
@@ -431,10 +527,20 @@ export function eligibleCellsFor(view: GameView, cardId: string, bentCorner = fa
       const cur = queue.shift()!;
       const d = dist.get(key(cur.x, cur.y))!;
       if (d >= 4) continue;
-      for (const [dx, dy] of [[1, 0], [-1, 0], [0, 1], [0, -1]] as const) {
-        const n = { x: cur.x + dx, y: cur.y + dy };
+      for (const side of SIDES) {
+        let n = neighbor(cur, side);
+        if (!view.board.cells[key(n.x, n.y)]) {
+          const w = view.board.warps.find((w) => w.from.cell.x === cur.x && w.from.cell.y === cur.y && w.from.side === side);
+          if (w) n = w.to.cell;
+          else if (view.deckRev >= 22) {
+            // Rev 22: the outer edge is no more than a wall to a teleporter.
+            const back = edgeReentry(view.board, cur, side);
+            if (!back) continue;
+            n = back;
+          } else continue;
+        }
         const nk = key(n.x, n.y);
-        if (!view.board.cells[nk] || dist.has(nk)) continue;
+        if (dist.has(nk)) continue;
         dist.set(nk, d + 1);
         queue.push(n);
         if (view.squareContents[nk]?.kind !== "stone") out.add(nk);

packages/engine/test/automaton.test.ts

@@ -8,13 +8,14 @@ import {
 } from "../src/game";
 import { cellKey, edgeKey } from "../src/board";
 import { sightedCellsFor, viewFor } from "../src/view";
-import { automatonCommand, automatonFallback, type AutomatonStyle, type AutomatonTier } from "../src/automaton";
+import { automatonCommand, automatonFallback, drawUnderSlowDeath, pathToward, type AutomatonStyle, type AutomatonTier } from "../src/automaton";
 import { pushSustained } from "./helpers";
 
 /** Whose input does the maze want right now? */
 function actingSeat(state: GameState): PlayerId {
   return (
     state.wardPending?.ownerId ??
+    state.pushPending?.pusheeId ??
     state.slowDeathPending?.playerId ??
     state.stack?.waitingOn ??
     state.pendingDiscard ??
@@ -1034,15 +1035,26 @@ describe("interception, escape, and hazard sense", () => {
     state.squareContents[cellKey(chest.position!)] = { kind: "safe", damage: 0, createdBy: "foe" };
     bot.position = { ...chest.position! };
     bot.hand = [{ cardId: "number-3", instanceId: "N3" }];
-    for (let i = 0; i < 8; i++) {
-      const cmd = automatonCommand(viewFor(state, "bot"), "hunter", "archmage");
-      if (!cmd) break;
-      expect(cmd.type).not.toBe("pickUpTreasure");
-      const r = applyCommand(state, "bot", cmd);
+    // Drive whichever seat the maze wants (a punched foe answers its own
+    // counteraction window). The invariants: the bot never proposes the
+    // doomed grab, and its turn actually ends instead of idling forever.
+    let ended = false;
+    for (let i = 0; i < 24 && !ended; i++) {
+      const seat = actingSeat(state);
+      const view = viewFor(state, seat);
+      const chosen = automatonCommand(view, "hunter", "archmage");
+      let cmd = chosen ?? automatonFallback(view, "archmage");
+      if (seat === "bot") expect(cmd.type).not.toBe("pickUpTreasure");
+      let r = applyCommand(state, seat, cmd);
+      if (!r.ok && chosen) {
+        cmd = automatonFallback(view, "archmage");
+        r = applyCommand(state, seat, cmd);
+      }
       expect(r.ok).toBe(true);
       state = r.state;
-      if (cmd.type === "endTurn") break;
+      ended = seat === "bot" && cmd.type === "endTurn";
     }
+    expect(ended).toBe(true);
   });
 
   it("a pressed carrier of any temperament turns to mist", () => {
@@ -1099,3 +1111,83 @@ describe("interception, escape, and hazard sense", () => {
     expect(applyCommand(state, "bot", cmd!).ok).toBe(true);
   });
 });
+
+describe("the clockwork under a curse, and before a pit", () => {
+  /** A two-seat game advanced to the bot's own turn in round 2. */
+  function botsTurn() {
+    let { state } = createGame({ playerIds: ["human", "bot"], seed: 7, sets: ["basic", "expansion1"] });
+    for (let guard = 0; guard < 8; guard++) {
+      if (state.turn.round >= 2 && actingSeat(state) === "bot") break;
+      const r = applyCommand(state, actingSeat(state), { type: "endTurn", draw: 0 });
+      if (!r.ok) throw new Error(`setup: ${r.error}`);
+      state = r.state;
+    }
+    return state;
+  }
+
+  it("draws only what SLOW DEATH lets it afford", () => {
+    const state = botsTurn();
+    const bot = state.players.find((p) => p.id === "bot")!;
+    const plain = viewFor(state, "bot");
+    expect(drawUnderSlowDeath(plain, 2)).toBe(2);
+    pushSustained(state, { id: "sd", cardId: "slow-death", casterId: "human", targetId: "bot", remainingTurns: 1e9 });
+    bot.life = 7;
+    expect(drawUnderSlowDeath(viewFor(state, "bot"), 2)).toBe(2);
+    bot.life = 5;
+    expect(drawUnderSlowDeath(viewFor(state, "bot"), 2)).toBe(1);
+    bot.life = 4;
+    expect(drawUnderSlowDeath(viewFor(state, "bot"), 2)).toBe(0);
+  });
+
+  it("raises no SHADOW while bleeding, nor with little blood to spare", () => {
+    for (const rig of [
+      (s: GameState) => pushSustained(s, { id: "sd", cardId: "slow-death", casterId: "human", targetId: "bot", remainingTurns: 1e9 }),
+      (s: GameState) => { s.players.find((p) => p.id === "bot")!.life = 5; },
+    ]) {
+      let state = botsTurn();
+      rig(state);
+      const bot = state.players.find((p) => p.id === "bot")!;
+      bot.hand = [{ instanceId: "shadow#T", cardId: "shadow" }];
+      // Play the bot's whole turn: nothing it does may be the shadow.
+      for (let guard = 0; guard < 30 && actingSeat(state) === "bot"; guard++) {
+        const view = viewFor(state, "bot");
+        const cmd = automatonCommand(view, "berserker", "archmage") ?? automatonFallback(view, "archmage");
+        expect(cmd.type === "cast" && cmd.instanceId === "shadow#T").toBe(false);
+        const r = applyCommand(state, "bot", cmd);
+        if (!r.ok) break;
+        state = r.state;
+      }
+    }
+  });
+
+  it("never plans a stride into a pit it cannot leap beyond", () => {
+    const state = botsTurn();
+    const bot = state.players.find((p) => p.id === "bot")!;
+    const view0 = viewFor(state, "bot");
+    // Stand the bot at the head of a straight three-square run, dig a pit
+    // in the middle square, and wall the far one with stone: the route in
+    // from here is no route. With the stone gone, the leap is a road again.
+    const delta = { N: { x: 0, y: -1 }, E: { x: 1, y: 0 }, S: { x: 0, y: 1 }, W: { x: -1, y: 0 } } as const;
+    for (const k of Object.keys(view0.board.cells)) {
+      const [x, y] = k.split(",").map(Number) as [number, number];
+      for (const dir of ["N", "E", "S", "W"] as const) {
+        const pit = { x: x + delta[dir].x, y: y + delta[dir].y };
+        const beyond = { x: pit.x + delta[dir].x, y: pit.y + delta[dir].y };
+        if (!view0.board.cells[cellKey(pit)] || !view0.board.cells[cellKey(beyond)]) continue;
+        if ((view0.board.edges[edgeKey({ x, y }, dir)] ?? "open") !== "open") continue;
+        if ((view0.board.edges[edgeKey(pit, dir)] ?? "open") !== "open") continue;
+        if (state.squareContents[k] || state.squareContents[cellKey(pit)] || state.squareContents[cellKey(beyond)]) continue;
+        bot.position = { x, y };
+        state.squareContents[cellKey(pit)] = { kind: "pit", damage: 0, createdBy: "human" };
+        state.squareContents[cellKey(beyond)] = { kind: "stone", damage: 0, createdBy: "human" };
+        const blocked = pathToward(viewFor(state, "bot"), bot.position, new Set([cellKey(pit)]), { throughHazards: true });
+        expect(blocked === null || blocked.dir !== dir).toBe(true);
+        delete state.squareContents[cellKey(beyond)];
+        const open = pathToward(viewFor(state, "bot"), bot.position, new Set([cellKey(pit)]), { throughHazards: true });
+        expect(open?.dir).toBe(dir);
+        return;
+      }
+    }
+    throw new Error("no straight three-square run on this board");
+  });
+});

packages/engine/test/casting.test.ts

@@ -117,6 +117,48 @@ describe("attack spells", () => {
     expect(state.players.find((p) => p.id === attacker)!.life).toBe(10);
   });
 
+  it("reflection's returning half is the caster's to counteract (rev 18)", () => {
+    const setup = (deckRev: number) => {
+      let { state } = createGame({ playerIds: ["alice", "bob"], seed: 42, sets: ["basic"], deckRev });
+      state = toRound2(state);
+      const { attacker, defender } = faceOff(state);
+      const fb = giveCard(state, attacker, "fireball");
+      const d = state.players.find((p) => p.id === defender)!;
+      d.hand[0] = { instanceId: "reflection#T", cardId: "reflection" };
+      const a = state.players.find((p) => p.id === attacker)!;
+      a.hand.push({ instanceId: "absorb#T", cardId: "absorb" });
+      state = must(state, attacker, { type: "cast", instanceId: fb.instanceId, target: { kind: "player", playerId: defender } });
+      state = must(state, defender, { type: "counteract", instanceId: "reflection#T" });
+      state = must(state, attacker, { type: "pass" });
+      state = must(state, defender, { type: "pass" });
+      return { state, attacker, defender };
+    };
+    const life = (s: GameState, id: string) => s.players.find((p) => p.id === id)!.life;
+    // Rev 18: the defender takes their half; the half coming back waits on the caster.
+    {
+      const { state, attacker, defender } = setup(18);
+      expect(life(state, defender)).toBe(12);
+      expect(life(state, attacker)).toBe(15);
+      expect(state.stack?.waitingOn).toBe(attacker);
+      expect(state.stack?.reflectedBase?.damage).toBe(3);
+      // A counter hands the word to the reflector, who may answer; both pass to resolve.
+      const soaked = must(state, attacker, { type: "counteract", instanceId: "absorb#T" });
+      const done = must(must(soaked, defender, { type: "pass" }), attacker, { type: "pass" });
+      expect(life(done, attacker)).toBe(15);
+      expect(done.stack).toBeNull();
+      const taken = must(state, attacker, { type: "pass" });
+      expect(life(taken, attacker)).toBe(12);
+      expect(taken.stack).toBeNull();
+    }
+    // Rev 17: the half landed at once.
+    {
+      const { state, attacker, defender } = setup(17);
+      expect(life(state, defender)).toBe(12);
+      expect(life(state, attacker)).toBe(12);
+      expect(state.stack).toBeNull();
+    }
+  });
+
   it("absorb spell nullifies the attack and takes the card into hand", () => {
     let { state } = newGame();
     state = toRound2(state);
@@ -1352,3 +1394,28 @@ describe("disease makes the caster the carrier (rev 7)", () => {
     throw new Error("no adjacent step for the return walk");
   });
 });
+
+describe("a REFLECTION against a permanent curse afflicts both (rev 24)", () => {
+  const cursed = (s: GameState, id: string) => s.sustained.some((e) => e.cardId === "walking-dead" && e.targetId === id);
+  const play = (deckRev: number) => {
+    let { state } = createGame({ playerIds: ["alice", "bob"], seed: 42, sets: ["basic"], deckRev });
+    state = toRound2(state);
+    const { attacker, defender } = faceOff(state);
+    const wd = giveCard(state, attacker, "walking-dead");
+    state.players.find((p) => p.id === defender)!.hand[0] = { instanceId: "reflection#T", cardId: "reflection" };
+    state = must(state, attacker, { type: "cast", instanceId: wd.instanceId, target: { kind: "player", playerId: defender } });
+    state = must(state, defender, { type: "counteract", instanceId: "reflection#T" });
+    state = drain(state);
+    return { state, attacker, defender };
+  };
+  it("lays WALKING DEAD on the caster too", () => {
+    const { state, attacker, defender } = play(24);
+    expect(cursed(state, defender)).toBe(true);
+    expect(cursed(state, attacker)).toBe(true);
+  });
+  it("older games left the caster untouched", () => {
+    const { state, attacker, defender } = play(23);
+    expect(cursed(state, defender)).toBe(true);
+    expect(cursed(state, attacker)).toBe(false);
+  });
+});

packages/engine/test/creatures.test.ts

@@ -1,9 +1,10 @@
 import { describe, expect, it } from "vitest";
 import {
-  type CreatureState, applyCommand, activePlayer, boardView, creatureAt, type GameState, type PlayerId, createGame } from "../src/game";
-import { cellKey, edgeKey, SIDES, stepTarget, type Cell, type Side } from "../src/board";
+  type CreatureState, applyCommand, activePlayer, boardView, creatureAt, type GameState, type PlayerId, createGame, gameLos,
+} from "../src/game";
+import { cellKey, edgeKey, neighbor, opposite, SIDES, stepTarget, type Cell, type Side } from "../src/board";
 import type { CardInstance } from "../src/cards";
-import { newExpansionGame as newGame, must, drain, giveCard, toRound2, emptyNeighborCell, pushSustained } from "./helpers";
+import { newExpansionGame as newGame, must, drain, giveCard, toRound2, emptyNeighborCell, pushSustained, faceOff } from "./helpers";
 
 /** Summon a creature next to its creator (round 2+, consumes the attack). */
 function summon(state: GameState, playerId: PlayerId, kind: string, tag = "S") {
@@ -392,23 +393,113 @@ describe("big man", () => {
     expect(cellKey(state.players.find((p) => p.id === rig.giant.id)!.position)).toBe(cellKey(run.mid));
   });
 
+  /** From a giant's square: a step into a square whose exits (all sides but
+   * the way back) number exactly `want` — a corner (1, not straight) or a
+   * fork (2+). Returns the giant's start, the pushee's square, and the exits. */
+  function pushSite(state: GameState, want: "corner" | "fork" | "straight-fork") {
+    const view = boardView(state);
+    for (const key of Object.keys(view.cells)) {
+      const [x, y] = key.split(",").map(Number) as [number, number];
+      if (view.homes.some((h) => cellKey(h) === key)) continue;
+      for (const side of SIDES) {
+        const t1 = stepTarget(view, { x, y }, side);
+        if (t1.kind !== "step") continue;
+        const exits = SIDES.filter((d) => d !== opposite(side) && stepTarget(view, t1.to, d).kind === "step");
+        if (want === "corner" && exits.length === 1 && exits[0] !== side) return { at: { x, y }, side, mid: t1.to, exits };
+        if (want === "fork" && exits.length >= 2) return { at: { x, y }, side, mid: t1.to, exits };
+        if (want === "straight-fork" && exits.length >= 2 && exits.includes(side)) return { at: { x, y }, side, mid: t1.to, exits };
+      }
+    }
+    throw new Error(`no ${want} on this board`);
+  }
+
+  it("pushes a wizard around a corner when that is the only way (rev 15)", () => {
+    const rig = bigRig();
+    let state = rig.state;
+    const site = pushSite(state, "corner");
+    const giant = state.players.find((p) => p.id === rig.giant.id)!;
+    const victim = state.players.find((p) => p.id !== rig.giant.id)!;
+    giant.position = { ...site.at };
+    victim.position = { ...site.mid };
+    state = must(state, rig.giant.id, { type: "move", direction: site.side });
+    const after = state.players.find((p) => p.id !== rig.giant.id)!;
+    expect(cellKey(after.position)).toBe(cellKey(neighbor(site.mid, site.exits[0]!)));
+    expect(cellKey(state.players.find((p) => p.id === rig.giant.id)!.position)).toBe(cellKey(site.mid));
+  });
+
+  it("at a fork the pushed wizard chooses, and the stride hangs until they do", () => {
+    const rig = bigRig();
+    let state = rig.state;
+    const site = pushSite(state, "fork");
+    const giant = state.players.find((p) => p.id === rig.giant.id)!;
+    const victim = state.players.find((p) => p.id !== rig.giant.id)!;
+    giant.position = { ...site.at };
+    victim.position = { ...site.mid };
+    const used = state.turn.movementUsed;
+    const r = applyCommand(state, rig.giant.id, { type: "move", direction: site.side });
+    if (!r.ok) throw new Error(r.error);
+    state = r.state;
+    expect(state.pushPending?.pusheeId).toBe(victim.id);
+    expect(state.turn.movementUsed).toBe(used);
+    expect(cellKey(state.players.find((p) => p.id === rig.giant.id)!.position)).toBe(cellKey(site.at));
+    // Only the pushed wizard may answer, and only with pushChoice, and only an open way.
+    expect(applyCommand(state, rig.giant.id, { type: "move", direction: site.side }).ok).toBe(false);
+    expect(applyCommand(state, victim.id, { type: "pass" }).ok).toBe(false);
+    expect(applyCommand(state, victim.id, { type: "pushChoice", direction: opposite(site.side) }).ok).toBe(false);
+    const pick = site.exits[site.exits.length - 1]!;
+    state = must(state, victim.id, { type: "pushChoice", direction: pick });
+    expect(state.pushPending).toBeNull();
+    expect(cellKey(state.players.find((p) => p.id !== rig.giant.id)!.position)).toBe(cellKey(neighbor(site.mid, pick)));
+    expect(cellKey(state.players.find((p) => p.id === rig.giant.id)!.position)).toBe(cellKey(site.mid));
+    expect(state.turn.movementUsed).toBe(used + 1);
+  });
+
+  it("a pre-rev-15 game shoves straight ahead when it can and rounds a corner when it cannot", () => {
+    let { state } = createGame({ playerIds: ["alice", "bob"], seed: 42, sets: ["basic", "expansion1"], deckRev: 14 });
+    state = toRound2(state);
+    const giant = activePlayer(state);
+    state.sustained.push({ id: "fx-big", cardId: "big-man", casterId: giant.id, targetId: giant.id, remainingTurns: 9, data: {} });
+    const victim = state.players.find((p) => p.id !== giant.id)!;
+    // A fork where straight ahead is open: no window, straight it is.
+    const fork = pushSite(state, "straight-fork");
+    {
+      giant.position = { ...fork.at };
+      victim.position = { ...fork.mid };
+      const r = applyCommand(state, giant.id, { type: "move", direction: fork.side });
+      if (!r.ok) throw new Error(r.error);
+      expect(r.state.pushPending).toBeNull();
+      expect(cellKey(r.state.players.find((p) => p.id !== giant.id)!.position)).toBe(cellKey(neighbor(fork.mid, fork.side)));
+    }
+    // A corner: refused before, rounded now.
+    const corner = pushSite(state, "corner");
+    giant.position = { ...corner.at };
+    victim.position = { ...corner.mid };
+    const r = applyCommand(state, giant.id, { type: "move", direction: corner.side });
+    if (!r.ok) throw new Error(r.error);
+    expect(cellKey(r.state.players.find((p) => p.id !== giant.id)!.position)).toBe(cellKey(neighbor(corner.mid, corner.exits[0]!)));
+  });
+
   it("no room to shove means no way forward", () => {
     const rig = bigRig();
     const state = rig.state;
     const victim = state.players.find((p) => p.id !== rig.giant.id)!;
     const view = boardView(state);
-    // Find a step whose far side is walled: victim there cannot be pushed.
+    // A dead-end pocket beside some square: a victim there cannot be pushed anywhere.
+    const giant = state.players.find((p) => p.id === rig.giant.id)!;
+    for (const key of Object.keys(view.cells)) {
+      const [x, y] = key.split(",").map(Number) as [number, number];
       for (const side of SIDES) {
-      const t1 = stepTarget(view, rig.giant.position, side);
+        const t1 = stepTarget(view, { x, y }, side);
         if (t1.kind !== "step") continue;
-      const t2 = stepTarget(view, t1.to, side);
-      if (t2.kind === "step") continue;
+        if (SIDES.some((d) => d !== opposite(side) && stepTarget(view, t1.to, d).kind === "step")) continue;
+        giant.position = { x, y };
         victim.position = { ...t1.to };
         const r = applyCommand(state, rig.giant.id, { type: "move", direction: side });
         expect(r.ok).toBe(false);
         return;
       }
-    throw new Error("setup: seed offered no walled pocket beside the home");
+    }
+    throw new Error("setup: no dead-end pocket on this board");
   });
 
   it("a shrunk wizard slips between the giant's boots", () => {
@@ -872,3 +963,62 @@ describe("the imp's fire is a spell (rev 8)", () => {
     expect(after.alive).toBe(true);
   });
 });
+
+describe("the alter ego casts from its own square", () => {
+  it("a fireball leaves from the double, by the double's sight, and answers to the caster", () => {
+    let { state } = newGame(42);
+    state = toRound2(state);
+    const { attacker, defender } = faceOff(state);
+    const a = state.players.find((p) => p.id === attacker)!;
+    const d = state.players.find((p) => p.id === defender)!;
+    const ego = giveCard(state, attacker, "alter-ego");
+    state = must(state, attacker, { type: "cast", instanceId: ego.instanceId });
+    const double = state.creatures.find((c) => c.kind === "alter-ego" && c.controllerId === attacker)!;
+    expect(cellKey(double.position)).toBe(cellKey(a.position));
+    // The caster steps out of the defender's sight; the double keeps it.
+    const view = boardView(state);
+    const hidden = Object.keys(view.cells).map((k) => { const [x, y] = k.split(",").map(Number) as [number, number]; return { x, y }; })
+      .find((c) => !gameLos(state, c, d.position) && !state.squareContents[cellKey(c)] && !view.homes.some((h) => cellKey(h) === cellKey(c)));
+    expect(hidden).toBeDefined();
+    const me = state.players.find((p) => p.id === attacker)!;
+    me.position = { ...hidden! };
+    const fb = giveCard(state, attacker, "fireball");
+    const blind = applyCommand(state, attacker, { type: "cast", instanceId: fb.instanceId, target: { kind: "player", playerId: defender } });
+    expect(blind.ok).toBe(false);
+    const wrong = applyCommand(state, attacker, { type: "cast", instanceId: fb.instanceId, target: { kind: "player", playerId: defender }, via: "no-such-double" });
+    expect(wrong.ok).toBe(false);
+    const viaEgo = applyCommand(state, attacker, { type: "cast", instanceId: fb.instanceId, target: { kind: "player", playerId: defender }, via: double.id });
+    expect(viaEgo.ok).toBe(true);
+    if (!viaEgo.ok) return;
+    expect(viaEgo.state.stack?.attackerId).toBe(attacker);
+    expect(cellKey(viaEgo.state.stack!.origin!)).toBe(cellKey(double.position));
+    const cast = viaEgo.events.find((e) => e.type === "spellCast");
+    expect(cast && cast.type === "spellCast" ? cellKey(cast.from) : null).toBe(cellKey(double.position));
+    const done = must(viaEgo.state, defender, { type: "pass" });
+    expect(done.players.find((p) => p.id === defender)!.life).toBe(10);
+  });
+});
+
+describe("the troll's fist on a wall", () => {
+  it("punches a wall line beside it for a D4, once a turn", () => {
+    let { state } = newGame();
+    state = toRound2(state);
+    const me = activePlayer(state).id;
+    const r = summon(state, me, "troll");
+    state = r.state;
+    const other = state.players.find((p) => p.id !== me)!.id;
+    state = must(state, me, { type: "endTurn", draw: 0 });
+    state = must(state, other, { type: "endTurn", draw: 0 });
+    const troll = state.creatures[0]!;
+    const board = boardView(state);
+    const side = SIDES.find((s) => board.edges[edgeKey(troll.position, s)] === "wall")!;
+    const res = applyCommand(state, me, { type: "creatureAttackWall", creatureId: troll.id, cell: troll.position, side });
+    expect(res.ok).toBe(true);
+    if (!res.ok) return;
+    const hit = res.events.find((e) => e.type === "wallDamaged");
+    expect(hit && hit.type === "wallDamaged" ? hit.amount : 0).toBeGreaterThanOrEqual(1);
+    expect(res.state.creatures[0]!.attackUsed).toBe(true);
+    const again = applyCommand(res.state, me, { type: "creatureAttackWall", creatureId: troll.id, cell: troll.position, side });
+    expect(again.ok).toBe(false);
+  });
+});

packages/engine/test/durations-doors-cards.test.ts

@@ -1,8 +1,8 @@
 import { describe, expect, it } from "vitest";
 import { applyCommand, activePlayer, boardView, createGame, sustainedOn, type GameState } from "../src/game";
-import { cellKey, edgeKey, neighbor, opposite, type Side } from "../src/board";
+import { cellKey, edgeKey, neighbor, opposite, SIDES, type Side } from "../src/board";
 import type { CardInstance } from "../src/cards";
-import { newGame, must, giveCard, toRound2, faceOff, castAt } from "./helpers";
+import { newGame, must, giveCard, toRound2, faceOff, castAt, drain } from "./helpers";
 
 describe("duration spells", () => {
   it("slow reduces movement to 1, blocks number cards, and halves attacks", () => {
@@ -567,3 +567,44 @@ describe("the displayed MASTER KEY", () => {
     expect(r.ok).toBe(false);
   });
 });
+
+describe("POWER DRAIN drains the number played (rev 23)", () => {
+  it("gains the number even when the blow is blunted", () => {
+    let { state } = newGame();
+    state = toRound2(state);
+    const { attacker, defender } = faceOff(state);
+    const pd = giveCard(state, attacker, "power-drain");
+    giveCard(state, attacker, "number-4", "N", 1);
+    const d = state.players.find((p) => p.id === defender)!;
+    d.hand[0] = { instanceId: "blunt#T", cardId: "blunt" };
+    state = must(state, attacker, { type: "cast", instanceId: pd.instanceId, target: { kind: "player", playerId: defender }, numberInstanceIds: ["number-4#N"] });
+    state = must(state, defender, { type: "counteract", instanceId: "blunt#T" });
+    state = drain(state);
+    expect(state.players.find((p) => p.id === defender)!.life).toBe(13);
+    expect(state.players.find((p) => p.id === attacker)!.life).toBe(19);
+  });
+
+  it("drains a wall for its points", () => {
+    let { state } = newGame();
+    state = toRound2(state);
+    const me = activePlayer(state);
+    const board = boardView(state);
+    const side = SIDES.find((s) => board.edges[edgeKey(me.position, s)] === "wall")!;
+    const pd = giveCard(state, me.id, "power-drain");
+    giveCard(state, me.id, "number-3", "N", 1);
+    state = must(state, me.id, { type: "cast", instanceId: pd.instanceId, target: { kind: "edge", cell: me.position, side }, numberInstanceIds: ["number-3#N"] });
+    expect(state.wallDamage[edgeKey(me.position, side)]).toBe(3);
+    expect(state.players.find((p) => p.id === me.id)!.life).toBe(18);
+  });
+
+  it("older games gave only what the opponent lost, and nothing from a wall", () => {
+    let state = toRound2(createGame({ playerIds: ["alice", "bob"], seed: 42, sets: ["basic"], deckRev: 22 }).state);
+    const me = activePlayer(state);
+    const board = boardView(state);
+    const side = SIDES.find((s) => board.edges[edgeKey(me.position, s)] === "wall")!;
+    const pd = giveCard(state, me.id, "power-drain");
+    giveCard(state, me.id, "number-3", "N", 1);
+    state = must(state, me.id, { type: "cast", instanceId: pd.instanceId, target: { kind: "edge", cell: me.position, side }, numberInstanceIds: ["number-3#N"] });
+    expect(state.players.find((p) => p.id === me.id)!.life).toBe(15);
+  });
+});

packages/engine/test/expansion-combat.test.ts

@@ -1,6 +1,6 @@
 import { describe, expect, it } from "vitest";
-import { applyCommand, activePlayer, boardView, createGame, gameLos, sustainedOn } from "../src/game";
-import { cellKey, edgeKey, stepTarget } from "../src/board";
+import { applyCommand, activePlayer, boardView, createGame, gameLos, sustainedOn, walkingDistance, type GameState } from "../src/game";
+import { cellKey, edgeKey, opposite, SIDES, stepTarget, type Cell, type Side } from "../src/board";
 import type { CardInstance } from "../src/cards";
 import { newExpansionGame as newGame, must, drain, giveCard, toRound2, faceOff, castAt } from "./helpers";
 
@@ -812,3 +812,86 @@ describe("the goat charges on legs, not wings (rev 10)", () => {
     expect(rams).toBeGreaterThan(0);
   });
 });
+
+describe("butt-head's charge reaches as far as its legs (rev 16)", () => {
+  /** Two empty cells seven or eight corridor steps apart on the seed-42 board. */
+  function longRun(state: GameState): { from: Cell; to: Cell; steps: number } {
+    const view = boardView(state);
+    const cells = Object.keys(view.cells).map((k) => { const [x, y] = k.split(",").map(Number) as [number, number]; return { x, y }; })
+      .filter((c) => !state.squareContents[cellKey(c)] && !view.homes.some((h) => cellKey(h) === cellKey(c)));
+    for (const from of cells) for (const to of cells) {
+      const d = walkingDistance(state, from, to, 12);
+      if (d === 7 || d === 8) return { from, to, steps: d };
+    }
+    throw new Error("no seven-step corridor on this board");
+  }
+  for (const [deckRev, ok] of [[16, true], [15, false]] as const) {
+    it(`a goat with eight legs and a target seven or eight corridor steps off: rev ${deckRev} ${ok ? "charges" : "refuses"}`, () => {
+      let { state } = createGame({ playerIds: ["goat", "mark"], seed: 42, sets: ["basic", "expansion1"], deckRev });
+      state = toRound2(state);
+      const goat = activePlayer(state);
+      const mark = state.players.find((p) => p.id !== goat.id)!;
+      const run = longRun(state);
+      goat.position = { ...run.from };
+      mark.position = { ...run.to };
+      state.turn.movementAllowance = 8;
+      state.turn.movementUsed = 0;
+      const card = giveCard(state, goat.id, "butt-head");
+      const r = applyCommand(state, goat.id, { type: "cast", instanceId: card.instanceId, target: { kind: "player", playerId: mark.id } });
+      expect(r.ok).toBe(ok);
+      if (!r.ok) expect(r.error).toMatch(/legs, not wings/);
+    });
+  }
+});
+
+describe("cards that keep their whole promise (rev 21)", () => {
+  it("LIFESAVER's holder survives losing both treasures", () => {
+    for (const [deckRev, alive] of [[21, true], [20, false]] as const) {
+      let { state } = createGame({ playerIds: ["alice", "bob", "carol"], seed: 42, sets: ["basic", "expansion1"], deckRev });
+      const me = activePlayer(state);
+      const others = state.players.filter((p) => p.id !== me.id);
+      const card = giveCard(state, me.id, "lifesaver");
+      state = must(state, me.id, { type: "cast", instanceId: card.instanceId });
+      // Both of the holder's treasures rest on two different enemy homes: nobody wins, the holder is done for.
+      const mine = state.treasures.filter((t) => t.owner === me.id);
+      mine[0]!.position = { ...others[0]!.home };
+      mine[1]!.position = { ...others[1]!.home };
+      state = must(state, me.id, { type: "endTurn", draw: 0 });
+      expect(state.players.find((p) => p.id === me.id)!.alive).toBe(alive);
+    }
+  });
+
+  it("FORCE FIELD stands until the opponent's turn ends: no entering, no casting on its caster", () => {
+    for (const deckRev of [21, 20]) {
+      let { state } = createGame({ playerIds: ["alice", "bob"], seed: 42, sets: ["basic", "expansion1"], deckRev });
+      state = toRound2(state);
+      const { attacker, defender } = faceOff(state);
+      const a = state.players.find((p) => p.id === attacker)!;
+      const d = state.players.find((p) => p.id === defender)!;
+      // Stand the attacker beside the defender, an open edge between.
+      const view = boardView(state);
+      const side = SIDES.find((s: Side) => { const t = stepTarget(view, d.position, s); return t.kind === "step" && !state.squareContents[cellKey(t.to)]; })!;
+      const beside = stepTarget(view, d.position, side);
+      if (beside.kind === "blocked") throw new Error("no open side");
+      a.position = { ...beside.to };
+      const fb = giveCard(state, attacker, "fireball");
+      d.hand[0] = { instanceId: "force-field#T", cardId: "force-field" };
+      state = must(state, attacker, { type: "cast", instanceId: fb.instanceId, target: { kind: "player", playerId: defender } });
+      state = must(state, defender, { type: "counteract", instanceId: "force-field#T" });
+      state = must(state, attacker, { type: "pass" });
+      if (state.stack) state = must(state, defender, { type: "pass" });
+      expect(state.players.find((p) => p.id === defender)!.life).toBe(15);
+      const step = applyCommand(state, attacker, { type: "move", direction: opposite(side) });
+      if (deckRev >= 21) {
+        expect(step.ok).toBe(false);
+        if (!step.ok) expect(step.error).toMatch(/force field/);
+        expect(state.sustained.some((f) => f.cardId === "force-field")).toBe(true);
+        const after = must(state, attacker, { type: "endTurn", draw: 0 });
+        expect(after.sustained.some((f) => f.cardId === "force-field")).toBe(false);
+      } else {
+        expect(step.ok).toBe(true);
+        expect(state.sustained.some((f) => f.cardId === "force-field")).toBe(false);
+      }
+    }
+  });
+});

packages/engine/test/expansion-terrain.test.ts

@@ -1,9 +1,43 @@
 import { describe, expect, it } from "vitest";
-import { applyCommand, activePlayer, boardView, createGame, gameLos } from "../src/game";
-import { cellKey, edgeKey, SIDES, stepTarget, type Cell, type Side } from "../src/board";
+import { applyCommand, activePlayer, boardView, createGame, gameLos, wallIgnoringDistance, type GameState } from "../src/game";
+import { cellKey, edgeKey, neighbor, opposite, SIDES, stepTarget, type Cell, type Side } from "../src/board";
 import type { CardInstance } from "../src/cards";
 import { eligibleCellsFor, sightedCellsFor, viewFor } from "../src/view";
-import { newExpansionGame as newGame, must, giveCard, emptyNeighborCell, plainRimWall } from "./helpers";
+import { newExpansionGame as newGame, must, giveCard, emptyNeighborCell, plainRimWall, toRound2 } from "./helpers";
+
+/** The sides a walker may leave a pit by, having entered it heading `entry`. */
+function rimExits(state: GameState, pit: Cell, entry: Side): Side[] {
+  const view = boardView(state);
+  return SIDES.filter((d) => {
+    if (d === opposite(entry)) return false;
+    const b = neighbor(pit, d);
+    return !!view.cells[cellKey(b)] && (view.edges[edgeKey(pit, d)] ?? "open") === "open" &&
+      state.squareContents[cellKey(b)]?.kind !== "stone";
+  });
+}
+
+/** Two pit sites on a board: a fork (several ways off) and a corridor (one
+ * way off, straight ahead), each with the square a walker enters from. */
+function pitSpots(state: GameState) {
+  const view = boardView(state);
+  let fork: { from: Cell; pit: Cell; side: Side; exits: Side[] } | null = null;
+  let corridor: { from: Cell; pit: Cell; side: Side; beyond: Cell } | null = null;
+  for (const k of Object.keys(view.cells)) {
+    const [x, y] = k.split(",").map(Number) as [number, number];
+    for (const side of SIDES) {
+      const t = stepTarget(view, { x, y }, side);
+      if (t.kind !== "step") continue;
+      if (state.squareContents[k] || state.squareContents[cellKey(t.to)]) continue;
+      if (view.homes.some((h) => cellKey(h) === k || cellKey(h) === cellKey(t.to))) continue;
+      const exits = rimExits(state, t.to, side);
+      if (!fork && exits.length >= 2) fork = { from: { x, y }, pit: t.to, side, exits };
+      if (!corridor && exits.length === 1 && exits[0] === side) corridor = { from: { x, y }, pit: t.to, side, beyond: neighbor(t.to, side) };
+      if (fork && corridor) return { fork, corridor };
+    }
+  }
+  throw new Error("board lacks a fork or a corridor pit site");
+}
+
 
 describe("expansion terrain", () => {
   it("killer ooze burns on entry and can drop you on your face", () => {
@@ -37,14 +71,62 @@ describe("expansion terrain", () => {
       state = must(state, me.id, {
         type: "cast", instanceId: pit.instanceId, target: { kind: "cell", cell: spot.cell },
       });
-      state = must(state, me.id, { type: "move", direction: spot.side });
+      // Rev 14: the rim's exits are the walker's to name; take the first.
+      const exits = rimExits(state, spot.cell, spot.side);
+      if (exits.length === 0) continue;
+      state = must(state, me.id, { type: "move", direction: spot.side, exit: exits[0] });
       const p = state.players.find((p) => p.id === me.id)!;
       if (p.inPit) { falls++; expect(p.life).toBe(13); }
       else if (cellKey(p.position) === cellKey(me.position)) teeters++;
       else jumps++;
     }
-    expect(falls + jumps + teeters).toBe(12);
+    expect(teeters).toBe(0);
     expect(falls).toBeGreaterThan(0);
+    expect(jumps).toBeGreaterThan(0);
+  });
+
+  it("the rim leads off a pit: one way is taken, several must be named, none cannot be entered", () => {
+    const found = pitSpots(newGame(42).state);
+    // Several ways off: a bare step is refused with the choices; a named exit lands there or falls in.
+    {
+      let { state } = newGame(42);
+      const me = activePlayer(state);
+      me.position = { ...found.fork.from };
+      state.squareContents[cellKey(found.fork.pit)] = { kind: "pit", damage: 0, createdBy: me.id };
+      const bare = applyCommand(state, me.id, { type: "move", direction: found.fork.side });
+      expect(bare.ok).toBe(false);
+      if (!bare.ok) expect(bare.error).toMatch(/click the square to land on/);
+      const chosen = found.fork.exits[1]!;
+      const named = applyCommand(state, me.id, { type: "move", direction: found.fork.side, exit: chosen });
+      expect(named.ok).toBe(true);
+      if (named.ok) {
+        const p = named.state.players.find((p) => p.id === me.id)!;
+        const landing = neighbor(found.fork.pit, chosen);
+        expect(p.inPit || cellKey(p.position) === cellKey(landing)).toBe(true);
+      }
+    }
+    // No way off: refused before any die is rolled (rev 14); bounced and charged in an older game.
+    for (const deckRev of [14, 13]) {
+      let { state } = createGame({ playerIds: ["alice", "bob"], seed: 42, sets: ["basic", "expansion1"], deckRev });
+      const me = activePlayer(state);
+      me.position = { ...found.corridor.from };
+      state.squareContents[cellKey(found.corridor.pit)] = { kind: "pit", damage: 0, createdBy: me.id };
+      state.squareContents[cellKey(found.corridor.beyond)] = { kind: "stone", damage: 0, createdBy: me.id };
+      const r = applyCommand(state, me.id, { type: "move", direction: found.corridor.side });
+      if (deckRev >= 14) {
+        expect(r.ok).toBe(false);
+        if (!r.ok) expect(r.error).toMatch(/cannot be crossed/);
+      } else {
+        expect(r.ok).toBe(true);
+        if (r.ok) {
+          const p = r.state.players.find((p) => p.id === me.id)!;
+          if (!p.inPit) {
+            expect(cellKey(p.position)).toBe(cellKey(found.corridor.from));
+            expect(r.events.some((e) => e.type === "moveBumped")).toBe(true);
+          }
+        }
+      }
+    }
   });
 
   it("dust cloud blinds anyone standing inside it", () => {
@@ -63,6 +145,29 @@ describe("expansion terrain", () => {
     }
   });
 
+  it("a wizard in a dust cloud casts no LOS spell out, and none reaches them (rev 19)", () => {
+    for (const deckRev of [19, 18]) {
+      let { state } = createGame({ playerIds: ["alice", "bob"], seed: 42, sets: ["basic", "expansion1"], deckRev });
+      const me = activePlayer(state);
+      const spot = emptyNeighborCell(state, me.position);
+      state.squareContents[cellKey(spot.cell)] = { kind: "dust", damage: 0, createdBy: me.id };
+      me.position = { ...spot.cell };
+      // An empty square beside the cloud, in plain sight but for the dust.
+      const outside = emptyNeighborCell(state, spot.cell).cell;
+      const blind = deckRev >= 19;
+      expect(gameLos(state, me.position, outside, me.id)).toBe(!blind);
+      expect(gameLos(state, outside, me.position)).toBe(!blind);
+      expect(gameLos(state, me.position, me.position, me.id)).toBe(true);
+      const sighted = sightedCellsFor(viewFor(state, me.id));
+      expect(sighted.has(cellKey(outside))).toBe(!blind);
+      expect(sighted.has(cellKey(me.position))).toBe(true);
+      // FILL SQUARE WITH STONE from inside the cloud: refused when blind.
+      const stone = giveCard(state, me.id, "fill-square-with-stone");
+      const r = applyCommand(state, me.id, { type: "cast", instanceId: stone.instanceId, target: { kind: "cell", cell: outside } });
+      expect(r.ok).toBe(!blind);
+    }
+  });
+
   it("glue pins a treasure to the floor until it wears off", () => {
     let { state } = newGame();
     const me = activePlayer(state);
@@ -455,3 +560,264 @@ describe("the boobytrap keeps its secret", () => {
     }
   });
 });
+
+describe("a pit on the board's rim (rev 17)", () => {
+  /** A square on the outer rim with a warp mouth on one side, entered from
+   * the square opposite the mouth; its other neighbouring squares listed. */
+  function rimPitSite(state: GameState) {
+    const view = boardView(state);
+    for (const k of Object.keys(view.cells)) {
+      const [x, y] = k.split(",").map(Number) as [number, number];
+      const pit = { x, y };
+      if (state.squareContents[k] || view.homes.some((h) => cellKey(h) === k)) continue;
+      for (const mouth of SIDES) {
+        if (stepTarget(view, pit, mouth).kind !== "warp") continue;
+        const entry = stepTarget(view, pit, opposite(mouth));
+        if (entry.kind !== "step" || state.squareContents[cellKey(entry.to)]) continue;
+        const floor = SIDES.filter((d) => d !== mouth && d !== opposite(mouth) && stepTarget(view, pit, d).kind === "step");
+        if (floor.length === 0) continue;
+        return { pit, mouth, from: entry.to, floor, far: stepTarget(view, pit, mouth) as { kind: "warp"; to: Cell } };
+      }
+    }
+    throw new Error("no rim pit site on this board");
+  }
+  const stoneUp = (state: GameState, pit: Cell, sides: Side[], by: string) => {
+    for (const d of sides) state.squareContents[cellKey(neighbor(pit, d))] = { kind: "stone", damage: 0, createdBy: by };
+  };
+  for (const deckRev of [17, 16]) {
+    it(`walls either side, the warp mouth is the way off (rev ${deckRev})`, () => {
+      let { state } = createGame({ playerIds: ["alice", "bob"], seed: 42, sets: ["basic", "expansion1"], deckRev });
+      const site = rimPitSite(state);
+      const me = activePlayer(state);
+      me.position = { ...site.from };
+      state.squareContents[cellKey(site.pit)] = { kind: "pit", damage: 0, createdBy: me.id };
+      stoneUp(state, site.pit, site.floor, me.id);
+      const r = applyCommand(state, me.id, { type: "move", direction: site.mouth });
+      expect(r.ok).toBe(true);
+      if (!r.ok) return;
+      const p = r.state.players.find((p) => p.id === me.id)!;
+      if (p.inPit) return;
+      expect(cellKey(p.position)).toBe(cellKey(site.far.to));
+      expect(r.events.some((e) => e.type === "jumpedPit" && e.via === "warp")).toBe(true);
+    });
+  }
+  it("a square beside the mouth: rev 17 asks which, rev 16 steps to the square but may name the mouth", () => {
+    for (const deckRev of [17, 16]) {
+      let { state } = createGame({ playerIds: ["alice", "bob"], seed: 42, sets: ["basic", "expansion1"], deckRev });
+      const site = rimPitSite(state);
+      const me = activePlayer(state);
+      me.position = { ...site.from };
+      state.squareContents[cellKey(site.pit)] = { kind: "pit", damage: 0, createdBy: me.id };
+      stoneUp(state, site.pit, site.floor.slice(1), me.id);
+      const bare = applyCommand(state, me.id, { type: "move", direction: site.mouth });
+      if (deckRev >= 17) {
+        expect(bare.ok).toBe(false);
+        if (!bare.ok) expect(bare.error).toMatch(/click the square to land on/);
+        const named = applyCommand(state, me.id, { type: "move", direction: site.mouth, exit: site.mouth });
+        expect(named.ok).toBe(true);
+        if (named.ok) {
+          const p = named.state.players.find((p) => p.id === me.id)!;
+          expect(p.inPit || cellKey(p.position) === cellKey(site.far.to)).toBe(true);
+        }
+      } else {
+        expect(bare.ok).toBe(true);
+        if (bare.ok) {
+          const p = bare.state.players.find((p) => p.id === me.id)!;
+          expect(p.inPit || cellKey(p.position) === cellKey(neighbor(site.pit, site.floor[0]!))).toBe(true);
+        }
+        // Named, the mouth is taken in any revision.
+        const mouth = applyCommand(state, me.id, { type: "move", direction: site.mouth, exit: site.mouth });
+        expect(mouth.ok).toBe(true);
+        if (mouth.ok) {
+          const p = mouth.state.players.find((p) => p.id === me.id)!;
+          expect(p.inPit || cellKey(p.position) === cellKey(site.far.to)).toBe(true);
+        }
+      }
+    }
+  });
+});
+
+describe("a wave names its victims before it pushes (rev 20)", () => {
+  /** A wall between two squares, a wizard on its near side with one open
+   * square behind them and a wall beyond it, and a caster's square beside. */
+  function site(state: GameState) {
+    const view = boardView(state);
+    for (const k of Object.keys(view.cells)) {
+      const [x, y] = k.split(",").map(Number) as [number, number];
+      const a = { x, y };
+      if (state.squareContents[k] || view.homes.some((h) => cellKey(h) === k)) continue;
+      if ((view.edges[edgeKey(a, "S")] ?? "open") !== "wall" || !view.cells[cellKey(neighbor(a, "S"))]) continue;
+      const back = stepTarget(view, a, "N");
+      if (back.kind !== "step" || state.squareContents[cellKey(back.to)] || view.homes.some((h) => cellKey(h) === cellKey(back.to))) continue;
+      if (stepTarget(view, back.to, "N").kind !== "blocked") continue;
+      const beside = stepTarget(view, a, "E");
+      if (beside.kind !== "step" || state.squareContents[cellKey(beside.to)]) continue;
+      return { a, back: back.to, beside: beside.to };
+    }
+    throw new Error("no such wall on this board");
+  }
+  for (const [deckRev, crush] of [[20, 1], [19, 2]] as const) {
+    it(`washed one square into a wall: rev ${deckRev} costs ${crush}`, () => {
+      let { state } = createGame({ playerIds: ["alice", "bob"], seed: 42, sets: ["basic", "expansion1"], deckRev });
+      const caster = activePlayer(state);
+      const victim = state.players.find((p) => p.id !== caster.id)!;
+      const s = site(state);
+      caster.position = { ...s.beside };
+      victim.position = { ...s.a };
+      const card = giveCard(state, caster.id, "stone-to-water");
+      const r = applyCommand(state, caster.id, { type: "cast", instanceId: card.instanceId, target: { kind: "edge", cell: s.a, side: "S" } });
+      expect(r.ok).toBe(true);
+      if (!r.ok) return;
+      const v = r.state.players.find((p) => p.id === victim.id)!;
+      expect(cellKey(v.position)).toBe(cellKey(s.back));
+      expect(v.life).toBe(15 - crush);
+      expect(r.events.filter((e) => e.type === "washedBack" && e.player === victim.id).length).toBe(crush === 1 ? 1 : 2);
+    });
+  }
+});
+
+describe("spells cast at a slime wait in the gel", () => {
+  it("a lightning blast lodges in the slime and goes off on the next wizard in, once", () => {
+    let { state } = newGame(42);
+    state = toRound2(state);
+    const caster = activePlayer(state);
+    const victim = state.players.find((p) => p.id !== caster.id)!;
+    const spot = emptyNeighborCell(state, caster.position);
+    state.squareContents[cellKey(spot.cell)] = { kind: "slime", damage: 0, createdBy: caster.id };
+    const bolt = giveCard(state, caster.id, "lightning-blast");
+    const cast = applyCommand(state, caster.id, { type: "cast", instanceId: bolt.instanceId, target: { kind: "cell", cell: spot.cell } });
+    expect(cast.ok).toBe(true);
+    if (!cast.ok) return;
+    expect(cast.events.some((e) => e.type === "spellTrapped")).toBe(true);
+    expect(cast.state.slimeTraps[cellKey(spot.cell)]?.length).toBe(1);
+    // Nobody is hurt yet; the victim walks in on their own turn.
+    state = must(cast.state, caster.id, { type: "endTurn", draw: 2 });
+    const v = state.players.find((p) => p.id === victim.id)!;
+    v.position = { ...caster.position };
+    const walk = applyCommand(state, victim.id, { type: "move", direction: spot.side });
+    expect(walk.ok).toBe(true);
+    if (!walk.ok) return;
+    expect(walk.events.some((e) => e.type === "slimeTrapSprung")).toBe(true);
+    expect(walk.state.stack?.defenderId).toBe(victim.id);
+    expect(walk.state.stack?.trapped).toBe(true);
+    const hit = must(walk.state, victim.id, { type: "pass" });
+    expect(hit.players.find((p) => p.id === victim.id)!.life).toBeLessThan(15);
+    expect(hit.slimeTraps[cellKey(spot.cell)]).toBeUndefined();
+  });
+});
+
+describe("attacks aimed at a bush or the ooze", () => {
+  function withContent(kind: "thornbush" | "rosebush" | "ooze") {
+    const state = toRound2(newGame().state);
+    const me = activePlayer(state);
+    const { cell } = emptyNeighborCell(state, me.position);
+    state.squareContents[cellKey(cell)] = { kind, damage: 0, createdBy: "bob" };
+    return { state, me, cell };
+  }
+
+  it("a FIREBALL tears a thornbush apart at five points", () => {
+    const { state, me, cell } = withContent("thornbush");
+    const fireball = giveCard(state, me.id, "fireball");
+    const r = applyCommand(state, me.id, { type: "cast", instanceId: fireball.instanceId, target: { kind: "cell", cell } });
+    expect(r.ok).toBe(true);
+    if (!r.ok) return;
+    expect(r.events).toContainEqual(expect.objectContaining({ type: "squareContentDamaged", kind: "thornbush", amount: 5, total: 5 }));
+    expect(r.events).toContainEqual(expect.objectContaining({ type: "squareContentDestroyed", kind: "thornbush" }));
+    expect(r.state.squareContents[cellKey(cell)]).toBeUndefined();
+    expect(r.state.turn.attackUsed).toBe(true);
+  });
+
+  it("a thrown dagger scratches a rosebush, and the scratch stays", () => {
+    const { state, me, cell } = withContent("rosebush");
+    const dagger = giveCard(state, me.id, "dagger");
+    const next = must(state, me.id, { type: "cast", instanceId: dagger.instanceId, target: { kind: "cell", cell } });
+    expect(next.squareContents[cellKey(cell)]).toEqual(expect.objectContaining({ kind: "rosebush", damage: 3 }));
+  });
+
+  it("only fire hurts the ooze", () => {
+    const { state, me, cell } = withContent("ooze");
+    const dagger = giveCard(state, me.id, "dagger");
+    const refused = applyCommand(state, me.id, { type: "cast", instanceId: dagger.instanceId, target: { kind: "cell", cell } });
+    expect(refused.ok).toBe(false);
+    if (!refused.ok) expect(refused.error).toMatch(/only fire/);
+    const fireball = giveCard(state, me.id, "fireball");
+    const burned = must(state, me.id, { type: "cast", instanceId: fireball.instanceId, target: { kind: "cell", cell } });
+    expect(burned.squareContents[cellKey(cell)]).toBeUndefined();
+  });
+
+  it("a WIZARDBLADE is swung at a bush from the square beside it, never from afar", () => {
+    const { state, me, cell } = withContent("thornbush");
+    const blade = giveCard(state, me.id, "wizardblade");
+    const three = giveCard(state, me.id, "number-3", "N", 1);
+    const near = applyCommand(state, me.id, {
+      type: "cast", instanceId: blade.instanceId, numberInstanceIds: [three.instanceId], target: { kind: "cell", cell },
+    });
+    expect(near.ok).toBe(true);
+    if (near.ok) expect(near.state.squareContents[cellKey(cell)]).toEqual(expect.objectContaining({ kind: "thornbush", damage: 3 }));
+
+    const far = sightedCellsFor(viewFor(state, me.id));
+    const farKey = [...far].find((k) => {
+      const [x, y] = k.split(",").map(Number);
+      return Math.abs(x! - me.position.x) + Math.abs(y! - me.position.y) >= 2 && !state.squareContents[k];
+    });
+    if (!farKey) return;
+    const [fx, fy] = farKey.split(",").map(Number);
+    state.squareContents[farKey] = { kind: "thornbush", damage: 0, createdBy: "bob" };
+    const refused = applyCommand(state, me.id, {
+      type: "cast", instanceId: blade.instanceId, numberInstanceIds: [three.instanceId], target: { kind: "cell", cell: { x: fx!, y: fy! } },
+    });
+    expect(refused.ok).toBe(false);
+    if (!refused.ok) expect(refused.error).toMatch(/beside/);
+  });
+});
+
+describe("teleport's reach wraps through the board's openings", () => {
+  it("offers the square beyond a warp mouth, as the engine allows it", () => {
+    const state = toRound2(newGame().state);
+    const me = activePlayer(state);
+    const view = boardView(state);
+    const warp = view.warps[0]!;
+    me.position = { ...warp.from.cell };
+    giveCard(state, me.id, "teleport");
+    const cells = eligibleCellsFor(viewFor(state, me.id), "teleport")!;
+    const beyond = cellKey(warp.to.cell);
+    expect(cells.has(beyond)).toBe(true);
+    const r = applyCommand(state, me.id, { type: "cast", instanceId: "teleport#T", target: { kind: "cell", cell: warp.to.cell } });
+    expect(r.ok).toBe(true);
+  });
+});
+
+describe("teleport across the maze's outer edge (rev 22)", () => {
+  function atTheTopEdge(deckRev?: number) {
+    const config = { playerIds: ["alice", "bob"], seed: 42, sets: ["basic", "expansion1"] as ("basic" | "expansion1")[], ...(deckRev ? { deckRev } : {}) };
+    const state = toRound2(createGame(config).state);
+    const me = activePlayer(state);
+    const view = boardView(state);
+    // A square on the top row whose north side is plain edge, not a lettered mouth.
+    const top = Object.keys(view.cells).map((k) => k.split(",").map(Number) as [number, number])
+      .filter(([x, y]) => y === 0 && !view.warps.some((w) => w.from.cell.x === x && w.from.cell.y === y && w.from.side === "N"))
+      .find(([x]) => !state.squareContents[`${x},0`])!;
+    me.position = { x: top[0], y: 0 };
+    const column = Object.keys(view.cells).map((k) => k.split(",").map(Number) as [number, number]).filter(([x]) => x === top[0]).map(([, y]) => y);
+    const bottom = { x: top[0], y: Math.max(...column) };
+    giveCard(state, me.id, "teleport");
+    return { state, me, bottom };
+  }
+
+  it("re-enters at the bottom of the same column, one space on", () => {
+    const { state, me, bottom } = atTheTopEdge();
+    expect(wallIgnoringDistance(boardView(state), me.position, bottom, true)).toBe(1);
+    expect(eligibleCellsFor(viewFor(state, me.id), "teleport")!.has(cellKey(bottom))).toBe(true);
+    const r = applyCommand(state, me.id, { type: "cast", instanceId: "teleport#T", target: { kind: "cell", cell: bottom } });
+    expect(r.ok).toBe(true);
+    if (r.ok) expect(r.state.players.find((p) => p.id === me.id)!.position).toEqual(bottom);
+  });
+
+  it("older games cross only at the lettered openings", () => {
+    const { state, me, bottom } = atTheTopEdge(21);
+    expect(wallIgnoringDistance(boardView(state), me.position, bottom)).toBeGreaterThan(4);
+    expect(eligibleCellsFor(viewFor(state, me.id), "teleport")!.has(cellKey(bottom))).toBe(false);
+    const r = applyCommand(state, me.id, { type: "cast", instanceId: "teleport#T", target: { kind: "cell", cell: bottom } });
+    expect(r.ok).toBe(false);
+  });
+});

packages/engine/test/stones.test.ts

@@ -188,7 +188,7 @@ describe("slow death", () => {
     expect(state.players.find((p) => p.id === defender)!.life).toBe(14);
   });
 
-  it("declining the window takes the whole total", () => {
+  it("declining the window takes the whole total (rev 13)", () => {
     let { state } = newGame();
     state = toRound2(state);
     const { attacker, defender } = faceOff(state);

packages/server/src/clips.ts

@@ -0,0 +1,159 @@
+// The public clip gallery: authored screenplay scenes recorded through
+// the reel, each in two takes — through the wizard's eyes and from the
+// board above. Standalone pages, no app bundle: a clip link must play
+// anywhere a browser lands, and unfurl anywhere it's pasted.
+import type { ClipMeta } from "./store.js";
+
+const esc = (s: string) =>
+  s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+
+const PAGE_CSS = `
+  * { box-sizing: border-box; }
+  body { margin: 0; background: #171a20; color: #d8d2c0; font-family: "Archivo Narrow", sans-serif; }
+  a { color: #e0b34a; }
+  .wrap { max-width: 1100px; margin: 0 auto; padding: 1.4rem 1.25rem 3rem; }
+  .mast { display: flex; align-items: baseline; gap: 1rem; margin-bottom: 1.6rem;
+          border-bottom: 1px solid rgba(233, 225, 203, 0.18); padding-bottom: 0.7rem; }
+  .mast a { font-family: "Oswald", sans-serif; text-transform: uppercase; letter-spacing: 0.18em;
+            font-size: 0.95rem; color: #e9e1cb; text-decoration: none; }
+  .mast .crumb { color: #8d8672; font-size: 0.85rem; letter-spacing: 0.06em; }
+  .mast .crumb a { font: inherit; letter-spacing: inherit; text-transform: none; color: inherit; }
+  .mast .deal { margin-left: auto; font-size: 0.8rem; letter-spacing: 0.12em; color: #e0b34a; }
+  h1 { font-family: "Oswald", sans-serif; font-weight: 500; font-size: 1.7rem; letter-spacing: 0.06em;
+       text-transform: uppercase; margin: 0 0 0.3rem; color: #e9e1cb; }
+  h1 a { color: inherit; text-decoration: none; }
+  p.sub { color: #a49c86; margin: 0 0 1.6rem; font-size: 1.05rem; max-width: 46rem; }
+  .grid { display: grid; grid-template-columns: repeat(auto-fill, minmax(300px, 1fr)); gap: 1.4rem; }
+  .card { background: #1f232d; border: 1px solid rgba(233, 225, 203, 0.18); border-radius: 8px;
+          overflow: hidden; text-decoration: none; color: inherit; display: block; }
+  .card:hover { border-color: #e0b34a; }
+  .card img { width: 100%; display: block; aspect-ratio: 736 / 577; object-fit: cover; }
+  .card .meta { padding: 0.7rem 0.9rem 0.9rem; }
+  .card .t { font-family: "Oswald", sans-serif; color: #e0b34a; letter-spacing: 0.06em; text-transform: uppercase; font-size: 0.95rem; }
+  .card .b { font-size: 0.95rem; line-height: 1.4; margin-top: 0.3rem; color: #b5b0a1; }
+  .card .s { float: right; color: #8d8672; font-size: 0.85rem; font-family: "Courier Prime", monospace; }
+  video { width: 100%; border-radius: 6px; display: block; background: #000; }
+  .takes { display: grid; gap: 1.5rem; margin-top: 1.4rem; }
+  .take h2 { font-family: "Oswald", sans-serif; font-size: 0.9rem; color: #e0b34a; font-weight: 500;
+             letter-spacing: 0.14em; text-transform: uppercase; margin: 0 0 0.5rem; }
+  .foot { margin-top: 2.2rem; color: #8d8672; font-size: 0.95rem; }
+  .share { font: inherit; font-size: 0.85rem; letter-spacing: 0.12em; text-transform: uppercase; cursor: pointer;
+           font-family: "Oswald", sans-serif; color: #43331f; background: #e9e1cb; border: 1.5px solid #43331f;
+           border-radius: 3px; padding: 0.4rem 1rem; margin: -0.6rem 0 0.4rem; }
+  .share:hover { background: #f2d27a; }
+  .share.done { background: #d8d2c0; }
+`;
+
+// The share button: the phone's own share sheet where there is one,
+// the clipboard everywhere else. The page URL is the canonical link.
+const SHARE_JS = `
+  var b = document.querySelector(".share");
+  b.addEventListener("click", function () {
+    var data = { title: b.dataset.title, text: b.dataset.text, url: location.origin + location.pathname };
+    if (navigator.share) { navigator.share(data).catch(function () {}); return; }
+    navigator.clipboard.writeText(data.url).then(function () {
+      b.textContent = "Link copied"; b.classList.add("done");
+      setTimeout(function () { b.textContent = "Share this clip"; b.classList.remove("done"); }, 1800);
+    });
+  });
+`;
+
+const shell = (metas: string[], body: string) => `<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<link rel="preconnect" href="https://fonts.googleapis.com">
+<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+<link href="https://fonts.googleapis.com/css2?family=Oswald:wght@400;500;600&family=Archivo+Narrow:wght@400;600&family=Courier+Prime&display=swap" rel="stylesheet">
+${metas.join("\n")}
+<style>${PAGE_CSS}</style>
+</head>
+<body><div class="wrap">${body}</div></body>
+</html>`;
+
+/** The 1200x630 share card cut by deploy/clips-prep.mjs, with the
+ * dimensions that let Facebook show it on the very first share. Falls
+ * back to the poster on a set that was never prepped. */
+function cardImageMetas(clip: ClipMeta, base: string): string[] {
+  const prepped = clip.width !== undefined;
+  const image = `${base}/clips/${clip.name}${prepped ? "-card" : ""}.jpg`;
+  return [
+    `<meta property="og:image" content="${image}"/>`,
+    ...(prepped ? [
+      `<meta property="og:image:width" content="1200"/>`,
+      `<meta property="og:image:height" content="630"/>`,
+    ] : []),
+    `<meta name="twitter:image" content="${image}"/>`,
+  ];
+}
+
+export function clipsIndexHtml(clips: ClipMeta[], base: string): string {
+  const metas = [
+    `<title>Wiz-War — clips from the labyrinth</title>`,
+    `<meta property="og:type" content="website"/>`,
+    `<meta property="og:site_name" content="Wiz-War"/>`,
+    `<meta property="og:title" content="Wiz-War — clips from the labyrinth"/>`,
+    `<meta property="og:description" content="Short scenes of magical combat in a stone maze: wormhole heists, warp snipers, ambushes, and the walls coming down — each seen through the wizard's own eyes and from the board above."/>`,
+    `<meta property="og:url" content="${base}/clips"/>`,
+    ...(clips[0] ? cardImageMetas(clips[0], base) : []),
+    `<meta name="twitter:card" content="summary_large_image"/>`,
+  ];
+  const cards = clips.map((c) => `
+    <a class="card" href="/clips/${c.name}">
+      <img src="/clips/${c.name}.jpg" alt="${esc(c.title)}" loading="lazy">
+      <div class="meta">
+        <span class="s">${c.seconds}s</span>
+        <span class="t">${esc(c.title)}</span>
+        <div class="b">${esc(c.blurb)}</div>
+      </div>
+    </a>`).join("\n");
+  const body = `
+    <nav class="mast"><a href="/">Wiz-War</a><span class="crumb">clips</span><a class="deal" href="/">deal yourself in →</a></nav>
+    <h1>Clips from the labyrinth</h1>
+    <p class="sub">Scenes of Wiz-War, played by the rules and filmed through the wizards' own eyes.
+      Each clip has a first-person take and a board take of the same moves.</p>
+    <div class="grid">${cards}</div>
+    <p class="foot">Wiz-War is Tom Jolly's classic of magical combat.
+      This is a fan-built table — <a href="/">deal yourself in</a>.</p>`;
+  return shell(metas, body);
+}
+
+export function clipPageHtml(clip: ClipMeta, base: string): string {
+  const metas = [
+    `<title>${esc(clip.title)} — a Wiz-War clip</title>`,
+    `<meta property="og:type" content="video.other"/>`,
+    `<meta property="og:site_name" content="Wiz-War"/>`,
+    `<meta property="og:title" content="${esc(clip.title)}"/>`,
+    `<meta property="og:description" content="${esc(clip.blurb)}"/>`,
+    `<meta property="og:url" content="${base}/clips/${clip.name}"/>`,
+    ...cardImageMetas(clip, base),
+    `<meta property="og:video" content="${base}/clips/${clip.name}-fpv.mp4"/>`,
+    `<meta property="og:video:secure_url" content="${base}/clips/${clip.name}-fpv.mp4"/>`,
+    `<meta property="og:video:type" content="video/mp4"/>`,
+    ...(clip.width && clip.height ? [
+      `<meta property="og:video:width" content="${clip.width}"/>`,
+      `<meta property="og:video:height" content="${clip.height}"/>`,
+    ] : []),
+    `<meta name="twitter:card" content="summary_large_image"/>`,
+  ];
+  const body = `
+    <nav class="mast"><a href="/">Wiz-War</a><span class="crumb"><a href="/clips">clips</a> / ${esc(clip.title)}</span><a class="deal" href="/">deal yourself in →</a></nav>
+    <h1><a href="/clips">${esc(clip.title)}</a></h1>
+    <p class="sub">${esc(clip.blurb)}</p>
+    <button class="share" type="button" data-title="${esc(clip.title)}" data-text="${esc(clip.blurb)}">Share this clip</button>
+    <div class="takes">
+      <div class="take">
+        <h2>Through the wizard's eyes</h2>
+        <video src="/clips/${clip.name}-fpv.mp4" poster="/clips/${clip.name}.jpg" controls playsinline></video>
+      </div>
+      <div class="take">
+        <h2>The same scene, from the board</h2>
+        <video src="/clips/${clip.name}-board.mp4" controls playsinline preload="metadata"></video>
+      </div>
+    </div>
+    <p class="foot">Played by the real rules engine — every move on screen is a legal move.
+      <a href="/">Deal yourself in</a>.</p>
+    <script>${SHARE_JS}</script>`;
+  return shell(metas, body);
+}

packages/server/src/index.ts

@@ -27,22 +27,18 @@
 //     {type:"chat", player, text, at}           one line of table talk
 //     {type:"watching", roomId}                 you are seated in the gallery
 //     {type:"audience", count}                  how many watch from the gallery
-//     {type:"transferCode"|"transferClaimed"|"catchUp"|"games"|"stats"|"feedbackReceived"}
+//     {type:"transferCode"|"transferClaimed"|"catchUp"|"games"|"stats"|"feedbackReceived"|"feedbackList"}
 //     {type:"error", message}
 
 import * as Sentry from "@sentry/node";
-// Errors only, no tracing: the box is small and the ledgers are the real
-// telemetry. Without a DSN in the environment this is entirely inert.
-if (process.env.SENTRY_DSN) {
-  Sentry.init({ dsn: process.env.SENTRY_DSN, environment: "production", tracesSampleRate: 0 });
-}
-
-import { createServer } from "node:http";
-import { readFileSync, existsSync, realpathSync } from "node:fs";
+import { createServer, type IncomingMessage, type ServerResponse } from "node:http";
+import { randomBytes } from "node:crypto";
+import { readFileSync, existsSync, realpathSync, statSync, createReadStream } from "node:fs";
 import { extname, join, normalize, sep } from "node:path";
 import { WebSocketServer, WebSocket } from "ws";
+import { cardDef } from "@wizwar/engine";
 import type { Command, PlayerId } from "@wizwar/engine";
-import {
+import { callKeeper, callRematch,
   catchUpSteps,
   momentSteps,
   claimTransferCode,
@@ -70,16 +66,32 @@ import {
   abandonRoom,
 } from "./rooms";
 import { engagementStats, recordHotseat } from "./stats";
-import { appendFeedback, readFeedback } from "./store";
-import { randomBytes } from "node:crypto";
+import { appendFeedback, readFeedback, readClips, clipAssetPath, CLIP_SLUG } from "./store";
+import { clipsIndexHtml, clipPageHtml } from "./clips";
+import { SlidingLimit, clientAddress } from "./ratelimit";
 import { getShare, loadShares, mintShare } from "./shares";
 import { renderSharePng } from "./ogimage";
 import { BOT_LINES, type BanterTrigger } from "./banter";
 
+// Errors only, no tracing: the box is small and the ledgers are the real
+// telemetry.
+if (process.env.SENTRY_DSN) {
+  Sentry.init({ dsn: process.env.SENTRY_DSN, environment: "production", tracesSampleRate: 0 });
+}
+
 // --- Abuse limits: this is a public server on a small box. -----------------
 const MAX_SOCKETS = 300;          // concurrent connections
 const MAX_ROOMS = 5000;           // total rooms on the server
 const MAX_ROOMS_PER_CONN = 10;    // rooms one connection may create
+// Per-address limits, held across reconnects: a table of friends never
+// nears them; a script filling the vault or the reports desk does.
+const roomsPerAddress = new SlidingLimit(12, 60 * 60 * 1000);
+/** Calls to the keeper: a real person's phone rings for each. */
+const challengesPerAddress = new SlidingLimit(3, 60 * 60 * 1000);
+/** The keeper of this table: the wizard a lobby may challenge. */
+const KEEPER = process.env.WIZWAR_KEEPER ?? "Kestrel";
+const PUBLIC_URL = (process.env.WIZWAR_PUBLIC_URL ?? "https://wizwar.kestrelsnest.social").replace(/\/$/, "");
+const reportsPerAddress = new SlidingLimit(6, 60 * 60 * 1000);
 const MAX_COMMAND_BYTES = 16384;  // serialized game command
 const MAX_MYGAMES_SEATS = 50;     // seats checked per myGames request
 const CATCHUP_COOLDOWN_MS = 3000; // full-game replays are CPU-heavy
@@ -178,15 +190,59 @@ function ogPage(metas: string[]): string {
 
 /** Host and proto arrive from request headers — attacker-writable text
  * that must never reach an HTML attribute raw. */
+const noSuchClip = (res: ServerResponse) =>
+  res.writeHead(404, { "content-type": "text/plain" }).end("no such clip — see /clips");
+
+/** The absolute origin a request came in on, as the proxy saw it. */
+function requestBase(req: IncomingMessage): string {
+  const proto = String(req.headers["x-forwarded-proto"] ?? "http").split(",")[0]!.trim();
+  return safeBase(String(req.headers.host ?? `localhost:${port}`), proto);
+}
+
 function safeBase(rawHost: string, rawProto: string): string {
   const proto = /^https?$/.test(rawProto) ? rawProto : "https";
   return `${proto}://${escapeHtml(rawHost)}`;
 }
 
+/** The turn's story in one line, for the share card: the deed a
+ * stranger would click to see, chosen by weight — a crown, a treasure
+ * carried home, a blow that landed, a spell cast — before the bare fact
+ * of whose turn it was. */
+function headlineOf(data: ShareData): string | null {
+  // A card retired since the share was written keeps its id as its name.
+  const name = (id: string | null) => { if (!id) return "a spell"; try { return cardDef(id).name; } catch { return id; } };
+  const deeds: { rank: number; text: string }[] = [];
+  const offer = (rank: number, text: string) => { deeds.push({ rank, text }); };
+  for (const step of data.steps) {
+    for (const e of step.events) {
+      switch (e.type) {
+        case "gameWon": offer(9, e.reason === "treasures" ? `${e.player} wins with two treasures home` : `${e.player} is the last wizard standing`); break;
+        case "playerEliminated": offer(8, e.reason === "killed" ? `${e.player} falls in the maze` : `${e.player} loses both treasures`); break;
+        case "treasureDropped": if (e.onHomeOf === e.player) offer(7, `${e.player} carries a stolen treasure home`); break;
+        case "treasurePickedUp": if (e.owner !== e.player) offer(5, `${e.player} snatches ${e.owner}'s treasure`); break;
+        case "attackResolved": if (e.damageDealt > 0) offer(6, `${e.attacker} hits ${e.defender} with ${name(e.attackCardId)} for ${e.damageDealt}`); else if (e.fullyStopped) offer(4, `${e.defender} stops ${e.attacker}'s ${name(e.attackCardId)} cold`); break;
+        case "punched": offer(3, `${e.attacker} punches ${e.target}`); break;
+        case "spellCast": offer(2, e.target ? `${e.caster} casts ${name(e.cardId)} at ${e.target}` : `${e.caster} casts ${name(e.cardId)}`); break;
+        case "jumpedPit": offer(3, `${e.player} leaps the pit`); break;
+        case "fellInPit": offer(3, `${e.player} falls into the pit`); break;
+        case "wardSprung": offer(4, `${e.owner}'s warded treasure bites ${e.victim}`); break;
+        case "slimeTrapSprung": offer(4, `the slime springs ${name(e.cardId)} on ${e.victim}`); break;
+        default: break;
+      }
+    }
+  }
+  let best: { rank: number; text: string } | null = null;
+  for (const d of deeds) if (!best || d.rank > best.rank) best = d;
+  return best?.text ?? null;
+}
+
 function shareHtml(id: string, data: ShareData, rawHost: string, rawProto: string): string {
   const base = safeBase(rawHost, rawProto);
+  const headline = data.whole ? null : headlineOf(data);
   const title = data.whole
     ? "The whole tale — a game of Wiz-War, replayed"
+    : headline
+      ? `${escapeHtml(headline)} — a Wiz-War instant replay`
       : `${escapeHtml(data.actor)}'s turn — a Wiz-War instant replay`;
   const desc = data.whole
     ? `A full game of Wiz-War, magical combat in a stone labyrinth — every turn through its wizard's own eyes${data.actor ? `, to ${escapeHtml(data.actor)}'s triumph` : ""}. Watch it all, then deal yourself in.`
@@ -274,7 +330,10 @@ const httpServer = createServer((req, res) => {
         "cache-control": "public, max-age=60",
         "access-control-allow-origin": "*",
       });
-      res.end(JSON.stringify({ steps: data.steps, actor: data.actor, round: data.round, whole: data.whole === true }));
+      res.end(JSON.stringify({
+        steps: data.steps, actor: data.actor, round: data.round, whole: data.whole === true,
+        headline: data.whole ? null : headlineOf(data),
+      }));
       return;
     }
     const watch = url.match(/^\/watch\/([a-z0-9]{4,20})(\/og\.png)?$/);
@@ -302,6 +361,58 @@ const httpServer = createServer((req, res) => {
       res.end(shareHtml(watch[1]!, data, hostname, proto));
       return;
     }
+    // The clip gallery: standalone pages and their media. Video ships
+    // with Range support — Safari refuses an mp4 whose server can't
+    // serve bytes 0-1 on demand.
+    if (url === "/clips" || url === "/clips/") {
+      const base = requestBase(req);
+      res.writeHead(200, { "content-type": "text/html", "cache-control": "no-cache" });
+      res.end(clipsIndexHtml(readClips(), base));
+      return;
+    }
+    const clipAsset = url.match(/^\/clips\/([^/]+\.(?:mp4|jpg))$/);
+    if (clipAsset) {
+      const path = clipAssetPath(clipAsset[1]!);
+      if (!path) { noSuchClip(res); return; }
+      const size = statSync(path).size;
+      const type = path.endsWith(".mp4") ? "video/mp4" : "image/jpeg";
+      const range = /^bytes=(\d*)-(\d*)$/.exec(String(req.headers.range ?? ""));
+      const head: Record<string, string> = {
+        "content-type": type,
+        "accept-ranges": "bytes",
+        "cache-control": "public, max-age=3600",
+      };
+      if (range && (range[1] || range[2])) {
+        const start = range[1] ? Number(range[1]) : Math.max(0, size - Number(range[2]));
+        const end = range[1] && range[2] ? Math.min(Number(range[2]), size - 1) : size - 1;
+        if (start > end || start >= size) {
+          res.writeHead(416, { "content-range": `bytes */${size}` }).end();
+          return;
+        }
+        res.writeHead(206, { ...head,
+          "content-range": `bytes ${start}-${end}/${size}`,
+          "content-length": String(end - start + 1) });
+        if (req.method === "HEAD") { res.end(); return; }
+        createReadStream(path, { start, end }).pipe(res);
+        return;
+      }
+      res.writeHead(200, { ...head, "content-length": String(size) });
+      if (req.method === "HEAD") { res.end(); return; }
+      createReadStream(path).pipe(res);
+      return;
+    }
+    const clipPage = url.match(/^\/clips\/([^/]+)$/);
+    if (clipPage && CLIP_SLUG.test(clipPage[1]!)) {
+      const clip = readClips().find((c) => c.name === clipPage[1]);
+      if (clip) {
+        const base = requestBase(req);
+        res.writeHead(200, { "content-type": "text/html", "cache-control": "no-cache" });
+        res.end(clipPageHtml(clip, base));
+        return;
+      }
+      noSuchClip(res);
+      return;
+    }
     // Room invitations: a living room gets its recruiting card; a dead
     // code falls through to the app, which reports it in the lobby.
     const invite = url.match(/^\/join\/([A-Za-z0-9]{4})$/);
@@ -320,7 +431,14 @@ const httpServer = createServer((req, res) => {
       res.writeHead(403).end();
       return;
     }
-    if (!existsSync(file)) file = join(staticRoot, "index.html"); // SPA fallback
+    if (!existsSync(file)) {
+      // A hashed asset that is gone is gone: a page built before the last
+      // deploy asking for its old chunk gets a plain 404 it can act on,
+      // never the app shell as text/html. Every other unknown path is the
+      // app's to route.
+      if (url.startsWith("/assets/")) { res.writeHead(404, { "content-type": "text/plain" }).end("gone"); return; }
+      file = join(staticRoot, "index.html");
+    }
     // Resolve symlinks and re-verify the real location stays inside the root.
     const real = realpathSync(file);
     if (real !== staticRoot && !real.startsWith(staticRoot + sep)) {
@@ -354,6 +472,8 @@ interface Session {
   spectator: boolean;
   /** The raw seat token this connection authenticated with (memory only). */
   token: string | null;
+  /** Where the connection came from, for the per-address limits. */
+  address: string;
   claimFails: number;
   // Token bucket: refills at 15 msg/s up to a burst of 30.
   bucket: number;
@@ -406,6 +526,11 @@ function roomInfo(room: Room) {
     hostId: room.hostId,
     started: room.state !== null,
     audience: audienceCount(room),
+    rematch: room.rematch ?? null,
+    expected: room.expected ?? [],
+    expansion: room.expansion,
+    challenge: room.challenge ?? null,
+    keeper: KEEPER,
     colors: Object.fromEntries(room.colorChoices),
     bots: Object.fromEntries(
       // A mystery machine keeps its mood only while the game lives: once it
@@ -524,7 +649,7 @@ function broadcastRoomState(room: Room): void {
   }
 }
 
-wss.on("connection", (socket) => {
+wss.on("connection", (socket, req) => {
   if (sessions.size >= MAX_SOCKETS) {
     send(socket, { type: "error", message: "the tavern is packed — try again shortly" });
     socket.close();
@@ -532,6 +657,7 @@ wss.on("connection", (socket) => {
   }
   const session: Session = {
     socket, playerId: null, roomId: null, spectator: false, token: null, claimFails: 0,
+    address: clientAddress(req.headers, req.socket.remoteAddress),
     bucket: 30, lastRefill: Date.now(), overLimitStrikes: 0,
     roomsCreated: 0, lastCatchUpAt: 0, hotseatReports: 0,
   };
@@ -571,6 +697,9 @@ wss.on("connection", (socket) => {
           if (session.roomsCreated >= MAX_ROOMS_PER_CONN || roomCount() >= MAX_ROOMS) {
             return send(socket, { type: "error", message: "no new rooms right now — try again later" });
           }
+          if (!roomsPerAddress.allow(session.address)) {
+            return send(socket, { type: "error", message: "that's a lot of new tables from one place — try again in an hour" });
+          }
           session.roomsCreated++;
           leaveGallery(session);
           const { room, token } = createRoom(name);
@@ -588,7 +717,12 @@ wss.on("connection", (socket) => {
           const room = getRoom(roomId);
           if (!room) return send(socket, { type: "error", message: "no such room" });
           const result = joinRoom(room, name, typeof msg.token === "string" ? msg.token : null);
-          if ("error" in result) return send(socket, { type: "error", message: result.error });
+          if ("error" in result) {
+            // A refused seat is worth a line: a lost seat mid-game is the
+            // costliest quiet failure this table has.
+            console.warn(`join refused: room ${room.id} name ${JSON.stringify(name)} — ${result.error}`);
+            return send(socket, { type: "error", message: result.error });
+          }
           leaveGallery(session);
           session.playerId = name;
           session.roomId = room.id;
@@ -599,11 +733,40 @@ wss.on("connection", (socket) => {
           // from firing again on every return to the room.
           if (room.state) {
             send(socket, { type: "events", events: redactFor(room.events, name), replayed: true });
+          } else if (room.chat.length > 0) {
+            // The lobby's talk so far, for whoever just sat down.
+            send(socket, { type: "events", events: room.chat.map((c) => ({ type: "tableTalk", player: c.player, text: c.text })), replayed: true });
           }
           broadcastRoomState(room);
           runBots(room);
           break;
         }
+        case "challengeKeeper": {
+          const room = session.roomId ? getRoom(session.roomId) : undefined;
+          if (!room || !session.playerId) return send(socket, { type: "error", message: "not in a room" });
+          if (!challengesPerAddress.allow(session.address)) {
+            return send(socket, { type: "error", message: "the keeper has been called enough from here for one hour" });
+          }
+          const called = callKeeper(room, session.playerId, KEEPER);
+          if ("error" in called) return send(socket, { type: "error", message: called.error });
+          // The alarm the keeper listens for: one issue per room, so each
+          // call rings once, with the door in the message. Error level,
+          // because Sentry's alerts ring for high-priority issues and a
+          // warning is filed as medium — a bell nobody hears.
+          const link = `${PUBLIC_URL}/join/${room.id}`;
+          if (process.env.SENTRY_DSN) {
+            Sentry.captureMessage(`${session.playerId} challenges ${KEEPER} to a game — ${link}`, {
+              level: "error",
+              fingerprint: ["challenge", room.id],
+              tags: { room: room.id, challenger: session.playerId },
+              extra: { link, players: room.players.join(", ") },
+            });
+          }
+          const said = addChat(room, session.playerId, `calls ${KEEPER} to the table`);
+          if (!("error" in said)) broadcast(room, () => ({ type: "chat", player: session.playerId, text: said.text, at: said.at }));
+          broadcastRoomState(room);
+          break;
+        }
         case "watch": {
           // The Peanut Gallery: no name, no seat, no ledger line — a pure
           // reader of the public broadcast, counted but never identified.
@@ -721,6 +884,30 @@ wss.on("connection", (socket) => {
           broadcast(room, () => ({ type: "chat", player: session.playerId, text: result.text, at: result.at }));
           break;
         }
+        case "rematch": {
+          // Anyone at a finished table may call; the caller lands in the
+          // new lobby, and the old table hears where it went.
+          const room = session.roomId ? getRoom(session.roomId) : undefined;
+          if (!room || !session.playerId) return send(socket, { type: "error", message: "not in a room" });
+          const called = callRematch(room, session.playerId);
+          if ("error" in called) return send(socket, { type: "error", message: called.error });
+          const next = getRoom(called.roomId);
+          if (!next) return send(socket, { type: "error", message: "the rematch room is gone" });
+          let token = called.token;
+          if (!token) {
+            const joined = joinRoom(next, session.playerId, null);
+            if ("error" in joined) return send(socket, { type: "error", message: joined.error });
+            token = joined.token;
+          }
+          if (called.created) broadcast(room, () => ({ type: "rematch", roomId: room.id, to: next.id, by: session.playerId }));
+          leaveGallery(session);
+          send(socket, { type: "rematched", roomId: next.id });
+          session.roomId = next.id;
+          session.token = token;
+          send(socket, { type: "seat", playerId: session.playerId, token });
+          broadcastRoomState(next);
+          break;
+        }
         case "chat": {
           const room = session.roomId ? getRoom(session.roomId) : undefined;
           if (!room || !session.playerId) return send(socket, { type: "error", message: "not in a room" });
@@ -813,6 +1000,9 @@ wss.on("connection", (socket) => {
             String(raw ?? "").replace(/[\u0000-\u0009\u000b-\u001f\u007f]/g, " ").trim().slice(0, 2000);
           const happened = clean(msg.happened);
           if (!happened) return send(socket, { type: "error", message: "say what happened" });
+          if (!reportsPerAddress.allow(session.address)) {
+            return send(socket, { type: "error", message: "the desk has plenty from you for now — more in an hour" });
+          }
           appendFeedback({
             id: randomBytes(4).toString("hex"),
             at: new Date().toISOString(),
@@ -880,6 +1070,7 @@ wss.on("connection", (socket) => {
             const result = peekSummary(roomId, name, typeof seat.token === "string" ? seat.token : null);
             if (result === null) continue;
             if (result === "badToken") {
+              console.warn(`seat voided: room ${roomId} name ${JSON.stringify(name)} — the token did not match`);
               voided.push(`${roomId}:${name}`);
               continue;
             }

packages/server/src/ratelimit.ts

@@ -0,0 +1,47 @@
+// A per-key sliding-window limiter for the two doors anyone may walk
+// through unseated: creating rooms and filing reports. Per-connection
+// caps reset on reconnect; these are keyed by client address and hold
+// for the window. Memory is bounded by pruning keys whose windows have
+// emptied.
+
+export class SlidingLimit {
+  private hits = new Map<string, number[]>();
+  private lastSweep = 0;
+
+  constructor(private readonly max: number, private readonly windowMs: number) {}
+
+  /** Record a hit for `key` if it is under the limit; false if it is not. */
+  allow(key: string, now = Date.now()): boolean {
+    this.sweep(now);
+    const cutoff = now - this.windowMs;
+    const times = (this.hits.get(key) ?? []).filter((t) => t > cutoff);
+    if (times.length >= this.max) { this.hits.set(key, times); return false; }
+    times.push(now);
+    this.hits.set(key, times);
+    return true;
+  }
+
+  private sweep(now: number): void {
+    if (now - this.lastSweep < this.windowMs) return;
+    this.lastSweep = now;
+    const cutoff = now - this.windowMs;
+    for (const [k, times] of this.hits) {
+      if (!times.some((t) => t > cutoff)) this.hits.delete(k);
+    }
+  }
+}
+
+const LOOPBACK = new Set(["127.0.0.1", "::1", "::ffff:127.0.0.1"]);
+
+/** The client's address as Caddy reports it. The proxy APPENDS the true
+ * peer to X-Forwarded-For, so the last entry is the trustworthy one; a
+ * client can write anything into the first. And the header is believed
+ * only when the socket peer is the proxy itself (loopback) — reached
+ * any other way, the peer address is the client. */
+export function clientAddress(headers: Record<string, string | string[] | undefined>, remote: string | undefined): string {
+  const peer = remote || "unknown";
+  if (!LOOPBACK.has(peer)) return peer;
+  const fwd = headers["x-forwarded-for"];
+  const parts = (Array.isArray(fwd) ? fwd.join(",") : fwd ?? "").split(",").map((s) => s.trim()).filter(Boolean);
+  return parts[parts.length - 1] || peer;
+}

packages/server/src/rooms.ts

@@ -22,7 +22,7 @@ import {
   type PlayerId,
   CURRENT_RULES_REV,
 } from "@wizwar/engine";
-import { appendLine, archiveRoomFile, countRoomFiles, ensureDataDir, readAllRooms, readRoom, roomFileExists, type RoomLine } from "./store";
+import { appendLine, archiveRoomFile, countRoomFiles, ensureDataDir, ledgerStat, listRoomIds, readRoom, readStubFile, roomFileExists, writeStubFile, type RoomLine } from "./store";
 import { recordRoom } from "./stats";
 
 export interface LoggedCommand {
@@ -52,6 +52,12 @@ export interface Room {
   bots: Map<PlayerId, { style: AutomatonStyle; secret: boolean; tier: AutomatonTier }>;
   /** Last time anything looked at this room (memory eviction clock). */
   touchedAt?: number;
+  /** A finished table that called for a rematch: where it went, and who called. */
+  rematch?: { roomId: string; by: PlayerId };
+  /** A rematch lobby: the wizards of the last table who have not yet sat. */
+  expected?: PlayerId[];
+  /** The table called the keeper of this site to a seat, and by whom. */
+  challenge?: { by: PlayerId; at: string };
 }
 
 const rooms = new Map<string, Room>();
@@ -91,7 +97,10 @@ export function runningRooms(): Room[] {
   return [...rooms.values()].filter((r) => r.state && r.state.phase === "playing");
 }
 
-export function createRoom(hostId: PlayerId): { room: Room; token: string } {
+export function createRoom(
+  hostId: PlayerId,
+  rematch?: { of: string; expected: PlayerId[]; expansion: boolean },
+): { room: Room; token: string } {
   const token = randomBytes(16).toString("hex");
   const room: Room = {
     id: makeRoomCode(),
@@ -99,7 +108,7 @@ export function createRoom(hostId: PlayerId): { room: Room; token: string } {
     players: [hostId],
     tokens: new Map([[hostId, hashToken(token)]]),
     seed: randomInt(0, 0xffffffff),
-    expansion: false,
+    expansion: rematch?.expansion ?? false,
     colorChoices: new Map(),
     createdAt: new Date().toISOString(),
     state: null,
@@ -108,6 +117,7 @@ export function createRoom(hostId: PlayerId): { room: Room; token: string } {
     chat: [],
     bots: new Map(),
     touchedAt: Date.now(),
+    ...(rematch ? { expected: [...rematch.expected] } : {}),
   };
   rooms.set(room.id, room);
   recordRoom(room);
@@ -118,10 +128,45 @@ export function createRoom(hostId: PlayerId): { room: Room; token: string } {
     hostTokenHash: hashToken(token),
     seed: room.seed,
     createdAt: new Date().toISOString(),
+    ...(rematch ? { rematchOf: rematch.of, expected: rematch.expected, expansion: rematch.expansion } : {}),
   });
   return { room, token };
 }
 
+/** A lobby calls the keeper to the table: a seat is held under their
+ * name, the call is written to the ledger, and the caller (index.ts)
+ * raises the alarm the keeper listens for. Once per room. */
+export function callKeeper(room: Room, byId: PlayerId, keeper: PlayerId): { at: string } | { error: string } {
+  if (room.state) return { error: "the game has started" };
+  if (!room.players.includes(byId) || room.bots.has(byId)) return { error: "take a seat first" };
+  if (room.challenge) return { error: `${keeper} has already been called to this table` };
+  if (room.players.includes(keeper)) return { error: `${keeper} is already here` };
+  if (room.players.length + (room.expected?.length ?? 0) >= 6) return { error: "the table is full" };
+  const at = new Date().toISOString();
+  room.challenge = { by: byId, at };
+  room.expected = [...(room.expected ?? []).filter((n) => n !== keeper), keeper];
+  appendLine(room.id, { kind: "challenge", by: byId, at });
+  return { at };
+}
+
+/** A finished table calls for a rematch: a new room with the same
+ * clockwork at the same tiers and the same expansion setting, waiting for
+ * the same humans. The first caller hosts it; anyone at the old table may
+ * call, and a second call finds the room already made. */
+export function callRematch(
+  room: Room, byId: PlayerId,
+): { roomId: string; token: string | null; created: boolean } | { error: string } {
+  if (room.state?.phase !== "finished") return { error: "the game is not over yet" };
+  if (!room.players.includes(byId) || room.bots.has(byId)) return { error: "only a wizard of this table may call a rematch" };
+  if (room.rematch) return { roomId: room.rematch.roomId, token: null, created: false };
+  const humans = room.players.filter((p) => !room.bots.has(p) && p !== byId);
+  const { room: next, token } = createRoom(byId, { of: room.id, expected: humans, expansion: room.expansion });
+  for (const [, b] of room.bots) addAutomaton(next, b.secret ? undefined : b.style, b.tier);
+  room.rematch = { roomId: next.id, by: byId };
+  appendLine(room.id, { kind: "rematch", to: next.id, by: byId, at: new Date().toISOString() });
+  return { roomId: next.id, token, created: true };
+}
+
 export function getRoom(id: string): Room | undefined {
   const code = id.toUpperCase();
   const live = rooms.get(code);
@@ -159,9 +204,16 @@ export function evictIdleRooms(hasSockets: (roomId: string) => boolean): number
     const idle = now - (room.touchedAt ?? now);
     const allowance = room.state?.phase === "finished" ? FINISHED_MS : IDLE_MS;
     if (idle < allowance) continue;
-    sleepingStubs.set(id, stubOf(room));
+    const stub = stubOf(room);
+    sleepingStubs.set(id, stub);
     rooms.delete(id);
     evicted++;
+    try {
+      const stat = ledgerStat(id);
+      if (stat) writeStubFile(id, stat.bytes, toStored(stub));
+    } catch (e) {
+      console.error(`could not write stub for ${id}:`, e);
+    }
   }
   return evicted;
 }
@@ -176,6 +228,10 @@ interface RoomStub {
   base: Omit<GameSummary, "name" | "yourTurn" | "attention">;
 }
 const sleepingStubs = new Map<string, RoomStub>();
+/** A stub as it rests on disk — the token map spelled as an object. */
+type StoredStub = Omit<RoomStub, "tokens"> & { tokens: Record<PlayerId, string> };
+const toStored = (stub: RoomStub): StoredStub => ({ ...stub, tokens: Object.fromEntries(stub.tokens) });
+const fromStored = (stored: StoredStub): RoomStub => ({ ...stored, tokens: new Map(Object.entries(stored.tokens)) });
 
 function stubOf(room: Room): RoomStub {
   const { active, turnHolder, waitKind } = turnFacts(room.state);
@@ -184,7 +240,13 @@ function stubOf(room: Room): RoomStub {
     turnHolder,
     waitKind,
     playing: room.state?.phase === "playing",
-    base: {
+    base: baseSummary(room, active),
+  };
+}
+
+/** The per-room half of a summary — everything except whose turn it is. */
+function baseSummary(room: Room, active: PlayerId | null): Omit<GameSummary, "name" | "yourTurn" | "attention"> {
+  return {
     roomId: room.id,
     players: [...room.players],
     started: room.state !== null,
@@ -194,7 +256,7 @@ function stubOf(room: Room): RoomStub {
     round: room.state?.turn.round ?? null,
     lastMoveAt: room.log.length > 0 ? room.log[room.log.length - 1]!.at : null,
     chatCount: room.chat.length,
-    },
+    rematch: room.rematch ?? null,
   };
 }
 
@@ -232,6 +294,8 @@ export function joinRoom(
   const fresh = randomBytes(16).toString("hex");
   room.players.push(playerId);
   room.tokens.set(playerId, hashToken(fresh));
+  // An expected wizard who sits is expected no longer.
+  if (room.expected?.includes(playerId)) room.expected = room.expected.filter((n) => n !== playerId);
   appendLine(room.id, { kind: "join", name: playerId, tokenHash: hashToken(fresh) });
   recordRoom(room);
   return { token: fresh };
@@ -390,6 +454,7 @@ function actingSeat(room: Room): PlayerId | null {
   if (!s || s.phase !== "playing") return null;
   return (
     s.wardPending?.ownerId ??
+    s.pushPending?.pusheeId ??
     s.slowDeathPending?.playerId ??
     s.stack?.waitingOn ??
     s.pendingDiscard ??
@@ -450,18 +515,26 @@ export interface GameSummary {
   lastMoveAt: string | null;
   /** Total table-talk messages; the client tracks which it has seen. */
   chatCount: number;
+  /** A finished table that moved on: the rematch room and who called it. */
+  rematch?: { roomId: string; by: PlayerId } | null;
 }
 
-/** A seat-holder's one-line view of a room, for the lobby ledger. */
-/** Who holds the table's attention, and why — the summary's turn facts. */
+/** Who holds the table's attention, and why — the summary's turn facts.
+ * The priority order is actingSeat's: a hanging ward or slow-death window
+ * outranks the stack, which outranks the turn itself. */
 function turnFacts(s: GameState | null): {
   active: PlayerId | null;
   turnHolder: PlayerId | null;
   waitKind: "counteract" | "discard" | "interrupt" | null;
 } {
   const active = s && s.phase === "playing" ? s.players[s.turn.activeIndex]!.id : null;
-  const waitingOn = s?.stack?.waitingOn ?? s?.pendingDiscard ?? s?.chaosPending?.queue[0] ?? s?.outOfTurnWindow?.playerId ?? null;
+  const waitingOn = s?.wardPending?.ownerId ?? s?.pushPending?.pusheeId ?? s?.slowDeathPending?.playerId ??
+    s?.stack?.waitingOn ?? s?.pendingDiscard ?? s?.chaosPending?.queue[0] ??
+    s?.outOfTurnWindow?.playerId ?? null;
   const waitKind = s == null ? null
+    : s.wardPending != null ? "counteract" as const
+    : s.pushPending != null ? "counteract" as const
+    : s.slowDeathPending != null ? "counteract" as const
     : s.stack?.waitingOn != null ? "counteract" as const
     : s.pendingDiscard != null ? "discard" as const
     : s.chaosPending?.queue[0] != null ? "counteract" as const
@@ -470,23 +543,15 @@ function turnFacts(s: GameState | null): {
   return { active, turnHolder: waitingOn ?? active, waitKind };
 }
 
+/** A seat-holder's one-line view of a room, for the lobby ledger. */
 export function summarize(room: Room, playerId: PlayerId): GameSummary {
-  const s = room.state;
-  const { active, turnHolder, waitKind } = turnFacts(s);
-  const yourTurn = s?.phase === "playing" && turnHolder === playerId;
+  const { active, turnHolder, waitKind } = turnFacts(room.state);
+  const yourTurn = room.state?.phase === "playing" && turnHolder === playerId;
   return {
-    roomId: room.id,
+    ...baseSummary(room, active),
     name: playerId,
-    players: [...room.players],
-    started: s !== null,
-    finished: s?.phase === "finished",
-    winner: s?.winner ?? null,
-    activePlayerId: active,
     yourTurn,
     attention: yourTurn ? (waitKind ?? "turn") : null,
-    round: s?.turn.round ?? null,
-    lastMoveAt: room.log.length > 0 ? room.log[room.log.length - 1]!.at : null,
-    chatCount: room.chat.length,
   };
 }
 
@@ -728,6 +793,8 @@ function rebuildRoom(id: string, lines: RoomLine[]): Room | null {
     chat: [],
     bots: new Map(),
     touchedAt: Date.now(),
+    ...(meta.expected ? { expected: [...meta.expected] } : {}),
+    ...(meta.expansion !== undefined ? { expansion: meta.expansion } : {}),
   };
   if (lines.some((l) => l.kind === "abandon")) return null;
   for (const line of lines.slice(1)) {
@@ -751,10 +818,17 @@ function rebuildRoom(id: string, lines: RoomLine[]): Room | null {
         if (!joinHash) throw new Error("join line has no token");
         room.players.push(line.name);
         room.tokens.set(line.name, joinHash);
+        if (room.expected?.includes(line.name)) room.expected = room.expected.filter((n) => n !== line.name);
       }
     } else if (line.kind === "start") {
       const r = startInMemory(room, line.expansion, line.colors, line.deckRev);
       if ("error" in r) throw new Error(`replay start failed: ${r.error}`);
+    } else if (line.kind === "rematch") {
+      room.rematch = { roomId: line.to, by: line.by };
+    } else if (line.kind === "challenge") {
+      room.challenge = { by: line.by, at: line.at };
+      const keeper = process.env.WIZWAR_KEEPER ?? "Kestrel";
+      if (!room.players.includes(keeper)) room.expected = [...(room.expected ?? []).filter((n) => n !== keeper), keeper];
     } else if (line.kind === "chat") {
       // File order preserves the interleaving with commands.
       room.chat.push({ player: line.player, text: line.text, at: line.at });
@@ -771,14 +845,29 @@ function rebuildRoom(id: string, lines: RoomLine[]): Room | null {
   return room;
 }
 
-/** Rebuild every persisted room by replaying its file. */
+/** Bring the rooms back after a restart. A room whose stub still matches
+ * its ledger sleeps on, answering the games ledger from the stub; the
+ * rest are replayed, with the eviction clock set to their last line so
+ * the first sweep puts the long-idle ones back to bed. */
 export function loadPersistedRooms(): void {
   ensureDataDir();
   let restored = 0;
-  for (const [id, lines] of readAllRooms()) {
+  let asleep = 0;
+  for (const id of listRoomIds()) {
+    const stat = ledgerStat(id);
+    if (!stat) continue;
+    const stored = readStubFile<StoredStub>(id);
+    if (stored && stored.bytes === stat.bytes) {
+      sleepingStubs.set(id, fromStored(stored.stub));
+      asleep++;
+      continue;
+    }
+    const lines = readRoom(id);
+    if (!lines) continue;
     try {
       const room = rebuildRoom(id, lines);
       if (!room) continue;
+      room.touchedAt = stat.mtimeMs;
       rooms.set(id, room);
       recordRoom(room);
       restored++;
@@ -786,5 +875,5 @@ export function loadPersistedRooms(): void {
       console.error(`could not restore room ${id}:`, e);
     }
   }
-  if (restored > 0) console.log(`restored ${restored} room(s) from disk`);
+  if (restored + asleep > 0) console.log(`restored ${restored} room(s) from disk, ${asleep} left sleeping`);
 }

packages/server/src/shares.ts

@@ -5,7 +5,7 @@
 import { appendFileSync, existsSync, readFileSync } from "node:fs";
 import { join } from "node:path";
 import { randomInt } from "node:crypto";
-import { statsDir } from "./store";
+import { dataRoot } from "./store";
 
 export interface Share {
   id: string;
@@ -20,7 +20,7 @@ const SHARE_ID_LENGTH = 10; // 31^10 ≈ 8×10^14 — unguessable, typeable
 const shares = new Map<string, Share>();
 
 function sharesFile(): string {
-  return join(statsDir(), "shares.jsonl");
+  return join(dataRoot(), "shares.jsonl");
 }
 
 export function loadShares(): void {

packages/server/src/stats.ts

@@ -6,7 +6,7 @@
 
 import { readFileSync, renameSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
-import { statsDir } from "./store";
+import { dataRoot } from "./store";
 import type { Room } from "./rooms";
 
 export interface EngagementStats {
@@ -35,7 +35,7 @@ interface StatsFile extends Omit<EngagementStats, "wizardsSeated"> {
   roomStages: Record<string, "created" | "started" | "finished">;
 }
 
-const FILE = () => join(statsDir(), "stats.json");
+const FILE = () => join(dataRoot(), "stats.json");
 
 let data: StatsFile = {
   gamesCreated: 0, gamesStarted: 0, gamesFinished: 0,

packages/server/src/store.ts

@@ -3,7 +3,7 @@
 // command. Because the engine is deterministic, replaying a file rebuilds
 // the exact game state — server restarts lose nothing.
 
-import { appendFileSync, existsSync, mkdirSync, readdirSync, readFileSync, renameSync } from "node:fs";
+import { appendFileSync, existsSync, mkdirSync, readdirSync, readFileSync, renameSync, statSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 
 export interface RoomMetaLine {
@@ -16,6 +16,26 @@ export interface RoomMetaLine {
   hostToken?: string;
   seed: number;
   createdAt: string;
+  /** A rematch: the finished room it follows, and the wizards it waits for. */
+  rematchOf?: string;
+  expected?: string[];
+  /** The lobby's expansion default, carried over from the last table. */
+  expansion?: boolean;
+}
+
+/** A table called the keeper: the seat is held and the keeper told. */
+export interface ChallengeLine {
+  kind: "challenge";
+  by: string;
+  at: string;
+}
+
+/** The finished table called for a rematch: the new room it moved to. */
+export interface RematchLine {
+  kind: "rematch";
+  to: string;
+  by: string;
+  at: string;
 }
 
 export interface JoinLine {
@@ -71,7 +91,7 @@ export interface AbandonLine {
   at: string;
 }
 
-export type RoomLine = RoomMetaLine | JoinLine | StartLine | CommandLine | ChatLine | KickLine | AbandonLine;
+export type RoomLine = RoomMetaLine | JoinLine | StartLine | CommandLine | ChatLine | KickLine | AbandonLine | RematchLine | ChallengeLine;
 
 const DATA_DIR = process.env.WIZWAR_DATA_DIR ?? join(process.cwd(), "data", "rooms");
 
@@ -86,8 +106,10 @@ function fileFor(roomId: string): string {
   return join(DATA_DIR, `${roomId}.jsonl`);
 }
 
-/** Directory holding stats.json — the parent of the rooms dir. */
-export function statsDir(): string {
+/** The data root — the parent of the rooms dir — where everything that
+ * is not a room ledger lives: stats, feedback, stubs, the graveyard, the
+ * clip vault. */
+export function dataRoot(): string {
   return join(DATA_DIR, "..");
 }
 
@@ -128,34 +150,65 @@ export function countRoomFiles(): number {
   return readdirSync(DATA_DIR).filter((f) => f.endsWith(".jsonl")).length;
 }
 
-/** Read every persisted room's lines, keyed by room id. */
-export function readAllRooms(): Map<string, RoomLine[]> {
+/** Every room with a ledger on disk. */
+export function listRoomIds(): string[] {
   ensureDataDir();
-  const rooms = new Map<string, RoomLine[]>();
-  for (const file of readdirSync(DATA_DIR)) {
-    if (!file.endsWith(".jsonl")) continue;
-    const id = file.slice(0, -".jsonl".length);
+  return readdirSync(DATA_DIR).filter((f) => f.endsWith(".jsonl")).map((f) => f.slice(0, -".jsonl".length));
+}
+
+/** A ledger's size and the moment of its last line. */
+export function ledgerStat(roomId: string): { bytes: number; mtimeMs: number } | null {
+  if (!safeRoomId(roomId)) return null;
+  const file = fileFor(roomId);
+  if (!existsSync(file)) return null;
+  const st = statSync(file);
+  return { bytes: st.size, mtimeMs: st.mtimeMs };
+}
+
+// --- Stubs of sleeping rooms. ---------------------------------------------
+// A room put to sleep leaves a stub beside the ledgers: what the games
+// ledger needs to answer for it, and the ledger's size at that moment. A
+// ledger only ever grows, so at boot a stub whose size still matches is
+// the room's whole truth and the room stays asleep, unreplayed.
+
+const stubDir = () => join(dataRoot(), "stubs");
+function stubFor(roomId: string): string {
+  if (!safeRoomId(roomId)) throw new Error(`unsafe room id: ${JSON.stringify(roomId)}`);
+  return join(stubDir(), `${roomId}.json`);
+}
+
+export function readStubFile<T>(roomId: string): { bytes: number; stub: T } | null {
+  if (!safeRoomId(roomId)) return null;
+  const file = stubFor(roomId);
+  if (!existsSync(file)) return null;
   try {
-      const lines = readFileSync(join(DATA_DIR, file), "utf8")
-        .split("\n")
-        .filter((l) => l.trim().length > 0)
-        .map((l) => JSON.parse(l) as RoomLine);
-      if (lines.length > 0 && lines[0]!.kind === "meta") rooms.set(id, lines);
+    const parsed = JSON.parse(readFileSync(file, "utf8")) as { bytes: number; stub: T };
+    return typeof parsed.bytes === "number" && parsed.stub ? parsed : null;
   } catch (e) {
-      console.error(`skipping unreadable room file ${file}:`, e);
+    console.error(`unreadable stub file ${roomId}:`, e);
+    return null;
   }
 }
-  return rooms;
+
+export function writeStubFile<T>(roomId: string, bytes: number, stub: T): void {
+  const file = stubFor(roomId);
+  mkdirSync(stubDir(), { recursive: true });
+  writeFileSync(file + ".tmp", JSON.stringify({ bytes, stub }), "utf8");
+  renameSync(file + ".tmp", file);
 }
 
 /** Player surprise reports and the wizards' replies share one JSONL file
  * beside the rooms directory — a report line carries roomId/seq pinning
  * its moment; a reply line carries reportId/status/text and folds onto
  * its report when read. Legacy reports without an id answer to their
- * timestamp. */
+ * timestamp. A report line may carry fields (deckRev, player context)
+ * that only the operator's raw read uses; readFeedback keeps the
+ * player-facing subset. */
+const feedbackFile = () => join(dataRoot(), "feedback.jsonl");
+
 export function appendFeedback(entry: Record<string, unknown>): void {
   ensureDataDir();
-  appendFileSync(join(DATA_DIR, "..", "feedback.jsonl"), JSON.stringify(entry) + "\n", "utf8");
+  appendFileSync(feedbackFile(), JSON.stringify(entry) + "\n", "utf8");
 }
 
 export interface FeedbackReport {
@@ -171,7 +224,7 @@ export interface FeedbackReport {
 }
 
 export function readFeedback(): FeedbackReport[] {
-  const file = join(DATA_DIR, "..", "feedback.jsonl");
+  const file = feedbackFile();
   if (!existsSync(file)) return [];
   const reports = new Map<string, FeedbackReport>();
   for (const raw of readFileSync(file, "utf8").split("\n")) {
@@ -208,7 +261,51 @@ export function readFeedback(): FeedbackReport[] {
 export function archiveRoomFile(roomId: string): void {
   const src = fileFor(roomId);
   if (!existsSync(src)) return;
-  const graveyard = join(DATA_DIR, "..", "rooms-abandoned");
+  const graveyard = join(dataRoot(), "rooms-abandoned");
   mkdirSync(graveyard, { recursive: true });
   renameSync(src, join(graveyard, `${roomId}.${Date.now()}.jsonl`));
 }
+
+// --- The clip vault. ------------------------------------------------------
+// Showcase clips live beside the rooms as plain files — <slug>-fpv.mp4,
+// <slug>-board.mp4, <slug>.jpg — described by clips.json, all published by
+// deploy/clips-publish.sh. The server only ever reads them.
+
+export interface ClipMeta {
+  name: string;
+  title: string;
+  blurb: string;
+  seconds: number;
+  /** Frame size of the first-person take, stamped by deploy/clips-prep.mjs;
+   * unfurlers won't embed a player without it. Absent on an unprepped set. */
+  width?: number;
+  height?: number;
+}
+
+const clipsDir = () => join(dataRoot(), "clips");
+
+/** A clip's name, which is also its file stem: no separators, no dots,
+ * so a name can never name a path. */
+const SLUG = "[a-z0-9-]{1,60}";
+export const CLIP_SLUG = new RegExp(`^${SLUG}$`);
+const CLIP_FILE = new RegExp(`^${SLUG}(?:(?:-fpv|-board)\\.mp4|(?:-card)?\\.jpg)$`);
+
+export function readClips(): ClipMeta[] {
+  const file = join(clipsDir(), "clips.json");
+  if (!existsSync(file)) return [];
+  try {
+    const parsed = JSON.parse(readFileSync(file, "utf8")) as ClipMeta[];
+    return parsed.filter((c) => CLIP_SLUG.test(c.name));
+  } catch {
+    return [];
+  }
+}
+
+/** Resolve a clip asset request to its path — or null for any name that
+ * is not exactly a published clip file: <slug>-fpv.mp4, <slug>-board.mp4,
+ * <slug>.jpg, <slug>-card.jpg. The pattern is the only path guard. */
+export function clipAssetPath(file: string): string | null {
+  if (!CLIP_FILE.test(file)) return null;
+  const path = join(clipsDir(), file);
+  return existsSync(path) ? path : null;
+}