docs: document e2e helpers

steipete · steipete · commit cb5bb9b936bb · 2026-06-05T00:04:03.000-04:00
diff --git a/scripts/e2e/kitchen-sink-rpc-walk.mjs b/scripts/e2e/kitchen-sink-rpc-walk.mjs
@@ -1,3 +1,4 @@
+// Walks the kitchen-sink gateway RPC scenario for E2E smoke coverage.
 import childProcess from "node:child_process";
 import fs from "node:fs";
 import os from "node:os";
diff --git a/scripts/e2e/lib/agent-turn-output.mjs b/scripts/e2e/lib/agent-turn-output.mjs
@@ -1,3 +1,4 @@
+// Helpers for extracting agent turn output from E2E protocol events.
 import fs from "node:fs";
 import { readTextFileTail, tailText } from "./text-file-utils.mjs";
 
diff --git a/scripts/e2e/lib/bounded-response-text.mjs b/scripts/e2e/lib/bounded-response-text.mjs
@@ -1,3 +1,4 @@
+// Bounded response body reader used by E2E HTTP fixture clients.
 function bodyTooLargeError(label, byteLimit) {
   return Object.assign(new Error(`${label} response body exceeded ${byteLimit} bytes`), {
     code: "ETOOBIG",
diff --git a/scripts/e2e/lib/browser-cdp-snapshot/assert-snapshot.mjs b/scripts/e2e/lib/browser-cdp-snapshot/assert-snapshot.mjs
@@ -1,3 +1,4 @@
+// Assertions for browser CDP snapshot E2E fixtures.
 import fs from "node:fs";
 
 const snapshotPath = process.argv[2] ?? "/tmp/browser-cdp-snapshot.txt";
diff --git a/scripts/e2e/lib/browser-cdp-snapshot/fixture-server.mjs b/scripts/e2e/lib/browser-cdp-snapshot/fixture-server.mjs
@@ -1,3 +1,4 @@
+// Fixture HTTP server for browser CDP snapshot E2E scenarios.
 import http from "node:http";
 import { readPositiveIntEnv } from "../env-limits.mjs";
 
diff --git a/scripts/e2e/lib/bun-global-install/assertions.mjs b/scripts/e2e/lib/bun-global-install/assertions.mjs
@@ -1,3 +1,4 @@
+// Assertions for Bun global install E2E validation.
 import { spawn } from "node:child_process";
 
 const DEFAULT_TIMEOUT_KILL_GRACE_MS = 30_000;
diff --git a/scripts/e2e/lib/bundled-plugin-install-uninstall/probe.mjs b/scripts/e2e/lib/bundled-plugin-install-uninstall/probe.mjs
@@ -1,3 +1,4 @@
+// Probe script for bundled plugin install/uninstall E2E scenarios.
 import { spawnSync } from "node:child_process";
 import fs from "node:fs";
 import os from "node:os";
diff --git a/scripts/e2e/lib/bundled-plugin-install-uninstall/runtime-smoke.mjs b/scripts/e2e/lib/bundled-plugin-install-uninstall/runtime-smoke.mjs
@@ -1,3 +1,4 @@
+// Runtime smoke script for bundled plugin install/uninstall E2E validation.
 import childProcess from "node:child_process";
 import fs from "node:fs";
 import os from "node:os";
diff --git a/scripts/e2e/lib/clawhub-fixture-server.cjs b/scripts/e2e/lib/clawhub-fixture-server.cjs
@@ -1,3 +1,4 @@
+// CommonJS fixture server for ClawHub package/install E2E scenarios.
 const crypto = require("node:crypto");
 const fs = require("node:fs");
 const http = require("node:http");
diff --git a/scripts/e2e/lib/codex-install-utils.mjs b/scripts/e2e/lib/codex-install-utils.mjs
@@ -1,3 +1,4 @@
+// Shared Codex plugin install helpers for E2E scenarios.
 import fs from "node:fs";
 import path from "node:path";
 import { readJson } from "./fixtures/common.mjs";
diff --git a/scripts/e2e/lib/codex-media-path/client.mjs b/scripts/e2e/lib/codex-media-path/client.mjs
@@ -1,3 +1,4 @@
+// Client helpers for Codex media-path E2E fixtures.
 import { createHash, randomBytes, randomUUID } from "node:crypto";
 import { setTimeout as delay } from "node:timers/promises";
 import { PROTOCOL_VERSION } from "../../../../dist/gateway/protocol/index.js";
diff --git a/scripts/e2e/lib/codex-media-path/fake-codex-app-server.mjs b/scripts/e2e/lib/codex-media-path/fake-codex-app-server.mjs
@@ -1,3 +1,4 @@
+// Fake Codex app server used by media-path E2E scenarios.
 import fs from "node:fs";
 import readline from "node:readline";
 
diff --git a/scripts/e2e/lib/codex-media-path/jsonl-request-tail.mjs b/scripts/e2e/lib/codex-media-path/jsonl-request-tail.mjs
@@ -1,3 +1,4 @@
+// Tails JSONL request logs for Codex media-path E2E assertions.
 import {
   createIncrementalLineReader,
   resolvePositiveInteger,
diff --git a/scripts/e2e/lib/codex-media-path/limits.mjs b/scripts/e2e/lib/codex-media-path/limits.mjs
@@ -1,3 +1,4 @@
+// Limits shared by Codex media-path E2E fixtures.
 export function readPositiveIntEnv(name, fallback, env = process.env) {
   const text = String(env[name] ?? fallback).trim();
   if (!/^\d+$/u.test(text)) {
diff --git a/scripts/e2e/lib/codex-media-path/write-config.mjs b/scripts/e2e/lib/codex-media-path/write-config.mjs
@@ -1,3 +1,4 @@
+// Writes config fixtures for Codex media-path E2E scenarios.
 import fs from "node:fs";
 import path from "node:path";
 import { readPositiveIntEnv } from "./limits.mjs";
diff --git a/scripts/e2e/lib/codex-npm-plugin-live/assertions.mjs b/scripts/e2e/lib/codex-npm-plugin-live/assertions.mjs
@@ -1,3 +1,4 @@
+// Assertions for Codex npm plugin live E2E scenarios.
 import fs from "node:fs";
 import path from "node:path";
 import {
diff --git a/scripts/e2e/lib/codex-on-demand/assertions.mjs b/scripts/e2e/lib/codex-on-demand/assertions.mjs
@@ -1,3 +1,4 @@
+// Assertions for Codex on-demand plugin E2E scenarios.
 import fs from "node:fs";
 import path from "node:path";
 import { DatabaseSync } from "node:sqlite";
diff --git a/scripts/e2e/lib/config-reload/assert-log.mjs b/scripts/e2e/lib/config-reload/assert-log.mjs
@@ -1,3 +1,4 @@
+// Log assertions for config reload E2E scenarios.
 import { readPositiveIntEnv } from "../env-limits.mjs";
 import { createConfigReloadLogScanner } from "./log-scanner.mjs";
 
diff --git a/scripts/e2e/lib/config-reload/log-scanner.mjs b/scripts/e2e/lib/config-reload/log-scanner.mjs
@@ -1,3 +1,4 @@
+// Streaming log scanner for config reload E2E scenarios.
 import {
   createIncrementalLineReader,
   resolvePositiveInteger,
diff --git a/scripts/e2e/lib/config-reload/mutate-metadata.mjs b/scripts/e2e/lib/config-reload/mutate-metadata.mjs
@@ -1,3 +1,4 @@
+// Mutates plugin metadata fixtures for config reload E2E scenarios.
 import fs from "node:fs";
 
 const configPath = process.env.OPENCLAW_CONFIG_PATH;
diff --git a/scripts/e2e/lib/docker-stats/assert-resource-ceiling.mjs b/scripts/e2e/lib/docker-stats/assert-resource-ceiling.mjs
@@ -1,3 +1,4 @@
+// Resource ceiling assertions for Docker E2E stats output.
 import fs from "node:fs";
 import { createInterface } from "node:readline";
 
diff --git a/scripts/e2e/lib/doctor-install-switch/write-wrapper.mjs b/scripts/e2e/lib/doctor-install-switch/write-wrapper.mjs
@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+// Writes wrapper scripts for doctor install-switch E2E scenarios.
 import fs from "node:fs";
 
 const [wrapperPath, npmBin, logPath = `${process.env.HOME}/openclaw-wrapper-argv.log`] =
diff --git a/scripts/e2e/lib/env-limits.mjs b/scripts/e2e/lib/env-limits.mjs
@@ -1,3 +1,4 @@
+// Environment limit helpers for E2E subprocess scenarios.
 export function readPositiveIntEnv(name, fallback, env = process.env) {
   const raw = env[name] ?? fallback;
   const text = raw == null ? "unset" : String(raw).trim();
diff --git a/scripts/e2e/lib/fixture.mjs b/scripts/e2e/lib/fixture.mjs
@@ -1,3 +1,4 @@
+// Shared command fixture dispatcher for E2E scripts.
 import { configCommands } from "./fixtures/config.mjs";
 import { pluginCommands } from "./fixtures/plugins.mjs";
 import { workspaceCommands } from "./fixtures/workspace.mjs";
diff --git a/scripts/e2e/lib/fixtures/common.mjs b/scripts/e2e/lib/fixtures/common.mjs
@@ -1,3 +1,4 @@
+// Common file/assertion helpers for E2E fixture writers.
 import fs from "node:fs";
 import path from "node:path";
 
diff --git a/scripts/e2e/lib/fixtures/config.mjs b/scripts/e2e/lib/fixtures/config.mjs
@@ -1,3 +1,4 @@
+// Config fixture writer commands for E2E scenarios.
 import path from "node:path";
 import { requireArg, writeJson } from "./common.mjs";
 
diff --git a/scripts/e2e/lib/fixtures/mock-openai-config.mjs b/scripts/e2e/lib/fixtures/mock-openai-config.mjs
@@ -1,3 +1,4 @@
+// Mock OpenAI model config helpers for E2E fixture generation.
 export function applyMockOpenAiModelConfig(cfg, params) {
   const modelRef = params.modelRef ?? "openai/gpt-5.5";
   const modelId = modelRef.split("/").at(-1) ?? "gpt-5.5";
diff --git a/scripts/e2e/lib/fixtures/plugins.mjs b/scripts/e2e/lib/fixtures/plugins.mjs
@@ -1,3 +1,4 @@
+// Plugin fixture writer commands for E2E scenarios.
 import path from "node:path";
 import { requireArg, write, writeJson } from "./common.mjs";
 
diff --git a/scripts/e2e/lib/fixtures/workspace.mjs b/scripts/e2e/lib/fixtures/workspace.mjs
@@ -1,3 +1,4 @@
+// Workspace fixture writer commands for E2E scenarios.
 import fs from "node:fs";
 import path from "node:path";
 import { assert, readJson, requireArg, write, writeJson } from "./common.mjs";
diff --git a/scripts/e2e/lib/gateway-frame-payload.mjs b/scripts/e2e/lib/gateway-frame-payload.mjs
@@ -1,3 +1,4 @@
+// Gateway frame payload helpers for E2E WebSocket assertions.
 function hasOwnEnvelopeField(frame, field) {
   return (
     ((typeof frame === "object" && frame !== null) || typeof frame === "function") &&
diff --git a/scripts/e2e/lib/gateway-network/client.mjs b/scripts/e2e/lib/gateway-network/client.mjs
@@ -1,3 +1,4 @@
+// WebSocket client helpers for gateway network E2E scenarios.
 import { WebSocket } from "ws";
 import { PROTOCOL_VERSION } from "../../../../dist/gateway/protocol/index.js";
 import { waitForWebSocketOpen } from "../websocket-open.mjs";
diff --git a/scripts/e2e/lib/gateway-network/limits.mjs b/scripts/e2e/lib/gateway-network/limits.mjs
@@ -1,3 +1,4 @@
+// Limits shared by gateway network E2E fixtures.
 function readPositiveIntEnv(name, fallback, env) {
   const text = String(env[name] ?? fallback).trim();
   if (!/^\d+$/u.test(text)) {
diff --git a/scripts/e2e/lib/gateway-network/ws-frames.mjs b/scripts/e2e/lib/gateway-network/ws-frames.mjs
@@ -1,3 +1,4 @@
+// WebSocket frame helpers for gateway network E2E fixtures.
 function formatCloseValue(value) {
   if (value === undefined || value === null) {
     return "";
diff --git a/scripts/e2e/lib/incremental-line-reader.mjs b/scripts/e2e/lib/incremental-line-reader.mjs
@@ -1,3 +1,4 @@
+// Incremental line reader for streaming E2E logs.
 import { createHash } from "node:crypto";
 import fs from "node:fs";
 
diff --git a/scripts/e2e/lib/kitchen-sink-plugin/assertions.mjs b/scripts/e2e/lib/kitchen-sink-plugin/assertions.mjs
@@ -1,3 +1,4 @@
+// Assertions for kitchen-sink plugin E2E scenarios.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
diff --git a/scripts/e2e/lib/live-plugin-tool/assertions.mjs b/scripts/e2e/lib/live-plugin-tool/assertions.mjs
@@ -1,3 +1,4 @@
+// Assertions for live plugin tool E2E scenarios.
 import fs from "node:fs";
 import path from "node:path";
 import { readPluginInstallRecords } from "../plugin-index-sqlite.mjs";
diff --git a/scripts/e2e/lib/mock-openai-http.mjs b/scripts/e2e/lib/mock-openai-http.mjs
@@ -1,3 +1,4 @@
+// Mock OpenAI-compatible HTTP server helpers for E2E scenarios.
 import fs from "node:fs";
 import { readPositiveIntEnv } from "./env-limits.mjs";
 
diff --git a/scripts/e2e/lib/npm-onboard-channel-agent/assertions.mjs b/scripts/e2e/lib/npm-onboard-channel-agent/assertions.mjs
@@ -1,3 +1,4 @@
+// Assertions for npm onboard channel-agent E2E scenarios.
 import fs from "node:fs";
 import path from "node:path";
 import { DatabaseSync } from "node:sqlite";
diff --git a/scripts/e2e/lib/npm-telegram-live/prepare-package.mjs b/scripts/e2e/lib/npm-telegram-live/prepare-package.mjs
@@ -1,3 +1,4 @@
+// Prepares package manifests for npm Telegram live E2E scenarios.
 import fs from "node:fs";
 
 for (const packageJsonPath of process.argv.slice(2)) {
diff --git a/scripts/e2e/lib/onboard/assert-config.mjs b/scripts/e2e/lib/onboard/assert-config.mjs
@@ -1,3 +1,4 @@
+// Config assertions for onboard E2E scenarios.
 import fs from "node:fs";
 import JSON5 from "json5";
 
diff --git a/scripts/e2e/lib/onboard/log-contains.mjs b/scripts/e2e/lib/onboard/log-contains.mjs
@@ -1,3 +1,4 @@
+// Log substring assertion helper for onboard E2E scenarios.
 import fs from "node:fs";
 
 const [file, needle] = process.argv.slice(2);
diff --git a/scripts/e2e/lib/onboard/write-config.mjs b/scripts/e2e/lib/onboard/write-config.mjs
@@ -1,3 +1,4 @@
+// Config writer helper for onboard E2E scenarios.
 import fs from "node:fs";
 
 const [scenario, configPath] = process.argv.slice(2);
diff --git a/scripts/e2e/lib/openai-chat-tools/client.mjs b/scripts/e2e/lib/openai-chat-tools/client.mjs
@@ -1,3 +1,4 @@
+// Gateway client for OpenAI chat tools E2E scenarios.
 const port = process.env.PORT;
 const token = process.env.OPENCLAW_GATEWAY_TOKEN;
 const backendModel = process.env.MODEL_REF || "openai/gpt-5.4-mini";
diff --git a/scripts/e2e/lib/openai-chat-tools/write-config.mjs b/scripts/e2e/lib/openai-chat-tools/write-config.mjs
@@ -1,3 +1,4 @@
+// Config writer for OpenAI chat tools E2E scenarios.
 import fs from "node:fs";
 import path from "node:path";
 
diff --git a/scripts/e2e/lib/openai-web-search-minimal/assertions.mjs b/scripts/e2e/lib/openai-web-search-minimal/assertions.mjs
@@ -1,3 +1,4 @@
+// Assertions for minimal OpenAI web-search E2E scenarios.
 import fs from "node:fs";
 import { readTextFileTail, tailText } from "../text-file-utils.mjs";
 
diff --git a/scripts/e2e/lib/openai-web-search-minimal/client.mjs b/scripts/e2e/lib/openai-web-search-minimal/client.mjs
@@ -1,3 +1,4 @@
+// Client script for minimal OpenAI web-search E2E scenarios.
 import { readdirSync } from "node:fs";
 import { pathToFileURL } from "node:url";
 
diff --git a/scripts/e2e/lib/openai-web-search-minimal/mock-server.mjs b/scripts/e2e/lib/openai-web-search-minimal/mock-server.mjs
@@ -1,3 +1,4 @@
+// Mock server for minimal OpenAI web-search E2E scenarios.
 import http from "node:http";
 import { readPositiveIntEnv } from "../env-limits.mjs";
 import {
diff --git a/scripts/e2e/lib/openwebui/http-probe.mjs b/scripts/e2e/lib/openwebui/http-probe.mjs
@@ -1,3 +1,4 @@
+// HTTP probe for OpenWebUI E2E scenarios.
 import { readPositiveIntEnv } from "../env-limits.mjs";
 
 const [url, expectedRaw = "200"] = process.argv.slice(2);
diff --git a/scripts/e2e/lib/package-compat.mjs b/scripts/e2e/lib/package-compat.mjs
@@ -1,3 +1,4 @@
+// Package-version compatibility helpers for E2E acceptance scripts.
 export function legacyPackageAcceptanceCompat(version) {
   const match = /^(\d{4})\.(\d{1,2})\.(\d{1,2})(?:[-+].*)?/.exec(version || "");
   const [year, month, day] = match?.slice(1, 4).map(Number) ?? [];
diff --git a/scripts/e2e/lib/parallels-package/build-info-commit.mjs b/scripts/e2e/lib/parallels-package/build-info-commit.mjs
@@ -1,3 +1,4 @@
+// Validates build-info commit metadata for Parallels package E2E scenarios.
 import fs from "node:fs";
 
 const path = "dist/build-info.json";
diff --git a/scripts/e2e/lib/parallels-package/log-progress-extract.mjs b/scripts/e2e/lib/parallels-package/log-progress-extract.mjs
@@ -1,3 +1,4 @@
+// Extracts progress markers from Parallels package E2E logs.
 import fs from "node:fs";
 import { readTextFileTail } from "../text-file-utils.mjs";
 
diff --git a/scripts/e2e/lib/plugin-index-sqlite.mjs b/scripts/e2e/lib/plugin-index-sqlite.mjs
@@ -1,3 +1,4 @@
+// SQLite readers for plugin install indexes produced during E2E scenarios.
 import fs from "node:fs";
 import path from "node:path";
 import { DatabaseSync } from "node:sqlite";
diff --git a/scripts/e2e/lib/plugin-lifecycle-matrix/measure.mjs b/scripts/e2e/lib/plugin-lifecycle-matrix/measure.mjs
@@ -1,3 +1,4 @@
+// Measures plugin lifecycle matrix E2E command timings.
 import { spawn } from "node:child_process";
 import fs from "node:fs";
 import path from "node:path";
diff --git a/scripts/e2e/lib/plugin-lifecycle-matrix/probe.mjs b/scripts/e2e/lib/plugin-lifecycle-matrix/probe.mjs
@@ -1,3 +1,4 @@
+// Probe script for plugin lifecycle matrix E2E scenarios.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
diff --git a/scripts/e2e/lib/plugin-update/probe.mjs b/scripts/e2e/lib/plugin-update/probe.mjs
@@ -1,3 +1,4 @@
+// Probe script for plugin update E2E scenarios.
 import fs from "node:fs";
 import http from "node:http";
 import os from "node:os";
diff --git a/scripts/e2e/lib/plugin-update/registry-server.mjs b/scripts/e2e/lib/plugin-update/registry-server.mjs
@@ -1,3 +1,4 @@
+// Fixture npm registry server for plugin update E2E scenarios.
 import http from "node:http";
 
 const metadata = {
diff --git a/scripts/e2e/lib/plugins/assertions.mjs b/scripts/e2e/lib/plugins/assertions.mjs
@@ -1,3 +1,4 @@
+// Assertions for plugin install/runtime E2E scenarios.
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
diff --git a/scripts/e2e/lib/plugins/npm-registry-server.mjs b/scripts/e2e/lib/plugins/npm-registry-server.mjs
@@ -1,3 +1,4 @@
+// Fixture npm registry server for plugin E2E scenarios.
 import crypto from "node:crypto";
 import fs from "node:fs";
 import http from "node:http";
diff --git a/scripts/e2e/lib/release-scenarios/assertions.mjs b/scripts/e2e/lib/release-scenarios/assertions.mjs
@@ -1,3 +1,4 @@
+// Assertions for release scenario E2E packages and plugin state.
 import fs from "node:fs";
 import path from "node:path";
 import { DatabaseSync } from "node:sqlite";
diff --git a/scripts/e2e/lib/release-scenarios/write-cli-plugin.mjs b/scripts/e2e/lib/release-scenarios/write-cli-plugin.mjs
@@ -1,3 +1,4 @@
+// Writes a CLI plugin fixture for release scenario E2E tests.
 import fs from "node:fs";
 import path from "node:path";
 
diff --git a/scripts/e2e/lib/release-scenarios/write-marketplace.mjs b/scripts/e2e/lib/release-scenarios/write-marketplace.mjs
@@ -1,3 +1,4 @@
+// Writes a marketplace fixture for release scenario E2E tests.
 import fs from "node:fs";
 import path from "node:path";
 
diff --git a/scripts/e2e/lib/release-user-journey/assertions.mjs b/scripts/e2e/lib/release-user-journey/assertions.mjs
@@ -1,3 +1,4 @@
+// Assertions for release user-journey E2E scenarios.
 import fs from "node:fs";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
diff --git a/scripts/e2e/lib/release-user-journey/clickclack-fixture.mjs b/scripts/e2e/lib/release-user-journey/clickclack-fixture.mjs
@@ -1,3 +1,4 @@
+// ClickClack fixture server for release user-journey E2E scenarios.
 import crypto from "node:crypto";
 import fs from "node:fs";
 import http from "node:http";
diff --git a/scripts/e2e/lib/run-with-pty.mjs b/scripts/e2e/lib/run-with-pty.mjs
@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+// Runs an E2E command under a pseudo-terminal.
 import fs from "node:fs";
 import process from "node:process";
 import { spawn } from "@lydell/node-pty";
diff --git a/scripts/e2e/lib/text-file-utils.mjs b/scripts/e2e/lib/text-file-utils.mjs
@@ -1,3 +1,4 @@
+// Text file tail helpers for E2E assertions.
 import fs from "node:fs";
 
 export function tailText(text, maxBytes) {
diff --git a/scripts/e2e/lib/update-channel-switch/assertions.mjs b/scripts/e2e/lib/update-channel-switch/assertions.mjs
@@ -1,3 +1,4 @@
+// Assertions for update-channel switch E2E scenarios.
 import fs from "node:fs";
 import path from "node:path";
 import { legacyPackageAcceptanceCompat } from "../package-compat.mjs";
diff --git a/scripts/e2e/lib/upgrade-survivor/assertions.mjs b/scripts/e2e/lib/upgrade-survivor/assertions.mjs
@@ -1,3 +1,4 @@
+// Assertions for upgrade-survivor E2E scenarios.
 import fs from "node:fs";
 import path from "node:path";
 import { readPluginInstallIndex } from "../plugin-index-sqlite.mjs";
diff --git a/scripts/e2e/lib/upgrade-survivor/config-recipe.mjs b/scripts/e2e/lib/upgrade-survivor/config-recipe.mjs
@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+// Builds config recipes for upgrade-survivor E2E scenarios.
 import { spawnSync } from "node:child_process";
 import fs from "node:fs";
 import path from "node:path";
diff --git a/scripts/e2e/lib/upgrade-survivor/probe-gateway.mjs b/scripts/e2e/lib/upgrade-survivor/probe-gateway.mjs
@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 
+// Probes gateway state for upgrade-survivor E2E scenarios.
 import fs from "node:fs";
 import path from "node:path";
 
diff --git a/scripts/e2e/lib/websocket-open.mjs b/scripts/e2e/lib/websocket-open.mjs
@@ -1,3 +1,4 @@
+// WebSocket open/close wait helper for E2E clients.
 function formatCloseValue(value) {
   if (value === undefined || value === null) {
     return "";
diff --git a/scripts/e2e/mock-openai-server.mjs b/scripts/e2e/mock-openai-server.mjs
@@ -1,3 +1,4 @@
+// Mock OpenAI-compatible server for broader E2E scenarios.
 import { createHash } from "node:crypto";
 import http from "node:http";
 import { readPositiveIntEnv } from "./lib/env-limits.mjs";
diff --git a/scripts/e2e/npm-telegram-rtt-config.mjs b/scripts/e2e/npm-telegram-rtt-config.mjs
@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+// Writes npm Telegram RTT config fixtures.
 import fs from "node:fs";
 
 const [configPath, mockPort, groupId, driverToken, sutToken, packageVersion] =
diff --git a/scripts/e2e/npm-telegram-rtt-credentials.mjs b/scripts/e2e/npm-telegram-rtt-credentials.mjs
@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+// Issues and writes npm Telegram RTT credential fixtures.
 import fs from "node:fs/promises";
 import { readBoundedResponseText } from "./lib/bounded-response-text.mjs";
 
diff --git a/scripts/e2e/npm-telegram-rtt-driver.mjs b/scripts/e2e/npm-telegram-rtt-driver.mjs
@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+// Drives npm Telegram RTT test messages through the fixture server.
 import fs from "node:fs/promises";
 import path from "node:path";
 import { readBoundedResponseText } from "./lib/bounded-response-text.mjs";
diff --git a/scripts/e2e/openwebui-probe.mjs b/scripts/e2e/openwebui-probe.mjs
@@ -1,3 +1,4 @@
+// Probe script for OpenWebUI E2E connectivity.
 import { Agent, setGlobalDispatcher } from "undici";
 import { readBoundedResponseText as readBoundedResponseTextWithLimit } from "./lib/bounded-response-text.mjs";
 
diff --git a/scripts/e2e/secret-provider-integrations.mjs b/scripts/e2e/secret-provider-integrations.mjs
@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+// Runs secret-provider integration E2E checks with fixture processes.
 import childProcess from "node:child_process";
 import fs from "node:fs";
 import net from "node:net";

Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,4 @@`
	`1`	`+// Walks the kitchen-sink gateway RPC scenario for E2E smoke coverage.`
`1`	`2`	`import childProcess from "node:child_process";`
`2`	`3`	`import fs from "node:fs";`
`3`	`4`	`import os from "node:os";`
Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,4 @@`
	`1`	`+// Helpers for extracting agent turn output from E2E protocol events.`
`1`	`2`	`import fs from "node:fs";`
`2`	`3`	`import { readTextFileTail, tailText } from "./text-file-utils.mjs";`
`3`	`4`
Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,4 @@`
	`1`	`+// Bounded response body reader used by E2E HTTP fixture clients.`
`1`	`2`	`function bodyTooLargeError(label, byteLimit) {`
`2`	`3`	return Object.assign(new Error(`${label} response body exceeded ${byteLimit} bytes`), {
`3`	`4`	`code: "ETOOBIG",`
Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,4 @@`
	`1`	`+// Assertions for browser CDP snapshot E2E fixtures.`
`1`	`2`	`import fs from "node:fs";`
`2`	`3`
`3`	`4`	`const snapshotPath = process.argv[2] ?? "/tmp/browser-cdp-snapshot.txt";`
Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,4 @@`
	`1`	`+// Fixture HTTP server for browser CDP snapshot E2E scenarios.`
`1`	`2`	`import http from "node:http";`
`2`	`3`	`import { readPositiveIntEnv } from "../env-limits.mjs";`
`3`	`4`
Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,4 @@`
	`1`	`+// Assertions for Bun global install E2E validation.`
`1`	`2`	`import { spawn } from "node:child_process";`
`2`	`3`
`3`	`4`	`const DEFAULT_TIMEOUT_KILL_GRACE_MS = 30_000;`
Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,4 @@`
	`1`	`+// Probe script for bundled plugin install/uninstall E2E scenarios.`
`1`	`2`	`import { spawnSync } from "node:child_process";`
`2`	`3`	`import fs from "node:fs";`
`3`	`4`	`import os from "node:os";`
Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,4 @@`
	`1`	`+// Runtime smoke script for bundled plugin install/uninstall E2E validation.`
`1`	`2`	`import childProcess from "node:child_process";`
`2`	`3`	`import fs from "node:fs";`
`3`	`4`	`import os from "node:os";`
Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,4 @@`
	`1`	`+// CommonJS fixture server for ClawHub package/install E2E scenarios.`
`1`	`2`	`const crypto = require("node:crypto");`
`2`	`3`	`const fs = require("node:fs");`
`3`	`4`	`const http = require("node:http");`
Original file line number	Diff line number	Diff line change
`@@ -1,3 +1,4 @@`
	`1`	`+// Shared Codex plugin install helpers for E2E scenarios.`
`1`	`2`	`import fs from "node:fs";`
`2`	`3`	`import path from "node:path";`
`3`	`4`	`import { readJson } from "./fixtures/common.mjs";`