claude-token-saver 3.42.2 → 3.42.4

package/README.ko.md

@@ -5,7 +5,7 @@
   <img alt="Sprag" src="https://raw.githubusercontent.com/rootstudioyaml/sprag/main/site/assets/logo/sprag-lockup-light.svg" width="220">
 </picture>
 
-**AI 코딩 에이전트용 품질 래칫. 같은 실수는 두 번 없습니다.**
+**AI 코딩 에이전트용 품질 래칫**<br>**같은 실수는 두 번 없습니다**
 
 [![npm](https://img.shields.io/npm/v/sprag-cli.svg?label=sprag-cli)](https://www.npmjs.com/package/sprag-cli)
 [![downloads](https://img.shields.io/npm/dm/claude-token-saver.svg)](https://www.npmjs.com/package/claude-token-saver)
@@ -17,9 +17,11 @@
 
 ---
 
-# Sprag (sprag)
+# Sprag
 
-**아낀 돈을 두 줄로 보여 줍니다.** 비싼 모델이 반복하던 쉬운 작업을 싼 모델로 내려보내고, 모델이 읽지 못하는 문서를 Markdown 으로 바꿉니다. 두 절감액 모두 추정이 아니라 원장 기록입니다. 의존성 0, 설치 한 줄.
+**AI 코딩 에이전트에 거는 품질 래칫입니다. 에이전트는 그대로 일하고, 퇴행만 잠급니다.** 이름은 스프래그 클러치에서 왔습니다. 앞으로 도는 힘은 그대로 통과시키고, 역회전하는 순간 잠기는 부품입니다. Sprag는 Claude Code가 이미 남기는 세션 기록을 읽어 누적되는 이득으로 바꿉니다. 되풀이된 실패는 세션 시작마다 올라오는 규칙이 되고, 저렴한 티어가 감당한다고 증명된 작업은 실행 건마다 절감액 원장을 영수증 삼아 그쪽으로 위임되며, 캐시와 사용량 한도 문제는 아직 손쓸 수 있을 때 statusline에 나타납니다.
+
+아낀 돈은 두 줄로 보여 줍니다. 라우팅과 문서 변환이 각자 한 줄씩 차지하며, 두 수치 모두 추정이 아니라 원장 기록입니다. 의존성 0, API 키 불요, 데이터는 컴퓨터 밖으로 나가지 않습니다.
 
 ![statusline 예시. 첫 줄은 라우팅 절감액, 둘째 줄은 문서 변환 절감액, 셋째 줄은 진단 칩입니다](./docs/statusline.png)
 
@@ -45,16 +47,18 @@ gemini-2.5-pro        57.9%             $734  ▰▰▰▰▰▰▰▰▰▰▰
 
 v3.35.0 부터는 지출도 보입니다. 이번 달 1일 이후 쓴 금액을 `💵 Sep $42` 로 상시 표시하고, 5h/7d cap 이 아예 없는 LiteLLM 게이트웨이(Bedrock 등) 환경에서는 키 예산을 `🔑 budget ▰▱ 34% $34/$100` 게이지로 보여 줍니다.
 
-## 네 가지가 함께 돌아갑니다
+## 설치 한 번에 전부 들어 있고, 첫날부터 동작합니다
 
-| | 하는 일 | 효과 |
-|---|---|---|
-| 🔀 **라우팅** | 반복되는 쉬운 작업을 더 싼 모델에 위임 | 절감액을 원장에 실측 기록, 판별 기준은 공개 데이터로 [벤치마크](./docs/BENCHMARK.md) |
-| 📄 **문서 변환** | pptx·xlsx·pdf·docx·fig 를 읽기 전에 Markdown 으로 변환 | 발표자료 한 건에 **51만 토큰** 절약 |
-| 🅷 **Harness** | 증거 없는 완료 보고·검증 생략 차단 (5원칙) | **비용 −18.6%** |
-| ⚙️ **Ratchet** | 한 번 겪은 에러를 룰로 고정 | 같은 실수 재발 차단 |
+| | 하는 일 |
+|---|---|
+| ⚙️ **래칫 규칙** | 되풀이된 실패가 한 줄짜리 규칙이 되어 매 세션에 올라옵니다. 후보는 기록에서 자동으로 찾아 주고, 프로젝트 범위와 전역 범위 중 어느 쪽에 넣을지는 사용자가 고릅니다. |
+| 🔀 **모델 피팅** | 기록에서 뽑은 위임 규칙에 측정한 오류율과 절감액을 붙여 `ratchet-model.md`에 적습니다. 판별 기준은 공개 데이터로 [벤치마크](./docs/BENCHMARK.md)했습니다. |
+| 🅷 **하네스 점수** | 다섯 가지 운영 원칙을 실시간으로 점검합니다 ([비용 −18.6% 실측](#실제-효과-도입-전후-리포트)). 검증 단계를 건너뛰면 완료를 보고하기 전에 `🅷 4/5`가 먼저 알려 줍니다. |
+| 📊 **토큰 텔레메트리** | 캐시 적중률과 TTL, 컨텍스트 크기, 출력 급증, 두 가지 사용량 한도를 매 턴 프롬프트에 표시합니다. |
+| 📄 **doc2md** | pptx와 xlsx, pdf, docx, fig를 필요할 때 변환합니다. 문서를 통째로 붙이는 대신 변환본만 읽으면 됩니다 ([발표자료 한 건에 51만 토큰 절약](#-doc2md-문서를-읽기-전에-markdown-으로-바꿉니다)). |
+| 🇰🇷 **문체 게이트** | 쓰는 시점에 hook으로 검사합니다. 지금은 한국어 기술 문서를 지원하며 이중 피동과 번역투, 문장 연결을 살핍니다. |
 
-설치 한 번이면 넷 다 적용됩니다. 실측 −18.6%는 Harness와 ratchet의 몫이고, 라우팅과 문서 변환 절감액은 그 위에 얹힙니다. 두 절감액은 성격이 달라서 한 숫자로 합치지 않고, statusline 이 각각의 줄로 보여 주며 금액이 큰 쪽을 위에 놓습니다.
+실측 −18.6%는 하네스와 래칫의 몫이고, 라우팅과 문서 변환 절감액은 그 위에 얹힙니다. 두 절감액은 성격이 달라서 한 숫자로 합치지 않고, statusline이 각각의 줄로 보여 주며 금액이 큰 쪽을 위에 놓습니다.
 
 ## 목차
 
@@ -68,7 +72,6 @@ v3.35.0 부터는 지출도 보입니다. 이번 달 1일 이후 쓴 금액을 `
 **사전 준비:** Node.js ≥ 18 (`node -v`로 확인 · macOS `brew install node` · Windows `winget install OpenJS.NodeJS.LTS` · Linux/WSL은 [nvm](https://github.com/nvm-sh/nvm) 권장)
 
 ```bash
-npm uninstall -g claude-cache-monitor   # (구 패키지 사용자만)
 npm i -g sprag-cli
 ```
 
@@ -148,9 +151,11 @@ $ sprag route-scan savings      # 모든 금액을 룰 단위까지 역추적
 
 ## 라우터가 아닙니다: 60초 설명
 
-이 도구는 요청을 실시간으로 가로채지 않습니다.
-**세션이 끝난 뒤에** 로컬 기록을 읽어서 비싼 모델이 반복해서 처리해 온 쉬운 유형을 찾아내고,
-그 유형은 **다음 세션부터** 더 싼 모델이 맡도록 룰로 등록합니다. 룰의 적용 범위는 글로벌과 프로젝트로 나뉩니다.
+설치는 한 번이면 됩니다. 이미 쓰고 있는 세션을 그대로 읽으므로, 프롬프트를 쓰는 방식을 바꾸라고 요구하지 않습니다. 요청을 실시간으로 가로채거나 모델을 바꿔치기하지도 않습니다.
+
+1. **되풀이된 실패가 규칙이 됩니다.** 처음 겪는 실패는 그냥 작업입니다. 같은 실패가 두 번째로 나타나면 Sprag가 규칙 후보로 알립니다. 적용 범위를 승인하면 그 뒤로는 세션이 시작될 때마다 규칙이 함께 올라옵니다.
+2. **안전한 작업은 하위 에이전트가 맡습니다.** 이력상 안전하다고 확인된 작업과 맞아떨어지면, 더 저렴한 티어로 하위 에이전트를 띄워 처리하고 결과를 메인에게 돌려 검수하게 합니다. 틀려도 겉으로 드러나지 않는 작업은 메인 에이전트가 계속 맡습니다.
+3. **비용 문제를 미리 알려 줍니다.** 캐시 적중률과 TTL 만료, 컨텍스트 증가, 두 가지 사용량 한도를 매 턴 읽어 statusline에 띄웁니다. 아직 손쓸 수 있을 때 보입니다.
 
 ### 실시간 모델 라우팅이 오히려 비용을 키우는 이유
 
@@ -225,7 +230,7 @@ Claude Code 안에서 `/claude-token-saver` Skill을 실행하거나, 칩에 적
 | `sprag handoff` | 작업 상태를 `HANDOFF-*.md`로 백업 (캡 임박 시) |
 | `sprag mode [keywords...]` | 출력 설정 (`icon`/`text`, `ko`/`en`, `1h`~`30d` 윈도 등) |
 | `sprag harness ...` | 🅷 Harness 관리 (아래 참고) |
-| `sprag route-scan` | 상위 모델이 반복 처리한 쉬운 작업을 감지해 haiku 위임 랫쳇 룰을 제안합니다 (아래 참고) |
+| `sprag route-scan` | 상위 모델이 반복 처리한 쉬운 작업을 감지해 haiku 위임 래칫 룰을 제안합니다 (아래 참고) |
 | `sprag route-scan savings` | 라우팅 절감 원장입니다. 모델 이동별 합계와 실행별 내역을 함께 보여 주며, 표시되는 금액의 근거가 됩니다 |
 | `sprag compact-window` | 1M 컨텍스트를 쓰면서 자동 압축 창이 설정되지 않았으면 경고하고, `set`으로 40만에 고정합니다 (아래 참고) |
 | `sprag korean on\|off\|status` | 한국어 문체 지침을 세션 시작 시 주입하고, 쓰기 시점 검사를 함께 설치합니다 (아래 참고) |
@@ -264,14 +269,14 @@ sprag harness check               # 현재 점수 (글로벌 fallback 인정)
 sprag harness analyze             # 훅 없이도 수동으로 전사 분석을 실행해 harness-state.json 갱신
 sprag harness promote <N> --project|--global   # 경고 #N → ratchet 룰 (스코프 필수)
 sprag harness promote "<룰 텍스트>" --project|--global  # 내가 직접 정의한 룰도 같은 명령으로 등록
-sprag harness pull                # 패키지 동봉 큐레이션 룰 → 내 글로벌 랫쳇에 등록 (opt-in, 중복 스킵)
+sprag harness pull                # 패키지 동봉 큐레이션 룰 → 내 글로벌 래칫에 등록 (opt-in, 중복 스킵)
 sprag harness list / rm <N>       # 룰 조회 / 삭제 (자동 .bak)
 sprag harness off | on            # 🅷 표시 토글
 ```
 
 - `promote`는 non-TTY 환경(스크립트나 LLM 호출)에서 `--project` 또는 `--global` 플래그가 **반드시 필요합니다.** 적용 범위가 사용자에게 묻지 않은 채 결정되는 사고를 막기 위한 설계입니다.
-- `pull`은 패키지에 동봉된 **제작자 큐레이션 랫쳇 룰**(`presets/ratchet-rules.json`, 실제 반복 사고에서 승격된 범용 룰만)을 내 글로벌 랫쳇(`~/.claude/ratchet.md`)에 등록합니다. 설치(`install`)나 `init`은 아무것도 자동 주입하지 않으며, `pull`은 항상 opt-in이고 재실행해도 중복이 없습니다(멱등). 마음에 안 드는 룰은 `harness rm`으로 제거하면 됩니다.
-- `seed`는 같은 프리셋을 **한 건씩** 물어보는 경로입니다. `pull`이 랫쳇 룰 전체를 한 번에 등록하는 명령인 데 반해, `seed`는 모델 피팅 프리셋까지 포함해 설치·업그레이드 후 첫 세션에서 한 건씩 제안합니다 ([아래](#-seed-설치-직후부터-위임이-걸리게-하는-시작-룰)).
+- `pull`은 패키지에 동봉된 **제작자 큐레이션 래칫 룰**(`presets/ratchet-rules.json`, 실제 반복 사고에서 승격된 범용 룰만)을 내 글로벌 래칫(`~/.claude/ratchet.md`)에 등록합니다. 설치(`install`)나 `init`은 아무것도 자동 주입하지 않으며, `pull`은 항상 opt-in이고 재실행해도 중복이 없습니다(멱등). 마음에 안 드는 룰은 `harness rm`으로 제거하면 됩니다.
+- `seed`는 같은 프리셋을 **한 건씩** 물어보는 경로입니다. `pull`이 래칫 룰 전체를 한 번에 등록하는 명령인 데 반해, `seed`는 모델 피팅 프리셋까지 포함해 설치·업그레이드 후 첫 세션에서 한 건씩 제안합니다 ([아래](#-seed-설치-직후부터-위임이-걸리게-하는-시작-룰)).
 - 🅷⚠ 런타임 경고(`ratchet?` `no-evidence` `PEV-skip`)는 30분 후 자동 만료되고, 하위 디렉터리 세션도 프로젝트에 올바르게 매칭됩니다. PEV-skip은 변경성 도구(Edit/Write/Bash)만 카운트해 읽기 위주 세션에서는 발동하지 않습니다 (v2.16.0+).
 
 <details>
@@ -365,14 +370,14 @@ v3.10.0부터는 프로파일 ID를 역할(main·opus·sonnet·haiku)로 되돌
 
 ## 🌱 seed: 설치 직후부터 위임이 걸리게 하는 시작 룰
 
-모델 피팅 랫쳇(`ratchet-model.md`)은 **빈 파일로 시작합니다.** route-scan이 사용자의 로그에서 같은 유형의 작업을 여러 번 관측하고, 사용자가 그 후보를 승인해야 룰이 생깁니다. 즉 갓 설치한 상태에서는 위임이 한 건도 걸리지 않고, 그 상태가 며칠 이어집니다. 정작 절감 효과가 가장 클 시기입니다.
+모델 피팅 래칫(`ratchet-model.md`)은 **빈 파일로 시작합니다.** route-scan이 사용자의 로그에서 같은 유형의 작업을 여러 번 관측하고, 사용자가 그 후보를 승인해야 룰이 생깁니다. 즉 갓 설치한 상태에서는 위임이 한 건도 걸리지 않고, 그 상태가 며칠 이어집니다. 정작 절감 효과가 가장 클 시기입니다.
 
 `seed`는 패키지에 동봉된 프리셋으로 그 공백을 메웁니다.
 
 | 프리셋 | 내용 | 파일 |
 |---|---|---|
 | 모델 피팅 9건 | 명령 실행·탐색·상태 확인·붙여넣은 로그 질문·읽기 요약, 각 유형의 T2(haiku)와 T1(sonnet) 룰 | `presets/model-rules.json` |
-| 랫쳇 6건 | 실제 반복 사고에서 승격된 범용 룰 | `presets/ratchet-rules.json` |
+| 래칫 6건 | 실제 반복 사고에서 승격된 범용 룰 | `presets/ratchet-rules.json` |
 
 **등록 절차:** 설치나 업그레이드 후 첫 세션에서 SessionStart 훅이 대기 중인 프리셋을 모델에게 전달하고, 모델이 **한 건씩 순서대로** 등록 여부를 묻습니다. 사용자가 답하면 곧바로 아래 명령을 실행합니다.
 
@@ -593,6 +598,16 @@ harness 5/5 + ratchet을 실제 적용한 전후 비교입니다 (저자 Claude
 - ⚠️ 도입 후 데이터는 2일치(157msg)로 통계적 의미가 약하고, 주별 작업 토픽 차이가 섞여 있어 도구 효과만 깨끗이 분리되진 않습니다.
 </details>
 
+## FAQ
+
+**claude-token-saver와 같은 도구인가요?** 네. Sprag가 새 이름이고 npm 패키지는 `sprag-cli`입니다. `claude-token-saver` 패키지도 같은 릴리스를 계속 받으므로 기존 설치는 그대로 동작합니다.
+
+**LLM을 호출하거나 API 키가 필요한가요?** 아니요. Claude Code가 이미 내 컴퓨터에 남기는 세션 로그를 사후 분석할 뿐입니다. 추가 모델 호출도, 키도 없고, 데이터가 밖으로 나가지 않습니다.
+
+**프롬프트 습관을 바꿔야 하나요?** 아니요. 설치 때 hook과 statusline을 한 번 등록하면, 지금 하던 방식 그대로 쓰는 동안 규칙과 위임, 경고가 세션 안에 나타납니다.
+
+**절감액 수치는 어디서 나오나요?** 위임 실행마다 실제 가격 차이가 장부에 한 줄씩 기록됩니다. 라우팅 기준은 공개 데이터로 벤치마크했고, 방법은 [docs/BENCHMARK.md](./docs/BENCHMARK.md)에 있습니다.
+
 ## 동작 원리 · 환경
 
 Claude Code는 모든 API 응답을 `~/.claude/projects/<dir>/<session>.jsonl`에 기록합니다. 이 도구는 `cache_read_input_tokens`, `cache_creation.ephemeral_5m/1h_input_tokens` 등을 `requestId` 기준으로 중복 제거 후 집계합니다.

package/README.md

@@ -17,9 +17,11 @@
 
 ---
 
-# Sprag (sprag)
+# Sprag
 
-**Shows what it saved, on two lines.** It moves the easy work your expensive model keeps repeating onto cheaper ones, and turns documents the model cannot read into Markdown. Both figures are ledger entries rather than estimates, and whichever saved more takes the top line. Zero dependencies, one-line install.
+**A quality ratchet for AI coding agents — your agent keeps working, it just stops regressing.** Sprag is named after the sprag clutch: forward motion passes freely, backspin locks. It reads the sessions Claude Code already writes and turns them into gains that compound — every repeated failure becomes a rule loaded at session start, work a cheaper tier has proven it can do is delegated there with a per-run savings ledger as the receipt, and cache or rate-limit trouble reaches your statusline while you can still act on it.
+
+What it saved shows on two lines — routing and document conversion each get their own, ledger entries rather than estimates. Zero dependencies, no API key, nothing leaves your machine.
 
 ![statusline example — routing savings on row 1, document conversion savings on row 2, diagnostics on row 3](./docs/statusline.png)
 
@@ -45,18 +47,18 @@ gemini-2.5-pro        57.9%             $734  ▰▰▰▰▰▰▰▰▰▰▰
 
 Since v3.35.0 spend is visible too: month-to-date spend shows as `💵 Sep $42`, and on LiteLLM gateways (Bedrock and friends) with no 5h/7d caps, your key budget renders as a `🔑 budget ▰▱ 34% $34/$100` gauge.
 
-## Four parts, working together
-
-| | What it does | Effect |
-|---|---|---|
-| 🔀 **Routing** | Delegates recurring easy work to cheaper models | Savings recorded per run in a ledger; criteria [benchmarked](./docs/BENCHMARK.md) on public data |
-| 📄 **Document conversion** | Turns pptx/xlsx/pdf/docx/fig into Markdown before the model reads them | **510,000 tokens** saved on one deck ([below](#-doc2md--documents-become-markdown-before-the-model-reads-them)) |
-| 🅷 **Harness** | Blocks the token-burning habits: unevidenced "done", skipped verification (5 principles) | **−18.6% cost** ([measured](#real-world-impact--beforeafter-report)) |
-| ⚙️ **Ratchet** | Freezes each error you hit into a rule | Same mistake stops recurring |
+## Everything ships in one install, working from day one
 
-One install sets up all four. The measured −18.6% comes from the harness and ratchet; routing and conversion savings sit on top of it.
+| | What it does |
+|---|---|
+| ⚙️ **Ratchet rules** | Repeated failures become one-line rules loaded every session. Candidates are detected from your logs; you choose project or global scope. |
+| 🔀 **Model fitting** | Log-driven delegation rules with measured error rates and reported savings, written to `ratchet-model.md`. Criteria [benchmarked](./docs/BENCHMARK.md) on public data. |
+| 🅷 **Harness score** | Five operating principles checked live ([−18.6% cost, measured](#real-world-impact--beforeafter-report)). Skip the verify step and `🅷 4/5` says so before you report done. |
+| 📊 **Token telemetry** | Cache hit rate, TTL, context size, output spikes and both rate-limit windows, in the prompt every turn. |
+| 📄 **doc2md** | pptx, xlsx, pdf, docx and fig converted on demand, so a document costs a read instead of a context bomb ([510k tokens saved on one deck](#-doc2md--documents-become-markdown-before-the-model-reads-them)). |
+| 🇰🇷 **Style gates** | Write-time prose lint enforced by hook. Shipping today for Korean technical writing: double passives, translationese, cohesion. |
 
-The two savings figures are never added together, because they answer different questions. Routing says "the same work ran on a cheaper model". Conversion says "a file you could not read became readable, without pushing the original through the context window". The statusline gives each its own line and puts the larger one first.
+The measured −18.6% comes from the harness and ratchet; routing and conversion savings sit on top of it. The two savings figures are never added together: routing says "the same work ran on a cheaper model", conversion says "a file became readable without pushing the original through the context window". The statusline gives each its own line and puts the larger one first.
 
 ## Contents
 
@@ -70,7 +72,6 @@ The two savings figures are never added together, because they answer different
 **Prerequisite:** Node.js ≥ 18 (`node -v` · macOS `brew install node` · Windows `winget install OpenJS.NodeJS.LTS` · Linux/WSL: [nvm](https://github.com/nvm-sh/nvm) recommended)
 
 ```bash
-npm uninstall -g claude-cache-monitor   # (previous-package users only)
 npm i -g sprag-cli
 ```
 
@@ -150,10 +151,11 @@ By run (newest first):
 
 ## Not a router — 60 seconds
 
-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.
+Sprag installs once, reads the sessions you already run, and does not ask you to change how you prompt. It never intercepts a request or swaps your model in realtime.
+
+1. **A repeat becomes a rule.** The first failure is just work. On the second, Sprag surfaces it as a candidate; you approve the scope, and the rule loads at the start of every session after that.
+2. **Safe work goes to a sub-agent.** When a task matches one your history shows is safe, Sprag spawns a sub-agent on a cheaper tier to do it and hands the result back for review. Anything that fails quietly stays with the main agent.
+3. **Cost trouble shows up early.** Cache hit rate, TTL expiry, context growth and both rate-limit windows are read every turn and printed in your statusline, while you can still act on them.
 
 ### Why realtime model routing can cost more, not less
 
@@ -712,6 +714,16 @@ Source: [Anthropic pricing docs](https://platform.claude.com/docs/en/about-claud
 | Pro ($20/mo) | **5m fixed** | not configurable |
 | API key | 5m default (1h via beta header) | `cache_control.ttl` |
 
+## FAQ
+
+**Is this the same tool as claude-token-saver?** Yes. Sprag is the new name; the npm package is `sprag-cli`, and the `claude-token-saver` package keeps receiving the same releases so nothing breaks.
+
+**Does it call an LLM or need an API key?** No. Everything is post-hoc analysis of the session logs Claude Code already writes on your machine. No extra model calls, no key, no telemetry leaves your computer.
+
+**Will it change how I prompt?** No. It installs hooks and a statusline once, then works from what you already do. Rules, delegation, and warnings show up inside your normal sessions.
+
+**Where do the savings numbers come from?** Each delegated run writes a ledger entry with the actual price difference. The tier criteria behind the routing are benchmarked on public data; the method is in [docs/BENCHMARK.md](./docs/BENCHMARK.md).
+
 ## How it works · Environment
 
 Claude Code logs every API call to `~/.claude/projects/<dir>/<session>.jsonl`. This tool dedupes streaming chunks by `requestId` and aggregates `cache_read_input_tokens` / `cache_creation.ephemeral_5m/1h_input_tokens` by day and session.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-token-saver",
-  "version": "3.42.2",
+  "version": "3.42.4",
   "description": "Legacy name of sprag-cli (Sprag) - same tool, kept publishing so existing installs stay current. Prefer: npm i -g sprag-cli",
   "type": "module",
   "bin": {

package/src/cohesion.js

@@ -63,7 +63,7 @@ export async function cohesionInjection({ cfg = loadConfig() } = {}) {
   if (!text) return null;
   return [
     '[sprag cohesion] Follow this guidance for English prose in this session.',
-    'The user enabled it in claude-token-saver.',
+    'The user enabled it in sprag.',
     '',
     text,
   ].join('\n');

package/src/commands/handoff.js

@@ -4,8 +4,8 @@
  * session can pick up where this one stopped. Pairs with the cap-warn chip:
  * when statusline shows 🚨 5H 90%+, run this to back up state before the cap
  * hits.
- *   claude-token-saver handoff             # write to cwd
- *   claude-token-saver handoff --cwd PATH  # custom directory
+ *   sprag handoff             # write to cwd
+ *   sprag handoff --cwd PATH  # custom directory
  */
 
 import { readStdinJson, extractCaps } from '../stdin-payload.js';

package/src/commands/history.js

@@ -2,9 +2,9 @@
  * Subcommand: history — print recent warning transitions captured by the
  * statusline. One markdown file per day, persisted under the platform-
  * specific user-data dir.
- *   claude-token-saver history              # last 7 days
- *   claude-token-saver history --days 30    # custom window
- *   claude-token-saver history --list       # just list available dates
+ *   sprag history              # last 7 days
+ *   sprag history --days 30    # custom window
+ *   sprag history --list       # just list available dates
  */
 
 

package/src/commands/install.js

@@ -333,7 +333,7 @@ export async function run({ hasFlag }) {
       if (pending.length > 0) {
         console.log('');
         console.log(lang === 'ko'
-          ? `  seed: 추천 룰 ${pending.length}건이 대기 중입니다 (모델 피팅 + 랫쳇 프리셋).`
+          ? `  seed: 추천 룰 ${pending.length}건이 대기 중입니다 (모델 피팅 + 래칫 프리셋).`
           : `  seed: ${pending.length} recommended rule(s) are waiting (model-fitting + ratchet presets).`);
         console.log(lang === 'ko'
           ? '        다음 Claude Code 세션에서 한 건씩 등록할지 물어봅니다. 지금 보려면: sprag seed'

package/src/commands/seed.js

@@ -86,7 +86,7 @@ export async function run({ args, hasFlag }) {
   for (const s of pending) {
     const head = s.kind === 'model'
       ? `[${s.id}] ${s.tier} · "${s.label}" → ${s.agent}`
-      : `[${s.id}] ${ko ? '랫쳇 룰' : 'ratchet rule'}`;
+      : `[${s.id}] ${ko ? '래칫 룰' : 'ratchet rule'}`;
     console.log(`  ${head}`);
     console.log(`      ${s.ruleText}`);
   }

package/src/commands/update-check.js

@@ -57,8 +57,8 @@ export async function run({ hasFlag, version }) {
       ? `새 버전이 있습니다: v${version} → ${s.latest}`
       : `Update available: v${version} → ${s.latest}`);
     console.log(lang === 'ko'
-      ? `업그레이드: ${upgradeCommand()}   (또는 claude-token-saver upgrade)`
-      : `Upgrade with: ${upgradeCommand()}   (or: claude-token-saver upgrade)`);
+      ? `업그레이드: ${upgradeCommand()}   (또는 sprag upgrade)`
+      : `Upgrade with: ${upgradeCommand()}   (or: sprag upgrade)`);
     if (s.dismissed) {
       console.log(lang === 'ko'
         ? '이 버전은 사용자가 한 번 넘긴 상태라, 세션 시작 시에는 다시 묻지 않습니다.'

package/src/commands/upgrade.js

@@ -2,8 +2,8 @@
  * Subcommand: upgrade — install the latest release with the package manager
  * that put this copy on disk.
  *
- *   claude-token-saver upgrade          # refresh the check, then install
- *   claude-token-saver upgrade --print  # show the command, run nothing
+ *   sprag upgrade          # refresh the check, then install
+ *   sprag upgrade --print  # show the command, run nothing
  *
  * This is the command the model runs after the user says yes to the
  * session-start offer, so it prints the exact command it is about to execute
@@ -63,6 +63,6 @@ export async function run({ hasFlag, version }) {
   // the statusline chip clears on the next render instead of lingering.
   await refreshUpdateState(s.latest);
   console.log(lang === 'ko'
-    ? `설치가 끝났습니다. 새 셸에서 claude-token-saver --version 으로 ${s.latest} 인지 확인하십시오.`
-    : `Done. In a fresh shell, run claude-token-saver --version to confirm ${s.latest}.`);
+    ? `설치가 끝났습니다. 새 셸에서 sprag --version 으로 ${s.latest} 인지 확인하십시오.`
+    : `Done. In a fresh shell, run sprag --version to confirm ${s.latest}.`);
 }

package/src/harness-templates.js

@@ -49,7 +49,7 @@ export const MODEL_RATCHET_IMPORT_RE = /^@(?:~\/\.claude|\.claude)\/ratchet-mode
 export function harnessClaudeMdBlock(scope = 'project') {
   const sections = HARNESS_SECTIONS.map((s) => s.heading).join('\n\n... (see full block below)');
   return `${HARNESS_BLOCK_BEGIN}
-## 🅷 Harness Rules (claude-token-saver)
+## 🅷 Harness Rules (sprag)
 
 이 섹션은 \`sprag harness init\`이 생성합니다. 5가지 원칙 모두를
 지키면 statusline에 \`🅷 5/5\`로 표시되고, 빠진 게 있으면 \`🅷 3/5\` 식으로
@@ -59,7 +59,7 @@ export function harnessClaudeMdBlock(scope = 'project') {
 ${HARNESS_SECTIONS[0].heading}
 - 같은 에러·오해·반복 작업이 한 번 더 발생하면 즉시 \`.claude/ratchet.md\`에
   "조건 → 행동" 한 줄로 룰 추가.
-- claude-token-saver가 후보를 감지하면 statusline에 \`🅷⚠ ratchet?\`로 알림.
+- sprag가 후보를 감지하면 statusline에 \`🅷⚠ ratchet?\`로 알림.
   \`sprag harness promote "<rule>" --project|--global\`로 승인.
 - **scope는 항상 사용자에게 먼저 물어볼 것** — 프로젝트 한정이면 \`--project\`,
   도구·환경 일반 룰이면 \`--global\`(\`~/.claude/ratchet.md\`). Bash 환경은
@@ -67,9 +67,9 @@ ${HARNESS_SECTIONS[0].heading}
   플래그를 명시해야 함. 묻지 않고 기본값으로 등록하지 말 것.
 - 승인된 룰은 이 블록 맨 아래 \`@\` import로 매 세션 로드된다 — 그 import 라인을
   지우면 ratchet.md는 컨텍스트에 들어오지 않으니 지우지 말 것.
-- **모델 피팅 랫쳇**: \`.claude/ratchet-model.md\`(프로젝트)와
+- **모델 피팅 래칫**: \`.claude/ratchet-model.md\`(프로젝트)와
   \`~/.claude/ratchet-model.md\`(글로벌)에 있는 티어 위임 룰도 ratchet.md와
-  동일하게 따를 것. 이 파일은 claude-token-saver가 로그 기반으로 자동
+  동일하게 따를 것. 이 파일은 sprag가 로그 기반으로 자동
   생성·갱신하므로 직접 수정하지 말 것 (관리: \`route-scan rules\`).
 
 ${HARNESS_SECTIONS[1].heading}
@@ -123,7 +123,7 @@ ${HARNESS_BLOCK_END}
 }
 
 export function harnessRatchetMdInitial() {
-  return `# Ratchet Rules (auto-grown by claude-token-saver)
+  return `# Ratchet Rules (auto-grown by sprag)
 
 같은 실수가 두 번 발생하면 여기에 한 줄 추가됩니다. 형식: "YYYY-MM-DD: <조건> → <행동>".
 

package/src/korean-style.js

@@ -181,7 +181,7 @@ export function koreanStyleInjection({ cfg = loadConfig() } = {}) {
   if (!text) return null;
   return [
     '[sprag korean-style] 이 세션에서 한국어를 출력할 때는 아래 지침을 따르십시오.',
-    '이 지침은 사용자가 claude-token-saver에 설정한 것입니다.',
+    '이 지침은 사용자가 sprag에 설정한 것입니다.',
     ...koreanScopeLines(cfg),
     '표기 규칙(예외 없이 적용): 도구 호출 인자에 한국어를 비롯한 비ASCII 문자열을 담을 때에는 반드시 리터럴 UTF-8로 작성하고, \\uXXXX 유니코드 이스케이프로는 절대 작성하지 마십시오. 이스케이프로 작성하면 글자가 깨진 채 파일에 기록되는 사례가 자주 발생합니다.',
     `(출처: ${KOREAN_STYLE_SOURCE})`,

package/src/seed-rules.js

@@ -252,7 +252,7 @@ export function seedOfferBlock({ lang = userLanguage(), root = findProjectRoot()
       }
     }
     if (fixes.length > 0) {
-      lines.push(`  · 랫쳇 룰 ${fixes.length}건 — 같은 실수를 반복하지 않도록 세션마다 읽히는 규칙입니다.`);
+      lines.push(`  · 래칫 룰 ${fixes.length}건 — 같은 실수를 반복하지 않도록 세션마다 읽히는 규칙입니다.`);
       for (const s of fixes) lines.push(`    [${s.id}] ${s.ruleText}`);
     }
     lines.push('  등록: claude-token-saver seed accept <id> --global|--project   # 적용 범위는 반드시 사용자에게 확인');

package/src/update-check.js

@@ -1,5 +1,5 @@
 /**
- * update-check — "is there a newer claude-token-saver?", answered without ever
+ * update-check — "is there a newer sprag?", answered without ever
  * blocking a render.
  *
  * The statusline command runs every ~300ms, so a network call on that path is