@selesai/code 0.13.40 → 0.14.3

package/dist/extensions/pi-zentui/extensions/zentui/footer.ts

@@ -1,31 +1,40 @@
+import { stripVTControlCharacters } from "node:util";
 import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
 import { visibleWidth } from "@earendil-works/pi-tui";
-import type { SeparatorStyle, ZentuiConfig } from "./config";
-import { FOOTER_FORMAT_ALIASES } from "./config";
+import type { CodexQuota } from "./codex-quota";
+import { codexQuotaText, renderCodexQuota } from "./codex-quota-display";
+import { componentColor } from "./component-colors";
+import type { ExtensionStatusComponentConfig, SeparatorStyle, ZentuiConfig } from "./config";
+import { FOOTER_FORMAT_ALIASES, FOOTER_FORMAT_VARIABLES } from "./config";
+import { renderCustomValue } from "./custom-value-colors";
+import { AtomicTemplateValues, normalizeTemplateVariables } from "./custom-variable-format";
 import { sanitizeEditorMetadataText } from "./editor-metadata-format";
 import {
 	collectExtensionStatusSegments,
 	type ExtensionStatusSegment,
+	renderExtensionStatusLine,
 	sanitizeExtensionStatusText,
 } from "./extension-status";
 import {
-	collectFooterFormatReferences,
-	compileCompactFormat,
-	parseFooterFormat,
+	type CompiledCompactChunk,
+	compiledFooterFormat,
 	renderFormatSplit,
 	renderFormatTokens,
 	stripOrphanSeparators,
 } from "./footer-format";
 import {
+	type CompactLayoutChunk,
 	compactChunkBudget,
 	fullFooterFitsAligned,
 	packCompactChunks,
+	packCompactZones,
 	reflowFullFooter,
 } from "./footer-layout";
 import { truncateFooterText } from "./footer-text";
 import {
 	buildContextDisplayLabel,
 	buildSessionDurationLabel,
+	type ContextUsageSnapshot,
 	contextColorTier,
 	formatCwdLabel,
 	formatGitBranchText,
@@ -38,8 +47,10 @@ import {
 	formatUsernameHostLabel,
 	resolveContextUsage,
 } from "./format";
+import { type HostTemplateValues, isHostTemplateVariable } from "./host-template-values";
 import { resolveRuntimeSymbol } from "./icons";
 import type { LiveContextOverride } from "./live-context";
+import { liveMetadataColor } from "./live-metadata-display";
 import { type FooterState, modelLabelFor } from "./state";
 import { renderStyleForSource } from "./style";
 
@@ -188,15 +199,23 @@ export function installFooter(
 		setRequestRender: (fn: (() => void) | undefined) => void;
 		scheduleProjectRefresh: (ctx: ExtensionContext) => void;
 		setExtensionStatusesGetter?: (fn: (() => ReadonlyMap<string, string>) | undefined) => void;
+		getThinkingLevel?: () => string | undefined;
+		getFastMode?: () => string | undefined;
 		getLiveContext?: () => LiveContextOverride | undefined;
+		getCodexQuota?: () => CodexQuota | undefined;
+		getCustomVariables?: () => ReadonlyMap<string, string>;
+		getHostTemplateValues?: (names: ReadonlySet<string>) => HostTemplateValues | undefined;
 		getRepositoryRoot?: (cwd: string) => string | undefined;
 		onDispose?: () => void;
+		onProjectChanged?: () => void;
+		beforeRender?: () => void;
 	},
 ): void {
 	ctx.ui.setFooter((tui, theme, footerData) => {
 		hooks.setRequestRender(() => tui.requestRender());
 		hooks.setExtensionStatusesGetter?.(() => footerData.getExtensionStatuses());
 		const unsubscribeBranch = footerData.onBranchChange(() => {
+			hooks.onProjectChanged?.();
 			hooks.scheduleProjectRefresh(ctx);
 			tui.requestRender();
 		});
@@ -209,27 +228,87 @@ export function installFooter(
 				hooks.onDispose?.();
 			},
 			invalidate() {},
-			render(width: number): string[] {
+			render: function renderFooter(
+				width: number,
+				showQuota = true,
+				contextSnapshot?: ContextUsageSnapshot,
+				excludedCustom: ReadonlySet<string> = new Set(),
+				builtinSnapshots = new Map<string, string>(),
+			): string[] {
 				if (width <= 0) return [""];
+				hooks.beforeRender?.();
 				const config = getConfig();
 				const footer = config.components.footer;
+				const aliases = normalizeTemplateVariables(footer.styles.starship.variables, [
+					...FOOTER_FORMAT_VARIABLES,
+					...Object.keys(FOOTER_FORMAT_ALIASES),
+				]);
+				const published = hooks.getCustomVariables?.() ?? new Map<string, string>();
+				const customTexts = new Map<string, string>();
+				for (const key of Object.values(aliases)) {
+					if (excludedCustom.has(key)) continue;
+					const raw = published.get(key);
+					if (!raw) continue;
+					const text = renderCustomValue({
+						key,
+						raw,
+						colors: footer.customValueColors,
+						mode: footer.styles.starship.extensionColorMode ?? "original",
+						theme,
+						source: footer.colorSource,
+						fallbackStyle: componentColor(config, "footer", "extensionStatus"),
+					});
+					if (visibleWidth(text)) customTexts.set(key, text);
+				}
+				const statusSnapshot = footerData.getExtensionStatuses();
+				const quota =
+					showQuota && ctx.model?.provider === "openai-codex" ? hooks.getCodexQuota?.() : undefined;
+				const styledQuota = renderCodexQuota(quota, theme, config, "footer");
+				// Include quota-enabled conditional groups when scanning non-quota text.
+				let quotaLabel = styledQuota;
+				let quotaProbe = "";
 				const footerModelLabel = modelLabelFor(state, footer.modelLabel);
-				const wideFormatTokens = config.components.footer.styles.starship.format
-					? parseFooterFormat(config.components.footer.styles.starship.format)
-					: [];
-				const compactFormatTokens = config.components.footer.styles.starship.responsive
-					? parseFooterFormat(config.components.footer.styles.starship.compactFormat)
-					: [];
-				const wideReferences = collectFooterFormatReferences(
-					wideFormatTokens,
+				const wideFormat = compiledFooterFormat(
+					footer.styles.starship.format,
 					FOOTER_FORMAT_ALIASES,
 				);
-				const compactReferences = collectFooterFormatReferences(
-					compactFormatTokens,
+				const compactFormat = compiledFooterFormat(
+					footer.styles.starship.responsive ? footer.styles.starship.compactFormat : "",
 					FOOTER_FORMAT_ALIASES,
 				);
+				const wideFormatTokens = wideFormat.tokens;
+				const compactFormatTokens = compactFormat.tokens;
+				const wideReferences = wideFormat.references;
+				const compactReferences = compactFormat.references;
 				const colorSource = config.components.footer.colorSource;
-				const iconMode = config.icons.mode;
+				const requestedHostNames = new Set(
+					[...wideReferences, ...compactReferences].filter(
+						(name) =>
+							isHostTemplateVariable(name) &&
+							!Object.hasOwn(aliases, name) &&
+							!builtinSnapshots.has(name),
+					),
+				);
+				if (requestedHostNames.size) {
+					const hostValues = hooks.getHostTemplateValues?.(requestedHostNames);
+					for (const name of requestedHostNames) {
+						if (!isHostTemplateVariable(name)) continue;
+						const text = sanitizeEditorMetadataText(hostValues?.[name] ?? "");
+						builtinSnapshots.set(
+							name,
+							text
+								? renderStyleForSource(
+										theme,
+										colorSource,
+										liveMetadataColor(config, "footer", name) ??
+											componentColor(config, "footer", "extensionStatus"),
+										text,
+									)
+								: "",
+						);
+					}
+				}
+				const iconMode = config.icons.effectiveMode;
 				const pathDisplay = config.components.footer.styles.starship.pathDisplay;
 				const formattedCwd = sanitizeEditorMetadataText(
 					formatCwdLabel(ctx.cwd, config.icons.cwd, {
@@ -265,22 +344,36 @@ export function installFooter(
 				const separator = renderStyleForSource(
 					theme,
 					colorSource,
-					config.colors.separator,
+					componentColor(config, "footer", "separator"),
 					separatorText[config.components.footer.styles.starship.separator],
 				);
 				const innerWidth = Math.max(1, width - 2);
-				const cwdLabel = renderStyleForSource(theme, colorSource, config.colors.cwd, formattedCwd);
+				const cwdLabel = renderStyleForSource(
+					theme,
+					colorSource,
+					componentColor(config, "footer", "cwd"),
+					formattedCwd,
+				);
 				const needsSessionName =
 					(config.components.footer.styles.starship.format
-						? wideReferences.has("session_name")
+						? wideReferences.includes("session_name")
 						: config.components.footer.styles.starship.segments.sessionName) ||
-					compactReferences.has("session_name");
-				const sessionName = needsSessionName
-					? sanitizeExtensionStatusText(ctx.sessionManager.getSessionName() ?? "")
-					: "";
-				const sessionNameLabel = sessionName
-					? renderStyleForSource(theme, colorSource, config.colors.sessionName, sessionName)
-					: "";
+					compactReferences.includes("session_name");
+				const sessionName =
+					needsSessionName && !builtinSnapshots.has("session_name")
+						? sanitizeExtensionStatusText(ctx.sessionManager.getSessionName() ?? "")
+						: "";
+				const sessionNameLabel =
+					builtinSnapshots.get("session_name") ??
+					(sessionName
+						? renderStyleForSource(
+								theme,
+								colorSource,
+								componentColor(config, "footer", "sessionName"),
+								sessionName,
+							)
+						: "");
+				if (needsSessionName) builtinSnapshots.set("session_name", sessionNameLabel);
 				const builtInSessionNameLabel = sessionNameLabel ? `in ${sessionNameLabel}` : "";
 				const branchText = branch
 					? formatGitBranchText(
@@ -288,10 +381,21 @@ export function installFooter(
 							config.components.footer.styles.starship.gitBranch.maxLength,
 						)
 					: undefined;
-				const { percent: contextPercent, contextWindow } = resolveContextUsage(
-					ctx,
-					hooks.getLiveContext?.(),
-				);
+				const needsContext =
+					(config.components.footer.styles.starship.format
+						? wideReferences.includes("context")
+						: config.components.footer.styles.starship.segments.context) ||
+					compactReferences.includes("context") ||
+					(state.autoCompaction &&
+						(wideReferences.includes("auto_compaction") ||
+							compactReferences.includes("auto_compaction")));
+				// Reuse only within this render's quota fallback, including resolved unknown usage.
+				const context =
+					contextSnapshot ??
+					(needsContext
+						? resolveContextUsage(ctx, hooks.getLiveContext?.())
+						: { percent: undefined, contextWindow: undefined });
+				const { percent: contextPercent, contextWindow } = context;
 				const contextLabel = buildContextDisplayLabel({
 					percent: contextPercent,
 					contextWindow,
@@ -304,26 +408,51 @@ export function installFooter(
 				);
 				const contextColor =
 					tier === "error"
-						? config.colors.contextError
+						? componentColor(config, "footer", "contextError")
 						: tier === "warning"
-							? config.colors.contextWarning
-							: config.colors.contextNormal;
+							? componentColor(config, "footer", "contextWarning")
+							: componentColor(config, "footer", "contextNormal");
 				const cacheReadLabel = state.cacheReadLabel
-					? renderStyleForSource(theme, colorSource, config.colors.tokens, state.cacheReadLabel)
+					? renderStyleForSource(
+							theme,
+							colorSource,
+							componentColor(config, "footer", "tokens"),
+							state.cacheReadLabel,
+						)
 					: "";
 				const cacheWriteLabel = state.cacheWriteLabel
-					? renderStyleForSource(theme, colorSource, config.colors.tokens, state.cacheWriteLabel)
+					? renderStyleForSource(
+							theme,
+							colorSource,
+							componentColor(config, "footer", "tokens"),
+							state.cacheWriteLabel,
+						)
 					: "";
 				const subscriptionLabel = state.subscription
-					? renderStyleForSource(theme, colorSource, config.colors.cost, "(sub)")
+					? renderStyleForSource(
+							theme,
+							colorSource,
+							componentColor(config, "footer", "cost"),
+							"(sub)",
+						)
 					: "";
 				const autoCompactionLabel = state.autoCompaction
 					? renderStyleForSource(theme, colorSource, contextColor, "(auto)")
 					: "";
 				const gitColor = (text: string) =>
-					renderStyleForSource(theme, colorSource, config.colors.gitBranch, text);
+					renderStyleForSource(
+						theme,
+						colorSource,
+						componentColor(config, "footer", "gitBranch"),
+						text,
+					);
 				const gitStatusColor = (text: string) =>
-					renderStyleForSource(theme, colorSource, config.colors.gitStatus, text);
+					renderStyleForSource(
+						theme,
+						colorSource,
+						componentColor(config, "footer", "gitStatus"),
+						text,
+					);
 				const gitIcon = config.icons.git ? gitColor(config.icons.git) : "";
 				const gitCounts = config.components.footer.styles.starship.segments.gitCounts;
 				const stashLabel =
@@ -357,8 +486,9 @@ export function installFooter(
 				const statusBlock =
 					allStatus || aheadBehind ? gitStatusColor(`[${allStatus}${aheadBehind}]`) : "";
 				const gitStateBlock = gitStateLabel ? gitStatusColor(gitStateLabel) : "";
-				const renderVariable = (name: string): string => {
+				const renderBuiltInVariable = (name: string): string => {
 					const canonical = FOOTER_FORMAT_ALIASES[name] ?? name;
+					if (isHostTemplateVariable(canonical)) return builtinSnapshots.get(canonical) ?? "";
 					switch (canonical) {
 						case "cwd":
 							return cwdLabel;
@@ -384,12 +514,18 @@ export function installFooter(
 							return sanitizeExtensionStatusText(footerModelLabel);
 						case "provider":
 							return sanitizeExtensionStatusText(state.providerLabel);
+						case "thinkingLevel": {
+							const level = sanitizeExtensionStatusText(hooks.getThinkingLevel?.() ?? "");
+							return level.toLowerCase() === "off" ? "" : level;
+						}
+						case "fast_mode":
+							return sanitizeExtensionStatusText(hooks.getFastMode?.() ?? "");
 						case "session_duration":
 							return state.sessionStartEpoch
 								? renderStyleForSource(
 										theme,
 										colorSource,
-										config.colors.sessionDuration,
+										componentColor(config, "footer", "sessionDuration"),
 										buildSessionDurationLabel(state.sessionStartEpoch),
 									)
 								: "";
@@ -397,30 +533,37 @@ export function installFooter(
 							return renderStyleForSource(
 								theme,
 								colorSource,
-								config.colors.username,
+								componentColor(config, "footer", "username"),
 								formatUsernameHostLabel(config.icons.username),
 							);
 						case "os":
 							return renderStyleForSource(
 								theme,
 								colorSource,
-								config.colors.os,
-								formatOsLabel(config.icons.os, iconMode),
+								componentColor(config, "footer", "os"),
+								formatOsLabel(
+									config.icons.os,
+									iconMode,
+									process.platform,
+									config.icons.osOverridden,
+								),
 							);
 						case "time":
 							return renderStyleForSource(
 								theme,
 								colorSource,
-								config.colors.time,
+								componentColor(config, "footer", "time"),
 								formatTimeLabel(config.icons.time),
 							);
+						case "codex_quota":
+							return quotaLabel;
 						case "context":
 							return renderStyleForSource(theme, colorSource, contextColor, contextLabel);
 						case "tokens":
 							return renderStyleForSource(
 								theme,
 								colorSource,
-								config.colors.tokens,
+								componentColor(config, "footer", "tokens"),
 								state.tokenLabel,
 							);
 						case "cache_read":
@@ -428,7 +571,12 @@ export function installFooter(
 						case "cache_write":
 							return cacheWriteLabel;
 						case "cost":
-							return renderStyleForSource(theme, colorSource, config.colors.cost, state.costLabel);
+							return renderStyleForSource(
+								theme,
+								colorSource,
+								componentColor(config, "footer", "cost"),
+								state.costLabel,
+							);
 						case "subscription":
 							return subscriptionLabel;
 						case "auto_compaction":
@@ -440,30 +588,40 @@ export function installFooter(
 								colorSource,
 								iconMode,
 								config.icons.package,
-								config.colors.packageVersion,
+								componentColor(config, "footer", "packageVersion"),
 							);
 						case "package_version":
 							return packageVersion?.version
 								? renderStyleForSource(
 										theme,
 										colorSource,
-										config.colors.packageVersion,
+										componentColor(config, "footer", "packageVersion"),
 										packageVersion.version,
 									)
 								: "";
 						case "sep":
-							return renderStyleForSource(theme, colorSource, config.colors.separator, " | ");
+							return renderStyleForSource(
+								theme,
+								colorSource,
+								componentColor(config, "footer", "separator"),
+								" | ",
+							);
 						case "git_commit":
 							return formatGitCommitSegment(
 								theme,
 								commit,
 								config.components.footer.styles.starship.gitCommit,
 								colorSource,
-								config.colors.gitCommit,
+								componentColor(config, "footer", "gitCommit"),
 							);
 						case "git_tag":
 							return config.components.footer.styles.starship.gitCommit.showTag && commit?.tag
-								? renderStyleForSource(theme, colorSource, config.colors.gitCommit, commit.tag)
+								? renderStyleForSource(
+										theme,
+										colorSource,
+										componentColor(config, "footer", "gitCommit"),
+										commit.tag,
+									)
 								: "";
 						case "git_metrics":
 							return formatGitMetricsSegment(
@@ -471,15 +629,15 @@ export function installFooter(
 								state.metrics,
 								config.components.footer.styles.starship.gitMetrics,
 								colorSource,
-								config.colors.gitMetricsAdded,
-								config.colors.gitMetricsDeleted,
+								componentColor(config, "footer", "gitMetricsAdded"),
+								componentColor(config, "footer", "gitMetricsDeleted"),
 							);
 						case "git_added":
 							return state.metrics
 								? renderStyleForSource(
 										theme,
 										colorSource,
-										config.colors.gitMetricsAdded,
+										componentColor(config, "footer", "gitMetricsAdded"),
 										`+${state.metrics.added}`,
 									)
 								: "";
@@ -488,7 +646,7 @@ export function installFooter(
 								? renderStyleForSource(
 										theme,
 										colorSource,
-										config.colors.gitMetricsDeleted,
+										componentColor(config, "footer", "gitMetricsDeleted"),
 										`−${state.metrics.deleted}`,
 									)
 								: "";
@@ -496,6 +654,20 @@ export function installFooter(
 							return "";
 					}
 				};
+				// Reserve actual referenced builtin output, not just static state. Reuse the
+				// same values during scans, packing and fallback so callbacks cannot collide later.
+				const builtinNames = new Set<string>(FOOTER_FORMAT_VARIABLES);
+				for (const name of new Set([...wideReferences, ...compactReferences])) {
+					if (name !== "codex_quota" && builtinNames.has(name) && !builtinSnapshots.has(name))
+						builtinSnapshots.set(name, renderBuiltInVariable(name));
+				}
+				const renderVariable = (name: string): string => {
+					const canonical = FOOTER_FORMAT_ALIASES[name] ?? name;
+					if (canonical === "codex_quota") return quotaLabel;
+					if (Object.hasOwn(aliases, name)) return atomicCustom.resolve(aliases[name]);
+					if (builtinSnapshots.has(canonical)) return builtinSnapshots.get(canonical) ?? "";
+					return renderBuiltInVariable(name);
+				};
 				const branchParts: string[] = [];
 				if (config.components.footer.styles.starship.segments.gitBranch) {
 					if (branchText) {
@@ -515,7 +687,12 @@ export function installFooter(
 									: "";
 							const inner = [shortHash, tag].filter(Boolean).join(" ");
 							branchParts.push(
-								renderStyleForSource(theme, colorSource, config.colors.gitCommit, `(${inner})`),
+								renderStyleForSource(
+									theme,
+									colorSource,
+									componentColor(config, "footer", "gitCommit"),
+									`(${inner})`,
+								),
 							);
 						}
 					}
@@ -532,7 +709,13 @@ export function installFooter(
 					.filter(Boolean)
 					.join(" ");
 				const runtimeLabel = config.components.footer.styles.starship.segments.runtime
-					? formatRuntimeSegment(theme, runtime, config.colors.runtimePrefix, colorSource, iconMode)
+					? formatRuntimeSegment(
+							theme,
+							runtime,
+							componentColor(config, "footer", "runtimePrefix"),
+							colorSource,
+							iconMode,
+						)
 					: "";
 				const packageVersionLabel = config.components.footer.styles.starship.segments.packageVersion
 					? formatPackageVersionSegment(
@@ -541,7 +724,7 @@ export function installFooter(
 							colorSource,
 							iconMode,
 							config.icons.package,
-							config.colors.packageVersion,
+							componentColor(config, "footer", "packageVersion"),
 						)
 					: "";
 				// Skip standalone gitCommit when hash is already folded into the
@@ -555,7 +738,7 @@ export function installFooter(
 								commit,
 								config.components.footer.styles.starship.gitCommit,
 								colorSource,
-								config.colors.gitCommit,
+								componentColor(config, "footer", "gitCommit"),
 							)
 						: "";
 				const gitMetricsLabel = config.components.footer.styles.starship.segments.gitMetrics
@@ -564,8 +747,8 @@ export function installFooter(
 							state.metrics,
 							config.components.footer.styles.starship.gitMetrics,
 							colorSource,
-							config.colors.gitMetricsAdded,
-							config.colors.gitMetricsDeleted,
+							componentColor(config, "footer", "gitMetricsAdded"),
+							componentColor(config, "footer", "gitMetricsDeleted"),
 						)
 					: "";
 
@@ -580,7 +763,7 @@ export function installFooter(
 					const time = renderStyleForSource(
 						theme,
 						colorSource,
-						config.colors.sessionDuration,
+						componentColor(config, "footer", "sessionDuration"),
 						timeLabel,
 					);
 					return `${prefix} ${time}`;
@@ -589,7 +772,7 @@ export function installFooter(
 					? renderStyleForSource(
 							theme,
 							colorSource,
-							config.colors.username,
+							componentColor(config, "footer", "username"),
 							formatUsernameHostLabel(config.icons.username),
 						)
 					: "";
@@ -597,8 +780,8 @@ export function installFooter(
 					? renderStyleForSource(
 							theme,
 							colorSource,
-							config.colors.os,
-							formatOsLabel(config.icons.os, iconMode),
+							componentColor(config, "footer", "os"),
+							formatOsLabel(config.icons.os, iconMode, process.platform, config.icons.osOverridden),
 						)
 					: "";
 				const left = [
@@ -628,7 +811,7 @@ export function installFooter(
 					? renderStyleForSource(
 							theme,
 							colorSource,
-							config.colors.time,
+							componentColor(config, "footer", "time"),
 							formatTimeLabel(config.icons.time),
 						)
 					: "";
@@ -639,25 +822,95 @@ export function installFooter(
 					.filter(Boolean)
 					.join(" ");
 				const builtInTokenLabel = [
-					renderStyleForSource(theme, colorSource, config.colors.tokens, state.tokenLabel),
+					renderStyleForSource(
+						theme,
+						colorSource,
+						componentColor(config, "footer", "tokens"),
+						state.tokenLabel,
+					),
 					cacheReadLabel,
 					cacheWriteLabel,
 				]
 					.filter(Boolean)
 					.join(" ");
 				const builtInCostLabel = [
-					renderStyleForSource(theme, colorSource, config.colors.cost, state.costLabel),
+					renderStyleForSource(
+						theme,
+						colorSource,
+						componentColor(config, "footer", "cost"),
+						state.costLabel,
+					),
 					subscriptionLabel,
 				]
 					.filter(Boolean)
 					.join(" ");
-				const right = [
+				const extensionStatuses = collectExtensionStatusSegments(statusSnapshot, config);
+				const renderExtensionStatus = (segment: ExtensionStatusSegment) =>
+					segment.colorMode === "original"
+						? segment.text
+						: renderStyleForSource(
+								theme,
+								colorSource,
+								componentColor(config, "footer", "extensionStatus"),
+								segment.text,
+							);
+				const extensionLeftSegments = extensionStatuses.left.map(renderExtensionStatus);
+				const extensionMiddleSegments = extensionStatuses.middle.map(renderExtensionStatus);
+				const extensionRightSegments = extensionStatuses.right.map(renderExtensionStatus);
+				const rightParts = [
 					modelInfoSegment,
 					config.components.footer.styles.starship.segments.context ? builtInContextLabel : "",
 					config.components.footer.styles.starship.segments.tokens ? builtInTokenLabel : "",
 					config.components.footer.styles.starship.segments.cost ? builtInCostLabel : "",
 					timeSegment,
-				]
+				];
+				const atomicCustom = new AtomicTemplateValues(
+					customTexts,
+					customTexts.size
+						? [
+								JSON.stringify(state),
+								ctx.cwd,
+								JSON.stringify(config.icons),
+								footer.styles.starship.format,
+								footer.styles.starship.compactFormat,
+								...builtinSnapshots.values(),
+								left,
+								separator,
+								...rightParts,
+								styledQuota,
+								...extensionLeftSegments,
+								...extensionMiddleSegments,
+								...extensionRightSegments,
+							]
+						: [],
+				);
+				if (styledQuota) {
+					// Measure an internal, same-shape probe so unrelated status text cannot
+					// count as owned quota. Restore text only after the existing layout fits it.
+					const otherText = stripVTControlCharacters(
+						[
+							left,
+							separator,
+							...rightParts,
+							config.components.footer.styles.starship.format,
+							config.components.footer.styles.starship.compactFormat,
+							renderFormatTokens(wideFormatTokens, renderVariable),
+							renderFormatTokens(compactFormatTokens, renderVariable),
+							...extensionLeftSegments,
+							...extensionMiddleSegments,
+							...extensionRightSegments,
+						].join(""),
+					);
+					// An absent letter cannot be synthesized by joining or trimming other zones.
+					const letter = [..."ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz"].find(
+						(value) => !otherText.includes(value),
+					);
+					// Bounded fail-open fallback if every candidate collides with non-quota text.
+					if (!letter) return renderFooter(width, false, context, excludedCustom, builtinSnapshots);
+					quotaProbe = codexQuotaText(quota).replace(/[a-z0-9]/gi, letter);
+					quotaLabel = styledQuota.replace(codexQuotaText(quota), quotaProbe);
+				}
+				const right = [rightParts[0], quotaLabel, ...rightParts.slice(1)]
 					.filter(Boolean)
 					.join(separator);
 
@@ -675,17 +928,6 @@ export function installFooter(
 					contentRight = stripOrphanSeparators(fmtRight);
 				}
 
-				const extensionStatuses = collectExtensionStatusSegments(
-					footerData.getExtensionStatuses(),
-					config,
-				);
-				const renderExtensionStatus = (segment: ExtensionStatusSegment) =>
-					segment.colorMode === "original"
-						? segment.text
-						: renderStyleForSource(theme, colorSource, config.colors.extensionStatus, segment.text);
-				const extensionLeftSegments = extensionStatuses.left.map(renderExtensionStatus);
-				const extensionMiddleSegments = extensionStatuses.middle.map(renderExtensionStatus);
-				const extensionRightSegments = extensionStatuses.right.map(renderExtensionStatus);
 				const middleSegments = contentMiddle
 					? [contentMiddle, ...extensionMiddleSegments]
 					: extensionMiddleSegments;
@@ -699,11 +941,33 @@ export function installFooter(
 						separator,
 						innerWidth,
 					);
-				const frameRows = (rows: string[]) =>
-					rows.map((row) => {
+				const frameRows = (rows: string[], source = [contentLeft, contentMiddle, contentRight]) => {
+					let framedRows = rows.map((row) => {
 						const framed = width > 2 ? ` ${truncateFooterText(row, width - 2, "")} ` : row;
 						return truncateFooterText(framed, width, "");
 					});
+					if (quotaLabel) {
+						const count = (lines: string[]) =>
+							lines.reduce(
+								(sum, line) => sum + stripVTControlCharacters(line).split(quotaProbe).length - 1,
+								0,
+							);
+						// Recompose without quota if any occurrence was clipped, split, or omitted.
+						if (count(source) !== count(framedRows))
+							return renderFooter(width, false, context, excludedCustom, builtinSnapshots);
+						framedRows = framedRows.map((row) => row.replaceAll(quotaProbe, codexQuotaText(quota)));
+					}
+					const omitted = atomicCustom.omitted(source, framedRows);
+					if (omitted.length)
+						return renderFooter(
+							width,
+							showQuota,
+							context,
+							new Set([...excludedCustom, ...omitted]),
+							builtinSnapshots,
+						);
+					return atomicCustom.restore(framedRows);
+				};
 
 				if (!config.components.footer.styles.starship.responsive)
 					return frameRows([renderLegacyContent()]);
@@ -729,7 +993,11 @@ export function installFooter(
 					return frameRows([renderLegacyContent()]);
 				}
 
-				const reflowed = reflowFullFooter(fullZones, innerWidth);
+				const reflowed = reflowFullFooter(
+					fullZones,
+					innerWidth,
+					wideFormatTokens.some((token) => token.kind === "fill"),
+				);
 				if (reflowed) return frameRows(reflowed);
 
 				const chunkBudget = compactChunkBudget(innerWidth);
@@ -761,53 +1029,92 @@ export function installFooter(
 							return renderVariable(name);
 					}
 				};
-				const compactChunks: Array<{
-					text: string;
-					boundary: "space" | "separator";
-				}> = [];
-				for (const chunk of compileCompactFormat(compactFormatTokens)) {
-					if (chunk.kind === "extensions") {
-						const statuses = [
-							...extensionLeftSegments,
-							...extensionMiddleSegments,
-							...extensionRightSegments,
-						];
-						for (const [index, text] of statuses.entries()) {
-							compactChunks.push({
-								text,
-								boundary: index === 0 ? chunk.boundary : "space",
-							});
+				const renderCompactChunks = (
+					chunks: readonly CompiledCompactChunk[],
+				): CompactLayoutChunk[] => {
+					const compactChunks: CompactLayoutChunk[] = [];
+					for (const chunk of chunks) {
+						if (chunk.kind === "extensions") {
+							const statuses = [
+								...extensionLeftSegments,
+								...extensionMiddleSegments,
+								...extensionRightSegments,
+							];
+							for (const [index, text] of statuses.entries()) {
+								compactChunks.push({
+									text,
+									boundary: index === 0 ? chunk.boundary : "space",
+								});
+							}
+							continue;
 						}
-						continue;
-					}
-					let rendered = stripOrphanSeparators(
-						renderFormatTokens(chunk.tokens, renderCompactVariable),
-					);
-					const references = collectFooterFormatReferences(chunk.tokens, FOOTER_FORMAT_ALIASES);
-					if (["cwd", "session_name", "git_branch"].some((name) => references.has(name))) {
-						rendered = truncateFooterText(rendered, chunkBudget, "…");
+						let rendered = stripOrphanSeparators(
+							renderFormatTokens(chunk.tokens, renderCompactVariable),
+						);
+						const references = chunk.references;
+						if (
+							(!quotaLabel || !references.includes("codex_quota")) &&
+							["cwd", "session_name", "git_branch"].some((name) => references.includes(name))
+						) {
+							rendered = truncateFooterText(rendered, chunkBudget, "…");
+						}
+						if (rendered) compactChunks.push({ text: rendered, boundary: chunk.boundary });
 					}
-					if (rendered) compactChunks.push({ text: rendered, boundary: chunk.boundary });
-				}
+					return compactChunks;
+				};
+				const compact = compactFormat.compact;
+				const compactLeft = renderCompactChunks(compact.left);
+				const compactRight = renderCompactChunks(compact.right);
 				return frameRows(
-					packCompactChunks(
-						compactChunks,
-						innerWidth,
-						config.components.footer.styles.starship.compactMaxLines,
-						renderVariable("sep"),
-					),
+					compact.alignRight
+						? packCompactZones(
+								compactLeft,
+								compactRight,
+								innerWidth,
+								config.components.footer.styles.starship.compactMaxLines,
+								renderVariable("sep"),
+							)
+						: packCompactChunks(
+								compactLeft,
+								innerWidth,
+								config.components.footer.styles.starship.compactMaxLines,
+								renderVariable("sep"),
+							),
+					[...compactLeft, ...compactRight].map((chunk) => chunk.text),
 				);
 			},
 		};
 	});
 }
 
-export function installHiddenFooter(ctx: ExtensionContext, onDispose?: () => void): void {
-	ctx.ui.setFooter(() => ({
-		dispose: onDispose,
-		invalidate() {},
-		render(): string[] {
-			return [];
-		},
-	}));
+export function installHiddenFooter(
+	ctx: ExtensionContext,
+	getPolicy: () => ExtensionStatusComponentConfig,
+	hooks: {
+		setRequestRender: (fn: (() => void) | undefined) => void;
+		setExtensionStatusesGetter: (fn: (() => ReadonlyMap<string, string>) | undefined) => void;
+		onDispose: () => void;
+	},
+): void {
+	ctx.ui.setFooter((tui, theme, footerData) => {
+		hooks.setRequestRender(() => tui.requestRender());
+		// Discovery only: provider snapshots never become controller replay provenance.
+		hooks.setExtensionStatusesGetter(() => footerData.getExtensionStatuses());
+		return {
+			dispose() {
+				hooks.setRequestRender(undefined);
+				hooks.setExtensionStatusesGetter(undefined);
+				hooks.onDispose();
+			},
+			invalidate() {},
+			render(width: number): string[] {
+				return renderExtensionStatusLine(
+					footerData.getExtensionStatuses(),
+					getPolicy(),
+					theme,
+					width,
+				);
+			},
+		};
+	});
 }