osdy-pi 1.2.0 → 1.3.0

package/extensions/osdy-pi/constants.ts

@@ -1,5 +1,5 @@
 import { visibleWidth } from "@earendil-works/pi-tui";
-import type { HeaderVariant } from "./types.js";
+import type { HeaderVariant, MascotChoice } from "./types.js";
 
 export const ANIMATION_ENABLED = true;
 export const ANIMATION_INTERVAL_MS = 30;
@@ -100,18 +100,62 @@ const HTML_MASCOT_MAP = [
   "                               dmmmmmm                    ",
 ] as const;
 
-const HEADER_CLASSIC = [
-  "░█████╗░░██████╗██████╗░██╗░░░██╗░░░░░░██████╗░██╗",
-  "██╔══██╗██╔════╝██╔══██╗╚██╗░██╔╝░░░░░░██╔══██╗  ║",
-  "██║░░██║╚█████╗░██║░░██║░╚████╔╝░█████╗██████╔╝██║",
-  "██║░░██║░╚═══██╗██║░░██║░░╚██╔╝░░╚════╝██╔═══╝░██║",
-  "╚█████╔╝██████╔╝██████╔╝░░░██║░░░░░░░░░██║░░░░░██║",
-  "░╚════╝░╚═════╝░╚═════╝░░░░╚═╝░░░░░░░░░╚═╝░░░░░╚═╝",
-  "                                ╭━╮╱╱╱╱╱╱╭╮╱╱╱╱╱╭╮╱╱╱╱╱╭╮╱╱╭╮╭╮╱╱╱╱╭━╮",
-  "                                ┃╭╋━┳━━┳━╋╋╮╭━╮╭╯┣━┳┳╮╭╯┣━╮┣╋╯┣━┳━╮┃━┫",
-  "                                ┃╰┫╋┃┃┃┃╋┃┃╰┫╋╰┫╋┃╋┃╭╯┃╋┃┻┫┃┃╋┃┻┫╋╰╋━┃",
-  "                                ╰━┻━┻┻┻┫╭┻┻━┻━━┻━┻━┻╯╱╰━┻━╯╰┻━┻━┻━━┻━╯",
-  "                                ╱╱╱╱╱╱╱╰╯                        </>",
+const BTS_MASCOT = [
+  "             ▒▒▒▒                          ▒▒▒░             ",
+  "            ▓▓▓▓▓▓▒                     ░▒▓▓▓▓▓▒            ",
+  "            ▓▓▓ ▒▓▓▒░                  ▒▓▓▓░░▓▓▓            ",
+  "          ░▓▓▒    ▒▒▓▒░░  ░▒▒▒▒▒░░   ▒▒▒▓▒    ▒▓            ",
+  "          ░▓▓▒     ░▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒░     ▒▓            ",
+  "            ▓▓▓ ░░▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒░░ ░▓▓▒            ",
+  "             ░▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒░               ",
+  "             ░▒▒▒▒▒▓▓▓▓▓▓▓▒▒▒▒▒▒▒▒▒▒▓▓▓▓▓▓▒▒▒               ",
+  "            ░▒▒▒▒▓▓▓▒   ▓▓▓▓▓▒▒▒▓▓▓▓▓   ░▓▓▓▓▒              ",
+  "            ░▒▒▓▓▓▓      ░▓▓▓▒▒▒▓▓▓░      ▒▓▓▓░     ░   ▒▒  ",
+  "           ▒▓▓▓▓░          ▓▓▒▒▒▓▓          ░▓▒░  ▓▓▓▓▓▓░   ",
+  "         ▓▓▓▓▓▒       ▓▓     ▒▒▒░    ▓▓        ▓▓▓▓▓▓▓▓▓▓▓▓ ",
+  "        ▒▓▓▓▒░            ░▓▓░░░▓▓░           ░▓▓▓▓▒▒▓▒▒▓▓▓▓",
+  "          ░▓░            ▓▓▓▓   ▒▓▓▓▓         ▓▓▓▓▓▒▒▓▒▓▓▓▓░",
+  "            ▒▓▒       ▓▓▓▓▓▓     ▒▓▓▓▓▓░    ░▓ ░▓▓▓▓▓▓▒▓▓▓  ",
+  "               ▓▓░░░░▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▒░▒▓░    ░░▒▓▓▓░    ",
+  "                      ░▒▓▓▓▓▓▓▓▓▓▓▓▓▓▒                      ",
+  "    ▒▒▒▒▒░           ▒▒▒▒▒▒▒▓▓▓▓▓▓▒▒▒▒▒░         ░          ",
+  " ░░▒▒▒▒░░░░       ░░▒▒▒▒▒▒▒▓▓▓▓▓▓▓▓▓▒▒▒▒▒▒░ ░░░  ░          ",
+  "▒▒▒▒▒▒     ░      ░▒▒▒░  ▒▓▓▓▓▓▓▓▓▓▓▓▒▒▒▒▒▒▒▒▒░ ░           ",
+  "░▒▒░░    ░▒▒▒▒    ░▒▒▒▒░   ▓▓▓▓▓▓▓▓▓▓▓▒░ ░▒▒░░              ",
+  "  ▒░   ░▒▒▒▒▒░      ░▒░    ▓▓▓▓▓▓▓▓▓▓▓▒▒▒                   ",
+  "       ▒▒▒▒░      ▒▒░   ░▒▓▓▓▓▓▓▓▓▓▓▓▓▒▒▒                   ",
+  "      ▒▒▒▒░░      ▒▒▒▒▒▒▓▓▓▓▓▓▓▓▓▓▓▓▓▒▒▒▒                   ",
+  "        ░▒░        ▒▒▒▒▒▒▒▓▓▓▓▓▓▓▓▒▒▒▒▒░                    ",
+  "                    ░▒▒▒▒░       ░▒▒▒▒░                     ",
+] as const;
+
+const BTS_MASCOT_MAP = [
+  "             mmmm                          mmmv             ",
+  "            lhhhhlv                     dmlhhhhp            ",
+  "            hhl mhhpv                  mlhhddhhl            ",
+  "          dhhv    mphmvd  dmmmmmvd   mmphp    pl            ",
+  "          dhhm     dmmmmmmmmmmmmmmmmmmmmd     pl            ",
+  "            hhl ddmmmmmmmmmmmmmmmmmmmmmmmvd dhhp            ",
+  "             vmvmmmmmmmmmmmmmmmmmmmmmmmmmmmmv               ",
+  "             dmmmmplhhhhhhmmmmmmmmmphhhhhhpmv               ",
+  "            vmmmphhhp   lhhhhmmmlhhhh   vhhhlm              ",
+  "            vmmhhhl      dlhhmmmlhlv      mlhhd     d   cc  ",
+  "           mhhhhd          lhmmmlh          dlpd  hhbbbld   ",
+  "         lhhhhp       hb     mmmd    lb        hhhbhcbbbbbh ",
+  "        mhhhpd            vhhvvvlhv           dhbbbccbccbbbl",
+  "          dhv            hhhh   phhhl         lhhbbcchccbhhv",
+  "            plp       lhhhhp     plhhhld    dp dlhbbbbcbhh  ",
+  "               pldddvhhhhhhhhhhhhhhhhhhhmdmlv    dvmlhhd    ",
+  "                      vmhhhhhhhhhhhhhm                      ",
+  "    mmmmmd           mmmmmmmllllllmmmmmv         d          ",
+  " dvmmmmvvvd       dvmmmmmmmhhhhhhhhlmmmmmvv dvd  d          ",
+  "vmmmmm     d      vmmmd  phhhhhhhhhhhmmmmmmmmmv d           ",
+  "vmmvd    vmmmm    vmmmmv   hhhhhhhhhhhmv vmmvd              ",
+  "  md   dmmmmmv      vmd    hhhhhhhhhhhmmm                   ",
+  "       mmmmv      mmv   dmhhhhhhhhhhhhmmm                   ",
+  "      mmmmvd      mmmmmmhhhhhhhhhhhhhmmmm                   ",
+  "        vmd        mmmmmmmhhhhhhhhmmmmmv                    ",
+  "                    dmmmmv       vmmmmd                     ",
 ] as const;
 
 const HEADER_SIMPLE = [
@@ -128,6 +172,33 @@ const HEADER_SIMPLE = [
   "                                  ░░░░░░                      <ideas_compiler/>",
 ] as const;
 
+const NEON_HEADER_ROWS = [
+  ["                                                             █████████                                                  ████████ ", "                                                             ddddddddd                                                  dddddddd "],
+  ["          ██████████████████████                           ███████████                         █████████████████████ ████████████", "          dddddddddddpdddddddddd                           ddccccccddd                         ddddddddddddddddddddd ddccccccccpd"],
+  ["        ██████████████████████████                        ███████████                        ████████████████████████████████████", "        dddccchhhhhhhhhhhhhhhcpddd                        ddcchhhhmdd                        dddccchhhhhhhhhhhhhhhcdddphhhhhllddd"],
+  ["      ███████████████████████████████████████████████████████████████████████████████       ████████████████████████████████████ ", "      pddpchhhhhhhhhhhhhhhhhhhhmdddddddddddddddddddddddddddchhhhhmdddddddddpddddddddd       ddpllhhhhhhllllllhhhhhhmdddddddddddd "],
+  ["     ████████████████████████████████████████████████████████████████████████████████       ███████████████████████████████████  ", "     ddpchhhhhhldddddddchhhhhlmddppchhhhhhhhhhhcdppcchhhhhhhhhhhldchhhhhpdddpchhhhcdd       dddddcchhhhdddddpchhhhlddpcchhhcpdd  "],
+  ["   ██████████████   ████████████████████████████████████████████ ████████████████████████████████████████ ████████████████████   ", "   dddcchhhhhlddd   ddchhhhhldpcchhhhlmmmmmmmddcchhhhlmmlhhhhhhd chhhhlddddcchhhhddddddddddddddpchhhhhmdd dchhhhhmddpchhhhlddd   "],
+  ["  ██████████████  ███████████████████████████████████████████████████████████████████████████████████████████████████████████    ", "  dddcchhhhhmddd  pdcchhhhhlddpplhhhhlddddddddcchhhhldddchhhhlddchhhhhmddpchhhhhldcchhhhhhhlpdpcchhhhhhhhhhhhhmmdddpchhhhlddd    "],
+  [" ████████████████████████████ █████████████████████████████████████████████████████████████████████████████████████████████      ", " ddcchhhhhldddddddpchhhhhhmdd dddmhhhhhldddddchhhhlmddpchhhhmddchhhhhhcccchhhhhmddlllllllllddpchhhhhlllllllldddddpcchhhhldd      "],
+  ["█████████████████████████████████████████████████████████████████████████████████████████████████████████████  ████████████████  ", "ddchhhhhhhlcccccccchhhhhhddpccccccchhhhhhddpchhhhhhcccchhhhlddddmhhhhhhhhhhhhhmdddddddddddddpchhhhldddddddddd  ddchhhhhmddddddd  "],
+  [" ███████████████████████████████████████████████████████████████████████████████          ██████████         ██████████████████  ", " ddmhhhhhhhhhhhhhhhhhhhddpchhhhhhhhhhhhmddddhhhhhhhhhhhhhhmdddddddddddpchhhhhmdd          pchhhhhldd         dddchhhhhhhhmddddd  "],
+  ["   █████████████████████████████████████   ████████████████████████████████████         ███████████          ███████████  █      ", "   ddddddddddddddddddddddddddddddddddddd   ddddddddddddddddddcchhhhhhhhhhhhmddd         dpccldddddd          dpchldddddd  d      "],
+  ["                                                         ██ █████████████████           ██████               ██████              ", "                                                         dd chhhhhhhhhhlddddd           dddddd               dddddd              "],
+  ["                                                         ████████████████                                                        ", "                                                         dddddddddddddddd                                                        "],
+] as const;
+
+const NEON_HEADER_TONES: MascotTonePalette = {
+  b: "#FFFFFF",
+  h: { kind: "theme", token: "accent" },
+  l: { kind: "theme", token: "accent", dimmed: true },
+  m: { kind: "theme", token: "accent", dimmed: true },
+  d: "#12011B",
+  p: { kind: "theme", token: "accent", dimmed: true },
+  c: "#FFFFFF",
+  v: "#FFFFFF",
+};
+
 type HeaderPalette = {
   baseColor: string;
   highlightColor: string;
@@ -148,7 +219,13 @@ export const MASCOT_TONE_KEYS = {
 export type MascotToneKey =
   (typeof MASCOT_TONE_KEYS)[keyof typeof MASCOT_TONE_KEYS];
 
-export type MascotTonePalette = Record<MascotToneKey, string>;
+export type ThemeForegroundColor = {
+  kind: "theme";
+  token: string;
+  dimmed?: true;
+};
+
+export type MascotTonePalette = Record<MascotToneKey, string | ThemeForegroundColor>;
 
 type HeaderVariantConfig = {
   label: string;
@@ -162,18 +239,6 @@ type HeaderVariantConfig = {
   mascotTonePalette?: MascotTonePalette;
 };
 
-const CLASSIC_PALETTE: HeaderPalette = {
-  baseColor: "accent",
-  highlightColor: "mdHeading",
-  trailColor: "mdLink",
-};
-
-const CLASSIC_LINK_PALETTE: HeaderPalette = {
-  baseColor: "mdLink",
-  highlightColor: "mdHeading",
-  trailColor: "accent",
-};
-
 const OSDY_THEME_CYAN_PALETTE: HeaderPalette = {
   baseColor: "accent",
   highlightColor: "mdHeading",
@@ -209,6 +274,17 @@ const HTML_MASCOT_TONES: MascotTonePalette = {
   v: "mdLink",
 };
 
+const BTS_MASCOT_TONES: MascotTonePalette = {
+  b: "#FCFCFC",
+  h: "#F9F3E7",
+  l: "#DDD5CC",
+  m: "#969291",
+  d: "#53445F",
+  p: "#C9BBA8",
+  c: "#CDA5F1",
+  v: "#746D6C",
+};
+
 const RAW_BODY_TONE_KEYS = [
   MASCOT_TONE_KEYS.background,
   MASCOT_TONE_KEYS.bright,
@@ -220,7 +296,8 @@ const RAW_HEX_COLOR = /^#[0-9A-F]{6}$/;
 
 function assertRawHexPalette(palette: MascotTonePalette): void {
   for (const tone of RAW_BODY_TONE_KEYS) {
-    if (!RAW_HEX_COLOR.test(palette[tone])) {
+    const color = palette[tone];
+    if (typeof color !== "string" || !RAW_HEX_COLOR.test(color)) {
       throw new Error(`Mascot tone ${tone} must be a #RRGGBB color.`);
     }
   }
@@ -378,9 +455,31 @@ const ROSE_MASCOT = addRightEdgeGlow({
   mascot: HTML_MASCOT,
   toneMap: HTML_MASCOT_MAP,
 });
+const BTS_MASCOT_ART = addRightEdgeGlow({
+  mascot: BTS_MASCOT,
+  toneMap: BTS_MASCOT_MAP,
+});
+for (const [art, palette] of [
+  [ROSE_MASCOT, HTML_MASCOT_TONES],
+  [BTS_MASCOT_ART, BTS_MASCOT_TONES],
+] as const) {
+  assertRawHexPalette(palette);
+  assertMascotStructure(art, palette);
+}
 
-assertRawHexPalette(HTML_MASCOT_TONES);
-assertMascotStructure(ROSE_MASCOT, HTML_MASCOT_TONES);
+export type MascotConfig = {
+  art: MascotArt;
+  tonePalette: MascotTonePalette;
+};
+
+export const MASCOTS: Record<MascotChoice, MascotConfig> = {
+  current: { art: ROSE_MASCOT, tonePalette: HTML_MASCOT_TONES },
+  bts: { art: BTS_MASCOT_ART, tonePalette: BTS_MASCOT_TONES },
+};
+
+export function mascotForChoice(choice: MascotChoice): MascotConfig {
+  return MASCOTS[choice];
+}
 
 type PreparedMascotArt = {
   art: MascotArt;
@@ -453,13 +552,14 @@ export const HEADER_VARIANTS: Record<HeaderVariant, HeaderVariantConfig> = {
     mascotPalette: OSDY_THEME_MASCOT_PALETTE,
     mascotTonePalette: HTML_MASCOT_TONES,
   },
-  classic: {
-    label: "Classic",
-    header: HEADER_CLASSIC,
+  neon: {
+    label: "Neon",
+    header: NEON_HEADER_ROWS.map(([header]) => header),
+    headerMap: NEON_HEADER_ROWS.map(([, toneMap]) => toneMap),
+    headerTonePalette: NEON_HEADER_TONES,
     mascot: ROSE_MASCOT.mascot,
     mascotMap: ROSE_MASCOT.toneMap,
-    linePalette: (lineIndex) =>
-      lineIndex >= 6 ? CLASSIC_LINK_PALETTE : CLASSIC_PALETTE,
+    linePalette: osdyThemePalette,
     mascotPalette: OSDY_THEME_MASCOT_PALETTE,
     mascotTonePalette: HTML_MASCOT_TONES,
   },

package/extensions/osdy-pi/context-usage-ui.test.ts

@@ -0,0 +1,168 @@
+import assert from "node:assert/strict";
+import { existsSync, readFileSync } from "node:fs";
+import { registerHooks } from "node:module";
+import test from "node:test";
+import { fileURLToPath } from "node:url";
+import ts from "typescript";
+import { visibleWidth } from "@earendil-works/pi-tui";
+
+registerHooks({
+	resolve(specifier, context, nextResolve) {
+		if (
+			specifier.startsWith(".") &&
+			specifier.endsWith(".js") &&
+			context.parentURL?.endsWith(".ts")
+		) {
+			const sourceUrl = new URL(`${specifier.slice(0, -3)}.ts`, context.parentURL);
+			if (existsSync(fileURLToPath(sourceUrl))) {
+				return { shortCircuit: true, url: sourceUrl.href };
+			}
+		}
+		return nextResolve(specifier, context);
+	},
+	load(url, context, nextLoad) {
+		if (url.endsWith(".ts")) {
+			return {
+				format: "module",
+				shortCircuit: true,
+				source: ts.transpileModule(readFileSync(fileURLToPath(url), "utf8"), {
+					compilerOptions: {
+						module: ts.ModuleKind.ESNext,
+						target: ts.ScriptTarget.ES2022,
+					},
+				}).outputText,
+			};
+		}
+		return nextLoad(url, context);
+	},
+});
+
+const { formatContextUsage } = await import("./context-usage-ui.js");
+
+const theme = {
+	fg(token: string, text: string): string {
+		return `<${token}>${text}</${token}>`;
+	},
+};
+
+void test("formats the selected single-line usage shape", () => {
+	assert.equal(
+		formatContextUsage(theme, {
+			input: 0,
+			output: 0,
+			cacheRead: 0,
+			cacheWrite: 0,
+			cost: 0,
+			percent: 60,
+			contextWindow: 272_000,
+		}),
+		"tok ↑0 ↓0 · $0.0000 · ctx <warning>[██████░░░░]</warning> 60%/272.0k",
+	);
+});
+
+void test("selects the full or compact usage line at the ANSI-aware width boundary", () => {
+	const ansiTheme = {
+		fg(_token: string, text: string): string {
+			return `\u001B[33m${text}\u001B[39m`;
+		},
+	};
+	const usage = {
+		input: 0,
+		output: 0,
+		cacheRead: 0,
+		cacheWrite: 0,
+		cost: 0,
+		percent: 60,
+		contextWindow: 272_000,
+	};
+	const full =
+		"tok ↑0 ↓0 · $0.0000 · ctx \u001B[33m[██████░░░░]\u001B[39m 60%/272.0k";
+
+	assert.equal(visibleWidth(full), 49);
+	assert.equal(formatContextUsage(ansiTheme, usage, 49), full);
+	assert.equal(
+		formatContextUsage(ansiTheme, usage, 48),
+		"$0.0000 · ctx \u001B[33m[██████░░░░]\u001B[39m 60%",
+	);
+});
+
+void test("formats a ten-cell green context bar at the inclusive 30% threshold", () => {
+	assert.equal(
+		formatContextUsage(theme, {
+			input: 0,
+			output: 0,
+			cacheRead: 0,
+			cacheWrite: 0,
+			cost: 0,
+			percent: 30,
+			contextWindow: 272_000,
+		}),
+		"tok ↑0 ↓0 · $0.0000 · ctx <success>[███░░░░░░░]</success> 30%/272.0k",
+	);
+});
+
+void test("uses warning and error colors for higher rounded usage", () => {
+	assert.equal(
+		formatContextUsage(theme, {
+			input: 1_500,
+			output: 2_500_000,
+			cacheRead: 12,
+			cacheWrite: 34,
+			cost: 1.2,
+			percent: 30.5,
+			contextWindow: 200_000,
+		}),
+		"tok ↑1.5k ↓2.5m R12 W34 · $1.2000 · ctx <warning>[███░░░░░░░]</warning> 31%/200.0k",
+	);
+	assert.equal(
+		formatContextUsage(theme, {
+			input: 0,
+			output: 0,
+			cacheRead: 0,
+			cacheWrite: 0,
+			cost: 1.2,
+			percent: 80.5,
+			contextWindow: 200_000,
+		}),
+		"tok ↑0 ↓0 · $1.2000 · ctx <error>[████████░░]</error> 81%/200.0k",
+	);
+});
+
+void test("clamps usage and safely represents missing context usage", () => {
+	assert.equal(
+		formatContextUsage(theme, {
+			input: 0,
+			output: 0,
+			cacheRead: 0,
+			cacheWrite: 0,
+			cost: 0,
+			percent: -10,
+			contextWindow: 200_000,
+		}),
+		"tok ↑0 ↓0 · $0.0000 · ctx <success>[░░░░░░░░░░]</success> 0%/200.0k",
+	);
+	assert.equal(
+		formatContextUsage(theme, {
+			input: 0,
+			output: 0,
+			cacheRead: 0,
+			cacheWrite: 0,
+			cost: 0,
+			percent: undefined,
+			contextWindow: 272_000,
+		}),
+		"tok ↑0 ↓0 · $0.0000 · ctx <success>[░░░░░░░░░░]</success> ?%/272.0k",
+	);
+	assert.equal(
+		formatContextUsage(theme, {
+			input: 0,
+			output: 0,
+			cacheRead: 0,
+			cacheWrite: 0,
+			cost: 0,
+			percent: undefined,
+			contextWindow: undefined,
+		}),
+		"tok ↑0 ↓0 · $0.0000 · ctx <success>[░░░░░░░░░░]</success> ?%/?",
+	);
+});

package/extensions/osdy-pi/context-usage-ui.ts

@@ -0,0 +1,60 @@
+import { visibleWidth } from "@earendil-works/pi-tui";
+import { shortNumber } from "./format.js";
+
+export type ContextUsageDisplayData = {
+	input: number;
+	output: number;
+	cacheRead: number;
+	cacheWrite: number;
+	cost: number;
+	percent: number | undefined;
+	contextWindow: number | undefined;
+};
+
+type UsageTheme = {
+	fg(token: "success" | "warning" | "error", text: string): string;
+};
+
+function roundedClampedPercent(
+	percent: number | undefined,
+): number | undefined {
+	if (percent === undefined || !Number.isFinite(percent)) return undefined;
+	return Math.min(100, Math.max(0, Math.round(percent)));
+}
+
+function usageTone(percent: number): "success" | "warning" | "error" {
+	if (percent <= 30) return "success";
+	if (percent <= 80) return "warning";
+	return "error";
+}
+
+function usageBar(percent: number): string {
+	const filledCells = Math.round(percent / 10);
+	return "█".repeat(filledCells) + "░".repeat(10 - filledCells);
+}
+
+export function formatContextUsage(
+	theme: UsageTheme,
+	usage: ContextUsageDisplayData,
+	availableWidth?: number,
+): string {
+	const percent = roundedClampedPercent(usage.percent);
+	const displayPercent = percent ?? 0;
+	const percentageLabel = percent === undefined ? "?" : String(percent);
+	const contextWindowLabel =
+		usage.contextWindow === undefined || !Number.isFinite(usage.contextWindow)
+			? "?"
+			: shortNumber(usage.contextWindow);
+	const cacheLabel =
+		usage.cacheRead || usage.cacheWrite
+			? ` R${shortNumber(usage.cacheRead)} W${shortNumber(usage.cacheWrite)}`
+			: "";
+	const bar = theme.fg(
+		usageTone(displayPercent),
+		`[${usageBar(displayPercent)}]`,
+	);
+	const full = `tok ↑${shortNumber(usage.input)} ↓${shortNumber(usage.output)}${cacheLabel} · $${usage.cost.toFixed(4)} · ctx ${bar} ${percentageLabel}%/${contextWindowLabel}`;
+	if (availableWidth === undefined || visibleWidth(full) <= availableWidth)
+		return full;
+	return `$${usage.cost.toFixed(4)} · ctx ${bar} ${percentageLabel}%`;
+}

package/extensions/osdy-pi/editor-settings.test.ts

@@ -4,10 +4,14 @@ import {
 	createEditorSettingsStore,
 	normalizeEditorSettings,
 	type EditorSettingsFileSystem,
-// @ts-expect-error Node's native TypeScript runner resolves test-only TypeScript source imports.
+	// @ts-expect-error Node's native TypeScript runner resolves test-only TypeScript source imports.
 } from "./editor-settings.ts";
-// @ts-expect-error Node's native TypeScript runner resolves test-only TypeScript source imports.
-import { EDITOR_MODES } from "./types.ts";
+import {
+	EDITOR_MODES,
+	HEADER_VARIANT_CHOICES,
+	MASCOT_CHOICES,
+	// @ts-expect-error Node's native TypeScript runner resolves test-only TypeScript source imports.
+} from "./types.ts";
 
 class MemoryEditorSettingsFileSystem implements EditorSettingsFileSystem {
 	content: string | undefined;
@@ -41,35 +45,120 @@ class MemoryEditorSettingsFileSystem implements EditorSettingsFileSystem {
 	private pendingContent = "";
 }
 
+void test("editor settings preserve version-one header choices and fall back safely", async () => {
+	assert.deepEqual(HEADER_VARIANT_CHOICES, ["osdy-theme", "neon"]);
+	assert.equal(
+		normalizeEditorSettings({ version: 1 }).headerVariant,
+		"osdy-theme",
+	);
+	assert.equal(
+		normalizeEditorSettings({ version: 1, headerVariant: "classic" })
+			.headerVariant,
+		"osdy-theme",
+	);
+	assert.equal(
+		normalizeEditorSettings({ version: 1, headerVariant: "invalid" })
+			.headerVariant,
+		"osdy-theme",
+	);
+
+	const fileSystem = new MemoryEditorSettingsFileSystem();
+	const store = createEditorSettingsStore(
+		"/agent/extensions/osdy-pi/settings.json",
+		fileSystem,
+	);
+	await store.save({
+		version: 1,
+		enabled: true,
+		editorMode: EDITOR_MODES.AUTO,
+		workingTreeEnabled: true,
+		headerVariant: "neon",
+		mascot: "current",
+	});
+	assert.equal((await store.load()).headerVariant, "neon");
+});
+
 void test("editor settings normalize only supported versioned modes", () => {
-	assert.deepEqual(
-		normalizeEditorSettings({ version: 1, editorMode: "simple" }),
-		{
+	for (const [input, editorMode] of [
+		[{ version: 1, editorMode: "simple" }, EDITOR_MODES.SIMPLE],
+		[{ version: 1, editorMode: "invalid" }, EDITOR_MODES.AUTO],
+		[{ version: 2, editorMode: "extended" }, EDITOR_MODES.AUTO],
+		[null, EDITOR_MODES.AUTO],
+	] as const) {
+		assert.deepEqual(normalizeEditorSettings(input), {
 			version: 1,
-			editorMode: EDITOR_MODES.SIMPLE,
+			enabled: true,
+			editorMode,
 			workingTreeEnabled: true,
-		},
+			headerVariant: "osdy-theme",
+			mascot: "current",
+		});
+	}
+});
+
+void test("mascot choices preserve the version-one current default, migrate raccoon to Bts, and persist Bts", async () => {
+	assert.deepEqual(MASCOT_CHOICES, ["current", "bts"]);
+	assert.equal(
+		normalizeEditorSettings({ version: 1, mascot: "invalid" }).mascot,
+		"current",
 	);
-	assert.deepEqual(
-		normalizeEditorSettings({ version: 1, editorMode: "invalid" }),
-		{
-			version: 1,
-			editorMode: EDITOR_MODES.AUTO,
-			workingTreeEnabled: true,
-		},
+	assert.equal(
+		normalizeEditorSettings({ version: 1, mascot: "raccoon" }).mascot,
+		"bts",
 	);
-	assert.deepEqual(
-		normalizeEditorSettings({ version: 2, editorMode: "extended" }),
-		{
-			version: 1,
-			editorMode: EDITOR_MODES.AUTO,
-			workingTreeEnabled: true,
-		},
+	for (const mascot of ["detective", "explorer"] as const) {
+		assert.equal(
+			normalizeEditorSettings({ version: 1, mascot }).mascot,
+			"current",
+		);
+	}
+
+	const fileSystem = new MemoryEditorSettingsFileSystem();
+	const store = createEditorSettingsStore(
+		"/agent/extensions/osdy-pi/settings.json",
+		fileSystem,
 	);
-	assert.deepEqual(normalizeEditorSettings(null), {
+	await store.save({
 		version: 1,
+		enabled: true,
 		editorMode: EDITOR_MODES.AUTO,
 		workingTreeEnabled: true,
+		headerVariant: "neon",
+		mascot: "bts",
+	});
+	assert.equal((await store.load()).mascot, "bts");
+});
+
+void test("enabled defaults safely and persists globally", async () => {
+	assert.equal(
+		normalizeEditorSettings({ version: 1, editorMode: "simple" }).enabled,
+		true,
+	);
+	assert.equal(
+		normalizeEditorSettings({ version: 1, enabled: "no" }).enabled,
+		true,
+	);
+
+	const fileSystem = new MemoryEditorSettingsFileSystem();
+	const store = createEditorSettingsStore(
+		"/agent/extensions/osdy-pi/settings.json",
+		fileSystem,
+	);
+	await store.save({
+		version: 1,
+		enabled: false,
+		editorMode: EDITOR_MODES.SIMPLE,
+		workingTreeEnabled: false,
+		headerVariant: "osdy-theme",
+		mascot: "current",
+	});
+	assert.deepEqual(await store.load(), {
+		version: 1,
+		enabled: false,
+		editorMode: EDITOR_MODES.SIMPLE,
+		workingTreeEnabled: false,
+		headerVariant: "osdy-theme",
+		mascot: "current",
 	});
 });
 
@@ -98,8 +187,11 @@ void test("working-tree visibility defaults safely and persists globally", async
 	);
 	await firstStore.save({
 		version: 1,
+		enabled: true,
 		editorMode: EDITOR_MODES.AUTO,
 		workingTreeEnabled: false,
+		headerVariant: "osdy-theme",
+		mascot: "current",
 	});
 	const reloadedStore = createEditorSettingsStore(
 		"/agent/extensions/osdy-pi/settings.json",
@@ -125,8 +217,11 @@ void test("editor settings load safely and save atomically", async () => {
 
 	await store.save({
 		version: 1,
+		enabled: true,
 		editorMode: EDITOR_MODES.SIMPLE,
 		workingTreeEnabled: true,
+		headerVariant: "osdy-theme",
+		mascot: "current",
 	});
 	assert.deepEqual(fileSystem.mkdirPaths, ["/agent/extensions/osdy-pi"]);
 	assert.deepEqual(fileSystem.writePaths, [
@@ -152,8 +247,11 @@ void test("new editor settings stores load their own persisted mode", async () =
 
 	await firstStore.save({
 		version: 1,
+		enabled: true,
 		editorMode: EDITOR_MODES.EXTENDED,
 		workingTreeEnabled: true,
+		headerVariant: "osdy-theme",
+		mascot: "current",
 	});
 	const reloadedStore = createEditorSettingsStore(
 		"/agent/extensions/osdy-pi/settings.json",