test(scripts): route doctor install wrapper helper

scripts/test-projects.test-support.mjs

@@ -1546,6 +1546,10 @@ const TOOLING_SOURCE_TEST_TARGETS = new Map([
     "scripts/e2e/lib/doctor-install-switch/scenario.sh",
     ["test/scripts/docker-build-helper.test.ts"],
   ],
+  [
+    "scripts/e2e/lib/doctor-install-switch/write-wrapper.mjs",
+    ["test/scripts/doctor-install-switch-wrapper.test.ts"],
+  ],
   [
     "scripts/e2e/lib/doctor-install-switch/shims/loginctl",
     ["test/scripts/docker-build-helper.test.ts"],

test/scripts/doctor-install-switch-wrapper.test.ts

@@ -0,0 +1,65 @@
+// Doctor Install Switch Wrapper tests cover the generated wrapper script contract.
+import { spawnSync } from "node:child_process";
+import { chmodSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import path from "node:path";
+import { afterEach, describe, expect, it } from "vitest";
+import { cleanupTempDirs, makeTempDir } from "../helpers/temp-dir.js";
+
+const SCRIPT_PATH = "scripts/e2e/lib/doctor-install-switch/write-wrapper.mjs";
+const tempDirs: string[] = [];
+
+afterEach(() => {
+  cleanupTempDirs(tempDirs);
+});
+
+function runWriter(args: string[]) {
+  return spawnSync(process.execPath, [SCRIPT_PATH, ...args], {
+    encoding: "utf8",
+    env: { ...process.env },
+  });
+}
+
+describe("doctor install switch wrapper writer", () => {
+  it("writes an executable wrapper that preserves quoted paths and arguments", () => {
+    const root = makeTempDir(tempDirs, "openclaw-doctor-wrapper-");
+    const npmDir = path.join(root, "bin with ' quote");
+    mkdirSync(npmDir);
+
+    const fakeNpm = path.join(npmDir, "npm mock");
+    const forwardedArgsPath = path.join(root, "forwarded args.json");
+    writeFileSync(
+      fakeNpm,
+      `#!/usr/bin/env node
+const fs = require("node:fs");
+fs.writeFileSync(${JSON.stringify(forwardedArgsPath)}, JSON.stringify(process.argv.slice(2)));
+`,
+      { encoding: "utf8", mode: 0o755 },
+    );
+    chmodSync(fakeNpm, 0o755);
+
+    const wrapperPath = path.join(root, "openclaw wrapper");
+    const wrapperLogPath = path.join(root, "wrapper log with ' quote.txt");
+    const writeResult = runWriter([wrapperPath, fakeNpm, wrapperLogPath]);
+
+    expect(writeResult.status).toBe(0);
+    expect(writeResult.stderr).toBe("");
+
+    const args = ["gateway", "install", "--flag=value with spaces", "it's quoted"];
+    const wrapperResult = spawnSync(wrapperPath, args, {
+      encoding: "utf8",
+      env: { ...process.env },
+    });
+
+    expect(wrapperResult.status).toBe(0);
+    expect(wrapperResult.stderr).toBe("");
+    expect(readFileSync(wrapperLogPath, "utf8")).toBe(`${args.join("\n")}\n`);
+    expect(JSON.parse(readFileSync(forwardedArgsPath, "utf8"))).toEqual(args);
+  });
+
+  it("rejects missing required arguments before writing a wrapper", () => {
+    const result = runWriter([]);
+
+    expect(result.status).toBe(1);
+    expect(result.stderr).toContain("usage: write-wrapper.mjs <wrapper-path> <npm-bin> [log-path]");
+  });
+});

test/scripts/test-projects.test.ts

@@ -487,6 +487,10 @@ describe("scripts/test-projects changed-target routing", () => {
         "scripts/e2e/lib/doctor-install-switch/scenario.sh",
         ["test/scripts/docker-build-helper.test.ts"],
       ],
+      [
+        "scripts/e2e/lib/doctor-install-switch/write-wrapper.mjs",
+        ["test/scripts/doctor-install-switch-wrapper.test.ts"],
+      ],
       [
         "scripts/e2e/lib/doctor-install-switch/shims/loginctl",
         ["test/scripts/docker-build-helper.test.ts"],