triflux 6.0.1 → 6.0.3

package/hub/team/headless.mjs

@@ -81,13 +81,18 @@ export async function runHeadless(sessionName, assignments, opts = {}) {
 
   mkdirSync(RESULT_DIR, { recursive: true });
 
+  // onProgress 예외를 삼켜 실행 흐름 보호 (onPoll과 동일 패턴)
+  const safeProgress = onProgress
+    ? (event) => { try { onProgress(event); } catch { /* 콜백 예외 삼킴 */ } }
+    : null;
+
   let dispatches;
 
   if (progressive) {
     // ─── 실시간 스플릿 모드: lead pane만 생성 후, 워커를 하나씩 추가 ───
     const session = createPsmuxSession(sessionName, { layout, paneCount: 1 });
     applyTrifluxTheme(sessionName);
-    if (onProgress) onProgress({ type: "session_created", sessionName, panes: session.panes });
+    if (safeProgress) safeProgress({ type: "session_created", sessionName, panes: session.panes });
 
     dispatches = assignments.map((assignment, i) => {
       const paneName = `worker-${i + 1}`;
@@ -104,7 +109,7 @@ export async function runHeadless(sessionName, assignments, opts = {}) {
       // 타이틀 설정
       try { psmuxExec(["select-pane", "-t", newPaneId, "-T", paneTitle]); } catch { /* 무시 */ }
 
-      if (onProgress) onProgress({ type: "worker_added", paneName, cli: assignment.cli, paneTitle });
+      if (safeProgress) safeProgress({ type: "worker_added", paneName, cli: assignment.cli, paneTitle });
 
       // 캡처 시작 + 명령 dispatch (paneId 직접 사용 — resolvePane race 회피)
       const resultFile = join(RESULT_DIR, `${sessionName}-${paneName}.txt`).replace(/\\/g, "/");
@@ -112,7 +117,7 @@ export async function runHeadless(sessionName, assignments, opts = {}) {
       startCapture(sessionName, newPaneId);
       const dispatch = dispatchCommand(sessionName, newPaneId, cmd);
 
-      if (onProgress) onProgress({ type: "dispatched", paneName, cli: assignment.cli });
+      if (safeProgress) safeProgress({ type: "dispatched", paneName, cli: assignment.cli });
 
       return { ...dispatch, paneId: newPaneId, paneName, resultFile, cli: assignment.cli, role: assignment.role };
     });
@@ -125,7 +130,7 @@ export async function runHeadless(sessionName, assignments, opts = {}) {
     const paneCount = assignments.length + 1;
     const session = createPsmuxSession(sessionName, { layout, paneCount });
     applyTrifluxTheme(sessionName);
-    if (onProgress) onProgress({ type: "session_created", sessionName, panes: session.panes });
+    if (safeProgress) safeProgress({ type: "session_created", sessionName, panes: session.panes });
 
     dispatches = assignments.map((assignment, i) => {
       const paneName = `worker-${i + 1}`;
@@ -137,7 +142,7 @@ export async function runHeadless(sessionName, assignments, opts = {}) {
       // 리네임하면 waitForCompletion이 "codex (role).log"를 찾지만 실제는 "worker-N.log"로 불일치
       // progressive 모드에서는 split-window 시 새 pane에 바로 타이틀이 설정되므로 문제없음
 
-      if (onProgress) onProgress({ type: "dispatched", paneName, cli: assignment.cli });
+      if (safeProgress) safeProgress({ type: "dispatched", paneName, cli: assignment.cli });
 
       return { ...dispatch, paneName, resultFile, cli: assignment.cli, role: assignment.role };
     });
@@ -147,14 +152,14 @@ export async function runHeadless(sessionName, assignments, opts = {}) {
   const results = await Promise.all(dispatches.map(async (d) => {
     // onPoll → onProgress 변환 (throttle by progressIntervalSec)
     const pollOpts = {};
-    if (onProgress && progressIntervalSec > 0) {
+    if (safeProgress && progressIntervalSec > 0) {
       let lastProgressAt = 0;
       const intervalMs = progressIntervalSec * 1000;
       pollOpts.onPoll = ({ content }) => {
         const now = Date.now();
         if (now - lastProgressAt >= intervalMs) {
           lastProgressAt = now;
-          onProgress({
+          safeProgress({
             type: "progress",
             paneName: d.paneName,
             cli: d.cli,
@@ -170,8 +175,8 @@ export async function runHeadless(sessionName, assignments, opts = {}) {
       ? readResult(d.resultFile, d.paneId)
       : "";
 
-    if (onProgress) {
-      onProgress({
+    if (safeProgress) {
+      safeProgress({
         type: "completed",
         paneName: d.paneName,
         cli: d.cli,

package/package.json

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

package/skills/tfx-auto/SKILL.md

@@ -150,28 +150,32 @@ Plan/PRD/Approval은 tfx-auto에서 실행, 그 후 tfx-multi Phase 3로 전환.
 ## 멀티 태스크 라우팅 (트리아지 후)
 
 > **트리아지 결과에 따라 실행 경로 결정.**
+> v6.0.0부터 CLI 워커는 **Lead-Direct Headless** (psmux)가 기본. Agent 래퍼 불필요.
 
-| 조건 | 실행 경로 | 이유 |
+| 조건 | 실행 경로 | 엔진 |
 |------|----------|------|
-| 1개 + quick | tfx-auto 직접 실행 (fire-and-forget) | 팀 오버헤드 불필요 |
-| 1개 + thorough | tfx-auto 직접 실행 + verify/fix loop | plan→exec→verify 단일 경로 |
-| 2개+ + quick | tfx-multi Phase 3 (TeamCreate 직행) | Shift+Down, 상태 추적 |
-| 2개+ + thorough | Plan/PRD/Approval 후 → tfx-multi Phase 3 + verify/fix | 전체 파이프라인 |
+| 1개 + quick | tfx-auto 직접 실행 (fire-and-forget) | tfx-route.sh |
+| 1개 + thorough | tfx-auto 직접 실행 + verify/fix loop | tfx-route.sh |
+| 2개+ + quick | **headless 직접 실행** (WT 자동 팝업) | headless.mjs |
+| 2개+ + thorough | Plan/PRD/Approval 후 → headless + verify/fix | headless.mjs |
+| psmux 미설치 fallback | Native Teams (Agent slim wrapper) | native.mjs |
 
-**전환 방법:** 트리아지 완료 후 서브태스크 배열 + thorough 플래그를 tfx-multi Phase 3에 전달.
-tfx-multi의 Phase 2(트리아지)는 건너뛰고, thorough 시 Phase 2.5-2.6도 건너뛴다 (auto에서 이미 수행).
+**전환 방법:** 트리아지 완료 후 서브태스크 배열을 headless.runHeadlessInteractive()에 전달.
+Windows Terminal에 psmux 세션이 자동 팝업되어 사용자가 실시간으로 CLI 출력 확인.
 
 ```
 thorough = args에 -t 또는 --thorough 포함
 
 if subtasks.length >= 2:
-  if thorough:
-    → Pipeline init → Plan → PRD → Approval (tfx-auto에서 수행)
-    → tfx-multi Phase 3 실행 ({ subtasks, thorough: true })
-    → Phase 3.5 verify → Phase 3.6 fix loop → Phase 5 정리
+  if psmux 설치됨:
+    → headless.runHeadlessInteractive(assignments, {
+        autoAttach: true,     // WT 자동 팝업
+        progressive: true,    // 실시간 스플릿
+        progressIntervalSec: 10,
+      })
+    → if thorough: verify → fix loop
   else:
-    → tfx-multi Phase 3 실행 ({ subtasks, thorough: false })
-    → Phase 4 결과 수집 → Phase 5 정리
+    → fallback: tfx-multi Phase 3 Native Teams (Agent slim wrapper)
 else:
   if thorough:
     → Pipeline init → Plan → PRD → Approval → 직접 실행 → Verify → Fix loop

package/skills/tfx-multi/SKILL.md

@@ -73,82 +73,7 @@ preflight와 Agent 생성을 병렬로 실행하여 사용자 체감 지연을
 > `--thorough`(기본) 모드에서 실행된다. `--quick` 플래그 시 건너뛴다.
 > 상세는 → [`references/thorough-pipeline.md`](references/thorough-pipeline.md) 참조.
 
-### Phase 3: Native Teams 실행
-
-#### Step 3a: 팀 생성
-
-```
-teamName = "tfx-" + Date.now().toString(36).slice(-6)
-TeamCreate({ team_name: teamName, description: "tfx-multi: {원본 작업 요약}" })
-```
-
-#### Step 3b: 공유 작업 등록
-
-```
-for each assignment (index i):
-  TaskCreate({ subject: assignment.subtask, metadata: { cli, role } })
-  agentName = "{cli}-worker-{i+1}"
-```
-
-#### Step 3c: 슬림 래퍼 Agent 실행
-
-Codex/Gemini 서브태스크마다 슬림 래퍼 Agent를 spawn하여 Shift+Down 네비게이션에 등록한다.
-래퍼 내부에서 `tfx-route.sh`로 CLI를 실행하고, 리드 피드백을 받아 재실행하는 구조이다.
-
-```
-for each item where item.cli in ["codex", "gemini"]:
-  Agent({
-    name: item.agentName,
-    team_name: teamName,
-    mode: "bypassPermissions",
-    run_in_background: true,
-    prompt: buildSlimWrapperPrompt(item.cli, { subtask, role, teamName, taskId, agentName, leadName: "team-lead", mcp_profile })
-  })
-```
-
-슬림 래퍼 프롬프트의 단일 truth source: `hub/team/native.mjs`의 `buildSlimWrapperPrompt()`.
-핵심 동작: Bash(tfx-route.sh) → SendMessage(보고) → 피드백 대기 → 재실행(N회) → TaskUpdate(completed) → 종료.
-
-**핵심 규칙 요약:**
-- Agent 래퍼 생략 금지 — 단일 워커도 반드시 Agent로 spawn (네비게이션 등록)
-- `mode: "bypassPermissions"` 필수 — 모든 Agent에 포함
-- `tfx-route.sh` 경유 필수 — 직접 `codex exec`/`gemini -y -p` 호출 금지
-- 코드 직접 조작 금지 — 워커가 Read/Edit/Write 등 도구 직접 사용 금지
-
-> 래퍼 규칙의 상세 이유와 인터럽트 프로토콜 → [`references/agent-wrapper-rules.md`](references/agent-wrapper-rules.md) 참조.
-
-#### Step 3d: claude 타입만 Agent 직접 실행
-
-```
-Agent({
-  name: "claude-worker-{n}", team_name: teamName, mode: "bypassPermissions",
-  run_in_background: true, subagent_type: "{role}",
-  prompt: "TaskGet → TaskUpdate(in_progress) → 작업 수행 → TaskUpdate(completed, metadata: {result}) + SendMessage(to: team-lead)"
-})
-```
-
-status는 "completed"만 사용. 실패 여부는 `metadata.result`로 구분.
-
-#### Step 3e: 사용자 안내
-
-"팀 생성 완료. Shift+Down으로 워커 전환, Shift+Tab으로 이전 워커."
-
-### Phase 4: 결과 수집
-
-`team_task_list`가 최종 truth source: `Bash("node hub/bridge.mjs team-task-list --team ${teamName}")`
-- `metadata.result == "failed"` → Claude fallback 재시도
-- Hub `task-update`에서는 `"failed"` 사용 가능. Claude Code `TaskUpdate`만 `"completed"` + `metadata.result`로 구분.
-
-### Phase 5: 정리 (반드시 실행)
-
-성공/실패에 관계없이 반드시 실행. TeamDelete를 건너뛰면 `~/.claude/teams/{teamName}/`이 잔존하여 무한 루프 발생.
-
-1. 백그라운드 Agent 완료를 **최대 30초** 대기
-2. `TeamDelete()` 호출
-3. 실패 시 `forceCleanupTeam(teamName)` → 그래도 실패 시 `rm -rf ~/.claude/teams/{teamName}/` 안내
-4. 종합 보고서 출력
-
-### Phase 3-direct: Lead-Direct Headless 실행 (v6.0.0, 기본)
+### Phase 3: Lead-Direct Headless 실행 (v6.0.0, 기본)
 
 CLI 워커(Codex/Gemini/Claude)를 Agent 래퍼 없이 Lead가 headless.mjs로 직접 실행.
 Windows Terminal에 psmux 세션이 자동 팝업되어 사용자가 실시간으로 CLI 출력을 확인.
@@ -201,6 +126,18 @@ Phase 3 선택:
 **시각적 확인:** Windows Terminal 자동 팝업 + pane 타이틀 `codex (reviewer)` + triflux 테마.
 **실수로 닫아도:** psmux 세션은 독립적. `psmux attach -t 세션이름`으로 재연결.
 
+### Phase 4: 결과 수집 + 정리
+
+headless 완료 후 `handle.results`에서 직접 수집. `handle.kill()`로 세션 정리.
+실패 워커(`exitCode !== 0`)는 Claude fallback 재시도.
+
+### Phase 3-fallback: Native Teams (psmux 미설치 시)
+
+psmux가 없는 환경에서만 사용. Agent slim wrapper로 CLI를 실행.
+`hub/team/native.mjs`의 `buildSlimWrapperPrompt()` 기반.
+
+> 래퍼 규칙 상세 → [`references/agent-wrapper-rules.md`](references/agent-wrapper-rules.md)
+
 **레거시 인터랙티브 모드:** `Bash("node {PKG_ROOT}/bin/triflux.mjs multi --no-attach --agents {agents} \\\"{task}\\\"")`
 
 ## 전제 조건