orchestrai 0.1.5 → 0.1.7

package/README.md

@@ -36,6 +36,37 @@ xattr -d com.apple.quarantine "$(which orchestrai)"
 
 (or the equivalent path npm installed it under) before running it again.
 
+### WSL on Windows: "optional dependency isn't installed"
+
+If you install `orchestrai` inside a WSL distro and see
+`The "orchestrai-linux-x64" optional dependency isn't installed` even
+though a fresh install just succeeded, the likely cause isn't a broken
+install — it's a **stale Windows npm install shadowing the WSL one**.
+WSL exposes Windows executables on `$PATH` by default, and if you ever ran
+`npm install -g orchestrai` from Windows (or through WSL before installing
+a native Linux Node via `nvm`), that install can keep resolving even after
+you set up a proper native one, especially if your shell has cached the
+old command location.
+
+Fix:
+```bash
+which orchestrai        # if this prints a /mnt/c/... path, that's the problem
+```
+```bash
+# remove the Windows-side shims directly (adjust the path to your username)
+rm "/mnt/c/Users/<you>/AppData/Roaming/npm/orchestrai" \
+   "/mnt/c/Users/<you>/AppData/Roaming/npm/orchestrai.cmd" \
+   "/mnt/c/Users/<you>/AppData/Roaming/npm/orchestrai.ps1"
+hash -r                 # zsh: clear the cached command path
+which orchestrai         # should now show a path under ~/.nvm/... or similar
+```
+If you don't already have a native Node installed inside the distro
+(`node -v` fails, or `which node` shows a `/mnt/c/...` path), install one
+first — e.g. via [nvm](https://github.com/nvm-sh/nvm) — before reinstalling
+`orchestrai`. A Node/npm running through the Windows bridge will correctly
+pick the *Windows* platform package, not Linux, no matter how many times
+you reinstall.
+
 ## Usage
 
 ```

package/bin/orchestrai.js

@@ -24,7 +24,7 @@
 
 const path = require("path")
 const { spawnSync } = require("child_process")
-const { chmodSync } = require("fs")
+const { chmodSync, existsSync } = require("fs")
 
 // One fixed platform package per supported platform+arch — mirrors
 // npm-package/*/package.json's own "os"/"cpu" restrictions exactly.
@@ -47,12 +47,19 @@ function resolveBinaryPath() {
         `See https://github.com/Muhamad-Yussuf/devops-mcp-server#readme for building from source instead.`,
     )
   }
+  // Resolve the platform package's own package.json first, then join the
+  // known relative bin path onto its directory — rather than
+  // require.resolve()-ing the binary's deep sub-path directly. Found live
+  // (a real WSL/global-install report, binary confirmed present on disk
+  // in exactly the expected location, yet the deep-path resolve() still
+  // failed) that the direct approach is fragile in at least one real
+  // global-install layout, for a reason not fully pinned down. Resolving
+  // package.json is the same pattern esbuild's own installer uses for
+  // this exact reason — it only depends on Node finding the package
+  // directory at all, not on any deep multi-segment specifier resolution.
+  let pkgDir
   try {
-    // require.resolve() walks node_modules exactly the way `require()`
-    // would — correct whether this dispatcher is itself inside
-    // node_modules/orchestrai/bin/ (the real installed case) or run
-    // directly from a workspace/monorepo layout during local testing.
-    return require.resolve(path.join(entry.pkg, "bin", entry.bin))
+    pkgDir = path.dirname(require.resolve(path.join(entry.pkg, "package.json")))
   } catch {
     throw new Error(
       `The "${entry.pkg}" optional dependency isn't installed. ` +
@@ -61,6 +68,17 @@ function resolveBinaryPath() {
         `Try reinstalling without those flags.`,
     )
   }
+
+  const binPath = path.join(pkgDir, "bin", entry.bin)
+  if (!existsSync(binPath)) {
+    throw new Error(
+      `The "${entry.pkg}" optional dependency is installed at ${pkgDir}, ` +
+        `but its expected binary is missing at ${binPath}. The install may ` +
+        `be corrupted — try "npm uninstall -g orchestrai && npm cache clean ` +
+        `--force && npm i -g orchestrai" to reinstall cleanly.`,
+    )
+  }
+  return binPath
 }
 
 function main() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "orchestrai",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "OrchestrAI — run the standalone orchestrai binary via bunx/npx with nothing pre-installed. The right platform binary is installed automatically as an optional dependency; no network download at runtime.",
   "license": "MIT",
   "bin": {
@@ -11,9 +11,9 @@
     "README.md"
   ],
   "optionalDependencies": {
-    "orchestrai-windows-x64": "0.1.4",
-    "orchestrai-linux-x64": "0.1.4",
-    "orchestrai-darwin-arm64": "0.1.4"
+    "orchestrai-windows-x64": "0.1.7",
+    "orchestrai-linux-x64": "0.1.7",
+    "orchestrai-darwin-arm64": "0.1.7"
   },
   "engines": {
     "node": ">=18"