claude-token-saver 3.23.0 → 3.23.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-token-saver",
-  "version": "3.23.0",
+  "version": "3.23.2",
   "description": "Route the easy work your expensive Claude model keeps repeating down to haiku/sonnet — post-hoc session analysis, no realtime router, no extra LLM calls.",
   "type": "module",
   "bin": {

package/src/commands/route-scan.js

@@ -161,6 +161,14 @@ export async function run({ args, hasFlag, numArg }) {
       // one rule and the file carries another.
       const mrHook = await import('../model-rules.js');
       const composed = (base, c) => mrHook.composeRuleText(base, c, lang);
+      // Re-render ratchet-model.md from THIS version's template. Rule text is
+      // composed in code, so an upgrade that rewords it leaves every existing
+      // file stale, and the rewrite used to ride along with refreshModelRules
+      // — which only runs on a rescan. A session that starts on a warm cache
+      // would keep reading the old wording indefinitely. The call writes only
+      // when the rendering differs, so the common case is a read and a string
+      // compare.
+      try { mrHook.syncAllFiles(); } catch (e) { debug('route-scan:sync-ratchet', e); }
       // Registered rules whose delegated-category error rate crossed the
       // health threshold since promotion — the user approved these, so a
       // status change must be briefed, not just written into the md file.

package/src/korean-style.js

@@ -126,6 +126,7 @@ export function koreanStyleInjection({ cfg = loadConfig() } = {}) {
     '이 지침은 사용자가 claude-token-saver에 설정한 것입니다.',
     '적용 대상: 대화 답변, 그리고 새로 작성하거나 수정하는 마크다운·문서·보고서의 한국어 산문을 모두 포함합니다.',
     '적용 예외: 원문을 그대로 옮기는 인용, 코드, 코드 주석, 그리고 프로젝트의 기존 표기 관례를 따라야 하는 커밋 메시지와 로그 문자열입니다.',
+    '표기 규칙(예외 없이 적용): 도구 호출 인자에 한국어를 비롯한 비ASCII 문자열을 담을 때에는 반드시 리터럴 UTF-8로 작성하고, \\uXXXX 유니코드 이스케이프로는 절대 작성하지 마십시오. 이스케이프로 작성하면 글자가 깨진 채 파일에 기록되는 사례가 자주 발생합니다.',
     `(출처: ${KOREAN_STYLE_SOURCE})`,
     '',
     text,

package/src/model-rules.js

@@ -288,8 +288,15 @@ export function modelRatchetPathFor(scope, targetRoot) {
 
 /**
  * Regenerate ratchet-model.md for every target that carries model rules.
- * A target whose rules are all gone gets its file removed (it's fully
- * tool-owned, so deletion is safe).
+ * A target whose rules are all gone gets its file emptied — not deleted,
+ * because CLAUDE.md imports the path (see the note at the loop below).
+ *
+ * Writes are content-conditional: a target whose rendering already matches
+ * what is on disk is left alone, and the returned list names only the files
+ * that actually changed. That makes the call cheap enough to run on a cache
+ * hit, which is what closes the upgrade gap — the file is rendered from THIS
+ * version's template, so an upgrade that reworded the rules reaches the disk
+ * on the next session rather than waiting for a rescan to happen to fire.
  */
 export function syncAllFiles({ previousPaths = [] } = {}) {
   const data = loadModelRules();
@@ -299,19 +306,30 @@ export function syncAllFiles({ previousPaths = [] } = {}) {
     if (!byPath.has(p)) byPath.set(p, []);
     byPath.get(p).push(r);
   }
-  const written = [];
-  for (const [p, rules] of byPath) {
+  // Skip the write when the file already says exactly this. An unreadable or
+  // missing file reads as "" and therefore always differs, which is the right
+  // outcome — it gets written.
+  const writeIfChanged = (p, text) => {
+    try {
+      if (existsSync(p) && readFileSync(p, 'utf8') === text) return false;
+    } catch { /* unreadable → fall through and rewrite it */ }
     try {
       mkdirSync(dirname(p), { recursive: true });
-      writeFileSync(p, renderModelRatchet(rules));
-      written.push(p);
-    } catch { /* unwritable target — skip, registry stays authoritative */ }
+      writeFileSync(p, text);
+      return true;
+    } catch {
+      return false; // unwritable target — skip, registry stays authoritative
+    }
+  };
+  const written = [];
+  for (const [p, rules] of byPath) {
+    if (writeIfChanged(p, renderModelRatchet(rules))) written.push(p);
   }
   // A target that lost its last rule is emptied, NOT deleted: CLAUDE.md
   // imports this path, and a dangling `@` import is worse than an empty file.
   for (const p of previousPaths) {
     if (!byPath.has(p) && existsSync(p)) {
-      try { writeFileSync(p, renderModelRatchet([])); } catch { /* stale content; regenerated next sync */ }
+      if (writeIfChanged(p, renderModelRatchet([]))) written.push(p);
     }
   }
   return written;