claude-token-saver 3.16.0 → 3.17.0

package/README.en.md

@@ -6,9 +6,7 @@
 
 ## 🔀 Routing saved — the reason this tool exists
 
-```
-🔀 Routing saved $2.09  |  fable→sonnet 1× $0.72 · opus→haiku 1× $0.57 · fable→haiku 1× $0.51 · opus→sonnet 2× $0.29
-```
+![statusline example — routing savings on row 1, diagnostics on row 2](./docs/statusline.png)
 
 **That figure on the first statusline row is the whole product.** It is money actually saved by moving the easy work your expensive model kept repeating onto cheaper ones — and right beside it is which model that money moved off, and onto what.
 
@@ -40,8 +38,6 @@ By run (newest first):
 npm i -g claude-token-saver   # postinstall auto-registers the statusline + Skill
 ```
 
-![statusline example](./docs/statusline.png)
-
 ---
 
 ## ⚡ Why — the 30-second pitch
@@ -87,6 +83,8 @@ npm i -g claude-token-saver
 
 The statusline appears at the bottom of Claude Code right away. If auto-registration was skipped (`--ignore-scripts`, sudo, sandboxed installs), run `claude-token-saver install`.
 
+One install sets up everything: **statusline, Skill, SessionStart hook, the 🅷 Harness (5 principles), and a first route-scan.** The harness is **appended** to `~/.claude/CLAUDE.md` as a marked block (your existing content is backed up and preserved) and is left alone if one is already there. Skip it with `CTS_NO_HARNESS=1 npm i -g claude-token-saver`; undo it with `claude-token-saver harness uninit --global`.
+
 > ⚠️ Avoid `sudo` global installs — the Skill lands in root's `~/.claude` instead of yours. Use nvm/fnm/Volta or `npm config set prefix ~/.npm-global`.
 
 ## Reading the statusline
@@ -339,6 +337,10 @@ Also update `statusLine.command` in `~/.claude/settings.json` to `claude-token-s
 
 ## Release notes
 
+### v3.17.0 (2026-08-22)
+- **One install now sets up the 🅷 Harness too** — until now `harness init` was a separate step, without which the 🅷 score and ratchet-rule delivery did nothing. The install **appends** the 5-principle block to `~/.claude/CLAUDE.md` (existing content backed up and preserved; an existing block is left alone). Skip with `CTS_NO_HARNESS=1`, undo with `harness uninit --global`.
+- **The README leads with the real statusline screenshot** — the capture replaces the code block at the top, and the duplicate image further down was removed.
+
 ### v3.16.0 (2026-08-22)
 - **README restructured around routing savings** — `🔀 Routing saved` now opens the page, with how the figure is derived (before / after / gap) and the real `route-scan savings` output alongside it. Channel and homepage badges moved to a "Who makes this" section at the bottom.
 - **Statusline screenshot refreshed to the current two-row layout** — captured from real output rather than mocked up. Regenerate with `npm run docs:statusline` (headless Chrome; no dependencies added).

package/README.md

@@ -6,9 +6,7 @@
 
 ## 🔀 Routing saved — 이 도구가 존재하는 이유
 
-```
-🔀 Routing saved $2.09  |  fable→sonnet 1× $0.72 · opus→haiku 1× $0.57 · fable→haiku 1× $0.51 · opus→sonnet 2× $0.29
-```
+![statusline 예시 — 1줄째 라우팅 절감, 2줄째 진단 칩](./docs/statusline.png)
 
 **statusline 첫 줄에 뜨는 이 금액이 전부입니다.** 비싼 모델이 반복 처리해 온 쉬운 작업을 더 싼 모델로 내려보내서 **실제로 아낀 돈**이고, 옆에는 그 돈이 어느 모델에서 어느 모델로 옮겨서 생겼는지가 그대로 붙습니다.
 
@@ -40,8 +38,6 @@ $ claude-token-saver route-scan savings
 npm i -g claude-token-saver   # postinstall이 statusline + Skill 자동 등록
 ```
 
-![statusline 예시](./docs/statusline.png)
-
 ---
 
 ## ⚡ 왜 쓰나 — 30초 요약
@@ -86,6 +82,8 @@ npm i -g claude-token-saver
 
 설치 즉시 Claude Code 하단에 statusline이 나타납니다. `--ignore-scripts`/sudo 등으로 자동 등록이 안 됐다면 `claude-token-saver install`로 수동 등록하세요.
 
+설치 한 번으로 **statusline · Skill · SessionStart 훅 · 🅷 Harness(5원칙) · 최초 route-scan** 이 모두 준비됩니다. Harness는 `~/.claude/CLAUDE.md`에 표시된 블록으로 **추가**되며(기존 내용은 백업 후 보존), 이미 설정돼 있으면 건드리지 않습니다. 원치 않으면 `CTS_NO_HARNESS=1 npm i -g claude-token-saver`로 건너뛰고, 되돌리려면 `claude-token-saver harness uninit --global`을 실행하세요.
+
 > ⚠️ sudo 글로벌 설치는 Skill이 root의 `~/.claude`에 등록되는 함정이 있습니다 — nvm/fnm/Volta로 사용자 영역 설치를 권장합니다.
 
 ## statusline 읽는 법
@@ -305,6 +303,10 @@ npm uninstall -g claude-cache-monitor && npm i -g claude-token-saver
 
 ## 릴리스 노트
 
+### v3.17.0 (2026-08-22)
+- **설치 한 번으로 🅷 Harness까지 적용됩니다** — 지금까지는 설치 후 `harness init`을 따로 실행해야 statusline의 🅷 점수와 ratchet 룰 전달이 동작했습니다. 이제 설치가 `~/.claude/CLAUDE.md`에 5원칙 블록을 **추가**합니다(기존 내용은 백업 후 보존, 이미 있으면 건드리지 않음). 건너뛰려면 `CTS_NO_HARNESS=1`, 되돌리려면 `harness uninit --global`.
+- **README 상단을 statusline 실제 스크린샷으로 교체** — 코드 블록 대신 실제 캡처를 최상단에 두고, 아래쪽에 중복으로 있던 이미지는 뺐습니다.
+
 ### v3.16.0 (2026-08-22)
 - **README를 라우팅 절감 중심으로 재구성** — 이 도구의 핵심이 무엇인지 첫 화면에서 바로 보이도록 `🔀 Routing saved`를 최상단에 올리고, 금액이 원장에서 어떻게 나오는지(before/after/차액)와 `route-scan savings` 실제 출력을 함께 실었습니다. 채널·홈페이지 배지는 최하단 "만든 곳"으로 내렸습니다.
 - **statusline 스크린샷을 현재 2줄 레이아웃으로 갱신** — 목업이 아니라 실제 출력을 캡처합니다. `npm run docs:statusline`으로 재생성할 수 있습니다(headless Chrome 사용, 의존성 추가 없음).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-token-saver",
-  "version": "3.16.0",
+  "version": "3.17.0",
   "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/install.js

@@ -59,6 +59,55 @@ export async function run({ hasFlag }) {
         } catch (e) { debug('install:route-scan-seed', e); /* hook-triggered scan covers it on the first session instead */ }
       }
     }
+    // Harness, set up as part of the install rather than left as a manual
+    // follow-up step. The 🅷 statusline segment and the ratchet rules that
+    // route-scan promotes both depend on the block existing in CLAUDE.md, so
+    // an install without it ships a tool that is half wired up.
+    //
+    // Scope is global (~/.claude/CLAUDE.md): a global install is not tied to
+    // any one project, and the harness principles are project-independent.
+    // Only ever ADDS — harnessInit appends its own marked block, backs up the
+    // previous file, and leaves surrounding content untouched. Skipped when a
+    // block is already there (nothing to do) and when CTS_NO_HARNESS=1 is set,
+    // for anyone who wants the statusline without the CLAUDE.md rules.
+    try {
+      const { harnessInit, harnessStatus } = await import('../harness.js');
+      const before = harnessStatus(undefined, { scope: 'global' });
+      if (process.env.CTS_NO_HARNESS === '1') {
+        console.log('');
+        console.log(lang === 'ko'
+          ? '  harness: CTS_NO_HARNESS=1 이므로 건너뜁니다 (나중에 `harness init --global`).'
+          : '  harness: skipped (CTS_NO_HARNESS=1) — run `harness init --global` later.');
+      } else if (before.hasBlock) {
+        console.log('');
+        console.log(lang === 'ko'
+          ? `  harness: 이미 설정됨 — 🅷 ${before.configured}/${before.total} (${before.file})`
+          : `  harness: already set up — 🅷 ${before.configured}/${before.total} (${before.file})`);
+      } else {
+        const h = harnessInit({ scope: 'global' });
+        console.log('');
+        for (const p of h.backedUp) {
+          console.log(lang === 'ko' ? `  harness: 백업 ${p}` : `  harness: backed up ${p}`);
+        }
+        for (const p of h.wrote) {
+          console.log(lang === 'ko' ? `  harness: 작성 ${p}` : `  harness: wrote ${p}`);
+        }
+        console.log(lang === 'ko'
+          ? '  harness: 5원칙을 ~/.claude/CLAUDE.md 에 설정했습니다 — statusline에 🅷 5/5 가 표시됩니다.'
+          : '  harness: 5 principles installed in ~/.claude/CLAUDE.md — the statusline now shows 🅷 5/5.');
+        console.log(lang === 'ko'
+          ? '           되돌리려면: claude-token-saver harness uninit --global'
+          : '           to undo: claude-token-saver harness uninit --global');
+      }
+    } catch (e) {
+      // Never fail an install over this — the statusline and Skill are already
+      // in place, and `harness init` remains available as a manual step.
+      debug('install:harness-init', e);
+      console.log(lang === 'ko'
+        ? '  harness: 자동 설정을 건너뛰었습니다 — `claude-token-saver harness init --global` 로 직접 설정하세요.'
+        : '  harness: auto-setup skipped — run `claude-token-saver harness init --global` yourself.');
+    }
+
     console.log('');
     console.log('Open Claude Code in any directory and just mention:');
     console.log('  "cache hit rate" / "1M context" / "5H cap" — the skill auto-activates.');