claude-doom-statusbar 0.3.1 → 0.5.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-doom-statusbar",
-  "version": "0.3.1",
+  "version": "0.5.0",
   "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": {
@@ -15,7 +15,7 @@
   "scripts": {
     "statusline": "node src/statusline.js",
     "hook": "node src/hook.js",
-    "test": "node test/installer.test.mjs && node test/smoke.test.mjs && node test/hook-tasks.test.mjs && node test/statusline-tasks.test.mjs && node test/render-scroll.test.mjs && node test/e2e-tasks.test.mjs",
+    "test": "node test/installer.test.mjs && node test/smoke.test.mjs && node test/hook-tasks.test.mjs && node test/statusline-tasks.test.mjs && node test/render-scroll.test.mjs && node test/statusline-savings.test.mjs && node test/e2e-tasks.test.mjs",
     "preversion": "npm test",
     "postversion": "git push --follow-tags",
     "prepublishOnly": "npm test"

package/presets/default.toml

@@ -17,6 +17,14 @@ metric = [
   { id = "ratelimit.7d", render = "bar", icon = "📅", color = "threshold" },
 ]
 
+[[segment]]
+type  = "box"
+title = "SAVE"
+metric = [
+  { id = "save.leanctx", render = "text", icon = "🪶" },
+  { id = "save.lingua",  render = "text", icon = "📜" },
+]
+
 [[segment]]
 type = "mugshot"
 

package/presets/full.toml

@@ -30,6 +30,14 @@ metric = [
   { id = "cost.total",   render = "number", icon = "💰" },
 ]
 
+[[segment]]
+type  = "box"
+title = "SAVE"
+metric = [
+  { id = "save.leanctx", render = "text", icon = "🪶" },
+  { id = "save.lingua",  render = "text", icon = "📜" },
+]
+
 [[segment]]
 type  = "box"
 title = "PROJECT"

package/src/render.js

@@ -47,6 +47,7 @@ export const SAMPLE = {
   "act.geiger": [0, .25, .5, 1, .75, 1, .5, .6, .3, .1, .4, 1, .8, .4],
   "act.tasks": "2/5", "act.errors": "0", "sys.ram": 47, "sys.cpu": "12%",
   "sys.disk": 63, "sys.clock": "14:23",
+  "save.leanctx": "8.3k 63%", "save.lingua": "1.2k 1.3x",
 };
 
 let VALUES = SAMPLE;

package/src/statusline.js

@@ -10,7 +10,7 @@
 // Config: $DOOMBAR_PRESET (default presets/default.toml)  State: $MUGSHOT_STATE
 
 import {
-  readFileSync, writeFileSync, openSync, fstatSync, readSync, closeSync, statfsSync,
+  readFileSync, writeFileSync, openSync, fstatSync, readSync, closeSync, statfsSync, statSync,
 } from "node:fs";
 import os from "node:os";
 import path from "node:path";
@@ -45,6 +45,10 @@ function git(cwd, ...args) {
 // so an oversized repo or branch name can't blow up the PROJECT box width.
 const clip = (s, n) => ([...String(s)].length > n ? [...String(s)].slice(0, n - 1).join("") + "…" : String(s));
 
+// Human-readable token count: 8263 -> "8.3k", 1200000 -> "1.2M", 512 -> "512".
+// Lowercase k/M — the savings rows read softer than model.window's uppercase K/M.
+const k = (n) => (n >= 1e6 ? `${(n / 1e6).toFixed(1)}M` : n >= 1e3 ? `${(n / 1e3).toFixed(1)}k` : `${n}`);
+
 function _dur(secsF) {
   let secs = Math.max(0, Math.trunc(secsF));
   const d = Math.floor(secs / 86400); secs %= 86400;
@@ -228,6 +232,109 @@ function sysValues(cwd) {
   return v;
 }
 
+// --- Token-savings rows -----------------------------------------------------
+// Read from what context-optimization tools already persist on disk. No plugin
+// patching, no binary spawn. Paths are env-overridable (DOOMBAR_*) for tests.
+const eventsPath = () => process.env.DOOMBAR_EVENTS || path.join(os.homedir(), ".lean-ctx", "events.jsonl");
+const llmlinguaPath = () => process.env.DOOMBAR_LLMLINGUA || path.join(os.homedir(), ".llmlingua-stats.json");
+
+// Defensive read: missing file or malformed JSON -> null (the row simply never appears).
+function readJson(p) {
+  try { return JSON.parse(readFileSync(p, "utf8")); } catch { return null; }
+}
+
+// Windows FS is case-insensitive, POSIX is not — only fold case on win32 to avoid
+// false path matches (e.g. /home/User vs /home/user) on the platforms the npm package also runs on.
+const normPath = (p) => {
+  const s = String(p).replace(/\\/g, "/");
+  return process.platform === "win32" ? s.toLowerCase() : s;
+};
+
+// "8.3k 63%" — saved + a per-session compression rate derived from accumulated totals.
+function fmtSaved(st) {
+  return st.original > 0 ? `${k(st.saved)} ${Math.round(100 * st.saved / st.original)}%` : k(st.saved);
+}
+
+const savingsStatePath = (sid) =>
+  process.env.DOOMBAR_SAVINGS_STATE || path.join(TMP, `savings_${sid}.json`);
+
+// Per-session lean-ctx savings. lean-ctx's mcp-live.json is a single global file clobbered
+// by every concurrent session, so it can't be per-session. events.jsonl is append-only and
+// each ToolCall carries the file path it compressed — so we sum tokens_saved over NEW events
+// (tracked by byte offset) whose path is under the current cwd, accumulated across refreshes
+// in a per-session state file keyed by session_id. The accumulator follows cwd changes (it
+// keeps adding wherever you currently work) and stays cheap — it reads only the bytes appended
+// since the last refresh, never the whole log. Residual: two sessions concurrently in the SAME
+// project share events and both count them — unsplittable from disk, accepted.
+function leanCtxSavings(cwd, sid) {
+  if (!cwd) return null;
+  const cwdN = normPath(cwd).replace(/\/+$/, "") + "/"; // match on a path boundary, not a prefix
+  const sp = savingsStatePath(sid);
+  let st = { offset: null, saved: 0, original: 0 };
+  try { st = { ...st, ...JSON.parse(readFileSync(sp, "utf8")) }; } catch { /* fresh session */ }
+
+  let size = -1;
+  try { size = statSync(eventsPath()).size; } catch { /* no log */ }
+  if (size < 0) return st.saved > 0 ? fmtSaved(st) : null; // log gone -> keep prior total
+
+  if (st.offset === null) st.offset = size; // first sight of this session: count from now on
+  // Log shrank -> lean-ctx rotated it (old events go to archives/, the restarted log holds only
+  // NEW events). Keep the running total and re-read from 0: prior total + new events = correct.
+  // (An in-place truncate-and-rewrite retaining old content would double-count, but an append-only
+  // log doesn't do that.)
+  if (st.offset > size) st.offset = 0;
+
+  if (size > st.offset) {
+    let chunk = "";
+    try {
+      const fd = openSync(eventsPath(), "r");
+      const buf = Buffer.alloc(size - st.offset);
+      readSync(fd, buf, 0, buf.length, st.offset);
+      closeSync(fd);
+      chunk = buf.toString("utf8");
+    } catch { chunk = ""; }
+    const lastNl = chunk.lastIndexOf("\n"); // consume complete lines only; keep any partial tail
+    if (lastNl >= 0) {
+      for (const ln of chunk.slice(0, lastNl).split("\n")) {
+        if (!ln) continue;
+        let o; try { o = JSON.parse(ln); } catch { continue; }
+        const ev = o.kind;
+        if (!ev || ev.type !== "ToolCall" || !ev.path) continue;
+        if (!normPath(ev.path).startsWith(cwdN)) continue; // cwdN ends in "/" -> boundary-safe
+        st.saved += ev.tokens_saved || 0;
+        st.original += ev.tokens_original || 0;
+      }
+      st.offset += Buffer.byteLength(chunk.slice(0, lastNl + 1), "utf8");
+    }
+  }
+  try { writeFileSync(sp, JSON.stringify(st)); } catch { /* ignore */ }
+  return st.saved > 0 ? fmtSaved(st) : null;
+}
+
+// Per-session llmlingua. smart-read keys its sessions map by CLAUDE_CODE_SESSION_ID — the same
+// id the statusbar gets on stdin — so we read sessions[sid] (not a single global block).
+// Prefer last_saved_pct; else show the ratio. Flat lifetime-only writers expose no session -> absent.
+function linguaSavings(sid) {
+  const d = readJson(llmlinguaPath());
+  const s = d && d.sessions && d.sessions[sid];
+  if (!s || !(s.tokens_saved > 0)) return null;
+  if (s.last_saved_pct != null) return `${k(s.tokens_saved)} ${Math.round(s.last_saved_pct)}%`;
+  if (s.last_ratio != null) return `${k(s.tokens_saved)} ${Number(s.last_ratio).toFixed(1)}x`;
+  return k(s.tokens_saved);
+}
+
+export function statsValues(data, cwd) {
+  const v = {};
+  const rawSid = String((data && data.session_id) || "default");
+  const sid = rawSid.replace(/[^A-Za-z0-9_-]/g, "_").slice(0, 48); // filesystem-safe state-file key
+  const lean = leanCtxSavings(cwd, sid);
+  if (lean) v["save.leanctx"] = lean;
+  // smart-read keys sessions[] by the RAW CLAUDE_CODE_SESSION_ID -> look up with the unsanitized id.
+  const ling = linguaSavings(rawSid);
+  if (ling) v["save.lingua"] = ling;
+  return v;
+}
+
 const PERM = { plan: "📋 plan", auto: "⏩ auto", acceptEdits: "⏩ auto", bypassPermissions: "⏩ bypass" };
 const OK_RGB = [96, 200, 104];   // matches render.js OK (done, green)
 const CRIT_RGB = [224, 84, 64];  // matches render.js CRIT (deleted, red)
@@ -287,7 +394,7 @@ function main() {
   const now = Date.now() / 1000;
   const st = readState(data);
   const cwd = data.cwd || (data.workspace || {}).current_dir;
-  const values = { ...buildValues(data), ...activityValues(st, now), ...sysValues(cwd) };
+  const values = { ...buildValues(data), ...activityValues(st, now), ...sysValues(cwd), ...statsValues(data, cwd) };
   const [advModel, advTs] = advisorInfo(data.transcript_path || "");
   if (advModel) values["advisor.model"] = advModel;
   const god_until = godFlash(data, advTs, now);