fix(scripts): bound clawtributor GitHub lookups (#109968)

test/scripts/update-clawtributors.test.ts

@@ -1,19 +1,30 @@
 // Update Clawtributors tests cover update clawtributors script behavior.
+import { execFileSync as realExecFileSync } from "node:child_process";
+import type { ExecFileSyncOptionsWithStringEncoding } from "node:child_process";
 import { resolve } from "node:path";
 import { pathToFileURL } from "node:url";
 import { afterEach, describe, expect, it, vi } from "vitest";
 
 const originalCwd = process.cwd();
 
+type GhRunner = (args: readonly string[], options: ExecFileSyncOptionsWithStringEncoding) => string;
+
 afterEach(() => {
   vi.useRealTimers();
   vi.unstubAllGlobals();
   vi.doUnmock("node:fs");
   vi.doUnmock("node:child_process");
+  vi.doUnmock("../../scripts/lib/plain-gh.mjs");
   vi.resetModules();
 });
 
-function mockClawtributorsFixture() {
+function mockClawtributorsFixture({
+  ensureLogins = [],
+  runGh,
+}: {
+  ensureLogins?: string[];
+  runGh?: GhRunner;
+} = {}) {
   const readme = [
     "# Fixture",
     "",
@@ -27,7 +38,7 @@ function mockClawtributorsFixture() {
   vi.doMock("node:fs", () => ({
     readFileSync: vi.fn((path: string) => {
       if (path.endsWith("scripts/clawtributors-map.json")) {
-        return "{}\n";
+        return `${JSON.stringify({ ensureLogins })}\n`;
       }
       if (path.endsWith("README.md")) {
         return readme;
@@ -50,18 +61,9 @@ function mockClawtributorsFixture() {
     contributions: 3,
   };
   const execSync = vi.fn((cmd: string) => {
-    if (cmd === 'gh api "repos/openclaw/openclaw/contributors?per_page=100&anon=1" --paginate') {
-      return `${JSON.stringify([contributor])}\n`;
-    }
     if (cmd === "git log --reverse --format=%aN%x1f%aE%x1f%aI --numstat") {
       return "";
     }
-    if (
-      cmd ===
-      "gh pr list -R openclaw/openclaw --state merged --limit 5000 --json author --jq '.[].author.login'"
-    ) {
-      return "";
-    }
     if (cmd === "git rev-list --max-parents=0 HEAD") {
       return "root-sha\n";
     }
@@ -70,13 +72,53 @@ function mockClawtributorsFixture() {
     }
     throw new Error(`unexpected command: ${cmd}`);
   });
+  const execPlainGh = vi.fn(
+    (args: readonly string[], options: ExecFileSyncOptionsWithStringEncoding) => {
+      if (runGh) {
+        return runGh(args, options);
+      }
+      if (
+        args.join("\0") ===
+        ["api", "repos/openclaw/openclaw/contributors?per_page=100&anon=1", "--paginate"].join("\0")
+      ) {
+        return `${JSON.stringify([contributor])}\n`;
+      }
+      if (
+        args.join("\0") ===
+        [
+          "pr",
+          "list",
+          "-R",
+          "openclaw/openclaw",
+          "--state",
+          "merged",
+          "--limit",
+          "5000",
+          "--json",
+          "author",
+          "--jq",
+          ".[].author.login",
+        ].join("\0")
+      ) {
+        return "";
+      }
+      if (args[0] === "api" && args[1]?.startsWith("users/")) {
+        const login = args[1].slice("users/".length);
+        return JSON.stringify({
+          login,
+          html_url: `https://github.com/${login}`,
+          avatar_url: "https://avatars.githubusercontent.com/u/2?v=4",
+        });
+      }
+      throw new Error(`unexpected gh arguments: ${args.join(" ")}`);
+    },
+  );
+  vi.doMock("../../scripts/lib/plain-gh.mjs", () => ({ execPlainGh }));
   vi.doMock("node:child_process", () => ({
-    execFileSync: vi.fn(() => {
-      throw new Error("unexpected execFileSync");
-    }),
     execSync,
   }));
   return {
+    execPlainGh,
     readWrittenReadme: () => writtenReadme,
   };
 }
@@ -87,6 +129,67 @@ async function importUpdateClawtributors() {
 }
 
 describe("update-clawtributors", () => {
+  it("bounds every GitHub CLI lookup", async () => {
+    const fixture = mockClawtributorsFixture({ ensureLogins: ["extra"] });
+    vi.stubGlobal(
+      "fetch",
+      vi.fn(async () => new Response(null, { status: 404 })),
+    );
+    vi.spyOn(console, "log").mockImplementation(() => undefined);
+
+    await importUpdateClawtributors();
+
+    const options = {
+      encoding: "utf8",
+      stdio: ["ignore", "pipe", "pipe"],
+      maxBuffer: 1024 * 1024 * 200,
+      timeout: 120_000,
+      killSignal: "SIGKILL",
+    };
+    expect(fixture.execPlainGh).toHaveBeenNthCalledWith(
+      1,
+      ["api", "repos/openclaw/openclaw/contributors?per_page=100&anon=1", "--paginate"],
+      options,
+    );
+    expect(fixture.execPlainGh).toHaveBeenNthCalledWith(2, ["api", "users/extra"], options);
+    expect(fixture.execPlainGh).toHaveBeenNthCalledWith(
+      3,
+      [
+        "pr",
+        "list",
+        "-R",
+        "openclaw/openclaw",
+        "--state",
+        "merged",
+        "--limit",
+        "5000",
+        "--json",
+        "author",
+        "--jq",
+        ".[].author.login",
+      ],
+      options,
+    );
+  });
+
+  it("kills a sleeping GitHub CLI process at the deadline", async () => {
+    const fixture = mockClawtributorsFixture({
+      runGh: (_args, options) => {
+        expect(options).toMatchObject({ timeout: 120_000, killSignal: "SIGKILL" });
+        return realExecFileSync(process.execPath, ["-e", "setInterval(() => {}, 1_000)"], {
+          ...options,
+          timeout: 50,
+        });
+      },
+    });
+
+    await expect(importUpdateClawtributors()).rejects.toMatchObject({
+      code: "ETIMEDOUT",
+      signal: "SIGKILL",
+    });
+    expect(fixture.execPlainGh).toHaveBeenCalledTimes(1);
+  });
+
   it("rejects unsafe avatar probe content lengths before reading the body", async () => {
     const fixture = mockClawtributorsFixture();
     const arrayBuffer = vi.fn(async () => new ArrayBuffer(0));