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

extensions/qa-matrix/src/cli.runtime.test.ts

@@ -0,0 +1,181 @@
+// Qa Matrix tests cover cli plugin behavior.
+import { mkdir, mkdtemp, readFile, rm, symlink } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { afterEach, describe, expect, it, vi } from "vitest";
+
+const runMatrixQaLive = vi.hoisted(() => vi.fn());
+const closeGlobalDispatcher = vi.hoisted(() => vi.fn(async () => {}));
+
+vi.mock("./runners/contract/runtime.js", () => ({
+  runMatrixQaLive,
+}));
+vi.mock("undici", async () => {
+  const actual = await vi.importActual<typeof import("undici")>("undici");
+  return {
+    ...actual,
+    getGlobalDispatcher: () => ({
+      close: closeGlobalDispatcher,
+    }),
+  };
+});
+
+import { runQaMatrixCommand } from "./cli.runtime.js";
+
+const tmpDirs: string[] = [];
+
+async function expectPathMissing(targetPath: string): Promise<void> {
+  let error: unknown;
+  try {
+    await readFile(targetPath, "utf8");
+  } catch (caught) {
+    error = caught;
+  }
+  expect(error).toBeInstanceOf(Error);
+  expect((error as NodeJS.ErrnoException).code).toBe("ENOENT");
+}
+
+describe("matrix qa cli runtime", () => {
+  const originalRunNodeOutputLog = process.env.OPENCLAW_RUN_NODE_OUTPUT_LOG;
+
+  afterEach(async () => {
+    vi.clearAllMocks();
+    if (originalRunNodeOutputLog === undefined) {
+      delete process.env.OPENCLAW_RUN_NODE_OUTPUT_LOG;
+    } else {
+      process.env.OPENCLAW_RUN_NODE_OUTPUT_LOG = originalRunNodeOutputLog;
+    }
+    await Promise.all(tmpDirs.splice(0).map((dir) => rm(dir, { recursive: true, force: true })));
+  });
+
+  it("rejects non-env credential sources for the disposable Matrix lane", async () => {
+    await expect(
+      runQaMatrixCommand({
+        credentialSource: "convex",
+      }),
+    ).rejects.toThrow("Matrix QA currently supports only --credential-source env");
+  });
+
+  it("passes through default env credential source options", async () => {
+    const repoRoot = await mkdtemp(path.join(os.tmpdir(), "matrix-qa-cli-"));
+    tmpDirs.push(repoRoot);
+    runMatrixQaLive.mockResolvedValue({
+      reportPath: "/tmp/matrix-report.md",
+      summaryPath: "/tmp/matrix-summary.json",
+      observedEventsPath: "/tmp/matrix-events.json",
+      routeStateManifestPath: "/tmp/matrix-route-state.json",
+    });
+    const originalStdoutWrite = process.stdout["write"];
+    process.stdout.write = (() => true) as typeof process.stdout.write;
+
+    try {
+      await runQaMatrixCommand({
+        repoRoot,
+        outputDir: ".artifacts/qa-e2e/matrix",
+        providerMode: "mock-openai",
+        credentialSource: "env",
+      });
+    } finally {
+      process.stdout.write = originalStdoutWrite;
+    }
+
+    expect(runMatrixQaLive).toHaveBeenCalledWith({
+      repoRoot,
+      outputDir: path.join(repoRoot, ".artifacts/qa-e2e/matrix"),
+      providerMode: "mock-openai",
+      primaryModel: undefined,
+      alternateModel: undefined,
+      fastMode: undefined,
+      failFast: undefined,
+      profile: undefined,
+      scenarioIds: undefined,
+      sutAccountId: undefined,
+      credentialSource: "env",
+      credentialRole: undefined,
+    });
+    expect(closeGlobalDispatcher).toHaveBeenCalledTimes(1);
+  });
+
+  it("reuses a run-node output log instead of installing a nested tee", async () => {
+    const repoRoot = await mkdtemp(path.join(os.tmpdir(), "matrix-qa-cli-"));
+    tmpDirs.push(repoRoot);
+    const outputPath = path.join(repoRoot, "run-node-output.log");
+    process.env.OPENCLAW_RUN_NODE_OUTPUT_LOG = outputPath;
+    runMatrixQaLive.mockResolvedValue({
+      reportPath: "/tmp/matrix-report.md",
+      summaryPath: "/tmp/matrix-summary.json",
+      observedEventsPath: "/tmp/matrix-events.json",
+      routeStateManifestPath: "/tmp/matrix-route-state.json",
+    });
+    const originalStdoutWrite = process.stdout["write"];
+    process.stdout.write = vi.fn(() => true) as unknown as typeof process.stdout.write;
+
+    try {
+      await runQaMatrixCommand({
+        repoRoot,
+        outputDir: ".artifacts/qa-e2e/matrix",
+        providerMode: "mock-openai",
+        credentialSource: "env",
+      });
+    } finally {
+      process.stdout.write = originalStdoutWrite;
+    }
+
+    expect(runMatrixQaLive).toHaveBeenCalledOnce();
+    await expectPathMissing(outputPath);
+  });
+
+  it.runIf(process.platform !== "win32")(
+    "rejects output dirs that traverse repo-local symlinks",
+    async () => {
+      const repoRoot = await mkdtemp(path.join(os.tmpdir(), "matrix-qa-cli-"));
+      const externalOutputRoot = await mkdtemp(path.join(os.tmpdir(), "matrix-qa-external-"));
+      tmpDirs.push(repoRoot, externalOutputRoot);
+      await mkdir(path.join(repoRoot, ".artifacts"), { recursive: true });
+      await symlink(externalOutputRoot, path.join(repoRoot, ".artifacts", "qa-e2e"));
+
+      await expect(
+        runQaMatrixCommand({
+          repoRoot,
+          outputDir: ".artifacts/qa-e2e/matrix",
+          providerMode: "mock-openai",
+          credentialSource: "env",
+        }),
+      ).rejects.toThrow("Matrix QA output dir must not traverse symlinks.");
+
+      expect(runMatrixQaLive).not.toHaveBeenCalled();
+    },
+  );
+
+  it("preserves the Matrix QA failure when output log cleanup also fails", async () => {
+    const repoRoot = await mkdtemp(path.join(os.tmpdir(), "matrix-qa-cli-"));
+    tmpDirs.push(repoRoot);
+    const outputDir = path.join(repoRoot, ".artifacts", "qa-e2e", "matrix");
+    await mkdir(path.join(outputDir, "matrix-qa-output.log"), { recursive: true });
+    runMatrixQaLive.mockRejectedValue(new Error("scenario failed"));
+    const stderrChunks: string[] = [];
+    const originalStdoutWrite = process.stdout["write"];
+    const originalStderrWrite = process.stderr["write"];
+    process.stdout.write = (() => true) as typeof process.stdout.write;
+    process.stderr.write = ((chunk: string | Buffer) => {
+      stderrChunks.push(String(chunk));
+      return true;
+    }) as typeof process.stderr.write;
+
+    try {
+      await expect(
+        runQaMatrixCommand({
+          repoRoot,
+          outputDir: ".artifacts/qa-e2e/matrix",
+          providerMode: "mock-openai",
+          credentialSource: "env",
+        }),
+      ).rejects.toThrow("scenario failed");
+    } finally {
+      process.stdout.write = originalStdoutWrite;
+      process.stderr.write = originalStderrWrite;
+    }
+
+    expect(stderrChunks.join("")).toContain("Matrix QA output log error");
+  });
+});