ruvnet-brain 3.4.5-dev → 3.4.6-dev

package/README.md

@@ -4,7 +4,7 @@
 
 # 🧠 RuvNet Brain
 
-### 🧠 RuvNet Brain — [![RuvNet Brain version 3.4.5-dev — updated 2026-07-17 09:40 EDT](https://img.shields.io/badge/version_3.4.5--dev-updated_2026--07--17_09:40_EDT-1E90FF?style=for-the-badge&labelColor=0757BA)](https://github.com/stuinfla/ruvnet-brain/blob/main/plugin/.claude-plugin/plugin.json)
+### 🧠 RuvNet Brain — [![RuvNet Brain version 3.4.6-dev — updated 2026-07-17 09:40 EDT](https://img.shields.io/badge/version_3.4.6--dev-updated_2026--07--17_09:40_EDT-1E90FF?style=for-the-badge&labelColor=0757BA)](https://github.com/stuinfla/ruvnet-brain/blob/main/plugin/.claude-plugin/plugin.json)
 
 **A portable, source-grounded brain over Reuven Cohen's (rUv's) RuvNet stack — delivered as a Claude Code plugin that makes Claude _use_ the stack instead of fighting it.**
 

package/bin/install.mjs

@@ -907,19 +907,26 @@ function runUpdate() {
   printBanner('update');
   const kbDir = resolvedKbDir();
   info(`brain dir: ${c.bold(kbDir)}`);
-  if (!fs.existsSync(path.join(kbDir, 'forge-update.mjs'))) {
-    missingUpdaterHelp(kbDir);
-    process.exit(1);
-  }
-  info(c.dim("running the bundle's own self-updater (backs up first, re-verifies, never half-applies)…\n"));
-  // Relative filename + matching cwd — same launch convention as smokeQuery(); stdio:'inherit'
-  // streams the updater's narration live and unedited.
-  const r = spawnSync(process.execPath, ['forge-update.mjs', '--apply'], { cwd: kbDir, stdio: 'inherit' });
-  if (r.error) {
-    console.error(`\n${c.red('✗ update failed to launch:')} ${r.error.message}`);
-    process.exit(1);
+  let updateStatus = 1;
+  if (fs.existsSync(path.join(kbDir, 'forge-update.mjs'))) {
+    info(c.dim("running the bundle's own self-updater (backs up first, re-verifies, never half-applies)…\n"));
+    // Relative filename + matching cwd — same launch convention as smokeQuery(); stdio:'inherit'
+    // streams the updater's narration live and unedited.
+    const r = spawnSync(process.execPath, ['forge-update.mjs', '--apply'], { cwd: kbDir, stdio: 'inherit' });
+    updateStatus = r.error ? 1 : (r.status === null ? 1 : r.status);
+  }
+  // FALLBACK (2026-07-17). The bundle's self-updater is missing OR failed — e.g. an OLDER bundle whose
+  // canonicalManifestUrl points at the dead main/kb/.last-built.json path and 404s (the exact break a
+  // real user, Jan Lafko, hit). NEVER leave the user stranded at a 404: re-run THIS installer as a
+  // fresh install, which pulls the latest Release DIRECTLY (releases/latest) and never touches the
+  // manifest — so --update always succeeds and self-heals the stale SOURCE.json in one shot.
+  if (updateStatus !== 0 && !process.env.RUVNET_BRAIN_NO_UPDATE_FALLBACK) {
+    warn("\nthe bundle's own updater couldn't complete — falling back to a fresh install of the latest Release (this always works)…\n");
+    const self = fileURLToPath(import.meta.url);
+    const fr = spawnSync(process.execPath, [self, '--force'], { stdio: 'inherit',
+      env: { ...process.env, RUVNET_BRAIN_NO_UPDATE_FALLBACK: '1' } });
+    updateStatus = fr.error ? 1 : (fr.status === null ? 1 : fr.status);
   }
-  const updateStatus = r.status === null ? 1 : r.status;
   // `--update --auto` = update now AND enroll in Evergreen, so this is the LAST time it's ever run by
   // hand. Only enroll if the update itself succeeded — never promise "you're set forever" on a failed
   // update. enableNightly() prints its own real verification (plist path + launchctl result).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ruvnet-brain",
-  "version": "3.4.5-dev",
+  "version": "3.4.6-dev",
   "description": "One-command installer for RuvNet Brain — a portable, source-grounded brain over rUv's RuvNet building blocks, delivered as a Claude Code plugin so Claude uses the stack instead of fighting it.",
   "type": "module",
   "bin": {