triflux 3.2.0-dev.15 → 3.2.0-dev.17

package/hub/team/native.mjs

@@ -80,6 +80,77 @@ Bash(command: 'TFX_TEAM_NAME="${teamName}" TFX_TEAM_TASK_ID="${taskId}" TFX_TEAM
 실패 여부는 metadata.result로 구분. Bash 실패 시에도 반드시 TaskUpdate + SendMessage 후 종료.`;
 }
 
+/**
+ * v3 하이브리드 래퍼 프롬프트 생성
+ * psmux pane 기반 비동기 실행 + polling 패턴.
+ * Agent가 idle 상태를 유지하여 인터럽트 수신이 가능하다.
+ *
+ * @param {'codex'|'gemini'} cli — CLI 타입
+ * @param {object} opts
+ * @param {string} opts.subtask — 서브태스크 설명
+ * @param {string} [opts.role] — 역할
+ * @param {string} [opts.teamName] — 팀 이름
+ * @param {string} [opts.taskId] — Hub task ID
+ * @param {string} [opts.agentName] — 워커 표시 이름
+ * @param {string} [opts.leadName] — 리드 수신자 이름
+ * @param {string} [opts.mcp_profile] — MCP 프로필
+ * @param {string} [opts.sessionName] — psmux 세션 이름
+ * @param {string} [opts.pipelinePhase] — 파이프라인 단계
+ * @param {string} [opts.psmuxPath] — psmux.mjs 경로
+ * @returns {string} 하이브리드 래퍼 프롬프트
+ */
+export function buildHybridWrapperPrompt(cli, opts = {}) {
+  const {
+    subtask,
+    role = "executor",
+    teamName = "tfx-multi",
+    taskId = "",
+    agentName = "",
+    leadName = "team-lead",
+    mcp_profile = "auto",
+    sessionName = teamName,
+    pipelinePhase = "",
+    psmuxPath = "hub/team/psmux.mjs",
+  } = opts;
+
+  const escaped = subtask.replace(/'/g, "'\\''");
+  const pipelineHint = pipelinePhase ? `\n파이프라인 단계: ${pipelinePhase}` : "";
+  const taskIdRef = taskId ? `taskId: "${taskId}"` : "";
+  const taskIdArg = taskIdRef ? `${taskIdRef}, ` : "";
+
+  const routeCmd = `TFX_TEAM_NAME="${teamName}" TFX_TEAM_TASK_ID="${taskId}" TFX_TEAM_AGENT_NAME="${agentName}" TFX_TEAM_LEAD_NAME="${leadName}" bash ${ROUTE_SCRIPT} "${role}" '${escaped}' ${mcp_profile}`;
+
+  return `하이브리드 psmux 워커 프로토콜:
+
+1. TaskUpdate(${taskIdArg}status: in_progress) + SendMessage(to: ${leadName}, "작업 시작: ${agentName}")
+
+2. pane 생성 (비동기 실행):
+   Bash: node ${psmuxPath} spawn --session "${sessionName}" --name "${agentName}" --cmd "${routeCmd}"
+
+3. 폴링 루프 (10초 간격, idle 유지 → 인터럽트 수신 가능):
+   Bash: node ${psmuxPath} status --session "${sessionName}" --name "${agentName}"
+   - status: "running" → 10초 대기 후 재확인
+   - status: "exited" → 5단계로
+
+4. 인터럽트 수신 시:
+   Bash: node ${psmuxPath} kill --session "${sessionName}" --name "${agentName}"
+   → SendMessage(to: ${leadName}, "인터럽트 수신, 방향 전환")
+   → 새 지시에 따라 2단계부터 재실행
+
+5. 완료 시:
+   Bash: node ${psmuxPath} output --session "${sessionName}" --name "${agentName}" --lines 100
+   → 결과를 TaskUpdate + SendMessage로 보고
+${pipelineHint}
+gemini/codex를 직접 호출하지 마라. psmux spawn이 tfx-route.sh를 통해 실행한다.
+프롬프트를 파일로 저장하지 마라. psmux spawn --cmd 인자로 전달된다.
+
+성공 → TaskUpdate(${taskIdArg}status: completed, metadata: {result: "success"}) + SendMessage(to: ${leadName}).
+실패 → TaskUpdate(${taskIdArg}status: completed, metadata: {result: "failed", error: "에러 요약"}) + SendMessage(to: ${leadName}).
+
+중요: TaskUpdate의 status는 "completed"만 사용. "failed"는 API 미지원.
+실패 여부는 metadata.result로 구분. pane 실패 시에도 반드시 TaskUpdate + SendMessage 후 종료.`;
+}
+
 /**
  * 팀 이름 생성 (타임스탬프 기반)
  * @returns {string}

package/hub/team/psmux.mjs

@@ -3,6 +3,8 @@
 import { execSync, spawnSync } from "node:child_process";
 
 const PSMUX_BIN = process.env.PSMUX_BIN || "psmux";
+const GIT_BASH = process.env.GIT_BASH_PATH || "C:\\Program Files\\Git\\bin\\bash.exe";
+const IS_WINDOWS = process.platform === "win32";
 
 function quoteArg(value) {
   const str = String(value);
@@ -309,12 +311,26 @@ export function spawnWorker(sessionName, workerName, cmd) {
   if (!hasPsmux()) {
     throw new Error("psmux가 설치되어 있지 않습니다. psmux를 먼저 설치하세요.");
   }
+
+  // remain-on-exit: 종료된 pane이 즉시 사라지는 것 방지
   try {
-    // 세션 컨텍스트 포함 타겟 반환 (psmux는 세션별 서버 모델)
-    const paneTarget = psmuxExec(
-      `split-window -t ${quoteArg(sessionName)} -P -F "#{session_name}:#{window_index}.#{pane_index}" ${quoteArg(cmd)}`
-    );
-    psmuxExec(`select-pane -t ${quoteArg(paneTarget)} -T ${quoteArg(workerName)}`);
+    psmuxExec(`set-option -t ${quoteArg(sessionName)} remain-on-exit on`);
+  } catch { /* 미지원 시 무시 */ }
+
+  // Windows: pane 기본셸이 PowerShell → Git Bash로 래핑
+  // psmux가 이스케이프 시퀀스를 처리하므로 포워드 슬래시로 변환
+  const shellCmd = IS_WINDOWS
+    ? `& '${GIT_BASH.replace(/\\/g, '/')}' -l -c '${cmd.replace(/'/g, "'\\''")}'`
+    : cmd;
+
+  try {
+    // 배열 형태 spawnSync → 쉘 해석 우회 (백슬래시 경로 보존)
+    const paneTarget = psmux([
+      "split-window", "-t", sessionName,
+      "-P", "-F", "#{session_name}:#{window_index}.#{pane_index}",
+      shellCmd,
+    ]);
+    psmux(["select-pane", "-t", paneTarget, "-T", workerName]);
     return { paneId: paneTarget, workerName };
   } catch (err) {
     throw new Error(`워커 생성 실패 (session=${sessionName}, worker=${workerName}): ${err.message}`);
@@ -365,9 +381,15 @@ export function killWorker(sessionName, workerName) {
     throw new Error("psmux가 설치되어 있지 않습니다.");
   }
   try {
-    // paneId 찾기
-    const { paneId } = getWorkerStatus(sessionName, workerName);
-    // C-c로 우아한 종료 시도
+    const { paneId, status } = getWorkerStatus(sessionName, workerName);
+
+    // 이미 종료된 워커 → pane 정리만 수행
+    if (status === "exited") {
+      try { psmuxExec(`kill-pane -t ${quoteArg(paneId)}`); } catch { /* 무시 */ }
+      return { killed: true };
+    }
+
+    // running → C-c 우아한 종료 시도
     try {
       psmuxExec(`send-keys -t ${quoteArg(paneId)} C-c`);
     } catch {
@@ -382,8 +404,9 @@ export function killWorker(sessionName, workerName) {
     }
     return { killed: true };
   } catch (err) {
+    // 워커를 찾을 수 없음 → 이미 종료된 것으로 간주
     if (err.message.includes("워커를 찾을 수 없습니다")) {
-      return { killed: false };
+      return { killed: true };
     }
     throw new Error(`워커 종료 실패 (session=${sessionName}, worker=${workerName}): ${err.message}`);
   }

package/package.json

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

package/scripts/setup.mjs

@@ -16,10 +16,17 @@ const CODEX_DIR = join(homedir(), ".codex");
 const CODEX_CONFIG_PATH = join(CODEX_DIR, "config.toml");
 
 const REQUIRED_CODEX_PROFILES = [
+  {
+    name: "high",
+    lines: [
+      'model = "gpt-5.4"',
+      'model_reasoning_effort = "high"',
+    ],
+  },
   {
     name: "xhigh",
     lines: [
-      'model = "gpt-5.3-codex"',
+      'model = "gpt-5.4"',
       'model_reasoning_effort = "xhigh"',
     ],
   },

package/scripts/tfx-route.sh

@@ -447,7 +447,7 @@ get_gemini_mcp_servers() {
   local profile="$1"
   case "$profile" in
     implement)  echo "context7 brave-search" ;;
-    analyze)    echo "context7 brave-search exa" ;;
+    analyze)    echo "context7 brave-search exa tavily" ;;
     review)     echo "sequential-thinking" ;;
     docs)       echo "context7 brave-search" ;;
     *)          echo "" ;;

package/skills/tfx-multi/SKILL.md

@@ -13,6 +13,11 @@ argument-hint: '"작업 설명" | --agents codex,gemini "작업" | --tmux "작
 > 실제 작업은 `tfx-route.sh`가 수행한다. task 상태는 `team_task_list`를 truth source로 검증한다.
 > v3 — `--quick`(기본, v2.2 호환) + `--thorough`(전체 파이프라인: plan→prd→exec→verify→fix loop).
 
+> **[필수] Lead 웹 서치 직접 사용 금지**
+> Lead(Claude Opus)는 brave-search, exa, tavily 등 웹 서치 MCP 도구를 직접 호출하지 마라.
+> 리서치/검색 태스크는 반드시 `scientist` 또는 `document-specialist` 역할의 Codex 워커에 위임하라.
+> Lead가 MCP 검색 도구에 직접 접근 가능하더라도, 위임해야 Claude 토큰을 절약할 수 있다.
+
 ## 사용법
 
 ```