claude-token-saver 3.6.0 → 3.6.1

package/README.en.md

@@ -243,6 +243,10 @@ Also update `statusLine.command` in `~/.claude/settings.json` to `claude-token-s
 
 ## Release notes
 
+### v3.6.1 (2026-07-26)
+- **Fixed state files splitting apart on macOS and Windows** — `route-scan.json`, `model-rules.json`, and `brief-state.json` each carried a private copy of the path resolver, and those copies honored `XDG_CONFIG_HOME` on Linux only. With XDG set on macOS or Windows, `config.json` and the session cache moved while those three stayed at the platform default, so delegation-candidate briefings and promoted rules silently vanished. All of them now resolve through `paths.js`. (Caught by the 3-OS CI added in v3.6.0; a regression test now keeps a fourth copy from reappearing.)
+- Fixed `npm test` failing on Node 22 — Node 22 resolves the directory argument of `node --test test/` as a module path.
+
 ### v3.6.0 (2026-07-26)
 - **Statusline refreshes stop re-parsing everything** — parsed sessions are now cached under a `(path, mtime, size)` key. Transcripts are append-only, so that triple is a sound identity for a parse result. On a 217MB / 226-file 30-day window every refresh used to spend ~3s re-reading files that could not have changed; now only the files that actually grew (in practice, the current session) are read. A stale or corrupt cache is never fatal — every read path falls back to a full parse.
 - **ratchet-model.md renders in English** — the model reads this file as instructions, so a Korean-only file dragged English sessions into Korean. Header, rule text, and rule-health warnings now follow the `language` setting. Category labels and rule text are stored in both languages at scan time, so switching languages takes effect immediately without a rescan.

package/README.md

@@ -200,6 +200,10 @@ npm uninstall -g claude-cache-monitor && npm i -g claude-token-saver
 
 ## 릴리스 노트
 
+### v3.6.1 (2026-07-26)
+- **macOS·Windows에서 상태 파일이 갈라지던 버그 수정** — `route-scan.json` / `model-rules.json` / `brief-state.json`이 각자 복제된 경로 해석 함수를 갖고 있었고, 그 복사본들은 `XDG_CONFIG_HOME`을 리눅스에서만 인정했습니다. 그래서 macOS·Windows에서 XDG를 설정하면 `config.json`·세션 캐시만 옮겨가고 위 세 파일은 플랫폼 기본 경로에 남아, 위임 후보 브리핑과 룰이 조용히 사라졌습니다. 이제 전부 `paths.js` 한 곳에서 해석합니다. (v3.6.0에서 도입한 3-OS CI가 잡아낸 버그 — 복제본이 다시 생기지 않도록 회귀 테스트 추가)
+- `npm test` 스크립트가 Node 22에서 실패하던 문제 수정 (`node --test test/`의 디렉터리 인자를 Node 22가 모듈 경로로 해석).
+
 ### v3.6.0 (2026-07-26)
 - **statusline 재실행 비용 제거** — 세션 파싱 결과를 `(경로, mtime, size)` 키로 캐싱. 트랜스크립트는 append-only라 이 조합이 파싱 결과의 정확한 신원이 됨. 217MB/226파일 30일 창 기준 매 갱신마다 3초씩 재파싱하던 것이 변경된 파일(사실상 현재 세션 1개)만 읽는 것으로 축소. 캐시가 깨져도 항상 전체 파싱으로 폴백하므로 실패 경로 없음.
 - **ratchet-model.md 영문 렌더링** — 이 파일은 LLM이 지시문으로 읽기 때문에, 한글 전용 파일은 영어 세션의 응답까지 한글로 끌어당김. `language` 설정에 따라 헤더·룰 원문·rule-health 경고를 영문으로 렌더. 카테고리 라벨과 룰 원문은 스캔 시점에 양쪽 언어로 저장돼, 언어를 바꿔도 재스캔 없이 즉시 반영.

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "claude-token-saver",
-  "version": "3.6.0",
+  "version": "3.6.1",
   "description": "Save tokens on Claude Code — spike diagnosis, 1M-context detection, TTL countdown, statusline. (formerly claude-cache-monitor)",
   "type": "module",
   "bin": {
     "claude-token-saver": "bin/cli.js"
   },
   "scripts": {
-    "test": "node --test test/",
+    "test": "node --test",
     "postinstall": "node bin/cli.js install || true"
   },
   "files": [

package/src/brief.js

@@ -27,7 +27,7 @@
 
 import { readFileSync, writeFileSync, existsSync, mkdirSync, statSync, openSync, readSync, closeSync } from 'node:fs';
 import { join } from 'node:path';
-import { homedir } from 'node:os';
+import { userDataDir } from './paths.js';
 
 // Context tiers as a fraction of the session's context window. Tier 1 warns
 // (compaction/cost territory ahead), tier 2 urges wrapping up. A session only
@@ -41,16 +41,9 @@ const WINDOW_1M_MIN_INPUT = 250_000;
 const PRUNE_MS = 7 * 24 * 60 * 60 * 1000;
 const TAIL_BYTES = 256 * 1024;
 
-function stateDir() {
-  if (process.platform === 'win32') {
-    return join(process.env.APPDATA || homedir(), 'claude-token-saver');
-  }
-  if (process.platform === 'darwin') {
-    return join(homedir(), 'Library', 'Application Support', 'claude-token-saver');
-  }
-  const xdg = process.env.XDG_CONFIG_HOME || join(homedir(), '.config');
-  return join(xdg, 'claude-token-saver');
-}
+// See the note in route-scan.js — paths.js is the only place that resolves
+// this, so an XDG_CONFIG_HOME override moves every state file together.
+const stateDir = userDataDir;
 
 export function briefStatePath() {
   return join(stateDir(), 'brief-state.json');

package/src/model-rules.js

@@ -31,6 +31,7 @@
 import { readFileSync, writeFileSync, existsSync, mkdirSync, unlinkSync } from 'node:fs';
 import { join, dirname } from 'node:path';
 import { homedir } from 'node:os';
+import { userDataDir } from './paths.js';
 import { userLanguage } from './config.js';
 
 // Post-promotion delegated-category error rate above this flags the rule
@@ -41,16 +42,9 @@ export const HEALTH_ERR_RATE = 0.2;
 // withheld until the sample is large enough to mean something.
 export const HEALTH_MIN_SAMPLE = 10;
 
-function stateDir() {
-  if (process.platform === 'win32') {
-    return join(process.env.APPDATA || homedir(), 'claude-token-saver');
-  }
-  if (process.platform === 'darwin') {
-    return join(homedir(), 'Library', 'Application Support', 'claude-token-saver');
-  }
-  const xdg = process.env.XDG_CONFIG_HOME || join(homedir(), '.config');
-  return join(xdg, 'claude-token-saver');
-}
+// See the note in route-scan.js — paths.js is the only place that resolves
+// this, so an XDG_CONFIG_HOME override moves every state file together.
+const stateDir = userDataDir;
 
 export function modelRulesPath() {
   return join(stateDir(), 'model-rules.json');

package/src/route-scan.js

@@ -19,7 +19,7 @@
 
 import { readFileSync, writeFileSync, existsSync, mkdirSync, statSync } from 'node:fs';
 import { join } from 'node:path';
-import { homedir } from 'node:os';
+import { userDataDir } from './paths.js';
 import { discoverSessionFiles } from './parser.js';
 import { collectSessionRecords } from './session-records.js';
 
@@ -159,16 +159,10 @@ function keywordScore(cat, text) {
 const SKIP_RE = /^(계속|이어서|continue|다음|proceed|진행|응|네|넵|ok|okay|yes|ㄱ+|고고)\b/i;
 const SKIP_PREFIX = ['<task-notification', '<system', '[Image:', '<local-command'];
 
-function stateDir() {
-  if (process.platform === 'win32') {
-    return join(process.env.APPDATA || homedir(), 'claude-token-saver');
-  }
-  if (process.platform === 'darwin') {
-    return join(homedir(), 'Library', 'Application Support', 'claude-token-saver');
-  }
-  const xdg = process.env.XDG_CONFIG_HOME || join(homedir(), '.config');
-  return join(xdg, 'claude-token-saver');
-}
+// Single source of truth for the state dir (paths.js). A local copy used to
+// live here and honored XDG_CONFIG_HOME on Linux only, so on macOS/Windows an
+// XDG override split this cache away from config.json and the session cache.
+const stateDir = userDataDir;
 
 export function routeScanCachePath() {
   return join(stateDir(), 'route-scan.json');