@pi-unipi/unipi 2.20.3 → 2.20.5

package/CHANGELOG.md

@@ -6,6 +6,27 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+## [2.20.5] — 2026-09-19
+
+### Fixed
+
+- `memory`: **MemPalace init no longer blocks startup by ~8–9s, and its migration finally converges.** `MemoryStorage.init()` ran the palace `ping` and the full `migrate` synchronously inside the memory `session_start` handler; whenever the source fingerprint had changed (i.e. after almost any memory write) the migrate re-embedded every changed record and, when a MemPalace daemon held the per-palace mine lock, every contended upsert raised `MineAlreadyRunning`, was counted as a hard `failed`, and the completion marker (`failed===0`) never advanced — so the whole ~8s sweep re-ran on every boot. Time-to-first-input dropped from ~9.5s to ~1s. The fix spans several layers:
+  - **Non-blocking init.** `init()` now does only the cheap install check and marks the backend active optimistically; `ping` + migration/catch-up run in a single-flight background task via `runBridgeAsync` (the spawned child is `unref()`d so a fire-and-forget migrate never keeps the process alive). `session_start` no longer awaits the bridge.
+  - **Contention-aware convergence.** The Python bridge now classifies `MineAlreadyRunning` as `deferred` (with `deferred_keys`), distinct from a genuine `failed`, and accepts an `only:[keys]` targeted pass. `markMigrated` advances when `failed===0 && verified+deferred===discovered`, persisting the deferred keys with an exponential backoff (15m → 1h → 6h → 24h) so later sessions retry just those keys instead of re-sweeping. `deferred` (lock) is kept strictly separate from `failed` (malformed) so the marker never advances over lost data.
+  - **Record-level ledger.** A new `~/.unipi/memory/.mempalace-ledger.json` maps `project/id` → sha256 of the exact markdown bytes last confirmed in the palace, replacing the size+mtime fingerprint that a normal `store()` invalidated on every write. Catch-up now migrates only records whose bytes differ from the ledger (plus due-for-retry deferred keys), `store()` records the ledger only on a confirmed upsert, and an existing `.mempalace-migrated` marker is used once to seed the ledger. The bridge stops discovering legacy `memory.db` (the SQLite tier is gone), so the corpus matches the ledger scanner exactly.
+  - **Daemon-aware catch-up.** `probeDaemon()` reads the palace daemon's `endpoint.json` + token and checks `/health`; when a daemon is reachable and actively mining, the background catch-up stands down for the session and lets the backoff ride out the lock instead of contending. When no daemon is running, behaviour is unchanged. (Writes are deliberately not routed through the daemon `/jobs` queue: it exposes no idempotent record-upsert job, and its generic write path uses a content-addressed drawer id incompatible with the bridge's source-URI id.)
+  - **Ping-cache hygiene.** Bridge calls now distinguish a successful `null` result and transient lock contention from real backend errors (`runBridgeOutcome`/`isTransientBridgeError`), so `.mempalace-ping-verified` is only invalidated on a genuine failure instead of on nearly every session.
+
+## [2.20.4] — 2026-09-19
+
+### Changed
+
+- `fusion`: **the `/unipi:model` picker name column now grows with the terminal.** `NAME_COL` was a fixed 24 columns, so every name past 23 characters was ellipsized even on a wide terminal and the thinking-effort control sat close to the name. `packages/fusion/src/picker.ts` now computes the column per render from the widest row label (`NAME_COL_MIN = 24`, capped to the available width) and keeps the effort bar right-anchored, so full names fit before the effort control.
+
+### Fixed
+
+- `fusion`: **model rows that look like a `provider/id` key are no longer ambiguous.** Rows label with `model.name || model.id` and never showed the provider, so an OpenRouter model named `deepseek/deepseek-v4.1-flash` was indistinguishable from a model actually served by provider `deepseek`. A dim `provider · ` prefix is now added only when the display name contains `/` or the same name is offered by more than one provider; the prefix is never truncated (the friendly name truncates instead). The highlighted row's price panel now spells out the exact registry key (`Model key  openrouter/deepseek/deepseek-v4.1-flash`, both lead and sidekick keys on the Fusion row).
+
 ## [2.20.3] — 2026-09-17
 
 ### Fixed

package/package.json

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

package/packages/ask-user/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/ask-user",
-  "version": "2.20.3",
+  "version": "2.20.5",
   "description": "Structured user input tool for Pi coding agent — single-select, multi-select, freeform",
   "type": "module",
   "main": "index.ts",
@@ -40,7 +40,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.20.3"
+    "@pi-unipi/core": "2.20.5"
   },
   "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.20.3",
+  "version": "2.20.5",
   "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,6 +1,6 @@
 {
   "name": "@pi-unipi/background-tasks",
-  "version": "2.20.3",
+  "version": "2.20.5",
   "description": "Background tasks for UniPi — durable shell jobs and delegated background agents with a footer dock",
   "type": "module",
   "main": "src/index.ts",
@@ -10,7 +10,7 @@
   },
   "dependencies": {
     "@earendil-works/pi-ai": "^0.84.0",
-    "@pi-unipi/core": "2.20.3",
+    "@pi-unipi/core": "2.20.5",
     "turndown": "^7.2.4"
   },
   "devDependencies": {

package/packages/btw/package.json

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

package/packages/compactor/package.json

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

package/packages/core/package.json

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

package/packages/footer/package.json

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

package/packages/fusion/README.md

@@ -10,10 +10,9 @@ pi's extension and RPC APIs natively.
 ╭ Model ───────────────────────────────────────────────────────────────╮
 │/ Type to search                                                       │
 │───────────────────────────────────────────────────────────────────────│
-│❭ Fusion                  ← ▰▰▰▱▱ → Medium     Lead Claude Fable… ▾    │
-│· GLM-5.3 Flash ✱        ▰▰▰▰▰   Max                              │
-│· Claude Fable 5.1       ▰▰▰▱▱   Medium                           │
-│· DeepSeek V4.1 Flash ✱  ▰▱▱▱▱   High                             │
+│❭ Fusion                              ← ▰▰▰▱▱ → Medium  Lead Fable… ▾ │
+│· GLM-5.3 Flash ✱                        ▰▰▰▰▰   Max                │
+│· openrouter · deepseek/deepseek-v4.1-flash ▰▰▱▱▱   High              │
 │  ↓ more below                                                        │
 │                                                                       │
 │  ━━━━━●━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━               │
@@ -21,6 +20,7 @@ pi's extension and RPC APIs natively.
 │  $10 / 1M   $0.25 / 1M     $50 / 1M   $0.2 / 1M                     │
 │  Sidekick cached input   Sidekick output                             │
 │  $0.02 / 1M              $1.2 / 1M                                   │
+│  Model key  openrouter/deepseek/deepseek-v4.1-flash                  │
 │                                                                       │
 │  ✱ New  ✱ Promotion  ✱ Beta · Pairs frontier intelligence with cost-efficient execution │
 │↑↓ select · tab lead · ←→ effort · ↵ confirm · esc cancel              │
@@ -44,7 +44,16 @@ pi's extension and RPC APIs natively.
 - **Price panel**: the highlighted model's blended price is marked on a
   logarithmic red→orange→yellow→green→cyan→blue→violet slider. Fusion shows
   `Input`, `Cached input`, `Output`, `Sidekick input`, `Sidekick cached input`,
-  and `Sidekick output`.
+  and `Sidekick output`, and the exact registry key of the highlighted row is
+  spelled out (`Model key  openrouter/deepseek/deepseek-v4.1-flash`; both the
+  lead and sidekick keys on the Fusion row).
+- **Name column & provider**: the name column sizes itself to the widest row
+  label (minimum 24 columns) up to the terminal width, and the effort control
+  stays right-anchored — so wide terminals show full names. A row only gets a
+  dim `provider · ` prefix when its display name is ambiguous: it contains a
+  `/` (`deepseek/deepseek-v4.1-flash` reads like a key) or the same friendly
+  name is offered by more than one provider. Unique names stay clean, and the
+  prefix is never truncated.
 - **Confirm** applies: `pi.setModel`, `pi.setThinkingLevel(effort)`, updates
   MRU + persisted active selection, and shows `Fusion · Lead ◆ Sidekick` in
   the footer. Switching the model through pi's own `/model`/Ctrl+P drops

package/packages/fusion/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/fusion",
-  "version": "2.20.3",
+  "version": "2.20.5",
   "description": "Devin-style model picker, fusion presets (lead + sidekick), and Local Fusion runtime for UniPi",
   "type": "module",
   "main": "src/index.ts",
@@ -32,8 +32,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.20.3",
-    "@pi-unipi/subagents": "2.20.3"
+    "@pi-unipi/core": "2.20.5",
+    "@pi-unipi/subagents": "2.20.5"
   },
   "peerDependencies": {
     "@earendil-works/pi-ai": "^0.84.0",

package/packages/fusion/src/picker.ts

@@ -109,9 +109,39 @@ type Row = { kind: "fusion" } | { kind: "model"; key: ModelKey };
 type FusionFocus = "effort" | "lead" | "sidekick";
 
 const DEFAULT_VISIBLE_ROWS = 10;
-const NAME_COL = 24;
+/** Minimum width of the name column (the pre-autosize default). */
+const NAME_COL_MIN = 24;
 const MARKER_COL = 2;
 const BAR_SEGMENTS = 5;
+/** Visible columns outside the name: pointer + marker prefix (4) + effort block (19). */
+const FIXED_COLS = 23;
+
+/**
+ * A model needs a provider prefix when its display name alone is ambiguous:
+ * it contains a "/" (so it reads like a `provider/id` key), or the same name
+ * is offered by more than one provider.
+ */
+function ambiguousNamesOf(models: readonly PickerModel[]): Set<string> {
+  const providersByName = new Map<string, Set<string>>();
+  for (const m of models) {
+    const set = providersByName.get(m.name) ?? new Set<string>();
+    set.add(m.provider);
+    providersByName.set(m.name, set);
+  }
+  const out = new Set<string>();
+  for (const [name, set] of providersByName) {
+    if (set.size > 1) out.add(name);
+  }
+  return out;
+}
+
+function needsProvider(m: PickerModel, ambiguous: ReadonlySet<string>): boolean {
+  return m.name.includes("/") || ambiguous.has(m.name);
+}
+
+function labelOf(m: PickerModel, ambiguous: ReadonlySet<string>): string {
+  return needsProvider(m, ambiguous) ? `${m.provider} \u00b7 ${m.name}` : m.name;
+}
 
 function printable(data: string): string | undefined {
   if (data.length !== 1) return undefined;
@@ -146,6 +176,9 @@ export class ModelPicker {
   private readonly modelsByKey: Map<ModelKey, PickerModel>;
   private readonly state: PickerState;
   private readonly priceRange: { min: number; max: number };
+  private readonly ambiguousNames: Set<string>;
+  /** Name column sized to the widest row label; capped to the available width at render time. */
+  private readonly naturalNameCol: number;
 
   private effort: Record<ModelKey, EffortLevel>;
   /** Fusion-row efforts — deliberately NOT stored in the per-model map. */
@@ -166,6 +199,12 @@ export class ModelPicker {
     this.onRenderRequest = options.onRenderRequest;
     this.visibleRows = options.visibleRows ?? DEFAULT_VISIBLE_ROWS;
     this.modelsByKey = new Map(options.state.models.map((m) => [m.key, m]));
+    this.ambiguousNames = ambiguousNamesOf(options.state.models);
+    const widestLabel = options.state.models.reduce(
+      (max, m) => Math.max(max, visibleWidth(labelOf(m, this.ambiguousNames))),
+      0,
+    );
+    this.naturalNameCol = Math.max(NAME_COL_MIN, widestLabel + 2);
     const prices = options.state.models.map((m) => (hasPricing(m.cost) ? blendedPrice(m.cost) : undefined)).filter((p): p is number => p !== undefined && p > 0);
     this.priceRange = { min: prices.length > 0 ? Math.min(...prices) : 0, max: prices.length > 0 ? Math.max(...prices) : 0 };
     this.effort = { ...options.state.effort };
@@ -416,7 +455,11 @@ export class ModelPicker {
     return shortName(m?.name ?? key, max);
   }
 
-  private renderRow(row: Row, highlighted: boolean, width: number): string {
+  private isAmbiguous(model: PickerModel): boolean {
+    return needsProvider(model, this.ambiguousNames);
+  }
+
+  private renderRow(row: Row, highlighted: boolean, width: number, nameCol: number): string {
     const t = this.theme;
     const pointer = highlighted ? t.fg("accent", "❭") : t.fg("dim", "·");
     const disabledFusion = row.kind === "fusion" && !this.fusionAvailable();
@@ -429,8 +472,14 @@ export class ModelPicker {
           : " "
         : this.markerFor(row.key);
     const working = row.kind === "model" && row.key === this.state.currentModelKey;
-    const nameRaw = row.kind === "fusion" ? "Fusion" : this.nameOf(row.key, NAME_COL - 1);
-    const name =
+    const model = row.kind === "model" ? this.modelsByKey.get(row.key) : undefined;
+    // Only ambiguous rows (slash-y names, or names shared across providers) pay
+    // the width cost of a dim provider prefix. The name is truncated, never the
+    // prefix, so `openrouter · …` always survives.
+    const providerPrefix = model !== undefined && this.isAmbiguous(model) ? t.fg("dim", `${model.provider} · `) : "";
+    const nameBudget = Math.max(1, nameCol - visibleWidth(providerPrefix) - 1);
+    const nameRaw = row.kind === "fusion" ? "Fusion" : this.nameOf(row.key, nameBudget);
+    const styled =
       row.kind === "fusion"
         ? disabledFusion
           ? highlighted
@@ -444,7 +493,7 @@ export class ModelPicker {
           : highlighted
             ? t.fg("accent", nameRaw)
             : t.fg("text", nameRaw);
-    const model = row.kind === "model" ? this.modelsByKey.get(row.key) : undefined;
+    const name = `${providerPrefix}${styled}`;
     const badge = model?.badge;
     const badgeGlyph = badge === undefined ? "" : ` ${t.fg(badge === "new" ? "success" : badge === "promotion" ? "accent" : "warning", "✱")}`;
 
@@ -458,7 +507,7 @@ export class ModelPicker {
         ? t.fg("accent", effortLabel(level))
         : t.fg("muted", effortLabel(level));
 
-    let line = `${pointer} ${marker} ${pad(`${name}${badgeGlyph}`, NAME_COL)} ${left} ${this.bar(level, !disabledFusion && highlighted)} ${right} ${pad(label, 8)}`;
+    let line = `${pointer} ${marker} ${pad(`${name}${badgeGlyph}`, nameCol)} ${left} ${this.bar(level, !disabledFusion && highlighted)} ${right} ${pad(label, 8)}`;
 
     if (row.kind === "fusion") {
       if (disabledFusion) {
@@ -480,10 +529,10 @@ export class ModelPicker {
     return truncateToWidth(line, Math.max(1, width - 1));
   }
 
-  private renderDropdown(width: number): string[] {
+  private renderDropdown(width: number, nameCol: number): string[] {
     const t = this.theme;
     const items = this.dropdownItems();
-    const indent = " ".repeat(MARKER_COL + NAME_COL + 5);
+    const indent = " ".repeat(MARKER_COL + nameCol + 5);
     if (items.length === 0) {
       return [`${indent}${t.fg("warning", `no ${this.focus} models in preset — run /unipi:fusion-preset`)}`];
     }
@@ -547,7 +596,23 @@ export class ModelPicker {
       : !hasPricing(primaryCost);
     const pricing = !disabledFusion && noPricing ? t.fg("dim", " · no pricing data from provider") : "";
     const description = `${badges}${badges.length > 0 ? " " : ""}${desc}${pricing}`;
-    return [truncateToWidth(`  ${head}`, width - 1), truncateToWidth(`  ${vals}`, width - 1), truncateToWidth(`  ${description}`, width - 1)];
+    // The row label may be a friendly name; spell out the exact registry key so
+    // the highlighted model is unambiguous (`openrouter/deepseek/...`).
+    const keys = row.kind === "fusion"
+      ? [this.lead, this.sidekick].filter((k): k is ModelKey => k !== undefined)
+      : primaryKey === undefined
+        ? []
+        : [primaryKey];
+    const out = [
+      truncateToWidth(`  ${head}`, width - 1),
+      truncateToWidth(`  ${vals}`, width - 1),
+    ];
+    if (keys.length > 0) {
+      const keyText = keys.map((k) => t.fg("text", k)).join(t.fg("dim", " · "));
+      out.push(truncateToWidth(`  ${t.fg("dim", "Model key")}  ${keyText}`, width - 1));
+    }
+    out.push(truncateToWidth(`  ${description}`, width - 1));
+    return out;
   }
 
   private hintLine(row: Row | undefined): string {
@@ -572,6 +637,10 @@ export class ModelPicker {
   private renderBody(width: number): string[] {
     const t = this.theme;
     const rows = this.rows();
+    // Give the name column every spare column (the effort control stays
+    // right-anchored) but never less than the historical 24.
+    const maxNameCol = Math.max(NAME_COL_MIN, width - FIXED_COLS - 1);
+    const nameCol = Math.min(this.naturalNameCol, maxNameCol);
     if (this.selected >= rows.length) this.selected = Math.max(0, rows.length - 1);
     const row = rows[this.selected];
     const lines: string[] = [];
@@ -591,9 +660,9 @@ export class ModelPicker {
         const r = rows[i];
         if (r === undefined) continue;
         const highlighted = i === this.selected;
-        lines.push(this.renderRow(r, highlighted, width));
+        lines.push(this.renderRow(r, highlighted, width, nameCol));
         if (highlighted && r.kind === "fusion" && this.focus !== "effort") {
-          lines.push(...this.renderDropdown(width));
+          lines.push(...this.renderDropdown(width, nameCol));
         }
       }
       if (end < rows.length) lines.push(t.fg("dim", `  ↓ more below (${String(rows.length - end)})`));

package/packages/image/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/image",
-  "version": "2.20.3",
+  "version": "2.20.5",
   "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.20.3"
+    "@pi-unipi/core": "2.20.5"
   },
   "peerDependencies": {
     "@earendil-works/pi-ai": "^0.84.0",

package/packages/info-screen/package.json

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

package/packages/input-shortcuts/package.json

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

package/packages/kanboard/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/kanboard",
-  "version": "2.20.3",
+  "version": "2.20.5",
   "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",
@@ -39,7 +39,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@pi-unipi/core": "2.20.3"
+    "@pi-unipi/core": "2.20.5"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.84.0",

package/packages/mcp/package.json

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

package/packages/memory/README.md

@@ -2,7 +2,7 @@
 
 Persistent memory that survives across sessions. Stores facts, preferences, and decisions with semantic vector search, so the agent remembers what you told it last week.
 
-**Primary backend: [MemPalace](https://github.com/mempalace/mempalace)** — auto-installed via `uv` on first load, with verified, resumable migration of existing legacy memories. If MemPalace or `uv` is unavailable, the package transparently falls back to the bundled SQLite + sqlite-vec store, so memory never hard-fails.
+**Backend: [MemPalace](https://github.com/mempalace/mempalace)** — auto-installed via `uv` on first load, with verified, resumable, incremental migration of existing markdown memories. Detection, ping, and migration run off the startup path, so loading the package never blocks the first prompt.
 
 Two storage tiers: MemPalace (or SQLite) for vector similarity search, markdown files for a durable human-readable copy you can edit by hand. Project-scoped memories stay separate per codebase, global memories are accessible everywhere.
 
@@ -74,46 +74,56 @@ Examples:
 Memory has no configuration file. Storage paths are fixed:
 
 ```
-~/.unipi/memory/                 # UniPi memory root (legacy + markdown tier)
+~/.unipi/memory/                 # UniPi memory root (markdown tier)
 ├── .mempalace-install           # Cached MemPalace venv detection
-├── .mempalace-migrated          # Versioned migration verification state
+├── .mempalace-migrated          # Legacy migration marker (seeds the ledger once)
+├── .mempalace-ledger.json       # Record-level sync ledger (project/id -> content hash)
+├── .mempalace-ping-verified     # Recent-ping cache (skips the cold-start ping)
 ├── global/
-│   ├── memory.db              # Global vector DB (SQLite fallback)
-│   └── *.md                   # Global memory files
+│   └── *.md                   # Global memory files (durable, human-readable)
 └── <project_name>/
-    ├── memory.db              # Project vector DB (SQLite fallback)
-    └── *.md                   # Project memory files
+    └── *.md                   # Project memory files (durable, human-readable)
 
-~/.mempalace/palace/             # MemPalace palace (primary backend)
+~/.mempalace/palace/             # MemPalace palace (vector backend)
 ```
 
 ## MemPalace backend
 
-On first load, the memory package:
+MemPalace is the sole vector backend; the markdown files are the durable,
+human-readable tier and the migration source. On load, the memory package:
 1. Detects MemPalace; if missing and `uv` is available, runs
    `uv tool install mempalace` once (caches the venv python path in
    `~/.unipi/memory/.mempalace-install`).
-2. Pings the bridge to confirm the palace is usable.
-3. Fingerprints the durable SQLite and markdown sources. If they differ from
-   the verified state in `~/.unipi/memory/.mempalace-migrated`, performs an
-   idempotent read-only migration into MemPalace drawers. Unchanged drawers are
-   skipped, new or changed memories are upserted, and the versioned state is
-   written only after every discovered record is verified in MemPalace.
-   Failed or partial migrations remain unmarked and retry on a later session.
+2. Marks the backend active immediately, then does everything else
+   **off the startup path** so time-to-first-input is never blocked: a
+   background task pings the bridge (skipped when recently ping-verified) and
+   runs an incremental catch-up.
+3. Catch-up is driven by a record-level ledger
+   (`~/.unipi/memory/.mempalace-ledger.json`) mapping `project/id` to the
+   sha256 of the markdown bytes last confirmed in the palace. Only records whose
+   bytes differ from the ledger are upserted, so an ordinary write never
+   triggers a full re-scan. `store()` updates the ledger only after a confirmed
+   upsert; a pre-existing `.mempalace-migrated` marker seeds the ledger once.
    Legacy files are never deleted or mutated.
 
-Each memory operation invokes the packaged Python bridge
-(`bridge/mempalace_bridge.py`) once via `spawnSync` (~0.5s per call). Both the
-standalone memory package and the all-in-one umbrella tarball ship and resolve
-this bridge. The
-first MemPalace use on a machine also downloads the default ONNX embedding
-model (~80MB, cached at `~/.cache/chroma/onnx_models/`).
+Records contended by a running MemPalace daemon's mine lock are recorded as
+**deferred** (never as failures) and retried with exponential backoff, so the
+catch-up always converges instead of re-running every boot. When a daemon is
+reachable and actively mining, the background catch-up stands down for the
+session rather than fighting the lock.
+
+Memory operations invoke the packaged Python bridge
+(`bridge/mempalace_bridge.py`); startup-path work uses the async, non-blocking
+variant. Both the standalone memory package and the all-in-one umbrella tarball
+ship and resolve this bridge. The first MemPalace use on a machine also
+downloads the default ONNX embedding model (~80MB, cached at
+`~/.cache/chroma/onnx_models/`).
 
 ### Forcing re-detection / re-migration
 
 ```bash
 rm ~/.unipi/memory/.mempalace-install    # re-detect MemPalace next session
-rm ~/.unipi/memory/.mempalace-migrated   # force a full verified migration pass next session
+rm ~/.unipi/memory/.mempalace-ledger.json  # force a full verified catch-up pass next session
 ```
 
 ### Backend override