pi-tropos 0.6.0 → 0.8.0

package/README.md

@@ -21,6 +21,11 @@ Personal pi customization bundle. One package, installable anywhere.
 - **`kaapi` theme** — filter-coffee dark: deep espresso base (`#15100D`), latte-foam text
   (`#E8DCCB`), caramel accent (`#D9984A`), matcha success, terracotta error. Warm and
   caffeinated. Select via `/settings` or `"theme": "kaapi"`.
+- **Clean footer** — one line: `project branch` left; `↑in ↓out Rcache Wcache $cost` plus
+  the dumbzone gauge right. Zero-valued counters hide; no full paths, no cache-hit %,
+  no session titles. Auto-named sessions are sanitized (no markdown table junk).
+- **`/zen` mode** — reading mode for brainstorming: collapses all tool output and shrinks
+  the footer to `$cost` + the ctx gauge. `/zen` again restores your previous state.
 - **Barista mascot** — the working spinner becomes a steaming cup of kaapi; every other
   brew cycle it's a boba 🧋. Hidden thinking blocks read "Steeping…".
 - **pi-smritikosh** — semantic codebase search, bundled as a dependency. One install
@@ -42,3 +47,20 @@ npm run typecheck
 ```
 
 No build step — pi loads the TypeScript directly.
+
+## Font (recommended)
+
+pi inherits the terminal's font — it can't set one. In VS Code (where pi usually runs):
+
+```jsonc
+// settings.json
+"terminal.integrated.fontFamily": "JetBrains Mono",
+"terminal.integrated.fontSize": 14,
+"terminal.integrated.lineHeight": 1.35,
+"terminal.integrated.fontLigatures.enabled": true
+```
+
+Good code-reading fonts: **JetBrains Mono** (free, tall x-height, superb at small sizes —
+`brew install --cask font-jetbrains-mono`), **SF Mono** (preinstalled on macOS),
+**Monaspace Neon** (GitHub's family — `brew install --cask font-monaspace`), **Berkeley
+Mono** (paid, beautiful). Size 13–14 + lineHeight 1.3–1.4 is the biggest readability win.

package/index.ts

@@ -2,11 +2,13 @@ import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import smritikosh from "pi-smritikosh/index.js";
 import barista from "./src/barista.js";
 import dumbzone from "./src/dumbzone.js";
+import footer from "./src/footer.js";
 import sessions from "./src/sessions.js";
 
 export default function (pi: ExtensionAPI) {
 	barista(pi);
 	dumbzone(pi);
+	footer(pi);
 	sessions(pi);
 	smritikosh(pi);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-tropos",
-  "version": "0.6.0",
+  "version": "0.8.0",
   "description": "Personal pi customization bundle — context-health indicator, session handoff, session browser",
   "type": "module",
   "keywords": [

package/src/footer.ts

@@ -0,0 +1,114 @@
+/**
+ * Footer — clean one-line status bar + /zen mode.
+ *
+ * Normal: `project branch` left; `↑in ↓out Rcache Wcache $cost` + extension
+ * statuses (e.g. the dumbzone ctx gauge) right. Zero-valued counters hide.
+ *
+ * /zen:  collapses all tool output and shrinks the footer to just
+ * `$cost` + the ctx gauge. Reading mode for brainstorming — the chat
+ * becomes the content. /zen again restores your previous state.
+ * (Zen lives here because the footer owns the chrome it minimizes.)
+ */
+
+import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
+import { truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
+
+interface Usage {
+	input: number;
+	output: number;
+	cacheRead: number;
+	cacheWrite: number;
+	cost: { total: number };
+}
+
+interface Totals {
+	input: number;
+	output: number;
+	cacheRead: number;
+	cacheWrite: number;
+	cost: number;
+}
+
+function fmt(n: number) {
+	if (n >= 1_000_000) return `${(n / 1_000_000).toFixed(1)}M`;
+	if (n >= 1_000) return `${Math.round(n / 1_000)}k`;
+	return `${n}`;
+}
+
+function totals(ctx: ExtensionContext): Totals {
+	const t: Totals = { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, cost: 0 };
+	for (const e of ctx.sessionManager.getBranch()) {
+		if (e.type !== "message" || e.message.role !== "assistant") continue;
+		const u = (e.message as { usage?: Usage }).usage;
+		if (!u) continue;
+		t.input += u.input;
+		t.output += u.output;
+		t.cacheRead += u.cacheRead ?? 0;
+		t.cacheWrite += u.cacheWrite ?? 0;
+		t.cost += u.cost?.total ?? 0;
+	}
+	return t;
+}
+
+function telemetryLine(t: Totals) {
+	if (t.input === 0) return "";
+	const parts = [`↑${fmt(t.input)}`, `↓${fmt(t.output)}`];
+	if (t.cacheRead > 0) parts.push(`R${fmt(t.cacheRead)}`);
+	if (t.cacheWrite > 0) parts.push(`W${fmt(t.cacheWrite)}`);
+	parts.push(`$${t.cost.toFixed(2)}`);
+	return parts.join(" ");
+}
+
+let zen = false;
+let wasExpanded = true;
+
+export default function footer(pi: ExtensionAPI) {
+	pi.registerCommand("zen", {
+		description: "Toggle zen mode — collapse tool noise, minimal footer",
+		handler: async (_args, ctx) => {
+			if (ctx.mode !== "tui") {
+				ctx.ui.notify("/zen needs interactive mode", "error");
+				return;
+			}
+			zen = !zen;
+			if (zen) {
+				wasExpanded = ctx.ui.getToolsExpanded();
+				ctx.ui.setToolsExpanded(false);
+				ctx.ui.notify("Zen ☁️ — Ctrl+T hides thinking · /zen to exit", "info");
+			} else {
+				ctx.ui.setToolsExpanded(wasExpanded);
+				ctx.ui.notify("Zen off — full telemetry restored", "info");
+			}
+		},
+	});
+
+	pi.on("session_start", (_event, ctx) => {
+		zen = false;
+		if (!ctx.hasUI) return;
+		ctx.ui.setFooter((tui, theme, footerData) => {
+			const unsub = footerData.onBranchChange(() => tui.requestRender());
+			return {
+				dispose: unsub,
+				invalidate() {},
+				render(width: number): string[] {
+					const t = totals(ctx);
+					const statuses = [...footerData.getExtensionStatuses().values()].join(" ");
+
+					if (zen) {
+						const right = [t.cost > 0 ? `$${t.cost.toFixed(2)}` : "", statuses].filter(Boolean).join("  ");
+						return [truncateToWidth(theme.fg("dim", right), width)];
+					}
+
+					const dir = ctx.cwd.split("/").pop() ?? ctx.cwd;
+					const branch = footerData.getGitBranch();
+					const left = theme.fg("dim", branch ? `${dir} ${branch}` : dir);
+					const metrics = theme.fg("dim", telemetryLine(t));
+					const right = [metrics, statuses].filter(Boolean).join("  ");
+
+					const pad = " ".repeat(Math.max(1, width - visibleWidth(left) - visibleWidth(right)));
+					return [truncateToWidth(left + pad + right, width)];
+				},
+			};
+		});
+	});
+}

package/src/sessions.ts

@@ -16,7 +16,12 @@ import type { ExtensionAPI, ExtensionContext, SessionInfo } from "@earendil-work
 const TITLE_MAX = 60;
 
 function oneLine(text: string, max: number) {
-	const line = text.replace(/\s+/g, " ").trim();
+	// Strip markdown noise (tables, emphasis, headings) so pasted SPEC
+	// rows and the like don't become unreadable titles.
+	const line = text
+		.replace(/[|*#`>\[\]]+/g, " ")
+		.replace(/\s+/g, " ")
+		.trim();
 	return line.length > max ? `${line.slice(0, max - 1)}…` : line;
 }