claude-token-saver 3.43.0 → 3.44.0

package/bin/cli.js

@@ -209,7 +209,7 @@ async function main() {
   //   sprag route-scan --hook          # SessionStart hook mode (context injection)
   //   sprag route-scan dismiss <N>     # mute candidate R<N>
   // Promote a candidate to a ratchet rule (scope is always explicit):
-  //   sprag harness promote R<N> --project|--global
+  //   sprag harness promote R<N> --global|--project
   // brief --hook — UserPromptSubmit hook mode: per-session, change-triggered
   // briefing of state the statusline can only chip (ctx tier crossings,
   // mid-session route/rule-health changes). Silent when nothing changed.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-token-saver",
-  "version": "3.43.0",
+  "version": "3.44.0",
   "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/presets/ratchet-rules.json

@@ -15,8 +15,8 @@
       "en": "When a web fetch/search is blocked by robots or user-agent checks ('unable to fetch' and similar) → retry with curl carrying a browser UA header (Mozilla/5.0 ... Chrome/...). Sites like reddit also answer on their .json endpoints with that UA"
     },
     {
-      "ko": "ratchet 룰 promote 호출 직전 사용자에게 scope(project/global)를 먼저 묻는다 — Bash 환경은 non-TTY라 CLI readline 프롬프트가 안 뜨므로, 호출자(LLM)가 대신 묻고 --project/--global 플래그를 명시해 실행",
-      "en": "Ask the user for the scope (project or global) before calling ratchet promote — the Bash environment is non-TTY, so the CLI's readline prompt never appears; the caller (the model) has to ask and pass --project/--global explicitly"
+      "ko": "ratchet 룰 promote 호출 직전 사용자에게 scope(global/project)를 먼저 묻는다 — Bash 환경은 non-TTY라 CLI readline 프롬프트가 안 뜨므로, 호출자(LLM)가 대신 묻고 --global/--project 플래그를 명시해 실행",
+      "en": "Ask the user for the scope (global or project) before calling ratchet promote — the Bash environment is non-TTY, so the CLI's readline prompt never appears; the caller (the model) has to ask and pass --global/--project explicitly"
     },
     {
       "ko": "자동화 도구가 grep·정규식으로 찾는 마커 텍스트(헤더·앵커·키워드 라인)는 리팩터링·압축·수정 금지 — 정확 매칭 검출은 한 글자만 바뀌어도 깨짐",

package/src/brief.js

@@ -226,7 +226,7 @@ export async function runBrief({ sessionId, transcriptPath, now = Date.now() })
     }
     for (const [kind, x] of fresh) {
       items.push(kind === 'route'
-        ? `새 위임 후보가 감지되었습니다 — "${x.label}" 유형 ${x.count}회 반복(statusline의 route? R${x.id} 칩). 등록: sprag harness promote R${x.id} --project|--global (적용 범위는 사용자에게 확인) / 무시: route-scan dismiss ${x.id}`
+        ? `새 위임 후보가 감지되었습니다 — "${x.label}" 유형 ${x.count}회 반복(statusline의 route? R${x.id} 칩). 등록: sprag harness promote R${x.id} --global|--project (적용 범위는 사용자에게 확인) / 무시: route-scan dismiss ${x.id}`
         : `승인된 위임 룰의 최근 에러율이 기준(20%)을 넘었습니다 — "${x.label}" (${x.healthSource === 'delegated' ? `위임 실행 ${x.delegatedRuns}건 중 에러율 ${Math.round((x.delegatedErrRate || 0) * 100)}%` : `유사 에피소드 기준 에러율 ${Math.round((x.errRate || 0) * 100)}%`}, statusline의 rule-health 칩). 조건 좁히기/제거를 사용자와 상의하세요: sprag route-scan rules`);
     }
     s.briefed = [...briefed];

package/src/commands/brief.js

@@ -7,7 +7,7 @@
  *   sprag route-scan --hook          # SessionStart hook mode (context injection)
  *   sprag route-scan dismiss <N>     # mute candidate R<N>
  * Promote a candidate to a ratchet rule (scope is always explicit):
- *   sprag harness promote R<N> --project|--global
+ *   sprag harness promote R<N> --global|--project
  * brief --hook — UserPromptSubmit hook mode: per-session, change-triggered
  * briefing of state the statusline can only chip (ctx tier crossings,
  * mid-session route/rule-health changes). Silent when nothing changed.

package/src/commands/route-scan.js

@@ -356,11 +356,11 @@ export async function run({ args, hasFlag, numArg }) {
         }
         if (lang === 'ko') {
           lines.push('등록하면 다음 세션부터 자동 위임됩니다. 사용자에게 등록 여부를 물을 때 위 룰 원문을 그대로 보여주고, 적용 범위까지 확인한 뒤 실행하세요:');
-          lines.push('  sprag harness promote R<N> --project|--global   # 적용 범위는 반드시 사용자에게 확인');
+          lines.push('  sprag harness promote R<N> --global|--project   # 적용 범위는 반드시 사용자에게 확인');
           lines.push('  sprag route-scan dismiss <N>                    # 사용자가 원치 않으면');
         } else {
           lines.push('Once registered, delegation happens automatically from the next session. Show the user the rule text verbatim, confirm the scope with them, then run:');
-          lines.push('  sprag harness promote R<N> --project|--global   # ALWAYS confirm the scope with the user first');
+          lines.push('  sprag harness promote R<N> --global|--project   # ALWAYS confirm the scope with the user first');
           lines.push('  sprag route-scan dismiss <N>                    # if they do not want it');
         }
       }
@@ -446,7 +446,7 @@ export async function run({ args, hasFlag, numArg }) {
     }
     console.log('');
     console.log(lang === 'ko' ? '등록 / 무시:' : 'Promote / dismiss:');
-    console.log('  sprag harness promote R<N> --project|--global');
+    console.log('  sprag harness promote R<N> --global|--project');
     console.log('  sprag route-scan dismiss <N>');
     // 최초 1회만 — 매번 찍으면 도구가 광고판이 된다 (CTS_NO_NOTE=1 로 끔)
     (await import('../first-run-note.js')).printOnce('route-scan', lang);

package/src/commands/upgrade.js

@@ -25,7 +25,8 @@ function runCommand(cmd) {
 }
 
 export async function run({ hasFlag, version }) {
-  const { updateStatus, refreshUpdateState, upgradeCommand } = await import('../update-check.js');
+  const { updateStatus, refreshUpdateState, upgradeCommand, INSTALLED_UNDER_LEGACY_NAME } =
+    await import('../update-check.js');
   const { userLanguage } = await import('../config.js');
   const lang = userLanguage();
   const cmd = upgradeCommand();
@@ -40,6 +41,25 @@ export async function run({ hasFlag, version }) {
   // network round trip is fine here.
   await refreshUpdateState(version);
   const s = updateStatus(version);
+  // A legacy-name copy has somewhere to go even on the newest version: the
+  // package was renamed, and only the new name keeps receiving releases.
+  if (!s.available && INSTALLED_UNDER_LEGACY_NAME) {
+    console.log(lang === 'ko'
+      ? `패키지 이름이 claude-token-saver 에서 sprag-cli 로 바뀌었습니다. 버전은 최신(v${version})이지만, 앞으로의 릴리스를 계속 받으려면 새 이름으로 옮겨야 합니다.`
+      : `The package was renamed from claude-token-saver to sprag-cli. You are on the latest version (v${version}), but future releases only ship under the new name.`);
+    console.log(`$ ${cmd}`);
+    const migrateCode = await runCommand(cmd);
+    if (migrateCode !== 0) {
+      console.error(lang === 'ko'
+        ? `이전 명령이 종료 코드 ${migrateCode}로 실패했습니다. 위 출력을 확인하십시오.`
+        : `Migration command failed with exit code ${migrateCode}. Check the output above.`);
+      process.exit(migrateCode);
+    }
+    console.log(lang === 'ko'
+      ? '이전이 끝났습니다. 새 셸에서 sprag --version 으로 확인하십시오.'
+      : 'Migration done. Confirm with sprag --version in a fresh shell.');
+    return;
+  }
   if (!s.available) {
     console.log(lang === 'ko'
       ? `이미 최신 버전입니다 (v${version}). 설치할 것이 없습니다.`
@@ -48,8 +68,12 @@ export async function run({ hasFlag, version }) {
   }
 
   console.log(lang === 'ko'
-    ? `v${version} → ${s.latest} 로 업그레이드합니다.`
-    : `Upgrading v${version} → ${s.latest}.`);
+    ? (INSTALLED_UNDER_LEGACY_NAME
+      ? `v${version} → ${s.latest} 로 업그레이드하면서 새 패키지 이름(sprag-cli)으로 함께 옮깁니다.`
+      : `v${version} → ${s.latest} 로 업그레이드합니다.`)
+    : (INSTALLED_UNDER_LEGACY_NAME
+      ? `Upgrading v${version} → ${s.latest} and moving to the new package name (sprag-cli).`
+      : `Upgrading v${version} → ${s.latest}.`));
   console.log(`$ ${cmd}`);
   const code = await runCommand(cmd);
   if (code !== 0) {

package/src/harness-templates.js

@@ -60,9 +60,10 @@ ${HARNESS_SECTIONS[0].heading}
 - 같은 에러·오해·반복 작업이 한 번 더 발생하면 즉시 \`.claude/ratchet.md\`에
   "조건 → 행동" 한 줄로 룰 추가.
 - sprag가 후보를 감지하면 statusline에 \`🅷⚠ ratchet?\`로 알림.
-  \`sprag harness promote "<rule>" --project|--global\`로 승인.
-- **scope는 항상 사용자에게 먼저 물어볼 것** — 프로젝트 한정이면 \`--project\`,
-  도구·환경 일반 룰이면 \`--global\`(\`~/.claude/ratchet.md\`). Bash 환경은
+  \`sprag harness promote "<rule>" --global|--project\`로 승인.
+- **scope는 항상 사용자에게 먼저 물어볼 것.** 선택지는 글로벌을 먼저 제시한다.
+  도구·환경 일반 룰이면 \`--global\`(\`~/.claude/ratchet.md\`), 프로젝트 한정이면
+  \`--project\`. Bash 환경은
   non-TTY라 CLI의 readline 프롬프트가 안 뜨므로, 호출자(LLM)가 직접 묻고
   플래그를 명시해야 함. 묻지 않고 기본값으로 등록하지 말 것.
 - 승인된 룰은 이 블록 맨 아래 \`@\` import로 매 세션 로드된다 — 그 import 라인을
@@ -109,7 +110,7 @@ ${HARNESS_SECTIONS[4].heading}
 
 📌 운영:
 - \`sprag harness check\` — 현재 셋업 점수
-- \`sprag harness promote "<룰>" --project|--global\` — ratchet에 룰 추가 (scope는 사용자에게 먼저 물어볼 것)
+- \`sprag harness promote "<룰>" --global|--project\` — ratchet에 룰 추가 (scope는 사용자에게 먼저 물어볼 것)
 - \`sprag harness off\` — statusline 표시 끄기
 
 ---

package/src/route-scan.js

@@ -14,7 +14,7 @@
  *
  * Pipeline position (per design discussion): this scan is NOT a real-time
  * router — it is a session-boundary calibrator that feeds the existing
- * ratchet promote flow (`harness promote R<N> --project|--global`).
+ * ratchet promote flow (`harness promote R<N> --global|--project`).
  */
 
 import { readFileSync, writeFileSync, existsSync, mkdirSync, statSync } from 'node:fs';

package/src/seed-rules.js

@@ -243,7 +243,9 @@ export function seedOfferBlock({ lang = userLanguage(), root = findProjectRoot()
   const lines = [];
   if (lang === 'ko') {
     lines.push(`[claude-token-saver seed] 아직 등록되지 않은 추천 룰이 ${pending.length}건 있습니다 (패키지 동봉 프리셋).`);
+    lines.push('**이 세션의 첫 응답에서 다른 작업보다 먼저 1번 룰의 등록 여부를 물어보십시오.** 사용자가 먼저 꺼낸 용건이 있으면 그 답변을 마친 직후에 이어서 묻고, 용건이 끝나기를 기다리지 마십시오. 사용자가 이 안내 문구에 대해 질문할 때까지 미루면 안 됩니다.');
     lines.push('사용자에게 **한 건씩 순서대로** 보여 주고 등록할지 물어보십시오. 한 번에 전체 등록을 권하지 말고, 답을 받은 뒤 바로 아래 명령을 실행하십시오.');
+    lines.push('적용 범위를 물을 때는 선택지를 **글로벌(모든 프로젝트)을 먼저, 이 프로젝트만을 그다음**으로 제시하십시오.');
     if (models.length > 0) {
       lines.push(`  · 모델 피팅 룰 ${models.length}건 — 등록하면 해당 유형 작업이 더 싼 서브에이전트로 위임됩니다.`);
       for (const s of models) {
@@ -260,7 +262,9 @@ export function seedOfferBlock({ lang = userLanguage(), root = findProjectRoot()
     lines.push('  (사용자가 "전부 등록"이라고 답하면 `seed accept all --global` 을 쓸 수 있습니다)');
   } else {
     lines.push(`[claude-token-saver seed] ${pending.length} recommended rule(s) from the bundled presets are not registered yet.`);
+    lines.push('**Ask about rule 1 in your very first reply of this session, before anything else.** If the user opened with their own request, answer it and then ask right away; do not wait for their task to finish, and never wait until they ask about this notice.');
     lines.push('Walk the user through them **one at a time** and ask about each. Do not push the whole set at once; run the matching command as soon as they answer.');
+    lines.push('When you ask about the scope, offer **global (all projects) first, this project only second**.');
     if (models.length > 0) {
       lines.push(`  · ${models.length} model-fitting rule(s) — once registered, that kind of work goes to a cheaper subagent.`);
       for (const s of models) {

package/src/update-check.js

@@ -23,10 +23,15 @@ import { fileURLToPath } from 'node:url';
 import { userDataDir } from './paths.js';
 import { debug } from './debug.js';
 
-// Whichever name this copy was installed under (sprag-cli or the legacy
-// claude-token-saver) is the one whose registry entry must be consulted.
+// This copy may be installed under the canonical name or under the legacy one.
+// Releases go out under the canonical name, so that is the entry the registry
+// check consults either way — a legacy copy must keep hearing about new
+// versions even after the legacy name stops receiving publishes.
 import { createRequire } from 'node:module';
 const PKG_NAME = createRequire(import.meta.url)('../package.json').name;
+const CANONICAL_NAME = 'sprag-cli';
+const LEGACY_NAME = 'claude-token-saver';
+const IS_LEGACY = PKG_NAME === LEGACY_NAME;
 const CHECK_INTERVAL_MS = 24 * 60 * 60 * 1000; // 24h — the registry is not a health endpoint
 const FETCH_TIMEOUT_MS = 5000;
 
@@ -148,7 +153,7 @@ export async function refreshUpdateState(currentVersion) {
   try {
     // The `latest` dist-tag endpoint returns a few hundred bytes, unlike the
     // full packument which is megabytes for a package with this many releases.
-    const res = await fetch(`https://registry.npmjs.org/${PKG_NAME}/latest`, {
+    const res = await fetch(`https://registry.npmjs.org/${CANONICAL_NAME}/latest`, {
       signal: controller.signal,
       headers: { accept: 'application/json' },
     });
@@ -194,6 +199,15 @@ export function dismissUpdate(version) {
  */
 export function upgradeCommand() {
   const here = dirname(fileURLToPath(import.meta.url));
+  // A legacy copy upgrades by moving to the canonical name. Installing the new
+  // name alone would leave two copies fighting over the same `sprag` binary,
+  // so the old one comes off first.
+  if (IS_LEGACY) {
+    if (here.includes('/pnpm/')) return `pnpm remove -g ${LEGACY_NAME} && pnpm add -g ${CANONICAL_NAME}@latest`;
+    if (here.includes('/.bun/')) return `bun remove -g ${LEGACY_NAME} && bun add -g ${CANONICAL_NAME}@latest`;
+    if (here.includes('/.yarn/')) return `yarn global remove ${LEGACY_NAME} && yarn global add ${CANONICAL_NAME}@latest`;
+    return `npm uninstall -g ${LEGACY_NAME} && npm install -g ${CANONICAL_NAME}@latest`;
+  }
   if (here.includes('/pnpm/')) return `pnpm add -g ${PKG_NAME}@latest`;
   if (here.includes('/.bun/')) return `bun add -g ${PKG_NAME}@latest`;
   if (here.includes('/.yarn/')) return `yarn global add ${PKG_NAME}@latest`;
@@ -202,3 +216,6 @@ export function upgradeCommand() {
 
 export const UPDATE_CHECK_INTERVAL_MS = CHECK_INTERVAL_MS;
 export const PACKAGE_NAME = PKG_NAME;
+export const CANONICAL_PACKAGE_NAME = CANONICAL_NAME;
+/** True when this copy was installed under the legacy package name. */
+export const INSTALLED_UNDER_LEGACY_NAME = IS_LEGACY;