sprag-cli 3.44.0 → 3.45.0

package/README.ko.md

@@ -71,6 +71,8 @@ gemini-2.5-pro        57.9%             $734  ▰▰▰▰▰▰▰▰▰▰▰
 
 문제가 생기면 경고 칩이 줄 맨 앞으로 옵니다. `🚨 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

@@ -77,6 +77,8 @@ gemini-2.5-pro        57.9%             $734  ▰▰▰▰▰▰▰▰▰▰▰
 
 문제가 생기면 경고 칩이 줄 맨 앞으로 옵니다. `🚨 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)
@@ -214,6 +216,8 @@ The measured −18.6% comes from the harness and ratchet; routing and conversion
 
 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

@@ -397,9 +397,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 +414,7 @@ async function main() {
       color: colorOk,
       verbose: isVerbose,
       timer: showTimer,
-      mode: isIcon ? 'icon' : 'text',
+      mode: labelMode,
       segments,
       singleLine: hasFlag('--single-line'),
     });
@@ -480,9 +481,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 +497,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 +752,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 +772,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.45.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": {

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/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/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/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,