claude-token-saver 2.8.4 → 2.8.5

package/README.en.md

@@ -143,6 +143,10 @@ Node.js ≥ 18 · macOS / Windows / Linux / WSL · zero dependencies.
 - [HN discussion](https://news.ycombinator.com/item?id=47736476) — 168 points, 142 comments
 - [HNPulse KR](https://www.youtube.com/@HNPulseKR) — Korean HN tech deep-dives
 
+## Known environment quirks
+
+**IntelliJ Claude Code plugin** — the statusline widget fuses prior and current frames at the character level when emoji are in the output, producing artifacts like `Cache expires 59:548`. v2.8.5+ detects `TERMINAL_EMULATOR=JetBrains-JediTerm` and falls back to text mode automatically (`--icon` is also ignored under IntelliJ). Other terminals (iTerm, Terminal, WSL, etc.) are unaffected.
+
 ## License
 
 MIT

package/README.md

@@ -103,6 +103,10 @@ Claude Code는 모든 API 응답을 `~/.claude/projects/<dir>/<session>.jsonl`
 
 Node.js ≥ 18 · macOS / Linux / Windows / WSL · 의존성 0.
 
+## 알려진 환경 이슈
+
+**IntelliJ Claude Code plugin** — statusline 위젯이 이전 프레임과 새 프레임을 글자 단위로 잘못 합쳐 `Cache expires 59:548` 같은 합성 잔재가 보이는 버그가 있습니다 (이모지가 들어간 텍스트일 때만). v2.8.5+에서는 `TERMINAL_EMULATOR=JetBrains-JediTerm`을 감지하면 자동으로 text 모드로 폴백해 이모지 없이 출력합니다 (`--icon` 플래그도 IntelliJ에서는 무시). 다른 터미널(iTerm, Terminal, WSL 등)에는 영향 없습니다.
+
 ## 라이선스
 
 MIT

package/bin/cli.js

@@ -700,10 +700,21 @@ async function main() {
     const { statuslineDefaults } = await import('../src/config.js');
     const cfg = statuslineDefaults();
 
+    // IntelliJ's Claude Code plugin renders the statusline through a custom
+    // widget that fuses prior frames with the new one when emoji are present,
+    // producing garbage like "59:548" that no ANSI escape can clean up
+    // (verified: emitting the same output directly into JediTerm renders
+    // cleanly, so the bug is in the plugin's render path, not the terminal).
+    // Force text mode unconditionally inside IntelliJ — even past an explicit
+    // `--icon` flag, since wrappers commonly hardcode `--icon` and the user
+    // can't easily edit them; icon mode is just broken there.
+    const isIntelliJ = process.env.TERMINAL_EMULATOR === 'JetBrains-JediTerm';
     // CLI flags take precedence; otherwise fall back to persisted config.
-    const isIcon = hasFlag('--icon')
-      ? true
-      : (hasFlag('--no-icon') || hasFlag('--text') ? false : cfg.icon);
+    const isIcon = isIntelliJ
+      ? false
+      : (hasFlag('--icon')
+          ? true
+          : (hasFlag('--no-icon') || hasFlag('--text') ? false : cfg.icon));
     const isVerbose = hasFlag('--verbose')
       ? true
       : (hasFlag('--no-verbose') || hasFlag('--compact') ? false : cfg.verbose);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-token-saver",
-  "version": "2.8.4",
+  "version": "2.8.5",
   "description": "Save tokens on Claude Code — spike diagnosis, 1M-context detection, TTL countdown, statusline. (formerly claude-cache-monitor)",
   "type": "module",
   "bin": {

package/src/formatters/statusline.js

@@ -103,7 +103,7 @@ function formatTimer(remainingSec) {
   // Defensive: non-finite/NaN inputs (e.g. clock skew, stringified Date) used
   // to slip through and render as "NaN:NaN" or stretched seconds. Treat any
   // weird input as expired rather than rendering garbage in the statusline.
-  if (!Number.isFinite(remainingSec) || remainingSec <= 0) return padTimer('EXPIRED');
+  if (!Number.isFinite(remainingSec) || remainingSec <= 0) return 'EXPIRED';
   const totalSec = Math.max(0, Math.floor(remainingSec));
   const h = Math.floor(totalSec / 3600);
   const mRaw = Math.floor((totalSec % 3600) / 60);
@@ -112,22 +112,8 @@ function formatTimer(remainingSec) {
   // truncation) can never produce m:sss like "4:547".
   const m = Math.min(59, Math.max(0, mRaw));
   const s = Math.min(59, Math.max(0, sRaw));
-  if (h > 0) return padTimer(`${h}:${String(m).padStart(2, '0')}`);
-  return padTimer(`${m}:${String(s).padStart(2, '0')}`);
-}
-
-// Pad timer text to a fixed width so transitions never shrink the visible
-// length. Otherwise `42:38` (5 chars) → `1:00` (4 chars) on activity reset
-// leaves the trailing `8` on screen → fused garbage like `1:008`. Some
-// terminals (JetBrains JediTerm, certain Claude Code render paths) don't
-// fully clear the statusline region between frames, so column-stable output
-// is the only reliable defense — `\x1b[K` and trailing-space padding only
-// help if the cursor lands at the right spot to begin with.
-//   "EXPIRED" → "EXPIRED" (7 — already widest, used as the target width)
-//   "59:59"   → " 59:59 " no — left-pad only so the digits stay right-aligned
-const TIMER_WIDTH = 7;
-function padTimer(s) {
-  return s.padStart(TIMER_WIDTH, ' ');
+  if (h > 0) return `${h}:${String(m).padStart(2, '0')}`;
+  return `${m}:${String(s).padStart(2, '0')}`;
 }
 
 /**
@@ -409,19 +395,8 @@ export function formatReport(data, { color = true, verbose = false, timer = true
   if (want('saved')) segs.push(saveSeg);
   if (want('period')) segs.push(periodSeg);
   // Trailing erase-to-end-of-line so any leftover characters from a previous
-  // (longer) statusline render don't bleed into ours. Some terminals + the
-  // Claude Code statusline integration don't fully clear the line on rewrite,
-  // which surfaced as "Cache expires 4:574" or "Cache expires 43550" — old
-  // digits from a prior frame leaking past the new shorter timer text.
-  // \x1b[K is the standard "erase from cursor to EOL" CSI; safe on any
-  // ANSI-compatible terminal and a no-op when stdout isn't a TTY.
-  // Defensive overwrite — terminals that miscount emoji width (JetBrains JediTerm
-  // is the known case, but others surface periodically) leave the cursor at the
-  // wrong column, which makes trailing `\x1b[K` erase the wrong region and
-  // leftover bytes from the previous frame fuse with the new one ("4:54" + "8"
-  // → "4:548"). Appending a run of spaces overwrites those leftover bytes
-  // positionally without any clear-then-redraw step (so no flicker), and is
-  // invisible on terminals that already redraw cleanly. `\x1b[K` still mops up
-  // anything beyond the padding.
-  return segs.join(' · ') + ' '.repeat(40) + '\x1b[K';
+  // (longer) statusline render don't bleed into ours. \x1b[K is the standard
+  // "erase from cursor to EOL" CSI; safe on any ANSI-compatible terminal and
+  // a no-op when stdout isn't a TTY.
+  return segs.join(' · ') + '\x1b[K';
 }