claude-doom-statusbar 0.8.0 → 0.8.2

package/README.md

@@ -3,7 +3,7 @@
 A DOOM-inspired status bar for the [Claude Code](https://docs.claude.com/en/docs/claude-code) CLI. Your session, read off the Doomguy HUD: a mugshot whose face tracks your health, boxes for usage, model, project and system, and live lists of running agents and tasks.
 
 <p align="center">
-  <img src="assets/images/hud.png" alt="claude-doom-statusbar HUD: MODEL, USAGE, PROJECT, the DOOM mugshot, ACTIVITY, AGENTS, TASKS and SYS boxes">
+  <img src="assets/images/hud.png" alt="claude-doom-statusbar HUD: MODEL, USAGE, PROJECT, the DOOM mugshot, ACTIVITY, AGENTS, TASKS and SYSTEM boxes">
 </p>
 
 The mugshot is the real DOOM (1993) status-face sprite, rasterised into the terminal at runtime — not ASCII art of it.
@@ -19,7 +19,7 @@ The HUD is a row of boxes centred on the mugshot. Each box is configurable; the
 - **ACTIVITY** — a tool-activity "geiger" sparkline (duty-cycle over the last 30 s), running-agent count, task progress, error count.
 - **AGENTS** — a live list of running subagents (type/description + ticking runtime), always visible. Long lists scroll within the box height, with ↑/↓ markers counting the rows hidden off-screen.
 - **TASKS** — the session's todo list: settled items (✅ done, ❌ removed) on top, open items (⏩ in-progress, 🎯 pending) below. Scrolls like AGENTS, anchored on the open/settled boundary.
-- **SYS** — CPU, a per-core CPU equalizer (one threshold-coloured column per core), disk, session length, wall clock.
+- **SYSTEM** — a per-core CPU equalizer (one threshold-coloured column per core) with the aggregate CPU % right-aligned beside it, disk, session length, wall clock.
 
 Anything the session can't supply is hidden automatically, so the same config degrades cleanly.
 
@@ -73,6 +73,12 @@ $env:FORCE_HYPERLINK = "1"; claude
 
 A preset is TOML: a `[bar]` style block, a `[mugshot]` block, and a list of `[[segment]]` boxes. Each box lists metrics with a render type — `bar`, `number`, `text`, `spark`, `equalizer`, `ammo`, `list`, `scroll`, or a `group`. (`equalizer` draws an array of `0..1` values as a one-row VU-meter: one block column per channel, each coloured by its own value — e.g. `sys.cores` for per-core CPU.) Copy one and rearrange the boxes, swap icons, or change which metrics show.
 
+A value-carrying metric (`bar`, `ammo`, `equalizer`, `number`, `text`) can set `color`:
+
+- `color = "threshold"` — the default heat gradient: green at 0, yellow at 50, red at 100, smoothly interpolated.
+- `color = "#rrggbb"` — a solid colour.
+- `color = [[0, "#60c868"], [50, "#e0b840"], [100, "#e05440"]]` — custom gradient stops as `[value, "#hex"]` pairs, interpolated between stops. A single pair is a solid colour; adjacent stops (e.g. `[50, "#..."], [51, "#..."]`) make a hard step instead of a smooth blend.
+
 ### Responsive width
 
 As the terminal narrows, the HUD shrinks: bars contract and text columns shrink together, and whatever overflows scrolls (the marquee). When even the smallest layout no longer fits, the preset falls back to a smaller one via its `[bar].fallback` key — `full → standard → minimal`. Your chosen preset is the ceiling; widening the terminal recovers it. It's stateless — each refresh re-reads the terminal width (`COLUMNS`), so it follows live resizes.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-doom-statusbar",
-  "version": "0.8.0",
+  "version": "0.8.2",
   "description": "DOOM-inspired status bar for the Claude Code CLI — a mugshot that tracks session health, plus usage, model, project, system, and a live subagent list.",
   "type": "module",
   "bin": {

package/presets/full.toml

@@ -85,10 +85,9 @@ metric = [
 
 [[segment]]
 type  = "box"
-title = "SYS"
+title = "SYSTEM"
 metric = [
-  { id = "sys.cpu",     render = "number",    icon = "🔥" },
-  { id = "sys.cores",   render = "equalizer", icon = "🎚", color = "threshold" },
+  { id = "sys.cores",   render = "equalizer", icon = "🔥", color = "threshold", right = "sys.cpu" },
   { id = "sys.disk",    render = "bar",    icon = "💿", color = "threshold" },
   { id = "sys.session", render = "text",   icon = "🕙" },
   { id = "sys.clock",   render = "text",   icon = "🕓" },

package/presets/standard.toml

@@ -1,4 +1,4 @@
-# standard — full minus SAVE and SYS
+# standard — full minus SAVE and SYSTEM
 [bar]
 border_style   = "vertical"
 border_color   = "term-bg"      # seamless cuts through the panel

package/src/render.js

@@ -90,8 +90,42 @@ function headCols(text, width) {
   return out;
 }
 
-function threshold(pct) {
-  return pct < 60 ? OK : pct < 85 ? WARN : CRIT;
+// Default heat gradient: green (0) -> yellow (50) -> red (100). Higher = hotter,
+// the orientation every caller wants (context usage, rate limits, CPU, disk, RAM).
+const DEFAULT_STOPS = [[0, OK], [50, WARN], [100, CRIT]];
+
+const lerp1 = (a, b, t) => Math.round(a + (b - a) * t);
+
+// Interpolate an RGB colour at `pct` (0..100) across sorted [value, rgb] stops.
+// Below the first stop / above the last it clamps to that stop. A single stop is a
+// solid colour; adjacent stops (e.g. 50 then 51) make a near-hard transition.
+function interpStops(stops, pct) {
+  if (pct <= stops[0][0]) return stops[0][1];
+  const last = stops[stops.length - 1];
+  if (pct >= last[0]) return last[1];
+  for (let i = 1; i < stops.length; i++) {
+    const [v0, c0] = stops[i - 1], [v1, c1] = stops[i];
+    if (pct <= v1) {
+      const t = v1 === v0 ? 0 : (pct - v0) / (v1 - v0);
+      return [0, 1, 2].map((j) => lerp1(c0[j], c1[j], t));
+    }
+  }
+  return last[1];
+}
+
+// Resolve a metric's `color` spec to an RGB at `pct` (0..100):
+//   "threshold"        -> the default green->yellow->red gradient
+//   [[v, "#hex"], ...] -> a custom gradient (a single pair = a solid colour)
+//   "#rrggbb"          -> a solid colour
+//   unset / unknown    -> null, so the caller can pick its own default
+function colorFor(spec, pct) {
+  if (spec === "threshold") return interpStops(DEFAULT_STOPS, pct);
+  if (Array.isArray(spec) && spec.length) {
+    const stops = spec.map(([v, c]) => [v, rgbOf(c)]).sort((a, b) => a[0] - b[0]);
+    return interpStops(stops, pct);
+  }
+  if (typeof spec === "string" && spec.startsWith("#")) return rgbOf(spec);
+  return null;
 }
 
 function rgbOf(spec) {
@@ -120,7 +154,7 @@ function rBar(pct, cells, boxRgb, colorSpec, showPct = true) {
   const eighths = pyround((pct / 100) * cells * 8);
   const full = Math.min(cells, Math.floor(eighths / 8));
   const rem = full < cells ? eighths % 8 : 0;
-  const c = colorSpec === "threshold" ? threshold(pct) : colorSpec ? rgbOf(colorSpec) : TEXT;
+  const c = colorFor(colorSpec, pct) ?? TEXT;
   let s = sgrBg(empty) + f(c) + "█".repeat(full);
   if (rem) s += EIGHTHS[rem];
   s += " ".repeat(Math.max(0, cells - full - (rem ? 1 : 0)));
@@ -130,7 +164,7 @@ function rBar(pct, cells, boxRgb, colorSpec, showPct = true) {
 }
 
 function rAmmo(pct, colorSpec, segs = 5) {
-  const c = colorSpec === "threshold" ? threshold(pct) : WARN;
+  const c = colorFor(colorSpec, pct) ?? WARN;
   const filled = pyround((pct / 100) * segs);
   return f(c) + "▮".repeat(filled) + f([90, 95, 120]) + "▯".repeat(segs - filled) +
     f(c) + " " + String(pct).padStart(3) + "%";
@@ -203,15 +237,15 @@ function eqColumns(values) {
 }
 
 // One-row VU-meter: one block column per channel (densified past EQ_MAX), each
-// column coloured by its OWN value via threshold(). Absolute 0..1 scale (no
-// span-normalize), 9-level EQ_RAMP. Fixed-width: takes no `cells` budget.
-function rEqualizer(values, boxRgb) {
+// column coloured by its OWN value via the metric's colour spec (default gradient).
+// Absolute 0..1 scale (no span-normalize), 9-level EQ_RAMP. Fixed-width: no `cells`.
+function rEqualizer(values, boxRgb, colorSpec) {
   if (!values || values.length === 0) return f(SPARK);
   const empty = [0, 1, 2].map((i) => Math.floor((boxRgb[i] + TERM_RGB[i]) / 2));
   let body = sgrBg(empty);
   for (const raw of eqColumns(values)) {
     const v = Math.max(0, Math.min(1, raw));
-    body += f(threshold(v * 100)) + EQ_RAMP[pyround(v * 8)];
+    body += f(colorFor(colorSpec, v * 100) ?? OK) + EQ_RAMP[pyround(v * 8)];
   }
   return body + bgsgrBox(boxRgb);
 }
@@ -236,18 +270,13 @@ export function renderValue(entry, cells, boxRgb) {
   }
   if (render === "ammo") return label + rAmmo(val, color || "threshold");
   if (render === "spark") return label + rSpark(val, entry.spark_style || "block", boxRgb, entry.spark_max);
-  if (render === "equalizer") return label + rEqualizer(val, boxRgb);
+  if (render === "equalizer") return label + rEqualizer(val, boxRgb, color || "threshold");
   if (render === "list") {
     const items = VALUES[entry.id] || [];
     return label + f(TEXT) + items.map((x) => (Array.isArray(x) ? `${x[0]} ${x[1]}` : String(x))).join("  ");
   }
   // number / text
-  let col;
-  if (color === "threshold") {
-    col = threshold(parseInt(String(val).replace(/\D/g, "") || "0", 10));
-  } else {
-    col = color ? rgbOf(color) : TEXT;
-  }
+  const col = colorFor(color, parseInt(String(val).replace(/\D/g, "") || "0", 10)) ?? TEXT;
   return label + f(col) + String(val);
 }
 
@@ -292,7 +321,7 @@ export function metricFixedWidth(entry, textCap = TEXTCAP_MAX) {
     return lw + capLen(entry.group.filter((i) => i in VALUES).map((i) => String(VALUES[i])).join(sep), textCap) + rextra;
   }
   if (r === "spark") return lw + Math.floor(((VALUES[entry.id] || []).length + 1) / 2);
-  if (r === "equalizer") return lw + Math.min((VALUES[entry.id] || []).length, EQ_MAX);
+  if (r === "equalizer") return lw + Math.min((VALUES[entry.id] || []).length, EQ_MAX) + rextra;
   if (r === "ammo") return lw + 5 + vlen(" " + (entry.id in VALUES ? VALUES[entry.id] : 0) + "%");
   if (r === "list") {
     const items = VALUES[entry.id] || [];
@@ -564,7 +593,7 @@ export function buildBar(cfg, target, spriteFor, tick = 0, overflow) {
           const tailW = vlen(tail);
           let body;
           if (Array.isArray(item)) {                       // [left, right] (agents)
-            const right = f(TEXT) + String(item[1]) + (marker ? f(TEXT) + tail : "");
+            const right = f(TEXT) + String(item[1]) + (marker ? f(TITLE) + tail : "");
             const rightW = vlen(String(item[1])) + tailW;
             const labelMax = Math.max(0, w - vlen(lbl) - rightW - 1); // 1 = min gap
             const left = lbl + f(TEXT) + marquee(String(item[0]), labelMax, tick, ovf);
@@ -578,7 +607,7 @@ export function buildBar(cfg, target, spriteFor, tick = 0, overflow) {
             const max = Math.max(0, w - vlen(mPad) - 1 - tailW); // reserve gap + marker on the right
             body = head + marquee(String(item.text), max, tick, ovf);
             body += " ".repeat(Math.max(0, w - tailW - vlen(body)));
-            if (tail) body += f(TEXT) + tail;
+            if (tail) body += f(TITLE) + tail;
           }
           col.push(bgsgrBox(boxRgb) + " " + body + " " + RESET);
         });
@@ -597,9 +626,7 @@ export function buildBar(cfg, target, spriteFor, tick = 0, overflow) {
         const budget = w - vlen(lbl) - vlen(rhs);
         const sliceable = !ESC_RE.test(raw) || OSC8_RE.test(raw); // plain or hyperlink
         if (sliceable && budget > 0 && vlen(raw) > budget) {
-          let col;
-          if (m.color === "threshold") col = threshold(parseInt(raw.replace(/\D/g, "") || "0", 10));
-          else col = m.color ? rgbOf(m.color) : TEXT;
+          const col = colorFor(m.color, parseInt(raw.replace(/\D/g, "") || "0", 10)) ?? TEXT;
           body = lbl + f(col) + marquee(raw, budget, tick, ovf);
         }
       }

package/src/statusline.js

@@ -239,6 +239,16 @@ function ramPercent() {
   try { return pyround((1 - os.freemem() / os.totalmem()) * 100); } catch { return null; }
 }
 
+// Minimum interval between CPU snapshots; below this, per-core deltas are tick-quantised noise.
+const CPU_MIN_MS = 1000;
+
+// Pure: should cpuMetrics recompute, or hold the cached result? Recompute on cold start,
+// a legacy snapshot without `ts`, a missing cached result, or once CPU_MIN_MS has elapsed.
+// Holding in between keeps a burst of fast refreshes from sampling a sub-tick interval.
+export function shouldSampleCpu(prev, now) {
+  return !(prev && typeof prev.ts === "number" && now - prev.ts < CPU_MIN_MS && prev.result);
+}
+
 // Per-core idle fraction over a cumulative-time delta; null when no time elapsed.
 const cpuUtil = (dt, di) => (dt > 0 ? Math.max(0, Math.min(1, 1 - di / dt)) : null);
 
@@ -268,12 +278,21 @@ function cpuMetrics() {
     });
   } catch { return { cpu: null, cores: null }; }
   const agg = cores.reduce((a, c) => ({ total: a.total + c.total, idle: a.idle + c.idle }), { total: 0, idle: 0 });
-  const cur = { total: agg.total, idle: agg.idle, cores };
+  const now = Date.now();
+  const cur = { ts: now, total: agg.total, idle: agg.idle, cores };
   const cache = path.join(TMP, "mugshot_cpu.json");
   let prev = null;
   try { prev = JSON.parse(readFileSync(cache, "utf8")); } catch { /* none */ }
-  try { writeFileSync(cache, JSON.stringify(cur)); } catch { /* ignore */ }
-  return cpuDeltas(prev, cur);
+  // Windows updates os.cpus() times only on the ~15.6ms scheduler tick, so a per-core
+  // delta over a sub-second interval is dominated by tick quantisation and explodes
+  // into 0/100 noise. The status bar refreshes on every action, often milliseconds
+  // apart -- so only recompute when >= CPU_MIN_MS has elapsed, holding the last result
+  // (and the old snapshot) in between. The interval keeps growing until it's wide
+  // enough to be stable, even under a burst of fast refreshes.
+  if (!shouldSampleCpu(prev, now)) return prev.result;
+  const result = cpuDeltas(prev, cur);
+  try { writeFileSync(cache, JSON.stringify({ ...cur, result })); } catch { /* ignore */ }
+  return result;
 }
 
 function sysValues(cwd) {