@triflux/remote 10.1.0 → 10.26.0

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

@@ -1,43 +1,132 @@
-import { DIM, GREEN, RESET, AMBER } from "../../../shared.mjs";
-import { runHeadlessInteractive, resolveCliType } from "../../../headless.mjs";
-import { ok, } from "../../render.mjs";
-import { buildTasks } from "../../services/task-model.mjs";
+import {
+  normalizeHeadlessRole,
+  resolveCliType,
+  resolveHeadlessDisplayName,
+  runHeadlessInteractive,
+} from "../../../headless.mjs";
+import { AMBER, DIM, GREEN, RESET } from "../../../shared.mjs";
+import { ok } from "../../render.mjs";
 import { clearTeamState } from "../../services/state-store.mjs";
+import { buildTasks } from "../../services/task-model.mjs";
 
-export async function startHeadlessTeam({ sessionId, task, lead, agents, subtasks, layout, assigns, autoAttach, progressive, timeoutSec, verbose, dashboard, dashboardLayout, dashboardSize, dashboardAnchor, mcpProfile, model }) {
+export function buildHeadlessAssignments({
+  agents = [],
+  subtasks = [],
+  assigns = [],
+  mcpProfile,
+  model,
+  cwd,
+} = {}) {
   // --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 }));
+  return assigns && assigns.length > 0
+    ? assigns.map((a, i) => {
+        const paneName = `worker-${i + 1}`;
+        return {
+          cli: resolveCliType(a.cli),
+          prompt: a.prompt,
+          displayName: resolveHeadlessDisplayName(a, paneName),
+          role: normalizeHeadlessRole(a.role),
+          mcp: mcpProfile,
+          model,
+          cwd,
+        };
+      })
+    : subtasks.map((subtask, i) => {
+        const paneName = `worker-${i + 1}`;
+        return {
+          cli: resolveCliType(agents[i] || agents[0]),
+          prompt: subtask,
+          displayName: paneName,
+          role: "",
+          mcp: mcpProfile,
+          model,
+          cwd,
+        };
+      });
+}
+
+export async function startHeadlessTeam({
+  sessionId,
+  task,
+  lead,
+  agents,
+  subtasks,
+  layout,
+  assigns,
+  autoAttach,
+  progressive,
+  timeoutSec,
+  verbose,
+  dashboard,
+  dashboardLayout,
+  dashboardSize,
+  dashboardAnchor,
+  mcpProfile,
+  model,
+  cwd,
+  nativeBridge,
+  nativeBridgeMode,
+}) {
+  const assignments = buildHeadlessAssignments({
+    agents,
+    subtasks,
+    assigns,
+    mcpProfile,
+    model,
+    cwd,
+  });
 
   const _startedAt = Date.now();
   ok(`headless ${assignments.length}워커 시작`);
+  if (nativeBridge) {
+    process.stderr.write(
+      `[headless] Claude native bridge mode: ${nativeBridgeMode || "roster"}\n`,
+    );
+  }
 
   const handle = await runHeadlessInteractive(sessionId, assignments, {
-    timeoutSec: timeoutSec || 300,
+    timeoutSec: timeoutSec || 900,
     layout,
     autoAttach: !!autoAttach,
     dashboard: !!dashboard,
     dashboardLayout,
-    dashboardSize: dashboardSize ?? 0.50,
+    dashboardSize: dashboardSize ?? 0.5,
     dashboardAnchor,
     progressive: progressive !== false,
+    nativeBridge,
+    nativeBridgeMode,
     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,
+    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,
   });
 
   // 최소 결과 요약
@@ -45,17 +134,25 @@ export async function startHeadlessTeam({ sessionId, task, lead, agents, subtask
   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}전체`);
+  ok(
+    `헤드리스 완료: ${succeeded.length}성공 / ${failed.length}실패 / ${results.length}전체`,
+  );
   // 머신 파싱용 완료 마커 — background task에서 결과 회수 시점 판단에 사용
-  console.log(`=== HEADLESS_COMPLETE succeeded=${succeeded.length} failed=${failed.length} total=${results.length} ===`);
+  console.log(
+    `=== HEADLESS_COMPLETE succeeded=${succeeded.length} failed=${failed.length} total=${results.length} ===`,
+  );
 
   if (failed.length > 0) {
-    for (const r of failed) console.log(`  ${AMBER}✗${RESET} ${r.paneName} (${r.cli}) exit=${r.exitCode}`);
+    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}`;
+    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}`);
@@ -71,8 +168,11 @@ export async function startHeadlessTeam({ sessionId, task, lead, agents, subtask
   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}`);
+        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}`);
       }
     }
@@ -80,28 +180,46 @@ export async function startHeadlessTeam({ sessionId, task, lead, agents, subtask
 
   // dashboard 모드: tui-viewer가 최종 상태를 렌더링할 시간 확보
   // WT pane spawn (~1s) + node 기동 (~500ms) + 첫 폴링 (~500ms) + 렌더 여유
-  if (dashboard) await new Promise(r => setTimeout(r, 5000));
+  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 })),
+    {
+      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),
+    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")),
+    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);

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

@@ -1,40 +1,50 @@
-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,
-    },
-  };
-}
+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

@@ -1,73 +1,122 @@
-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`);
-      }
-    },
-  };
-}
+import { join } from "node:path";
+import { orchestrate } from "../../../orchestrator.mjs";
+import { buildCliCommand, startCliInPane } from "../../../pane.mjs";
+import {
+  attachSession,
+  configureTeammateKeybindings,
+  createSession,
+} from "../../../session.mjs";
+import { BOLD, DIM, GREEN, RESET } from "../../../shared.mjs";
+import { ok, warn } from "../../render.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";
+
+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`);
+      }
+    },
+  };
+}