triflux 10.9.9 → 10.9.11

package/hooks/keyword-rules.json

@@ -11,7 +11,12 @@
       "skill": null,
       "action": "suppress_all",
       "priority": 0,
-      "supersedes": ["tfx-multi", "tfx-unified", "tfx-codex", "tfx-gemini"],
+      "supersedes": [
+        "tfx-multi",
+        "tfx-unified",
+        "tfx-codex",
+        "tfx-gemini"
+      ],
       "exclusive": true,
       "state": null,
       "mcp_route": null
@@ -57,7 +62,9 @@
       ],
       "skill": "tfx-swarm",
       "priority": 1,
-      "supersedes": ["tfx-codex"],
+      "supersedes": [
+        "tfx-codex"
+      ],
       "exclusive": false,
       "state": null,
       "mcp_route": null
@@ -65,14 +72,38 @@
     {
       "id": "tfx-unified",
       "patterns": [
-        { "source": "\\btfx[\\s-]?auto\\b", "flags": "i" },
-        { "source": "\\btfx[\\s-]?auto[\\s-]?codex\\b", "flags": "i" },
-        { "source": "(?:만들어|고쳐|구현해|짜줘|수정해|바꿔)", "flags": "i" },
-        { "source": "(?:리뷰해|검토해|봐줘|괜찮아)", "flags": "i" },
-        { "source": "(?:테스트|검증|돌려봐|QA)", "flags": "i" },
-        { "source": "(?:분석해|계획|설계해)", "flags": "i" },
-        { "source": "(?:찾아봐|조사해|검색해)", "flags": "i" },
-        { "source": "(?:정리해|슬롭|클린업)", "flags": "i" },
+        {
+          "source": "\\btfx[\\s-]?auto\\b",
+          "flags": "i"
+        },
+        {
+          "source": "\\btfx[\\s-]?auto[\\s-]?codex\\b",
+          "flags": "i"
+        },
+        {
+          "source": "(?:만들어|고쳐|구현해|짜줘|수정해|바꿔)",
+          "flags": "i"
+        },
+        {
+          "source": "(?:리뷰해|검토해|봐줘|괜찮아)",
+          "flags": "i"
+        },
+        {
+          "source": "(?:테스트|검증|돌려봐|QA)",
+          "flags": "i"
+        },
+        {
+          "source": "(?:분석해|계획|설계해)",
+          "flags": "i"
+        },
+        {
+          "source": "(?:찾아봐|조사해|검색해)",
+          "flags": "i"
+        },
+        {
+          "source": "(?:정리해|슬롭|클린업)",
+          "flags": "i"
+        },
         {
           "source": "\\b(?:implement|build|fix|review|test|plan|analyze)\\b",
           "flags": "i"
@@ -80,7 +111,9 @@
       ],
       "skill": "tfx-auto",
       "priority": 2,
-      "supersedes": ["tfx-auto-codex"],
+      "supersedes": [
+        "tfx-auto-codex"
+      ],
       "exclusive": false,
       "state": null,
       "mcp_route": null
@@ -193,17 +226,32 @@
     {
       "id": "wt-tab-route",
       "patterns": [
-        { "source": "(?:새\\s*탭|탭\\s*(?:새로|추가|생성|열|띄|파|만들))", "flags": "i" },
-        { "source": "(?:패인|화면|pane)\\s*(?:분할|나눠|스플릿|split)", "flags": "i" },
-        { "source": "\\bwt\\b\\s*(?:에\\s*)?(?:탭|tab|열|띄|새)", "flags": "i" },
-        { "source": "(?:터미널|terminal)\\s*(?:탭|새\\s*탭)", "flags": "i" },
-        { "source": "\\b(?:new\\s+tab|split\\s+pane|open\\s+(?:new\\s+)?tab)\\b", "flags": "i" }
+        {
+          "source": "(?:새\\s*탭|탭\\s*(?:새로|추가|생성|열|띄|파|만들))",
+          "flags": "i"
+        },
+        {
+          "source": "(?:패인|화면|pane)\\s*(?:분할|나눠|스플릿|split)",
+          "flags": "i"
+        },
+        {
+          "source": "\\bwt\\b\\s*(?:에\\s*)?(?:탭|tab|열|띄|새)",
+          "flags": "i"
+        },
+        {
+          "source": "(?:터미널|terminal)\\s*(?:탭|새\\s*탭)",
+          "flags": "i"
+        },
+        {
+          "source": "\\b(?:new\\s+tab|split\\s+pane|open\\s+(?:new\\s+)?tab)\\b",
+          "flags": "i"
+        }
       ],
-      "skill": null,
-      "action": "context_hint",
-      "hint": "WT 탭/패인 생성 요청입니다. wt.exe 직접 호출은 safety-guard가 차단합니다.\n\nhub/team/wt-manager.mjs의 createWtManager() 팩토리로 인스턴스를 만든 뒤 API를 호출하세요:\n- wt.createTab({ title, command, profile, cwd }) — 새 탭\n- wt.splitPane({ direction: 'H'|'V', title, command }) — 패인 분할\n- wt.applySplitLayout([{ title, command, direction }]) — 다중 배치\n- wt.closeTab(title) — 탭 닫기\n\n사용법:\nnode -e \"import('./hub/team/wt-manager.mjs').then(m => { const wt = m.createWtManager(); wt.createTab({ title: 'MyTab', command: 'pwsh' }); })\"",
+      "skill": "tfx-wt",
       "priority": 1,
-      "supersedes": ["tfx-unified"],
+      "supersedes": [
+        "tfx-unified"
+      ],
       "exclusive": false,
       "state": null,
       "mcp_route": null
@@ -211,14 +259,20 @@
     {
       "id": "wt-tab-rename",
       "patterns": [
-        { "source": "(?:탭\\s*(?:이름|제목)\\s*(?:바꿔|변경|rename))", "flags": "i" },
-        { "source": "(?:rename\\s+tab|tab\\s+rename)", "flags": "i" }
+        {
+          "source": "(?:탭\\s*(?:이름|제목)\\s*(?:바꿔|변경|rename))",
+          "flags": "i"
+        },
+        {
+          "source": "(?:rename\\s+tab|tab\\s+rename)",
+          "flags": "i"
+        }
       ],
-      "skill": null,
-      "action": "context_hint",
-      "hint": "WT 탭 이름 변경 요청입니다. wt.exe 직접 호출은 safety-guard가 차단합니다.\n\nhub/team/wt-manager.mjs의 createWtManager() 팩토리로 인스턴스를 만든 뒤 API를 호출하세요:\n- wt.renameTab({ oldTitle, newTitle }) — 탭 이름 변경\n\n사용법:\nnode -e \"import('./hub/team/wt-manager.mjs').then(m => { const wt = m.createWtManager(); wt.renameTab({ oldTitle: 'OldName', newTitle: 'NewName' }); })\"",
+      "skill": "tfx-wt",
       "priority": 1,
-      "supersedes": ["tfx-unified"],
+      "supersedes": [
+        "tfx-unified"
+      ],
       "exclusive": false,
       "state": null,
       "mcp_route": null
@@ -226,14 +280,20 @@
     {
       "id": "wt-tab-list",
       "patterns": [
-        { "source": "(?:탭\\s*(?:목록|리스트|열린|현재))", "flags": "i" },
-        { "source": "(?:list\\s+tabs|tab\\s+list|열린\\s*탭)", "flags": "i" }
+        {
+          "source": "(?:탭\\s*(?:목록|리스트|열린|현재))",
+          "flags": "i"
+        },
+        {
+          "source": "(?:list\\s+tabs|tab\\s+list|열린\\s*탭)",
+          "flags": "i"
+        }
       ],
-      "skill": null,
-      "action": "context_hint",
-      "hint": "WT 탭 목록 조회 요청입니다. wt.exe 직접 호출은 safety-guard가 차단합니다.\n\nhub/team/wt-manager.mjs의 createWtManager() 팩토리로 인스턴스를 만든 뒤 API를 호출하세요:\n- wt.listTabs() — 현재 열린 탭 목록 (pid 파일 기반)\n\n사용법:\nnode -e \"import('./hub/team/wt-manager.mjs').then(m => { const wt = m.createWtManager(); console.log(wt.listTabs()); })\"",
+      "skill": "tfx-wt",
       "priority": 1,
-      "supersedes": ["tfx-unified"],
+      "supersedes": [
+        "tfx-unified"
+      ],
       "exclusive": false,
       "state": null,
       "mcp_route": null
@@ -241,14 +301,20 @@
     {
       "id": "wt-tab-close",
       "patterns": [
-        { "source": "(?:탭\\s*(?:닫아|닫기|종료|정리|close))", "flags": "i" },
-        { "source": "(?:close\\s+tab|tab\\s+close|탭\\s*정리)", "flags": "i" }
+        {
+          "source": "(?:탭\\s*(?:닫아|닫기|종료|정리|close))",
+          "flags": "i"
+        },
+        {
+          "source": "(?:close\\s+tab|tab\\s+close|탭\\s*정리)",
+          "flags": "i"
+        }
       ],
-      "skill": null,
-      "action": "context_hint",
-      "hint": "WT 탭 닫기 요청입니다. wt.exe 직접 호출은 safety-guard가 차단합니다.\n\nhub/team/wt-manager.mjs의 createWtManager() 팩토리로 인스턴스를 만든 뒤 API를 호출하세요:\n- wt.closeTab(title) — 제목으로 탭 닫기\n- wt.closeStale({ olderThanMs, titlePattern }) — 오래된/패턴 매칭 탭 정리\n\n사용법:\nnode -e \"import('./hub/team/wt-manager.mjs').then(m => { const wt = m.createWtManager(); wt.closeTab('MyTab'); })\"",
+      "skill": "tfx-wt",
       "priority": 1,
-      "supersedes": ["tfx-unified"],
+      "supersedes": [
+        "tfx-unified"
+      ],
       "exclusive": false,
       "state": null,
       "mcp_route": null

package/hub/account-broker.mjs

@@ -354,6 +354,13 @@ class AccountBroker extends EventEmitter {
       if (isHalfOpen) {
         this.emit("circuitClose", { id: accountId });
       }
+    } else if (result?.skipCircuit) {
+      // 인프라 에러 — circuit/cooldown에 카운트하지 않음
+      circuitUpdate = {
+        failureTimestamps: acct.failureTimestamps,
+        circuitOpenedAt: acct.circuitOpenedAt,
+        circuitTrialInFlight: acct.circuitTrialInFlight,
+      };
     } else {
       circuitUpdate = this.#recordCircuitFailure(acct, isHalfOpen, now);
       if (circuitUpdate.circuitOpenedAt !== acct.circuitOpenedAt) {

package/hub/cli-adapter-base.mjs

@@ -282,6 +282,9 @@ export async function executeWithCircuitBroker({
     const coolMs = parseRetryAfterMs(text, provider);
     brokerMod.broker.markRateLimited(lease.id, coolMs);
     brokerMod.broker.emit("cooldown", { id: lease.id, provider, coolMs, reason: "quota_exhausted" });
+  } else if (lastResult.failureMode === "crash") {
+    // 인프라 에러(모듈 누락, 서버 에러 등)는 계정 문제가 아님 → circuit/cooldown 건너뜀
+    brokerMod.broker.release(lease.id, { ok: false, skipCircuit: true });
   } else {
     brokerMod.broker.release(lease.id, { ok: false });
   }

package/hub/public/dashboard.html

@@ -47,6 +47,17 @@ body{background:#0d1117;color:#c9d1d9;font-family:system-ui,-apple-system,sans-s
 .legend-dot{width:8px;height:8px;border-radius:50%;display:inline-block;margin-right:4px;vertical-align:middle}
 
 .placeholder{text-align:center;padding:24px;color:#8b949e;font-size:.85rem}
+.btn{background:#21262d;border:1px solid #30363d;color:#c9d1d9;padding:4px 12px;border-radius:6px;font-size:.78rem;cursor:pointer;transition:background .2s}
+.btn:hover{background:#30363d}
+.btn:active{background:#3b414a}
+.btn.ok{border-color:#3fb950;color:#3fb950}
+.guide{display:none;max-width:1200px;margin:0 auto 16px;background:#161b22;border:1px solid #30363d;border-radius:8px;padding:16px;font-size:.82rem;line-height:1.7;color:#8b949e}
+.guide.open{display:block}
+.guide h3{color:#c9d1d9;font-size:.9rem;margin:12px 0 6px}
+.guide h3:first-child{margin-top:0}
+.guide code{background:#0d1117;padding:1px 5px;border-radius:3px;font-size:.78rem;color:#d19a66}
+.guide ul{padding-left:18px;margin:4px 0}
+.actions{display:flex;gap:8px;align-items:center}
 </style>
 </head>
 <body>
@@ -57,9 +68,35 @@ body{background:#0d1117;color:#c9d1d9;font-family:system-ui,-apple-system,sans-s
     <span class="status-dot" id="statusDot"></span>
     <span id="statusText">연결 중...</span>
     <span id="lastUpdate" class="sub"></span>
+    <div class="actions">
+      <button class="btn" id="guideBtn" title="도움말">?</button>
+      <button class="btn" id="reloadBtn" title="계정 브로커 리로드">Reload</button>
+      <a href="/broker/dashboard" target="_blank" class="btn" style="text-decoration:none">Broker</a>
+    </div>
   </div>
 </div>
 
+<div class="guide" id="guidePanel">
+  <h3>AIMD 동시 워커</h3>
+  <p>AIMD(Additive Increase / Multiplicative Decrease) 알고리즘으로 최적 동시 워커 수를 자동 조절합니다. 게이지가 <code>10/10</code>에 가까우면 시스템이 포화 상태입니다.</p>
+  <h3>CLI 쿼터 사용률</h3>
+  <ul>
+    <li><strong>Claude</strong> — 5시간/주간 사용량. 80% 이상이면 빨간색 경고.</li>
+    <li><strong>Codex</strong> — Primary/Secondary 버킷별 사용률. 리셋 시간이 표시됩니다.</li>
+    <li><strong>Gemini</strong> — 남은 비율 기반 사용률. RPM/RPD 제한 포함.</li>
+  </ul>
+  <h3>호출 이력 타임라인</h3>
+  <p>최근 CLI 호출의 성공/실패/타임아웃을 시간순으로 표시합니다. <span style="color:#3fb950">녹색</span>=성공, <span style="color:#f85149">빨강</span>=실패, <span style="color:#d29922">노랑</span>=타임아웃.</p>
+  <h3>토큰 누적 현황</h3>
+  <p>CLI별 누적 토큰 사용량과 호출 횟수입니다. 세션 시작 이후의 합계입니다.</p>
+  <h3>조작</h3>
+  <ul>
+    <li><strong>Reload</strong> — <code>POST /broker/reload</code> 호출. accounts.json을 핫리로드합니다.</li>
+    <li><strong>Broker</strong> — 계정 브로커 대시보드(별도 페이지)를 엽니다.</li>
+    <li>데이터는 <strong>5초</strong>마다 자동 갱신됩니다.</li>
+  </ul>
+</div>
+
 <div class="grid">
   <!-- AIMD 게이지 -->
   <div class="card">
@@ -347,6 +384,30 @@ body{background:#0d1117;color:#c9d1d9;font-family:system-ui,-apple-system,sans-s
     rTimer = setTimeout(function() { drawEvents(cachedEvents); }, 150);
   });
 
+  /* ── 가이드 토글 ── */
+  document.getElementById('guideBtn').onclick = function() {
+    var p = document.getElementById('guidePanel');
+    p.classList.toggle('open');
+    this.classList.toggle('ok');
+  };
+
+  /* ── 브로커 리로드 ── */
+  document.getElementById('reloadBtn').onclick = function() {
+    var btn = this;
+    btn.textContent = '...';
+    fetch('/broker/reload', { method: 'POST' })
+      .then(function(r) { return r.json(); })
+      .then(function(d) {
+        btn.textContent = d.ok ? 'OK (' + (d.accounts || 0) + ')' : 'Fail';
+        btn.classList.toggle('ok', d.ok);
+        setTimeout(function() { btn.textContent = 'Reload'; btn.classList.remove('ok'); }, 3000);
+      })
+      .catch(function() {
+        btn.textContent = 'Error';
+        setTimeout(function() { btn.textContent = 'Reload'; }, 3000);
+      });
+  };
+
   poll();
   setInterval(poll, POLL);
 })();

package/hub/server.mjs

@@ -719,6 +719,16 @@ export async function startHub({
         return;
       }
 
+      if (path === "/broker/quota-refresh" && (req.method === "POST" || req.method === "GET")) {
+        try {
+          const results = await refreshAllAccountQuotas();
+          return writeJson(res, 200, { ok: true, results, ts: Date.now() });
+        } catch (err) {
+          hubLog.error({ err: String(err?.message || err) }, "broker.quota_refresh_error");
+          return writeJson(res, 200, { ok: false, error: String(err?.message || err) });
+        }
+      }
+
       if (path === "/broker/reload" && req.method === "POST") {
         const result = reloadBroker();
         if (!result.ok) {
@@ -1667,17 +1677,70 @@ function cleanupStaleSpawnSessions(log) {
   return killed;
 }
 
+// ── Quota check for all accounts ───────────────────────────────
+
+const QUOTA_CACHE_PATH = join(CACHE_DIR, "broker-quota-cache.json");
+
+async function checkSingleAccountQuota(acct) {
+  const authPath = join(PID_DIR, acct.authFile);
+  if (!existsSync(authPath)) return { id: acct.id, status: "no_auth" };
+  try {
+    const auth = JSON.parse(readFileSync(authPath, "utf8"));
+    if (acct.provider === "codex") {
+      const token = auth.tokens?.access_token || auth.OPENAI_API_KEY || "";
+      if (!token) return { id: acct.id, status: "no_token" };
+      const r = await fetch("https://api.openai.com/v1/chat/completions", {
+        method: "POST", signal: AbortSignal.timeout(8000),
+        headers: { Authorization: "Bearer " + token, "Content-Type": "application/json" },
+        body: JSON.stringify({ model: "gpt-4.1-nano", messages: [{ role: "user", content: "hi" }], max_tokens: 1 }),
+      });
+      const hdrs = Object.fromEntries([...r.headers.entries()].filter(([k]) => /ratelimit/i.test(k)));
+      if (r.status === 429) return { id: acct.id, status: "quota_hit", http: 429, headers: hdrs };
+      if (r.status === 401) {
+        // 401이어도 ratelimit 헤더가 있으면 쿼터 정보 추출 가능
+        return { id: acct.id, status: "auth_error", http: 401, headers: hdrs };
+      }
+      return { id: acct.id, status: r.ok ? "ok" : "error", http: r.status, headers: hdrs };
+    }
+    // gemini — OAuth token refresh needed for accurate check
+    return { id: acct.id, status: "oauth_check_needed" };
+  } catch (e) {
+    return { id: acct.id, status: "error", message: e.message?.substring(0, 60) };
+  }
+}
+
+async function refreshAllAccountQuotas() {
+  const snap = brokerInstance?.snapshot() || [];
+  const checks = snap.filter(a => a.authFile).map(a => checkSingleAccountQuota(a));
+  const results = await Promise.all(checks);
+  // 캐시 저장
+  try {
+    writeFileSync(QUOTA_CACHE_PATH, JSON.stringify({ ts: Date.now(), results }));
+  } catch { /* best-effort */ }
+  return results;
+}
+
+function loadQuotaCache() {
+  try {
+    if (!existsSync(QUOTA_CACHE_PATH)) return null;
+    return JSON.parse(readFileSync(QUOTA_CACHE_PATH, "utf8"));
+  } catch { return null; }
+}
+
 // ── Broker Dashboard HTML ──────────────────────────────────────
 
 function renderBrokerDashboard() {
   return `<!DOCTYPE html><html lang="ko"><head><meta charset="utf-8">
 <title>Account Broker Dashboard</title>
-<meta http-equiv="refresh" content="30">
 <style>
 *{margin:0;padding:0;box-sizing:border-box}
 body{background:#0a0a0b;color:#e8e8ec;font:14px/1.6 'SF Mono',Consolas,monospace;padding:24px}
-h1{font-size:18px;color:#a8b1ff;margin-bottom:16px}
-.grid{display:grid;grid-template-columns:repeat(auto-fill,minmax(340px,1fr));gap:12px}
+h1{font-size:18px;color:#a8b1ff;margin-bottom:8px}
+.toolbar{margin-bottom:16px;display:flex;gap:8px;align-items:center}
+.toolbar button{background:#1a1a2e;color:#a8b1ff;border:1px solid rgba(255,255,255,0.1);border-radius:4px;padding:4px 12px;cursor:pointer;font:12px inherit}
+.toolbar button:hover{background:#252547}
+.toolbar .status-text{font-size:11px;color:#555}
+.grid{display:grid;grid-template-columns:repeat(auto-fill,minmax(380px,1fr));gap:12px}
 .card{background:#141416;border:1px solid rgba(255,255,255,0.06);border-radius:8px;padding:16px}
 .card.available{border-left:3px solid #34d399}
 .card.busy{border-left:3px solid #fbbf24}
@@ -1690,16 +1753,75 @@ h1{font-size:18px;color:#a8b1ff;margin-bottom:16px}
 .status.busy{background:#451a03;color:#fbbf24}
 .status.cooldown{background:#450a0a;color:#f87171}
 .status.circuit-open{background:#450a0a;color:#ef4444}
-.meta{margin-top:8px;font-size:11px;color:#666;line-height:1.8}
+.gauge{margin-top:8px}
+.gauge-row{display:flex;align-items:center;gap:8px;margin:3px 0}
+.gauge-label{font-size:10px;color:#888;width:28px;text-align:right}
+.gauge-bar{flex:1;height:8px;background:#1a1a1e;border-radius:4px;overflow:hidden}
+.gauge-fill{height:100%;border-radius:4px;transition:width .3s}
+.gauge-fill.green{background:linear-gradient(90deg,#34d399,#059669)}
+.gauge-fill.yellow{background:linear-gradient(90deg,#fbbf24,#d97706)}
+.gauge-fill.red{background:linear-gradient(90deg,#f87171,#dc2626)}
+.gauge-pct{font-size:10px;color:#999;width:32px}
+.gauge-reset{font-size:9px;color:#555}
+.meta{margin-top:6px;font-size:11px;color:#666;line-height:1.8}
 .meta b{color:#999}
 .timer{color:#f87171;font-weight:600}
-.refresh{color:#555;font-size:11px;margin-top:16px}
+.refresh-bar{color:#555;font-size:11px;margin-top:16px}
 </style></head><body>
-<h1>🔑 Account Broker Dashboard</h1>
+<h1>Account Broker Dashboard</h1>
+<div class="toolbar">
+  <button onclick="checkQuotas()">Check All Quotas</button>
+  <button onclick="reloadBroker()">Reload Broker</button>
+  <span id="toolbar-status" class="status-text"></span>
+</div>
 <div id="grid" class="grid"></div>
-<p class="refresh">auto-refresh: 10s | <a href="/broker/snapshot" style="color:#666">JSON API</a></p>
+<p class="refresh-bar">auto-refresh: 10s | <a href="/broker/snapshot" style="color:#666">JSON</a> | <a href="/broker/quota-refresh" style="color:#666">Quota API</a></p>
 <script>
+let quotaData={};
 function fmt(ms){if(ms<=0)return'-';const s=Math.floor(ms/1000),m=Math.floor(s/60),h=Math.floor(m/60),d=Math.floor(h/24);if(d>0)return d+'d '+h%24+'h';if(h>0)return h+'h '+m%60+'m';if(m>0)return m+'m '+s%60+'s';return s+'s'}
+
+function gaugeColor(pct){return pct<60?'green':pct<85?'yellow':'red'}
+
+function renderGauge(label,pct,resetTs){
+  if(pct==null)return '';
+  const now=Date.now()/1000;
+  const resetIn=resetTs>now?fmt((resetTs-now)*1000):'';
+  return '<div class="gauge-row"><span class="gauge-label">'+label+'</span>'+
+    '<div class="gauge-bar"><div class="gauge-fill '+gaugeColor(pct)+'" style="width:'+pct+'%"></div></div>'+
+    '<span class="gauge-pct">'+pct+'%</span>'+
+    (resetIn?'<span class="gauge-reset">reset '+resetIn+'</span>':'')+
+    '</div>';
+}
+
+function renderQuotaGauges(acctId){
+  const q=quotaData[acctId];
+  if(!q)return '<div class="gauge"><div class="gauge-row"><span style="font-size:10px;color:#444">quota: click Check All Quotas</span></div></div>';
+  if(q.status==='quota_hit')return '<div class="gauge"><div class="gauge-row"><span style="font-size:10px;color:#f87171">QUOTA EXHAUSTED</span></div></div>';
+  if(q.status==='auth_error'||q.status==='no_token'||q.status==='oauth_check_needed'){
+    // 401이어도 ratelimit 헤더가 있으면 표시
+    const h=q.headers||{};
+    const limReq=h['x-ratelimit-limit-requests'],remReq=h['x-ratelimit-remaining-requests'];
+    const limTok=h['x-ratelimit-limit-tokens'],remTok=h['x-ratelimit-remaining-tokens'];
+    if(limReq){
+      const pctReq=Math.round((1-remReq/limReq)*100);
+      const pctTok=limTok?Math.round((1-remTok/limTok)*100):null;
+      return '<div class="gauge">'+renderGauge('req',pctReq,0)+(pctTok!=null?renderGauge('tok',pctTok,0):'')+'</div>';
+    }
+    return '<div class="gauge"><div class="gauge-row"><span style="font-size:10px;color:#fbbf24">'+(q.status==='oauth_check_needed'?'OAuth refresh needed':'auth: token refresh needed')+'</span></div></div>';
+  }
+  if(q.status==='ok'||q.status==='error'){
+    const h=q.headers||{};
+    const limReq=h['x-ratelimit-limit-requests'],remReq=h['x-ratelimit-remaining-requests'];
+    const limTok=h['x-ratelimit-limit-tokens'],remTok=h['x-ratelimit-remaining-tokens'];
+    const resetReq=h['x-ratelimit-reset-requests'],resetTok=h['x-ratelimit-reset-tokens'];
+    if(!limReq)return '';
+    const pctReq=Math.round((1-remReq/limReq)*100);
+    const pctTok=limTok?Math.round((1-remTok/limTok)*100):null;
+    return '<div class="gauge">'+renderGauge('req',pctReq,0)+(pctTok!=null?renderGauge('tok',pctTok,0):'')+'</div>';
+  }
+  return '';
+}
+
 async function refresh(){
   try{
     const r=await fetch('/broker/snapshot');
@@ -1719,6 +1841,7 @@ async function refresh(){
         '<div class="id">'+a.id+'</div>'+
         '<span class="status '+st+'">'+sl+'</span>'+
         (cd>0?'<span class="timer" style="margin-left:8px">'+fmt(cd)+' remaining</span>':'')+
+        renderQuotaGauges(a.id)+
         '<div class="meta">'+
         '<b>Sessions:</b> '+a.totalSessions+
         (a.lastUsedAt?' | <b>Last:</b> '+new Date(a.lastUsedAt).toLocaleTimeString():'')+
@@ -1728,6 +1851,29 @@ async function refresh(){
     }).join('');
   }catch(e){console.error('refresh failed',e)}
 }
+
+async function checkQuotas(){
+  const el=document.getElementById('toolbar-status');
+  el.textContent='checking quotas...';
+  try{
+    const r=await fetch('/broker/quota-refresh',{method:'POST'});
+    const d=await r.json();
+    if(d.ok){
+      d.results.forEach(q=>{quotaData[q.id]=q});
+      el.textContent='updated '+d.results.length+' accounts ('+new Date().toLocaleTimeString()+')';
+      refresh();
+    }else{el.textContent='error';}
+  }catch(e){el.textContent='failed: '+e.message;}
+}
+
+async function reloadBroker(){
+  await fetch('/broker/reload',{method:'POST'});
+  document.getElementById('toolbar-status').textContent='broker reloaded';
+  refresh();
+}
+
+// 캐시에서 초기 로드
+fetch('/broker/quota-refresh').catch(()=>{});
 refresh();setInterval(refresh,10000);
 </script></body></html>`;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "triflux",
-  "version": "10.9.9",
+  "version": "10.9.11",
   "description": "CLI-first multi-model orchestrator for Claude Code — route tasks to Codex, Gemini, and Claude",
   "type": "module",
   "bin": {

package/scripts/tfx-route-worker.mjs

@@ -51,6 +51,7 @@ if (!createWorker) {
 function parseArgs(argv) {
   const args = {
     allowedMcpServerNames: [],
+    extraArgs: [],
     mcpConfig: [],
   };
 
@@ -94,6 +95,10 @@ function parseArgs(argv) {
         args.allowedMcpServerNames.push(next);
         index += 1;
         break;
+      case "--extra-arg":
+        args.extraArgs.push(next);
+        index += 1;
+        break;
       case "--mcp-config":
         args.mcpConfig.push(next);
         index += 1;
@@ -202,6 +207,7 @@ const worker = createWorker(args.type, {
   permissionMode: args.permissionMode,
   allowDangerouslySkipPermissions: args.allowDangerouslySkipPermissions,
   allowedMcpServerNames: args.allowedMcpServerNames,
+  extraArgs: args.extraArgs,
   mcpConfig:
     args.type === "claude" && args.mcpConfig.length === 0
       ? resolveDefaultMcpConfig(args.cwd || process.cwd())

package/scripts/tfx-route.sh

@@ -1,5 +1,5 @@
 #!/usr/bin/env bash
-# tfx-route.sh v2.4 — CLI 라우팅 래퍼 (triflux)
+# tfx-route.sh v2.7 — CLI 라우팅 래퍼 (triflux)
 #
 # v1.x: cli-route.sh (jq+python3+node 혼재, 동기 후처리 ~1s)
 # v2.0: tfx-route.sh 리네임
@@ -9,7 +9,7 @@
 #   - Gemini health check 지수 백오프 (30×1s → 5×exp)
 #   - 컨텍스트 파일 5번째 인자 지원
 #
-VERSION="2.5"
+VERSION="2.7"
 #
 # 사용법:
 #   tfx-route.sh <agent_type> <prompt> [mcp_profile] [timeout_sec] [context_file]
@@ -220,10 +220,13 @@ CODEX_BIN="${CODEX_BIN:-$(command -v codex 2>/dev/null || echo codex)}"
 GEMINI_BIN="${GEMINI_BIN:-$(command -v gemini 2>/dev/null || echo gemini)}"
 CLAUDE_BIN="${CLAUDE_BIN:-$(command -v claude 2>/dev/null || echo claude)}"
 GEMINI_BIN_ARGS_JSON="${GEMINI_BIN_ARGS_JSON:-[]}"
+# ── Gemini 확장 플래그 (issue #64) ──
+TFX_GEMINI_EXTENSIONS="${TFX_GEMINI_EXTENSIONS:-}"
+TFX_GEMINI_FLAGS="${TFX_GEMINI_FLAGS:-}"
 CLAUDE_BIN_ARGS_JSON="${CLAUDE_BIN_ARGS_JSON:-[]}"
 
 # ── Gemini 프로필 경로 (Codex config.toml 대칭) ──
-GEMINI_PROFILES_PATH="${GEMINI_PROFILES_PATH:-$(eval echo ~)/.gemini/triflux-profiles.json}"
+GEMINI_PROFILES_PATH="${GEMINI_PROFILES_PATH:-${HOME}/.gemini/triflux-profiles.json}"
 
 # ── 상수 ──
 MAX_STDOUT_BYTES=51200  # 50KB — Claude 컨텍스트 절약
@@ -250,7 +253,6 @@ unset _tfx_breadcrumb
 
 # fallback 시 원래 에이전트 정보 보존
 ORIGINAL_AGENT=""
-ORIGINAL_CLI_ARGS=""
 
 # JSON 문자열 이스케이프:
 # - "\", """ 필수 이스케이프
@@ -340,33 +342,32 @@ normalize_script_path() {
   printf '%s\n' "$path"
 }
 
-# ── 팀 Hub Bridge 통신 ──
-resolve_bridge_script() {
-  if [[ -n "${TFX_BRIDGE_SCRIPT:-}" && -f "$TFX_BRIDGE_SCRIPT" ]]; then
-    printf '%s\n' "$TFX_BRIDGE_SCRIPT"
-    return 0
+# ── 스크립트 경로 해석 공통 인프라 ──
+_tfx_script_dir=""
+_get_script_dir() {
+  if [[ -z "$_tfx_script_dir" ]]; then
+    local ref; ref="$(normalize_script_path "${BASH_SOURCE[0]}")"
+    _tfx_script_dir="$(cd "$(dirname "$ref")" && pwd -P)"
   fi
+  printf '%s\n' "$_tfx_script_dir"
+}
 
-  local script_dir
-  script_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-  local candidates=()
-  [[ -n "$TFX_PKG_ROOT" ]] && candidates+=("$TFX_PKG_ROOT/hub/bridge.mjs")
-  candidates+=(
-    "$script_dir/../hub/bridge.mjs"
-    "$script_dir/hub/bridge.mjs"
-  )
-
-  local candidate
-  for candidate in "${candidates[@]}"; do
-    if [[ -f "$candidate" ]]; then
-      printf '%s\n' "$candidate"
-      return 0
-    fi
-  done
-
+# _resolve_script ENV_VAR_VALUE CANDIDATE... → 첫 번째 존재하는 파일 경로 반환
+_resolve_script() {
+  local env_val="${1:-}"; shift
+  [[ -n "$env_val" && -f "$env_val" ]] && { printf '%s\n' "$env_val"; return 0; }
+  local c; for c in "$@"; do [[ -f "$c" ]] && { printf '%s\n' "$c"; return 0; }; done
   return 1
 }
 
+# ── 팀 Hub Bridge 통신 ──
+resolve_bridge_script() {
+  local sd; sd="$(_get_script_dir)"
+  _resolve_script "${TFX_BRIDGE_SCRIPT:-}" \
+    ${TFX_PKG_ROOT:+"$TFX_PKG_ROOT/hub/bridge.mjs"} \
+    "$sd/../hub/bridge.mjs" "$sd/hub/bridge.mjs"
+}
+
 bridge_cli() {
   if ! command -v "$NODE_BIN" &>/dev/null; then
     return 127
@@ -401,14 +402,6 @@ bridge_json_stringify() {
   shift || true
 
   case "$mode" in
-    metadata-patch)
-      "$NODE_BIN" -e '
-        process.stdout.write(JSON.stringify({
-          result: process.argv[1] || "",
-          summary: process.argv[2] || "",
-        }));
-      ' -- "${1:-}" "${2:-}"
-      ;;
     task-result)
       "$NODE_BIN" -e '
         process.stdout.write(JSON.stringify({
@@ -584,10 +577,13 @@ team_complete_task() {
   # Claude 재로그인 시 Agent 래퍼가 죽어도 이 파일로 결과 수집 가능
   local result_dir="${TFX_RESULT_DIR:-${HOME}/.claude/tfx-results/${TFX_TEAM_NAME}}"
   if mkdir -p "$result_dir" 2>/dev/null; then
-    cat > "${result_dir}/${TFX_TEAM_TASK_ID}.json" 2>/dev/null <<RESULT_EOF
-{"taskId":"${TFX_TEAM_TASK_ID}","agent":"${TFX_TEAM_AGENT_NAME}","team":"${TFX_TEAM_NAME}","result":"${result}","summary":$(printf '%s' "$summary_trimmed" | node -e "let d='';process.stdin.on('data',c=>d+=c);process.stdin.on('end',()=>console.log(JSON.stringify(d)))" 2>/dev/null || echo '""'),"timestamp":"$(date -u +%Y-%m-%dT%H:%M:%SZ)"}
-RESULT_EOF
-    [[ $? -eq 0 ]] && echo "[tfx-route] 결과 백업: ${result_dir}/${TFX_TEAM_TASK_ID}.json" >&2
+    # 전체를 Node.js로 안전하게 stringify — 변수 직접 삽입 인젝션 방지
+    "$NODE_BIN" -e '
+      const [,taskId,agent,team,result,summary,ts] = process.argv;
+      process.stdout.write(JSON.stringify({taskId,agent,team,result,summary,timestamp:ts}));
+    ' -- "$TFX_TEAM_TASK_ID" "$TFX_TEAM_AGENT_NAME" "$TFX_TEAM_NAME" "$result" "$summary_trimmed" "$(date -u +%Y-%m-%dT%H:%M:%SZ)" \
+      > "${result_dir}/${TFX_TEAM_TASK_ID}.json" 2>/dev/null \
+      && echo "[tfx-route] 결과 백업: ${result_dir}/${TFX_TEAM_TASK_ID}.json" >&2
   fi
 }
 
@@ -633,8 +629,9 @@ auto_reroute() {
   local quota_marker="$TFX_TMP/tfx-quota-${failed_cli}-$(date +%Y%m%d)"
   echo "$(date +%s)" >> "$quota_marker"
   ORIGINAL_AGENT="$AGENT_TYPE"
-  ORIGINAL_CLI_ARGS="$CLI_ARGS"
   export TFX_REROUTED_FROM="$CLI_TYPE"
+  # EXIT trap 정리 — exec는 현재 프로세스를 교체하므로 trap이 실행되지 않음
+  cleanup_workers
   TFX_CLI_MODE="$target_cli" exec bash "${BASH_SOURCE[0]}" \
     "$AGENT_TYPE" "$PROMPT" "$MCP_PROFILE" "$USER_TIMEOUT" "$CONTEXT_FILE"
 }
@@ -816,7 +813,7 @@ route_agent() {
   # ── 에이전트별 상세 설정 ──
   case "$agent" in
     # ─── 구현 레인 ───
-    executor)
+    executor|codex)
       CLI_ARGS="exec --profile codex53_high ${codex_base}"
       CLI_EFFORT="codex53_high"; DEFAULT_TIMEOUT=1080; RUN_MODE="fg"; OPUS_OVERSIGHT="false" ;;
     build-fixer)
@@ -825,48 +822,33 @@ route_agent() {
     debugger)
       CLI_ARGS="exec --profile codex53_high ${codex_base}"
       CLI_EFFORT="codex53_high"; DEFAULT_TIMEOUT=900; RUN_MODE="bg"; OPUS_OVERSIGHT="false" ;;
-    deep-executor)
-      CLI_ARGS="exec --profile gpt54_xhigh ${codex_base}"
-      CLI_EFFORT="gpt54_xhigh"; DEFAULT_TIMEOUT=3600; RUN_MODE="bg"; OPUS_OVERSIGHT="true" ;;
 
     # ─── 설계/분석 레인 (5.4: 1M 컨텍스트, 에이전틱) ───
-    architect)
-      CLI_ARGS="exec --profile gpt54_xhigh ${codex_base}"
-      CLI_EFFORT="gpt54_xhigh"; DEFAULT_TIMEOUT=3600; RUN_MODE="bg"; OPUS_OVERSIGHT="true" ;;
-    planner)
-      CLI_ARGS="exec --profile gpt54_xhigh ${codex_base}"
-      CLI_EFFORT="gpt54_xhigh"; DEFAULT_TIMEOUT=3600; RUN_MODE="fg"; OPUS_OVERSIGHT="true" ;;
-    critic)
+    deep-executor|architect|critic)
       CLI_ARGS="exec --profile gpt54_xhigh ${codex_base}"
       CLI_EFFORT="gpt54_xhigh"; DEFAULT_TIMEOUT=3600; RUN_MODE="bg"; OPUS_OVERSIGHT="true" ;;
-    analyst)
+    planner|analyst)
       CLI_ARGS="exec --profile gpt54_xhigh ${codex_base}"
       CLI_EFFORT="gpt54_xhigh"; DEFAULT_TIMEOUT=3600; RUN_MODE="fg"; OPUS_OVERSIGHT="true" ;;
 
     # ─── 리뷰 레인 (5.3-codex: SWE-Bench 72%) ───
-    code-reviewer)
+    code-reviewer|quality-reviewer)
       CLI_ARGS="exec --profile codex53_high ${codex_base} review"
       CLI_EFFORT="codex53_high"; DEFAULT_TIMEOUT=1800; RUN_MODE="bg"; OPUS_OVERSIGHT="false" ;;
     security-reviewer)
       CLI_ARGS="exec --profile codex53_high ${codex_base} review"
       CLI_EFFORT="codex53_high"; DEFAULT_TIMEOUT=1800; RUN_MODE="bg"; OPUS_OVERSIGHT="true" ;;
-    quality-reviewer)
-      CLI_ARGS="exec --profile codex53_high ${codex_base} review"
-      CLI_EFFORT="codex53_high"; DEFAULT_TIMEOUT=1800; RUN_MODE="bg"; OPUS_OVERSIGHT="false" ;;
 
     # ─── 리서치 레인 ───
-    scientist)
+    scientist|document-specialist)
       CLI_ARGS="exec --profile codex53_high ${codex_base}"
       CLI_EFFORT="codex53_high"; DEFAULT_TIMEOUT=1440; RUN_MODE="bg"; OPUS_OVERSIGHT="false" ;;
     scientist-deep)
       CLI_ARGS="exec --profile gpt54_high ${codex_base}"
       CLI_EFFORT="gpt54_high"; DEFAULT_TIMEOUT=3600; RUN_MODE="bg"; OPUS_OVERSIGHT="false" ;;
-    document-specialist)
-      CLI_ARGS="exec --profile codex53_high ${codex_base}"
-      CLI_EFFORT="codex53_high"; DEFAULT_TIMEOUT=1440; RUN_MODE="bg"; OPUS_OVERSIGHT="false" ;;
 
     # ─── UI/문서 레인 ───
-    designer)
+    designer|gemini)
       CLI_ARGS="-m $(resolve_gemini_profile pro31) -y --prompt"
       CLI_EFFORT="pro31"; DEFAULT_TIMEOUT=900; RUN_MODE="bg"; OPUS_OVERSIGHT="false" ;;
     writer)
@@ -874,10 +856,10 @@ route_agent() {
       CLI_EFFORT="flash3"; DEFAULT_TIMEOUT=900; RUN_MODE="bg"; OPUS_OVERSIGHT="false" ;;
 
     # ─── 탐색 (Claude-native: Glob/Grep/Read 직접 접근) ───
-    explore)
+    explore|claude)
       CLI_EFFORT="n/a"; DEFAULT_TIMEOUT=600; RUN_MODE="fg"; OPUS_OVERSIGHT="false" ;;
 
-    # ─── 검증/테스트 (Codex: 무료 + 파일 쓰기 가능) ───
+    # ─── 검증/테스트 ───
     verifier)
       CLI_ARGS="exec --profile codex53_high ${codex_base} review"
       CLI_EFFORT="codex53_high"; DEFAULT_TIMEOUT=1200; RUN_MODE="fg"; OPUS_OVERSIGHT="false" ;;
@@ -892,15 +874,6 @@ route_agent() {
     spark)
       CLI_ARGS="exec --profile spark53_low ${codex_base}"
       CLI_EFFORT="spark53_low"; DEFAULT_TIMEOUT=180; RUN_MODE="fg"; OPUS_OVERSIGHT="false" ;;
-    # ─── CLI 이름 alias (사용자 편의) ───
-    codex)
-      CLI_ARGS="exec --profile codex53_high ${codex_base}"
-      CLI_EFFORT="codex53_high"; DEFAULT_TIMEOUT=1080; RUN_MODE="fg"; OPUS_OVERSIGHT="false" ;;
-    gemini)
-      CLI_ARGS="-m $(resolve_gemini_profile pro31) -y --prompt"
-      CLI_EFFORT="pro31"; DEFAULT_TIMEOUT=900; RUN_MODE="bg"; OPUS_OVERSIGHT="false" ;;
-    claude)
-      CLI_EFFORT="n/a"; DEFAULT_TIMEOUT=600; RUN_MODE="fg"; OPUS_OVERSIGHT="false" ;;
     # ─── agent-map.json에만 정의된 신규 에이전트 (CLI_TYPE별 기본값) ───
     *)
       case "$CLI_TYPE" in
@@ -924,21 +897,29 @@ TFX_CODEX_TRANSPORT="${TFX_CODEX_TRANSPORT:-auto}"
 # Preflight 캐시 일괄 로드 — CLI/Hub 가용성 + Codex 요금제를 환경변수로 내보냄
 # 하위 프로세스(스킬 포함)가 TFX_CODEX_OK, TFX_GEMINI_OK, TFX_HUB_OK로 즉시 참조 가능
 if [[ -z "${TFX_PREFLIGHT_LOADED:-}" ]]; then
-  eval "$(node -e '
-    try {
-      const c = JSON.parse(require("fs").readFileSync(require("path").join(require("os").homedir(),".claude","cache","tfx-preflight.json"),"utf8"));
-      const lines = [];
-      lines.push("export TFX_CODEX_OK=" + (c?.codex?.ok ? "1" : "0"));
-      lines.push("export TFX_GEMINI_OK=" + (c?.gemini?.ok ? "1" : "0"));
-      lines.push("export TFX_HUB_OK=" + (c?.hub?.ok ? "1" : "0"));
-      const p = c?.codex_plan?.plan;
-      if (p && p !== "unknown" && p !== "api") lines.push("export TFX_CODEX_PLAN=" + p);
-      const agents = c?.available_agents;
-      if (Array.isArray(agents)) lines.push("export TFX_AVAILABLE_AGENTS=" + agents.join(","));
-      lines.push("export TFX_PREFLIGHT_LOADED=1");
-      process.stdout.write(lines.join("\n") + "\n");
-    } catch { process.stdout.write("export TFX_PREFLIGHT_LOADED=1\n"); }
-  ' 2>/dev/null)"
+  # eval 제거 — pipe-delimited read로 인젝션 위험 차단
+  IFS='|' read -r _pf_codex _pf_gemini _pf_hub _pf_plan _pf_agents < <(
+    "$NODE_BIN" -e '
+      try {
+        const c = JSON.parse(require("fs").readFileSync(require("path").join(require("os").homedir(),".claude","cache","tfx-preflight.json"),"utf8"));
+        const parts = [
+          c?.codex?.ok ? "1" : "0",
+          c?.gemini?.ok ? "1" : "0",
+          c?.hub?.ok ? "1" : "0",
+          (c?.codex_plan?.plan && c.codex_plan.plan !== "unknown" && c.codex_plan.plan !== "api") ? c.codex_plan.plan : "",
+          Array.isArray(c?.available_agents) ? c.available_agents.join(",") : ""
+        ];
+        process.stdout.write(parts.join("|"));
+      } catch { process.stdout.write("0|0|0||"); }
+    ' 2>/dev/null
+  ) || true
+  export TFX_CODEX_OK="${_pf_codex:-0}"
+  export TFX_GEMINI_OK="${_pf_gemini:-0}"
+  export TFX_HUB_OK="${_pf_hub:-0}"
+  [[ -n "${_pf_plan:-}" ]] && export TFX_CODEX_PLAN="$_pf_plan"
+  [[ -n "${_pf_agents:-}" ]] && export TFX_AVAILABLE_AGENTS="$_pf_agents"
+  export TFX_PREFLIGHT_LOADED=1
+  unset _pf_codex _pf_gemini _pf_hub _pf_plan _pf_agents
   TFX_CODEX_PLAN="${TFX_CODEX_PLAN:-pro}"
 fi
 TFX_WORKER_INDEX="${TFX_WORKER_INDEX:-}"
@@ -1027,8 +1008,6 @@ apply_cli_mode() {
             CLI_ARGS="-m $(resolve_gemini_profile pro31) -y --prompt"; CLI_EFFORT="pro31" ;;
           build-fixer|spark)
             CLI_ARGS="-m $(resolve_gemini_profile flash3) -y --prompt"; CLI_EFFORT="flash3"; DEFAULT_TIMEOUT=180 ;;
-          writer)
-            CLI_ARGS="-m $(resolve_gemini_profile flash3) -y --prompt"; CLI_EFFORT="flash3" ;;
           *)
             CLI_ARGS="-m $(resolve_gemini_profile flash3) -y --prompt"; CLI_EFFORT="flash3" ;;
         esac
@@ -1044,16 +1023,14 @@ apply_cli_mode() {
         if command -v "$GEMINI_BIN" &>/dev/null; then
           TFX_CLI_MODE="gemini"; apply_cli_mode; return
         else
-          ORIGINAL_AGENT="${AGENT_TYPE}"; ORIGINAL_CLI_ARGS="$CLI_ARGS"
-          CLI_TYPE="claude-native"; CLI_CMD=""; CLI_ARGS=""
+          ORIGINAL_AGENT="${AGENT_TYPE}"          CLI_TYPE="claude-native"; CLI_CMD=""; CLI_ARGS=""
           echo "[tfx-route] codex/gemini 모두 미설치: $AGENT_TYPE → claude-native fallback" >&2
         fi
       elif [[ "$CLI_TYPE" == "gemini" ]] && ! command -v "$GEMINI_BIN" &>/dev/null; then
         if command -v "$CODEX_BIN" &>/dev/null; then
           TFX_CLI_MODE="codex"; apply_cli_mode; return
         else
-          ORIGINAL_AGENT="${AGENT_TYPE}"; ORIGINAL_CLI_ARGS="$CLI_ARGS"
-          CLI_TYPE="claude-native"; CLI_CMD=""; CLI_ARGS=""
+          ORIGINAL_AGENT="${AGENT_TYPE}"          CLI_TYPE="claude-native"; CLI_CMD=""; CLI_ARGS=""
           echo "[tfx-route] codex/gemini 모두 미설치: $AGENT_TYPE → claude-native fallback" >&2
         fi
       fi ;;
@@ -1067,7 +1044,7 @@ apply_plan_guard() {
 
   if [[ "$CLI_EFFORT" == spark53_* ]]; then
     local codex_base
-  codex_base="$(build_codex_base)"
+    codex_base="$(build_codex_base)"
     CLI_ARGS="exec --profile codex53_high ${codex_base}"
     CLI_EFFORT="codex53_high"
     echo "[tfx-route] TFX_CODEX_PLAN=$TFX_CODEX_PLAN: spark → codex53_high로 다운그레이드 (Pro 전용)" >&2
@@ -1168,34 +1145,12 @@ get_cached_servers() {
 }
 
 resolve_mcp_filter_script() {
-  if [[ -n "$MCP_FILTER_SCRIPT" && -f "$MCP_FILTER_SCRIPT" ]]; then
-    printf '%s\n' "$MCP_FILTER_SCRIPT"
-    return 0
-  fi
-
-  local script_ref script_dir candidate
-  local -a candidates=()
-
-  script_ref="$(normalize_script_path "${BASH_SOURCE[0]}")"
-  if [[ -n "$script_ref" ]]; then
-    script_dir="$(cd "$(dirname "$script_ref")" 2>/dev/null && pwd -P || true)"
-    [[ -n "$script_dir" ]] && candidates+=("$script_dir/lib/mcp-filter.mjs")
-  fi
-
-  candidates+=(
-    "$PWD/scripts/lib/mcp-filter.mjs"
-    "$PWD/lib/mcp-filter.mjs"
-  )
-
-  for candidate in "${candidates[@]}"; do
-    if [[ -f "$candidate" ]]; then
-      MCP_FILTER_SCRIPT="$candidate"
-      printf '%s\n' "$MCP_FILTER_SCRIPT"
-      return 0
-    fi
-  done
-
-  return 1
+  [[ -n "$MCP_FILTER_SCRIPT" && -f "$MCP_FILTER_SCRIPT" ]] && { printf '%s\n' "$MCP_FILTER_SCRIPT"; return 0; }
+  local sd; sd="$(_get_script_dir)"
+  MCP_FILTER_SCRIPT=$(_resolve_script "" \
+    ${sd:+"$sd/lib/mcp-filter.mjs"} \
+    "$PWD/scripts/lib/mcp-filter.mjs" "$PWD/lib/mcp-filter.mjs") || return 1
+  printf '%s\n' "$MCP_FILTER_SCRIPT"
 }
 
 resolve_mcp_policy() {
@@ -1216,9 +1171,8 @@ resolve_mcp_policy() {
     available_servers=""
   fi
   # Codex 0.115+: 미등록 서버에 config override(enabled=true/false 모두)를 보내면
-  # "invalid transport" 에러 발생. 캐시 비어있으면 빈 문자열로 유지하여
-  # mcp-filter가 override를 생성하지 않도록 한다.
-  [[ -z "$available_servers" ]] && available_servers=""
+  # "invalid transport" 에러 발생. 캐시 비어있으면 빈 문자열이 유지되어
+  # mcp-filter가 override를 생성하지 않는다.
 
   local -a cmd=(
     "$NODE_BIN" "$filter_script" shell
@@ -1358,18 +1312,19 @@ heartbeat_monitor() {
   echo "[tfx-heartbeat] pid=$pid terminated" >&2
 }
 
-resolve_worker_runner_script() {
-  if [[ -n "${TFX_ROUTE_WORKER_RUNNER:-}" && -f "$TFX_ROUTE_WORKER_RUNNER" ]]; then
-    printf '%s\n' "$TFX_ROUTE_WORKER_RUNNER"
-    return 0
-  fi
+# _wait_with_heartbeat PID — track + heartbeat + wait + cleanup
+_wait_with_heartbeat() {
+  local wpid="$1" hb_pid ec=0
+  track_worker_pid "$wpid"
+  heartbeat_monitor "$wpid" &
+  hb_pid=$!
+  wait "$wpid" || ec=$?
+  kill "$hb_pid" 2>/dev/null; wait "$hb_pid" 2>/dev/null
+  return "$ec"
+}
 
-  local script_ref script_dir
-  script_ref="$(normalize_script_path "${BASH_SOURCE[0]}")"
-  script_dir="$(cd "$(dirname "$script_ref")" && pwd -P)"
-  local candidate="$script_dir/tfx-route-worker.mjs"
-  [[ -f "$candidate" ]] || return 1
-  printf '%s\n' "$candidate"
+resolve_worker_runner_script() {
+  _resolve_script "${TFX_ROUTE_WORKER_RUNNER:-}" "$(_get_script_dir)/tfx-route-worker.mjs"
 }
 
 run_stream_worker() {
@@ -1378,7 +1333,7 @@ run_stream_worker() {
   local use_tee_flag="$3"
   shift 3
   local exit_code_local=0
-  local worker_pid hb_pid
+  local worker_pid
 
   local runner_script
   if ! runner_script=$(resolve_worker_runner_script); then
@@ -1406,48 +1361,22 @@ run_stream_worker() {
     printf '%s' "$prompt" | "$TIMEOUT_BIN" "$TIMEOUT_SEC" "${worker_cmd[@]}" >"$STDOUT_LOG" 2>"$STDERR_LOG" &
   fi
   worker_pid=$!
-  track_worker_pid "$worker_pid"
-
-  heartbeat_monitor "$worker_pid" &
-  hb_pid=$!
-
-  wait "$worker_pid" || exit_code_local=$?
-  kill "$hb_pid" 2>/dev/null; wait "$hb_pid" 2>/dev/null
+  _wait_with_heartbeat "$worker_pid" || exit_code_local=$?
   return "$exit_code_local"
 }
 
 resolve_codex_mcp_script() {
-  if [[ -n "${TFX_CODEX_MCP_SCRIPT:-}" && -f "$TFX_CODEX_MCP_SCRIPT" ]]; then
-    printf '%s\n' "$TFX_CODEX_MCP_SCRIPT"
-    return 0
-  fi
-
-  local script_ref script_dir
-  script_ref="$(normalize_script_path "${BASH_SOURCE[0]}")"
-  script_dir="$(cd "$(dirname "$script_ref")" && pwd -P)"
-  local candidates=()
-  [[ -n "$TFX_PKG_ROOT" ]] && candidates+=("$TFX_PKG_ROOT/hub/workers/codex-mcp.mjs")
-  candidates+=(
-    "$script_dir/hub/workers/codex-mcp.mjs"
-    "$script_dir/../hub/workers/codex-mcp.mjs"
-  )
-
-  local candidate
-  for candidate in "${candidates[@]}"; do
-    if [[ -f "$candidate" ]]; then
-      printf '%s\n' "$candidate"
-      return 0
-    fi
-  done
-
-  return 1
+  local sd; sd="$(_get_script_dir)"
+  _resolve_script "${TFX_CODEX_MCP_SCRIPT:-}" \
+    ${TFX_PKG_ROOT:+"$TFX_PKG_ROOT/hub/workers/codex-mcp.mjs"} \
+    "$sd/hub/workers/codex-mcp.mjs" "$sd/../hub/workers/codex-mcp.mjs"
 }
 
 run_codex_exec() {
   local prompt="$1"
   local use_tee_flag="$2"
   local exit_code_local=0
-  local worker_pid hb_pid
+  local worker_pid
   local -a codex_args=()
   read -r -a codex_args <<< "$CLI_ARGS"
   if [[ ${#CODEX_CONFIG_FLAGS[@]} -gt 0 ]]; then
@@ -1460,13 +1389,7 @@ run_codex_exec() {
     "$TIMEOUT_BIN" "$TIMEOUT_SEC" "$CLI_CMD" "${codex_args[@]}" "$prompt" < /dev/null >"$STDOUT_LOG" 2>"$STDERR_LOG" &
   fi
   worker_pid=$!
-  track_worker_pid "$worker_pid"
-
-  heartbeat_monitor "$worker_pid" &
-  hb_pid=$!
-
-  wait "$worker_pid" || exit_code_local=$?
-  kill "$hb_pid" 2>/dev/null; wait "$hb_pid" 2>/dev/null
+  _wait_with_heartbeat "$worker_pid" || exit_code_local=$?
 
   if [[ ! -s "$STDOUT_LOG" && -s "$STDERR_LOG" ]]; then
     # stderr에서 마지막 "codex" 마커 이후의 텍스트를 stdout으로 복구
@@ -1498,17 +1421,16 @@ run_codex_exec() {
 run_codex_mcp() {
   local prompt="$1"
   local use_tee_flag="$2"
-  local mcp_script node_bin
+  local mcp_script
   local exit_code_local=0
-  local worker_pid hb_pid
+  local worker_pid
 
   if ! mcp_script=$(resolve_codex_mcp_script); then
     echo "[tfx-route] 경고: Codex MCP 래퍼를 찾지 못했습니다." >&2
     return "$CODEX_MCP_TRANSPORT_EXIT_CODE"
   fi
 
-  node_bin="${NODE_BIN:-$(command -v node 2>/dev/null || echo node)}"
-  if ! command -v "$node_bin" &>/dev/null; then
+  if ! command -v "$NODE_BIN" &>/dev/null; then
     echo "[tfx-route] 경고: node를 찾지 못해 Codex MCP 경로를 사용할 수 없습니다." >&2
     return "$CODEX_MCP_TRANSPORT_EXIT_CODE"
   fi
@@ -1550,18 +1472,12 @@ run_codex_mcp() {
   esac
 
   if [[ "$use_tee_flag" == "true" ]]; then
-    "$TIMEOUT_BIN" "$TIMEOUT_SEC" "$node_bin" "${mcp_args[@]}" 2>"$STDERR_LOG" | tee "$STDOUT_LOG" &
+    "$TIMEOUT_BIN" "$TIMEOUT_SEC" "$NODE_BIN" "${mcp_args[@]}" 2>"$STDERR_LOG" | tee "$STDOUT_LOG" &
   else
-    "$TIMEOUT_BIN" "$TIMEOUT_SEC" "$node_bin" "${mcp_args[@]}" >"$STDOUT_LOG" 2>"$STDERR_LOG" &
+    "$TIMEOUT_BIN" "$TIMEOUT_SEC" "$NODE_BIN" "${mcp_args[@]}" >"$STDOUT_LOG" 2>"$STDERR_LOG" &
   fi
   worker_pid=$!
-  track_worker_pid "$worker_pid"
-
-  heartbeat_monitor "$worker_pid" &
-  hb_pid=$!
-
-  wait "$worker_pid" || exit_code_local=$?
-  kill "$hb_pid" 2>/dev/null; wait "$hb_pid" 2>/dev/null
+  _wait_with_heartbeat "$worker_pid" || exit_code_local=$?
 
   # 모듈 로드 실패(의존성 누락) → MCP transport exit code로 변환하여 fallback 트리거
   if [[ "$exit_code_local" -ne 0 && "$exit_code_local" -ne 124 ]] && grep -q 'ERR_MODULE_NOT_FOUND' "$STDERR_LOG" 2>/dev/null; then
@@ -1760,6 +1676,27 @@ FALLBACK_EOF
       done
     fi
 
+    # ── Gemini extensions (-e) 주입 (issue #64) ──
+    if [[ -n "$TFX_GEMINI_EXTENSIONS" ]]; then
+      local ext
+      IFS="," read -ra _gemini_exts <<< "$TFX_GEMINI_EXTENSIONS"
+      for ext in "${_gemini_exts[@]}"; do
+        ext=$(echo "$ext" | xargs)  # trim whitespace
+        [[ -n "$ext" ]] && gemini_worker_args+=("--extra-arg" "-e" "--extra-arg" "$ext")
+      done
+      echo "[tfx-route] Gemini extensions: ${TFX_GEMINI_EXTENSIONS}" >&2
+    fi
+
+    # ── Gemini 추가 플래그 주입 (issue #64) ──
+    if [[ -n "$TFX_GEMINI_FLAGS" ]]; then
+      local flag
+      read -ra _gemini_flags <<< "$TFX_GEMINI_FLAGS"
+      for flag in "${_gemini_flags[@]}"; do
+        [[ -n "$flag" ]] && gemini_worker_args+=("--extra-arg" "$flag")
+      done
+      echo "[tfx-route] Gemini extra flags: ${TFX_GEMINI_FLAGS}" >&2
+    fi
+
     run_stream_worker "gemini" "$FULL_PROMPT" "$use_tee" "${gemini_worker_args[@]}" || exit_code=$?
     if [[ "$exit_code" -ne 0 && "$exit_code" -ne 124 ]]; then
       echo "[tfx-route] Gemini stream wrapper 실패(exit=${exit_code}). claude-native fallback." >&2

package/scripts/wt-cli.mjs

@@ -0,0 +1,57 @@
+#!/usr/bin/env node
+// wt-cli.mjs — wt-manager CLI wrapper for Claude Code
+// safety-guard가 wt.exe 직접 호출을 차단하므로 이 스크립트를 경유한다.
+import { createWtManager } from "../hub/team/wt-manager.mjs";
+
+const [action, ...rest] = process.argv.slice(2);
+if (!action) {
+  console.error(
+    "Usage: node scripts/wt-cli.mjs <action> [json-opts]\n" +
+      "Actions: create-tab, split-pane, layout, list, close, close-stale, rename",
+  );
+  process.exit(1);
+}
+
+const opts = rest.length ? JSON.parse(rest.join(" ")) : {};
+const wt = createWtManager();
+
+switch (action) {
+  case "create-tab": {
+    const r = await wt.createTab(opts);
+    console.log(JSON.stringify(r));
+    break;
+  }
+  case "split-pane": {
+    await wt.splitPane(opts);
+    console.log(JSON.stringify({ success: true }));
+    break;
+  }
+  case "layout": {
+    const panes = Array.isArray(opts) ? opts : opts.panes;
+    const r = await wt.applySplitLayout(panes);
+    console.log(JSON.stringify(r || { success: true }));
+    break;
+  }
+  case "list": {
+    console.log(JSON.stringify(wt.listTabs()));
+    break;
+  }
+  case "close": {
+    await wt.closeTab(opts.title);
+    console.log(JSON.stringify({ success: true }));
+    break;
+  }
+  case "close-stale": {
+    const closed = await wt.closeStale(opts);
+    console.log(JSON.stringify({ success: true, closed }));
+    break;
+  }
+  case "rename": {
+    const r = wt.renameTab(opts);
+    console.log(JSON.stringify(r));
+    break;
+  }
+  default:
+    console.error(`Unknown action: ${action}`);
+    process.exit(1);
+}

package/skills/tfx-deep-analysis/SKILL.md

@@ -46,13 +46,7 @@ psmux --version 2>/dev/null && \
 IF claude -p (one-shot 모드):
   → Tier 3 즉시 fallback
 
-IF psmux 없음:
-  → Tier 3
-
-IF Hub 미응답:
-  → hub-ensure 자동 재시작 시도: Bash("node ~/.claude/scripts/hub-ensure.mjs")
-  → 재시작 성공(exit 0) → Tier 판정 재시도
-  → 재시작 실패 → Tier 3
+IF psmux 없음 OR Hub 미응답:
   → Tier 3
 
 IF Codex 없음 AND Gemini 없음:

package/skills/tfx-deep-analysis/SKILL.md.tmpl

@@ -53,7 +53,6 @@ IF Hub 미응답:
   → hub-ensure 자동 재시작 시도: Bash("node ~/.claude/scripts/hub-ensure.mjs")
   → 재시작 성공(exit 0) → Tier 판정 재시도
   → 재시작 실패 → Tier 3
-  → Tier 3
 
 IF Codex 없음 AND Gemini 없음:
   → Tier 3