docs: document repository scripts

qa/convex-credential-broker/convex/credentials.ts

@@ -1,3 +1,4 @@
+// Credentials module supports OpenClaw QA credential workflows.
 import { v } from "convex/values";
 import { internal } from "./_generated/api";
 import type { Id } from "./_generated/dataModel";

qa/convex-credential-broker/convex/crons.ts

@@ -1,3 +1,4 @@
+// Crons module supports OpenClaw QA credential workflows.
 import { cronJobs } from "convex/server";
 import { internal } from "./_generated/api";
 

qa/convex-credential-broker/convex/http.ts

@@ -1,3 +1,4 @@
+// Http module supports OpenClaw QA credential workflows.
 import { httpRouter } from "convex/server";
 import { internal } from "./_generated/api";
 import type { Id } from "./_generated/dataModel";

qa/convex-credential-broker/convex/payload-validation.ts

@@ -1,3 +1,4 @@
+// Payload Validation module supports OpenClaw QA credential workflows.
 export class CredentialPayloadValidationError extends Error {
   code: string;
   httpStatus: number;

qa/convex-credential-broker/convex/schema.ts

@@ -1,3 +1,4 @@
+// Schema module supports OpenClaw QA credential workflows.
 import { defineSchema, defineTable } from "convex/server";
 import { v } from "convex/values";
 

scripts/analyze-plugin-sdk-usage.ts

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+// Analyze Plugin Sdk Usage script supports OpenClaw repository automation.
 import { main } from "./ts-topology.ts";
 
 const forwardedArgs = process.argv.slice(2);

scripts/anthropic-prompt-probe.ts

@@ -1,3 +1,4 @@
+// Anthropic Prompt Probe script supports OpenClaw repository automation.
 import { spawn } from "node:child_process";
 // Live prompt probe for Anthropic setup-token and Claude CLI prompt-path debugging.
 // Usage:

scripts/bench-cli-startup.ts

@@ -1,3 +1,4 @@
+// Bench Cli Startup script supports OpenClaw repository automation.
 import { spawn } from "node:child_process";
 import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";
 import os from "node:os";

scripts/bench-gateway-restart.ts

@@ -1,3 +1,4 @@
+// Bench Gateway Restart script supports OpenClaw repository automation.
 import { spawn, spawnSync, type ChildProcessWithoutNullStreams } from "node:child_process";
 import fs from "node:fs";
 import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";

scripts/bench-gateway-startup.ts

@@ -1,3 +1,4 @@
+// Bench Gateway Startup script supports OpenClaw repository automation.
 import { spawn, spawnSync } from "node:child_process";
 import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";
 import { request } from "node:http";

scripts/bench-model.ts

@@ -1,3 +1,4 @@
+// Bench Model script supports OpenClaw repository automation.
 import { completeSimple, type Model } from "openclaw/plugin-sdk/llm";
 
 type Usage = {

scripts/check-codex-app-server-protocol.ts

@@ -1,3 +1,4 @@
+// Check Codex App Server Protocol script supports OpenClaw repository automation.
 import fs from "node:fs/promises";
 import path from "node:path";
 import {

scripts/check-file-utils.ts

@@ -1,3 +1,4 @@
+// Check File Utils helper supports OpenClaw script workflows.
 import fs from "node:fs";
 import path from "node:path";
 

scripts/check-import-cycles.ts

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+// Check Import Cycles script supports OpenClaw repository automation.
 import { readFileSync } from "node:fs";
 import path from "node:path";
 import { fileURLToPath } from "node:url";

scripts/check-live-cache.ts

@@ -1,3 +1,4 @@
+// Check Live Cache script supports OpenClaw repository automation.
 import { runLiveCacheRegression } from "../src/agents/live-cache-regression-runner.js";
 import { LIVE_CACHE_TEST_ENABLED, logLiveCache } from "../src/agents/live-cache-test-support.js";
 

scripts/check-madge-import-cycles.ts

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+// Check Madge Import Cycles script supports OpenClaw repository automation.
 import { readFileSync } from "node:fs";
 import path from "node:path";
 import { fileURLToPath } from "node:url";

scripts/check-no-deprecated-channel-access.ts

@@ -1,3 +1,4 @@
+// Check No Deprecated Channel Access script supports OpenClaw repository automation.
 import fs from "node:fs";
 import path from "node:path";
 import { collectFilesSync, isCodeFile, relativeToCwd } from "./check-file-utils.js";

scripts/check-no-extension-src-imports.ts

@@ -1,3 +1,4 @@
+// Check No Extension Src Imports script supports OpenClaw repository automation.
 import fs from "node:fs";
 import path from "node:path";
 import { collectFilesSync, isCodeFile, relativeToCwd } from "./check-file-utils.js";

scripts/check-no-extension-test-core-imports.ts

@@ -1,3 +1,4 @@
+// Check No Extension Test Core Imports script supports OpenClaw repository automation.
 import fs from "node:fs";
 import path from "node:path";
 import { collectFilesSync, isCodeFile, relativeToCwd } from "./check-file-utils.js";

scripts/check-no-monolithic-plugin-sdk-entry-imports.ts

@@ -1,3 +1,4 @@
+// Check No Monolithic Plugin Sdk Entry Imports script supports OpenClaw repository automation.
 import fs from "node:fs";
 import path from "node:path";
 import { discoverOpenClawPlugins } from "../src/plugins/discovery.js";

scripts/check-temp-path-guardrails.ts

@@ -1,3 +1,4 @@
+// Check Temp Path Guardrails script supports OpenClaw repository automation.
 import { execFileSync } from "node:child_process";
 import fs from "node:fs/promises";
 import path from "node:path";

scripts/check-ts-max-loc.ts

@@ -1,3 +1,4 @@
+// Check Ts Max Loc script supports OpenClaw repository automation.
 import { execFileSync } from "node:child_process";
 import { existsSync } from "node:fs";
 import { readFile } from "node:fs/promises";

scripts/control-ui-i18n-report.ts

@@ -1,3 +1,4 @@
+// Control Ui I18N Report script supports OpenClaw repository automation.
 import { existsSync } from "node:fs";
 import { readFile } from "node:fs/promises";
 import path from "node:path";

scripts/control-ui-i18n.ts

@@ -1,3 +1,4 @@
+// Control Ui I18N script supports OpenClaw repository automation.
 import { spawn, spawnSync } from "node:child_process";
 import { createHash } from "node:crypto";
 import { existsSync } from "node:fs";

scripts/control-ui-mock-dev.ts

@@ -1,3 +1,4 @@
+// Control Ui Mock Dev script supports OpenClaw repository automation.
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 import { createServer, type Plugin, type ViteDevServer } from "vite";

scripts/cron_usage_report.ts

@@ -1,3 +1,4 @@
+// Cron Usage Report script supports OpenClaw repository automation.
 import fs from "node:fs/promises";
 import path from "node:path";
 

scripts/debug-claude-usage.ts

@@ -1,3 +1,4 @@
+// Debug Claude Usage script supports OpenClaw repository automation.
 import { execFileSync } from "node:child_process";
 import crypto from "node:crypto";
 import fs from "node:fs";

scripts/dev/channel-message-flows.ts

@@ -1,4 +1,5 @@
 #!/usr/bin/env -S node --import tsx
+// Channel Message Flows script supports OpenClaw repository automation.
 import { setTimeout as sleep } from "node:timers/promises";
 import { fileURLToPath } from "node:url";
 import { Bot, type ApiClientOptions } from "grammy";

scripts/dev/discord-acp-plain-language-smoke.ts

@@ -1,4 +1,5 @@
 #!/usr/bin/env bun
+// Discord Acp Plain Language Smoke script supports OpenClaw repository automation.
 import { execFile } from "node:child_process";
 // Manual ACP thread smoke for plain-language routing.
 // Keep this script available for regression/debug validation. Do not delete.

scripts/dev/gateway-smoke.ts

@@ -1,3 +1,4 @@
+// Gateway Smoke script supports OpenClaw repository automation.
 import { fileURLToPath } from "node:url";
 import {
   MIN_CLIENT_PROTOCOL_VERSION,

scripts/dev/gateway-ws-client.ts

@@ -1 +1,2 @@
+// Gateway Ws Client script supports OpenClaw repository automation.
 export * from "../lib/gateway-ws-client.ts";

scripts/dev/ios-node-e2e.ts

@@ -1,3 +1,4 @@
+// Ios Node E2E script supports OpenClaw repository automation.
 import {
   MIN_CLIENT_PROTOCOL_VERSION,
   PROTOCOL_VERSION,

scripts/dev/realtime-talk-live-smoke.ts

@@ -1,3 +1,4 @@
+// Realtime Talk Live Smoke script supports OpenClaw repository automation.
 import { mkdtemp, rm, writeFile } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import path from "node:path";

scripts/dev/test-device-pair-telegram.ts

@@ -1,3 +1,4 @@
+// Test Device Pair Telegram script supports OpenClaw repository automation.
 import { sendMessageTelegram } from "../../extensions/telegram/runtime-api.js";
 import { getRuntimeConfig } from "../../src/config/config.js";
 import { matchPluginCommand, executePluginCommand } from "../../src/plugins/commands.js";

scripts/dev/tui-pty-test-watch.ts

@@ -1,3 +1,4 @@
+// Tui Pty Test Watch script supports OpenClaw repository automation.
 import { spawn } from "node:child_process";
 import { mkdir, readFile, writeFile } from "node:fs/promises";
 import { createRequire } from "node:module";

scripts/diffs-shiki-curated.ts

@@ -1,3 +1,4 @@
+// Diffs Shiki Curated script supports OpenClaw repository automation.
 import {
   createBundledHighlighter,
   createCssVariablesTheme,

scripts/e2e/cron-mcp-cleanup-docker-client.ts

@@ -1,3 +1,4 @@
+// Cron Mcp Cleanup Docker Client script supports OpenClaw repository automation.
 import { execFile } from "node:child_process";
 import { randomUUID } from "node:crypto";
 import fs from "node:fs/promises";

scripts/e2e/cron-mcp-cleanup-seed.ts

@@ -1,3 +1,4 @@
+// Cron Mcp Cleanup Seed script supports OpenClaw repository automation.
 import fs from "node:fs/promises";
 import { createRequire } from "node:module";
 import os from "node:os";

scripts/e2e/lib/session-log-mentions.ts

@@ -1,3 +1,4 @@
+// Session Log Mentions script supports OpenClaw repository automation.
 import fs from "node:fs/promises";
 import path from "node:path";
 import { readPositiveIntEnv } from "./env-limits.mjs";

scripts/e2e/lib/temp-state-dir.ts

@@ -1,3 +1,4 @@
+// Temp State Dir script supports OpenClaw repository automation.
 import { rmSync } from "node:fs";
 import fs from "node:fs/promises";
 import os from "node:os";

scripts/e2e/mcp-channel-limits.ts

@@ -1,3 +1,4 @@
+// Mcp Channel Limits script supports OpenClaw repository automation.
 import { readPositiveIntEnv } from "./lib/env-limits.mjs";
 
 export type McpChannelLimits = {

scripts/e2e/mcp-channels-docker-client.ts

@@ -1,3 +1,4 @@
+// Mcp Channels Docker Client script supports OpenClaw repository automation.
 import { randomUUID } from "node:crypto";
 import {
   assert,

scripts/e2e/mcp-channels-seed.ts

@@ -1,3 +1,4 @@
+// Mcp Channels Seed script supports OpenClaw repository automation.
 import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";

scripts/e2e/mcp-client-temp-state.ts

@@ -1,3 +1,4 @@
+// Mcp Client Temp State script supports OpenClaw repository automation.
 import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";
 import { tmpdir } from "node:os";
 import path from "node:path";

scripts/e2e/mcp-code-mode-gateway-client.ts

@@ -1,3 +1,4 @@
+// Mcp Code Mode Gateway Client script supports OpenClaw repository automation.
 import path from "node:path";
 import { setTimeout as setNodeTimeout, clearTimeout as clearNodeTimeout } from "node:timers";
 import { pathToFileURL } from "node:url";

scripts/e2e/mcp-code-mode-gateway-seed.ts

@@ -1,3 +1,4 @@
+// Mcp Code Mode Gateway Seed script supports OpenClaw repository automation.
 import fs from "node:fs/promises";
 import { createRequire } from "node:module";
 import os from "node:os";

scripts/e2e/mcp-connect-timeout.ts

@@ -1,3 +1,4 @@
+// Mcp Connect Timeout script supports OpenClaw repository automation.
 type McpConnectTransport = {
   close?(): Promise<void> | void;
 };

scripts/e2e/mcp-websocket-open.ts

@@ -1,3 +1,4 @@
+// Mcp Websocket Open script supports OpenClaw repository automation.
 type WebSocketOpenHandle = {
   close?: () => void;
   off?: (event: "open" | "error" | "close", listener: (...args: unknown[]) => void) => void;

scripts/e2e/openai-image-auth-docker-client.ts

@@ -1,3 +1,4 @@
+// Openai Image Auth Docker Client script supports OpenClaw repository automation.
 import http from "node:http";
 import type { AddressInfo } from "node:net";
 import path from "node:path";

scripts/e2e/parallels/agent-workspace.ts

@@ -1,3 +1,4 @@
+// Agent Workspace script supports OpenClaw repository automation.
 export function posixAgentWorkspaceScript(purpose: string): string {
   return `set -eu
 workspace="\${OPENCLAW_WORKSPACE_DIR:-$HOME/.openclaw/workspace}"

scripts/e2e/parallels/common.ts

@@ -1,3 +1,4 @@
+// Common helper supports OpenClaw script workflows.
 export * from "./filesystem.ts";
 export * from "./env-limits.ts";
 export * from "./host-command.ts";

scripts/e2e/parallels/env-limits.ts

@@ -1,3 +1,4 @@
+// Env Limits script supports OpenClaw repository automation.
 import { die } from "./host-command.ts";
 
 const positiveIntPattern = /^[1-9]\d*$/u;

scripts/e2e/parallels/filesystem.ts

@@ -1,3 +1,4 @@
+// Filesystem script supports OpenClaw repository automation.
 import { mkdirSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";
 import { access, mkdir, readFile, rm, writeFile } from "node:fs/promises";
 import path from "node:path";

scripts/e2e/parallels/guest-transports.ts

@@ -1,3 +1,4 @@
+// Guest Transports script supports OpenClaw repository automation.
 import { run } from "./host-command.ts";
 import type { PhaseRunner } from "./phase-runner.ts";
 import { encodePowerShell, psSingleQuote } from "./powershell.ts";

scripts/e2e/parallels/host-command.ts

@@ -1,3 +1,4 @@
+// Host Command script supports OpenClaw repository automation.
 import { spawn, spawnSync, type SpawnOptions, type SpawnSyncReturns } from "node:child_process";
 import { writeFile } from "node:fs/promises";
 import path from "node:path";

scripts/e2e/parallels/host-server.ts

@@ -1,3 +1,4 @@
+// Host Server script supports OpenClaw repository automation.
 import { spawn, type ChildProcessWithoutNullStreams } from "node:child_process";
 import { createServer } from "node:http";
 import { createConnection } from "node:net";

scripts/e2e/parallels/lane-runner.ts

@@ -1,3 +1,4 @@
+// Lane Runner script supports OpenClaw repository automation.
 import { warn } from "./host-command.ts";
 
 export type SmokeLane = "fresh" | "upgrade";

scripts/e2e/parallels/linux-smoke.ts

@@ -1,4 +1,5 @@
 #!/usr/bin/env -S pnpm tsx
+// Linux Smoke script supports OpenClaw repository automation.
 import { mkdir, readFile } from "node:fs/promises";
 import path from "node:path";
 import { pathToFileURL } from "node:url";

scripts/e2e/parallels/macos-discord.ts

@@ -1,3 +1,4 @@
+// Macos Discord script supports OpenClaw repository automation.
 import { readFile, writeFile } from "node:fs/promises";
 import path from "node:path";
 import type { MacosGuest } from "./guest-transports.ts";

scripts/e2e/parallels/macos-smoke.ts

@@ -1,4 +1,5 @@
 #!/usr/bin/env -S pnpm tsx
+// Macos Smoke script supports OpenClaw repository automation.
 import { readFile, rm } from "node:fs/promises";
 import path from "node:path";
 import { pathToFileURL } from "node:url";

scripts/e2e/parallels/npm-update-scripts.ts

@@ -1,3 +1,4 @@
+// Npm Update Scripts script supports OpenClaw repository automation.
 import { posixAgentWorkspaceScript, windowsAgentWorkspaceScript } from "./agent-workspace.ts";
 import { shellQuote } from "./host-command.ts";
 import { posixProviderOnlyPluginIsolationScript } from "./plugin-isolation.ts";

scripts/e2e/parallels/npm-update-smoke.ts

@@ -1,4 +1,5 @@
 #!/usr/bin/env -S pnpm tsx
+// Npm Update Smoke script supports OpenClaw repository automation.
 import { spawn } from "node:child_process";
 import { appendFileSync, readFileSync, writeFileSync } from "node:fs";
 import { readFile, rm } from "node:fs/promises";

scripts/e2e/parallels/package-artifact.ts

@@ -1,3 +1,4 @@
+// Package Artifact script supports OpenClaw repository automation.
 import { randomUUID } from "node:crypto";
 import { copyFile, mkdir, readFile, rm, stat, writeFile } from "node:fs/promises";
 import { tmpdir } from "node:os";

scripts/e2e/parallels/parallels-vm.ts

@@ -1,3 +1,4 @@
+// Parallels Vm script supports OpenClaw repository automation.
 import { die, run, say, warn } from "./host-command.ts";
 
 const PRLCTL_STATUS_TIMEOUT_MS = 30_000;

scripts/e2e/parallels/phase-runner.ts

@@ -1,3 +1,4 @@
+// Phase Runner script supports OpenClaw repository automation.
 import { appendFileSync } from "node:fs";
 import { writeFile } from "node:fs/promises";
 import path from "node:path";

scripts/e2e/parallels/plugin-isolation.ts

@@ -1,3 +1,4 @@
+// Plugin Isolation script supports OpenClaw repository automation.
 import { shellQuote } from "./host-command.ts";
 import { providerIdFromModelId } from "./provider-auth.ts";
 

scripts/e2e/parallels/powershell.ts

@@ -1,3 +1,4 @@
+// Powershell script supports OpenClaw repository automation.
 import {
   configPathMapKey,
   modelProviderConfigBatchJson,

scripts/e2e/parallels/provider-auth.ts

@@ -1,3 +1,4 @@
+// Provider Auth script supports OpenClaw repository automation.
 import { mkdtempSync, rmSync, writeFileSync } from "node:fs";
 import { tmpdir } from "node:os";
 import path from "node:path";

scripts/e2e/parallels/smoke-common.ts

@@ -1,3 +1,4 @@
+// Smoke Common helper supports OpenClaw script workflows.
 import { readFile, rm } from "node:fs/promises";
 import path from "node:path";
 import { run, say } from "./host-command.ts";

scripts/e2e/parallels/snapshots.ts

@@ -1,3 +1,4 @@
+// Snapshots script supports OpenClaw repository automation.
 import { die, run } from "./host-command.ts";
 import type { SnapshotInfo } from "./types.ts";
 

scripts/e2e/parallels/types.ts

@@ -1,3 +1,4 @@
+// Types script supports OpenClaw repository automation.
 export type Provider = "openai" | "anthropic" | "minimax";
 export type Mode = "fresh" | "upgrade" | "both";
 export type Platform = "macos" | "windows" | "linux";

scripts/e2e/parallels/update-job-timeout.ts

@@ -1,3 +1,4 @@
+// Update Job Timeout script supports OpenClaw repository automation.
 interface TimedUpdateJobOptions {
   append(this: void, chunk: string): void;
   label: string;

scripts/e2e/parallels/windows-git.ts

@@ -1,3 +1,4 @@
+// Windows Git script supports OpenClaw repository automation.
 import path from "node:path";
 import type { WindowsGuest } from "./guest-transports.ts";
 import { die, run, say } from "./host-command.ts";

scripts/e2e/parallels/windows-smoke.ts

@@ -1,4 +1,5 @@
 #!/usr/bin/env -S pnpm tsx
+// Windows Smoke script supports OpenClaw repository automation.
 import path from "node:path";
 import { pathToFileURL } from "node:url";
 import { windowsAgentWorkspaceScript } from "./agent-workspace.ts";

scripts/e2e/telegram-bot-api.ts

@@ -1,3 +1,4 @@
+// Telegram Bot Api script supports OpenClaw repository automation.
 import { readBoundedResponseText } from "../lib/bounded-response.ts";
 import { readPositiveIntEnv } from "./lib/env-limits.mjs";
 

scripts/e2e/telegram-user-crabbox-proof.ts

@@ -1,4 +1,5 @@
 #!/usr/bin/env -S node --import tsx
+// Telegram User Crabbox Proof script supports OpenClaw repository automation.
 
 import { type ChildProcess, spawn, type SpawnOptionsWithoutStdio } from "node:child_process";
 import fs from "node:fs";

scripts/e2e/telegram-user-credential-io.ts

@@ -1,3 +1,4 @@
+// Telegram User Credential Io script supports OpenClaw repository automation.
 import { spawn } from "node:child_process";
 import { readBoundedResponseText } from "../lib/bounded-response.ts";
 
@@ -36,11 +37,15 @@ function readKillGraceMs() {
     return 5_000;
   }
   if (!/^\d+$/u.test(raw)) {
-    throw new Error(`OPENCLAW_QA_CREDENTIAL_KILL_GRACE_MS must be a non-negative integer; got: ${raw}`);
+    throw new Error(
+      `OPENCLAW_QA_CREDENTIAL_KILL_GRACE_MS must be a non-negative integer; got: ${raw}`,
+    );
   }
   const parsed = Number(raw);
   if (!Number.isSafeInteger(parsed)) {
-    throw new Error(`OPENCLAW_QA_CREDENTIAL_KILL_GRACE_MS must be a non-negative integer; got: ${raw}`);
+    throw new Error(
+      `OPENCLAW_QA_CREDENTIAL_KILL_GRACE_MS must be a non-negative integer; got: ${raw}`,
+    );
   }
   return parsed;
 }
@@ -183,7 +188,9 @@ export function runCommand(
         return;
       }
       if (forwardedSignalExitCode !== undefined) {
-        activeChildTree.unregister({ finishForwardedSignal: !childProcessTreeMayStillExist(child) });
+        activeChildTree.unregister({
+          finishForwardedSignal: !childProcessTreeMayStillExist(child),
+        });
         return;
       }
       if (timedOutError && killTimer && childProcessTreeMayStillExist(child)) {

scripts/e2e/telegram-user-credential-paths.ts

@@ -1,3 +1,4 @@
+// Telegram User Credential Paths script supports OpenClaw repository automation.
 import { chmod, mkdir, writeFile } from "node:fs/promises";
 import path from "node:path";
 

scripts/e2e/telegram-user-credential.ts

@@ -1,4 +1,5 @@
 #!/usr/bin/env -S node --import tsx
+// Telegram User Credential script supports OpenClaw repository automation.
 
 import { createHash } from "node:crypto";
 import { copyFile, mkdir, mkdtemp, readFile, rm, unlink, writeFile } from "node:fs/promises";

scripts/firecrawl-compare.ts

@@ -1,3 +1,4 @@
+// Firecrawl Compare script supports OpenClaw repository automation.
 import { pathToFileURL } from "node:url";
 import { fetchFirecrawlContent } from "../extensions/firecrawl/api.ts";
 import { extractReadableContent } from "../src/agents/tools/web-tools.js";

scripts/fixtures/packed-plugin-sdk-type-smoke.ts

@@ -1,3 +1,4 @@
+// Packed Plugin Sdk Type Smoke script supports OpenClaw repository automation.
 type PublicPluginSdkModules = [
   typeof import("openclaw/plugin-sdk"),
   typeof import("openclaw/plugin-sdk/channel-entry-contract"),

scripts/generate-base-config-schema.ts

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+// Generate Base Config Schema script supports OpenClaw repository automation.
 import { pathToFileURL } from "node:url";
 import { computeBaseConfigSchemaResponse } from "../src/config/schema-base.js";
 

scripts/generate-bundled-channel-config-metadata.ts

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+// Generate Bundled Channel Config Metadata script supports OpenClaw repository automation.
 import fs from "node:fs";
 import path from "node:path";
 import { loadBundledPluginPublicArtifactModuleSync } from "../src/plugins/public-surface-loader.js";

scripts/generate-config-doc-baseline.ts

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+// Generate Config Doc Baseline script supports OpenClaw repository automation.
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 import { writeConfigDocBaselineArtifacts } from "../src/config/doc-baseline.js";

scripts/generate-plugin-sdk-api-baseline.ts

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+// Generate Plugin Sdk Api Baseline script supports OpenClaw repository automation.
 import path from "node:path";
 import { writePluginSdkApiBaselineStatefile } from "../src/plugin-sdk/api-baseline.ts";
 

scripts/generate-prompt-snapshots.ts

@@ -1,3 +1,4 @@
+// Generate Prompt Snapshots script supports OpenClaw repository automation.
 import { execFile } from "node:child_process";
 import fs from "node:fs/promises";
 import os from "node:os";

scripts/generate-runtime-sidecar-paths-baseline.ts

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+// Generate Runtime Sidecar Paths Baseline script supports OpenClaw repository automation.
 import path from "node:path";
 import { writeBundledRuntimeSidecarPathBaseline } from "../src/plugins/runtime-sidecar-paths-baseline.js";
 

scripts/generate-secretref-credential-matrix.ts

@@ -1,3 +1,4 @@
+// Generate Secretref Credential Matrix script supports OpenClaw repository automation.
 import fs from "node:fs";
 import path from "node:path";
 import { buildSecretRefCredentialMatrix } from "../src/secrets/credential-matrix.js";

scripts/gh-read.ts

@@ -1,3 +1,4 @@
+// Gh Read script supports OpenClaw repository automation.
 import { execFileSync, spawnSync } from "node:child_process";
 import { createPrivateKey, createSign } from "node:crypto";
 import { readFileSync } from "node:fs";

scripts/ios-pin-version.ts

@@ -1,3 +1,4 @@
+// Ios Pin Version script supports OpenClaw repository automation.
 import path from "node:path";
 import {
   normalizePinnedIosVersion,

scripts/ios-sync-versioning.ts

@@ -1,3 +1,4 @@
+// Ios Sync Versioning script supports OpenClaw repository automation.
 import path from "node:path";
 import { syncIosVersioning } from "./lib/ios-version.ts";
 

scripts/ios-version.ts

@@ -1,3 +1,4 @@
+// Ios Version script supports OpenClaw repository automation.
 import path from "node:path";
 import { resolveIosVersion } from "./lib/ios-version.ts";
 

scripts/label-open-issues.ts

@@ -1,3 +1,4 @@
+// Label Open Issues script supports OpenClaw repository automation.
 import { execFileSync } from "node:child_process";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";

scripts/lib/bounded-response.ts

@@ -1,3 +1,4 @@
+// Bounded Response script supports OpenClaw repository automation.
 type BoundedResponseTextOptions = {
   createTooLargeError?: (message: string) => Error;
   formatTooLargeMessage?: (label: string, maxBytes: number) => string;

scripts/lib/bundled-extension-manifest.ts

@@ -1,3 +1,4 @@
+// Bundled Extension Manifest script supports OpenClaw repository automation.
 import { validateMinHostVersion } from "../../src/plugins/min-host-version.ts";
 import { isRecord } from "../../src/utils.js";
 

scripts/lib/bundled-plugin-build-entries-types.d.ts

@@ -1,3 +1,4 @@
+// Bundled Plugin Build Entries Types.D script supports OpenClaw repository automation.
 export type BundledPluginBuildEntry = {
   id: string;
   hasPackageJson: boolean;

scripts/lib/bundled-plugin-build-entries.d.ts

@@ -1 +1,2 @@
+// Bundled Plugin Build Entries.D script supports OpenClaw repository automation.
 export * from "./bundled-plugin-build-entries-types.js";

scripts/lib/codex-app-server-protocol-source.ts

@@ -1,3 +1,4 @@
+// Codex App Server Protocol Source script supports OpenClaw repository automation.
 import { spawnSync } from "node:child_process";
 import fs from "node:fs/promises";
 import path from "node:path";
@@ -82,9 +83,7 @@ export function buildCodexProtocolExportArgs(manifestPath: string, outDir: strin
   ];
 }
 
-export function resolveCodexProtocolMinFreeBytes(
+export function resolveCodexProtocolMinFreeBytes(env: NodeJS.ProcessEnv = process.env): number {
-  env: NodeJS.ProcessEnv = process.env,
-): number {
   const raw = env.OPENCLAW_CODEX_PROTOCOL_MIN_FREE_BYTES;
   if (raw === undefined || raw.trim() === "") {
     return DEFAULT_PROTOCOL_GENERATION_MIN_FREE_BYTES;
@@ -104,7 +103,9 @@ export function resolveCodexProtocolCargoTargetDir(
 ): string {
   const targetDir = env.CARGO_TARGET_DIR ?? env.CARGO_BUILD_TARGET_DIR;
   if (targetDir !== undefined && targetDir.trim() !== "") {
-    return path.isAbsolute(targetDir) ? path.resolve(targetDir) : path.resolve(codexRepo, targetDir);
+    return path.isAbsolute(targetDir)
+      ? path.resolve(targetDir)
+      : path.resolve(codexRepo, targetDir);
   }
   return path.join(codexRepo, "codex-rs", "target");
 }

scripts/lib/copy-assets.ts

@@ -1,3 +1,4 @@
+// Copy Assets script supports OpenClaw repository automation.
 import fs from "node:fs";
 import path from "node:path";
 import { fileURLToPath } from "node:url";

scripts/lib/dev-tooling-safety.ts

@@ -1,3 +1,4 @@
+// Dev Tooling Safety script supports OpenClaw repository automation.
 import path from "node:path";
 import { redactSensitiveText } from "../../src/logging/redact.js";