triflux 10.0.0 → 10.0.2

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

@@ -0,0 +1,53 @@
+import { attachSession, focusPane, focusWtPane } from "../../session.mjs";
+import { DIM, RESET, WHITE } from "../../shared.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 { loadTeamState } from "../services/state-store.mjs";
+import { fail, ok, warn } from "../render.mjs";
+
+export async function teamFocus(args = []) {
+  const state = loadTeamState();
+  if (!state || !isTeamAlive(state)) {
+    console.log(`\n  ${DIM}활성 팀 세션 없음${RESET}\n`);
+    return;
+  }
+  if (isNativeMode(state)) {
+    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`);
+    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`);
+      return;
+    }
+    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;
+  }
+
+  focusPane(member.pane, { zoom: false });
+  try {
+    attachSession(state.sessionName);
+  } catch (error) {
+    const allowWt = wantsWtAttachFallback(args);
+    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`);
+      return;
+    }
+    fail(`attach 실패: ${error.message}`);
+    warn(allowWt ? "WT 분할창 attach 자동 검증 실패 (session_attached 증가 없음)" : "자동 WT 분할은 기본 비활성입니다. 필요 시 --wt 옵션으로 실행하세요.");
+    console.log(`  ${DIM}수동 attach 명령: ${buildManualAttachCommand(state.sessionName)}${RESET}\n`);
+  }
+}

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

@@ -0,0 +1,36 @@
+import { sendKeys } from "../../pane.mjs";
+import { DIM, RESET, WHITE, YELLOW } from "../../shared.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 { loadTeamState } from "../services/state-store.mjs";
+import { ok, warn } from "../render.mjs";
+
+export async function teamInterrupt(args = []) {
+  const state = loadTeamState();
+  if (!state || !isTeamAlive(state)) {
+    console.log(`\n  ${DIM}활성 팀 세션 없음${RESET}\n`);
+    return;
+  }
+
+  const member = resolveMember(state, args[0] || "lead");
+  if (!member) {
+    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`);
+    return;
+  }
+
+  if (isNativeMode(state)) {
+    const result = await nativeRequest(state, "/interrupt", { member: member.name });
+    (result?.ok ? ok : warn)(`${member.name} ${result?.ok ? "인터럽트 전송" : "인터럽트 실패"}`);
+    console.log("");
+    return;
+  }
+
+  sendKeys(member.pane, "C-c");
+  ok(`${member.name} 인터럽트 전송`);
+  console.log("");
+}

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

@@ -0,0 +1,37 @@
+import { closeWtSession, killSession, listSessions } from "../../session.mjs";
+import { DIM, RESET } from "../../shared.mjs";
+import { nativeRequest } from "../services/native-control.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 {}
+    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 });
+    clearTeamState(state.sessionId);
+    ok(`종료: ${state.sessionName}${closed ? ` (${closed} panes closed)` : ""}`);
+    console.log("");
+    return;
+  }
+
+  const sessions = listSessions();
+  if (!sessions.length) {
+    console.log(`\n  ${DIM}활성 팀 세션 없음${RESET}\n`);
+    return;
+  }
+  for (const session of sessions) {
+    killSession(session);
+    ok(`종료: ${session}`);
+  }
+  clearTeamState(state?.sessionId);
+  console.log("");
+}

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

@@ -0,0 +1,24 @@
+import { AMBER, BOLD, DIM, GREEN, RESET } from "../../shared.mjs";
+import { listSessions } from "../../session.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("");
+    return;
+  }
+
+  const sessions = listSessions();
+  if (!sessions.length) {
+    console.log(`\n  ${DIM}활성 팀 세션 없음${RESET}\n`);
+    return;
+  }
+
+  console.log(`\n  ${AMBER}${BOLD}⬡ 팀 세션 목록${RESET}\n`);
+  for (const session of sessions) console.log(`    ${GREEN}●${RESET} ${session}`);
+  console.log("");
+}

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

@@ -0,0 +1,37 @@
+import { injectPrompt } from "../../pane.mjs";
+import { DIM, RESET, WHITE, YELLOW } from "../../shared.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 { loadTeamState } from "../services/state-store.mjs";
+import { ok, warn } from "../render.mjs";
+
+export async function teamSend(args = []) {
+  const state = loadTeamState();
+  if (!state || !isTeamAlive(state)) {
+    console.log(`\n  ${DIM}활성 팀 세션 없음${RESET}\n`);
+    return;
+  }
+
+  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`);
+    return;
+  }
+  if (isWtMode(state)) {
+    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 ? "에 메시지 주입 완료" : " 메시지 주입 실패"}`);
+    console.log("");
+    return;
+  }
+
+  injectPrompt(member.pane, message);
+  ok(`${member.name}에 메시지 주입 완료`);
+  console.log("");
+}

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

@@ -0,0 +1,106 @@
+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 { 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 { 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`);
+}
+
+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];
+    console.log(`    ${DIM}[${agents[index]}-${index + 1}] ${preview}${RESET}`);
+  }
+  console.log("");
+}
+
+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`);
+}
+
+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);
+  // --assign 사용 시 task를 자동 생성
+  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`);
+
+  // P1b: 워커 수 계산 — 단일 워커 headless에는 Hub 불필요
+  const workerCount = assigns.length > 0 ? assigns.length : agents.length;
+  const needsHub = workerCount >= 2 || teammateMode !== "headless";
+
+  let hub = null;
+  if (needsHub) {
+    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 모듈이 설치되지 않음"); }
+      console.log(` ${hub ? `${GREEN}✓${RESET}` : `${RED}✗${RESET}`}`);
+      if (!hub) warn("Hub 시작 실패 — 수동으로 실행: tfx hub start");
+    } else ok(`Hub: ${DIM}${hub.url}${RESET}`);
+  } else {
+    ok(`Hub: ${DIM}건너뜀 (단일 워커 headless)${RESET}`);
+  }
+
+  const sessionId = `tfx-multi-${Date.now().toString(36).slice(-4)}${Math.random().toString(36).slice(2, 6)}`;
+  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"; }
+
+  console.log(`  세션:  ${WHITE}${sessionId}${RESET}`);
+  console.log(`  모드:  ${effectiveMode}`);
+  console.log(`  리드:  ${AMBER}${lead}${RESET}`);
+  console.log(`  워커:  ${agents.map((agent) => `${AMBER}${agent}${RESET}`).join(", ")}`);
+  printWorkerPreview(agents, subtasks);
+
+  if (effectiveMode === "tmux") {
+    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 });
+
+  if (!state) return fail("in-process supervisor 시작 실패");
+  state.sessionId = sessionId;
+  saveTeamState(state, sessionId);
+  if (typeof state.postSave === "function") state.postSave();
+  if (effectiveMode === "in-process") {
+    ok("네이티브 in-process 팀 시작 완료");
+    console.log(`  ${DIM}tmux 없이 실행됨 (직접 CLI 프로세스)${RESET}`);
+    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`);
+  }
+}

package/hub/team/cli/commands/start/parse-args.mjs

@@ -0,0 +1,130 @@
+import { resolve } from "node:path";
+import { normalizeLayout, normalizeTeammateMode } from "../../services/runtime-mode.mjs";
+import { parseDashboardLayout } from "../../../dashboard-layout.mjs";
+import { parseDashboardAnchor } from "../../../dashboard-anchor.mjs";
+
+// --assign 파싱 시 마지막 콜론 뒤를 role로 인식할 알려진 역할/CLI 이름
+const KNOWN_ROLES = new Set([
+  "codex", "gemini", "claude",
+  "executor", "architect", "planner", "analyst", "critic",
+  "debugger", "verifier", "code-reviewer", "security-reviewer",
+  "test-engineer", "designer", "writer", "scientist",
+]);
+
+/**
+ * --assign "cli:prompt:role" 형식을 콜론-안전하게 파싱한다.
+ * 프롬프트 내부의 콜론(:)은 구분자로 취급하지 않는다.
+ *
+ * 규칙:
+ *   1. 첫 번째 콜론 앞 = CLI 이름
+ *   2. 마지막 콜론 뒤가 KNOWN_ROLES에 있으면 role, 나머지가 prompt
+ *   3. 그 외에는 첫 콜론 뒤 전체가 prompt, role은 빈 문자열
+ */
+function parseAssignValue(raw) {
+  const firstColon = raw.indexOf(":");
+  if (firstColon < 0) return null;
+
+  const cli = raw.slice(0, firstColon).trim();
+  const rest = raw.slice(firstColon + 1);
+
+  const lastColon = rest.lastIndexOf(":");
+  if (lastColon > 0) {
+    const candidate = rest.slice(lastColon + 1).trim().toLowerCase();
+    if (KNOWN_ROLES.has(candidate)) {
+      return { cli, prompt: rest.slice(0, lastColon).trim(), role: candidate };
+    }
+  }
+
+  return { cli, prompt: rest.trim(), role: "" };
+}
+
+export function parseTeamArgs(args = []) {
+  let agents = ["codex", "gemini"];
+  let lead = "claude";
+  let layout = "2x2";
+  let teammateMode = "auto";
+  const taskParts = [];
+  const assigns = []; // --assign "codex:프롬프트:역할" 형식
+  let autoAttach = true;
+  let progressive = true;
+  let timeoutSec = 300;
+  let verbose = false;
+  let dashboard = true;
+  let dashboardLayout = "lite";
+  let dashboardSize = 0.40;
+  let dashboardAnchor = "window";
+  let mcpProfile = "";
+  let model = "";
+  let cwd = "";
+
+  for (let index = 0; index < args.length; index += 1) {
+    const current = args[index];
+    if (current === "--agents" && args[index + 1]) {
+      agents = args[++index].split(",").map((value) => value.trim().toLowerCase()).filter(Boolean);
+    } else if (current === "--lead" && args[index + 1]) {
+      lead = args[++index].trim().toLowerCase();
+    } else if (current === "--layout" && args[index + 1]) {
+      layout = args[++index];
+    } else if ((current === "--teammate-mode" || current === "--mode") && args[index + 1]) {
+      teammateMode = args[++index];
+    } else if (current === "--assign" && args[index + 1]) {
+      const parsed = parseAssignValue(args[++index]);
+      if (parsed) assigns.push(parsed);
+    } else if (current === "--auto-attach") {
+      autoAttach = true;
+    } else if (current === "--no-auto-attach") {
+      autoAttach = false;
+    } else if (current === "--verbose") {
+      verbose = true;
+    } else if (current === "--dashboard") {
+      dashboard = true;
+    } else if (current === "--no-dashboard") {
+      dashboard = false;
+    } else if (current === "--dashboard-layout" && args[index + 1]) {
+      dashboardLayout = parseDashboardLayout(args[++index]);
+    } else if (current === "--dashboard-size" && args[index + 1]) {
+      dashboardSize = Math.min(0.8, Math.max(0.2, parseFloat(args[++index]) || 0.50));
+    } else if (current === "--dashboard-anchor" && args[index + 1]) {
+      dashboardAnchor = parseDashboardAnchor(args[++index]);
+    } else if (current === "--no-progressive") {
+      progressive = false;
+    } else if (current === "--timeout" && args[index + 1]) {
+      timeoutSec = Number(args[++index]) || 300;
+    } else if (current === "--mcp-profile" && args[index + 1]) {
+      mcpProfile = args[++index].trim();
+    } else if ((current === "--model" || current === "-m") && args[index + 1]) {
+      model = args[++index].trim();
+    } else if (current === "--cwd" && args[index + 1]) {
+      let p = args[++index].trim();
+      // MSYS/Git Bash 드라이브 문자 변환: /c/... → C:/...
+      if (process.platform === "win32" && /^\/[a-zA-Z]\//.test(p)) {
+        p = p[1].toUpperCase() + ":" + p.slice(2);
+      }
+      cwd = resolve(p);
+    } else if (current.startsWith("-")) {
+      console.warn(`  ⚠ 미인식 플래그 무시: ${current}`);
+    } else {
+      taskParts.push(current);
+    }
+  }
+
+  return {
+    agents,
+    lead,
+    layout: normalizeLayout(layout),
+    teammateMode: normalizeTeammateMode(teammateMode),
+    task: taskParts.join(" ").trim(),
+    assigns,
+    autoAttach,
+    progressive,
+    timeoutSec,
+    verbose,
+    dashboard,
+    dashboardLayout,
+    dashboardSize,
+    dashboardAnchor,
+    mcpProfile,
+    model,
+    cwd,
+  };
+}

package/hub/team/cli/commands/start/start-headless.mjs

@@ -0,0 +1,109 @@
+import { BOLD, DIM, GREEN, RESET, AMBER } from "../../../shared.mjs";
+import { runHeadlessInteractive, resolveCliType } from "../../../headless.mjs";
+import { ok, warn } from "../../render.mjs";
+import { buildTasks } from "../../services/task-model.mjs";
+import { clearTeamState } from "../../services/state-store.mjs";
+
+export async function startHeadlessTeam({ sessionId, task, lead, agents, subtasks, layout, assigns, autoAttach, progressive, timeoutSec, verbose, dashboard, dashboardLayout, dashboardSize, dashboardAnchor, mcpProfile, model }) {
+  // --assign이 있으면 그것을 사용, 없으면 agents+subtasks 조합
+  const assignments = assigns && assigns.length > 0
+    ? assigns.map((a, i) => ({ cli: resolveCliType(a.cli), prompt: a.prompt, role: a.role || `worker-${i + 1}`, mcp: mcpProfile, model }))
+    : subtasks.map((subtask, i) => ({ cli: resolveCliType(agents[i] || agents[0]), prompt: subtask, role: `worker-${i + 1}`, mcp: mcpProfile, model }));
+
+  const startedAt = Date.now();
+  ok(`headless ${assignments.length}워커 시작`);
+
+  const handle = await runHeadlessInteractive(sessionId, assignments, {
+    timeoutSec: timeoutSec || 300,
+    layout,
+    autoAttach: !!autoAttach,
+    dashboard: !!dashboard,
+    dashboardLayout,
+    dashboardSize: dashboardSize ?? 0.50,
+    dashboardAnchor,
+    progressive: progressive !== false,
+    progressIntervalSec: verbose ? 10 : 0,
+    onProgress: verbose ? function onProgress(event) {
+      if (event.type === "session_created") {
+        console.log(`  ${DIM}세션: ${event.sessionName}${RESET}`);
+      } else if (event.type === "worker_added") {
+        console.log(`  ${DIM}[+] ${event.paneTitle}${RESET}`);
+      } else if (event.type === "dispatched") {
+        console.log(`  ${DIM}[${event.paneName}] ${event.cli} dispatch${RESET}`);
+      } else if (event.type === "progress") {
+        const last = (event.snapshot || "").split("\n").filter(l => l.trim()).pop() || "";
+        if (last) console.log(`  ${DIM}[${event.paneName}] ${last.slice(0, 60)}${RESET}`);
+      } else if (event.type === "completed") {
+        const icon = event.matched && event.exitCode === 0 ? `${GREEN}✓${RESET}` : `${AMBER}✗${RESET}`;
+        console.log(`  ${icon} [${event.paneName}] ${event.cli} exit=${event.exitCode}${event.sessionDead ? " (dead)" : ""}`);
+      }
+    } : undefined,
+  });
+
+  // 최소 결과 요약
+  const results = handle.results;
+  const succeeded = results.filter((r) => r.matched && r.exitCode === 0);
+  const failed = results.filter((r) => !r.matched || r.exitCode !== 0);
+
+  ok(`헤드리스 완료: ${succeeded.length}성공 / ${failed.length}실패 / ${results.length}전체`);
+
+  if (failed.length > 0) {
+    for (const r of failed) console.log(`  ${AMBER}✗${RESET} ${r.paneName} (${r.cli}) exit=${r.exitCode}`);
+  }
+
+  // handoff 요약 (Lead 토큰 절약 포맷)
+  for (const r of results) {
+    const icon = r.matched && r.exitCode === 0 ? `${GREEN}✓${RESET}` : `${AMBER}✗${RESET}`;
+    if (r.handoffFormatted) {
+      const tag = r.handoffFallback ? `${DIM}(fallback)${RESET}` : "";
+      console.log(`  ${icon} ${r.paneName} ${tag}`);
+      for (const line of r.handoffFormatted.split("\n")) {
+        console.log(`    ${DIM}${line}${RESET}`);
+      }
+    } else {
+      if (r.resultFile) console.log(`  ${icon} ${r.paneName}: ${r.resultFile}`);
+    }
+  }
+
+  // --verbose: 기존 장황한 출력 (200자 preview)
+  if (verbose) {
+    for (const r of results) {
+      if (r.output) {
+        const preview = r.output.length > 200 ? `${r.output.slice(0, 200)}…` : r.output;
+        console.log(`\n  ${DIM}── ${r.paneName} (${r.cli}${r.role ? `, ${r.role}` : ""}) ──${RESET}`);
+        console.log(`  ${preview}`);
+      }
+    }
+  }
+
+  // dashboard 모드: tui-viewer가 최종 상태를 렌더링할 시간 확보
+  // WT pane spawn (~1s) + node 기동 (~500ms) + 첫 폴링 (~500ms) + 렌더 여유
+  if (dashboard) await new Promise(r => setTimeout(r, 5000));
+
+  // 세션 정리
+  handle.kill();
+
+  const members = [
+    { role: "lead", name: "lead", cli: lead, pane: `${handle.sessionName}:0.0` },
+    ...results.map((r, i) => ({ role: "worker", name: r.paneName, cli: r.cli, pane: r.paneId || "", subtask: assignments[i]?.prompt })),
+  ];
+
+  return {
+    sessionName: handle.sessionName,
+    task,
+    lead,
+    agents: assignments.map(a => a.cli),
+    layout,
+    teammateMode: "headless",
+    startedAt: Date.now(),
+    members,
+    headlessResults: results,
+    handoffs: results.map((r) => ({ paneName: r.paneName, cli: r.cli, ...r.handoff })),
+    tasks: buildTasks(assignments.map(a => a.prompt), members.filter((m) => m.role === "worker")),
+    postSave() {
+      // headless는 실행 완료 후 즉시 정리 — HUD에 잔존 방지
+      clearTeamState(sessionId);
+      console.log(`\n  ${DIM}세션 정리 완료.${RESET}\n`);
+    },
+  };
+}

package/hub/team/cli/commands/start/start-in-process.mjs

@@ -0,0 +1,40 @@
+import { startNativeSupervisor } from "../../services/native-control.mjs";
+import { buildTasks } from "../../services/task-model.mjs";
+
+export async function startInProcessTeam({ sessionId, task, lead, agents, subtasks, hubUrl }) {
+  const { runtime, members } = await startNativeSupervisor({
+    sessionId,
+    task,
+    lead,
+    agents,
+    subtasks,
+    hubUrl,
+  });
+
+  if (!runtime?.controlUrl) return null;
+
+  return {
+    sessionName: sessionId,
+    task,
+    lead,
+    agents,
+    layout: "native",
+    teammateMode: "in-process",
+    startedAt: Date.now(),
+    hubUrl,
+    members: members.map((member, index) => ({
+      role: member.role,
+      name: member.name,
+      cli: member.cli,
+      agentId: member.agentId,
+      pane: `native:${index}`,
+      subtask: member.subtask || null,
+    })),
+    panes: {},
+    tasks: buildTasks(subtasks, members.filter((member) => member.role === "worker")),
+    native: {
+      controlUrl: runtime.controlUrl,
+      supervisorPid: runtime.supervisorPid,
+    },
+  };
+}

package/hub/team/cli/commands/start/start-mux.mjs

@@ -0,0 +1,73 @@
+import { join } from "node:path";
+
+import { buildCliCommand, startCliInPane } from "../../../pane.mjs";
+import { orchestrate } from "../../../orchestrator.mjs";
+import { attachSession, configureTeammateKeybindings, createSession } from "../../../session.mjs";
+import { BOLD, DIM, GREEN, RESET } from "../../../shared.mjs";
+import { toAgentId } from "../../services/member-selector.mjs";
+import { PKG_ROOT, TEAM_PROFILE } from "../../services/state-store.mjs";
+import { buildTasks } from "../../services/task-model.mjs";
+import { ok, warn } from "../../render.mjs";
+
+export async function startMuxTeam({ sessionId, task, lead, agents, subtasks, layout, hubUrl, teammateMode }) {
+  const paneCount = agents.length + 1;
+  const effectiveLayout = paneCount <= 4 ? layout : (layout === "Nx1" ? "Nx1" : "1xN");
+  console.log(`  레이아웃: ${effectiveLayout} (${paneCount} panes)`);
+
+  const session = createSession(sessionId, { layout: effectiveLayout, paneCount });
+  const leadTarget = session.panes[0];
+  startCliInPane(leadTarget, buildCliCommand(lead));
+
+  const members = [{ role: "lead", name: "lead", cli: lead, pane: leadTarget, agentId: toAgentId(lead, leadTarget) }];
+  const assignments = [];
+  for (let index = 0; index < agents.length; index += 1) {
+    const cli = agents[index];
+    const pane = session.panes[index + 1];
+    startCliInPane(pane, buildCliCommand(cli));
+    const worker = { role: "worker", name: `${cli}-${index + 1}`, cli, pane, subtask: subtasks[index], agentId: toAgentId(cli, pane) };
+    members.push(worker);
+    assignments.push({ target: pane, cli, subtask: subtasks[index] });
+  }
+
+  ok("CLI 초기화 대기 (3초)...");
+  await new Promise((resolve) => setTimeout(resolve, 3000));
+  await orchestrate(sessionId, assignments, { hubUrl, teammateMode, lead: { target: leadTarget, cli: lead, task } });
+  ok("리드/워커 프롬프트 주입 완료");
+
+  return {
+    sessionName: sessionId,
+    task,
+    lead,
+    agents,
+    layout: effectiveLayout,
+    teammateMode,
+    startedAt: Date.now(),
+    hubUrl,
+    members,
+    panes: Object.fromEntries(members.map((member) => [member.pane, {
+      role: member.role,
+      name: member.name,
+      cli: member.cli,
+      agentId: member.agentId,
+      subtask: member.subtask || null,
+    }])),
+    tasks: buildTasks(subtasks, members.filter((member) => member.role === "worker")),
+    postSave() {
+      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}Shift+Tab / Shift+Left: 이전 팀메이트 전환${RESET}`);
+      console.log(`  ${DIM}Escape: 현재 팀메이트 인터럽트${RESET}`);
+      console.log(`  ${DIM}Ctrl+T: 태스크 목록${RESET}`);
+      console.log(`  ${DIM}참고: Shift+Up은 Claude Code 미지원 (scroll-up 충돌). Shift+Tab 사용${RESET}`);
+      console.log(`  ${DIM}Ctrl+B → D: 세션 분리 (백그라운드)${RESET}\n`);
+      if (process.stdout.isTTY && process.stdin.isTTY) attachSession(sessionId);
+      else {
+        warn("TTY 미지원 환경이라 자동 attach를 생략함");
+        console.log(`  ${DIM}수동 연결: tfx multi attach${RESET}\n`);
+      }
+    },
+  };
+}