create-egregore 0.18.5 → 0.18.6

package/assets/egregore-launcher.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-// egregore-launcher-version: 0.5.19
+// egregore-launcher-version: 0.5.20
 //
 // egregore — launch and browse Egregore instances from your terminal.
 // Installed by create-egregore. Reads ~/.egregore/instances.json.
@@ -30,7 +30,7 @@ const https = require("node:https");
 const { spawnSync, spawn } = require("node:child_process");
 const readline = require("node:readline");
 
-const VERSION = "0.5.19";
+const VERSION = "0.5.20";
 const REGISTRY = path.join(os.homedir(), ".egregore", "instances.json");
 const DEFAULT_FILE = path.join(os.homedir(), ".egregore", "default");
 const PUBLIC_NPX_PACKAGE = "create-egregore";
@@ -200,6 +200,28 @@ function die(msg) {
   process.exit(1);
 }
 
+// process.cwd() throws (EPERM/ENOENT, "uv_cwd") when the shell's working
+// directory was moved, deleted, or recreated out from under it. Fall back to
+// home so spawned children never inherit a dead cwd.
+function safeCwd() {
+  try {
+    return process.cwd();
+  } catch {
+    return os.homedir();
+  }
+}
+
+// Turn a raw startup error into actionable guidance when it's a stale-cwd one.
+function friendlyError(err) {
+  const msg = (err && (err.message || String(err))) || "unknown error";
+  if (/uv_cwd|getcwd/i.test(msg)) {
+    return "your terminal's working directory is stale or inaccessible.\n" +
+      "  It was likely moved, deleted, or recreated out from under the shell.\n" +
+      "  Open a new terminal (or run: cd ~), then run: egregore";
+  }
+  return msg;
+}
+
 function readRegistry() {
   if (!fs.existsSync(REGISTRY)) return [];
   try {
@@ -274,7 +296,7 @@ function pathContains(parent, child) {
   return rel === "" || (!!rel && !rel.startsWith("..") && !path.isAbsolute(rel));
 }
 
-function initialCursorForCwd(registry, cwd = process.cwd()) {
+function initialCursorForCwd(registry, cwd = safeCwd()) {
   let best = -1;
   let bestLen = -1;
   for (let i = 0; i < registry.length; i++) {
@@ -624,6 +646,18 @@ function runtimeLaunchArgs(runtime, egregoreDir) {
 async function launch(inst, runtimeOverride) {
   if (!inst) die("no instance to launch");
   if (!fs.existsSync(inst.path)) die(`instance path does not exist: ${inst.path}`);
+  // existsSync can pass while the path is still untraversable (a parent lost
+  // execute permission, or the dir was recreated under the shell). realpathSync
+  // walks the full path and surfaces that before we spawn the harness into a
+  // dead directory and produce a cryptic getcwd/EPERM cascade.
+  try {
+    fs.realpathSync(inst.path);
+    fs.accessSync(inst.path, fs.constants.X_OK);
+  } catch {
+    die(`instance directory isn't accessible: ${inst.path}\n` +
+      "  Your terminal's working directory may be stale (the folder was moved or recreated).\n" +
+      "  Open a new terminal (or run: cd ~), then run: egregore");
+  }
   const runtime = await chooseRuntimeForLaunch(inst, runtimeOverride);
   if (!runtime) return;
   const binary = runtimeBinary(runtime);
@@ -661,7 +695,7 @@ function setupNewEgregore(runtimeOverride) {
   if (runtimeOverride) args.push("--runtime", runtimeOverride);
   const child = spawn("npx", args, {
     stdio: "inherit",
-    cwd: process.cwd(),
+    cwd: safeCwd(),
     env: { ...process.env },
   });
   child.on("exit", (code, signal) => {
@@ -1964,6 +1998,15 @@ async function numberedPicker(registry, runtimeOverride) {
 // ── main ────────────────────────────────────────────────────────────
 
 function main() {
+  // Self-heal a stale/inaccessible working directory before anything spawns —
+  // otherwise every child (harness, npx) inherits the dead cwd and fails with
+  // getcwd/EPERM. Home is always a safe place to stand.
+  try {
+    process.cwd();
+  } catch {
+    try { process.chdir(os.homedir()); } catch { /* nothing more we can do */ }
+  }
+
   const parsed = parseRuntimeFlags(process.argv.slice(2));
   const args = parsed.args;
   const runtimeOverride = parsed.runtimeOverride;
@@ -2022,8 +2065,8 @@ function main() {
 try {
   const r = main();
   if (r && typeof r.then === "function") {
-    r.catch((err) => die(err.message || String(err)));
+    r.catch((err) => die(friendlyError(err)));
   }
 } catch (err) {
-  die(err.message || String(err));
+  die(friendlyError(err));
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-egregore",
-  "version": "0.18.5",
+  "version": "0.18.6",
   "description": "Set up Egregore for your team in one command — installs the egregore launcher and your choice of Claude Code or Codex.",
   "license": "MIT",
   "bin": {