triflux 6.0.2 → 6.0.4

package/hub/team/headless.mjs

@@ -128,7 +128,9 @@ export async function runHeadless(sessionName, assignments, opts = {}) {
   } else {
     // ─── 기존 모드: 모든 pane을 한 번에 생성 ───
     const paneCount = assignments.length + 1;
-    const session = createPsmuxSession(sessionName, { layout, paneCount });
+    // A2b fix: 2x2 레이아웃은 최대 4 pane — 초과 시 tiled로 자동 전환
+    const effectiveLayout = (layout === "2x2" && paneCount > 4) ? "tiled" : layout;
+    const session = createPsmuxSession(sessionName, { layout: effectiveLayout, paneCount });
     applyTrifluxTheme(sessionName);
     if (safeProgress) safeProgress({ type: "session_created", sessionName, panes: session.panes });
 

package/package.json

@@ -1,66 +1,66 @@
-{
-  "name": "triflux",
-  "version": "6.0.2",
-  "description": "CLI-first multi-model orchestrator for Claude Code — route tasks to Codex, Gemini, and Claude",
-  "type": "module",
-  "bin": {
-    "triflux": "bin/triflux.mjs",
-    "tfx": "bin/triflux.mjs",
-    "tfl": "bin/triflux.mjs",
-    "tfx-setup": "bin/tfx-setup.mjs",
-    "tfx-doctor": "bin/tfx-doctor.mjs"
-  },
-  "files": [
-    "bin",
-    "hub",
-    "skills",
-    "!skills/tfx-workspace",
-    "!**/failure-reports",
-    "scripts",
-    "hooks",
-    "hud",
-    ".claude-plugin",
-    ".mcp.json",
-    "README.md",
-    "README.ko.md",
-    "LICENSE"
-  ],
-  "scripts": {
-    "setup": "node scripts/setup.mjs",
-    "preinstall": "node scripts/preinstall.mjs",
-    "postinstall": "node scripts/setup.mjs",
-    "test": "node --test --test-force-exit --test-concurrency=1 \"tests/**/*.test.mjs\" \"scripts/__tests__/**/*.test.mjs\"",
-    "test:unit": "node --test --test-force-exit --test-concurrency=1 tests/unit/**/*.test.mjs",
-    "test:integration": "node --test --test-force-exit --test-concurrency=1 tests/integration/**/*.test.mjs",
-    "test:route-smoke": "node --test scripts/test-tfx-route-no-claude-native.mjs"
-  },
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/tellang/triflux.git"
-  },
-  "homepage": "https://github.com/tellang/triflux#readme",
-  "author": "tellang",
-  "license": "MIT",
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.27.1",
-    "better-sqlite3": "^12.6.2",
-    "pino": "^10.3.1",
-    "pino-pretty": "^13.1.3",
-    "systray2": "^2.1.4",
-    "zod": "^4.0.0"
-  },
-  "keywords": [
-    "claude-code",
-    "plugin",
-    "codex",
-    "gemini",
-    "cli-routing",
-    "orchestration",
-    "multi-model",
-    "triflux",
-    "tfx"
-  ]
-}
+{
+  "name": "triflux",
+  "version": "6.0.4",
+  "description": "CLI-first multi-model orchestrator for Claude Code — route tasks to Codex, Gemini, and Claude",
+  "type": "module",
+  "bin": {
+    "triflux": "bin/triflux.mjs",
+    "tfx": "bin/triflux.mjs",
+    "tfl": "bin/triflux.mjs",
+    "tfx-setup": "bin/tfx-setup.mjs",
+    "tfx-doctor": "bin/tfx-doctor.mjs"
+  },
+  "files": [
+    "bin",
+    "hub",
+    "skills",
+    "!skills/tfx-workspace",
+    "!**/failure-reports",
+    "scripts",
+    "hooks",
+    "hud",
+    ".claude-plugin",
+    ".mcp.json",
+    "README.md",
+    "README.ko.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "setup": "node scripts/setup.mjs",
+    "preinstall": "node scripts/preinstall.mjs",
+    "postinstall": "node scripts/setup.mjs",
+    "test": "node --test --test-force-exit --test-concurrency=1 \"tests/**/*.test.mjs\" \"scripts/__tests__/**/*.test.mjs\"",
+    "test:unit": "node --test --test-force-exit --test-concurrency=1 tests/unit/**/*.test.mjs",
+    "test:integration": "node --test --test-force-exit --test-concurrency=1 tests/integration/**/*.test.mjs",
+    "test:route-smoke": "node --test scripts/test-tfx-route-no-claude-native.mjs"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tellang/triflux.git"
+  },
+  "homepage": "https://github.com/tellang/triflux#readme",
+  "author": "tellang",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "better-sqlite3": "^12.6.2",
+    "pino": "^10.3.1",
+    "pino-pretty": "^13.1.3",
+    "systray2": "^2.1.4",
+    "zod": "^4.0.0"
+  },
+  "keywords": [
+    "claude-code",
+    "plugin",
+    "codex",
+    "gemini",
+    "cli-routing",
+    "orchestration",
+    "multi-model",
+    "triflux",
+    "tfx"
+  ]
+}

package/scripts/preinstall.mjs

@@ -36,6 +36,22 @@ function stopHub() {
 
   const pid = Number(info.pid);
 
+  // D4 fix: PID 소유자 검증 — node 프로세스인지 확인 (PID 재사용 보호)
+  if (process.platform === "win32") {
+    try {
+      const taskInfo = execFileSync("tasklist", ["/FI", `PID eq ${pid}`, "/FO", "CSV", "/NH"], {
+        encoding: "utf8", stdio: ["pipe", "pipe", "ignore"], timeout: 5000, windowsHide: true,
+      }).trim();
+      if (!taskInfo.toLowerCase().includes("node")) {
+        console.log(`[triflux preinstall] PID ${pid}은 node 프로세스가 아님 — kill 건너뜀`);
+        try { unlinkSync(HUB_PID_FILE); } catch {}
+        return;
+      }
+    } catch {
+      // tasklist 실패 — 안전하게 진행 (프로세스가 이미 죽었을 수 있음)
+    }
+  }
+
   // 1단계: 프로세스 종료 — Windows는 taskkill, Unix는 SIGTERM
   try {
     if (process.platform === "win32") {

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}\\\"")`
 
 ## 전제 조건