@pi-unipi/footer 2.12.1 → 2.13.0

package/README.md

@@ -18,6 +18,7 @@ An experimental input surface, on by default and toggleable in `/unipi:footer-se
 - **Top border:** animated lolcat-gradient UNIPI brand + git branch (turns rainbow-frame animated while thinking is max/xhigh)
 - **Bottom border:** workspace · context %/window · model · thinking level
 - **Session strip:** turns/steps, wall + tool wall time, average TTFT, tok/s, cache hit % — colored per stat, honest across restarts (derived from persisted session timestamps when live hooks are unavailable; provider-reported `usage.output` anchors token counts whenever present)
+- **Process line (new in 2.13):** centered one-liner directly above the frame while background work is in flight — `● 3 running  ● 1 stopped  ● 1 failed  ● 2 done` — green ● running, yellow ● stopped (killed), red ● failed, gray ● done. Covers every task type (shell jobs, delegates, fusion workflows) via direct registry reads; zero-count buckets are omitted and the line hides when idle. Counts reset per session.
 - The classic segment status line is suppressed while glance mode is on; toggle it back for the classic footer
 
 ## Commands

package/package.json

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

package/src/index.ts

@@ -29,6 +29,7 @@ import { STATUS_EXT_SEGMENTS } from "./segments/status-ext.js";
 
 import type { FooterGroup, FooterSegment } from "./types.js";
 import { tpsTracker } from "./tps-tracker.js";
+import { renderProcessLine } from "./process-line.js";
 
 /** All segment groups */
 const ALL_GROUPS: FooterGroup[] = [
@@ -328,9 +329,10 @@ function setupFooterUI(pi: ExtensionAPI, ctx: ExtensionContext, state: FooterSta
     };
   });
 
-  // Top row widget — classic status line (suppressed in glance mode; the
-  // glance frame's top border already shows UNIPI │ branch and the bottom
-  // border shows context/model/thinking, so a segment row would duplicate it)
+  // Top row widget — dual role. Classic mode: status segment line. Glance
+  // mode: the bg-process one-liner, rendered directly above the glance frame
+  // (the frame replaces the editor, so this aboveEditor slot sits right above
+  // the footer); the frame's own borders show branch/context/model/thinking.
   ctx.ui.setWidget("footer-top", (_tui, theme) => {
     // Update the renderer's theme-like
     const themeLike = { fg: (color: string, text: string) => theme.fg(color as any, text) };
@@ -344,8 +346,8 @@ function setupFooterUI(pi: ExtensionAPI, ctx: ExtensionContext, state: FooterSta
       },
       render(width: number): string[] {
         if (!state.enabled || !state.piContext || width <= 0) return [];
-        // Glance mode replaces the classic segment line entirely.
-        if (state.glanceMode) return [];
+        // Glance mode: this slot becomes the bg-process one-liner.
+        if (state.glanceMode) return renderProcessLine(width);
         const layout = state.renderer.computeLayout(width);
         if (!layout.topContent) return [];
 

package/src/process-line.ts

@@ -0,0 +1,74 @@
+/**
+ * @pi-unipi/footer — Background process one-liner
+ *
+ * Glance-mode strip rendered above the footer frame: one colored dot + count
+ * per background-task status. Reads DIRECTLY from the
+ * @pi-unipi/background-tasks shared registry (no events, no polling
+ * channels); re-renders on the footer's existing 1s refresh timer.
+ *
+ * Dot → status mapping:
+ *   green ● running   yellow ● stopped (killed)   red ● failed   gray ● done (completed)
+ *
+ * Buckets with zero count are omitted; with nothing in flight the line is
+ * empty so the footer stays clean.
+ */
+
+import { truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
+import { getSharedTaskRegistry } from "@pi-unipi/background-tasks";
+
+const GREEN_DOT = "\x1b[38;5;82m●\x1b[0m"; // running — active work
+const YELLOW_DOT = "\x1b[38;5;220m●\x1b[0m"; // stopped (killed) — needs attention
+const RED_DOT = "\x1b[38;5;196m●\x1b[0m"; // failed — needs attention
+const GRAY_DOT = "\x1b[38;5;245m●\x1b[0m"; // done (completed) — idle info
+
+export interface BgProcessCounts {
+  running: number;
+  stopped: number;
+  failed: number;
+  done: number;
+}
+
+/**
+ * Count background tasks by display status straight from the registry.
+ * Returns null when background-tasks has not published a registry (module
+ * disabled, before first load, or after session shutdown).
+ */
+export function countBgProcesses(): BgProcessCounts | null {
+  try {
+    const tasks = getSharedTaskRegistry()?.allTasks();
+    if (!tasks) return null;
+    const counts: BgProcessCounts = { running: 0, stopped: 0, failed: 0, done: 0 };
+    for (const task of tasks) {
+      if (task.status === "running") counts.running++;
+      else if (task.status === "killed") counts.stopped++;
+      else if (task.status === "failed") counts.failed++;
+      else if (task.status === "completed") counts.done++;
+    }
+    return counts;
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Render the centered one-liner for the given terminal width.
+ * Returns [] when there is nothing to show.
+ */
+export function renderProcessLine(width: number): string[] {
+  if (width <= 0) return [];
+  const counts = countBgProcesses();
+  if (!counts) return [];
+
+  const parts: string[] = [];
+  if (counts.running > 0) parts.push(`${GREEN_DOT} ${counts.running} running`);
+  if (counts.stopped > 0) parts.push(`${YELLOW_DOT} ${counts.stopped} stopped`);
+  if (counts.failed > 0) parts.push(`${RED_DOT} ${counts.failed} failed`);
+  if (counts.done > 0) parts.push(`${GRAY_DOT} ${counts.done} done`);
+  if (parts.length === 0) return [];
+
+  const line = parts.join("  ");
+  const w = visibleWidth(line);
+  if (w >= width) return [truncateToWidth(line, width)];
+  const leftPad = Math.floor((width - w) / 2);
+  return [" ".repeat(leftPad) + line];
+}