triflux 10.9.5 → 10.9.7

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

@@ -45,6 +45,11 @@ const ConfigSchema = z.object({
 });
 
 const DEFAULT_COOLDOWN_MS = 300_000; // 5 minutes
+const QUOTA_COOLDOWN_MS = {
+  codex: 5 * 60 * 60_000, // 5 hours (단기 쿼터)
+  codex_weekly: 7 * 24 * 60 * 60_000, // 7 days (주간 쿼터)
+  gemini: 24 * 60 * 60_000, // 24 hours
+};
 const TIER_PRIORITY = { pro: 0, plus: 1, unknown: 2, free: 3 };
 const LEASE_TTL_MS = 30 * 60 * 1000; // 30 minutes
 const CIRCUIT_WINDOW_MS = 10 * 60_000; // 10 minutes

package/hub/cli-adapter-base.mjs

@@ -6,6 +6,46 @@ import { existsSync, readFileSync } from "node:fs";
 
 import { IS_WINDOWS, killProcess } from "./platform.mjs";
 
+// ── Quota retry-after 파싱 ──────────────────────────────────────
+
+const FALLBACK_COOLDOWN_MS = { codex: 5 * 3600_000, gemini: 86400_000 };
+
+/**
+ * 에러 텍스트에서 retry-after 시간을 동적 파싱.
+ * "try again at 2026-04-11T10:00:00Z", "retry after 3600 seconds",
+ * "resets in 7 days", "wait 5 hours" 등을 감지.
+ */
+export function parseRetryAfterMs(text, provider) {
+  // 1. ISO timestamp: "try again at 2026-04-11T10:00:00"
+  const isoMatch = text.match(/(?:try again|retry|available|resets?)\s+(?:at|after)\s+(\d{4}-\d{2}-\d{2}T[\d:.]+Z?)/i);
+  if (isoMatch) {
+    const target = new Date(isoMatch[1]).getTime();
+    if (target > Date.now()) return target - Date.now();
+  }
+
+  // 2. Duration: "N seconds/minutes/hours/days"
+  const durMatch = text.match(/(?:retry|wait|resets?|again)\s+(?:in\s+|after\s+)?(\d+)\s*(second|minute|hour|day|week)/i);
+  if (durMatch) {
+    const n = Number(durMatch[1]);
+    const unit = durMatch[2].toLowerCase();
+    const multipliers = { second: 1000, minute: 60_000, hour: 3600_000, day: 86400_000, week: 604800_000 };
+    return n * (multipliers[unit] || 3600_000);
+  }
+
+  // 3. "7 days" / "24 hours" 단독 (context 없이)
+  const standaloneMatch = text.match(/(\d+)\s*(day|hour|week|minute)/i);
+  if (standaloneMatch) {
+    const n = Number(standaloneMatch[1]);
+    const unit = standaloneMatch[2].toLowerCase();
+    const multipliers = { minute: 60_000, hour: 3600_000, day: 86400_000, week: 604800_000 };
+    const parsed = n * (multipliers[unit] || 3600_000);
+    if (parsed >= 3600_000) return parsed; // 1시간 이상만 신뢰
+  }
+
+  // 4. fallback: provider 기본값
+  return FALLBACK_COOLDOWN_MS[provider] || 5 * 3600_000;
+}
+
 // ── Codex CLI compatibility ─────────────────────────────────────
 
 let _cachedVersion = null;
@@ -237,7 +277,14 @@ export async function executeWithCircuitBroker({
     return lastResult;
   }
 
-  brokerMod.broker.release(lease.id, { ok: false });
+  if (lastResult.failureMode === "rate_limited") {
+    const text = `${lastResult.output || ""}\n${lastResult.stderr || ""}`;
+    const coolMs = parseRetryAfterMs(text, provider);
+    brokerMod.broker.markRateLimited(lease.id, coolMs);
+    brokerMod.broker.emit("cooldown", { id: lease.id, provider, coolMs, reason: "quota_exhausted" });
+  } else {
+    brokerMod.broker.release(lease.id, { ok: false });
+  }
   return {
     ...lastResult,
     retried: attempts.length > 1,

package/hub/pipe.mjs

@@ -670,8 +670,12 @@ export function createPipeServer({
         const line = client.buffer.slice(0, newlineIndex).trim();
         client.buffer = client.buffer.slice(newlineIndex + 1);
         if (line) {
-          const frame = safeJsonParse(line);
-          await handleFrame(client, frame);
+          try {
+            const frame = safeJsonParse(line);
+            await handleFrame(client, frame);
+          } catch (err) {
+            pipeLog.error({ clientId: client.id, err: String(err?.message || err) }, "pipe.frame_handler_error");
+          }
         }
         newlineIndex = client.buffer.indexOf("\n");
       }

package/hub/server.mjs

@@ -21,7 +21,7 @@ import {
   ListToolsRequestSchema,
 } from "@modelcontextprotocol/sdk/types.js";
 import { createModuleLogger } from "../scripts/lib/logger.mjs";
-import { reloadBroker } from "./account-broker.mjs";
+import { broker as brokerInstance, reloadBroker } from "./account-broker.mjs";
 import { createAdaptiveEngine } from "./adaptive.mjs";
 import { createAssignCallbackServer } from "./assign-callbacks.mjs";
 import { DelegatorService } from "./delegator/index.mjs";
@@ -708,6 +708,17 @@ export async function startHub({
         return writeJson(res, 200, getQosStatsPayload());
       }
 
+      if (path === "/broker/snapshot" && req.method === "GET") {
+        const snap = brokerInstance?.snapshot() || [];
+        return writeJson(res, 200, { ok: true, accounts: snap, ts: Date.now() });
+      }
+
+      if (path === "/broker/dashboard" && req.method === "GET") {
+        res.writeHead(200, { "Content-Type": "text/html; charset=utf-8" });
+        res.end(renderBrokerDashboard());
+        return;
+      }
+
       if (path === "/broker/reload" && req.method === "POST") {
         const result = reloadBroker();
         if (!result.ok) {
@@ -1499,8 +1510,8 @@ export async function startHub({
             httpServer.closeAllConnections();
             await new Promise((resolveClose) => httpServer.close(resolveClose));
           })().catch((error) => {
-            stopPromise = null;
-            throw error;
+            hubLog.error({ err: String(error?.message || error) }, "hub.stop_error");
+            // stopPromise를 null로 리셋하지 않음 — double-close 방지
           });
 
           return stopPromise;
@@ -1656,6 +1667,71 @@ function cleanupStaleSpawnSessions(log) {
   return killed;
 }
 
+// ── 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}
+.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}
+.card.cooldown{border-left:3px solid #f87171}
+.card.circuit-open{border-left:3px solid #ef4444;opacity:0.7}
+.provider{font-size:11px;text-transform:uppercase;letter-spacing:1px;color:#888}
+.id{font-size:13px;color:#c8c8d0;margin:4px 0}
+.status{font-size:12px;font-weight:600;padding:2px 8px;border-radius:4px;display:inline-block}
+.status.available{background:#064e3b;color:#34d399}
+.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}
+.meta b{color:#999}
+.timer{color:#f87171;font-weight:600}
+.refresh{color:#555;font-size:11px;margin-top:16px}
+</style></head><body>
+<h1>🔑 Account Broker Dashboard</h1>
+<div id="grid" class="grid"></div>
+<p class="refresh">auto-refresh: 10s | <a href="/broker/snapshot" style="color:#666">JSON API</a></p>
+<script>
+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'}
+async function refresh(){
+  try{
+    const r=await fetch('/broker/snapshot');
+    const d=await r.json();
+    if(!d.ok)return;
+    const now=d.ts;
+    const grid=document.getElementById('grid');
+    grid.innerHTML=d.accounts.map(a=>{
+      const cd=a.cooldownUntil>now?a.cooldownUntil-now:0;
+      const rm=a.remainingMs||0;
+      let st='available',sl='Available';
+      if(a.circuitState==='open'){st='circuit-open';sl='Circuit Open'}
+      else if(cd>0){st='cooldown';sl='Cooldown'}
+      else if(a.busy){st='busy';sl='Busy ('+fmt(rm)+')'}
+      return '<div class="card '+st+'">'+
+        '<div class="provider">'+a.provider+' / '+(a.tier||'unknown')+'</div>'+
+        '<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>':'')+
+        '<div class="meta">'+
+        '<b>Sessions:</b> '+a.totalSessions+
+        (a.lastUsedAt?' | <b>Last:</b> '+new Date(a.lastUsedAt).toLocaleTimeString():'')+
+        (a.failureTimestamps?.length?' | <b>Failures:</b> '+a.failureTimestamps.length:'')+
+        (a.circuitState!=='closed'?' | <b>Circuit:</b> '+a.circuitState:'')+
+        '</div></div>'
+    }).join('');
+  }catch(e){console.error('refresh failed',e)}
+}
+refresh();setInterval(refresh,10000);
+</script></body></html>`;
+}
+
 const selfRun = process.argv[1]?.replace(/\\/g, "/").endsWith("hub/server.mjs");
 if (selfRun) {
   const port = parseInt(process.env.TFX_HUB_PORT || "27888", 10);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "triflux",
-  "version": "10.9.5",
+  "version": "10.9.7",
   "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": ["원격에서", "다른 머신에서", "다른 컴퓨터에서"]
+}

package/scripts/headless-guard.mjs

@@ -41,6 +41,16 @@ const MULTI_EXPIRE_MS = 30 * 60 * 1000; // 30분 자동 만료
 const GATE_THRESHOLD = 2; // A: dispatch 전 허용할 Agent 호출 수
 const NUDGE_THRESHOLD = 4; // B: dispatch 후 nudge 트리거 횟수
 
+function isOwnerAlive(pid) {
+  if (!pid || typeof pid !== "number") return false;
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
 function readMultiState() {
   try {
     if (!existsSync(MULTI_STATE_FILE)) return null;
@@ -55,6 +65,15 @@ function readMultiState() {
       }
       return null;
     }
+    // ownerPid 생존 체크 — 소유 세션이 죽었으면 stale (#62)
+    if (state.ownerPid && !isOwnerAlive(state.ownerPid)) {
+      try {
+        unlinkSync(MULTI_STATE_FILE);
+      } catch {
+        /* ignore */
+      }
+      return null;
+    }
     return state;
   } catch {
     return null;

package/scripts/session-stale-cleanup.mjs

@@ -115,9 +115,15 @@ function cleanupOrphanPidFiles() {
   }
 }
 
-function main() {
+export function main() {
   cleanupMultiState();
   cleanupOrphanPidFiles();
 }
 
-main();
+const isDirectRun =
+  process.argv[1] &&
+  import.meta.url.endsWith(
+    process.argv[1].replace(/\\/g, "/").split("/").pop(),
+  );
+
+if (isDirectRun) main();

package/scripts/setup.mjs

@@ -159,6 +159,16 @@ const SYNC_MAP = [
     dst: join(CLAUDE_DIR, "scripts", "hub", "workers", "factory.mjs"),
     label: "hub/workers/factory.mjs",
   },
+  {
+    src: join(PLUGIN_ROOT, "hub", "cli-adapter-base.mjs"),
+    dst: join(CLAUDE_DIR, "scripts", "hub", "cli-adapter-base.mjs"),
+    label: "hub/cli-adapter-base.mjs",
+  },
+  {
+    src: join(PLUGIN_ROOT, "hub", "platform.mjs"),
+    dst: join(CLAUDE_DIR, "scripts", "hub", "platform.mjs"),
+    label: "hub/platform.mjs",
+  },
   ...scanHudFiles(PLUGIN_ROOT, CLAUDE_DIR),
   {
     src: join(PLUGIN_ROOT, "scripts", "notion-read.mjs"),

package/scripts/tfx-route-worker.mjs

@@ -51,7 +51,6 @@ if (!createWorker) {
 function parseArgs(argv) {
   const args = {
     allowedMcpServerNames: [],
-    extraArgs: [],
     mcpConfig: [],
   };
 
@@ -95,10 +94,6 @@ 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;
@@ -207,7 +202,6 @@ 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())