openzoo 0.49.11 → 0.49.12

package/lib/launch.js

@@ -280,18 +280,22 @@ export async function launchClaude(argv) {
 
   if (terminal) {
     const rejected = [];
-    const cli = resolveClaudeCli(process.env, rejected);
+    let cli = resolveClaudeCli(process.env, rejected);
+    if (!cli && rejected.length) {
+      // THE FORMAT CHECK IS A TIE-BREAKER, NOT A VETO.
+      //
+      // isRunnableExecutable() knows four magics. Something legitimate that it
+      // has never seen — a packaging format we did not anticipate — would be
+      // refused here even though the OS would have run it happily, and we would
+      // have told the user to reinstall a CLI that was fine. When there is a
+      // real alternative the check earns its keep by preferring the good file;
+      // when this is the ONLY candidate, defer to the kernel and let the spawn
+      // below decide. A wrong heuristic must never be the sole reason we refuse.
+      cli = rejected[0];
+      console.error(`openzoo: ${cli} does not look like a runnable executable — trying it anyway.`);
+    }
     if (!cli) {
-      if (rejected.length) {
-        // Found it, could not run it. Say so — "not found on PATH" is a lie
-        // here and sends the user off to reinstall something they already have.
-        console.error('openzoo: found `claude` but it is not a runnable executable:');
-        for (const f of rejected) console.error(`         ${f}`);
-        console.error('         (no shebang and no binary magic — usually a truncated or half-finished install)');
-        console.error('         fix: reinstall Claude Code, or delete the broken file so another copy on PATH is used.');
-      } else {
-        console.error('openzoo: `claude` CLI not found on PATH — install Claude Code, or drop --terminal for the desktop app');
-      }
+      console.error('openzoo: `claude` CLI not found on PATH — install Claude Code, or drop --terminal for the desktop app');
       process.exit(1);
     }
     // ALWAYS-ON HUD via Claude Code's NATIVE status line (the title bar is owned
@@ -422,9 +426,11 @@ export async function launchClaude(argv) {
       try { restoreStatus?.(); } catch { /* ignore */ }
       console.error(`openzoo: cannot execute ${cli} (${e?.code || e?.message})`);
       console.error('         it is marked executable but the OS refused to run it.');
-      console.error(`         check: head -1 ${cli}   and   file ${cli}`);
+      console.error(`         check:  file ${cli}`);
+      console.error(`                 head -c 2 ${cli} | xxd     # a healthy script starts 2321 ("#!")`);
       console.error('         usually a truncated install, a wrong-architecture binary,');
       console.error('         or a shebang pointing at an interpreter that no longer exists.');
+      console.error('         fix:    npm i -g @anthropic-ai/claude-code');
       process.exit(1);
     }
     child.on('exit', (c) => { try { restoreStatus?.(); } catch { /* ignore */ } process.exit(c ?? 0); });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openzoo",
-  "version": "0.49.11",
+  "version": "0.49.12",
   "description": "Local x402-paying proxy + MCP server for openzoo.fun — point any OpenAI-compatible harness (Cursor, Claude Code, aider, SDKs) at localhost and it pays per call from a local burner wallet. Solana and Base rails live; Robinhood experimental.",
   "license": "MIT",
   "type": "module",