triflux 3.2.0-dev.9 → 3.3.0-dev.1

package/hub/team/cli-team-status.mjs

@@ -1,241 +1,241 @@
-// hub/team/cli-team-status.mjs — team 상태/조회 로직
-import {
-  capturePaneOutput,
-  detectMultiplexer,
-  getSessionAttachedCount,
-  hasWindowsTerminal,
-  hasWindowsTerminalSession,
-  listSessions,
-} from "./session.mjs";
-import { AMBER, BOLD, DIM, GRAY, GREEN, RED, RESET, WHITE } from "./shared.mjs";
-import {
-  TEAM_PROFILE,
-  getDefaultHubUrl,
-  getHubInfo,
-  isNativeMode,
-  isTeamAlive,
-  isWtMode,
-  loadTeamState,
-  nativeGetStatus,
-  ok,
-  saveTeamState,
-} from "./cli-team-common.mjs";
-
-async function fetchHubTaskList(state) {
-  const hubBase = (state?.hubUrl || getDefaultHubUrl()).replace(/\/mcp$/, "");
-  const teamName = state?.native?.teamName || state?.sessionName || null;
-  if (!teamName) return [];
-  try {
-    const res = await fetch(`${hubBase}/bridge/team/task-list`, {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({ team_name: teamName }),
-      signal: AbortSignal.timeout(2000),
-    });
-    const data = await res.json();
-    return data?.ok ? (data.data?.tasks || []) : [];
-  } catch {
-    return [];
-  }
-}
-
-function renderTasks(tasks = []) {
-  if (!tasks.length) {
-    console.log(`\n  ${DIM}태스크 없음${RESET}\n`);
-    return;
-  }
-
-  console.log(`\n  ${AMBER}${BOLD}⬡ Team Tasks${RESET}\n`);
-  for (const t of tasks) {
-    const dep = t.depends_on?.length ? ` ${DIM}(deps: ${t.depends_on.join(",")})${RESET}` : "";
-    const owner = t.owner ? ` ${GRAY}[${t.owner}]${RESET}` : "";
-    console.log(`    ${WHITE}${t.id}${RESET} ${t.status.padEnd(11)} ${t.title}${owner}${dep}`);
-  }
-  console.log("");
-}
-
-export async function teamStatus() {
-  const state = loadTeamState();
-  if (!state) {
-    console.log(`\n  ${DIM}활성 팀 세션 없음${RESET}\n`);
-    return;
-  }
-
-  const alive = isTeamAlive(state);
-  const status = alive ? `${GREEN}● active${RESET}` : `${RED}● dead${RESET}`;
-  const uptime = alive ? `${Math.round((Date.now() - state.startedAt) / 60000)}분` : "-";
-
-  console.log(`\n  ${AMBER}${BOLD}⬡ tfx team${RESET} ${status}\n`);
-  console.log(`    세션:   ${state.sessionName}`);
-  console.log(`    모드:   ${state.teammateMode || "tmux"}`);
-  console.log(`    리드:   ${state.lead || "claude"}`);
-  console.log(`    워커:   ${(state.agents || []).join(", ")}`);
-  console.log(`    Uptime: ${uptime}`);
-  console.log(`    태스크: ${(state.tasks || []).length}`);
-  if (isWtMode(state) && !hasWindowsTerminalSession()) {
-    console.log(`    ${DIM}WT_SESSION 미감지: 생존성은 heuristics로 판정됨${RESET}`);
-  }
-
-  const members = state.members || [];
-  if (members.length) {
-    console.log("");
-    for (const m of members) {
-      const roleTag = m.role === "lead" ? "lead" : "worker";
-      console.log(`    - ${m.name} (${m.cli}) ${DIM}${roleTag}${RESET} ${DIM}${m.pane}${RESET}`);
-    }
-  }
-
-  if (isNativeMode(state) && alive) {
-    const native = await nativeGetStatus(state);
-    const nativeMembers = native?.data?.members || [];
-    if (nativeMembers.length) {
-      console.log("");
-      for (const m of nativeMembers) {
-        console.log(`    • ${m.name}: ${m.status}${m.lastPreview ? ` ${DIM}${m.lastPreview}${RESET}` : ""}`);
-      }
-    }
-  }
-
-  if (alive) {
-    const hubTasks = await fetchHubTaskList(state);
-    if (hubTasks.length > 0) {
-      const completed = hubTasks.filter((t) => t.status === "completed").length;
-      const failed = hubTasks.filter((t) => t.status === "failed").length;
-
-      console.log(`\n  ${BOLD}Hub Tasks${RESET} ${DIM}(${completed}/${hubTasks.length} done)${RESET}`);
-      for (const t of hubTasks) {
-        const icon = t.status === "completed" ? `${GREEN}✓${RESET}`
-          : t.status === "in_progress" ? `${AMBER}●${RESET}`
-          : t.status === "failed" ? `${RED}✗${RESET}`
-          : `${GRAY}○${RESET}`;
-        const owner = t.owner ? ` ${GRAY}[${t.owner}]${RESET}` : "";
-        const subject = t.subject || t.description?.slice(0, 50) || "";
-        console.log(`    ${icon} ${subject}${owner}`);
-      }
-      if (failed > 0) console.log(`    ${RED}⚠ ${failed}건 실패${RESET}`);
-    }
-  }
-
-  console.log("");
-}
-
-export function teamTasks() {
-  const state = loadTeamState();
-  if (!state || !isTeamAlive(state)) {
-    console.log(`\n  ${DIM}활성 팀 세션 없음${RESET}\n`);
-    return;
-  }
-  renderTasks(state.tasks || []);
-}
-
-export function teamTaskUpdate() {
-  const state = loadTeamState();
-  if (!state || !isTeamAlive(state)) {
-    console.log(`\n  ${DIM}활성 팀 세션 없음${RESET}\n`);
-    return;
-  }
-
-  const action = (process.argv[4] || "").toLowerCase();
-  const taskId = (process.argv[5] || "").toUpperCase();
-  const nextStatus = action === "done" || action === "complete" || action === "completed"
-    ? "completed"
-    : action === "progress" || action === "in-progress" || action === "in_progress"
-      ? "in_progress"
-      : action === "pending"
-        ? "pending"
-        : null;
-
-  if (!nextStatus || !taskId) {
-    console.log(`\n  사용법: ${WHITE}tfx team task <pending|progress|done> <T1>${RESET}\n`);
-    return;
-  }
-
-  const tasks = state.tasks || [];
-  const target = tasks.find((t) => String(t.id).toUpperCase() === taskId);
-  if (!target) {
-    console.log(`\n  ${DIM}태스크를 찾을 수 없음: ${taskId}${RESET}\n`);
-    return;
-  }
-
-  target.status = nextStatus;
-  saveTeamState(state);
-  ok(`${target.id} 상태 갱신: ${nextStatus}`);
-  console.log("");
-}
-
+// hub/team/cli-team-status.mjs — team 상태/조회 로직
+import {
+  capturePaneOutput,
+  detectMultiplexer,
+  getSessionAttachedCount,
+  hasWindowsTerminal,
+  hasWindowsTerminalSession,
+  listSessions,
+} from "./session.mjs";
+import { AMBER, BOLD, DIM, GRAY, GREEN, RED, RESET, WHITE } from "./shared.mjs";
+import {
+  TEAM_PROFILE,
+  getDefaultHubUrl,
+  getHubInfo,
+  isNativeMode,
+  isTeamAlive,
+  isWtMode,
+  loadTeamState,
+  nativeGetStatus,
+  ok,
+  saveTeamState,
+} from "./cli-team-common.mjs";
+
+async function fetchHubTaskList(state) {
+  const hubBase = (state?.hubUrl || getDefaultHubUrl()).replace(/\/mcp$/, "");
+  const teamName = state?.native?.teamName || state?.sessionName || null;
+  if (!teamName) return [];
+  try {
+    const res = await fetch(`${hubBase}/bridge/team/task-list`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ team_name: teamName }),
+      signal: AbortSignal.timeout(2000),
+    });
+    const data = await res.json();
+    return data?.ok ? (data.data?.tasks || []) : [];
+  } catch {
+    return [];
+  }
+}
+
+function renderTasks(tasks = []) {
+  if (!tasks.length) {
+    console.log(`\n  ${DIM}태스크 없음${RESET}\n`);
+    return;
+  }
+
+  console.log(`\n  ${AMBER}${BOLD}⬡ Team Tasks${RESET}\n`);
+  for (const t of tasks) {
+    const dep = t.depends_on?.length ? ` ${DIM}(deps: ${t.depends_on.join(",")})${RESET}` : "";
+    const owner = t.owner ? ` ${GRAY}[${t.owner}]${RESET}` : "";
+    console.log(`    ${WHITE}${t.id}${RESET} ${t.status.padEnd(11)} ${t.title}${owner}${dep}`);
+  }
+  console.log("");
+}
+
+export async function teamStatus() {
+  const state = loadTeamState();
+  if (!state) {
+    console.log(`\n  ${DIM}활성 팀 세션 없음${RESET}\n`);
+    return;
+  }
+
+  const alive = isTeamAlive(state);
+  const status = alive ? `${GREEN}● active${RESET}` : `${RED}● dead${RESET}`;
+  const uptime = alive ? `${Math.round((Date.now() - state.startedAt) / 60000)}분` : "-";
+
+  console.log(`\n  ${AMBER}${BOLD}⬡ tfx multi${RESET} ${status}\n`);
+  console.log(`    세션:   ${state.sessionName}`);
+  console.log(`    모드:   ${state.teammateMode || "tmux"}`);
+  console.log(`    리드:   ${state.lead || "claude"}`);
+  console.log(`    워커:   ${(state.agents || []).join(", ")}`);
+  console.log(`    Uptime: ${uptime}`);
+  console.log(`    태스크: ${(state.tasks || []).length}`);
+  if (isWtMode(state) && !hasWindowsTerminalSession()) {
+    console.log(`    ${DIM}WT_SESSION 미감지: 생존성은 heuristics로 판정됨${RESET}`);
+  }
+
+  const members = state.members || [];
+  if (members.length) {
+    console.log("");
+    for (const m of members) {
+      const roleTag = m.role === "lead" ? "lead" : "worker";
+      console.log(`    - ${m.name} (${m.cli}) ${DIM}${roleTag}${RESET} ${DIM}${m.pane}${RESET}`);
+    }
+  }
+
+  if (isNativeMode(state) && alive) {
+    const native = await nativeGetStatus(state);
+    const nativeMembers = native?.data?.members || [];
+    if (nativeMembers.length) {
+      console.log("");
+      for (const m of nativeMembers) {
+        console.log(`    • ${m.name}: ${m.status}${m.lastPreview ? ` ${DIM}${m.lastPreview}${RESET}` : ""}`);
+      }
+    }
+  }
+
+  if (alive) {
+    const hubTasks = await fetchHubTaskList(state);
+    if (hubTasks.length > 0) {
+      const completed = hubTasks.filter((t) => t.status === "completed").length;
+      const failed = hubTasks.filter((t) => t.status === "failed").length;
+
+      console.log(`\n  ${BOLD}Hub Tasks${RESET} ${DIM}(${completed}/${hubTasks.length} done)${RESET}`);
+      for (const t of hubTasks) {
+        const icon = t.status === "completed" ? `${GREEN}✓${RESET}`
+          : t.status === "in_progress" ? `${AMBER}●${RESET}`
+          : t.status === "failed" ? `${RED}✗${RESET}`
+          : `${GRAY}○${RESET}`;
+        const owner = t.owner ? ` ${GRAY}[${t.owner}]${RESET}` : "";
+        const subject = t.subject || t.description?.slice(0, 50) || "";
+        console.log(`    ${icon} ${subject}${owner}`);
+      }
+      if (failed > 0) console.log(`    ${RED}⚠ ${failed}건 실패${RESET}`);
+    }
+  }
+
+  console.log("");
+}
+
+export function teamTasks() {
+  const state = loadTeamState();
+  if (!state || !isTeamAlive(state)) {
+    console.log(`\n  ${DIM}활성 팀 세션 없음${RESET}\n`);
+    return;
+  }
+  renderTasks(state.tasks || []);
+}
+
+export function teamTaskUpdate() {
+  const state = loadTeamState();
+  if (!state || !isTeamAlive(state)) {
+    console.log(`\n  ${DIM}활성 팀 세션 없음${RESET}\n`);
+    return;
+  }
+
+  const action = (process.argv[4] || "").toLowerCase();
+  const taskId = (process.argv[5] || "").toUpperCase();
+  const nextStatus = action === "done" || action === "complete" || action === "completed"
+    ? "completed"
+    : action === "progress" || action === "in-progress" || action === "in_progress"
+      ? "in_progress"
+      : action === "pending"
+        ? "pending"
+        : null;
+
+  if (!nextStatus || !taskId) {
+    console.log(`\n  사용법: ${WHITE}tfx multi task <pending|progress|done> <T1>${RESET}\n`);
+    return;
+  }
+
+  const tasks = state.tasks || [];
+  const target = tasks.find((t) => String(t.id).toUpperCase() === taskId);
+  if (!target) {
+    console.log(`\n  ${DIM}태스크를 찾을 수 없음: ${taskId}${RESET}\n`);
+    return;
+  }
+
+  target.status = nextStatus;
+  saveTeamState(state);
+  ok(`${target.id} 상태 갱신: ${nextStatus}`);
+  console.log("");
+}
+
 export async function teamDebug() {
-  const state = loadTeamState();
-  const linesIdx = process.argv.findIndex((a) => a === "--lines" || a === "-n");
-  const lines = linesIdx !== -1 ? Math.max(3, parseInt(process.argv[linesIdx + 1] || "20", 10) || 20) : 20;
-  const mux = detectMultiplexer() || "none";
-  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(`    mux:       ${mux}`);
-  console.log(`    hub-pid:   ${hub ? `${hub.pid}` : "-"}`);
-  console.log(`    hub-url:   ${hub?.url || "-"}`);
-
-  const sessions = listSessions();
-  console.log(`    sessions:  ${sessions.length ? sessions.join(", ") : "-"}`);
-
-  if (!state) {
-    console.log(`\n  ${DIM}team-state 없음 (활성 세션 없음)${RESET}\n`);
-    return;
-  }
-
-  console.log(`\n  ${BOLD}state${RESET}`);
-  console.log(`    session:   ${state.sessionName}`);
-  console.log(`    profile:   ${state.profile || TEAM_PROFILE}`);
-  console.log(`    mode:      ${state.teammateMode || "tmux"}`);
-  console.log(`    lead:      ${state.lead}`);
-  console.log(`    agents:    ${(state.agents || []).join(", ")}`);
-  console.log(`    alive:     ${isTeamAlive(state) ? "yes" : "no"}`);
-  const attached = getSessionAttachedCount(state.sessionName);
-  console.log(`    attached:  ${attached == null ? "-" : attached}`);
-
-  if (isWtMode(state)) {
-    const wtState = state.wt || {};
-    console.log(`\n  ${BOLD}wt-session${RESET}`);
-    console.log(`    window:    ${wtState.windowId ?? 0}`);
-    console.log(`    layout:    ${wtState.layout || state.layout || "-"}`);
-    console.log(`    panes:     ${wtState.paneCount ?? (state.members || []).length}`);
-    console.log(`    wt.exe:    ${hasWindowsTerminal() ? "yes" : "no"}`);
-    console.log(`    WT_SESSION:${hasWindowsTerminalSession() ? "yes" : "no"}`);
-    console.log("");
-    return;
-  }
-
-  if (isNativeMode(state)) {
-    const native = await nativeGetStatus(state);
-    const members = native?.data?.members || [];
-    console.log(`\n  ${BOLD}native-members${RESET}`);
-    if (!members.length) {
-      console.log(`    ${DIM}(no data)${RESET}`);
-    } else {
-      for (const m of members) {
-        console.log(`    - ${m.name}: ${m.status}${m.lastPreview ? ` ${DIM}${m.lastPreview}${RESET}` : ""}`);
-      }
-    }
-    console.log("");
-    return;
-  }
-
-  const members = state.members || [];
-  console.log(`\n  ${BOLD}pane-tail${RESET} ${DIM}(last ${lines} lines)${RESET}`);
-  if (!members.length) {
-    console.log(`    ${DIM}(members 없음)${RESET}`);
-  } else {
-    for (const m of members) {
-      const tail = capturePaneOutput(m.pane, lines) || "(empty)";
-      console.log(`\n    [${m.name}] ${m.pane}`);
-      const tailLines = tail.split("\n").slice(-lines);
-      for (const line of tailLines) {
-        console.log(`      ${line}`);
-      }
-    }
+  const state = loadTeamState();
+  const linesIdx = process.argv.findIndex((a) => a === "--lines" || a === "-n");
+  const lines = linesIdx !== -1 ? Math.max(3, parseInt(process.argv[linesIdx + 1] || "20", 10) || 20) : 20;
+  const mux = detectMultiplexer() || "none";
+  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(`    mux:       ${mux}`);
+  console.log(`    hub-pid:   ${hub ? `${hub.pid}` : "-"}`);
+  console.log(`    hub-url:   ${hub?.url || "-"}`);
+
+  const sessions = listSessions();
+  console.log(`    sessions:  ${sessions.length ? sessions.join(", ") : "-"}`);
+
+  if (!state) {
+    console.log(`\n  ${DIM}team-state 없음 (활성 세션 없음)${RESET}\n`);
+    return;
+  }
+
+  console.log(`\n  ${BOLD}state${RESET}`);
+  console.log(`    session:   ${state.sessionName}`);
+  console.log(`    profile:   ${state.profile || TEAM_PROFILE}`);
+  console.log(`    mode:      ${state.teammateMode || "tmux"}`);
+  console.log(`    lead:      ${state.lead}`);
+  console.log(`    agents:    ${(state.agents || []).join(", ")}`);
+  console.log(`    alive:     ${isTeamAlive(state) ? "yes" : "no"}`);
+  const attached = getSessionAttachedCount(state.sessionName);
+  console.log(`    attached:  ${attached == null ? "-" : attached}`);
+
+  if (isWtMode(state)) {
+    const wtState = state.wt || {};
+    console.log(`\n  ${BOLD}wt-session${RESET}`);
+    console.log(`    window:    ${wtState.windowId ?? 0}`);
+    console.log(`    layout:    ${wtState.layout || state.layout || "-"}`);
+    console.log(`    panes:     ${wtState.paneCount ?? (state.members || []).length}`);
+    console.log(`    wt.exe:    ${hasWindowsTerminal() ? "yes" : "no"}`);
+    console.log(`    WT_SESSION:${hasWindowsTerminalSession() ? "yes" : "no"}`);
+    console.log("");
+    return;
+  }
+
+  if (isNativeMode(state)) {
+    const native = await nativeGetStatus(state);
+    const members = native?.data?.members || [];
+    console.log(`\n  ${BOLD}native-members${RESET}`);
+    if (!members.length) {
+      console.log(`    ${DIM}(no data)${RESET}`);
+    } else {
+      for (const m of members) {
+        console.log(`    - ${m.name}: ${m.status}${m.lastPreview ? ` ${DIM}${m.lastPreview}${RESET}` : ""}`);
+      }
+    }
+    console.log("");
+    return;
+  }
+
+  const members = state.members || [];
+  console.log(`\n  ${BOLD}pane-tail${RESET} ${DIM}(last ${lines} lines)${RESET}`);
+  if (!members.length) {
+    console.log(`    ${DIM}(members 없음)${RESET}`);
+  } else {
+    for (const m of members) {
+      const tail = capturePaneOutput(m.pane, lines) || "(empty)";
+      console.log(`\n    [${m.name}] ${m.pane}`);
+      const tailLines = tail.split("\n").slice(-lines);
+      for (const line of tailLines) {
+        console.log(`      ${line}`);
+      }
+    }
   }
   console.log("");
 }
@@ -266,4 +266,4 @@ export function teamList() {
   }
   console.log("");
 }
-
+

package/hub/team/cli.mjs

@@ -1,5 +1,5 @@
-// hub/team/cli.mjs — team CLI UI/네비게이션 진입점
-// bin/triflux.mjs에서 import하여 사용
+// hub/team/cli.mjs — team CLI UI/네비게이션 진입점
+// bin/triflux.mjs에서 import하여 사용
 import { AMBER, GRAY, DIM, BOLD, RESET, WHITE } from "./shared.mjs";
 import { TEAM_SUBCOMMANDS } from "./cli-team-common.mjs";
 import { teamStart } from "./cli-team-start.mjs";
@@ -13,87 +13,87 @@ import {
   teamKill,
   teamSend,
 } from "./cli-team-control.mjs";
-
-function teamHelp() {
-  console.log(`
-  ${AMBER}${BOLD}⬡ tfx team${RESET} ${DIM}멀티-CLI 팀 모드 (Lead + Teammates)${RESET}
-
-  ${BOLD}시작${RESET}
-    ${WHITE}tfx team "작업 설명"${RESET}
-    ${WHITE}tfx team --agents codex,gemini --lead claude "작업"${RESET}
-    ${WHITE}tfx team --teammate-mode tmux "작업"${RESET}
-    ${WHITE}tfx team --teammate-mode wt "작업"${RESET}   ${DIM}(Windows Terminal split-pane)${RESET}
-    ${WHITE}tfx team --layout 1xN "작업"${RESET}               ${DIM}(세로 분할 컬럼)${RESET}
-    ${WHITE}tfx team --layout Nx1 "작업"${RESET}               ${DIM}(가로 분할 스택)${RESET}
-    ${WHITE}tfx team --teammate-mode in-process "작업"${RESET} ${DIM}(tmux 불필요)${RESET}
-
-  ${BOLD}제어${RESET}
-    ${WHITE}tfx team status${RESET}                      ${GRAY}현재 팀 상태${RESET}
-    ${WHITE}tfx team debug${RESET} ${DIM}[--lines 30]${RESET}          ${GRAY}강화 디버그 출력(환경/세션/pane tail)${RESET}
-    ${WHITE}tfx team tasks${RESET}                       ${GRAY}공유 태스크 목록${RESET}
-    ${WHITE}tfx team task${RESET} ${DIM}<pending|progress|done> <T1>${RESET} ${GRAY}태스크 상태 갱신${RESET}
-    ${WHITE}tfx team attach${RESET} ${DIM}[--wt]${RESET}               ${GRAY}세션 재연결 (WT 분할은 opt-in)${RESET}
-    ${WHITE}tfx team focus${RESET} ${DIM}<lead|이름|번호> [--wt]${RESET} ${GRAY}특정 팀메이트 포커스${RESET}
-    ${WHITE}tfx team send${RESET} ${DIM}<lead|이름|번호> "msg"${RESET} ${GRAY}팀메이트에 메시지 주입${RESET}
-    ${WHITE}tfx team interrupt${RESET} ${DIM}<대상>${RESET}            ${GRAY}팀메이트 인터럽트(C-c)${RESET}
-    ${WHITE}tfx team control${RESET} ${DIM}<대상> <cmd>${RESET}        ${GRAY}리드 제어명령(interrupt|stop|pause|resume)${RESET}
-    ${WHITE}tfx team stop${RESET}                        ${GRAY}graceful 종료${RESET}
-    ${WHITE}tfx team kill${RESET}                        ${GRAY}모든 팀 세션 강제 종료${RESET}
-    ${WHITE}tfx team list${RESET}                        ${GRAY}활성 세션 목록${RESET}
-
-  ${BOLD}키 조작(Claude teammate 스타일, tmux 모드)${RESET}
-    ${WHITE}Shift+Down${RESET}  ${GRAY}다음 팀메이트${RESET}
-    ${WHITE}Shift+Tab${RESET}   ${GRAY}이전 팀메이트 (권장)${RESET}
-    ${WHITE}Shift+Left${RESET}  ${GRAY}이전 팀메이트 (대체)${RESET}
-    ${WHITE}Shift+Up${RESET}    ${GRAY}미지원 (Claude Code가 캡처 불가, scroll-up 충돌)${RESET}
-    ${WHITE}Escape${RESET}      ${GRAY}현재 팀메이트 인터럽트${RESET}
-    ${WHITE}Ctrl+T${RESET}      ${GRAY}태스크 목록 토글${RESET}
-`);
-}
-
-/**
- * tfx team 서브커맨드 라우터
- * bin/triflux.mjs에서 호출
- */
-export async function cmdTeam() {
-  const rawSub = process.argv[3];
-  const sub = typeof rawSub === "string" ? rawSub.toLowerCase() : rawSub;
-
-  switch (sub) {
-    case "status":
-      return teamStatus();
-    case "debug":
-      return teamDebug();
-    case "tasks":
-      return teamTasks();
-    case "task":
-      return teamTaskUpdate();
-    case "attach":
-      return teamAttach();
-    case "focus":
-      return teamFocus();
-    case "interrupt":
-      return teamInterrupt();
-    case "control":
-      return teamControl();
-    case "stop":
-      return teamStop();
-    case "kill":
-      return teamKill();
-    case "send":
-      return teamSend();
-    case "list":
-      return teamList();
-    case "help":
-    case "--help":
-    case "-h":
-      return teamHelp();
-    case undefined:
-      return teamHelp();
-    default:
-      if (typeof sub === "string" && !sub.startsWith("-") && TEAM_SUBCOMMANDS.has(sub)) {
-        return teamHelp();
-      }
-      return teamStart();
-  }
-}
+
+function teamHelp() {
+  console.log(`
+  ${AMBER}${BOLD}⬡ tfx multi${RESET} ${DIM}멀티-CLI 팀 모드 (Lead + Teammates)${RESET}
+
+  ${BOLD}시작${RESET}
+    ${WHITE}tfx multi "작업 설명"${RESET}
+    ${WHITE}tfx multi --agents codex,gemini --lead claude "작업"${RESET}
+    ${WHITE}tfx multi --teammate-mode tmux "작업"${RESET}
+    ${WHITE}tfx multi --teammate-mode wt "작업"${RESET}   ${DIM}(Windows Terminal split-pane)${RESET}
+    ${WHITE}tfx multi --layout 1xN "작업"${RESET}               ${DIM}(세로 분할 컬럼)${RESET}
+    ${WHITE}tfx multi --layout Nx1 "작업"${RESET}               ${DIM}(가로 분할 스택)${RESET}
+    ${WHITE}tfx multi --teammate-mode in-process "작업"${RESET} ${DIM}(tmux 불필요)${RESET}
+
+  ${BOLD}제어${RESET}
+    ${WHITE}tfx multi status${RESET}                      ${GRAY}현재 팀 상태${RESET}
+    ${WHITE}tfx multi debug${RESET} ${DIM}[--lines 30]${RESET}          ${GRAY}강화 디버그 출력(환경/세션/pane tail)${RESET}
+    ${WHITE}tfx multi tasks${RESET}                       ${GRAY}공유 태스크 목록${RESET}
+    ${WHITE}tfx multi task${RESET} ${DIM}<pending|progress|done> <T1>${RESET} ${GRAY}태스크 상태 갱신${RESET}
+    ${WHITE}tfx multi attach${RESET} ${DIM}[--wt]${RESET}               ${GRAY}세션 재연결 (WT 분할은 opt-in)${RESET}
+    ${WHITE}tfx multi focus${RESET} ${DIM}<lead|이름|번호> [--wt]${RESET} ${GRAY}특정 팀메이트 포커스${RESET}
+    ${WHITE}tfx multi send${RESET} ${DIM}<lead|이름|번호> "msg"${RESET} ${GRAY}팀메이트에 메시지 주입${RESET}
+    ${WHITE}tfx multi interrupt${RESET} ${DIM}<대상>${RESET}            ${GRAY}팀메이트 인터럽트(C-c)${RESET}
+    ${WHITE}tfx multi control${RESET} ${DIM}<대상> <cmd>${RESET}        ${GRAY}리드 제어명령(interrupt|stop|pause|resume)${RESET}
+    ${WHITE}tfx multi stop${RESET}                        ${GRAY}graceful 종료${RESET}
+    ${WHITE}tfx multi kill${RESET}                        ${GRAY}모든 팀 세션 강제 종료${RESET}
+    ${WHITE}tfx multi list${RESET}                        ${GRAY}활성 세션 목록${RESET}
+
+  ${BOLD}키 조작(Claude teammate 스타일, tmux 모드)${RESET}
+    ${WHITE}Shift+Down${RESET}  ${GRAY}다음 팀메이트${RESET}
+    ${WHITE}Shift+Tab${RESET}   ${GRAY}이전 팀메이트 (권장)${RESET}
+    ${WHITE}Shift+Left${RESET}  ${GRAY}이전 팀메이트 (대체)${RESET}
+    ${WHITE}Shift+Up${RESET}    ${GRAY}미지원 (Claude Code가 캡처 불가, scroll-up 충돌)${RESET}
+    ${WHITE}Escape${RESET}      ${GRAY}현재 팀메이트 인터럽트${RESET}
+    ${WHITE}Ctrl+T${RESET}      ${GRAY}태스크 목록 토글${RESET}
+`);
+}
+
+/**
+ * tfx multi 서브커맨드 라우터
+ * bin/triflux.mjs에서 호출
+ */
+export async function cmdTeam() {
+  const rawSub = process.argv[3];
+  const sub = typeof rawSub === "string" ? rawSub.toLowerCase() : rawSub;
+
+  switch (sub) {
+    case "status":
+      return teamStatus();
+    case "debug":
+      return teamDebug();
+    case "tasks":
+      return teamTasks();
+    case "task":
+      return teamTaskUpdate();
+    case "attach":
+      return teamAttach();
+    case "focus":
+      return teamFocus();
+    case "interrupt":
+      return teamInterrupt();
+    case "control":
+      return teamControl();
+    case "stop":
+      return teamStop();
+    case "kill":
+      return teamKill();
+    case "send":
+      return teamSend();
+    case "list":
+      return teamList();
+    case "help":
+    case "--help":
+    case "-h":
+      return teamHelp();
+    case undefined:
+      return teamHelp();
+    default:
+      if (typeof sub === "string" && !sub.startsWith("-") && TEAM_SUBCOMMANDS.has(sub)) {
+        return teamHelp();
+      }
+      return teamStart();
+  }
+}