@groeponline/pi-wishcraft 1.1.0 → 1.3.0

package/src/config/types.ts

@@ -1,4 +1,5 @@
 import type { Theme, ThemeColor } from "@earendil-works/pi-coding-agent";
+import type { MotionEvent } from "../motion/types.ts";
 import type { CostCurrencyCode } from "../usage/rates.ts";
 
 // Theme color - either a pi theme color name or a custom hex color
@@ -28,6 +29,176 @@ export type SemanticColor =
 // Color scheme mapping semantic names to actual colors
 export type ColorScheme = Partial<Record<SemanticColor, ColorValue>>;
 
+/**
+ * Semantic design tokens (vNext). Presets fill abstract roles; the segment
+ * colors above are derived from them. See src/config/tokens.ts for the mapping
+ * and the default palette.
+ */
+export interface WishcraftTokens {
+  /** Deck background. */
+  surface: ColorValue;
+  /** Raised areas: headers, footers, selected rows. */
+  surfaceRaised: ColorValue;
+  text: ColorValue;
+  textMuted: ColorValue;
+  primary: ColorValue;
+  secondary: ColorValue;
+  accent: ColorValue;
+  success: ColorValue;
+  warning: ColorValue;
+  error: ColorValue;
+  /** Focused control or active route. */
+  focus: ColorValue;
+  /** Selected row background. */
+  selection: ColorValue;
+  /** Resting motion, e.g. a still rail. */
+  motionDim: ColorValue;
+  /** The travelling head of a sweep. */
+  motionHot: ColorValue;
+  /** Cells just behind the head. */
+  motionTrail: ColorValue;
+}
+
+export type TokenRole = keyof WishcraftTokens;
+
+/** Motion catalog id, e.g. `ember-relay`. */
+export type MotionRef = string;
+
+export type StructuralPresetName =
+  | "lanternwake"
+  | "threadbound"
+  | "scryglass"
+  | "runebloom"
+  | "moonwell"
+  | "hexforge"
+  | "vellum"
+  | "wisp"
+  | "starweave"
+  | "crucible";
+
+export const STRUCTURAL_PRESET_NAMES = [
+  "lanternwake",
+  "threadbound",
+  "scryglass",
+  "runebloom",
+  "moonwell",
+  "hexforge",
+  "vellum",
+  "wisp",
+  "starweave",
+  "crucible",
+] as const satisfies readonly StructuralPresetName[];
+
+export type ChromeFrame = "rounded" | "square" | "double" | "minimal" | "borderless";
+export type ChromeDensity = "compact" | "medium" | "spacious";
+
+export interface ChromeSpec {
+  frame: ChromeFrame;
+  corners: { tl: string; tr: string; bl: string; br: string };
+  dividers: { horizontal: string; vertical: string; cross: string };
+  density: ChromeDensity;
+}
+
+export type SignalLayout =
+  | "standard"
+  | "capsule"
+  | "woven"
+  | "sparse"
+  | "block"
+  | "arc"
+  | "editorial"
+  | "fluid"
+  | "constellation"
+  | "cell";
+
+export interface SignalSpec {
+  layout: SignalLayout;
+  separators: {
+    left: string;
+    right: string;
+    subLeft?: string;
+    subRight?: string;
+  };
+  caps: {
+    leftOpen?: string;
+    leftClose?: string;
+    rightOpen?: string;
+    rightClose?: string;
+  };
+  /** Signature lane animation from the motion catalog. */
+  animation: MotionRef;
+}
+
+export type DeckNavigation = "tabs" | "rail" | "minimal";
+export type DeckPanelStyle = "framed" | "borderless" | "inset";
+export type DeckActivityStyle = "pulse" | "bar" | "none";
+
+export interface DeckSpec {
+  navigation: DeckNavigation;
+  panelStyle: DeckPanelStyle;
+  activityStyle: DeckActivityStyle;
+}
+
+export interface WelcomeSpec {
+  lantern: boolean;
+  ambient: boolean;
+  motionId?: MotionRef;
+}
+
+export type GlyphMode = "nerd" | "ascii" | "auto";
+
+export interface GlyphSet {
+  mode: GlyphMode;
+  /** Leading ornament for the model segment (Nerd). */
+  model?: string;
+  /** ASCII fallback for the model ornament. */
+  modelAscii?: string;
+  /** Default segment marker (Nerd). */
+  segment?: string;
+  /** ASCII fallback for segment markers. */
+  segmentAscii?: string;
+}
+
+/** vNext structural personality: tokens, chrome, signal grammar, motion, deck, welcome, glyphs. */
+export interface StructuralPresetDef {
+  name: StructuralPresetName;
+  displayName: string;
+  description: string;
+  tokens: Partial<WishcraftTokens>;
+  chrome: ChromeSpec;
+  signal: SignalSpec;
+  motion: Partial<Record<MotionEvent, MotionRef>>;
+  deck: DeckSpec;
+  welcome: WelcomeSpec;
+  glyphs: GlyphSet;
+}
+
+/**
+ * Decoupled appearance layers. Each field can point at a different structural
+ * preset so palette, signal layout, chrome, and motion stay independent.
+ */
+export interface AppearanceMixConfig {
+  base?: StructuralPresetName;
+  palette?: StructuralPresetName;
+  signalLayout?: StructuralPresetName;
+  chrome?: StructuralPresetName;
+  glyphs?: StructuralPresetName;
+  deck?: StructuralPresetName;
+  welcome?: StructuralPresetName;
+  motion?: StructuralPresetName | Partial<Record<MotionEvent, MotionRef>>;
+}
+
+export interface ResolvedAppearance {
+  base: StructuralPresetName;
+  tokens: WishcraftTokens;
+  chrome: ChromeSpec;
+  signal: SignalSpec;
+  motion: Partial<Record<MotionEvent, MotionRef>>;
+  deck: DeckSpec;
+  welcome: WelcomeSpec;
+  glyphs: GlyphSet;
+}
+
 // Built-in segment identifiers
 export const BUILTIN_STATUS_LINE_SEGMENT_IDS = [
   "model",
@@ -78,7 +249,24 @@ export type StatusLineSeparatorStyle =
 export type PowerlinePlacement = "above" | "below";
 
 export type StatusLinePreset =
-  "default" | "minimal" | "compact" | "full" | "nerd" | "ascii" | "chef";
+  | "default"
+  | "minimal"
+  | "compact"
+  | "full"
+  | "nerd"
+  | "ascii"
+  | "chef"
+  // vNext Structural Signature Presets
+  | "lanternwake"
+  | "threadbound"
+  | "scryglass"
+  | "runebloom"
+  | "moonwell"
+  | "hexforge"
+  | "vellum"
+  | "wisp"
+  | "starweave"
+  | "crucible";
 
 // Optional `{value}` template override shared by all segment option groups.
 // Replaces `{value}` in the rendered value text (e.g. "{value} tok/s").
@@ -153,7 +341,7 @@ export interface CustomStatusItem {
   excludeFromExtensionStatuses: boolean;
 }
 
-// Preset definition
+
 export interface PresetDef {
   leftSegments: StatusLineSegmentId[];
   rightSegments: StatusLineSegmentId[];
@@ -163,6 +351,24 @@ export interface PresetDef {
   segmentOptions?: StatusLineSegmentOptions;
   /** Color scheme for this preset */
   colors?: ColorScheme;
+  /**
+   * Semantic design tokens (vNext). When present, `colors` is derived from these
+   * and any explicit `colors` entry still wins. Optional, so the presets that
+   * predate tokens keep rendering exactly as before.
+   */
+  tokens?: Partial<WishcraftTokens>;
+  /** Deck and overlay frame geometry (vNext). */
+  chrome?: ChromeSpec;
+  /** Signal lane grammar and separators (vNext). */
+  signal?: SignalSpec;
+  /** Per-event motion overrides (vNext). */
+  motion?: Partial<Record<MotionEvent, MotionRef>>;
+  /** Deck navigation and panel chrome (vNext). */
+  deck?: DeckSpec;
+  /** Welcome screen lantern and ambient motion (vNext). */
+  welcome?: WelcomeSpec;
+  /** Nerd / ASCII glyph grammar (vNext). */
+  glyphs?: GlyphSet;
 }
 
 // Separator definition
@@ -311,4 +517,6 @@ export interface CustomPresetConfig {
   separator?: StatusLineSeparatorStyle;
   colors?: ColorScheme;
   segmentOptions?: StatusLineSegmentOptions;
+  /** Semantic design tokens; `colors` entries still win over derived values. */
+  tokens?: Partial<WishcraftTokens>;
 }

package/src/extension/commands/commands.ts

@@ -18,7 +18,9 @@ import {
 } from "../settings/settings-io.ts";
 import { showOpenPortsList, showSelectOverlay } from "../ui/menu-views.ts";
 import { showTpsOverlay, showUsageOverlay } from "../ui/token-overlays.ts";
-import { showPowerlineMainMenu } from "../ui/powerline-menu-view.ts";
+import { openWishcraftDeck } from "../ui/deck/index.ts";
+import { showPowerlineClassicMenu } from "../ui/powerline-menu-view.ts";
+import { syncAppearanceForLayoutPreset } from "../settings/appearance-write.ts";
 import { openStashHistory } from "../shortcuts/shortcuts-router.ts";
 import { ensureShellSession, setBashModeActive } from "./bash-mode-actions.ts";
 import { setupCustomEditor } from "../ui/custom-editor.ts";
@@ -31,6 +33,7 @@ import { publishPowerlineStatuses } from "../core/status-export.ts";
 import { config, normalizePreset } from "../core/state.ts";
 import type { RuntimeState } from "../core/types.ts";
 import { getPowerlineArgumentCompletions } from "./powerline-completions.ts";
+import { settleSignal } from "../../signal/integration.ts";
 
 export function registerCommands(pi: ExtensionAPI, rt: RuntimeState): void {
   registerCdCommand(pi, () => rt.currentCtx?.cwd ?? process.cwd());
@@ -39,9 +42,9 @@ export function registerCommands(pi: ExtensionAPI, rt: RuntimeState): void {
   registerSkillManagerCommand(pi, rt);
   registerWishcraftConfigCommand(pi, rt);
 
-  // Command to toggle/configure
-  pi.registerCommand("powerline", {
-    description: "Configure powerline status (toggle, preset, placement)",
+  // `/signal` is the vNext command; `/powerline` remains a transparent alias.
+  const signalCommand: Parameters<ExtensionAPI["registerCommand"]>[1] = {
+    description: "Configure Signal status (toggle, preset, placement)",
     getArgumentCompletions(argumentPrefix) {
       return getPowerlineArgumentCompletions(argumentPrefix);
     },
@@ -54,8 +57,9 @@ export function registerCommands(pi: ExtensionAPI, rt: RuntimeState): void {
         rt.enabled = !rt.enabled;
         if (rt.enabled) {
           setupCustomEditor(pi, rt, ctx);
-          ctx.ui.notify("Powerline enabled", "info");
+          ctx.ui.notify("Signal enabled", "info");
         } else {
+          settleSignal(rt);
           rt.shellSession?.dispose();
           rt.shellSession = null;
           rt.bashTranscript.clear();
@@ -87,12 +91,20 @@ export function registerCommands(pi: ExtensionAPI, rt: RuntimeState): void {
           rt.currentEditor = null;
           rt.statusRenderScheduler.cancel();
           resetLayoutCache(rt);
-          ctx.ui.notify("Powerline disabled", "info");
+          ctx.ui.notify("Signal disabled", "info");
         }
         return;
       }
 
       const normalizedArgs = args.trim().toLowerCase();
+      if (normalizedArgs === "menu") {
+        await showPowerlineClassicMenu(rt, ctx);
+        return;
+      }
+      if (normalizedArgs === "deck") {
+        await openWishcraftDeck(rt, ctx, "signal");
+        return;
+      }
       if (normalizedArgs === "doctor") {
         await runPowerlineDoctor(rt, ctx);
         return;
@@ -123,12 +135,12 @@ export function registerCommands(pi: ExtensionAPI, rt: RuntimeState): void {
           )
         ) {
           ctx.ui.notify(
-            `Powerline placement set to: ${config.placement}`,
+            `Signal placement set to: ${config.placement}`,
             "info",
           );
         } else {
           ctx.ui.notify(
-            `Powerline placement set to: ${config.placement} (not persisted; check settings.json)`,
+            `Signal placement set to: ${config.placement} (not persisted; check settings.json)`,
             "warning",
           );
         }
@@ -144,7 +156,9 @@ export function registerCommands(pi: ExtensionAPI, rt: RuntimeState): void {
           setupCustomEditor(pi, rt, ctx);
         }
 
-        if (writePowerlinePresetSetting(preset, ctx.cwd)) {
+        const persisted = writePowerlinePresetSetting(preset, ctx.cwd);
+        syncAppearanceForLayoutPreset(rt, ctx.cwd, preset);
+        if (persisted) {
           ctx.ui.notify(`Preset set to: ${preset}`, "info");
         } else {
           ctx.ui.notify(
@@ -159,6 +173,11 @@ export function registerCommands(pi: ExtensionAPI, rt: RuntimeState): void {
       const presetList = Object.keys(PRESETS).join(", ");
       ctx.ui.notify(`Available presets: ${presetList}`, "info");
     },
+  };
+  pi.registerCommand("signal", signalCommand);
+  pi.registerCommand("powerline", {
+    ...signalCommand,
+    description: "Compatibility alias for /signal",
   });
 
   pi.registerCommand("stash-history", {
@@ -250,8 +269,12 @@ export function registerCommands(pi: ExtensionAPI, rt: RuntimeState): void {
 
   pi.registerCommand("usage", {
     description: "Show session / today / week token usage overlay",
-    handler: async (_args, ctx) => {
+    handler: async (args, ctx) => {
       rt.currentCtx = ctx;
+      if (args?.trim().toLowerCase() === "deck") {
+        await openWishcraftDeck(rt, ctx, "usage");
+        return;
+      }
       await showUsageOverlay(rt, ctx);
     },
   });
@@ -295,9 +318,10 @@ export function registerCommands(pi: ExtensionAPI, rt: RuntimeState): void {
   // Configurable powerline shortcuts (re-bound on /reload via settings.powerlineShortcuts).
   if (rt.resolvedShortcuts.menu) {
     pi.registerShortcut(rt.resolvedShortcuts.menu as KeyId, {
-      description: "Powerline menu (navigate / configure / info)",
+      description: "Wishcraft Deck (operator control surface)",
       handler: async (ctx) => {
-        await showPowerlineMainMenu(rt, ctx);
+        rt.currentCtx = ctx;
+        await openWishcraftDeck(rt, ctx, "home");
       },
     });
   }

package/src/extension/commands/powerline-completions.ts

@@ -19,6 +19,10 @@ export const POWERLINE_SUBCOMMANDS: ReadonlyArray<{
     value: "placement",
     description: "Move the primary row above or below the editor",
   },
+  {
+    value: "menu",
+    description: "Open Navigate / Configure / Status",
+  },
 ];
 
 const PLACEMENT_DESCRIPTIONS: Record<(typeof POWERLINE_PLACEMENT_VALUES)[number], string> = {

package/src/extension/commands/queue-commands.ts

@@ -15,6 +15,7 @@ import { getCurrentEditorText } from "../shortcuts/shortcuts-router.ts";
 import { getQueueContext } from "../queue/queue-context.ts";
 import { config } from "../core/state.ts";
 import type { RuntimeState } from "../core/types.ts";
+import { openWishcraftDeck } from "../ui/deck/index.ts";
 
 export function registerQueueCommands(
   pi: ExtensionAPI,
@@ -70,6 +71,11 @@ export function registerQueueCommands(
         return;
       }
 
+      if (action === "deck") {
+        await openWishcraftDeck(rt, ctx, "ideas");
+        return;
+      }
+
       if (action === "next") {
         const item = findNextIdea(rt, ctx);
         if (!item) {

package/src/extension/core/segment-context.ts

@@ -5,6 +5,7 @@ import type {
 
 import type { SegmentContext, ColorScheme } from "../../config/types.ts";
 import { getPreset } from "../../config/presets.ts";
+import { liveColorScheme } from "../../config/appearance.ts";
 import {
   collectHiddenExtensionStatusKeys,
   deriveAutoCustomItems,
@@ -14,14 +15,8 @@ import { getDefaultColors } from "../../theme/theme.ts";
 import { getGitStatus } from "../../git/status.ts";
 import { getQueueContext } from "../queue/queue-context.ts";
 import { getUsageTokenTotal } from "../../usage/ledger.ts";
-import {
-  dayKey,
-  loadUsageFileFromDisk,
-  tokenTotal,
-  totalsForRange,
-} from "../../usage/usage-store.ts";
-import { parseTokenBudget } from "../../usage/token-budget.ts";
-import { readSettings } from "../settings/settings-io.ts";
+import { tokenBudgetSnapshotForDay } from "../../usage/token-budget.ts";
+import { dayKey } from "../../usage/usage-store.ts";
 import {
   CUSTOM_COMPACTION_STATUS_KEY,
   EDITOR_STATUS_DEFER_MS,
@@ -119,13 +114,24 @@ export function installFooterStatusRepaintHook(
   };
 }
 
+export interface BuildSegmentContextOptions {
+  /** Omit token-budget data from lightweight UI snapshots. */
+  includeTokenBudget?: boolean;
+}
+
 export function buildSegmentContext(
   rt: RuntimeState,
   ctx: any,
   theme: Theme,
+  options: BuildSegmentContextOptions = {},
 ): SegmentContext {
   const presetDef = getPreset(config.preset);
-  const colors: ColorScheme = presetDef.colors ?? getDefaultColors();
+  const colors: ColorScheme = liveColorScheme(
+    presetDef,
+    config.appearance,
+    config.preset,
+    getDefaultColors,
+  );
 
   // Build usage stats and get thinking level from session (cached; the full
   // event list is only re-scanned when events are appended or the trailing
@@ -199,6 +205,10 @@ export function buildSegmentContext(
     getQueueContext(ctx),
     rt.powerlineCompacting,
   );
+  const budgetSnapshot = tokenBudgetSnapshotForDay(
+    rt.tokenBudgetSnapshot,
+    dayKey(Date.now()),
+  );
 
   return {
     model: ctx.model,
@@ -228,18 +238,14 @@ export function buildSegmentContext(
     effectiveCustomItems,
     options: segmentOptions,
     segmentLabels: new Map(Object.entries(config.segmentLabels)),
-    tokenBudget: (() => {
-      const dailyLimit = parseTokenBudget(
-        readSettings(ctx.cwd ?? process.cwd()).wishcraft,
-      ).daily;
-      const now = Date.now();
-      const todayStart = Date.parse(`${dayKey(now)}T00:00:00`);
-      const dailyUsed = tokenTotal(
-        totalsForRange(loadUsageFileFromDisk(), todayStart, now + 1),
-      );
-      return { dailyLimit, dailyUsed };
-    })(),
+    tokenBudget:
+      options.includeTokenBudget === false
+        ? undefined
+        : {
+            dailyLimit: budgetSnapshot.dailyLimit,
+            dailyUsed: budgetSnapshot.dailyUsed,
+          },
     theme,
     colors,
   };
-}
+}

package/src/extension/core/state.ts

@@ -12,6 +12,8 @@ import {
 import { CoreContextUsageCache } from "../../usage/context.ts";
 import { createWelcomeDismissScheduler } from "../../welcome/auto-dismiss.ts";
 import { createRenderScheduler } from "../../render/timer.ts";
+import { MotionScheduler, policyFromEnvironment } from "../../motion/index.ts";
+import { createSignalRuntime } from "../../signal/controller.ts";
 import {
   resolveShortcutConfig,
   parseBashModeSettings,
@@ -47,6 +49,8 @@ export let config: PowerlineConfig = {
   segments: {},
   presets: {},
   segmentLabels: {},
+  appearance: {},
+  motionLevel: "full",
 };
 
 export function setConfig(next: PowerlineConfig): void {
@@ -113,6 +117,7 @@ export function createRuntimeState(
     currentEditor: null,
     costAlertNotified: false,
     tokenBudgetNotifiedLevel: 0,
+    tokenBudgetSnapshot: { day: "", dailyLimit: null, dailyUsed: 0 },
     bashModeActive: false,
     bashTranscript: new BashTranscriptStore(bashModeSettings),
     bashCompletionEngine: new BashCompletionEngine(),
@@ -135,6 +140,8 @@ export function createRuntimeState(
 
     resolvedShortcuts,
     bashModeSettings,
+    motionPolicy: policyFromEnvironment(process.env, config.motionLevel),
+    signal: createSignalRuntime(),
   } as RuntimeState;
 
   rt.welcomeDismissScheduler = createWelcomeDismissScheduler({
@@ -159,5 +166,13 @@ export function createRuntimeState(
     rt.tuiRef?.requestRender();
   }, STATUS_RENDER_DEBOUNCE_MS);
 
+  rt.motionScheduler = new MotionScheduler({
+    requestRender: () => {
+      // Motion only changes the Signal rail; segment data remains cached.
+      rt.lastLayoutResult = null;
+      rt.tuiRef?.requestRender();
+    },
+  });
+
   return rt;
-}
+}

package/src/extension/core/types.ts

@@ -11,8 +11,11 @@ import type {
   SessionTokenStatsCache,
 } from "../../usage/ledger.ts";
 import type { CoreContextUsageCache } from "../../usage/context.ts";
+import type { TokenBudgetSnapshot } from "../../usage/token-budget.ts";
 import type { WelcomeDismissScheduler } from "../../welcome/auto-dismiss.ts";
 import type { RenderScheduler } from "../../render/timer.ts";
+import type { MotionPolicy, MotionScheduler } from "../../motion/index.ts";
+import type { SignalRuntime } from "../../signal/controller.ts";
 
 export type ShortcutBinding = string | null;
 
@@ -66,6 +69,8 @@ export interface RuntimeState {
   costAlertNotified: boolean;
   /** Highest daily-budget warning already shown this session (0 / 80 / 100). */
   tokenBudgetNotifiedLevel: 0 | 80 | 100;
+  /** Event-driven token-budget snapshot consumed by render paths without disk I/O. */
+  tokenBudgetSnapshot: TokenBudgetSnapshot;
   bashModeActive: boolean;
   bashTranscript: BashTranscriptStore;
   bashCompletionEngine: BashCompletionEngine;
@@ -98,4 +103,9 @@ export interface RuntimeState {
 
   welcomeDismissScheduler: WelcomeDismissScheduler<any>;
   statusRenderScheduler: RenderScheduler;
-}
+  /** The single shared clock for every Wishcraft animation surface. */
+  motionScheduler: MotionScheduler;
+  motionPolicy: MotionPolicy;
+  /** Live Signal event, motion frame, and activity label. */
+  signal: SignalRuntime;
+}