@zibby/core 0.1.10 → 0.1.13

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zibby/core",
-  "version": "0.1.10",
+  "version": "0.1.13",
   "description": "Core test automation engine with multi-agent and multi-MCP support",
   "type": "module",
   "main": "src/index.js",

package/scripts/setup-official-playwright-mcp.sh

@@ -5,13 +5,30 @@ set -e
 # Get script directory for relative imports
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 
-# Step 1: Check cursor-agent
-if ! command -v cursor-agent &> /dev/null; then
+# Step 1: Check cursor-agent (check actual locations, not just PATH)
+CURSOR_AGENT_PATH=""
+if command -v cursor-agent &> /dev/null; then
+    CURSOR_AGENT_PATH=$(command -v cursor-agent)
+elif [ -x "$HOME/.local/bin/cursor-agent" ]; then
+    CURSOR_AGENT_PATH="$HOME/.local/bin/cursor-agent"
+elif [ -x "$HOME/.cursor/bin/cursor-agent" ]; then
+    CURSOR_AGENT_PATH="$HOME/.cursor/bin/cursor-agent"
+fi
+
+if [ -z "$CURSOR_AGENT_PATH" ]; then
     echo "⚠️  cursor-agent not found. Installing..."
     curl https://cursor.com/install -fsS | bash
-    export PATH="$HOME/.cursor/bin:$HOME/.local/bin:$PATH"
+    # Check again after install
+    if [ -x "$HOME/.local/bin/cursor-agent" ]; then
+        CURSOR_AGENT_PATH="$HOME/.local/bin/cursor-agent"
+    elif [ -x "$HOME/.cursor/bin/cursor-agent" ]; then
+        CURSOR_AGENT_PATH="$HOME/.cursor/bin/cursor-agent"
+    fi
 fi
 
+# Always ensure these directories are in PATH for this script
+export PATH="$HOME/.cursor/bin:$HOME/.local/bin:$PATH"
+
 # Step 2: Find Node.js absolute paths (Cursor GUI doesn't have shell PATH)
 NODE_PATH=$(which node 2>/dev/null || echo "")
 NPX_PATH=$(which npx 2>/dev/null || echo "")

package/src/framework/agents/cursor-strategy.js

@@ -26,6 +26,8 @@ export class CursorAgentStrategy extends AgentStrategy {
       'agent',
       '/usr/local/bin/agent',
       '/usr/local/bin/cursor-agent',
+      join(homedir(), '.local', 'bin', 'cursor-agent'),
+      join(homedir(), '.cursor', 'bin', 'cursor-agent'),
       '/Applications/Cursor.app/Contents/Resources/app/bin/cursor'
     ];
     
@@ -84,6 +86,8 @@ export class CursorAgentStrategy extends AgentStrategy {
       'agent',
       '/usr/local/bin/agent',
       '/usr/local/bin/cursor-agent',
+      join(homedir(), '.local', 'bin', 'cursor-agent'),
+      join(homedir(), '.cursor', 'bin', 'cursor-agent'),
       '/Applications/Cursor.app/Contents/Resources/app/bin/cursor'
     ];
     
@@ -113,11 +117,14 @@ export class CursorAgentStrategy extends AgentStrategy {
     
     if (!cursorBin) {
       throw new Error(
-        'Cursor Agent CLI not found or not working.\n\n' +
-        'Install it with:\n' +
-        '  npm install -g @cursor/agent\n\n' +
-        'Or set CURSOR_API_KEY and ensure "agent" is in your PATH.\n' +
-        'Test with: agent --version'
+        `Cursor Agent CLI not found or not working.\n\n` +
+        `Checked paths:\n` +
+        `${possibleBins.map(p => `  - ${p}`).join('\n')}\n\n` +
+        `Install cursor-agent:\n` +
+        `  curl https://cursor.com/install -fsS | bash\n\n` +
+        `Then add to PATH:\n` +
+        `  echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc\n\n` +
+        `Test with: agent --version`
       );
     }
     
@@ -322,6 +329,7 @@ export class CursorAgentStrategy extends AgentStrategy {
       let lastOutputTime = Date.now();
       let lineCount = 0;
       let killed = false;
+      let processStarted = false;
 
       const proc = spawn(bin, args, {
         cwd,
@@ -331,6 +339,24 @@ export class CursorAgentStrategy extends AgentStrategy {
 
       logger.debug(`[Agent] PID: ${proc.pid}`);
 
+      const startupTimer = setTimeout(() => {
+        if (!processStarted && lineCount === 0) {
+          killed = true;
+          logger.error(`❌ [Agent] Process failed to start within 5 seconds. Binary may not be in PATH.`);
+          logger.error(`   Binary: ${bin}`);
+          logger.error(`   PATH: ${process.env.PATH}`);
+          logger.error(`   Try: export PATH="$HOME/.local/bin:$PATH"`);
+          proc.kill('SIGTERM');
+          setTimeout(() => { if (!proc.killed) proc.kill('SIGKILL'); }, 2000);
+          reject(new Error(
+            `Cursor Agent failed to start. Binary '${bin}' not found or not executable.\n\n` +
+            `Install cursor-agent and add ~/.local/bin to your PATH:\n` +
+            `  curl https://cursor.com/install -fsS | bash\n` +
+            `  echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc`
+          ));
+        }
+      }, 5000);
+
       if (stdinPrompt) {
         proc.stdin.write(stdinPrompt);
         proc.stdin.end();
@@ -434,6 +460,11 @@ export class CursorAgentStrategy extends AgentStrategy {
         stdout += chunk;
         lastOutputTime = Date.now();
         
+        if (!processStarted) {
+          processStarted = true;
+          clearTimeout(startupTimer);
+        }
+        
         const displayText = streamParser.processChunk(chunk);
         if (displayText) {
           process.stdout.write(displayText);
@@ -448,6 +479,11 @@ export class CursorAgentStrategy extends AgentStrategy {
         stderr += chunk;
         lastOutputTime = Date.now();
         
+        if (!processStarted) {
+          processStarted = true;
+          clearTimeout(startupTimer);
+        }
+        
         const lines = chunk.split('\n').filter(l => l.trim());
         for (const line of lines) {
           logger.warn(`⚠️  [Agent stderr] ${line}`);
@@ -456,6 +492,7 @@ export class CursorAgentStrategy extends AgentStrategy {
 
       proc.on('close', (code, signal) => {
         clearTimeout(timer);
+        clearTimeout(startupTimer);
         clearInterval(heartbeat);
         streamParser.flush();
         const elapsed = Math.round((Date.now() - startTime) / 1000);
@@ -489,8 +526,14 @@ export class CursorAgentStrategy extends AgentStrategy {
 
       proc.on('error', (err) => {
         clearTimeout(timer);
+        clearTimeout(startupTimer);
         clearInterval(heartbeat);
-        reject(new Error(`Cursor Agent spawn error: ${err.message}`));
+        reject(new Error(
+          `Cursor Agent spawn error: ${err.message}\n` +
+          `Binary: ${bin}\n` +
+          `This usually means the binary is not in PATH. Try:\n` +
+          `  echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc`
+        ));
       });
     });
   }

package/templates/browser-test-automation/graph.mjs

@@ -47,13 +47,12 @@ export class BrowserTestAutomationAgent extends WorkflowAgent {
     BrowserTestResultHandler.saveTitle(result, cwd);
     await BrowserTestResultHandler.saveExecutionData(result);
 
-    if (process.env.ZIBBY_MEMORY) {
-      try {
-        const { memoryEndRun, memorySyncPush } = await import('@zibby/memory');
-        const sessionId = result.state.sessionPath?.split('/').pop();
-        memoryEndRun(cwd, { sessionId, passed: result.success !== false });
-        memorySyncPush(cwd);
-      } catch { /* @zibby/memory not available */ }
-    }
+    // Memory end-run hook (if @zibby/memory is installed)
+    try {
+      const { memoryEndRun, memorySyncPush } = await import('@zibby/memory');
+      const sessionId = result.state.sessionPath?.split('/').pop();
+      memoryEndRun(cwd, { sessionId, passed: result.success !== false });
+      memorySyncPush(cwd);
+    } catch { /* @zibby/memory not available */ }
   }
 }