@pi-unipi/unipi 2.14.1 → 2.15.0

package/CHANGELOG.md

@@ -6,6 +6,20 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+## [2.15.0] — 2026-08-31
+
+### Added
+
+- `ralph`: **argument completions for `/unipi:ralph`** — the command now autosuggests subcommands with one-line descriptions, live loop names from `.unipi/ralph/*.state.json` (status-annotated, filtered per subcommand: `resume` hides completed loops, `archive` hides active ones, `cancel` shows all), `start` flags (`--max-iterations`, `--items-per-iteration`, `--reflect-every`, already-used ones excluded), and `--archived` / `--all` / `--yes` for `list` / `clean` / `nuke`. Implemented as a pure builder (`packages/ralph/completions.ts`, 12 tests) wired via `registerCommand`'s `getArgumentCompletions`; pi replaces the entire argument text with the selected item's value, so nested suggestions carry full replacement strings (`resume myloop`) to preserve already-typed flags. Exact-match tokens suppress the popup.
+- `memory`: **MemPalace auto-update** — when MemPalace is the active backend, a TTL-gated (24h, state file `~/.unipi/memory/.mempalace-update`) PyPI release check runs in the background at session start; on a newer `mempalace` release it upgrades via `uv` fire-and-forget (paused while the daemon is running) and emits `unipi:update:applied`. Never blocks startup, all failures swallowed; toggle in `/unipi:memory-settings` (`mempalaceAutoUpdate`, default on).
+
+## [2.14.2] — 2026-08-31
+
+### Fixed
+
+- `footer`: **glance frame no longer writes the terminal's last column** (GitHub [#31](https://github.com/Neuron-Mr-White/UniPi/issues/31)) — the glance frame, session strip, process one-liner, and classic status line now cap emitted lines at `width - 1` instead of exactly `width`. pi-tui joins per-tick rewrites with `\r\n`; a line at EXACTLY the terminal width trips auto-wrap on terminals that wrap immediately (or whose glyph widths disagree with `visibleWidth()`, e.g. missing Nerd Fonts / ambiguous-width settings), silently desyncing the differential renderer so every 1s footer refresh painted a fresh input-box copy one block lower until the screen filled. Verified by PTY capture + VT replay: identical byte stream renders 1 stable frame on deferred-wrap terminals vs 12 stacked frames on immediate-wrap ones; the cap removes the footer's contribution entirely. Full resolution of terminal-side drift from pi's own boot/info lines is upstream (pi-tui main-screen wrap-safe bookkeeping).
+- `web-api`: **fetch errors surface their real cause instead of "[object Object]"** — engine errors were plain objects (`{ error, code, phase, retryable }`), so every tool-level catch serialized them via `String()` and both the agent and the user saw only "Read failed: [object Object]" with no diagnosis. `createError()` now returns a real `Error` instance carrying the FetchError fields (interface-compatible: `.error`/`.code`/`.phase`/`.retryable` preserved, classification untouched), and a new `describeError()` normalizes Error instances, FetchError-shaped objects, `{message}`/`{reason}`/`{detail}` shapes, strings, and unserializable values at every tool boundary and in the provider fallthrough. Regression tests cover all shapes; a provider throwing `{ error: "HTTP 429" }` now reports the 429 instead of nothing.
+
 ## [2.14.1] — 2026-08-28
 
 ### Added

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/unipi",
-  "version": "2.14.1",
+  "version": "2.15.0",
   "description": "All-in-one extension suite for Pi coding agent",
   "type": "module",
   "license": "MIT",
@@ -82,28 +82,28 @@
     "typebox": "^1.1.38"
   },
   "dependencies": {
-    "@pi-unipi/ask-user": "2.14.1",
-    "@pi-unipi/background-tasks": "2.14.1",
-    "@pi-unipi/btw": "2.14.1",
-    "@pi-unipi/command-enchantment": "2.14.1",
-    "@pi-unipi/compactor": "2.14.1",
-    "@pi-unipi/core": "2.14.1",
-    "@pi-unipi/footer": "2.14.1",
-    "@pi-unipi/image": "2.14.1",
-    "@pi-unipi/info-screen": "2.14.1",
-    "@pi-unipi/input-shortcuts": "2.14.1",
-    "@pi-unipi/kanboard": "2.14.1",
-    "@pi-unipi/mcp": "2.14.1",
-    "@pi-unipi/memory": "2.14.1",
-    "@pi-unipi/milestone": "2.14.1",
-    "@pi-unipi/notify": "2.14.1",
-    "@pi-unipi/ralph": "2.14.1",
-    "@pi-unipi/subagents": "2.14.1",
-    "@pi-unipi/trajectory": "2.14.1",
-    "@pi-unipi/updater": "2.14.1",
-    "@pi-unipi/utility": "2.14.1",
-    "@pi-unipi/web-api": "2.14.1",
-    "@pi-unipi/workflow": "2.14.1"
+    "@pi-unipi/ask-user": "2.15.0",
+    "@pi-unipi/background-tasks": "2.15.0",
+    "@pi-unipi/btw": "2.15.0",
+    "@pi-unipi/command-enchantment": "2.15.0",
+    "@pi-unipi/compactor": "2.15.0",
+    "@pi-unipi/core": "2.15.0",
+    "@pi-unipi/footer": "2.15.0",
+    "@pi-unipi/image": "2.15.0",
+    "@pi-unipi/info-screen": "2.15.0",
+    "@pi-unipi/input-shortcuts": "2.15.0",
+    "@pi-unipi/kanboard": "2.15.0",
+    "@pi-unipi/mcp": "2.15.0",
+    "@pi-unipi/memory": "2.15.0",
+    "@pi-unipi/milestone": "2.15.0",
+    "@pi-unipi/notify": "2.15.0",
+    "@pi-unipi/ralph": "2.15.0",
+    "@pi-unipi/subagents": "2.15.0",
+    "@pi-unipi/trajectory": "2.15.0",
+    "@pi-unipi/updater": "2.15.0",
+    "@pi-unipi/utility": "2.15.0",
+    "@pi-unipi/web-api": "2.15.0",
+    "@pi-unipi/workflow": "2.15.0"
   },
   "devDependencies": {
     "@earendil-works/pi-agent-core": "^0.84.0",

package/packages/ask-user/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pi-unipi/ask-user",
-  "version": "2.14.1",
-  "description": "Structured user input tool for Pi coding agent \u2014 single-select, multi-select, freeform",
+  "version": "2.15.0",
+  "description": "Structured user input tool for Pi coding agent — single-select, multi-select, freeform",
   "type": "module",
   "main": "index.ts",
   "license": "MIT",
@@ -40,7 +40,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.14.1"
+    "@pi-unipi/core": "2.15.0"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.84.0",

package/packages/autocomplete/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/command-enchantment",
-  "version": "2.14.1",
+  "version": "2.15.0",
   "description": "Enhanced TUI autocomplete for /unipi:* commands — colored, sorted, and grouped by package",
   "type": "module",
   "main": "src/index.ts",

package/packages/background-tasks/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pi-unipi/background-tasks",
-  "version": "2.14.1",
-  "description": "Background tasks for UniPi \u2014 durable shell jobs, delegated agents, attested Pi runs, and fixed-purpose Fusion workflows",
+  "version": "2.15.0",
+  "description": "Background tasks for UniPi — durable shell jobs, delegated agents, attested Pi runs, and fixed-purpose Fusion workflows",
   "type": "module",
   "main": "src/index.ts",
   "types": "src/index.ts",
@@ -10,7 +10,7 @@
   },
   "dependencies": {
     "@earendil-works/pi-ai": "^0.84.0",
-    "@pi-unipi/core": "2.14.1",
+    "@pi-unipi/core": "2.15.0",
     "turndown": "^7.2.4"
   },
   "devDependencies": {

package/packages/btw/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pi-unipi/btw",
-  "version": "2.14.1",
-  "description": "A pi extension for parallel side conversations with /unipi:btw \u2014 part of the Unipi suite",
+  "version": "2.15.0",
+  "description": "A pi extension for parallel side conversations with /unipi:btw — part of the Unipi suite",
   "type": "module",
   "main": "extensions/btw.ts",
   "license": "MIT",
@@ -37,7 +37,7 @@
     "@earendil-works/pi-tui": "^0.84.0"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.14.1"
+    "@pi-unipi/core": "2.15.0"
   },
   "pi": {
     "extensions": [

package/packages/compactor/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pi-unipi/compactor",
-  "version": "2.14.1",
-  "description": "Context engine for Pi \u2014 zero-LLM compaction, session continuity, sandbox execution, and tool display optimization",
+  "version": "2.15.0",
+  "description": "Context engine for Pi — zero-LLM compaction, session continuity, sandbox execution, and tool display optimization",
   "type": "module",
   "main": "src/index.ts",
   "license": "MIT",
@@ -34,8 +34,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.14.1",
-    "@pi-unipi/info-screen": "2.14.1",
+    "@pi-unipi/core": "2.15.0",
+    "@pi-unipi/info-screen": "2.15.0",
     "@earendil-works/pi-agent-core": "^0.84.0"
   },
   "peerDependencies": {

package/packages/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/core",
-  "version": "2.14.1",
+  "version": "2.15.0",
   "description": "Shared utilities, event types, and constants for Unipi extension suite",
   "type": "module",
   "license": "MIT",

package/packages/footer/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pi-unipi/footer",
-  "version": "2.14.1",
-  "description": "Persistent status bar for Unipi \u2014 subscribes to UNIPI_EVENTS and renders key stats from all unipi packages",
+  "version": "2.15.0",
+  "description": "Persistent status bar for Unipi — subscribes to UNIPI_EVENTS and renders key stats from all unipi packages",
   "type": "module",
   "main": "index.ts",
   "license": "MIT",
@@ -32,8 +32,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.14.1",
-    "@pi-unipi/background-tasks": "2.14.1"
+    "@pi-unipi/core": "2.15.0",
+    "@pi-unipi/background-tasks": "2.15.0"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.84.0",

package/packages/footer/src/glance-editor.ts

@@ -63,6 +63,24 @@ function repeat(s: string, n: number): string {
 	return s.repeat(Math.max(0, n));
 }
 
+/**
+ * Frame width for a terminal of `terminalWidth` columns: one column SHORT of
+ * the terminal (legacy 8-column floor preserved below 9 columns).
+ *
+ * Issue #31 invariant — the frame is repainted every second and pi-tui joins
+ * the rewritten lines with "\r\n". A line at EXACTLY the terminal width hits
+ * the auto-wrap threshold: on terminals that wrap immediately (and whenever
+ * a glyph renders wider than visibleWidth() assumed) the cursor silently
+ * advances one extra row per line, desyncing the differential renderer —
+ * every refresh then paints a fresh frame copy one block lower until the
+ * screen fills. Never writing the last column keeps every frame line below
+ * the wrap threshold on every terminal.
+ */
+export function glanceFrameWidth(terminalWidth: number): number {
+	if (!Number.isFinite(terminalWidth)) return 8;
+	return Math.max(8, terminalWidth - 1);
+}
+
 function padLine(line: string, width: number): string {
 	const w = visibleWidth(line);
 	if (w === width) return line;
@@ -160,7 +178,8 @@ export class GlanceEditor extends CustomEditor {
 	}
 
 	override render(width: number): string[] {
-		const safe = Math.max(8, width);
+		// One column short of the terminal — see glanceFrameWidth() / issue #31.
+		const safe = glanceFrameWidth(width);
 		const inner = Math.max(0, safe - 2);
 
 		// Base render at inner width: harvest content rows only (rules dropped).

package/packages/footer/src/index.ts

@@ -354,8 +354,11 @@ function setupFooterUI(pi: ExtensionAPI, ctx: ExtensionContext, state: FooterSta
         // Hard safety net: never return a line wider than the terminal.
         // This catches any edge cases in layout math or visibleWidth()
         // inconsistencies with PUA characters + ANSI codes.
+        // Cap at width - 1 (issue #31): a line at EXACTLY the terminal width
+        // trips immediate-wrap terminals and desyncs the diff renderer.
         const line = layout.topContent;
-        return [visibleWidth(line) > width ? truncateToWidth(line, width) : line];
+        const cap = Math.max(1, width - 1);
+        return [visibleWidth(line) > cap ? truncateToWidth(line, cap) : line];
       },
     };
   }, { placement: "aboveEditor" });
@@ -373,7 +376,9 @@ function setupFooterUI(pi: ExtensionAPI, ctx: ExtensionContext, state: FooterSta
         if (!strip) return [];
         // Centered under the input box.
         const w = visibleWidth(strip);
-        if (w >= width) return [truncateToWidth(strip, width)];
+        // Truncate one column short of the terminal (issue #31 — same wrap
+        // desync as the glance frame; see glanceFrameWidth()).
+        if (w >= width) return [truncateToWidth(strip, Math.max(1, width - 1))];
         const leftPad = Math.floor((width - w) / 2);
         return [" ".repeat(leftPad) + strip];
       },

package/packages/footer/src/process-line.ts

@@ -55,7 +55,9 @@ export function countBgProcesses(): BgProcessCounts | null {
  * Returns [] when there is nothing to show.
  */
 export function renderProcessLine(width: number): string[] {
-  if (width <= 0) return [];
+  // One column can never host a meaningful one-liner, and any content would
+  // be exactly-full-width (issue #31 wrap desync) — render nothing.
+  if (width <= 1) return [];
   const counts = countBgProcesses();
   if (!counts) return [];
 
@@ -68,7 +70,9 @@ export function renderProcessLine(width: number): string[] {
 
   const line = parts.join("  ");
   const w = visibleWidth(line);
-  if (w >= width) return [truncateToWidth(line, width)];
+  // One column short of the terminal (issue #31 — same wrap desync as the
+  // glance frame; see glanceFrameWidth() in glance-editor.ts).
+  if (w >= width) return [truncateToWidth(line, Math.max(1, width - 1))];
   const leftPad = Math.floor((width - w) / 2);
   return [" ".repeat(leftPad) + line];
 }

package/packages/image/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/image",
-  "version": "2.14.1",
+  "version": "2.15.0",
   "description": "Image generation and image recognition tools for the Pi coding agent",
   "type": "module",
   "main": "src/index.ts",
@@ -34,7 +34,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.14.1"
+    "@pi-unipi/core": "2.15.0"
   },
   "peerDependencies": {
     "@earendil-works/pi-ai": "^0.84.0",

package/packages/info-screen/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pi-unipi/info-screen",
-  "version": "2.14.1",
-  "description": "Dashboard and module registry for Unipi \u2014 configurable info overlay with tabbed groups",
+  "version": "2.15.0",
+  "description": "Dashboard and module registry for Unipi — configurable info overlay with tabbed groups",
   "type": "module",
   "main": "index.ts",
   "license": "MIT",
@@ -33,7 +33,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.14.1"
+    "@pi-unipi/core": "2.15.0"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.84.0",

package/packages/input-shortcuts/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pi-unipi/input-shortcuts",
-  "version": "2.14.1",
-  "description": "Keyboard shortcuts for stash/restore, undo/redo, clipboard, and thinking toggle \u2014 chord-based overlay system",
+  "version": "2.15.0",
+  "description": "Keyboard shortcuts for stash/restore, undo/redo, clipboard, and thinking toggle — chord-based overlay system",
   "type": "module",
   "main": "src/index.ts",
   "license": "MIT",
@@ -33,7 +33,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.14.1"
+    "@pi-unipi/core": "2.15.0"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.84.0",

package/packages/kanboard/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pi-unipi/kanboard",
-  "version": "2.14.1",
-  "description": "Visualization layer for unipi workflow \u2014 HTTP server with htmx/Alpine.js UI, modular parsers, TUI overlay, and kanban board",
+  "version": "2.15.0",
+  "description": "Visualization layer for unipi workflow — HTTP server with htmx/Alpine.js UI, modular parsers, TUI overlay, and kanban board",
   "type": "module",
   "main": "index.ts",
   "license": "MIT",
@@ -39,7 +39,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.14.1"
+    "@pi-unipi/core": "2.15.0"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.84.0",

package/packages/mcp/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pi-unipi/mcp",
-  "version": "2.14.1",
-  "description": "MCP server management extension for Pi coding agent \u2014 browse, add, configure, and use MCP servers",
+  "version": "2.15.0",
+  "description": "MCP server management extension for Pi coding agent — browse, add, configure, and use MCP servers",
   "type": "module",
   "main": "src/index.ts",
   "license": "MIT",
@@ -30,7 +30,7 @@
     "test": "npx tsx --test tests/**/*.test.ts"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.14.1"
+    "@pi-unipi/core": "2.15.0"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.84.0",

package/packages/memory/index.ts

@@ -31,6 +31,7 @@ import {
 import { registerMemoryTools, MEMORY_TOOLS, GLOBAL_SEARCH_ALIAS } from "./tools.js";
 import { registerMemoryCommands } from "./commands.js";
 import { isEmbeddingReady, hasModelChanged } from "./settings.js";
+import { maybeAutoUpdateMempalace } from "./mempalace.js";
 
 /** Package version */
 const VERSION = getPackageVersion(dirname(fileURLToPath(import.meta.url)));
@@ -157,6 +158,22 @@ export default function (pi: ExtensionAPI) {
       projectStorage = null;
     }
 
+    // Keep the MemPalace backend current — TTL-gated (~daily) background
+    // check; upgrades via uv only when a newer release exists. Never blocks
+    // startup and never throws into the session path.
+    if (projectStorage?.isMempalace()) {
+      void maybeAutoUpdateMempalace()
+        .then((outcome) => {
+          if (outcome.updated) {
+            emitEvent(pi, UNIPI_EVENTS.UPDATE_APPLIED, {
+              previousVersion: outcome.currentVersion ?? "",
+              newVersion: outcome.latestVersion ?? "",
+            });
+          }
+        })
+        .catch(() => {});
+    }
+
 
     // Announce module
     emitEvent(pi, UNIPI_EVENTS.MODULE_READY, {

package/packages/memory/mempalace.ts

@@ -18,6 +18,7 @@ import * as fs from "node:fs";
 import * as path from "node:path";
 import * as os from "node:os";
 import { fileURLToPath } from "node:url";
+import { loadEmbeddingConfig } from "./settings.js";
 
 /** Default MemPalace palace path. */
 export const DEFAULT_PALACE = path.join(os.homedir(), ".mempalace", "palace");
@@ -458,3 +459,187 @@ export function runBridgeAsync<T = unknown>(
 export function ping(install: MempalaceInstall, palace: string): boolean {
   return runBridge<string>(install, palace, "ping") === "pong";
 }
+
+// ── Auto-update (TTL-gated PyPI check + `uv tool upgrade`) ────────────────
+
+/** Update check state file — records the last check so we hit PyPI ~daily. */
+const UPDATE_FLAG = path.join(os.homedir(), ".unipi", "memory", ".mempalace-update");
+export const UPDATE_CHECK_TTL_MS = 24 * 60 * 60 * 1000; // 24h
+const PYPI_URL = "https://pypi.org/pypi/mempalace/json";
+
+export interface MempalaceUpdateState {
+  checkedAt: number;
+  latestVersion: string;
+}
+
+export interface MempalaceUpdateOutcome {
+  checked: boolean;
+  updated: boolean;
+  currentVersion?: string;
+  latestVersion?: string;
+  reason?: "disabled" | "not-installed" | "recent" | "lookup-failed" | "up-to-date" | "uv-missing" | "upgrade-failed";
+}
+
+/** Read the cached update-check state (null when missing/corrupt). */
+export function readUpdateState(flagPath = UPDATE_FLAG): MempalaceUpdateState | null {
+  try {
+    const parsed = JSON.parse(fs.readFileSync(flagPath, "utf-8")) as MempalaceUpdateState;
+    if (typeof parsed?.checkedAt !== "number" || typeof parsed?.latestVersion !== "string") return null;
+    return parsed;
+  } catch {
+    return null;
+  }
+}
+
+/** Persist the update-check state atomically. */
+export function writeUpdateState(state: MempalaceUpdateState, flagPath = UPDATE_FLAG): void {
+  try {
+    fs.mkdirSync(path.dirname(flagPath), { recursive: true });
+    const temp = `${flagPath}.${process.pid}.tmp`;
+    fs.writeFileSync(temp, JSON.stringify(state, null, 2), "utf-8");
+    fs.renameSync(temp, flagPath);
+  } catch { /* ignore */ }
+}
+
+/** Is a PyPI lookup due? (no state yet, or the TTL has elapsed) */
+export function isUpdateCheckDue(
+  flagPath = UPDATE_FLAG,
+  now = Date.now(),
+  ttlMs = UPDATE_CHECK_TTL_MS,
+): boolean {
+  const state = readUpdateState(flagPath);
+  if (!state) return true;
+  return now - state.checkedAt >= ttlMs;
+}
+
+/** Numeric dotted-version compare: >0 if a is newer, <0 if older, 0 if equal. */
+export function compareVersions(a: string, b: string): number {
+  const pa = String(a ?? "").trim().split(".");
+  const pb = String(b ?? "").trim().split(".");
+  const len = Math.max(pa.length, pb.length);
+  for (let i = 0; i < len; i++) {
+    const na = Number.parseInt(pa[i] ?? "0", 10) || 0;
+    const nb = Number.parseInt(pb[i] ?? "0") || 0;
+    if (na !== nb) return na - nb;
+  }
+  return 0;
+}
+
+/** Latest MemPalace version on PyPI, or null on any failure. */
+export async function fetchLatestMempalaceVersion(
+  fetchImpl: typeof fetch = fetch,
+): Promise<string | null> {
+  try {
+    const res = await fetchImpl(PYPI_URL, { signal: AbortSignal.timeout(8_000) });
+    if (!res.ok) return null;
+    const body = (await res.json()) as { info?: { version?: string } };
+    return typeof body?.info?.version === "string" ? body.info.version : null;
+  } catch {
+    return null;
+  }
+}
+
+/** Is the opt-in MemPalace daemon currently running? */
+function daemonRunning(): boolean {
+  try {
+    const res = spawnSync("mempalace", ["daemon", "status"], { encoding: "utf-8", timeout: 10_000 });
+    return /is running/i.test(res.stdout || "");
+  } catch {
+    return false;
+  }
+}
+
+/** Fire-and-forget process run; resolves null on spawn failure or non-zero exit. */
+function runProcess(bin: string, args: string[], timeoutMs: number): Promise<boolean> {
+  return new Promise((resolve) => {
+    let child;
+    try {
+      child = spawn(bin, args, { stdio: ["ignore", "ignore", "ignore"] });
+    } catch {
+      resolve(false);
+      return;
+    }
+    let settled = false;
+    const finish = (ok: boolean) => {
+      if (settled) return;
+      settled = true;
+      clearTimeout(timer);
+      resolve(ok);
+    };
+    const timer = setTimeout(() => {
+      try { child.kill(); } catch { /* already gone */ }
+      finish(false);
+    }, timeoutMs);
+    timer.unref?.();
+    child.on("error", () => finish(false));
+    child.on("close", (code) => finish(code === 0));
+  });
+}
+
+/**
+ * Upgrade MemPalace via `uv tool install --upgrade`. The daemon (if running)
+ * is stopped first and restarted after, so the long-lived process picks up
+ * the new venv instead of straddling versions.
+ */
+async function upgradeMempalace(): Promise<boolean> {
+  if (!which("uv")) return false;
+  const wasRunning = daemonRunning();
+  if (wasRunning) await runProcess("mempalace", ["daemon", "stop"], 30_000);
+  const upgraded = await runProcess("uv", ["tool", "upgrade", "mempalace"], 300_000);
+  if (wasRunning) await runProcess("mempalace", ["daemon", "start"], 30_000);
+  return upgraded;
+}
+
+export interface MempalaceUpdateOptions {
+  /** Skip the TTL gate and force a PyPI lookup. */
+  force?: boolean;
+  /** Injectable fetch for tests. */
+  fetchImpl?: typeof fetch;
+  /** Override "now" for TTL math (tests). */
+  now?: number;
+}
+
+/**
+ * Keep the user's MemPalace install current.
+ *
+ * TTL-gated (~daily) PyPI lookup; when a newer release exists and the install
+ * came from uv, runs `uv tool upgrade mempalace` in the background. Never
+ * throws — callers fire-and-forget this from session_start.
+ */
+export async function maybeAutoUpdateMempalace(
+  options: MempalaceUpdateOptions = {},
+): Promise<MempalaceUpdateOutcome> {
+  const now = options.now ?? Date.now();
+  if (loadEmbeddingConfig().mempalaceAutoUpdate === false) {
+    return { checked: false, updated: false, reason: "disabled" };
+  }
+  const install = readCachedInstall();
+  if (!install) return { checked: false, updated: false, reason: "not-installed" };
+
+  if (!options.force && !isUpdateCheckDue(UPDATE_FLAG, now, UPDATE_CHECK_TTL_MS)) {
+    return { checked: false, updated: false, reason: "recent" };
+  }
+
+  const latest = await fetchLatestMempalaceVersion(options.fetchImpl).catch(() => null);
+  const previous = readUpdateState()?.latestVersion ?? "";
+  writeUpdateState({ checkedAt: now, latestVersion: latest ?? previous });
+  if (!latest) {
+    return { checked: true, updated: false, currentVersion: install.version, reason: "lookup-failed" };
+  }
+
+  const current = detectVersion(install.python);
+  if (compareVersions(latest, current) <= 0) {
+    return { checked: true, updated: false, currentVersion: current, latestVersion: latest, reason: "up-to-date" };
+  }
+
+  const upgraded = await upgradeMempalace();
+  if (!upgraded) {
+    return { checked: true, updated: false, currentVersion: current, latestVersion: latest, reason: "upgrade-failed" };
+  }
+
+  // Refresh the cached install record so the new version is used next bridge call.
+  const python = findVenvPython();
+  if (python) writeCachedInstall({ python, version: detectVersion(python) });
+  invalidatePingVerified();
+  return { checked: true, updated: true, currentVersion: current, latestVersion: latest };
+}

package/packages/memory/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/memory",
-  "version": "2.14.1",
+  "version": "2.15.0",
   "description": "Persistent cross-session memory with MemPalace backend (auto-installed) and SQLite fallback for Pi coding agent",
   "type": "module",
   "main": "index.ts",
@@ -39,8 +39,8 @@
     "README.md"
   ],
   "dependencies": {
-    "@pi-unipi/core": "2.14.1",
-    "@pi-unipi/info-screen": "2.14.1",
+    "@pi-unipi/core": "2.15.0",
+    "@pi-unipi/info-screen": "2.15.0",
     "js-yaml": "^4.1.0"
   },
   "peerDependencies": {

package/packages/memory/settings.ts

@@ -26,6 +26,8 @@ export interface EmbeddingConfig {
   lastModel?: string;
   /** Whether to show migration warning on startup */
   suppressMigrationWarning?: boolean;
+  /** Keep the MemPalace backend current via a daily PyPI check + uv upgrade */
+  mempalaceAutoUpdate?: boolean;
 }
 
 /** Default configuration */
@@ -34,6 +36,7 @@ const DEFAULT_CONFIG: EmbeddingConfig = {
   model: "openai/text-embedding-3-small",
   dimensions: 384,
   suppressMigrationWarning: false,
+  mempalaceAutoUpdate: true,
 };
 
 /** Known embedding models on OpenRouter */