@triflux/remote 10.0.1 → 10.25.1

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

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

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

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

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

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

@@ -1,16 +1,33 @@
 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";
+import { parseDashboardLayout } from "../../../dashboard-layout.mjs";
+import {
+  normalizeLayout,
+  normalizeTeammateMode,
+} from "../../services/runtime-mode.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",
+  "codex",
+  "gemini",
+  "claude",
+  "executor",
+  "architect",
+  "planner",
+  "analyst",
+  "critic",
+  "debugger",
+  "verifier",
+  "code-reviewer",
+  "security-reviewer",
+  "test-engineer",
+  "designer",
+  "writer",
+  "scientist",
 ]);
 
+const NATIVE_BRIDGE_MODES = new Set(["roster", "agents", "claude-wrapper"]);
+
 /**
  * --assign "cli:prompt:role" 형식을 콜론-안전하게 파싱한다.
  * 프롬프트 내부의 콜론(:)은 구분자로 취급하지 않는다.
@@ -29,7 +46,10 @@ function parseAssignValue(raw) {
 
   const lastColon = rest.lastIndexOf(":");
   if (lastColon > 0) {
-    const candidate = rest.slice(lastColon + 1).trim().toLowerCase();
+    const candidate = rest
+      .slice(lastColon + 1)
+      .trim()
+      .toLowerCase();
     if (KNOWN_ROLES.has(candidate)) {
       return { cli, prompt: rest.slice(0, lastColon).trim(), role: candidate };
     }
@@ -51,21 +71,32 @@ export function parseTeamArgs(args = []) {
   let verbose = false;
   let dashboard = true;
   let dashboardLayout = "lite";
-  let dashboardSize = 0.40;
+  let dashboardSize = 0.4;
   let dashboardAnchor = "window";
   let mcpProfile = "";
   let model = "";
   let cwd = "";
+  let nativeBridge = false;
+  let nativeBridgeMode = "agents";
+  let nativeBridgeExplicit = false;
+  let nativeBridgeUiRequested = false;
+  let nativeBridgeUiOptOut = false;
 
   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);
+      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]) {
+    } 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]);
@@ -83,7 +114,10 @@ export function parseTeamArgs(args = []) {
     } 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));
+      dashboardSize = Math.min(
+        0.8,
+        Math.max(0.2, parseFloat(args[++index]) || 0.5),
+      );
     } else if (current === "--dashboard-anchor" && args[index + 1]) {
       dashboardAnchor = parseDashboardAnchor(args[++index]);
     } else if (current === "--no-progressive") {
@@ -94,6 +128,37 @@ export function parseTeamArgs(args = []) {
       mcpProfile = args[++index].trim();
     } else if ((current === "--model" || current === "-m") && args[index + 1]) {
       model = args[++index].trim();
+    } else if (current === "--native-bridge" || current === "-nb") {
+      nativeBridge = true;
+      nativeBridgeExplicit = true;
+    } else if (current === "--native-bridge-ui") {
+      if (nativeBridgeUiOptOut) {
+        throw new Error(
+          "cannot combine --native-bridge-ui and --no-native-bridge-ui",
+        );
+      }
+      nativeBridge = true;
+      nativeBridgeMode = "agents";
+      nativeBridgeExplicit = true;
+      nativeBridgeUiRequested = true;
+    } else if (current === "--no-native-bridge-ui") {
+      if (nativeBridgeUiRequested) {
+        throw new Error(
+          "cannot combine --native-bridge-ui and --no-native-bridge-ui",
+        );
+      }
+      nativeBridge = false;
+      nativeBridgeUiOptOut = true;
+    } else if (current === "--native-bridge-mode") {
+      const mode = args[++index];
+      if (!NATIVE_BRIDGE_MODES.has(mode)) {
+        throw new Error(
+          `unknown native bridge mode: ${mode || ""}; expected roster, agents, or claude-wrapper`,
+        );
+      }
+      nativeBridge = true;
+      nativeBridgeMode = mode;
+      nativeBridgeExplicit = true;
     } else if (current === "--cwd" && args[index + 1]) {
       let p = args[++index].trim();
       // MSYS/Git Bash 드라이브 문자 변환: /c/... → C:/...
@@ -108,11 +173,20 @@ export function parseTeamArgs(args = []) {
     }
   }
 
+  const normalizedTeammateMode = normalizeTeammateMode(teammateMode);
+  if (
+    !nativeBridgeExplicit &&
+    !nativeBridgeUiOptOut &&
+    normalizedTeammateMode === "headless"
+  ) {
+    nativeBridge = true;
+  }
+
   return {
     agents,
     lead,
     layout: normalizeLayout(layout),
-    teammateMode: normalizeTeammateMode(teammateMode),
+    teammateMode: normalizedTeammateMode,
     task: taskParts.join(" ").trim(),
     assigns,
     autoAttach,
@@ -126,5 +200,8 @@ export function parseTeamArgs(args = []) {
     mcpProfile,
     model,
     cwd,
+    nativeBridge,
+    nativeBridgeMode,
+    nativeBridgeUiOptOut,
   };
 }