opencode-system-metrics-tui 0.1.3 → 0.1.5

package/README.md

@@ -1,5 +1,22 @@
 # OpenCode System Metrics TUI
 
+## Install globally in OpenCode
+
+```powershell
+opencode plugin -g opencode-system-metrics-tui@0.1.4 --force
+```
+
+This is the primary installation path. The version must match `package.json`; `--force` asks OpenCode to refresh its package cache. Verify the actual installed artifact afterward:
+
+```powershell
+npm run install-plugin
+npm run verify-installation
+```
+
+`npm run install-plugin` runs the same global OpenCode installer command with the current `package.json` version. The explicit command above is provided for users installing without this checkout.
+
+Restart OpenCode after installation. This installs the plugin globally for all projects. The OpenCode cache directory name, including `@latest`, is only a package-specifier label and does not prove the package version. Verification reads the nested package's own `package.json` and checks `dist/tui.js`; it reports stale entries without deleting anything.
+
 OpenCode TUI plugin that adds live CPU, RAM, GPU, GPU VRAM, temperature, and network metrics to the `sidebar_content` slot.
 
 The README is available in **Español**, **English**, and **Português**.
@@ -23,6 +40,8 @@ The README is available in **Español**, **English**, and **Português**.
 - En Windows, la temperatura de CPU requiere LibreHardwareMonitor ejecutándose como administrador con **Remote Web Server** activo en `http://127.0.0.1:8085`.
 - En Windows, la velocidad de red usa PowerShell y `Get-NetAdapterStatistics`; no agrega una dependencia npm.
 - Las lecturas opcionales de Windows se hacen bajo demanda, con timeout y caché; no hay timers globales de PowerShell.
+- La detección de Nerd Font en Linux/macOS está limitada a rutas conocidas, 2 niveles de profundidad y 256 entradas por directorio; una ruta ausente o inaccesible usa Unicode. Windows no escanea fuentes salvo con `OPENCODE_MONITOR_NERD_FONT=1`.
+- Si una fuente de métricas no responde a tiempo, su intento en caché se abandona de forma segura para permitir reintentos sin cancelar APIs que no aceptan `AbortSignal`.
 
 ### Requisitos
 
@@ -72,7 +91,7 @@ npm publish --access public
 En otro equipo:
 
 ```bash
-opencode plugin opencode-system-metrics-tui
+opencode plugin opencode-system-metrics-tui@0.1.4
 ```
 
 El paquete exporta tanto la raíz (`opencode-system-metrics-tui`) como `./tui`; ambas rutas cargan el mismo bundle TUI.
@@ -82,12 +101,14 @@ El instalador de OpenCode configura el plugin TUI automáticamente. Reinicia Ope
 Publicar en npm e instalar en OpenCode son pasos distintos:
 
 - `npm publish --access public` publica el paquete en npm.
-- `opencode plugin opencode-system-metrics-tui` lo instala solo en el proyecto actual.
-- `opencode plugin -g opencode-system-metrics-tui` lo instala globalmente para todos los proyectos.
+- `opencode plugin opencode-system-metrics-tui@0.1.4` lo instala solo en el proyecto actual.
+- `opencode plugin -g opencode-system-metrics-tui@0.1.4 --force` lo instala globalmente para todos los proyectos.
 
 ### Verificación
 
 ```bash
+npm run install-plugin
+npm run verify-installation
 npm test
 npm run typecheck
 npm run build
@@ -112,6 +133,8 @@ npm run build
 - On Windows, CPU temperature requires LibreHardwareMonitor running as administrator with **Remote Web Server** enabled at `http://127.0.0.1:8085`.
 - On Windows, network speed uses PowerShell and `Get-NetAdapterStatistics`; it adds no npm dependency.
 - Optional Windows reads are on demand, timeout-bounded, and cached; no global PowerShell timers are used.
+- Linux/macOS Nerd Font detection is limited to known paths, two directory levels, and 256 entries per directory; missing or inaccessible paths safely fall back to Unicode. Windows does not scan fonts unless `OPENCODE_MONITOR_NERD_FONT=1` is set.
+- When a metric source does not respond in time, its cache attempt is safely abandoned so retries remain possible without cancelling APIs that do not accept `AbortSignal`.
 
 ### Requirements
 
@@ -161,7 +184,7 @@ npm publish --access public
 On another machine:
 
 ```bash
-opencode plugin opencode-system-metrics-tui
+opencode plugin opencode-system-metrics-tui@0.1.4
 ```
 
 The package exports both the root (`opencode-system-metrics-tui`) and `./tui`; both paths load the same TUI bundle.
@@ -171,12 +194,14 @@ The OpenCode installer configures the TUI plugin automatically. Restart OpenCode
 Publishing to npm and installing in OpenCode are separate steps:
 
 - `npm publish --access public` publishes the package to npm.
-- `opencode plugin opencode-system-metrics-tui` installs it for the current project only.
-- `opencode plugin -g opencode-system-metrics-tui` installs it globally for all projects.
+- `opencode plugin opencode-system-metrics-tui@0.1.4` installs it for the current project only.
+- `opencode plugin -g opencode-system-metrics-tui@0.1.4 --force` installs it globally for all projects.
 
 ### Verification
 
 ```bash
+npm run install-plugin
+npm run verify-installation
 npm test
 npm run typecheck
 npm run build
@@ -201,6 +226,8 @@ npm run build
 - No Windows, a temperatura da CPU requer o LibreHardwareMonitor executado como administrador com o **Remote Web Server** ativo em `http://127.0.0.1:8085`.
 - No Windows, a velocidade da rede usa o PowerShell e `Get-NetAdapterStatistics`; nenhuma dependência npm é adicionada.
 - As leituras opcionais do Windows são sob demanda, têm timeout e cache; não há timers globais do PowerShell.
+- A detecção de Nerd Font no Linux/macOS é limitada a caminhos conhecidos, dois níveis de profundidade e 256 entradas por diretório; caminhos ausentes ou inacessíveis usam Unicode. O Windows não verifica fontes sem `OPENCODE_MONITOR_NERD_FONT=1`.
+- Quando uma fonte de métricas não responde a tempo, a tentativa em cache é abandonada com segurança para permitir novas tentativas sem cancelar APIs que não aceitam `AbortSignal`.
 
 ### Requisitos
 
@@ -250,7 +277,7 @@ npm publish --access public
 Em outro computador:
 
 ```bash
-opencode plugin opencode-system-metrics-tui
+opencode plugin opencode-system-metrics-tui@0.1.4
 ```
 
 O pacote exporta tanto a raiz (`opencode-system-metrics-tui`) quanto `./tui`; os dois caminhos carregam o mesmo bundle TUI.
@@ -260,8 +287,8 @@ O instalador do OpenCode configura o plugin TUI automaticamente. Reinicie o Open
 Publicar no npm e instalar no OpenCode são etapas diferentes:
 
 - `npm publish --access public` publica o pacote no npm.
-- `opencode plugin opencode-system-metrics-tui` instala o plugin apenas no projeto atual.
-- `opencode plugin -g opencode-system-metrics-tui` instala o plugin globalmente para todos os projetos.
+- `opencode plugin opencode-system-metrics-tui@0.1.4` instala o plugin apenas no projeto atual.
+- `opencode plugin -g opencode-system-metrics-tui@0.1.4 --force` instala o plugin globalmente para todos os projetos.
 
 ### Verificação
 

package/dist/install-hack-font.js

@@ -10,6 +10,8 @@ import { existsSync, readdirSync } from "node:fs";
 import { homedir } from "node:os";
 import { join as posixJoin, win32 } from "node:path";
 var NERD_FONT_FILE_PATTERN = /NerdFont[A-Za-z0-9-]*[-_][A-Za-z0-9-]+\.(?:ttf|otf)$/i;
+var MAX_FONT_SCAN_DEPTH = 2;
+var MAX_FONT_SCAN_ENTRIES = 256;
 function getFontDirectories(platform, home = homedir(), env = process.env) {
   if (platform === "darwin")
     return [posixJoin(home, "Library", "Fonts"), "/Library/Fonts", "/System/Library/Fonts"];
@@ -25,19 +27,23 @@ function isNerdFontFile(fileName) {
 }
 var isHackNerdFontFile = isNerdFontFile;
 function hasNerdFont(platform = process.platform, home = homedir(), env = process.env) {
-  const containsFont = (directory) => {
+  if (platform === "win32" && env.OPENCODE_MONITOR_NERD_FONT !== "1")
+    return false;
+  const containsFont = (directory, depth) => {
+    if (depth > MAX_FONT_SCAN_DEPTH)
+      return false;
     if (!existsSync(directory))
       return false;
     try {
-      return readdirSync(directory, { withFileTypes: true }).some((entry) => {
+      return readdirSync(directory, { withFileTypes: true }).slice(0, MAX_FONT_SCAN_ENTRIES).some((entry) => {
         const path = platform === "win32" ? win32.join(directory, entry.name) : posixJoin(directory, entry.name);
-        return entry.isFile() ? isNerdFontFile(entry.name) : entry.isDirectory() && containsFont(path);
+        return entry.isFile() ? isNerdFontFile(entry.name) : entry.isDirectory() && containsFont(path, depth + 1);
       });
     } catch {
       return false;
     }
   };
-  return getFontDirectories(platform, home, env).some(containsFont);
+  return getFontDirectories(platform, home, env).some((directory) => containsFont(directory, 0));
 }
 var hasHackNerdFont = hasNerdFont;
 var nerdFontIcons = {

package/dist/tui.js

@@ -52,22 +52,31 @@ async function readLibreHardwareMonitorTemperature() {
   if (!response.ok)
     return;
   const root = await response.json();
+  if (root === null || typeof root !== "object")
+    return;
   const sensors = [];
   const visit = (node) => {
     if (node.Type === "Temperature" && node.Text !== undefined)
       sensors.push(node);
-    for (const child of node.Children ?? [])
-      visit(child);
+    for (const child of Array.isArray(node.Children) ? node.Children : []) {
+      if (child !== null && typeof child === "object")
+        visit(child);
+    }
   };
   visit(root);
   const cpuSensor = sensors.find((sensor) => sensor.Text === "CPU Package") ?? sensors.find((sensor) => sensor.Text === "Core Average") ?? sensors.find((sensor) => sensor.Text === "Core Max");
   return parseMonitorTemperature(cpuSensor?.Value);
 }
 function parseWindowsNetworkOutput(stdout) {
-  const parsed = JSON.parse(stdout.trim());
-  const rows = Array.isArray(parsed) ? parsed : [parsed];
+  let parsed;
+  try {
+    parsed = JSON.parse(stdout.trim());
+  } catch {
+    return [];
+  }
+  const rows = (Array.isArray(parsed) ? parsed : [parsed]).filter((item) => item !== null && typeof item === "object");
   return rows.map((item) => ({
-    iface: item.Name,
+    iface: typeof item.Name === "string" ? item.Name : undefined,
     rx_bytes: finite(item.ReceivedBytes) ?? 0,
     tx_bytes: finite(item.SentBytes) ?? 0
   }));
@@ -126,14 +135,15 @@ function selectGpuMetrics(graphics) {
     gpuMemoryTotalBytes: null,
     gpuMemoryPercent: null
   };
-  if (graphics === undefined)
+  if (graphics === undefined || graphics === null || !Array.isArray(graphics.controllers))
     return empty;
   const controller = graphics.controllers.map((item) => {
-    const utilization = finite(item.utilizationGpu);
-    const temperature = finite(item.temperatureGpu);
-    const memoryTotal = finite(item.memoryTotal);
-    const memoryFree = finite(item.memoryFree);
-    const memoryUsed = finite(item.memoryUsed) ?? (memoryTotal !== null && memoryFree !== null ? Math.max(0, memoryTotal - memoryFree) : null);
+    const source = item ?? {};
+    const utilization = finite(source.utilizationGpu);
+    const temperature = finite(source.temperatureGpu);
+    const memoryTotal = finite(source.memoryTotal);
+    const memoryFree = finite(source.memoryFree);
+    const memoryUsed = finite(source.memoryUsed) ?? (memoryTotal !== null && memoryFree !== null ? Math.max(0, memoryTotal - memoryFree) : null);
     const hasMemory = memoryUsed !== null && memoryTotal !== null && memoryTotal > 0;
     return { utilization, temperature, memoryUsed, memoryTotal, hasMemory };
   }).filter(({ utilization, temperature, hasMemory }) => utilization !== null || temperature !== null || hasMemory).sort((left, right) => {
@@ -156,7 +166,7 @@ function selectGpuMetrics(graphics) {
   }
   return result;
 }
-function readCachedMetric(state, reader, cacheMs = SLOW_METRIC_CACHE_MS, now = Date.now(), unavailableCacheMs = cacheMs) {
+function readCachedMetric(state, reader, cacheMs = SLOW_METRIC_CACHE_MS, now = Date.now(), unavailableCacheMs = cacheMs, timeoutMs) {
   if (state.inFlight !== undefined)
     return state.inFlight;
   if (state.lastFailureAt !== undefined && now - state.lastFailureAt < unavailableCacheMs) {
@@ -165,17 +175,23 @@ function readCachedMetric(state, reader, cacheMs = SLOW_METRIC_CACHE_MS, now = D
   if (now - state.lastAttemptAt < cacheMs)
     return Promise.resolve(state.value);
   state.lastAttemptAt = now;
-  state.inFlight = reader().then((value) => {
-    state.value = value;
-    state.lastFailureAt = undefined;
-    return value;
-  }).catch(() => {
-    state.lastFailureAt = now;
-    return state.value;
-  }).finally(() => {
-    state.inFlight = undefined;
-  });
-  return state.inFlight;
+  let flight;
+  flight = (async () => {
+    try {
+      const value = timeoutMs === undefined ? await reader() : await withTimeout(reader(), timeoutMs);
+      state.value = value;
+      state.lastFailureAt = undefined;
+      return value;
+    } catch {
+      state.lastFailureAt = now;
+      return state.value;
+    } finally {
+      if (state.inFlight === flight)
+        state.inFlight = undefined;
+    }
+  })();
+  state.inFlight = flight;
+  return flight;
 }
 var cachedCpuTemperature = {
   value: undefined,
@@ -238,9 +254,9 @@ async function readMetrics() {
     withTimeout(si.mem(), 1500)
   ]);
   const [temperature, graphics, network] = await Promise.allSettled([
-    withTimeout(readCachedMetric(cachedCpuTemperature, isWindows ? readWindowsCpuTemperature : () => si.cpuTemperature(), TEMPERATURE_CACHE_MS), 2500),
-    withTimeout(readCachedMetric(cachedGraphics, () => si.graphics(), SLOW_METRIC_CACHE_MS), 2500),
-    withTimeout(readCachedMetric(cachedNetwork, isWindows ? readWindowsNetworkMetrics : () => si.networkStats("*"), isWindows ? NETWORK_CACHE_MS : 2000, Date.now(), OPTIONAL_SOURCE_BACKOFF_MS), 1500)
+    readCachedMetric(cachedCpuTemperature, isWindows ? readWindowsCpuTemperature : () => si.cpuTemperature(), TEMPERATURE_CACHE_MS, Date.now(), TEMPERATURE_CACHE_MS, 2500),
+    readCachedMetric(cachedGraphics, () => si.graphics(), SLOW_METRIC_CACHE_MS, Date.now(), SLOW_METRIC_CACHE_MS, 2500),
+    readCachedMetric(cachedNetwork, isWindows ? readWindowsNetworkMetrics : () => si.networkStats("*"), isWindows ? NETWORK_CACHE_MS : 2000, Date.now(), OPTIONAL_SOURCE_BACKOFF_MS, 1500)
   ]);
   const cpuPercent = load.status === "fulfilled" ? finite(load.value.currentLoad) : null;
   const memoryTotalBytes = memory.status === "fulfilled" ? finite(memory.value.total) : null;
@@ -251,7 +267,7 @@ async function readMetrics() {
   let downloadBytesPerSecond = null;
   let uploadBytesPerSecond = null;
   if (network.status === "fulfilled" && network.value !== undefined) {
-    const samples = network.value;
+    const samples = Array.isArray(network.value) ? network.value : [];
     const timestamp = Date.now();
     const rx = samples.reduce((total, item) => total + (finite(item.rx_bytes) ?? 0), 0);
     const tx = samples.reduce((total, item) => total + (finite(item.tx_bytes) ?? 0), 0);
@@ -290,6 +306,8 @@ import { existsSync, readdirSync } from "node:fs";
 import { homedir } from "node:os";
 import { join as posixJoin, win32 } from "node:path";
 var NERD_FONT_FILE_PATTERN = /NerdFont[A-Za-z0-9-]*[-_][A-Za-z0-9-]+\.(?:ttf|otf)$/i;
+var MAX_FONT_SCAN_DEPTH = 2;
+var MAX_FONT_SCAN_ENTRIES = 256;
 function getFontDirectories(platform, home = homedir(), env = process.env) {
   if (platform === "darwin")
     return [posixJoin(home, "Library", "Fonts"), "/Library/Fonts", "/System/Library/Fonts"];
@@ -305,19 +323,23 @@ function isNerdFontFile(fileName) {
 }
 var isHackNerdFontFile = isNerdFontFile;
 function hasNerdFont(platform = process.platform, home = homedir(), env = process.env) {
-  const containsFont = (directory) => {
+  if (platform === "win32" && env.OPENCODE_MONITOR_NERD_FONT !== "1")
+    return false;
+  const containsFont = (directory, depth) => {
+    if (depth > MAX_FONT_SCAN_DEPTH)
+      return false;
     if (!existsSync(directory))
       return false;
     try {
-      return readdirSync(directory, { withFileTypes: true }).some((entry) => {
+      return readdirSync(directory, { withFileTypes: true }).slice(0, MAX_FONT_SCAN_ENTRIES).some((entry) => {
         const path = platform === "win32" ? win32.join(directory, entry.name) : posixJoin(directory, entry.name);
-        return entry.isFile() ? isNerdFontFile(entry.name) : entry.isDirectory() && containsFont(path);
+        return entry.isFile() ? isNerdFontFile(entry.name) : entry.isDirectory() && containsFont(path, depth + 1);
       });
     } catch {
       return false;
     }
   };
-  return getFontDirectories(platform, home, env).some(containsFont);
+  return getFontDirectories(platform, home, env).some((directory) => containsFont(directory, 0));
 }
 var hasHackNerdFont = hasNerdFont;
 var nerdFontIcons = {
@@ -341,7 +363,8 @@ function shouldUseNerdFont(platform, detected, env = process.env) {
 
 // src/tui.tsx
 var REFRESH_INTERVAL_MS = 2000;
-var icons = getMetricIcons(shouldUseNerdFont(process.platform, hasNerdFont()));
+var platform = process.platform;
+var icons = getMetricIcons(shouldUseNerdFont(platform, platform === "win32" ? false : hasNerdFont()));
 var initialMetrics = {
   cpuPercent: null,
   memoryUsedBytes: null,
@@ -356,33 +379,43 @@ var initialMetrics = {
   downloadBytesPerSecond: null,
   uploadBytesPerSecond: null
 };
-var [sharedMetrics, setSharedMetrics] = createSignal(initialMetrics);
-var metricsTimer;
-var metricsConsumers = 0;
-var refreshing = false;
+var METRICS_STATE_KEY = Symbol.for("opencode-monitor.system-metrics");
+var globalMetrics = globalThis;
+var metricsState = globalMetrics[METRICS_STATE_KEY] ?? (globalMetrics[METRICS_STATE_KEY] = {
+  ...(() => {
+    const [sharedMetrics, setSharedMetrics] = createSignal(initialMetrics);
+    return {
+      sharedMetrics,
+      setSharedMetrics
+    };
+  })(),
+  metricsTimer: undefined,
+  metricsConsumers: 0,
+  refreshing: false
+});
 var refreshMetrics = async () => {
-  if (refreshing)
+  if (metricsState.refreshing)
     return;
-  refreshing = true;
+  metricsState.refreshing = true;
   try {
-    setSharedMetrics(await readMetrics());
+    metricsState.setSharedMetrics(await readMetrics());
   } finally {
-    refreshing = false;
+    metricsState.refreshing = false;
   }
 };
 function startMetricsPolling() {
-  metricsConsumers += 1;
-  if (metricsConsumers !== 1)
+  metricsState.metricsConsumers += 1;
+  if (metricsState.metricsConsumers !== 1)
     return;
   refreshMetrics();
-  metricsTimer = setInterval(() => void refreshMetrics(), REFRESH_INTERVAL_MS);
+  metricsState.metricsTimer = setInterval(() => void refreshMetrics(), REFRESH_INTERVAL_MS);
 }
 function stopMetricsPolling() {
-  metricsConsumers = Math.max(0, metricsConsumers - 1);
-  if (metricsConsumers !== 0 || metricsTimer === undefined)
+  metricsState.metricsConsumers = Math.max(0, metricsState.metricsConsumers - 1);
+  if (metricsState.metricsConsumers !== 0 || metricsState.metricsTimer === undefined)
     return;
-  clearInterval(metricsTimer);
-  metricsTimer = undefined;
+  clearInterval(metricsState.metricsTimer);
+  metricsState.metricsTimer = undefined;
 }
 function systemMetricsTitle() {
   const locale = process.env.LC_ALL ?? process.env.LANGUAGE?.split(":")[0] ?? process.env.LANG ?? Intl.DateTimeFormat().resolvedOptions().locale;
@@ -420,9 +453,9 @@ function MetricsPanel(props) {
     _$insertNode(_el$6, _$createTextNode(` CPU `));
     _$insertNode(_el$8, _el$9);
     _$insertNode(_el$8, _el$0);
-    _$insert(_el$8, () => formatPercent(sharedMetrics().cpuPercent), _el$9);
+    _$insert(_el$8, () => formatPercent(metricsState.sharedMetrics().cpuPercent), _el$9);
     _$insert(_el$8, () => icons.thermometer, _el$0);
-    _$insert(_el$8, () => formatTemperature(sharedMetrics().cpuTemperatureCelsius), null);
+    _$insert(_el$8, () => formatTemperature(metricsState.sharedMetrics().cpuTemperatureCelsius), null);
     _$insertNode(_el$1, _el$10);
     _$insertNode(_el$1, _el$11);
     _$insertNode(_el$1, _el$13);
@@ -432,9 +465,9 @@ function MetricsPanel(props) {
     _$insertNode(_el$13, _el$14);
     _$insertNode(_el$13, _el$15);
     _$insertNode(_el$13, _el$16);
-    _$insert(_el$13, () => formatGiB(sharedMetrics().memoryUsedBytes), _el$14);
-    _$insert(_el$13, () => formatGiB(sharedMetrics().memoryTotalBytes), _el$15);
-    _$insert(_el$13, () => formatPercent(sharedMetrics().memoryPercent), _el$16);
+    _$insert(_el$13, () => formatGiB(metricsState.sharedMetrics().memoryUsedBytes), _el$14);
+    _$insert(_el$13, () => formatGiB(metricsState.sharedMetrics().memoryTotalBytes), _el$15);
+    _$insert(_el$13, () => formatPercent(metricsState.sharedMetrics().memoryPercent), _el$16);
     _$insertNode(_el$17, _el$18);
     _$insertNode(_el$17, _el$19);
     _$insertNode(_el$17, _el$21);
@@ -443,9 +476,9 @@ function MetricsPanel(props) {
     _$insertNode(_el$19, _$createTextNode(` GPU `));
     _$insertNode(_el$21, _el$22);
     _$insertNode(_el$21, _el$23);
-    _$insert(_el$21, () => formatPercent(sharedMetrics().gpuPercent), _el$22);
+    _$insert(_el$21, () => formatPercent(metricsState.sharedMetrics().gpuPercent), _el$22);
     _$insert(_el$21, () => icons.thermometer, _el$23);
-    _$insert(_el$21, () => formatTemperature(sharedMetrics().gpuTemperatureCelsius), null);
+    _$insert(_el$21, () => formatTemperature(metricsState.sharedMetrics().gpuTemperatureCelsius), null);
     _$insertNode(_el$24, _el$25);
     _$insertNode(_el$24, _el$26);
     _$insertNode(_el$24, _el$28);
@@ -455,9 +488,9 @@ function MetricsPanel(props) {
     _$insertNode(_el$28, _el$29);
     _$insertNode(_el$28, _el$30);
     _$insertNode(_el$28, _el$31);
-    _$insert(_el$28, () => formatGiB(sharedMetrics().gpuMemoryUsedBytes), _el$29);
-    _$insert(_el$28, () => formatGiB(sharedMetrics().gpuMemoryTotalBytes), _el$30);
-    _$insert(_el$28, () => formatPercent(sharedMetrics().gpuMemoryPercent), _el$31);
+    _$insert(_el$28, () => formatGiB(metricsState.sharedMetrics().gpuMemoryUsedBytes), _el$29);
+    _$insert(_el$28, () => formatGiB(metricsState.sharedMetrics().gpuMemoryTotalBytes), _el$30);
+    _$insert(_el$28, () => formatPercent(metricsState.sharedMetrics().gpuMemoryPercent), _el$31);
     _$insertNode(_el$32, _el$33);
     _$insertNode(_el$32, _el$34);
     _$insertNode(_el$32, _el$36);
@@ -466,8 +499,8 @@ function MetricsPanel(props) {
     _$insertNode(_el$34, _$createTextNode(` NET `));
     _$insertNode(_el$36, _el$37);
     _$insertNode(_el$36, _el$38);
-    _$insert(_el$36, () => formatRate(sharedMetrics().downloadBytesPerSecond), _el$38);
-    _$insert(_el$36, () => formatRate(sharedMetrics().uploadBytesPerSecond), null);
+    _$insert(_el$36, () => formatRate(metricsState.sharedMetrics().downloadBytesPerSecond), _el$38);
+    _$insert(_el$36, () => formatRate(metricsState.sharedMetrics().uploadBytesPerSecond), null);
     _$effect((_p$) => {
       var _v$ = props.theme.text, _v$2 = TextAttributes.BOLD, _v$3 = props.theme.success, _v$4 = props.theme.text, _v$5 = props.theme.textMuted, _v$6 = props.theme.success, _v$7 = props.theme.text, _v$8 = props.theme.textMuted, _v$9 = props.theme.success, _v$0 = props.theme.text, _v$1 = props.theme.textMuted, _v$10 = props.theme.success, _v$11 = props.theme.text, _v$12 = props.theme.textMuted, _v$13 = props.theme.success, _v$14 = props.theme.text, _v$15 = props.theme.textMuted;
       _v$ !== _p$.e && (_p$.e = _$setProp(_el$2, "fg", _v$, _p$.e));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-system-metrics-tui",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "OpenCode TUI sidebar plugin for live system metrics",
   "license": "MIT",
   "type": "module",
@@ -23,7 +23,9 @@
     "build": "bun scripts/build.ts && tsc --emitDeclarationOnly --declaration --outDir dist",
     "test": "tsx --test test/*.test.ts",
     "typecheck": "tsc --noEmit",
-    "install-font": "node dist/install-hack-font.js"
+    "install-font": "node dist/install-hack-font.js",
+    "verify-installation": "tsx scripts/plugin-installation.ts",
+    "install-plugin": "tsx scripts/install-plugin.ts"
   },
   "engines": {
     "node": ">=18"

package/scripts/install-plugin.ts

@@ -0,0 +1,30 @@
+import { execFile } from "node:child_process"
+import { readFile } from "node:fs/promises"
+import { promisify } from "node:util"
+import { formatVerificationResult, verifyPluginInstallation } from "./plugin-installation.js"
+
+const execFileAsync = promisify(execFile)
+const manifest = JSON.parse(await readFile(new URL("../package.json", import.meta.url), "utf8")) as {
+  name: string
+  version: string
+}
+const packageSpec = `${manifest.name}@${manifest.version}`
+
+console.log(`Installing ${packageSpec} globally through OpenCode`)
+try {
+  const result = await execFileAsync("opencode", ["plugin", "-g", packageSpec, "--force"], { windowsHide: true })
+  if (result.stdout.trim()) console.log(result.stdout.trim())
+  if (result.stderr.trim()) console.error(result.stderr.trim())
+} catch (error) {
+  const message = error instanceof Error ? error.message : String(error)
+  console.error(`OpenCode plugin installation failed: ${message}`)
+  process.exit(1)
+}
+
+const verification = await verifyPluginInstallation({
+  packageName: manifest.name,
+  expectedVersion: manifest.version,
+  cacheDirectory: process.env.OPENCODE_CACHE_DIR,
+})
+console.log(formatVerificationResult(verification))
+if (!verification.ok) process.exitCode = 1

package/scripts/plugin-installation.ts

@@ -0,0 +1,107 @@
+import { access, readFile, readdir } from "node:fs/promises"
+import { homedir } from "node:os"
+import { fileURLToPath } from "node:url"
+import { join, resolve } from "node:path"
+
+export type PluginVerificationOptions = {
+  cacheDirectory?: string
+  packageName: string
+  expectedVersion: string
+  distPath?: string
+}
+
+export type PluginVerification = {
+  ok: boolean
+  packagePath?: string
+  actualVersion?: string
+  staleEntries: string[]
+  errors: string[]
+}
+
+type PackageManifest = { name?: unknown; version?: unknown }
+
+export function getDefaultOpenCodeCacheDirectory(env: NodeJS.ProcessEnv = process.env, home = homedir()): string {
+  const cacheRoot = env.OPENCODE_CACHE_DIR ?? env.XDG_CACHE_HOME ?? join(home, ".cache")
+  return join(cacheRoot, "opencode", "packages")
+}
+
+async function readManifest(path: string): Promise<PackageManifest | undefined> {
+  try {
+    return JSON.parse(await readFile(path, "utf8")) as PackageManifest
+  } catch {
+    return undefined
+  }
+}
+
+async function exists(path: string): Promise<boolean> {
+  try {
+    await access(path)
+    return true
+  } catch {
+    return false
+  }
+}
+
+export async function verifyPluginInstallation(options: PluginVerificationOptions): Promise<PluginVerification> {
+  const cacheDirectory = resolve(options.cacheDirectory ?? getDefaultOpenCodeCacheDirectory())
+  const errors: string[] = []
+  const staleEntries: string[] = []
+  let packagePath: string | undefined
+  let actualVersion: string | undefined
+
+  let entries: string[]
+  try {
+    entries = (await readdir(cacheDirectory, { withFileTypes: true }))
+      .filter((entry) => entry.isDirectory() && entry.name.startsWith(`${options.packageName}@`))
+      .map((entry) => entry.name)
+  } catch {
+    return { ok: false, staleEntries, errors: [`OpenCode package cache not found: ${cacheDirectory}`] }
+  }
+
+  for (const entry of entries) {
+    const candidatePath = join(cacheDirectory, entry, "node_modules", options.packageName)
+    const manifest = await readManifest(join(candidatePath, "package.json"))
+    if (manifest?.name !== options.packageName || typeof manifest.version !== "string") {
+      staleEntries.push(join(cacheDirectory, entry))
+      continue
+    }
+    if (manifest.version === options.expectedVersion && packagePath === undefined) {
+      packagePath = candidatePath
+      actualVersion = manifest.version
+    } else if (manifest.version !== options.expectedVersion) {
+      staleEntries.push(join(cacheDirectory, entry))
+    }
+  }
+
+  if (packagePath === undefined) {
+    errors.push(`Installed ${options.packageName}@${options.expectedVersion} was not found in ${cacheDirectory}`)
+  } else if (actualVersion !== options.expectedVersion) {
+    errors.push(`Installed version is ${actualVersion ?? "unknown"}; expected ${options.expectedVersion}`)
+  }
+
+  if (packagePath !== undefined && !(await exists(join(packagePath, options.distPath ?? "dist", "tui.js")))) {
+    errors.push(`Required dist/tui.js is missing from ${packagePath}`)
+  }
+  if (staleEntries.length > 0) errors.push(`Stale OpenCode cache entries detected: ${staleEntries.join(", ")}`)
+
+  return { ok: errors.length === 0, packagePath, actualVersion, staleEntries, errors }
+}
+
+export function formatVerificationResult(result: PluginVerification): string {
+  if (result.ok) return `Verified OpenCode plugin ${result.actualVersion} at ${result.packagePath}`
+  return result.errors.join("\n")
+}
+
+if (process.argv[1] !== undefined && resolve(process.argv[1]) === resolve(fileURLToPath(import.meta.url))) {
+  const packageManifest = JSON.parse(await readFile(new URL("../package.json", import.meta.url), "utf8")) as {
+    name: string
+    version: string
+  }
+  const result = await verifyPluginInstallation({
+    packageName: packageManifest.name,
+    expectedVersion: packageManifest.version,
+    cacheDirectory: process.env.OPENCODE_CACHE_DIR,
+  })
+  console.log(formatVerificationResult(result))
+  if (!result.ok) process.exitCode = 1
+}