pi-spark 0.2.1 → 0.3.1

package/README.md

@@ -6,11 +6,11 @@ A small, opinionated collection of [pi](https://pi.dev/) extensions.
 
 ## Extensions
 
-- **Editor**: replaces the default editor with a compact working indicator (inspired by [Amp](https://ampcode.com/)) and current model info.
-- **Footer**: shows the session info, cost, and context usage in one line, followed by extension statuses.
-- **Fullscreen**: clears the screen and scrollback on session start and pins the editor and footer to the bottom for a full-screen session.
-- **Presets**: switches named model presets with `/preset`, `--preset`, and quick cycle shortcuts.
-- **Recap**: generates a short idle-session recap and exposes a `/recap` command for manual generation, inspired by [Claude Code's session recap](https://code.claude.com/docs/en/interactive-mode#session-recap).
+- **Editor:** replaces the default editor with a compact working indicator (inspired by [Amp](https://ampcode.com/)) and current model info.
+- **Footer:** shows session information, extension statuses, cost, and context usage on one line.
+- **Fullscreen:** clears the screen and scrollback on session start, pins the editor and footer to the bottom for a full-screen session, and clears again on exit.
+- **Presets:** switches named model presets with `/preset`, `--preset`, and quick cycle shortcuts.
+- **Recap:** generates a short idle-session recap and exposes a `/recap` command for manual generation, inspired by [Claude Code's session recap](https://code.claude.com/docs/en/interactive-mode#session-recap).
 
 ![Screenshot](./assets/screenshot.png)
 
@@ -65,23 +65,8 @@ Notes:
 
 - Set an extension key to `false` to disable it.
 - The `editor.spinner` value can be `dots`, `lights`, or `tildes`.
+- Fullscreen enables Pi's `clearOnShrink` behavior programmatically so the pinned editor and footer stay aligned after taller UI components close.
 - Presets can be selected with `/preset` or `/preset <key>`.
 - Start pi with a preset using `pi --preset <key>`.
 - Cycle presets with `ctrl+super+p` and `ctrl+shift+super+p` (`super` is `command` on macOS).
 - The `recap.idle` value is in milliseconds and must be at least `5000`.
-
-## Recommended pi settings
-
-The Fullscreen extension pins the editor and footer to the bottom of the terminal. For the cleanest experience, pair it with pi's `terminal.clearOnShrink` setting, which clears empty rows when content shrinks so the pinned UI does not leave stale lines behind.
-
-Add this to `~/.pi/agent/settings.json` (global) or `.pi/settings.json` (project):
-
-```json
-{
-  "terminal": {
-    "clearOnShrink": true
-  }
-}
-```
-
-This setting defaults to `false` because it can cause flicker in some terminals. With Fullscreen enabled the trade-off is usually worth it.

package/extensions/footer/index.ts

@@ -1,8 +1,10 @@
-import { isAbsolute, relative, resolve, sep } from "node:path";
+import { homedir } from "node:os";
+import { resolve } from "node:path";
+import { pathToFileURL } from "node:url";
 
 import { SplitLine } from "../shared/components/split-line";
 import { loadConfig } from "../shared/config";
-import { formatContextUsage, formatCost, sanitizeText } from "../shared/format";
+import { formatContextUsage, formatCost, formatCwd, linkText, sanitizeText } from "../shared/format";
 import { getEntryUsage } from "../shared/usage";
 
 import type { ExtensionContext, ExtensionAPI, ReadonlyFooterDataProvider, Theme } from "@earendil-works/pi-coding-agent";
@@ -31,7 +33,9 @@ class FooterComponent implements Component {
   }
 
   private getLeft(): string {
-    let text = formatCwd(this.ctx.sessionManager.getCwd(), process.env.HOME || process.env.USERPROFILE);
+    const cwd = this.ctx.sessionManager.getCwd();
+    const url = pathToFileURL(resolve(cwd));
+    let text = linkText(formatCwd(cwd, homedir()), url.href);
 
     const branch = this.footerData.getGitBranch();
     if (branch) text = `${text} [${branch}]`;
@@ -90,18 +94,6 @@ class FooterComponent implements Component {
   }
 }
 
-function formatCwd(cwd: string, home?: string): string {
-  if (!home) return cwd;
-
-  const resolvedCwd = resolve(cwd);
-  const resolvedHome = resolve(home);
-  const relativeToHome = relative(resolvedHome, resolvedCwd);
-  const isInsideHome = relativeToHome === "" || (relativeToHome !== ".." && !relativeToHome.startsWith(`..${sep}`) && !isAbsolute(relativeToHome));
-  if (!isInsideHome) return cwd;
-
-  return relativeToHome === "" ? "~" : `~${sep}${relativeToHome}`;
-}
-
 export default function (pi: ExtensionAPI) {
   pi.on("session_start", (_event, ctx) => {
     if (!ctx.hasUI) return;

package/extensions/fullscreen/index.ts

@@ -1,24 +1,71 @@
+import { VERSION } from "@earendil-works/pi-coding-agent";
+
 import { BottomFiller } from "./filler";
 import { loadConfig } from "../shared/config";
+import { sanitizeText } from "../shared/format";
+
+import type { ExtensionAPI, ExtensionContext, Theme } from "@earendil-works/pi-coding-agent";
+import { truncateToWidth } from "@earendil-works/pi-tui";
 
-import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
 import type { TUI } from "@earendil-works/pi-tui";
+import type { UserMessage } from "@earendil-works/pi-ai";
 
 const WIDGET_KEY = "fullscreen";
 
+function getSessionDisplayText(ctx: ExtensionContext, theme: Theme): string | undefined {
+  const sessionName = ctx.sessionManager.getSessionName();
+  if (sessionName) return theme.fg("warning", sanitizeText(sessionName));
+
+  for (const entry of ctx.sessionManager.getEntries()) {
+    if (entry.type !== "message" || entry.message.role !== "user") continue;
+
+    const text = extractText(entry.message);
+    if (text) return sanitizeText(text);
+  }
+
+  return undefined;
+}
+
+function extractText(message: UserMessage): string {
+  const content = message.content;
+  if (typeof content === "string") return content;
+
+  return content.filter((block) => block.type === "text").map((block) => block.text).join(" ");
+}
+
 export default function (pi: ExtensionAPI) {
   let tui: TUI | undefined;
+  let enabled = false;
   let pendingClear = false;
+  let previousClearOnShrink: boolean | undefined;
 
-  /**
-   * Mount a persistent filler above the editor. The widget factory receives the TUI handle
-   * (otherwise unavailable via `ctx.ui`), so it both captures the TUI for clearing and pins the
-   * editor and footer to the bottom of the screen.
-   */
-  function mountFiller(ctx: ExtensionContext): void {
+  pi.on("session_start", (_event, ctx) => {
+    if (!ctx.hasUI) return;
+
+    const config = loadConfig(ctx, "fullscreen");
+    if (!config) return;
+
+    enabled = true;
+    pendingClear = true;
+
+    // The TUI handle isn't exposed via `ctx.ui`; the widget factory is the only place that
+    // receives it. Mounting a persistent filler above the editor both captures the TUI and
+    // pins the editor and footer to the bottom of the screen.
     ctx.ui.setWidget(WIDGET_KEY, (capturedTui) => {
       tui = capturedTui;
 
+      // Enable `clearOnShrink`, but defer it to a macrotask. On `/reload`, pi resets
+      // `clearOnShrink` to the settings value right after `session_start`, inside the reload's
+      // microtask continuation. A `setTimeout` callback runs only after that microtask queue
+      // drains, so it lands last and sticks. `queueMicrotask` (or a synchronous call) would run
+      // before the reset and get clobbered.
+      previousClearOnShrink ??= capturedTui.getClearOnShrink();
+      setTimeout(() => capturedTui.setClearOnShrink(true));
+
+      // Clear the screen once on entry. `session_start` has no TUI to repaint with, and a
+      // synchronous repaint here is too early (the filler isn't in the render tree until
+      // `setWidget` returns), so defer to a microtask. `pendingClear` limits this to the
+      // `session_start`-triggered mount rather than every widget rebuild.
       if (pendingClear) {
         pendingClear = false;
         queueMicrotask(() => capturedTui.requestRender(true));
@@ -26,22 +73,33 @@ export default function (pi: ExtensionAPI) {
 
       return new BottomFiller(capturedTui);
     });
-  }
+  });
 
-  pi.on("session_start", (_event, ctx) => {
-    if (!ctx.hasUI) return;
+  pi.on("session_shutdown", (event, ctx) => {
+    if (!enabled) return;
 
-    const config = loadConfig(ctx, "fullscreen");
-    if (!config) return;
+    // Restore `clearOnShrink` to its pre-fullscreen value.
+    if (previousClearOnShrink !== undefined) {
+      tui?.setClearOnShrink(previousClearOnShrink);
+      previousClearOnShrink = undefined;
+    }
+
+    if (event.reason === "quit" && tui) {
+      // On normal interactive quit, shutdown handlers run after pi stops the TUI, so
+      // `requestRender(true)` can no longer repaint. Write the clear sequence directly: clear
+      // screen, move home, then clear scrollback.
+      tui.terminal.write("\x1b[2J\x1b[H\x1b[3J");
 
-    if (tui) {
-      // Force a full repaint, which resets the TUI's diff state and clears the screen and
-      // scrollback (`\x1b[2J\x1b[H\x1b[3J`), just like the built-in `clearOnShrink` behavior.
-      tui.requestRender(true);
-      return;
+      // Leave one concise line after the cleared session.
+      const theme = ctx.ui.theme;
+      const exitMessage = `${theme.bold(theme.fg("accent", "pi"))} ${theme.fg("dim", `v${VERSION} exited`)}`;
+      const sessionText = getSessionDisplayText(ctx, theme);
+      const line = truncateToWidth(`${exitMessage}${sessionText ? `${theme.fg("dim", ":")} ${sessionText}` : ""}`, tui.terminal.columns, "…");
+      tui.terminal.write(`${line}\r\n`);
     }
 
-    pendingClear = true;
-    mountFiller(ctx);
+    tui = undefined;
+    enabled = false;
+    pendingClear = false;
   });
 }

package/extensions/shared/format/index.ts

@@ -1,3 +1,5 @@
+import { isAbsolute, relative, resolve, sep } from "node:path";
+
 import type { Provider } from "@earendil-works/pi-ai";
 import type { ContextUsage } from "@earendil-works/pi-coding-agent";
 
@@ -26,6 +28,32 @@ export function formatCost(cost: number, isSubscription: boolean): string {
   return `$${cost.toFixed(2)}${isSubscription ? " (sub)" : ""}`;
 }
 
+export function formatCwd(cwd: string, home: string): string {
+  const resolvedCwd = resolve(cwd);
+  const resolvedHome = resolve(home);
+  const relativeToHome = relative(resolvedHome, resolvedCwd);
+  const isInsideHome = relativeToHome === "" || (relativeToHome !== ".." && !relativeToHome.startsWith(`..${sep}`) && !isAbsolute(relativeToHome));
+  const displayCwd = isInsideHome ? (relativeToHome === "" ? "~" : `~${sep}${relativeToHome}`) : resolvedCwd;
+
+  return shortenPath(displayCwd);
+}
+
+/** Shorten every path component except the first and last to one character, like fish `prompt_pwd`. */
+function shortenPath(path: string): string {
+  const parts = path.split(sep);
+  const lastIndex = parts.length - 1;
+
+  return parts.map((part, index) => {
+    if (!part || index === 0 || index === lastIndex) return part;
+    return Array.from(part)[0] ?? part;
+  }).join(sep);
+}
+
+/** Wrap text in an OSC 8 hyperlink while preserving the visible text. */
+export function linkText(text: string, url: string): string {
+  return `\x1b]8;;${url}\x07${text}\x1b]8;;\x07`;
+}
+
 /** Replace newlines, tabs, carriage returns with space, then collapse multiple spaces */
 export function sanitizeText(text: string): string {
   return text

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-spark",
-  "version": "0.2.1",
+  "version": "0.3.1",
   "description": "A small, opinionated collection of pi extensions",
   "keywords": [
     "pi-coding-agent",