sprag-cli 3.44.0 → 3.46.0

package/README.ko.md

@@ -66,11 +66,13 @@ gemini-2.5-pro        57.9%             $734  ▰▰▰▰▰▰▰▰▰▰▰
 
 ```
 🔀 라우팅 절감 $2.09  |  fable→sonnet 1회 $0.72 · opus→haiku 1회 $0.57
-🚨 5H █████▓ 94% 🔄 12:36 · 🅷 5/5 · 🤖 Opus 5 · 🧠 Cache hit 98.8% · ⏳ Cache expires 59:46 · 📅 weekly ██▒░░░ 38% · 💵 Sep $42 · 📦 Ctx 47% of 1M
+🚨 5H ▰▰▰▰▰▰▰▰▰▰▰▱ 94% 🔄 12:36 · 🅷 5/5 · 🤖 Opus 5 · 🧠 Cache hit 98.8% · ⏳ Cache expires 59:46 · 📅 weekly ▰▰▰▰▰▱▱▱▱▱▱▱ 38% · 💵 Sep $42 · 📦 Ctx 47% of 1M
 ```
 
 문제가 생기면 경고 칩이 줄 맨 앞으로 옵니다. `🚨 5H/7D NN%`, `⚠ Ctx 500k+`, `⚠ Cache miss`, `⚠ Input spike`, `⚠ Output heavy`, `⚠ Call surge`, `⚠ Rebuild churn`, `⚠ 5m TTL` 여덟 가지이며, 칩 문구를 그대로 말하면 Skill이 원인 코드와 조치 순서를 꺼내 줍니다. 세그먼트별 의미와 색 기준은 [statusline 문서](https://github.com/rootstudioyaml/sprag/blob/main/docs/STATUSLINE.md)에 정리했습니다.
 
+JetBrains IDE 내장 터미널에서는 이모지 대신 한 칸 글리프로 표시합니다(`◉ Cache hit 98.8% · ◧ Ctx 47% of 1M`). IDE 기본 폰트에 이모지 글리프가 없어서 그대로 두면 `Cache expires 4:545` 처럼 이전 프레임 문자가 남기 때문입니다. 자세한 사정과 `sprag mode narrow` · `mode icon-force` 사용법은 [statusline 문서의 라벨 모드](https://github.com/rootstudioyaml/sprag/blob/main/docs/STATUSLINE.md#라벨-모드)에 있습니다.
+
 ## 실제 효과: 도입 전후 리포트
 
 ![sprag: harness와 ratchet 도입 효과](./docs/harness-impact.png)

package/README.md

@@ -72,11 +72,13 @@ gemini-2.5-pro        57.9%             $734  ▰▰▰▰▰▰▰▰▰▰▰
 
 ```
 🔀 라우팅 절감 $2.09  |  fable→sonnet 1회 $0.72 · opus→haiku 1회 $0.57
-🚨 5H █████▓ 94% 🔄 12:36 · 🅷 5/5 · 🤖 Opus 5 · 🧠 Cache hit 98.8% · ⏳ Cache expires 59:46 · 📅 weekly ██▒░░░ 38% · 💵 Sep $42 · 📦 Ctx 47% of 1M
+🚨 5H ▰▰▰▰▰▰▰▰▰▰▰▱ 94% 🔄 12:36 · 🅷 5/5 · 🤖 Opus 5 · 🧠 Cache hit 98.8% · ⏳ Cache expires 59:46 · 📅 weekly ▰▰▰▰▰▱▱▱▱▱▱▱ 38% · 💵 Sep $42 · 📦 Ctx 47% of 1M
 ```
 
 문제가 생기면 경고 칩이 줄 맨 앞으로 옵니다. `🚨 5H/7D NN%`, `⚠ Ctx 500k+`, `⚠ Cache miss`, `⚠ Input spike`, `⚠ Output heavy`, `⚠ Call surge`, `⚠ Rebuild churn`, `⚠ 5m TTL` 여덟 가지이며, 칩 문구를 그대로 말하면 Skill이 원인 코드와 조치 순서를 꺼내 줍니다. 세그먼트별 의미와 색 기준은 [statusline 문서](https://github.com/rootstudioyaml/sprag/blob/main/docs/STATUSLINE.md)에 정리했습니다.
 
+JetBrains IDE 내장 터미널에서는 이모지 대신 한 칸 글리프로 표시합니다(`◉ Cache hit 98.8% · ◧ Ctx 47% of 1M`). IDE 기본 폰트에 이모지 글리프가 없어서 그대로 두면 `Cache expires 4:545` 처럼 이전 프레임 문자가 남기 때문입니다. 자세한 사정과 `sprag mode narrow` · `mode icon-force` 사용법은 [statusline 문서의 라벨 모드](https://github.com/rootstudioyaml/sprag/blob/main/docs/STATUSLINE.md#라벨-모드)에 있습니다.
+
 ## 실제 효과: 도입 전후 리포트
 
 ![sprag: harness와 ratchet 도입 효과](./docs/harness-impact.png)
@@ -209,11 +211,13 @@ The measured −18.6% comes from the harness and ratchet; routing and conversion
 
 ```
 🔀 Routing saved $2.09  |  fable→sonnet 1× $0.72 · opus→haiku 1× $0.57
-🚨 5H █████▓ 94% 🔄 12:36 · 🅷 5/5 · 🤖 Opus 5 · 🧠 Cache hit 98.8% · ⏳ Cache expires 59:46 · 📅 weekly ██▒░░░ 38% · 💵 Sep $42 · 📦 Ctx 47% of 1M
+🚨 5H ▰▰▰▰▰▰▰▰▰▰▰▱ 94% 🔄 12:36 · 🅷 5/5 · 🤖 Opus 5 · 🧠 Cache hit 98.8% · ⏳ Cache expires 59:46 · 📅 weekly ▰▰▰▰▰▱▱▱▱▱▱▱ 38% · 💵 Sep $42 · 📦 Ctx 47% of 1M
 ```
 
 When something is wrong the warning chip leads the line: `🚨 5H/7D NN%`, `⚠ Ctx 500k+`, `⚠ Cache miss`, `⚠ Input spike`, `⚠ Output heavy`, `⚠ Call surge`, `⚠ Rebuild churn`, `⚠ 5m TTL`. Say the chip wording inside Claude and the Skill surfaces the root-cause code and the fix. Segment-by-segment meanings live in [the statusline reference](./docs/STATUSLINE.md).
 
+Inside a JetBrains IDE terminal the chips render as single-cell glyphs instead of emoji (`◉ Cache hit 98.8% · ◧ Ctx 47% of 1M`). The IDE's default font has no emoji glyphs, so leaving them in leaves debris from the previous frame behind — `Cache expires 4:545` and the like. [Label modes](./docs/STATUSLINE.md#label-modes) covers the detail, plus `sprag mode narrow` and `mode icon-force`.
+
 ## Real-world impact — before/after report
 
 ![sprag — harness + ratchet adoption impact](./docs/harness-impact.png)

package/bin/cli.js

@@ -325,7 +325,12 @@ async function main() {
       console.log('예산 캐시가 비어 있습니다. `sprag litellm-budget --refresh` 로 먼저 조회하십시오.');
       return;
     }
-    for (const line of formatBudgetReport(state)) console.log(line);
+    // Same resolver the statusline uses: this report draws a gauge too, and a
+    // glyph the terminal's font lacks garbles here exactly as it does there.
+    const { resolveLabelMode } = await import('../src/statusline-mode.js');
+    const { statuslineDefaults } = await import('../src/config.js');
+    const { mode: labelMode } = resolveLabelMode({ hasFlag, cfg: statuslineDefaults() });
+    for (const line of formatBudgetReport(state, new Date(), labelMode)) console.log(line);
     return;
   }
 
@@ -397,9 +402,10 @@ async function main() {
       process.exit(1);
     }
     const { formatReport } = await import('../src/formatters/statusline.js');
-    const isIcon = hasFlag('--icon')
-      ? true
-      : (hasFlag('--no-icon') || hasFlag('--text') ? false : cfg.icon);
+    // Same resolver as the real statusline path: a demo that renders emoji
+    // where the real line would not is worse than no demo at all.
+    const { resolveLabelMode } = await import('../src/statusline-mode.js');
+    const { mode: labelMode } = resolveLabelMode({ hasFlag, cfg });
     const isVerbose = hasFlag('--verbose')
       ? true
       : (hasFlag('--no-verbose') || hasFlag('--compact') ? false : cfg.verbose);
@@ -413,7 +419,7 @@ async function main() {
       color: colorOk,
       verbose: isVerbose,
       timer: showTimer,
-      mode: isIcon ? 'icon' : 'text',
+      mode: labelMode,
       segments,
       singleLine: hasFlag('--single-line'),
     });
@@ -480,9 +486,11 @@ async function main() {
       const { statuslineDefaults } = await import('../src/config.js');
       const cfg = statuslineDefaults();
       const colorOk = !hasFlag('--no-color') && !process.env.NO_COLOR && cfg.color;
-      const isIcon = hasFlag('--icon')
-        ? true
-        : (hasFlag('--no-icon') || hasFlag('--text') ? false : cfg.icon);
+      // Third caller of the same decision — the no-session line has to agree
+      // with the populated one, or IntelliJ users watch icons appear and
+      // disappear as the analysis window empties and fills.
+      const { resolveLabelMode } = await import('../src/statusline-mode.js');
+      const { mode: labelMode } = resolveLabelMode({ hasFlag, cfg });
       const stdinJson = readStdinJson();
       const caps = extractCaps(stdinJson);
       const model = extractModel(stdinJson);
@@ -494,7 +502,7 @@ async function main() {
       }
       console.log(formatNoSession(
         { caps, model, windowLabel, version: PKG_VERSION, update: readUpdateChip() },
-        { color: colorOk, mode: isIcon ? 'icon' : 'text' },
+        { color: colorOk, mode: labelMode },
       ));
       return;
     }
@@ -749,21 +757,11 @@ async function main() {
     const { statuslineDefaults } = await import('../src/config.js');
     const cfg = statuslineDefaults();
 
-    // IntelliJ's Claude Code plugin renders the statusline through a custom
-    // widget that fuses prior frames with the new one when emoji are present,
-    // producing garbage like "59:548" that no ANSI escape can clean up
-    // (verified: emitting the same output directly into JediTerm renders
-    // cleanly, so the bug is in the plugin's render path, not the terminal).
-    // Force text mode unconditionally inside IntelliJ — even past an explicit
-    // `--icon` flag, since wrappers commonly hardcode `--icon` and the user
-    // can't easily edit them; icon mode is just broken there.
-    const isIntelliJ = process.env.TERMINAL_EMULATOR === 'JetBrains-JediTerm';
-    // CLI flags take precedence; otherwise fall back to persisted config.
-    const isIcon = isIntelliJ
-      ? false
-      : (hasFlag('--icon')
-          ? true
-          : (hasFlag('--no-icon') || hasFlag('--text') ? false : cfg.icon));
+    // Icon vs text is decided in one module shared with the `--demo` path, so
+    // the two cannot drift apart again. It also owns the IntelliJ downgrade and
+    // the escape hatch out of it (SPRAG_ICON=force / `sprag mode icon-force`).
+    const { resolveLabelMode } = await import('../src/statusline-mode.js');
+    const { mode: labelMode } = resolveLabelMode({ hasFlag, cfg });
     const isVerbose = hasFlag('--verbose')
       ? true
       : (hasFlag('--no-verbose') || hasFlag('--compact') ? false : cfg.verbose);
@@ -779,7 +777,7 @@ async function main() {
       color: colorOk,
       verbose: isVerbose,
       timer: showTimer,
-      mode: isIcon ? 'icon' : 'text',
+      mode: labelMode,
       segments,
       // macOS builds of Claude Code have rendered only the first line of a
       // multi-line statusline in some versions (anthropics/claude-code#35176)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sprag-cli",
-  "version": "3.44.0",
+  "version": "3.46.0",
   "description": "Sprag - a quality ratchet harness for AI coding agents: model-fitting delegation, ratchet rules, doc2md, Korean style gate. Same tool as claude-token-saver, under its new name.",
   "type": "module",
   "bin": {
@@ -13,6 +13,7 @@
     "postinstall": "node bin/cli.js install || true",
     "publish:legacy": "node scripts/publish-legacy.mjs",
     "sync:ko": "node scripts/sync-readme-ko.mjs",
+    "release:notes": "node scripts/release-notes.mjs",
     "prepublishOnly": "node scripts/sync-readme-ko.mjs"
   },
   "files": [

package/presets/model-rules.json

@@ -21,7 +21,10 @@
       "agent": "haiku-runner",
       "example": "npm test 돌려봐",
       "exampleEn": "run npm test",
-      "budget": { "calls": 8, "out": 1500 }
+      "budget": {
+        "calls": 8,
+        "out": 1500
+      }
     },
     {
       "id": "run-t1",
@@ -32,7 +35,10 @@
       "agent": "sonnet",
       "example": "빌드하고 실패한 테스트만 보여줘",
       "exampleEn": "build it and show only the failing tests",
-      "budget": { "calls": null, "out": 6000 }
+      "budget": {
+        "calls": null,
+        "out": 6000
+      }
     },
     {
       "id": "explore-t2",
@@ -43,7 +49,10 @@
       "agent": "haiku-explore",
       "example": "이 설정값 어느 파일에 있어?",
       "exampleEn": "which file holds this config value?",
-      "budget": { "calls": 8, "out": 1500 }
+      "budget": {
+        "calls": 8,
+        "out": 1500
+      }
     },
     {
       "id": "explore-t1",
@@ -54,7 +63,10 @@
       "agent": "sonnet",
       "example": "이 함수를 호출하는 곳 전부 찾아줘",
       "exampleEn": "find every caller of this function",
-      "budget": { "calls": null, "out": 6000 }
+      "budget": {
+        "calls": null,
+        "out": 6000
+      }
     },
     {
       "id": "check-t2",
@@ -65,7 +77,10 @@
       "agent": "haiku-explore",
       "example": "지금 배포된 버전이 뭔지 확인해줘",
       "exampleEn": "check which version is deployed right now",
-      "budget": { "calls": 8, "out": 1500 }
+      "budget": {
+        "calls": 8,
+        "out": 1500
+      }
     },
     {
       "id": "check-t1",
@@ -76,7 +91,10 @@
       "agent": "sonnet",
       "example": "마이그레이션이 실제로 적용됐는지 확인해줘",
       "exampleEn": "verify the migration actually applied",
-      "budget": { "calls": null, "out": 6000 }
+      "budget": {
+        "calls": null,
+        "out": 6000
+      }
     },
     {
       "id": "paste-t2",
@@ -87,7 +105,10 @@
       "agent": "haiku-explore",
       "example": "이 에러 로그는 무슨 뜻이야?",
       "exampleEn": "what does this error log mean?",
-      "budget": { "calls": 8, "out": 1500 }
+      "budget": {
+        "calls": 8,
+        "out": 1500
+      }
     },
     {
       "id": "paste-t1",
@@ -98,7 +119,10 @@
       "agent": "sonnet",
       "example": "이 스택트레이스에서 어느 모듈이 죽은 건지 짚어줘",
       "exampleEn": "point out which module failed in this stack trace",
-      "budget": { "calls": null, "out": 8000 }
+      "budget": {
+        "calls": null,
+        "out": 8000
+      }
     },
     {
       "id": "read-t2",
@@ -109,7 +133,24 @@
       "agent": "haiku-explore",
       "example": "이 README 요약해줘",
       "exampleEn": "summarize this README",
-      "budget": { "calls": 8, "out": 1900 }
+      "budget": {
+        "calls": 8,
+        "out": 1900
+      }
+    },
+    {
+      "id": "read-t1",
+      "tier": "T1",
+      "category": "read",
+      "label": "읽기·요약·설명",
+      "labelEn": "reading / summarizing / explaining",
+      "agent": "sonnet",
+      "example": "이 함수가 하는 일을 단계별로 정리해줘",
+      "exampleEn": "walk through what this function does, step by step",
+      "budget": {
+        "calls": null,
+        "out": 8000
+      }
     }
   ]
 }

package/src/changelog.js

@@ -0,0 +1,34 @@
+/**
+ * changelog — read one version's section out of CHANGELOG.md.
+ *
+ * Separate from scripts/release-notes.mjs, which is a CLI: importing that file
+ * runs its argument parsing and exits, so the extraction it depends on cannot be
+ * tested through it. The boundary logic is the part worth pinning — a section
+ * pulled one line short drops the release's last item, and one line long carries
+ * the previous release's first, and the upgrade offer shows either without
+ * complaint.
+ */
+
+/**
+ * The body of one version's section, heading excluded.
+ *
+ * @param {string} changelog - CHANGELOG.md contents
+ * @param {string} version - e.g. "3.45.0"
+ * @returns {string|null} the section text, or null when that version has none
+ */
+export function sectionFor(changelog, version) {
+  const lines = String(changelog).split(/\r?\n/);
+  // The version has to match to its end: without the boundary, "3.42.0" would
+  // also match the "### v3.42.7" heading and publish the wrong notes.
+  const head = new RegExp(`^### v${String(version).replace(/\./g, '\\.')}(\\s|$|\\()`);
+  const start = lines.findIndex((l) => head.test(l));
+  if (start < 0) return null;
+  const out = [];
+  for (let i = start + 1; i < lines.length; i += 1) {
+    // The next version heading ends this section, and so does a shallower one:
+    // "## All releases" is a container, not part of any release.
+    if (/^### v/.test(lines[i]) || /^## /.test(lines[i])) break;
+    out.push(lines[i]);
+  }
+  return out.join('\n').trim();
+}

package/src/commands/brief.js

@@ -22,10 +22,22 @@ export async function run({ hasFlag }) {
       process.exit(1);
     }
     const ctx = readStdinJson() || {};
+    const parts = [];
     try {
       const { runBrief } = await import('../brief.js');
       const out = await runBrief({ sessionId: ctx.session_id, transcriptPath: ctx.transcript_path });
-      if (out) console.log(out);
+      if (out) parts.push(out);
     } catch (e) { debug('brief:hook', e); /* briefing is best-effort — never block a prompt */ }
+    // State the matching delegation rule as a fact about this request. Registered
+    // rules were going unused because applying one meant scanning a list and
+    // resolving it against a general "don't spawn subagents" instruction; naming
+    // the match here removes both steps. Silent unless it is sure — see
+    // src/route-inject.js.
+    try {
+      const { routeHint } = await import('../route-inject.js');
+      const hint = routeHint(ctx.prompt);
+      if (hint) parts.push(hint);
+    } catch (e) { debug('brief:route-hint', e); }
+    if (parts.length) console.log(parts.join('\n'));
     return;
 }

package/src/commands/install.js

@@ -71,6 +71,7 @@ export async function run({ hasFlag }) {
     const r = installAll({ force });
     print('skill', r.skill);
     print('SessionStart hook (route-scan)', r.sessionStartHook);
+    print('PostToolUse hook (delegation rescan)', r.delegationHook);
     print('UserPromptSubmit hook (brief)', r.briefHook);
     {
       let s = r.statusline;

package/src/commands/mode.js

@@ -10,12 +10,28 @@
 export async function run({ args }) {
     const { applyMode, loadConfig, configPath, statuslineDefaults, userLanguage, VALID_KEYWORDS } =
       await import('../config.js');
+    const { resolveLabelMode, isJetBrainsTerminal } = await import('../statusline-mode.js');
     const words = args.slice(1);
     if (words.length === 0) {
       const eff = statuslineDefaults();
       const raw = loadConfig();
       console.log('Statusline (effective):');
-      console.log(`  icon:    ${eff.icon}`);
+      console.log(`  labels:  ${eff.labels}`);
+      // What renders can differ from the stored preference: inside IntelliJ the
+      // emoji set steps down to narrow glyphs, because the IDE font lacks the
+      // emoji and the fallback breaks the cell grid. Saying so here is the
+      // difference between a two-second answer and a hunt through the source for
+      // why `--icon` appeared to do nothing.
+      const { mode: labelMode, reason } = resolveLabelMode({ cfg: eff });
+      if (labelMode !== eff.labels) {
+        const why = reason === 'intellij-narrow'
+          ? ' (IntelliJ: emoji garble in the IDE font. `sprag mode icon-force` keeps them anyway)'
+          : reason === 'intellij-forced'
+            ? ' (icon-force)'
+            : '';
+        console.log(`  renders: ${labelMode}${why}`);
+      }
+      console.log(`  icon-force: ${eff.iconForce}`);
       console.log(`  verbose: ${eff.verbose}`);
       console.log(`  timer:   ${eff.timer}`);
       console.log(`  color:   ${eff.color}`);
@@ -40,7 +56,11 @@ export async function run({ args }) {
     }
     const eff = statuslineDefaults();
     console.log(`Updated: ${applied.join(', ')}`);
-    console.log(`Now: icon=${eff.icon} verbose=${eff.verbose} timer=${eff.timer} color=${eff.color} window=${eff.windowLabel} language=${userLanguage()}`);
+    console.log(`Now: labels=${eff.labels} icon-force=${eff.iconForce} verbose=${eff.verbose} timer=${eff.timer} color=${eff.color} window=${eff.windowLabel} language=${userLanguage()}`);
+    const { mode: renders } = resolveLabelMode({ cfg: eff });
+    if (renders !== eff.labels) {
+      console.log(`Renders as: ${renders}${isJetBrainsTerminal() ? ' (IntelliJ detected)' : ''}`);
+    }
     console.log('Statusline picks up the change on the next refresh (~1s).');
     return;
 }

package/src/commands/route-scan.js

@@ -174,11 +174,27 @@ export async function run({ args, hasFlag, numArg }) {
       const scan = rs.readRouteScan();
       if (scan?.unresolvedRuns > 0) {
         const ids = (scan.unresolvedModels || []).join(', ');
+        // Unlike the statusline chip, this listing reports even a single one: the
+        // user ran this command to find out why a rule reads as never fired, and
+        // there is room here to answer properly. But a gateway's opaque profile
+        // ARN is normally resolved by learning from observed runs, which needs
+        // MIN_VOTES of them — so below that, the honest advice is to wait rather
+        // than to go edit a config file.
+        const { MIN_VOTES } = await import('../model-alias.js');
+        const learning = scan.unresolvedRuns < MIN_VOTES;
+        const remedyKo = learning
+          ? `\n  위임이 ${MIN_VOTES}건 이상 쌓이면 자동으로 해석될 수 있습니다. 그때까지 기다렸다가 다시 확인하고,`
+            + '\n  게이트웨이가 모델 이름을 아예 알려 주지 않는 환경이라면 profile-map.json 의 modelAliases 에'
+            + '\n  해당 ID 를 매핑한 뒤 route-scan --refresh 를 실행하십시오.'
+          : '\n  profile-map.json 의 modelAliases 에 해당 ID 를 매핑한 뒤 route-scan --refresh 를 실행하십시오.';
+        const remedyEn = learning
+          ? `\n  These may resolve on their own once ${MIN_VOTES} or more delegated runs accumulate — check again then.`
+            + '\n  If the gateway never reports a model name at all, map the id under modelAliases in'
+            + '\n  profile-map.json and run route-scan --refresh.'
+          : '\n  Map it under modelAliases in profile-map.json, then run route-scan --refresh.';
         console.log(lang === 'ko'
-          ? `\n⚠ 해석되지 않은 모델 ID 때문에 위임 ${scan.unresolvedRuns}건이 집계에서 제외됐습니다${ids ? ` (${ids})` : ''}.`
-            + '\n  profile-map.json 의 modelAliases 에 해당 ID 를 매핑한 뒤 route-scan --refresh 를 실행하십시오.'
-          : `\n⚠ ${scan.unresolvedRuns} delegated run(s) were excluded — unpriceable model id${ids ? ` (${ids})` : ''}.`
-            + '\n  Map it under modelAliases in profile-map.json, then run route-scan --refresh.');
+          ? `\n⚠ 해석되지 않은 모델 ID 때문에 위임 ${scan.unresolvedRuns}건이 집계에서 제외됐습니다${ids ? ` (${ids})` : ''}.` + remedyKo
+          : `\n⚠ ${scan.unresolvedRuns} delegated run(s) were excluded — unpriceable model id${ids ? ` (${ids})` : ''}.` + remedyEn);
       }
       console.log(lang === 'ko'
         ? '\n제거: sprag route-scan rules rm <N>'
@@ -203,6 +219,33 @@ export async function run({ args, hasFlag, numArg }) {
       return;
     }
 
+    // --hook-delegated: PostToolUse hook for Task/Agent. A delegation just
+    // finished, which is the one event guaranteed to change what a scan
+    // produces — its savings and its error rate both move. Kicks a detached
+    // refresh so the statusline shows the new figure on its next render
+    // instead of waiting out the hourly gate, and prints nothing: a tool
+    // result is not a place for our commentary.
+    if (hasFlag('--hook-delegated')) {
+      const payload = readStdinJson() || {};
+      // Claude Code matches the hook by tool name already, but the payload is
+      // the only thing that proves it: a mis-registered matcher would otherwise
+      // have us rescanning after every Read.
+      const tool = payload.tool_name;
+      if (tool !== 'Task' && tool !== 'Agent') return;
+      try {
+        const cache = rs.readRouteScan();
+        if (!(await rs.shouldRescan(cache, { afterDelegation: true }))) return;
+        const { spawn } = await import('node:child_process');
+        spawn(process.execPath, [process.argv[1], 'route-scan', '--refresh', '--quiet'],
+          { detached: true, stdio: 'ignore', windowsHide: true }).unref();
+      } catch (e) {
+        // A missed refresh only means the figure lags, which is what happened
+        // before this hook existed. Never fail the tool call over it.
+        debug('route-scan:delegated-refresh', e);
+      }
+      return;
+    }
+
     // --hook: SessionStart hook mode. Never scans inline (session start must
     // stay fast) — reads the cache, kicks a detached refresh when stale, and
     // prints delegation-candidate context for the new session.
@@ -299,16 +342,32 @@ export async function run({ args, hasFlag, numArg }) {
         // `dismissed` is the whole point of asking once: a user who said no to
         // this version must not be asked again every `/clear`.
         if (u && u.available && !u.dismissed) {
+          // What the release adds, when we managed to read it. "A newer version
+          // exists" is not a reason to upgrade; the reason is in this list, and
+          // without it the user is being asked to decide on no information.
+          const notes = Array.isArray(u.highlights) ? u.highlights : [];
+          const koNotes = notes.length
+            ? ['  이 버전에서 새로 생긴 것:', ...notes.map((n) => `    · ${n}`)]
+            : [];
+          const enNotes = notes.length
+            ? ['  What this release adds:', ...notes.map((n) => `    · ${n}`)]
+            : [];
           updateBlock = lang === 'ko'
             ? [
                 `[sprag update] 새 버전이 나와 있습니다: v${u.current} → ${u.latest}.`,
-                '사용자에게 지금 업그레이드할지 물어보고, 승낙하면 아래 명령을 실행하십시오. 묻지 않고 설치하지는 마십시오.',
-                '  sprag upgrade            # 업그레이드 실행',
+                ...koNotes,
+                notes.length
+                  ? '  위 내용을 사용자에게 보여 주고 업그레이드할지 물어보십시오. 승낙하면 아래 명령을 실행하고, 묻지 않고 설치하지는 마십시오.'
+                  : '  사용자에게 지금 업그레이드할지 물어보고, 승낙하면 아래 명령을 실행하십시오. 묻지 않고 설치하지는 마십시오.',
+                '  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.',
+                ...enNotes,
+                notes.length
+                  ? '  Show that list to the user and ask whether to upgrade. Run the command below only if they agree; do not install without asking.'
+                  : 'Ask the user whether to upgrade now, and run the command below only if they agree. Do not install without asking.',
                 '  sprag upgrade                  # perform the upgrade',
                 '  sprag update-check --dismiss   # if they decline (stays quiet until a newer release)',
               ].join('\n');

package/src/config.js

@@ -12,6 +12,7 @@
 import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'node:fs';
 import { join } from 'node:path';
 import { userDataDir } from './paths.js';
+import { labelPreference } from './statusline-mode.js';
 
 const CONFIG_DIR = userDataDir();
 const CONFIG_PATH = join(CONFIG_DIR, 'config.json');
@@ -38,8 +39,17 @@ export function saveConfig(cfg) {
 // Orthogonal — `mode icon verbose` flips both without resetting the rest.
 // Statusline-only toggles. Stored under `cfg.statusline`.
 const KEYWORDS = {
-  icon:       { key: 'icon',    value: true  },
-  text:       { key: 'icon',    value: false },
+  // Label style is one setting with three values, so the keywords write one key
+  // rather than a pair of booleans that could contradict each other.
+  icon:       { key: 'labels',  value: 'icon'   },
+  narrow:     { key: 'labels',  value: 'narrow' },
+  text:       { key: 'labels',  value: 'text'   },
+  // Opt back into icons inside IntelliJ, where they are downgraded by default
+  // for the plugin's statusline widget. Scoped to that guard only: outside
+  // IntelliJ it changes nothing, because `icon` / `text` already decide there.
+  // See src/statusline-mode.js.
+  'icon-force':    { key: 'iconForce', value: true  },
+  'no-icon-force': { key: 'iconForce', value: false },
   verbose:    { key: 'verbose', value: true  },
   compact:    { key: 'verbose', value: false },
   timer:      { key: 'timer',   value: true  },
@@ -171,8 +181,17 @@ export function statuslineDefaults() {
   } else {
     windowHours = 24; // default: last 1 day
   }
+  // Three-valued label style, with the legacy boolean honored for configs
+  // written before it existed. labelPreference() owns that fallback so the
+  // resolver and this function cannot disagree about what an old config means.
+  const labels = labelPreference(s);
   return {
-    icon:        s.icon    !== false,
+    labels,
+    // Kept for callers that only ask "emoji or not".
+    icon:        labels === 'icon',
+    // Off unless asked for: narrow labels are the IntelliJ default now, and only
+    // the user knows whether they would rather have garbled emoji than glyphs.
+    iconForce:   s.iconForce === true,
     verbose:     s.verbose !== false,
     timer:       s.timer   !== false,
     color:       s.color   !== false,