@mindexec/cli 0.2.478 → 0.2.480

package/launch-bridge.cjs

@@ -1,236 +1,236 @@
-#!/usr/bin/env node
-
-const path = require('path');
-const fs = require('fs');
-const { spawn } = require('child_process');
-const packageInfo = require('./package.json');
-const { normalizePort, releaseBridgePort } = require('./port-guard.cjs');
-
-const bridgeRoot = __dirname;
-const serverPath = path.resolve(bridgeRoot, 'server.js');
-const inheritedWorkspacePath = String(process.env.WORKSPACE_PATH || '').trim();
-const rawArgs = process.argv.slice(2);
-const parsedArgs = extractWorkspaceArg(rawArgs);
-const cliArgs = parsedArgs.args;
-const workspacePath = path.resolve(
-    parsedArgs.workspacePath || inheritedWorkspacePath || getDefaultWorkspacePath()
-);
-const appUrl = `http://localhost:${normalizePort(process.env.BRIDGE_PORT)}/mindcanvas`;
-const statusUrl = `http://127.0.0.1:${normalizePort(process.env.BRIDGE_PORT)}/api/status`;
-
-function isSamePath(left, right) {
-    return path.resolve(left).toLowerCase() === path.resolve(right).toLowerCase();
-}
-
-function pathExists(...segments) {
-    return fs.existsSync(path.join(...segments));
-}
-
-function looksLikeWorkspaceRoot(candidate) {
-    return pathExists(candidate, '.mindexec')
-        || pathExists(candidate, 'MindExecution.Web')
-        || pathExists(candidate, 'MindExecution.Shared')
-        || pathExists(candidate, 'LocalBridge');
-}
-
-function getDefaultWorkspacePath() {
-    const cwd = process.cwd();
-    const bridgeParent = path.resolve(bridgeRoot, '..');
-
-    if (isSamePath(cwd, bridgeRoot) && looksLikeWorkspaceRoot(bridgeParent)) {
-        return bridgeParent;
-    }
-
-    return cwd;
-}
-
-function extractWorkspaceArg(args) {
-    const filteredArgs = [];
-    let workspacePath = '';
-
-    for (let index = 0; index < args.length; index += 1) {
-        const arg = args[index];
-        if (arg === '--workspace' || arg === '--workspace-path') {
-            workspacePath = String(args[index + 1] || '').trim();
-            if (!workspacePath) {
-                console.error(`[MindExec CLI] ${arg} requires a path.`);
-                process.exit(1);
-            }
-
-            index += 1;
-            continue;
-        }
-
-        if (arg.startsWith('--workspace=')) {
-            workspacePath = arg.slice('--workspace='.length).trim();
-            continue;
-        }
-
-        if (arg.startsWith('--workspace-path=')) {
-            workspacePath = arg.slice('--workspace-path='.length).trim();
-            continue;
-        }
-
-        filteredArgs.push(arg);
-    }
-
-    return {
-        args: filteredArgs,
-        workspacePath
-    };
-}
-
-function printHelp() {
-    console.log(`MindExec CLI ${packageInfo.version}
-
-Usage:
-  mindexec [start] [options] [node-options]
-  npx @mindexec/cli [options]
-
-Runs the MindExec local app and bridge on http://localhost:5147/mindcanvas by default.
-
-Options:
-  --workspace <path>
-                    Workspace root. Defaults to the current directory for npx/global runs
-  --no-open         Do not open the local app in the default browser
-
-Environment:
-  BRIDGE_PORT       Local bridge port. Default: 5147
-  WORKSPACE_PATH    Workspace root. Overridden by --workspace when both are set
-  BRIDGE_TOKEN      Fixed token for protected REST APIs
-  MINDEXEC_WEB_ROOT Published MindCanvas wwwroot override. Default: package wwwroot
-  MINDEXEC_NO_OPEN=1
-                    Do not open the local app in the default browser
-  BRIDGE_SKIP_PORT_REAP=1
-                    Do not stop an existing MindExec bridge on the same port
-  BRIDGE_FORCE_KILL_PORT_OWNER=1
-                    Stop any process that owns BRIDGE_PORT before starting
-
-Examples:
-  mindexec
-  mindexec --no-open
-  mindexec --workspace /path/to/work
-  npx @mindexec/cli --workspace /path/to/work
-  BRIDGE_PORT=8080 WORKSPACE_PATH=/path/to/work mindexec
-  mindexec --watch
-`);
-}
-
-if (cliArgs.includes('--help') || cliArgs.includes('-h')) {
-    printHelp();
-    process.exit(0);
-}
-
-if (cliArgs.includes('--version') || cliArgs.includes('-v')) {
-    console.log(packageInfo.version);
-    process.exit(0);
-}
-
-const command = cliArgs[0];
-const commandArgs = command === 'start' || command === 'bridge'
-    ? cliArgs.slice(1)
-    : cliArgs;
-const shouldOpenApp = !commandArgs.some(arg => arg === '--no-open' || arg === '--no-browser')
-    && !/^(1|true|yes|on)$/i.test(String(process.env.MINDEXEC_NO_OPEN || '').trim())
-    && !/^(0|false|no|off)$/i.test(String(process.env.MINDEXEC_OPEN_APP || '').trim());
-const runtimeArgs = commandArgs.filter(arg => arg !== '--no-open' && arg !== '--no-browser');
-const childArgs = [...runtimeArgs, serverPath];
-const port = normalizePort(process.env.BRIDGE_PORT);
-
-function delay(ms) {
-    return new Promise(resolve => setTimeout(resolve, ms));
-}
-
-async function waitForBridgeReady(timeoutMs = 15000) {
-    const startedAt = Date.now();
-    while (Date.now() - startedAt < timeoutMs) {
-        try {
-            const response = await fetch(statusUrl, { cache: 'no-store' });
-            if (response.ok) {
-                return true;
-            }
-        } catch {
-            // Server is still booting.
-        }
-
-        await delay(300);
-    }
-
-    return false;
-}
-
-function openLocalApp() {
-    let child;
-    if (process.platform === 'win32') {
-        child = spawn('cmd', ['/c', 'start', '', appUrl], {
-            detached: true,
-            stdio: 'ignore',
-            windowsHide: true
-        });
-    } else if (process.platform === 'darwin') {
-        child = spawn('open', [appUrl], {
-            detached: true,
-            stdio: 'ignore'
-        });
-    } else {
-        child = spawn('xdg-open', [appUrl], {
-            detached: true,
-            stdio: 'ignore'
-        });
-    }
-
-    child.on('error', () => {
-        console.log(`[MindExec CLI] Open the app manually: ${appUrl}`);
-    });
-    child.unref();
-}
-
-async function main() {
-    await releaseBridgePort({
-        port,
-        bridgeRoot,
-        log: message => console.log(`[MindExec CLI] ${message}`)
-    });
-
-    const child = spawn(process.execPath, childArgs, {
-        cwd: bridgeRoot,
-        env: {
-            ...process.env,
-            WORKSPACE_PATH: workspacePath
-        },
-        stdio: 'inherit',
-        windowsHide: false
-    });
-
-    child.on('exit', (code, signal) => {
-        if (signal) {
-            process.kill(process.pid, signal);
-            return;
-        }
-
-        process.exit(code ?? 0);
-    });
-
-    child.on('error', (error) => {
-        console.error('[MindExec CLI] Failed to start local bridge:', error);
-        process.exit(1);
-    });
-
-    if (shouldOpenApp) {
-        void (async () => {
-            const ready = await waitForBridgeReady();
-            if (!ready || child.exitCode !== null) {
-                console.log(`[MindExec CLI] Open the app manually: ${appUrl}`);
-                return;
-            }
-
-            console.log(`[MindExec CLI] opening ${appUrl}`);
-            openLocalApp();
-        })();
-    }
-}
-
-main().catch(error => {
-    console.error('[MindExec CLI] Failed to prepare local bridge port:', error.message || error);
-    process.exit(1);
-});
+#!/usr/bin/env node
+
+const path = require('path');
+const fs = require('fs');
+const { spawn } = require('child_process');
+const packageInfo = require('./package.json');
+const { normalizePort, releaseBridgePort } = require('./port-guard.cjs');
+
+const bridgeRoot = __dirname;
+const serverPath = path.resolve(bridgeRoot, 'server.js');
+const inheritedWorkspacePath = String(process.env.WORKSPACE_PATH || '').trim();
+const rawArgs = process.argv.slice(2);
+const parsedArgs = extractWorkspaceArg(rawArgs);
+const cliArgs = parsedArgs.args;
+const workspacePath = path.resolve(
+    parsedArgs.workspacePath || inheritedWorkspacePath || getDefaultWorkspacePath()
+);
+const appUrl = `http://localhost:${normalizePort(process.env.BRIDGE_PORT)}/mindcanvas`;
+const statusUrl = `http://127.0.0.1:${normalizePort(process.env.BRIDGE_PORT)}/api/status`;
+
+function isSamePath(left, right) {
+    return path.resolve(left).toLowerCase() === path.resolve(right).toLowerCase();
+}
+
+function pathExists(...segments) {
+    return fs.existsSync(path.join(...segments));
+}
+
+function looksLikeWorkspaceRoot(candidate) {
+    return pathExists(candidate, '.mindexec')
+        || pathExists(candidate, 'MindExecution.Web')
+        || pathExists(candidate, 'MindExecution.Shared')
+        || pathExists(candidate, 'LocalBridge');
+}
+
+function getDefaultWorkspacePath() {
+    const cwd = process.cwd();
+    const bridgeParent = path.resolve(bridgeRoot, '..');
+
+    if (isSamePath(cwd, bridgeRoot) && looksLikeWorkspaceRoot(bridgeParent)) {
+        return bridgeParent;
+    }
+
+    return cwd;
+}
+
+function extractWorkspaceArg(args) {
+    const filteredArgs = [];
+    let workspacePath = '';
+
+    for (let index = 0; index < args.length; index += 1) {
+        const arg = args[index];
+        if (arg === '--workspace' || arg === '--workspace-path') {
+            workspacePath = String(args[index + 1] || '').trim();
+            if (!workspacePath) {
+                console.error(`[MindExec CLI] ${arg} requires a path.`);
+                process.exit(1);
+            }
+
+            index += 1;
+            continue;
+        }
+
+        if (arg.startsWith('--workspace=')) {
+            workspacePath = arg.slice('--workspace='.length).trim();
+            continue;
+        }
+
+        if (arg.startsWith('--workspace-path=')) {
+            workspacePath = arg.slice('--workspace-path='.length).trim();
+            continue;
+        }
+
+        filteredArgs.push(arg);
+    }
+
+    return {
+        args: filteredArgs,
+        workspacePath
+    };
+}
+
+function printHelp() {
+    console.log(`MindExec CLI ${packageInfo.version}
+
+Usage:
+  mindexec [start] [options] [node-options]
+  npx @mindexec/cli [options]
+
+Runs the MindExec local app and bridge on http://localhost:5147/mindcanvas by default.
+
+Options:
+  --workspace <path>
+                    Workspace root. Defaults to the current directory for npx/global runs
+  --no-open         Do not open the local app in the default browser
+
+Environment:
+  BRIDGE_PORT       Local bridge port. Default: 5147
+  WORKSPACE_PATH    Workspace root. Overridden by --workspace when both are set
+  BRIDGE_TOKEN      Fixed token for protected REST APIs
+  MINDEXEC_WEB_ROOT Published MindCanvas wwwroot override. Default: package wwwroot
+  MINDEXEC_NO_OPEN=1
+                    Do not open the local app in the default browser
+  BRIDGE_SKIP_PORT_REAP=1
+                    Do not stop an existing MindExec bridge on the same port
+  BRIDGE_FORCE_KILL_PORT_OWNER=1
+                    Stop any process that owns BRIDGE_PORT before starting
+
+Examples:
+  mindexec
+  mindexec --no-open
+  mindexec --workspace /path/to/work
+  npx @mindexec/cli --workspace /path/to/work
+  BRIDGE_PORT=8080 WORKSPACE_PATH=/path/to/work mindexec
+  mindexec --watch
+`);
+}
+
+if (cliArgs.includes('--help') || cliArgs.includes('-h')) {
+    printHelp();
+    process.exit(0);
+}
+
+if (cliArgs.includes('--version') || cliArgs.includes('-v')) {
+    console.log(packageInfo.version);
+    process.exit(0);
+}
+
+const command = cliArgs[0];
+const commandArgs = command === 'start' || command === 'bridge'
+    ? cliArgs.slice(1)
+    : cliArgs;
+const shouldOpenApp = !commandArgs.some(arg => arg === '--no-open' || arg === '--no-browser')
+    && !/^(1|true|yes|on)$/i.test(String(process.env.MINDEXEC_NO_OPEN || '').trim())
+    && !/^(0|false|no|off)$/i.test(String(process.env.MINDEXEC_OPEN_APP || '').trim());
+const runtimeArgs = commandArgs.filter(arg => arg !== '--no-open' && arg !== '--no-browser');
+const childArgs = [...runtimeArgs, serverPath];
+const port = normalizePort(process.env.BRIDGE_PORT);
+
+function delay(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+
+async function waitForBridgeReady(timeoutMs = 15000) {
+    const startedAt = Date.now();
+    while (Date.now() - startedAt < timeoutMs) {
+        try {
+            const response = await fetch(statusUrl, { cache: 'no-store' });
+            if (response.ok) {
+                return true;
+            }
+        } catch {
+            // Server is still booting.
+        }
+
+        await delay(300);
+    }
+
+    return false;
+}
+
+function openLocalApp() {
+    let child;
+    if (process.platform === 'win32') {
+        child = spawn('cmd', ['/c', 'start', '', appUrl], {
+            detached: true,
+            stdio: 'ignore',
+            windowsHide: true
+        });
+    } else if (process.platform === 'darwin') {
+        child = spawn('open', [appUrl], {
+            detached: true,
+            stdio: 'ignore'
+        });
+    } else {
+        child = spawn('xdg-open', [appUrl], {
+            detached: true,
+            stdio: 'ignore'
+        });
+    }
+
+    child.on('error', () => {
+        console.log(`[MindExec CLI] Open the app manually: ${appUrl}`);
+    });
+    child.unref();
+}
+
+async function main() {
+    await releaseBridgePort({
+        port,
+        bridgeRoot,
+        log: message => console.log(`[MindExec CLI] ${message}`)
+    });
+
+    const child = spawn(process.execPath, childArgs, {
+        cwd: bridgeRoot,
+        env: {
+            ...process.env,
+            WORKSPACE_PATH: workspacePath
+        },
+        stdio: 'inherit',
+        windowsHide: false
+    });
+
+    child.on('exit', (code, signal) => {
+        if (signal) {
+            process.kill(process.pid, signal);
+            return;
+        }
+
+        process.exit(code ?? 0);
+    });
+
+    child.on('error', (error) => {
+        console.error('[MindExec CLI] Failed to start local bridge:', error);
+        process.exit(1);
+    });
+
+    if (shouldOpenApp) {
+        void (async () => {
+            const ready = await waitForBridgeReady();
+            if (!ready || child.exitCode !== null) {
+                console.log(`[MindExec CLI] Open the app manually: ${appUrl}`);
+                return;
+            }
+
+            console.log(`[MindExec CLI] opening ${appUrl}`);
+            openLocalApp();
+        })();
+    }
+}
+
+main().catch(error => {
+    console.error('[MindExec CLI] Failed to prepare local bridge port:', error.message || error);
+    process.exit(1);
+});