@gonrocca/zero-pi 0.1.32 → 0.1.34

package/extensions/zero-banner.ts

@@ -125,27 +125,75 @@ function ornament(width: number): string {
   return center(line, width);
 }
 
-/** The full banner block, centered to the given width. */
+/**
+ * The full banner block, centered to the given width.
+ *
+ * Wide layout = exactly **10 lines**: top ornament + 7 logo rows (6 + cast
+ * shadow) + tag + bottom ornament. Pi's `setWidget` caps managed widgets at
+ * `MAX_WIDGET_LINES = 10` (hardcoded in interactive-mode.js); anything taller
+ * is rendered with a `... (widget truncated)` line. Inner blank-line padding
+ * was removed to fit that cap exactly — adding blanks back would re-truncate.
+ */
 export function bannerBlock(width: number): string[] {
   if (width < 64) {
     return [center(fg(VIOLET, "ZERO SDD"), width), center(fg(MUTED, "pi.dev · spec-driven work"), width)];
   }
   const tag = fg(VIOLET, "ZERO SDD") + fg(MUTED, "   explore → plan → build → veredicto");
-  return [ornament(width), "", ...renderLogo(width), "", center(tag, width), ornament(width)];
+  return [ornament(width), ...renderLogo(width), center(tag, width), ornament(width)];
+}
+
+/** The slice of pi's UI surface this extension uses. */
+interface PiUI {
+  setWidget(id: string, lines: string[]): void;
+}
+interface PiSessionContext {
+  ui?: PiUI;
+}
+interface PiAPI {
+  on(event: string, handler: (event: unknown, ctx: PiSessionContext) => void): void;
+}
+
+/** Stable widget id — re-installing with the same id replaces the previous lines. */
+const WIDGET_ID = "zero-banner";
+
+/**
+ * Install (or refresh) the banner as a pi-managed widget above the editor.
+ *
+ * Using `ctx.ui.setWidget` instead of a one-shot `stdout.write` means pi owns
+ * the lines and redraws them on every resize, every reload, every session
+ * restart — so the banner survives maximize/minimize instead of vanishing into
+ * scrollback. The crash this file's earlier comment warned about was the
+ * animated 140 ms re-render loop; a static widget set once per `session_start`
+ * has no timer and re-uses the same id, so it never spams.
+ */
+function installWidget(ctx: PiSessionContext): void {
+  if (!ctx?.ui || typeof ctx.ui.setWidget !== "function") return;
+  if (process.env.NO_COLOR) return;
+  const cols = process.stdout?.columns && process.stdout.columns > 0 ? process.stdout.columns : 80;
+  ctx.ui.setWidget(WIDGET_ID, bannerBlock(cols));
 }
 
 /**
- * The pi extension entry point. Renders the banner exactly once, synchronously,
- * at load time. Any failure is swallowed — a banner must never break a session.
+ * The pi extension entry point.
+ *
+ * Hooks `session_start` (fires on startup, reload, new, resume, fork) and
+ * installs the banner as a pi-managed widget above the editor — so pi keeps it
+ * rendered and redraws it on resize. Disabled with `ZERO_HEADER=off`.
+ * Defensive: any failure of registration or the widget install is swallowed —
+ * a banner must never break a pi session.
  */
-export default function register(_pi?: unknown): void {
+export default function register(pi?: unknown): void {
   try {
     if ((process.env.ZERO_HEADER ?? "").trim().toLowerCase() === "off") return;
-    const stream = process.stdout;
-    if (!stream || !stream.isTTY || process.env.NO_COLOR) return;
-    const width = stream.columns && stream.columns > 0 ? stream.columns : 80;
-    stream.write("\n" + bannerBlock(width).join("\n") + "\n\n");
+    if (!pi || typeof (pi as PiAPI).on !== "function") return;
+    (pi as PiAPI).on("session_start", (_event, ctx) => {
+      try {
+        installWidget(ctx);
+      } catch {
+        // A widget install failure must never break a pi session.
+      }
+    });
   } catch {
-    // A banner failure must never break a pi session.
+    // Registration itself must never break a pi session.
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gonrocca/zero-pi",
-  "version": "0.1.32",
+  "version": "0.1.34",
   "description": "zero-pi — an installable layer for pi (pi.dev): the zero spec-driven development workflow, per-phase model autotune, and skill auto-learning. Adds capability to pi without modifying pi.",
   "type": "module",
   "keywords": [