triflux 10.9.10 → 10.9.11

package/CLAUDE.md

@@ -0,0 +1,212 @@
+<!-- prompt-hygiene:ignore line_count_warning -->
+# triflux — Claude Code 운영 가이드
+
+<core-systems>
+## 핵심 스킬 시스템 (항상 인지)
+
+이 프로젝트는 3개의 스킬 시스템을 동시에 사용한다. 어떤 작업이든 해당 시스템의 스킬이 있는지 먼저 확인한다.
+
+| 시스템 | 접두사 | 용도 | 스킬 수 |
+|--------|--------|------|---------|
+| **triflux** | `/tfx-*` | CLI 라우팅, 멀티모델 오케스트레이션, 스웜, 원격 실행 | ~40개 |
+| **gstack** | `/` (접두사 없음) | QA, ship, investigate, design, review, checkpoint | ~35개 |
+| **omc** | `/oh-my-claudecode:*` | autopilot, ralph, team, ultrawork, ccg | ~25개 |
+
+스킬을 모르면 자연어 라우팅(아래)으로 자동 매핑된다.
+세션 종료 전 메모리 파일이 3개+ 변경됐으면 `/memory-hygiene` 제안을 검토한다.
+</core-systems>
+
+<psmux-wt>
+## psmux/WT 규칙
+
+psmux 세션·WT 패인을 생성/조작/정리할 때 `tfx-psmux-rules` 스킬을 참조한다.
+WT 프리징 방지: exit → sleep 2 → kill 순서. 바로 kill하지 않는다.
+
+### wt.exe → wt-manager 경유
+
+safety-guard가 `wt.exe`, `wt new-tab`, `wt split-pane`, `Start-Process wt`를 차단한다.
+`hub/team/wt-manager.mjs`의 API를 사용한다.
+
+| 용도 | API |
+|------|-----|
+| 새 탭 | `createTab({ title, command, profile, cwd })` |
+| 패인 분할 | `splitPane({ direction: 'H'\|'V', title, command })` |
+| 다중 배치 | `applySplitLayout([{ title, command, direction }])` |
+| 탭 정리 | `closeTab(title)` / `closeStale({ olderThanMs, titlePattern })` |
+
+차단과 대안은 항상 쌍으로 존재해야 한다. 차단만 추가하고 대안을 안 만들면 데드락.
+
+### psmux에서 Codex 실행
+
+| 방식 | 동작 | 이유 |
+|------|------|------|
+| `codex` (interactive) | 불가 | psmux에서 TTY를 못 잡음 |
+| `codex < prompt.md` | 불가 | "stdin is not a terminal" |
+| `codex exec "$(cat prompt.md)" -s danger-full-access --dangerously-bypass-approvals-and-sandbox` | 사용 | 유일한 안전 경로 |
+
+`codex exec`는 config.toml `approval_mode`를 무시하므로 `--dangerously-bypass-approvals-and-sandbox` 필수.
+`-s` 유효값: read-only, workspace-write, danger-full-access.
+</psmux-wt>
+
+<codex-config>
+## Codex config.toml
+
+config.toml에 이미 설정된 값은 CLI 플래그로 중복 지정하지 않는다.
+
+| config.toml에 있으면 | CLI에서 생략 |
+|---------------------|-------------|
+| `sandbox = "elevated"` | `--full-auto` |
+| `approval_mode = "full-auto"` | `--full-auto` |
+
+안전 패턴: config.toml에 기본값을 두고, CLI에서는 `--profile` 선택만 한다.
+</codex-config>
+
+<account-broker>
+## AccountBroker (계정 브로커)
+
+conductor, headless, swarm-hypervisor가 하나의 AccountBroker 싱글턴을 공유한다.
+
+| 항목 | 설명 |
+|------|------|
+| 계정별 CircuitBreaker | 장애 격리 — 한 계정 오류가 다른 계정에 전파되지 않음 |
+| busy 플래그 | 동일 계정 이중 임대(double-lease) 방지 |
+| `/broker/reload` | 장시간 세션 중 accounts.json 핫리로드 |
+| EventEmitter 이벤트 | `lease`, `release`, `cooldown`, `tierFallback`, `circuitOpen`, `circuitClose`, `noAvailableAccounts` — HUD 연동용 |
+</account-broker>
+
+<remote>
+## 원격 실행
+
+### 스킬 구분
+
+| 스킬 | 대상 | 방식 |
+|------|------|------|
+| tfx-codex-swarm | 로컬 전용 | 로컬 worktree + psmux |
+| tfx-remote-spawn | Claude Code 원격 | SSH → Claude Code 세션 → 내부 tfx 라우팅 |
+
+codex를 SSH 너머로 직접 실행하지 않는다. config.toml 충돌 + TTY 문제.
+원격에서 codex가 필요하면: remote-spawn → Claude Code → Claude가 내부에서 codex 호출.
+
+### SSH 패턴
+
+hosts.json `os` 필드로 대상 셸을 판단한다. safety-guard도 이 필드를 참조.
+
+| 대상 OS | 셸 | 패턴 |
+|---------|-----|------|
+| windows | PowerShell | scp + `pwsh -File` 필수. `$var` → `$env:VAR`, `2>/dev/null` → `2>$null` |
+| darwin | zsh | 인라인 가능. brew PATH 주의 (`/opt/homebrew/bin`) |
+| linux | bash | 인라인 가능. 표준 POSIX |
+
+- `~` → `$HOME` 변환은 모든 OS 공통
+</remote>
+
+<headless-retrieval>
+## Headless 결과 회수
+
+background로 실행한 headless 결과는 **반드시 task-notification 완료 후** 읽는다.
+
+| 패턴 | 올바름 | 이유 |
+|------|--------|------|
+| task-notification 후 output 파일 읽기 | YES | 프로세스 종료 = 워커 전부 완료 |
+| task-notification 전 output 파일 tail | NO | 시작 메시지만 보이고 "실패"로 오진 |
+| psmux capture-pane으로 중간 체크 | NO | 워커 진행 중이면 빈 화면일 수 있음 |
+
+완료 마커: `=== HEADLESS_COMPLETE succeeded=N failed=N total=N ===`
+워커 상세: `$TMPDIR/tfx-headless/{sessionName}-worker-N.txt`
+</headless-retrieval>
+
+<cross-review>
+## 교차 검증
+
+- Claude 작성 코드 → Codex 리뷰
+- Codex 작성 코드 → Claude 리뷰
+- 동일 모델 self-approve 하지 않는다
+- git commit 전 미검증 파일 감지 시 nudge
+</cross-review>
+
+<session-context>
+## 맥락 이탈 판단
+
+현재 세션 맥락과 무관한 요청이 감지되면 psmux 격리를 제안한다.
+
+| 확신도 | 신호 | 행동 |
+|--------|------|------|
+| 확실 | "새 탭", "별도로", "새 세션" | 바로 psmux spawn |
+| 높음 | 다른 프로젝트/스택 언급 | 분리 제안 |
+| 중간 | 작업 유형 전환 | 분리 제안 + 현재 세션 옵션 |
+| 낮음 | 현재 작업 연장 | 세션 유지 |
+</session-context>
+
+<routing>
+## 자연어 → 스킬 라우팅
+
+사용자가 스킬명을 모르더라도 자연어로 요청하면 아래 규칙에 따라 적절한 스킬을 호출한다.
+
+### 행동 유형 → 스킬 매핑
+
+| 의도 | 자연어 신호 | 스킬 |
+|------|-----------|------|
+| 구현/수정 | 만들어, 고쳐, 구현해, 짜줘, 수정해, 바꿔 | tfx-auto |
+| 리뷰 | 봐줘, 리뷰해, 검토해, 괜찮아? | tfx-review |
+| 분석 | 분석해, 어떻게 돌아가?, 구조가 뭐야 | tfx-analysis |
+| 계획 | 계획, 어떻게 하지, 설계해 | tfx-plan |
+| 검색 | 찾아, 어디있어, 파일 찾아 | tfx-find |
+| 리서치 (빠른) | 검색해줘, 찾아봐, 공식문서, 이거 뭐야 | tfx-research |
+| 리서치 (자율) | 자율 리서치, 검색하고 정리해, research and plan | tfx-autoresearch |
+| 테스트 | 테스트, 검증, 돌려봐, QA | tfx-qa |
+| 정리 | 정리해, 슬롭 제거, 클린업 | tfx-prune |
+| 토론 | 뭐가 나을까, 비교해, A vs B | tfx-debate |
+
+### 깊이 수정자
+
+| 수정자 | 신호 | 효과 |
+|--------|------|------|
+| 기본 | (없음), 빠르게, 간단히 | Light 스킬 |
+| 깊이 | 제대로, 꼼꼼히, 철저히 | Deep 스킬 (tfx-deep-*). 예외: tfx-deep-interview는 Gemini 단독 |
+| 합의 | 3자, 교차, 다각도 | consensus 프로토콜 |
+| 반복 | 끝까지, 멈추지마, ralph | persist 모드 |
+| 자율 | 알아서, 자동으로, autopilot | autopilot 모드 |
+
+### CLI 라우팅
+
+headless-guard가 `codex exec` / `gemini -y -p` 직접 호출을 차단한다. tfx 스킬 경유 필수.
+
+**Layer 1 — Light** (tfx-route.sh → 단일 CLI)
+
+| 스킬 | CLI | 용도 |
+|------|-----|------|
+| tfx-auto | 자동 | 통합 진입점 |
+| tfx-codex | Codex | Codex 전용 |
+| tfx-gemini | Gemini | Gemini 전용 |
+| tfx-autopilot | Codex→검증 | 단일 파일, 5분 이내 |
+| tfx-autoroute | 자동 승격 | 실패→더 강한 모델 |
+
+**Layer 2 — Deep** (headless 3-CLI 합의)
+
+tfx-deep-review, tfx-deep-qa, tfx-deep-plan, tfx-deep-research, tfx-consensus, tfx-debate, tfx-panel, tfx-fullcycle, tfx-persist
+
+**Layer 3 — Remote/병렬**
+
+| 스킬 | 용도 |
+|------|------|
+| tfx-multi | 2+개 태스크 headless 병렬 |
+| tfx-swarm | PRD별 worktree + 다중 모델(Codex/Gemini/Claude) + 다중 기기(로컬+원격) |
+| tfx-remote-spawn | Claude Code 원격 세션 (SSH, setup 필수) |
+
+**Claude 네이티브** (CLI 불필요): tfx-find, tfx-forge, tfx-prune, tfx-index, tfx-setup, tfx-doctor, tfx-hooks, tfx-hub
+
+자원 우선순위: remote-spawn > swarm > multi > Light > 로컬 단독
+
+### 충돌 해소
+
+- ralph = persist alias
+- "auto" 단독 → tfx-auto. "알아서 해" → tfx-autopilot
+- "코드에서 찾아" → tfx-find. "알아봐" → tfx-research
+- 복합 의도: "구현하고 리뷰까지" → tfx-auto → cross-review hook
+
+### Q-Learning 동적 라우팅 (실험적)
+
+- `TRIFLUX_DYNAMIC_ROUTING=true` 또는 `1` 설정 시 Q-Learning 기반 동적 스킬 라우팅 활성화
+- `routing-weights.json` + Q-table로 스킬 선택 최적화
+- 기본 비활성
+</routing>

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/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.10",
+  "version": "10.9.11",
   "description": "CLI-first multi-model orchestrator for Claude Code — route tasks to Codex, Gemini, and Claude",
   "type": "module",
   "bin": {
@@ -13,69 +13,26 @@
     "tfx-doctor-tui": "bin/tfx-doctor-tui.mjs",
     "tfx-setup-tui": "bin/tfx-setup-tui.mjs"
   },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@triflux/core": "10.0.1",
+    "@triflux/remote": "^10.0.0-alpha.1"
+  },
   "files": [
     "bin",
-    "tui",
-    "hub",
-    "config",
     "skills",
-    "!skills/tfx-workspace",
-    "!**/failure-reports",
-    "scripts",
     "hooks",
     "hud",
+    "scripts",
+    "hub",
     "mesh",
-    ".claude-plugin",
+    "references",
+    "CLAUDE.md",
     "README.md",
-    "README.ko.md",
     "LICENSE"
   ],
-  "workspaces": [
-    "packages/core",
-    "packages/remote",
-    "packages/triflux"
-  ],
-  "scripts": {
-    "pack": "node scripts/pack.mjs all",
-    "pack:core": "node scripts/pack.mjs core",
-    "pack:remote": "node scripts/pack.mjs remote",
-    "setup": "node scripts/setup.mjs",
-    "preinstall": "node scripts/preinstall.mjs",
-    "postinstall": "node scripts/setup.mjs",
-    "lint": "biome check .",
-    "lint:fix": "biome check --fix .",
-    "health": "npm test && npm run lint",
-    "test": "node scripts/test-lock.mjs --test --test-force-exit --test-concurrency=8 \"tests/**/*.test.mjs\" \"scripts/__tests__/**/*.test.mjs\"",
-    "test:unit": "node scripts/test-lock.mjs --test --test-force-exit --test-concurrency=8 tests/unit/**/*.test.mjs",
-    "test:integration": "node scripts/test-lock.mjs --test --test-force-exit --test-concurrency=8 tests/integration/**/*.test.mjs",
-    "test:route-smoke": "node scripts/test-lock.mjs --test scripts/test-tfx-route-no-claude-native.mjs",
-    "test:contract": "node scripts/test-lock.mjs --test --test-force-exit --test-concurrency=8 tests/contract/**/*.test.mjs",
-    "test:coverage": "node --experimental-test-coverage --test-coverage-lines=60 --test-coverage-functions=60 --test --test-force-exit --test-concurrency=8 \"tests/**/*.test.mjs\"",
-    "gen:skill-docs": "node scripts/gen-skill-docs.mjs",
-    "gen:skill-manifest": "node scripts/gen-skill-manifest.mjs"
-  },
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/tellang/triflux.git"
-  },
-  "homepage": "https://github.com/tellang/triflux#readme",
-  "author": "tellang",
-  "license": "MIT",
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.27.1",
-    "better-sqlite3": "^12.6.2",
-    "pino": "^10.3.1",
-    "pino-pretty": "^13.1.3",
-    "systray2": "^2.1.4",
-    "zod": "^4.0.0"
-  },
-  "devDependencies": {
-    "@biomejs/biome": "^2.0.0",
-    "knip": "^6.3.0"
-  },
   "keywords": [
     "claude-code",
     "plugin",
@@ -86,5 +43,13 @@
     "multi-model",
     "triflux",
     "tfx"
-  ]
+  ],
+  "author": "tellang",
+  "license": "MIT",
+  "homepage": "https://github.com/tellang/triflux#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tellang/triflux.git",
+    "directory": "packages/triflux"
+  }
 }

package/references/hosts.json

@@ -0,0 +1,46 @@
+{
+  "hosts": {
+    "ultra4": {
+      "description": "Windows 데스크탑 (22코어/64GB RAM)",
+      "aliases": ["울트라", "울트라4", "데스크탑"],
+      "default_dir": "~/Desktop/Projects/cli/triflux",
+      "tailscale": {
+        "ip": "100.110.136.64",
+        "dns": "ultra-book-4-1",
+        "ssh_mode": "ssh-over-vpn"
+      },
+      "ssh_user": "SSAFY",
+      "os": "windows",
+      "specs": {
+        "cores": 22,
+        "ram_gb": 64,
+        "codex": "0.118.0",
+        "node": "24.14.0"
+      },
+      "capabilities": ["codex", "claude", "high-memory"]
+    },
+    "m2": {
+      "description": "MacBook Air M2 (8코어/16GB RAM)",
+      "aliases": ["맥", "맥북", "m2"],
+      "default_dir": "~/Desktop/Projects/triflux",
+      "tailscale": {
+        "ip": "100.104.61.126",
+        "dns": "tellang의-macbook-air",
+        "ssh_mode": "ssh-over-vpn"
+      },
+      "ssh_user": "tellang",
+      "os": "darwin",
+      "specs": {
+        "cores": 8,
+        "ram_gb": 16,
+        "claude": "2.1.89",
+        "codex": "0.114.0",
+        "gemini": "0.33.1",
+        "node": "25.9.0"
+      },
+      "capabilities": ["codex", "claude", "gemini"]
+    }
+  },
+  "default_host": "m2",
+  "triggers": ["원격에서", "다른 머신에서", "다른 컴퓨터에서"]
+}