triflux 3.3.0-dev.7 → 4.0.0

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

@@ -0,0 +1,37 @@
+import { attachSession } from "../../session.mjs";
+import { DIM, RESET } from "../../shared.mjs";
+import { buildManualAttachCommand, launchAttachInWindowsTerminal, wantsWtAttachFallback } from "../services/attach-fallback.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 teamAttach(args = []) {
+  const state = loadTeamState();
+  if (!state || !isTeamAlive(state)) {
+    console.log(`\n  ${DIM}활성 팀 세션 없음${RESET}\n`);
+    return;
+  }
+  if (isNativeMode(state)) {
+    console.log(`\n  ${DIM}in-process 모드는 별도 attach가 없습니다.${RESET}\n  ${DIM}상태 확인: tfx multi status${RESET}\n`);
+    return;
+  }
+  if (isWtMode(state)) {
+    console.log(`\n  ${DIM}wt 모드는 attach 개념이 없습니다 (Windows Terminal pane가 독립 실행됨).${RESET}\n  ${DIM}재실행/정리는: tfx multi stop${RESET}\n`);
+    return;
+  }
+
+  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/control.mjs

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

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

@@ -0,0 +1,74 @@
+import { AMBER, BOLD, DIM, RESET } from "../../shared.mjs";
+import {
+  capturePaneOutput,
+  detectMultiplexer,
+  getSessionAttachedCount,
+  hasWindowsTerminal,
+  hasWindowsTerminalSession,
+  listSessions,
+} from "../../session.mjs";
+import { getHubInfo, nativeGetStatus } from "../services/hub-client.mjs";
+import { isNativeMode, isTeamAlive, isWtMode } from "../services/runtime-mode.mjs";
+import { loadTeamState, TEAM_PROFILE } from "../services/state-store.mjs";
+import { formatCompletionSuffix } from "../render.mjs";
+
+export async function teamDebug(args = []) {
+  const state = loadTeamState();
+  const flagIndex = args.findIndex((arg) => arg === "--lines" || arg === "-n");
+  const lines = flagIndex === -1 ? 20 : Math.max(3, parseInt(args[flagIndex + 1] || "20", 10) || 20);
+  const 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:       ${detectMultiplexer() || "none"}`);
+  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"}`);
+  console.log(`    attached:  ${getSessionAttachedCount(state.sessionName) ?? "-"}`);
+
+  if (isWtMode(state)) {
+    console.log(`\n  ${BOLD}wt-session${RESET}`);
+    console.log(`    window:    ${state?.wt?.windowId ?? 0}`);
+    console.log(`    layout:    ${state?.wt?.layout || state?.layout || "-"}`);
+    console.log(`    panes:     ${state?.wt?.paneCount ?? (state.members || []).length}`);
+    console.log(`    wt.exe:    ${hasWindowsTerminal() ? "yes" : "no"}`);
+    console.log(`    WT_SESSION:${hasWindowsTerminalSession() ? "yes" : "no"}`);
+    console.log("");
+    return;
+  }
+
+  if (isNativeMode(state)) {
+    console.log(`\n  ${BOLD}native-members${RESET}`);
+    const members = (await nativeGetStatus(state))?.data?.members || [];
+    if (!members.length) console.log(`    ${DIM}(no data)${RESET}`);
+    for (const member of members) console.log(`    - ${member.name}: ${member.status}${formatCompletionSuffix(member)}${member.lastPreview ? ` ${DIM}${member.lastPreview}${RESET}` : ""}`);
+    console.log("");
+    return;
+  }
+
+  console.log(`\n  ${BOLD}pane-tail${RESET} ${DIM}(last ${lines} lines)${RESET}`);
+  if (!(state.members || []).length) console.log(`    ${DIM}(members 없음)${RESET}`);
+  for (const member of state.members || []) {
+    console.log(`\n    [${member.name}] ${member.pane}`);
+    for (const line of (capturePaneOutput(member.pane, lines) || "(empty)").split("\n").slice(-lines)) {
+      console.log(`      ${line}`);
+    }
+  }
+  console.log("");
+}

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 } 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  \x1b[33m⚠\x1b[0m 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();
+    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) {
+    console.log(`\n  ${DIM}활성 팀 세션 없음${RESET}\n`);
+    return;
+  }
+  for (const session of sessions) {
+    killSession(session);
+    ok(`종료: ${session}`);
+  }
+  clearTeamState();
+  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 } 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  \x1b[33m⚠\x1b[0m 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,87 @@
+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 { 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 psmux "작업"${RESET} ${DIM}(Windows psmux 네이티브)${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 } = parseTeamArgs(args);
+  if (!task) return printStartUsage();
+
+  console.log(`\n  ${AMBER}${BOLD}⬡ tfx multi${RESET}\n`);
+  let 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}`);
+
+  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 === "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 시작 실패");
+  saveTeamState(state);
+  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,32 @@
+import { normalizeLayout, normalizeTeammateMode } from "../../services/runtime-mode.mjs";
+
+export function parseTeamArgs(args = []) {
+  let agents = ["codex", "gemini"];
+  let lead = "claude";
+  let layout = "2x2";
+  let teammateMode = "auto";
+  const taskParts = [];
+
+  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.startsWith("-")) {
+      taskParts.push(current);
+    }
+  }
+
+  return {
+    agents,
+    lead,
+    layout: normalizeLayout(layout),
+    teammateMode: normalizeTeammateMode(teammateMode),
+    task: taskParts.join(" ").trim(),
+  };
+}

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`);
+      }
+    },
+  };
+}

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

@@ -0,0 +1,69 @@
+import { createWtSession } from "../../../session.mjs";
+import { buildCliCommand } from "../../../pane.mjs";
+import { toAgentId } from "../../services/member-selector.mjs";
+import { buildTasks } from "../../services/task-model.mjs";
+import { warn } from "../../render.mjs";
+
+export async function startWtTeam({ sessionId, task, lead, agents, subtasks, layout, hubUrl }) {
+  const paneCount = agents.length + 1;
+  const effectiveLayout = layout === "Nx1" ? "Nx1" : "1xN";
+  if (layout !== effectiveLayout) warn(`wt 모드에서 ${layout} 레이아웃은 미지원 — ${effectiveLayout}로 대체`);
+  console.log(`  레이아웃: ${effectiveLayout} (${paneCount} panes)`);
+
+  const session = createWtSession(sessionId, {
+    layout: effectiveLayout,
+    paneCommands: [
+      { title: `${sessionId}-lead`, command: buildCliCommand(lead) },
+      ...agents.map((cli, index) => ({
+        title: `${sessionId}-${cli}-${index + 1}`,
+        command: buildCliCommand(cli),
+      })),
+    ],
+  });
+
+  const members = [
+    {
+      role: "lead",
+      name: "lead",
+      cli: lead,
+      pane: session.panes[0] || "wt:0",
+      agentId: toAgentId(lead, session.panes[0] || "wt:0"),
+    },
+    ...agents.map((cli, index) => {
+      const pane = session.panes[index + 1] || `wt:${index + 1}`;
+      return {
+        role: "worker",
+        name: `${cli}-${index + 1}`,
+        cli,
+        pane,
+        subtask: subtasks[index],
+        agentId: toAgentId(cli, pane),
+      };
+    }),
+  ];
+
+  return {
+    sessionName: sessionId,
+    task,
+    lead,
+    agents,
+    layout: effectiveLayout,
+    teammateMode: "wt",
+    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")),
+    wt: {
+      windowId: 0,
+      layout: effectiveLayout,
+      paneCount: session.paneCount,
+    },
+  };
+}