triflux 10.9.9 → 10.9.10

package/.claude-plugin/marketplace.json

@@ -0,0 +1,34 @@
+{
+  "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
+  "name": "triflux",
+  "description": "CLI-first multi-model orchestrator — Codex/Gemini/Claude routing with DAG execution, auto-triage, and cost optimization",
+  "owner": {
+    "name": "tellang"
+  },
+  "plugins": [
+    {
+      "name": "triflux",
+      "description": "Tri-CLI orchestrator for Claude Code. Routes tasks across Claude + Codex + Gemini with consensus intelligence, natural language routing, 42 skills, and cross-model review.",
+      "version": "10.9.6",
+      "author": {
+        "name": "tellang"
+      },
+      "source": {
+        "source": "npm",
+        "package": "triflux"
+      },
+      "category": "productivity",
+      "homepage": "https://github.com/tellang/triflux",
+      "tags": [
+        "multi-model",
+        "codex",
+        "gemini",
+        "cli-routing",
+        "orchestration",
+        "cost-optimization",
+        "dag-execution"
+      ]
+    }
+  ],
+  "version": "10.9.9"
+}

package/.claude-plugin/plugin.json

@@ -0,0 +1,22 @@
+{
+  "name": "triflux",
+  "version": "10.3.4",
+  "description": "CLI-first multi-model orchestrator for Claude Code — route tasks to Codex, Gemini, and Claude",
+  "author": {
+    "name": "tellang"
+  },
+  "repository": "https://github.com/tellang/triflux",
+  "homepage": "https://github.com/tellang/triflux",
+  "license": "MIT",
+  "keywords": [
+    "claude-code",
+    "plugin",
+    "codex",
+    "gemini",
+    "cli-routing",
+    "orchestration",
+    "multi-model"
+  ],
+  "skills": "./skills/",
+  "hooks": "./hooks/hooks.json"
+}

package/config/mcp-registry.json

@@ -0,0 +1,29 @@
+{
+  "$schema": "mcp-registry-schema",
+  "version": 1,
+  "description": "MCP 서버 중앙 레지스트리 — 진실의 원천",
+  "defaults": {
+    "transport": "hub-url",
+    "hub_base": "http://127.0.0.1:27888"
+  },
+  "servers": {
+    "tfx-hub": {
+      "transport": "hub-url",
+      "url": "http://127.0.0.1:27888/mcp",
+      "safe": true,
+      "targets": ["claude", "gemini", "codex"],
+      "description": "triflux Hub MCP 서버"
+    }
+  },
+  "policies": {
+    "stdio_action": "replace-with-hub",
+    "unknown_server_action": "warn",
+    "watched_paths": [
+      "~/.gemini/settings.json",
+      "~/.codex/config.toml",
+      "~/.claude/settings.json",
+      "~/.claude/settings.local.json",
+      ".mcp.json"
+    ]
+  }
+}

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/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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "triflux",
-  "version": "10.9.9",
+  "version": "10.9.10",
   "description": "CLI-first multi-model orchestrator for Claude Code — route tasks to Codex, Gemini, and Claude",
   "type": "module",
   "bin": {
@@ -13,26 +13,69 @@
     "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",
-    "references",
-    "CLAUDE.md",
+    ".claude-plugin",
     "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",
@@ -43,13 +86,5 @@
     "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/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())