@mycadet/cli 0.12.11 → 0.13.0-dev.202610171617.9ea363e

package/src/lib/process.ts

@@ -1,3 +1,4 @@
+import { DAEMON_STOP_TIMEOUT_MS } from "@mycadet/local-mode";
 import { execFileSync } from "child_process";
 import { existsSync, readFileSync, unlinkSync } from "fs";
 import { platform } from "os";
@@ -324,6 +325,7 @@ export async function stopProcess(
     });
   },
   readIdentity: (pid: number) => string | null = readPosixCommandLine,
+  gracefulOnly = false,
 ): Promise<boolean> {
   try {
     process.kill(pid, 0);
@@ -339,6 +341,9 @@ export async function stopProcess(
   console.log(`Stopping ${label} (pid ${pid})...`);
   let waitForGracefulExit = true;
   if (hostPlatform === "win32") {
+    if (gracefulOnly) {
+      throw new Error("Graceful-only shutdown is not supported for Windows local services.");
+    }
     try {
       runTaskkill(["/PID", String(pid), "/T"], timeoutMs);
     } catch {
@@ -363,6 +368,7 @@ export async function stopProcess(
   } catch {
     return true;
   }
+  if (gracefulOnly) return false;
   if (hostPlatform === "win32") {
     console.log(`${label} did not exit, terminating its process tree...`);
     try {
@@ -415,6 +421,13 @@ export async function stopProcess(
   }
 }
 
+/** Stop a service without escalation. Failure preserves PID tracking and aborts capture/replacement. */
+export async function stopProcessGracefully(pid: number, label: string, timeoutMs = DAEMON_STOP_TIMEOUT_MS): Promise<boolean> {
+  const stopped = await stopProcess(pid, label, timeoutMs, undefined, undefined, undefined, true);
+  if (!stopped) throw new Error(`${label} did not stop gracefully.`);
+  return stopped;
+}
+
 /** Remove one or more files, ignoring missing-file errors. */
 function removeFiles(...files: (string | string[] | undefined)[]): void {
   for (const entry of files) {