triflux 4.1.1 → 4.1.4

package/bin/triflux.mjs

@@ -2392,18 +2392,20 @@ async function main() {
     case "tray": {
       const trayUrl = new URL("../hub/tray.mjs", import.meta.url);
       const trayPath = fileURLToPath(trayUrl);
-      if (cmdArgs.includes("--detach")) {
-        const child = spawn(process.execPath, [trayPath], {
-          detached: true,
-          stdio: "ignore",
-          windowsHide: true,
-        });
-        child.unref();
-        console.log(`\n  ${GREEN_BRIGHT}✓${RESET} tray 시작됨 (PID ${child.pid})\n`);
+      if (cmdArgs.includes("--attach")) {
+        // --attach: 포그라운드 모드 (디버깅용)
+        const { startTray } = await import(trayUrl.href);
+        await startTray();
         return;
       }
-      const { startTray } = await import(trayUrl.href);
-      await startTray();
+      // 기본: detach 모드 (프리징 방지)
+      const child = spawn(process.execPath, [trayPath], {
+        detached: true,
+        stdio: "ignore",
+        windowsHide: true,
+      });
+      child.unref();
+      console.log(`\n  ${GREEN_BRIGHT}✓${RESET} tray 시작됨 (PID ${child.pid})\n`);
       return;
     }
     case "multi": {

package/hub/server.mjs

@@ -230,8 +230,9 @@ function servePublicFile(res, path) {
 
   mkdirSync(PUBLIC_DIR, { recursive: true });
   if (!existsSync(filePath)) {
+    console.warn(`[tfx-hub] 정적 파일 없음: ${filePath}`);
     res.writeHead(404);
-    res.end('Not Found');
+    res.end('Not Found (static file missing)');
     return true;
   }
 
@@ -746,6 +747,7 @@ export async function startHub({ port = 27888, dbPath, host = '127.0.0.1', sessi
       }));
 
       console.log(`[tfx-hub] MCP 서버 시작: ${info.url} / pipe ${pipe.path} / assign-callback ${assignCallbacks.path} (PID ${process.pid})`);
+      console.log(`[tfx-hub] PUBLIC_DIR: ${PUBLIC_DIR} (exists: ${existsSync(PUBLIC_DIR)}, dashboard: ${existsSync(resolve(PUBLIC_DIR, 'dashboard.html'))})`);
 
       const stopFn = async () => {
         router.stopSweeper();

package/hub/team/native.mjs

@@ -10,11 +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 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);
@@ -59,37 +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,
- *   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 usedRoute = sawRouteCommand || sawRouteLog;
-  const expectedRouteInvocation = promptMentionsRoute;
-
-  return {
-    expectedRouteInvocation,
-    promptMentionsRoute,
-    sawRouteCommand,
-    sawRouteLog,
-    usedRoute,
-    abnormal: expectedRouteInvocation && !usedRoute,
-    reason: expectedRouteInvocation && !usedRoute ? "missing_tfx_route_evidence" : null,
-  };
-}
+  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 (초)
@@ -153,7 +163,7 @@ export function buildSlimWrapperPrompt(cli, opts = {}) {
 2. Bash 종료 후 TaskUpdate + SendMessage로 Claude Code 태스크 동기화
 3. 종료${pipelineHint}
 
-[HARD CONSTRAINT] 허용 도구: Bash, TaskUpdate, SendMessage만 사용한다.
+[HARD CONSTRAINT] 허용 도구: Bash, TaskUpdate, TaskGet, TaskList, SendMessage만 사용한다.
 Read, Edit, Write, Grep, Glob, Agent, WebSearch, WebFetch 등 다른 모든 도구 사용을 금지한다.
 코드를 직접 읽거나 수정하면 안 된다. 반드시 아래 Bash 명령(tfx-route.sh)을 통해 Codex/Gemini에 위임하라.
 이 규칙을 위반하면 작업 실패로 간주한다.

package/hud/hud-qos-status.mjs

@@ -19,7 +19,7 @@ const RED = "\x1b[31m";
 const GREEN = "\x1b[32m";
 const YELLOW = "\x1b[33m";
 const CYAN = "\x1b[36m";
-const CLAUDE_ORANGE = "\x1b[38;5;173m"; // #D87656 (Claude 테라코타)
+const CLAUDE_ORANGE = "\x1b[38;2;232;112;64m"; // #E87040 (Claude 공식 오렌지)
 const CODEX_WHITE = "\x1b[97m"; // bright white (SGR 37은 Windows Terminal에서 연회색 매핑)
 const GEMINI_BLUE = "\x1b[38;5;39m";
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "triflux",
-  "version": "4.1.1",
+  "version": "4.1.4",
   "description": "CLI-first multi-model orchestrator for Claude Code — route tasks to Codex, Gemini, and Claude",
   "type": "module",
   "bin": {
@@ -26,6 +26,7 @@
   ],
   "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",

package/scripts/preinstall.mjs

@@ -0,0 +1,37 @@
+#!/usr/bin/env node
+// npm install 전 Hub를 안전하게 중지하여 EBUSY 방지
+// better-sqlite3.node 파일이 Hub 프로세스에 의해 잠기면 npm이 덮어쓸 수 없음
+
+import { existsSync, readFileSync, unlinkSync } from "fs";
+import { join } from "path";
+import { homedir } from "os";
+
+const HUB_PID_FILE = join(homedir(), ".claude", "cache", "tfx-hub", "hub.pid");
+
+function stopHub() {
+  if (!existsSync(HUB_PID_FILE)) return;
+
+  try {
+    const info = JSON.parse(readFileSync(HUB_PID_FILE, "utf8"));
+    const pid = Number(info?.pid);
+    if (!Number.isFinite(pid) || pid <= 0) return;
+
+    // 프로세스 존재 확인
+    process.kill(pid, 0);
+
+    // SIGTERM 전송
+    process.kill(pid, "SIGTERM");
+    console.log(`[triflux preinstall] Hub 중지됨 (PID ${pid}) — EBUSY 방지`);
+
+    // PID 파일 정리
+    try { unlinkSync(HUB_PID_FILE); } catch {}
+  } catch (err) {
+    if (err.code === "ESRCH") {
+      // 프로세스 이미 종료됨 — PID 파일만 정리
+      try { unlinkSync(HUB_PID_FILE); } catch {}
+    }
+    // EPERM 등 기타 에러는 무시 (설치를 막으면 안 됨)
+  }
+}
+
+stopHub();

package/scripts/setup.mjs

@@ -228,6 +228,49 @@ if (!existsSync(mcpSdkPath) && existsSync(srcNodeModules)) {
   }
 }
 
+// ── 패키지 루트 breadcrumb 기록 ──
+// tfx-route.sh가 hub/server.mjs, hub/bridge.mjs를 찾을 수 있도록
+// 패키지 루트 경로를 ~/.claude/scripts/.tfx-pkg-root에 기록한다.
+{
+  const breadcrumbPath = join(CLAUDE_DIR, "scripts", ".tfx-pkg-root");
+  const pkgRootForward = PLUGIN_ROOT.replace(/\\/g, "/");
+  const currentBreadcrumb = existsSync(breadcrumbPath)
+    ? readFileSync(breadcrumbPath, "utf8").trim()
+    : "";
+  if (currentBreadcrumb !== pkgRootForward) {
+    const breadcrumbDir = dirname(breadcrumbPath);
+    if (!existsSync(breadcrumbDir)) mkdirSync(breadcrumbDir, { recursive: true });
+    writeFileSync(breadcrumbPath, pkgRootForward + "\n", "utf8");
+    synced++;
+  }
+}
+
+// ── 에이전트 동기화 (.claude/agents/ → ~/.claude/agents/) ──
+// slim-wrapper 등 커스텀 에이전트를 글로벌에 배포하여
+// 다른 프로젝트에서도 subagent_type으로 참조 가능하게 한다.
+
+const agentsSrc = join(PLUGIN_ROOT, ".claude", "agents");
+const agentsDst = join(CLAUDE_DIR, "agents");
+
+if (existsSync(agentsSrc)) {
+  if (!existsSync(agentsDst)) mkdirSync(agentsDst, { recursive: true });
+
+  for (const name of readdirSync(agentsSrc)) {
+    if (!name.endsWith(".md")) continue;
+
+    const src = join(agentsSrc, name);
+    const dst = join(agentsDst, name);
+
+    if (!existsSync(dst)) {
+      copyFileSync(src, dst);
+      synced++;
+    } else if (shouldSyncTextFile(src, dst)) {
+      copyFileSync(src, dst);
+      synced++;
+    }
+  }
+}
+
 // ── 스킬 동기화 ──
 
 const skillsSrc = join(PLUGIN_ROOT, "skills");

package/scripts/tfx-route.sh

@@ -51,6 +51,14 @@ TFX_TEAM_LEAD_NAME="${TFX_TEAM_LEAD_NAME:-team-lead}"
 TFX_HUB_PIPE="${TFX_HUB_PIPE:-}"
 TFX_HUB_URL="${TFX_HUB_URL:-http://127.0.0.1:27888}"  # bridge.mjs HTTP fallback hint
 
+# ── 패키지 루트 해석 (setup.mjs가 기록한 breadcrumb) ──
+TFX_PKG_ROOT=""
+_tfx_breadcrumb="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/.tfx-pkg-root"
+if [[ -f "$_tfx_breadcrumb" ]]; then
+  TFX_PKG_ROOT="$(head -1 "$_tfx_breadcrumb" 2>/dev/null | tr -d '\r\n')"
+fi
+unset _tfx_breadcrumb
+
 # fallback 시 원래 에이전트 정보 보존
 ORIGINAL_AGENT=""
 ORIGINAL_CLI_ARGS=""
@@ -152,7 +160,9 @@ resolve_bridge_script() {
 
   local script_dir
   script_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-  local candidates=(
+  local candidates=()
+  [[ -n "$TFX_PKG_ROOT" ]] && candidates+=("$TFX_PKG_ROOT/hub/bridge.mjs")
+  candidates+=(
     "$script_dir/../hub/bridge.mjs"
     "$script_dir/hub/bridge.mjs"
   )
@@ -247,10 +257,17 @@ team_send_message() {
 try_restart_hub() {
   local hub_server script_dir hub_port
   script_dir="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-  hub_server="$script_dir/../hub/server.mjs"
+  hub_server=""
+  local _hub_candidates=()
+  [[ -n "$TFX_PKG_ROOT" ]] && _hub_candidates+=("$TFX_PKG_ROOT/hub/server.mjs")
+  _hub_candidates+=("$script_dir/../hub/server.mjs")
+  for _hc in "${_hub_candidates[@]}"; do
+    if [[ -f "$_hc" ]]; then hub_server="$_hc"; break; fi
+  done
+  unset _hub_candidates _hc
 
-  if [[ ! -f "$hub_server" ]]; then
-    echo "[tfx-route] Hub 서버 스크립트 미발견: $hub_server" >&2
+  if [[ -z "$hub_server" ]]; then
+    echo "[tfx-route] Hub 서버 스크립트 미발견 (pkg_root=${TFX_PKG_ROOT:-unset}, script_dir=$script_dir)" >&2
     return 1
   fi
 
@@ -946,7 +963,9 @@ resolve_codex_mcp_script() {
   local script_ref script_dir
   script_ref="$(normalize_script_path "${BASH_SOURCE[0]}")"
   script_dir="$(cd "$(dirname "$script_ref")" && pwd -P)"
-  local candidates=(
+  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"
   )

package/skills/tfx-auto/SKILL.md

@@ -100,6 +100,27 @@ argument-hint: "<command|task> [args...]"
 
 **수동 모드 (`N:agent_type`):** Codex 분류 건너뜀 → Opus가 N개 서브태스크 분해. N > 10 거부.
 
+## 멀티 태스크 라우팅 (트리아지 후)
+
+> **트리아지 결과 서브태스크가 2개 이상이면 tfx-multi Native Teams 모드로 자동 전환한다.**
+
+| 서브태스크 수 | 실행 경로 | 이유 |
+|--------------|----------|------|
+| 1개 | tfx-auto 직접 실행 (아래 "실행" 섹션) | 팀 오버헤드 불필요, 경량 fire-and-forget |
+| 2개+ | **tfx-multi Phase 3** (TeamCreate → TaskCreate → Agent 래퍼) | Shift+Down 네비게이션, 상태 추적, fallback |
+
+**전환 방법:** 트리아지 완료 후 서브태스크 배열을 그대로 tfx-multi Phase 3에 전달한다.
+tfx-multi의 Phase 2(트리아지)는 건너뛰고 Phase 3a(TeamCreate)부터 시작한다.
+
+```
+if subtasks.length >= 2:
+  → tfx-multi Phase 3 실행 (트리아지 결과 재사용)
+  → TeamCreate → TaskCreate × N → Agent 래퍼 spawn (Phase 3a~3c)
+  → Phase 4 결과 수집 → Phase 5 정리
+else:
+  → tfx-auto 직접 실행 (아래)
+```
+
 ## 실행
 
 ### CLI 에이전트 (Codex/Gemini)