create-egregore 0.19.12 → 0.19.13

package/assets/egregore-launcher.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-// egregore-launcher-version: 0.8.0
+// egregore-launcher-version: 0.19.13
 //
 // egregore — launch and browse Egregore instances from your terminal.
 // Installed by create-egregore. Reads ~/.egregore/instances.json.
@@ -33,10 +33,17 @@ const crypto = require("node:crypto");
 const { spawnSync, spawn } = require("node:child_process");
 const readline = require("node:readline");
 
-const VERSION = "0.8.0";
+const VERSION = "0.19.13";
 const REGISTRY = path.join(os.homedir(), ".egregore", "instances.json");
 const DEFAULT_FILE = path.join(os.homedir(), ".egregore", "default");
+const UPDATE_CACHE_FILE = path.join(os.homedir(), ".egregore", "update-check.json");
 const PUBLIC_NPX_PACKAGE = "create-egregore";
+const UPDATE_REGISTRY_URL =
+  process.env.EGREGORE_UPDATE_REGISTRY_URL ||
+  `https://registry.npmjs.org/${PUBLIC_NPX_PACKAGE}/latest`;
+const UPDATE_CACHE_TTL_MS = 6 * 60 * 60 * 1000;
+const UPDATE_FAILURE_TTL_MS = 30 * 60 * 1000;
+const UPDATE_CHECK_TIMEOUT_MS = 1500;
 const CONNECT_API_URL = (
   process.env.EGREGORE_CONNECT_API_URL ||
   "https://egregore-production-55f2.up.railway.app"
@@ -976,11 +983,145 @@ function requestJson(options, body) {
       });
     });
     req.on("error", (err) => resolve({ status: 0, data: { message: err.message } }));
+    if (options.unref) {
+      req.on("socket", (socket) => socket.unref());
+    }
+    if (options.timeoutMs) {
+      req.setTimeout(options.timeoutMs, () => req.destroy(new Error("request timed out")));
+    }
     if (payload) req.write(payload);
     req.end();
   });
 }
 
+function parseReleaseVersion(value) {
+  const match = String(value || "").trim().match(/^v?(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?$/);
+  if (!match) return null;
+  return {
+    parts: match.slice(1, 4).map(Number),
+    prerelease: match[4] || "",
+  };
+}
+
+function compareReleaseVersions(a, b) {
+  const left = parseReleaseVersion(a);
+  const right = parseReleaseVersion(b);
+  if (!left || !right) return 0;
+  for (let i = 0; i < 3; i++) {
+    if (left.parts[i] !== right.parts[i]) return left.parts[i] > right.parts[i] ? 1 : -1;
+  }
+  if (left.prerelease === right.prerelease) return 0;
+  if (!left.prerelease) return 1;
+  if (!right.prerelease) return -1;
+  return left.prerelease.localeCompare(right.prerelease);
+}
+
+function cliUpdateState(latest) {
+  if (!parseReleaseVersion(latest)) return null;
+  return {
+    current: VERSION,
+    latest,
+    available: compareReleaseVersions(latest, VERSION) > 0,
+  };
+}
+
+function readUpdateCache() {
+  try {
+    const cache = JSON.parse(fs.readFileSync(UPDATE_CACHE_FILE, "utf-8"));
+    if (!cache || !cache.checked_at) return null;
+    const age = Date.now() - new Date(cache.checked_at).getTime();
+    const ttl = cache.latest ? UPDATE_CACHE_TTL_MS : UPDATE_FAILURE_TTL_MS;
+    if (!Number.isFinite(age) || age < 0 || age > ttl) return null;
+    if (!cache.latest) return { current: VERSION, latest: null, available: false };
+    return cliUpdateState(cache.latest);
+  } catch {
+    return null;
+  }
+}
+
+function writeUpdateCache(latest) {
+  try {
+    fs.mkdirSync(path.dirname(UPDATE_CACHE_FILE), { recursive: true });
+    atomicWrite(
+      UPDATE_CACHE_FILE,
+      JSON.stringify({ checked_at: new Date().toISOString(), latest: latest || null }, null, 2) + "\n",
+      0o600,
+    );
+  } catch {}
+}
+
+async function checkForCliUpdate() {
+  if (process.env.EGREGORE_DISABLE_UPDATE_CHECK === "1") return null;
+  if (process.env.EGREGORE_UPDATE_LATEST_VERSION) {
+    return cliUpdateState(process.env.EGREGORE_UPDATE_LATEST_VERSION);
+  }
+
+  const cached = readUpdateCache();
+  if (cached) return cached;
+
+  try {
+    const url = new URL(UPDATE_REGISTRY_URL);
+    const result = await requestJson({
+      hostname: url.hostname,
+      port: url.port || undefined,
+      path: `${url.pathname}${url.search}`,
+      method: "GET",
+      protocol: url.protocol,
+      timeoutMs: UPDATE_CHECK_TIMEOUT_MS,
+      unref: true,
+      headers: { Accept: "application/json" },
+    });
+    const latest = result.status === 200 && result.data && result.data.version;
+    const update = cliUpdateState(latest);
+    writeUpdateCache(update?.latest || null);
+    return update;
+  } catch {
+    return null;
+  }
+}
+
+function cmdCliUpdate(latest) {
+  if (!parseReleaseVersion(latest)) {
+    console.error(`\n  ${YELLOW}!${RESET} Could not verify the CLI release version.\n`);
+    process.exitCode = 1;
+    return;
+  }
+
+  console.log("");
+  console.log(`  ${BOLD}${CYAN}↑ CLI UPDATE${RESET}`);
+  console.log(`  ${DIM}${VERSION} → ${latest}${RESET}`);
+  console.log("");
+  process.stdout.write(`  [1/2] Installing ${PUBLIC_NPX_PACKAGE}@${latest}…`);
+  const result = spawnSync(
+    "npx",
+    ["-y", `${PUBLIC_NPX_PACKAGE}@${latest}`, "--refresh-launcher"],
+    { encoding: "utf-8", stdio: ["inherit", "pipe", "pipe"], env: { ...process.env } },
+  );
+  if (result.status !== 0) {
+    console.log(`\r  [1/2] ${YELLOW}!${RESET} Install failed`);
+    const detail = String(result.stderr || result.stdout || "").trim().split("\n").filter(Boolean).pop();
+    if (detail) console.error(`        ${DIM}${detail}${RESET}`);
+    console.error(`        Retry: npx -y ${PUBLIC_NPX_PACKAGE}@${latest} --refresh-launcher\n`);
+    process.exitCode = 1;
+    return;
+  }
+  console.log(`\r  [1/2] ${GREEN}✓${RESET} CLI ${latest} installed`);
+
+  if (process.env.EGREGORE_UPDATE_NO_RELAUNCH === "1") {
+    console.log(`  [2/2] ${GREEN}✓${RESET} Ready for the next launch\n`);
+    return;
+  }
+
+  console.log(`  [2/2] ${GREEN}✓${RESET} Reopening Egregore\n`);
+  const relaunched = spawnSync(process.execPath, [process.argv[1], "browse"], {
+    stdio: "inherit",
+    env: { ...process.env },
+  });
+  if (relaunched.error) {
+    console.error(`  ${YELLOW}!${RESET} Updated successfully. Run ${BOLD}egregore${RESET} to reopen.\n`);
+  }
+}
+
 function githubRequest(token, method, apiPath, body) {
   return requestJson({
     hostname: "api.github.com",
@@ -1689,7 +1830,7 @@ function selectedWorkflowLine(pv, width) {
   return joinShort(available.map(skillToken), Math.max(12, width));
 }
 
-function renderHeroPanel({ selected, pv, width, height, countSuffix, filter, filterMode }) {
+function renderHeroPanel({ selected, pv, width, height, countSuffix, filter, filterMode, cliUpdate }) {
   const outerWidth = Math.min(Math.max(50, width - 2), 126);
   const innerWidth = Math.max(48, outerWidth - 2);
   const bodyWidth = Math.max(8, innerWidth - 2);
@@ -1741,7 +1882,17 @@ function renderHeroPanel({ selected, pv, width, height, countSuffix, filter, fil
   lines.push(mid);
   lines.push(boxLine(`${BOLD}${title}${RESET} ${DIM}· ${org} · ${runtime} · ${countSuffix} · ${filterText}${RESET}`, innerWidth, margin));
   lines.push(boxLine(`${DIM}skills${RESET} ${skillStatus}`, innerWidth, margin));
-  lines.push(emptyBoxLine(innerWidth, margin));
+  if (cliUpdate?.available) {
+    lines.push(boxLine(
+      `${YELLOW}→ CLI update ${cliUpdate.latest} available${RESET} ${DIM}· installed ${cliUpdate.current} · ${RESET}${BOLD}U${RESET}${DIM} install${RESET}`,
+      innerWidth,
+      margin,
+    ));
+  } else {
+    // Reserve the status row so the list never jumps when the async version
+    // check resolves and reveals an available release.
+    lines.push(emptyBoxLine(innerWidth, margin));
+  }
 
   const sigilWidth = Math.max(...EGREGORE_SIGIL.map((line) => line.length));
   const twoColumn = bodyWidth >= 68;
@@ -1938,6 +2089,7 @@ async function browser(args = {}) {
     message: null, // ephemeral info line (e.g. "default set to X")
     messageKind: "info", // "info" | "success" | "warn"
     messageUntil: 0,
+    cliUpdate: null,
   };
 
   const newAction = {
@@ -2041,6 +2193,7 @@ async function browser(args = {}) {
       countSuffix,
       filter: state.filter,
       filterMode: state.filterMode,
+      cliUpdate: state.cliUpdate,
     });
     for (const line of heroLines) out.push(line + ANSI.clearLine + "\n");
     out.push(ANSI.clearLine + "\n");
@@ -2571,6 +2724,12 @@ async function browser(args = {}) {
         resolve(cmdConnect([pick.slug]));
         return;
       }
+      if (chunk === "U" && state.cliUpdate?.available) {
+        const latest = state.cliUpdate.latest;
+        cleanup();
+        resolve(cmdCliUpdate(latest));
+        return;
+      }
       if (chunk === "i") {
         const pick = visible()[state.cursor]?.e;
         if (!pick) return;
@@ -2657,6 +2816,11 @@ async function browser(args = {}) {
     });
 
     render();
+    checkForCliUpdate().then((update) => {
+      if (done || !update) return;
+      state.cliUpdate = update;
+      if (update.available) render();
+    });
   });
 }
 

package/bin/cli.js

@@ -223,6 +223,8 @@ function parseArgs(argv) {
       // already served as the entry screen — a second alt-screen welcome
       // would otherwise demand a redundant Enter and churn the alt buffer.
       args.noWelcome = true;
+    } else if (argv[i] === "--refresh-launcher") {
+      args.refreshLauncher = true;
     } else if (argv[i] === "--codex") {
       args.runtime = "codex";
     } else if (argv[i] === "--pi") {
@@ -395,6 +397,7 @@ function showHelp() {
   ui.info("  --force           Skip the in-repo detection check");
   ui.info("  --no-autolaunch   Don't launch the harness at the end (for CI)");
   ui.info("  --no-screens      Skip the full-screen welcome/ready bookends");
+  ui.info("  --refresh-launcher Refresh only the Egregore CLI, then exit");
   ui.info("  -h, --help        Show this help");
   ui.info("");
 }
@@ -443,6 +446,21 @@ async function main() {
     }
   }
 
+  if (args.refreshLauncher) {
+    const instances = readLocalInstances();
+    if (instances.length === 0) {
+      ui.error("No installed Egregore instance was found. Run create-egregore without --refresh-launcher.");
+      process.exit(1);
+    }
+    const alias = await installLauncherBinary(instances[0].path, ui);
+    if (!alias || !alias.binaryPath) {
+      ui.error("Could not refresh the Egregore CLI.");
+      process.exit(1);
+    }
+    ui.success(`Egregore CLI is current at ${alias.binaryPath}`);
+    return;
+  }
+
   // Local-first product surface: if the user already has egregores installed
   // and didn't pass an explicit mode flag, refresh the launcher and open the
   // same TUI as bare `egregore`. With no installed instances, make bare

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-egregore",
-  "version": "0.19.12",
+  "version": "0.19.13",
   "description": "Set up Egregore for your team in one command — installs the egregore launcher and your choice of Claude Code, Codex, or Pi.",
   "license": "MIT",
   "bin": {
@@ -12,7 +12,7 @@
   "scripts": {
     "build:runtime": "node scripts/build-runtime-bundle.mjs && node scripts/build-pi-runtime-bundle.mjs",
     "build:pi-runtime": "node scripts/build-pi-runtime-bundle.mjs",
-    "test": "node scripts/build-runtime-bundle.mjs --check && node scripts/build-pi-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/pi-runtime.test.js test/pi-product-workflows.test.js test/installer-runtime-source.test.js test/scroll-repro.test.js test/launcher-refocus-redraw.test.js test/multiselect-remote-search.test.js test/back-navigation.test.js test/manifest-form.test.js test/launcher-delete.test.js test/launcher-connect.test.js",
+    "test": "node scripts/build-runtime-bundle.mjs --check && node scripts/build-pi-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/pi-runtime.test.js test/pi-product-workflows.test.js test/installer-runtime-source.test.js test/scroll-repro.test.js test/launcher-refocus-redraw.test.js test/multiselect-remote-search.test.js test/back-navigation.test.js test/manifest-form.test.js test/launcher-delete.test.js test/launcher-connect.test.js test/launcher-update.test.js",
     "test:e2e": "node --test test/e2e-local.test.js",
     "test:all": "node scripts/build-runtime-bundle.mjs --check && node scripts/build-pi-runtime-bundle.mjs --check && node --test test/"
   },