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/scripts/qa-e2e.test.ts

@@ -0,0 +1,159 @@
+// Qa E2E tests cover qa e2e script behavior.
+import { describe, expect, it, vi } from "vitest";
+import type { QaSelfCheckResult } from "../../extensions/qa-lab/api.js";
+import {
+  enablePrivateQaScriptEnv,
+  main,
+  parseQaE2eArgs,
+  resolveQaE2eOutputPath,
+} from "../../scripts/qa-e2e.js";
+
+function makeSelfCheckResult(status: "pass" | "fail"): QaSelfCheckResult {
+  return {
+    outputPath: "/tmp/qa-self-check.md",
+    report: "",
+    checks: [{ name: "QA self-check scenario", status }],
+    scenarioResult: {
+      name: "QA self-check scenario",
+      status,
+      steps: [],
+    },
+  };
+}
+
+describe("qa-e2e script", () => {
+  it("enables private QA plugin SDK subpaths before loading QA Lab", () => {
+    const env: NodeJS.ProcessEnv = {};
+
+    enablePrivateQaScriptEnv(env);
+
+    expect(env.OPENCLAW_BUILD_PRIVATE_QA).toBe("1");
+    expect(env.OPENCLAW_ENABLE_PRIVATE_QA_CLI).toBe("1");
+    expect(env.OPENCLAW_DISABLE_BUNDLED_PLUGINS).toBe("0");
+  });
+
+  it("overrides inherited environment that would break the private QA self-check", () => {
+    const env: NodeJS.ProcessEnv = {
+      OPENCLAW_BUILD_PRIVATE_QA: "0",
+      OPENCLAW_ENABLE_PRIVATE_QA_CLI: "0",
+      OPENCLAW_DISABLE_BUNDLED_PLUGINS: "1",
+    };
+
+    enablePrivateQaScriptEnv(env);
+
+    expect(env.OPENCLAW_BUILD_PRIVATE_QA).toBe("1");
+    expect(env.OPENCLAW_ENABLE_PRIVATE_QA_CLI).toBe("1");
+    expect(env.OPENCLAW_DISABLE_BUNDLED_PLUGINS).toBe("0");
+  });
+
+  it("resolves the default self-check report path", () => {
+    expect(resolveQaE2eOutputPath([])).toBeUndefined();
+    expect(resolveQaE2eOutputPath([".artifacts/custom.md"])).toBe(".artifacts/custom.md");
+    expect(resolveQaE2eOutputPath(["--output", ".artifacts/custom.md"])).toBe(
+      ".artifacts/custom.md",
+    );
+    expect(resolveQaE2eOutputPath(["--", ".artifacts/custom.md"])).toBe(".artifacts/custom.md");
+  });
+
+  it("prints help before enabling private QA or loading QA Lab", async () => {
+    const env: NodeJS.ProcessEnv = {};
+    const loadRuntime = vi.fn(async () => {
+      throw new Error("runtime loaded");
+    });
+    const writeStdout = vi.fn();
+
+    await expect(main(["--help"], { env, loadRuntime, writeStdout })).resolves.toBe(0);
+
+    expect(loadRuntime).not.toHaveBeenCalled();
+    expect(writeStdout).toHaveBeenCalledWith(expect.stringContaining("Usage: pnpm qa:e2e"));
+    expect(env.OPENCLAW_BUILD_PRIVATE_QA).toBeUndefined();
+  });
+
+  it("rejects unknown options before enabling private QA or loading QA Lab", async () => {
+    const env: NodeJS.ProcessEnv = {};
+    const loadRuntime = vi.fn(async () => {
+      throw new Error("runtime loaded");
+    });
+
+    await expect(main(["--wat"], { env, loadRuntime })).rejects.toThrow(
+      "Unknown qa:e2e option: --wat",
+    );
+
+    expect(loadRuntime).not.toHaveBeenCalled();
+    expect(env.OPENCLAW_BUILD_PRIVATE_QA).toBeUndefined();
+  });
+
+  it("parses explicit output flags and package-manager separators", () => {
+    expect(parseQaE2eArgs(["--output=.artifacts/custom.md"])).toEqual({
+      help: false,
+      outputPath: ".artifacts/custom.md",
+    });
+    expect(parseQaE2eArgs(["--", ".artifacts/from-separator.md"])).toEqual({
+      help: false,
+      outputPath: ".artifacts/from-separator.md",
+    });
+    expect(() => parseQaE2eArgs(["--output", "--help"])).toThrow("--output requires a value");
+  });
+
+  it("rejects duplicate output destinations before loading QA Lab", async () => {
+    const env: NodeJS.ProcessEnv = {};
+    const loadRuntime = vi.fn(async () => {
+      throw new Error("runtime loaded");
+    });
+
+    expect(() =>
+      parseQaE2eArgs(["--output", ".artifacts/first.md", "--output=.artifacts/second.md"]),
+    ).toThrow("qa:e2e output path was provided more than once");
+    await expect(
+      main([".artifacts/first.md", "--output", ".artifacts/second.md"], { env, loadRuntime }),
+    ).rejects.toThrow("qa:e2e output path was provided more than once");
+
+    expect(loadRuntime).not.toHaveBeenCalled();
+    expect(env.OPENCLAW_BUILD_PRIVATE_QA).toBeUndefined();
+  });
+
+  it.each([
+    { status: "pass" as const, exitCode: 0 },
+    { status: "fail" as const, exitCode: 1 },
+  ])("exits with $exitCode when the self-check status is $status", async ({ status, exitCode }) => {
+    const result = makeSelfCheckResult(status);
+    const runQaE2eSelfCheck = vi.fn(async () => result);
+    const isQaSelfCheckSuccessful = vi.fn(() => status === "pass");
+    const writeStdout = vi.fn();
+    const env: NodeJS.ProcessEnv = {};
+
+    await expect(
+      main([".artifacts/custom.md"], {
+        env,
+        loadRuntime: async () => ({
+          isQaSelfCheckSuccessful,
+          runQaE2eSelfCheck,
+        }),
+        writeStdout,
+      }),
+    ).resolves.toBe(exitCode);
+
+    expect(runQaE2eSelfCheck).toHaveBeenCalledWith({ outputPath: ".artifacts/custom.md" });
+    expect(isQaSelfCheckSuccessful).toHaveBeenCalledWith(result);
+    expect(writeStdout).toHaveBeenCalledWith("QA self-check report: /tmp/qa-self-check.md\n");
+    expect(env.OPENCLAW_BUILD_PRIVATE_QA).toBe("1");
+  });
+
+  it("lets QA Lab choose the default self-check output path", async () => {
+    const result = makeSelfCheckResult("pass");
+    const runQaE2eSelfCheck = vi.fn(async () => result);
+    const env: NodeJS.ProcessEnv = {};
+
+    await expect(
+      main([], {
+        env,
+        loadRuntime: async () => ({
+          isQaSelfCheckSuccessful: () => true,
+          runQaE2eSelfCheck,
+        }),
+      }),
+    ).resolves.toBe(0);
+
+    expect(runQaE2eSelfCheck.mock.calls[0]).toEqual([]);
+  });
+});