triflux 6.0.18 → 6.0.20

package/hub/team/cli/commands/start/parse-args.mjs

@@ -7,7 +7,7 @@ export function parseTeamArgs(args = []) {
   let teammateMode = "auto";
   const taskParts = [];
   const assigns = []; // --assign "codex:프롬프트:역할" 형식
-  let autoAttach = false;
+  let autoAttach = true;
   let progressive = true;
   let timeoutSec = 300;
 

package/hub/team/headless.mjs

@@ -238,11 +238,9 @@ export async function runHeadlessWithCleanup(assignments, opts = {}) {
   try {
     return await runHeadless(sessionName, assignments, runOpts);
   } finally {
-    try {
-      killPsmuxSession(sessionName);
-    } catch {
-      // 이미 종료된 세션 — 무시
-    }
+    try { killPsmuxSession(sessionName); } catch { /* 무시 */ }
+    // WT split pane은 psmux 종료 시 셸이 끝나면서 자동으로 닫힘
+    // 수동 close-pane 불필요 (레이스 컨디션으로 WT 에러 발생)
   }
 }
 
@@ -369,28 +367,36 @@ export function autoAttachTerminal(sessionName, opts = {}, workerCount = 2) {
   ensureWtProfile(workerCount);
 
   const shells = ["pwsh.exe", "powershell.exe"];
-  // 방법 1: split-pane — 같은 WT 창에서 가로 분할
-  // 워커 수에 따라 split 비율 조정: 1-2→30%, 3-4→40%, 5-6→50%, 7+→60%
-  const splitSize = Math.min(0.6, 0.2 + workerCount * 0.05).toFixed(2);
-  if (process.env.WT_SESSION) {
+  const mode = opts.mode || "auto"; // "split" | "window" | "auto"
+
+  // v6.0.20: 기본 popup(별도 창). split은 --split 명시 시에만.
+  // 이유: WT sp는 포커스된 pane을 분할하므로, 사용자가 다른 탭에 있으면
+  // 엉뚱한 곳이 분할됨. 별도 창은 포커스 무관하게 안정적.
+  const preferSplit = mode === "split";
+  const preferWindow = mode !== "split";
+
+  if (preferSplit && !preferWindow && process.env.WT_SESSION) {
+    // inner split — 같은 WT 창에서 가로 분할
+    const splitSize = "0.50";
     for (const shell of shells) {
       try {
-        // 1) 하단 분할 생성
         execSync(
           `wt.exe -w 0 sp -H --size ${splitSize} --profile triflux --title triflux -- ${shell} -Command "psmux attach -t ${sessionName}"`,
           { stdio: "ignore", timeout: 5000 },
         );
-        // 2) 포커스를 Claude Code(위 pane)로 되돌림
         try { execSync(`wt.exe -w 0 mf up`, { stdio: "ignore", timeout: 2000 }); } catch { /* 무시 */ }
         return true;
       } catch { /* 다음 shell */ }
     }
   }
-  // 방법 2 fallback: 새 탭 (WT_SESSION 없거나 sp 실패 시)
+  // 별도 WT 창 — PowerShell 콘솔 크기 지정 후 psmux attach
+  const cols = Math.max(100, 60 + workerCount * 15);
+  const rows = Math.max(25, 15 + workerCount * 4);
+  const resizePs = `$s=$Host.UI.RawUI;$b=$s.BufferSize;$b.Width=${cols};$s.BufferSize=$b;$w=$s.WindowSize;$w.Width=${cols};$w.Height=${rows};$s.WindowSize=$w`;
   for (const shell of shells) {
     try {
       execSync(
-        `start "" /b wt.exe nt --profile triflux --title triflux -- ${shell} -Command "psmux attach -t ${sessionName}"`,
+        `start "" /b wt.exe -w new --profile triflux --title "triflux workers (${workerCount})" -- ${shell} -NoProfile -Command "${resizePs};psmux attach -t ${sessionName}"`,
         { stdio: "ignore", shell: true, timeout: 5000 },
       );
       return true;
@@ -460,7 +466,8 @@ export async function runHeadlessInteractive(sessionName, assignments, opts = {}
   runOpts.onProgress = (event) => {
     if (autoAttach && event.type === "session_created" && !terminalAttached) {
       terminalAttached = true;
-      autoAttachTerminal(sessionName, {}, assignments.length);
+      // v6.0.20: 항상 별도 창 (포커스 문제 회피)
+      autoAttachTerminal(sessionName, { mode: "window" }, assignments.length);
     }
     if (userOnProgress) userOnProgress(event);
   };
@@ -531,11 +538,13 @@ export async function runHeadlessInteractive(sessionName, assignments, opts = {}
       return psmuxSessionExists(sessionName);
     },
 
-    /** 세션 종료 */
+    /** 세션 종료 — WT pane은 psmux 종료 시 자동으로 닫힘 */
     kill() {
       if (this._killed) return;
       this._killed = true;
       try { killPsmuxSession(sessionName); } catch { /* 무시 */ }
+      // WT split pane은 psmux 종료 → 셸 종료 → 자동 닫힘
+      // 수동 close-pane 불필요 (레이스 컨디션으로 WT 0x80070002 에러 발생)
     },
   };
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "triflux",
-  "version": "6.0.18",
+  "version": "6.0.20",
   "description": "CLI-first multi-model orchestrator for Claude Code — route tasks to Codex, Gemini, and Claude",
   "type": "module",
   "bin": {

package/scripts/headless-guard.mjs

@@ -1,62 +1,69 @@
 #!/usr/bin/env node
 /**
- * headless-guard.mjs — PreToolUse 훅 (auto-route 모드)
+ * headless-guard.mjs — PreToolUse 훅 (상시 활성 auto-route)
  *
- * Phase 3 headless 모드 활성 중 Lead가 Bash(tfx-route.sh)로 개별 호출하면
- * deny 대신 자동으로 headless 명령으로 변환한다.
+ * psmux가 설치된 환경에서 Bash(tfx-route.sh) 개별 호출을
+ * 자동으로 headless 명령으로 변환한다.
+ *
+ * v2: 마커 파일 의존 제거. psmux 설치 여부만으로 판단.
+ *     Opus가 SKILL.md를 무시해도 auto-route가 작동한다.
  *
  * 동작:
- * - 마커 존재 + Bash(tfx-route.sh agent prompt mcp) → updatedInput: tfx multi --headless --assign
- * - 마커 존재 + Agent(codex/gemini CLI 워커) → deny (tool 타입 변환 불가, 안내 메시지)
- * - 마커 없음 → 전부 통과
- * - 마커 30분 초과 → 자동 만료 (stale 방지)
+ * - psmux 설치 + Bash(tfx-route.sh) → updatedInput: tfx multi --headless --assign
+ * - psmux 설치 + Bash(codex exec / gemini -p) → deny
+ * - psmux 설치 + Agent(codex/gemini CLI 래핑) → deny
+ * - psmux 미설치 → 전부 통과
  *
- * Exit 0 + stdout JSON: auto-route (updatedInput)
- * Exit 2 + stderr: deny (Agent CLI 래핑만)
- * Exit 0 (no stdout): allow
+ * 성능: psmux 감지 결과를 5분간 캐시 ($TMPDIR/tfx-psmux-check.json)
  */
 
-import { existsSync, readFileSync, unlinkSync } from "node:fs";
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { execFileSync } from "node:child_process";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
 
-const LOCK_FILE = join(tmpdir(), "tfx-headless-guard.lock");
-const MAX_AGE_MS = 30 * 60 * 1000; // 30분
+const CACHE_FILE = join(tmpdir(), "tfx-psmux-check.json");
+const CACHE_TTL_MS = 5 * 60 * 1000; // 5분
 
-function isLockActive() {
-  if (!existsSync(LOCK_FILE)) return false;
+function isPsmuxInstalled() {
+  // 캐시 확인
   try {
-    const ts = Number(readFileSync(LOCK_FILE, "utf8").trim());
-    if (Date.now() - ts > MAX_AGE_MS) {
-      unlinkSync(LOCK_FILE);
-      return false;
+    if (existsSync(CACHE_FILE)) {
+      const cache = JSON.parse(readFileSync(CACHE_FILE, "utf8"));
+      if (Date.now() - cache.ts < CACHE_TTL_MS) return cache.ok;
     }
-    return true;
-  } catch {
-    return false;
-  }
+  } catch { /* cache miss */ }
+
+  // psmux -V 실행
+  let ok = false;
+  try {
+    execFileSync("psmux", ["-V"], { timeout: 2000, stdio: "ignore" });
+    ok = true;
+  } catch { /* not installed */ }
+
+  // 캐시 저장
+  try {
+    writeFileSync(CACHE_FILE, JSON.stringify({ ts: Date.now(), ok }));
+  } catch { /* ignore */ }
+
+  return ok;
 }
 
 /**
  * tfx-route.sh 명령에서 agent, prompt를 파싱한다.
- * 형식: bash ~/.claude/scripts/tfx-route.sh {agent} '{prompt}' {mcp} [timeout] [context]
  */
 function parseRouteCommand(cmd) {
-  // MCP 프로필 목록 (tfx-route.sh의 마지막 위치 인자)
   const MCP_PROFILES = ["implement", "analyze", "review", "docs"];
 
-  // 전략: agent명 추출 후, 나머지에서 MCP 프로필을 역방향으로 찾아 프롬프트 경계를 결정
   const agentMatch = cmd.match(/tfx-route\.sh\s+(\S+)\s+/);
   if (!agentMatch) return null;
 
   const agent = agentMatch[1];
   const afterAgent = cmd.slice(agentMatch.index + agentMatch[0].length);
 
-  // MCP 프로필을 역방향으로 찾기
   let mcp = "";
   let promptRaw = afterAgent;
   for (const profile of MCP_PROFILES) {
-    // 프롬프트 뒤에 오는 MCP 프로필 (공백 구분)
     const profileIdx = afterAgent.lastIndexOf(` ${profile}`);
     if (profileIdx >= 0) {
       mcp = profile;
@@ -65,26 +72,24 @@ function parseRouteCommand(cmd) {
     }
   }
 
-  // 프롬프트에서 바깥쪽 따옴표 제거
   const prompt = promptRaw
     .replace(/^['"]/, "")
     .replace(/['"]$/, "")
-    .replace(/'\\''/g, "'")  // bash '\'' → '
-    .replace(/'"'"'/g, "'")  // bash '"'"' → '
+    .replace(/'\\''/g, "'")
+    .replace(/'"'"'/g, "'")
     .trim();
 
   return { agent, prompt, mcp };
 }
 
 function autoRoute(updatedCommand, reason) {
-  const output = {
+  process.stdout.write(JSON.stringify({
     hookSpecificOutput: {
       hookEventName: "PreToolUse",
       updatedInput: { command: updatedCommand },
       additionalContext: reason,
     },
-  };
-  process.stdout.write(JSON.stringify(output));
+  }));
   process.exit(0);
 }
 
@@ -94,7 +99,8 @@ function deny(reason) {
 }
 
 async function main() {
-  if (!isLockActive()) process.exit(0);
+  // psmux 미설치 → 전부 통과
+  if (!isPsmuxInstalled()) process.exit(0);
 
   let raw = "";
   for await (const chunk of process.stdin) raw += chunk;
@@ -109,58 +115,45 @@ async function main() {
   const toolName = input.tool_name || "";
   const toolInput = input.tool_input || {};
 
-  // ── Bash: tfx-route.sh → headless auto-route ──
+  // ── Bash ──
   if (toolName === "Bash") {
     const cmd = toolInput.command || "";
 
-    // 이미 headless 명령이면 통과
+    // headless 명령은 통과
     if (cmd.includes("tfx multi") || cmd.includes("triflux.mjs multi")) {
       process.exit(0);
     }
 
-    // 마커 조작 통과
-    if (cmd.includes("tfx-headless-guard")) {
-      process.exit(0);
-    }
-
-    // codex/gemini 직접 CLI 호출 감지 → deny (auto-route 불가: 원본 agent/role 정보 없음)
+    // codex/gemini 직접 CLI 호출 → deny
     if (/\bcodex\s+exec\b/.test(cmd) || /\bgemini\s+(-p|--prompt)\b/.test(cmd)) {
       deny(
-        "[headless-guard] Phase 3 활성 중. codex/gemini를 직접 호출하지 마세요. " +
-        'Bash("tfx multi --teammate-mode headless --assign \'codex:prompt:role\' ...") 로 headless 엔진에 위임하세요.',
+        "[headless-guard] codex/gemini 직접 호출 대신 headless를 사용하세요. " +
+        'Bash("tfx multi --teammate-mode headless --assign \'codex:prompt:role\' ...")',
       );
     }
 
-    // tfx-route.sh 개별 호출 → headless 자동 변환
-    if (cmd.includes("tfx-route.sh")) {
+    // tfx-route.sh 실행만 감지: 명령이 bash로 시작할 때만 (커밋 메시지/echo 등 무시)
+    if (/^\s*bash\s+.*tfx-route\.sh\s/.test(cmd)) {
       const parsed = parseRouteCommand(cmd);
       if (parsed) {
-        const role = parsed.agent;
-        // 프롬프트에서 싱글쿼트 이스케이프
         const safePrompt = parsed.prompt.replace(/'/g, "'\\''");
-        const headlessCmd =
-          `tfx multi --teammate-mode headless --auto-attach ` +
-          `--assign '${parsed.agent}:${safePrompt}:${role}' --timeout 600`;
         autoRoute(
-          headlessCmd,
-          `[headless-guard] auto-route: tfx-route.sh → headless 변환. 원본 agent=${parsed.agent}, mcp=${parsed.mcp}`,
+          `tfx multi --teammate-mode headless --auto-attach --assign '${parsed.agent}:${safePrompt}:${parsed.agent}' --timeout 600`,
+          `[headless-guard] auto-route: tfx-route.sh ${parsed.agent} → headless. mcp=${parsed.mcp}`,
         );
       }
-      // 파싱 실패 시 deny fallback
       deny(
-        "[headless-guard] Phase 3 활성 중. tfx-route.sh 명령을 headless로 변환할 수 없습니다. " +
-        'Bash("tfx multi --teammate-mode headless --auto-attach --assign \'cli:prompt:role\' ...") 형식을 사용하세요.',
+        "[headless-guard] tfx-route.sh를 headless로 변환 실패. " +
+        'Bash("tfx multi --teammate-mode headless --assign \'cli:prompt:role\' ...") 형식을 사용하세요.',
       );
     }
   }
 
-  // ── Agent: CLI 워커 래핑 시도 → deny (tool 타입 변환 불가) ──
+  // ── Agent: CLI 워커 래핑 → deny ──
   if (toolName === "Agent") {
-    const prompt = (toolInput.prompt || "").toLowerCase();
-    const desc = (toolInput.description || "").toLowerCase();
-    const combined = `${prompt} ${desc}`;
+    const combined = `${(toolInput.prompt || "").toLowerCase()} ${(toolInput.description || "").toLowerCase()}`;
 
-    const cliWorkerPatterns = [
+    const cliPatterns = [
       /codex\s+(exec|run|실행)/,
       /gemini\s+(-p|run|실행)/,
       /tfx-route/,
@@ -168,10 +161,9 @@ async function main() {
       /bash.*gemini/,
     ];
 
-    if (cliWorkerPatterns.some((p) => p.test(combined))) {
+    if (cliPatterns.some((p) => p.test(combined))) {
       deny(
-        "[headless-guard] Phase 3 활성 중. " +
-        "Codex/Gemini를 Agent()로 래핑하지 말고 headless --assign으로 전달하세요. " +
+        "[headless-guard] Codex/Gemini를 Agent()로 래핑하지 마세요. " +
         'Bash("tfx multi --teammate-mode headless --assign \'codex:prompt:role\' ...")',
       );
     }

package/scripts/setup.mjs

@@ -117,6 +117,11 @@ const SYNC_MAP = [
     dst: join(CLAUDE_DIR, "scripts", "lib", "keyword-rules.mjs"),
     label: "lib/keyword-rules.mjs",
   },
+  {
+    src: join(PLUGIN_ROOT, "scripts", "headless-guard.mjs"),
+    dst: join(CLAUDE_DIR, "scripts", "headless-guard.mjs"),
+    label: "headless-guard.mjs",
+  },
 ];
 
 function getVersion(filePath) {
@@ -549,6 +554,55 @@ try {
     writeFileSync(settingsPath, JSON.stringify(hookSettings, null, 2) + "\n", "utf8");
     synced++;
   }
+
+  // ── PreToolUse 훅: headless-guard (auto-route) ──
+  // Phase 3 headless 모드 활성 중 tfx-route.sh 개별 호출을
+  // headless 명령으로 자동 변환한다.
+  if (!Array.isArray(hookSettings.hooks.PreToolUse)) {
+    hookSettings.hooks.PreToolUse = [];
+  }
+
+  const guardScriptPath = join(CLAUDE_DIR, "scripts", "headless-guard.mjs").replace(/\\/g, "/");
+  const hasGuardHook = hookSettings.hooks.PreToolUse.some((entry) =>
+    Array.isArray(entry.hooks) &&
+    entry.hooks.some((h) => typeof h.command === "string" && h.command.includes("headless-guard")),
+  );
+
+  if (!hasGuardHook && existsSync(guardScriptPath.replace(/\//g, "\\"))) {
+    const nodePath = process.execPath.replace(/\\/g, "/");
+    const nodeRef = nodePath.includes(" ") ? `"${nodePath}"` : nodePath;
+
+    hookSettings.hooks.PreToolUse.push({
+      matcher: "Bash|Agent",
+      hooks: [
+        {
+          type: "command",
+          command: `${nodeRef} "${guardScriptPath}"`,
+          timeout: 3,
+        },
+      ],
+    });
+    writeFileSync(settingsPath, JSON.stringify(hookSettings, null, 2) + "\n", "utf8");
+    synced++;
+  } else if (hasGuardHook) {
+    // 기존 훅 경로를 동기화된 경로로 업데이트
+    let updated = false;
+    for (const entry of hookSettings.hooks.PreToolUse) {
+      if (!Array.isArray(entry.hooks)) continue;
+      for (const h of entry.hooks) {
+        if (typeof h.command === "string" && h.command.includes("headless-guard") && !h.command.includes(guardScriptPath)) {
+          const nodePath = process.execPath.replace(/\\/g, "/");
+          const nodeRef = nodePath.includes(" ") ? `"${nodePath}"` : nodePath;
+          h.command = `${nodeRef} "${guardScriptPath}"`;
+          updated = true;
+        }
+      }
+    }
+    if (updated) {
+      writeFileSync(settingsPath, JSON.stringify(hookSettings, null, 2) + "\n", "utf8");
+      synced++;
+    }
+  }
 } catch {
   // settings.json 파싱 실패 시 무시 — 기존 설정 보존
 }

package/skills/tfx-multi/SKILL.md

@@ -75,29 +75,17 @@ preflight와 Agent 생성을 병렬로 실행하여 사용자 체감 지연을
 
 ### Phase 3: Lead-Direct Headless 실행 (v6.0.0, 기본)
 
-> **MANDATORY: 2개+ CLI 워커 실행 시 headless 엔진 필수**
-> 서브태스크가 2개 이상이면 반드시 아래 `Bash()` 명령으로 headless 엔진을 실행한다.
-> `Agent()` 백그라운드나 `Bash(tfx-route.sh)` 개별 호출로 대체하지 않는다.
+> **MANDATORY: CLI 워커는 headless 엔진으로 실행**
+> CLI 워커(Codex/Gemini)는 반드시 아래 `Bash()` 명령으로 headless 엔진을 통해 실행한다.
+> `Bash(tfx-route.sh)` 개별 호출이나 `Agent()` CLI 래핑은 PreToolUse 훅이 자동 차단/변환한다.
 > headless 엔진이 psmux 세션 생성 → WT 자동 팝업 → CLI dispatch → 결과 수집을 전부 처리한다.
 
-**Step 1 — headless guard 활성화 (Phase 3 진입 시 반드시 먼저 실행):**
-
-```
-Bash("node -e \"require('fs').writeFileSync(require('os').tmpdir()+'/tfx-headless-guard.lock', String(Date.now()))\"")
-```
-
-**Step 2 — headless 엔진 실행 (Lead가 호출하는 유일한 명령):**
+**실행 명령 (Lead가 호출하는 유일한 명령):**
 
 ```
 Bash("tfx multi --teammate-mode headless --auto-attach --assign 'codex:{프롬프트1}:{역할1}' --assign 'gemini:{프롬프트2}:{역할2}' --timeout 600")
 ```
 
-**Step 3 — headless guard 해제 (Phase 3 완료 후):**
-
-```
-Bash("node -e \"try{require('fs').unlinkSync(require('os').tmpdir()+'/tfx-headless-guard.lock')}catch{}\"")
-```
-
 **예시:**
 
 ```