triflux 10.3.4 → 10.7.0

package/hub/team/cli/commands/control.mjs

@@ -1,11 +1,15 @@
 import { injectPrompt, sendKeys } from "../../pane.mjs";
 import { DIM, RESET, WHITE, YELLOW } from "../../shared.mjs";
+import { ok, warn } from "../render.mjs";
 import { publishLeadControl } from "../services/hub-client.mjs";
 import { resolveMember } from "../services/member-selector.mjs";
 import { nativeRequest } from "../services/native-control.mjs";
-import { isNativeMode, isTeamAlive, isWtMode } from "../services/runtime-mode.mjs";
+import {
+  isNativeMode,
+  isTeamAlive,
+  isWtMode,
+} from "../services/runtime-mode.mjs";
 import { loadTeamState } from "../services/state-store.mjs";
-import { ok, warn } from "../render.mjs";
 
 export async function teamControl(args = []) {
   const state = loadTeamState();
@@ -17,26 +21,43 @@ export async function teamControl(args = []) {
   const member = resolveMember(state, args[0]);
   const command = String(args[1] || "").toLowerCase();
   const reason = args.slice(2).join(" ");
-  if (!member || !new Set(["interrupt", "stop", "pause", "resume"]).has(command)) {
-    console.log(`\n  사용법: ${WHITE}tfx multi control <lead|이름|번호> <interrupt|stop|pause|resume> [사유]${RESET}\n`);
+  if (
+    !member ||
+    !new Set(["interrupt", "stop", "pause", "resume"]).has(command)
+  ) {
+    console.log(
+      `\n  사용법: ${WHITE}tfx multi control <lead|이름|번호> <interrupt|stop|pause|resume> [사유]${RESET}\n`,
+    );
     return;
   }
   if (isWtMode(state)) {
-    console.log(`\n  ${YELLOW}⚠${RESET} wt 모드는 Hub direct/control 주입 경로가 비활성입니다.\n  ${DIM}수동 제어: 해당 pane에서 직접 명령/인터럽트를 수행하세요.${RESET}\n`);
+    console.log(
+      `\n  ${YELLOW}⚠${RESET} wt 모드는 Hub direct/control 주입 경로가 비활성입니다.\n  ${DIM}수동 제어: 해당 pane에서 직접 명령/인터럽트를 수행하세요.${RESET}\n`,
+    );
     return;
   }
 
   let directOk = false;
   if (isNativeMode(state)) {
-    directOk = !!(await nativeRequest(state, "/control", { member: member.name, command, reason }))?.ok;
+    directOk = !!(
+      await nativeRequest(state, "/control", {
+        member: member.name,
+        command,
+        reason,
+      })
+    )?.ok;
   } else {
-    injectPrompt(member.pane, `[LEAD CONTROL] command=${command}${reason ? ` reason=${reason}` : ""}`);
+    injectPrompt(
+      member.pane,
+      `[LEAD CONTROL] command=${command}${reason ? ` reason=${reason}` : ""}`,
+    );
     if (command === "interrupt") sendKeys(member.pane, "C-c");
     directOk = true;
   }
 
   const published = await publishLeadControl(state, member, command, reason);
-  if (directOk && published) ok(`${member.name} 제어 전송 (${command}, direct + hub)`);
+  if (directOk && published)
+    ok(`${member.name} 제어 전송 (${command}, direct + hub)`);
   else if (directOk) ok(`${member.name} 제어 전송 (${command}, direct only)`);
   else warn(`${member.name} 제어 전송 실패 (${command})`);
   console.log("");

package/hub/team/cli/commands/debug.mjs

@@ -1,4 +1,3 @@
-import { AMBER, BOLD, DIM, RESET } from "../../shared.mjs";
 import {
   capturePaneOutput,
   detectMultiplexer,
@@ -7,21 +6,31 @@ import {
   hasWindowsTerminalSession,
   listSessions,
 } from "../../session.mjs";
+import { AMBER, BOLD, DIM, RESET } from "../../shared.mjs";
+import { formatCompletionSuffix } from "../render.mjs";
 import { getHubInfo, nativeGetStatus } from "../services/hub-client.mjs";
-import { isNativeMode, isTeamAlive, isWtMode } from "../services/runtime-mode.mjs";
+import {
+  isNativeMode,
+  isTeamAlive,
+  isWtMode,
+} from "../services/runtime-mode.mjs";
 import { loadTeamState, TEAM_PROFILE } from "../services/state-store.mjs";
-import { formatCompletionSuffix } from "../render.mjs";
 
 export async function teamDebug(args = []) {
   const state = loadTeamState();
   const flagIndex = args.findIndex((arg) => arg === "--lines" || arg === "-n");
-  const lines = flagIndex === -1 ? 20 : Math.max(3, parseInt(args[flagIndex + 1] || "20", 10) || 20);
+  const lines =
+    flagIndex === -1
+      ? 20
+      : Math.max(3, parseInt(args[flagIndex + 1] || "20", 10) || 20);
   const hub = await getHubInfo();
 
   console.log(`\n  ${AMBER}${BOLD}⬡ Team Debug${RESET}\n`);
   console.log(`    platform:  ${process.platform}`);
   console.log(`    node:      ${process.version}`);
-  console.log(`    tty:       stdout=${!!process.stdout.isTTY}, stdin=${!!process.stdin.isTTY}`);
+  console.log(
+    `    tty:       stdout=${!!process.stdout.isTTY}, stdin=${!!process.stdin.isTTY}`,
+  );
   console.log(`    mux:       ${detectMultiplexer() || "none"}`);
   console.log(`    hub-pid:   ${hub ? `${hub.pid}` : "-"}`);
   console.log(`    hub-url:   ${hub?.url || "-"}`);
@@ -40,13 +49,17 @@ export async function teamDebug(args = []) {
   console.log(`    lead:      ${state.lead}`);
   console.log(`    agents:    ${(state.agents || []).join(", ")}`);
   console.log(`    alive:     ${isTeamAlive(state) ? "yes" : "no"}`);
-  console.log(`    attached:  ${getSessionAttachedCount(state.sessionName) ?? "-"}`);
+  console.log(
+    `    attached:  ${getSessionAttachedCount(state.sessionName) ?? "-"}`,
+  );
 
   if (isWtMode(state)) {
     console.log(`\n  ${BOLD}wt-session${RESET}`);
     console.log(`    window:    ${state?.wt?.windowId ?? 0}`);
     console.log(`    layout:    ${state?.wt?.layout || state?.layout || "-"}`);
-    console.log(`    panes:     ${state?.wt?.paneCount ?? (state.members || []).length}`);
+    console.log(
+      `    panes:     ${state?.wt?.paneCount ?? (state.members || []).length}`,
+    );
     console.log(`    wt.exe:    ${hasWindowsTerminal() ? "yes" : "no"}`);
     console.log(`    WT_SESSION:${hasWindowsTerminalSession() ? "yes" : "no"}`);
     console.log("");
@@ -57,16 +70,24 @@ export async function teamDebug(args = []) {
     console.log(`\n  ${BOLD}native-members${RESET}`);
     const members = (await nativeGetStatus(state))?.data?.members || [];
     if (!members.length) console.log(`    ${DIM}(no data)${RESET}`);
-    for (const member of members) console.log(`    - ${member.name}: ${member.status}${formatCompletionSuffix(member)}${member.lastPreview ? ` ${DIM}${member.lastPreview}${RESET}` : ""}`);
+    for (const member of members)
+      console.log(
+        `    - ${member.name}: ${member.status}${formatCompletionSuffix(member)}${member.lastPreview ? ` ${DIM}${member.lastPreview}${RESET}` : ""}`,
+      );
     console.log("");
     return;
   }
 
-  console.log(`\n  ${BOLD}pane-tail${RESET} ${DIM}(last ${lines} lines)${RESET}`);
-  if (!(state.members || []).length) console.log(`    ${DIM}(members 없음)${RESET}`);
+  console.log(
+    `\n  ${BOLD}pane-tail${RESET} ${DIM}(last ${lines} lines)${RESET}`,
+  );
+  if (!(state.members || []).length)
+    console.log(`    ${DIM}(members 없음)${RESET}`);
   for (const member of state.members || []) {
     console.log(`\n    [${member.name}] ${member.pane}`);
-    for (const line of (capturePaneOutput(member.pane, lines) || "(empty)").split("\n").slice(-lines)) {
+    for (const line of (capturePaneOutput(member.pane, lines) || "(empty)")
+      .split("\n")
+      .slice(-lines)) {
       console.log(`      ${line}`);
     }
   }

package/hub/team/cli/commands/focus.mjs

@@ -1,10 +1,18 @@
 import { attachSession, focusPane, focusWtPane } from "../../session.mjs";
 import { DIM, RESET, WHITE } from "../../shared.mjs";
-import { buildManualAttachCommand, launchAttachInWindowsTerminal, wantsWtAttachFallback } from "../services/attach-fallback.mjs";
+import { fail, ok, warn } from "../render.mjs";
+import {
+  buildManualAttachCommand,
+  launchAttachInWindowsTerminal,
+  wantsWtAttachFallback,
+} from "../services/attach-fallback.mjs";
 import { resolveMember } from "../services/member-selector.mjs";
-import { isNativeMode, isTeamAlive, isWtMode } from "../services/runtime-mode.mjs";
+import {
+  isNativeMode,
+  isTeamAlive,
+  isWtMode,
+} from "../services/runtime-mode.mjs";
 import { loadTeamState } from "../services/state-store.mjs";
-import { fail, ok, warn } from "../render.mjs";
 
 export async function teamFocus(args = []) {
   const state = loadTeamState();
@@ -13,23 +21,34 @@ export async function teamFocus(args = []) {
     return;
   }
   if (isNativeMode(state)) {
-    console.log(`\n  ${DIM}in-process 모드는 focus/attach 개념이 없습니다.${RESET}\n  ${DIM}직접 지시: tfx multi send <대상> "메시지"${RESET}\n`);
+    console.log(
+      `\n  ${DIM}in-process 모드는 focus/attach 개념이 없습니다.${RESET}\n  ${DIM}직접 지시: tfx multi send <대상> "메시지"${RESET}\n`,
+    );
     return;
   }
 
   const member = resolveMember(state, args[0]);
   if (!member) {
-    console.log(`\n  사용법: ${WHITE}tfx multi focus <lead|이름|번호>${RESET}\n`);
+    console.log(
+      `\n  사용법: ${WHITE}tfx multi focus <lead|이름|번호>${RESET}\n`,
+    );
     return;
   }
 
   if (isWtMode(state)) {
     const paneIndex = Number(/^wt:(\d+)$/.exec(member.pane || "")?.[1]);
     if (!Number.isFinite(paneIndex)) {
-      console.log(`\n  ${DIM}wt pane 인덱스 파싱 실패: ${member.pane}${RESET}\n`);
+      console.log(
+        `\n  ${DIM}wt pane 인덱스 파싱 실패: ${member.pane}${RESET}\n`,
+      );
       return;
     }
-    if (focusWtPane(paneIndex, { layout: state?.wt?.layout || state?.layout || "1xN" })) ok(`${member.name} pane 포커스 이동 (wt)`);
+    if (
+      focusWtPane(paneIndex, {
+        layout: state?.wt?.layout || state?.layout || "1xN",
+      })
+    )
+      ok(`${member.name} pane 포커스 이동 (wt)`);
     else warn("wt pane 포커스 이동 실패 (WT_SESSION/wt.exe 상태 확인 필요)");
     console.log("");
     return;
@@ -40,14 +59,22 @@ export async function teamFocus(args = []) {
     attachSession(state.sessionName);
   } catch (error) {
     const allowWt = wantsWtAttachFallback(args);
-    if (allowWt && await launchAttachInWindowsTerminal(state.sessionName)) {
+    if (allowWt && (await launchAttachInWindowsTerminal(state.sessionName))) {
       warn(`현재 터미널에서 attach 실패: ${error.message}`);
       ok("Windows Terminal split-pane로 attach 재시도 창을 열었습니다.");
-      console.log(`  ${DIM}수동 attach 명령: ${buildManualAttachCommand(state.sessionName)}${RESET}\n`);
+      console.log(
+        `  ${DIM}수동 attach 명령: ${buildManualAttachCommand(state.sessionName)}${RESET}\n`,
+      );
       return;
     }
     fail(`attach 실패: ${error.message}`);
-    warn(allowWt ? "WT 분할창 attach 자동 검증 실패 (session_attached 증가 없음)" : "자동 WT 분할은 기본 비활성입니다. 필요 시 --wt 옵션으로 실행하세요.");
-    console.log(`  ${DIM}수동 attach 명령: ${buildManualAttachCommand(state.sessionName)}${RESET}\n`);
+    warn(
+      allowWt
+        ? "WT 분할창 attach 자동 검증 실패 (session_attached 증가 없음)"
+        : "자동 WT 분할은 기본 비활성입니다. 필요 시 --wt 옵션으로 실행하세요.",
+    );
+    console.log(
+      `  ${DIM}수동 attach 명령: ${buildManualAttachCommand(state.sessionName)}${RESET}\n`,
+    );
   }
 }

package/hub/team/cli/commands/interrupt.mjs

@@ -1,10 +1,14 @@
 import { sendKeys } from "../../pane.mjs";
 import { DIM, RESET, WHITE, YELLOW } from "../../shared.mjs";
+import { ok, warn } from "../render.mjs";
 import { resolveMember } from "../services/member-selector.mjs";
 import { nativeRequest } from "../services/native-control.mjs";
-import { isNativeMode, isTeamAlive, isWtMode } from "../services/runtime-mode.mjs";
+import {
+  isNativeMode,
+  isTeamAlive,
+  isWtMode,
+} from "../services/runtime-mode.mjs";
 import { loadTeamState } from "../services/state-store.mjs";
-import { ok, warn } from "../render.mjs";
 
 export async function teamInterrupt(args = []) {
   const state = loadTeamState();
@@ -15,17 +19,25 @@ export async function teamInterrupt(args = []) {
 
   const member = resolveMember(state, args[0] || "lead");
   if (!member) {
-    console.log(`\n  사용법: ${WHITE}tfx multi interrupt <lead|이름|번호>${RESET}\n`);
+    console.log(
+      `\n  사용법: ${WHITE}tfx multi interrupt <lead|이름|번호>${RESET}\n`,
+    );
     return;
   }
   if (isWtMode(state)) {
-    console.log(`\n  ${YELLOW}⚠${RESET} wt 모드에서는 pane stdin 주입이 지원되지 않아 interrupt를 자동 전송할 수 없습니다.\n  ${DIM}수동으로 해당 pane에서 Ctrl+C를 입력하세요.${RESET}\n`);
+    console.log(
+      `\n  ${YELLOW}⚠${RESET} wt 모드에서는 pane stdin 주입이 지원되지 않아 interrupt를 자동 전송할 수 없습니다.\n  ${DIM}수동으로 해당 pane에서 Ctrl+C를 입력하세요.${RESET}\n`,
+    );
     return;
   }
 
   if (isNativeMode(state)) {
-    const result = await nativeRequest(state, "/interrupt", { member: member.name });
-    (result?.ok ? ok : warn)(`${member.name} ${result?.ok ? "인터럽트 전송" : "인터럽트 실패"}`);
+    const result = await nativeRequest(state, "/interrupt", {
+      member: member.name,
+    });
+    (result?.ok ? ok : warn)(
+      `${member.name} ${result?.ok ? "인터럽트 전송" : "인터럽트 실패"}`,
+    );
     console.log("");
     return;
   }

package/hub/team/cli/commands/kill.mjs

@@ -1,24 +1,35 @@
 import { closeWtSession, killSession, listSessions } from "../../session.mjs";
 import { DIM, RESET } from "../../shared.mjs";
+import { ok } from "../render.mjs";
 import { nativeRequest } from "../services/native-control.mjs";
-import { isNativeMode, isTeamAlive, isWtMode } from "../services/runtime-mode.mjs";
+import {
+  isNativeMode,
+  isTeamAlive,
+  isWtMode,
+} from "../services/runtime-mode.mjs";
 import { clearTeamState, loadTeamState } from "../services/state-store.mjs";
-import { ok } from "../render.mjs";
 
 export async function teamKill() {
   const state = loadTeamState();
   if (state && isNativeMode(state) && isTeamAlive(state)) {
     await nativeRequest(state, "/stop", {});
-    try { process.kill(state.native.supervisorPid, "SIGTERM"); } catch {}
+    try {
+      process.kill(state.native.supervisorPid, "SIGTERM");
+    } catch {}
     clearTeamState(state.sessionId);
     ok(`종료: ${state.sessionName}`);
     console.log("");
     return;
   }
   if (state && isWtMode(state)) {
-    const closed = closeWtSession({ layout: state?.wt?.layout || state?.layout || "1xN", paneCount: state?.wt?.paneCount ?? (state.members || []).length });
+    const closed = closeWtSession({
+      layout: state?.wt?.layout || state?.layout || "1xN",
+      paneCount: state?.wt?.paneCount ?? (state.members || []).length,
+    });
     clearTeamState(state.sessionId);
-    ok(`종료: ${state.sessionName}${closed ? ` (${closed} panes closed)` : ""}`);
+    ok(
+      `종료: ${state.sessionName}${closed ? ` (${closed} panes closed)` : ""}`,
+    );
     console.log("");
     return;
   }

package/hub/team/cli/commands/list.mjs

@@ -1,13 +1,19 @@
-import { AMBER, BOLD, DIM, GREEN, RESET } from "../../shared.mjs";
 import { listSessions } from "../../session.mjs";
-import { isNativeMode, isTeamAlive, isWtMode } from "../services/runtime-mode.mjs";
+import { AMBER, BOLD, DIM, GREEN, RESET } from "../../shared.mjs";
+import {
+  isNativeMode,
+  isTeamAlive,
+  isWtMode,
+} from "../services/runtime-mode.mjs";
 import { loadTeamState } from "../services/state-store.mjs";
 
 export function teamList() {
   const state = loadTeamState();
   if (state && isTeamAlive(state) && (isNativeMode(state) || isWtMode(state))) {
     console.log(`\n  ${AMBER}${BOLD}⬡ 팀 세션 목록${RESET}\n`);
-    console.log(`    ${GREEN}●${RESET} ${state.sessionName} ${DIM}(${isNativeMode(state) ? "in-process" : "wt"})${RESET}`);
+    console.log(
+      `    ${GREEN}●${RESET} ${state.sessionName} ${DIM}(${isNativeMode(state) ? "in-process" : "wt"})${RESET}`,
+    );
     console.log("");
     return;
   }
@@ -19,6 +25,7 @@ export function teamList() {
   }
 
   console.log(`\n  ${AMBER}${BOLD}⬡ 팀 세션 목록${RESET}\n`);
-  for (const session of sessions) console.log(`    ${GREEN}●${RESET} ${session}`);
+  for (const session of sessions)
+    console.log(`    ${GREEN}●${RESET} ${session}`);
   console.log("");
 }

package/hub/team/cli/commands/send.mjs

@@ -1,10 +1,14 @@
 import { injectPrompt } from "../../pane.mjs";
 import { DIM, RESET, WHITE, YELLOW } from "../../shared.mjs";
+import { ok, warn } from "../render.mjs";
 import { resolveMember } from "../services/member-selector.mjs";
 import { nativeRequest } from "../services/native-control.mjs";
-import { isNativeMode, isTeamAlive, isWtMode } from "../services/runtime-mode.mjs";
+import {
+  isNativeMode,
+  isTeamAlive,
+  isWtMode,
+} from "../services/runtime-mode.mjs";
 import { loadTeamState } from "../services/state-store.mjs";
-import { ok, warn } from "../render.mjs";
 
 export async function teamSend(args = []) {
   const state = loadTeamState();
@@ -16,17 +20,26 @@ export async function teamSend(args = []) {
   const member = resolveMember(state, args[0]);
   const message = args.slice(1).join(" ");
   if (!member || !message) {
-    console.log(`\n  사용법: ${WHITE}tfx multi send <lead|이름|번호> "메시지"${RESET}\n`);
+    console.log(
+      `\n  사용법: ${WHITE}tfx multi send <lead|이름|번호> "메시지"${RESET}\n`,
+    );
     return;
   }
   if (isWtMode(state)) {
-    console.log(`\n  ${YELLOW}⚠${RESET} wt 모드는 pane 프롬프트 자동 주입(send)이 지원되지 않습니다.\n  ${DIM}수동 전달: 선택한 pane에 직접 붙여넣으세요.${RESET}\n`);
+    console.log(
+      `\n  ${YELLOW}⚠${RESET} wt 모드는 pane 프롬프트 자동 주입(send)이 지원되지 않습니다.\n  ${DIM}수동 전달: 선택한 pane에 직접 붙여넣으세요.${RESET}\n`,
+    );
     return;
   }
 
   if (isNativeMode(state)) {
-    const result = await nativeRequest(state, "/send", { member: member.name, text: message });
-    (result?.ok ? ok : warn)(`${member.name}${result?.ok ? "에 메시지 주입 완료" : " 메시지 주입 실패"}`);
+    const result = await nativeRequest(state, "/send", {
+      member: member.name,
+      text: message,
+    });
+    (result?.ok ? ok : warn)(
+      `${member.name}${result?.ok ? "에 메시지 주입 완료" : " 메시지 주입 실패"}`,
+    );
     console.log("");
     return;
   }

package/hub/team/cli/commands/start/index.mjs

@@ -1,31 +1,63 @@
 import { decomposeTask } from "../../../orchestrator.mjs";
-import { hasWindowsTerminal, hasWindowsTerminalSession } from "../../../session.mjs";
-import { AMBER, BOLD, DIM, GREEN, RED, RESET, WHITE } from "../../../shared.mjs";
-import { getDefaultHubUrl, getHubInfo, startHubDaemon } from "../../services/hub-client.mjs";
+import {
+  hasWindowsTerminal,
+  hasWindowsTerminalSession,
+} from "../../../session.mjs";
+import {
+  AMBER,
+  BOLD,
+  DIM,
+  GREEN,
+  RED,
+  RESET,
+  WHITE,
+} from "../../../shared.mjs";
+import { fail, ok, warn } from "../../render.mjs";
+import {
+  getDefaultHubUrl,
+  getHubInfo,
+  startHubDaemon,
+} from "../../services/hub-client.mjs";
 import { ensureTmuxOrExit } from "../../services/runtime-mode.mjs";
 import { saveTeamState } from "../../services/state-store.mjs";
-import { fail, ok, warn } from "../../render.mjs";
 import { parseTeamArgs } from "./parse-args.mjs";
+import { startHeadlessTeam } from "./start-headless.mjs";
 import { startInProcessTeam } from "./start-in-process.mjs";
 import { startMuxTeam } from "./start-mux.mjs";
-import { startHeadlessTeam } from "./start-headless.mjs";
 import { startWtTeam } from "./start-wt.mjs";
 
 function printStartUsage() {
   console.log(`\n  ${AMBER}${BOLD}⬡ tfx multi${RESET}\n`);
   console.log(`  사용법: ${WHITE}tfx multi "작업 설명"${RESET}`);
-  console.log(`          ${WHITE}tfx multi --agents codex,gemini --lead claude "작업"${RESET}`);
-  console.log(`          ${WHITE}tfx multi --teammate-mode headless "작업"${RESET} ${DIM}(psmux 헤드리스, 기본)${RESET}`);
-  console.log(`          ${WHITE}tfx multi --dashboard-layout lite "작업"${RESET} ${DIM}(dashboard-lite 기본 뷰)${RESET}`);
-  console.log(`          ${WHITE}tfx multi --dashboard-layout auto "작업"${RESET} ${DIM}(dashboard viewer 레이아웃 자동)${RESET}`);
-  console.log(`          ${WHITE}tfx multi --dashboard-anchor window "작업"${RESET} ${DIM}(dashboard anchor: window|tab, 기본 window)${RESET}`);
-  console.log(`          ${WHITE}tfx multi --teammate-mode wt "작업"${RESET} ${DIM}(Windows Terminal split-pane)${RESET}`);
-  console.log(`          ${WHITE}tfx multi --teammate-mode in-process "작업"${RESET} ${DIM}(mux 불필요)${RESET}\n`);
+  console.log(
+    `          ${WHITE}tfx multi --agents codex,gemini --lead claude "작업"${RESET}`,
+  );
+  console.log(
+    `          ${WHITE}tfx multi --teammate-mode headless "작업"${RESET} ${DIM}(psmux 헤드리스, 기본)${RESET}`,
+  );
+  console.log(
+    `          ${WHITE}tfx multi --dashboard-layout lite "작업"${RESET} ${DIM}(dashboard-lite 기본 뷰)${RESET}`,
+  );
+  console.log(
+    `          ${WHITE}tfx multi --dashboard-layout auto "작업"${RESET} ${DIM}(dashboard viewer 레이아웃 자동)${RESET}`,
+  );
+  console.log(
+    `          ${WHITE}tfx multi --dashboard-anchor window "작업"${RESET} ${DIM}(dashboard anchor: window|tab, 기본 window)${RESET}`,
+  );
+  console.log(
+    `          ${WHITE}tfx multi --teammate-mode wt "작업"${RESET} ${DIM}(Windows Terminal split-pane)${RESET}`,
+  );
+  console.log(
+    `          ${WHITE}tfx multi --teammate-mode in-process "작업"${RESET} ${DIM}(mux 불필요)${RESET}\n`,
+  );
 }
 
 function printWorkerPreview(agents, subtasks) {
   for (let index = 0; index < subtasks.length; index += 1) {
-    const preview = subtasks[index].length > 44 ? `${subtasks[index].slice(0, 44)}…` : subtasks[index];
+    const preview =
+      subtasks[index].length > 44
+        ? `${subtasks[index].slice(0, 44)}…`
+        : subtasks[index];
     console.log(`    ${DIM}[${agents[index]}-${index + 1}] ${preview}${RESET}`);
   }
   console.log("");
@@ -34,16 +66,40 @@ function printWorkerPreview(agents, subtasks) {
 function renderTmuxInstallHelp() {
   console.log(`\n  ${RED}${BOLD}tmux 미발견${RESET}\n`);
   console.log("  현재 선택한 모드는 tmux 기반 팀세션이 필요합니다.\n");
-  console.log(`  설치:\n    WSL2:   ${WHITE}wsl sudo apt install tmux${RESET}\n    macOS:  ${WHITE}brew install tmux${RESET}\n    Linux:  ${WHITE}apt install tmux${RESET}\n`);
-  console.log(`  Windows에서는 WSL2를 권장합니다:\n    1. ${WHITE}wsl --install${RESET}\n    2. ${WHITE}wsl sudo apt install tmux${RESET}\n    3. ${WHITE}tfx multi "작업"${RESET}\n`);
+  console.log(
+    `  설치:\n    WSL2:   ${WHITE}wsl sudo apt install tmux${RESET}\n    macOS:  ${WHITE}brew install tmux${RESET}\n    Linux:  ${WHITE}apt install tmux${RESET}\n`,
+  );
+  console.log(
+    `  Windows에서는 WSL2를 권장합니다:\n    1. ${WHITE}wsl --install${RESET}\n    2. ${WHITE}wsl sudo apt install tmux${RESET}\n    3. ${WHITE}tfx multi "작업"${RESET}\n`,
+  );
 }
 
 export { parseTeamArgs };
 
 export async function teamStart(args = []) {
-  const { agents, lead, layout, teammateMode, task: rawTask, assigns, autoAttach, progressive, timeoutSec, verbose, dashboard, dashboardLayout, dashboardSize, dashboardAnchor, mcpProfile, model, cwd } = parseTeamArgs(args);
+  const {
+    agents,
+    lead,
+    layout,
+    teammateMode,
+    task: rawTask,
+    assigns,
+    autoAttach,
+    progressive,
+    timeoutSec,
+    verbose,
+    dashboard,
+    dashboardLayout,
+    dashboardSize,
+    dashboardAnchor,
+    mcpProfile,
+    model,
+    cwd,
+  } = parseTeamArgs(args);
   // --assign 사용 시 task를 자동 생성
-  const task = rawTask || (assigns.length > 0 ? assigns.map(a => a.prompt).join(" + ") : "");
+  const task =
+    rawTask ||
+    (assigns.length > 0 ? assigns.map((a) => a.prompt).join(" + ") : "");
   if (!task) return printStartUsage();
 
   console.log(`\n  ${AMBER}${BOLD}⬡ tfx multi${RESET}\n`);
@@ -57,7 +113,12 @@ export async function teamStart(args = []) {
     hub = await getHubInfo();
     if (!hub) {
       process.stdout.write("  Hub 시작 중...");
-      try { hub = await startHubDaemon(); } catch (error) { if (error?.code === "HUB_SERVER_MISSING") fail("hub/server.mjs 없음 — hub 모듈이 설치되지 않음"); }
+      try {
+        hub = await startHubDaemon();
+      } catch (error) {
+        if (error?.code === "HUB_SERVER_MISSING")
+          fail("hub/server.mjs 없음 — hub 모듈이 설치되지 않음");
+      }
       console.log(` ${hub ? `${GREEN}✓${RESET}` : `${RED}✗${RESET}`}`);
       if (!hub) warn("Hub 시작 실패 — 수동으로 실행: tfx hub start");
     } else ok(`Hub: ${DIM}${hub.url}${RESET}`);
@@ -69,26 +130,84 @@ export async function teamStart(args = []) {
   const subtasks = decomposeTask(task, agents.length);
   const hubUrl = hub?.url || getDefaultHubUrl();
   let effectiveMode = teammateMode;
-  if (effectiveMode === "wt" && !hasWindowsTerminal()) { warn("wt.exe 미발견 — in-process 모드로 자동 fallback"); effectiveMode = "in-process"; }
-  if (effectiveMode === "wt" && !hasWindowsTerminalSession()) { warn("WT_SESSION 미감지(Windows Terminal 외부) — in-process 모드로 자동 fallback"); effectiveMode = "in-process"; }
+  if (effectiveMode === "wt" && !hasWindowsTerminal()) {
+    warn("wt.exe 미발견 — in-process 모드로 자동 fallback");
+    effectiveMode = "in-process";
+  }
+  if (effectiveMode === "wt" && !hasWindowsTerminalSession()) {
+    warn(
+      "WT_SESSION 미감지(Windows Terminal 외부) — in-process 모드로 자동 fallback",
+    );
+    effectiveMode = "in-process";
+  }
 
   console.log(`  세션:  ${WHITE}${sessionId}${RESET}`);
   console.log(`  모드:  ${effectiveMode}`);
   console.log(`  리드:  ${AMBER}${lead}${RESET}`);
-  console.log(`  워커:  ${agents.map((agent) => `${AMBER}${agent}${RESET}`).join(", ")}`);
+  console.log(
+    `  워커:  ${agents.map((agent) => `${AMBER}${agent}${RESET}`).join(", ")}`,
+  );
   printWorkerPreview(agents, subtasks);
 
   if (effectiveMode === "tmux") {
-    try { ensureTmuxOrExit(); } catch { return renderTmuxInstallHelp(); }
+    try {
+      ensureTmuxOrExit();
+    } catch {
+      return renderTmuxInstallHelp();
+    }
   }
 
-  const state = effectiveMode === "in-process"
-    ? await startInProcessTeam({ sessionId, task, lead, agents, subtasks, hubUrl })
-    : effectiveMode === "headless"
-      ? await startHeadlessTeam({ sessionId, task, lead, agents, subtasks, layout, assigns, autoAttach, progressive, timeoutSec, verbose, dashboard, dashboardLayout, dashboardSize, dashboardAnchor, mcpProfile, model, cwd })
-      : effectiveMode === "wt"
-        ? await startWtTeam({ sessionId, task, lead, agents, subtasks, layout, hubUrl })
-        : await startMuxTeam({ sessionId, task, lead, agents, subtasks, layout, hubUrl, teammateMode: effectiveMode });
+  const state =
+    effectiveMode === "in-process"
+      ? await startInProcessTeam({
+          sessionId,
+          task,
+          lead,
+          agents,
+          subtasks,
+          hubUrl,
+        })
+      : effectiveMode === "headless"
+        ? await startHeadlessTeam({
+            sessionId,
+            task,
+            lead,
+            agents,
+            subtasks,
+            layout,
+            assigns,
+            autoAttach,
+            progressive,
+            timeoutSec,
+            verbose,
+            dashboard,
+            dashboardLayout,
+            dashboardSize,
+            dashboardAnchor,
+            mcpProfile,
+            model,
+            cwd,
+          })
+        : effectiveMode === "wt"
+          ? await startWtTeam({
+              sessionId,
+              task,
+              lead,
+              agents,
+              subtasks,
+              layout,
+              hubUrl,
+            })
+          : await startMuxTeam({
+              sessionId,
+              task,
+              lead,
+              agents,
+              subtasks,
+              layout,
+              hubUrl,
+              teammateMode: effectiveMode,
+            });
 
   if (!state) return fail("in-process supervisor 시작 실패");
   state.sessionId = sessionId;
@@ -100,7 +219,11 @@ export async function teamStart(args = []) {
     console.log(`  ${DIM}제어: tfx multi send/control/tasks/status${RESET}\n`);
   } else if (effectiveMode === "wt") {
     ok("Windows Terminal wt 팀 시작 완료");
-    console.log(`  ${DIM}현재 pane 기준으로 ${state.layout} 분할 생성됨${RESET}`);
-    console.log(`  ${DIM}wt 모드는 자동 프롬프트 주입/Hub direct 제어(send/control)가 제한됩니다.${RESET}\n`);
+    console.log(
+      `  ${DIM}현재 pane 기준으로 ${state.layout} 분할 생성됨${RESET}`,
+    );
+    console.log(
+      `  ${DIM}wt 모드는 자동 프롬프트 주입/Hub direct 제어(send/control)가 제한됩니다.${RESET}\n`,
+    );
   }
 }