opencode-system-metrics-tui 0.1.6 → 0.1.7

package/README.md

@@ -3,10 +3,10 @@
 ## Install globally in OpenCode
 
 ```powershell
-opencode plugin -g opencode-system-metrics-tui@0.1.6 --force
+opencode plugin -g opencode-system-metrics-tui@0.1.7 --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:
+This is the primary installation path. The version must match `package.json`; `--force` asks OpenCode to refresh its package cache. The helper below skips OpenCode when the expected artifact is already current. Verify the actual installed artifact afterward:
 
 ```powershell
 npm run install-plugin
@@ -91,7 +91,7 @@ npm publish --access public
 En otro equipo:
 
 ```bash
-opencode plugin opencode-system-metrics-tui@0.1.6
+opencode plugin opencode-system-metrics-tui@0.1.7
 ```
 
 El paquete exporta tanto la raíz (`opencode-system-metrics-tui`) como `./tui`; ambas rutas cargan el mismo bundle TUI.
@@ -101,8 +101,8 @@ 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@0.1.6` lo instala solo en el proyecto actual.
-- `opencode plugin -g opencode-system-metrics-tui@0.1.6 --force` lo instala globalmente para todos los proyectos.
+- `opencode plugin opencode-system-metrics-tui@0.1.7` lo instala solo en el proyecto actual.
+- `opencode plugin -g opencode-system-metrics-tui@0.1.7 --force` lo instala globalmente para todos los proyectos.
 
 ### Verificación
 
@@ -184,7 +184,7 @@ npm publish --access public
 On another machine:
 
 ```bash
-opencode plugin opencode-system-metrics-tui@0.1.6
+opencode plugin opencode-system-metrics-tui@0.1.7
 ```
 
 The package exports both the root (`opencode-system-metrics-tui`) and `./tui`; both paths load the same TUI bundle.
@@ -194,8 +194,8 @@ 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@0.1.6` installs it for the current project only.
-- `opencode plugin -g opencode-system-metrics-tui@0.1.6 --force` installs it globally for all projects.
+- `opencode plugin opencode-system-metrics-tui@0.1.7` installs it for the current project only.
+- `opencode plugin -g opencode-system-metrics-tui@0.1.7 --force` installs it globally for all projects.
 
 ### Verification
 
@@ -277,7 +277,7 @@ npm publish --access public
 Em outro computador:
 
 ```bash
-opencode plugin opencode-system-metrics-tui@0.1.6
+opencode plugin opencode-system-metrics-tui@0.1.7
 ```
 
 O pacote exporta tanto a raiz (`opencode-system-metrics-tui`) quanto `./tui`; os dois caminhos carregam o mesmo bundle TUI.
@@ -287,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@0.1.6` instala o plugin apenas no projeto atual.
-- `opencode plugin -g opencode-system-metrics-tui@0.1.6 --force` instala o plugin globalmente para todos os projetos.
+- `opencode plugin opencode-system-metrics-tui@0.1.7` instala o plugin apenas no projeto atual.
+- `opencode plugin -g opencode-system-metrics-tui@0.1.7 --force` instala o plugin globalmente para todos os projetos.
 
 ### Verificação
 

package/dist/install-hack-font.js

@@ -8,19 +8,19 @@ import { promisify } from "node:util";
 // src/font.ts
 import { existsSync, readdirSync } from "node:fs";
 import { homedir } from "node:os";
-import { join as posixJoin, win32 } from "node:path";
+import { posix, 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"];
+    return [posix.join(home, "Library", "Fonts"), "/Library/Fonts", "/System/Library/Fonts"];
   if (platform === "win32") {
     const localAppData = env.LOCALAPPDATA ?? win32.join(home, "AppData", "Local");
     const windows = env.WINDIR ?? "C:\\Windows";
     return [win32.join(localAppData, "Microsoft", "Windows", "Fonts"), win32.join(windows, "Fonts")];
   }
-  return [posixJoin(home, ".local", "share", "fonts"), posixJoin(home, ".fonts"), "/usr/local/share/fonts", "/usr/share/fonts"];
+  return [posix.join(home, ".local", "share", "fonts"), posix.join(home, ".fonts"), "/usr/local/share/fonts", "/usr/share/fonts"];
 }
 function isNerdFontFile(fileName) {
   return NERD_FONT_FILE_PATTERN.test(fileName);
@@ -36,7 +36,7 @@ function hasNerdFont(platform = process.platform, home = homedir(), env = proces
       return false;
     try {
       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);
+        const path = platform === "win32" ? win32.join(directory, entry.name) : posix.join(directory, entry.name);
         return entry.isFile() ? isNerdFontFile(entry.name) : entry.isDirectory() && containsFont(path, depth + 1);
       });
     } catch {

package/dist/tui.js

@@ -40,7 +40,10 @@ import { execFile } from "node:child_process";
 import { promisify } from "node:util";
 import si from "systeminformation";
 var execFileAsync = promisify(execFile);
-var WINDOWS_NETWORK_TIMEOUT_MS = 1500;
+var DEFAULT_METRIC_TIMEOUT_MS = 1500;
+var WINDOWS_MEMORY_TIMEOUT_MS = 5000;
+var WINDOWS_NETWORK_PROCESS_TIMEOUT_MS = 4000;
+var WINDOWS_NETWORK_OUTER_TIMEOUT_MS = 4500;
 function parseMonitorTemperature(value) {
   if (value === undefined)
     return;
@@ -87,7 +90,7 @@ async function readWindowsNetworkSample() {
     "-NonInteractive",
     "-Command",
     "Get-NetAdapterStatistics | Select-Object Name,ReceivedBytes,SentBytes | ConvertTo-Json -Compress"
-  ], { windowsHide: true, timeout: WINDOWS_NETWORK_TIMEOUT_MS, maxBuffer: 1024 * 1024 });
+  ], { windowsHide: true, timeout: WINDOWS_NETWORK_PROCESS_TIMEOUT_MS, maxBuffer: 1024 * 1024 });
   return parseWindowsNetworkOutput(stdout);
 }
 var previousNetwork;
@@ -250,13 +253,13 @@ async function readWindowsCpuTemperature() {
 }
 async function readMetrics() {
   const [load, memory] = await Promise.allSettled([
-    withTimeout(si.currentLoad(), 1500),
-    withTimeout(si.mem(), 1500)
+    withTimeout(si.currentLoad(), DEFAULT_METRIC_TIMEOUT_MS),
+    withTimeout(si.mem(), isWindows ? WINDOWS_MEMORY_TIMEOUT_MS : DEFAULT_METRIC_TIMEOUT_MS)
   ]);
   const [temperature, graphics, network] = await Promise.allSettled([
     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)
+    readCachedMetric(cachedNetwork, isWindows ? readWindowsNetworkMetrics : () => si.networkStats("*"), isWindows ? NETWORK_CACHE_MS : 2000, Date.now(), OPTIONAL_SOURCE_BACKOFF_MS, isWindows ? WINDOWS_NETWORK_OUTER_TIMEOUT_MS : DEFAULT_METRIC_TIMEOUT_MS)
   ]);
   const cpuPercent = load.status === "fulfilled" ? finite(load.value.currentLoad) : null;
   const memoryTotalBytes = memory.status === "fulfilled" ? finite(memory.value.total) : null;
@@ -304,19 +307,19 @@ async function readMetrics() {
 // src/font.ts
 import { existsSync, readdirSync } from "node:fs";
 import { homedir } from "node:os";
-import { join as posixJoin, win32 } from "node:path";
+import { posix, 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"];
+    return [posix.join(home, "Library", "Fonts"), "/Library/Fonts", "/System/Library/Fonts"];
   if (platform === "win32") {
     const localAppData = env.LOCALAPPDATA ?? win32.join(home, "AppData", "Local");
     const windows = env.WINDIR ?? "C:\\Windows";
     return [win32.join(localAppData, "Microsoft", "Windows", "Fonts"), win32.join(windows, "Fonts")];
   }
-  return [posixJoin(home, ".local", "share", "fonts"), posixJoin(home, ".fonts"), "/usr/local/share/fonts", "/usr/share/fonts"];
+  return [posix.join(home, ".local", "share", "fonts"), posix.join(home, ".fonts"), "/usr/local/share/fonts", "/usr/share/fonts"];
 }
 function isNerdFontFile(fileName) {
   return NERD_FONT_FILE_PATTERN.test(fileName);
@@ -332,7 +335,7 @@ function hasNerdFont(platform = process.platform, home = homedir(), env = proces
       return false;
     try {
       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);
+        const path = platform === "win32" ? win32.join(directory, entry.name) : posix.join(directory, entry.name);
         return entry.isFile() ? isNerdFontFile(entry.name) : entry.isDirectory() && containsFont(path, depth + 1);
       });
     } catch {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-system-metrics-tui",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "description": "OpenCode TUI sidebar plugin for live system metrics",
   "license": "MIT",
   "type": "module",

package/scripts/install-plugin.ts

@@ -1,7 +1,8 @@
 import { execFile } from "node:child_process"
 import { readFile } from "node:fs/promises"
+import { fileURLToPath } from "node:url"
 import { promisify } from "node:util"
-import { formatVerificationResult, verifyPluginInstallation } from "./plugin-installation.js"
+import { formatVerificationResult, shouldInstallPlugin, verifyPluginInstallation } from "./plugin-installation.js"
 
 const execFileAsync = promisify(execFile)
 const manifest = JSON.parse(await readFile(new URL("../package.json", import.meta.url), "utf8")) as {
@@ -10,21 +11,36 @@ const manifest = JSON.parse(await readFile(new URL("../package.json", import.met
 }
 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)
+export async function installPlugin(): Promise<void> {
+  const verificationOptions = {
+    packageName: manifest.name,
+    expectedVersion: manifest.version,
+    cacheDirectory: process.env.OPENCODE_CACHE_DIR,
+  }
+  const current = await verifyPluginInstallation(verificationOptions)
+  console.log(formatVerificationResult(current))
+  if (!shouldInstallPlugin(current)) {
+    console.log(`Installation already current for ${packageSpec}; OpenCode was not invoked.`)
+    return
+  }
+
+  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.exitCode = 1
+    return
+  }
+
+  const verification = await verifyPluginInstallation(verificationOptions)
+  console.log(formatVerificationResult(verification))
+  if (!verification.ok) process.exitCode = 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
+if (process.argv[1] !== undefined && fileURLToPath(import.meta.url) === process.argv[1]) {
+  await installPlugin()
+}

package/scripts/plugin-installation.ts

@@ -15,6 +15,7 @@ export type PluginVerification = {
   packagePath?: string
   actualVersion?: string
   staleEntries: string[]
+  warnings: string[]
   errors: string[]
 }
 
@@ -46,8 +47,11 @@ export async function verifyPluginInstallation(options: PluginVerificationOption
   const cacheDirectory = resolve(options.cacheDirectory ?? getDefaultOpenCodeCacheDirectory())
   const errors: string[] = []
   const staleEntries: string[] = []
+  const warnings: string[] = []
   let packagePath: string | undefined
   let actualVersion: string | undefined
+  let expectedArtifactFound = false
+  let expectedPackagePath: string | undefined
 
   let entries: string[]
   try {
@@ -55,7 +59,7 @@ export async function verifyPluginInstallation(options: PluginVerificationOption
       .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}`] }
+    return { ok: false, staleEntries, warnings, errors: [`OpenCode package cache not found: ${cacheDirectory}`] }
   }
 
   for (const entry of entries) {
@@ -65,31 +69,42 @@ export async function verifyPluginInstallation(options: PluginVerificationOption
       staleEntries.push(join(cacheDirectory, entry))
       continue
     }
-    if (manifest.version === options.expectedVersion && packagePath === undefined) {
-      packagePath = candidatePath
-      actualVersion = manifest.version
-    } else if (manifest.version !== options.expectedVersion) {
+    if (manifest.version === options.expectedVersion) {
+      expectedArtifactFound = true
+      expectedPackagePath ??= candidatePath
+      if (await exists(join(candidatePath, options.distPath ?? "dist", "tui.js")) && packagePath === undefined) {
+        packagePath = candidatePath
+        actualVersion = manifest.version
+      }
+    } else {
       staleEntries.push(join(cacheDirectory, entry))
     }
   }
 
-  if (packagePath === undefined) {
+  if (!expectedArtifactFound) {
     errors.push(`Installed ${options.packageName}@${options.expectedVersion} was not found in ${cacheDirectory}`)
+  } else if (packagePath === undefined) {
+    errors.push(`Required dist/tui.js is missing from an expected ${options.packageName}@${options.expectedVersion} artifact in ${cacheDirectory}`)
+    packagePath = expectedPackagePath
+    actualVersion = options.expectedVersion
   } 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(", ")}`)
+  if (staleEntries.length > 0) warnings.push(`Stale OpenCode cache entries detected: ${staleEntries.join(", ")}`)
+
+  return { ok: errors.length === 0, packagePath, actualVersion, staleEntries, warnings, errors }
+}
 
-  return { ok: errors.length === 0, packagePath, actualVersion, staleEntries, errors }
+export function shouldInstallPlugin(result: PluginVerification): boolean {
+  return !result.ok
 }
 
 export function formatVerificationResult(result: PluginVerification): string {
-  if (result.ok) return `Verified OpenCode plugin ${result.actualVersion} at ${result.packagePath}`
-  return result.errors.join("\n")
+  const lines = result.ok
+    ? [`Verified OpenCode plugin ${result.actualVersion} at ${result.packagePath}`]
+    : result.errors
+  return [...lines, ...result.warnings].join("\n")
 }
 
 if (process.argv[1] !== undefined && resolve(process.argv[1]) === resolve(fileURLToPath(import.meta.url))) {