triflux 3.2.0-dev.3 → 3.2.0-dev.6

package/hub/team/cli.mjs

@@ -1,36 +1,44 @@
 // hub/team/cli.mjs — tfx team CLI 진입점
 // bin/triflux.mjs에서 import하여 사용
-import { existsSync, readFileSync, writeFileSync, mkdirSync, unlinkSync } from "node:fs";
-import { join, dirname } from "node:path";
-import { homedir } from "node:os";
-import { execSync, spawn } from "node:child_process";
-
-import {
-  createSession,
-  createWtSession,
-  attachSession,
-  resolveAttachCommand,
-  killSession,
-  closeWtSession,
-  sessionExists,
-  getSessionAttachedCount,
-  listSessions,
-  capturePaneOutput,
-  focusPane,
-  focusWtPane,
-  configureTeammateKeybindings,
-  detectMultiplexer,
-  hasWindowsTerminal,
-  hasWindowsTerminalSession,
-} from "./session.mjs";
+import { existsSync, readFileSync, writeFileSync, mkdirSync, unlinkSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { homedir } from "node:os";
+import { spawn } from "node:child_process";
+
+import {
+  createSession,
+  createWtSession,
+  attachSession,
+  resolveAttachCommand,
+  killSession,
+  closeWtSession,
+  sessionExists,
+  getSessionAttachedCount,
+  listSessions,
+  capturePaneOutput,
+  focusPane,
+  focusWtPane,
+  configureTeammateKeybindings,
+  detectMultiplexer,
+  hasWindowsTerminal,
+  hasWindowsTerminalSession,
+} from "./session.mjs";
 import { buildCliCommand, startCliInPane, injectPrompt, sendKeys } from "./pane.mjs";
 import { orchestrate, decomposeTask, buildLeadPrompt, buildPrompt } from "./orchestrator.mjs";
 
 // ── 상수 ──
-const PKG_ROOT = dirname(dirname(dirname(new URL(import.meta.url).pathname))).replace(/^\/([A-Z]:)/, "$1");
-const HUB_PID_DIR = join(homedir(), ".claude", "cache", "tfx-hub");
-const HUB_PID_FILE = join(HUB_PID_DIR, "hub.pid");
-const TEAM_STATE_FILE = join(HUB_PID_DIR, "team-state.json");
+const PKG_ROOT = dirname(dirname(dirname(new URL(import.meta.url).pathname))).replace(/^\/([A-Z]:)/, "$1");
+const HUB_PID_DIR = join(homedir(), ".claude", "cache", "tfx-hub");
+const HUB_PID_FILE = join(HUB_PID_DIR, "hub.pid");
+const LOOPBACK_HOSTS = new Set(["127.0.0.1", "localhost", "::1"]);
+const TEAM_PROFILE = (() => {
+  const raw = String(process.env.TFX_TEAM_PROFILE || "team").trim().toLowerCase();
+  return raw === "codex-team" ? "codex-team" : "team";
+})();
+const TEAM_STATE_FILE = join(
+  HUB_PID_DIR,
+  TEAM_PROFILE === "codex-team" ? "team-state-codex-team.json" : "team-state.json",
+);
 
 const TEAM_SUBCOMMANDS = new Set([
   "status", "attach", "stop", "kill", "send", "list", "help", "tasks", "task", "focus", "interrupt", "control", "debug",
@@ -61,66 +69,163 @@ function loadTeamState() {
   }
 }
 
-function saveTeamState(state) {
-  mkdirSync(HUB_PID_DIR, { recursive: true });
-  writeFileSync(TEAM_STATE_FILE, JSON.stringify(state, null, 2) + "\n");
-}
-
-function clearTeamState() {
-  try { unlinkSync(TEAM_STATE_FILE); } catch {}
-}
-
-// ── Hub 유틸 ──
+function saveTeamState(state) {
+  mkdirSync(HUB_PID_DIR, { recursive: true });
+  const nextState = { ...state, profile: TEAM_PROFILE };
+  writeFileSync(TEAM_STATE_FILE, JSON.stringify(nextState, null, 2) + "\n");
+}
 
-function getHubInfo() {
-  if (!existsSync(HUB_PID_FILE)) return null;
-  try {
-    const info = JSON.parse(readFileSync(HUB_PID_FILE, "utf8"));
-    process.kill(info.pid, 0); // 프로세스 생존 확인
-    return info;
-  } catch {
+function clearTeamState() {
+  try { unlinkSync(TEAM_STATE_FILE); } catch {}
+}
+
+// ── Hub 유틸 ──
+
+function formatHostForUrl(host) {
+  return host.includes(":") ? `[${host}]` : host;
+}
+
+function buildHubBaseUrl(host, port) {
+  return `http://${formatHostForUrl(host)}:${port}`;
+}
+
+function getDefaultHubPort() {
+  const envPortRaw = Number(process.env.TFX_HUB_PORT || "27888");
+  return Number.isFinite(envPortRaw) && envPortRaw > 0 ? envPortRaw : 27888;
+}
+
+function getDefaultHubUrl() {
+  return `${buildHubBaseUrl("127.0.0.1", getDefaultHubPort())}/mcp`;
+}
+
+function getDefaultHubBase() {
+  return getDefaultHubUrl().replace(/\/mcp$/, "");
+}
+
+function normalizeLoopbackHost(host) {
+  if (typeof host !== "string") return "127.0.0.1";
+  const candidate = host.trim();
+  return LOOPBACK_HOSTS.has(candidate) ? candidate : "127.0.0.1";
+}
+
+async function probeHubStatus(host, port, timeoutMs = 1500) {
+  try {
+    const res = await fetch(`${buildHubBaseUrl(host, port)}/status`, {
+      signal: AbortSignal.timeout(timeoutMs),
+    });
+    if (!res.ok) return null;
+    const data = await res.json();
+    return data?.hub ? data : null;
+  } catch {
+    return null;
+  }
+}
+
+async function getHubInfo() {
+  const probePort = getDefaultHubPort();
+
+  if (existsSync(HUB_PID_FILE)) {
+    try {
+      const raw = JSON.parse(readFileSync(HUB_PID_FILE, "utf8"));
+      const pid = Number(raw?.pid);
+      if (!Number.isFinite(pid) || pid <= 0) throw new Error("invalid pid");
+      process.kill(pid, 0); // 프로세스 생존 확인
+      const host = normalizeLoopbackHost(raw?.host);
+      const port = Number(raw.port) || 27888;
+      const status = await probeHubStatus(host, port, 1200);
+      if (!status) {
+        // transient timeout/응답 지연은 stale로 단정하지 않고 기존 PID 정보를 유지한다.
+        return {
+          ...raw,
+          pid,
+          host,
+          port,
+          url: `${buildHubBaseUrl(host, port)}/mcp`,
+          degraded: true,
+        };
+      }
+      return {
+        ...raw,
+        pid,
+        host,
+        port,
+        url: `${buildHubBaseUrl(host, port)}/mcp`,
+      };
+    } catch {
+      try { unlinkSync(HUB_PID_FILE); } catch {}
+    }
+  }
+
+  // PID 파일이 없거나 stale인 경우에도 실제 Hub가 떠 있으면 재사용
+  const candidates = Array.from(new Set([probePort, 27888]));
+  for (const portCandidate of candidates) {
+    const data = await probeHubStatus("127.0.0.1", portCandidate, 1200);
+    if (!data) continue;
+    const port = Number(data.port) || portCandidate;
+    const pid = Number(data.pid);
+    const recovered = {
+      pid: Number.isFinite(pid) ? pid : null,
+      host: "127.0.0.1",
+      port,
+      url: `${buildHubBaseUrl("127.0.0.1", port)}/mcp`,
+      discovered: true,
+    };
+    if (Number.isFinite(recovered.pid) && recovered.pid > 0) {
+      try {
+        mkdirSync(HUB_PID_DIR, { recursive: true });
+        writeFileSync(HUB_PID_FILE, JSON.stringify({
+          pid: recovered.pid,
+          port: recovered.port,
+          host: recovered.host,
+          url: recovered.url,
+          started: Date.now(),
+        }));
+      } catch {}
+    }
+    return recovered;
+  }
+  return null;
+}
+
+async function startHubDaemon() {
+  const serverPath = join(PKG_ROOT, "hub", "server.mjs");
+  if (!existsSync(serverPath)) {
+    fail("hub/server.mjs 없음 — hub 모듈이 설치되지 않음");
     return null;
   }
-}
 
-function startHubDaemon() {
-  const serverPath = join(PKG_ROOT, "hub", "server.mjs");
-  if (!existsSync(serverPath)) {
-    fail("hub/server.mjs 없음 — hub 모듈이 설치되지 않음");
-    return null;
-  }
+  const child = spawn(process.execPath, [serverPath], {
+    env: { ...process.env },
+    stdio: "ignore",
+    detached: true,
+  });
+  child.unref();
+
+  const expectedPort = getDefaultHubPort();
+
+  // Hub 상태 확인 (최대 3초 대기)
+  const deadline = Date.now() + 3000;
+  while (Date.now() < deadline) {
+    const info = await getHubInfo();
+    if (info && info.port === expectedPort) return info;
+    await new Promise((r) => setTimeout(r, 100));
+  }
+  return null;
+}
 
-  const child = spawn(process.execPath, [serverPath], {
-    env: { ...process.env },
-    stdio: "ignore",
-    detached: true,
-  });
-  child.unref();
+// ── 인자 파싱 ──
 
-  // PID 파일 확인 (최대 3초 대기)
-  const deadline = Date.now() + 3000;
-  while (Date.now() < deadline) {
-    if (existsSync(HUB_PID_FILE)) {
-      return JSON.parse(readFileSync(HUB_PID_FILE, "utf8"));
-    }
-    execSync('node -e "setTimeout(()=>{},100)"', { stdio: "ignore", timeout: 500 });
+function normalizeTeammateMode(mode = "auto") {
+  const raw = String(mode).toLowerCase();
+  if (raw === "inline" || raw === "native") return "in-process";
+  if (raw === "in-process" || raw === "tmux" || raw === "wt") return raw;
+  if (raw === "windows-terminal" || raw === "windows_terminal") return "wt";
+  if (raw === "auto") {
+    return process.env.TMUX ? "tmux" : "in-process";
   }
-  return null;
+  return "in-process";
 }
 
-// ── 인자 파싱 ──
-
-function normalizeTeammateMode(mode = "auto") {
-  const raw = String(mode).toLowerCase();
-  if (raw === "inline" || raw === "native") return "in-process";
-  if (raw === "in-process" || raw === "tmux" || raw === "wt") return raw;
-  if (raw === "windows-terminal" || raw === "windows_terminal") return "wt";
-  if (raw === "auto") {
-    return process.env.TMUX ? "tmux" : "in-process";
-  }
-  return "in-process";
-}
-
 function normalizeLayout(layout = "2x2") {
   const raw = String(layout).toLowerCase();
   if (raw === "2x2" || raw === "grid") return "2x2";
@@ -183,8 +288,8 @@ function ensureTmuxOrExit() {
   process.exit(1);
 }
 
-async function launchAttachInWindowsTerminal(sessionName) {
-  if (!hasWindowsTerminal()) return false;
+async function launchAttachInWindowsTerminal(sessionName) {
+  if (!hasWindowsTerminal()) return false;
 
   let attachSpec;
   try {
@@ -244,10 +349,10 @@ function wantsWtAttachFallback() {
     || process.env.TFX_ATTACH_WT_AUTO === "1";
 }
 
-function toAgentId(cli, target) {
-  const suffix = String(target).split(/[:.]/).pop();
-  return `${cli}-${suffix}`;
-}
+function toAgentId(cli, target) {
+  const suffix = String(target).split(/[:.]/).pop();
+  return `${cli}-${suffix}`;
+}
 
 function buildNativeCliCommand(cli) {
   switch (cli) {
@@ -303,11 +408,11 @@ function resolveMember(state, selector) {
     if (workerIdx >= 0 && workerIdx < workers.length) return workers[workerIdx];
   }
 
-  const n = parseInt(selector, 10);
-  if (!Number.isNaN(n)) {
-    // 하위 호환: pane 번호 우선
-    const byPane = members.find((m) => m.pane?.endsWith(`.${n}`) || m.pane?.endsWith(`:${n}`));
-    if (byPane) return byPane;
+  const n = parseInt(selector, 10);
+  if (!Number.isNaN(n)) {
+    // 하위 호환: pane 번호 우선
+    const byPane = members.find((m) => m.pane?.endsWith(`.${n}`) || m.pane?.endsWith(`:${n}`));
+    if (byPane) return byPane;
 
     // teammate 스타일: 1-based 인덱스
     if (n >= 1 && n <= members.length) return members[n - 1];
@@ -316,8 +421,8 @@ function resolveMember(state, selector) {
   return null;
 }
 
-async function publishLeadControl(state, targetMember, command, reason = "") {
-  const hubBase = (state?.hubUrl || "http://127.0.0.1:27888/mcp").replace(/\/mcp$/, "");
+async function publishLeadControl(state, targetMember, command, reason = "") {
+  const hubBase = (state?.hubUrl || getDefaultHubUrl()).replace(/\/mcp$/, "");
   const leadAgent = (state?.members || []).find((m) => m.role === "lead")?.agentId || "lead";
 
   const payload = {
@@ -343,27 +448,29 @@ async function publishLeadControl(state, targetMember, command, reason = "") {
   }
 }
 
-function isNativeMode(state) {
-  return state?.teammateMode === "in-process" && !!state?.native?.controlUrl;
-}
-
-function isWtMode(state) {
-  return state?.teammateMode === "wt";
-}
+function isNativeMode(state) {
+  return state?.teammateMode === "in-process" && !!state?.native?.controlUrl;
+}
+
+function isWtMode(state) {
+  return state?.teammateMode === "wt";
+}
 
 function isTeamAlive(state) {
   if (!state) return false;
-  if (isNativeMode(state)) {
-    try {
-      process.kill(state.native.supervisorPid, 0);
-      return true;
-    } catch {
-      return false;
-    }
-  }
+  if (isNativeMode(state)) {
+    try {
+      process.kill(state.native.supervisorPid, 0);
+      return true;
+    } catch {
+      return false;
+    }
+  }
   if (isWtMode(state)) {
-    // WT pane 상태를 신뢰성 있게 조회할 API가 없어 세션 환경/실행기 존재 여부로 판정
-    return hasWindowsTerminal() && hasWindowsTerminalSession();
+    // WT pane 상태를 신뢰성 있게 조회할 API가 없어, WT_SESSION은 힌트로만 사용한다.
+    if (!hasWindowsTerminal()) return false;
+    if (hasWindowsTerminalSession()) return true;
+    return Array.isArray(state.members) && state.members.length > 0;
   }
   return sessionExists(state.sessionName);
 }
@@ -464,23 +571,23 @@ async function startNativeSupervisor({ sessionId, task, lead, agents, subtasks,
 
 // ── 서브커맨드 ──
 
-async function teamStart() {
+async function teamStart() {
   const { agents, lead, layout, teammateMode, task } = parseTeamArgs();
-  if (!task) {
-    console.log(`\n  ${AMBER}${BOLD}⬡ tfx team${RESET}\n`);
-    console.log(`  사용법: ${WHITE}tfx team "작업 설명"${RESET}`);
-    console.log(`          ${WHITE}tfx team --agents codex,gemini --lead claude "작업"${RESET}`);
-    console.log(`          ${WHITE}tfx team --teammate-mode wt "작업"${RESET} ${DIM}(Windows Terminal split-pane)${RESET}`);
-    console.log(`          ${WHITE}tfx team --teammate-mode in-process "작업"${RESET} ${DIM}(tmux 불필요)${RESET}\n`);
-    return;
-  }
+  if (!task) {
+    console.log(`\n  ${AMBER}${BOLD}⬡ tfx team${RESET}\n`);
+    console.log(`  사용법: ${WHITE}tfx team "작업 설명"${RESET}`);
+    console.log(`          ${WHITE}tfx team --agents codex,gemini --lead claude "작업"${RESET}`);
+    console.log(`          ${WHITE}tfx team --teammate-mode wt "작업"${RESET} ${DIM}(Windows Terminal split-pane)${RESET}`);
+    console.log(`          ${WHITE}tfx team --teammate-mode in-process "작업"${RESET} ${DIM}(tmux 불필요)${RESET}\n`);
+    return;
+  }
 
   console.log(`\n  ${AMBER}${BOLD}⬡ tfx team${RESET}\n`);
 
-  let hub = getHubInfo();
-  if (!hub) {
-    process.stdout.write("  Hub 시작 중...");
-    hub = startHubDaemon();
+  let hub = await getHubInfo();
+  if (!hub) {
+    process.stdout.write("  Hub 시작 중...");
+    hub = await startHubDaemon();
     if (hub) {
       console.log(` ${GREEN}✓${RESET}`);
     } else {
@@ -491,28 +598,28 @@ async function teamStart() {
     ok(`Hub: ${DIM}${hub.url}${RESET}`);
   }
 
-  const sessionId = `tfx-team-${Date.now().toString(36).slice(-4)}`;
-  const subtasks = decomposeTask(task, agents.length);
-  const hubUrl = hub?.url || "http://127.0.0.1:27888/mcp";
-  let effectiveTeammateMode = teammateMode;
-
-  if (teammateMode === "wt") {
-    if (!hasWindowsTerminal()) {
-      warn("wt.exe 미발견 — in-process 모드로 자동 fallback");
-      effectiveTeammateMode = "in-process";
-    } else if (!hasWindowsTerminalSession()) {
-      warn("WT_SESSION 미감지(Windows Terminal 외부) — in-process 모드로 자동 fallback");
-      effectiveTeammateMode = "in-process";
-    }
-  }
-
-  console.log(`  세션:  ${WHITE}${sessionId}${RESET}`);
-  console.log(`  모드:  ${effectiveTeammateMode}`);
-  console.log(`  리드:  ${AMBER}${lead}${RESET}`);
-  console.log(`  워커:  ${agents.map((a) => `${AMBER}${a}${RESET}`).join(", ")}`);
-
-  // ── in-process(네이티브): tmux 없이 supervisor가 직접 CLI 프로세스 관리 ──
-  if (effectiveTeammateMode === "in-process") {
+  const sessionId = `tfx-team-${Date.now().toString(36).slice(-4)}`;
+  const subtasks = decomposeTask(task, agents.length);
+  const hubUrl = hub?.url || getDefaultHubUrl();
+  let effectiveTeammateMode = teammateMode;
+
+  if (teammateMode === "wt") {
+    if (!hasWindowsTerminal()) {
+      warn("wt.exe 미발견 — in-process 모드로 자동 fallback");
+      effectiveTeammateMode = "in-process";
+    } else if (!hasWindowsTerminalSession()) {
+      warn("WT_SESSION 미감지(Windows Terminal 외부) — in-process 모드로 자동 fallback");
+      effectiveTeammateMode = "in-process";
+    }
+  }
+
+  console.log(`  세션:  ${WHITE}${sessionId}${RESET}`);
+  console.log(`  모드:  ${effectiveTeammateMode}`);
+  console.log(`  리드:  ${AMBER}${lead}${RESET}`);
+  console.log(`  워커:  ${agents.map((a) => `${AMBER}${a}${RESET}`).join(", ")}`);
+
+  // ── in-process(네이티브): tmux 없이 supervisor가 직접 CLI 프로세스 관리 ──
+  if (effectiveTeammateMode === "in-process") {
     for (let i = 0; i < subtasks.length; i++) {
       const preview = subtasks[i].length > 44 ? subtasks[i].slice(0, 44) + "…" : subtasks[i];
       console.log(`    ${DIM}[${agents[i]}-${i + 1}] ${preview}${RESET}`);
@@ -540,10 +647,10 @@ async function teamStart() {
       task,
       lead,
       agents,
-      layout: "native",
-      teammateMode: effectiveTeammateMode,
-      startedAt: Date.now(),
-      hubUrl,
+      layout: "native",
+      teammateMode: effectiveTeammateMode,
+      startedAt: Date.now(),
+      hubUrl,
       members: members.map((m, idx) => ({
         role: m.role,
         name: m.name,
@@ -564,103 +671,103 @@ async function teamStart() {
     console.log(`  ${DIM}tmux 없이 실행됨 (직접 CLI 프로세스)${RESET}`);
     console.log(`  ${DIM}제어: tfx team send/control/tasks/status${RESET}\n`);
     return;
-  }
-
-  // ── wt 모드(Windows Terminal 독립 split-pane) ──
-  if (effectiveTeammateMode === "wt") {
-    const paneCount = agents.length + 1; // lead + workers
-    const effectiveLayout = layout === "Nx1" ? "Nx1" : "1xN";
-    if (layout !== effectiveLayout) {
-      warn(`wt 모드에서 ${layout} 레이아웃은 미지원 — ${effectiveLayout}로 대체`);
-    }
-    console.log(`  레이아웃: ${effectiveLayout} (${paneCount} panes)`);
-
-    const paneCommands = [
-      {
-        title: `${sessionId}-lead`,
-        command: buildCliCommand(lead),
-        cwd: PKG_ROOT,
-      },
-      ...agents.map((cli, i) => ({
-        title: `${sessionId}-${cli}-${i + 1}`,
-        command: buildCliCommand(cli),
-        cwd: PKG_ROOT,
-      })),
-    ];
-
-    const session = createWtSession(sessionId, {
-      layout: effectiveLayout,
-      paneCommands,
-    });
-
-    const members = [
-      {
-        role: "lead",
-        name: "lead",
-        cli: lead,
-        pane: session.panes[0] || "wt:0",
-        agentId: toAgentId(lead, session.panes[0] || "wt:0"),
-      },
-    ];
-
-    for (let i = 0; i < agents.length; i++) {
-      const cli = agents[i];
-      const target = session.panes[i + 1] || `wt:${i + 1}`;
-      members.push({
-        role: "worker",
-        name: `${cli}-${i + 1}`,
-        cli,
-        pane: target,
-        subtask: subtasks[i],
-        agentId: toAgentId(cli, target),
-      });
-    }
-
-    for (const worker of members.filter((m) => m.role === "worker")) {
-      const preview = worker.subtask.length > 44 ? worker.subtask.slice(0, 44) + "…" : worker.subtask;
-      console.log(`    ${DIM}[${worker.name}] ${preview}${RESET}`);
-    }
-    console.log("");
-
-    const tasks = buildTasks(subtasks, members.filter((m) => m.role === "worker"));
-    const panes = {};
-    for (const m of members) {
-      panes[m.pane] = {
-        role: m.role,
-        name: m.name,
-        cli: m.cli,
-        agentId: m.agentId,
-        subtask: m.subtask || null,
-      };
-    }
-
-    saveTeamState({
-      sessionName: sessionId,
-      task,
-      lead,
-      agents,
-      layout: effectiveLayout,
-      teammateMode: effectiveTeammateMode,
-      startedAt: Date.now(),
-      hubUrl,
-      members,
-      panes,
-      tasks,
-      wt: {
-        windowId: 0,
-        layout: effectiveLayout,
-        paneCount: session.paneCount,
-      },
-    });
-
-    ok("Windows Terminal wt 팀 시작 완료");
-    console.log(`  ${DIM}현재 pane 기준으로 ${effectiveLayout} 분할 생성됨${RESET}`);
-    console.log(`  ${DIM}wt 모드는 자동 프롬프트 주입/Hub direct 제어(send/control)가 제한됩니다.${RESET}\n`);
-    return;
-  }
-
-  // ── tmux 모드 ──
-  ensureTmuxOrExit();
+  }
+
+  // ── wt 모드(Windows Terminal 독립 split-pane) ──
+  if (effectiveTeammateMode === "wt") {
+    const paneCount = agents.length + 1; // lead + workers
+    const effectiveLayout = layout === "Nx1" ? "Nx1" : "1xN";
+    if (layout !== effectiveLayout) {
+      warn(`wt 모드에서 ${layout} 레이아웃은 미지원 — ${effectiveLayout}로 대체`);
+    }
+    console.log(`  레이아웃: ${effectiveLayout} (${paneCount} panes)`);
+
+    const paneCommands = [
+      {
+        title: `${sessionId}-lead`,
+        command: buildCliCommand(lead),
+        cwd: PKG_ROOT,
+      },
+      ...agents.map((cli, i) => ({
+        title: `${sessionId}-${cli}-${i + 1}`,
+        command: buildCliCommand(cli),
+        cwd: PKG_ROOT,
+      })),
+    ];
+
+    const session = createWtSession(sessionId, {
+      layout: effectiveLayout,
+      paneCommands,
+    });
+
+    const members = [
+      {
+        role: "lead",
+        name: "lead",
+        cli: lead,
+        pane: session.panes[0] || "wt:0",
+        agentId: toAgentId(lead, session.panes[0] || "wt:0"),
+      },
+    ];
+
+    for (let i = 0; i < agents.length; i++) {
+      const cli = agents[i];
+      const target = session.panes[i + 1] || `wt:${i + 1}`;
+      members.push({
+        role: "worker",
+        name: `${cli}-${i + 1}`,
+        cli,
+        pane: target,
+        subtask: subtasks[i],
+        agentId: toAgentId(cli, target),
+      });
+    }
+
+    for (const worker of members.filter((m) => m.role === "worker")) {
+      const preview = worker.subtask.length > 44 ? worker.subtask.slice(0, 44) + "…" : worker.subtask;
+      console.log(`    ${DIM}[${worker.name}] ${preview}${RESET}`);
+    }
+    console.log("");
+
+    const tasks = buildTasks(subtasks, members.filter((m) => m.role === "worker"));
+    const panes = {};
+    for (const m of members) {
+      panes[m.pane] = {
+        role: m.role,
+        name: m.name,
+        cli: m.cli,
+        agentId: m.agentId,
+        subtask: m.subtask || null,
+      };
+    }
+
+    saveTeamState({
+      sessionName: sessionId,
+      task,
+      lead,
+      agents,
+      layout: effectiveLayout,
+      teammateMode: effectiveTeammateMode,
+      startedAt: Date.now(),
+      hubUrl,
+      members,
+      panes,
+      tasks,
+      wt: {
+        windowId: 0,
+        layout: effectiveLayout,
+        paneCount: session.paneCount,
+      },
+    });
+
+    ok("Windows Terminal wt 팀 시작 완료");
+    console.log(`  ${DIM}현재 pane 기준으로 ${effectiveLayout} 분할 생성됨${RESET}`);
+    console.log(`  ${DIM}wt 모드는 자동 프롬프트 주입/Hub direct 제어(send/control)가 제한됩니다.${RESET}\n`);
+    return;
+  }
+
+  // ── tmux 모드 ──
+  ensureTmuxOrExit();
 
   const paneCount = agents.length + 1; // lead + workers
   const effectiveLayout = paneCount <= 4 ? layout : (layout === "Nx1" ? "Nx1" : "1xN");
@@ -714,12 +821,12 @@ async function teamStart() {
   ok("CLI 초기화 대기 (3초)...");
   await new Promise((r) => setTimeout(r, 3000));
 
-  await orchestrate(sessionId, assignments, {
-    hubUrl,
-    teammateMode: effectiveTeammateMode,
-    lead: {
-      target: leadTarget,
-      cli: lead,
+  await orchestrate(sessionId, assignments, {
+    hubUrl,
+    teammateMode: effectiveTeammateMode,
+    lead: {
+      target: leadTarget,
+      cli: lead,
       task,
     },
   });
@@ -742,26 +849,29 @@ async function teamStart() {
     task,
     lead,
     agents,
-    layout: effectiveLayout,
-    teammateMode: effectiveTeammateMode,
-    startedAt: Date.now(),
+    layout: effectiveLayout,
+    teammateMode: effectiveTeammateMode,
+    startedAt: Date.now(),
     hubUrl,
     members,
     panes,
     tasks,
   });
 
-  const taskListCommand = `${process.execPath} ${join(PKG_ROOT, "bin", "triflux.mjs")} team tasks`;
+  const profilePrefix = TEAM_PROFILE === "team" ? "" : `TFX_TEAM_PROFILE=${TEAM_PROFILE} `;
+  const taskListCommand = `${profilePrefix}${process.execPath} ${join(PKG_ROOT, "bin", "triflux.mjs")} team tasks`;
   configureTeammateKeybindings(sessionId, {
     inProcess: false,
     taskListCommand,
   });
 
-  console.log(`\n  ${GREEN}${BOLD}팀 세션 준비 완료${RESET}`);
-  console.log(`  ${DIM}Shift+Down: 다음 팀메이트 전환${RESET}`);
-  console.log(`  ${DIM}Escape: 현재 팀메이트 인터럽트${RESET}`);
-  console.log(`  ${DIM}Ctrl+T: 태스크 목록${RESET}`);
-  console.log(`  ${DIM}Ctrl+B → D: 세션 분리 (백그라운드)${RESET}\n`);
+  console.log(`\n  ${GREEN}${BOLD}팀 세션 준비 완료${RESET}`);
+  console.log(`  ${DIM}Shift+Down: 다음 팀메이트 전환${RESET}`);
+  console.log(`  ${DIM}Shift+Tab / Shift+Left: 이전 팀메이트 전환${RESET}`);
+  console.log(`  ${DIM}Escape: 현재 팀메이트 인터럽트${RESET}`);
+  console.log(`  ${DIM}Ctrl+T: 태스크 목록${RESET}`);
+  console.log(`  ${DIM}참고: 일부 터미널/호스트에서 Shift+Up 전달이 제한될 수 있음${RESET}`);
+  console.log(`  ${DIM}Ctrl+B → D: 세션 분리 (백그라운드)${RESET}\n`);
 
   if (process.stdout.isTTY && process.stdin.isTTY) {
     attachSession(sessionId);
@@ -785,10 +895,13 @@ async function teamStatus() {
   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}`);
+  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) {
@@ -810,9 +923,56 @@ async function teamStatus() {
     }
   }
 
+  // Hub task-list 데이터 통합 (v2.2)
+  if (alive) {
+    const hubTasks = await fetchHubTaskList(state);
+    if (hubTasks.length > 0) {
+      const completed = hubTasks.filter((t) => t.status === "completed").length;
+      const inProgress = hubTasks.filter((t) => t.status === "in_progress").length;
+      const failed = hubTasks.filter((t) => t.status === "failed").length;
+      const pending = hubTasks.filter((t) => !t.status || t.status === "pending").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("");
 }
 
+/**
+ * Hub bridge에서 팀 task-list 조회 (v2.2)
+ * @param {object} state — team-state.json
+ * @returns {Promise<Array>}
+ */
+async function fetchHubTaskList(state) {
+  const hubBase = (state?.hubUrl || getDefaultHubUrl()).replace(/\/mcp$/, "");
+  // teamName: native 모드는 state에 저장된 팀 이름, SKILL.md 모드는 세션 이름 기반
+  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 teamTasks() {
   const state = loadTeamState();
   if (!state || !isTeamAlive(state)) {
@@ -865,19 +1025,19 @@ async function teamAttach() {
     return;
   }
 
-  if (isNativeMode(state)) {
-    console.log(`\n  ${DIM}in-process 모드는 별도 attach가 없습니다.${RESET}`);
-    console.log(`  ${DIM}상태 확인: tfx team status${RESET}\n`);
-    return;
-  }
-
-  if (isWtMode(state)) {
-    console.log(`\n  ${DIM}wt 모드는 attach 개념이 없습니다 (Windows Terminal pane가 독립 실행됨).${RESET}`);
-    console.log(`  ${DIM}재실행/정리는: tfx team stop${RESET}\n`);
-    return;
-  }
-
-  try {
+  if (isNativeMode(state)) {
+    console.log(`\n  ${DIM}in-process 모드는 별도 attach가 없습니다.${RESET}`);
+    console.log(`  ${DIM}상태 확인: tfx team status${RESET}\n`);
+    return;
+  }
+
+  if (isWtMode(state)) {
+    console.log(`\n  ${DIM}wt 모드는 attach 개념이 없습니다 (Windows Terminal pane가 독립 실행됨).${RESET}`);
+    console.log(`  ${DIM}재실행/정리는: tfx team stop${RESET}\n`);
+    return;
+  }
+
+  try {
     attachSession(state.sessionName);
   } catch (e) {
     const allowWt = wantsWtAttachFallback();
@@ -905,7 +1065,7 @@ async function teamDebug() {
   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 = getHubInfo();
+  const hub = await getHubInfo();
 
   console.log(`\n  ${AMBER}${BOLD}⬡ Team Debug${RESET}\n`);
   console.log(`    platform:  ${process.platform}`);
@@ -923,28 +1083,29 @@ async function teamDebug() {
     return;
   }
 
-  console.log(`\n  ${BOLD}state${RESET}`);
-  console.log(`    session:   ${state.sessionName}`);
-  console.log(`    mode:      ${state.teammateMode || "tmux"}`);
+  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 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}`);
@@ -990,34 +1151,34 @@ async function teamFocus() {
   }
 
   const selector = process.argv[4];
-  const member = resolveMember(state, selector);
-  if (!member) {
-    console.log(`\n  사용법: ${WHITE}tfx team focus <lead|이름|번호>${RESET}\n`);
-    return;
-  }
-
-  if (isWtMode(state)) {
-    const m = /^wt:(\d+)$/.exec(member.pane || "");
-    const paneIndex = m ? parseInt(m[1], 10) : NaN;
-    if (!Number.isFinite(paneIndex)) {
-      warn(`wt pane 인덱스 파싱 실패: ${member.pane}`);
-      console.log("");
-      return;
-    }
-    const focused = focusWtPane(paneIndex, {
-      layout: state?.wt?.layout || state?.layout || "1xN",
-    });
-    if (focused) {
-      ok(`${member.name} pane 포커스 이동 (wt)`);
-    } else {
-      warn("wt pane 포커스 이동 실패 (WT_SESSION/wt.exe 상태 확인 필요)");
-    }
-    console.log("");
-    return;
-  }
-
-  focusPane(member.pane, { zoom: (state.teammateMode === "in-process") });
-  try {
+  const member = resolveMember(state, selector);
+  if (!member) {
+    console.log(`\n  사용법: ${WHITE}tfx team focus <lead|이름|번호>${RESET}\n`);
+    return;
+  }
+
+  if (isWtMode(state)) {
+    const m = /^wt:(\d+)$/.exec(member.pane || "");
+    const paneIndex = m ? parseInt(m[1], 10) : NaN;
+    if (!Number.isFinite(paneIndex)) {
+      warn(`wt pane 인덱스 파싱 실패: ${member.pane}`);
+      console.log("");
+      return;
+    }
+    const focused = focusWtPane(paneIndex, {
+      layout: state?.wt?.layout || state?.layout || "1xN",
+    });
+    if (focused) {
+      ok(`${member.name} pane 포커스 이동 (wt)`);
+    } else {
+      warn("wt pane 포커스 이동 실패 (WT_SESSION/wt.exe 상태 확인 필요)");
+    }
+    console.log("");
+    return;
+  }
+
+  focusPane(member.pane, { zoom: (state.teammateMode === "in-process") });
+  try {
     attachSession(state.sessionName);
   } catch (e) {
     const allowWt = wantsWtAttachFallback();
@@ -1049,19 +1210,19 @@ async function teamInterrupt() {
 
   const selector = process.argv[4] || "lead";
   const member = resolveMember(state, selector);
-  if (!member) {
-    console.log(`\n  사용법: ${WHITE}tfx team interrupt <lead|이름|번호>${RESET}\n`);
-    return;
-  }
-
-  if (isWtMode(state)) {
-    warn("wt 모드에서는 pane stdin 주입이 지원되지 않아 interrupt를 자동 전송할 수 없습니다.");
-    console.log(`  ${DIM}수동으로 해당 pane에서 Ctrl+C를 입력하세요.${RESET}`);
-    console.log("");
-    return;
-  }
-
-  if (isNativeMode(state)) {
+  if (!member) {
+    console.log(`\n  사용법: ${WHITE}tfx team interrupt <lead|이름|번호>${RESET}\n`);
+    return;
+  }
+
+  if (isWtMode(state)) {
+    warn("wt 모드에서는 pane stdin 주입이 지원되지 않아 interrupt를 자동 전송할 수 없습니다.");
+    console.log(`  ${DIM}수동으로 해당 pane에서 Ctrl+C를 입력하세요.${RESET}`);
+    console.log("");
+    return;
+  }
+
+  if (isNativeMode(state)) {
     const result = await nativeRequest(state, "/interrupt", { member: member.name });
     if (result?.ok) {
       ok(`${member.name} 인터럽트 전송`);
@@ -1090,20 +1251,20 @@ async function teamControl() {
   const member = resolveMember(state, selector);
   const allowed = new Set(["interrupt", "stop", "pause", "resume"]);
 
-  if (!member || !allowed.has(command)) {
-    console.log(`\n  사용법: ${WHITE}tfx team control <lead|이름|번호> <interrupt|stop|pause|resume> [사유]${RESET}\n`);
-    return;
-  }
-
-  if (isWtMode(state)) {
-    warn("wt 모드는 Hub direct/control 주입 경로가 비활성입니다.");
-    console.log(`  ${DIM}수동 제어: 해당 pane에서 직접 명령/인터럽트를 수행하세요.${RESET}`);
-    console.log("");
-    return;
-  }
-
-  // 직접 주입: MCP 유무와 무관하게 즉시 전달
-  let directOk = false;
+  if (!member || !allowed.has(command)) {
+    console.log(`\n  사용법: ${WHITE}tfx team control <lead|이름|번호> <interrupt|stop|pause|resume> [사유]${RESET}\n`);
+    return;
+  }
+
+  if (isWtMode(state)) {
+    warn("wt 모드는 Hub direct/control 주입 경로가 비활성입니다.");
+    console.log(`  ${DIM}수동 제어: 해당 pane에서 직접 명령/인터럽트를 수행하세요.${RESET}`);
+    console.log("");
+    return;
+  }
+
+  // 직접 주입: MCP 유무와 무관하게 즉시 전달
+  let directOk = false;
   if (isNativeMode(state)) {
     const direct = await nativeRequest(state, "/control", {
       member: member.name,
@@ -1140,19 +1301,19 @@ async function teamStop() {
     return;
   }
 
-  if (isNativeMode(state)) {
-    await nativeRequest(state, "/stop", {});
-    try { process.kill(state.native.supervisorPid, "SIGTERM"); } catch {}
-    ok(`세션 종료: ${state.sessionName}`);
-  } else if (isWtMode(state)) {
-    const closed = closeWtSession({
-      layout: state?.wt?.layout || state?.layout || "1xN",
-      paneCount: state?.wt?.paneCount ?? (state.members || []).length,
-    });
-    ok(`세션 종료: ${state.sessionName}${closed ? ` (${closed} panes closed)` : ""}`);
-  } else {
-    if (sessionExists(state.sessionName)) {
-      killSession(state.sessionName);
+  if (isNativeMode(state)) {
+    await nativeRequest(state, "/stop", {});
+    try { process.kill(state.native.supervisorPid, "SIGTERM"); } catch {}
+    ok(`세션 종료: ${state.sessionName}`);
+  } else if (isWtMode(state)) {
+    const closed = closeWtSession({
+      layout: state?.wt?.layout || state?.layout || "1xN",
+      paneCount: state?.wt?.paneCount ?? (state.members || []).length,
+    });
+    ok(`세션 종료: ${state.sessionName}${closed ? ` (${closed} panes closed)` : ""}`);
+  } else {
+    if (sessionExists(state.sessionName)) {
+      killSession(state.sessionName);
       ok(`세션 종료: ${state.sessionName}`);
     } else {
       console.log(`  ${DIM}세션 이미 종료됨${RESET}`);
@@ -1163,28 +1324,28 @@ async function teamStop() {
   console.log("");
 }
 
-async function teamKill() {
-  const state = loadTeamState();
-  if (state && isNativeMode(state) && isTeamAlive(state)) {
-    await nativeRequest(state, "/stop", {});
-    try { process.kill(state.native.supervisorPid, "SIGTERM"); } catch {}
-    clearTeamState();
-    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,
-    });
-    clearTeamState();
-    ok(`종료: ${state.sessionName}${closed ? ` (${closed} panes closed)` : ""}`);
-    console.log("");
-    return;
-  }
-
-  const sessions = listSessions();
+async function teamKill() {
+  const state = loadTeamState();
+  if (state && isNativeMode(state) && isTeamAlive(state)) {
+    await nativeRequest(state, "/stop", {});
+    try { process.kill(state.native.supervisorPid, "SIGTERM"); } catch {}
+    clearTeamState();
+    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,
+    });
+    clearTeamState();
+    ok(`종료: ${state.sessionName}${closed ? ` (${closed} panes closed)` : ""}`);
+    console.log("");
+    return;
+  }
+
+  const sessions = listSessions();
   if (sessions.length === 0) {
     console.log(`\n  ${DIM}활성 팀 세션 없음${RESET}\n`);
     return;
@@ -1207,19 +1368,19 @@ async function teamSend() {
   const selector = process.argv[4];
   const message = process.argv.slice(5).join(" ");
   const member = resolveMember(state, selector);
-  if (!member || !message) {
-    console.log(`\n  사용법: ${WHITE}tfx team send <lead|이름|번호> "메시지"${RESET}\n`);
-    return;
-  }
-
-  if (isWtMode(state)) {
-    warn("wt 모드는 pane 프롬프트 자동 주입(send)이 지원되지 않습니다.");
-    console.log(`  ${DIM}수동 전달: 선택한 pane에 직접 붙여넣으세요.${RESET}`);
-    console.log("");
-    return;
-  }
-
-  if (isNativeMode(state)) {
+  if (!member || !message) {
+    console.log(`\n  사용법: ${WHITE}tfx team send <lead|이름|번호> "메시지"${RESET}\n`);
+    return;
+  }
+
+  if (isWtMode(state)) {
+    warn("wt 모드는 pane 프롬프트 자동 주입(send)이 지원되지 않습니다.");
+    console.log(`  ${DIM}수동 전달: 선택한 pane에 직접 붙여넣으세요.${RESET}`);
+    console.log("");
+    return;
+  }
+
+  if (isNativeMode(state)) {
     const result = await nativeRequest(state, "/send", { member: member.name, text: message });
     if (result?.ok) {
       ok(`${member.name}에 메시지 주입 완료`);
@@ -1235,22 +1396,22 @@ async function teamSend() {
   console.log("");
 }
 
-function teamList() {
-  const state = loadTeamState();
-  if (state && isNativeMode(state) && isTeamAlive(state)) {
-    console.log(`\n  ${AMBER}${BOLD}⬡ 팀 세션 목록${RESET}\n`);
-    console.log(`    ${GREEN}●${RESET} ${state.sessionName} ${DIM}(in-process)${RESET}`);
-    console.log("");
-    return;
-  }
-  if (state && isWtMode(state) && isTeamAlive(state)) {
-    console.log(`\n  ${AMBER}${BOLD}⬡ 팀 세션 목록${RESET}\n`);
-    console.log(`    ${GREEN}●${RESET} ${state.sessionName} ${DIM}(wt)${RESET}`);
-    console.log("");
-    return;
-  }
-
-  const sessions = listSessions();
+function teamList() {
+  const state = loadTeamState();
+  if (state && isNativeMode(state) && isTeamAlive(state)) {
+    console.log(`\n  ${AMBER}${BOLD}⬡ 팀 세션 목록${RESET}\n`);
+    console.log(`    ${GREEN}●${RESET} ${state.sessionName} ${DIM}(in-process)${RESET}`);
+    console.log("");
+    return;
+  }
+  if (state && isWtMode(state) && isTeamAlive(state)) {
+    console.log(`\n  ${AMBER}${BOLD}⬡ 팀 세션 목록${RESET}\n`);
+    console.log(`    ${GREEN}●${RESET} ${state.sessionName} ${DIM}(wt)${RESET}`);
+    console.log("");
+    return;
+  }
+
+  const sessions = listSessions();
   if (sessions.length === 0) {
     console.log(`\n  ${DIM}활성 팀 세션 없음${RESET}\n`);
     return;
@@ -1266,14 +1427,14 @@ 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 "작업 설명"${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}
@@ -1289,13 +1450,15 @@ function teamHelp() {
     ${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+Up${RESET}    ${GRAY}이전 팀메이트${RESET}
-    ${WHITE}Escape${RESET}      ${GRAY}현재 팀메이트 인터럽트${RESET}
-    ${WHITE}Ctrl+T${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}이전 팀메이트 (환경 따라 미동작 가능)${RESET}
+    ${WHITE}Escape${RESET}      ${GRAY}현재 팀메이트 인터럽트${RESET}
+    ${WHITE}Ctrl+T${RESET}      ${GRAY}태스크 목록 토글${RESET}
+`);
+}
 
 // ── 메인 진입점 ──
 
@@ -1303,8 +1466,9 @@ function teamHelp() {
  * tfx team 서브커맨드 라우터
  * bin/triflux.mjs에서 호출
  */
-export async function cmdTeam() {
-  const sub = process.argv[3];
+export async function cmdTeam() {
+  const rawSub = process.argv[3];
+  const sub = typeof rawSub === "string" ? rawSub.toLowerCase() : rawSub;
 
   switch (sub) {
     case "status":    return teamStatus();
@@ -1323,13 +1487,13 @@ export async function cmdTeam() {
     case "--help":
     case "-h":
       return teamHelp();
-    case undefined:
-      return teamHelp();
-    default:
-      // 서브커맨드가 아니면 작업 문자열로 간주
-      if (!sub.startsWith("-") && TEAM_SUBCOMMANDS.has(sub)) {
-        return teamHelp();
-      }
-      return teamStart();
-  }
-}
+    case undefined:
+      return teamHelp();
+    default:
+      // 서브커맨드가 아니면 작업 문자열로 간주
+      if (typeof sub === "string" && !sub.startsWith("-") && TEAM_SUBCOMMANDS.has(sub)) {
+        return teamHelp();
+      }
+      return teamStart();
+  }
+}