llm-tuner 0.2.0 → 0.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "llm-tuner",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Detects your hardware and finds the fastest configuration to run local LLMs with LM Studio or Ollama.",
   "keywords": [
     "llm",

package/src/cli/index.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { select, input, confirm, search } from '@inquirer/prompts';
-import { detectHardware, detectEngines, Tuner, installPlans, runInstall, listPresets, presetsDir, fmtBytes, readSettings, writeSettings, THEMES, PROFILES, DEFAULT_PROFILE, TunerError } from '../core/index.js';
+import { detectHardware, detectEngines, Tuner, installPlans, runInstall, listPresets, presetsDir, fmtBytes, readSettings, writeSettings, THEMES, PROFILES, DEFAULT_PROFILE, TunerError, checkUpdate, CURRENT_VERSION } from '../core/index.js';
 import { t as translate, LOCALES, errorText } from '../i18n/index.js';
 import { profileChoices, profileNotes, profileSwitchNote, profileEventLines, shouldAskProfile, parseContext } from './profile.js';
 
@@ -34,12 +34,18 @@ const isLight = () => theme === 'light';
 const c = {
   b: (s) => `\x1b[1m${s}\x1b[0m`,
   dim: (s) => isLight() ? `\x1b[90m${s}\x1b[0m` : `\x1b[2m${s}\x1b[0m`,
-  g: (s) => isLight() ? `\x1b[32m${s}\x1b[0m` : `\x1b[92m${s}\x1b[0m`,
+  g: (s) => isLight() ? `\x1b[38;2;40;138;0m${s}\x1b[0m` : `\x1b[38;2;101;255;0m${s}\x1b[0m`,
   y: (s) => isLight() ? `\x1b[33m${s}\x1b[0m` : `\x1b[93m${s}\x1b[0m`,
-  r: (s) => isLight() ? `\x1b[31m${s}\x1b[0m` : `\x1b[91m${s}\x1b[0m`,
-  cyan: (s) => isLight() ? `\x1b[36m${s}\x1b[0m` : `\x1b[96m${s}\x1b[0m`,
+  r: (s) => isLight() ? `\x1b[38;2;214;21;0m${s}\x1b[0m` : `\x1b[38;2;255;26;0m${s}\x1b[0m`,
+  cyan: (s) => isLight() ? `\x1b[38;2;0;124;153m${s}\x1b[0m` : `\x1b[38;2;0;229;255m${s}\x1b[0m`,
+  purple: (s) => isLight() ? `\x1b[38;2;120;0;199m${s}\x1b[0m` : `\x1b[38;2;154;0;255m${s}\x1b[0m`,
 };
 
+if (args.version) {
+  console.log(CURRENT_VERSION);
+  process.exit(0);
+}
+
 if (args.help) {
   console.log(t('cli.help', { presetsDir: presetsDir() }));
   process.exit(0);
@@ -114,6 +120,7 @@ async function settingsFlow() {
 }
 
 async function main() {
+  const updatePromise = checkUpdate().catch(() => null);
   const isTTY = Boolean(process.stdout.isTTY && !args.json);
   let lastProgress = null;
   let lastTelemetry = null;
@@ -163,6 +170,12 @@ async function main() {
     '',
   ].join('\n'));
 
+  const updateInfo = await updatePromise;
+  if (updateInfo?.updateAvailable) {
+    out(c.y(`  ▲ ${t('cli.updateAvailable', { current: updateInfo.currentVersion, latest: updateInfo.latestVersion })}`));
+    out(c.dim(`    ${t('cli.updateCommand', { cmd: 'npm install -g llm-tuner' })}\n`));
+  }
+
   const hw = await detectHardware();
   out(c.dim(`  ${hw.cpu.brand} · ${fmtBytes(hw.ram.totalBytes)} RAM`));
   for (const g of hw.gpus) out(c.dim(`  GPU${g.index} ${g.name} · ${fmtBytes(g.totalBytes)}${g.pcieGen ? ` · PCIe ${g.pcieGen}.0 x${g.pcieWidth}` : ''}${g.displayAttached ? t('cli.display') : ''}`));
@@ -343,11 +356,12 @@ function vramStr(peaks = {}) {
 }
 
 function parseArgs(argv) {
-  const flags = new Set(['help', 'yes', 'dry-run', 'json', 'force', 'presets', 'settings']);
+  const flags = new Set(['help', 'version', 'yes', 'dry-run', 'json', 'force', 'presets', 'settings']);
   const o = {};
   for (let i = 0; i < argv.length; i++) {
     const a = argv[i];
     if (a === '-h') o.help = true;
+    if (a === '-v') o.version = true;
     if (a === '/settings' || a === '/setting' || a === 'settings') o.settings = true;
     if (!a.startsWith('--')) continue;
     const k = a.slice(2);

package/src/core/index.js

@@ -9,4 +9,4 @@ export { findPreset, savePreset, listPresets, presetsDir, presetPath, variantsSi
 export { readSettings, writeSettings, settingsPath, THEMES, DEFAULT_THEME, normalizeTheme } from './settings.js';
 export { TunerError, benchError } from './errors.js';
 export { sampleRam, sampleGpus, startTelemetrySampler } from './telemetry.js';
-
+export { checkUpdate, isNewerVersion, CURRENT_VERSION } from './updater.js';

package/src/core/updater.js

@@ -0,0 +1,99 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { configDir, readJson, fetchJson } from './util.js';
+
+const pkgUrl = new URL('../../package.json', import.meta.url);
+const pkgContent = await fs.readFile(pkgUrl, 'utf8');
+export const CURRENT_VERSION = JSON.parse(pkgContent).version;
+
+export const DEFAULT_REGISTRY_URL = 'https://registry.npmjs.org/llm-tuner/latest';
+export const DEFAULT_CACHE_TTL_MS = 24 * 60 * 60 * 1000; // 24 hours
+
+export const updateCachePath = () => path.join(configDir(), 'update-check.json');
+
+/**
+ * Parse a semver string into [major, minor, patch] numbers.
+ * Strips any leading 'v' and ignores pre-release/build identifiers.
+ */
+export function parseSemver(v) {
+  if (typeof v !== 'string') return null;
+  const clean = v.trim().replace(/^v/, '');
+  const [core] = clean.split('-');
+  const parts = core.split('.').map((p) => Number(p));
+  if (parts.length < 3 || parts.some((n) => Number.isNaN(n) || n < 0)) return null;
+  return parts.slice(0, 3);
+}
+
+/**
+ * Returns true if `latest` is strictly newer than `current`.
+ */
+export function isNewerVersion(latest, current) {
+  const l = parseSemver(latest);
+  const c = parseSemver(current);
+  if (!l || !c) return false;
+  for (let i = 0; i < 3; i++) {
+    if (l[i] > c[i]) return true;
+    if (l[i] < c[i]) return false;
+  }
+  return false;
+}
+
+/**
+ * Checks npm registry for updates with a 24h cache.
+ * Never throws; returns safe fallback on network or file errors.
+ */
+export async function checkUpdate({
+  force = false,
+  timeout = 2000,
+  cacheTtlMs = DEFAULT_CACHE_TTL_MS,
+  registryUrl = DEFAULT_REGISTRY_URL,
+  currentVersion = CURRENT_VERSION,
+} = {}) {
+  try {
+    const cacheFile = updateCachePath();
+    if (!force) {
+      const cached = await readJson(cacheFile, null);
+      if (cached && typeof cached === 'object' && cached.lastChecked && cached.latestVersion) {
+        if (Date.now() - cached.lastChecked < cacheTtlMs) {
+          return {
+            updateAvailable: isNewerVersion(cached.latestVersion, currentVersion),
+            currentVersion,
+            latestVersion: cached.latestVersion,
+            cached: true,
+          };
+        }
+      }
+    }
+
+    const res = await fetchJson(registryUrl, { timeout });
+    if (res?.ok && res?.json?.version) {
+      const latest = res.json.version;
+      try {
+        await fs.mkdir(configDir(), { recursive: true });
+        await fs.writeFile(cacheFile, JSON.stringify({ lastChecked: Date.now(), latestVersion: latest }, null, 2));
+      } catch {
+        // Ignore cache write errors
+      }
+      return {
+        updateAvailable: isNewerVersion(latest, currentVersion),
+        currentVersion,
+        latestVersion: latest,
+        cached: false,
+      };
+    }
+
+    return {
+      updateAvailable: false,
+      currentVersion,
+      latestVersion: null,
+      cached: false,
+    };
+  } catch {
+    return {
+      updateAvailable: false,
+      currentVersion,
+      latestVersion: null,
+      cached: false,
+    };
+  }
+}

package/src/i18n/en.js

@@ -244,5 +244,10 @@ Presets are saved in {presetsDir}`,
   'web.telemetryRam': 'RAM',
   'web.telemetryVram': 'VRAM',
   'web.telemetryGpu': 'GPU {index}',
+  'cli.updateAvailable': 'Update available: {current} → {latest}',
+  'cli.updateCommand': 'Run {cmd} to update',
+  'web.updateAvailable': 'Update available: v{latest}',
+  'web.updateLink': 'View release notes on GitHub',
+  'web.version': 'Version {version}',
 };
 

package/src/i18n/es.js

@@ -244,5 +244,10 @@ Los presets se guardan en {presetsDir}`,
   'web.telemetryRam': 'RAM',
   'web.telemetryVram': 'VRAM',
   'web.telemetryGpu': 'GPU {index}',
+  'cli.updateAvailable': 'Actualización disponible: {current} → {latest}',
+  'cli.updateCommand': 'Ejecutá {cmd} para actualizar',
+  'web.updateAvailable': 'Actualización disponible: v{latest}',
+  'web.updateLink': 'Ver notas de la versión en GitHub',
+  'web.version': 'Versión {version}',
 };
 

package/src/web/public/app.js

@@ -136,6 +136,22 @@ async function boot() {
   document.documentElement.lang = s.lang;
   applyStatic();
   setupDrawer();
+  api('/api/update').then((up) => {
+    if (up?.currentVersion) {
+      const vDisp = $('#version-display');
+      if (vDisp) vDisp.textContent = t('web.version', { version: up.currentVersion });
+    }
+    if (up?.updateAvailable) {
+      const dot = $('#update-dot');
+      if (dot) dot.hidden = false;
+      const badge = $('#update-badge');
+      const link = $('#update-link');
+      if (badge && link) {
+        link.textContent = t('web.updateAvailable', { latest: up.latestVersion });
+        badge.hidden = false;
+      }
+    }
+  }).catch(() => {});
   state.storedProfile = s.profile ?? null;
   state.profileIds = s.profiles;
   renderProfile();

package/src/web/public/index.html

@@ -22,6 +22,7 @@
     <button id="settings-open" class="settings-trigger" type="button" aria-haspopup="dialog" aria-expanded="false">
       <span class="settings-trigger-icon">⚙</span>
       <span data-i18n="web.settings">Settings</span>
+      <span id="update-dot" class="update-dot" hidden></span>
     </button>
     <ol class="steps" id="steps">
       <li data-step="engine" class="active" data-i18n="web.stepEngine">Engine</li>
@@ -144,6 +145,12 @@
         <option value="dark" data-i18n="web.themeDark">Dark</option>
       </select>
     </div>
+    <div class="drawer-field version-info">
+      <span class="muted" id="version-display"></span>
+      <div id="update-badge" hidden>
+        <a href="https://github.com/ronald32acunadev/llmtuner/releases" target="_blank" rel="noopener noreferrer" class="tag prio" id="update-link"></a>
+      </div>
+    </div>
   </div>
 </aside>
 <script src="app.js" type="module"></script>

package/src/web/public/style.css

@@ -4,13 +4,14 @@
   --ink: #0f172a;
   --muted: #475569;
   --line: #cbd5e1;
-  --accent: #0284c7;
+  --accent: #007c99; /* accessible electric cyan for light theme */
   --accent-ink: #ffffff;
-  --gpu: #0891b2;
+  --gpu: #007c99;
+  --purple: #7800c7; /* accessible electric purple */
   --cpu: #94a3b8;
-  --ok: #16a34a;
+  --ok: #288a00; /* accessible neon lime */
   --warn: #d97706;
-  --bad: #dc2626;
+  --bad: #d61500; /* accessible electric red */
   --code-bg: #f8fafc;
   --font: 'IBM Plex Sans', system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif;
   --mono: 'IBM Plex Mono', ui-monospace, 'SFMono-Regular', Menlo, Consolas, monospace;
@@ -23,13 +24,14 @@
     --ink: #e2e8f0;
     --muted: #8b9bb0;
     --line: #1e2c3d;
-    --accent: #00e5ff; /* electric cyan from logo */
+    --accent: #00e5ff; /* electric cyan from brand */
     --accent-ink: #05131d;
     --gpu: #00e5ff;
+    --purple: #9a00ff; /* electric purple from brand */
     --cpu: #3d4f63;
-    --ok: #34d399;
+    --ok: #65ff00; /* neon lime from brand */
     --warn: #fbbf24;
-    --bad: #f87171;
+    --bad: #ff1a00; /* electric red from brand */
     --code-bg: #0b121b;
     color-scheme: dark;
   }
@@ -40,13 +42,14 @@
   --ink: #e2e8f0;
   --muted: #8b9bb0;
   --line: #1e2c3d;
-  --accent: #00e5ff; /* electric cyan from logo */
+  --accent: #00e5ff; /* electric cyan from brand */
   --accent-ink: #05131d;
   --gpu: #00e5ff;
+  --purple: #9a00ff; /* electric purple from brand */
   --cpu: #3d4f63;
-  --ok: #34d399;
+  --ok: #65ff00; /* neon lime from brand */
   --warn: #fbbf24;
-  --bad: #f87171;
+  --bad: #ff1a00; /* electric red from brand */
   --code-bg: #0b121b;
   color-scheme: dark;
 }
@@ -56,13 +59,14 @@
   --ink: #0f172a;
   --muted: #475569;
   --line: #cbd5e1;
-  --accent: #0284c7;
+  --accent: #007c99; /* accessible electric cyan for light theme */
   --accent-ink: #ffffff;
-  --gpu: #0891b2;
+  --gpu: #007c99;
+  --purple: #7800c7; /* accessible electric purple */
   --cpu: #94a3b8;
-  --ok: #16a34a;
+  --ok: #288a00; /* accessible neon lime */
   --warn: #d97706;
-  --bad: #dc2626;
+  --bad: #d61500; /* accessible electric red */
   --code-bg: #f8fafc;
   color-scheme: light;
 }
@@ -331,7 +335,7 @@ td .err { color: var(--bad); white-space: normal; }
 /* Progress bar and real-time telemetry */
 .progress-wrap { display: flex; flex-direction: column; gap: 6px; margin-top: 8px; }
 .progress-bar-track { width: 100%; height: 8px; background: var(--code-bg); border: 1px solid var(--line); border-radius: 4px; overflow: hidden; }
-.progress-bar-fill { height: 100%; background: var(--accent); transition: width .2s ease; }
+.progress-bar-fill { height: 100%; background: linear-gradient(90deg, var(--accent), var(--ok)); transition: width .2s ease; }
 .progress-meta { display: flex; justify-content: space-between; align-items: center; font: 500 .8rem var(--mono); color: var(--muted); }
 .progress-meta strong { color: var(--ink); }
 
@@ -342,5 +346,27 @@ td .err { color: var(--bad); white-space: normal; }
 .telemetry-gpus { grid-column: 1 / -1; display: grid; grid-template-columns: repeat(auto-fit, minmax(220px, 1fr)); gap: 12px; }
 .meter-bar { width: 100%; height: 8px; background: var(--code-bg); border: 1px solid var(--line); border-radius: 4px; overflow: hidden; }
 .meter-fill { height: 100%; background: var(--gpu); transition: width .2s ease; }
-#telemetry-cpu-fill { background: var(--accent); }
+#telemetry-cpu-fill { background: var(--purple); }
+
+/* Update notifications */
+.update-dot {
+  width: 8px;
+  height: 8px;
+  border-radius: 50%;
+  background: var(--warn, #f59e0b);
+  display: inline-block;
+  margin-left: auto;
+}
+.version-info {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  padding-top: 1rem;
+  border-top: 1px solid var(--line);
+  font-size: .85rem;
+}
+.version-info #update-link {
+  text-decoration: none;
+  font-size: .75rem;
+}
 

package/src/web/server.js

@@ -3,7 +3,7 @@ import fs from 'node:fs/promises';
 import path from 'node:path';
 import { fileURLToPath, pathToFileURL } from 'node:url';
 import { randomUUID } from 'node:crypto';
-import { detectHardware, detectEngines, Tuner, ENGINES, installPlans, runInstall, slim, listPresets, readSettings, writeSettings, TunerError, PROFILES } from '../core/index.js';
+import { detectHardware, detectEngines, Tuner, ENGINES, installPlans, runInstall, slim, listPresets, readSettings, writeSettings, TunerError, PROFILES, checkUpdate } from '../core/index.js';
 import { THEMES } from '../core/settings.js';
 import { LOCALES, messagesFor } from '../i18n/index.js';
 import { openUrl } from '../core/installer.js';
@@ -52,6 +52,8 @@ function send(res, status, obj) {
 const routes = {
   'GET /api/settings': async () => ({ ...(await readSettings()), locales: LOCALES, themes: THEMES, profiles: PROFILES }),
 
+  'GET /api/update': async () => checkUpdate(),
+
   'POST /api/settings': async (req) => {
     const payload = await body(req);
     if (payload?.lang === undefined && payload?.theme === undefined && payload?.profile === undefined) throw new TunerError('errors.unknownLocale', { lang: '', list: LOCALES.join(', ') });