killeros 2.1.29 → 2.1.31

package/killeros/footer.ts

@@ -1,505 +1,505 @@
-import { execFile } from "node:child_process";
-import { watch } from "node:fs";
-import path from "node:path";
-import { type ExtensionAPI, type ExtensionContext, type Theme, type ThemeColor } from "@earendil-works/pi-coding-agent";
-import { truncateToWidth, visibleWidth, type TUI } from "@earendil-works/pi-tui";
-import { isCodexFastEnabled, subscribeCodexFast } from "./codex-fast-state.ts";
-import { formatCwd, formatTime, modelDisplayName, padRight } from "./display.ts";
-import { inspectWorktreeWithoutFilters, passiveGitCommand, passiveGitEnv, type PassiveGitRunner } from "./passive-git-status.ts";
-import { goalElapsedMilliseconds } from "./goal-state.ts";
-import type { GoalRuntime, GoalState } from "./runtime.ts";
-import { safeTerminalText } from "./safe-terminal-text.ts";
-import { LEVEL_COLORS, type ThinkingLevel } from "./variants.ts";
-
-const GIT_STATUS_REFRESH_INTERVAL_MS = 30_000;
-const GIT_STATUS_TIMEOUT_MS = 5_000;
-const GIT_STATUS_WATCH_DEBOUNCE_MS = 250;
-const GIT_STATUS_WATCH_INTERVAL_MS = 5_000;
-const CODEX_PROVIDER = "openai-codex";
-export const colorDirectory = (text: string): string => `\x1B[38;2;240;248;154m${text}\x1B[39m`;
-
-export interface GitFileChanges {
-  modified: number;
-  added: number;
-  deleted: number;
-}
-
-type GitStatusExecutor = (
-  file: string,
-  args: string[],
-  options: {
-    encoding: "utf8";
-    env: NodeJS.ProcessEnv;
-    maxBuffer: number;
-    timeout: number;
-    windowsHide: true;
-  },
-  callback: (error: Error | null, stdout: string) => void,
-) => unknown;
-
-/** Resolves changed-file counts without asking Git to inspect worktree content. */
-export async function resolveGitFileChanges(
-  cwd: string,
-  execute: GitStatusExecutor = execFile,
-  trusted = true,
-): Promise<GitFileChanges | undefined> {
-  if (!trusted) return undefined;
-  try {
-    const gitCommand = passiveGitCommand(cwd);
-    if (!gitCommand) return undefined;
-    const options = {
-      encoding: "utf8" as const,
-      env: passiveGitEnv(),
-      maxBuffer: 4 * 1024 * 1024,
-      timeout: GIT_STATUS_TIMEOUT_MS,
-      windowsHide: true as const,
-    };
-    const runAt = (directory: string): PassiveGitRunner => (args) => new Promise((resolve, reject) => {
-      execute(gitCommand, ["-C", directory, ...args], options, (error, stdout) => {
-        if (error) reject(error);
-        else resolve(Buffer.from(stdout));
-      });
-    });
-    const initialRunner = runAt(cwd);
-    const root = new TextDecoder("utf-8", { fatal: true }).decode(
-      await initialRunner(["rev-parse", "--path-format=absolute", "--show-toplevel"]),
-    ).trim();
-    if (!path.isAbsolute(root)) return undefined;
-    const snapshot = await inspectWorktreeWithoutFilters(root, runAt(root));
-    const changes: GitFileChanges = { modified: 0, added: 0, deleted: 0 };
-    const deletedObjectIds: string[] = [];
-    const addedObjectIds: string[] = [];
-    for (const file of snapshot.files.values()) {
-      if (!file.mode) {
-        changes.deleted += 1;
-        if (!file.indexMode && file.headObjectId) deletedObjectIds.push(file.headObjectId);
-      } else if (!file.headMode) {
-        changes.added += 1;
-        if (file.indexObjectId) addedObjectIds.push(file.indexObjectId);
-      } else changes.modified += 1;
-    }
-    for (const objectId of deletedObjectIds) {
-      const match = addedObjectIds.indexOf(objectId);
-      if (match < 0) continue;
-      addedObjectIds.splice(match, 1);
-      changes.deleted -= 1;
-      changes.added -= 1;
-      changes.modified += 1;
-    }
-    return changes;
-  } catch {
-    return undefined;
-  }
-}
-
-async function resolveUncommittedFileCount(cwd: string): Promise<number | undefined> {
-  const changes = await resolveGitFileChanges(cwd);
-  return changes && changes.modified + changes.added + changes.deleted;
-}
-
-function createGitRefresh<T>(
-  cwd: string,
-  onResult: (result: T | undefined) => void,
-  resolveResult: (cwd: string) => Promise<T | undefined>,
-): { request: () => void; dispose: () => void } {
-  let disposed = false;
-  let pending = false;
-  let queued = false;
-  const request = (): void => {
-    if (disposed) return;
-    if (pending) {
-      queued = true;
-      return;
-    }
-    pending = true;
-    let result: Promise<T | undefined>;
-    try {
-      result = resolveResult(cwd);
-    } catch {
-      result = Promise.resolve(undefined);
-    }
-    void result.then(
-      (value) => { if (!disposed) onResult(value); },
-      () => { if (!disposed) onResult(undefined); },
-    ).finally(() => {
-      pending = false;
-      if (!disposed && queued) {
-        queued = false;
-        request();
-      }
-    });
-  };
-  return {
-    request,
-    dispose() {
-      disposed = true;
-      queued = false;
-    },
-  };
-}
-
-/** Coalesces Git status requests to one active scan and one queued follow-up. */
-export function createGitStatusRefresh(
-  cwd: string,
-  onCount: (count: number | undefined) => void,
-  resolveCount: (cwd: string) => Promise<number | undefined> = resolveUncommittedFileCount,
-): { request: () => void; dispose: () => void } {
-  return createGitRefresh(cwd, onCount, resolveCount);
-}
-
-/** Coalesces file-change scans and emits only successful results. */
-export function createGitFileChangesRefresh(
-  cwd: string,
-  onChanges: (changes: GitFileChanges) => void,
-  resolveChanges: (cwd: string) => Promise<GitFileChanges | undefined> = resolveGitFileChanges,
-): { request: () => void; dispose: () => void } {
-  return createGitRefresh(cwd, (changes) => {
-    if (changes !== undefined) onChanges(changes);
-  }, resolveChanges);
-}
-
-type ScheduleFallback = (refresh: () => void, intervalMs: number) => () => void;
-type WatchDirectory = (cwd: string, onChange: () => void, onError: () => void) => () => void;
-type ScheduleDelay = (refresh: () => void, delayMs: number) => () => void;
-
-const scheduleFallback: ScheduleFallback = (refresh, intervalMs) => {
-  const timer = setInterval(refresh, intervalMs);
-  timer.unref?.();
-  return () => clearInterval(timer);
-};
-
-const watchDirectory: WatchDirectory = (cwd, onChange, onError) => {
-  const watcher = watch(cwd, { recursive: true }, onChange);
-  watcher.on("error", onError);
-  return () => watcher.close();
-};
-
-const scheduleDelay: ScheduleDelay = (refresh, delayMs) => {
-  const timer = setTimeout(refresh, delayMs);
-  timer.unref?.();
-  return () => clearTimeout(timer);
-};
-
-/** Schedules the fallback Git scan independently from footer rendering. */
-export function scheduleGitStatusFallback(
-  refresh: () => void,
-  schedule: ScheduleFallback = scheduleFallback,
-): () => void {
-  return schedule(refresh, GIT_STATUS_REFRESH_INTERVAL_MS);
-}
-
-/** Throttles filesystem changes and falls back silently when watching is unavailable. */
-export function scheduleGitStatusWatch(
-  cwd: string,
-  refresh: () => void,
-  startWatching: WatchDirectory = watchDirectory,
-  schedule: ScheduleDelay = scheduleDelay,
-): () => void {
-  let disposed = false;
-  let coolingDown = false;
-  let queued = false;
-  let stopTimer: (() => void) | undefined;
-  let stopWatching: (() => void) | undefined;
-  const stop = (): void => {
-    if (disposed) return;
-    disposed = true;
-    stopTimer?.();
-    stopTimer = undefined;
-    stopWatching?.();
-    stopWatching = undefined;
-  };
-  const changed = (): void => {
-    if (disposed) return;
-    if (stopTimer) {
-      if (coolingDown) queued = true;
-      return;
-    }
-    stopTimer = schedule(() => {
-      stopTimer = undefined;
-      if (disposed) return;
-      refresh();
-      coolingDown = true;
-      stopTimer = schedule(() => {
-        stopTimer = undefined;
-        coolingDown = false;
-        if (queued) {
-          queued = false;
-          changed();
-        }
-      }, GIT_STATUS_WATCH_INTERVAL_MS);
-    }, GIT_STATUS_WATCH_DEBOUNCE_MS);
-  };
-  try {
-    stopWatching = startWatching(cwd, changed, stop);
-  } catch {
-    disposed = true;
-  }
-  return stop;
-}
-
-export function formatCost(usd: number): string {
-  if (!Number.isFinite(usd)) return "$—";
-  return `$${usd.toFixed(2)}`;
-}
-
-export function contextPercentRemaining(ctx: ExtensionContext): number | null {
-  let usage: ReturnType<ExtensionContext["getContextUsage"]>;
-  try {
-    usage = ctx.getContextUsage();
-  } catch {
-    return null;
-  }
-  if (!usage || !Number.isFinite(usage.contextWindow) || usage.contextWindow <= 0) return null;
-  if (usage.tokens === null || !Number.isFinite(usage.tokens)) return null;
-
-  const percentRemaining = ((usage.contextWindow - Math.max(0, usage.tokens)) / usage.contextWindow) * 100;
-  return Math.round(Math.max(0, Math.min(100, percentRemaining)));
-}
-
-export function formatContextProgress(tokensUsed: number | null, contextWindow: number, theme: Theme): string {
-  if (tokensUsed === null || !Number.isFinite(tokensUsed)) return theme.fg("dim", "ctx —%");
-  const windowSize = Number.isFinite(contextWindow) && contextWindow > 0 ? contextWindow : 128_000;
-  const used = Math.max(0, Math.min(windowSize, Math.max(0, tokensUsed)));
-  const percentUsed = Math.max(0, Math.min(100, Math.round((used / windowSize) * 100)));
-  const color: ThemeColor = percentUsed > 80 ? "error" : percentUsed >= 50 ? "warning" : "success";
-  const action = percentUsed >= 85 ? " · /compact" : "";
-  return theme.fg(color, `ctx ${percentUsed}%${action}`);
-}
-
-function sumSessionCost(ctx: ExtensionContext): number {
-  let total = 0;
-  for (const entry of ctx.sessionManager.getEntries()) {
-    if (entry.type === "message" && entry.message.role === "assistant") total += entry.message.usage.cost.total;
-    else if (entry.type === "message" && entry.message.role === "toolResult" && entry.message.usage) {
-      total += entry.message.usage.cost.total;
-    } else if ((entry.type === "compaction" || entry.type === "branch_summary") && entry.usage) {
-      total += entry.usage.cost.total;
-    }
-  }
-  return total;
-}
-
-const PROVIDER_LABELS: Readonly<Record<string, string>> = {
-  "amazon-bedrock": "Amazon Bedrock",
-  "azure-openai-responses": "Azure OpenAI",
-  "github-copilot": "GitHub Copilot",
-  "google-vertex": "Google Vertex",
-  "openai-codex": "OpenAI",
-  anthropic: "Anthropic",
-  deepseek: "DeepSeek",
-  google: "Google",
-  ollama: "Ollama",
-  openai: "OpenAI",
-  openrouter: "OpenRouter",
-};
-
-function formatProviderName(provider: string): string {
-  const normalized = safeTerminalText(provider).replaceAll("\n", "").trim();
-  const known = PROVIDER_LABELS[normalized.toLowerCase()];
-  if (known) return known.toLowerCase();
-  return normalized.toLowerCase().split(/[-_]+/u).filter(Boolean).join(" ") || "unknown provider";
-}
-
-export function formatModel(
-  model: ExtensionContext["model"],
-  theme: Theme,
-  includeProvider = true,
-  showCodexFast = false,
-): string {
-  if (!model) return theme.fg("dim", "no model");
-  const displayName = modelDisplayName(model) || "unknown model";
-  const name = theme.fg("text", displayName);
-  const fast = showCodexFast && model.provider === CODEX_PROVIDER ? theme.fg("text", "fast") : "";
-  const provider = includeProvider ? theme.fg("dim", formatProviderName(model.provider)) : "";
-  return [name, fast, provider].filter(Boolean).join(" ");
-}
-
-function compactDirectory(cwd: string): string {
-  if (cwd === "~" || cwd === "/" || /^[A-Za-z]:[\\/]?$/u.test(cwd)) return cwd;
-  const normalized = cwd.replace(/\\/gu, "/").replace(/\/$/u, "");
-  const finalSegment = normalized.split("/").at(-1);
-  return finalSegment ? `…/${finalSegment}` : cwd;
-}
-
-function joinFooterParts(parts: string[], theme: Theme): string {
-  return parts.filter(Boolean).join(theme.fg("dim", " · "));
-}
-
-function footerRowFits(left: string, right: string, width: number): boolean {
-  const contentWidth = visibleWidth(left) + (right ? visibleWidth(right) + 1 : 0);
-  return contentWidth + 2 <= width;
-}
-
-function renderFooterRow(left: string, right: string, width: number): string {
-  if (width <= 0) return "";
-  if (width < 3) return " ".repeat(width);
-
-  const innerWidth = width - 2;
-  if (!right) return ` ${padRight(left, innerWidth)} `;
-
-  const clippedRight = truncateToWidth(right, innerWidth, "");
-  const rightWidth = visibleWidth(clippedRight);
-  const leftBudget = Math.max(0, innerWidth - rightWidth - 1);
-  const clippedLeft = truncateToWidth(left, leftBudget, "…");
-  const gap = " ".repeat(Math.max(0, innerWidth - visibleWidth(clippedLeft) - rightWidth));
-  return ` ${clippedLeft}${gap}${clippedRight} `;
-}
-
-function renderFooter(rows: string[], width: number, theme: Theme): string[] {
-  return [theme.fg("borderMuted", "─".repeat(width)), ...rows];
-}
-
-function formatGoalFooter(state: GoalState | undefined, theme: Theme): string {
-  if (!state) return "";
-  if (state.status === "active") {
-    const detail = state.maxTurns === undefined
-      ? `${state.turns} turn${state.turns === 1 ? "" : "s"} · ${formatTime(goalElapsedMilliseconds(state, Date.now()))}`
-      : `${state.turns}/${state.maxTurns} · ${formatTime(goalElapsedMilliseconds(state, Date.now()))}`;
-    return `${theme.fg("customMessageLabel", "/goal active")}${theme.fg("dim", ` · ${detail}`)}`;
-  }
-  if (state.status === "paused") return theme.fg("warning", "/goal paused");
-  if (state.status === "blocked") return theme.fg("error", "/goal blocked");
-  return "";
-}
-
-function formatGitFileChanges(changes: GitFileChanges, theme: Theme): string {
-  const total = changes.modified + changes.added + changes.deleted;
-  if (total === 0) return "";
-  return `${theme.fg("dim", `±${total} [`)}${theme.fg("warning", `~${changes.modified}`)} ${theme.fg("success", `+${changes.added}`)} ${theme.fg("error", `−${changes.deleted}`)}${theme.fg("dim", "]")}`;
-}
-
-export function registerFooter(pi: ExtensionAPI, goalRuntime: GoalRuntime): void {
-  let currentModel: ExtensionContext["model"];
-  let thinkingLevel: ThinkingLevel = "off";
-  let activeTui: TUI | undefined;
-  let cachedSessionCost = 0;
-  let sessionCostDirty = true;
-  let unsubscribeCodexFast: (() => void) | undefined;
-  const resetSessionCost = (): void => {
-    cachedSessionCost = 0;
-    sessionCostDirty = true;
-  };
-  const invalidateSessionCost = (): void => {
-    sessionCostDirty = true;
-    activeTui?.requestRender();
-  };
-  const getSessionCost = (ctx: ExtensionContext): number => {
-    if (sessionCostDirty) {
-      cachedSessionCost = sumSessionCost(ctx);
-      sessionCostDirty = false;
-    }
-    return cachedSessionCost;
-  };
-  goalRuntime.requestRender = () => activeTui?.requestRender();
-
-  pi.on("session_start", (_event, ctx) => {
-    resetSessionCost();
-    if (ctx.mode !== "tui") return;
-    unsubscribeCodexFast?.();
-    unsubscribeCodexFast = subscribeCodexFast(() => activeTui?.requestRender());
-    const sessionStart = Date.now();
-    currentModel = ctx.model;
-    thinkingLevel = pi.getThinkingLevel();
-    const cwd = formatCwd(ctx.cwd);
-
-    ctx.ui.setFooter((tui, theme, footerData) => {
-      activeTui = tui;
-      let gitFileChanges: GitFileChanges | undefined;
-      const gitStatus = createGitFileChangesRefresh(ctx.cwd, (changes) => {
-        if (JSON.stringify(changes) === JSON.stringify(gitFileChanges)) return;
-        gitFileChanges = changes;
-        tui.requestRender();
-      }, (cwd) => resolveGitFileChanges(cwd, execFile, ctx.isProjectTrusted()));
-      const unsubscribe = footerData.onBranchChange(() => {
-        gitStatus.request();
-        tui.requestRender();
-      });
-      gitStatus.request();
-      const stopWatch = scheduleGitStatusWatch(ctx.cwd, gitStatus.request);
-      const stopFallback = scheduleGitStatusFallback(gitStatus.request);
-      return {
-        dispose() {
-          unsubscribe();
-          stopWatch();
-          stopFallback();
-          gitStatus.dispose();
-          if (activeTui === tui) activeTui = undefined;
-        },
-        invalidate() {},
-        render(width: number): string[] {
-          if (width <= 0) return [];
-          const model = currentModel ?? ctx.model;
-          const level = model?.reasoning === false
-            ? theme.fg("thinkingOff", "no reasoning")
-            : theme.fg(LEVEL_COLORS[thinkingLevel], thinkingLevel);
-          let usage: ReturnType<ExtensionContext["getContextUsage"]>;
-          try {
-            usage = ctx.getContextUsage();
-          } catch {
-            usage = undefined;
-          }
-          const contextWindow = usage?.contextWindow ?? model?.contextWindow ?? 128_000;
-          const context = formatContextProgress(usage?.tokens ?? null, contextWindow, theme);
-          const branch = footerData.getGitBranch();
-          const signature = formatModel(model, theme, true, isCodexFastEnabled());
-          const fullDirectory = colorDirectory(cwd);
-          const focusedDirectory = colorDirectory(compactDirectory(cwd));
-          const goal = formatGoalFooter(goalRuntime.state, theme);
-          const primary = joinFooterParts([
-            signature,
-            level,
-            context,
-          ], theme);
-          const primaryFocused = joinFooterParts([signature, context], theme);
-          const session = joinFooterParts([
-            theme.fg("dim", formatTime(Date.now() - sessionStart)),
-            theme.fg("dim", formatCost(getSessionCost(ctx))),
-          ], theme);
-          const essentialModel = formatModel(model, theme, false, isCodexFastEnabled());
-          const primaryRow = footerRowFits(primary, session, width)
-            ? renderFooterRow(primary, session, width)
-            : footerRowFits(primary, "", width)
-              ? renderFooterRow(primary, "", width)
-              : footerRowFits(primaryFocused, "", width)
-                ? renderFooterRow(primaryFocused, "", width)
-                : renderFooterRow(essentialModel, context, width);
-          const changes = gitFileChanges ? formatGitFileChanges(gitFileChanges, theme) : "";
-          const branchLabel = branch
-            ? `${theme.fg("dim", branch)}${changes ? `${theme.fg("dim", " · ")}${changes}` : ""}`
-            : "";
-          const workspaceRight = goal || fullDirectory;
-          const secondaryRow = footerRowFits(branchLabel, workspaceRight, width)
-            ? renderFooterRow(branchLabel, workspaceRight, width)
-            : goal
-              ? renderFooterRow("", goal, width)
-              : footerRowFits(branchLabel, focusedDirectory, width)
-                ? renderFooterRow(branchLabel, focusedDirectory, width)
-                : renderFooterRow(branchLabel, "", width);
-          return renderFooter([primaryRow, secondaryRow], width, theme);
-        },
-      };
-    });
-  });
-
-  pi.on("model_select", (event) => {
-    currentModel = event.model;
-    activeTui?.requestRender();
-  });
-  pi.on("thinking_level_select", (event) => {
-    thinkingLevel = event.level;
-    activeTui?.requestRender();
-  });
-  pi.on("turn_end", invalidateSessionCost);
-  pi.on("session_compact", invalidateSessionCost);
-  pi.on("session_tree", () => {
-    resetSessionCost();
-    activeTui?.requestRender();
-  });
-  pi.on("session_shutdown", () => {
-    unsubscribeCodexFast?.();
-    unsubscribeCodexFast = undefined;
-    resetSessionCost();
-    activeTui = undefined;
-    goalRuntime.requestRender = undefined;
-  });
-}
+import { execFile } from "node:child_process";
+import { watch } from "node:fs";
+import path from "node:path";
+import { type ExtensionAPI, type ExtensionContext, type Theme, type ThemeColor } from "@earendil-works/pi-coding-agent";
+import { truncateToWidth, visibleWidth, type TUI } from "@earendil-works/pi-tui";
+import { isCodexFastEnabled, subscribeCodexFast } from "./codex-fast-state.ts";
+import { formatCwd, formatTime, modelDisplayName, padRight } from "./display.ts";
+import { inspectWorktreeWithoutFilters, passiveGitCommand, passiveGitEnv, type PassiveGitRunner } from "./passive-git-status.ts";
+import { goalElapsedMilliseconds } from "./goal-state.ts";
+import type { GoalRuntime, GoalState } from "./runtime.ts";
+import { safeTerminalText } from "./safe-terminal-text.ts";
+import { LEVEL_COLORS, type ThinkingLevel } from "./variants.ts";
+
+const GIT_STATUS_REFRESH_INTERVAL_MS = 30_000;
+const GIT_STATUS_TIMEOUT_MS = 5_000;
+const GIT_STATUS_WATCH_DEBOUNCE_MS = 250;
+const GIT_STATUS_WATCH_INTERVAL_MS = 5_000;
+const CODEX_PROVIDER = "openai-codex";
+export const colorDirectory = (text: string): string => `\x1B[38;2;240;248;154m${text}\x1B[39m`;
+
+export interface GitFileChanges {
+  modified: number;
+  added: number;
+  deleted: number;
+}
+
+type GitStatusExecutor = (
+  file: string,
+  args: string[],
+  options: {
+    encoding: "utf8";
+    env: NodeJS.ProcessEnv;
+    maxBuffer: number;
+    timeout: number;
+    windowsHide: true;
+  },
+  callback: (error: Error | null, stdout: string) => void,
+) => unknown;
+
+/** Resolves changed-file counts without asking Git to inspect worktree content. */
+export async function resolveGitFileChanges(
+  cwd: string,
+  execute: GitStatusExecutor = execFile,
+  trusted = true,
+): Promise<GitFileChanges | undefined> {
+  if (!trusted) return undefined;
+  try {
+    const gitCommand = passiveGitCommand(cwd);
+    if (!gitCommand) return undefined;
+    const options = {
+      encoding: "utf8" as const,
+      env: passiveGitEnv(),
+      maxBuffer: 4 * 1024 * 1024,
+      timeout: GIT_STATUS_TIMEOUT_MS,
+      windowsHide: true as const,
+    };
+    const runAt = (directory: string): PassiveGitRunner => (args) => new Promise((resolve, reject) => {
+      execute(gitCommand, ["-C", directory, ...args], options, (error, stdout) => {
+        if (error) reject(error);
+        else resolve(Buffer.from(stdout));
+      });
+    });
+    const initialRunner = runAt(cwd);
+    const root = new TextDecoder("utf-8", { fatal: true }).decode(
+      await initialRunner(["rev-parse", "--path-format=absolute", "--show-toplevel"]),
+    ).trim();
+    if (!path.isAbsolute(root)) return undefined;
+    const snapshot = await inspectWorktreeWithoutFilters(root, runAt(root));
+    const changes: GitFileChanges = { modified: 0, added: 0, deleted: 0 };
+    const deletedObjectIds: string[] = [];
+    const addedObjectIds: string[] = [];
+    for (const file of snapshot.files.values()) {
+      if (!file.mode) {
+        changes.deleted += 1;
+        if (!file.indexMode && file.headObjectId) deletedObjectIds.push(file.headObjectId);
+      } else if (!file.headMode) {
+        changes.added += 1;
+        if (file.indexObjectId) addedObjectIds.push(file.indexObjectId);
+      } else changes.modified += 1;
+    }
+    for (const objectId of deletedObjectIds) {
+      const match = addedObjectIds.indexOf(objectId);
+      if (match < 0) continue;
+      addedObjectIds.splice(match, 1);
+      changes.deleted -= 1;
+      changes.added -= 1;
+      changes.modified += 1;
+    }
+    return changes;
+  } catch {
+    return undefined;
+  }
+}
+
+async function resolveUncommittedFileCount(cwd: string): Promise<number | undefined> {
+  const changes = await resolveGitFileChanges(cwd);
+  return changes && changes.modified + changes.added + changes.deleted;
+}
+
+function createGitRefresh<T>(
+  cwd: string,
+  onResult: (result: T | undefined) => void,
+  resolveResult: (cwd: string) => Promise<T | undefined>,
+): { request: () => void; dispose: () => void } {
+  let disposed = false;
+  let pending = false;
+  let queued = false;
+  const request = (): void => {
+    if (disposed) return;
+    if (pending) {
+      queued = true;
+      return;
+    }
+    pending = true;
+    let result: Promise<T | undefined>;
+    try {
+      result = resolveResult(cwd);
+    } catch {
+      result = Promise.resolve(undefined);
+    }
+    void result.then(
+      (value) => { if (!disposed) onResult(value); },
+      () => { if (!disposed) onResult(undefined); },
+    ).finally(() => {
+      pending = false;
+      if (!disposed && queued) {
+        queued = false;
+        request();
+      }
+    });
+  };
+  return {
+    request,
+    dispose() {
+      disposed = true;
+      queued = false;
+    },
+  };
+}
+
+/** Coalesces Git status requests to one active scan and one queued follow-up. */
+export function createGitStatusRefresh(
+  cwd: string,
+  onCount: (count: number | undefined) => void,
+  resolveCount: (cwd: string) => Promise<number | undefined> = resolveUncommittedFileCount,
+): { request: () => void; dispose: () => void } {
+  return createGitRefresh(cwd, onCount, resolveCount);
+}
+
+/** Coalesces file-change scans and emits only successful results. */
+export function createGitFileChangesRefresh(
+  cwd: string,
+  onChanges: (changes: GitFileChanges) => void,
+  resolveChanges: (cwd: string) => Promise<GitFileChanges | undefined> = resolveGitFileChanges,
+): { request: () => void; dispose: () => void } {
+  return createGitRefresh(cwd, (changes) => {
+    if (changes !== undefined) onChanges(changes);
+  }, resolveChanges);
+}
+
+type ScheduleFallback = (refresh: () => void, intervalMs: number) => () => void;
+type WatchDirectory = (cwd: string, onChange: () => void, onError: () => void) => () => void;
+type ScheduleDelay = (refresh: () => void, delayMs: number) => () => void;
+
+const scheduleFallback: ScheduleFallback = (refresh, intervalMs) => {
+  const timer = setInterval(refresh, intervalMs);
+  timer.unref?.();
+  return () => clearInterval(timer);
+};
+
+const watchDirectory: WatchDirectory = (cwd, onChange, onError) => {
+  const watcher = watch(cwd, { recursive: true }, onChange);
+  watcher.on("error", onError);
+  return () => watcher.close();
+};
+
+const scheduleDelay: ScheduleDelay = (refresh, delayMs) => {
+  const timer = setTimeout(refresh, delayMs);
+  timer.unref?.();
+  return () => clearTimeout(timer);
+};
+
+/** Schedules the fallback Git scan independently from footer rendering. */
+export function scheduleGitStatusFallback(
+  refresh: () => void,
+  schedule: ScheduleFallback = scheduleFallback,
+): () => void {
+  return schedule(refresh, GIT_STATUS_REFRESH_INTERVAL_MS);
+}
+
+/** Throttles filesystem changes and falls back silently when watching is unavailable. */
+export function scheduleGitStatusWatch(
+  cwd: string,
+  refresh: () => void,
+  startWatching: WatchDirectory = watchDirectory,
+  schedule: ScheduleDelay = scheduleDelay,
+): () => void {
+  let disposed = false;
+  let coolingDown = false;
+  let queued = false;
+  let stopTimer: (() => void) | undefined;
+  let stopWatching: (() => void) | undefined;
+  const stop = (): void => {
+    if (disposed) return;
+    disposed = true;
+    stopTimer?.();
+    stopTimer = undefined;
+    stopWatching?.();
+    stopWatching = undefined;
+  };
+  const changed = (): void => {
+    if (disposed) return;
+    if (stopTimer) {
+      if (coolingDown) queued = true;
+      return;
+    }
+    stopTimer = schedule(() => {
+      stopTimer = undefined;
+      if (disposed) return;
+      refresh();
+      coolingDown = true;
+      stopTimer = schedule(() => {
+        stopTimer = undefined;
+        coolingDown = false;
+        if (queued) {
+          queued = false;
+          changed();
+        }
+      }, GIT_STATUS_WATCH_INTERVAL_MS);
+    }, GIT_STATUS_WATCH_DEBOUNCE_MS);
+  };
+  try {
+    stopWatching = startWatching(cwd, changed, stop);
+  } catch {
+    disposed = true;
+  }
+  return stop;
+}
+
+export function formatCost(usd: number): string {
+  if (!Number.isFinite(usd)) return "$—";
+  return `$${usd.toFixed(2)}`;
+}
+
+export function contextPercentRemaining(ctx: ExtensionContext): number | null {
+  let usage: ReturnType<ExtensionContext["getContextUsage"]>;
+  try {
+    usage = ctx.getContextUsage();
+  } catch {
+    return null;
+  }
+  if (!usage || !Number.isFinite(usage.contextWindow) || usage.contextWindow <= 0) return null;
+  if (usage.tokens === null || !Number.isFinite(usage.tokens)) return null;
+
+  const percentRemaining = ((usage.contextWindow - Math.max(0, usage.tokens)) / usage.contextWindow) * 100;
+  return Math.round(Math.max(0, Math.min(100, percentRemaining)));
+}
+
+export function formatContextProgress(tokensUsed: number | null, contextWindow: number, theme: Theme): string {
+  if (tokensUsed === null || !Number.isFinite(tokensUsed)) return theme.fg("dim", "ctx —%");
+  const windowSize = Number.isFinite(contextWindow) && contextWindow > 0 ? contextWindow : 128_000;
+  const used = Math.max(0, tokensUsed);
+  const percentRemaining = Math.max(0, Math.min(100, Math.round(((windowSize - used) / windowSize) * 100)));
+  const color: ThemeColor = percentRemaining > 50 ? "success" : percentRemaining >= 20 ? "warning" : "error";
+  const action = percentRemaining <= 15 ? " · /compact" : "";
+  return theme.fg(color, `ctx ${percentRemaining}%${action}`);
+}
+
+function sumSessionCost(ctx: ExtensionContext): number {
+  let total = 0;
+  for (const entry of ctx.sessionManager.getEntries()) {
+    if (entry.type === "message" && entry.message.role === "assistant") total += entry.message.usage.cost.total;
+    else if (entry.type === "message" && entry.message.role === "toolResult" && entry.message.usage) {
+      total += entry.message.usage.cost.total;
+    } else if ((entry.type === "compaction" || entry.type === "branch_summary") && entry.usage) {
+      total += entry.usage.cost.total;
+    }
+  }
+  return total;
+}
+
+const PROVIDER_LABELS: Readonly<Record<string, string>> = {
+  "amazon-bedrock": "Amazon Bedrock",
+  "azure-openai-responses": "Azure OpenAI",
+  "github-copilot": "GitHub Copilot",
+  "google-vertex": "Google Vertex",
+  "openai-codex": "OpenAI",
+  anthropic: "Anthropic",
+  deepseek: "DeepSeek",
+  google: "Google",
+  ollama: "Ollama",
+  openai: "OpenAI",
+  openrouter: "OpenRouter",
+};
+
+function formatProviderName(provider: string): string {
+  const normalized = safeTerminalText(provider).replaceAll("\n", "").trim();
+  const known = PROVIDER_LABELS[normalized.toLowerCase()];
+  if (known) return known.toLowerCase();
+  return normalized.toLowerCase().split(/[-_]+/u).filter(Boolean).join(" ") || "unknown provider";
+}
+
+export function formatModel(
+  model: ExtensionContext["model"],
+  theme: Theme,
+  includeProvider = true,
+  showCodexFast = false,
+): string {
+  if (!model) return theme.fg("dim", "no model");
+  const displayName = modelDisplayName(model) || "unknown model";
+  const name = theme.fg("text", displayName);
+  const fast = showCodexFast && model.provider === CODEX_PROVIDER ? theme.fg("text", "fast") : "";
+  const provider = includeProvider ? theme.fg("dim", formatProviderName(model.provider)) : "";
+  return [name, fast, provider].filter(Boolean).join(" ");
+}
+
+function compactDirectory(cwd: string): string {
+  if (cwd === "~" || cwd === "/" || /^[A-Za-z]:[\\/]?$/u.test(cwd)) return cwd;
+  const normalized = cwd.replace(/\\/gu, "/").replace(/\/$/u, "");
+  const finalSegment = normalized.split("/").at(-1);
+  return finalSegment ? `…/${finalSegment}` : cwd;
+}
+
+function joinFooterParts(parts: string[], theme: Theme): string {
+  return parts.filter(Boolean).join(theme.fg("dim", " · "));
+}
+
+function footerRowFits(left: string, right: string, width: number): boolean {
+  const contentWidth = visibleWidth(left) + (right ? visibleWidth(right) + 1 : 0);
+  return contentWidth + 2 <= width;
+}
+
+function renderFooterRow(left: string, right: string, width: number): string {
+  if (width <= 0) return "";
+  if (width < 3) return " ".repeat(width);
+
+  const innerWidth = width - 2;
+  if (!right) return ` ${padRight(left, innerWidth)} `;
+
+  const clippedRight = truncateToWidth(right, innerWidth, "");
+  const rightWidth = visibleWidth(clippedRight);
+  const leftBudget = Math.max(0, innerWidth - rightWidth - 1);
+  const clippedLeft = truncateToWidth(left, leftBudget, "…");
+  const gap = " ".repeat(Math.max(0, innerWidth - visibleWidth(clippedLeft) - rightWidth));
+  return ` ${clippedLeft}${gap}${clippedRight} `;
+}
+
+function renderFooter(rows: string[], width: number, theme: Theme): string[] {
+  return [theme.fg("borderMuted", "─".repeat(width)), ...rows];
+}
+
+function formatGoalFooter(state: GoalState | undefined, theme: Theme): string {
+  if (!state) return "";
+  if (state.status === "active") {
+    const detail = state.maxTurns === undefined
+      ? `${state.turns} turn${state.turns === 1 ? "" : "s"} · ${formatTime(goalElapsedMilliseconds(state, Date.now()))}`
+      : `${state.turns}/${state.maxTurns} · ${formatTime(goalElapsedMilliseconds(state, Date.now()))}`;
+    return `${theme.fg("customMessageLabel", "/goal active")}${theme.fg("dim", ` · ${detail}`)}`;
+  }
+  if (state.status === "paused") return theme.fg("warning", "/goal paused");
+  if (state.status === "blocked") return theme.fg("error", "/goal blocked");
+  return "";
+}
+
+function formatGitFileChanges(changes: GitFileChanges, theme: Theme): string {
+  const total = changes.modified + changes.added + changes.deleted;
+  if (total === 0) return "";
+  return `${theme.fg("dim", `±${total} [`)}${theme.fg("warning", `~${changes.modified}`)} ${theme.fg("success", `+${changes.added}`)} ${theme.fg("error", `−${changes.deleted}`)}${theme.fg("dim", "]")}`;
+}
+
+export function registerFooter(pi: ExtensionAPI, goalRuntime: GoalRuntime): void {
+  let currentModel: ExtensionContext["model"];
+  let thinkingLevel: ThinkingLevel = "off";
+  let activeTui: TUI | undefined;
+  let cachedSessionCost = 0;
+  let sessionCostDirty = true;
+  let unsubscribeCodexFast: (() => void) | undefined;
+  const resetSessionCost = (): void => {
+    cachedSessionCost = 0;
+    sessionCostDirty = true;
+  };
+  const invalidateSessionCost = (): void => {
+    sessionCostDirty = true;
+    activeTui?.requestRender();
+  };
+  const getSessionCost = (ctx: ExtensionContext): number => {
+    if (sessionCostDirty) {
+      cachedSessionCost = sumSessionCost(ctx);
+      sessionCostDirty = false;
+    }
+    return cachedSessionCost;
+  };
+  goalRuntime.requestRender = () => activeTui?.requestRender();
+
+  pi.on("session_start", (_event, ctx) => {
+    resetSessionCost();
+    if (ctx.mode !== "tui") return;
+    unsubscribeCodexFast?.();
+    unsubscribeCodexFast = subscribeCodexFast(() => activeTui?.requestRender());
+    const sessionStart = Date.now();
+    currentModel = ctx.model;
+    thinkingLevel = pi.getThinkingLevel();
+    const cwd = formatCwd(ctx.cwd);
+
+    ctx.ui.setFooter((tui, theme, footerData) => {
+      activeTui = tui;
+      let gitFileChanges: GitFileChanges | undefined;
+      const gitStatus = createGitFileChangesRefresh(ctx.cwd, (changes) => {
+        if (JSON.stringify(changes) === JSON.stringify(gitFileChanges)) return;
+        gitFileChanges = changes;
+        tui.requestRender();
+      }, (cwd) => resolveGitFileChanges(cwd, execFile, ctx.isProjectTrusted()));
+      const unsubscribe = footerData.onBranchChange(() => {
+        gitStatus.request();
+        tui.requestRender();
+      });
+      gitStatus.request();
+      const stopWatch = scheduleGitStatusWatch(ctx.cwd, gitStatus.request);
+      const stopFallback = scheduleGitStatusFallback(gitStatus.request);
+      return {
+        dispose() {
+          unsubscribe();
+          stopWatch();
+          stopFallback();
+          gitStatus.dispose();
+          if (activeTui === tui) activeTui = undefined;
+        },
+        invalidate() {},
+        render(width: number): string[] {
+          if (width <= 0) return [];
+          const model = currentModel ?? ctx.model;
+          const level = model?.reasoning === false
+            ? theme.fg("thinkingOff", "no reasoning")
+            : theme.fg(LEVEL_COLORS[thinkingLevel], thinkingLevel);
+          let usage: ReturnType<ExtensionContext["getContextUsage"]>;
+          try {
+            usage = ctx.getContextUsage();
+          } catch {
+            usage = undefined;
+          }
+          const contextWindow = usage?.contextWindow ?? model?.contextWindow ?? 128_000;
+          const context = formatContextProgress(usage?.tokens ?? null, contextWindow, theme);
+          const branch = footerData.getGitBranch();
+          const signature = formatModel(model, theme, true, isCodexFastEnabled());
+          const fullDirectory = colorDirectory(cwd);
+          const focusedDirectory = colorDirectory(compactDirectory(cwd));
+          const goal = formatGoalFooter(goalRuntime.state, theme);
+          const primary = joinFooterParts([
+            signature,
+            level,
+            context,
+          ], theme);
+          const primaryFocused = joinFooterParts([signature, context], theme);
+          const session = joinFooterParts([
+            theme.fg("dim", formatTime(Date.now() - sessionStart)),
+            theme.fg("dim", formatCost(getSessionCost(ctx))),
+          ], theme);
+          const essentialModel = formatModel(model, theme, false, isCodexFastEnabled());
+          const primaryRow = footerRowFits(primary, session, width)
+            ? renderFooterRow(primary, session, width)
+            : footerRowFits(primary, "", width)
+              ? renderFooterRow(primary, "", width)
+              : footerRowFits(primaryFocused, "", width)
+                ? renderFooterRow(primaryFocused, "", width)
+                : renderFooterRow(essentialModel, context, width);
+          const changes = gitFileChanges ? formatGitFileChanges(gitFileChanges, theme) : "";
+          const branchLabel = branch
+            ? `${theme.fg("dim", branch)}${changes ? `${theme.fg("dim", " · ")}${changes}` : ""}`
+            : "";
+          const workspaceRight = goal || fullDirectory;
+          const secondaryRow = footerRowFits(branchLabel, workspaceRight, width)
+            ? renderFooterRow(branchLabel, workspaceRight, width)
+            : goal
+              ? renderFooterRow("", goal, width)
+              : footerRowFits(branchLabel, focusedDirectory, width)
+                ? renderFooterRow(branchLabel, focusedDirectory, width)
+                : renderFooterRow(branchLabel, "", width);
+          return renderFooter([primaryRow, secondaryRow], width, theme);
+        },
+      };
+    });
+  });
+
+  pi.on("model_select", (event) => {
+    currentModel = event.model;
+    activeTui?.requestRender();
+  });
+  pi.on("thinking_level_select", (event) => {
+    thinkingLevel = event.level;
+    activeTui?.requestRender();
+  });
+  pi.on("turn_end", invalidateSessionCost);
+  pi.on("session_compact", invalidateSessionCost);
+  pi.on("session_tree", () => {
+    resetSessionCost();
+    activeTui?.requestRender();
+  });
+  pi.on("session_shutdown", () => {
+    unsubscribeCodexFast?.();
+    unsubscribeCodexFast = undefined;
+    resetSessionCost();
+    activeTui = undefined;
+    goalRuntime.requestRender = undefined;
+  });
+}