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/test-perf-budget.mjs

@@ -0,0 +1,141 @@
+// Runs a Vitest config and enforces wall-time regression budgets.
+import { pathToFileURL } from "node:url";
+import { booleanFlag, parseFlagArgs, stringFlag } from "./lib/arg-utils.mjs";
+import {
+  budgetFloatFlag,
+  parseBudgetNumber,
+  readBudgetEnvNumber,
+} from "./lib/budget-number-args.mjs";
+import { formatMs } from "./lib/vitest-report-cli-utils.mjs";
+import { readJsonFile, runVitestJsonReport } from "./test-report-utils.mjs";
+
+function readBooleanEnv(name, env = process.env) {
+  const normalized = env[name]?.trim().toLowerCase();
+  return normalized === "1" || normalized === "true" || normalized === "yes";
+}
+
+function parseArgs(argv, env = process.env) {
+  const opts = parseFlagArgs(
+    argv,
+    {
+      config: "test/vitest/vitest.unit.config.ts",
+      maxWallMs: readBudgetEnvNumber("OPENCLAW_TEST_PERF_MAX_WALL_MS", env),
+      baselineWallMs: readBudgetEnvNumber("OPENCLAW_TEST_PERF_BASELINE_WALL_MS", env),
+      maxRegressionPct: readBudgetEnvNumber("OPENCLAW_TEST_PERF_MAX_REGRESSION_PCT", env) ?? 10,
+      reportOnly: readBooleanEnv("OPENCLAW_TEST_PERF_REPORT_ONLY", env),
+    },
+    [
+      stringFlag("--config", "config"),
+      budgetFloatFlag("--max-wall-ms", "maxWallMs"),
+      budgetFloatFlag("--baseline-wall-ms", "baselineWallMs"),
+      budgetFloatFlag("--max-regression-pct", "maxRegressionPct"),
+      booleanFlag("--report-only", "reportOnly", true),
+    ],
+  );
+  if (opts.maxWallMs === null && opts.baselineWallMs === null && opts.reportOnly !== true) {
+    throw new Error(
+      "[test-perf-budget] provide --max-wall-ms, --baseline-wall-ms, or set --report-only for an explicit timing-only run",
+    );
+  }
+  return opts;
+}
+
+function formatErrorMessage(error) {
+  return error instanceof Error ? error.message : String(error);
+}
+
+function collectPerfReportStats(reportPath) {
+  let report;
+  try {
+    report = readJsonFile(reportPath);
+  } catch (error) {
+    throw new Error(
+      `[test-perf-budget] failed to read Vitest JSON report ${reportPath}: ${formatErrorMessage(
+        error,
+      )}`,
+      { cause: error },
+    );
+  }
+
+  let totalFileDurationMs = 0;
+  let fileCount = 0;
+  for (const result of report.testResults ?? []) {
+    if (typeof result.startTime === "number" && typeof result.endTime === "number") {
+      totalFileDurationMs += Math.max(0, result.endTime - result.startTime);
+      fileCount += 1;
+    }
+  }
+  if (fileCount === 0) {
+    throw new Error(`[test-perf-budget] Vitest JSON report contained no timed file results`);
+  }
+  return { fileCount, totalFileDurationMs };
+}
+
+function main() {
+  let opts;
+  try {
+    opts = parseArgs(process.argv.slice(2));
+  } catch (error) {
+    console.error(error instanceof Error ? error.message : String(error));
+    process.exit(1);
+  }
+
+  const startedAt = process.hrtime.bigint();
+  const reportPath = runVitestJsonReport({
+    config: opts.config,
+    prefix: "openclaw-vitest-perf",
+  });
+  const elapsedMs = Number.parseFloat(String(process.hrtime.bigint() - startedAt)) / 1_000_000;
+
+  let reportStats;
+  try {
+    reportStats = collectPerfReportStats(reportPath);
+  } catch (error) {
+    console.error(formatErrorMessage(error));
+    process.exit(1);
+  }
+
+  const allowedByBaseline =
+    opts.baselineWallMs !== null
+      ? opts.baselineWallMs * (1 + (opts.maxRegressionPct ?? 0) / 100)
+      : null;
+
+  let failed = false;
+  if (opts.maxWallMs !== null && elapsedMs > opts.maxWallMs) {
+    console.error(
+      `[test-perf-budget] wall time ${formatMs(elapsedMs)} exceeded max ${formatMs(
+        opts.maxWallMs,
+      )}.`,
+    );
+    failed = true;
+  }
+  if (allowedByBaseline !== null && elapsedMs > allowedByBaseline) {
+    console.error(
+      `[test-perf-budget] wall time ${formatMs(elapsedMs)} exceeded baseline budget ${formatMs(
+        allowedByBaseline,
+      )} (baseline ${formatMs(opts.baselineWallMs ?? 0)}, +${String(opts.maxRegressionPct)}%).`,
+    );
+    failed = true;
+  }
+
+  console.log(
+    `[test-perf-budget] config=${opts.config} wall=${formatMs(elapsedMs)} file-sum=${formatMs(
+      reportStats.totalFileDurationMs,
+    )} files=${String(reportStats.fileCount)}`,
+  );
+
+  if (failed) {
+    process.exit(1);
+  }
+}
+
+/** Test-facing parser helpers for budget validation. */
+export const testing = {
+  collectPerfReportStats,
+  parseArgs,
+  parseBudgetNumber,
+};
+
+if (process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href) {
+  main();
+}