triflux 4.2.3 → 4.2.5

package/bin/triflux.mjs

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 // triflux CLI — setup, doctor, version
 import { copyFileSync, existsSync, readFileSync, writeFileSync, mkdirSync, chmodSync, readdirSync, unlinkSync, rmSync, statSync, openSync, closeSync } from "fs";
 import { join, dirname } from "path";
@@ -1045,13 +1045,7 @@ async function cmdDoctor(options = {}) {
       shells: codexCli.shells,
       ...(codexCli.fix ? { fix: codexCli.fix } : {}),
     });
-    if (which("codex")) {
-      if (process.env.OPENAI_API_KEY) {
-        ok("OPENAI_API_KEY 설정됨");
-      } else {
-        warn(`OPENAI_API_KEY 미설정 ${GRAY}(Pro 구독이면 불필요)${RESET}`);
-      }
-    }
+    // API 키 검사 제거 — bash exec 기반이므로 API 키 불필요
 
     // 4. Codex Profiles
     section("Codex Profiles");
@@ -1090,13 +1084,7 @@ async function cmdDoctor(options = {}) {
       shells: geminiCli.shells,
       ...(geminiCli.fix ? { fix: geminiCli.fix } : {}),
     });
-    if (which("gemini")) {
-      if (process.env.GEMINI_API_KEY) {
-        ok("GEMINI_API_KEY 설정됨");
-      } else {
-        warn(`GEMINI_API_KEY 미설정 ${GRAY}(gemini auth login)${RESET}`);
-      }
-    }
+    // API 키 검사 제거 — bash exec 기반이므로 API 키 불필요
 
     // 6. Claude Code
     section(`Claude Code ${AMBER}●${RESET}`);

package/hub/server.mjs

@@ -718,7 +718,7 @@ export async function startHub({ port = 27888, dbPath, host = '127.0.0.1', sessi
   await pipe.start();
   await assignCallbacks.start();
 
-  return new Promise((resolve, reject) => {
+  return new Promise((resolveHub, reject) => {
     httpServer.listen(port, host, () => {
       const info = {
         port,
@@ -763,10 +763,11 @@ export async function startHub({ port = 27888, dbPath, host = '127.0.0.1', sessi
         store.close();
         try { unlinkSync(PID_FILE); } catch {}
         try { unlinkSync(TOKEN_FILE); } catch {}
+        httpServer.closeAllConnections();
         await new Promise((resolveClose) => httpServer.close(resolveClose));
       };
 
-      resolve({
+      resolveHub({
         ...info,
         httpServer,
         store,

package/hub/team/native.mjs

@@ -10,12 +10,12 @@ import * as fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
 
-const ROUTE_SCRIPT = "~/.claude/scripts/tfx-route.sh";
-export const SLIM_WRAPPER_SUBAGENT_TYPE = "slim-wrapper";
-const ROUTE_LOG_RE = /\[tfx-route\]/i;
-const ROUTE_COMMAND_RE = /(?:^|[\s"'`])(?:bash\s+)?(?:[^"'`\s]*\/)?tfx-route\.sh\b/i;
-const ROUTE_PROMPT_RE = /tfx-route\.sh/i;
-const DIRECT_TOOL_BYPASS_RE = /\b(?:Read|Edit|Write)\s*\(/;
+const ROUTE_SCRIPT = "~/.claude/scripts/tfx-route.sh";
+export const SLIM_WRAPPER_SUBAGENT_TYPE = "slim-wrapper";
+const ROUTE_LOG_RE = /\[tfx-route\]/i;
+const ROUTE_COMMAND_RE = /(?:^|[\s"'`])(?:bash\s+)?(?:[^"'`\s]*\/)?tfx-route\.sh\b/i;
+const ROUTE_PROMPT_RE = /tfx-route\.sh/i;
+const DIRECT_TOOL_BYPASS_RE = /\b(?:Read|Edit|Write)\s*\(/;
 
 function inferWorkerIndex(agentName = "") {
   const match = /(\d+)(?!.*\d)/.exec(agentName);
@@ -60,46 +60,46 @@ export function buildSlimWrapperAgent(cli, opts = {}) {
  * @param {string} [input.promptText]
  * @param {string} [input.stdoutText]
  * @param {string} [input.stderrText]
- * @returns {{
- *   expectedRouteInvocation: boolean,
- *   promptMentionsRoute: boolean,
- *   sawRouteCommand: boolean,
- *   sawRouteLog: boolean,
- *   sawDirectToolBypass: boolean,
- *   usedRoute: boolean,
- *   abnormal: boolean,
- *   reason: string|null,
- * }}
- */
-export function verifySlimWrapperRouteExecution(input = {}) {
+ * @returns {{
+ *   expectedRouteInvocation: boolean,
+ *   promptMentionsRoute: boolean,
+ *   sawRouteCommand: boolean,
+ *   sawRouteLog: boolean,
+ *   sawDirectToolBypass: boolean,
+ *   usedRoute: boolean,
+ *   abnormal: boolean,
+ *   reason: string|null,
+ * }}
+ */
+export function verifySlimWrapperRouteExecution(input = {}) {
   const promptText = String(input.promptText || "");
   const stdoutText = String(input.stdoutText || "");
   const stderrText = String(input.stderrText || "");
-  const combinedLogs = `${stdoutText}\n${stderrText}`;
-  const promptMentionsRoute = ROUTE_PROMPT_RE.test(promptText);
-  const sawRouteCommand = ROUTE_COMMAND_RE.test(combinedLogs);
-  const sawRouteLog = ROUTE_LOG_RE.test(combinedLogs);
-  const sawDirectToolBypass = DIRECT_TOOL_BYPASS_RE.test(stdoutText);
-  const usedRoute = sawRouteCommand || sawRouteLog;
-  const expectedRouteInvocation = promptMentionsRoute;
-  const abnormal = expectedRouteInvocation && (sawDirectToolBypass || !usedRoute);
-  const reason = !abnormal
-    ? null
-    : sawDirectToolBypass
-      ? "direct_tool_bypass_detected"
-      : "missing_tfx_route_evidence";
-
-  return {
-    expectedRouteInvocation,
-    promptMentionsRoute,
-    sawRouteCommand,
-    sawRouteLog,
-    sawDirectToolBypass,
-    usedRoute,
-    abnormal,
-    reason,
-  };
-}
+  const combinedLogs = `${stdoutText}\n${stderrText}`;
+  const promptMentionsRoute = ROUTE_PROMPT_RE.test(promptText);
+  const sawRouteCommand = ROUTE_COMMAND_RE.test(combinedLogs);
+  const sawRouteLog = ROUTE_LOG_RE.test(combinedLogs);
+  const sawDirectToolBypass = DIRECT_TOOL_BYPASS_RE.test(stdoutText);
+  const usedRoute = sawRouteCommand || sawRouteLog;
+  const expectedRouteInvocation = promptMentionsRoute;
+  const abnormal = expectedRouteInvocation && (sawDirectToolBypass || !usedRoute);
+  const reason = !abnormal
+    ? null
+    : sawDirectToolBypass
+      ? "direct_tool_bypass_detected"
+      : "missing_tfx_route_evidence";
+
+  return {
+    expectedRouteInvocation,
+    promptMentionsRoute,
+    sawRouteCommand,
+    sawRouteLog,
+    sawDirectToolBypass,
+    usedRoute,
+    abnormal,
+    reason,
+  };
+}
 
 /**
  * role/mcp_profile별 tfx-route.sh 기본 timeout (초)
@@ -108,10 +108,21 @@ export function verifySlimWrapperRouteExecution(input = {}) {
  * @param {string} mcpProfile — MCP 프로필
  * @returns {number} timeout(초)
  */
-function getRouteTimeout(role, mcpProfile) {
-  if (mcpProfile === "analyze" || mcpProfile === "review") return 3600;
-  if (role === "architect" || role === "analyst") return 3600;
-  return 1080; // 기본 18분
+function getRouteTimeout(role, _mcpProfile) {
+  // tfx-route.sh route_agent()의 DEFAULT_TIMEOUT 기반, 최소 1080초(18분) 보장.
+  // Bash timeout = 이 값 + 60초 여유. 짧은 역할도 네트워크/스케줄 지연 대비.
+  const TIMEOUTS = {
+    'build-fixer': 1080, debugger: 1080, executor: 1080,
+    'deep-executor': 3600, architect: 3600, planner: 3600,
+    critic: 3600, analyst: 3600, scientist: 1800,
+    'scientist-deep': 3600, 'document-specialist': 1800,
+    'code-reviewer': 1800, 'security-reviewer': 1800,
+    'quality-reviewer': 1800, verifier: 1800,
+    designer: 1080, writer: 1080,
+    explore: 1080, 'test-engineer': 1080, 'qa-tester': 1080,
+    spark: 600,
+  };
+  return TIMEOUTS[role] || 1080;
 }
 
 /**

package/hub/workers/delegator-mcp.mjs

@@ -6,7 +6,7 @@ import { randomUUID } from 'node:crypto';
 import { existsSync, readFileSync } from 'node:fs';
 import { dirname, isAbsolute, resolve } from 'node:path';
 import process from 'node:process';
-import { fileURLToPath } from 'node:url';
+import { fileURLToPath, pathToFileURL } from 'node:url';
 
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
@@ -14,15 +14,25 @@ import * as z from 'zod';
 
 import { CodexMcpWorker } from './codex-mcp.mjs';
 import { GeminiWorker } from './gemini-worker.mjs';
-import {
+
+const SCRIPT_DIR = dirname(fileURLToPath(import.meta.url));
+
+// mcp-filter.mjs 동적 해석 — 프로젝트(hub/workers/)와 배포(scripts/hub/workers/) 양쪽 대응
+const MCP_FILTER_CANDIDATES = [
+  resolve(SCRIPT_DIR, '../../scripts/lib/mcp-filter.mjs'), // 프로젝트 원본
+  resolve(SCRIPT_DIR, '../../lib/mcp-filter.mjs'),         // 배포 (~/.claude/scripts/)
+];
+const mcpFilterPath = MCP_FILTER_CANDIDATES.find((p) => existsSync(p));
+if (!mcpFilterPath) {
+  throw new Error(`mcp-filter.mjs not found. candidates: ${MCP_FILTER_CANDIDATES.join(', ')}`);
+}
+const {
   buildPromptHint,
   getCodexMcpConfig,
   getGeminiAllowedServers,
   resolveMcpProfile,
   SUPPORTED_MCP_PROFILES,
-} from '../../scripts/lib/mcp-filter.mjs';
-
-const SCRIPT_DIR = dirname(fileURLToPath(import.meta.url));
+} = await import(pathToFileURL(mcpFilterPath).href);
 const SERVER_INFO = { name: 'triflux-delegator', version: '1.0.0' };
 const DEFAULT_CONTEXT_BYTES = 32 * 1024;
 const DEFAULT_ROUTE_TIMEOUT_SEC = 120;
@@ -70,6 +80,8 @@ const CODEX_PROFILE_BY_AGENT = Object.freeze({
   'scientist-deep': 'thorough',
   'document-specialist': 'high',
   verifier: 'thorough',
+  designer: 'high',  // Gemini primary, codex fallback용
+  writer: 'high',    // Gemini primary, codex fallback용
   spark: 'spark_fast',
 });
 

package/package.json

@@ -1,62 +1,62 @@
-{
-  "name": "triflux",
-  "version": "4.2.3",
-  "description": "CLI-first multi-model orchestrator for Claude Code — route tasks to Codex, Gemini, and Claude",
-  "type": "module",
-  "bin": {
-    "triflux": "bin/triflux.mjs",
-    "tfx": "bin/triflux.mjs",
-    "tfl": "bin/triflux.mjs",
-    "tfx-setup": "bin/tfx-setup.mjs",
-    "tfx-doctor": "bin/tfx-doctor.mjs"
-  },
-  "files": [
-    "bin",
-    "hub",
-    "skills",
-    "!**/failure-reports",
-    "scripts",
-    "hooks",
-    "hud",
-    ".claude-plugin",
-    ".mcp.json",
-    "README.md",
-    "README.ko.md",
-    "LICENSE"
-  ],
-  "scripts": {
-    "setup": "node scripts/setup.mjs",
-    "preinstall": "node scripts/preinstall.mjs",
-    "postinstall": "node scripts/setup.mjs",
-    "test": "node --test --test-force-exit --test-concurrency=1 \"tests/**/*.test.mjs\" \"scripts/__tests__/**/*.test.mjs\"",
-    "test:unit": "node --test --test-force-exit --test-concurrency=1 tests/unit/**/*.test.mjs",
-    "test:integration": "node --test --test-force-exit --test-concurrency=1 tests/integration/**/*.test.mjs",
-    "test:route-smoke": "node --test scripts/test-tfx-route-no-claude-native.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",
-    "systray2": "^2.1.4"
-  },
-  "keywords": [
-    "claude-code",
-    "plugin",
-    "codex",
-    "gemini",
-    "cli-routing",
-    "orchestration",
-    "multi-model",
-    "triflux",
-    "tfx"
-  ]
-}
+{
+  "name": "triflux",
+  "version": "4.2.5",
+  "description": "CLI-first multi-model orchestrator for Claude Code — route tasks to Codex, Gemini, and Claude",
+  "type": "module",
+  "bin": {
+    "triflux": "bin/triflux.mjs",
+    "tfx": "bin/triflux.mjs",
+    "tfl": "bin/triflux.mjs",
+    "tfx-setup": "bin/tfx-setup.mjs",
+    "tfx-doctor": "bin/tfx-doctor.mjs"
+  },
+  "files": [
+    "bin",
+    "hub",
+    "skills",
+    "!**/failure-reports",
+    "scripts",
+    "hooks",
+    "hud",
+    ".claude-plugin",
+    ".mcp.json",
+    "README.md",
+    "README.ko.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "setup": "node scripts/setup.mjs",
+    "preinstall": "node scripts/preinstall.mjs",
+    "postinstall": "node scripts/setup.mjs",
+    "test": "node --test --test-force-exit --test-concurrency=1 \"tests/**/*.test.mjs\" \"scripts/__tests__/**/*.test.mjs\"",
+    "test:unit": "node --test --test-force-exit --test-concurrency=1 tests/unit/**/*.test.mjs",
+    "test:integration": "node --test --test-force-exit --test-concurrency=1 tests/integration/**/*.test.mjs",
+    "test:route-smoke": "node --test scripts/test-tfx-route-no-claude-native.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",
+    "systray2": "^2.1.4"
+  },
+  "keywords": [
+    "claude-code",
+    "plugin",
+    "codex",
+    "gemini",
+    "cli-routing",
+    "orchestration",
+    "multi-model",
+    "triflux",
+    "tfx"
+  ]
+}

package/scripts/lib/mcp-filter.mjs

@@ -71,8 +71,21 @@ const PROFILE_DEFINITIONS = Object.freeze({
       ]),
     }),
   }),
+  analyze: Object.freeze({
+    description: '분석/설계 워커용. 추론 + 검색 MCP 허용',
+    allowedServers: Object.freeze(['context7', 'brave-search', 'tavily', 'exa', 'sequential-thinking']),
+    alwaysOnServers: Object.freeze(['context7', 'sequential-thinking']),
+    maxSearchServers: 2,
+    allowedToolsByServer: Object.freeze({
+      context7: Object.freeze(['resolve-library-id', 'query-docs']),
+      'brave-search': Object.freeze(['brave_web_search', 'brave_news_search']),
+      exa: Object.freeze(['web_search_exa', 'get_code_context_exa']),
+      tavily: Object.freeze(['tavily_search', 'tavily_extract']),
+      'sequential-thinking': Object.freeze(['sequentialthinking']),
+    }),
+  }),
   explore: Object.freeze({
-    description: '탐색 워커용. 읽기/검색 중심 MCP만 허용',
+    description: '탐색/리서치 워커용. 읽기/검색 중심 MCP만 허용',
     allowedServers: Object.freeze(['context7', 'brave-search', 'tavily', 'exa']),
     alwaysOnServers: Object.freeze(['context7']),
     maxSearchServers: 2,
@@ -116,7 +129,7 @@ const PROFILE_DEFINITIONS = Object.freeze({
 
 export const LEGACY_PROFILE_ALIASES = Object.freeze({
   implement: 'executor',
-  analyze: 'explore',
+  analyze: 'analyze',
   review: 'reviewer',
   docs: 'writer',
   minimal: 'default',
@@ -147,15 +160,17 @@ function resolveAutoProfile(agentType = '') {
     case 'build-fixer':
     case 'debugger':
     case 'deep-executor':
+      return 'executor';
     case 'test-engineer':
     case 'qa-tester':
-      return 'executor';
+      return 'none';
     case 'designer':
       return 'designer';
     case 'architect':
     case 'planner':
     case 'critic':
     case 'analyst':
+      return 'analyze';
     case 'scientist':
     case 'scientist-deep':
     case 'document-specialist':
@@ -474,17 +489,28 @@ export function getGeminiAllowedServers(options = {}) {
 export function getCodexMcpConfig(options = {}) {
   const allowedServers = new Set(resolveAllowedServers(options));
   const resolvedProfile = resolveMcpProfile(options.agentType, options.requestedProfile);
+  // Codex에 실제 등록된 서버만 대상으로 config override 생성.
+  // 미등록 서버에 enabled=false를 보내면 "invalid transport" 에러 발생.
+  const registeredServers = parseAvailableServers(options.availableServers);
+  // Codex 0.115+: 미등록 서버에 config override를 보내면 "invalid transport" 에러.
+  // 등록 서버 정보가 없으면 override를 생성하지 않는다 (안전 기본값).
+  if (registeredServers.length === 0) {
+    return { mcp_servers: {} };
+  }
+  const targetServers = registeredServers;
+
   if (resolvedProfile === 'none') {
-    return {
-      mcp_servers: Object.fromEntries(KNOWN_MCP_SERVERS.map((server) => [server, { enabled: false }])),
-    };
+    // Codex 0.115+: transport 없는 서버에 enabled=false를 보내면 "invalid transport" 에러.
+    // 비허용 서버는 override에서 제외하고, 허용 서버만 명시적으로 설정한다.
+    return { mcp_servers: {} };
   }
 
   const config = { mcp_servers: {} };
   const allowedToolsByServer = getProfileDefinition(resolvedProfile).allowedToolsByServer;
-  for (const server of KNOWN_MCP_SERVERS) {
+  for (const server of targetServers) {
+    // Codex 0.115+: transport 없는 서버에 enabled=false를 보내면 "invalid transport" 에러.
+    // 비허용 서버는 override에서 제외한다 (Codex 기본 설정이 유지됨).
     if (!allowedServers.has(server)) {
-      config.mcp_servers[server] = { enabled: false };
       continue;
     }
 

package/scripts/tfx-route.sh

@@ -558,20 +558,23 @@ route_agent() {
       CLI_ARGS="-m gemini-3-flash-preview -y --prompt"
       CLI_EFFORT="flash"; DEFAULT_TIMEOUT=900; RUN_MODE="bg"; OPUS_OVERSIGHT="false" ;;
 
-    # ─── Claude 네이티브 ───
+    # ─── 탐색/검증/테스트 (Codex 우선, claude-native fallback은 apply_cli_mode auto에서) ───
     explore)
-      CLI_TYPE="claude-native"; CLI_CMD=""; CLI_ARGS=""
-      CLI_EFFORT="n/a"; DEFAULT_TIMEOUT=300; RUN_MODE="fg"; OPUS_OVERSIGHT="false" ;;
+      CLI_TYPE="codex"; CLI_CMD="codex"
+      CLI_ARGS="exec --profile fast ${codex_base}"
+      CLI_EFFORT="fast"; DEFAULT_TIMEOUT=600; RUN_MODE="fg"; OPUS_OVERSIGHT="false" ;;
     verifier)
       CLI_TYPE="codex"; CLI_CMD="codex"
       CLI_ARGS="exec --profile thorough ${codex_base} review"
       CLI_EFFORT="thorough"; DEFAULT_TIMEOUT=1200; RUN_MODE="fg"; OPUS_OVERSIGHT="false" ;;
     test-engineer)
-      CLI_TYPE="claude-native"; CLI_CMD=""; CLI_ARGS=""
-      CLI_EFFORT="n/a"; DEFAULT_TIMEOUT=300; RUN_MODE="bg"; OPUS_OVERSIGHT="false" ;;
+      CLI_TYPE="codex"; CLI_CMD="codex"
+      CLI_ARGS="exec ${codex_base}"
+      CLI_EFFORT="high"; DEFAULT_TIMEOUT=1200; RUN_MODE="bg"; OPUS_OVERSIGHT="false" ;;
     qa-tester)
-      CLI_TYPE="claude-native"; CLI_CMD=""; CLI_ARGS=""
-      CLI_EFFORT="n/a"; DEFAULT_TIMEOUT=300; RUN_MODE="bg"; OPUS_OVERSIGHT="false" ;;
+      CLI_TYPE="codex"; CLI_CMD="codex"
+      CLI_ARGS="exec --profile thorough ${codex_base} review"
+      CLI_EFFORT="thorough"; DEFAULT_TIMEOUT=1200; RUN_MODE="bg"; OPUS_OVERSIGHT="false" ;;
 
     # ─── 경량 ───
     spark)
@@ -849,7 +852,10 @@ resolve_mcp_policy() {
   fi
 
   available_servers=$(get_cached_servers "$CLI_TYPE")
-  [[ -z "$available_servers" ]] && available_servers="context7,brave-search,exa,tavily,playwright,sequential-thinking"
+  # Codex 0.115+: 미등록 서버에 config override(enabled=true/false 모두)를 보내면
+  # "invalid transport" 에러 발생. 캐시 비어있으면 빈 문자열로 유지하여
+  # mcp-filter가 override를 생성하지 않도록 한다.
+  [[ -z "$available_servers" ]] && available_servers=""
 
   local -a cmd=(
     "$NODE_BIN" "$filter_script" shell