@mandujs/cli 0.18.3 → 0.18.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mandujs/cli",
-  "version": "0.18.3",
+  "version": "0.18.4",
   "description": "Agent-Native Fullstack Framework - 에이전트가 코딩해도 아키텍처가 무너지지 않는 개발 OS",
   "type": "module",
   "main": "./src/main.ts",
@@ -32,7 +32,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@mandujs/core": "^0.18.4",
+    "@mandujs/core": "^0.18.6",
     "@mandujs/ate": "^0.17.0",
     "cfonts": "^3.3.0"
   },

package/src/util/port.ts

@@ -1,6 +1,9 @@
 import { createServer } from "net";
 
 const DEFAULT_MAX_ATTEMPTS = 10;
+// Windows TIME_WAIT 상태에서 같은 포트를 재시도하는 최대 횟수 (#125)
+const TIME_WAIT_RETRY_ATTEMPTS = 3;
+const TIME_WAIT_RETRY_DELAY_MS = 1000;
 
 function isPortUsable(error: unknown): boolean {
   if (!error || typeof error !== "object") return false;
@@ -33,6 +36,25 @@ async function isPortAvailable(port: number, hostname?: string): Promise<boolean
   });
 }
 
+/**
+ * Windows TIME_WAIT 상태를 고려한 포트 가용성 체크 (#125)
+ * EADDRINUSE이지만 TIME_WAIT 중인 포트는 잠시 후 사용 가능해질 수 있음
+ * → 같은 포트를 지정 횟수만큼 재시도 후 다음 포트로 이동
+ */
+async function isPortAvailableWithRetry(
+  port: number,
+  hostname?: string
+): Promise<boolean> {
+  for (let i = 0; i < TIME_WAIT_RETRY_ATTEMPTS; i++) {
+    const available = await isPortAvailable(port, hostname);
+    if (available) return true;
+    if (i < TIME_WAIT_RETRY_ATTEMPTS - 1) {
+      await new Promise((r) => setTimeout(r, TIME_WAIT_RETRY_DELAY_MS));
+    }
+  }
+  return false;
+}
+
 export async function resolveAvailablePort(
   startPort: number,
   options: {
@@ -43,6 +65,7 @@ export async function resolveAvailablePort(
 ): Promise<{ port: number; attempts: number }> {
   const offsets = options.offsets && options.offsets.length > 0 ? options.offsets : [0];
   const maxAttempts = options.maxAttempts ?? DEFAULT_MAX_ATTEMPTS;
+  const isWindows = process.platform === "win32";
 
   for (let attempt = 0; attempt < maxAttempts; attempt++) {
     const candidate = startPort + attempt;
@@ -58,9 +81,12 @@ export async function resolveAvailablePort(
       continue;
     }
 
-    const results = await Promise.all(
-      targets.map((port) => isPortAvailable(port, options.hostname))
-    );
+    // Windows에서는 최초 포트(attempt=0)에 한해 TIME_WAIT 재시도 적용
+    const checkFn = (isWindows && attempt === 0)
+      ? (port: number) => isPortAvailableWithRetry(port, options.hostname)
+      : (port: number) => isPortAvailable(port, options.hostname);
+
+    const results = await Promise.all(targets.map(checkFn));
 
     if (results.every(Boolean)) {
       return { port: candidate, attempts: attempt };