Vendor OpenClaw source as Adolf fork baseline

Adolf is a fork/vendored clone of github.com/openclaw/openclaw (v2026.6.11),
free to diverge. Tree copied sans upstream .git; upstream remote added for
future syncs. Node pinned to 24 (.nvmrc); engines already require >=22.19.
Preserves docs/ARCHITECTURE.md.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LeqyaxJF2nbRXJtae2kNB2

scripts/e2e/lib/browser-cdp-snapshot/assert-snapshot.mjs

@@ -0,0 +1,71 @@
+// Assertions for browser CDP snapshot E2E fixtures.
+import fs from "node:fs";
+
+const DEFAULT_SNAPSHOT_MAX_BYTES = 512 * 1024;
+const SNAPSHOT_DIAGNOSTIC_MAX_BYTES = 32 * 1024;
+const snapshotPath = process.argv[2] ?? "/tmp/browser-cdp-snapshot.txt";
+
+function readPositiveIntEnv(name, fallback) {
+  const raw = process.env[name];
+  if (raw === undefined || raw === "") {
+    return fallback;
+  }
+  const text = raw.trim();
+  if (!/^\d+$/u.test(text)) {
+    throw new Error(`${name} must be a positive integer; got: ${raw}`);
+  }
+  const parsed = Number(text);
+  if (!Number.isSafeInteger(parsed) || parsed <= 0) {
+    throw new Error(`${name} must be a positive integer; got: ${raw}`);
+  }
+  return parsed;
+}
+
+function readBoundedSnapshot(file, maxBytes) {
+  const stats = fs.statSync(file);
+  if (!stats.isFile()) {
+    throw new Error(`${file} is not a file`);
+  }
+  if (stats.size > maxBytes) {
+    throw new Error(`browser CDP snapshot exceeded ${maxBytes} bytes: ${stats.size} bytes`);
+  }
+  const snapshot = fs.readFileSync(file, "utf8");
+  const bytes = Buffer.byteLength(snapshot, "utf8");
+  if (bytes > maxBytes) {
+    throw new Error(`browser CDP snapshot exceeded ${maxBytes} bytes: ${bytes} bytes`);
+  }
+  return snapshot;
+}
+
+function snapshotDiagnostic(snapshot) {
+  const buffer = Buffer.from(snapshot, "utf8");
+  if (buffer.byteLength <= SNAPSHOT_DIAGNOSTIC_MAX_BYTES) {
+    return snapshot;
+  }
+  return `[truncated snapshot diagnostic to ${SNAPSHOT_DIAGNOSTIC_MAX_BYTES} bytes]\n${buffer
+    .subarray(buffer.byteLength - SNAPSHOT_DIAGNOSTIC_MAX_BYTES)
+    .toString("utf8")}`;
+}
+
+const snapshotMaxBytes = readPositiveIntEnv(
+  "OPENCLAW_BROWSER_CDP_SNAPSHOT_MAX_BYTES",
+  DEFAULT_SNAPSHOT_MAX_BYTES,
+);
+const snapshot = readBoundedSnapshot(snapshotPath, snapshotMaxBytes);
+
+for (const needle of [
+  'button "Save"',
+  'link "Docs"',
+  "https://docs.openclaw.ai/browser-cdp-live",
+  'generic "Clickable Card"',
+  "cursor:pointer",
+  'Iframe "Child"',
+  'button "Inside"',
+]) {
+  if (!snapshot.includes(needle)) {
+    console.error(snapshotDiagnostic(snapshot));
+    throw new Error(`missing snapshot needle: ${needle}`);
+  }
+}
+
+console.log("ok");