bgrun 3.12.23 → 3.12.25

package/dist/api.js

@@ -240,7 +240,7 @@ function ensureDir(dirPath) {
 }
 function getShellCommand(command) {
   if (isWindows()) {
-    return ["cmd", "/c", command];
+    return [process.env.ComSpec || "cmd.exe", "/c", command];
   } else {
     return ["sh", "-c", command];
   }
@@ -825,7 +825,7 @@ var init_db = __esm(() => {
 // src/utils.ts
 import * as fs2 from "fs";
 import * as os2 from "os";
-import { join as join3 } from "path";
+import { delimiter, dirname, join as join3 } from "path";
 function parseEnvString(envString) {
   const env = {};
   envString.split(",").forEach((pair) => {
@@ -841,6 +841,17 @@ function calculateRuntime(startTime) {
   const diffInMinutes = Math.floor((now - start) / (1000 * 60));
   return `${diffInMinutes} minutes`;
 }
+function prependPathEntry(existingPath, entry) {
+  if (!existingPath)
+    return entry;
+  const parts = existingPath.split(delimiter).filter(Boolean);
+  const normalizedEntry = process.platform === "win32" ? entry.toLowerCase() : entry;
+  const deduped = parts.filter((part) => {
+    const normalizedPart = process.platform === "win32" ? part.toLowerCase() : part;
+    return normalizedPart !== normalizedEntry;
+  });
+  return [entry, ...deduped].join(delimiter);
+}
 function parseCommandEnv(command) {
   const env = {};
   const trimmed = command.trim();
@@ -882,6 +893,8 @@ function buildManagedProcessEnv(parentEnv, processEnv = {}) {
       continue;
     sanitizedParentEnv[key] = value;
   }
+  const bunDir = dirname(process.execPath);
+  sanitizedParentEnv.PATH = prependPathEntry(sanitizedParentEnv.PATH, bunDir);
   return { ...sanitizedParentEnv, ...processEnv };
 }
 function stringifyEnvString(env) {
@@ -1181,79 +1194,28 @@ import { join as join4 } from "path";
 
 // src/cli-helpers.ts
 init_db();
-var MONTH_NAMES = [
-  "january",
-  "february",
-  "march",
-  "april",
-  "may",
-  "june",
-  "july",
-  "august",
-  "september",
-  "october",
-  "november",
-  "december"
-];
-var DAY_NAMES = [
-  "",
-  "first",
-  "second",
-  "third",
-  "fourth",
-  "fifth",
-  "sixth",
-  "seventh",
-  "eighth",
-  "ninth",
-  "tenth",
-  "eleventh",
-  "twelfth",
-  "thirteenth",
-  "fourteenth",
-  "fifteenth",
-  "sixteenth",
-  "seventeenth",
-  "eighteenth",
-  "nineteenth",
-  "twentieth",
-  "twenty-first",
-  "twenty-second",
-  "twenty-third",
-  "twenty-fourth",
-  "twenty-fifth",
-  "twenty-sixth",
-  "twenty-seventh",
-  "twenty-eighth",
-  "twenty-ninth",
-  "thirtieth",
-  "thirty-first"
-];
-function pad2(value) {
-  return String(value).padStart(2, "0");
-}
-function buildDateProcessName(now = new Date) {
-  const month = MONTH_NAMES[now.getMonth()] || "process";
-  const day = DAY_NAMES[now.getDate()] || "day";
-  return `${month}-${day}`;
-}
-function generateAutoProcessName(now = new Date) {
-  const baseName = buildDateProcessName(now);
+import { basename, resolve } from "path";
+function sanitizeProcessName(value) {
+  const normalized = value.trim().toLowerCase().replace(/[^a-z0-9._-]+/g, "-").replace(/-+/g, "-").replace(/^[-._]+|[-._]+$/g, "");
+  return normalized || "process";
+}
+function buildDirectoryProcessName(directory) {
+  const resolved = resolve(directory);
+  const folderName = basename(resolved);
+  return sanitizeProcessName(folderName);
+}
+function generateAutoProcessName(directory) {
+  const baseName = buildDirectoryProcessName(directory);
   if (!getProcess(baseName)) {
     return baseName;
   }
-  const timeSuffix = `${pad2(now.getHours())}${pad2(now.getMinutes())}${pad2(now.getSeconds())}`;
-  const timeName = `${baseName}-${timeSuffix}`;
-  if (!getProcess(timeName)) {
-    return timeName;
-  }
   for (let i = 1;i < 1000; i++) {
-    const candidate = `${timeName}-${i}`;
+    const candidate = `${baseName}-${i}`;
     if (!getProcess(candidate)) {
       return candidate;
     }
   }
-  return `${timeName}-${Date.now()}`;
+  return `${baseName}-${Date.now()}`;
 }
 function shellQuoteArg(arg) {
   if (process.platform === "win32") {
@@ -1465,6 +1427,78 @@ function getRecentGuardEvents(limit = 100) {
 var homePath2 = getHomeDir();
 var run = createMeasure2("run");
 var INTERNAL_BUNX_PREFIX = "bunx bgrun";
+async function resolveSpawnedProcessPid(parentPid, command, workdir) {
+  if (parentPid <= 0)
+    return 0;
+  let candidatePid = parentPid;
+  const spawnedAt = Date.now();
+  for (let attempt = 0;attempt < 6; attempt++) {
+    const descendantPid = await findChildPid(parentPid);
+    if (descendantPid > 0) {
+      candidatePid = descendantPid;
+    }
+    if (candidatePid > 0 && await isProcessRunning(candidatePid, command)) {
+      return candidatePid;
+    }
+    await sleep2(250);
+  }
+  const reconciled = await reconcileProcessPids([{ name: "__spawn__", pid: parentPid, command, workdir }], new Set([parentPid]));
+  const matchedPid = reconciled.get("__spawn__") ?? 0;
+  if (matchedPid > 0 && await isProcessRunning(matchedPid, command)) {
+    return matchedPid;
+  }
+  if (process.platform === "win32") {
+    try {
+      const commandParts = command.toLowerCase().split(/\s+/).map((part) => part.trim()).filter((part) => part.length > 2);
+      const output = await psExec(`Get-CimInstance Win32_Process -Filter "Name='bun.exe'" | ` + `ForEach-Object { Write-Output "$($_.ProcessId)|$($_.ParentProcessId)|$($_.CreationDate)|$($_.CommandLine)" }`, 5000);
+      let bestPid = 0;
+      let bestScore = -1;
+      for (const line of output.split(`
+`)) {
+        const parts = line.split("|");
+        if (parts.length < 4)
+          continue;
+        const pid = parseInt(parts[0]?.trim(), 10);
+        const candidateParentPid = parseInt(parts[1]?.trim(), 10);
+        const creationDateRaw = parts[2]?.trim() || "";
+        const candidateCommand = parts.slice(3).join("|").trim().toLowerCase();
+        if (isNaN(pid) || pid <= 0 || pid === process.pid)
+          continue;
+        if (!candidateCommand)
+          continue;
+        let score = 0;
+        if (candidateParentPid === parentPid)
+          score += 10;
+        for (const part of commandParts) {
+          if (candidateCommand.includes(part))
+            score += 2;
+        }
+        if (candidateCommand.includes("run server.ts"))
+          score += 2;
+        if (candidateCommand.includes(workdir.toLowerCase().replace(/\\/g, "/")))
+          score += 4;
+        if (candidateCommand.includes(workdir.toLowerCase()))
+          score += 4;
+        const createdAt = creationDateRaw ? Date.parse(creationDateRaw) : NaN;
+        if (!isNaN(createdAt)) {
+          const ageMs = Math.abs(createdAt - spawnedAt);
+          if (ageMs <= 15000)
+            score += 6;
+          else if (ageMs <= 60000)
+            score += 2;
+        }
+        if (score > bestScore && await isProcessRunning(pid, command)) {
+          bestScore = score;
+          bestPid = pid;
+        }
+      }
+      if (bestScore >= 4) {
+        return bestPid;
+      }
+    } catch {}
+  }
+  return 0;
+}
 function resolveInternalBgrunCommand(command) {
   const trimmed = command.trim();
   if (!trimmed.startsWith("bgrun --_") && !trimmed.startsWith(`${INTERNAL_BUNX_PREFIX} --_`)) {
@@ -1675,11 +1709,13 @@ async function handleRun(options) {
         stderr: Bun.file(stderrPath)
       });
       newProcess.unref();
-      await sleep2(100);
-      const pid = await findChildPid(newProcess.pid);
-      await sleep2(400);
-      return pid;
+      return await resolveSpawnedProcessPid(newProcess.pid, finalCommand, finalDirectory);
     }) ?? 0;
+    if (actualPid <= 0) {
+      throw new Error(`Failed to resolve a live PID for "${name}" after launch. The child process likely exited immediately. Check logs:
+stdout: ${stdoutPath}
+stderr: ${stderrPath}`);
+    }
     await retryDatabaseOperation(() => insertProcess({
       pid: actualPid,
       workdir: finalDirectory,

package/dist/deploy.js

@@ -240,7 +240,7 @@ function ensureDir(dirPath) {
 }
 function getShellCommand(command) {
   if (isWindows()) {
-    return ["cmd", "/c", command];
+    return [process.env.ComSpec || "cmd.exe", "/c", command];
   } else {
     return ["sh", "-c", command];
   }
@@ -825,7 +825,7 @@ var init_db = __esm(() => {
 // src/utils.ts
 import * as fs2 from "fs";
 import * as os2 from "os";
-import { join as join3 } from "path";
+import { delimiter, dirname, join as join3 } from "path";
 function parseEnvString(envString) {
   const env = {};
   envString.split(",").forEach((pair) => {
@@ -841,6 +841,17 @@ function calculateRuntime(startTime) {
   const diffInMinutes = Math.floor((now - start) / (1000 * 60));
   return `${diffInMinutes} minutes`;
 }
+function prependPathEntry(existingPath, entry) {
+  if (!existingPath)
+    return entry;
+  const parts = existingPath.split(delimiter).filter(Boolean);
+  const normalizedEntry = process.platform === "win32" ? entry.toLowerCase() : entry;
+  const deduped = parts.filter((part) => {
+    const normalizedPart = process.platform === "win32" ? part.toLowerCase() : part;
+    return normalizedPart !== normalizedEntry;
+  });
+  return [entry, ...deduped].join(delimiter);
+}
 function parseCommandEnv(command) {
   const env = {};
   const trimmed = command.trim();
@@ -882,6 +893,8 @@ function buildManagedProcessEnv(parentEnv, processEnv = {}) {
       continue;
     sanitizedParentEnv[key] = value;
   }
+  const bunDir = dirname(process.execPath);
+  sanitizedParentEnv.PATH = prependPathEntry(sanitizedParentEnv.PATH, bunDir);
   return { ...sanitizedParentEnv, ...processEnv };
 }
 function stringifyEnvString(env) {
@@ -1180,79 +1193,28 @@ import { join as join4 } from "path";
 
 // src/cli-helpers.ts
 init_db();
-var MONTH_NAMES = [
-  "january",
-  "february",
-  "march",
-  "april",
-  "may",
-  "june",
-  "july",
-  "august",
-  "september",
-  "october",
-  "november",
-  "december"
-];
-var DAY_NAMES = [
-  "",
-  "first",
-  "second",
-  "third",
-  "fourth",
-  "fifth",
-  "sixth",
-  "seventh",
-  "eighth",
-  "ninth",
-  "tenth",
-  "eleventh",
-  "twelfth",
-  "thirteenth",
-  "fourteenth",
-  "fifteenth",
-  "sixteenth",
-  "seventeenth",
-  "eighteenth",
-  "nineteenth",
-  "twentieth",
-  "twenty-first",
-  "twenty-second",
-  "twenty-third",
-  "twenty-fourth",
-  "twenty-fifth",
-  "twenty-sixth",
-  "twenty-seventh",
-  "twenty-eighth",
-  "twenty-ninth",
-  "thirtieth",
-  "thirty-first"
-];
-function pad2(value) {
-  return String(value).padStart(2, "0");
-}
-function buildDateProcessName(now = new Date) {
-  const month = MONTH_NAMES[now.getMonth()] || "process";
-  const day = DAY_NAMES[now.getDate()] || "day";
-  return `${month}-${day}`;
-}
-function generateAutoProcessName(now = new Date) {
-  const baseName = buildDateProcessName(now);
+import { basename, resolve } from "path";
+function sanitizeProcessName(value) {
+  const normalized = value.trim().toLowerCase().replace(/[^a-z0-9._-]+/g, "-").replace(/-+/g, "-").replace(/^[-._]+|[-._]+$/g, "");
+  return normalized || "process";
+}
+function buildDirectoryProcessName(directory) {
+  const resolved = resolve(directory);
+  const folderName = basename(resolved);
+  return sanitizeProcessName(folderName);
+}
+function generateAutoProcessName(directory) {
+  const baseName = buildDirectoryProcessName(directory);
   if (!getProcess(baseName)) {
     return baseName;
   }
-  const timeSuffix = `${pad2(now.getHours())}${pad2(now.getMinutes())}${pad2(now.getSeconds())}`;
-  const timeName = `${baseName}-${timeSuffix}`;
-  if (!getProcess(timeName)) {
-    return timeName;
-  }
   for (let i = 1;i < 1000; i++) {
-    const candidate = `${timeName}-${i}`;
+    const candidate = `${baseName}-${i}`;
     if (!getProcess(candidate)) {
       return candidate;
     }
   }
-  return `${timeName}-${Date.now()}`;
+  return `${baseName}-${Date.now()}`;
 }
 function shellQuoteArg(arg) {
   if (process.platform === "win32") {
@@ -1464,6 +1426,78 @@ function getRecentGuardEvents(limit = 100) {
 var homePath2 = getHomeDir();
 var run = createMeasure2("run");
 var INTERNAL_BUNX_PREFIX = "bunx bgrun";
+async function resolveSpawnedProcessPid(parentPid, command, workdir) {
+  if (parentPid <= 0)
+    return 0;
+  let candidatePid = parentPid;
+  const spawnedAt = Date.now();
+  for (let attempt = 0;attempt < 6; attempt++) {
+    const descendantPid = await findChildPid(parentPid);
+    if (descendantPid > 0) {
+      candidatePid = descendantPid;
+    }
+    if (candidatePid > 0 && await isProcessRunning(candidatePid, command)) {
+      return candidatePid;
+    }
+    await sleep2(250);
+  }
+  const reconciled = await reconcileProcessPids([{ name: "__spawn__", pid: parentPid, command, workdir }], new Set([parentPid]));
+  const matchedPid = reconciled.get("__spawn__") ?? 0;
+  if (matchedPid > 0 && await isProcessRunning(matchedPid, command)) {
+    return matchedPid;
+  }
+  if (process.platform === "win32") {
+    try {
+      const commandParts = command.toLowerCase().split(/\s+/).map((part) => part.trim()).filter((part) => part.length > 2);
+      const output = await psExec(`Get-CimInstance Win32_Process -Filter "Name='bun.exe'" | ` + `ForEach-Object { Write-Output "$($_.ProcessId)|$($_.ParentProcessId)|$($_.CreationDate)|$($_.CommandLine)" }`, 5000);
+      let bestPid = 0;
+      let bestScore = -1;
+      for (const line of output.split(`
+`)) {
+        const parts = line.split("|");
+        if (parts.length < 4)
+          continue;
+        const pid = parseInt(parts[0]?.trim(), 10);
+        const candidateParentPid = parseInt(parts[1]?.trim(), 10);
+        const creationDateRaw = parts[2]?.trim() || "";
+        const candidateCommand = parts.slice(3).join("|").trim().toLowerCase();
+        if (isNaN(pid) || pid <= 0 || pid === process.pid)
+          continue;
+        if (!candidateCommand)
+          continue;
+        let score = 0;
+        if (candidateParentPid === parentPid)
+          score += 10;
+        for (const part of commandParts) {
+          if (candidateCommand.includes(part))
+            score += 2;
+        }
+        if (candidateCommand.includes("run server.ts"))
+          score += 2;
+        if (candidateCommand.includes(workdir.toLowerCase().replace(/\\/g, "/")))
+          score += 4;
+        if (candidateCommand.includes(workdir.toLowerCase()))
+          score += 4;
+        const createdAt = creationDateRaw ? Date.parse(creationDateRaw) : NaN;
+        if (!isNaN(createdAt)) {
+          const ageMs = Math.abs(createdAt - spawnedAt);
+          if (ageMs <= 15000)
+            score += 6;
+          else if (ageMs <= 60000)
+            score += 2;
+        }
+        if (score > bestScore && await isProcessRunning(pid, command)) {
+          bestScore = score;
+          bestPid = pid;
+        }
+      }
+      if (bestScore >= 4) {
+        return bestPid;
+      }
+    } catch {}
+  }
+  return 0;
+}
 function resolveInternalBgrunCommand(command) {
   const trimmed = command.trim();
   if (!trimmed.startsWith("bgrun --_") && !trimmed.startsWith(`${INTERNAL_BUNX_PREFIX} --_`)) {
@@ -1674,11 +1708,13 @@ async function handleRun(options) {
         stderr: Bun.file(stderrPath)
       });
       newProcess.unref();
-      await sleep2(100);
-      const pid = await findChildPid(newProcess.pid);
-      await sleep2(400);
-      return pid;
+      return await resolveSpawnedProcessPid(newProcess.pid, finalCommand, finalDirectory);
     }) ?? 0;
+    if (actualPid <= 0) {
+      throw new Error(`Failed to resolve a live PID for "${name}" after launch. The child process likely exited immediately. Check logs:
+stdout: ${stdoutPath}
+stderr: ${stderrPath}`);
+    }
     await retryDatabaseOperation(() => insertProcess({
       pid: actualPid,
       workdir: finalDirectory,

package/dist/deps.js

@@ -240,7 +240,7 @@ function ensureDir(dirPath) {
 }
 function getShellCommand(command) {
   if (isWindows()) {
-    return ["cmd", "/c", command];
+    return [process.env.ComSpec || "cmd.exe", "/c", command];
   } else {
     return ["sh", "-c", command];
   }
@@ -825,7 +825,7 @@ var init_db = __esm(() => {
 // src/utils.ts
 import * as fs2 from "fs";
 import * as os2 from "os";
-import { join as join3 } from "path";
+import { delimiter, dirname, join as join3 } from "path";
 function parseEnvString(envString) {
   const env = {};
   envString.split(",").forEach((pair) => {
@@ -841,6 +841,17 @@ function calculateRuntime(startTime) {
   const diffInMinutes = Math.floor((now - start) / (1000 * 60));
   return `${diffInMinutes} minutes`;
 }
+function prependPathEntry(existingPath, entry) {
+  if (!existingPath)
+    return entry;
+  const parts = existingPath.split(delimiter).filter(Boolean);
+  const normalizedEntry = process.platform === "win32" ? entry.toLowerCase() : entry;
+  const deduped = parts.filter((part) => {
+    const normalizedPart = process.platform === "win32" ? part.toLowerCase() : part;
+    return normalizedPart !== normalizedEntry;
+  });
+  return [entry, ...deduped].join(delimiter);
+}
 function parseCommandEnv(command) {
   const env = {};
   const trimmed = command.trim();
@@ -882,6 +893,8 @@ function buildManagedProcessEnv(parentEnv, processEnv = {}) {
       continue;
     sanitizedParentEnv[key] = value;
   }
+  const bunDir = dirname(process.execPath);
+  sanitizedParentEnv.PATH = prependPathEntry(sanitizedParentEnv.PATH, bunDir);
   return { ...sanitizedParentEnv, ...processEnv };
 }
 function stringifyEnvString(env) {

package/dist/index.js

@@ -241,7 +241,7 @@ function ensureDir(dirPath) {
 }
 function getShellCommand(command) {
   if (isWindows()) {
-    return ["cmd", "/c", command];
+    return [process.env.ComSpec || "cmd.exe", "/c", command];
   } else {
     return ["sh", "-c", command];
   }
@@ -826,7 +826,7 @@ var init_db = __esm(() => {
 // src/utils.ts
 import * as fs2 from "fs";
 import * as os2 from "os";
-import { join as join3 } from "path";
+import { delimiter, dirname, join as join3 } from "path";
 function parseEnvString(envString) {
   const env = {};
   envString.split(",").forEach((pair) => {
@@ -842,6 +842,17 @@ function calculateRuntime(startTime) {
   const diffInMinutes = Math.floor((now - start) / (1000 * 60));
   return `${diffInMinutes} minutes`;
 }
+function prependPathEntry(existingPath, entry) {
+  if (!existingPath)
+    return entry;
+  const parts = existingPath.split(delimiter).filter(Boolean);
+  const normalizedEntry = process.platform === "win32" ? entry.toLowerCase() : entry;
+  const deduped = parts.filter((part) => {
+    const normalizedPart = process.platform === "win32" ? part.toLowerCase() : part;
+    return normalizedPart !== normalizedEntry;
+  });
+  return [entry, ...deduped].join(delimiter);
+}
 function parseCommandEnv(command) {
   const env = {};
   const trimmed = command.trim();
@@ -883,6 +894,8 @@ function buildManagedProcessEnv(parentEnv, processEnv = {}) {
       continue;
     sanitizedParentEnv[key] = value;
   }
+  const bunDir = dirname(process.execPath);
+  sanitizedParentEnv.PATH = prependPathEntry(sanitizedParentEnv.PATH, bunDir);
   return { ...sanitizedParentEnv, ...processEnv };
 }
 function stringifyEnvString(env) {
@@ -1341,79 +1354,28 @@ import { join as join4 } from "path";
 
 // src/cli-helpers.ts
 init_db();
-var MONTH_NAMES = [
-  "january",
-  "february",
-  "march",
-  "april",
-  "may",
-  "june",
-  "july",
-  "august",
-  "september",
-  "october",
-  "november",
-  "december"
-];
-var DAY_NAMES = [
-  "",
-  "first",
-  "second",
-  "third",
-  "fourth",
-  "fifth",
-  "sixth",
-  "seventh",
-  "eighth",
-  "ninth",
-  "tenth",
-  "eleventh",
-  "twelfth",
-  "thirteenth",
-  "fourteenth",
-  "fifteenth",
-  "sixteenth",
-  "seventeenth",
-  "eighteenth",
-  "nineteenth",
-  "twentieth",
-  "twenty-first",
-  "twenty-second",
-  "twenty-third",
-  "twenty-fourth",
-  "twenty-fifth",
-  "twenty-sixth",
-  "twenty-seventh",
-  "twenty-eighth",
-  "twenty-ninth",
-  "thirtieth",
-  "thirty-first"
-];
-function pad2(value) {
-  return String(value).padStart(2, "0");
-}
-function buildDateProcessName(now = new Date) {
-  const month = MONTH_NAMES[now.getMonth()] || "process";
-  const day = DAY_NAMES[now.getDate()] || "day";
-  return `${month}-${day}`;
-}
-function generateAutoProcessName(now = new Date) {
-  const baseName = buildDateProcessName(now);
+import { basename, resolve } from "path";
+function sanitizeProcessName(value) {
+  const normalized = value.trim().toLowerCase().replace(/[^a-z0-9._-]+/g, "-").replace(/-+/g, "-").replace(/^[-._]+|[-._]+$/g, "");
+  return normalized || "process";
+}
+function buildDirectoryProcessName(directory) {
+  const resolved = resolve(directory);
+  const folderName = basename(resolved);
+  return sanitizeProcessName(folderName);
+}
+function generateAutoProcessName(directory) {
+  const baseName = buildDirectoryProcessName(directory);
   if (!getProcess(baseName)) {
     return baseName;
   }
-  const timeSuffix = `${pad2(now.getHours())}${pad2(now.getMinutes())}${pad2(now.getSeconds())}`;
-  const timeName = `${baseName}-${timeSuffix}`;
-  if (!getProcess(timeName)) {
-    return timeName;
-  }
   for (let i = 1;i < 1000; i++) {
-    const candidate = `${timeName}-${i}`;
+    const candidate = `${baseName}-${i}`;
     if (!getProcess(candidate)) {
       return candidate;
     }
   }
-  return `${timeName}-${Date.now()}`;
+  return `${baseName}-${Date.now()}`;
 }
 function shellQuoteArg(arg) {
   if (process.platform === "win32") {
@@ -1625,6 +1587,78 @@ function getRecentGuardEvents(limit = 100) {
 var homePath2 = getHomeDir();
 var run = createMeasure2("run");
 var INTERNAL_BUNX_PREFIX = "bunx bgrun";
+async function resolveSpawnedProcessPid(parentPid, command, workdir) {
+  if (parentPid <= 0)
+    return 0;
+  let candidatePid = parentPid;
+  const spawnedAt = Date.now();
+  for (let attempt = 0;attempt < 6; attempt++) {
+    const descendantPid = await findChildPid(parentPid);
+    if (descendantPid > 0) {
+      candidatePid = descendantPid;
+    }
+    if (candidatePid > 0 && await isProcessRunning(candidatePid, command)) {
+      return candidatePid;
+    }
+    await sleep2(250);
+  }
+  const reconciled = await reconcileProcessPids([{ name: "__spawn__", pid: parentPid, command, workdir }], new Set([parentPid]));
+  const matchedPid = reconciled.get("__spawn__") ?? 0;
+  if (matchedPid > 0 && await isProcessRunning(matchedPid, command)) {
+    return matchedPid;
+  }
+  if (process.platform === "win32") {
+    try {
+      const commandParts = command.toLowerCase().split(/\s+/).map((part) => part.trim()).filter((part) => part.length > 2);
+      const output = await psExec(`Get-CimInstance Win32_Process -Filter "Name='bun.exe'" | ` + `ForEach-Object { Write-Output "$($_.ProcessId)|$($_.ParentProcessId)|$($_.CreationDate)|$($_.CommandLine)" }`, 5000);
+      let bestPid = 0;
+      let bestScore = -1;
+      for (const line of output.split(`
+`)) {
+        const parts = line.split("|");
+        if (parts.length < 4)
+          continue;
+        const pid = parseInt(parts[0]?.trim(), 10);
+        const candidateParentPid = parseInt(parts[1]?.trim(), 10);
+        const creationDateRaw = parts[2]?.trim() || "";
+        const candidateCommand = parts.slice(3).join("|").trim().toLowerCase();
+        if (isNaN(pid) || pid <= 0 || pid === process.pid)
+          continue;
+        if (!candidateCommand)
+          continue;
+        let score = 0;
+        if (candidateParentPid === parentPid)
+          score += 10;
+        for (const part of commandParts) {
+          if (candidateCommand.includes(part))
+            score += 2;
+        }
+        if (candidateCommand.includes("run server.ts"))
+          score += 2;
+        if (candidateCommand.includes(workdir.toLowerCase().replace(/\\/g, "/")))
+          score += 4;
+        if (candidateCommand.includes(workdir.toLowerCase()))
+          score += 4;
+        const createdAt = creationDateRaw ? Date.parse(creationDateRaw) : NaN;
+        if (!isNaN(createdAt)) {
+          const ageMs = Math.abs(createdAt - spawnedAt);
+          if (ageMs <= 15000)
+            score += 6;
+          else if (ageMs <= 60000)
+            score += 2;
+        }
+        if (score > bestScore && await isProcessRunning(pid, command)) {
+          bestScore = score;
+          bestPid = pid;
+        }
+      }
+      if (bestScore >= 4) {
+        return bestPid;
+      }
+    } catch {}
+  }
+  return 0;
+}
 function resolveInternalBgrunCommand(command) {
   const trimmed = command.trim();
   if (!trimmed.startsWith("bgrun --_") && !trimmed.startsWith(`${INTERNAL_BUNX_PREFIX} --_`)) {
@@ -1835,11 +1869,13 @@ async function handleRun(options) {
         stderr: Bun.file(stderrPath)
       });
       newProcess.unref();
-      await sleep2(100);
-      const pid = await findChildPid(newProcess.pid);
-      await sleep2(400);
-      return pid;
+      return await resolveSpawnedProcessPid(newProcess.pid, finalCommand, finalDirectory);
     }) ?? 0;
+    if (actualPid <= 0) {
+      throw new Error(`Failed to resolve a live PID for "${name}" after launch. The child process likely exited immediately. Check logs:
+stdout: ${stdoutPath}
+stderr: ${stderrPath}`);
+    }
     await retryDatabaseOperation(() => insertProcess({
       pid: actualPid,
       workdir: finalDirectory,
@@ -2039,7 +2075,18 @@ function formatMemory(bytes) {
 }
 async function showAll(opts) {
   const processes = getAllProcesses();
-  const filtered = processes.filter((proc) => {
+  const latestByName = new Map;
+  for (const proc of processes) {
+    const existing = latestByName.get(proc.name);
+    if (!existing) {
+      latestByName.set(proc.name, proc);
+      continue;
+    }
+    if (proc.timestamp > existing.timestamp || proc.timestamp === existing.timestamp && proc.id > existing.id) {
+      latestByName.set(proc.name, proc);
+    }
+  }
+  const filtered = Array.from(latestByName.values()).filter((proc) => {
     if (isInternalProcessName(proc.name))
       return false;
     if (!opts?.filter)
@@ -2071,9 +2118,19 @@ async function showAll(opts) {
     for (const proc of filtered) {
       const isRunning = aliveCache.get(proc.pid) ?? await isProcessRunning(proc.pid, proc.command);
       const envVars = parseEnvString(proc.env);
-      const ports = isRunning ? await getProcessPorts(proc.pid) : [];
+      let displayPid = proc.pid;
+      let ports = [];
+      if (isRunning) {
+        const resolved = await resolvePidWithPorts(proc.pid);
+        displayPid = resolved.pid;
+        ports = resolved.ports;
+        if (displayPid !== proc.pid) {
+          updateProcessPid(proc.name, displayPid);
+          proc.pid = displayPid;
+        }
+      }
       jsonData.push({
-        pid: proc.pid,
+        pid: displayPid,
         name: proc.name,
         ports: ports.length > 0 ? ports : undefined,
         status: isRunning ? "running" : "stopped",
@@ -2334,7 +2391,7 @@ ${color(content)}
     return true;
   };
   const waitForLogReady = (logPath, timeoutMs = 5000) => {
-    return new Promise((resolve, reject) => {
+    return new Promise((resolve2, reject) => {
       const checkReady = () => {
         try {
           if (fs4.existsSync(logPath)) {
@@ -2347,7 +2404,7 @@ ${color(content)}
         return false;
       };
       if (checkReady()) {
-        resolve();
+        resolve2();
         return;
       }
       const dir = path2.dirname(logPath);
@@ -2356,7 +2413,7 @@ ${color(content)}
         if (changedFilename === filename && eventType === "change") {
           if (checkReady()) {
             watcher2.close();
-            resolve();
+            resolve2();
           }
         }
       });
@@ -2874,7 +2931,7 @@ async function showHelp() {
     ${chalk7.yellow("Commands:")}
       bunx bgrun                     List all processes
       bunx bgrun [name]             Show details for a process
-      bunx bgrun -- <cmd>           Start a managed process with an auto-generated name
+      bunx bgrun -- <cmd>           Start a managed process named from the working directory
       bunx bgrun inline -- <cmd>    Run a command in this terminal with config env loaded
       bunx bgrun --env              Print shell commands to export config env vars
       bunx bgrun --dashboard        Launch web dashboard (managed by bgrun)
@@ -2887,6 +2944,7 @@ async function showHelp() {
       bunx bgrun --delete [name]    Delete a process
       bunx bgrun --clean            Remove all stopped processes
       bunx bgrun --nuke             Delete ALL processes
+      bunx bgrun --kill-port <n>    Kill whatever is currently listening on a port
 
     ${chalk7.yellow("Options:")}
       --name <string>        Process name (required for new)
@@ -2897,6 +2955,7 @@ async function showHelp() {
       --env                  Print shell export commands from config and exit
       --shell <type>         Shell for --env: powershell | cmd | sh | json
       --watch                Watch for file changes and auto-restart
+      --hot                  Restart the managed process when files change
       --force                Force restart existing process
       --fetch                Fetch latest git changes before running
       --json                 Output in JSON format
@@ -2910,17 +2969,21 @@ async function showHelp() {
       --dashboard            Launch web dashboard as bgrun-managed process
       --guard                Enable per-process crash watcher
       --guard-off            Disable per-process crash watcher
+      --kill-port <number>   Kill the process currently using a port
       --port <number>        Port for dashboard (default: 3000)
       --help                 Show this help message
 
     ${chalk7.yellow("Examples:")}
       bunx bgrun -- bun run dev
+      bunx bgrun --hot -- bun run index.ts
+      bunx bgrun -hl -- bun run server.ts
       bunx bgrun --no-config -- bun run script.ts
       bunx bgrun --force -- bun run server.ts
       bunx bgrun inline -- bun run dev
       Invoke-Expression (bunx bgrun --env)
       eval "$(bunx bgrun --env --shell sh)"
       bunx bgrun --dashboard
+      bunx bgrun --kill-port 3000
       bunx bgrun myapp --guard
       bunx bgrun myapp --guard-off
       bunx bgrun --name myapp --command "bun run dev" --directory . --watch
@@ -2929,15 +2992,16 @@ async function showHelp() {
   console.log(usage);
 }
 var cliArgOptions = {
-  name: { type: "string" },
-  command: { type: "string" },
-  directory: { type: "string" },
+  name: { type: "string", short: "n" },
+  command: { type: "string", short: "c" },
+  directory: { type: "string", short: "d" },
   config: { type: "string" },
   "no-config": { type: "boolean" },
   env: { type: "boolean" },
   shell: { type: "string" },
-  watch: { type: "boolean" },
-  force: { type: "boolean" },
+  watch: { type: "boolean", short: "w" },
+  hot: { type: "boolean", short: "h" },
+  force: { type: "boolean", short: "f" },
   fetch: { type: "boolean" },
   delete: { type: "boolean" },
   nuke: { type: "boolean" },
@@ -2946,13 +3010,13 @@ var cliArgOptions = {
   stop: { type: "boolean" },
   "stop-all": { type: "boolean" },
   clean: { type: "boolean" },
-  json: { type: "boolean" },
-  logs: { type: "boolean" },
+  json: { type: "boolean", short: "j" },
+  logs: { type: "boolean", short: "l" },
   "log-stdout": { type: "boolean" },
   "log-stderr": { type: "boolean" },
   lines: { type: "string" },
   filter: { type: "string" },
-  version: { type: "boolean" },
+  version: { type: "boolean", short: "v" },
   help: { type: "boolean" },
   db: { type: "string" },
   stdout: { type: "string" },
@@ -2961,6 +3025,7 @@ var cliArgOptions = {
   guard: { type: "boolean" },
   "guard-off": { type: "boolean" },
   debug: { type: "boolean" },
+  "kill-port": { type: "string" },
   _serve: { type: "boolean" },
   "_watch-process": { type: "string" },
   port: { type: "string" }
@@ -2968,7 +3033,7 @@ var cliArgOptions = {
 async function run2() {
   const rawArgs = Bun.argv.slice(2);
   const isActionInvocation = (values2) => {
-    return Boolean(values2.dashboard || values2.guard || values2["guard-off"] || values2.version || values2.help || values2.debug || values2.nuke || values2.clean || values2["restart-all"] || values2["stop-all"] || values2.delete || values2.restart || values2.stop || values2.logs || values2["log-stdout"] || values2["log-stderr"] || values2.watch || values2.json || values2.filter);
+    return Boolean(values2.dashboard || values2.guard || values2["guard-off"] || values2.version || values2.help || values2.debug || values2["kill-port"] || values2.nuke || values2.clean || values2["restart-all"] || values2["stop-all"] || values2.delete || values2.restart || values2.stop || values2.logs || values2["log-stdout"] || values2["log-stderr"] || values2.watch || values2.hot || values2.json || values2.filter);
   };
   if (rawArgs[0] === "inline") {
     const parsed = parseInlineArgs(rawArgs.slice(1));
@@ -3001,11 +3066,12 @@ async function run2() {
       strict: false,
       allowPositionals: true
     });
-    const autoName = values2.name || generateAutoProcessName();
     const inlineCommand = joinCommandArgs(commandArgs);
     const directory = values2.directory || process.cwd();
-    await handleRun({
-      action: "run",
+    const autoName = values2.name || generateAutoProcessName(directory);
+    const watchLike = Boolean(values2.watch || values2.hot);
+    const runOptions = {
+      action: watchLike ? "watch" : "run",
       name: autoName,
       command: inlineCommand,
       directory,
@@ -3016,7 +3082,16 @@ async function run2() {
       dbPath: values2.db,
       stdout: values2.stdout,
       stderr: values2.stderr
-    });
+    };
+    if (watchLike) {
+      await handleWatch(runOptions, {
+        showLogs: values2.logs || false,
+        logType: values2["log-stdout"] ? "stdout" : values2["log-stderr"] ? "stderr" : "both",
+        lines: values2.lines ? parseInt(values2.lines) : undefined
+      });
+    } else {
+      await handleRun(runOptions);
+    }
     return;
   }
   const { values, positionals } = parseArgs({
@@ -3037,11 +3112,12 @@ async function run2() {
     return;
   }
   if (positionals.length > 1 && !values.command && !isActionInvocation(values)) {
-    const autoName = values.name || generateAutoProcessName();
     const implicitCommand = joinCommandArgs(positionals);
     const directory = values.directory || process.cwd();
-    await handleRun({
-      action: "run",
+    const autoName = values.name || generateAutoProcessName(directory);
+    const watchLike = Boolean(values.watch || values.hot);
+    const runOptions = {
+      action: watchLike ? "watch" : "run",
       name: autoName,
       command: implicitCommand,
       directory,
@@ -3052,7 +3128,16 @@ async function run2() {
       dbPath: values.db,
       stdout: values.stdout,
       stderr: values.stderr
-    });
+    };
+    if (watchLike) {
+      await handleWatch(runOptions, {
+        showLogs: values.logs || false,
+        logType: values["log-stdout"] ? "stdout" : values["log-stderr"] ? "stderr" : "both",
+        lines: values.lines ? parseInt(values.lines) : undefined
+      });
+    } else {
+      await handleRun(runOptions);
+    }
     return;
   }
   if (values["_serve"]) {
@@ -3221,6 +3306,24 @@ async function run2() {
     `);
     return;
   }
+  if (values["kill-port"]) {
+    const port = parseInt(String(values["kill-port"]), 10);
+    if (isNaN(port) || port <= 0) {
+      error("Please provide a valid port number for --kill-port.");
+    }
+    const wasFree = await isPortFree(port);
+    if (wasFree) {
+      announce(`Port ${port} is already free.`, "Port Free");
+      return;
+    }
+    await killProcessOnPort(port);
+    const freed = await waitForPortFree(port, 5000);
+    if (!freed) {
+      error(`Port ${port} is still busy after attempted cleanup.`);
+    }
+    announce(`Freed port ${port}.`, "Port Cleanup");
+    return;
+  }
   if (values.nuke) {
     await handleDeleteAll();
     return;
@@ -3321,7 +3424,7 @@ async function run2() {
     await showLogs(name, logType, lines);
     return;
   }
-  if (values.watch) {
+  if (values.watch || values.hot) {
     await handleWatch({
       action: "watch",
       name,

package/dist/server.js

@@ -311,7 +311,7 @@ function ensureDir(dirPath) {
 }
 function getShellCommand(command) {
   if (isWindows()) {
-    return ["cmd", "/c", command];
+    return [process.env.ComSpec || "cmd.exe", "/c", command];
   } else {
     return ["sh", "-c", command];
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bgrun",
-  "version": "3.12.23",
+  "version": "3.12.25",
   "description": "bgrun — A lightweight process manager for Bun",
   "type": "module",
   "main": "./dist/api.js",