@pi-unipi/unipi 2.14.0 → 2.14.2

package/CHANGELOG.md

@@ -6,6 +6,24 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+## [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
+
+- `utility`: **skill startup discovery toggle** (`/unipi:skills-settings`, default on) — controls whether Unipi's built-in skills are cataloged in the agent's system prompt at startup. When off (`unipi.skills.discovery: false` in pi settings.json), Unipi's bundled skills are removed from the `<available_skills>` section every turn while user-owned skills (global, project, settings-mounted, third-party packages) stay cataloged; `/skill:name` invocation keeps working since pi expands those commands by reading SKILL.md directly from disk. Filtering is anchor-based (agentskills.io tags) and applied consistently per turn, preserving provider prefix cache.
+- `autocomplete`: registered `/unipi:skills-settings` in COMMAND_REGISTRY + COMMAND_DESCRIPTIONS so the command autosuggests.
+
+### Fixed
+
+- `info-screen`: **boot splash no longer eats keystrokes or strands the session** — the auto-close boot dashboard was a capturing overlay during its 2s window: typing during boot was swallowed (worse, its vim-style keys interpreted command text as tab switches), the first-keypress-cancels-auto-close rule left it on screen forever as an unclosable input-eating zombie, and prompts appeared to never send (the agent actually responded behind the overlay). The splash is now non-capturing (typing always reaches the editor) and dismisses itself via a stack-safe `handle.hide()` that only fires while it is the topmost visible overlay entry — if the user opens any dialog during the splash window (e.g. `/unipi:skills-settings`), dismissal defers until it closes, so the overlay can no longer be orphaned with a pending interaction (previously the covered overlay vanished while its `ctx.ui.select` promise hung forever). Interactive (`bootMode: "on"`) dashboards are unchanged; splash footer now reads "auto-dismissing…" instead of keyboard hints that could never reach it.
+
 ## [2.14.0] — 2026-08-29
 
 ### Changed

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/unipi",
-  "version": "2.14.0",
+  "version": "2.14.2",
   "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.0",
-    "@pi-unipi/background-tasks": "2.14.0",
-    "@pi-unipi/btw": "2.14.0",
-    "@pi-unipi/command-enchantment": "2.14.0",
-    "@pi-unipi/compactor": "2.14.0",
-    "@pi-unipi/core": "2.14.0",
-    "@pi-unipi/footer": "2.14.0",
-    "@pi-unipi/image": "2.14.0",
-    "@pi-unipi/info-screen": "2.14.0",
-    "@pi-unipi/input-shortcuts": "2.14.0",
-    "@pi-unipi/kanboard": "2.14.0",
-    "@pi-unipi/mcp": "2.14.0",
-    "@pi-unipi/memory": "2.14.0",
-    "@pi-unipi/milestone": "2.14.0",
-    "@pi-unipi/notify": "2.14.0",
-    "@pi-unipi/ralph": "2.14.0",
-    "@pi-unipi/subagents": "2.14.0",
-    "@pi-unipi/trajectory": "2.14.0",
-    "@pi-unipi/updater": "2.14.0",
-    "@pi-unipi/utility": "2.14.0",
-    "@pi-unipi/web-api": "2.14.0",
-    "@pi-unipi/workflow": "2.14.0"
+    "@pi-unipi/ask-user": "2.14.2",
+    "@pi-unipi/background-tasks": "2.14.2",
+    "@pi-unipi/btw": "2.14.2",
+    "@pi-unipi/command-enchantment": "2.14.2",
+    "@pi-unipi/compactor": "2.14.2",
+    "@pi-unipi/core": "2.14.2",
+    "@pi-unipi/footer": "2.14.2",
+    "@pi-unipi/image": "2.14.2",
+    "@pi-unipi/info-screen": "2.14.2",
+    "@pi-unipi/input-shortcuts": "2.14.2",
+    "@pi-unipi/kanboard": "2.14.2",
+    "@pi-unipi/mcp": "2.14.2",
+    "@pi-unipi/memory": "2.14.2",
+    "@pi-unipi/milestone": "2.14.2",
+    "@pi-unipi/notify": "2.14.2",
+    "@pi-unipi/ralph": "2.14.2",
+    "@pi-unipi/subagents": "2.14.2",
+    "@pi-unipi/trajectory": "2.14.2",
+    "@pi-unipi/updater": "2.14.2",
+    "@pi-unipi/utility": "2.14.2",
+    "@pi-unipi/web-api": "2.14.2",
+    "@pi-unipi/workflow": "2.14.2"
   },
   "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.14.0",
+  "version": "2.14.2",
   "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.14.0"
+    "@pi-unipi/core": "2.14.2"
   },
   "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.0",
+  "version": "2.14.2",
   "description": "Enhanced TUI autocomplete for /unipi:* commands — colored, sorted, and grouped by package",
   "type": "module",
   "main": "src/index.ts",

package/packages/autocomplete/src/constants.ts

@@ -131,6 +131,7 @@ export const COMMAND_REGISTRY: Record<string, string> = {
   "unipi:badge-toggle": "utility",
   "unipi:badge-settings": "utility",
   "unipi:util-settings": "utility",
+  "unipi:skills-settings": "utility",
 
   // ask-user (1 command)
   "unipi:ask-user-settings": "ask-user",
@@ -270,6 +271,7 @@ export const COMMAND_DESCRIPTIONS: Record<string, string> = {
   "unipi:badge-toggle": "Configure badge settings (autoGen, badgeEnabled, agentTool)",
   "unipi:badge-settings": "Configure badge settings via TUI overlay",
   "unipi:util-settings": "Unified settings — badge + diff rendering config",
+  "unipi:skills-settings": "Toggle skill startup discovery (skills catalog in system prompt)",
   "unipi:kanboard":        "Start the kanboard visualization server",
   "unipi:kanboard-doctor": "Diagnose and fix kanboard parser issues",
   "unipi:trajectory":      "Open/reuse trajectory; add stop/off or toggle to close it",

package/packages/background-tasks/package.json

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

package/packages/btw/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/btw",
-  "version": "2.14.0",
+  "version": "2.14.2",
   "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.14.0"
+    "@pi-unipi/core": "2.14.2"
   },
   "pi": {
     "extensions": [

package/packages/compactor/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/compactor",
-  "version": "2.14.0",
+  "version": "2.14.2",
   "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.14.0",
-    "@pi-unipi/info-screen": "2.14.0",
+    "@pi-unipi/core": "2.14.2",
+    "@pi-unipi/info-screen": "2.14.2",
     "@earendil-works/pi-agent-core": "^0.84.0"
   },
   "peerDependencies": {

package/packages/core/constants.ts

@@ -161,6 +161,7 @@ export const UTILITY_COMMANDS = {
   BADGE_SETTINGS: "badge-settings",
   UTIL_SETTINGS: "util-settings",
   PREFIX_CACHE: "prefix-cache",
+  SKILLS_SETTINGS: "skills-settings",
 } as const;
 
 /** Utility tool names */

package/packages/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/core",
-  "version": "2.14.0",
+  "version": "2.14.2",
   "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.14.0",
+  "version": "2.14.2",
   "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.14.0",
-    "@pi-unipi/background-tasks": "2.14.0"
+    "@pi-unipi/core": "2.14.2",
+    "@pi-unipi/background-tasks": "2.14.2"
   },
   "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.0",
+  "version": "2.14.2",
   "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.0"
+    "@pi-unipi/core": "2.14.2"
   },
   "peerDependencies": {
     "@earendil-works/pi-ai": "^0.84.0",

package/packages/info-screen/index.ts

@@ -113,10 +113,19 @@ export default function (pi: ExtensionAPI) {
    */
   function showOverlay(ctx: ExtensionContext, autoCloseMs?: number): void {
     let overlay: InfoOverlay;
+    // Splash mode (auto-close): the overlay must NEVER take keyboard focus —
+    // it lives exactly during the window where the user starts typing their
+    // first prompt. A capturing overlay here eats those keystrokes (worse: its
+    // vim-style keys "work", so command text vanishes into tab switches), and
+    // its first-keypress-cancels-auto-close rule strands it on screen forever
+    // as an unclosable, input-eating zombie. Non-capturing + stack-safe
+    // self-dismiss (see startBootTimer) makes it pure eye-candy.
+    const splashMode = autoCloseMs !== undefined && autoCloseMs > 0;
     ctx.ui.custom<void>(
       (tui, theme, _keybindings, done) => {
         overlay = new InfoOverlay();
         overlay.setTheme(theme);
+        overlay.interactive = !splashMode;
         overlayVisible = true;
         overlay.onClose = () => {
           overlayVisible = false;
@@ -127,14 +136,37 @@ export default function (pi: ExtensionAPI) {
         const component = {
           render: (w: number) => overlay.render(w),
           invalidate: () => overlay.invalidate(),
+          // In splash mode the overlay is non-capturing and never receives
+          // input; keep handleInput wired for interactive ("on") mode.
           handleInput: (data: string) => {
             overlay.handleInput(data);
             tui.requestRender();
           },
         };
-        // Boot dashboard dismisses itself; any keypress cancels the timer.
+        // Splash self-dismiss may only run while this overlay is the topmost
+        // VISIBLE entry of the TUI overlay stack. If the user opens anything
+        // during the splash window (a /unipi:… settings dialog, the updater's
+        // update prompt, …), dismissal must wait — removing a covered entry
+        // breaks the covering overlay (pi retargets focus and orphans its
+        // pending interaction, e.g. a hung ctx.ui.select promise). Re-check
+        // on every timer tick; once the stack clears we dismiss as usual.
+        const isTopmostVisible = (): boolean => {
+          try {
+            const stack = (tui as unknown as { overlayStack?: Array<{ component?: unknown; hidden?: boolean }> }).overlayStack;
+            if (!stack || stack.length === 0) return true;
+            for (let i = stack.length - 1; i >= 0; i--) {
+              const entry = stack[i];
+              if (entry?.hidden) continue;
+              return entry?.component === component;
+            }
+            return true;
+          } catch {
+            return true; // Stack unreadable — assume topmost (legacy behavior).
+          }
+        };
+        // Boot dashboard dismisses itself (splash mode).
         if (autoCloseMs && autoCloseMs > 0) {
-          overlay.startBootTimer(autoCloseMs);
+          overlay.startBootTimer(autoCloseMs, isTopmostVisible);
         }
         return component;
       },
@@ -145,17 +177,24 @@ export default function (pi: ExtensionAPI) {
           minWidth: 60,
           anchor: "center" as const,
           margin: 2,
+          nonCapturing: splashMode,
         },
-        // `done()` (the extension UI's close callback) pops the *topmost* overlay
-        // in the TUI stack, not this one specifically. When another overlay (e.g.
-        // the updater's "Update Available" prompt) is stacked on top, the boot
-        // auto-close timer must not fire `done()` — that would pop the covering
-        // overlay and strand this dashboard with a spent one-shot close the user
-        // can no longer dismiss. `isTopmostOverlay` lets the boot timer defer
-        // until we are the focused (topmost) entry; the user can still press
-        // q/Esc to close once the covering overlay is gone.
+        // In splash mode the timer uses `selfHide` (handle.hide() splices this
+        // entry out by identity) guarded by the topmost-visible check above —
+        // never `done()`, which pops whatever is TOPMOST. `isTopmostOverlay`
+        // remains as the focused-done() fallback for interactive ("on") mode,
+        // where the user drives the dashboard directly: it is topmost while
+        // being driven, so the q/Esc → done() path is correct there.
         onHandle: (handle) => {
           overlay.isTopmostOverlay = () => handle.isFocused();
+          overlay.selfHide = () => {
+            overlayVisible = false;
+            if (typeof handle.hide === "function") {
+              handle.hide();
+            } else if (typeof (handle as { setHidden?: (v: boolean) => void }).setHidden === "function") {
+              (handle as { setHidden: (v: boolean) => void }).setHidden(true);
+            }
+          };
         },
       }
     );

package/packages/info-screen/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/info-screen",
-  "version": "2.14.0",
+  "version": "2.14.2",
   "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.14.0"
+    "@pi-unipi/core": "2.14.2"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.84.0",

package/packages/info-screen/tui/info-overlay.ts

@@ -69,6 +69,21 @@ export class InfoOverlay implements Component {
    * `startBootTimer` for why.
    */
   isTopmostOverlay?: () => boolean;
+  /**
+   * Stack-safe self-removal via the overlay handle (`handle.hide()` splices
+   * this entry out of the TUI stack by identity, unlike `done()` which pops
+   * whatever is TOPMOST). Set from `onHandle` in index.ts. When available,
+   * the boot auto-close timer prefers this over `done()` so a splash that
+   * lingers while another overlay opens can never dismiss that overlay
+   * instead of itself.
+   */
+  selfHide?: () => void;
+  /**
+   * False when running as a non-capturing boot splash (auto-close): the
+   * overlay never receives keyboard input, so interactive hints like
+   * "q/Esc close" would be misleading and are replaced accordingly.
+   */
+  interactive = true;
 
   private overlay = new OverlayTheme();
 
@@ -232,31 +247,46 @@ export class InfoOverlay implements Component {
   }
 
   /**
-   * Auto-close the overlay after `ms`, unless the user interacts first.
+   * Auto-close the overlay after `ms`.
    *
-   * Used when the overlay is shown on boot: the dashboard is informational, so
-   * it should get out of the way on its own rather than requiring a keypress.
+   * Used when the overlay is shown as a boot splash: the dashboard is
+   * informational, so it should get out of the way on its own rather than
+   * requiring a keypress.
    *
-   * The close callback (`onClose` → `done`) pops the *topmost* overlay in the
-   * TUI stack, not this one specifically. When another overlay (e.g. the
-   * updater's "Update Available" prompt) is stacked on top, firing `done()`
-   * here would remove the covering overlay and strand this dashboard with a
-   * spent one-shot close the user can no longer trigger — leaving the starting
-   * screen stuck. So we defer the auto-close until we are actually the
-   * focused/topmost overlay; the user can still press q/Esc to dismiss it once
-   * the covering overlay is gone.
+   * Dismissal uses `selfHide` (handle.hide() — removes THIS entry from the
+   * TUI overlay stack by identity) and only fires while `isTopmostVisible`
+   * confirms nothing is stacked above: dismissing a covered overlay breaks
+   * the covering one (pi retargets focus and orphans its pending
+   * interaction, e.g. a ctx.ui.select promise that never resolves while its
+   * overlay vanishes). If covered, the timer re-arms and retries.
+   *
+   * If `selfHide` is unavailable (older host), falls back to the guarded
+   * `onClose` (`done()`) path, which requires focus (topmost) for the same
+   * reason.
    */
-  startBootTimer(ms: number): void {
+  startBootTimer(ms: number, isTopmostVisible?: () => boolean): void {
     this.cancelBootTimer();
     if (!Number.isFinite(ms) || ms <= 0) return;
     const arm = (): void => {
       this.bootTimer = setTimeout(() => {
         this.bootTimer = null;
         if (this._destroyed) return;
+        if (this.selfHide) {
+          if (isTopmostVisible && !isTopmostVisible()) {
+            // Something is stacked on top of us — dismissing now would break
+            // it (orphaned select promise, focus retarget). Retry shortly;
+            // once the stack clears we dismiss as usual.
+            arm();
+            return;
+          }
+          this.selfHide();
+          this.destroy();
+          return;
+        }
         if (this.isTopmostOverlay && !this.isTopmostOverlay()) {
-          // Something is stacked on top of us — closing now would pop it
-          // instead of this dashboard. Retry shortly; once the covering
-          // overlay closes we'll be topmost and can auto-close safely.
+          // Fallback (no selfHide available): closing now would pop the
+          // covering overlay instead of this dashboard. Retry shortly; once
+          // we are topmost the close is safe.
           arm();
           return;
         }
@@ -346,7 +376,7 @@ export class InfoOverlay implements Component {
     lines.push(this.overlay.frameLine(this.overlay.fg("dim", "Modules will register groups on startup."), innerWidth));
     for (let i = 0; i < 4; i++) lines.push(this.overlay.frameLine("", innerWidth));
     lines.push(this.overlay.ruleLine(innerWidth));
-    lines.push(this.overlay.frameLine(this.overlay.fg("dim", "q/Esc close · r refresh"), innerWidth));
+    lines.push(this.overlay.frameLine(this.overlay.fg("dim", this.interactive ? "q/Esc close · r refresh" : "auto-dismissing…"), innerWidth));
     lines.push(this.overlay.borderLine(innerWidth, "bottom"));
     return lines;
   }
@@ -529,12 +559,14 @@ export class InfoOverlay implements Component {
     const lastUp = infoRegistry.getLastUpdated(group?.id ?? "");
     const age = lastUp > 0 ? humanizeAge(Date.now() - lastUp) : "loading…";
 
-    const hints = [
-      `${this.overlay.fg("accent", "←/→")} tabs`,
-      `${this.overlay.fg("success", "↑/↓")} scroll`,
-      `${this.overlay.fg("warning", "r")} refresh`,
-      `${this.overlay.fg("error", "q/Esc")} close`,
-    ];
+    const hints = this.interactive
+      ? [
+          `${this.overlay.fg("accent", "←/→")} tabs`,
+          `${this.overlay.fg("success", "↑/↓")} scroll`,
+          `${this.overlay.fg("warning", "r")} refresh`,
+          `${this.overlay.fg("error", "q/Esc")} close`,
+        ]
+      : [`${this.overlay.fg("dim", "auto-dismissing…")}`];
 
     const hintStr = hints.join(`  ${this.overlay.fg("borderMuted", "•")}  `);
 

package/packages/input-shortcuts/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/input-shortcuts",
-  "version": "2.14.0",
+  "version": "2.14.2",
   "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.14.0"
+    "@pi-unipi/core": "2.14.2"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.84.0",

package/packages/kanboard/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/kanboard",
-  "version": "2.14.0",
+  "version": "2.14.2",
   "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.14.0"
+    "@pi-unipi/core": "2.14.2"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.84.0",

package/packages/mcp/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/mcp",
-  "version": "2.14.0",
+  "version": "2.14.2",
   "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.14.0"
+    "@pi-unipi/core": "2.14.2"
   },
   "peerDependencies": {
     "@earendil-works/pi-coding-agent": "^0.84.0",

package/packages/memory/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pi-unipi/memory",
-  "version": "2.14.0",
+  "version": "2.14.2",
   "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.0",
-    "@pi-unipi/info-screen": "2.14.0",
+    "@pi-unipi/core": "2.14.2",
+    "@pi-unipi/info-screen": "2.14.2",
     "js-yaml": "^4.1.0"
   },
   "peerDependencies": {