claude-token-saver 3.31.0 → 3.34.0

package/src/commands/route-scan.js

@@ -137,9 +137,17 @@ export async function run({ args, hasFlag, numArg }) {
         const health = r.status === 'review'
           ? (lang === 'ko' ? '  ⚠ 에러율 초과 — 재검토 필요' : '  ⚠ error rate over threshold — needs review')
           : '';
+        // A seeded rule has no recurrence of its own until a scan measures one,
+        // so "반복 0회 / seen ×0" would misreport a curated preset as work that
+        // never happens.
+        const evidence = r.origin === 'preset' && !r.count
+          ? (lang === 'ko' ? '동봉 프리셋 (로그 누적 전)' : 'bundled preset (no local history yet)')
+          : (lang === 'ko'
+            ? `반복 ${r.count || 0}회 · 에러율 ${Math.round((r.errRate || 0) * 100)}%`
+            : `seen ×${r.count || 0} · err ${Math.round((r.errRate || 0) * 100)}%`);
         const stat = lang === 'ko'
-          ? `${r.tier} (${rs.tierLabel(r.tier)}) · ${rs.scopeLabel(r.scope)} · 반복 ${r.count || 0}회 · 에러율 ${Math.round((r.errRate || 0) * 100)}%`
-          : `${r.tier} (${rs.tierLabel(r.tier, 'en')}) · ${rs.scopeLabel(r.scope, 'en')} · seen ×${r.count || 0} · err ${Math.round((r.errRate || 0) * 100)}%`;
+          ? `${r.tier} (${rs.tierLabel(r.tier)}) · ${rs.scopeLabel(r.scope)} · ${evidence}`
+          : `${r.tier} (${rs.tierLabel(r.tier, 'en')}) · ${rs.scopeLabel(r.scope, 'en')} · ${evidence}`;
         console.log(`  #${i + 1} ${stat}${health}`);
         // Measured outcome of the rule actually firing, plus what it saved.
         // A rule with no measured delegations shows "—", never "$0.00": the
@@ -254,6 +262,19 @@ export async function run({ args, hasFlag, numArg }) {
         if (doc2mdHookRegistered()) doc2mdBlock = require('../doc2md.cjs').sessionNote(lang);
       } catch (e) { debug('route-scan:doc2md-note', e); /* the note is optional */ }
 
+      // Starter rules that the user has not answered yet (bundled presets, both
+      // model-fitting and ratchet). A fresh install has an empty model ratchet
+      // and an empty ratchet.md, so without this the tool delegates nothing
+      // until the user's own history is long enough to propose a candidate.
+      // The asking happens here because a CLI prompt cannot reach a user whose
+      // only interface is the chat: the model gets the list and asks one rule
+      // at a time. Silent — and free — once everything has an answer.
+      let seedBlock = null;
+      try {
+        const { seedOfferBlock } = await import('../seed-rules.js');
+        seedBlock = seedOfferBlock({ lang });
+      } catch (e) { debug('route-scan:seed-offer', e); /* the offer is optional */ }
+
       // Upgrade offer. A statusline cannot open a dialog, so session start is
       // where the *asking* happens: the model gets one line telling it a newer
       // version exists and to ask before installing anything. Cached read only
@@ -288,11 +309,13 @@ export async function run({ args, hasFlag, numArg }) {
 
       if (open.length === 0 && reviewRules.length === 0) {
         if (updateBlock) console.log(updateBlock);
+        if (seedBlock) console.log(seedBlock);
         if (doc2mdBlock) console.log(doc2mdBlock);
         if (koreanBlock) console.log(koreanBlock);
         return; // nothing else to inject
       }
       if (updateBlock) console.log(updateBlock);
+      if (seedBlock) console.log(seedBlock);
       if (doc2mdBlock) console.log(doc2mdBlock);
       // This text is injected straight into the model's context, so it must
       // follow the user's configured language — a Korean-only briefing in an

package/src/commands/seed.js

@@ -0,0 +1,105 @@
+/**
+ * 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
+ *
+ * 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
+ * flag rather than let a default decide where a rule lands.
+ */
+
+export async function run({ args, hasFlag }) {
+  const sub = args[1];
+  const seed = await import('../seed-rules.js');
+  const { userLanguage } = await import('../config.js');
+  const { findProjectRoot } = await import('../harness.js');
+  const lang = userLanguage();
+  const ko = lang === 'ko';
+  const root = findProjectRoot();
+
+  const scopeFlag = () => (hasFlag('--global') ? 'global' : hasFlag('--project') ? 'project' : null);
+
+  if (sub === 'reset') {
+    const n = seed.resetSeeds();
+    console.log(ko
+      ? `기록된 응답 ${n}건을 지웠습니다 — 프리셋 전체가 다시 제안 대상이 됩니다.`
+      : `Cleared ${n} recorded answer(s) — every preset is pending again.`);
+    return;
+  }
+
+  if (sub === 'accept' || sub === 'skip') {
+    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`.');
+      process.exit(1);
+    }
+    const pending = seed.pendingSeeds({ lang, root });
+    const targets = ids.includes('all') ? pending.map((s) => s.id) : ids;
+
+    if (sub === 'skip') {
+      for (const id of targets) {
+        const r = seed.skipSeed(id, { lang, root });
+        console.log(r
+          ? (ko ? `건너뜀: ${id}` : `skipped: ${id}`)
+          : (ko ? `대기 중인 프리셋이 아닙니다: ${id}` : `not a pending preset: ${id}`));
+      }
+      return;
+    }
+
+    const scope = scopeFlag();
+    if (!scope) {
+      console.error(ko
+        ? '적용 범위를 명시하십시오 (사용자에게 먼저 확인): --global 또는 --project'
+        : 'Scope required (confirm it with the user first): --global or --project');
+      process.exit(1);
+    }
+    for (const id of targets) {
+      const r = await seed.acceptSeed(id, { scope, root, lang });
+      if (!r) {
+        console.log(ko ? `대기 중인 프리셋이 아닙니다: ${id}` : `not a pending preset: ${id}`);
+        continue;
+      }
+      console.log(ko
+        ? `✅ 등록: ${id} [${scope === 'global' ? '전체 프로젝트' : '이 프로젝트'}]`
+        : `✅ registered: ${id} [${scope}]`);
+      console.log(`   ${r.rule}`);
+      for (const p of r.paths || (r.path ? [r.path] : [])) console.log(`   → ${p}`);
+    }
+    return;
+  }
+
+  // Default: status. Lists what is pending and what was already answered, so a
+  // user who said no can see that they did and reverse it with `reset`.
+  const pending = seed.pendingSeeds({ lang, root });
+  const { decided } = seed.loadSeedState();
+  const answered = Object.entries(decided);
+  console.log(ko
+    ? `seed — 동봉 프리셋 중 대기 ${pending.length}건, 응답 완료 ${answered.length}건`
+    : `seed — ${pending.length} preset(s) pending, ${answered.length} already answered`);
+  for (const s of pending) {
+    const head = s.kind === 'model'
+      ? `[${s.id}] ${s.tier} · "${s.label}" → ${s.agent}`
+      : `[${s.id}] ${ko ? '랫쳇 룰' : 'ratchet rule'}`;
+    console.log(`  ${head}`);
+    console.log(`      ${s.ruleText}`);
+  }
+  if (answered.length > 0) {
+    console.log(ko ? '  응답 기록:' : '  answered:');
+    for (const [id, d] of answered) {
+      console.log(`    ${id}: ${d.action}${d.scope ? ` (${d.scope})` : ''} — ${d.at}`);
+    }
+  }
+  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>');
+  }
+}

package/src/config.js

@@ -197,6 +197,31 @@ export function userLanguage() {
   return v === 'ko' ? 'ko' : 'en';
 }
 
+/**
+ * Whether the language is a recorded choice rather than the 'en' fallback.
+ *
+ * The install needs the distinction: a user who picked English must not be
+ * asked again on the next upgrade, and "nothing recorded" has to stay
+ * distinguishable from "chose en", which `userLanguage()` alone cannot say.
+ */
+export function languageDecided() {
+  const cfg = loadConfig();
+  const v = cfg.language || (cfg.statusline && cfg.statusline.language);
+  return v === 'ko' || v === 'en';
+}
+
+/** Record the output language ('ko' | 'en'). Anything else is ignored. */
+export function setUserLanguage(v) {
+  const lang = v === 'ko' ? 'ko' : v === 'en' ? 'en' : null;
+  if (!lang) return null;
+  const cfg = loadConfig();
+  cfg.language = lang;
+  // The legacy slot would win on a later read for configs written by 2.9.x.
+  if (cfg.statusline) delete cfg.statusline.language;
+  saveConfig(cfg);
+  return lang;
+}
+
 /**
  * Render hours as the most natural unit:
  *   24h → "1d", 168h → "7d", 6h → "6h", 36h → "36h" (not whole days).

package/src/demo.js

@@ -99,15 +99,16 @@ const SCENARIOS = [
   },
   {
     name: 'ctx-1m',
-    label: '⚠ Context past 200k',
+    label: '⚠ Context past 500k',
     data: {
       hitRate: 0.78,
       pct1h: 0.92,
       savings: 1340,
       elapsedSec: 30,
       contextSize: '1M',
-      ctxUsedPct: 28, // 28% of 1M ≈ 280k actually in context
-      spikeChip: '⚠ Ctx 200k+',
+      ctxOverWarn: true,
+      ctxUsedPct: 62, // 62% of 1M ≈ 620k actually in context
+      spikeChip: '⚠ Ctx 500k+',
       caps: HEALTHY_CAPS,
     },
   },
@@ -271,9 +272,9 @@ export function buildTableDemoData(options = {}) {
       version: options.version ?? '',
     },
     spikeReport: { spikes, baseline: { p95: 940_000 } },
-    contextWindow: { size: '1M', maxContext: 280_000 },
+    contextWindow: { size: '1M', maxContext: 620_000, overWarn: true },
     lastActivity: Date.now() - 60 * 1000,
-    spikeChip: '⚠ Ctx 200k+',
+    spikeChip: '⚠ Ctx 500k+',
   };
 }
 
@@ -303,7 +304,7 @@ export function buildScenarioData(scenarioName, options) {
     if (!scenario) return null;
   }
 
-  const { hitRate, pct1h, pct5m, savings, elapsedSec, contextSize, ctxUsedPct, spikeChip, caps } = scenario.data;
+  const { hitRate, pct1h, pct5m, savings, elapsedSec, contextSize, ctxOverWarn, ctxUsedPct, spikeChip, caps } = scenario.data;
   return {
     summary: { hitRate },
     ttl: { pct1h, pct5m: pct5m ?? (1 - pct1h) },
@@ -315,7 +316,7 @@ export function buildScenarioData(scenarioName, options) {
       version: options.version ?? '',
     },
     lastActivity: Date.now() - elapsedSec * 1000,
-    contextWindow: { size: contextSize },
+    contextWindow: { size: contextSize, overWarn: Boolean(ctxOverWarn) },
     // Live fill level (`📦 68%`) — scenarios that set ctxUsedPct exercise the
     // stdin-driven segment; the rest fall back to the size-based chip.
     ctxLive: ctxUsedPct != null

package/src/formatters/statusline.js

@@ -545,7 +545,9 @@ export function formatReport(data, { color = true, verbose = false, timer = true
     }
   } else if (contextWindow && contextWindow.size && contextWindow.size !== 'unknown') {
     const label = contextWindow.size === '1M' ? '1M' : '200k';
-    const ctxColor = contextWindow.size === '1M' ? YELLOW : GREEN;
+    // Yellow is reserved for the 500k warn line. A 1M window by itself is the
+    // default on every current model, so colouring it yellow cried wolf.
+    const ctxColor = contextWindow.overWarn ? YELLOW : GREEN;
     if (isIcon && verbose) {
       ctxSeg = `${c(ctxColor)}📦 Ctx ${label}${c(RESET)}`;
     } else if (isIcon) {

package/src/formatters/table.js

@@ -84,9 +84,9 @@ function renderSpikeSection(spikes, contextWindow) {
   const lines = [];
   lines.push(rbl('  ⚠ Token spike detected'));
   lines.push(r(`  ${'─'.repeat(50)}`));
-  if (contextWindow && contextWindow.size === '1M') {
+  if (contextWindow && contextWindow.overWarn) {
     lines.push(
-      r(`  Context usage exceeded 200k  (max recent single-request input ${formatContextSize(contextWindow.maxContext)} tokens)`),
+      r(`  Context usage exceeded 500k  (max recent single-request input ${formatContextSize(contextWindow.maxContext)} tokens)`),
     );
     lines.push('');
   }
@@ -196,9 +196,11 @@ export function formatReport({ summary: sum, trend, ttl, anomalies, cost, option
   // Context window chip for the normal case too
   if (contextWindow && contextWindow.size !== 'unknown') {
     const note =
-      contextWindow.size === '1M'
-        ? '⚠ Context exceeded 200k in recent requests — big contexts re-bill every turn and drain the 5H/7D caps. Use /compact or /clear.'
-        : '✓ 200k context (standard)';
+      contextWindow.overWarn
+        ? '⚠ Context exceeded 500k in recent requests — big contexts re-bill every turn and drain the 5H/7D caps. Use /compact or /clear.'
+        : contextWindow.size === '1M'
+          ? '✓ 1M window in use, under the 500k warn line'
+          : '✓ 200k context (standard)';
     lines.push(`  Context window: ${contextWindow.size}  ${note}`);
     lines.push(`  (max recent single-request input ${formatContextSize(contextWindow.maxContext)} tokens)`);
     lines.push('');

package/src/harness.js

@@ -25,6 +25,7 @@ import {
 import { routeWarningForStatusline } from './route-scan.js';
 import { ruleHealthWarningForStatusline, modelRatchetPathFor, renderModelRatchet } from './model-rules.js';
 import { compactWindowWarningForStatusline } from './compact-window.js';
+import { userLanguage } from './config.js';
 
 const require = createRequire(import.meta.url);
 function readHarnessState() {
@@ -366,23 +367,35 @@ export function harnessPull({ root = findProjectRoot(), scope = 'global' } = {})
   return result;
 }
 
-/** Parse the bundled preset rules (markdown bullets under presets/). */
-export function presetRules() {
+/**
+ * The bundled preset rules, both languages per rule.
+ *
+ * These strings are injected into the model's context (by `seed`) and written
+ * into the user's ratchet (by `pull`), so a Korean-only set would pull an
+ * English session's responses into Korean — hence the pair. The `ko` text is
+ * canonical: it is what identifies a rule, so revising an English wording never
+ * turns a rule the user already answered into a new one.
+ */
+export function presetRuleEntries() {
   try {
     // fileURLToPath, not `.pathname`: the latter yields `/D:/repo/src` on
     // Windows, where the read fails and the catch below turns a missing
     // file into an empty rule set without ever saying so.
-    const path = join(dirname(fileURLToPath(import.meta.url)), '..', 'presets', 'ratchet-rules.md');
-    return readFileSync(path, 'utf8')
-      .split('\n')
-      .filter((l) => /^\s*-\s+/.test(l))
-      .map((l) => l.replace(/^\s*-\s+/, '').trim())
-      .filter(Boolean);
+    const path = join(dirname(fileURLToPath(import.meta.url)), '..', 'presets', 'ratchet-rules.json');
+    const data = JSON.parse(readFileSync(path, 'utf8'));
+    return (Array.isArray(data.rules) ? data.rules : [])
+      .filter((r) => r && typeof r.ko === 'string' && r.ko.trim())
+      .map((r) => ({ ko: r.ko.trim(), en: (r.en || r.ko).trim() }));
   } catch {
     return [];
   }
 }
 
+/** Preset rule text in the user's configured language. */
+export function presetRules(lang = userLanguage()) {
+  return presetRuleEntries().map((r) => (lang === 'ko' ? r.ko : r.en));
+}
+
 /**
  * harness list — return numbered ratchet rules from .claude/ratchet.md.
  * Numbering is 1-based and matches `harness rm <N>`.

package/src/history.js

@@ -69,7 +69,8 @@ function saveState(state) {
 function chipKo(chip) {
   if (!chip) return chip;
   const map = {
-    '⚠ Ctx 200k+': '⚠ 컨텍스트 200k 초과',
+    '⚠ Ctx 500k+': '⚠ 컨텍스트 500k 초과',
+    '⚠ Ctx 200k+': '⚠ 컨텍스트 200k 초과', // legacy (pre-v3.32)
     '⚠ 1M ON': '⚠ 1M 컨텍스트 활성', // legacy (pre-v2.18)
     '⚠ Cache miss': '⚠ 캐시 미스',
     '⚠ Rebuild churn': '⚠ 캐시 재빌드 빈발',
@@ -93,8 +94,10 @@ function chipKo(chip) {
  */
 function detailKo(detail) {
   if (!detail) return detail;
-  const m0 = detail.match(/^Single-request context exceeded 200k \(max (\d+)k tokens\)$/);
-  if (m0) return `단일 요청 컨텍스트 200k 초과 (최대 ${m0[1]}k 토큰)`;
+  // The threshold moved from 200k to 500k in v3.32, so both spellings have to
+  // resolve: history files written by older versions still carry the old one.
+  const m0 = detail.match(/^Single-request context exceeded (200|500)k \(max (\d+)k tokens\)$/);
+  if (m0) return `단일 요청 컨텍스트 ${m0[1]}k 초과 (최대 ${m0[2]}k 토큰)`;
   // legacy detail shape (pre-v2.18)
   const m1 = detail.match(/^Context auto-promoted to 1M \(max single-request (\d+)k tokens\)$/);
   if (m1) return `1M 컨텍스트 자동 활성 (단일 요청 최대 ${m1[1]}k 토큰)`;

package/src/installer.js

@@ -22,7 +22,7 @@ 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%", "⚠ 1M ON", "⚠ 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 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\`.
 ---
 
 # claude-token-saver — Claude Code Token Monitor
@@ -46,7 +46,7 @@ honor that for the rest of the turn without changing the saved setting.
 ## When this skill should activate
 
 - The user references any chip wording: \`🚨 5H NN%\`, \`🚨 7D NN%\`,
-  \`⚠ 1M ON\`, \`⚠ Input spike\`, \`⚠ Cache miss\`, \`⚠ 5m TTL\`,
+  \`⚠ Ctx 500k+\`, \`⚠ Input spike\`, \`⚠ Cache miss\`, \`⚠ 5m TTL\`,
   \`⚠ Rebuild churn\`, \`⚠ Output heavy\`, \`⚠ Call surge\`.
 - The user asks "why is my cache hit rate low", "what does this warning mean",
   "when did this start happening", or similar.
@@ -80,7 +80,7 @@ honor that for the rest of the turn without changing the saved setting.
    | ------------------ | ----------------------------------------------------- |
    | \`🚨 5H NN%\`       | 5-hour rate-limit window at NN% (>=90%). Cap is imminent. |
    | \`🚨 7D NN%\`       | 7-day rate-limit window at NN% (>=90%). Pace yourself.   |
-   | \`⚠ 1M ON\`         | Auto-promoted to 1M context (Opus 4.7+ Max default).  |
+   | \`⚠ Ctx 500k+\`     | A single recent request carried more than 500k input tokens. |
    | \`⚠ Input spike\`   | One request consumed >250k or >3× the recent p95.     |
    | \`⚠ Cache miss\`    | Cache hit rate dropped below ~70%.                    |
    | \`⚠ 5m TTL\`        | Most cache writes are 5-min ephemeral (Pro plan default). |
@@ -96,7 +96,8 @@ honor that for the rest of the turn without changing the saved setting.
 6. **Suggest the next action.** For \`🚨 5H/7D\` chips, recommend running
    \`claude-token-saver handoff\` to back up the current work to a
    \`HANDOFF-*.md\` file before the cap hits, then continue in a fresh
-   session. For 1M ON, mention \`CLAUDE_CODE_DISABLE_1M_CONTEXT=1\`. For
+   session. For \`⚠ Ctx 500k+\`, recommend \`/compact\` or \`/clear\` and
+   checking what is pinned into context. For
    5m TTL, point at the Max plan's 1h bucket. For input spike, suggest
    splitting the conversation or compacting context.
 

package/src/korean-style.js

@@ -67,13 +67,21 @@ export function koreanLocaleDetected({ env = process.env, platform = process.pla
   try {
     if (loadConfig().language === 'ko') return true;
   } catch { /* unreadable config falls through to the env checks */ }
-  for (const v of [env.LC_ALL, env.LC_MESSAGES, env.LANG, env.LANGUAGE]) {
+  const posix = [env.LC_ALL, env.LC_MESSAGES, env.LANG, env.LANGUAGE].filter(
+    (v) => typeof v === 'string' && v.trim() && v !== 'C' && v !== 'POSIX',
+  );
+  for (const v of posix) {
     // `ko` must be a whole subtag: `ko`, `ko_KR.UTF-8`, `ko-KR`, and the
     // colon-separated `LANGUAGE=ko:en` all count, while `kok` (Konkani) and
     // `tok` do not.
-    if (typeof v === 'string' && /(^|[:._-])ko([:._-]|$)/i.test(v)) return true;
+    if (/(^|[:._-])ko([:._-]|$)/i.test(v)) return true;
   }
-  if (platform === 'darwin') {
+  // A locale variable that is set and is NOT Korean is an answer, not a missing
+  // signal: `LANG=en_US.UTF-8` on a machine whose system locale is Korean means
+  // the user chose English for their shell. Only consult the system locale when
+  // the POSIX variables say nothing at all, which is the macOS GUI-shell case
+  // this fallback exists for.
+  if (platform === 'darwin' && posix.length === 0) {
     try {
       // `LANG` is commonly unset in macOS GUI-launched shells, so the system
       // locale is the only reliable signal there.

package/src/model-rules.js

@@ -100,6 +100,27 @@ export function composeRuleText(baseText, rule, lang = userLanguage()) {
   return `${baseText.replace(/\s*$/, '')}. ${clause}`;
 }
 
+/**
+ * The base rule sentence for one tier-delegation rule, without the budget
+ * clause (composeRuleText adds that). Lives here rather than in route-scan so
+ * that the scan, the seed presets and any later producer all emit byte-identical
+ * wording — two copies of this template would drift the moment one is reworded,
+ * and the drift only shows up in a file the model reads as instructions.
+ *
+ * `g` carries { tier, label, labelEn, example, exampleEn, agent }.
+ */
+export function modelRuleBaseText(g, lang = userLanguage()) {
+  if (lang === 'ko') {
+    return g.tier === 'T2'
+      ? `"${g.label}" 유형의 단순 요청(예: "${g.example}")은 ${agentPhrase(g.agent)} 서브에이전트로 위임한다 (설계 판단·배포·스토어 제출 같은 비가역 작업이 섞이면 위임하지 않음)`
+      : `"${g.label}" 유형의 중간 난도 요청(예: "${g.example}")은 model: sonnet 서브에이전트로 위임한다 (설계 판단·비가역 작업·반복 에러 발생 시 메인 모델이 이어받음)`;
+  }
+  const example = g.exampleEn || g.example;
+  return g.tier === 'T2'
+    ? `Delegate simple "${g.labelEn}" requests (e.g. "${example}") to ${agentPhraseEn(g.agent)} — never when the request mixes in design judgement or irreversible work like deploy/release/submission`
+    : `Delegate moderate "${g.labelEn}" requests (e.g. "${example}") to a model: sonnet subagent — hand back to the main model on design judgement, irreversible work, or repeated errors`;
+}
+
 // See the note in route-scan.js — paths.js is the only place that resolves
 // this, so an XDG_CONFIG_HOME override moves every state file together.
 const stateDir = userDataDir;
@@ -234,7 +255,12 @@ export function renderModelRatchet(rules, lang = userLanguage()) {
       : ` ⚠ rule-health: recent error rate ${rate}% for the delegated category — narrow the condition or remove`;
   };
   const statsOf = (r) => {
-    const base = `×${r.count || 0}, err ${pct(r.errRate)}%, seen ${r.lastSeen || r.promotedAt}`;
+    // A seeded rule carries no recurrence of its own until a scan measures one.
+    // Printing `×0` would read as "never happened"; printing the author's count
+    // would pass someone else's evidence off as the user's.
+    const base = r.origin === 'preset' && !r.count
+      ? `preset (curated), registered ${r.promotedAt}`
+      : `×${r.count || 0}, err ${pct(r.errRate)}%, seen ${r.lastSeen || r.promotedAt}`;
     if (!r.delegatedRuns) return base;
     const saved = r.savedUsd ? `, saved ~$${r.savedUsd.toFixed(2)}` : '';
     return `${base}, delegated ×${r.delegatedRuns} err ${pct(r.delegatedErrRate)}%${saved}`;
@@ -260,13 +286,16 @@ export function renderModelRatchet(rules, lang = userLanguage()) {
     const t2 = group.find((r) => r.tier === 'T2');
     const t1 = group.find((r) => r.tier === 'T1');
     if (t2 && t1) {
+      // Seeded rules carry a localized example; scan-produced ones only have the
+      // user's own prompt, so exampleEn is a preference, not a requirement.
+      const ex = (r) => (ko ? r.example : (r.exampleEn || r.example));
       const rule = ko
-        ? `"${t2.label}" 유형 요청은 기본적으로 ${agentPhrase(t2.agent)} 서브에이전트로 위임한다(예: "${t2.example}"). ` +
-          `여러 단계·여러 파일 수정이 얽힌 중간 난도 요청(예: "${t1.example}")은 model: sonnet 서브에이전트로 위임한다. ` +
+        ? `"${t2.label}" 유형 요청은 기본적으로 ${agentPhrase(t2.agent)} 서브에이전트로 위임한다(예: "${ex(t2)}"). ` +
+          `여러 단계·여러 파일 수정이 얽힌 중간 난도 요청(예: "${ex(t1)}")은 model: sonnet 서브에이전트로 위임한다. ` +
           `설계 판단이나 배포·릴리스·스토어 제출 같은 비가역 작업이 섞여 있을 때만 위임하지 않는다. ` +
           mergedBudget(t2, t1)
-        : `Delegate "${t2.labelEn || t2.label}" requests to ${agentPhraseEn(t2.agent)} by default (e.g. "${t2.example}"). ` +
-          `Escalate moderate ones that span multiple steps or file edits (e.g. "${t1.example}") to a model: sonnet subagent. ` +
+        : `Delegate "${t2.labelEn || t2.label}" requests to ${agentPhraseEn(t2.agent)} by default (e.g. "${ex(t2)}"). ` +
+          `Escalate moderate ones that span multiple steps or file edits (e.g. "${ex(t1)}") to a model: sonnet subagent. ` +
           `Keep it on the main model only when the request mixes in design judgement or irreversible work (deploy, release, store submission). ` +
           mergedBudget(t2, t1);
       lines.push(`- ${rule}${healthOf(t2)}${healthOf(t1)} <!-- T2 ${statsOf(t2)} / T1 ${statsOf(t1)} -->`);

package/src/route-scan.js

@@ -27,7 +27,7 @@ import {
 } from './subagent-records.js';
 import { estimateCost, modelRank, isRecognizedModelId, TIER_TARGET_RANK, tierForRank } from './cost.js';
 import { learnProfileMapping, resetModelAliasCache } from './model-alias.js';
-import { agentPhrase, agentPhraseEn } from './agents.js';
+import { modelRuleBaseText } from './model-rules.js';
 
 // ── Tier bands (docs/TIER_CRITERIA.md §3) ────────────────────────────────
 // T2 (haiku): finished in few calls, tiny output, near-zero mutation, no
@@ -615,12 +615,11 @@ export async function runRouteScan({ days = 14 } = {}) {
     calls: g.tier === 'T2' ? T2_MAX_CALLS + 2 : null,
     out: g.tier === 'T2' ? thresholds.t2Out : thresholds.t1Out,
   });
-  const ruleText = (g) => g.tier === 'T2'
-    ? `"${g.label}" 유형의 단순 요청(예: "${g.example}")은 ${agentPhrase(g.agent)} 서브에이전트로 위임한다 (설계 판단·배포·스토어 제출 같은 비가역 작업이 섞이면 위임하지 않음)`
-    : `"${g.label}" 유형의 중간 난도 요청(예: "${g.example}")은 model: sonnet 서브에이전트로 위임한다 (설계 판단·비가역 작업·반복 에러 발생 시 메인 모델이 이어받음)`;
-  const ruleTextEn = (g) => g.tier === 'T2'
-    ? `Delegate simple "${g.labelEn}" requests (e.g. "${g.example}") to ${agentPhraseEn(g.agent)} — never when the request mixes in design judgement or irreversible work like deploy/release/submission`
-    : `Delegate moderate "${g.labelEn}" requests (e.g. "${g.example}") to a model: sonnet subagent — hand back to the main model on design judgement, irreversible work, or repeated errors`;
+  // Shared with the seed presets (src/seed-rules.js) through model-rules.js —
+  // one template, so a reworded rule cannot mean two different things
+  // depending on which producer wrote it.
+  const ruleText = (g) => modelRuleBaseText(g, 'ko');
+  const ruleTextEn = (g) => modelRuleBaseText(g, 'en');
 
   const candidates = [...groups.values()]
     .filter((g) => g.count >= MIN_RECURRENCE && !hasRule(g))