@pi-unipi/unipi 2.17.1 → 2.17.2

package/CHANGELOG.md

@@ -6,6 +6,13 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+## [2.17.2] — 2026-09-15
+
+### Fixed
+
+- `footer`: **the startup update prompt no longer becomes unclosable after ~3.5s.** The deferred Glance editor install (`installGlanceEditor` in `src/index.ts`) calls `setEditorComponent()`, which internally re-focuses the editor and silently stole keyboard focus from whatever overlay was open — the updater prompt kept rendering while `q`/`n`/Esc typed into the input box. The install now snapshots the focused overlay (`tui.isOverlayFocused()` / `getFocusedComponent()`) and restores it after the swap, protecting the updater prompt, the boot dashboard, and any other overlay. New `tests/glance-focus.test.ts`.
+- `updater`: **the update prompt now shows the release notes for the version being offered.** It previously parsed the `CHANGELOG.md` shipped with the *installed* package, which by definition never contains the newer version's entry, so it only ever showed an empty `Unreleased` header. New `src/remote-changelog.ts` fetches `raw.githubusercontent.com/Neuron-Mr-White/unipi/v<latest>/CHANGELOG.md` (5s timeout, falls back to `main` when the tag is not pushed yet, then to the local file when offline) and caches tag-served content under `~/.unipi/cache/updater/changelog-<version>.md`. `parseChangelog()` is split into `parseChangelogContent()` + a file wrapper; `getNewerVersions()` drops an empty `Unreleased` entry; the empty state reads `No changelog available for <version> (offline?)`.
+
 ## [2.17.1] — 2026-09-15
 
 ### Fixed

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/unipi",
-  "version": "2.17.1",
+  "version": "2.17.2",
   "description": "All-in-one extension suite for Pi coding agent",
   "type": "module",
   "license": "MIT",
@@ -90,7 +90,7 @@
     "@pi-unipi/command-enchantment": "2.17.0",
     "@pi-unipi/compactor": "2.17.0",
     "@pi-unipi/core": "2.17.0",
-    "@pi-unipi/footer": "2.17.0",
+    "@pi-unipi/footer": "2.17.2",
     "@pi-unipi/image": "2.17.0",
     "@pi-unipi/fusion": "2.17.1",
     "@pi-unipi/info-screen": "2.17.0",
@@ -103,7 +103,7 @@
     "@pi-unipi/ralph": "2.17.0",
     "@pi-unipi/subagents": "2.17.0",
     "@pi-unipi/trajectory": "2.17.0",
-    "@pi-unipi/updater": "2.17.0",
+    "@pi-unipi/updater": "2.17.2",
     "@pi-unipi/utility": "2.17.0",
     "@pi-unipi/web-api": "2.17.0",
     "@pi-unipi/workflow": "2.17.0"

package/packages/footer/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/footer",
-  "version": "2.17.0",
+  "version": "2.17.2",
   "description": "Persistent status bar for Unipi — subscribes to UNIPI_EVENTS and renders key stats from all unipi packages",
   "type": "module",
   "main": "index.ts",

package/packages/footer/src/index.ts

@@ -153,13 +153,10 @@ export default function footerExtension(pi: ExtensionAPI): void {
     // Glance-style input surface (pi-glance-inspired). Preserves all default
     // editor behavior via CustomEditor subclassing; only paint differs.
     //
-    // FOCUS-SAFETY DEFERRAL: setEditorComponent() internally calls
-    // ui.setFocus(newEditor). info-screen (loaded before us) opens its boot
-    // dashboard during ITS session_start handler, so our session_start runs
-    // while that overlay owns keyboard focus. Swapping now would steal focus
-    // and strand the dashboard unclosable (q/Esc would type into the editor).
-    // The boot overlay auto-closes after ~2s; we install after a grace period
-    // longer than any sane bootTimeoutMs.
+    // FOCUS-SAFETY DEFERRAL: the timer remains a grace period for the boot
+    // dashboard, but installGlanceEditor also restores any overlay focus after
+    // setEditorComponent() calls ui.setFocus(newEditor). This covers the
+    // updater prompt too, so q/Esc cannot be stranded in the editor.
     state.glanceInstallTimer = setTimeout(() => installGlanceEditor(state, ctx), 3500);
 
     // Sync TPS cursor with persisted assistant messages so streaming-hook
@@ -420,6 +417,15 @@ function installGlanceEditor(
 ): void {
   if (st.glanceInstalled || !st.piContext || !st.glanceMode) return;
   try {
+    const tui = st.tuiRef as (import("@earendil-works/pi-tui").TUI & {
+      isOverlayFocused?: () => boolean;
+      getFocusedComponent?: () => import("@earendil-works/pi-tui").Component | null;
+    }) | null | undefined;
+    const overlayFocused = tui !== undefined && tui !== null
+      && (typeof tui.isOverlayFocused === "function" ? tui.isOverlayFocused() : tui.hasOverlay());
+    const overlayOwner = overlayFocused && typeof tui?.getFocusedComponent === "function"
+      ? tui.getFocusedComponent() ?? null
+      : null;
     const piCtx = st.piContext as Record<string, unknown> | undefined;
     const cwd = (piCtx?.sessionManager as any)?.getCwd?.() ?? (piCtx as any)?.cwd ?? process.cwd();
     const workspace = String(cwd).split("/").filter(Boolean).pop() ?? "~";
@@ -445,6 +451,7 @@ function installGlanceEditor(
         };
       }),
     );
+    if (overlayOwner && tui) tui.setFocus(overlayOwner);
     st.glanceInstalled = true;
   } catch {
     st.glanceInstalled = false;

package/packages/unipi/bundled.js

@@ -6978,7 +6978,7 @@ var init_hooks = __esm({
       if (!debug) return;
       try {
         import("node:fs").then(
-          ({ writeFileSync: writeFileSync48 }) => writeFileSync48("/tmp/compactor-debug.json", JSON.stringify(data, null, 2))
+          ({ writeFileSync: writeFileSync49 }) => writeFileSync49("/tmp/compactor-debug.json", JSON.stringify(data, null, 2))
         ).catch(() => {
         });
       } catch {
@@ -15246,8 +15246,8 @@ function resolvePiPackageRoot() {
     return void 0;
   }
 }
-function isRunnableNodeScript(filePath, existsSync64) {
-  if (!existsSync64(filePath)) return false;
+function isRunnableNodeScript(filePath, existsSync65) {
+  if (!existsSync65(filePath)) return false;
   return /\.(?:mjs|cjs|js)$/i.test(filePath);
 }
 function normalizePath(filePath) {
@@ -15258,16 +15258,16 @@ function isStandalonePiExecutable(execPath) {
   return /^pi(?:\.exe)?$/i.test(executableName ?? "");
 }
 function resolvePiCliScript(deps = {}) {
-  const existsSync64 = deps.existsSync ?? fs9.existsSync;
+  const existsSync65 = deps.existsSync ?? fs9.existsSync;
   const realpathSync9 = deps.realpathSync ?? fs9.realpathSync;
-  const readFileSync55 = deps.readFileSync ?? ((filePath, encoding) => fs9.readFileSync(filePath, encoding));
+  const readFileSync56 = deps.readFileSync ?? ((filePath, encoding) => fs9.readFileSync(filePath, encoding));
   const argv1 = deps.argv1 ?? process.argv[1];
   if (argv1) {
     const argvPath = normalizePath(argv1);
-    if (isRunnableNodeScript(argvPath, existsSync64)) {
+    if (isRunnableNodeScript(argvPath, existsSync65)) {
       try {
         const canonicalArgvPath = realpathSync9(argvPath);
-        if (isRunnableNodeScript(canonicalArgvPath, existsSync64) && findPiPackageRootFromEntry(canonicalArgvPath)) {
+        if (isRunnableNodeScript(canonicalArgvPath, existsSync65) && findPiPackageRootFromEntry(canonicalArgvPath)) {
           return canonicalArgvPath;
         }
       } catch {
@@ -15285,12 +15285,12 @@ function resolvePiCliScript(deps = {}) {
       return path9.join(packageRoot, "package.json");
     });
     const packageJsonPath = resolvePackageJson();
-    const packageJson = JSON.parse(readFileSync55(packageJsonPath, "utf8"));
+    const packageJson = JSON.parse(readFileSync56(packageJsonPath, "utf8"));
     const binField = packageJson.bin;
     const binPath = typeof binField === "string" ? binField : binField?.pi ?? Object.values(binField ?? {})[0];
     if (!binPath) return void 0;
     const candidate = path9.resolve(path9.dirname(packageJsonPath), binPath);
-    if (isRunnableNodeScript(candidate, existsSync64)) {
+    if (isRunnableNodeScript(candidate, existsSync65)) {
       return candidate;
     }
   } catch {
@@ -42422,15 +42422,15 @@ function compactorExtension(pi) {
     config = loadConfig4(cwd);
     currentSessionId = `${ctx.sessionId ?? "default"}${getWorktreeSuffix()}`;
     try {
-      const { existsSync: existsSync64 } = await import("node:fs");
-      const { join: join77 } = await import("node:path");
+      const { existsSync: existsSync65 } = await import("node:fs");
+      const { join: join78 } = await import("node:path");
       const strategies = [
         { key: "commits", config: config.commits }
       ];
       for (const { key, config: strat } of strategies) {
         if (strat.autoDetect === "git") {
-          const gitDir = join77(cwd, ".git");
-          if (!existsSync64(gitDir)) {
+          const gitDir = join78(cwd, ".git");
+          if (!existsSync65(gitDir)) {
             strat.enabled = false;
           }
         }
@@ -46449,11 +46449,14 @@ function applyGlanceMode(st, cmdCtx) {
 function installGlanceEditor(st, uiHost) {
   if (st.glanceInstalled || !st.piContext || !st.glanceMode) return;
   try {
+    const tui = st.tuiRef;
+    const overlayFocused = tui !== void 0 && tui !== null && (typeof tui.isOverlayFocused === "function" ? tui.isOverlayFocused() : tui.hasOverlay());
+    const overlayOwner = overlayFocused && typeof tui?.getFocusedComponent === "function" ? tui.getFocusedComponent() ?? null : null;
     const piCtx = st.piContext;
     const cwd = piCtx?.sessionManager?.getCwd?.() ?? piCtx?.cwd ?? process.cwd();
     const workspace = String(cwd).split("/").filter(Boolean).pop() ?? "~";
     uiHost.ui.setEditorComponent(
-      (tui, theme, keybindings) => new GlanceEditor(tui, theme, keybindings, () => {
+      (tui2, theme, keybindings) => new GlanceEditor(tui2, theme, keybindings, () => {
         const p = st.piContext;
         const usage2 = typeof p?.getContextUsage === "function" ? p.getContextUsage() : void 0;
         const model = p?.model;
@@ -46472,6 +46475,7 @@ function installGlanceEditor(st, uiHost) {
         };
       })
     );
+    if (overlayOwner && tui) tui.setFocus(overlayOwner);
     st.glanceInstalled = true;
   } catch {
     st.glanceInstalled = false;
@@ -46968,9 +46972,12 @@ var VERSION_HEADER_RE = /^## \[(.+?)\](?:\s*[-—–]\s*(.+))?$/;
 var SECTION_HEADER_RE = /^### (.+)$/;
 function parseChangelog(filePath) {
   if (!existsSync56(filePath)) return [];
-  const content = readFileSync47(filePath, "utf-8").trim();
-  if (!content) return [];
-  const lines = content.split("\n");
+  return parseChangelogContent(readFileSync47(filePath, "utf-8"));
+}
+function parseChangelogContent(content) {
+  const trimmed = content.trim();
+  if (!trimmed) return [];
+  const lines = trimmed.split("\n");
   const entries = [];
   let currentEntry = null;
   let currentSection = null;
@@ -47006,12 +47013,12 @@ function parseChangelog(filePath) {
       currentItems = [];
       continue;
     }
-    const trimmed = line.trim();
-    if (currentSection && (trimmed.startsWith("- ") || trimmed.startsWith("* "))) {
-      currentItems.push(trimmed.slice(2).trim());
-    } else if (trimmed && currentSection) {
+    const trimmed2 = line.trim();
+    if (currentSection && (trimmed2.startsWith("- ") || trimmed2.startsWith("* "))) {
+      currentItems.push(trimmed2.slice(2).trim());
+    } else if (trimmed2 && currentSection) {
       if (currentItems.length > 0) {
-        currentItems[currentItems.length - 1] += " " + trimmed;
+        currentItems[currentItems.length - 1] += " " + trimmed2;
       }
     }
   }
@@ -47038,7 +47045,7 @@ function getNewerVersions(entries, installedVersion) {
   const result2 = [];
   for (const entry of entries) {
     if (entry.version === "Unreleased") {
-      result2.push(entry);
+      if (Object.keys(entry.sections).length > 0) result2.push(entry);
       continue;
     }
     if (!isNewerVersion(entry.version, installedVersion)) break;
@@ -47475,15 +47482,17 @@ function padVisible3(content, targetWidth) {
   const pad2 = Math.max(0, targetWidth - vw);
   return content + " ".repeat(pad2);
 }
-function renderUpdateOverlay(checkResult) {
+function renderUpdateOverlay(checkResult, providedNewerVersions) {
   return (tui, theme, _kb, done) => {
     const config = loadConfig5();
-    let newerVersions = [];
-    const changelogPath = resolveChangelogPath();
-    try {
-      const entries = parseChangelog(changelogPath);
-      newerVersions = getNewerVersions(entries, checkResult.currentVersion);
-    } catch (_err) {
+    let newerVersions = providedNewerVersions ?? [];
+    if (providedNewerVersions === void 0) {
+      const changelogPath = resolveChangelogPath();
+      try {
+        const entries = parseChangelog(changelogPath);
+        newerVersions = getNewerVersions(entries, checkResult.currentVersion);
+      } catch (_err) {
+      }
     }
     const contentLines = [];
     for (const entry of newerVersions) {
@@ -47496,7 +47505,7 @@ function renderUpdateOverlay(checkResult) {
       contentLines.push("");
     }
     if (contentLines.length === 0) {
-      contentLines.push(`  ${theme.fg("muted", "No changelog available for this update.")}`);
+      contentLines.push(`  ${theme.fg("muted", `No changelog available for ${checkResult.latestVersion} (offline?).`)}`);
     }
     const state2 = {
       result: checkResult,
@@ -47633,6 +47642,49 @@ function renderUpdateOverlay(checkResult) {
   };
 }
 
+// packages/updater/src/remote-changelog.ts
+init_core();
+import { existsSync as existsSync60, mkdirSync as mkdirSync38, readFileSync as readFileSync50, writeFileSync as writeFileSync42 } from "node:fs";
+import { homedir as homedir34 } from "node:os";
+import { join as join69 } from "node:path";
+var CHANGELOG_RAW_BASE = "https://raw.githubusercontent.com/Neuron-Mr-White/unipi";
+function cacheDirectory(opts) {
+  return (opts?.cacheDir ?? UPDATER_DIRS.CACHE).replace("~", homedir34());
+}
+async function fetchRemoteChangelog(version, opts = {}) {
+  const cacheDir2 = cacheDirectory(opts);
+  const cachePath = join69(cacheDir2, `changelog-${version}.md`);
+  try {
+    if (existsSync60(cachePath)) return readFileSync50(cachePath, "utf8");
+  } catch {
+  }
+  const fetchImpl = opts.fetchImpl ?? fetch;
+  const signal = AbortSignal.timeout(opts.timeoutMs ?? 5e3);
+  try {
+    let response = await fetchImpl(`${CHANGELOG_RAW_BASE}/v${version}/CHANGELOG.md`, { signal });
+    const cacheable = response.ok;
+    if (response.status === 404) {
+      response = await fetchImpl(`${CHANGELOG_RAW_BASE}/main/CHANGELOG.md`, { signal });
+    }
+    if (!response.ok) return null;
+    const content = await response.text();
+    if (cacheable) {
+      mkdirSync38(cacheDir2, { recursive: true });
+      writeFileSync42(cachePath, content, "utf8");
+    }
+    return content;
+  } catch {
+    return null;
+  }
+}
+async function loadUpdateChangelog(currentVersion, latestVersion, opts) {
+  const remote = await fetchRemoteChangelog(latestVersion, opts);
+  const entries = remote === null ? [] : parseChangelogContent(remote);
+  const newer = remote === null ? [] : getNewerVersions(entries, currentVersion);
+  if (newer.length > 0) return newer;
+  return getNewerVersions(parseChangelog(resolveChangelogPath()), currentVersion);
+}
+
 // packages/updater/src/index.ts
 var VERSION10 = getPackageVersion(new URL("..", import.meta.url).pathname);
 function updaterExtension(pi) {
@@ -47726,8 +47778,9 @@ function updaterExtension(pi) {
         latestVersion: result2.latestVersion
       });
       if (ctx.hasUI) {
+        const entries = await loadUpdateChangelog(result2.currentVersion, result2.latestVersion);
         const updateResult = await ctx.ui.custom(
-          renderUpdateOverlay(result2),
+          renderUpdateOverlay(result2, entries),
           {
             overlay: true,
             overlayOptions: {
@@ -47755,8 +47808,8 @@ init_core();
 import { Key as Key19, matchesKey as matchesKey25 } from "@earendil-works/pi-tui";
 
 // packages/input-shortcuts/src/registers.ts
-import { existsSync as existsSync60, mkdirSync as mkdirSync38, readFileSync as readFileSync50, renameSync as renameSync13, writeFileSync as writeFileSync42 } from "node:fs";
-import { dirname as dirname45, join as join69 } from "node:path";
+import { existsSync as existsSync61, mkdirSync as mkdirSync39, readFileSync as readFileSync51, renameSync as renameSync13, writeFileSync as writeFileSync43 } from "node:fs";
+import { dirname as dirname45, join as join70 } from "node:path";
 
 // packages/input-shortcuts/src/types.ts
 var DEFAULT_CONFIG8 = {
@@ -47779,7 +47832,7 @@ var RegisterStore = class {
   filePath;
   loaded = false;
   constructor(baseDir) {
-    this.filePath = baseDir ? join69(baseDir, REGISTERS_FILE) : REGISTERS_FILE;
+    this.filePath = baseDir ? join70(baseDir, REGISTERS_FILE) : REGISTERS_FILE;
   }
   /** Get the stash register contents. */
   getStash() {
@@ -47803,8 +47856,8 @@ var RegisterStore = class {
     if (this.loaded) return;
     this.loaded = true;
     try {
-      if (existsSync60(this.filePath)) {
-        const raw = readFileSync50(this.filePath, "utf-8");
+      if (existsSync61(this.filePath)) {
+        const raw = readFileSync51(this.filePath, "utf-8");
         const parsed = JSON.parse(raw);
         this.data = {
           stash: typeof parsed.stash === "string" ? parsed.stash : "",
@@ -47821,11 +47874,11 @@ var RegisterStore = class {
   save() {
     try {
       const dir = dirname45(this.filePath);
-      if (!existsSync60(dir)) {
-        mkdirSync38(dir, { recursive: true });
+      if (!existsSync61(dir)) {
+        mkdirSync39(dir, { recursive: true });
       }
       const tmpPath = this.filePath + ".tmp";
-      writeFileSync42(tmpPath, JSON.stringify(this.data, null, 2), "utf-8");
+      writeFileSync43(tmpPath, JSON.stringify(this.data, null, 2), "utf-8");
       renameSync13(tmpPath, this.filePath);
     } catch {
     }
@@ -48037,8 +48090,8 @@ var ChordOverlay = class extends Container2 {
 
 // packages/input-shortcuts/src/settings-overlay.ts
 import { SettingsList as SettingsList3 } from "@earendil-works/pi-tui";
-import { existsSync as existsSync61, mkdirSync as mkdirSync39, readFileSync as readFileSync51, renameSync as renameSync14, writeFileSync as writeFileSync43 } from "node:fs";
-import { dirname as dirname46, join as join70 } from "node:path";
+import { existsSync as existsSync62, mkdirSync as mkdirSync40, readFileSync as readFileSync52, renameSync as renameSync14, writeFileSync as writeFileSync44 } from "node:fs";
+import { dirname as dirname46, join as join71 } from "node:path";
 var ALT_KEY_OPTIONS = [
   "alt+a",
   "alt+b",
@@ -48070,10 +48123,10 @@ var ALT_KEY_OPTIONS = [
 var CONFLICTS = /* @__PURE__ */ new Set(["alt+e"]);
 var FREE_ALT_KEYS = ALT_KEY_OPTIONS.filter((k) => !CONFLICTS.has(k));
 function loadConfig6(baseDir) {
-  const filePath = baseDir ? join70(baseDir, CONFIG_FILE) : CONFIG_FILE;
+  const filePath = baseDir ? join71(baseDir, CONFIG_FILE) : CONFIG_FILE;
   try {
-    if (existsSync61(filePath)) {
-      const raw = readFileSync51(filePath, "utf-8");
+    if (existsSync62(filePath)) {
+      const raw = readFileSync52(filePath, "utf-8");
       const parsed = JSON.parse(raw);
       return {
         chordKey: typeof parsed.chordKey === "string" ? parsed.chordKey : DEFAULT_CONFIG8.chordKey,
@@ -48085,14 +48138,14 @@ function loadConfig6(baseDir) {
   return { ...DEFAULT_CONFIG8 };
 }
 function saveConfig5(config, baseDir) {
-  const filePath = baseDir ? join70(baseDir, CONFIG_FILE) : CONFIG_FILE;
+  const filePath = baseDir ? join71(baseDir, CONFIG_FILE) : CONFIG_FILE;
   try {
     const dir = dirname46(filePath);
-    if (!existsSync61(dir)) {
-      mkdirSync39(dir, { recursive: true });
+    if (!existsSync62(dir)) {
+      mkdirSync40(dir, { recursive: true });
     }
     const tmpPath = filePath + ".tmp";
-    writeFileSync43(tmpPath, JSON.stringify(config, null, 2), "utf-8");
+    writeFileSync44(tmpPath, JSON.stringify(config, null, 2), "utf-8");
     renameSync14(tmpPath, filePath);
   } catch {
   }
@@ -50304,13 +50357,13 @@ function src_default5(pi) {
 
 // packages/fusion/src/index.ts
 init_core();
-import { homedir as homedir36 } from "node:os";
-import { join as join75 } from "node:path";
+import { homedir as homedir37 } from "node:os";
+import { join as join76 } from "node:path";
 
 // packages/fusion/src/preset.ts
-import { existsSync as existsSync63, mkdirSync as mkdirSync42, readFileSync as readFileSync54, writeFileSync as writeFileSync46, renameSync as renameSync15 } from "node:fs";
-import { homedir as homedir35 } from "node:os";
-import { dirname as dirname48, join as join73 } from "node:path";
+import { existsSync as existsSync64, mkdirSync as mkdirSync43, readFileSync as readFileSync55, writeFileSync as writeFileSync47, renameSync as renameSync15 } from "node:fs";
+import { homedir as homedir36 } from "node:os";
+import { dirname as dirname48, join as join74 } from "node:path";
 var PRESET_SCHEMA_VERSION = 1;
 var EFFORT_LEVELS = ["off", "minimal", "low", "medium", "high", "xhigh", "max"];
 var RECENT_LIMIT = 5;
@@ -50326,11 +50379,11 @@ function emptyPreset() {
     prices: {}
   };
 }
-function globalPresetPath(home = homedir35()) {
-  return join73(home, ".unipi", "config", "fusion", "preset.json");
+function globalPresetPath(home = homedir36()) {
+  return join74(home, ".unipi", "config", "fusion", "preset.json");
 }
 function projectPresetPath(cwd) {
-  return join73(cwd, ".unipi", "fusion-preset.json");
+  return join74(cwd, ".unipi", "fusion-preset.json");
 }
 function modelKey(model) {
   return `${model.provider}/${model.id}`;
@@ -50424,13 +50477,13 @@ function mergePresets(base, over) {
 }
 function readJson4(path41) {
   try {
-    if (!existsSync63(path41)) return void 0;
-    return JSON.parse(readFileSync54(path41, "utf8"));
+    if (!existsSync64(path41)) return void 0;
+    return JSON.parse(readFileSync55(path41, "utf8"));
   } catch {
     return void 0;
   }
 }
-function loadPreset(cwd, home = homedir35()) {
+function loadPreset(cwd, home = homedir36()) {
   const globalPath = globalPresetPath(home);
   const projectPath = projectPresetPath(cwd);
   const globalRaw = readJson4(globalPath);
@@ -50441,9 +50494,9 @@ function loadPreset(cwd, home = homedir35()) {
   return { preset: preset2, globalPath, projectPath, hasProjectLayer };
 }
 function writeJsonAtomic2(path41, value) {
-  mkdirSync42(dirname48(path41), { recursive: true });
+  mkdirSync43(dirname48(path41), { recursive: true });
   const tmp = `${path41}.${String(process.pid)}.tmp`;
-  writeFileSync46(tmp, `${JSON.stringify(value, null, 2)}
+  writeFileSync47(tmp, `${JSON.stringify(value, null, 2)}
 `, "utf8");
   renameSync15(tmp, path41);
 }
@@ -51038,9 +51091,9 @@ var PresetEditor = class {
 
 // packages/fusion/src/sidekick-runtime.ts
 import { spawn as defaultSpawn2 } from "node:child_process";
-import { mkdirSync as mkdirSync43, unlinkSync as unlinkSync12, writeFileSync as writeFileSync47 } from "node:fs";
+import { mkdirSync as mkdirSync44, unlinkSync as unlinkSync12, writeFileSync as writeFileSync48 } from "node:fs";
 import { tmpdir as tmpdir7 } from "node:os";
-import { dirname as dirname49, join as join74 } from "node:path";
+import { dirname as dirname49, join as join75 } from "node:path";
 import { randomUUID as randomUUID11 } from "node:crypto";
 var emptyUsage = () => ({ input: 0, output: 0, cacheRead: 0, cacheWrite: 0, cost: 0 });
 var SidekickRuntime = class {
@@ -51080,9 +51133,9 @@ var SidekickRuntime = class {
     this.promptPath = void 0;
   }
   spawn() {
-    mkdirSync43(dirname49(this.cfg.sessionFile), { recursive: true });
-    this.promptPath = join74(tmpdir7(), `unipi-fusion-${randomUUID11()}.txt`);
-    writeFileSync47(this.promptPath, this.cfg.systemPrompt, "utf8");
+    mkdirSync44(dirname49(this.cfg.sessionFile), { recursive: true });
+    this.promptPath = join75(tmpdir7(), `unipi-fusion-${randomUUID11()}.txt`);
+    writeFileSync48(this.promptPath, this.cfg.systemPrompt, "utf8");
     const command = this.cfg.command ?? getPiSpawnCommand([
       "--mode",
       "rpc",
@@ -51501,7 +51554,7 @@ ${progressText(runtime, id)}`);
 var MODEL_COMMAND = `${UNIPI_PREFIX}model`;
 var PRESET_COMMAND = `${UNIPI_PREFIX}fusion-preset`;
 function sidekickSessionPath(leadSessionId) {
-  return join75(homedir36(), ".unipi", "state", "fusion", "sidekick", `${leadSessionId ?? "default"}.jsonl`);
+  return join76(homedir37(), ".unipi", "state", "fusion", "sidekick", `${leadSessionId ?? "default"}.jsonl`);
 }
 function registryOf(ctx) {
   const r = ctx.modelRegistry;
@@ -51964,9 +52017,9 @@ var PrefixIntegrityTracker = class {
 };
 
 // packages/trajectory/src/telemetry.ts
-import { appendFileSync, closeSync as closeSync4, mkdirSync as mkdirSync44, openSync as openSync4, readSync as readSync3, statSync as statSync18 } from "node:fs";
-import { homedir as homedir37 } from "node:os";
-import { join as join76 } from "node:path";
+import { appendFileSync, closeSync as closeSync4, mkdirSync as mkdirSync45, openSync as openSync4, readSync as readSync3, statSync as statSync18 } from "node:fs";
+import { homedir as homedir38 } from "node:os";
+import { join as join77 } from "node:path";
 var SECRET_KEY = /authorization|api[-_]?key|token|cookie|secret|password|credential/i;
 var SECRET_VALUE = /^(?:bearer\s+|sk-[a-z0-9_-]{12,}|gh[pousr]_[a-z0-9]{12,}|AIza[a-z0-9_-]{20,})/i;
 var MAX_STRING = 2e5;
@@ -52030,9 +52083,9 @@ function redactTelemetry(value, seen = /* @__PURE__ */ new WeakSet()) {
 var TelemetrySidecar = class {
   file;
   state;
-  constructor(sessionId, root = join76(homedir37(), ".unipi", "trajectory")) {
-    mkdirSync44(root, { recursive: true, mode: 448 });
-    this.file = join76(root, `${sessionId.replace(/[^a-zA-Z0-9._-]/g, "_")}.jsonl`);
+  constructor(sessionId, root = join77(homedir38(), ".unipi", "trajectory")) {
+    mkdirSync45(root, { recursive: true, mode: 448 });
+    this.file = join77(root, `${sessionId.replace(/[^a-zA-Z0-9._-]/g, "_")}.jsonl`);
     this.state = stateFor(this.file);
   }
   append(event) {

package/packages/updater/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/updater",
-  "version": "2.17.0",
+  "version": "2.17.2",
   "description": "Auto-updater, changelog browser, and readme browser for Unipi — checks npm registry, renders CHANGELOG.md and README.md files in TUI overlays",
   "type": "module",
   "main": "index.ts",

package/packages/updater/src/changelog.ts

@@ -47,11 +47,14 @@ const SECTION_HEADER_RE = /^### (.+)$/;
  */
 export function parseChangelog(filePath: string): ChangelogEntry[] {
   if (!existsSync(filePath)) return [];
+  return parseChangelogContent(readFileSync(filePath, "utf-8"));
+}
 
-  const content = readFileSync(filePath, "utf-8").trim();
-  if (!content) return [];
+export function parseChangelogContent(content: string): ChangelogEntry[] {
+  const trimmed = content.trim();
+  if (!trimmed) return [];
 
-  const lines = content.split("\n");
+  const lines = trimmed.split("\n");
   const entries: ChangelogEntry[] = [];
 
   let currentEntry: ChangelogEntry | null = null;
@@ -143,7 +146,7 @@ export function getNewerVersions(
   const result: ChangelogEntry[] = [];
   for (const entry of entries) {
     if (entry.version === "Unreleased") {
-      result.push(entry);
+      if (Object.keys(entry.sections).length > 0) result.push(entry);
       continue;
     }
     // Compare rather than test for equality. Stopping only on an exact match

package/packages/updater/src/index.ts

@@ -23,6 +23,7 @@ import { loadConfig } from "./settings.js";
 import { checkForUpdates } from "./checker.js";
 import { isVersionSkipped } from "./cache.js";
 import { renderUpdateOverlay } from "./tui/update-overlay.js";
+import { loadUpdateChangelog } from "./remote-changelog.js";
 
 /** Package version */
 const VERSION = getPackageVersion(new URL("..", import.meta.url).pathname);
@@ -142,8 +143,9 @@ export default function updaterExtension(pi: ExtensionAPI): void {
 
       // Show update overlay if UI is available
       if (ctx.hasUI) {
+        const entries = await loadUpdateChangelog(result.currentVersion, result.latestVersion);
         const updateResult = await ctx.ui.custom(
-          renderUpdateOverlay(result),
+          renderUpdateOverlay(result, entries),
           {
             overlay: true,
             overlayOptions: {

package/packages/updater/src/remote-changelog.ts

@@ -0,0 +1,61 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { UPDATER_DIRS } from "@pi-unipi/core";
+import type { ChangelogEntry } from "../types.js";
+import { getNewerVersions, parseChangelogContent, parseChangelog, resolveChangelogPath } from "./changelog.js";
+
+export const CHANGELOG_RAW_BASE = "https://raw.githubusercontent.com/Neuron-Mr-White/unipi";
+
+export interface RemoteChangelogOptions {
+  fetchImpl?: typeof fetch;
+  cacheDir?: string;
+  timeoutMs?: number;
+}
+
+function cacheDirectory(opts?: RemoteChangelogOptions): string {
+  return (opts?.cacheDir ?? UPDATER_DIRS.CACHE).replace("~", homedir());
+}
+
+export async function fetchRemoteChangelog(version: string, opts: RemoteChangelogOptions = {}): Promise<string | null> {
+  const cacheDir = cacheDirectory(opts);
+  const cachePath = join(cacheDir, `changelog-${version}.md`);
+  try {
+    if (existsSync(cachePath)) return readFileSync(cachePath, "utf8");
+  } catch {
+    // Continue with the network request.
+  }
+
+  const fetchImpl = opts.fetchImpl ?? fetch;
+  const signal = AbortSignal.timeout(opts.timeoutMs ?? 5000);
+  try {
+    let response = await fetchImpl(`${CHANGELOG_RAW_BASE}/v${version}/CHANGELOG.md`, { signal });
+    // The release tag is immutable, so its changelog is safe to cache forever.
+    // The `main` fallback (tag not pushed yet) is not: never cache it.
+    const cacheable = response.ok;
+    if (response.status === 404) {
+      response = await fetchImpl(`${CHANGELOG_RAW_BASE}/main/CHANGELOG.md`, { signal });
+    }
+    if (!response.ok) return null;
+    const content = await response.text();
+    if (cacheable) {
+      mkdirSync(cacheDir, { recursive: true });
+      writeFileSync(cachePath, content, "utf8");
+    }
+    return content;
+  } catch {
+    return null;
+  }
+}
+
+export async function loadUpdateChangelog(
+  currentVersion: string,
+  latestVersion: string,
+  opts?: RemoteChangelogOptions,
+): Promise<ChangelogEntry[]> {
+  const remote = await fetchRemoteChangelog(latestVersion, opts);
+  const entries = remote === null ? [] : parseChangelogContent(remote);
+  const newer = remote === null ? [] : getNewerVersions(entries, currentVersion);
+  if (newer.length > 0) return newer;
+  return getNewerVersions(parseChangelog(resolveChangelogPath()), currentVersion);
+}

package/packages/updater/src/tui/update-overlay.ts

@@ -40,7 +40,7 @@ interface UpdateState {
 /**
  * Render the update available overlay.
  */
-export function renderUpdateOverlay(checkResult: UpdateCheckResult) {
+export function renderUpdateOverlay(checkResult: UpdateCheckResult, providedNewerVersions?: ChangelogEntry[]) {
   return (
     tui: import("@earendil-works/pi-tui").TUI,
     theme: Theme,
@@ -49,14 +49,16 @@ export function renderUpdateOverlay(checkResult: UpdateCheckResult) {
   ) => {
     const config = loadConfig();
 
-    // Load changelog for newer versions
-    let newerVersions: ChangelogEntry[] = [];
-    const changelogPath = resolveChangelogPath();
-    try {
-      const entries = parseChangelog(changelogPath);
-      newerVersions = getNewerVersions(entries, checkResult.currentVersion);
-    } catch (_err) {
-      // No changelog
+    // Load changelog for newer versions unless the caller already fetched it.
+    let newerVersions: ChangelogEntry[] = providedNewerVersions ?? [];
+    if (providedNewerVersions === undefined) {
+      const changelogPath = resolveChangelogPath();
+      try {
+        const entries = parseChangelog(changelogPath);
+        newerVersions = getNewerVersions(entries, checkResult.currentVersion);
+      } catch (_err) {
+        // No changelog
+      }
     }
 
     // Build content lines from changelog using markdown renderer
@@ -74,7 +76,7 @@ export function renderUpdateOverlay(checkResult: UpdateCheckResult) {
       contentLines.push("");
     }
     if (contentLines.length === 0) {
-      contentLines.push(`  ${theme.fg("muted", "No changelog available for this update.")}`);
+      contentLines.push(`  ${theme.fg("muted", `No changelog available for ${checkResult.latestVersion} (offline?).`)}`);
     }
 
     const state: UpdateState = {