docs(gateway): explain ESRCH signal race

steipete · krissding · steipete · commit 6570c2fa99db · 2026-07-16T21:08:06.000-07:00
Co-authored-by: 丁宇婷0668001435 &lt;ding.yuting@xydigit.com&gt;
diff --git a/src/infra/gateway-processes.ts b/src/infra/gateway-processes.ts
@@ -46,6 +46,8 @@ export function signalVerifiedGatewayPidSync(pid: number, signal: "SIGTERM" | "S
   try {
     process.kill(pid, signal);
   } catch (err) {
+    // The verified process can exit between argv inspection and signaling;
+    // ESRCH already satisfies the requested stop or restart handoff.
     if ((err as NodeJS.ErrnoException).code !== "ESRCH") {
       throw err;
     }

Original file line number	Diff line number	Diff line change
`@@ -46,6 +46,8 @@ export function signalVerifiedGatewayPidSync(pid: number, signal: "SIGTERM" \| "S`
`46`	`46`	`try {`
`47`	`47`	`process.kill(pid, signal);`
`48`	`48`	`} catch (err) {`
	`49`	`+ // The verified process can exit between argv inspection and signaling;`
	`50`	`+ // ESRCH already satisfies the requested stop or restart handoff.`
`49`	`51`	`if ((err as NodeJS.ErrnoException).code !== "ESRCH") {`
`50`	`52`	`throw err;`
`51`	`53`	`}`