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

test/setup.shared.ts

@@ -0,0 +1,100 @@
+// Shared test setup installs common Vitest mocks and cleanup behavior.
+import { vi } from "vitest";
+
+const openAiCodexTokenRefreshTestHook = "__OPENCLAW_TEST_REFRESH_OPENAI_CODEX_TOKEN__";
+type GlobalWithOpenAiCodexTokenRefreshTestHook = typeof globalThis & {
+  [openAiCodexTokenRefreshTestHook]?: ((...args: unknown[]) => unknown) | undefined;
+};
+
+vi.mock("../src/llm/oauth.js", () => ({
+  getOAuthApiKey: () => undefined,
+  getOAuthProviders: () => [],
+  loginOpenAICodex: vi.fn(),
+  refreshOpenAICodexToken: vi.fn((...args: unknown[]) =>
+    (globalThis as GlobalWithOpenAiCodexTokenRefreshTestHook)[openAiCodexTokenRefreshTestHook]?.(
+      ...args,
+    ),
+  ),
+  resetOAuthProviders: vi.fn(),
+}));
+
+vi.mock("@mariozechner/clipboard", () => ({
+  availableFormats: () => [],
+  getText: async () => "",
+  setText: async () => {},
+  hasText: () => false,
+  getImageBinary: async () => [],
+  getImageBase64: async () => "",
+  setImageBinary: async () => {},
+  setImageBase64: async () => {},
+  hasImage: () => false,
+  getHtml: async () => "",
+  setHtml: async () => {},
+  hasHtml: () => false,
+  getRtf: async () => "",
+  setRtf: async () => {},
+  hasRtf: () => false,
+  clear: async () => {},
+  watch: () => {},
+  callThreadsafeFunction: () => {},
+}));
+
+// Ensure Vitest environment is properly set.
+process.env.VITEST = "true";
+// Tests frequently point bundled plugin discovery at temp fixture roots. Production still rejects
+// arbitrary OPENCLAW_BUNDLED_PLUGINS_DIR overrides unless this Vitest-only opt-in is present.
+process.env.OPENCLAW_TEST_TRUST_BUNDLED_PLUGINS_DIR ??= "1";
+// Vitest fork workers can load transitive lockfile helpers many times per worker.
+// Raise listener budget to avoid noisy MaxListeners warnings and warning-stack overhead.
+const TEST_PROCESS_MAX_LISTENERS = 256;
+if (process.getMaxListeners() > 0 && process.getMaxListeners() < TEST_PROCESS_MAX_LISTENERS) {
+  process.setMaxListeners(TEST_PROCESS_MAX_LISTENERS);
+}
+
+import { installProcessWarningFilter } from "../src/infra/warning-filter.js";
+import { withIsolatedTestHome } from "./test-env.js";
+
+type SharedTestSetupOptions = {
+  loadProfileEnv?: boolean;
+};
+
+const SHARED_TEST_SETUP = Symbol.for("openclaw.sharedTestSetup");
+
+type SharedTestSetupHandle = {
+  cleanup: () => void;
+  tempHome: string;
+};
+
+export function installSharedTestSetup(options?: SharedTestSetupOptions): {
+  cleanup: () => void;
+  tempHome: string;
+} {
+  const globalState = globalThis as typeof globalThis & {
+    [SHARED_TEST_SETUP]?: SharedTestSetupHandle;
+  };
+  const existing = globalState[SHARED_TEST_SETUP];
+  if (existing) {
+    return existing;
+  }
+
+  const testEnv = withIsolatedTestHome({
+    loadProfileEnv: options?.loadProfileEnv,
+  });
+  installProcessWarningFilter();
+
+  let cleaned = false;
+  const handle: SharedTestSetupHandle = {
+    tempHome: testEnv.tempHome,
+    cleanup: () => {
+      if (cleaned) {
+        return;
+      }
+      cleaned = true;
+      testEnv.cleanup();
+      delete globalState[SHARED_TEST_SETUP];
+    },
+  };
+  process.once("exit", handle.cleanup);
+  globalState[SHARED_TEST_SETUP] = handle;
+  return handle;
+}