@groeponline/pi-wishcraft 1.17.0 → 1.23.0

package/package.json

@@ -1,8 +1,9 @@
 {
   "name": "@groeponline/pi-wishcraft",
-  "version": "1.17.0",
+  "version": "1.23.0",
   "description": "Pi coding agent extension: operator cockpit with a live powerline status bar, idea queue, skill search, sticky Bash, hooks, policy guardrails, and TUI session UX.",
   "type": "module",
+  "packageManager": "bun@1.4.2",
   "engines": {
     "node": ">=22.19"
   },
@@ -11,6 +12,7 @@
     "*.md",
     "*.json",
     "!audit-baseline.json",
+    "!.oxlintrc.json",
     "banner.png",
     "docs/**/*.md",
     "src/**/*.ts",
@@ -60,14 +62,18 @@
   },
   "scripts": {
     "typecheck": "tsc --noEmit",
+    "lint": "oxlint --deny-warnings src tests scripts index.ts bash-mode queue",
+    "lint:fix": "oxlint --fix src tests scripts index.ts bash-mode queue",
     "test": "node --experimental-strip-types --experimental-test-coverage --test-coverage-lines=70 --test-coverage-functions=60 --test tests/**/*.test.ts",
-    "release": "node scripts/release.mjs",
-    "prepublishOnly": "tsc --noEmit && node scripts/verify-package.mjs && npm run verify:pi-package",
-    "verify:package": "node scripts/verify-package.mjs && node scripts/verify-pi-package-contract.mjs",
+    "check": "bun run typecheck && bun run lint && bun run test",
+    "release": "bun scripts/release.mjs",
+    "prepublishOnly": "bun run typecheck && bun run lint && bun scripts/verify-package.mjs && bun run verify:pi-package",
+    "verify:package": "bun scripts/verify-package.mjs && bun scripts/verify-pi-package-contract.mjs",
     "circular": "madge --circular src index.ts bash-mode queue",
-    "audit": "node scripts/audit-gate.mjs",
-    "preview": "node --experimental-strip-types scripts/preview.mjs",
-    "verify:pi-package": "node scripts/verify-pi-package-contract.mjs"
+    "audit": "bun scripts/audit-gate.mjs",
+    "preview": "bun scripts/preview.mjs",
+    "verify:pi-package": "bun scripts/verify-pi-package-contract.mjs",
+    "hooks:install": "git config core.hooksPath .githooks"
   },
   "peerDependencies": {
     "@earendil-works/pi-ai": "*",
@@ -75,11 +81,12 @@
     "@earendil-works/pi-tui": "*"
   },
   "devDependencies": {
-    "@earendil-works/pi-ai": "^0.99.2",
-    "@earendil-works/pi-coding-agent": "^0.99.2",
-    "@earendil-works/pi-tui": "^0.99.2",
+    "@earendil-works/pi-ai": "^1.5.0",
+    "@earendil-works/pi-coding-agent": "^1.5.0",
+    "@earendil-works/pi-tui": "^1.5.0",
     "@types/node": "24.13.3",
     "madge": "^8.0.0",
+    "oxlint": "^1.91.0",
     "typescript": "5.9.3"
   },
   "pi": {

package/src/config/settings-registry.ts

@@ -6,6 +6,7 @@
  */
 import { tr } from "../i18n/index.ts";
 import { MOTION_LEVELS } from "../motion/accessibility.ts";
+import { workingIndicatorStyles } from "../working-vibes/frames.ts";
 import { STRUCTURAL_PRESET_NAMES } from "./types.ts";
 
 export type SettingValue = boolean | string | number;
@@ -108,7 +109,7 @@ export const SETTINGS_REGISTRY = [
   { id: "status.ports.host", path: "powerline.segmentOptions.openPorts.host", group: "status", label: "Ports probe host", kind: "text", hint: "SSH host to probe (fleet) · empty = this machine" },
   { id: "welcome.enabled", path: "powerline.welcome", group: "vibes", label: "Welcome overlay", kind: "toggle", defaultValue: SETTING_DEFAULTS["powerline.welcome"], hint: "on = overlay at startup, off = no welcome" },
   { id: "welcome.lanternMotion", path: "wishcraft.welcome.animateLantern", group: "vibes", label: "Animate wishcraft lantern", kind: "toggle", hint: "flicker on the lantern" },
-  { id: "vibes.indicatorStyle", path: "wishcraft.workingIndicatorStyle", group: "vibes", label: "Working indicator", kind: "select", choices: ["dots", "pulse", "bar", "ascii"], defaultValue: SETTING_DEFAULTS["wishcraft.workingIndicatorStyle"], hint: "frame style used while the agent is working" },
+  { id: "vibes.indicatorStyle", path: "wishcraft.workingIndicatorStyle", group: "vibes", label: "Working indicator", kind: "select", choices: workingIndicatorStyles(), defaultValue: SETTING_DEFAULTS["wishcraft.workingIndicatorStyle"], hint: "frame style for Pi's own working spinner while the agent runs" },
   { id: "skills.inline", path: "wishcraft.inlineSkills", group: "skills", label: "Inline expand /command and $skill", kind: "toggle", hint: "needs a restart to take effect", restartRequired: true },
   { id: "skills.readHints", path: "wishcraft.readHints", group: "skills", label: "Read hints", kind: "toggle", defaultValue: SETTING_DEFAULTS["wishcraft.readHints"], hint: "off = no continuation hint after partial reads" },
   { id: "harness.hooks", path: "wishcraft.hooksEnabled", group: "harness", label: "Hooks enabled", kind: "toggle", defaultValue: SETTING_DEFAULTS["wishcraft.hooksEnabled"], hint: "gate for configured preToolUse / postToolUse / sessionStart hooks" },

package/src/config/structural-preset-table.ts

@@ -11,7 +11,6 @@ import type { StructuralPresetDef, StructuralPresetName } from "./types.ts";
 import {
   BORDERLESS_CHROME,
   DEFAULT_DECK,
-  DEFAULT_WELCOME,
   MINIMAL_CHROME,
   motion,
   ROUNDED_CHROME,

package/src/extension/commands/commands.ts

@@ -1,6 +1,5 @@
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import { type KeyId } from "@earendil-works/pi-tui";
-import type { StatusLinePreset } from "../../config/types.ts";
 import { PRESETS } from "../../config/presets.ts";
 import { registerCdCommand } from "../../shell/cd-command.ts";
 import { registerVibeCommand } from "./vibe-command.ts";

package/src/extension/core/peer-guard.ts

@@ -90,6 +90,11 @@ export const PEER_SYMBOL_REQUIREMENTS: readonly PeerSymbolRequirement[] = [
     symbol: "truncateToWidth",
     usedBy: "status line rendering",
   },
+  {
+    pkg: "@earendil-works/pi-tui",
+    symbol: "wrapTextWithAnsi",
+    usedBy: "welcome news expansion",
+  },
   {
     pkg: "@earendil-works/pi-tui",
     symbol: "SelectList",

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

@@ -15,6 +15,12 @@ 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 type { SessionAssistantUsage } from "../../usage/ledger.ts";
+import {
+  pushTpsSample,
+  ringMsForWindow,
+  tpsSamples,
+} from "../../usage/tps-ring.ts";
 import { tokenBudgetSnapshotForDay } from "../../usage/token-budget.ts";
 import { dayKey } from "../../usage/usage-store.ts";
 import {
@@ -119,9 +125,90 @@ export interface BuildSegmentContextOptions {
   includeTokenBudget?: boolean;
 }
 
+/**
+ * Structural subset of Pi's extension context that the context builder reads.
+ * Typed rather than `any` so a renamed Pi accessor fails the typecheck here
+ * instead of silently rendering defaults at runtime.
+ */
+export interface SegmentSourceContext {
+  sessionManager?: { getSessionId?: () => string | undefined };
+  model?: SegmentContext["model"];
+  modelRegistry?: {
+    // Pi types this as `(model: Model<Api>) => boolean`. Method-bivariance
+    // keeps that signature assignable without widening the segment model
+    // shape to the full SDK `Model` type.
+    isUsingOAuth?: {
+      bivariance(model: NonNullable<SegmentContext["model"]>): boolean;
+    }["bivariance"];
+  };
+  cwd?: string;
+  settingsManager?: {
+    getCompactionSettings?: () => { enabled?: boolean } | undefined;
+  };
+}
+
+interface ContextMetrics {
+  contextTokens: number;
+  contextPercent: number;
+  contextWindow: number;
+}
+
+/**
+ * Token/context numbers: cached core usage wins, the live assistant usage is
+ * the fallback, and the model's window bounds the percentage.
+ */
+function resolveContextMetrics(
+  rt: RuntimeState,
+  ctx: SegmentSourceContext,
+  usage: SessionAssistantUsage | undefined,
+): ContextMetrics {
+  const core =
+    rt.isStreaming && rt.liveAssistantUsage ? null : rt.coreContextUsageCache.get(ctx);
+  const contextTokens =
+    core?.contextTokens ?? (usage ? getUsageTokenTotal(usage) : 0);
+  const contextWindow = core?.contextWindow ?? ctx.model?.contextWindow ?? 0;
+  const contextPercent =
+    core?.contextPercent ??
+    (contextWindow > 0 ? (contextTokens / contextWindow) * 100 : 0);
+  return { contextTokens, contextPercent, contextWindow };
+}
+
+interface CustomItemState {
+  effectiveCustomItems: SegmentContext["effectiveCustomItems"];
+  customItemsById: SegmentContext["customItemsById"];
+  hiddenExtensionStatusKeys: Set<string>;
+}
+
+/** Merge configured + auto-discovered custom items and hide claimed statuses. */
+function resolveCustomItemState(
+  extensionStatuses: ReadonlyMap<string, string>,
+): CustomItemState {
+  const excludedStatusKeys = new Set<string>([
+    CUSTOM_COMPACTION_STATUS_KEY,
+    "stash",
+    ...HIDDEN_POWERLINE_STATUS_KEYS,
+  ]);
+  const effectiveCustomItems = deriveAutoCustomItems(
+    config.customItems,
+    extensionStatuses,
+    config.customItemsAuto,
+    excludedStatusKeys,
+  );
+  const customItemsById = new Map(
+    effectiveCustomItems.map((item) => [item.id, item]),
+  );
+  const hiddenExtensionStatusKeys = collectHiddenExtensionStatusKeys(
+    effectiveCustomItems,
+  );
+  for (const key of HIDDEN_POWERLINE_STATUS_KEYS) {
+    hiddenExtensionStatusKeys.add(key);
+  }
+  return { effectiveCustomItems, customItemsById, hiddenExtensionStatusKeys };
+}
+
 export function buildSegmentContext(
   rt: RuntimeState,
-  ctx: any,
+  ctx: SegmentSourceContext,
   theme: Theme,
   options: BuildSegmentContextOptions = {},
 ): SegmentContext {
@@ -133,72 +220,39 @@ export function buildSegmentContext(
     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
-  // event's stats-relevant fields change, e.g. in-place streaming updates)
+  // Usage stats are cached; the full event list is only re-scanned when events
+  // are appended or the trailing event's stats-relevant fields change (e.g.
+  // in-place streaming updates).
   const sessionEvents = rt.sessionBranchCache.get(ctx.sessionManager);
   const tokenStats = rt.tokenStatsCache.get(sessionEvents);
   const { input, output, cacheRead, cacheWrite, cost, subagentCost } =
     tokenStats;
   const lastAssistant = tokenStats.lastAssistant;
-  const thinkingLevelFromSession = tokenStats.thinkingLevelFromSession;
 
-  // Calculate context percentage.
   const latestUsage = rt.isStreaming
     ? (rt.liveAssistantUsage ?? lastAssistant?.usage)
     : lastAssistant?.usage;
-  const coreContextUsage =
-    rt.isStreaming && rt.liveAssistantUsage
-      ? null
-      : rt.coreContextUsageCache.get(ctx);
-  const contextTokens =
-    coreContextUsage?.contextTokens ??
-    (latestUsage ? getUsageTokenTotal(latestUsage) : 0);
-  const contextWindow =
-    coreContextUsage?.contextWindow ?? ctx.model?.contextWindow ?? 0;
-  const contextPercent =
-    coreContextUsage?.contextPercent ??
-    (contextWindow > 0 ? (contextTokens / contextWindow) * 100 : 0);
+  const { contextTokens, contextPercent, contextWindow } =
+    resolveContextMetrics(rt, ctx, latestUsage);
 
   const segmentOptions = mergeSegmentOptions(
     presetDef.segmentOptions,
     config.segmentOptions,
   );
 
-  // Get git status (cached)
   const gitBranch = rt.footerDataRef?.getGitBranch() ?? null;
   const gitStatus = getGitStatus(gitBranch, segmentOptions.git?.polling);
-  const extensionStatuses =
-    rt.footerDataRef?.getExtensionStatuses() ?? new Map();
-  const excludedStatusKeys = new Set<string>([
-    CUSTOM_COMPACTION_STATUS_KEY,
-    "stash",
-    ...HIDDEN_POWERLINE_STATUS_KEYS,
-  ]);
-  const effectiveCustomItems = deriveAutoCustomItems(
-    config.customItems,
-    extensionStatuses,
-    config.customItemsAuto,
-    excludedStatusKeys,
-  );
-  const customItemsById = new Map(
-    effectiveCustomItems.map((item) => [item.id, item]),
-  );
-  const hiddenExtensionStatusKeys = collectHiddenExtensionStatusKeys(
-    effectiveCustomItems,
-  );
-  for (const key of HIDDEN_POWERLINE_STATUS_KEYS) {
-    hiddenExtensionStatusKeys.add(key);
-  }
+  const extensionStatuses = rt.footerDataRef?.getExtensionStatuses() ?? new Map();
+  const { effectiveCustomItems, customItemsById, hiddenExtensionStatusKeys } =
+    resolveCustomItemState(extensionStatuses);
 
-  // Check if using OAuth subscription
   const usingSubscription = ctx.model
     ? (ctx.modelRegistry?.isUsingOAuth?.(ctx.model) ?? false)
     : false;
 
   const thinkingLevel =
     rt.currentThinkingLevel ??
-    thinkingLevelFromSession ??
+    tokenStats.thinkingLevelFromSession ??
     rt.getThinkingLevelFn?.() ??
     "off";
   const queueSummary = rt.queueStore.summarize(
@@ -248,4 +302,45 @@ export function buildSegmentContext(
     theme,
     colors,
   };
-}
+}
+const TPS_EVENT_MIN_GAP_MS = 30;
+let lastTpsEventAt = 0;
+let lastMarkedTurnStart: number | null = null;
+
+/**
+ * Event-driven TPS sampling, called from `message_update`. The ring used to be
+ * filled only while the `tps` segment rendered, so presets without that segment
+ * left `/tps` empty and every unrelated repaint added a duplicate sample.
+ *
+ * This is also the only writer of the turn marker: the first sample of a turn
+ * carries `turnStartAt`, the rest do not, so `measureTurn` can find both the
+ * turn boundary and the sample that produced its first token.
+ */
+export function sampleTpsFromSession(
+  rt: RuntimeState,
+  ctx: SegmentSourceContext,
+  now: number = Date.now(),
+): void {
+  if (now - lastTpsEventAt < TPS_EVENT_MIN_GAP_MS) return;
+  lastTpsEventAt = now;
+  const events = rt.sessionBranchCache.get(ctx.sessionManager);
+  const { input, output, cacheRead } = rt.tokenStatsCache.get(events);
+  const windowMs =
+    mergeSegmentOptions(getPreset(config.preset).segmentOptions, config.segmentOptions)
+      .tps?.windowMs ?? 1000;
+  const turnStartAt =
+    rt.turnStartedAt !== null && rt.turnStartedAt !== lastMarkedTurnStart
+      ? (lastMarkedTurnStart = rt.turnStartedAt)
+      : undefined;
+  pushTpsSample(
+    tpsSamples,
+    {
+      at: now,
+      output,
+      input,
+      uncachedInput: Math.max(0, input - cacheRead),
+      ...(turnStartAt === undefined ? {} : { turnStartAt }),
+    },
+    ringMsForWindow(windowMs),
+  );
+}

package/src/extension/core/state.ts

@@ -111,6 +111,7 @@ export function createRuntimeState(
     welcomeHeaderActive: false,
     welcomeOverlayShouldDismiss: false,
     lastUserPrompt: "",
+    turnStartedAt: null,
     showLastPrompt: true,
     stashedEditorText: null,
     stashedPromptHistory: readPersistedStashHistory(),

package/src/extension/core/types.ts

@@ -61,6 +61,11 @@ export interface RuntimeState {
   welcomeHeaderActive: boolean;
   welcomeOverlayShouldDismiss: boolean;
   lastUserPrompt: string;
+  /**
+   * Timestamp (ms) of the current turn's `agent_start`; null between turns.
+   * Only the first TPS sample of a turn carries it as a ring marker.
+   */
+  turnStartedAt: number | null;
   showLastPrompt: boolean;
   stashedEditorText: string | null;
   stashedPromptHistory: string[];

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

@@ -18,6 +18,9 @@ import { showSelectOverlay } from "../ui/menu-views.ts";
 import { getQueueContext } from "./queue-context.ts";
 import { isStaleExtensionContextError } from "../session/stale-context.ts";
 import { config } from "../core/state.ts";
+import { allWorkingIndicatorFrames } from "../../working-vibes/frames.ts";
+import { MOTION_CATALOG } from "../../motion/catalog.ts";
+import { framesOf } from "../../motion/frames.ts";
 import type { RuntimeState } from "../core/types.ts";
 
 export function requestQueueRender(rt: RuntimeState): void {
@@ -40,9 +43,24 @@ export function queueItemDescription(item: PowerlineQueueItem): string {
  * Pi's working indicator (spinner frame + "Working...") can end up at the start
  * of captured text when the editor buffer is captured while the agent runs.
  * Strip that prefix so ideas never render as a permanently "working" card.
+ *
+ * The frame alternation is built from the same tables the indicator draws from
+ * (`working-vibes/frames.ts` plus the Motion Catalog the `motion` style
+ * borrows), so a new style or motion can never leak its glyphs into an idea.
  */
-const CAPTURE_NOISE_PREFIX =
-  /^[\u2800-\u28FF][\u2800-\u28FF ]*\s*Working[.…]+\s*/;
+const SPINNER_FRAMES = [
+  ...new Set([
+    ...allWorkingIndicatorFrames(),
+    ...MOTION_CATALOG.flatMap((def) => framesOf(def)),
+  ]),
+]
+  .filter((frame) => frame.trim().length > 0)
+  .sort((a, b) => b.length - a.length)
+  .map((frame) => frame.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"));
+
+const CAPTURE_NOISE_PREFIX = new RegExp(
+  `^\\s*(?:(?:${SPINNER_FRAMES.join("|")})\\s*)*Working[.…]+\\s*`,
+);
 
 export function stripCaptureNoisePrefix(text: string): string {
   let out = text;

package/src/extension/session/session-lifecycle.ts

@@ -4,6 +4,7 @@ import { BashTranscriptStore } from "../../../bash-mode/transcript.ts";
 import { BashCompletionEngine } from "../../../bash-mode/completion.ts";
 import { parsePowerlineConfig } from "../../config/powerline-config.ts";
 import { policyFromEnvironment } from "../../motion/accessibility.ts";
+import { defaultMotionFor } from "../../motion/catalog.ts";
 import { registerCustomSegments } from "../../segments/index.ts";
 import { registerCustomPresets } from "../../config/presets.ts";
 import { invalidateGitStatus } from "../../git/status.ts";
@@ -34,6 +35,7 @@ import {
   requestImmediateStatusRender,
   requestStatusRender,
   resetLayoutCache,
+  sampleTpsFromSession,
 } from "../core/segment-context.ts";
 import { getQueueContext } from "../queue/queue-context.ts";
 import {
@@ -62,6 +64,10 @@ import {
   clearSkillsCountPublisher,
 } from "../skills/skill-status.ts";
 import { maybeAppendReadHint } from "./read-hints.ts";
+import {
+  applyNativeWorkingIndicator,
+  resetNativeWorkingIndicator,
+} from "../../working-vibes/native-indicator.ts";
 import {
   dispatchSignalEvent,
   settleSignal,
@@ -181,7 +187,7 @@ export function registerSessionLifecycle(
     }
   });
 
-  pi.on("session_shutdown", async (_event, ctx) => {
+  pi.on("session_shutdown", async (_event, _ctx) => {
     clearSkillsCountPublisher();
     rt.sessionGeneration++;
     rt.dismissWelcomeOverlay?.();
@@ -260,9 +266,16 @@ export function registerSessionLifecycle(
 
   // Generate themed working message before agent starts (has access to user's prompt)
   pi.on("before_agent_start", async (event, ctx) => {
-    rt.lastUserPrompt = event.prompt;
+    const prompt =
+      event.messageType === "user"
+        ? event.prompt
+        : event.message.display && typeof event.message.content === "string"
+          ? event.message.content
+          : "";
+    rt.lastUserPrompt = prompt;
     if (ctx.hasUI) {
-      onVibeBeforeAgentStart(event.prompt, ctx.ui.setWorkingMessage);
+      onVibeBeforeAgentStart(prompt, ctx.ui.setWorkingMessage);
+      applyNativeWorkingIndicator(ctx.ui, rt.motionPolicy, defaultMotionFor("thinking"));
     }
   });
 
@@ -270,6 +283,7 @@ export function registerSessionLifecycle(
   // Also dismiss welcome when agent starts responding (handles `p "command"` case)
   pi.on("agent_start", async (_event, ctx) => {
     rt.isStreaming = true;
+    rt.turnStartedAt = Date.now();
     rt.liveAssistantUsage = null;
     onVibeAgentStart();
     dismissWelcome(rt, ctx);
@@ -287,6 +301,11 @@ export function registerSessionLifecycle(
       rt.liveAssistantUsage = event.message.usage;
       rt.currentCtx = ctx;
       rt.layoutDirty = true;
+      try {
+        sampleTpsFromSession(rt, ctx);
+      } catch (error) {
+        if (!isStaleExtensionContextError(error)) throw error;
+      }
       rt.statusRenderScheduler.schedule(CONTEXT_STATUS_RENDER_MS);
       if (rt.signal.event !== "streaming") {
         dispatchSignalEvent(rt, config.appearance, "streaming");
@@ -406,6 +425,7 @@ export function registerSessionLifecycle(
 
   pi.on("agent_end", async (_event, ctx) => {
     rt.isStreaming = false;
+    rt.turnStartedAt = null;
     rt.liveAssistantUsage = null;
     rt.coreContextUsageCache.reset();
     dispatchSignalEvent(rt, config.appearance, "success");
@@ -423,6 +443,7 @@ export function registerSessionLifecycle(
     try {
       if (hasUI) {
         onVibeAgentEnd(ctx.ui.setWorkingMessage); // working-vibes internal state + reset message
+        resetNativeWorkingIndicator(ctx.ui);
         if (rt.stashedEditorText !== null) {
           if (ctx.ui.getEditorText().trim() === "") {
             ctx.ui.setEditorText(rt.stashedEditorText);

package/src/extension/skills/inline-invocation.ts

@@ -162,7 +162,7 @@ export function expandInlineTriggers(text: string): string {
  */
 export function setupInlineInvocation(
   pi: ExtensionAPI,
-  rt: RuntimeState,
+  _rt: RuntimeState,
 ): void {
   pi.on("input", async (event: any) => {
     // Alleen interactive input verwerken

package/src/extension/ui/custom-editor.ts

@@ -48,14 +48,10 @@ import {
   runPowerlineShortcut,
   stashOrRestoreEditorText,
 } from "../shortcuts/shortcuts-router.ts";
-import {
-  dismissWelcome,
-  scheduleDismissWelcome,
-} from "../welcome/welcome-control.ts";
+import { scheduleDismissWelcome } from "../welcome/welcome-control.ts";
 import { config } from "../core/state.ts";
 import type { RuntimeState } from "../core/types.ts";
 import {
-  ensureShellSession,
   getShellCwd,
   getShellHistoryEntries,
   getShellPath,

package/src/extension/ui/deck/config-diagnostic-lines.ts

@@ -19,12 +19,6 @@ const MAX_CONFLICTS = 3;
 const MAX_UNKNOWN = 3;
 const MAX_INVALID = 4;
 
-const MARK: Record<"ok" | "warn" | "fail", string> = {
-  ok: "✓",
-  warn: "!",
-  fail: "✗",
-};
-
 /** Localised heading for the config diagnosis block. */
 export function configDiagnosticTitle(): string {
   return tr("diag.title", "Config diagnosis");

package/src/extension/ui/ports-panel.ts

@@ -21,7 +21,6 @@ import { matchesKey, type SelectItem, SelectList } from "@earendil-works/pi-tui"
 import { tr } from "../../i18n/index.ts";
 import { config } from "../core/state.ts";
 import {
-  filterPorts,
   formatAddresses,
   formatOwner,
   formatPortsSummary,

package/src/extension/ui/token-overlays.ts

@@ -35,7 +35,7 @@ export function buildTpsOverlayItems(rt: RuntimeState, ctx: any): SelectItem[] {
   const summary = summarizeTpsRing(
     tpsSamples,
     Date.now(),
-    { input: snap.input, output: snap.output },
+    { input: snap.input, output: snap.output, cacheRead: snap.cacheRead },
     {
       windowMs: config.segmentOptions?.tps?.windowMs ?? 1000,
       override: process.env.POWERLINE_TPS,

package/src/extension/welcome/welcome-integration.ts

@@ -183,7 +183,7 @@ export function setupWelcomeOverlay(rt: RuntimeState, ctx: any) {
         (
           tui: any,
           _theme: any,
-          _keybindings: any,
+          keybindings: any,
           done: (result: void) => void,
         ) => {
           const welcome = new WelcomeComponent(
@@ -205,22 +205,51 @@ export function setupWelcomeOverlay(rt: RuntimeState, ctx: any) {
           let countdown = 30;
           let dismissed = false;
           let interval: ReturnType<typeof setInterval> | null = null;
+          let revealTimer: ReturnType<typeof setInterval> | null = null;
+
+          const stopTimers = () => {
+            if (interval) clearInterval(interval);
+            if (revealTimer) clearInterval(revealTimer);
+            interval = null;
+            revealTimer = null;
+          };
 
           const dismiss = () => {
             if (dismissed) return;
             dismissed = true;
-            if (interval) clearInterval(interval);
+            stopTimers();
             rt.dismissWelcomeOverlay = null;
             done();
           };
 
           interval = setInterval(() => {
-            if (dismissed) return;
+            if (dismissed || welcome.isTimerPaused()) return;
             countdown--;
             welcome.setCountdown(countdown);
             tui.requestRender();
             if (countdown <= 0) dismiss();
           }, 1000);
+          interval.unref?.();
+
+          // The countdown only repaints once a second, which stepped the boot
+          // reveal at 1 FPS. Repaint on the ambient heartbeat: bounded while
+          // the reveal window is open, continuous while the lantern animates.
+          const revealStartedAt = Date.now();
+          const animateArt = artSettings.animate;
+          revealTimer = setInterval(() => {
+            if (dismissed) {
+              if (revealTimer) clearInterval(revealTimer);
+              revealTimer = null;
+              return;
+            }
+            if (!animateArt && !bootRevealActive(revealStartedAt, Date.now())) {
+              if (revealTimer) clearInterval(revealTimer);
+              revealTimer = null;
+              return;
+            }
+            tui.requestRender();
+          }, BOOT_REVEAL_HEARTBEAT_MS);
+          revealTimer.unref?.();
 
           rt.dismissWelcomeOverlay = dismiss;
 
@@ -233,10 +262,41 @@ export function setupWelcomeOverlay(rt: RuntimeState, ctx: any) {
             focused: false,
             invalidate: () => welcome.invalidate(),
             render: (width: number) => welcome.render(width),
-            handleInput: () => dismiss(),
+            handleInput: (data: string) => {
+              // Only non-printable navigation is intercepted; Tab/Shift+Tab
+              // switch section, arrows move inside it, Enter (only once the
+              // countdown is paused) primes the focused quick-launch row.
+              // Every printable key still just dismisses, so typing is never
+              // swallowed by the overlay.
+              const nextSection = data === "\t";
+              const prevSection = data === "\x1b[Z";
+              if (nextSection || prevSection) {
+                welcome.cycleSection(prevSection ? -1 : 1);
+                tui.requestRender();
+                return;
+              }
+              const up = keybindings?.matches?.(data, "tui.select.up") || data === "\x1b[A";
+              const down = keybindings?.matches?.(data, "tui.select.down") || data === "\x1b[B";
+              if (up || down) {
+                welcome.moveFocus(up ? -1 : 1);
+                tui.requestRender();
+                return;
+              }
+              const enter =
+                keybindings?.matches?.(data, "tui.select.confirm") ||
+                data === "\r" ||
+                data === "\n";
+              if (enter && welcome.isTimerPaused()) {
+                const insert = welcome.activate();
+                dismiss();
+                if (insert) ctx.ui.setEditorText?.(insert);
+                return;
+              }
+              dismiss();
+            },
             dispose: () => {
               dismissed = true;
-              if (interval) clearInterval(interval);
+              stopTimers();
             },
           };
         },

package/src/i18n/nl.ts

@@ -311,6 +311,9 @@ export const NL: Record<string, string> = {
   "welcome.tagline": "Schrijf het op, laat het stijgen, houd je focus helder.",
   "welcome.title": " pi-wishcraft ",
   "welcome.countdown": "Druk op een toets om verder te gaan ({n}s)",
+  "welcome.pausedHint": "↑/↓ nieuws bekijken · andere toets gaat verder",
+  "welcome.pausedHint.sessions": "↑/↓ sessies bekijken · tab wisselt sectie · andere toets gaat verder",
+  "welcome.pausedHint.shortcuts": "↑/↓ kiezen · enter vult de prompt · tab wisselt sectie",
   "welcome.whatsNew": "Wat is nieuw",
   "welcome.firstRun": "Aan de slag",
   "welcome.firstRun.1": "# <idee> — leg een gedachte vast zonder te onderbreken",