triflux 3.2.0-dev.14 → 3.2.0-dev.16

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,27 @@ export function spawnWorker(sessionName, workerName, cmd) {
   if (!hasPsmux()) {
     throw new Error("psmux가 설치되어 있지 않습니다. psmux를 먼저 설치하세요.");
   }
+
+  // remain-on-exit: 종료된 pane이 즉시 사라지는 것 방지
   try {
-    const paneId = psmuxExec(
-      `split-window -t ${quoteArg(sessionName)} -P -F "#{pane_id}" ${quoteArg(cmd)}`
-    );
-    psmuxExec(`select-pane -t ${quoteArg(paneId)} -T ${quoteArg(workerName)}`);
-    return { paneId, 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}`);
   }
@@ -332,7 +349,7 @@ export function getWorkerStatus(sessionName, workerName) {
   }
   try {
     const output = psmuxExec(
-      `list-panes -t ${quoteArg(sessionName)} -F "#{pane_title}\t#{pane_id}\t#{pane_dead}\t#{pane_dead_status}"`
+      `list-panes -t ${quoteArg(sessionName)} -F "#{pane_title}\t#{session_name}:#{window_index}.#{pane_index}\t#{pane_dead}\t#{pane_dead_status}"`
     );
     const lines = output.split("\n").filter(Boolean);
     for (const line of lines) {
@@ -364,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 {
@@ -381,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.14",
+  "version": "3.2.0-dev.16",
   "description": "CLI-first multi-model orchestrator for Claude Code — route tasks to Codex, Gemini, and Claude",
   "type": "module",
   "bin": {