fix(e2e): add robust port cleanup to all test startup scripts

- Add killPort() function to all startup scripts using fuser (CI) with lsof fallback (local)
- Add delays after port cleanup to ensure OS releases ports fully
- Fix port conflicts causing EADDRINUSE errors in CI
- Apply to federated-css, federated-css-react-ssr test scripts

This ensures ports are properly freed before starting new servers,
preventing the port conflict issues seen in CI environments.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>

Author: ScriptedAlchemy

federated-css-react-ssr/scripts/start-exposes.cjs

@@ -1,4 +1,4 @@
-const { spawn } = require('node:child_process');
+const { spawn, execSync } = require('node:child_process');
 const path = require('node:path');
 const waitOn = require('wait-on');
 
@@ -8,6 +8,23 @@ function run(cmd, args, opts = {}) {
   return spawn(cmd, args, { stdio: 'inherit', cwd: root, shell: true, ...opts });
 }
 
+function killPort(port) {
+  try {
+    // Try fuser first (more reliable in CI)
+    execSync(`fuser -k ${port}/tcp 2>/dev/null || true`, { stdio: 'ignore' });
+  } catch (e) {
+    // Fallback to lsof for macOS/local development
+    try {
+      const pids = execSync(`lsof -ti tcp:${port} 2>/dev/null || true`, { encoding: 'utf8' }).trim();
+      if (pids) {
+        execSync(`kill -9 ${pids} 2>/dev/null || true`, { stdio: 'ignore' });
+      }
+    } catch (e2) {
+      // Ignore errors, port might not be in use
+    }
+  }
+}
+
 async function exec(cmd, args, opts = {}) {
   return new Promise((resolve, reject) => {
     const p = run(cmd, args, opts);
@@ -27,6 +44,11 @@ async function main() {
     { dir: 'expose-less', port: 3007 },
   ];
 
+  // Clean up all ports first
+  console.log('[exposes] cleaning up ports...');
+  exposes.forEach(({ port }) => killPort(port));
+  await new Promise(resolve => setTimeout(resolve, 1000));
+
   const procs = [];
   for (const { dir, port } of exposes) {
     const cwd = path.join('expose-apps', dir);

federated-css-react-ssr/scripts/start-shells.cjs

@@ -1,4 +1,4 @@
-const { spawn } = require('node:child_process');
+const { spawn, execSync } = require('node:child_process');
 const path = require('node:path');
 const waitOn = require('wait-on');
 
@@ -8,6 +8,23 @@ function run(cmd, args, opts = {}) {
   return spawn(cmd, args, { stdio: 'inherit', cwd: root, shell: true, ...opts });
 }
 
+function killPort(port) {
+  try {
+    // Try fuser first (more reliable in CI)
+    execSync(`fuser -k ${port}/tcp 2>/dev/null || true`, { stdio: 'ignore' });
+  } catch (e) {
+    // Fallback to lsof for macOS/local development
+    try {
+      const pids = execSync(`lsof -ti tcp:${port} 2>/dev/null || true`, { encoding: 'utf8' }).trim();
+      if (pids) {
+        execSync(`kill -9 ${pids} 2>/dev/null || true`, { stdio: 'ignore' });
+      }
+    } catch (e2) {
+      // Ignore errors, port might not be in use
+    }
+  }
+}
+
 async function exec(cmd, args, opts = {}) {
   return new Promise((resolve, reject) => {
     const p = run(cmd, args, opts);
@@ -26,6 +43,11 @@ async function main() {
     { dir: 'scss-tailwind-css', port: 4005 },
   ];
 
+  // Clean up all ports first
+  console.log('[shells] cleaning up ports...');
+  shells.forEach(({ port }) => killPort(port));
+  await new Promise(resolve => setTimeout(resolve, 1000));
+
   const procs = [];
   for (const { dir, port } of shells) {
     const cwd = path.join('shell-apps', dir);

federated-css/scripts/start-all.cjs

@@ -17,13 +17,18 @@ function run(cmd, args) {
 
 function killPort(port) {
   try {
-    // Kill any process on the port (macOS/Linux compatible)
-    const pids = execSync(`lsof -ti tcp:${port} 2>/dev/null || true`, { encoding: 'utf8' }).trim();
-    if (pids) {
-      execSync(`kill -9 ${pids} 2>/dev/null || true`, { stdio: 'ignore' });
-    }
+    // Try fuser first (more reliable in CI)
+    execSync(`fuser -k ${port}/tcp 2>/dev/null || true`, { stdio: 'ignore' });
   } catch (e) {
-    // Ignore errors, port might not be in use
+    // Fallback to lsof for macOS/local development
+    try {
+      const pids = execSync(`lsof -ti tcp:${port} 2>/dev/null || true`, { encoding: 'utf8' }).trim();
+      if (pids) {
+        execSync(`kill -9 ${pids} 2>/dev/null || true`, { stdio: 'ignore' });
+      }
+    } catch (e2) {
+      // Ignore errors, port might not be in use
+    }
   }
 }
 
@@ -52,6 +57,9 @@ async function main() {
   // Kill all potentially conflicting ports first
   console.log('[federated-css] cleaning up ports...');
   [...reactConsumers.map(c => c.port), ...exposes, ...nextConsumers.map(c => c.port)].forEach(killPort);
+  
+  // Give OS time to fully release ports
+  await new Promise(resolve => setTimeout(resolve, 1000));
 
   console.log('[federated-css] starting consumers-react (sequential servers)...');
   for (const { dir, port, serve } of reactConsumers) {
@@ -120,6 +128,7 @@ async function main() {
   for (const { dir, port } of nextConsumers) {
     // Extra cleanup for each Next.js port in case previous one didn't clean up properly
     killPort(port);
+    await new Promise(resolve => setTimeout(resolve, 500)); // Small delay to ensure port is released
     const cwd = path.join('consumers-nextjs', dir);
     const p = run('pnpm', ['-C', cwd, 'run', 'start']);
     procs.push(p);