@diegopetrucci/pi-extensions 0.1.39 → 0.1.40

package/README.md

@@ -9,7 +9,7 @@ A collection of [pi](https://github.com/earendil-works/pi-mono) agent extensions
 - [`context-cap`](./extensions/context-cap): Caps effective model context windows at 200k tokens by default so pi avoids the `dumb zone`; toggle temporarily with `/context-cap`.
 - [`context-inspector`](./extensions/context-inspector): Adds `/context`, a local self-contained HTML dashboard that breaks down where the current session context is going, with category overview, top offenders, and drilldown search.
 - [`dirty-repo-guard`](./extensions/dirty-repo-guard): Prompts before new sessions, session switches, or forks when the current git repo has uncommitted changes.
-- [`git-footer`](./extensions/git-footer): Standalone footer extension that replaces pi's built-in footer with a TLH-style git summary: branch, dirty counts, ahead/behind, optional PR number, session name, plus context/model status. Not auto-loaded by the collection package because it conflicts with `minimal-footer`.
+- [`git-footer`](./extensions/git-footer): Standalone extension that adds TLH-style git dirty counts, ahead/behind, and optional PR number to pi's built-in footer status area.
 - [`gnosis`](./extensions/gnosis): Exposes the `gn` repo-local knowledge base CLI as an agent tool for searching and recording durable project decisions, constraints, and intent.
 - [`inline-bash`](./extensions/inline-bash): Expands `!{command}` snippets in user prompts by running them through bash before the prompt reaches the agent.
 - [`librarian`](./extensions/librarian): Adds a GitHub research scout with a local repo checkout cache enabled by default under the OS user cache directory, toggleable with `/librarian-cache`, with cached repos expiring after 7 days of non-use.

package/extensions/git-footer/README.md

@@ -1,14 +1,15 @@
 # git-footer
 
-A TLH-style git status footer for pi.
+A TLH-style git status add-on for pi's built-in footer.
 
-This package is standalone-only and is not auto-loaded by the `@diegopetrucci/pi-extensions` collection package because only one custom footer should win.
+This package is standalone-only and is not auto-loaded by the `@diegopetrucci/pi-extensions` collection package.
 
-It replaces pi's built-in footer with a compact two-line layout whose first line mirrors how [`the-last-harness`](https://github.com/diegopetrucci/the-last-harness) summarizes repository state:
+It keeps pi's default footer intact and adds a compact git status segment through pi's extension status API:
 
 ```text
-<repo> • <branch> • <git-status> • PR #<number> • <session-name>
-ctx <percent>% • <model> <thinking> • <extension-statuses>
+~/repo (main) • session-name
+↑12k ↓3k 44.1%/200k                      model
++2 ~1 ?3 ↑1 • PR #123
 ```
 
 Git status indicators:
@@ -20,7 +21,7 @@ Git status indicators:
 - `↑N`: commits ahead of upstream
 - `↓N`: commits behind upstream
 
-The extension polls git status in the background, caches the latest snapshot, and keeps footer rendering synchronous. It also performs a best-effort `gh pr view` lookup for the current branch; if `gh` is unavailable or the branch has no PR, the PR segment is omitted.
+The extension polls git status in the background and caches the latest snapshot. It also performs a best-effort `gh pr view` lookup for the current branch; if `gh` is unavailable or the branch has no PR, the PR segment is omitted.
 
 ## Install
 
@@ -36,6 +37,7 @@ Then reload pi:
 
 ## Notes
 
-- Replaces pi's built-in footer entirely.
-- Intended as a separate footer extension; do not enable it at the same time as another custom-footer extension such as `minimal-footer` unless you want the last-loaded footer to win.
-- `render()` never spawns subprocesses. Git and GitHub CLI lookups run on a short background interval with timeouts, and the footer reads only cached snapshots.
+- Does not replace pi's built-in footer.
+- Uses `ctx.ui.setStatus()`, so pi renders the git summary with other extension statuses.
+- The current pi extension API does not support literally appending text inside the built-in footer's first `cwd (branch)` line without replacing the footer.
+- Git and GitHub CLI lookups run on a short background interval with timeouts.

package/extensions/git-footer/index.ts

@@ -1,7 +1,5 @@
 import { spawn } from "node:child_process";
-import { basename } from "node:path";
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
-import { truncateToWidth } from "@earendil-works/pi-tui";
 
 type GitStatusSnapshot = {
 	branch?: string;
@@ -48,12 +46,12 @@ type GitFooterCacheOptions = {
 	gitTimeoutMs?: number;
 	ghTimeoutMs?: number;
 	onChange?: () => void;
-	onBranchChangeSource?: (callback: () => void) => () => void;
 };
 
 const BRANCH_HEAD_PREFIX = "# branch.head ";
 const BRANCH_AB_PREFIX = "# branch.ab ";
-const FOOTER_SEPARATOR = " • ";
+const STATUS_KEY = "git-footer";
+const STATUS_SEPARATOR = " • ";
 const DEFAULT_REFRESH_INTERVAL_MS = 8_000;
 const DEFAULT_GIT_TIMEOUT_MS = 1_500;
 const DEFAULT_GH_TIMEOUT_MS = 3_000;
@@ -157,21 +155,15 @@ function formatPullRequestFooterSegment(pullRequest: PullRequestSnapshot | undef
 	return undefined;
 }
 
-function formatGitFooterSegments(
+function formatGitFooterStatus(
 	status: GitStatusSnapshot | undefined,
 	pullRequest: PullRequestSnapshot | undefined,
-): string[] {
-	const segments: string[] = [];
-	const branch = typeof status?.branch === "string" ? status.branch.trim() : "";
-	if (branch) segments.push(branch);
-
-	const statusSegment = formatGitStatusFooterSegment(status);
-	if (statusSegment) segments.push(statusSegment);
-
-	const pullRequestSegment = formatPullRequestFooterSegment(pullRequest);
-	if (pullRequestSegment) segments.push(pullRequestSegment);
-
-	return segments;
+): string | undefined {
+	const parts = [
+		formatGitStatusFooterSegment(status),
+		formatPullRequestFooterSegment(pullRequest),
+	].filter((part): part is string => !!part);
+	return parts.length > 0 ? parts.join(STATUS_SEPARATOR) : undefined;
 }
 
 function parsePullRequestJson(stdout: string): PullRequestSnapshot | undefined {
@@ -307,7 +299,6 @@ class GitFooterCache {
 	private readonly inflightControllers = new Set<AbortController>();
 	private disposed = false;
 	private refreshInFlight: Promise<void> | undefined;
-	private branchChangeUnsubscribe: (() => void) | undefined;
 	private statusSnapshot: GitStatusSnapshot | undefined;
 	private pullRequestSnapshot: PullRequestSnapshot | undefined;
 	private lastSeenBranch: string | undefined;
@@ -325,12 +316,6 @@ class GitFooterCache {
 			void this.refresh();
 		}, this.refreshIntervalMs);
 		void this.refresh();
-
-		if (options.onBranchChangeSource) {
-			this.branchChangeUnsubscribe = options.onBranchChangeSource(() => {
-				void this.refresh();
-			});
-		}
 	}
 
 	getStatusSnapshot(): GitStatusSnapshot | undefined {
@@ -453,81 +438,43 @@ class GitFooterCache {
 			this.clock.clearInterval(this.intervalHandle);
 			this.intervalHandle = undefined;
 		}
-		if (this.branchChangeUnsubscribe) {
-			try {
-				this.branchChangeUnsubscribe();
-			} catch {
-				// Ignore misbehaving notifier.
-			}
-			this.branchChangeUnsubscribe = undefined;
-		}
 		for (const controller of this.inflightControllers) controller.abort();
 		this.inflightControllers.clear();
 	}
 }
 
-function composeFooterFirstLine(input: {
-	cwd: string;
-	sessionName?: string | null;
-	status?: GitStatusSnapshot;
-	pullRequest?: PullRequestSnapshot;
-}): string {
-	const segments = [input.cwd];
-	if (input.status !== undefined) {
-		segments.push(...formatGitFooterSegments(input.status, input.pullRequest));
-	}
-	if (input.sessionName) segments.push(input.sessionName);
-	return segments.join(FOOTER_SEPARATOR);
-}
+export default function (pi: ExtensionAPI) {
+	let cache: GitFooterCache | undefined;
 
-function sanitizeFooterSegment(value: string): string {
-	return value.replace(/[\r\n\t]+/g, " ").trim();
-}
+	function disposeCache(): void {
+		cache?.dispose();
+		cache = undefined;
+	}
 
-export default function (pi: ExtensionAPI) {
 	pi.on("session_start", (_event, ctx) => {
-		let cache: GitFooterCache | undefined;
-
-		ctx.ui.setFooter((tui, theme, footerData) => {
-			cache = new GitFooterCache({
-				cwd: () => ctx.cwd,
-				onChange: () => tui.requestRender(),
-				onBranchChangeSource: (callback) => footerData.onBranchChange(callback),
-			});
+		disposeCache();
+
+		const updateStatus = () => {
+			const text = formatGitFooterStatus(
+				cache?.getStatusSnapshot(),
+				cache?.getPullRequestSnapshot(),
+			);
+			ctx.ui.setStatus(STATUS_KEY, text ? ctx.ui.theme.fg("dim", text) : undefined);
+		};
 
-			return {
-				dispose() {
-					cache?.dispose();
-					cache = undefined;
-				},
-				invalidate() {},
-				render(width: number): string[] {
-					const status = cache?.getStatusSnapshot();
-					const pullRequest = cache?.getPullRequestSnapshot();
-					const firstLine = composeFooterFirstLine({
-						cwd: basename(ctx.cwd),
-						status,
-						pullRequest,
-						sessionName: pi.getSessionName(),
-					});
-
-					const usage = ctx.getContextUsage();
-					const context = usage?.percent == null ? "ctx ?" : `ctx ${usage.percent.toFixed(1)}%`;
-					const thinking = pi.getThinkingLevel();
-					const model = ctx.model?.id ?? "no-model";
-					const modelText = thinking === "off" ? model : `${model} ${thinking}`;
-					const statuses = [...footerData.getExtensionStatuses().values()]
-						.map(sanitizeFooterSegment)
-						.filter(Boolean);
-					const secondLine = [theme.fg("dim", context), theme.fg("dim", modelText), ...statuses]
-						.join(theme.fg("dim", FOOTER_SEPARATOR));
-
-					return [
-						truncateToWidth(theme.fg("dim", firstLine), width),
-						truncateToWidth(secondLine, width),
-					];
-				},
-			};
+		cache = new GitFooterCache({
+			cwd: () => ctx.cwd,
+			onChange: updateStatus,
 		});
+		updateStatus();
+	});
+
+	pi.on("turn_end", () => {
+		void cache?.refresh();
+	});
+
+	pi.on("session_shutdown", (_event, ctx) => {
+		disposeCache();
+		ctx.ui.setStatus(STATUS_KEY, undefined);
 	});
 }

package/extensions/git-footer/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@diegopetrucci/pi-git-footer",
-  "version": "0.1.0",
-  "description": "A TLH-style git status footer for pi.",
+  "version": "0.1.1",
+  "description": "A TLH-style git status add-on for pi's built-in footer.",
   "keywords": [
     "pi-package",
     "pi",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diegopetrucci/pi-extensions",
-  "version": "0.1.39",
+  "version": "0.1.40",
   "description": "A collection of pi extensions for context management, workflow audits, review-comment triage, notifications, brrr push alerts, safety guards, GitHub research, repo-local knowledge, todos, tool rendering, and model/provider helpers.",
   "keywords": [
     "pi-package",