@phenx-inc/ctlsurf 0.17.0 → 0.17.1

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}`)
   }
@@ -297,13 +300,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.1",
       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: {