claude-token-saver 3.9.1 → 3.9.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 rootstudioyaml
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.en.md

@@ -17,6 +17,23 @@ npm i -g claude-token-saver   # postinstall auto-registers the statusline + Skil
 
 ![statusline example](./docs/statusline.png)
 
+## 📺 Came here from the video? — 60 seconds
+
+This is not a router. It never intercepts a request in realtime.
+**After a session ends** it reads your local logs, finds the easy patterns your expensive model
+kept handling, and promotes them into rules so a cheaper model takes them **from the next session
+onward**. Rules are scoped global or per-project.
+
+```bash
+npm i -g claude-token-saver@latest
+claude-token-saver route-scan         # find delegation candidates in your own history (0 LLM calls)
+claude-token-saver route-scan rules   # list promoted rules · rm <N> to remove
+```
+
+Thresholds come from **your own last-14-day distribution (p25/p75)**, not someone else's benchmark.
+Measured rule-health — whether a delegated run actually succeeded — landed in [v3.9.0](#v390-2026-08-01).
+
+
 ## ⚡ Why — the 30-second pitch
 
 | | |
@@ -265,6 +282,12 @@ Also update `statusLine.command` in `~/.claude/settings.json` to `claude-token-s
 
 ## Release notes
 
+### v3.9.2 (2026-08-01)
+- **Added a LICENSE file (MIT)** — the field existed in `package.json` but the file did not, which blocked license review for company adoption. It ships in the npm tarball now via `files`.
+- **Package description and keywords rewritten for what this actually does** — leftover cache-monitoring copy meant it never surfaced for `model-routing` / `delegation` / `subagent`.
+- **A 60-second on-ramp at the top of the README** — that this is post-hoc analysis rather than a router, plus the three commands from install to seeing your own numbers.
+- **One-time note in `route-scan`** — prints the explainer link exactly once. Disable with `CTS_NO_NOTE=1`.
+
 ### v3.9.1 (2026-08-01)
 - **compact-window now recommends a 400k–700k band instead of a single 400k** — 400k proved too tight in practice and compacted too often. The advice is a range now, and **a window inside it (or below it) is never warned about**; only an unset value or one above 700k raises `🅷⚠ compact-window?` and the briefing. `set` defaults to 500k (mid-band); pick your own with `--value 600k`.
 

package/README.md

@@ -17,6 +17,22 @@ npm i -g claude-token-saver   # postinstall이 statusline + Skill 자동 등록
 
 ![statusline 예시](./docs/statusline.png)
 
+## 📺 영상 보고 오셨다면 — 60초
+
+라우터가 아닙니다. 요청을 실시간으로 가로채지 않습니다.
+**세션이 끝난 뒤** 로컬 기록을 읽어서, 비싼 모델이 반복해서 처리해 온 쉬운 유형을 뽑고,
+그 유형은 **다음 세션부터** 싼 모델이 맡도록 룰로 겁니다. 룰은 글로벌·프로젝트로 범위가 나뉩니다.
+
+```bash
+npm i -g claude-token-saver@latest
+claude-token-saver route-scan         # 내 지난 세션에서 위임 후보 뽑기 (LLM 호출 0)
+claude-token-saver route-scan rules   # 승격된 룰 확인 · rm <N> 으로 삭제
+```
+
+기준선은 남의 벤치마크가 아니라 **내 최근 14일 분포(p25/p75)** 로 잡습니다.
+넘긴 뒤 실제로 잘 됐는지까지 재는 실측 rule-health는 [v3.9.0](#v390-2026-08-01)에 들어갔습니다.
+
+
 ## ⚡ 왜 쓰나 — 30초 요약
 
 | | |
@@ -222,6 +238,12 @@ npm uninstall -g claude-cache-monitor && npm i -g claude-token-saver
 
 ## 릴리스 노트
 
+### v3.9.2 (2026-08-01)
+- **LICENSE 파일 추가 (MIT)** — `package.json`에만 있고 파일이 없어서, 사내 도입 검토 시 라이선스 확인이 막히던 문제. npm 패키지에도 포함되도록 `files`에 넣었습니다.
+- **패키지 설명·키워드를 현재 기능에 맞게 교체** — 캐시 모니터링 시절 문구가 남아 있어 모델 위임(`model-routing`·`delegation`·`subagent`)으로 검색되지 않았습니다.
+- **README 상단에 60초 진입로** — 라우터가 아니라 사후 분석이라는 점과, 설치부터 내 숫자 확인까지의 명령 3줄.
+- **`route-scan` 최초 1회 안내** — 기능 설명 영상 링크를 딱 한 번만 출력합니다. `CTS_NO_NOTE=1`로 끕니다.
+
 ### v3.9.1 (2026-08-01)
 - **compact-window 권장값이 단일 40만에서 40만~70만 범위로** — 40만은 실사용에서 너무 빡빡해 압축이 잦았습니다. 이제 범위를 제안하고, **그 안(또는 그보다 낮게) 잡아둔 세션은 경고하지 않습니다.** 미설정이거나 70만 초과일 때만 `🅷⚠ compact-window?`와 브리핑이 뜹니다. `set`의 기본값도 범위 중간인 50만으로 올렸고, 원하는 값은 `--value 600k`로 지정합니다.
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "claude-token-saver",
-  "version": "3.9.1",
-  "description": "Save tokens on Claude Code — spike diagnosis, 1M-context detection, TTL countdown, statusline. (formerly claude-cache-monitor)",
+  "version": "3.9.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": {
     "claude-token-saver": "bin/cli.js"
@@ -16,22 +16,27 @@
     "presets/",
     "examples/",
     "README.md",
-    "README.en.md"
+    "README.en.md",
+    "LICENSE"
   ],
   "engines": {
     "node": ">=18"
   },
   "keywords": [
     "claude",
+    "claude-code",
     "anthropic",
-    "cache",
-    "monitoring",
+    "model-routing",
+    "llm-router",
+    "delegation",
+    "subagent",
+    "haiku",
+    "cost-savings",
+    "token-usage",
     "prompt-caching",
-    "cli",
+    "cache",
     "statusline",
-    "claude-code",
-    "token-usage",
-    "cost-savings",
+    "cli",
     "1m-context"
   ],
   "license": "MIT",

package/src/commands/route-scan.js

@@ -202,6 +202,7 @@ export async function run({ args, hasFlag, numArg }) {
       console.log(lang === 'ko'
         ? '위임 후보 없음 (반복 3회 미만이거나 이미 처리됨).'
         : 'No delegation candidates (below recurrence threshold or already resolved).');
+      (await import('../first-run-note.js')).printOnce('route-scan', lang);
       return;
     }
     console.log(lang === 'ko' ? '\n위임 후보 (R<N>=후보 번호, T2/T1=난이도 등급):' : '\nDelegation candidates (R<N> = candidate id, T2/T1 = difficulty tier):');
@@ -223,5 +224,7 @@ export async function run({ args, hasFlag, numArg }) {
     console.log(lang === 'ko' ? '등록 / 무시:' : 'Promote / dismiss:');
     console.log('  claude-token-saver harness promote R<N> --project|--global');
     console.log('  claude-token-saver route-scan dismiss <N>');
+    // 최초 1회만 — 매번 찍으면 도구가 광고판이 된다 (CTS_NO_NOTE=1 로 끔)
+    (await import('../first-run-note.js')).printOnce('route-scan', lang);
     return;
 }

package/src/first-run-note.js

@@ -0,0 +1,63 @@
+/**
+ * first-run-note — a one-time pointer to where a feature is explained.
+ *
+ * A CLI that advertises on every invocation stops being a tool, so this fires
+ * ONCE per note key and then never again: the shown-at timestamp is persisted
+ * next to the other state files and checked before anything is printed.
+ *
+ * Opt out entirely with CTS_NO_NOTE=1 (also honoured by anything that pipes
+ * our output somewhere it does not belong).
+ */
+
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { userDataDir } from './paths.js';
+
+export function firstRunStatePath() {
+  return join(userDataDir(), 'first-run.json');
+}
+
+function load() {
+  try {
+    const s = JSON.parse(readFileSync(firstRunStatePath(), 'utf8'));
+    return s && typeof s === 'object' ? s : {};
+  } catch {
+    return {};
+  }
+}
+
+function markShown(key, now) {
+  const state = load();
+  state[key] = now;
+  const dir = userDataDir();
+  if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
+  writeFileSync(firstRunStatePath(), JSON.stringify(state) + '\n');
+}
+
+/** True only the first time this key is asked about. Best-effort — a
+ *  read-only state dir just means the note repeats, never that we crash. */
+export function shouldShowOnce(key, { now = Date.now() } = {}) {
+  if (process.env.CTS_NO_NOTE === '1') return false;
+  if (load()[key]) return false;
+  try {
+    markShown(key, now);
+  } catch {
+    /* state dir unwritable — show it, do not fail the command */
+  }
+  return true;
+}
+
+const NOTES = {
+  'route-scan': {
+    ko: '📺 이 기능을 설명한 영상: https://www.youtube.com/@DeepPulseKR  (이 안내는 한 번만 표시됩니다)',
+    en: '📺 How this works, in 3 minutes: https://www.youtube.com/@DeepPulseEN  (shown once)',
+  },
+};
+
+/** Print the one-time note for `key`, or nothing. */
+export function printOnce(key, lang = 'en') {
+  const note = NOTES[key];
+  if (!note || !shouldShowOnce(key)) return;
+  console.log('');
+  console.log(lang === 'ko' ? note.ko : note.en);
+}