lucentracode 0.2.0 → 0.2.1

package/bin/lucentracode.js

@@ -166,6 +166,33 @@ if (typeof resolved !== "string") {
   process.exit(1)
 }
 
+// Make sure the binary is actually executable before trying to run it.
+//
+// It frequently is not. These packages are built and published from Windows, which has
+// no POSIX permission bits, so npm records mode 0644 in the tar header and every macOS
+// and Linux install extracts a binary it is not allowed to execute:
+//
+//     spawnSync .../bin/lucentracode EACCES
+//
+// Fixing it at pack time would mean the release only ever being publishable from a
+// POSIX machine -- a rule that holds until the day someone publishes from a laptop.
+// Fixing it here makes the tar mode irrelevant, which is the property worth having.
+function ensureExecutable(file) {
+  if (platform === "windows") return null
+  try {
+    const mode = fs.statSync(file).mode
+    if (mode & 0o111) return null
+    fs.chmodSync(file, (mode & 0o7777) | 0o755)
+    return null
+  } catch (err) {
+    // A read-only or root-owned install directory. Report it rather than failing with
+    // a bare EACCES, because the fix is one command and the user cannot guess it.
+    return err
+  }
+}
+
+const chmodError = ensureExecutable(resolved)
+
 // `stdio: "inherit"` hands the real terminal to the child, which the TUI requires: it
 // needs a genuine TTY for raw mode, resize events and colour. It also means the
 // terminal delivers Ctrl+C to the foreground process group, so the child sees the
@@ -173,7 +200,20 @@ if (typeof resolved !== "string") {
 const result = spawnSync(resolved, process.argv.slice(2), { stdio: "inherit", windowsHide: false })
 
 if (result.error) {
-  process.stderr.write(`${PRODUCT}: could not start ${resolved}\n${result.error.message}\n`)
+  const lines = [`${PRODUCT}: could not start the binary.`, `  ${resolved}`, ``, `${result.error.message}`]
+  if (result.error.code === "EACCES") {
+    lines.push(
+      ``,
+      `The binary is not marked executable.` +
+        (chmodError ? ` Making it executable failed: ${chmodError.message}` : ``),
+      ``,
+      `Fix it with:`,
+      `  chmod +x ${resolved}`,
+      ``,
+      `If that is denied, reinstall somewhere you own, or use sudo for the chmod.`,
+    )
+  }
+  process.stderr.write(lines.join("\n") + "\n")
   process.exit(1)
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lucentracode",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "AI coding agent for the terminal, powered by the LucentraCode gateway.",
   "license": "MIT",
   "repository": {