@mindexec/cli 0.2.0 → 0.2.1

package/README.md

@@ -18,6 +18,14 @@ By default the CLI opens the MindCanvas app in your default browser after the
 bridge is ready. Use `mindexec --no-open` or `MINDEXEC_NO_OPEN=1` when you only
 want to start the listener.
 
+For npx and global installs, the default workspace is the directory where you
+run the command. Run it from the folder that contains your `.mindexec` data, or
+pass the workspace explicitly:
+
+```bash
+npx @mindexec/cli --workspace /path/to/workspace
+```
+
 For local frontend development, keep LocalBridge running and refresh the
 packaged app bundle after code changes:
 
@@ -47,6 +55,7 @@ mindexec
 湲곕낯 ?ㅽ뻾 二쇱냼??`http://127.0.0.1:5147`?낅땲?? `WORKSPACE_PATH`媛€ 鍮꾩뼱 ?덉쑝硫??ㅼ튂???⑦궎吏€??遺€紐??대뜑瑜?湲곕낯 ?묒뾽 怨듦컙?쇰줈 ?ъ슜?⑸땲??
 
 ```bash
+mindexec --workspace /custom/path
 BRIDGE_PORT=8080 WORKSPACE_PATH=/custom/path mindexec
 ```
 

package/launch-bridge.cjs

@@ -1,6 +1,7 @@
 #!/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');
@@ -8,23 +9,94 @@ 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 workspacePath = inheritedWorkspacePath || path.resolve(bridgeRoot, '..');
 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] [node-options]
-  npx @mindexec/cli
+  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. Default: parent of the installed package
+  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
@@ -37,25 +109,27 @@ Environment:
 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 (rawArgs.includes('--help') || rawArgs.includes('-h')) {
+if (cliArgs.includes('--help') || cliArgs.includes('-h')) {
     printHelp();
     process.exit(0);
 }
 
-if (rawArgs.includes('--version') || rawArgs.includes('-v')) {
+if (cliArgs.includes('--version') || cliArgs.includes('-v')) {
     console.log(packageInfo.version);
     process.exit(0);
 }
 
-const command = rawArgs[0];
+const command = cliArgs[0];
 const commandArgs = command === 'start' || command === 'bridge'
-    ? rawArgs.slice(1)
-    : rawArgs;
+    ? 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());

package/package.json

@@ -1,25 +1,25 @@
 {
   "name": "@mindexec/cli",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "MindExec local runtime and bridge CLI",
   "main": "server.js",
   "type": "module",
-  "files": [
-    "start-bridge.bat",
-    "start-bridge.sh",
-    "launch-bridge.cjs",
-    "server.js",
-    "codex-runtime.js",
-    "port-guard.cjs",
-    "wwwroot/",
-    "scripts/",
+  "files": [
+    "start-bridge.bat",
+    "start-bridge.sh",
+    "launch-bridge.cjs",
+    "server.js",
+    "codex-runtime.js",
+    "port-guard.cjs",
+    "wwwroot/",
+    "scripts/",
     "tree-sitter-grammars/",
     "README.md"
   ],
   "scripts": {
     "start": "node launch-bridge.cjs",
     "dev": "node launch-bridge.cjs --watch",
-    "test:syntax": "node --check server.js && node --check codex-runtime.js && node --check launch-bridge.cjs && node --check port-guard.cjs && node --check scripts/setup-tree-sitter-grammars.mjs",
+    "test:syntax": "node --check server.js && node --check codex-runtime.js && node --check launch-bridge.cjs && node --check port-guard.cjs && node --check scripts/setup-tree-sitter-grammars.mjs",
     "pack:dry": "npm pack --dry-run",
     "setup:grammars": "node scripts/setup-tree-sitter-grammars.mjs",
     "postinstall": "npm run setup:grammars"