claude-token-saver 3.6.3 → 3.6.4

package/README.en.md

@@ -243,6 +243,9 @@ Also update `statusLine.command` in `~/.claude/settings.json` to `claude-token-s
 
 ## Release notes
 
+### v3.6.4 (2026-07-29)
+- **Fixed: false `🅷⚠ ratchet-unloaded`** — the import check looked at a single CLAUDE.md. When the project file carried the harness block, only that file was inspected, so the common layout of block-in-project + `@` imports-in-global raised the warning even though the rules loaded fine. Claude Code loads both files, so the flags are now the union of the two, and `importSource` (`project`/`global`/`both`) says which file carries them. The warning fires only when neither file imports.
+
 ### v3.6.3 (2026-07-27)
 - **Fixed: approved ratchet rules never reached the session** — `harness promote` appended rules to `ratchet.md`, but nothing ever read that file. Claude Code loads `CLAUDE.md` (plus whatever it imports) and the harness block carried no import line, so "approved rules apply automatically from the next session" was unimplemented. The block now imports `@.claude/ratchet.md` (project) / `@~/.claude/ratchet.md` (global). Re-running `harness init` upgrades an existing block in place.
 - **`ratchet-model.md` is imported explicitly too** — delegation rules now travel the same declared path instead of relying on a host that happens to pick the file up. To keep the import from dangling, `harness init` seeds an empty file and `syncAllFiles` empties rather than deletes a target that loses its last rule.

package/README.md

@@ -200,6 +200,9 @@ npm uninstall -g claude-cache-monitor && npm i -g claude-token-saver
 
 ## 릴리스 노트
 
+### v3.6.4 (2026-07-29)
+- **`🅷⚠ ratchet-unloaded`가 잘못 뜨던 버그 수정** — import 여부를 CLAUDE.md 한 파일에서만 확인했습니다. 프로젝트 `CLAUDE.md`에 harness 블록이 있으면 그 파일만 보고 판정했기 때문에, `@` import가 글로벌 `~/.claude/CLAUDE.md`에 있는 흔한 조합에서는 룰이 정상 로드되는데도 경고가 떴습니다. Claude Code는 두 파일을 모두 로드하므로 이제 양쪽의 import를 합쳐서 판정하고, 어느 쪽이 들고 있는지는 `importSource`(`project`/`global`/`both`)로 알려줍니다. 두 파일 다 import가 없을 때만 경고합니다.
+
 ### v3.6.3 (2026-07-27)
 - **승인한 ratchet 룰이 세션에 전달되지 않던 버그 수정** — `harness promote`는 룰을 `ratchet.md`에 append했지만, 그 파일을 읽는 소비자가 어디에도 없었습니다. Claude Code는 `CLAUDE.md`(와 그것이 import하는 파일)만 로드하는데 harness 블록에 import 라인이 없었기 때문에, "승인된 룰은 다음 세션부터 자동 적용"은 사실상 미구현 상태였습니다. 이제 harness 블록이 `@.claude/ratchet.md`(project) / `@~/.claude/ratchet.md`(global)를 import합니다. `harness init`을 다시 돌리면 기존 블록도 제자리에서 갱신됩니다.
 - **`ratchet-model.md`도 명시적으로 import** — 모델 피팅 룰도 호스트가 알아서 읽어주길 기대하지 않고 같은 경로로 전달합니다. import가 끊기지 않도록 `harness init`이 빈 파일을 미리 만들고, 마지막 룰이 사라져도 `syncAllFiles`가 파일을 지우는 대신 비웁니다.

package/package.json

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

package/src/harness.js

@@ -153,15 +153,37 @@ function statusForFile(filePath) {
  *     relies on a globally-installed harness report 🅷 5/5 (covered by global),
  *     matching reality: Claude Code loads ~/.claude/CLAUDE.md for every project.
  * The returned `source` ('project'|'global') tells callers which file was used.
+ *
+ * The `@` import flags are the union of both files, not just the source one:
+ * Claude Code loads ~/.claude/CLAUDE.md for every project *and* the project
+ * CLAUDE.md, so a project-scope block with the imports living in the global
+ * file still gets the ratchet rules. Checking only the source file made that
+ * layout report a false `ratchet-unloaded`. `importSource` says which file
+ * actually carries them ('project' | 'global' | 'both' | null).
  */
 export function harnessStatus(root = findProjectRoot(), { scope = 'auto' } = {}) {
-  if (scope === 'project') return { ...statusForFile(claudeMdPath(root)), root, source: 'project' };
-  if (scope === 'global') return { ...statusForFile(globalClaudeMdPath()), root, source: 'global' };
   const project = statusForFile(claudeMdPath(root));
-  if (project.hasBlock) return { ...project, root, source: 'project' };
   const global = statusForFile(globalClaudeMdPath());
-  if (global.hasBlock) return { ...global, root, source: 'global' };
-  return { ...project, root, source: 'project' };
+  const pick = (s, source) => ({ ...s, ...unionImports(project, global), root, source });
+  if (scope === 'project') return pick(project, 'project');
+  if (scope === 'global') return pick(global, 'global');
+  if (project.hasBlock) return pick(project, 'project');
+  if (global.hasBlock) return pick(global, 'global');
+  return pick(project, 'project');
+}
+
+// Union the two files' import flags. Same file read twice (project root === ~)
+// is harmless — OR is idempotent.
+function unionImports(project, global) {
+  const samePath = project.file === global.file;
+  const g = samePath ? { hasRatchetImport: false, hasModelRatchetImport: false } : global;
+  const inProject = project.hasRatchetImport || project.hasModelRatchetImport;
+  const inGlobal = g.hasRatchetImport || g.hasModelRatchetImport;
+  return {
+    hasRatchetImport: project.hasRatchetImport || g.hasRatchetImport,
+    hasModelRatchetImport: project.hasModelRatchetImport || g.hasModelRatchetImport,
+    importSource: inProject && inGlobal ? 'both' : inProject ? 'project' : inGlobal ? 'global' : null,
+  };
 }
 
 /**