claude-token-saver 3.39.0 → 3.40.0

package/README.ko.md

@@ -2,7 +2,7 @@
 
 [![npm](https://img.shields.io/npm/v/claude-token-saver.svg)](https://www.npmjs.com/package/claude-token-saver)
 
-🌐 **[프로젝트 소개 페이지](https://rootstudioyaml.github.io/claude-token-saver/)**
+🌐 **[sprag.io](https://sprag.io)** · 프로젝트 사이트 (claude-token-saver는 **Sprag**로 이름을 바꾸는 중입니다)
 
 # claude-token-saver
 
@@ -395,7 +395,7 @@ Claude Code의 output style로도 같은 일을 할 수 있지만, output style
 
 **이전** (지침 꺼짐)
 
-> 렌더 실패 원인 좁히기 3단계: 먼저 `hn:still --check`로 스틸이 명세보다 최신인지(FRESH/STALE) 확인 — STALE이면 재생성 안 해서 옛 자산으로 렌더 시도한 게 원인. 다음 caption-blocks가 최신 나레이션과 단어열 일치하는지 직접 대조 — TTS 재생성 후 blocks 재생성 빠지면 자막·음성 어긋나 렌더 깨짐.
+> 렌더 실패 원인 좁히기 3단계: 먼저 `hn:still --check`로 스틸이 명세보다 최신인지(FRESH/STALE) 확인합니다. STALE이면 재생성 안 해서 옛 자산으로 렌더 시도한 게 원인. 다음 caption-blocks가 최신 나레이션과 단어열 일치하는지 직접 대조합니다. TTS 재생성 후 blocks 재생성 빠지면 자막·음성 어긋나 렌더 깨짐.
 
 **이후** (지침 켜짐)
 
@@ -413,7 +413,7 @@ Claude Code의 output style로도 같은 일을 할 수 있지만, output style
 
 세 층이 더해집니다.
 
-- **번역투**: 이중 피동, 일본어에서 온 굳은 표현, '~에 있어서', 영어 have를 직역한 '가지다' 남용. 기계가 판정할 수 있는 것은 쓰기 시점 검사(아래)에도 함께 들어갑니다.
+- **번역투**: 이중 피동, 일본어에서 온 굳은 표현, `~에 있어서`, 영어 have를 직역한 '가지다' 남용. 기계가 판정할 수 있는 것은 쓰기 시점 검사(아래)에도 함께 들어갑니다.
 - **상투 패턴**: 자동으로 붙는 수식어("다양한", "핵심적인"), 표지판 문장, 수사적 질문 뒤 즉답, 근거 없는 긍정 마무리.
 - **응집성**: 문장이 이어지는 방식이라 정규식으로는 검사하지 못합니다. 이 절의 방향을 정한 연구 결과가 있습니다. 접속어·지시어 같은 표층 연결 장치는 글의 품질과 상관이 없거나 오히려 부적 상관이고, 앞 문장이 내놓은 정보를 다음 문장이 받아 풀어 주는 상술형 연결만 정적 상관을 보였습니다. 그래서 지침은 연결이 어색할 때 접속어를 더하지 말고 정보의 배열(아는 것 먼저, 새 것 나중)을 고치라고 말합니다.
 
@@ -503,7 +503,7 @@ claude-token-saver doc2md install-converter   # 설치를 미리 끝내 두고
 몇 가지는 의도적으로 하지 않습니다.
 
 - **이미지는 변환하지 않습니다.** markitdown 이 빈 결과를 돌려주고, OCR 은 실측에서 리소스 이름을 틀리게 읽었습니다(`c5.xlarge` 를 `c.xlarge` 로). 이름 자체가 내용인 문서에서는 텍스트가 없느니만 못합니다. 모델이 이미지는 직접 읽습니다.
-- **변환기가 없으면 조용히 실패하지 않습니다.** 설치 명령을 한 번 안내한 뒤 원본 `Read` 를 그대로 통과시킵니다. 매번 알리면 그것대로 방해가 되고, 아무 말도 하지 않으면 고장을 숨기게 됩니다. `doc2md` 를 인자 없이 실행하면 변환기와 훅 등록 상태를 한 번에 확인할 수 있습니다.
+- **변환기가 없어도 알리지 않고 지나가지 않습니다.** 설치 명령을 한 번 안내한 뒤 원본 `Read` 를 그대로 통과시킵니다. 매번 알리면 그것대로 방해가 되고, 아무 말도 하지 않으면 고장을 숨기게 됩니다. `doc2md` 를 인자 없이 실행하면 변환기와 훅 등록 상태를 한 번에 확인할 수 있습니다.
 - **변환본은 프로젝트 안에 남기지 않습니다.** 도구의 상태 디렉터리 아래 권한 `0700` 으로 저장하므로 `.gitignore` 에 무엇을 추가할 필요가 없습니다. 파일명이 급여·계약·개인정보 같은 패턴에 걸리면 아예 변환하지 않습니다.
 - **압축 폭탄은 막습니다.** pptx·xlsx·docx 는 zip 컨테이너입니다. 선언된 크기를 먼저 걸러 내고, 선언은 조작될 수 있으므로 실제 해제 바이트도 상한과 대조합니다.
 - **엑셀은 행 수로 자릅니다.** 변환 시간은 파일 크기가 아니라 행 수를 따릅니다(실측: PDF 6.3MB 0.9초, 엑셀 5.8MB 47.75초). 5만 행을 넘으면 앞부분만 변환하고, **잘랐다는 사실과 전체 행 수를 안내에 함께 적습니다.**
@@ -610,7 +610,7 @@ npm uninstall -g claude-cache-monitor && npm i -g claude-token-saver
 
 ## 피드백
 
-버그 제보와 기능 제안은 GitHub 이슈로 받습니다: https://github.com/rootstudioyaml/claude-token-saver/issues
+버그 제보와 기능 제안은 GitHub 이슈로 받습니다: https://github.com/rootstudioyaml/sprag/issues
 
 브라우저나 GitHub 로그인이 어려운 환경(사내망, 세션 도중)이라면 터미널에서 바로 제출할 수 있고, Claude에게 대신 제출해 달라고 요청해도 됩니다.
 

package/README.md

@@ -2,7 +2,7 @@
 
 [![npm](https://img.shields.io/npm/v/claude-token-saver.svg)](https://www.npmjs.com/package/claude-token-saver)
 
-🌐 **[Project page](https://rootstudioyaml.github.io/claude-token-saver/)**
+🌐 **[sprag.io](https://sprag.io)** · project site (claude-token-saver is being renamed to **Sprag**)
 
 # claude-token-saver
 
@@ -731,7 +731,7 @@ The full history moved to [CHANGELOG.md](./CHANGELOG.md) (Korean; version headin
 
 ## Feedback
 
-Found a bug, or want a feature? Open an issue: https://github.com/rootstudioyaml/claude-token-saver/issues
+Found a bug, or want a feature? Open an issue: https://github.com/rootstudioyaml/sprag/issues
 
 No browser or GitHub login handy (corporate network, mid-session)? Submit straight from the terminal — or ask Claude to do it for you:
 

package/package.json

@@ -1,9 +1,10 @@
 {
   "name": "claude-token-saver",
-  "version": "3.39.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.",
+  "version": "3.40.0",
+  "description": "Route the easy work your expensive Claude model keeps repeating down to haiku/sonnet \u2014 post-hoc session analysis, no realtime router, no extra LLM calls.",
   "type": "module",
   "bin": {
+    "sprag": "bin/cli.js",
     "claude-token-saver": "bin/cli.js"
   },
   "scripts": {
@@ -48,11 +49,11 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/rootstudioyaml/claude-token-saver.git"
+    "url": "git+https://github.com/rootstudioyaml/sprag.git"
   },
-  "homepage": "https://github.com/rootstudioyaml/claude-token-saver#readme",
+  "homepage": "https://sprag.io",
   "bugs": {
-    "url": "https://github.com/rootstudioyaml/claude-token-saver/issues"
+    "url": "https://github.com/rootstudioyaml/sprag/issues"
   },
   "author": "DeepPulse (https://www.youtube.com/@DeepPulseKR)"
 }

package/src/commands/korean.js

@@ -86,6 +86,7 @@ export async function run({ args, hasFlag }) {
         console.error(`${file}: ${e.message}`);
         continue;
       }
+      if (lint.isHtmlFile(file)) text = lint.stripHtml(text);
       const findings = lint.lintKoreanText(text, { code: !lint.isProseFile(file) });
       total += findings.length;
       if (findings.length) console.log(lint.formatFindings(file, findings));

package/src/korean-lint.cjs

@@ -35,12 +35,21 @@
 // Documents. Under the `prose` scope these are the only files checked.
 const PROSE_EXTENSIONS = new Set(['.md', '.mdx', '.markdown', '.txt', '.rst', '.adoc']);
 
+// HTML is a document a reader receives, so it is checked under BOTH scopes,
+// like prose — but through `stripHtml` first, so tags, comments, and CSS never
+// trip the rules. Script bodies are kept: on a static page the Korean UI copy
+// (i18n dictionaries, template strings) lives exactly there, and that gap is
+// how an em dash shipped to a real landing page unchecked (2026-09-13).
+const HTML_EXTENSIONS = new Set(['.html', '.htm', '.xhtml', '.vue', '.svelte']);
+
 // Only two kinds of path are skipped: installed dependencies and VCS
 // internals, neither of which anyone in this session wrote. Build output is
 // deliberately NOT on this list. Generated artifacts are the files a reader
 // actually receives, so exempting `dist/` or `build/` would exempt the very
 // documents the check exists for.
 const SKIP_PATH = /(^|[\\/])(node_modules|\.git|.*\.min\.[a-z]+|.*-lock\.json|.*\.lock)([\\/]|$)/i;
+// This module and the hook copy that embeds it quote every banned form.
+const SELF_PATH = /(^|[\\/])(korean-lint\.cjs|cache-monitor-hook\.cjs)$/i;
 const BINARY_EXTENSIONS = new Set([
   '.png', '.jpg', '.jpeg', '.gif', '.webp', '.svg', '.ico', '.pdf', '.zip', '.gz', '.tar',
   '.mp3', '.mp4', '.wav', '.mov', '.woff', '.woff2', '.ttf', '.otf', '.map', '.bin',
@@ -71,6 +80,18 @@ const METAPHOR_LEXICON = [
   { re: /벽에 부딪|길을 열|문을 열/, fix: '무엇이 막히고 무엇이 가능해지는지 그대로 적습니다' },
   { re: /갈림길|갈리는 지점/, fix: "'결정이 나뉘는 조건'으로 바꿉니다" },
   { re: /깨어나|잠들어 있/, fix: "'동작을 시작하다'·'실행되지 않고 있다'로 바꿉니다" },
+  // Added 2026-09-13. "fails loudly / fails silently" reads as idiom in English
+  // but lands as figurative vocabulary in Korean: a failure has no volume.
+  // 0 hits across 400 Korean files in yaml-sns-agent, so the confirm-request is
+  // not noise.
+  {
+    re: /(?:시끄럽게|시끄러운|조용히|조용한)\s*[가-힣]*(?:실패|틀리|드러나|어긋)|(?:실패|오류|버그)[가은는이]?\s*(?:시끄럽|시끄러운|조용하|조용한)/,
+    fix: "무엇으로 실패를 확인하는지 적습니다. '종료 코드로 바로 드러나는가'·'검증 없이 지나가는가'",
+  },
+  {
+    re: /안전망/,
+    fix: "'검증 수단'·'확인 장치'처럼 무엇이 실패를 잡아내는지 그대로 적습니다",
+  },
 ];
 
 // Guidance 3.2/3.3: literal renderings of English noun phrases.
@@ -111,9 +132,13 @@ const NOMINAL_ENDING = /(?:음|함|됨|임|점|론|양|성|화)\.$/;
 function isLintTarget(filePath, scope = 'all') {
   if (!filePath) return false;
   if (SKIP_PATH.test(filePath)) return false;
+  // The rule table has to spell every banned form out, so this file always
+  // matches its own lexicon. Checking it reports the rules, not a breach.
+  if (SELF_PATH.test(filePath)) return false;
   const dot = filePath.lastIndexOf('.');
   const ext = dot === -1 ? '' : filePath.slice(dot).toLowerCase();
   if (PROSE_EXTENSIONS.has(ext)) return true;
+  if (HTML_EXTENSIONS.has(ext)) return true;
   if (scope !== 'all') return false;
   if (!ext) return false;
   return !BINARY_EXTENSIONS.has(ext);
@@ -124,6 +149,26 @@ function isProseFile(filePath) {
   return isLintTarget(filePath, 'prose');
 }
 
+function isHtmlFile(filePath) {
+  const dot = String(filePath).lastIndexOf('.');
+  const ext = dot === -1 ? '' : String(filePath).slice(dot).toLowerCase();
+  return HTML_EXTENSIONS.has(ext);
+}
+
+/**
+ * Blank out the parts of an HTML document no reader sees — comments, CSS, and
+ * the tags themselves — while keeping every newline, so finding line numbers
+ * still point into the original file. Script bodies stay: that is where the
+ * page's Korean copy lives on a static site.
+ */
+function stripHtml(text) {
+  const blank = (m) => m.replace(/[^\n]/g, ' ');
+  return String(text)
+    .replace(/<!--[\s\S]*?-->/g, blank)
+    .replace(/<style\b[^>]*>[\s\S]*?<\/style>/gi, blank)
+    .replace(/<[^>]+>/g, blank);
+}
+
 /** Drop fenced code blocks and inline code so snippets never trip the rules. */
 function stripCode(text) {
   const out = [];
@@ -226,9 +271,12 @@ function lintToolUse(context, { scope = 'all' } = {}) {
   const filePath = toolInput && typeof toolInput.file_path === 'string' ? toolInput.file_path : '';
   if (!isLintTarget(filePath, scope)) return null;
 
-  const text = writtenTextOf(toolName, toolInput);
+  let text = writtenTextOf(toolName, toolInput);
   if (!text || !hasKorean(text)) return null;
 
+  // Edits arrive as fragments, so tag-stripping only applies when the payload
+  // is a whole document; a fragment is still linted, just without stripping.
+  if (isHtmlFile(filePath) && toolName === 'Write') text = stripHtml(text);
   const findings = lintKoreanText(text, { code: !isProseFile(filePath) });
   if (findings.length === 0) return null;
   return { filePath, findings };
@@ -246,6 +294,8 @@ module.exports = {
   METAPHOR_LEXICON,
   isLintTarget,
   isProseFile,
+  isHtmlFile,
+  stripHtml,
   lintKoreanText,
   writtenTextOf,
   lintToolUse,