triflux 5.1.2 → 6.0.0

package/hub/team/psmux.mjs

@@ -37,6 +37,10 @@ function sleepMs(ms) {
   Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, Math.max(0, ms));
 }
 
+function sleepMsAsync(ms) {
+  return new Promise((resolve) => setTimeout(resolve, Math.max(0, ms)));
+}
+
 function tokenizeCommand(command) {
   const source = String(command || "").trim();
   if (!source) return [];
@@ -637,23 +641,68 @@ export function dispatchCommand(sessionName, paneNameOrTarget, commandText) {
  * @param {string} paneNameOrTarget
  * @param {string|RegExp} pattern
  * @param {number} timeoutSec
+ * @param {object} [opts]
+ * @param {(snapshot: {content: string, paneId: string, paneName: string, elapsed: number}) => void} [opts.onPoll] — 각 폴링 주기마다 호출
  * @returns {{ matched: boolean, paneId: string, paneName: string, logPath: string, match: string|null }}
  */
-export function waitForPattern(sessionName, paneNameOrTarget, pattern, timeoutSec = 300) {
+export async function waitForPattern(sessionName, paneNameOrTarget, pattern, timeoutSec = 300, opts = {}) {
   ensurePsmuxInstalled();
-  const pane = resolvePane(sessionName, paneNameOrTarget);
+
+  // E4 크래시 복구: 초기 resolvePane도 세션 사망을 감지
+  let pane;
+  try {
+    pane = resolvePane(sessionName, paneNameOrTarget);
+  } catch (resolveError) {
+    if (!psmuxSessionExists(sessionName)) {
+      return {
+        matched: false,
+        paneId: "",
+        paneName: String(paneNameOrTarget),
+        logPath: "",
+        match: null,
+        sessionDead: true,
+      };
+    }
+    throw resolveError; // 세션은 살아있지만 pane을 못 찾음 → 원래 에러 전파
+  }
+
   const paneName = pane.title || paneNameOrTarget;
   const logPath = getCaptureLogPath(sessionName, paneName);
   if (!existsSync(logPath)) {
     throw new Error(`캡처 로그가 없습니다. 먼저 startCapture(${sessionName}, ${paneName})를 호출하세요.`);
   }
 
-  const deadline = Date.now() + Math.max(0, Math.trunc(timeoutSec * 1000));
+  const startTime = Date.now();
+  const deadline = startTime + Math.max(0, Math.trunc(timeoutSec * 1000));
   const regex = toPatternRegExp(pattern);
 
   while (Date.now() <= deadline) {
-    refreshCaptureSnapshot(sessionName, pane.paneId);
+    // E4 크래시 복구: capture 실패 시 세션 생존 체크
+    try {
+      refreshCaptureSnapshot(sessionName, pane.paneId);
+    } catch {
+      if (!psmuxSessionExists(sessionName)) {
+        return {
+          matched: false,
+          paneId: pane.paneId,
+          paneName,
+          logPath,
+          match: null,
+          sessionDead: true,
+        };
+      }
+      // 일시적 오류 — 다음 폴링에서 재시도
+    }
+
     const content = readCaptureLog(logPath);
+
+    // onPoll 콜백 — 각 폴링 주기마다 중간 상태 전달
+    if (opts.onPoll) {
+      try {
+        opts.onPoll({ content, paneId: pane.paneId, paneName, elapsed: Date.now() - startTime });
+      } catch { /* 콜백 예외는 삼킴 — 폴링 루프 보호 */ }
+    }
+
     const match = regex.exec(content);
     if (match) {
       return {
@@ -668,7 +717,7 @@ export function waitForPattern(sessionName, paneNameOrTarget, pattern, timeoutSe
     if (Date.now() > deadline) {
       break;
     }
-    sleepMs(POLL_INTERVAL_MS);
+    await sleepMsAsync(POLL_INTERVAL_MS);
   }
 
   return {
@@ -686,14 +735,15 @@ export function waitForPattern(sessionName, paneNameOrTarget, pattern, timeoutSe
  * @param {string} paneNameOrTarget
  * @param {string} token
  * @param {number} timeoutSec
+ * @param {object} [opts] — waitForPattern에 전달할 옵션 (onPoll 등)
  * @returns {{ matched: boolean, paneId: string, paneName: string, logPath: string, match: string|null, token: string, exitCode: number|null }}
  */
-export function waitForCompletion(sessionName, paneNameOrTarget, token, timeoutSec = 300) {
+export async function waitForCompletion(sessionName, paneNameOrTarget, token, timeoutSec = 300, opts = {}) {
   const completionRegex = new RegExp(
     `${escapeRegExp(COMPLETION_PREFIX)}${escapeRegExp(token)}:(\\d+)`,
     "m",
   );
-  const result = waitForPattern(sessionName, paneNameOrTarget, completionRegex, timeoutSec);
+  const result = await waitForPattern(sessionName, paneNameOrTarget, completionRegex, timeoutSec, opts);
   const exitMatch = result.match ? completionRegex.exec(result.match) : null;
   return {
     ...result,
@@ -840,6 +890,7 @@ export function captureWorkerOutput(sessionName, workerName, lines = 50) {
 // ─── CLI 진입점 ───
 
 if (process.argv[1] && process.argv[1].endsWith("psmux.mjs")) {
+  (async () => {
   const [, , cmd, ...args] = process.argv;
 
   // CLI 인자 파싱 헬퍼
@@ -922,7 +973,7 @@ if (process.argv[1] && process.argv[1].endsWith("psmux.mjs")) {
           console.error("사용법: node psmux.mjs wait-pattern --session <세션> --name <pane> --pattern <정규식> [--timeout <초>]");
           process.exit(1);
         }
-        const result = waitForPattern(session, name, pattern, timeoutSec);
+        const result = await waitForPattern(session, name, pattern, timeoutSec);
         console.log(JSON.stringify(result, null, 2));
         if (!result.matched) process.exit(2);
         break;
@@ -936,7 +987,7 @@ if (process.argv[1] && process.argv[1].endsWith("psmux.mjs")) {
           console.error("사용법: node psmux.mjs wait-completion --session <세션> --name <pane> --token <토큰> [--timeout <초>]");
           process.exit(1);
         }
-        const result = waitForCompletion(session, name, token, timeoutSec);
+        const result = await waitForCompletion(session, name, token, timeoutSec);
         console.log(JSON.stringify(result, null, 2));
         if (!result.matched) process.exit(2);
         break;
@@ -958,4 +1009,5 @@ if (process.argv[1] && process.argv[1].endsWith("psmux.mjs")) {
     console.error(`오류: ${err.message}`);
     process.exit(1);
   }
+  })();
 }

package/package.json

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

package/scripts/lib/logger.mjs

@@ -93,13 +93,13 @@ export function createModuleLogger(module) {
 
 // 정상 종료 시 버퍼 flush 보장
 process.on('uncaughtException', (err) => {
-  const finalLogger = pino.final(logger);
-  finalLogger.fatal({ err }, 'process.uncaught_exception');
+  logger.fatal({ err }, 'process.uncaught_exception');
+  logger.flush();
   process.exit(1);
 });
 
 process.on('unhandledRejection', (reason) => {
-  const finalLogger = pino.final(logger);
-  finalLogger.fatal({ reason: String(reason) }, 'process.unhandled_rejection');
+  logger.fatal({ reason: String(reason) }, 'process.unhandled_rejection');
+  logger.flush();
   process.exit(1);
 });

package/scripts/lib/mcp-filter.mjs

@@ -176,7 +176,10 @@ function normalizeProfileName(profile) {
   if (raw === 'auto') return raw;
   if (PROFILE_DEFINITIONS[raw]) return raw;
   if (LEGACY_PROFILE_ALIASES[raw]) return LEGACY_PROFILE_ALIASES[raw];
-  throw new Error(`지원하지 않는 MCP 프로필: ${raw}`);
+  // graceful fallback: --flag나 잘못된 프로필 → 'auto'로 폴백 (hard crash 방지)
+  if (raw.startsWith('-') || raw.startsWith('/')) return 'auto';
+  console.error(`[mcp-filter] 경고: 알 수 없는 프로필 '${raw}', 'auto'로 폴백`);
+  return 'auto';
 }
 
 function resolveAutoProfile(agentType = '') {

package/scripts/tfx-route.sh

@@ -121,14 +121,7 @@ MCP_PROFILE="${3:-auto}"
 USER_TIMEOUT="${4:-}"
 CONTEXT_FILE="${5:-}"
 
-# ── 인자 검증: CLI 이름을 role 자리에 사용한 경우 안내 ──
-case "$AGENT_TYPE" in
-  codex|gemini|claude|claude-native)
-    echo "ERROR: '$AGENT_TYPE'는 CLI 이름이지 에이전트 역할이 아닙니다." >&2
-    echo "올바른 사용법: TFX_CLI_MODE=$AGENT_TYPE bash tfx-route.sh <역할> \"프롬프트\"" >&2
-    echo "사용 가능한 역할: executor, code-reviewer, scientist, designer, architect, verifier 등" >&2
-    exit 64 ;;
-esac
+# ── CLI 이름은 route_agent()에서 기본 역할 alias로 처리됨 (codex→executor, gemini→designer, claude→explore) ──
 
 # ── 인자 검증: MCP_PROFILE이 --flag 형태인 경우 거절 ──
 if [[ "$MCP_PROFILE" == --* ]]; then
@@ -668,11 +661,24 @@ route_agent() {
       CLI_TYPE="codex"; CLI_CMD="codex"
       CLI_ARGS="exec --profile spark_fast ${codex_base}"
       CLI_EFFORT="spark_fast"; DEFAULT_TIMEOUT=180; RUN_MODE="fg"; OPUS_OVERSIGHT="false" ;;
+    # ─── CLI 이름 alias (사용자 편의) ───
+    codex)
+      CLI_TYPE="codex"; CLI_CMD="codex"
+      CLI_ARGS="exec ${codex_base}"
+      CLI_EFFORT="high"; DEFAULT_TIMEOUT=1080; RUN_MODE="fg"; OPUS_OVERSIGHT="false" ;;
+    gemini)
+      CLI_TYPE="gemini"; CLI_CMD="gemini"
+      CLI_ARGS="-m gemini-3.1-pro-preview -y --prompt"
+      CLI_EFFORT="pro"; DEFAULT_TIMEOUT=900; RUN_MODE="bg"; OPUS_OVERSIGHT="false" ;;
+    claude)
+      CLI_TYPE="claude-native"; CLI_CMD=""; CLI_ARGS=""
+      CLI_EFFORT="n/a"; DEFAULT_TIMEOUT=600; RUN_MODE="fg"; OPUS_OVERSIGHT="false" ;;
     *)
       echo "ERROR: 알 수 없는 에이전트 타입: $agent" >&2
       echo "사용 가능: executor, build-fixer, debugger, deep-executor, architect, planner, critic, analyst," >&2
       echo "          code-reviewer, security-reviewer, quality-reviewer, scientist, document-specialist," >&2
-      echo "          designer, writer, explore, verifier, test-engineer, qa-tester, spark" >&2
+      echo "          designer, writer, explore, verifier, test-engineer, qa-tester, spark," >&2
+      echo "          codex, gemini, claude (CLI alias)" >&2
       exit 1 ;;
   esac
 }

package/skills/tfx-multi/SKILL.md

@@ -148,10 +148,60 @@ status는 "completed"만 사용. 실패 여부는 `metadata.result`로 구분.
 3. 실패 시 `forceCleanupTeam(teamName)` → 그래도 실패 시 `rm -rf ~/.claude/teams/{teamName}/` 안내
 4. 종합 보고서 출력
 
-### Phase 3-mux: 레거시 psmux/tmux 모드
+### Phase 3-direct: Lead-Direct Headless 실행 (v6.0.0, 기본)
+
+CLI 워커(Codex/Gemini/Claude)를 Agent 래퍼 없이 Lead가 headless.mjs로 직접 실행.
+Windows Terminal에 psmux 세션이 자동 팝업되어 사용자가 실시간으로 CLI 출력을 확인.
+
+**핵심 기능:**
+- `progressive: true` (기본) — pane이 하나씩 split-window로 추가 (실시간 스플릿)
+- `autoAttach: true` — 세션 생성 즉시 Windows Terminal 자동 팝업
+- `progressIntervalSec` — N초마다 각 pane 스냅샷을 onProgress로 전달
+- `applyTrifluxTheme()` — status bar + pane border 테마 자동 적용
+- 피드백 재실행 — 같은 pane에 후속 명령 dispatch (세션 유지)
+
+**Lead 오케스트레이션 패턴:**
+
+```javascript
+// headless.mjs의 runHeadlessInteractive()를 Bash 내에서 호출
+// Lead는 Bash의 결과를 직접 파싱 — Agent 래퍼 불필요
+const handle = await runHeadlessInteractive("tfx-session", [
+  { cli: "codex", prompt: "코드 리뷰", role: "reviewer" },
+  { cli: "gemini", prompt: "문서 작성", role: "writer" },
+  { cli: "claude", prompt: "테스트 실행", role: "tester" },
+], {
+  timeoutSec: 300,
+  autoAttach: true,          // WT 자동 팝업
+  progressive: true,         // 실시간 스플릿 (기본)
+  progressIntervalSec: 10,   // 10초마다 진행 스냅샷
+});
+// handle: { results, dispatch(), capture(), snapshots(), waitFor(), kill() }
+```
+
+**결정 로직:**
+```
+Phase 3 선택:
+  assignments.every(a => a.cli !== 'claude')
+    → Phase 3-direct (headless, 전부 CLI)
+  assignments.some(a => a.cli === 'claude') AND Claude 워커가 Read/Edit 필요
+    → Claude 워커: Agent(subagent_type), CLI 워커: Phase 3-direct
+  fallback (psmux 미설치)
+    → Phase 3 Native Teams (기존 slim wrapper)
+```
+
+**CLI 헤드리스 명령 패턴:**
+| CLI | 명령 | 출력 |
+|-----|-------|------|
+| Codex | `codex exec 'prompt' -o result.txt --color never` | 파일 |
+| Gemini | `gemini -p 'prompt' -o text > result.txt 2>result.txt.err` | 리다이렉트 |
+| Claude | `claude -p 'prompt' --output-format text > result.txt 2>&1` | 리다이렉트 |
+
+**E4 크래시 복구:** `waitForCompletion`이 세션 사망 시 `{sessionDead: true}` 반환 (throw 대신).
+**elevation 불필요:** psmux IPC는 TCP 기반. 비-elevated 환경에서 정상 실행. (v5.2.0 검증 완료)
+**시각적 확인:** Windows Terminal 자동 팝업 + pane 타이틀 `codex (reviewer)` + triflux 테마.
+**실수로 닫아도:** psmux 세션은 독립적. `psmux attach -t 세션이름`으로 재연결.
 
-`--tmux`/`--psmux` 시 pane 기반 실행. psmux가 Windows 1순위.
-`Bash("node {PKG_ROOT}/bin/triflux.mjs multi --no-attach --agents {agents} \\\"{task}\\\"")`
+**레거시 인터랙티브 모드:** `Bash("node {PKG_ROOT}/bin/triflux.mjs multi --no-attach --agents {agents} \\\"{task}\\\"")`
 
 ## 전제 조건