create-egregore 0.20.2 → 0.20.3

package/assets/egregore-launcher.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-// egregore-launcher-version: 0.20.2
+// egregore-launcher-version: 0.20.3
 //
 // egregore — launch and browse Egregore instances from your terminal.
 // Installed by create-egregore. Reads ~/.egregore/instances.json.
@@ -33,7 +33,7 @@ const crypto = require("node:crypto");
 const { spawnSync, spawn } = require("node:child_process");
 const readline = require("node:readline");
 
-const VERSION = "0.20.2";
+const VERSION = "0.20.3";
 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");
@@ -702,9 +702,8 @@ function codexSupportMessage(egregoreDir) {
     "  .codex/hooks.json",
     "  .codex/hooks/",
     "",
-    "Automatic repair did not complete. Retry with:",
-    "  npx -y create-egregore@latest --refresh-launcher",
-    "Then rerun egregore.",
+    "Restore this instance using its installed runtime version, then rerun egregore.",
+    "A global CLI refresh does not repair instance files.",
     "Egregore workflows appear as slash commands. In Codex, invoke them with the matching $skill token or ask in natural language.",
   ].join("\n");
 }
@@ -735,7 +734,7 @@ function piSupportMessage(egregoreDir) {
     "Pi meta-harness support is missing from this Egregore checkout.",
     `  path: ${egregoreDir}`,
     "",
-    "Run npx -y create-egregore@latest to install the packaged Pi runtime, then rerun egregore.",
+    "Restore this instance using its installed runtime version, then rerun egregore.",
   ].join("\n");
 }
 
@@ -754,31 +753,10 @@ function primeSupportMessage(egregoreDir) {
     "Prime Agent runtime support is missing from this Egregore checkout.",
     `  path: ${egregoreDir}`,
     "",
-    "Run npx -y create-egregore@latest to install the packaged Prime Agent runtime, then rerun egregore.",
+    "Restore this instance using its installed runtime version, then rerun egregore.",
   ].join("\n");
 }
 
-function repairPortableRuntime(egregoreDir, runtime) {
-  const label = runtimeLabel(runtime);
-  process.stdout.write(`\n  ${CYAN}↻${RESET} ${BOLD}Repairing ${label} support${RESET}${DIM} — updating this checkout${RESET}\n`);
-  const result = spawnSync(
-    "npx",
-    ["-y", `${PUBLIC_NPX_PACKAGE}@latest`, "--refresh-launcher"],
-    {
-      cwd: egregoreDir,
-      stdio: "inherit",
-      env: { ...process.env, EGREGORE_RUNTIME_REPAIR: runtime },
-      timeout: 3 * 60 * 1000,
-    },
-  );
-  if (result.error || result.status !== 0) {
-    process.stderr.write(`  ${YELLOW}!${RESET} Automatic ${label} repair failed; the checkout was left in place.\n`);
-    return false;
-  }
-  process.stdout.write(`  ${GREEN}✓${RESET} ${label} support repaired\n\n`);
-  return true;
-}
-
 // Minimal y/N line prompt for pre-launch decisions (the TUI select machinery
 // is torn down by the time launch() runs).
 function confirmLine(question) {
@@ -908,19 +886,15 @@ async function launch(inst, runtimeOverride) {
     }
   }
   if (runtime === "codex") {
-    if (!hasCodexCoreSupport(inst.path)) {
-      if (!repairPortableRuntime(inst.path, runtime) || !hasCodexCoreSupport(inst.path)) {
-        die(codexSupportMessage(inst.path));
-      }
-    }
+    // Launching never changes an instance's runtime or release channel.
+    if (!hasCodexCoreSupport(inst.path)) die(codexSupportMessage(inst.path));
     const skillsInstalled = installCodexSkills(inst.path);
     const cardRendered = await renderCodexStartupCard(inst.path);
     if (!skillsInstalled || !cardRendered) {
       die(codexSupportMessage(inst.path));
     }
   } else if (runtime === "pi") {
-    if (!hasPiCoreSupport(inst.path) &&
-        (!repairPortableRuntime(inst.path, runtime) || !hasPiCoreSupport(inst.path))) {
+    if (!hasPiCoreSupport(inst.path)) {
       die(piSupportMessage(inst.path));
     }
   }
@@ -931,10 +905,7 @@ async function launch(inst, runtimeOverride) {
     // check + the trust-flag probe, which shells out to the binary), then a
     // single handoff line explains the remaining in-harness startup.
     const stopLoader = startSpinner("Starting Prime Agent");
-    let coreOk = hasPrimeCoreSupport(inst.path);
-    if (!coreOk && repairPortableRuntime(inst.path, runtime)) {
-      coreOk = hasPrimeCoreSupport(inst.path);
-    }
+    const coreOk = hasPrimeCoreSupport(inst.path);
     launchArgs = coreOk ? runtimeLaunchArgs(runtime, inst.path) : null;
     stopLoader();
     if (!coreOk) die(primeSupportMessage(inst.path));
@@ -1797,9 +1768,10 @@ async function cmdConnect(args) {
       console.log(`        ${DIM}${line}${RESET}`);
     }
   }
+  // Connect is an instance-scoped overlay; never refresh other runtimes here.
   const runtimeRefresh = spawnSync(
     "npx",
-    ["-y", `${PUBLIC_NPX_PACKAGE}@latest`, "--refresh-launcher"],
+    ["-y", `${PUBLIC_NPX_PACKAGE}@${VERSION}`, "--refresh-connect"],
     {
       cwd: inst.path,
       encoding: "utf-8",
@@ -1811,7 +1783,7 @@ async function cmdConnect(args) {
     console.log(`        ${GREEN}✓${RESET} Connect features installed`);
   } else {
     console.log(`        ${YELLOW}!${RESET} Connect features will retry on the next update`);
-    console.log(`          ${DIM}npx -y ${PUBLIC_NPX_PACKAGE}@latest --refresh-launcher${RESET}`);
+    console.log(`          ${DIM}npx -y ${PUBLIC_NPX_PACKAGE}@${VERSION} --refresh-connect${RESET}`);
   }
   console.log("");
   console.log(`  ${GREEN}✓${RESET} ${BOLD}${inst.slug}${RESET} is connected. Local files remain the source of truth.`);

package/bin/cli.js

@@ -25,27 +25,8 @@ const {
   ghCliExists,
   tryGhAuthOrLogin,
 } = require("../lib/auth");
-const {
-  hasCodexRuntimeSupport,
-  installCodexRuntime,
-  reportCodexRuntimeSummary,
-} = require("../lib/codex-runtime");
-const {
-  hasPiRuntimeSupport,
-  installPiRuntime,
-  reportPiRuntimeSummary,
-} = require("../lib/pi-runtime");
-const {
-  hasPrimeRuntimeSupport,
-  installPrimeRuntime,
-  reportPrimeRuntimeSummary,
-} = require("../lib/prime-runtime");
-const {
-  connectEligibility,
-  fetchConnectRuntimePack,
-  installConnectRuntime,
-  reportConnectRuntimeSummary,
-} = require("../lib/connect-runtime");
+// Global CLI maintenance never installs or reconciles instance runtimes.
+// Fresh installation and explicit instance updates own those writes.
 const {
   install,
   ghApi,
@@ -120,45 +101,6 @@ function assistantLabel(runtime) {
   return "Claude Code";
 }
 
-async function upgradePortableRuntimesForExisting(instances) {
-  for (const inst of instances) {
-    if (!inst || !inst.path || !fs.existsSync(inst.path)) continue;
-    try {
-      // Fetch and validate the private overlay before pruning the old public
-      // bundle. During the one-time ownership migration, an API outage must
-      // leave an existing Connect installation untouched.
-      const eligibility = connectEligibility(inst.path);
-      const connectPack = eligibility.eligible
-        ? await fetchConnectRuntimePack(inst.path)
-        : null;
-      const summary = installCodexRuntime(inst.path);
-      const ready = hasCodexRuntimeSupport(inst.path);
-      reportCodexRuntimeSummary(summary, ui, {
-        label: `Codex runtime for ${inst.slug || inst.name || path.basename(inst.path)}`,
-        includeConflicts: !ready,
-      });
-      const piSummary = installPiRuntime(inst.path);
-      const piReady = hasPiRuntimeSupport(inst.path);
-      reportPiRuntimeSummary(piSummary, ui, {
-        label: `Pi meta-harness for ${inst.slug || inst.name || path.basename(inst.path)}`,
-        includeConflicts: !piReady,
-      });
-      const primeSummary = installPrimeRuntime(inst.path);
-      const primeReady = hasPrimeRuntimeSupport(inst.path);
-      reportPrimeRuntimeSummary(primeSummary, ui, {
-        label: `Prime Agent runtime for ${inst.slug || inst.name || path.basename(inst.path)}`,
-        includeConflicts: !primeReady,
-      });
-      const connectSummary = await installConnectRuntime(inst.path, { validatedPack: connectPack });
-      reportConnectRuntimeSummary(connectSummary, ui, {
-        label: `Connect features for ${inst.slug || inst.name || path.basename(inst.path)}`,
-      });
-    } catch (err) {
-      ui.warn(`Could not refresh shell-runtime support for ${inst.path}: ${err.message}`);
-    }
-  }
-}
-
 async function chooseRuntime(args) {
   if (args.runtime) {
     try {
@@ -199,7 +141,6 @@ async function chooseRuntime(args) {
 }
 
 async function upgradeLauncherFromExisting(instances) {
-  await upgradePortableRuntimesForExisting(instances);
   const inst = instances.find((entry) => entry && entry.path && fs.existsSync(entry.path));
   if (!inst) return null;
   try {
@@ -433,7 +374,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 the Egregore CLI and runtime packs, then exit");
+  ui.info("  --refresh-launcher Refresh only the global Egregore CLI, then exit");
   ui.info("  -h, --help        Show this help");
   ui.info("");
 }
@@ -513,7 +454,6 @@ async function main() {
       ui.error("No installed Egregore instance was found. Run create-egregore without --refresh-launcher.");
       process.exit(1);
     }
-    await upgradePortableRuntimesForExisting(instances);
     const alias = await installLauncherBinary(instances[0].path, ui);
     if (!alias || !alias.binaryPath) {
       ui.error("Could not refresh the Egregore CLI.");

package/lib/setup.js

@@ -1021,7 +1021,7 @@ function codexSupportMessage(egregoreDir) {
     "  .codex/hooks.json",
     "  .codex/hooks/",
     "",
-    "Run npx -y create-egregore@latest to install the packaged Codex runtime, then rerun egregore.",
+    "Restore this instance using its installed runtime version, then rerun egregore.",
     "Egregore workflows appear as slash commands. In Codex, invoke them with the matching $skill token or ask in natural language.",
   ].join("\n");
 }
@@ -1035,7 +1035,7 @@ function piSupportMessage(egregoreDir) {
     "Pi meta-harness support is missing from this Egregore checkout.",
     `  path: ${egregoreDir}`,
     "",
-    "Run npx -y create-egregore@latest to install the packaged Pi runtime, then rerun egregore.",
+    "Restore this instance using its installed runtime version, then rerun egregore.",
     "Pi loads Egregore through project-local .pi resources and the shared portable skill corpus.",
   ].join("\n");
 }
@@ -1045,7 +1045,7 @@ function primeSupportMessage(egregoreDir) {
     "Prime Agent runtime support is missing from this Egregore checkout.",
     `  path: ${egregoreDir}`,
     "",
-    "Run npx -y create-egregore@latest to install the packaged Prime Agent runtime, then rerun egregore.",
+    "Restore this instance using its installed runtime version, then rerun egregore.",
     "Prime Agent loads Egregore through project-local .prime/agent resources and the shared portable skill corpus.",
   ].join("\n");
 }
@@ -1171,8 +1171,6 @@ async function launchOrInstruct(egregoreDir, alias, ui, ctx = {}) {
   console.log("");
 
   if (runtime === "codex") {
-    const codexRuntime = installCodexRuntime(egregoreDir);
-    reportCodexRuntimeSummary(codexRuntime, ui);
     if (!hasCodexCoreSupport(egregoreDir)) {
       ui.warn(codexSupportMessage(egregoreDir));
       ui.info(`Run ${ui.bold(aliasName)} after updating the checkout.`);
@@ -1188,8 +1186,6 @@ async function launchOrInstruct(egregoreDir, alias, ui, ctx = {}) {
       return;
     }
   } else if (runtime === "pi") {
-    const piRuntime = installPiRuntime(egregoreDir);
-    reportPiRuntimeSummary(piRuntime, ui);
     if (!hasPiRuntimeSupport(egregoreDir)) {
       ui.warn(piSupportMessage(egregoreDir));
       ui.info(`Run ${ui.bold(aliasName)} after updating the checkout.`);
@@ -1197,8 +1193,6 @@ async function launchOrInstruct(egregoreDir, alias, ui, ctx = {}) {
       return;
     }
   } else if (runtime === "prime") {
-    const primeRuntime = installPrimeRuntime(egregoreDir);
-    reportPrimeRuntimeSummary(primeRuntime, ui);
     if (!hasPrimeRuntimeSupport(egregoreDir)) {
       ui.warn(primeSupportMessage(egregoreDir));
       ui.info(`Run ${ui.bold(aliasName)} after updating the checkout.`);
@@ -1309,11 +1303,15 @@ function appendLocalBinToRc(ui) {
  */
 async function installLauncherBinary(egregoreDir, ui) {
   const template = readLauncherTemplate();
-  const candidates = [
-    { dir: "/usr/local/bin", location: "system" },
-    { dir: "/opt/homebrew/bin", location: "system" },
-    { dir: path.join(os.homedir(), ".local", "bin"), location: "user" },
-  ];
+  // An explicit destination must never fall through to machine-wide paths.
+  const configuredBinDir = process.env.EGREGORE_LAUNCHER_BIN_DIR;
+  const candidates = configuredBinDir
+    ? [{ dir: path.resolve(configuredBinDir), location: "user" }]
+    : [
+        { dir: "/usr/local/bin", location: "system" },
+        { dir: "/opt/homebrew/bin", location: "system" },
+        { dir: path.join(os.homedir(), ".local", "bin"), location: "user" },
+      ];
 
   let chosen = null;
   for (const c of candidates) {

package/package.json

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