@gonrocca/zero-pi 0.1.37 → 0.1.39

package/extensions/zero-banner.ts

@@ -142,58 +142,27 @@ export function bannerBlock(width: number): string[] {
   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.
  *
- * 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.
+ * Writes the banner ONCE to stdout at extension load — pi loads extensions
+ * before its TUI takes over the screen, so the banner ends up at the very top
+ * of the terminal scrollback, above everything else. `setWidget` was tried
+ * (0.1.33–0.1.37) but pi positions widgets above the editor, not at the top
+ * of the viewport — short chats showed the banner in the middle.
+ *
+ * Known tradeoff: resizing the terminal lets pi clear/reflow its TUI area, and
+ * the one-shot banner in scrollback can scroll out of view. That is normal
+ * CLI startup-banner behavior. `ZERO_HEADER=off` disables it.
  */
-export default function register(pi?: unknown): void {
+export default function register(_pi?: unknown): void {
   try {
     if ((process.env.ZERO_HEADER ?? "").trim().toLowerCase() === "off") return;
-    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.
-      }
-    });
+    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");
   } catch {
-    // Registration itself must never break a pi session.
+    // A banner failure must never break a pi session.
   }
 }

package/extensions/zero-statusline.ts

@@ -0,0 +1,270 @@
+// zero-pi — colored statusline footer.
+//
+// Updates pi's footer (`ctx.ui.setStatus`) with a powerline-style line:
+//
+//   claude-opus-4-7 · tok ↑12.3K ↓4.1K · diff +50/-12 · ctx 45% · master · www.ceroclawd.com
+//
+// Themed: model violet, tokens cyan/blue, diff mint/rose, ctx mint→amber→rose
+// by load, branch steel, brand amber. Pure 24-bit ANSI, no runtime deps.
+//
+// Refreshes on `session_start`, `model_select`, `message_update`
+// (accumulates tokens), and `tool_execution_end` (re-reads git, since tools
+// edit files). No timer — the 140 ms re-render loop that crashed pi 0.75.x
+// is the cautionary tale; event-driven updates are safe.
+
+import { exec } from "node:child_process";
+import { promisify } from "node:util";
+
+const execAsync = promisify(exec);
+
+// ─── Color palette (matches the zero-sdd theme `vars`) ─────────────────────
+
+type RGB = [number, number, number];
+const VIOLET: RGB = [175, 138, 255];
+const CYAN: RGB = [80, 210, 255];
+const BLUE: RGB = [116, 151, 255];
+const MINT: RGB = [79, 221, 171];
+const AMBER: RGB = [238, 190, 92];
+const ROSE: RGB = [255, 106, 122];
+const STEEL: RGB = [143, 152, 168];
+const DIM: RGB = [95, 104, 120];
+
+function fg([r, g, b]: RGB, text: string): string {
+  return `\x1b[38;2;${r};${g};${b}m${text}\x1b[0m`;
+}
+
+// ─── Pure formatters (unit-tested) ─────────────────────────────────────────
+
+/** Compact a token count: `500` → `500`, `1500` → `1.5K`, `2_400_000` → `2.4M`. */
+export function formatTokenCount(n: number): string {
+  if (!Number.isFinite(n) || n < 0) return "0";
+  if (n < 1000) return `${Math.floor(n)}`;
+  if (n < 1_000_000) return `${(n / 1000).toFixed(1)}K`;
+  return `${(n / 1_000_000).toFixed(1)}M`;
+}
+
+/** Pick a load-based color for context-usage display. */
+export function ctxColor(percent: number): RGB {
+  if (!Number.isFinite(percent) || percent < 50) return MINT;
+  if (percent < 80) return AMBER;
+  return ROSE;
+}
+
+/** Strip a `provider/` prefix from a model id for compact display. */
+export function shortModel(id: string | undefined): string | undefined {
+  if (!id) return undefined;
+  const slash = id.lastIndexOf("/");
+  return slash >= 0 ? id.slice(slash + 1) : id;
+}
+
+/** The shape of one statusline render. All fields optional — missing parts skip. */
+export interface StatuslineParts {
+  model?: string;
+  tokensIn?: number;
+  tokensOut?: number;
+  diffAdded?: number;
+  diffRemoved?: number;
+  ctxPercent?: number;
+  branch?: string;
+  brand?: string;
+}
+
+const SEP = fg(DIM, " · ");
+
+/**
+ * Compose the themed statusline string from its parts. Missing parts are
+ * skipped — an empty parts object yields the empty string.
+ */
+export function composeStatusline(p: StatuslineParts): string {
+  const parts: string[] = [];
+
+  if (p.model) parts.push(fg(VIOLET, p.model));
+
+  if (p.tokensIn != null || p.tokensOut != null) {
+    const inS = fg(CYAN, `↑${formatTokenCount(p.tokensIn ?? 0)}`);
+    const outS = fg(BLUE, `↓${formatTokenCount(p.tokensOut ?? 0)}`);
+    parts.push(`${fg(DIM, "tok")} ${inS} ${outS}`);
+  }
+
+  if (p.diffAdded != null || p.diffRemoved != null) {
+    const added = fg(MINT, `+${p.diffAdded ?? 0}`);
+    const removed = fg(ROSE, `-${p.diffRemoved ?? 0}`);
+    parts.push(`${fg(DIM, "diff")} ${added}/${removed}`);
+  }
+
+  if (p.ctxPercent != null && Number.isFinite(p.ctxPercent)) {
+    parts.push(fg(ctxColor(p.ctxPercent), `ctx ${Math.round(p.ctxPercent)}%`));
+  }
+
+  if (p.branch) parts.push(fg(STEEL, p.branch));
+
+  if (p.brand) parts.push(fg(AMBER, p.brand));
+
+  return parts.join(SEP);
+}
+
+// ─── pi API surfaces (minimal slices) ──────────────────────────────────────
+
+interface PiUI {
+  setStatus(id: string, text: string | undefined): void;
+}
+interface PiModel {
+  id?: string;
+  name?: string;
+  contextWindow?: number;
+}
+interface PiCtx {
+  ui?: PiUI;
+  model?: PiModel;
+  cwd?: string;
+  getContextUsage?(): { tokens?: number } | null | undefined;
+}
+interface PiAPI {
+  on(event: string, handler: (event: unknown, ctx: PiCtx) => void): void;
+}
+
+const STATUS_ID = "zero-statusline";
+const BRAND = "www.ceroclawd.com";
+
+// ─── Session-scoped state ──────────────────────────────────────────────────
+
+let tokensIn = 0;
+let tokensOut = 0;
+let branch: string | undefined;
+let added = 0;
+let removed = 0;
+let lastCtx: PiCtx | undefined;
+let gitInFlight = false;
+
+function resetSessionState(): void {
+  tokensIn = 0;
+  tokensOut = 0;
+  branch = undefined;
+  added = 0;
+  removed = 0;
+}
+
+// ─── Git read (best-effort, async, deduped) ────────────────────────────────
+
+async function readGit(cwd: string | undefined): Promise<void> {
+  if (!cwd || gitInFlight) return;
+  gitInFlight = true;
+  try {
+    try {
+      const { stdout } = await execAsync("git rev-parse --abbrev-ref HEAD", {
+        cwd,
+        timeout: 1500,
+        windowsHide: true,
+      });
+      branch = stdout.trim() || undefined;
+    } catch {
+      branch = undefined;
+    }
+    try {
+      const { stdout } = await execAsync("git diff --shortstat", {
+        cwd,
+        timeout: 1500,
+        windowsHide: true,
+      });
+      // "1 file changed, 12 insertions(+), 3 deletions(-)"
+      const ins = stdout.match(/(\d+)\s+insertions?\(\+\)/);
+      const del = stdout.match(/(\d+)\s+deletions?\(-\)/);
+      added = ins ? parseInt(ins[1], 10) : 0;
+      removed = del ? parseInt(del[1], 10) : 0;
+    } catch {
+      // not a git repo or no diff
+    }
+  } finally {
+    gitInFlight = false;
+  }
+}
+
+// ─── Render: read everything from ctx + state, push to footer ──────────────
+
+function render(ctx: PiCtx): void {
+  try {
+    if (!ctx?.ui || typeof ctx.ui.setStatus !== "function") return;
+    const window = ctx.model?.contextWindow && ctx.model.contextWindow > 0 ? ctx.model.contextWindow : 200_000;
+    const used = ctx.getContextUsage?.()?.tokens;
+    const ctxPercent = typeof used === "number" && used >= 0 ? Math.min(100, (used / window) * 100) : undefined;
+    const text = composeStatusline({
+      model: shortModel(ctx.model?.id ?? ctx.model?.name),
+      tokensIn,
+      tokensOut,
+      diffAdded: added,
+      diffRemoved: removed,
+      ctxPercent,
+      branch,
+      brand: BRAND,
+    });
+    ctx.ui.setStatus(STATUS_ID, text);
+  } catch {
+    // setStatus failure must never break a pi session.
+  }
+}
+
+// ─── Registration ──────────────────────────────────────────────────────────
+
+/**
+ * The pi extension entry point. Wires four events: `session_start` (reset +
+ * initial git read), `model_select` (re-render with the new model name),
+ * `message_update` (accumulate token usage), `tool_execution_end` (re-read git
+ * since the tool may have edited files). Defensive: every callback is wrapped,
+ * and registration itself never throws.
+ */
+export default function register(pi?: unknown): void {
+  try {
+    if (!pi || typeof (pi as PiAPI).on !== "function") return;
+    const api = pi as PiAPI;
+
+    api.on("session_start", (_event, ctx) => {
+      try {
+        lastCtx = ctx;
+        resetSessionState();
+        render(ctx);
+        void readGit(ctx?.cwd).then(() => render(ctx));
+      } catch {
+        // never break a session
+      }
+    });
+
+    api.on("model_select", (_event, ctx) => {
+      try {
+        lastCtx = ctx;
+        render(ctx);
+      } catch {
+        // never break a session
+      }
+    });
+
+    api.on("message_update", (event, ctx) => {
+      try {
+        lastCtx = ctx;
+        const usage = (event as { message?: { usage?: { inputTokens?: unknown; outputTokens?: unknown } } })?.message
+          ?.usage;
+        if (usage) {
+          if (typeof usage.inputTokens === "number" && usage.inputTokens > 0) {
+            tokensIn += usage.inputTokens;
+          }
+          if (typeof usage.outputTokens === "number" && usage.outputTokens > 0) {
+            tokensOut += usage.outputTokens;
+          }
+        }
+        render(ctx);
+      } catch {
+        // never break a session
+      }
+    });
+
+    api.on("tool_execution_end", (_event, ctx) => {
+      try {
+        lastCtx = ctx;
+        void readGit(ctx?.cwd).then(() => render(ctx));
+      } catch {
+        // never break a session
+      }
+    });
+  } catch {
+    // Registration itself must never break a pi session.
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gonrocca/zero-pi",
-  "version": "0.1.37",
+  "version": "0.1.39",
   "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": [
@@ -24,6 +24,7 @@
     ],
     "extensions": [
       "./extensions/zero-banner.ts",
+      "./extensions/zero-statusline.ts",
       "./extensions/working-phrases.ts",
       "./extensions/win-tree-kill.ts",
       "./extensions/sdd-agents.ts",
@@ -39,6 +40,7 @@
     "skills",
     "themes",
     "extensions/zero-banner.ts",
+    "extensions/zero-statusline.ts",
     "extensions/working-phrases.ts",
     "extensions/win-tree-kill.ts",
     "extensions/sdd-agents.ts",