@mindexec/cli 0.2.478 → 0.2.480

package/port-guard.cjs

@@ -1,285 +1,285 @@
-const { execFile } = require('child_process');
-const http = require('http');
-const path = require('path');
-const { promisify } = require('util');
-
-const execFileAsync = promisify(execFile);
-const DEFAULT_WAIT_MS = 3500;
-const STATUS_PROBE_TIMEOUT_MS = 650;
-
-function normalizePort(value, fallback = 5147) {
-    const parsed = Number.parseInt(String(value || '').trim(), 10);
-    return Number.isInteger(parsed) && parsed > 0 && parsed <= 65535
-        ? parsed
-        : fallback;
-}
-
-function normalizePath(value) {
-    return String(value || '').replace(/\\/g, '/').toLowerCase();
-}
-
-function isTruthy(value) {
-    return /^(1|true|yes|on)$/i.test(String(value || '').trim());
-}
-
-function endpointUsesPort(endpoint, port) {
-    const text = String(endpoint || '').trim();
-    return text.endsWith(`:${port}`)
-        || text.endsWith(`.${port}`)
-        || text.includes(`:${port} `)
-        || text.includes(`]:${port}`);
-}
-
-async function getWindowsListeners(port) {
-    const { stdout } = await execFileAsync('netstat.exe', ['-ano', '-p', 'tcp'], {
-        windowsHide: true,
-        maxBuffer: 1024 * 1024
-    });
-
-    const pids = new Set();
-    for (const rawLine of String(stdout || '').split(/\r?\n/)) {
-        const line = rawLine.trim();
-        if (!line || !/\bLISTENING\b/i.test(line)) {
-            continue;
-        }
-
-        const parts = line.split(/\s+/);
-        if (parts.length < 5 || !endpointUsesPort(parts[1], port)) {
-            continue;
-        }
-
-        const pid = Number.parseInt(parts[parts.length - 1], 10);
-        if (Number.isInteger(pid) && pid > 0 && pid !== process.pid) {
-            pids.add(pid);
-        }
-    }
-
-    return [...pids];
-}
-
-async function getUnixListeners(port) {
-    try {
-        const { stdout } = await execFileAsync('lsof', ['-nP', `-iTCP:${port}`, '-sTCP:LISTEN', '-t'], {
-            maxBuffer: 256 * 1024
-        });
-        return String(stdout || '')
-            .split(/\r?\n/)
-            .map(line => Number.parseInt(line.trim(), 10))
-            .filter(pid => Number.isInteger(pid) && pid > 0 && pid !== process.pid);
-    } catch {
-        return [];
-    }
-}
-
-async function getPortListeners(port) {
-    try {
-        return process.platform === 'win32'
-            ? await getWindowsListeners(port)
-            : await getUnixListeners(port);
-    } catch {
-        return [];
-    }
-}
-
-async function getWindowsProcessDetails(pid) {
-    const script = [
-        '$ErrorActionPreference = "SilentlyContinue";',
-        `$p = Get-CimInstance Win32_Process -Filter "ProcessId=${pid}";`,
-        'if ($p) {',
-        '  [pscustomobject]@{ ProcessId = $p.ProcessId; ExecutablePath = $p.ExecutablePath; CommandLine = $p.CommandLine } | ConvertTo-Json -Compress',
-        '}'
-    ].join(' ');
-    const { stdout } = await execFileAsync('powershell.exe', ['-NoProfile', '-Command', script], {
-        windowsHide: true,
-        maxBuffer: 256 * 1024
-    });
-    const parsed = JSON.parse(String(stdout || '{}').trim() || '{}');
-    return {
-        pid,
-        executablePath: parsed.ExecutablePath || '',
-        commandLine: parsed.CommandLine || ''
-    };
-}
-
-async function getUnixProcessDetails(pid) {
-    const { stdout } = await execFileAsync('ps', ['-p', String(pid), '-o', 'comm=', '-o', 'args='], {
-        maxBuffer: 256 * 1024
-    });
-    const text = String(stdout || '').trim();
-    return {
-        pid,
-        executablePath: text.split(/\s+/)[0] || '',
-        commandLine: text
-    };
-}
-
-async function getProcessDetails(pid) {
-    try {
-        return process.platform === 'win32'
-            ? await getWindowsProcessDetails(pid)
-            : await getUnixProcessDetails(pid);
-    } catch {
-        return {
-            pid,
-            executablePath: '',
-            commandLine: ''
-        };
-    }
-}
-
-function looksLikeMindExecBridge(details, bridgeRoot) {
-    const text = normalizePath(`${details.executablePath || ''} ${details.commandLine || ''}`);
-    const root = normalizePath(bridgeRoot);
-    const packageRoot = normalizePath(path.dirname(bridgeRoot));
-
-    return (root && text.includes(root))
-        || (packageRoot && text.includes(`${packageRoot}/localbridge/`))
-        || text.includes('localbridge/server.js')
-        || text.includes('localbridge/launch-bridge.cjs')
-        || text.includes('/localbridge/server.js')
-        || text.includes('/localbridge/launch-bridge.cjs')
-        || text.includes('@mindexec/cli')
-        || text.includes('mind-bridge')
-        || /\bmindexec(\.cmd|\.ps1|\.exe)?\b/i.test(text);
-}
-
-async function probeMindExecStatus(port) {
-    return await new Promise(resolve => {
-        const request = http.request({
-            hostname: '127.0.0.1',
-            port,
-            path: '/api/status',
-            method: 'GET',
-            timeout: STATUS_PROBE_TIMEOUT_MS,
-            headers: {
-                Accept: 'application/json'
-            }
-        }, response => {
-            let body = '';
-            response.setEncoding('utf8');
-            response.on('data', chunk => {
-                body += chunk;
-                if (body.length > 64 * 1024) {
-                    request.destroy();
-                    resolve(false);
-                }
-            });
-            response.on('end', () => {
-                if (response.statusCode !== 200) {
-                    resolve(false);
-                    return;
-                }
-
-                try {
-                    const payload = JSON.parse(body || '{}');
-                    resolve(
-                        payload?.app === 'MindExec' &&
-                        payload?.packageName === '@mindexec/cli' &&
-                        payload?.status === 'ok'
-                    );
-                } catch {
-                    resolve(false);
-                }
-            });
-        });
-
-        request.on('timeout', () => {
-            request.destroy();
-            resolve(false);
-        });
-        request.on('error', () => resolve(false));
-        request.end();
-    });
-}
-
-async function waitForPortRelease(port, timeoutMs = DEFAULT_WAIT_MS) {
-    const started = Date.now();
-    while (Date.now() - started < timeoutMs) {
-        const listeners = await getPortListeners(port);
-        if (listeners.length === 0) {
-            return true;
-        }
-
-        await new Promise(resolve => setTimeout(resolve, 120));
-    }
-
-    return false;
-}
-
-function killPid(pid, signal) {
-    try {
-        process.kill(pid, signal);
-        return true;
-    } catch {
-        return false;
-    }
-}
-
-async function releaseBridgePort(options = {}) {
-    const port = normalizePort(options.port || process.env.BRIDGE_PORT);
-    const bridgeRoot = options.bridgeRoot || __dirname;
-    const log = typeof options.log === 'function' ? options.log : () => {};
-    const force = isTruthy(process.env.BRIDGE_FORCE_KILL_PORT_OWNER)
-        || isTruthy(process.env.BRIDGE_KILL_ANY_PORT_OWNER);
-    const disabled = isTruthy(process.env.BRIDGE_SKIP_PORT_REAP);
-
-    if (disabled) {
-        return { port, killed: [], skipped: [], disabled: true };
-    }
-
-    const pids = await getPortListeners(port);
-    const killed = [];
-    const skipped = [];
-
-    for (const pid of pids) {
-        const details = await getProcessDetails(pid);
-        const canKill = force ||
-            looksLikeMindExecBridge(details, bridgeRoot) ||
-            await probeMindExecStatus(port);
-        if (!canKill) {
-            skipped.push(details);
-            continue;
-        }
-
-        if (killPid(pid, 'SIGTERM')) {
-            killed.push(details);
-            log(`stopping existing LocalBridge listener on port ${port} (pid ${pid})`);
-        }
-    }
-
-    if (killed.length > 0) {
-        const released = await waitForPortRelease(port);
-        if (!released) {
-            const remaining = await getPortListeners(port);
-            for (const details of killed) {
-                if (remaining.includes(details.pid)) {
-                    killPid(details.pid, 'SIGKILL');
-                    log(`force-stopping LocalBridge listener on port ${port} (pid ${details.pid})`);
-                }
-            }
-
-            await waitForPortRelease(port, 1200);
-        }
-    }
-
-    if (skipped.length > 0) {
-        const owners = skipped
-            .map(item => `pid ${item.pid}${item.commandLine ? ` (${item.commandLine})` : ''}`)
-            .join('; ');
-        const error = new Error(
-            `Port ${port} is already in use by a non-MindExec process: ${owners}. ` +
-            'Close it or set BRIDGE_FORCE_KILL_PORT_OWNER=1 to terminate any owner of this bridge port.'
-        );
-        error.code = 'BRIDGE_PORT_IN_USE';
-        error.port = port;
-        error.skipped = skipped;
-        throw error;
-    }
-
-    return { port, killed, skipped, disabled: false };
-}
-
-module.exports = {
-    normalizePort,
-    releaseBridgePort
-};
+const { execFile } = require('child_process');
+const http = require('http');
+const path = require('path');
+const { promisify } = require('util');
+
+const execFileAsync = promisify(execFile);
+const DEFAULT_WAIT_MS = 3500;
+const STATUS_PROBE_TIMEOUT_MS = 650;
+
+function normalizePort(value, fallback = 5147) {
+    const parsed = Number.parseInt(String(value || '').trim(), 10);
+    return Number.isInteger(parsed) && parsed > 0 && parsed <= 65535
+        ? parsed
+        : fallback;
+}
+
+function normalizePath(value) {
+    return String(value || '').replace(/\\/g, '/').toLowerCase();
+}
+
+function isTruthy(value) {
+    return /^(1|true|yes|on)$/i.test(String(value || '').trim());
+}
+
+function endpointUsesPort(endpoint, port) {
+    const text = String(endpoint || '').trim();
+    return text.endsWith(`:${port}`)
+        || text.endsWith(`.${port}`)
+        || text.includes(`:${port} `)
+        || text.includes(`]:${port}`);
+}
+
+async function getWindowsListeners(port) {
+    const { stdout } = await execFileAsync('netstat.exe', ['-ano', '-p', 'tcp'], {
+        windowsHide: true,
+        maxBuffer: 1024 * 1024
+    });
+
+    const pids = new Set();
+    for (const rawLine of String(stdout || '').split(/\r?\n/)) {
+        const line = rawLine.trim();
+        if (!line || !/\bLISTENING\b/i.test(line)) {
+            continue;
+        }
+
+        const parts = line.split(/\s+/);
+        if (parts.length < 5 || !endpointUsesPort(parts[1], port)) {
+            continue;
+        }
+
+        const pid = Number.parseInt(parts[parts.length - 1], 10);
+        if (Number.isInteger(pid) && pid > 0 && pid !== process.pid) {
+            pids.add(pid);
+        }
+    }
+
+    return [...pids];
+}
+
+async function getUnixListeners(port) {
+    try {
+        const { stdout } = await execFileAsync('lsof', ['-nP', `-iTCP:${port}`, '-sTCP:LISTEN', '-t'], {
+            maxBuffer: 256 * 1024
+        });
+        return String(stdout || '')
+            .split(/\r?\n/)
+            .map(line => Number.parseInt(line.trim(), 10))
+            .filter(pid => Number.isInteger(pid) && pid > 0 && pid !== process.pid);
+    } catch {
+        return [];
+    }
+}
+
+async function getPortListeners(port) {
+    try {
+        return process.platform === 'win32'
+            ? await getWindowsListeners(port)
+            : await getUnixListeners(port);
+    } catch {
+        return [];
+    }
+}
+
+async function getWindowsProcessDetails(pid) {
+    const script = [
+        '$ErrorActionPreference = "SilentlyContinue";',
+        `$p = Get-CimInstance Win32_Process -Filter "ProcessId=${pid}";`,
+        'if ($p) {',
+        '  [pscustomobject]@{ ProcessId = $p.ProcessId; ExecutablePath = $p.ExecutablePath; CommandLine = $p.CommandLine } | ConvertTo-Json -Compress',
+        '}'
+    ].join(' ');
+    const { stdout } = await execFileAsync('powershell.exe', ['-NoProfile', '-Command', script], {
+        windowsHide: true,
+        maxBuffer: 256 * 1024
+    });
+    const parsed = JSON.parse(String(stdout || '{}').trim() || '{}');
+    return {
+        pid,
+        executablePath: parsed.ExecutablePath || '',
+        commandLine: parsed.CommandLine || ''
+    };
+}
+
+async function getUnixProcessDetails(pid) {
+    const { stdout } = await execFileAsync('ps', ['-p', String(pid), '-o', 'comm=', '-o', 'args='], {
+        maxBuffer: 256 * 1024
+    });
+    const text = String(stdout || '').trim();
+    return {
+        pid,
+        executablePath: text.split(/\s+/)[0] || '',
+        commandLine: text
+    };
+}
+
+async function getProcessDetails(pid) {
+    try {
+        return process.platform === 'win32'
+            ? await getWindowsProcessDetails(pid)
+            : await getUnixProcessDetails(pid);
+    } catch {
+        return {
+            pid,
+            executablePath: '',
+            commandLine: ''
+        };
+    }
+}
+
+function looksLikeMindExecBridge(details, bridgeRoot) {
+    const text = normalizePath(`${details.executablePath || ''} ${details.commandLine || ''}`);
+    const root = normalizePath(bridgeRoot);
+    const packageRoot = normalizePath(path.dirname(bridgeRoot));
+
+    return (root && text.includes(root))
+        || (packageRoot && text.includes(`${packageRoot}/localbridge/`))
+        || text.includes('localbridge/server.js')
+        || text.includes('localbridge/launch-bridge.cjs')
+        || text.includes('/localbridge/server.js')
+        || text.includes('/localbridge/launch-bridge.cjs')
+        || text.includes('@mindexec/cli')
+        || text.includes('mind-bridge')
+        || /\bmindexec(\.cmd|\.ps1|\.exe)?\b/i.test(text);
+}
+
+async function probeMindExecStatus(port) {
+    return await new Promise(resolve => {
+        const request = http.request({
+            hostname: '127.0.0.1',
+            port,
+            path: '/api/status',
+            method: 'GET',
+            timeout: STATUS_PROBE_TIMEOUT_MS,
+            headers: {
+                Accept: 'application/json'
+            }
+        }, response => {
+            let body = '';
+            response.setEncoding('utf8');
+            response.on('data', chunk => {
+                body += chunk;
+                if (body.length > 64 * 1024) {
+                    request.destroy();
+                    resolve(false);
+                }
+            });
+            response.on('end', () => {
+                if (response.statusCode !== 200) {
+                    resolve(false);
+                    return;
+                }
+
+                try {
+                    const payload = JSON.parse(body || '{}');
+                    resolve(
+                        payload?.app === 'MindExec' &&
+                        payload?.packageName === '@mindexec/cli' &&
+                        payload?.status === 'ok'
+                    );
+                } catch {
+                    resolve(false);
+                }
+            });
+        });
+
+        request.on('timeout', () => {
+            request.destroy();
+            resolve(false);
+        });
+        request.on('error', () => resolve(false));
+        request.end();
+    });
+}
+
+async function waitForPortRelease(port, timeoutMs = DEFAULT_WAIT_MS) {
+    const started = Date.now();
+    while (Date.now() - started < timeoutMs) {
+        const listeners = await getPortListeners(port);
+        if (listeners.length === 0) {
+            return true;
+        }
+
+        await new Promise(resolve => setTimeout(resolve, 120));
+    }
+
+    return false;
+}
+
+function killPid(pid, signal) {
+    try {
+        process.kill(pid, signal);
+        return true;
+    } catch {
+        return false;
+    }
+}
+
+async function releaseBridgePort(options = {}) {
+    const port = normalizePort(options.port || process.env.BRIDGE_PORT);
+    const bridgeRoot = options.bridgeRoot || __dirname;
+    const log = typeof options.log === 'function' ? options.log : () => {};
+    const force = isTruthy(process.env.BRIDGE_FORCE_KILL_PORT_OWNER)
+        || isTruthy(process.env.BRIDGE_KILL_ANY_PORT_OWNER);
+    const disabled = isTruthy(process.env.BRIDGE_SKIP_PORT_REAP);
+
+    if (disabled) {
+        return { port, killed: [], skipped: [], disabled: true };
+    }
+
+    const pids = await getPortListeners(port);
+    const killed = [];
+    const skipped = [];
+
+    for (const pid of pids) {
+        const details = await getProcessDetails(pid);
+        const canKill = force ||
+            looksLikeMindExecBridge(details, bridgeRoot) ||
+            await probeMindExecStatus(port);
+        if (!canKill) {
+            skipped.push(details);
+            continue;
+        }
+
+        if (killPid(pid, 'SIGTERM')) {
+            killed.push(details);
+            log(`stopping existing LocalBridge listener on port ${port} (pid ${pid})`);
+        }
+    }
+
+    if (killed.length > 0) {
+        const released = await waitForPortRelease(port);
+        if (!released) {
+            const remaining = await getPortListeners(port);
+            for (const details of killed) {
+                if (remaining.includes(details.pid)) {
+                    killPid(details.pid, 'SIGKILL');
+                    log(`force-stopping LocalBridge listener on port ${port} (pid ${details.pid})`);
+                }
+            }
+
+            await waitForPortRelease(port, 1200);
+        }
+    }
+
+    if (skipped.length > 0) {
+        const owners = skipped
+            .map(item => `pid ${item.pid}${item.commandLine ? ` (${item.commandLine})` : ''}`)
+            .join('; ');
+        const error = new Error(
+            `Port ${port} is already in use by a non-MindExec process: ${owners}. ` +
+            'Close it or set BRIDGE_FORCE_KILL_PORT_OWNER=1 to terminate any owner of this bridge port.'
+        );
+        error.code = 'BRIDGE_PORT_IN_USE';
+        error.port = port;
+        error.skipped = skipped;
+        throw error;
+    }
+
+    return { port, killed, skipped, disabled: false };
+}
+
+module.exports = {
+    normalizePort,
+    releaseBridgePort
+};