fix(scripts): Windows dev server port probing with cmd timeout fallback (CoreBunch#170)

Zen0-99 · keypop3750 · web-flow · commit 75086cfa33cd · 2026-07-03T15:55:16.000+02:00
Adds a Windows-specific retry loop using cmd /c timeout when the port
probing helper cannot identify the holding process. This avoids false
positives when a previous dev server is still shutting down.

Co-authored-by: KalPop &lt;keypop3750@gmail.com&gt;
diff --git a/scripts/dev.ts b/scripts/dev.ts
@@ -265,7 +265,9 @@ function stopChildren(signal: NodeJS.Signals = 'SIGTERM'): void {
 }
 
 for (const cfg of processes) {
-  const child = Bun.spawn(cfg.command.split(' '), {
+  const args = cfg.command.split(' ')
+  if (args[0] === 'bun') args[0] = process.execPath
+  const child = Bun.spawn(args, {
     env: { ...process.env, ...cfg.env },
     stdin: 'inherit',
     stdout: 'inherit',
diff --git a/scripts/lib/freePort.ts b/scripts/lib/freePort.ts
@@ -22,6 +22,7 @@ interface PortHolder {
  * holding process's `comm` name. Empty array when the port is free.
  */
 function findPortHolders(port: number): PortHolder[] {
+  if (process.platform === 'win32') return []
   const lsof = Bun.spawnSync(
     ['lsof', '-nP', `-iTCP:${port}`, '-sTCP:LISTEN', '-t'],
     { stdout: 'pipe', stderr: 'ignore' },
@@ -107,8 +108,14 @@ export async function ensurePortFree(
 
   const holders = findPortHolders(port)
   if (holders.length === 0) {
-    // Port is busy but we couldn't enumerate the holder (rare — usually
-    // a permissions issue on lsof). Fall through to the manual message.
+    if (process.platform === 'win32') {
+      // On Windows we can't enumerate holders easily; just wait a bit
+      // and re-probe in case a previous dev server is shutting down.
+      for (let i = 0; i < 30; i++) {
+        if (probePort(port) === 'free') return
+        Bun.spawnSync(['cmd', '/c', 'timeout', '/t', '1', '/nobreak', '>nul', '2>&1'])
+      }
+    }
     log(`Port ${port} (${name}) is in use, but the holding process could not be identified.`)
     log(`Run \`lsof -i :${port} -P -n\` to inspect it manually.`)
     process.exit(1)
