claude-token-saver 3.38.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만 행을 넘으면 앞부분만 변환하고, **잘랐다는 사실과 전체 행 수를 안내에 함께 적습니다.**
@@ -602,11 +602,26 @@ npm uninstall -g claude-cache-monitor && npm i -g claude-token-saver
 
 전체 내역은 [CHANGELOG.md](./CHANGELOG.md)로 옮겼습니다. 최근 변경은 다음과 같습니다.
 
+- **v3.39.0**: `feedback` 서브커맨드가 터미널이나 Claude 세션에서 버그 제보·기능 제안을 바로 제출합니다. gh CLI가 있으면 이슈 직접 등록, 없으면 로그인 없는 익명 제출(릴레이가 이슈로 자동 등록), 오프라인이면 로컬 저장. `install`은 기존 statusline이 있으면 조용히 건너뛰지 않고 교체 여부를 묻습니다.
 - **v3.38.0**: `cohesion on`이 응집성 다섯 원칙을 영어 블록으로 주입합니다. 옵트인이고, korean 지침이 켜져 있으면 중복 주입을 막습니다.
 - **v3.37.0**: 한국어 지침에 보강 지침(supplement)이 붙습니다. 번역투·상투 패턴·응집성(문장 이어짐) 조항이며, 쓰기 시점 검사에도 번역투 5종이 추가됐습니다. 실파일 255개 실측에서 오탐 1건으로 검증했습니다.
 - **v3.35.0**: 이번 달 1일 00시 이후 지출 추정치를 `💵 Sep $42` 세그먼트로 상시 표시합니다. LiteLLM 게이트웨이 사용자는 키의 max_budget/spend 를 `🔑 budget` 게이지로 봅니다 (5h/7d cap 이 없는 Bedrock·LiteLLM 환경 대응).
 - **v3.34.0**: seed 프리셋 제안, 설치 시 출력 언어 선택, 컨텍스트 경고 500k 상향. 상세는 CHANGELOG 참고.
 
+## 피드백
+
+버그 제보와 기능 제안은 GitHub 이슈로 받습니다: https://github.com/rootstudioyaml/sprag/issues
+
+브라우저나 GitHub 로그인이 어려운 환경(사내망, 세션 도중)이라면 터미널에서 바로 제출할 수 있고, Claude에게 대신 제출해 달라고 요청해도 됩니다.
+
+```bash
+claude-token-saver feedback "Bedrock에서 5m TTL 칩이 사라지지 않아요"
+```
+
+`gh` CLI가 인증되어 있으면 GitHub 이슈로 바로 등록하고, 없으면 로그인이 필요 없는 익명 경로로 제출합니다(github.com이 막힌 사내망에서도 동작합니다). `gh` 경로를 건너뛰려면 `--anonymous`를 붙입니다. 도구 버전과 OS 정보는 자동으로 첨부됩니다.
+
+버그를 제보하실 때는 도구 버전(`claude-token-saver --version`)과 OS를 함께 적어 주시고, statusline이나 경고 관련 문제라면 statusline 출력이나 `claude-token-saver last` 결과를 덧붙여 주시면 원인을 빨리 찾을 수 있습니다.
+
 ## 라이선스
 
 MIT

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
 
@@ -723,11 +723,26 @@ Also update `statusLine.command` in `~/.claude/settings.json` to `claude-token-s
 
 The full history moved to [CHANGELOG.md](./CHANGELOG.md) (Korean; version headings and command names are language-neutral). Recent changes:
 
+- **v3.39.0**: `feedback` subcommand — file bug reports and feature requests straight from the terminal or a Claude session, via the gh CLI, an anonymous no-login form (auto-filed as a GitHub issue by an Apps Script relay), or a local fallback. `install` now asks before replacing an existing statusline instead of silently skipping.
 - **v3.38.0**: `cohesion on` — the language-neutral cohesion rules from the Korean supplement become a standalone English injection (given-before-new, one referent per pronoun, subject consistency, bridging, merging choppy sentences). Opt-in, ~0.5k tokens per session, suppressed while `korean on` already carries them.
 - **v3.37.0**: Korean guidance grows a conservative supplement (translationese, AI-writing tics, a research-backed cohesion section whose principles apply to English prose too) and the write-time lint gains 5 translationese patterns, validated at 1 false positive across 255 real files.
 - **v3.35.0**: A `💵 Sep $42` segment now shows estimated spend since 00:00 on the 1st of the current month, always on — including gateway setups with no 5h/7d caps. LiteLLM gateway users get a `🔑 budget ▰▱ 34% $34/$100` gauge built from the key's budget (`GET /key/info` + `GET /user/info`, team-membership budget first, then key, then internal user — verified against a Dockerized LiteLLM).
 - **v3.34.0**: seed presets offered one at a time, output-language choice at install, context warning raised to 500k.
 
+## Feedback
+
+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:
+
+```bash
+claude-token-saver feedback "the 5m TTL chip never clears on Bedrock"
+```
+
+It files a GitHub issue via the `gh` CLI when one is authenticated; otherwise it submits anonymously (no login, works where github.com is blocked). Pass `--anonymous` to skip the `gh` path. Version and OS metadata are attached automatically.
+
+When reporting a bug, please include the tool version (`claude-token-saver --version`), your OS, and — if it is a statusline or warning issue — the statusline output or the `claude-token-saver last` result.
+
 ## License
 
 MIT

package/bin/cli.js

@@ -87,7 +87,7 @@ function readUpdateChip() {
 const KNOWN_SUBCOMMANDS = new Set([
   'last', 'brief', 'history', 'handoff', 'install', 'uninstall', 'mode', 'korean', 'cohesion',
   'doc2md', 'harness', 'route-scan', 'compact-window', 'update-check', 'upgrade',
-  'seed', 'litellm-budget',
+  'seed', 'litellm-budget', 'feedback',
 ]);
 
 const USAGE = `claude-token-saver — Claude Code token usage, cache health, and model routing
@@ -107,6 +107,7 @@ Usage:
   claude-token-saver last               most recent warning + how to handle it
   claude-token-saver history            recent warning transitions
   claude-token-saver handoff            write a session handoff file
+  claude-token-saver feedback "<msg>"   file a bug report / feature request (no browser needed)
   claude-token-saver upgrade            install the latest release
   claude-token-saver --install-hook     install cache-monitor PostToolUse hook
   claude-token-saver --uninstall-hook   remove that hook
@@ -114,6 +115,7 @@ Usage:
       --verbose / --no-color / --icon / --no-timer / --single-line
 
 Run any subcommand with --help for its own options where available.
+Bug reports & feature requests: https://github.com/rootstudioyaml/claude-token-saver/issues
 `;
 
 async function main() {
@@ -161,6 +163,14 @@ async function main() {
   // hits.
   //   claude-token-saver handoff             # write to cwd
   //   claude-token-saver handoff --cwd PATH  # custom directory
+  // Subcommand: feedback — file a bug report / feature request without a
+  // browser. Tries gh CLI, then an anonymous form POST, then a local save
+  // with a prefilled GitHub issue URL. See src/commands/feedback.js.
+  if (args[0] === 'feedback') {
+    const { userDataDir } = await import('../src/paths.js');
+    return (await import('../src/commands/feedback.js')).run({ args, getArg, version: PKG_VERSION, dataDir: userDataDir() });
+  }
+
   if (args[0] === 'handoff') {
     return (await import('../src/commands/handoff.js')).run({ getArg });
   }

package/package.json

@@ -1,9 +1,10 @@
 {
   "name": "claude-token-saver",
-  "version": "3.38.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/feedback.js

@@ -0,0 +1,132 @@
+/**
+ * Subcommand: feedback — submit a bug report or feature request from the
+ * terminal (or from a Claude Code session) without opening a browser.
+ *
+ *   claude-token-saver feedback "statusline이 IntelliJ에서 깨져요"
+ *   claude-token-saver feedback --title "cache chip" "5m TTL 칩이 안 사라짐"
+ *
+ * Why this exists: GitHub issues require a logged-in browser session, and
+ * corporate networks often block github.com entirely. This command tries
+ * three transports in order and reports which one carried the message:
+ *
+ *   1. `gh` CLI, if installed and authenticated — files a real GitHub issue.
+ *   2. Anonymous Google Form POST — no login, no GitHub access needed.
+ *      (Only when the form endpoint below is configured for this build.)
+ *   3. Local fallback — saves the report to a Markdown file and prints a
+ *      prefilled GitHub new-issue URL to use from an unblocked machine.
+ *
+ * Metadata (tool version, OS, Node version) is attached automatically so a
+ * report is diagnosable without a follow-up round trip.
+ */
+
+import { spawnSync } from 'node:child_process';
+import { writeFileSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import os from 'node:os';
+import { debug } from '../debug.js';
+
+const REPO = 'rootstudioyaml/claude-token-saver';
+const ISSUES_URL = `https://github.com/${REPO}/issues`;
+
+// Anonymous submission endpoint (Google Form). A Google Form's formResponse
+// URL accepts unauthenticated POSTs, which is exactly the property a
+// login-free, GitHub-blocked-network path needs. Responses land in the
+// maintainer's "claude-token-saver 피드백 (Feedback)" form (published
+// 2026-09-13, responder access: anyone with the link).
+//   id      — the /d/e/<id>/ segment of the form URL
+//   message — entry.NNNN field id of the message question
+//   meta    — entry.NNNN field id of the metadata question
+const FORM = {
+  id: '1FAIpQLScISjU8_t9y8xfp-X3jvLV6_RcSjQIJ4aydATC8NazkxcJbgg',
+  message: 'entry.79517542',
+  meta: 'entry.112678638',
+};
+
+function metadata(version) {
+  return [
+    `version: ${version}`,
+    `os: ${process.platform} ${os.release()}`,
+    `node: ${process.version}`,
+  ].join('\n');
+}
+
+function tryGhCli(title, body) {
+  try {
+    const auth = spawnSync('gh', ['auth', 'status'], { encoding: 'utf8', timeout: 10_000 });
+    if (auth.status !== 0) return null;
+    const res = spawnSync('gh', ['issue', 'create', '-R', REPO, '--title', title, '--body', body],
+      { encoding: 'utf8', timeout: 30_000 });
+    if (res.status !== 0) { debug('feedback:gh', res.stderr); return null; }
+    const url = String(res.stdout).trim().split('\n').pop();
+    return { transport: 'gh', url };
+  } catch (e) { debug('feedback:gh', e); return null; }
+}
+
+async function tryForm(title, body, meta) {
+  if (!FORM) return null;
+  try {
+    const params = new URLSearchParams();
+    params.set(FORM.message, `${title}\n\n${body}`);
+    params.set(FORM.meta, meta);
+    const res = await fetch(`https://docs.google.com/forms/d/e/${FORM.id}/formResponse`, {
+      method: 'POST',
+      headers: { 'content-type': 'application/x-www-form-urlencoded' },
+      body: params.toString(),
+      signal: AbortSignal.timeout(15_000),
+    });
+    if (!res.ok) { debug('feedback:form', `HTTP ${res.status}`); return null; }
+    return { transport: 'form' };
+  } catch (e) { debug('feedback:form', e); return null; }
+}
+
+function saveLocal(title, body, dataDir) {
+  const dir = join(dataDir, 'feedback');
+  mkdirSync(dir, { recursive: true });
+  const stamp = new Date().toISOString().replace(/[:.]/g, '-');
+  const file = join(dir, `${stamp}.md`);
+  writeFileSync(file, `# ${title}\n\n${body}\n`);
+  const prefilled = `${ISSUES_URL}/new?title=${encodeURIComponent(title)}&body=${encodeURIComponent(body)}`;
+  return { transport: 'local', file, prefilled };
+}
+
+export async function run({ args, getArg, version, dataDir }) {
+  // --anonymous skips the gh transport: for people whose gh CLI is signed in
+  // with an account they do not want attached to the report.
+  const anonymous = args.includes('--anonymous');
+  const rest = args.slice(1).filter((a, i, all) => {
+    if (a === '--title') return false;
+    if (all[i - 1] === '--title') return false;
+    return !a.startsWith('--');
+  });
+  const message = rest.join(' ').trim();
+  const explicitTitle = getArg('--title');
+
+  if (!message) {
+    console.log('usage: claude-token-saver feedback [--title "<제목>"] "<내용>"');
+    console.log(`       (GitHub에서 직접 제보: ${ISSUES_URL})`);
+    process.exitCode = 1;
+    return;
+  }
+
+  const title = explicitTitle || (message.length > 60 ? `${message.slice(0, 57)}...` : message);
+  const meta = metadata(version);
+  const body = `${message}\n\n---\n${meta}`;
+
+  const viaGh = anonymous ? null : tryGhCli(title, body);
+  if (viaGh) {
+    console.log(`feedback: GitHub 이슈로 등록했습니다 — ${viaGh.url}`);
+    return;
+  }
+
+  const viaForm = await tryForm(title, message, meta);
+  if (viaForm) {
+    console.log('feedback: 제출했습니다. 감사합니다. (익명 제출이라 답변 추적은 GitHub 이슈에서만 가능합니다)');
+    console.log(`          공개 트래커: ${ISSUES_URL}`);
+    return;
+  }
+
+  const local = saveLocal(title, body, dataDir);
+  console.log(`feedback: 온라인 제출 경로가 없어 로컬에 저장했습니다: ${local.file}`);
+  console.log('          GitHub 접근이 가능한 환경에서 아래 주소를 열면 내용이 채워진 이슈 작성 화면이 나옵니다:');
+  console.log(`          ${local.prefilled}`);
+}

package/src/commands/install.js

@@ -73,7 +73,31 @@ export async function run({ hasFlag }) {
     print('SessionStart hook (route-scan)', r.sessionStartHook);
     print('UserPromptSubmit hook (brief)', r.briefHook);
     {
-      const s = r.statusline;
+      let s = r.statusline;
+      // A different statusline is already installed. Replacing it silently
+      // would be rude and leaving it silently loses the tool's main surface,
+      // so with a human attached the install asks. Default is "keep yours":
+      // an accidental Enter must not clobber someone's custom statusline.
+      if (s.action === 'skipped' && s.conflict && interactive) {
+        console.log('');
+        console.log(lang === 'ko'
+          ? `  statusline: 기존 statusline이 이미 설정되어 있습니다: ${s.existingCommand}`
+          : `  statusline: an existing statusline is already configured: ${s.existingCommand}`);
+        console.log(lang === 'ko'
+          ? '              교체하면 토큰·캐시·상한 경고가 statusline에 표시됩니다. 기존 설정은 사라집니다.'
+          : '              replacing it shows token/cache/cap warnings in the statusline; the current one is removed.');
+        const replace = await confirm(lang === 'ko'
+          ? '              claude-token-saver statusline으로 교체할까요?'
+          : '              Replace it with the claude-token-saver statusline?', { defaultValue: false });
+        if (replace) {
+          const { installStatusline } = await import('../installer.js');
+          s = installStatusline({ force: true });
+        } else {
+          s = { ...s, reason: lang === 'ko'
+            ? '기존 statusline을 유지했습니다. 교체하려면 `claude-token-saver install --force`'
+            : 'kept your statusline — replace later with `claude-token-saver install --force`' };
+        }
+      }
       const verb = s.action === 'exists' ? 'already configured (refreshInterval=5)'
         : s.action === 'skipped' ? `skipped — ${s.reason}`
         : s.reason ? `${s.action} — ${s.reason}`
@@ -326,5 +350,9 @@ export async function run({ hasFlag }) {
       console.log('');
       console.log('Tip: re-run with --force to overwrite the existing skill file.');
     }
+    console.log('');
+    console.log(lang === 'ko'
+      ? '버그 제보·기능 제안: https://github.com/rootstudioyaml/claude-token-saver/issues'
+      : 'Bug reports & feature requests: https://github.com/rootstudioyaml/claude-token-saver/issues');
     return;
 }

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/installer.js

@@ -114,6 +114,12 @@ honor that for the rest of the turn without changing the saved setting.
   capturing git status + cap snapshot, so a fresh session can resume cleanly.
 - \`claude-token-saver mode\` — show statusline preferences.
 - \`claude-token-saver mode icon verbose 1d\` — change preferences.
+- \`claude-token-saver feedback "<message>"\` — file a bug report or feature
+  request for this tool right from the session (tries the gh CLI, then an
+  anonymous no-login submission, then saves locally with a prefilled GitHub
+  issue URL; \`--anonymous\` skips the gh path).
+  Use it whenever the user says the tool itself misbehaves or wishes it did
+  something it does not — offer to submit the report for them.
 
 ## Storage layout (for reference)
 
@@ -197,7 +203,10 @@ export function installStatusline({ force = false } = {}) {
   }
 
   if (!force) {
-    return { path: file, action: 'skipped', reason: `existing statusLine command (${cur.command}) — re-run with --force to overwrite` };
+    // `conflict` lets the interactive install distinguish "someone else's
+    // statusline is here" (worth asking about) from other skip reasons
+    // (unreadable JSON), which a prompt cannot fix.
+    return { path: file, action: 'skipped', conflict: true, existingCommand: cur.command, reason: `existing statusLine command (${cur.command}) — re-run with --force to overwrite` };
   }
   settings.statusLine = {
     type: 'command',

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,