@rosetears/aili-pi 0.1.7 → 0.1.8

package/README.md

@@ -49,11 +49,15 @@ The package does not write global AILI resources during extension load. After re
 
 That command creates or updates only the AILI marker block in `~/.pi/agent/APPEND_SYSTEM.md` and installs the 19 packaged profiles at `~/.pi/agent/agents/aili/`. The marker block is a Pi-native governance derivation of the pinned `aili-workflows` global AGENTS template: it retains instruction precedence, untrusted-content handling, approval/evidence/verification discipline, bounded delegation, project-rule precedence, and user-language output, while excluding OpenCode-only control planes. It preserves unrelated prompt content, rejects malformed markers or an unowned profile collision, and reports stale profiles without pruning them.
 
-## Rem Cyberdeck
+## Rose Cyberdeck
 
-The package supplies the dark `rem-cyberdeck` theme plus three additional Pi Extensions: a Rem header, Sakura Matrix animation, and Zentui footer/editor surface. Select it through Pi's `/settings` theme selector or set `"theme": "rem-cyberdeck"` in `~/.pi/agent/settings.json`. The visual extensions are derived from `pi-sakura-cyberdeck` at revision `165a1f8011a12a58a6409b56b8a6c0416cd9b589` under MIT; see `THIRD_PARTY_NOTICES.md` and `notices/pi-sakura-cyberdeck-NOTICE.txt`.
+The package supplies the dark `rose-cyberdeck` theme plus three additional Pi Extensions: a Rose header, Rose Shimmer + four-row Rose Code Rain working surface, and Zentui footer/editor surface. Select it through Pi's `/settings` theme selector or set `"theme": "rose-cyberdeck"` in `~/.pi/agent/settings.json`. The visual extensions are adapted from `pi-sakura-cyberdeck` at revision `165a1f8011a12a58a6409b56b8a6c0416cd9b589` under MIT; see `THIRD_PARTY_NOTICES.md` and `notices/pi-sakura-cyberdeck-NOTICE.txt`.
 
-Matrix keeps the pinned sparse waterfall rhythm and default `density=0.65`, while bounded ultra-wide tracks are spread across the complete terminal-cell width instead of truncating to a left prefix. `/sakura-matrix status` reports its settings; use `/sakura-matrix density <0.45-0.95>` for an explicit density preference. The `✦ REASONING` trail uses the same pinned Sakura pastel gradient.
+Rose Code Rain retains the pinned sparse waterfall geometry and default `density=0.65`, while bounded ultra-wide tracks are spread across the complete terminal-cell width instead of truncating to a left prefix. `/rose-matrix status` reports its settings; use `/rose-matrix density <0.45-0.95>` or `/rose-matrix appearance <auto|dark|light>` for explicit preferences. `/sakura-matrix` remains a deprecated compatibility alias. The `✦ REASONING` trail uses the Rose-to-ice gradient.
+
+### Migrating from Rem/Sakura names
+
+Replace an exact legacy `rem-cyberdeck` theme token with `rose-cyberdeck` through `/settings` or `~/.pi/agent/settings.json`; when using a `light/dark` pair, replace only the legacy side. Existing `sakura-cyberdeck-matrix.json` and `rem-cyberdeck-zentui.json` configuration files are read compatibly and retained. Legacy product names below appear only for migration or upstream attribution.
 
 Zentui enables its experimental fixed-bottom editor by default when the installed Pi TUI exposes the required private layout capabilities. If capability detection or installation fails, it keeps Pi's native editor and emits a warning. The feature uses the terminal alternate screen; its default mouse scrolling can interfere with terminal text selection and tmux scrollback. Use Zentui's `/zentui` settings to disable the fixed editor or mouse scrolling. Zentui hides `pi-cache-stats` by default so the one canonical Codex weekly quota remains visible; explicitly re-enabled cache stats follow quota in the bounded footer.
 

package/THIRD_PARTY_NOTICES.md

@@ -99,7 +99,7 @@ This distribution is MIT-licensed. The following adapted sources and locked deve
 - License: MIT
 - Source files: extensions/header/index.ts, extensions/matrix/index.ts, extensions/zentui/**
 - Reused symbols/patterns: header, matrix animation, Zentui footer, fixed editor compositor
-- Local changes: registered as three additional Pi Package Extensions; header avatar loads the supplied Rem asset; Zentui shell palette uses Rem while Matrix and the reasoning trail retain the upstream Sakura palette; overflowing Matrix tracks are sampled deterministically across the complete terminal width while retaining the 96-track budget and ordinary-width behavior; relative import specifiers and session lifecycle event are adapted for this package's NodeNext TypeScript contract
+- Local changes: registered as three additional Pi Package Extensions; Rose header loads a package-owned renamed artwork asset without changing upstream identity; Rose Shimmer, Rose Code Rain, and Zentui use the Rose-owned palette and gradient; overflowing Matrix tracks remain deterministic across the complete terminal width with the 96-track budget, while each rain row receives a structural blank-row repair; relative import specifiers and session lifecycle event are adapted for this package's NodeNext TypeScript contract
 
 ## npm dependency inventory
 

package/extensions/header/index.ts

@@ -1,6 +1,8 @@
 import { readFileSync } from "node:fs";
+import { getAgentDir, type ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import { fileURLToPath } from "node:url";
-import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import { join } from "node:path";
+import { legacyRoseThemeGuidanceFromSettings } from "../../src/runtime/rose-theme.js";
 
 const RESET = "\x1b[0m";
 const BOLD = "\x1b[1m";
@@ -26,7 +28,7 @@ function gradient(text: string, from: RGB, to: RGB, bold = false): string {
   }).join("");
 }
 
-const ANIME_ART = readFileSync(fileURLToPath(new URL("../../src/runtime/rem-head.txt", import.meta.url)), "utf8").trimEnd().split("\n") as readonly string[];
+const ROSE_ART = readFileSync(fileURLToPath(new URL("../../src/runtime/rose-head.txt", import.meta.url)), "utf8").trimEnd().split("\n") as readonly string[];
 
 function getAvailableRows(tui: unknown): number {
   try {
@@ -38,15 +40,15 @@ function getAvailableRows(tui: unknown): number {
   }
 }
 
-function renderHeader(width: number, availableRows = 0): string[] {
+export function renderRoseHeader(width: number, availableRows = 0): string[] {
   if (width <= 0) return [];
 
-  const sakura: RGB = [136, 184, 255];
-  const peach: RGB = [125, 228, 255];
-  const lavender: RGB = [188, 167, 255];
-  const sky: RGB = [214, 244, 255];
-  const telemetry = "◈  REM CYBERDECK  ◈";
-  const artWidth = Math.max(...ANIME_ART.map((line) => [...line].length));
+  const blue: RGB = [136, 184, 255];
+  const cyan: RGB = [125, 228, 255];
+  const violet: RGB = [188, 167, 255];
+  const ice: RGB = [214, 244, 255];
+  const telemetry = "◈  ROSE CYBERDECK  ◈";
+  const artWidth = Math.max(...ROSE_ART.map((line) => [...line].length));
   const visibleArtWidth = Math.min(width, artWidth);
   const artPad = " ".repeat(Math.max(0, Math.floor((width - visibleArtWidth) / 2) - 2));
   // Keep the divider visually subordinate: inset it symmetrically from the artwork.
@@ -58,12 +60,12 @@ function renderHeader(width: number, availableRows = 0): string[] {
   const telemetryWidth = [...visibleTelemetry].length;
   const telemetryPad = " ".repeat(Math.max(0, Math.min(width - telemetryWidth, Math.floor((width - telemetryWidth) / 2) + 1)));
 
-  const art = ANIME_ART.map((line) => {
+  const art = ROSE_ART.map((line) => {
     const clipped = [...line].slice(0, visibleArtWidth).join("");
-    return `${artPad}${gradient(clipped, sakura, sky)}`;
+    return `${artPad}${gradient(clipped, blue, ice)}`;
   });
 
-  const visualHeight = ANIME_ART.length + 3; // artwork + gap + divider + label
+  const visualHeight = ROSE_ART.length + 3; // artwork + gap + divider + label
   const extraTopPadding = Math.max(0, Math.floor((availableRows - visualHeight) / 2) - 1);
 
   return [
@@ -71,17 +73,25 @@ function renderHeader(width: number, availableRows = 0): string[] {
     "",
     ...art,
     "",
-    `${railPad}${gradient(rail, sakura, sky)}`,
-    `${telemetryPad}${gradient(visibleTelemetry, lavender, peach, true)}`,
+    `${railPad}${gradient(rail, blue, ice)}`,
+    `${telemetryPad}${gradient(visibleTelemetry, violet, cyan, true)}`,
     "",
   ];
 }
 
-export default function sakuraCyberdeckHeader(pi: ExtensionAPI): void {
+export default function roseCyberdeckHeader(pi: ExtensionAPI): void {
+  let legacyThemeNoticeSent = false;
   pi.on("session_start", (_event, ctx) => {
     if (!ctx.hasUI) return;
+    if (!legacyThemeNoticeSent) {
+      const guidance = legacyRoseThemeGuidanceFromSettings(join(getAgentDir(), "settings.json"));
+      if (guidance) {
+        legacyThemeNoticeSent = true;
+        ctx.ui.notify(guidance, "warning");
+      }
+    }
     ctx.ui.setHeader((tui) => ({
-      render: (width) => renderHeader(width, getAvailableRows(tui)),
+      render: (width) => renderRoseHeader(width, getAvailableRows(tui)),
       invalidate() {},
     }));
   });

package/extensions/matrix/index.ts

@@ -1,42 +1,50 @@
-import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import {
+  existsSync,
+  lstatSync,
+  mkdirSync,
+  readFileSync,
+  renameSync,
+  statSync,
+  unlinkSync,
+  writeFileSync,
+} from "node:fs";
 import { homedir } from "node:os";
-import { join } from "node:path";
+import { basename, dirname, join } from "node:path";
 import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
+import { truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
 
-const WIDGET_KEY = "sakura-matrix-engine";
-const CONFIG_PATH = join(homedir(), ".pi", "agent", "sakura-cyberdeck-matrix.json");
+const WIDGET_KEY = "rose-matrix-engine";
+const CONFIG_PATH = join(homedir(), ".pi", "agent", "rose-cyberdeck-matrix.json");
+const LEGACY_CONFIG_PATH = join(homedir(), ".pi", "agent", "sakura-cyberdeck-matrix.json");
 const RESET = "\x1b[0m";
-export const SAKURA_MATRIX_GLYPHS = [..."0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZｱｲｳｴｵｶｷｸｹｺｻｼｽｾｿﾀﾁﾂﾃﾄﾅﾆﾇﾈﾉﾊﾋﾌﾍﾎﾏﾐﾑﾒﾓﾗﾘﾙﾚﾛﾜﾝ"];
-const BG: RGB = [20, 17, 26];
-const TEXT: RGB = [247, 238, 248];
-const CANDY: readonly RGB[] = [
-  [242, 167, 198], // sakura
-  [252, 201, 185], // sakura-iro
-  [239, 195, 230], // petal
-  [199, 184, 245], // lavender
-  [159, 211, 242], // sky
-  [174, 229, 197], // mint
-];
-const WORKING_INDICATOR = "◆";
 const MAX_DROPS = 96;
-const PHASE_MESSAGES: Record<Phase, string> = {
-  thinking: "Weaving the next move…",
-  working: "Composing the response…",
-  tool: "Running tools…",
-};
+const SHIMMER_STEP_MS = 120;
+const TOOL_GRADIENT: readonly RGB[] = [[188, 167, 255], [125, 228, 255]];
+
+export const ROSE_MATRIX_GLYPHS = [..."0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZｱｲｳｴｵｶｷｸｹｺｻｼｽｾｿﾀﾁﾂﾃﾄﾅﾆﾇﾈﾉﾊﾋﾌﾍﾎﾏﾐﾑﾒﾓﾗﾘﾙﾚﾛﾜﾝ"];
+export const ROSE_RAIN_PALETTE: readonly RGB[] = [
+  [136, 184, 255], [125, 228, 255], [214, 244, 255], [136, 184, 255],
+  [125, 228, 255], [214, 244, 255], [136, 184, 255], [125, 228, 255],
+  [214, 244, 255], [136, 184, 255], [199, 91, 122], [232, 167, 184],
+];
+export const ROSE_SHIMMER_INDICATOR = ["·", "✢", "✳", "✶", "✻", "✽", "✻", "✶", "✳", "✢"] as const;
 
 type RGB = readonly [number, number, number];
-type Phase = "thinking" | "working" | "tool";
+export type Appearance = "auto" | "dark" | "light";
+export type ResolvedAppearance = Exclude<Appearance, "auto">;
+export type Phase = "requesting" | "thinking" | "working" | "tool";
 type Timer = ReturnType<typeof setTimeout>;
 
-interface MatrixConfig {
+export interface MatrixConfig {
+  version: 2;
   enabled: boolean;
   fps: number;
   density: number;
-  height: number;
+  height: 4;
+  appearance: Appearance;
 }
 
-interface Drop {
+export interface Drop {
   x: number;
   offset: number;
   speed: number;
@@ -46,34 +54,113 @@ interface Drop {
   color: RGB;
 }
 
+type ConfigLoadResult = { config: MatrixConfig; migrated: boolean; warning?: string };
+
 const DEFAULT_CONFIG: MatrixConfig = {
+  version: 2,
   enabled: true,
   fps: 10,
   density: 0.65,
   height: 4,
+  appearance: "auto",
+};
+
+const PHASE_MESSAGES: Record<Phase, string> = {
+  requesting: "Connecting to the model…",
+  thinking: "Weaving the next move…",
+  working: "Composing the response…",
+  tool: "Running tools…",
+};
+
+const DARK = {
+  fade: [16, 18, 29] as RGB,
+  base: [136, 184, 255] as RGB,
+  highlight: [214, 244, 255] as RGB,
+  indicator: [199, 91, 122] as RGB,
+};
+const LIGHT = {
+  fade: [250, 247, 242] as RGB,
+  base: [92, 115, 151] as RGB,
+  highlight: [42, 38, 34] as RGB,
+  indicator: [168, 69, 95] as RGB,
 };
 
 function clamp(value: number, min: number, max: number): number {
   return Math.min(max, Math.max(min, value));
 }
 
-function loadConfig(): MatrixConfig {
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+
+function isSafeRegularFile(path: string): boolean {
   try {
-    if (!existsSync(CONFIG_PATH)) return { ...DEFAULT_CONFIG };
-    const parsed = JSON.parse(readFileSync(CONFIG_PATH, "utf8")) as Partial<MatrixConfig>;
-    return {
-      enabled: typeof parsed.enabled === "boolean" ? parsed.enabled : DEFAULT_CONFIG.enabled,
-      fps: clamp(Number(parsed.fps) || DEFAULT_CONFIG.fps, 8, 18),
-      density: clamp(Number(parsed.density) || DEFAULT_CONFIG.density, 0.45, 0.95),
-      height: clamp(Math.round(Number(parsed.height) || DEFAULT_CONFIG.height), 3, 6),
-    };
+    const link = lstatSync(path);
+    return !link.isSymbolicLink() && statSync(path).isFile();
   } catch {
-    return { ...DEFAULT_CONFIG };
+    return false;
   }
 }
 
-function saveConfig(config: MatrixConfig): void {
-  writeFileSync(CONFIG_PATH, `${JSON.stringify(config, null, 2)}\n`, "utf8");
+function parseConfig(value: unknown): MatrixConfig {
+  const parsed = isRecord(value) ? value : {};
+  return {
+    version: 2,
+    enabled: typeof parsed.enabled === "boolean" ? parsed.enabled : DEFAULT_CONFIG.enabled,
+    fps: clamp(Math.round(Number(parsed.fps) || DEFAULT_CONFIG.fps), 8, 18),
+    density: clamp(Number(parsed.density) || DEFAULT_CONFIG.density, 0.45, 0.95),
+    height: 4,
+    appearance: parsed.appearance === "dark" || parsed.appearance === "light" || parsed.appearance === "auto"
+      ? parsed.appearance
+      : "auto",
+  };
+}
+
+function writeConfigAtomically(path: string, config: MatrixConfig): void {
+  mkdirSync(dirname(path), { recursive: true });
+  if (existsSync(path) && !isSafeRegularFile(path)) {
+    throw new Error(`Refusing to overwrite unsafe Matrix config: ${path}`);
+  }
+  const temp = join(dirname(path), `.${basename(path)}.${process.pid}.tmp`);
+  try {
+    writeFileSync(temp, `${JSON.stringify(config, null, 2)}\n`, { encoding: "utf8", flag: "wx" });
+    renameSync(temp, path);
+  } catch (error) {
+    try { unlinkSync(temp); } catch {}
+    throw error;
+  }
+}
+
+export function loadRoseMatrixConfig(
+  path = CONFIG_PATH,
+  legacyPath = LEGACY_CONFIG_PATH,
+): ConfigLoadResult {
+  if (existsSync(path)) {
+    if (!isSafeRegularFile(path)) return { config: { ...DEFAULT_CONFIG }, migrated: false, warning: "Rose Matrix config is unsafe; using runtime defaults." };
+    try {
+      return { config: parseConfig(JSON.parse(readFileSync(path, "utf8"))), migrated: false };
+    } catch {
+      return { config: { ...DEFAULT_CONFIG }, migrated: false, warning: "Rose Matrix config is corrupt; using runtime defaults." };
+    }
+  }
+  if (!existsSync(legacyPath)) return { config: { ...DEFAULT_CONFIG }, migrated: false };
+  if (!isSafeRegularFile(legacyPath)) return { config: { ...DEFAULT_CONFIG }, migrated: false, warning: "Legacy Sakura Matrix config is unsafe; using runtime defaults." };
+  try {
+    const legacy = JSON.parse(readFileSync(legacyPath, "utf8"));
+    if (!isRecord(legacy)) throw new Error("not an object");
+    const config = parseConfig(legacy);
+    writeConfigAtomically(path, config);
+    return { config, migrated: true, warning: Number(legacy.height) !== 4 ? "Legacy Matrix height was normalized to four rows." : undefined };
+  } catch {
+    return { config: { ...DEFAULT_CONFIG }, migrated: false, warning: "Legacy Sakura Matrix config is corrupt; using runtime defaults." };
+  }
+}
+
+export function resolveAppearance(appearance: Appearance, themeName: string | undefined): ResolvedAppearance | undefined {
+  if (appearance === "dark" || appearance === "light") return appearance;
+  if (themeName === "light") return "light";
+  if (themeName === "dark" || themeName === "rose-cyberdeck" || themeName === "rem-cyberdeck") return "dark";
+  return undefined;
 }
 
 function mulberry32(seed: number): () => number {
@@ -99,27 +186,25 @@ function colorize(char: string, color: RGB, bold = false): string {
   return `\x1b[${bold ? "1;" : ""}38;2;${color[0]};${color[1]};${color[2]}m${char}${RESET}`;
 }
 
-function workingIndicatorFrame(): string {
-  return colorize(WORKING_INDICATOR, CANDY[0] ?? [242, 167, 198], true);
+function fillWidth(content: string, width: number): string {
+  const clipped = truncateToWidth(content, Math.max(1, width), "");
+  return `${clipped}${" ".repeat(Math.max(0, width - visibleWidth(clipped)))}`;
 }
 
 function stableGlyph(seed: number, row: number, timeSlice: number): string {
   let hash = Math.imul(seed ^ (row + 17), 0x45d9f3b);
   hash = Math.imul(hash ^ timeSlice, 0x45d9f3b);
   hash ^= hash >>> 16;
-  return SAKURA_MATRIX_GLYPHS[Math.abs(hash) % SAKURA_MATRIX_GLYPHS.length] ?? "0";
+  return ROSE_MATRIX_GLYPHS[Math.abs(hash) % ROSE_MATRIX_GLYPHS.length] ?? "0";
 }
 
 function selectBoundedColumns(columns: readonly number[]): number[] {
   if (columns.length <= MAX_DROPS) return [...columns];
   const lastIndex = columns.length - 1;
-  return Array.from({ length: MAX_DROPS }, (_, index) => {
-    const sourceIndex = Math.round((index * lastIndex) / (MAX_DROPS - 1));
-    return columns[sourceIndex] ?? 0;
-  });
+  return Array.from({ length: MAX_DROPS }, (_, index) => columns[Math.round((index * lastIndex) / (MAX_DROPS - 1))] ?? 0);
 }
 
-export function createDrops(width: number, density: number, height: number): Drop[] {
+export function createDrops(width: number, density: number, height = 4): Drop[] {
   const random = mulberry32((width * 2654435761) ^ 0x53414b55);
   const columns = Array.from({ length: Math.ceil(width / 2) }, (_, index) => index * 2);
   const active = columns.filter(() => random() < density);
@@ -135,48 +220,121 @@ export function createDrops(width: number, density: number, height: number): Dro
       length,
       gap,
       seed: Math.floor(random() * 0x7fffffff) ^ (index * 7919),
-      color: CANDY[index % CANDY.length] ?? [242, 167, 198],
+      color: ROSE_RAIN_PALETTE[index % ROSE_RAIN_PALETTE.length] ?? ROSE_RAIN_PALETTE[0]!,
     };
   });
 }
 
-export function renderSakuraMatrix(
+function appearanceColor(color: RGB, appearance: ResolvedAppearance): RGB {
+  if (appearance === "dark") return color;
+  if (color[0] === 199 && color[1] === 91) return LIGHT.indicator;
+  if (color[0] === 232 && color[1] === 167) return [168, 69, 95];
+  if (color[0] === 214) return [78, 120, 129];
+  if (color[1] === 228) return [78, 120, 129];
+  return LIGHT.base;
+}
+
+function repairBlankRows(grid: string[][], width: number, appearance: ResolvedAppearance, elapsedSeconds: number): void {
+  const blanks = grid.map((row) => row.every((cell) => cell === " "));
+  if (!blanks.some(Boolean)) return;
+  const seed = Math.floor(elapsedSeconds * 8) ^ (width * 7919) ^ 0x524f5345;
+  const column = Math.max(0, Math.min(width - 1, Math.abs(seed) % Math.max(1, width)));
+  const fallback = appearance === "dark" ? [125, 228, 255] as RGB : [78, 120, 129] as RGB;
+  const occupied = grid.findIndex((row) => row.some((cell) => cell !== " "));
+  for (let row = 0; row < grid.length; row += 1) {
+    if (!blanks[row]) continue;
+    const glyph = stableGlyph(seed + row * 97 + Math.max(0, occupied), row, Math.floor(elapsedSeconds * 8));
+    grid[row]![column] = colorize(glyph, fallback, row === 0 || row === grid.length - 1);
+  }
+}
+
+export function renderRoseMatrix(
   width: number,
   height: number,
   elapsedSeconds: number,
   phase: Phase,
   drops: readonly Drop[],
+  appearance: ResolvedAppearance = "dark",
 ): string[] {
   const safeWidth = Math.max(1, width);
-  const safeHeight = clamp(height, 3, 6);
+  const safeHeight = 4;
   const grid: string[][] = Array.from({ length: safeHeight }, () => Array(safeWidth).fill(" "));
   const timeSlice = Math.floor(elapsedSeconds * 8);
   const phaseSpeed = phase === "tool" ? 1.12 : phase === "thinking" ? 1.06 : 1;
+  const palette = appearance === "dark" ? DARK : LIGHT;
 
   for (const drop of drops) {
     const cycle = safeHeight + drop.length + drop.gap;
     const head = ((drop.offset + elapsedSeconds * drop.speed * phaseSpeed) % cycle) - drop.gap;
-    for (let trail = 0; trail < drop.length; trail++) {
+    for (let trail = 0; trail < drop.length; trail += 1) {
       const row = Math.floor(head - trail);
       if (row < 0 || row >= safeHeight || drop.x >= safeWidth) continue;
       const glyph = stableGlyph(drop.seed + trail * 97, row, timeSlice);
+      const trackColor = appearanceColor(drop.color, appearance);
       const color = trail === 0
-        ? mix(drop.color, TEXT, 0.58)
+        ? mix(trackColor, palette.highlight, 0.58)
         : trail === 1
-          ? drop.color
-          : mix(drop.color, BG, clamp((trail - 1) * 0.16, 0, 0.72));
-      const gridRow = grid[row];
-      if (gridRow) gridRow[drop.x] = colorize(glyph, color, trail <= 1);
+          ? trackColor
+          : mix(trackColor, palette.fade, clamp((trail - 1) * 0.16, 0, 0.72));
+      grid[row]![drop.x] = colorize(glyph, color, trail <= 1);
     }
   }
+  repairBlankRows(grid, safeWidth, appearance, elapsedSeconds);
+  return grid.map((row) => fillWidth(`${row.join("")}${RESET}`, safeWidth));
+}
+
+function shimmerIndex(elapsedMs: number): number {
+  return Math.floor(Math.max(0, elapsedMs) / SHIMMER_STEP_MS) % ROSE_SHIMMER_INDICATOR.length;
+}
 
-  return grid.map((row) => `${row.join("")}${RESET}`);
+function formatElapsed(elapsedMs: number): string | undefined {
+  const seconds = Math.floor(Math.max(0, elapsedMs) / 1000);
+  if (seconds < 30) return undefined;
+  if (seconds < 60) return `${seconds}s`;
+  return `${Math.floor(seconds / 60)}m ${String(seconds % 60).padStart(2, "0")}s`;
 }
 
-export default function sakuraMatrixExtension(pi: ExtensionAPI): void {
-  const config = loadConfig();
+export function renderRoseShimmer(
+  width: number,
+  phase: Phase,
+  elapsedMs: number,
+  outputTokens: number | undefined,
+  appearance: ResolvedAppearance,
+): string {
+  const palette = appearance === "dark" ? DARK : LIGHT;
+  const indicator = colorize(ROSE_SHIMMER_INDICATOR[shimmerIndex(elapsedMs)]!, palette.indicator, true);
+  const message = PHASE_MESSAGES[phase];
+  const positions = Math.max(1, message.length - 3);
+  const raw = Math.floor(elapsedMs / SHIMMER_STEP_MS) % (positions * 2);
+  const start = raw < positions ? raw : positions * 2 - raw - 1;
+  const text = [...message].map((char, index) => {
+    const base = phase === "tool"
+      ? TOOL_GRADIENT[index % TOOL_GRADIENT.length]!
+      : palette.base;
+    return colorize(char, index >= start && index < start + 4 ? palette.highlight : appearanceColor(base, appearance));
+  }).join("");
+  const suffix = [formatElapsed(elapsedMs), outputTokens && outputTokens > 0 ? `${outputTokens} output tokens` : undefined]
+    .filter((value): value is string => Boolean(value))
+    .join(" · ");
+  const body = suffix ? `${indicator} ${text} ${suffix}` : `${indicator} ${text}`;
+  return fillWidth(body, Math.max(1, width));
+}
+
+function assistantUsage(message: unknown): number | undefined {
+  if (!isRecord(message) || !isRecord(message.usage)) return undefined;
+  const output = message.usage.output;
+  return typeof output === "number" && Number.isFinite(output) && output > 0 ? Math.floor(output) : undefined;
+}
+
+function isAssistantMessage(message: unknown): boolean {
+  return isRecord(message) && message.role === "assistant";
+}
+
+export default function roseMatrixExtension(pi: ExtensionAPI): void {
+  const loaded = loadRoseMatrixConfig();
+  const config = loaded.config;
   let activeContext: ExtensionContext | undefined;
-  let phase: Phase = "working";
+  let phase: Phase = "requesting";
   let active = false;
   let timer: Timer | undefined;
   let startedAt = 0;
@@ -187,49 +345,58 @@ export default function sakuraMatrixExtension(pi: ExtensionAPI): void {
   let requestRender: (() => void) | undefined;
   let cachedKey = "";
   let cachedLines: string[] = [];
+  let currentAppearance: ResolvedAppearance | undefined;
+  let pendingConfigWarning = loaded.warning;
+  let warningIssued = false;
+  let completedOutputTokens = 0;
+  let currentOutputTokens = 0;
+  let currentMessageFinalized = false;
+  const activeToolIds = new Set<string>();
   const dropsByWidth = new Map<number, Drop[]>();
 
-  const invalidate = () => {
-    cachedKey = "";
-    cachedLines = [];
-  };
+  const invalidate = () => { cachedKey = ""; cachedLines = []; };
+  const totalOutputTokens = () => completedOutputTokens + currentOutputTokens || undefined;
 
-  const component = {
-    render(width: number): string[] {
-      const safeWidth = Math.max(1, width);
-      const key = `${safeWidth}:${config.height}:${frame}:${phase}`;
-      if (key === cachedKey) return cachedLines;
-      let drops = dropsByWidth.get(safeWidth);
-      if (!drops) {
-        drops = createDrops(safeWidth, config.density, config.height);
-        if (dropsByWidth.size >= 4) {
-          dropsByWidth.delete(dropsByWidth.keys().next().value ?? safeWidth);
-        }
-        dropsByWidth.set(safeWidth, drops);
-      }
-      cachedLines = renderSakuraMatrix(
-        safeWidth,
-        config.height,
-        Math.max(0, performance.now() - startedAt) / 1000,
-        phase,
-        drops,
-      );
-      cachedKey = key;
-      return cachedLines;
-    },
-    invalidate(): void {
-      dropsByWidth.clear();
-      invalidate();
-    },
-  };
-
-  const clearTimer = () => {
+  const stop = () => {
+    generation += 1;
+    active = false;
     if (timer) clearTimeout(timer);
     timer = undefined;
+    const ctx = activeContext;
+    activeContext = undefined;
+    requestRender = undefined;
+    lastHostUpdateAt = 0;
+    activeToolIds.clear();
+    completedOutputTokens = 0;
+    currentOutputTokens = 0;
+    currentMessageFinalized = false;
+    dropsByWidth.clear();
+    invalidate();
+    if (!ctx) return;
+    try {
+      ctx.ui.setWidget(WIDGET_KEY, undefined);
+      ctx.ui.setWorkingMessage();
+      ctx.ui.setWorkingIndicator();
+      ctx.ui.setWorkingVisible(true);
+    } catch { /* disposal is idempotent */ }
   };
 
+  const resolveCurrentAppearance = (): ResolvedAppearance | undefined =>
+    resolveAppearance(config.appearance, activeContext?.ui.theme.name);
+
   const schedule = (token: number) => {
     if (!active || token !== generation) return;
+    const resolved = resolveCurrentAppearance();
+    if (!resolved) {
+      const ctx = activeContext;
+      stop();
+      if (!warningIssued) {
+        warningIssued = true;
+        ctx?.ui.notify("Rose Matrix needs a known theme; run /rose-matrix appearance dark|light.", "warning");
+      }
+      return;
+    }
+    if (resolved !== currentAppearance) { currentAppearance = resolved; invalidate(); }
     const frameMs = 1000 / config.fps;
     const now = performance.now();
     if (now - nextDeadline > frameMs * 3) nextDeadline = now;
@@ -238,52 +405,69 @@ export default function sakuraMatrixExtension(pi: ExtensionAPI): void {
       if (!active || token !== generation) return;
       frame += 1;
       invalidate();
-      // Streaming and tool updates already schedule a host render. Avoid adding
-      // a second full TUI pass when one occurred within this frame window.
+      // Agent/tool streaming already asks Pi to render. Avoid a redundant full
+      // TUI pass inside that same frame while still advancing one shared clock.
       if (performance.now() - lastHostUpdateAt >= frameMs) requestRender?.();
       schedule(token);
     }, Math.max(16, nextDeadline - performance.now()));
     timer.unref?.();
   };
 
-  const stop = () => {
-    generation += 1;
-    active = false;
-    clearTimer();
-    const ctx = activeContext;
-    activeContext = undefined;
-    requestRender = undefined;
-    lastHostUpdateAt = 0;
-    invalidate();
-    if (!ctx) return;
-    try {
-      ctx.ui.setWidget(WIDGET_KEY, undefined);
-      ctx.ui.setWorkingMessage();
-      ctx.ui.setWorkingIndicator();
-      ctx.ui.setWorkingVisible(true);
-    } catch {
-      // UI may already be disposed during shutdown; cleanup remains idempotent.
-    }
+  const component = {
+    render(width: number): string[] {
+      const safeWidth = Math.max(1, width);
+      const appearance = currentAppearance ?? "dark";
+      const key = `${safeWidth}:${frame}:${phase}:${appearance}:${totalOutputTokens() ?? 0}`;
+      if (key === cachedKey) return cachedLines;
+      let drops = dropsByWidth.get(safeWidth);
+      if (!drops) {
+        drops = createDrops(safeWidth, config.density, 4);
+        if (dropsByWidth.size >= 4) dropsByWidth.delete(dropsByWidth.keys().next().value ?? safeWidth);
+        dropsByWidth.set(safeWidth, drops);
+      }
+      const elapsedMs = Math.max(0, performance.now() - startedAt);
+      cachedLines = [
+        renderRoseShimmer(safeWidth, phase, elapsedMs, totalOutputTokens(), appearance),
+        ...renderRoseMatrix(safeWidth, 4, elapsedMs / 1000, phase, drops, appearance),
+      ];
+      cachedKey = key;
+      return cachedLines;
+    },
+    invalidate(): void { dropsByWidth.clear(); invalidate(); },
   };
 
-  const start = (ctx: ExtensionContext, initialPhase: Phase = "working") => {
+  const start = (ctx: ExtensionContext, initialPhase: Phase = "requesting") => {
     stop();
     if (!config.enabled || ctx.mode !== "tui") return;
     activeContext = ctx;
+    const resolved = resolveCurrentAppearance();
+    if (!resolved) {
+      activeContext = undefined;
+      if (!warningIssued) {
+        warningIssued = true;
+        ctx.ui.notify("Rose Matrix needs a known theme; run /rose-matrix appearance dark|light.", "warning");
+      }
+      return;
+    }
     active = true;
+    currentAppearance = resolved;
+    if (pendingConfigWarning) {
+      ctx.ui.notify(pendingConfigWarning, "warning");
+      pendingConfigWarning = undefined;
+    }
     phase = initialPhase;
     frame = 0;
     startedAt = performance.now();
     nextDeadline = startedAt;
     lastHostUpdateAt = 0;
+    activeToolIds.clear();
+    completedOutputTokens = 0;
+    currentOutputTokens = 0;
+    currentMessageFinalized = false;
     dropsByWidth.clear();
     invalidate();
     const token = generation;
-    ctx.ui.setWorkingVisible(true);
-    // The matrix owns the only animation clock; a static indicator prevents a
-    // second independent timer from forcing redundant full-screen renders.
-    ctx.ui.setWorkingIndicator({ frames: [workingIndicatorFrame()] });
-    ctx.ui.setWorkingMessage(PHASE_MESSAGES[phase]);
+    ctx.ui.setWorkingVisible(false);
     ctx.ui.setWidget(WIDGET_KEY, (tui) => {
       requestRender = () => tui.requestRender();
       return component;
@@ -291,16 +475,33 @@ export default function sakuraMatrixExtension(pi: ExtensionAPI): void {
     schedule(token);
   };
 
-  const noteHostUpdate = () => {
-    lastHostUpdateAt = performance.now();
-  };
+  const noteHostUpdate = () => { lastHostUpdateAt = performance.now(); };
 
   const setPhase = (next: Phase) => {
     noteHostUpdate();
-    if (!active || phase === next) return;
-    phase = next;
-    activeContext?.ui.setWorkingMessage(PHASE_MESSAGES[phase]);
-    frame += 1;
+    if (!active || (activeToolIds.size > 0 && next !== "tool")) return;
+    if (phase !== next) { phase = next; frame += 1; invalidate(); }
+  };
+
+  const updateUsage = (message: unknown) => {
+    const usage = assistantUsage(message);
+    if (usage !== undefined && usage >= currentOutputTokens) {
+      currentOutputTokens = usage;
+      invalidate();
+    }
+  };
+
+  const beginAssistant = () => {
+    currentOutputTokens = 0;
+    currentMessageFinalized = false;
+    invalidate();
+  };
+  const finalizeAssistant = (message: unknown) => {
+    if (currentMessageFinalized) return;
+    updateUsage(message);
+    completedOutputTokens += currentOutputTokens;
+    currentOutputTokens = 0;
+    currentMessageFinalized = true;
     invalidate();
   };
 
@@ -308,76 +509,72 @@ export default function sakuraMatrixExtension(pi: ExtensionAPI): void {
   pi.on("agent_end", () => stop());
   pi.on("session_before_switch", () => stop());
   pi.on("session_shutdown", () => stop());
-
+  pi.on("message_start", (event) => { if (isAssistantMessage(event.message)) beginAssistant(); });
+  pi.on("message_end", (event) => { if (isAssistantMessage(event.message)) finalizeAssistant(event.message); });
   pi.on("message_update", (event) => {
     noteHostUpdate();
-    const streamEvent = event.assistantMessageEvent as { type?: string } | undefined;
-    if (!streamEvent?.type) return;
-    if (streamEvent.type === "thinking_start" || streamEvent.type === "thinking_delta") {
-      setPhase("thinking");
-    } else if (streamEvent.type === "thinking_end" || streamEvent.type === "text_delta") {
-      setPhase("working");
-    }
+    const streamEvent = event.assistantMessageEvent;
+    updateUsage("partial" in streamEvent ? streamEvent.partial : "message" in streamEvent ? streamEvent.message : "error" in streamEvent ? streamEvent.error : undefined);
+    if (streamEvent.type === "thinking_start" || streamEvent.type === "thinking_delta") setPhase("thinking");
+    else if (streamEvent.type === "thinking_end") setPhase("requesting");
+    else if (streamEvent.type === "text_start" || streamEvent.type === "text_delta") setPhase("working");
+    else if (streamEvent.type === "done") finalizeAssistant(streamEvent.message);
+    else if (streamEvent.type === "error") finalizeAssistant(streamEvent.error);
   });
-
-  pi.on("tool_execution_start", () => setPhase("tool"));
-  pi.on("tool_execution_update", () => noteHostUpdate());
-  pi.on("tool_execution_end", () => setPhase("working"));
-
-  pi.registerCommand("sakura-matrix", {
-    description: "Sakura Matrix animation: status, on, off, preview, fps <8-18>, density <0.45-0.95>",
-    handler: async (args, ctx) => {
-      const [command = "status", value] = args.trim().toLowerCase().split(/\s+/);
-      if (command === "on") {
-        config.enabled = true;
-        saveConfig(config);
-        ctx.ui.notify("Sakura Matrix enabled", "info");
-        return;
-      }
-      if (command === "off") {
-        config.enabled = false;
-        saveConfig(config);
-        stop();
-        ctx.ui.notify("Sakura Matrix disabled", "info");
-        return;
-      }
-      if (command === "preview") {
-        start(ctx, "thinking");
-        const previewToken = generation;
-        const previewTimer = setTimeout(() => {
-          if (generation === previewToken) stop();
-        }, 5000);
-        previewTimer.unref?.();
-        ctx.ui.notify("Sakura Matrix preview: 5 seconds", "info");
-        return;
-      }
-      if (command === "fps") {
-        const fps = Number(value);
-        if (!Number.isFinite(fps) || fps < 8 || fps > 18) {
-          ctx.ui.notify("Usage: /sakura-matrix fps <8-18>", "error");
-          return;
-        }
-        config.fps = Math.round(fps);
-        saveConfig(config);
-        ctx.ui.notify(`Sakura Matrix FPS: ${config.fps}`, "info");
-        return;
-      }
-      if (command === "density") {
-        const density = Number(value);
-        if (!Number.isFinite(density) || density < 0.45 || density > 0.95) {
-          ctx.ui.notify("Usage: /sakura-matrix density <0.45-0.95>", "error");
-          return;
-        }
-        config.density = Math.round(density * 100) / 100;
-        dropsByWidth.clear();
-        saveConfig(config);
-        ctx.ui.notify(`Sakura Matrix density: ${config.density}`, "info");
-        return;
-      }
-      ctx.ui.notify(
-        `Sakura Matrix: ${config.enabled ? "on" : "off"} · ${config.fps} FPS · ${config.height} lines · density ${config.density}`,
-        "info",
-      );
-    },
+  pi.on("tool_execution_start", (event) => { activeToolIds.add(event.toolCallId); setPhase("tool"); });
+  pi.on("tool_execution_update", (event) => { noteHostUpdate(); if (activeToolIds.has(event.toolCallId)) setPhase("tool"); });
+  pi.on("tool_execution_end", (event) => {
+    if (!activeToolIds.delete(event.toolCallId)) return;
+    setPhase(activeToolIds.size > 0 ? "tool" : "requesting");
   });
+
+  const handleCommand = async (args: string, ctx: ExtensionContext, deprecated = false) => {
+    const [command = "status", value] = args.trim().toLowerCase().split(/\s+/);
+    if (deprecated) ctx.ui.notify("/sakura-matrix is deprecated; use /rose-matrix.", "warning");
+    if (command === "on" || command === "off") {
+      config.enabled = command === "on";
+      writeConfigAtomically(CONFIG_PATH, config);
+      if (!config.enabled) stop();
+      ctx.ui.notify(`Rose Matrix ${config.enabled ? "enabled" : "disabled"}`, "info");
+      return;
+    }
+    if (command === "preview") {
+      start(ctx, "thinking");
+      const token = generation;
+      const previewTimer = setTimeout(() => { if (generation === token) stop(); }, 5000);
+      previewTimer.unref?.();
+      ctx.ui.notify("Rose Matrix preview: 5 seconds", "info");
+      return;
+    }
+    if (command === "fps") {
+      const fps = Number(value);
+      if (!Number.isFinite(fps) || fps < 8 || fps > 18) { ctx.ui.notify("Usage: /rose-matrix fps <8-18>", "error"); return; }
+      config.fps = Math.round(fps);
+      writeConfigAtomically(CONFIG_PATH, config);
+      ctx.ui.notify(`Rose Matrix FPS: ${config.fps}`, "info");
+      return;
+    }
+    if (command === "density") {
+      const density = Number(value);
+      if (!Number.isFinite(density) || density < 0.45 || density > 0.95) { ctx.ui.notify("Usage: /rose-matrix density <0.45-0.95>", "error"); return; }
+      config.density = Math.round(density * 100) / 100;
+      dropsByWidth.clear();
+      writeConfigAtomically(CONFIG_PATH, config);
+      ctx.ui.notify(`Rose Matrix density: ${config.density}`, "info");
+      return;
+    }
+    if (command === "appearance") {
+      if (value !== "auto" && value !== "dark" && value !== "light") { ctx.ui.notify("Usage: /rose-matrix appearance <auto|dark|light>", "error"); return; }
+      config.appearance = value;
+      writeConfigAtomically(CONFIG_PATH, config);
+      currentAppearance = resolveAppearance(config.appearance, ctx.ui.theme.name);
+      invalidate();
+      ctx.ui.notify(`Rose Matrix appearance: ${value}`, "info");
+      return;
+    }
+    ctx.ui.notify(`Rose Matrix: ${config.enabled ? "on" : "off"} · ${config.fps} FPS · 4 lines · density ${config.density} · ${config.appearance}`, "info");
+  };
+
+  pi.registerCommand("rose-matrix", { description: "Rose Matrix: status, on, off, preview, fps <8-18>, density <0.45-0.95>, appearance <auto|dark|light>", handler: (args, ctx) => handleCommand(args, ctx) });
+  pi.registerCommand("sakura-matrix", { description: "Deprecated alias for /rose-matrix", handler: (args, ctx) => handleCommand(args, ctx, true) });
 }

package/extensions/zentui/config.ts

@@ -213,7 +213,8 @@ export const FOOTER_FORMAT_ALIASES: Record<string, string> = {
 	separator: "sep",
 };
 
-export const configPath = join(getAgentDir(), "rem-cyberdeck-zentui.json");
+export const configPath = join(getAgentDir(), "rose-cyberdeck-zentui.json");
+export const legacyConfigPath = join(getAgentDir(), "rem-cyberdeck-zentui.json");
 
 export const defaultConfig: PolishedTuiConfig = {
 	projectRefreshIntervalMs: 60_000,
@@ -252,7 +253,7 @@ export const defaultConfig: PolishedTuiConfig = {
 		os: "#F7EEF8",
 		editorAccent: "bold #88B8FF",
 		editorPrompt: "bold #88B8FF",
-		editorBorder: "sakura-macaron-gradient",
+		editorBorder: "rose-cyberdeck-gradient",
 		editorModel: "bold #88B8FF",
 		editorProvider: "#B8BEDD",
 		editorThinking: "#BCA7FF",
@@ -405,7 +406,8 @@ function stringValue(record: Record<string, unknown>, key: string): string | und
 
 function colorValue(record: Record<string, unknown>, key: string): string | undefined {
 	const value = stringValue(record, key);
-	if (key === "editorBorder" && value === "sakura-macaron-gradient") return value;
+	if (key === "editorBorder" && value === "rose-cyberdeck-gradient") return value;
+	if (key === "editorBorder" && value === "sakura-macaron-gradient") return "rose-cyberdeck-gradient";
 	return value !== undefined && isSupportedColorSpec(value) ? value : undefined;
 }
 
@@ -821,10 +823,10 @@ export function getExtensionStatusColorMode(
 	return config.extensionStatuses.colorModes[key] ?? DEFAULT_EXTENSION_STATUS_COLOR_MODE;
 }
 
-export function loadConfig(): PolishedTuiConfig {
+export function loadConfig(path = configPath, legacyPath = legacyConfigPath): PolishedTuiConfig {
 	try {
-		if (!existsSync(configPath)) return mergeConfig({});
-		return mergeConfig(JSON.parse(readFileSync(configPath, "utf8")));
+		const selected = existsSync(path) ? path : existsSync(legacyPath) ? legacyPath : undefined;
+		return selected ? mergeConfig(JSON.parse(readFileSync(selected, "utf8"))) : mergeConfig({});
 	} catch {
 		return mergeConfig({});
 	}

package/extensions/zentui/gradient.ts

@@ -2,13 +2,14 @@ import { truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
 
 export type RGB = readonly [number, number, number];
 
-export const SAKURA_MACARON_GRADIENT = "sakura-macaron-gradient";
-export const SAKURA_MACARON_STOPS: readonly RGB[] = [
-	[242, 167, 198], // sakura pink  #F2A7C6
-	[252, 201, 185], // sakura-iro   #FCC9B9
-	[239, 195, 230], // petal        #EFC3E6
-	[199, 184, 245], // lavender     #C7B8F5
-	[159, 211, 242], // sky macaron  #9FD3F2
+export const ROSE_GRADIENT = "rose-cyberdeck-gradient";
+export const ROSE_GRADIENT_STOPS: readonly RGB[] = [
+  [199, 91, 122], // brand Rose #C75B7A
+  [232, 167, 184], // soft Rose  #E8A7B8
+  [188, 167, 255], // violet     #BCA7FF
+  [136, 184, 255], // blue       #88B8FF
+  [125, 228, 255], // cyan       #7DE4FF
+  [214, 244, 255], // ice        #D6F4FF
 ];
 
 const RESET = "\x1b[0m";
@@ -16,55 +17,44 @@ const GRADIENT_CACHE_LIMIT = 128;
 const gradientCache = new Map<string, string>();
 
 function mix(from: RGB, to: RGB, amount: number): RGB {
-	const t = Math.max(0, Math.min(1, amount));
-	return [
-		Math.round(from[0] + (to[0] - from[0]) * t),
-		Math.round(from[1] + (to[1] - from[1]) * t),
-		Math.round(from[2] + (to[2] - from[2]) * t),
-	];
+  const t = Math.max(0, Math.min(1, amount));
+  return [
+    Math.round(from[0] + (to[0] - from[0]) * t),
+    Math.round(from[1] + (to[1] - from[1]) * t),
+    Math.round(from[2] + (to[2] - from[2]) * t),
+  ];
 }
 
 function sampleGradient(position: number): RGB {
-	const stops = SAKURA_MACARON_STOPS;
-	const normalized = Math.max(0, Math.min(1, position));
-	const scaled = normalized * (stops.length - 1);
-	const index = Math.min(stops.length - 2, Math.floor(scaled));
-	const from = stops[index] ?? SAKURA_MACARON_STOPS[0] ?? [242, 167, 198];
-	const to = stops[index + 1] ?? from;
-	return mix(from, to, scaled - index);
+  const normalized = Math.max(0, Math.min(1, position));
+  const scaled = normalized * (ROSE_GRADIENT_STOPS.length - 1);
+  const index = Math.min(ROSE_GRADIENT_STOPS.length - 2, Math.floor(scaled));
+  const from = ROSE_GRADIENT_STOPS[index] ?? ROSE_GRADIENT_STOPS[0]!;
+  const to = ROSE_GRADIENT_STOPS[index + 1] ?? from;
+  return mix(from, to, scaled - index);
 }
 
 function foreground(color: RGB, text: string): string {
-	return `\x1b[38;2;${color[0]};${color[1]};${color[2]}m${text}`;
+  return `\x1b[38;2;${color[0]};${color[1]};${color[2]}m${text}`;
 }
 
-/** Render the stable Sakura → sky gradient used by the editor and sent prompts. */
-export function renderSakuraGradient(text: string): string {
-	const cached = gradientCache.get(text);
-	if (cached !== undefined) return cached;
-	const chars = [...text];
-	if (chars.length === 0) return text;
-	const span = Math.max(1, chars.length - 1);
-	const rendered = `${chars.map((char, index) => foreground(sampleGradient(index / span), char)).join("")}${RESET}`;
-	if (gradientCache.size >= GRADIENT_CACHE_LIMIT) {
-		gradientCache.delete(gradientCache.keys().next().value ?? "");
-	}
-	gradientCache.set(text, rendered);
-	return rendered;
+/** Render the stable Rose-to-ice gradient for Zentui chrome and markers. */
+export function renderRoseGradient(text: string): string {
+  const cached = gradientCache.get(text);
+  if (cached !== undefined) return cached;
+  const chars = [...text];
+  if (chars.length === 0) return text;
+  const span = Math.max(1, chars.length - 1);
+  const rendered = `${chars.map((char, index) => foreground(sampleGradient(index / span), char)).join("")}${RESET}`;
+  if (gradientCache.size >= GRADIENT_CACHE_LIMIT) gradientCache.delete(gradientCache.keys().next().value ?? "");
+  gradientCache.set(text, rendered);
+  return rendered;
 }
 
 /** Add symmetric colored side rails while preserving the terminal width contract. */
-export function renderBoxedLine(
-	line: string,
-	width: number,
-	leftRail: string,
-	rightRail: string,
-): string {
-	if (width <= 0) return "";
-	const leftWidth = visibleWidth(leftRail);
-	const rightWidth = visibleWidth(rightRail);
-	const innerWidth = Math.max(0, width - leftWidth - rightWidth);
-	const content = truncateToWidth(line, innerWidth, "");
-	const padding = " ".repeat(Math.max(0, innerWidth - visibleWidth(content)));
-	return truncateToWidth(`${leftRail}${content}${padding}${rightRail}`, width, "");
+export function renderBoxedLine(line: string, width: number, leftRail: string, rightRail: string): string {
+  if (width <= 0) return "";
+  const innerWidth = Math.max(0, width - visibleWidth(leftRail) - visibleWidth(rightRail));
+  const content = truncateToWidth(line, innerWidth, "");
+  return truncateToWidth(`${leftRail}${content}${" ".repeat(Math.max(0, innerWidth - visibleWidth(content)))}${rightRail}`, width, "");
 }

package/extensions/zentui/thinking-message.ts

@@ -1,6 +1,6 @@
 import { AssistantMessageComponent, type Theme } from "@earendil-works/pi-coding-agent";
 import { type Component, truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
-import { renderSakuraGradient } from "./gradient.js";
+import { renderRoseGradient } from "./gradient.js";
 import { installPrototypePatch } from "./prototype-patch-registry.js";
 
 type Cleanup = () => void;
@@ -121,14 +121,14 @@ class ThinkingTrailComponent implements Component {
 		const theme = this.getTheme();
 		if (!theme) return rawLines;
 		const count = theme.fg("muted", ` · ${stepCount} ${stepCount === 1 ? "STEP" : "STEPS"}`);
-		const title = `${renderSakuraGradient("✦ REASONING")}${count}`;
+		const title = `${renderRoseGradient("✦ REASONING")}${count}`;
 		let currentStep = 0;
 		const body = rows.map(({ line, step }) => {
 			if (step) currentStep += 1;
 			const isLastStep = currentStep === stepCount;
 			const branchText = step ? (isLastStep ? "╰─ " : "├─ ") : isLastStep ? "   " : "│  ";
 			const branch = theme.fg("thinkingXhigh", branchText);
-			const marker = step ? renderSakuraGradient("◇ ") : "  ";
+			const marker = step ? renderRoseGradient("◇ ") : "  ";
 			return truncateToWidth(`${branch}${marker}${line}`, width, "");
 		});
 

package/extensions/zentui/tool-execution.ts

@@ -1,6 +1,6 @@
 import { type Theme, ToolExecutionComponent } from "@earendil-works/pi-coding-agent";
 import { visibleWidth } from "@earendil-works/pi-tui";
-import { renderBoxedLine, renderSakuraGradient } from "./gradient.js";
+import { renderBoxedLine, renderRoseGradient } from "./gradient.js";
 import { installPrototypePatch } from "./prototype-patch-registry.js";
 
 const SETTLED_CACHE_MAX_LINES = 80;
@@ -141,17 +141,17 @@ export function installToolExecutionStyle(getTheme: () => Theme | undefined): Cl
 				if (blank !== undefined) prefix.push(blank);
 			}
 			const label = fitBorderLabel(statusLabel(runtime), width);
-			const top = renderSakuraGradient(label);
+			const top = renderRoseGradient(label);
 			// Keep only the status rail slightly heavier. State is expressed in the
-			// native macaron palette rather than traffic-light red/green: lavender
-			// while running, sky blue when complete, and Sakura pink when failed.
+			// Rose palette rather than traffic-light red/green: violet while running,
+			// ice blue when complete, and Rose when failed.
 			const leftRail = pending
 				? theme.fg("thinkingXhigh", "┃ ")
 				: runtime.result?.isError
 					? theme.fg("accent", "┃ ")
 					: theme.fg("syntaxFunction", "┃ ");
-			const rightRail = renderSakuraGradient(" │");
-			const bottom = renderSakuraGradient(bottomBorder(width));
+			const rightRail = renderRoseGradient(" │");
+			const bottom = renderRoseGradient(bottomBorder(width));
 
 			const boxed = [
 				...prefix,

package/extensions/zentui/ui.ts

@@ -10,7 +10,7 @@ import {
 } from "@earendil-works/pi-tui";
 import type { PolishedTuiConfig } from "./config.js";
 import { formatTimeLabel } from "./format.js";
-import { renderSakuraGradient, SAKURA_MACARON_GRADIENT } from "./gradient.js";
+import { renderRoseGradient, ROSE_GRADIENT } from "./gradient.js";
 import {
 	EDITOR_ACCENT_FALLBACK,
 	EDITOR_BORDER_FALLBACK,
@@ -83,8 +83,8 @@ export function renderEditorFrameBorder(
 	uiTheme: Theme,
 	colorSource: PolishedTuiConfig["colorSources"]["editor"],
 ): string {
-	if (config.colors.editorBorder === SAKURA_MACARON_GRADIENT) {
-		return renderSakuraGradient(text);
+	if (config.colors.editorBorder === ROSE_GRADIENT) {
+		return renderRoseGradient(text);
 	}
 	return renderStyleForSourceOrFallback(
 		uiTheme,

package/manifests/provenance.json

@@ -113,7 +113,7 @@
       "status": "adapted",
       "sourceFiles": ["extensions/header/index.ts", "extensions/matrix/index.ts", "extensions/zentui/**"],
       "symbols": ["header", "matrix animation", "Zentui footer", "fixed editor compositor"],
-      "localChanges": ["registered as three additional Pi Package Extensions", "header avatar loads the supplied Rem asset", "Zentui shell palette uses Rem while Matrix and the reasoning trail retain the upstream Sakura palette", "overflowing Matrix tracks are sampled deterministically across the complete terminal width while retaining the 96-track budget and ordinary-width behavior", "relative import specifiers and session lifecycle event are adapted for this package's NodeNext TypeScript contract"],
+      "localChanges": ["registered as three additional Pi Package Extensions", "Rose header loads a package-owned renamed artwork asset without changing upstream identity", "Rose Shimmer, Rose Code Rain, and Zentui use the Rose-owned palette and gradient", "overflowing Matrix tracks remain deterministic across the complete terminal width with the 96-track budget, while each rain row receives a structural blank-row repair", "relative import specifiers and session lifecycle event are adapted for this package's NodeNext TypeScript contract"],
       "verification": ["tests/unit/matrix.test.ts", "tests/unit/zentui-gradient.test.ts", "npm run typecheck", "npm test", "npm pack --dry-run --json"]
     }
   ]

package/manifests/sbom.json

@@ -3,7 +3,7 @@
   "dataLicense": "CC0-1.0",
   "SPDXID": "SPDXRef-DOCUMENT",
   "name": "@rosetears/aili-pi-0.0.0-development",
-  "documentNamespace": "https://github.com/Rosetears520/aili-pi/sbom/a9e5a3e4d1076b3179dd8cca5ef89f9f",
+  "documentNamespace": "https://github.com/Rosetears520/aili-pi/sbom/4a5b950286a6867acf10e709f49f1448",
   "creationInfo": {
     "creators": [
       "Tool: @rosetears/aili-pi scripts/generate-provenance.ts"
@@ -126,7 +126,7 @@
       "licenseDeclared": "MIT",
       "checksums": [],
       "primaryPackagePurpose": "SOURCE",
-      "comment": "revision=165a1f8011a12a58a6409b56b8a6c0416cd9b589; files=extensions/header/index.ts, extensions/matrix/index.ts, extensions/zentui/**; symbols=header, matrix animation, Zentui footer, fixed editor compositor; local changes=registered as three additional Pi Package Extensions | header avatar loads the supplied Rem asset | Zentui shell palette uses Rem while Matrix and the reasoning trail retain the upstream Sakura palette | overflowing Matrix tracks are sampled deterministically across the complete terminal width while retaining the 96-track budget and ordinary-width behavior | relative import specifiers and session lifecycle event are adapted for this package's NodeNext TypeScript contract"
+      "comment": "revision=165a1f8011a12a58a6409b56b8a6c0416cd9b589; files=extensions/header/index.ts, extensions/matrix/index.ts, extensions/zentui/**; symbols=header, matrix animation, Zentui footer, fixed editor compositor; local changes=registered as three additional Pi Package Extensions | Rose header loads a package-owned renamed artwork asset without changing upstream identity | Rose Shimmer, Rose Code Rain, and Zentui use the Rose-owned palette and gradient | overflowing Matrix tracks remain deterministic across the complete terminal width with the 96-track budget, while each rain row receives a structural blank-row repair | relative import specifiers and session lifecycle event are adapted for this package's NodeNext TypeScript contract"
     },
     {
       "SPDXID": "SPDXRef-node-modules-agent-base-e28bede7a2",

package/notices/pi-sakura-cyberdeck-NOTICE.txt

@@ -2,6 +2,6 @@ This package includes a modified copy of pi-zentui by Luka.
 Original project: https://github.com/lmilojevicc/pi-zentui
 License: MIT. Full license text: licenses/pi-zentui-MIT.txt
 
-Modifications include the Rem shell palette, retained Sakura Matrix/reasoning
-palette, responsive bounded Matrix track selection, package-specific defaults,
-and package-specific configuration path.
+Modifications include Rose Cyberdeck branding, Rose Shimmer and Rose Code Rain,
+Rose Zentui gradients, responsive bounded Matrix track selection, package-specific
+defaults, and package-specific configuration paths.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rosetears/aili-pi",
-  "version": "0.1.7",
+  "version": "0.1.8",
   "description": "AILI and ROSE distribution for official Pi",
   "type": "module",
   "license": "MIT",
@@ -50,7 +50,7 @@
       "./prompts/local-review.md"
     ],
     "themes": [
-      "./themes/rem-cyberdeck.json"
+      "./themes/rose-cyberdeck.json"
     ]
   },
   "engines": {

package/src/runtime/rose-theme.ts

@@ -0,0 +1,26 @@
+import { existsSync, readFileSync } from "node:fs";
+
+const LEGACY_THEME = "rem-cyberdeck";
+const ROSE_THEME = "rose-cyberdeck";
+
+/** Return non-mutating exact-token guidance for a legacy Pi theme setting. */
+export function legacyRoseThemeGuidance(theme: unknown): string | undefined {
+  if (typeof theme !== "string") return undefined;
+  const parts = theme.split("/");
+  if (!parts.some((part) => part === LEGACY_THEME)) return undefined;
+  const replacement = parts.map((part) => part === LEGACY_THEME ? ROSE_THEME : part).join("/");
+  return `Rose Cyberdeck renamed ${LEGACY_THEME} to ${ROSE_THEME}. Use /settings or edit settings.json: \"theme\": \"${replacement}\".`;
+}
+
+/** Read-only startup compatibility detector; malformed settings are intentionally silent. */
+export function legacyRoseThemeGuidanceFromSettings(path: string): string | undefined {
+  try {
+    if (!existsSync(path)) return undefined;
+    const parsed: unknown = JSON.parse(readFileSync(path, "utf8"));
+    return parsed !== null && typeof parsed === "object" && "theme" in parsed
+      ? legacyRoseThemeGuidance((parsed as { theme?: unknown }).theme)
+      : undefined;
+  } catch {
+    return undefined;
+  }
+}

package/themes/rose-cyberdeck.json

@@ -0,0 +1,35 @@
+{
+  "$schema": "https://raw.githubusercontent.com/earendil-works/pi/main/packages/coding-agent/src/modes/interactive/theme/theme-schema.json",
+  "name": "rose-cyberdeck",
+  "vars": {
+    "void": "#10121D",
+    "panel": "#191D2E",
+    "raised": "#242A42",
+    "text": "#E8EEFF",
+    "muted": "#9DA9C8",
+    "dim": "#64708F",
+    "blue": "#88B8FF",
+    "cyan": "#7DE4FF",
+    "violet": "#BCA7FF",
+    "ice": "#D6F4FF",
+    "rose": "#C75B7A",
+    "roseSoft": "#E8A7B8",
+    "roseDeep": "#A8455F",
+    "successGreen": "#5A8A72",
+    "gold": "#F3CE83",
+    "coral": "#FF93B1",
+    "border": "#4C5B86",
+    "borderMuted": "#303A5B"
+  },
+  "colors": {
+    "accent": "rose", "border": "border", "borderAccent": "cyan", "borderMuted": "borderMuted",
+    "success": "successGreen", "error": "coral", "warning": "gold", "muted": "muted", "dim": "dim", "text": "text", "thinkingText": "ice",
+    "selectedBg": "raised", "userMessageBg": "", "userMessageText": "text", "customMessageBg": "", "customMessageText": "text", "customMessageLabel": "violet",
+    "toolPendingBg": "", "toolSuccessBg": "", "toolErrorBg": "", "toolTitle": "cyan", "toolOutput": "ice",
+    "mdHeading": "rose", "mdLink": "cyan", "mdLinkUrl": "muted", "mdCode": "gold", "mdCodeBlock": "text", "mdCodeBlockBorder": "borderMuted", "mdQuote": "ice", "mdQuoteBorder": "violet", "mdHr": "borderMuted", "mdListBullet": "rose",
+    "toolDiffAdded": "successGreen", "toolDiffRemoved": "coral", "toolDiffContext": "muted",
+    "syntaxComment": "muted", "syntaxKeyword": "violet", "syntaxFunction": "cyan", "syntaxVariable": "blue", "syntaxString": "successGreen", "syntaxNumber": "gold", "syntaxType": "ice", "syntaxOperator": "violet", "syntaxPunctuation": "text",
+    "thinkingOff": "dim", "thinkingMinimal": "muted", "thinkingLow": "cyan", "thinkingMedium": "violet", "thinkingHigh": "blue", "thinkingXhigh": "rose", "thinkingMax": "roseDeep", "bashMode": "successGreen"
+  },
+  "export": { "pageBg": "#10121D", "cardBg": "#191D2E", "infoBg": "#242A42" }
+}

package/themes/rem-cyberdeck.json

@@ -1,32 +0,0 @@
-{
-  "$schema": "https://raw.githubusercontent.com/earendil-works/pi/main/packages/coding-agent/src/modes/interactive/theme/theme-schema.json",
-  "name": "rem-cyberdeck",
-  "vars": {
-    "void": "#10121D",
-    "panel": "#191D2E",
-    "raised": "#242A42",
-    "text": "#E8EEFF",
-    "muted": "#9DA9C8",
-    "dim": "#64708F",
-    "rem": "#88B8FF",
-    "cyan": "#7DE4FF",
-    "violet": "#BCA7FF",
-    "ice": "#D6F4FF",
-    "mint": "#8CE6C2",
-    "gold": "#F3CE83",
-    "coral": "#FF93B1",
-    "border": "#4C5B86",
-    "borderMuted": "#303A5B"
-  },
-  "colors": {
-    "accent": "rem", "border": "border", "borderAccent": "cyan", "borderMuted": "borderMuted",
-    "success": "mint", "error": "coral", "warning": "gold", "muted": "muted", "dim": "dim", "text": "text", "thinkingText": "ice",
-    "selectedBg": "raised", "userMessageBg": "", "userMessageText": "text", "customMessageBg": "", "customMessageText": "text", "customMessageLabel": "violet",
-    "toolPendingBg": "", "toolSuccessBg": "", "toolErrorBg": "", "toolTitle": "cyan", "toolOutput": "ice",
-    "mdHeading": "rem", "mdLink": "cyan", "mdLinkUrl": "muted", "mdCode": "gold", "mdCodeBlock": "text", "mdCodeBlockBorder": "borderMuted", "mdQuote": "ice", "mdQuoteBorder": "violet", "mdHr": "borderMuted", "mdListBullet": "rem",
-    "toolDiffAdded": "mint", "toolDiffRemoved": "coral", "toolDiffContext": "muted",
-    "syntaxComment": "muted", "syntaxKeyword": "violet", "syntaxFunction": "cyan", "syntaxVariable": "rem", "syntaxString": "mint", "syntaxNumber": "gold", "syntaxType": "ice", "syntaxOperator": "violet", "syntaxPunctuation": "text",
-    "thinkingOff": "dim", "thinkingMinimal": "muted", "thinkingLow": "cyan", "thinkingMedium": "violet", "thinkingHigh": "rem", "thinkingXhigh": "coral", "thinkingMax": "coral", "bashMode": "mint"
-  },
-  "export": { "pageBg": "#10121D", "cardBg": "#191D2E", "infoBg": "#242A42" }
-}