@phenx-inc/ctlsurf 0.17.0 → 0.17.2

package/bin/ctlsurf-worker.js

@@ -190,11 +190,14 @@ if (subcommand === 'doctor') {
     console.log(`    ${D}Run: ctlsurf setup${R}`)
   }
 
-  // Desktop
-  try {
-    require.resolve('electron')
+  // Desktop — check the binary actually resolves, not just that the package
+  // exists (a half-extracted electron still passes require.resolve)
+  if (electronResolves()) {
     console.log(`  ${G}✓${R} Electron ${D}(desktop mode available)${R}`)
-  } catch {
+  } else if (fs.existsSync(path.join(ROOT, 'node_modules', 'electron'))) {
+    console.log(`  ${Y}✗${R} Electron ${D}(installed but binary incomplete — desktop mode unavailable)${R}`)
+    console.log(`    ${D}Repair: cd ${ROOT} && node scripts/extract-electron.js${R}`)
+  } else {
     console.log(`  ${D}-${R} Electron ${D}(not installed — desktop mode unavailable)${R}`)
     console.log(`    ${D}Install: cd ${ROOT} && npm install${R}`)
   }
@@ -238,10 +241,34 @@ const mode = detectMode(args)
 checkApiKey(mode).catch(() => {}).then(() => launch(mode))
 
 function launch(launchMode) {
+  ensurePtyHelperExecutable()
   if (launchMode === 'desktop') runDesktop()
   else runTerminal()
 }
 
+// node-pty runs spawn-helper from whichever native dir it loaded (build/Release,
+// else prebuilds/<platform>-<arch>). The prebuilt copy ships without the execute
+// bit, so when our postinstall didn't compile build/Release (install scripts
+// blocked, or no Xcode CLT) every spawn fails with "posix_spawnp failed".
+function ensurePtyHelperExecutable() {
+  const ptyDir = path.join(ROOT, 'node_modules', 'node-pty')
+  const dirs = [path.join(ptyDir, 'build', 'Release')]
+  try {
+    for (const d of fs.readdirSync(path.join(ptyDir, 'prebuilds'))) {
+      if (d.startsWith(`${process.platform}-`)) dirs.push(path.join(ptyDir, 'prebuilds', d))
+    }
+  } catch { /* no prebuilds */ }
+
+  for (const dir of dirs) {
+    const helper = path.join(dir, 'spawn-helper')
+    try {
+      if ((fs.statSync(helper).mode & 0o111) === 0) fs.chmodSync(helper, 0o755)
+    } catch (err) {
+      if (err.code !== 'ENOENT') console.error(`${D}[ctlsurf] could not make ${helper} executable: ${err.message}${R}`)
+    }
+  }
+}
+
 function runDesktop() {
   let electronPath
   try {
@@ -297,13 +324,43 @@ function installElectron() {
       cwd: ROOT,
       stdio: ['ignore', 'ignore', 'inherit']
     })
-    console.log(`  ${G}✓${R} Electron installed.\n`)
-    return true
   } catch (err) {
     console.error(`\n${Y}!${R} Electron install failed: ${err.message}`)
     console.error(`  Try manually: cd ${ROOT} && npm install electron\n`)
     return false
   }
+
+  // electron's postinstall can exit 0 with a half-extracted binary (its
+  // extract-zip stalls on Node >= 26), and npm won't re-run it for a package
+  // that's already present — so unzip it ourselves with the system tool.
+  if (!electronResolves()) {
+    console.log(`  ${D}Electron binary incomplete — extracting with system unzip...${R}`)
+    try {
+      execFileSync(process.execPath, [path.join(ROOT, 'scripts', 'extract-electron.js')], {
+        stdio: ['ignore', 'ignore', 'inherit']
+      })
+    } catch (err) {
+      console.error(`\n${Y}!${R} Electron extract failed: ${err.message}`)
+      console.error(`  Try manually: cd ${ROOT} && node scripts/extract-electron.js\n`)
+      return false
+    }
+    if (!electronResolves()) {
+      console.error(`\n${Y}!${R} Electron binary still missing after extract.\n`)
+      return false
+    }
+  }
+
+  console.log(`  ${G}✓${R} Electron installed.\n`)
+  return true
+}
+
+function electronResolves() {
+  try {
+    delete require.cache[require.resolve('electron')]
+    return fs.existsSync(require('electron'))
+  } catch {
+    return false
+  }
 }
 
 function runTerminal() {

package/out/headless/index.mjs

@@ -17314,7 +17314,7 @@ var require_package = __commonJS({
   "package.json"(exports, module) {
     module.exports = {
       name: "@phenx-inc/ctlsurf",
-      version: "0.17.0",
+      version: "0.17.2",
       description: "Agent-agnostic terminal and desktop app for ctlsurf \u2014 run Claude Code, Codex, or any coding agent with live session logging and remote control",
       main: "out/main/index.js",
       bin: {