@triflux/core 10.1.0 → 10.25.1

package/hub/token-mode.mjs

@@ -2,83 +2,84 @@
 // GAP 분석 P2 #7: 심볼 통신 + 약어로 30-50% 토큰 절감
 
 /**
+ * @experimental 런타임 미연결 — 향후 통합 예정
  * @experimental
  * @type {Array<{ from: string[], to: string, type: 'symbol'|'abbrev' }>}
  */
 export const COMPACT_RULES = [
   // ── 심볼 치환 (긴 매칭 우선 정렬) ──
-  { from: ['greater than or equal'],                to: '≥',  type: 'symbol' },
-  { from: ['less than or equal'],                   to: '≤',  type: 'symbol' },
-  { from: ['results in', '결과적으로'],             to: '→',  type: 'symbol' },
-  { from: ['therefore', '따라서'],                  to: '∴',  type: 'symbol' },
-  { from: ['because', '왜냐하면'],                  to: '∵',  type: 'symbol' },
-  { from: ['approximately', '대략'],                to: '≈',  type: 'symbol' },
-  { from: ['not equal', '같지 않'],                 to: '≠',  type: 'symbol' },
-  { from: ['in progress', '진행 중'],               to: '⏳', type: 'symbol' },
-  { from: ['completed', '완료'],                    to: '✓',  type: 'symbol' },
-  { from: ['success', '성공'],                      to: '✓',  type: 'symbol' },
-  { from: ['failure', '실패'],                      to: '✗',  type: 'symbol' },
-  { from: ['warning', '경고'],                      to: '⚠',  type: 'symbol' },
-  { from: ['error', '에러'],                        to: '✗',  type: 'symbol' },
-  { from: ['pending', '대기'],                      to: '⏸',  type: 'symbol' },
+  { from: ["greater than or equal"], to: "≥", type: "symbol" },
+  { from: ["less than or equal"], to: "≤", type: "symbol" },
+  { from: ["results in", "결과적으로"], to: "→", type: "symbol" },
+  { from: ["therefore", "따라서"], to: "∴", type: "symbol" },
+  { from: ["because", "왜냐하면"], to: "∵", type: "symbol" },
+  { from: ["approximately", "대략"], to: "≈", type: "symbol" },
+  { from: ["not equal", "같지 않"], to: "≠", type: "symbol" },
+  { from: ["in progress", "진행 중"], to: "⏳", type: "symbol" },
+  { from: ["completed", "완료"], to: "✓", type: "symbol" },
+  { from: ["success", "성공"], to: "✓", type: "symbol" },
+  { from: ["failure", "실패"], to: "✗", type: "symbol" },
+  { from: ["warning", "경고"], to: "⚠", type: "symbol" },
+  { from: ["error", "에러"], to: "✗", type: "symbol" },
+  { from: ["pending", "대기"], to: "⏸", type: "symbol" },
 
   // ── 약어 (긴 매칭 우선 정렬) ──
-  { from: ['configuration', '설정'],                to: 'cfg',    type: 'abbrev' },
-  { from: ['implementation', '구현'],               to: 'impl',   type: 'abbrev' },
-  { from: ['architecture', '아키텍처'],             to: 'arch',   type: 'abbrev' },
-  { from: ['dependency', '의존성'],                 to: 'dep',    type: 'abbrev' },
-  { from: ['function', '함수'],                     to: 'fn',     type: 'abbrev' },
-  { from: ['parameter', '파라미터'],                to: 'param',  type: 'abbrev' },
-  { from: ['repository', '저장소'],                 to: 'repo',   type: 'abbrev' },
-  { from: ['environment', '환경'],                  to: 'env',    type: 'abbrev' },
-  { from: ['variable', '변수'],                     to: 'var',    type: 'abbrev' },
-  { from: ['directory', '디렉토리'],                to: 'dir',    type: 'abbrev' },
+  { from: ["configuration", "설정"], to: "cfg", type: "abbrev" },
+  { from: ["implementation", "구현"], to: "impl", type: "abbrev" },
+  { from: ["architecture", "아키텍처"], to: "arch", type: "abbrev" },
+  { from: ["dependency", "의존성"], to: "dep", type: "abbrev" },
+  { from: ["function", "함수"], to: "fn", type: "abbrev" },
+  { from: ["parameter", "파라미터"], to: "param", type: "abbrev" },
+  { from: ["repository", "저장소"], to: "repo", type: "abbrev" },
+  { from: ["environment", "환경"], to: "env", type: "abbrev" },
+  { from: ["variable", "변수"], to: "var", type: "abbrev" },
+  { from: ["directory", "디렉토리"], to: "dir", type: "abbrev" },
 
   // ── 한국어 동사/명령형 약어 ──
-  { from: ['구현해'],   to: 'impl',    type: 'abbrev' },
-  { from: ['확인해'],   to: 'check',   type: 'abbrev' },
-  { from: ['수정해'],   to: 'fix',     type: 'abbrev' },
-  { from: ['테스트'],   to: 'test',    type: 'abbrev' },
-  { from: ['리뷰'],     to: 'review',  type: 'abbrev' },
-  { from: ['분석'],     to: 'analyze', type: 'abbrev' },
-  { from: ['설계'],     to: 'design',  type: 'abbrev' },
-  { from: ['문서화'],   to: 'docs',    type: 'abbrev' },
+  { from: ["구현해"], to: "impl", type: "abbrev" },
+  { from: ["확인해"], to: "check", type: "abbrev" },
+  { from: ["수정해"], to: "fix", type: "abbrev" },
+  { from: ["테스트"], to: "test", type: "abbrev" },
+  { from: ["리뷰"], to: "review", type: "abbrev" },
+  { from: ["분석"], to: "analyze", type: "abbrev" },
+  { from: ["설계"], to: "design", type: "abbrev" },
+  { from: ["문서화"], to: "docs", type: "abbrev" },
 ];
 
 /** @type {Array<{ from: string[], to: string, type: 'symbol'|'abbrev' }>} */
 export const REVIEW_RULES = [
-  { from: ['looks good to me', 'lgtm'],    to: '✓lgtm',   type: 'abbrev' },
-  { from: ['needs changes', '수정 필요'],  to: '✗chg',    type: 'abbrev' },
-  { from: ['nitpick', '사소한'],           to: 'nit',     type: 'abbrev' },
-  { from: ['blocking', '블로킹'],          to: 'blk',     type: 'abbrev' },
-  { from: ['suggestion', '제안'],          to: 'sug',     type: 'abbrev' },
-  { from: ['question', '질문'],            to: 'q',       type: 'abbrev' },
-  { from: ['approved', '승인'],            to: '✓apv',    type: 'abbrev' },
-  { from: ['request changes', '변경 요청'], to: '✗req',   type: 'abbrev' },
+  { from: ["looks good to me", "lgtm"], to: "✓lgtm", type: "abbrev" },
+  { from: ["needs changes", "수정 필요"], to: "✗chg", type: "abbrev" },
+  { from: ["nitpick", "사소한"], to: "nit", type: "abbrev" },
+  { from: ["blocking", "블로킹"], to: "blk", type: "abbrev" },
+  { from: ["suggestion", "제안"], to: "sug", type: "abbrev" },
+  { from: ["question", "질문"], to: "q", type: "abbrev" },
+  { from: ["approved", "승인"], to: "✓apv", type: "abbrev" },
+  { from: ["request changes", "변경 요청"], to: "✗req", type: "abbrev" },
 ];
 
 /** @type {Array<{ from: string[], to: string, type: 'symbol'|'abbrev' }>} */
 export const DESIGN_RULES = [
-  { from: ['component', '컴포넌트'],       to: 'cmp',     type: 'abbrev' },
-  { from: ['interface', '인터페이스'],     to: 'iface',   type: 'abbrev' },
-  { from: ['abstraction', '추상화'],       to: 'abs',     type: 'abbrev' },
-  { from: ['pattern', '패턴'],             to: 'ptn',     type: 'abbrev' },
-  { from: ['dependency injection', '의존성 주입'], to: 'di', type: 'abbrev' },
-  { from: ['single responsibility', '단일 책임'],  to: 'srp', type: 'abbrev' },
-  { from: ['open closed', '개방 폐쇄'],    to: 'ocp',     type: 'abbrev' },
-  { from: ['inheritance', '상속'],         to: 'inh',     type: 'abbrev' },
+  { from: ["component", "컴포넌트"], to: "cmp", type: "abbrev" },
+  { from: ["interface", "인터페이스"], to: "iface", type: "abbrev" },
+  { from: ["abstraction", "추상화"], to: "abs", type: "abbrev" },
+  { from: ["pattern", "패턴"], to: "ptn", type: "abbrev" },
+  { from: ["dependency injection", "의존성 주입"], to: "di", type: "abbrev" },
+  { from: ["single responsibility", "단일 책임"], to: "srp", type: "abbrev" },
+  { from: ["open closed", "개방 폐쇄"], to: "ocp", type: "abbrev" },
+  { from: ["inheritance", "상속"], to: "inh", type: "abbrev" },
 ];
 
 /** @type {Array<{ from: string[], to: string, type: 'symbol'|'abbrev' }>} */
 export const DOCS_RULES = [
-  { from: ['description', '설명'],         to: 'desc',    type: 'abbrev' },
-  { from: ['example', '예시'],             to: 'ex',      type: 'abbrev' },
-  { from: ['reference', '참조'],           to: 'ref',     type: 'abbrev' },
-  { from: ['introduction', '소개'],        to: 'intro',   type: 'abbrev' },
-  { from: ['deprecated', '사용 중단'],     to: 'dep',     type: 'abbrev' },
-  { from: ['optional', '선택적'],          to: 'opt',     type: 'abbrev' },
-  { from: ['required', '필수'],            to: 'req',     type: 'abbrev' },
-  { from: ['returns', '반환'],             to: 'ret',     type: 'abbrev' },
+  { from: ["description", "설명"], to: "desc", type: "abbrev" },
+  { from: ["example", "예시"], to: "ex", type: "abbrev" },
+  { from: ["reference", "참조"], to: "ref", type: "abbrev" },
+  { from: ["introduction", "소개"], to: "intro", type: "abbrev" },
+  { from: ["deprecated", "사용 중단"], to: "dep", type: "abbrev" },
+  { from: ["optional", "선택적"], to: "opt", type: "abbrev" },
+  { from: ["required", "필수"], to: "req", type: "abbrev" },
+  { from: ["returns", "반환"], to: "ret", type: "abbrev" },
 ];
 
 // ── 프로필 맵 ──
@@ -86,9 +87,9 @@ export const DOCS_RULES = [
 /** @type {Record<string, Array<{ from: string[], to: string, type: 'symbol'|'abbrev' }>>} */
 const PROFILE_MAP = {
   default: COMPACT_RULES,
-  review:  [...COMPACT_RULES, ...REVIEW_RULES],
-  design:  [...COMPACT_RULES, ...DESIGN_RULES],
-  docs:    [...COMPACT_RULES, ...DOCS_RULES],
+  review: [...COMPACT_RULES, ...REVIEW_RULES],
+  design: [...COMPACT_RULES, ...DESIGN_RULES],
+  docs: [...COMPACT_RULES, ...DOCS_RULES],
 };
 
 // ── 내부: 정렬된 치환 쌍 빌드 헬퍼 ──
@@ -134,7 +135,7 @@ const CODE_BLOCK_RE = /```[\s\S]*?```/g;
  */
 function withCodeProtection(text, transform) {
   const blocks = [];
-  const placeholder = '\x00CB';
+  const placeholder = "\x00CB";
   let idx = 0;
   const masked = text.replace(CODE_BLOCK_RE, (match) => {
     blocks.push(match);
@@ -145,7 +146,7 @@ function withCodeProtection(text, transform) {
 
   // 플레이스홀더 복원
   return transformed.replace(
-    new RegExp(`${placeholder}(\\d+)${placeholder}`, 'g'),
+    new RegExp(`${placeholder}(\\d+)${placeholder}`, "g"),
     (_, i) => blocks[Number(i)],
   );
 }
@@ -169,14 +170,14 @@ export function isCompactMode() {
  * @returns {string}
  */
 export function compactify(text) {
-  if (!text || typeof text !== 'string') return text ?? '';
+  if (!text || typeof text !== "string") return text ?? "";
   _compactMode = true;
 
   return withCodeProtection(text, (segment) => {
     let result = segment;
     for (const { pattern, to } of _compactPairs) {
-      const escaped = pattern.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-      const re = new RegExp(escaped, 'gi');
+      const escaped = pattern.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+      const re = new RegExp(escaped, "gi");
       result = result.replace(re, to);
     }
     return result;
@@ -189,8 +190,8 @@ export function compactify(text) {
  * @param {'default'|'review'|'design'|'docs'} [profile='default'] — 도메인 프로필
  * @returns {string}
  */
-export function applyCompactRules(text, profile = 'default') {
-  if (!text || typeof text !== 'string') return text ?? '';
+export function applyCompactRules(text, profile = "default") {
+  if (!text || typeof text !== "string") return text ?? "";
 
   const rules = PROFILE_MAP[profile] ?? COMPACT_RULES;
   const pairs = buildCompactPairs(rules);
@@ -198,8 +199,8 @@ export function applyCompactRules(text, profile = 'default') {
   return withCodeProtection(text, (segment) => {
     let result = segment;
     for (const { pattern, to } of pairs) {
-      const escaped = pattern.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-      const re = new RegExp(escaped, 'gi');
+      const escaped = pattern.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+      const re = new RegExp(escaped, "gi");
       result = result.replace(re, to);
     }
     return result;
@@ -212,14 +213,14 @@ export function applyCompactRules(text, profile = 'default') {
  * @returns {string}
  */
 export function expand(text) {
-  if (!text || typeof text !== 'string') return text ?? '';
+  if (!text || typeof text !== "string") return text ?? "";
   _compactMode = false;
 
   return withCodeProtection(text, (segment) => {
     let result = segment;
     for (const { symbol, restore } of _expandPairs) {
-      const escaped = symbol.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-      const re = new RegExp(escaped, 'g');
+      const escaped = symbol.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+      const re = new RegExp(escaped, "g");
       result = result.replace(re, restore);
     }
     return result;

package/hub/workers/worker-utils.mjs

@@ -6,9 +6,7 @@ export const DEFAULT_KILL_GRACE_MS = 1000;
 
 export function toStringList(value) {
   if (!Array.isArray(value)) return [];
-  return value
-    .map((item) => String(item ?? '').trim())
-    .filter(Boolean);
+  return value.map((item) => String(item ?? "").trim()).filter(Boolean);
 }
 
 export function safeJsonParse(line) {
@@ -27,8 +25,7 @@ export function createWorkerError(message, details = {}) {
 
 function sleep(delayMs) {
   return new Promise((resolve) => {
-    const timer = setTimeout(resolve, Math.max(0, delayMs));
-    timer.unref?.();
+    setTimeout(resolve, Math.max(0, delayMs));
   });
 }
 
@@ -51,8 +48,9 @@ export async function withRetry(fn, opts = {}) {
         throw error;
       }
 
-      const delay = Math.min(baseDelayMs * 2 ** (attempt - 1), maxDelayMs)
-        * (0.5 + Math.random() * 0.5);
+      const delay =
+        Math.min(baseDelayMs * 2 ** (attempt - 1), maxDelayMs) *
+        (0.5 + Math.random() * 0.5);
       await sleep(delay);
     }
   }
@@ -63,7 +61,7 @@ export async function withRetry(fn, opts = {}) {
 export function appendTextFragments(value, parts) {
   if (value == null) return;
 
-  if (typeof value === 'string') {
+  if (typeof value === "string") {
     const trimmed = value.trim();
     if (trimmed) parts.push(trimmed);
     return;
@@ -74,11 +72,13 @@ export function appendTextFragments(value, parts) {
     return;
   }
 
-  if (typeof value !== 'object') return;
+  if (typeof value !== "object") return;
 
-  if (typeof value.text === 'string') appendTextFragments(value.text, parts);
-  if (typeof value.response === 'string') appendTextFragments(value.response, parts);
-  if (typeof value.result === 'string') appendTextFragments(value.result, parts);
+  if (typeof value.text === "string") appendTextFragments(value.text, parts);
+  if (typeof value.response === "string")
+    appendTextFragments(value.response, parts);
+  if (typeof value.result === "string")
+    appendTextFragments(value.result, parts);
   if (value.content != null) appendTextFragments(value.content, parts);
   if (value.message != null) appendTextFragments(value.message, parts);
 }
@@ -86,18 +86,24 @@ export function appendTextFragments(value, parts) {
 export function extractText(value) {
   const parts = [];
   appendTextFragments(value, parts);
-  return parts.join('\n').trim();
+  return parts.join("\n").trim();
 }
 
 export function terminateChild(child, killGraceMs) {
   if (!child || child.exitCode !== null || child.killed) return;
 
-  try { child.stdin.end(); } catch {}
-  try { child.kill(); } catch {}
+  try {
+    child.stdin.end();
+  } catch {}
+  try {
+    child.kill();
+  } catch {}
 
   const timer = setTimeout(() => {
     if (child.exitCode === null) {
-      try { child.kill('SIGKILL'); } catch {}
+      try {
+        child.kill("SIGKILL");
+      } catch {}
     }
   }, killGraceMs);
   timer.unref?.();

package/hud/colors.mjs

@@ -12,15 +12,33 @@ export const CLAUDE_ORANGE = "\x1b[38;2;232;112;64m"; // #E87040 (Claude 공식
 export const CODEX_WHITE = "\x1b[97m"; // bright white (SGR 37은 Windows Terminal에서 연회색 매핑)
 export const GEMINI_BLUE = "\x1b[38;5;39m";
 
-export function green(t) { return `${GREEN}${t}${RESET}`; }
-export function yellow(t) { return `${YELLOW}${t}${RESET}`; }
-export function red(t) { return `${RED}${t}${RESET}`; }
-export function cyan(t) { return `${CYAN}${t}${RESET}`; }
-export function dim(t) { return `${DIM}${t}${RESET}`; }
-export function bold(t) { return `${BOLD}${t}${RESET}`; }
-export function claudeOrange(t) { return `${CLAUDE_ORANGE}${t}${RESET}`; }
-export function codexWhite(t) { return `${CODEX_WHITE}${t}${RESET}`; }
-export function geminiBlue(t) { return `${GEMINI_BLUE}${t}${RESET}`; }
+export function green(t) {
+  return `${GREEN}${t}${RESET}`;
+}
+export function yellow(t) {
+  return `${YELLOW}${t}${RESET}`;
+}
+export function red(t) {
+  return `${RED}${t}${RESET}`;
+}
+export function cyan(t) {
+  return `${CYAN}${t}${RESET}`;
+}
+export function dim(t) {
+  return `${DIM}${t}${RESET}`;
+}
+export function bold(t) {
+  return `${BOLD}${t}${RESET}`;
+}
+export function claudeOrange(t) {
+  return `${CLAUDE_ORANGE}${t}${RESET}`;
+}
+export function codexWhite(t) {
+  return `${CODEX_WHITE}${t}${RESET}`;
+}
+export function geminiBlue(t) {
+  return `${GEMINI_BLUE}${t}${RESET}`;
+}
 
 export function colorByPercent(value, text) {
   if (value >= 85) return red(text);

package/hud/constants.mjs

@@ -6,26 +6,88 @@ import { join } from "node:path";
 
 export const VERSION = "2.0";
 
-export const QOS_PATH = join(homedir(), ".omc", "state", "cli_qos_profile.json");
-export const ACCOUNTS_CONFIG_PATH = join(homedir(), ".omc", "router", "accounts.json");
-export const ACCOUNTS_STATE_PATH = join(homedir(), ".omc", "state", "cli_accounts_state.json");
+export const QOS_PATH = join(
+  homedir(),
+  ".claude",
+  "cache",
+  "tfx-hub",
+  "cli_qos_profile.json",
+);
+export const ACCOUNTS_CONFIG_PATH = join(
+  homedir(),
+  ".claude",
+  "cache",
+  "tfx-hub",
+  "accounts.json",
+);
+export const ACCOUNTS_STATE_PATH = join(
+  homedir(),
+  ".claude",
+  "cache",
+  "tfx-hub",
+  "cli_accounts_state.json",
+);
 
 // tfx-multi 상태 (v2.2 HUD 통합)
-export const TEAM_STATE_PATH = join(homedir(), ".claude", "cache", "tfx-hub", "team-state.json");
-export const CONTEXT_MONITOR_CACHE_PATH = join(homedir(), ".claude", "cache", "tfx-hub", "context-monitor.json");
-export const CONTEXT_MONITOR_LEGACY_PATH = join(homedir(), ".omc", "state", "context-monitor.json");
-export const CONTEXT_MONITOR_LOG_DIR = join(homedir(), ".omc", "logs");
+export const TEAM_STATE_PATH = join(
+  homedir(),
+  ".claude",
+  "cache",
+  "tfx-hub",
+  "team-state.json",
+);
+export const CONTEXT_MONITOR_CACHE_PATH = join(
+  homedir(),
+  ".claude",
+  "cache",
+  "tfx-hub",
+  "context-monitor.json",
+);
+export const CONTEXT_MONITOR_LEGACY_PATH = join(
+  homedir(),
+  ".omc",
+  "state",
+  "context-monitor.json",
+);
+export const CONTEXT_MONITOR_LOG_DIR = join(
+  homedir(),
+  ".claude",
+  "cache",
+  "tfx-hub",
+  "logs",
+);
 
 // 원격 프로브 캐시 (tfx-remote-spawn)
-export const REMOTE_ENV_CACHE_DIR = join(homedir(), ".claude", "cache", "tfx-hub", "remote-env");
+export const REMOTE_ENV_CACHE_DIR = join(
+  homedir(),
+  ".claude",
+  "cache",
+  "tfx-hub",
+  "remote-env",
+);
 export const REMOTE_ENV_CACHE_TTL_MS = 24 * 60 * 60 * 1000; // 24시간
 
 // Claude OAuth Usage API (api.anthropic.com/api/oauth/usage)
-export const CLAUDE_CREDENTIALS_PATH = join(homedir(), ".claude", ".credentials.json");
-export const CLAUDE_USAGE_CACHE_PATH = join(homedir(), ".claude", "cache", "claude-usage-cache.json");
-export const OMC_PLUGIN_USAGE_CACHE_PATH = join(homedir(), ".claude", "plugins", "oh-my-claudecode", ".usage-cache.json");
+export const CLAUDE_CREDENTIALS_PATH = join(
+  homedir(),
+  ".claude",
+  ".credentials.json",
+);
+export const CLAUDE_USAGE_CACHE_PATH = join(
+  homedir(),
+  ".claude",
+  "cache",
+  "claude-usage-cache.json",
+);
+export const OMC_PLUGIN_USAGE_CACHE_PATH = join(
+  homedir(),
+  ".claude",
+  "cache",
+  "tfx-hub",
+  "plugin-usage-cache.json",
+);
 export const CLAUDE_USAGE_STALE_MS_SOLO = 5 * 60 * 1000; // OMC 없을 때: 5분 캐시
-export const CLAUDE_USAGE_STALE_MS_WITH_OMC = 15 * 60 * 1000; // OMC 있을 때: 15분 (OMC가 30초마다 갱신)
+export const CLAUDE_USAGE_STALE_MS_WITH_OMC = 15 * 60 * 1000; // OMC 있을 때: 15분
 export const CLAUDE_USAGE_429_BACKOFF_MS = 10 * 60 * 1000; // 429 에러 시 10분 backoff
 export const GEMINI_429_BASE_DELAY_MS = 2000;
 export const GEMINI_429_MAX_RETRIES = 3;
@@ -38,27 +100,115 @@ export const ONE_DAY_MS = 24 * 60 * 60 * 1000;
 export const DEFAULT_OAUTH_CLIENT_ID = "9d1c250a-e61b-44d9-88ed-5944d1962f5e";
 
 export const CODEX_AUTH_PATH = join(homedir(), ".codex", "auth.json");
-export const CODEX_QUOTA_CACHE_PATH = join(homedir(), ".claude", "cache", "codex-rate-limits-cache.json");
-export const CODEX_QUOTA_STALE_MS = 15 * 1000; // 15초
+export const CODEX_QUOTA_CACHE_PATH = join(
+  homedir(),
+  ".claude",
+  "cache",
+  "codex-rate-limits-cache.json",
+);
+export const CODEX_QUOTA_STALE_MS = 30 * 1000; // 30초
 export const CODEX_MIN_BUCKETS = 2;
 
+// Spawn lock (중복 refresh 방지)
+export const CLAUDE_REFRESH_LOCK_PATH = join(
+  homedir(),
+  ".claude",
+  "cache",
+  ".claude-refresh-lock",
+);
+export const CODEX_REFRESH_LOCK_PATH = join(
+  homedir(),
+  ".claude",
+  "cache",
+  ".codex-refresh-lock",
+);
+export const GEMINI_QUOTA_REFRESH_LOCK_PATH = join(
+  homedir(),
+  ".claude",
+  "cache",
+  ".gemini-quota-refresh-lock",
+);
+export const GEMINI_SESSION_REFRESH_LOCK_PATH = join(
+  homedir(),
+  ".claude",
+  "cache",
+  ".gemini-session-refresh-lock",
+);
+export const SPAWN_LOCK_TTL_MS = 30 * 1000; // 30초 spawn dedup
+
 // Gemini 쿼터 API 관련
 export const GEMINI_OAUTH_PATH = join(homedir(), ".gemini", "oauth_creds.json");
-export const GEMINI_QUOTA_CACHE_PATH = join(homedir(), ".claude", "cache", "gemini-quota-cache.json");
-export const GEMINI_PROJECT_CACHE_PATH = join(homedir(), ".claude", "cache", "gemini-project-id.json");
-export const GEMINI_SESSION_CACHE_PATH = join(homedir(), ".claude", "cache", "gemini-session-cache.json");
-export const GEMINI_RPM_TRACKER_PATH = join(homedir(), ".claude", "cache", "gemini-rpm-tracker.json");
-export const SV_ACCUMULATOR_PATH = join(homedir(), ".claude", "cache", "sv-accumulator.json");
+export const GEMINI_QUOTA_CACHE_PATH = join(
+  homedir(),
+  ".claude",
+  "cache",
+  "gemini-quota-cache.json",
+);
+export const GEMINI_PROJECT_CACHE_PATH = join(
+  homedir(),
+  ".claude",
+  "cache",
+  "gemini-project-id.json",
+);
+export const GEMINI_SESSION_CACHE_PATH = join(
+  homedir(),
+  ".claude",
+  "cache",
+  "gemini-session-cache.json",
+);
+export const TFX_PREFLIGHT_CACHE_PATH = join(
+  homedir(),
+  ".claude",
+  "cache",
+  "tfx-preflight.json",
+);
+export const GEMINI_RPM_TRACKER_PATH = join(
+  homedir(),
+  ".claude",
+  "cache",
+  "gemini-rpm-tracker.json",
+);
+export const SV_ACCUMULATOR_PATH = join(
+  homedir(),
+  ".claude",
+  "cache",
+  "sv-accumulator.json",
+);
 // 이전 .omc/ 경로 fallback (기존 환경 호환)
-export const LEGACY_GEMINI_QUOTA_CACHE = join(homedir(), ".omc", "state", "gemini_quota_cache.json");
-export const LEGACY_GEMINI_PROJECT_CACHE = join(homedir(), ".omc", "state", "gemini_project_id.json");
-export const LEGACY_GEMINI_SESSION_CACHE = join(homedir(), ".omc", "state", "gemini_session_tokens_cache.json");
-export const LEGACY_GEMINI_RPM_TRACKER = join(homedir(), ".omc", "state", "gemini_rpm_tracker.json");
-export const LEGACY_SV_ACCUMULATOR = join(homedir(), ".omc", "state", "sv-accumulator.json");
+export const LEGACY_GEMINI_QUOTA_CACHE = join(
+  homedir(),
+  ".omc",
+  "state",
+  "gemini_quota_cache.json",
+);
+export const LEGACY_GEMINI_PROJECT_CACHE = join(
+  homedir(),
+  ".omc",
+  "state",
+  "gemini_project_id.json",
+);
+export const LEGACY_GEMINI_SESSION_CACHE = join(
+  homedir(),
+  ".omc",
+  "state",
+  "gemini_session_tokens_cache.json",
+);
+export const LEGACY_GEMINI_RPM_TRACKER = join(
+  homedir(),
+  ".omc",
+  "state",
+  "gemini_rpm_tracker.json",
+);
+export const LEGACY_SV_ACCUMULATOR = join(
+  homedir(),
+  ".omc",
+  "state",
+  "sv-accumulator.json",
+);
 
 export const GEMINI_RPM_WINDOW_MS = 60 * 1000; // 60초 슬라이딩 윈도우
 export const GEMINI_QUOTA_STALE_MS = 5 * 60 * 1000; // 5분
-export const GEMINI_SESSION_STALE_MS = 15 * 1000; // 15초
+export const GEMINI_SESSION_STALE_MS = 30 * 1000; // 30초
 export const GEMINI_API_TIMEOUT_MS = 3000; // 3초
 
 export const ACCOUNT_LABEL_WIDTH = 10;
@@ -84,5 +234,12 @@ export const ROWS_BUDGET_MEDIUM = 28;
 export const ROWS_BUDGET_SMALL = 22;
 
 // Gemini Pro 풀 공유 그룹: 같은 remainingFraction을 공유하는 모델 ID들
-export const GEMINI_PRO_POOL = new Set(["gemini-2.5-pro", "gemini-3-pro-preview", "gemini-3.1-pro-preview"]);
-export const GEMINI_FLASH_POOL = new Set(["gemini-2.5-flash", "gemini-3-flash-preview"]);
+export const GEMINI_PRO_POOL = new Set([
+  "gemini-2.5-pro",
+  "gemini-3-pro-preview",
+  "gemini-3.1-pro-preview",
+]);
+export const GEMINI_FLASH_POOL = new Set([
+  "gemini-2.5-flash",
+  "gemini-3-flash-preview",
+]);