create-egregore 0.18.4 → 0.18.6

package/assets/egregore-launcher.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-// egregore-launcher-version: 0.5.18
+// 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.18";
+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";
@@ -99,9 +99,57 @@ const ANSI = {
   clear:          "\x1b[2J",
   home:           "\x1b[H",
   clearLine:      "\x1b[K",
+  // Disable every terminal mouse-reporting mode. Some terminals (tmux,
+  // iTerm2) or a TUI run earlier in the session leave mouse reporting ON,
+  // which turns the scroll wheel into escape sequences that corrupt our
+  // pickers. Emitting this on picker entry makes the wheel do native
+  // scrollback instead. Modes: 1000 (click), 1002 (drag), 1003 (any-motion),
+  // 1006 (SGR encoding), 1015 (urxvt encoding).
+  mouseOff: "\x1b[?1000l\x1b[?1002l\x1b[?1003l\x1b[?1006l\x1b[?1015l",
   moveTo: (row, col) => `\x1b[${row};${col}H`,
 };
 
+// Scroll-wheel / mouse-event filter (defense-in-depth for ANSI.mouseOff).
+// With mouse reporting on, the scroll wheel and shift+arrow arrive as escape
+// sequences. Node's readline decomposes them into stray keypresses:
+//   • SGR mouse  "\x1b[<b;x;yM"  → an event with key.code "[<", then each
+//     coordinate DIGIT as its own keypress (a "1"/"2" hits the picker's
+//     number quick-select and LAUNCHES a runtime), then a final "M".
+//   • X11 mouse  "\x1b[M" + 3 raw bytes → key.code "[M" then 3 stray chars.
+//   • shift+arrow "\x1b[1;2A" / "\x1b[1;2B" → key.name "up"/"down" with
+//     key.shift set, which would advance the selection.
+// This factory returns a stateful predicate: pass it every (chunk, key) at the
+// top of a keypress handler and early-return when it reports true, so no
+// mouse-derived byte is ever treated as navigation.
+function makeMouseFilter() {
+  let sgr = false; // inside an SGR mouse report (ESC [ < ... M|m)
+  let x11 = 0;     // raw bytes left to swallow after ESC [ M
+  return function isMouseEvent(chunk, key) {
+    const seq = (key && key.sequence) || (typeof chunk === "string" ? chunk : "") || "";
+    if (sgr) {
+      if (/[Mm]/.test(seq)) sgr = false; // SGR terminates on M (press) / m (release)
+      return true;
+    }
+    if (x11 > 0) {
+      x11 -= seq.length || 1;
+      return true;
+    }
+    if ((key && key.code === "[<") || seq.startsWith("\x1b[<")) {
+      sgr = !/[Mm]$/.test(seq); // single-chunk variant already includes terminator
+      return true;
+    }
+    if ((key && key.code === "[M") || seq.startsWith("\x1b[M")) {
+      const extra = Math.max(0, seq.length - 3); // bytes past "ESC [ M" in this chunk
+      x11 = Math.max(0, 3 - extra);
+      return true;
+    }
+    if (key && key.shift && (key.name === "up" || key.name === "down")) {
+      return true; // shift+arrow scroll fallback
+    }
+    return false;
+  };
+}
+
 const stripAnsi = (s) => s.replace(/\x1b\[[0-9;]*m/g, "");
 const visLen = (s) => stripAnsi(s).length;
 const pad = (s, n) => s + " ".repeat(Math.max(0, n - visLen(s)));
@@ -152,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 {
@@ -226,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++) {
@@ -363,6 +433,7 @@ function pickRuntimeInteractive(inst, runtimes, stored) {
     let done = false;
     const title = inst.slug || inst.name || path.basename(inst.path);
     const previousRaw = !!process.stdin.isRaw;
+    const isMouseEvent = makeMouseFilter();
 
     const erase = () => {
       if (!rendered) return;
@@ -378,6 +449,7 @@ function pickRuntimeInteractive(inst, runtimes, stored) {
       if (done) return;
       done = true;
       process.stdin.removeListener("keypress", onKey);
+      process.stdout.write(ANSI.mouseOff);
       if (process.stdin.setRawMode) process.stdin.setRawMode(previousRaw);
       if (!previousRaw) process.stdin.pause();
       erase();
@@ -399,6 +471,7 @@ function pickRuntimeInteractive(inst, runtimes, stored) {
     };
 
     function onKey(chunk, key = {}) {
+      if (isMouseEvent(chunk, key)) return; // drop scroll-wheel / mouse escape sequences
       if (key.ctrl && key.name === "c") {
         cleanup();
         process.exit(130);
@@ -424,6 +497,7 @@ function pickRuntimeInteractive(inst, runtimes, stored) {
     readline.emitKeypressEvents(process.stdin);
     if (process.stdin.setRawMode) process.stdin.setRawMode(true);
     process.stdin.resume();
+    process.stdout.write(ANSI.mouseOff);
     process.stdin.on("keypress", onKey);
     render();
   });
@@ -572,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);
@@ -609,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) => {
@@ -1586,7 +1672,8 @@ async function browser(args = {}) {
   };
 
   // ── setup / teardown ───────────────────
-  process.stdout.write(ANSI.altScreenEnter + ANSI.cursorHide + ANSI.clear + ANSI.home);
+  process.stdout.write(ANSI.altScreenEnter + ANSI.mouseOff + ANSI.cursorHide + ANSI.clear + ANSI.home);
+  const isMouseEvent = makeMouseFilter();
   let done = false;
   const cleanup = () => {
     if (done) return;
@@ -1594,7 +1681,7 @@ async function browser(args = {}) {
     process.stdin.setRawMode(false);
     process.stdin.pause();
     process.stdin.removeAllListeners("keypress");
-    process.stdout.write(ANSI.cursorShow + ANSI.altScreenLeave);
+    process.stdout.write(ANSI.mouseOff + ANSI.cursorShow + ANSI.altScreenLeave);
   };
   process.on("exit", cleanup);
   process.on("SIGINT", () => { cleanup(); process.exit(130); });
@@ -1618,6 +1705,7 @@ async function browser(args = {}) {
   return new Promise((resolve) => {
     process.stdin.on("keypress", (chunk, key) => {
       if (!key) return;
+      if (isMouseEvent(chunk, key)) return; // drop scroll-wheel / mouse escape sequences
 
       if (state.runtimeInst) {
         const runtimes = runtimeChoicesFor(state.runtimeInst, args.runtimeOverride);
@@ -1910,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;
@@ -1968,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.4",
+  "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": {
@@ -11,7 +11,7 @@
   },
   "scripts": {
     "build:runtime": "node scripts/build-runtime-bundle.mjs",
-    "test": "node scripts/build-runtime-bundle.mjs --check && node --test test/context.test.js test/parse-join-target.test.js test/skip-repos.test.js test/onboarding-shortcircuit.test.js test/welcome-screen.test.js test/runtime-selection.test.js test/command-generation.test.js test/auth-gh.test.js test/gauntlet-fixes.test.js test/codex-runtime.test.js test/installer-runtime-source.test.js",
+    "test": "node scripts/build-runtime-bundle.mjs --check && node --test test/context.test.js test/parse-join-target.test.js test/skip-repos.test.js test/onboarding-shortcircuit.test.js test/welcome-screen.test.js test/runtime-selection.test.js test/command-generation.test.js test/auth-gh.test.js test/gauntlet-fixes.test.js test/codex-runtime.test.js test/installer-runtime-source.test.js test/scroll-repro.test.js",
     "test:e2e": "node --test test/e2e-local.test.js",
     "test:all": "node scripts/build-runtime-bundle.mjs --check && node --test test/"
   },

package/runtime/codex/bin/lib/dashboard-artifact.sh

@@ -134,7 +134,7 @@ DASHBOARD_URL=$(echo "$_DB_PUBLISH_OUT" | grep -o 'https://[^ ]*' | tail -1)
 if [ -z "$DASHBOARD_URL" ]; then
   _DB_HTML="/tmp/egregore-artifacts/dashboard-${EGREGORE_SESSION_ID}.html"
   mkdir -p /tmp/egregore-artifacts
-  if npx egregore-artifacts document "$_DB_MD" --output "$_DB_HTML" --no-open >/dev/null 2>&1 && [ -f "$_DB_HTML" ]; then
+  if npx egregore-artifacts@latest document "$_DB_MD" --output "$_DB_HTML" --no-open >/dev/null 2>&1 && [ -f "$_DB_HTML" ]; then
     DASHBOARD_URL="file://${_DB_HTML}"
   fi
 fi

package/runtime/codex/bin/publish-artifact.sh

@@ -109,7 +109,7 @@ else
       exit 0
     fi
   else
-    if ! npx egregore-artifacts "${RENDER_ARGS[@]}" >/dev/null 2>&1; then
+    if ! npx egregore-artifacts@latest "${RENDER_ARGS[@]}" >/dev/null 2>&1; then
       exit 0
     fi
   fi