sprag-cli 3.42.0 → 3.42.2

package/src/commands/compact-window.js

@@ -1,10 +1,10 @@
 /**
  * Subcommand: compact-window — audit / pin Claude Code's `autoCompactWindow`.
- *   claude-token-saver compact-window                      # status
- *   claude-token-saver compact-window set --global         # pin 500k in ~/.claude/settings.json
- *   claude-token-saver compact-window set --project        # pin 500k in <root>/.claude/settings.json
- *   claude-token-saver compact-window set --global --value 600k
- *   claude-token-saver compact-window off | on             # toggle the statusline warning
+ *   sprag compact-window                      # status
+ *   sprag compact-window set --global         # pin 500k in ~/.claude/settings.json
+ *   sprag compact-window set --project        # pin 500k in <root>/.claude/settings.json
+ *   sprag compact-window set --global --value 600k
+ *   sprag compact-window off | on             # toggle the statusline warning
  *
  * Scope is deliberately explicit for `set`: writing a global settings.json is
  * not something to guess at, and the non-TTY hook environment cannot prompt.
@@ -80,14 +80,14 @@ export async function run({ args, hasFlag }) {
     console.log(ko
       ? `  그 전까지 모든 요청이 전체 컨텍스트를 재과금합니다. 1M은 너무 크니 ${fmt(s.recommendedMin)}~${fmt(s.recommendedMax)} 범위를 권장합니다 (기본값 ${fmt(s.recommended)}, --value로 조절). 1M 창 자체는 그대로 두고 압축 시점만 앞당깁니다.`
       : `  Until then every request re-bills the whole context. 1M is too large — pick something in ${fmt(s.recommendedMin)}–${fmt(s.recommendedMax)} (default ${fmt(s.recommended)}, override with --value). The 1M window itself stays.`);
-    console.log(`\n  claude-token-saver compact-window set --global     (~/.claude/settings.json, ${fmt(s.recommended)})`);
-    console.log(`  claude-token-saver compact-window set --project    (<root>/.claude/settings.json, ${fmt(s.recommended)})`);
-    console.log(`  claude-token-saver compact-window set --global --value ${fmt(s.recommendedMax)}`);
+    console.log(`\n  sprag compact-window set --global     (~/.claude/settings.json, ${fmt(s.recommended)})`);
+    console.log(`  sprag compact-window set --project    (<root>/.claude/settings.json, ${fmt(s.recommended)})`);
+    console.log(`  sprag compact-window set --global --value ${fmt(s.recommendedMax)}`);
     console.log(ko ? '  (적용 범위는 사용자에게 먼저 확인할 것)' : '  (confirm the scope with the user first)');
     return;
   }
 
   console.error(`Unknown compact-window subcommand: ${sub}`);
-  console.error('Usage: claude-token-saver compact-window [status|set --global|--project [--value 500k]|off|on]');
+  console.error('Usage: sprag compact-window [status|set --global|--project [--value 500k]|off|on]');
   process.exit(1);
 }

package/src/commands/feedback.js

@@ -25,13 +25,13 @@ import { join } from 'node:path';
 import os from 'node:os';
 import { debug } from '../debug.js';
 
-const REPO = 'rootstudioyaml/claude-token-saver';
+const REPO = 'rootstudioyaml/sprag';
 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
+// maintainer's "sprag 피드백 (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

package/src/commands/install.js

@@ -49,7 +49,7 @@ export async function run({ hasFlag }) {
           chosen = ko ? 'ko' : 'en';
         }
         setUserLanguage(chosen);
-        console.log(`  language: set to ${chosen === 'ko' ? '한국어' : 'English'} — change it any time with \`claude-token-saver mode lang=${chosen === 'ko' ? 'en' : 'ko'}\``);
+        console.log(`  language: set to ${chosen === 'ko' ? '한국어' : 'English'} — change it any time with \`sprag mode lang=${chosen === 'ko' ? 'en' : 'ko'}\``);
       } else if (process.env.CTS_LANG) {
         // Escape hatch for scripted installs, which cannot answer a prompt but
         // do know which language the machine's user reads.
@@ -87,8 +87,8 @@ export async function run({ hasFlag }) {
           ? '              교체하면 토큰·캐시·상한 경고가 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 });
+          ? '              sprag statusline으로 교체할까요?'
+          : '              Replace it with the sprag statusline?', { defaultValue: false });
         if (replace) {
           const { installStatusline } = await import('../installer.js');
           s = installStatusline({ force: true });
@@ -336,8 +336,8 @@ export async function run({ hasFlag }) {
           ? `  seed: 추천 룰 ${pending.length}건이 대기 중입니다 (모델 피팅 + 랫쳇 프리셋).`
           : `  seed: ${pending.length} recommended rule(s) are waiting (model-fitting + ratchet presets).`);
         console.log(lang === 'ko'
-          ? '        다음 Claude Code 세션에서 한 건씩 등록할지 물어봅니다. 지금 보려면: claude-token-saver seed'
-          : '        the next Claude Code session asks about them one at a time. See them now: claude-token-saver seed');
+          ? '        다음 Claude Code 세션에서 한 건씩 등록할지 물어봅니다. 지금 보려면: sprag seed'
+          : '        the next Claude Code session asks about them one at a time. See them now: sprag seed');
       }
     } catch (e) {
       debug('install:seed-offer', e); // optional feature; never fail install
@@ -352,7 +352,7 @@ export async function run({ hasFlag }) {
     }
     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');
+      ? '버그 제보·기능 제안: https://github.com/rootstudioyaml/sprag/issues'
+      : 'Bug reports & feature requests: https://github.com/rootstudioyaml/sprag/issues');
     return;
 }

package/src/commands/last.js

@@ -3,8 +3,8 @@
  * Designed for the auto-trigger skill so the user immediately sees
  * "what just fired and how to fix it" without having to read the whole
  * history file.
- *   claude-token-saver last           # search last 1 day
- *   claude-token-saver last --days 7  # widen the lookback
+ *   sprag last           # search last 1 day
+ *   sprag last --days 7  # widen the lookback
  */
 
 
@@ -113,7 +113,7 @@ export async function run({ numArg }) {
       console.log('💡 ' + (lang === 'ko' ? CAP_TIPS.ko : CAP_TIPS.en));
       console.log('');
       console.log(lang === 'ko' ? '실행:' : 'Run:');
-      console.log('  claude-token-saver handoff');
+      console.log('  sprag handoff');
       return;
     }
     // Chip warning path: render full ISSUE_MESSAGES advice for each code,
@@ -121,8 +121,8 @@ export async function run({ numArg }) {
     // the history.md format).
     if (latest.codes.length === 0) {
       console.log(lang === 'ko'
-        ? '(진단 코드 없음 — 표 뷰를 열어보세요: `claude-token-saver --days 1`)'
-        : '(No diagnostic code attached — open the table view: `claude-token-saver --days 1`)');
+        ? '(진단 코드 없음 — 표 뷰를 열어보세요: `sprag --days 1`)'
+        : '(No diagnostic code attached — open the table view: `sprag --days 1`)');
       return;
     }
     // Pick a single language per field; fall back to EN when KO is missing.

package/src/commands/mode.js

@@ -1,9 +1,9 @@
 /**
  * Subcommand: mode — persist statusline preferences so future runs pick
  * them up without flags or wrapper edits.
- *   claude-token-saver mode                    # show current config
- *   claude-token-saver mode icon verbose       # set icon + verbose
- *   claude-token-saver mode reset              # clear back to defaults
+ *   sprag mode                    # show current config
+ *   sprag mode icon verbose       # set icon + verbose
+ *   sprag mode reset              # clear back to defaults
  */
 
 
@@ -28,7 +28,7 @@ export async function run({ args }) {
       console.log(`Stored config file (${configPath()}):`);
       console.log(`  ${Object.keys(raw).length === 0 ? '(none — using defaults)' : JSON.stringify(raw)}`);
       console.log('');
-      console.log('Change with: claude-token-saver mode <keywords...>');
+      console.log('Change with: sprag mode <keywords...>');
       console.log(`Keywords: ${VALID_KEYWORDS.join(', ')}`);
       return;
     }

package/src/commands/route-scan.js

@@ -303,13 +303,13 @@ export async function run({ args, hasFlag, numArg }) {
             ? [
                 `[sprag update] 새 버전이 나와 있습니다: v${u.current} → ${u.latest}.`,
                 '사용자에게 지금 업그레이드할지 물어보고, 승낙하면 아래 명령을 실행하십시오. 묻지 않고 설치하지는 마십시오.',
-                '  claude-token-saver upgrade            # 업그레이드 실행',
+                '  sprag upgrade            # 업그레이드 실행',
                 '  sprag update-check --dismiss   # 사용자가 원치 않으면 (다음 버전이 나올 때까지 다시 묻지 않습니다)',
               ].join('\n')
             : [
                 `[sprag update] A newer version is available: v${u.current} → ${u.latest}.`,
                 'Ask the user whether to upgrade now, and run the command below only if they agree. Do not install without asking.',
-                '  claude-token-saver upgrade                  # perform the upgrade',
+                '  sprag upgrade                  # perform the upgrade',
                 '  sprag update-check --dismiss   # if they decline (stays quiet until a newer release)',
               ].join('\n');
         }
@@ -366,8 +366,8 @@ export async function run({ args, hasFlag, numArg }) {
       }
       if (reviewRules.length > 0) {
         lines.push(lang === 'ko'
-          ? '[claude-token-saver rule-health] 사용자가 승인한 위임 룰 중, 위임 대상 유형의 최근 에러율이 기준(20%)을 넘어 재검토가 필요한 룰이 있습니다 — 사용자에게 브리핑하고 조건 좁히기/제거를 상의하세요:'
-          : '[claude-token-saver rule-health] Some user-approved delegation rules now exceed the 20% error-rate threshold for their delegated category — brief the user and discuss narrowing or removing them:');
+          ? '[sprag rule-health] 사용자가 승인한 위임 룰 중, 위임 대상 유형의 최근 에러율이 기준(20%)을 넘어 재검토가 필요한 룰이 있습니다 — 사용자에게 브리핑하고 조건 좁히기/제거를 상의하세요:'
+          : '[sprag rule-health] Some user-approved delegation rules now exceed the 20% error-rate threshold for their delegated category — brief the user and discuss narrowing or removing them:');
         for (const r of reviewRules) {
           // Say WHICH signal tripped: a measured delegation failure rate is a
           // much stronger claim than the shape-based proxy, and the user's

package/src/commands/seed.js

@@ -1,12 +1,12 @@
 /**
  * Subcommand: seed — register the bundled starter rules, one answer at a time.
  *
- *   claude-token-saver seed                          # what is still pending
- *   claude-token-saver seed accept <id> --global     # register one rule
- *   claude-token-saver seed accept <id> --project    # ... into this project only
- *   claude-token-saver seed accept all --global      # when the user says "all of them"
- *   claude-token-saver seed skip <id> | skip all     # never offer it again
- *   claude-token-saver seed reset                    # make every preset pending again
+ *   sprag seed                          # what is still pending
+ *   sprag seed accept <id> --global     # register one rule
+ *   sprag seed accept <id> --project    # ... into this project only
+ *   sprag seed accept all --global      # when the user says "all of them"
+ *   sprag seed skip <id> | skip all     # never offer it again
+ *   sprag seed reset                    # make every preset pending again
  *
  * Scope is explicit on purpose, exactly as `harness promote` requires it: the
  * hook environment is non-TTY, so the model has to ask the user and pass the
@@ -36,8 +36,8 @@ export async function run({ args, hasFlag }) {
     const ids = args.slice(2).filter((a) => !a.startsWith('-'));
     if (ids.length === 0) {
       console.error(ko
-        ? 'id를 지정하십시오 (목록: claude-token-saver seed). 전체는 `all`.'
-        : 'Pass an id (list them with `claude-token-saver seed`), or `all`.');
+        ? 'id를 지정하십시오 (목록: sprag seed). 전체는 `all`.'
+        : 'Pass an id (list them with `sprag seed`), or `all`.');
       process.exit(1);
     }
     const pending = seed.pendingSeeds({ lang, root });
@@ -99,7 +99,7 @@ export async function run({ args, hasFlag }) {
   if (pending.length > 0) {
     console.log('');
     console.log(ko
-      ? '등록: claude-token-saver seed accept <id> --global|--project   ·   거절: seed skip <id>'
-      : 'register: claude-token-saver seed accept <id> --global|--project   ·   decline: seed skip <id>');
+      ? '등록: sprag seed accept <id> --global|--project   ·   거절: seed skip <id>'
+      : 'register: sprag seed accept <id> --global|--project   ·   decline: seed skip <id>');
   }
 }

package/src/handoff.js

@@ -70,7 +70,7 @@ function renderTemplate({ now, cwd, git, caps }) {
   const lines = [];
   lines.push(`# Handoff — ${ymd(now)} ${pad(now.getHours())}:${pad(now.getMinutes())}`);
   lines.push('');
-  lines.push(`Generated by \`claude-token-saver handoff\`.`);
+  lines.push(`Generated by \`sprag handoff\`.`);
   lines.push('');
   lines.push('## Context');
   lines.push('');

package/src/history.js

@@ -306,7 +306,7 @@ export function recordCapTransition(window) {
 
 /**
  * Record a handoff write — invoked by the `handoff` subcommand so
- * `claude-token-saver history` shows when work was backed up to a HANDOFF file.
+ * `sprag history` shows when work was backed up to a HANDOFF file.
  *
  * @param {string} filePath
  * @returns {boolean}

package/src/installer.js

@@ -22,19 +22,19 @@ const STATUSLINE_REFRESH_INTERVAL = 5;
 
 const SKILL_BODY = `---
 name: claude-token-saver
-description: Use when the user mentions Claude Code token usage, prompt cache hit rate, TTL/expiry, the 1M context window, cache misses, output spikes, rate-limit caps (5h/7d), or anything in the statusline produced by claude-token-saver (chips like "🚨 5H 94%", "🚨 7D 92%", "⚠ Ctx 500k+", "⚠ Input spike", "⚠ Cache miss", "⚠ 5m TTL", "⚠ Rebuild churn", "⚠ Output heavy", "⚠ Call surge", "⏳ Cache expires", "💰 Cache saved", "🧠 Cache hit"). Also use when they ask to view token-usage history, want to understand a warning they just saw, or want to back up work before a session cap with \`claude-token-saver handoff\`.
+description: Use when the user mentions Claude Code token usage, prompt cache hit rate, TTL/expiry, the 1M context window, cache misses, output spikes, rate-limit caps (5h/7d), or anything in the statusline produced by sprag (chips like "🚨 5H 94%", "🚨 7D 92%", "⚠ Ctx 500k+", "⚠ Input spike", "⚠ Cache miss", "⚠ 5m TTL", "⚠ Rebuild churn", "⚠ Output heavy", "⚠ Call surge", "⏳ Cache expires", "💰 Cache saved", "🧠 Cache hit"). Also use when they ask to view token-usage history, want to understand a warning they just saw, or want to back up work before a session cap with \`sprag handoff\`.
 ---
 
-# claude-token-saver — Claude Code Token Monitor
+# sprag — Claude Code Token Monitor
 
-This skill helps users interpret and act on the \`claude-token-saver\` statusline
+This skill helps users interpret and act on the \`sprag\` statusline
 in Claude Code. The statusline updates every ~1s and shows cache health, TTL
 countdown, savings, and (when relevant) a leading warning chip.
 
 ## Response language
 
 Respond in the user's configured output language. Run
-\`claude-token-saver mode\` once at the start of the session and read the
+\`sprag mode\` once at the start of the session and read the
 \`Output language\` field — if it shows \`language: ko\`, write **all of your
 prose to the user in Korean** (summary, "All clear" status lines, headings,
 recommendations). If it shows \`language: en\` (the default), write in
@@ -52,7 +52,7 @@ honor that for the rest of the turn without changing the saved setting.
   "when did this start happening", or similar.
 - The user is approaching a rate-limit cap and wants to back up the current
   work so a fresh session can continue (point them at
-  \`claude-token-saver handoff\`).
+  \`sprag handoff\`).
 - The user wants to see the token-usage history file or asks for a summary
   of recent warnings.
 - The user asks for a quick token report or "current state" check (the
@@ -62,16 +62,16 @@ honor that for the rest of the turn without changing the saved setting.
 ## What to do
 
 1. **Lead with the most recent warning + how to handle it.** Run
-   \`claude-token-saver last\` first. It returns the most recent warning event
+   \`sprag last\` first. It returns the most recent warning event
    (chip + detail + timestamp) plus the full advice block for it. Surface that
    to the user before anything else — this is what they came for.
 2. **Identify the chip.** If the user pasted a statusline (instead of relying
    on \`last\`), pull out the leading \`⚠ ...\` chip. That maps to a specific
    issue category.
-3. **Show recent history.** Run \`claude-token-saver history\` (default last 7
+3. **Show recent history.** Run \`sprag history\` (default last 7
    days) to see the chronology of warning transitions. Each entry is timestamped,
    bilingual (English line + 한국어), and includes a \`💡\` action tip inline.
-4. **Drill down on the live state.** Run \`claude-token-saver --days 1\` (or
+4. **Drill down on the live state.** Run \`sprag --days 1\` (or
    another window) to render the full table view, which lists per-session
    spikes and recommended actions.
 5. **Explain the warning** in plain language. Use the chip → cause table:
@@ -94,7 +94,7 @@ honor that for the rest of the turn without changing the saved setting.
    that is expected, not a failure of this tool.
 
 6. **Suggest the next action.** For \`🚨 5H/7D\` chips, recommend running
-   \`claude-token-saver handoff\` to back up the current work to a
+   \`sprag handoff\` to back up the current work to a
    \`HANDOFF-*.md\` file before the cap hits, then continue in a fresh
    session. For \`⚠ Ctx 500k+\`, recommend \`/compact\` or \`/clear\` and
    checking what is pinned into context. For
@@ -103,18 +103,18 @@ honor that for the rest of the turn without changing the saved setting.
 
 ## Useful commands
 
-- \`claude-token-saver last\` — most recent warning + full advice (start here).
-- \`claude-token-saver last --days 7\` — widen the lookback window.
-- \`claude-token-saver\` — full table report (default last 1 day).
-- \`claude-token-saver --days 7\` — wider window.
-- \`claude-token-saver history\` — recent warning transitions per day, with
+- \`sprag last\` — most recent warning + full advice (start here).
+- \`sprag last --days 7\` — widen the lookback window.
+- \`sprag\` — full table report (default last 1 day).
+- \`sprag --days 7\` — wider window.
+- \`sprag history\` — recent warning transitions per day, with
   inline \`💡\` action tips.
-- \`claude-token-saver history --days 30\` — longer history.
-- \`claude-token-saver handoff\` — write a HANDOFF-*.md template in cwd
+- \`sprag history --days 30\` — longer history.
+- \`sprag handoff\` — write a HANDOFF-*.md template in cwd
   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
+- \`sprag mode\` — show statusline preferences.
+- \`sprag mode icon verbose 1d\` — change preferences.
+- \`sprag 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).
@@ -163,7 +163,7 @@ export function removeLegacyCommand() {
 
 // Registers/repairs the Claude Code statusLine entry in ~/.claude/settings.json.
 // - No statusLine yet: insert ours with refreshInterval:STATUSLINE_REFRESH_INTERVAL.
-// - statusLine already points at claude-token-saver: ensure that refreshInterval
+// - statusLine already points at sprag: ensure that refreshInterval
 //   (this is the bit that makes the TTL countdown tick every second while idle).
 // - statusLine points at a different command: leave it alone unless --force.
 export function installStatusline({ force = false } = {}) {
@@ -219,7 +219,7 @@ export function installStatusline({ force = false } = {}) {
 
 // Registers the SessionStart hook that surfaces route-scan delegation
 // candidates as session context (startup + /clear). Idempotent: skips when a
-// claude-token-saver route-scan hook is already present; never touches other
+// sprag route-scan hook is already present; never touches other
 // hooks the user configured.
 const ROUTE_SCAN_HOOK_COMMAND = 'claude-token-saver route-scan --hook';
 

package/src/korean-style.js

@@ -67,9 +67,13 @@ export function koreanStyleDecided(cfg = loadConfig()) {
  * locale variables, then (macOS only, where those are routinely unset) the
  * system locale.
  */
-export function koreanLocaleDetected({ env = process.env, platform = process.platform } = {}) {
+export function koreanLocaleDetected({ env = process.env, platform = process.platform, cfg } = {}) {
   try {
-    if (loadConfig().language === 'ko') return true;
+    // The saved language answer only applies to the live process environment.
+    // A caller that injects a synthetic `env` (tests, simulations) is asking
+    // about that environment, not about this machine's recorded choice.
+    const c = cfg !== undefined ? cfg : (env === process.env ? loadConfig() : null);
+    if (c && c.language === 'ko') return true;
   } catch { /* unreadable config falls through to the env checks */ }
   const posix = [env.LC_ALL, env.LC_MESSAGES, env.LANG, env.LANGUAGE].filter(
     (v) => typeof v === 'string' && v.trim() && v !== 'C' && v !== 'POSIX',

package/src/model-rules.js

@@ -198,7 +198,7 @@ export function removeModelRule(index1) {
 export function renderModelRatchet(rules, lang = userLanguage()) {
   const ko = lang === 'ko';
   const lines = ko ? [
-    '# Model-Fitting Ratchet (claude-token-saver 자동 관리)',
+    '# Model-Fitting Ratchet (sprag 자동 관리)',
     '',
     '로그 기반 티어 위임 룰. 이 파일은 route-scan이 매 스캔마다 통째로 재생성하므로',
     '직접 수정하지 마세요 — 목록/제거: `sprag route-scan rules [rm <N>]`.',
@@ -245,7 +245,7 @@ export function renderModelRatchet(rules, lang = userLanguage()) {
     '## Rules',
     '',
   ] : [
-    '# Model-Fitting Ratchet (managed by claude-token-saver)',
+    '# Model-Fitting Ratchet (managed by sprag)',
     '',
     'Log-derived tier delegation rules. route-scan regenerates this file in full',
     'on every scan — do not edit it by hand. List / remove with:',