jbai-cli 1.5.4 → 1.6.0

package/README.md

@@ -76,6 +76,16 @@ jbai-opencode
 jbai handoff --task "continue this work in orca-lab"
 ```
 
+### Handoff to Orca Lab (nightly/staging)
+```bash
+export ORCA_LAB_URL="https://orca-lab-nightly.labs.jb.gg"
+export FACADE_JWT_TOKEN="..."        # required for /api/handoff
+export GITHUB_TOKEN="..."            # repo clone during provisioning
+
+jbai handoff --task "add new e2e test" \
+  --repo "https://github.com/JetBrains/jcp-orca-facade.git"
+```
+
 ### In-session handoff (interactive tools)
 While running `jbai-codex`, `jbai-claude`, `jbai-gemini`, or `jbai-opencode`:
 - Press `Ctrl+]` to trigger a handoff to Orca Lab.
@@ -83,7 +93,7 @@ While running `jbai-codex`, `jbai-claude`, `jbai-gemini`, or `jbai-opencode`:
 
 Optional environment variables:
 - `ORCA_LAB_URL` (default: `http://localhost:3000`)
-- `FACADE_JWT_TOKEN` (local facade auth)
+- `FACADE_JWT_TOKEN` (required for /api/handoff on hosted Orca Lab)
 - `GITHUB_TOKEN` / `GH_TOKEN` (private repos)
 - `JBAI_HANDOFF_TASK` (fallback task if no prompt captured)
 - `JBAI_HANDOFF_REPO` (override repo URL)

package/lib/interactive-handoff.js

@@ -54,13 +54,33 @@ function runWithHandoff({
 
   process.stderr.write(`ℹ️  Handoff trigger: ${label}\n`);
 
-  const ptyProcess = pty.spawn(command, args, {
-    name: 'xterm-256color',
-    cols: process.stdout.columns || 80,
-    rows: process.stdout.rows || 24,
-    cwd: process.cwd(),
-    env,
-  });
+  let ptyProcess;
+  try {
+    ptyProcess = pty.spawn(command, args, {
+      name: 'xterm-256color',
+      cols: process.stdout.columns || 80,
+      rows: process.stdout.rows || 24,
+      cwd: process.cwd(),
+      env,
+    });
+  } catch (err) {
+    // node-pty throws synchronous errors (e.g., posix_spawnp failed) when executable not found
+    const error = new Error(err.message || 'Failed to spawn process');
+    // Check if this is likely a "command not found" error
+    const isNotFound = err.message && (
+      err.message.includes('posix_spawnp failed') ||
+      err.message.includes('ENOENT') ||
+      err.message.includes('not found')
+    );
+    error.code = isNotFound ? 'ENOENT' : 'SPAWN_ERROR';
+    error.command = command;
+    error.originalError = err;
+    // Return a minimal event emitter that immediately emits the error
+    const { EventEmitter } = require('events');
+    const fakeChild = new EventEmitter();
+    setImmediate(() => fakeChild.emit('error', error));
+    return fakeChild;
+  }
 
   let lineBuffer = '';
   let lastPrompt = '';

package/lib/postinstall.js

@@ -1,7 +1,30 @@
 #!/usr/bin/env node
 
+const fs = require('fs');
+const path = require('path');
 const config = require('./config');
 
+// Fix node-pty spawn-helper permissions (macOS/Linux)
+// The prebuilt binary sometimes loses execute permissions during npm install
+try {
+  const platform = process.platform === 'darwin' ? 'darwin' : process.platform;
+  const arch = process.arch;
+  const spawnHelperPath = path.join(
+    __dirname,
+    '..',
+    'node_modules',
+    'node-pty',
+    'prebuilds',
+    `${platform}-${arch}`,
+    'spawn-helper'
+  );
+  if (fs.existsSync(spawnHelperPath)) {
+    fs.chmodSync(spawnHelperPath, 0o755);
+  }
+} catch {
+  // Ignore errors - this is a best-effort fix
+}
+
 console.log(`
 ╔══════════════════════════════════════════════════════════════╗
 ║                    jbai-cli installed!                       ║

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jbai-cli",
-  "version": "1.5.4",
+  "version": "1.6.0",
   "description": "CLI wrappers to use AI coding tools (Claude Code, Codex, Gemini CLI, OpenCode) with JetBrains AI Platform",
   "keywords": [
     "jetbrains",