token-larper 1.0.1 → 1.6.1

package/src/tray.ts

@@ -1,5 +1,6 @@
 import { mkdirSync, writeFileSync } from "node:fs";
 import { join, resolve } from "node:path";
+import { flattenPath, LOGO_PATHS } from "./client/logoMark.ts";
 
 const ROOT_DIR = resolve(import.meta.dir, "..");
 const SCRIPTS_DIR = join(ROOT_DIR, "scripts");
@@ -10,6 +11,10 @@ let trayPid: number | null = null;
 
 export function generateTrayScript(port: number, serverPid: number): string {
   mkdirSync(SCRIPTS_DIR, { recursive: true });
+  const logoPolygons = [LOGO_PATHS.t, LOGO_PATHS.flame]
+    .flatMap((d) => flattenPath(d))
+    .map((poly) => `  @(${poly.flat().map((n) => n.toFixed(2)).join(", ")})`)
+    .join(",\n");
 
   const psScript = `
 Add-Type -AssemblyName System.Windows.Forms
@@ -24,52 +29,193 @@ $BaseUrl = "http://127.0.0.1:$ServerPort"
 Add-Type -Namespace TokenLarper -Name Dpi -MemberDefinition '[DllImport("user32.dll")] public static extern bool SetProcessDPIAware();'
 [TokenLarper.Dpi]::SetProcessDPIAware() | Out-Null
 
-# The t. monogram from src/client/logo.svg, drawn in its 64-unit coordinates.
-$iconSize = [Math]::Max(16, [System.Windows.Forms.SystemInformation]::SmallIconSize.Width)
-$bmp = New-Object System.Drawing.Bitmap($iconSize, $iconSize)
-$g = [System.Drawing.Graphics]::FromImage($bmp)
-$g.SmoothingMode = [System.Drawing.Drawing2D.SmoothingMode]::AntiAlias
-$g.PixelOffsetMode = [System.Drawing.Drawing2D.PixelOffsetMode]::HighQuality
-$g.Clear([System.Drawing.Color]::Transparent)
-$g.ScaleTransform($iconSize / 64, $iconSize / 64)
-
-$green = New-Object System.Drawing.SolidBrush([System.Drawing.Color]::FromArgb(255, 47, 90, 67))
-$cream = New-Object System.Drawing.SolidBrush([System.Drawing.Color]::FromArgb(255, 243, 227, 191))
-$gold = New-Object System.Drawing.SolidBrush([System.Drawing.Color]::FromArgb(255, 225, 183, 92))
-
-# Rounded square: x 3, y 3, size 58, corner radius 14.
-$tile = New-Object System.Drawing.Drawing2D.GraphicsPath
-$tile.AddArc(3, 3, 28, 28, 180, 90)
-$tile.AddArc(33, 3, 28, 28, 270, 90)
-$tile.AddArc(33, 33, 28, 28, 0, 90)
-$tile.AddArc(3, 33, 28, 28, 90, 90)
-$tile.CloseFigure()
-$g.FillPath($green, $tile)
-
-# Letter t: a stem with a curved foot, plus the crossbar.
-$stem = New-Object System.Drawing.Drawing2D.GraphicsPath
-$stem.AddLine(20, 12, 28, 12)
-$stem.AddLine(28, 12, 28, 43.5)
-$stem.AddBezier(28, 43.5, 28, 45.2, 28.8, 46, 30.5, 46)
-$stem.AddLine(30.5, 46, 35, 46)
-$stem.AddLine(35, 46, 35, 53)
-$stem.AddLine(35, 53, 28.5, 53)
-$stem.AddBezier(28.5, 53, 22.8, 53, 20, 50.2, 20, 44.5)
-$stem.CloseFigure()
-$g.FillPath($cream, $stem)
-$g.FillRectangle($cream, 13, 21, 22, 7)
-
-# The dot.
-$g.FillEllipse($gold, 39.5, 42, 11, 11)
-
-$hIcon = $bmp.GetHicon()
-$icon = [System.Drawing.Icon]::FromHandle($hIcon)
+# The Burning t. logo from src/client/logoMark.ts, flattened to polygons in 64-unit
+# coordinates. It has no background, so it is black on a light taskbar and white on a
+# dark one, and redrawn if that Windows setting changes.
+Add-Type -Namespace TokenLarper -Name IconNative -MemberDefinition '[DllImport("user32.dll")] public static extern bool DestroyIcon(IntPtr handle);'
+$LogoPolygons = @(
+${logoPolygons}
+)
+
+function Test-LightTaskbar {
+  try {
+    $value = Get-ItemPropertyValue -Path "HKCU:\Software\Microsoft\Windows\CurrentVersion\Themes\Personalize" -Name SystemUsesLightTheme -ErrorAction Stop
+    return ($value -eq 1)
+  } catch {
+    return $false
+  }
+}
+
+function New-LogoIcon([bool]$light) {
+  $size = [Math]::Max(16, [System.Windows.Forms.SystemInformation]::SmallIconSize.Width)
+  $bmp = New-Object System.Drawing.Bitmap($size, $size)
+  $g = [System.Drawing.Graphics]::FromImage($bmp)
+  $g.SmoothingMode = [System.Drawing.Drawing2D.SmoothingMode]::AntiAlias
+  $g.PixelOffsetMode = [System.Drawing.Drawing2D.PixelOffsetMode]::HighQuality
+  $g.Clear([System.Drawing.Color]::Transparent)
+  $g.ScaleTransform($size / 64, $size / 64)
+  $color = if ($light) { [System.Drawing.Color]::FromArgb(255, 20, 20, 20) } else { [System.Drawing.Color]::FromArgb(255, 245, 245, 245) }
+  $brush = New-Object System.Drawing.SolidBrush($color)
+  # Alternate (even-odd) filling cuts the flame's core out of the flame.
+  $path = New-Object System.Drawing.Drawing2D.GraphicsPath([System.Drawing.Drawing2D.FillMode]::Alternate)
+  foreach ($poly in $LogoPolygons) {
+    $count = [int]($poly.Length / 2)
+    $points = New-Object 'System.Drawing.PointF[]' $count
+    for ($i = 0; $i -lt $count; $i++) {
+      $points[$i] = New-Object System.Drawing.PointF([single]$poly[2 * $i], [single]$poly[2 * $i + 1])
+    }
+    $path.AddPolygon($points)
+  }
+  $g.FillPath($brush, $path)
+  $path.Dispose()
+  $brush.Dispose()
+  $g.Dispose()
+  $icon = [System.Drawing.Icon]::FromHandle($bmp.GetHicon())
+  $bmp.Dispose()
+  return $icon
+}
+
+$script:lightTaskbar = Test-LightTaskbar
+$icon = New-LogoIcon $script:lightTaskbar
 
 $notifyIcon = New-Object System.Windows.Forms.NotifyIcon
 $notifyIcon.Icon = $icon
 $notifyIcon.Text = "Token Larper - AI Coding Telemetry (Port $ServerPort)"
 $notifyIcon.Visible = $true
 
+# Compact left-click popup. Every string comes from /api/tray-status, and its colors come
+# from the dashboard's current theme (sent to the server whenever the theme changes).
+Add-Type -Namespace TokenLarper -Name Dwm -MemberDefinition '[DllImport("dwmapi.dll")] public static extern int DwmSetWindowAttribute(IntPtr hwnd, int attr, ref int value, int size);'
+
+function New-PopupLabel([string]$text, [int]$x, [int]$y, [int]$w, [int]$h, [float]$size, [bool]$bold, [string]$align) {
+  $label = New-Object System.Windows.Forms.Label
+  $label.Text = $text
+  $label.Location = New-Object System.Drawing.Point($x, $y)
+  $label.Size = New-Object System.Drawing.Size($w, $h)
+  $style = if ($bold) { [System.Drawing.FontStyle]::Bold } else { [System.Drawing.FontStyle]::Regular }
+  $label.Font = New-Object System.Drawing.Font("Segoe UI", $size, $style)
+  $label.TextAlign = [System.Drawing.ContentAlignment]::$align
+  $label.AutoEllipsis = $true
+  $popup.Controls.Add($label)
+  return $label
+}
+
+$popup = New-Object System.Windows.Forms.Form
+$popup.Text = "Token Larper"
+$popup.FormBorderStyle = [System.Windows.Forms.FormBorderStyle]::None
+$popup.StartPosition = [System.Windows.Forms.FormStartPosition]::Manual
+$popup.ShowInTaskbar = $false
+$popup.TopMost = $true
+$popup.KeyPreview = $true
+$popup.ClientSize = New-Object System.Drawing.Size(300, 222)
+
+$popupTitle = New-PopupLabel "Token Larper" 20 16 170 22 10 $true "MiddleLeft"
+$popupLevel = New-PopupLabel "" 190 16 90 22 9 $true "MiddleRight"
+$popupTodayCaption = New-PopupLabel "Today" 20 50 260 18 9 $false "MiddleLeft"
+$popupTodayTokens = New-PopupLabel "Loading..." 17 68 160 40 21 $true "MiddleLeft"
+$popupTodayCost = New-PopupLabel "" 160 76 120 28 12 $true "MiddleRight"
+$popupRule = New-Object System.Windows.Forms.Panel
+$popupRule.Location = New-Object System.Drawing.Point(20, 118)
+$popupRule.Size = New-Object System.Drawing.Size(260, 1)
+$popup.Controls.Add($popupRule)
+$popupWeekCaption = New-PopupLabel "Last 7 days" 20 128 110 22 9 $false "MiddleLeft"
+$popupWeek = New-PopupLabel "" 120 128 160 22 9 $true "MiddleRight"
+$popupAllCaption = New-PopupLabel "All time" 20 152 110 22 9 $false "MiddleLeft"
+$popupAll = New-PopupLabel "" 120 152 160 22 9 $true "MiddleRight"
+$popupUpdated = New-PopupLabel "" 150 186 130 22 8 $false "MiddleRight"
+
+# A text link instead of a filled button bar; it takes focus so Enter opens the dashboard.
+$popupOpen = New-Object System.Windows.Forms.LinkLabel
+$popupOpen.Text = "Open dashboard"
+$popupOpen.Location = New-Object System.Drawing.Point(20, 186)
+$popupOpen.Size = New-Object System.Drawing.Size(130, 22)
+$popupOpen.Font = New-Object System.Drawing.Font("Segoe UI", 9, [System.Drawing.FontStyle]::Bold)
+$popupOpen.TextAlign = [System.Drawing.ContentAlignment]::MiddleLeft
+$popupOpen.LinkBehavior = [System.Windows.Forms.LinkBehavior]::HoverUnderline
+$popupOpen.TabStop = $true
+$popup.Controls.Add($popupOpen)
+
+$script:popupThemeKey = ""
+function Set-PopupTheme($theme) {
+  # Defaults match the Pine dark theme until the dashboard reports its colors.
+  $t = @{ surface = "#1b221e"; text = "#e8eee7"; text2 = "#b5c1b7"; text3 = "#98a59b"; border = "#2e3932"; accent = "#9fcaa8"; gold = "#e1b75c" }
+  if ($null -ne $theme) { foreach ($key in @($t.Keys)) { if ($theme.$key) { $t[$key] = [string]$theme.$key } } }
+  $key = ($t.GetEnumerator() | Sort-Object Name | ForEach-Object { $_.Value }) -join ","
+  if ($key -eq $script:popupThemeKey) { return }
+  $script:popupThemeKey = $key
+
+  $c = @{}
+  foreach ($name in $t.Keys) { $c[$name] = [System.Drawing.ColorTranslator]::FromHtml($t[$name]) }
+  $popup.BackColor = $c.surface
+  foreach ($label in @($popupTitle, $popupTodayTokens, $popupTodayCost, $popupWeek, $popupAll)) { $label.ForeColor = $c.text }
+  foreach ($label in @($popupTodayCaption, $popupWeekCaption, $popupAllCaption, $popupUpdated)) { $label.ForeColor = $c.text3 }
+  $popupLevel.ForeColor = $c.gold
+  $popupRule.BackColor = $c.border
+  $popupOpen.LinkColor = $c.accent
+  $popupOpen.ActiveLinkColor = $c.text
+  $popupOpen.VisitedLinkColor = $c.accent
+  Set-PopupChrome $c.border
+}
+
+# Windows 11 draws rounded corners and a hairline border in the theme color; older
+# versions ignore both attributes and keep a square window.
+function Set-PopupChrome([System.Drawing.Color]$border) {
+  try {
+    $round = 2
+    [TokenLarper.Dwm]::DwmSetWindowAttribute($popup.Handle, 33, [ref]$round, 4) | Out-Null
+    $colorRef = [int]$border.R -bor ([int]$border.G -shl 8) -bor ([int]$border.B -shl 16)
+    [TokenLarper.Dwm]::DwmSetWindowAttribute($popup.Handle, 34, [ref]$colorRef, 4) | Out-Null
+  } catch {}
+}
+Set-PopupTheme $null
+
+function Open-Dashboard {
+  $popup.Hide()
+  try {
+    Start-Process -FilePath $BaseUrl -ErrorAction Stop
+  } catch {
+    $notifyIcon.ShowBalloonTip(4000, "Token Larper", "Could not open the browser. Visit $BaseUrl manually.", [System.Windows.Forms.ToolTipIcon]::Warning)
+  }
+}
+
+$popupOpen.Add_LinkClicked({ Open-Dashboard })
+$popup.Add_KeyDown({
+  param($sender, $eventArgs)
+  if ($eventArgs.KeyCode -eq [System.Windows.Forms.Keys]::Escape) {
+    $popup.Hide()
+    $eventArgs.Handled = $true
+  } elseif ($eventArgs.KeyCode -eq [System.Windows.Forms.Keys]::Enter) {
+    Open-Dashboard
+    $eventArgs.Handled = $true
+  }
+})
+$script:lastPopupDismissedAt = -1000
+$popup.Add_Deactivate({
+  if ($popup.Visible) {
+    $popup.Hide()
+    $script:lastPopupDismissedAt = [Environment]::TickCount
+  }
+})
+
+function Show-StatusPopup {
+  # Refresh first so the numbers and colors are current when it appears.
+  Update-TrayStatus
+  $cursor = [System.Windows.Forms.Cursor]::Position
+  $area = [System.Windows.Forms.Screen]::FromPoint($cursor).WorkingArea
+  $x = [Math]::Max($area.Left + 8, [Math]::Min($cursor.X - $popup.Width + 24, $area.Right - $popup.Width - 8))
+  if ($cursor.Y -ge $area.Bottom) {
+    $y = $area.Bottom - $popup.Height - 8
+  } elseif ($cursor.Y -lt $area.Top) {
+    $y = $area.Top + 8
+  } else {
+    $y = [Math]::Max($area.Top + 8, [Math]::Min($cursor.Y - $popup.Height - 12, $area.Bottom - $popup.Height - 8))
+  }
+  $popup.Location = New-Object System.Drawing.Point($x, $y)
+  $popup.Show()
+  $popup.Activate() | Out-Null
+  $popupOpen.Focus() | Out-Null
+}
+
 # Context Menu
 $menu = New-Object System.Windows.Forms.ContextMenuStrip
 
@@ -85,9 +231,7 @@ $menu.Items.Add((New-Object System.Windows.Forms.ToolStripSeparator)) | Out-Null
 
 $itemOpen = New-Object System.Windows.Forms.ToolStripMenuItem("Open Dashboard (http://localhost:$ServerPort)")
 $itemOpen.Font = New-Object System.Drawing.Font($itemOpen.Font, [System.Drawing.FontStyle]::Bold)
-$itemOpen.Add_Click({
-  Start-Process "$BaseUrl"
-})
+$itemOpen.Add_Click({ Open-Dashboard })
 $menu.Items.Add($itemOpen) | Out-Null
 
 $itemSync = New-Object System.Windows.Forms.ToolStripMenuItem("Sync Harnesses Now (ccusage)")
@@ -136,6 +280,8 @@ $menu.Items.Add((New-Object System.Windows.Forms.ToolStripSeparator)) | Out-Null
 $itemQuit = New-Object System.Windows.Forms.ToolStripMenuItem("Quit Token Larper")
 $itemQuit.Add_Click({
   $notifyIcon.Visible = $false
+  $popup.Close()
+  $popup.Dispose()
   try {
     Invoke-RestMethod -Uri "$BaseUrl/api/shutdown" -Method Post -ContentType "application/json" -TimeoutSec 3 | Out-Null
   } catch {}
@@ -149,9 +295,18 @@ $menu.Items.Add($itemQuit) | Out-Null
 
 $notifyIcon.ContextMenuStrip = $menu
 
-# Double-click tray icon opens dashboard
-$notifyIcon.Add_DoubleClick({
-  Start-Process "$BaseUrl"
+# Left-click toggles the status popup; right-click keeps the context menu.
+$notifyIcon.Add_MouseClick({
+  param($sender, $eventArgs)
+  if ($eventArgs.Button -eq [System.Windows.Forms.MouseButtons]::Left) {
+    if ($popup.Visible) {
+      $popup.Hide()
+    } elseif ([Environment]::TickCount - $script:lastPopupDismissedAt -gt 250) {
+      Show-StatusPopup
+    }
+  } elseif ($eventArgs.Button -eq [System.Windows.Forms.MouseButtons]::Right) {
+    $popup.Hide()
+  }
 })
 
 function Update-TrayStatus {
@@ -164,10 +319,24 @@ function Update-TrayStatus {
         $tooltip = $tooltip.Substring(0, 63)
       }
       $notifyIcon.Text = $tooltip
+      $popupLevel.Text = $st.levelText
+      $popupTodayCaption.Text = $st.todayCaptionText
+      $popupTodayTokens.Text = $st.todayTokensText
+      $popupTodayCost.Text = $st.todayCostText
+      $popupWeek.Text = $st.weekText
+      $popupAll.Text = $st.allTimeText
+      $popupUpdated.Text = $st.updatedText
+      Set-PopupTheme $st.theme
       $itemBoot.Checked = [bool]$st.bootEnabled
       $itemOpenOnBoot.Checked = [bool]$st.openBrowserOnBoot
     }
-  } catch {}
+  } catch {
+    $popupTodayTokens.Text = "Unavailable"
+    $popupTodayCost.Text = ""
+    $popupWeek.Text = "--"
+    $popupAll.Text = "--"
+    $popupUpdated.Text = ""
+  }
 }
 
 # Timer to check parent Bun server health & update stats
@@ -178,11 +347,20 @@ $timer.Add_Tick({
   $proc = Get-Process -Id $ServerPid -ErrorAction SilentlyContinue
   if ($null -eq $proc) {
     $notifyIcon.Visible = $false
+    $popup.Close()
+    $popup.Dispose()
     $notifyIcon.Dispose()
     [System.Windows.Forms.Application]::Exit()
     return
   }
   $script:tickCount++
+  $nowLight = Test-LightTaskbar
+  if ($nowLight -ne $script:lightTaskbar) {
+    $script:lightTaskbar = $nowLight
+    $oldIcon = $notifyIcon.Icon
+    $notifyIcon.Icon = New-LogoIcon $nowLight
+    [TokenLarper.IconNative]::DestroyIcon($oldIcon.Handle) | Out-Null
+  }
   if ($script:tickCount -eq 1 -or ($script:tickCount % 3 -eq 0)) {
     Update-TrayStatus
   }
@@ -190,7 +368,7 @@ $timer.Add_Tick({
 $timer.Start()
 
 Update-TrayStatus
-$notifyIcon.ShowBalloonTip(2500, "Token Larper Running", "Right-click or double-click the green t. icon in your system tray.", [System.Windows.Forms.ToolTipIcon]::Info)
+$notifyIcon.ShowBalloonTip(2500, "Token Larper Running", "Left-click the t. icon for usage; right-click for options.", [System.Windows.Forms.ToolTipIcon]::Info)
 
 [System.Windows.Forms.Application]::Run()
 `.trim();

package/src/trayStatus.ts

@@ -0,0 +1,91 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import type { DashboardPayload, StartupConfig } from "./types.ts";
+import { dataPath } from "./paths.ts";
+import { rankFor } from "./client/lib/rank.ts";
+import { formatCurrency, localDateKey } from "./client/utils.ts";
+
+// Everything the tray shows is formatted here, so the PowerShell script only places
+// strings and never needs non-ASCII literals of its own.
+
+const THEME_FILE = dataPath("ui-theme.json");
+const THEME_KEYS = ["surface", "text", "text2", "text3", "border", "accent", "accentInk", "gold"] as const;
+
+export type TrayTheme = Record<(typeof THEME_KEYS)[number], string> & { mode: "light" | "dark" };
+
+let theme: TrayTheme | null = loadTheme();
+
+function loadTheme(): TrayTheme | null {
+  try {
+    return existsSync(THEME_FILE) ? parseTheme(JSON.parse(readFileSync(THEME_FILE, "utf8"))) : null;
+  } catch {
+    return null;
+  }
+}
+
+/** Accept only #rrggbb colors; the dashboard resolves every theme color to hex before sending. */
+export function parseTheme(value: unknown): TrayTheme | null {
+  if (!value || typeof value !== "object") return null;
+  const source = value as Record<string, unknown>;
+  const out: Partial<TrayTheme> = { mode: source.mode === "light" ? "light" : "dark" };
+  for (const key of THEME_KEYS) {
+    const color = source[key];
+    if (typeof color !== "string" || !/^#[0-9a-f]{6}$/i.test(color)) return null;
+    out[key] = color.toLowerCase();
+  }
+  return out as TrayTheme;
+}
+
+export function saveTheme(next: TrayTheme): void {
+  theme = next;
+  try {
+    mkdirSync(dirname(THEME_FILE), { recursive: true });
+    writeFileSync(THEME_FILE, JSON.stringify(next), "utf8");
+  } catch {
+    // The theme still applies for this session.
+  }
+}
+
+const compact = (n: number) =>
+  new Intl.NumberFormat("en-US", { notation: "compact", maximumSignificantDigits: 3 }).format(n);
+
+export function buildTrayStatus(data: DashboardPayload, startup: StartupConfig) {
+  const today = localDateKey(new Date());
+  const weekStart = new Date();
+  weekStart.setDate(weekStart.getDate() - 6);
+  const since = localDateKey(weekStart);
+
+  const todayRow = data.daily.find((d) => d.period === today);
+  const week = data.daily.filter((d) => d.period >= since && d.period <= today);
+  const weekTokens = week.reduce((acc, d) => acc + d.totalTokens, 0);
+  const weekCost = week.reduce((acc, d) => acc + d.verifiedCost, 0);
+  const rank = rankFor(data.totals.totalTokens);
+
+  const todayTokens = todayRow?.totalTokens ?? 0;
+  const todayCost = todayRow?.verifiedCost ?? 0;
+  const allTime = `${compact(data.totals.totalTokens)} · ${formatCurrency(data.totals.verifiedCost, 0)}`;
+  const syncing = data.syncingHarnesses.length > 0;
+  const updated = new Date(data.generatedAt).toLocaleTimeString("en-US", { hour: "numeric", minute: "2-digit" });
+
+  return {
+    // Popup
+    todayTokensText: todayTokens > 0 ? compact(todayTokens) : "0",
+    todayCaptionText: todayTokens > 0 ? "Today" : "Today · no usage yet",
+    todayCostText: formatCurrency(todayCost),
+    weekText: `${compact(weekTokens)} · ${formatCurrency(weekCost)}`,
+    allTimeText: allTime,
+    levelText: `Lv ${rank.tier.level}`,
+    levelTitle: rank.tier.title,
+    updatedText: syncing ? "Syncing…" : `Updated ${updated}`,
+    theme,
+    // Menu and tooltip
+    summaryText: `Today ${compact(todayTokens)} · ${formatCurrency(todayCost)}   All time ${allTime}`,
+    shortTooltip: `today ${compact(todayTokens)} · ${formatCurrency(todayCost)}`,
+    // Older tray scripts read these; keep them until every running tray has restarted.
+    totalTokensText: compact(data.totals.totalTokens),
+    verifiedCostText: formatCurrency(data.totals.verifiedCost),
+    estimatedCostText: formatCurrency(data.totals.estimatedCost),
+    bootEnabled: startup.enabled,
+    openBrowserOnBoot: startup.openBrowserOnBoot,
+  };
+}

package/src/types.ts

@@ -153,3 +153,13 @@ export interface StartupConfig {
   registryValue: string | null;
   launcherPath: string;
 }
+
+export interface UpdateStatus {
+  current: string;
+  latest: string | null;
+  updateAvailable: boolean;
+  checkedAt: string | null;
+  /** "npm" can update itself; "source" is a git checkout and updates with git pull. */
+  source: "npm" | "source";
+  error?: string;
+}

package/src/updates.ts

@@ -0,0 +1,62 @@
+import { spawn } from "node:child_process";
+import { APP_VERSION, RUNNING_FROM_SOURCE } from "./paths.ts";
+import { compareVersions } from "./semver.ts";
+import type { UpdateStatus } from "./types.ts";
+
+export { compareVersions };
+
+// Token Larper's own update check. It runs only when the dashboard asks (on open, if
+// automatic checks are on, or from Settings) and sends nothing but the package name.
+
+const PACKAGE = "token-larper";
+const REGISTRY_URL = `https://registry.npmjs.org/${PACKAGE}/latest`;
+const RECHECK_MS = 6 * 60 * 60 * 1000;
+
+let lastCheck: { latest: string; at: number } | null = null;
+let inFlight: Promise<void> | null = null;
+
+async function fetchLatest(): Promise<void> {
+  const res = await fetch(REGISTRY_URL, { signal: AbortSignal.timeout(5000), headers: { Accept: "application/json" } });
+  if (!res.ok) throw new Error(`npm registry responded ${res.status}`);
+  const body = (await res.json()) as { version?: unknown };
+  if (typeof body.version !== "string") throw new Error("npm registry response had no version");
+  lastCheck = { latest: body.version, at: Date.now() };
+}
+
+export function localStatus(): UpdateStatus {
+  const latest = lastCheck?.latest ?? null;
+  return {
+    current: APP_VERSION,
+    latest,
+    updateAvailable: latest !== null && compareVersions(latest, APP_VERSION) > 0,
+    checkedAt: lastCheck ? new Date(lastCheck.at).toISOString() : null,
+    source: RUNNING_FROM_SOURCE ? "source" : "npm",
+  };
+}
+
+/** Check npm (at most every few hours unless forced) and report. */
+export async function checkForUpdates(force = false): Promise<UpdateStatus> {
+  if (force || !lastCheck || Date.now() - lastCheck.at > RECHECK_MS) {
+    inFlight ??= fetchLatest().finally(() => (inFlight = null));
+    try {
+      await inFlight;
+    } catch (error) {
+      return { ...localStatus(), error: error instanceof Error ? error.message : "Could not reach npm" };
+    }
+  }
+  return localStatus();
+}
+
+/**
+ * Start the latest version in the background. The new copy sees this server running
+ * an older version, asks it to shut down, and takes over the same port (bin/cli.js).
+ */
+export function startUpdate(port: number): void {
+  const child = spawn(process.execPath, ["x", `${PACKAGE}@latest`], {
+    detached: true,
+    stdio: "ignore",
+    windowsHide: true,
+    env: { ...process.env, PORT: String(port), TOKEN_LARPER_NO_BROWSER: "1" },
+  });
+  child.unref();
+}

package/src/client/logo.svg

@@ -1,8 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" role="img" aria-labelledby="title">
-  <title id="title">Token Larper</title>
-  <!-- The tray icon in src/tray.ts draws this same geometry; keep the two in sync. -->
-  <rect x="3" y="3" width="58" height="58" rx="14" fill="#2f5a43"/>
-  <path d="M20 12h8v31.5c0 1.7.8 2.5 2.5 2.5H35v7h-6.5C22.8 53 20 50.2 20 44.5z" fill="#f3e3bf"/>
-  <rect x="13" y="21" width="22" height="7" fill="#f3e3bf"/>
-  <circle cx="45" cy="47.5" r="5.5" fill="#e1b75c"/>
-</svg>