triflux 8.11.2 → 8.12.2

package/hub/team/cli/help.mjs

@@ -1,40 +1,41 @@
-import { AMBER, BOLD, DIM, GRAY, RESET, WHITE } from "../shared.mjs";
-
-export function renderTeamHelp() {
-  console.log(`
-  ${AMBER}${BOLD}⬡ tfx multi${RESET} ${DIM}멀티-CLI 팀 모드 (Lead + Teammates)${RESET}
-
-  ${BOLD}시작${RESET}
-    ${WHITE}tfx multi "작업 설명"${RESET}
-    ${WHITE}tfx multi --agents codex,gemini --lead claude "작업"${RESET}
-    ${WHITE}tfx multi --teammate-mode tmux "작업"${RESET}
-    ${WHITE}tfx multi --teammate-mode wt "작업"${RESET}   ${DIM}(Windows Terminal split-pane)${RESET}
-    ${WHITE}tfx multi --layout 1xN "작업"${RESET}               ${DIM}(세로 분할 컬럼)${RESET}
-    ${WHITE}tfx multi --layout Nx1 "작업"${RESET}               ${DIM}(가로 분할 스택)${RESET}
-    ${WHITE}tfx multi --dashboard-layout auto "작업"${RESET}    ${DIM}(dashboard viewer 레이아웃 자동 결정)${RESET}
-    ${WHITE}tfx multi --dashboard-size 0.4 "작업"${RESET}      ${DIM}(대시보드 분할 비율 0.2~0.8, 기본 0.50)${RESET}
-    ${WHITE}tfx multi --teammate-mode in-process "작업"${RESET} ${DIM}(tmux 불필요)${RESET}
-
-  ${BOLD}제어${RESET}
-    ${WHITE}tfx multi status${RESET}                      ${GRAY}현재 팀 상태${RESET}
-    ${WHITE}tfx multi debug${RESET} ${DIM}[--lines 30]${RESET}          ${GRAY}강화 디버그 출력(환경/세션/pane tail)${RESET}
-    ${WHITE}tfx multi tasks${RESET}                       ${GRAY}공유 태스크 목록${RESET}
-    ${WHITE}tfx multi task${RESET} ${DIM}<pending|progress|done> <T1>${RESET} ${GRAY}태스크 상태 갱신${RESET}
-    ${WHITE}tfx multi attach${RESET} ${DIM}[--wt]${RESET}               ${GRAY}세션 재연결 (WT 분할은 opt-in)${RESET}
-    ${WHITE}tfx multi focus${RESET} ${DIM}<lead|이름|번호> [--wt]${RESET} ${GRAY}특정 팀메이트 포커스${RESET}
-    ${WHITE}tfx multi send${RESET} ${DIM}<lead|이름|번호> "msg"${RESET} ${GRAY}팀메이트에 메시지 주입${RESET}
-    ${WHITE}tfx multi interrupt${RESET} ${DIM}<대상>${RESET}            ${GRAY}팀메이트 인터럽트(C-c)${RESET}
-    ${WHITE}tfx multi control${RESET} ${DIM}<대상> <cmd>${RESET}        ${GRAY}리드 제어명령(interrupt|stop|pause|resume)${RESET}
-    ${WHITE}tfx multi stop${RESET}                        ${GRAY}graceful 종료${RESET}
-    ${WHITE}tfx multi kill${RESET}                        ${GRAY}모든 팀 세션 강제 종료${RESET}
-    ${WHITE}tfx multi list${RESET}                        ${GRAY}활성 세션 목록${RESET}
-
-  ${BOLD}키 조작(Claude teammate 스타일, tmux 모드)${RESET}
-    ${WHITE}Shift+Down${RESET}  ${GRAY}다음 팀메이트${RESET}
-    ${WHITE}Shift+Tab${RESET}   ${GRAY}이전 팀메이트 (권장)${RESET}
-    ${WHITE}Shift+Left${RESET}  ${GRAY}이전 팀메이트 (대체)${RESET}
-    ${WHITE}Shift+Up${RESET}    ${GRAY}미지원 (Claude Code가 캡처 불가, scroll-up 충돌)${RESET}
-    ${WHITE}Escape${RESET}      ${GRAY}현재 팀메이트 인터럽트${RESET}
-    ${WHITE}Ctrl+T${RESET}      ${GRAY}태스크 목록 토글${RESET}
-`);
-}
+import { AMBER, BOLD, DIM, GRAY, RESET, WHITE } from "../shared.mjs";
+
+export function renderTeamHelp() {
+  console.log(`
+  ${AMBER}${BOLD}⬡ tfx multi${RESET} ${DIM}멀티-CLI 팀 모드 (Lead + Teammates)${RESET}
+
+  ${BOLD}시작${RESET}
+    ${WHITE}tfx multi "작업 설명"${RESET}
+    ${WHITE}tfx multi --agents codex,gemini --lead claude "작업"${RESET}
+    ${WHITE}tfx multi --teammate-mode tmux "작업"${RESET}
+    ${WHITE}tfx multi --teammate-mode wt "작업"${RESET}   ${DIM}(Windows Terminal split-pane)${RESET}
+    ${WHITE}tfx multi --layout 1xN "작업"${RESET}               ${DIM}(세로 분할 컬럼)${RESET}
+    ${WHITE}tfx multi --layout Nx1 "작업"${RESET}               ${DIM}(가로 분할 스택)${RESET}
+    ${WHITE}tfx multi --dashboard-layout auto "작업"${RESET}    ${DIM}(dashboard viewer 레이아웃 자동 결정)${RESET}
+    ${WHITE}tfx multi --dashboard-size 0.4 "작업"${RESET}      ${DIM}(대시보드 분할 비율 0.2~0.8, 기본 0.50)${RESET}
+    ${WHITE}tfx multi --dashboard-anchor window "작업"${RESET} ${DIM}(대시보드 고정 위치: window|tab, 기본 window)${RESET}
+    ${WHITE}tfx multi --teammate-mode in-process "작업"${RESET} ${DIM}(tmux 불필요)${RESET}
+
+  ${BOLD}제어${RESET}
+    ${WHITE}tfx multi status${RESET}                      ${GRAY}현재 팀 상태${RESET}
+    ${WHITE}tfx multi debug${RESET} ${DIM}[--lines 30]${RESET}          ${GRAY}강화 디버그 출력(환경/세션/pane tail)${RESET}
+    ${WHITE}tfx multi tasks${RESET}                       ${GRAY}공유 태스크 목록${RESET}
+    ${WHITE}tfx multi task${RESET} ${DIM}<pending|progress|done> <T1>${RESET} ${GRAY}태스크 상태 갱신${RESET}
+    ${WHITE}tfx multi attach${RESET} ${DIM}[--wt]${RESET}               ${GRAY}세션 재연결 (WT 분할은 opt-in)${RESET}
+    ${WHITE}tfx multi focus${RESET} ${DIM}<lead|이름|번호> [--wt]${RESET} ${GRAY}특정 팀메이트 포커스${RESET}
+    ${WHITE}tfx multi send${RESET} ${DIM}<lead|이름|번호> "msg"${RESET} ${GRAY}팀메이트에 메시지 주입${RESET}
+    ${WHITE}tfx multi interrupt${RESET} ${DIM}<대상>${RESET}            ${GRAY}팀메이트 인터럽트(C-c)${RESET}
+    ${WHITE}tfx multi control${RESET} ${DIM}<대상> <cmd>${RESET}        ${GRAY}리드 제어명령(interrupt|stop|pause|resume)${RESET}
+    ${WHITE}tfx multi stop${RESET}                        ${GRAY}graceful 종료${RESET}
+    ${WHITE}tfx multi kill${RESET}                        ${GRAY}모든 팀 세션 강제 종료${RESET}
+    ${WHITE}tfx multi list${RESET}                        ${GRAY}활성 세션 목록${RESET}
+
+  ${BOLD}키 조작(Claude teammate 스타일, tmux 모드)${RESET}
+    ${WHITE}Shift+Down${RESET}  ${GRAY}다음 팀메이트${RESET}
+    ${WHITE}Shift+Tab${RESET}   ${GRAY}이전 팀메이트 (권장)${RESET}
+    ${WHITE}Shift+Left${RESET}  ${GRAY}이전 팀메이트 (대체)${RESET}
+    ${WHITE}Shift+Up${RESET}    ${GRAY}미지원 (Claude Code가 캡처 불가, scroll-up 충돌)${RESET}
+    ${WHITE}Escape${RESET}      ${GRAY}현재 팀메이트 인터럽트${RESET}
+    ${WHITE}Ctrl+T${RESET}      ${GRAY}태스크 목록 토글${RESET}
+`);
+}

package/hub/team/cli/services/hub-client.mjs

@@ -1,208 +1,208 @@
-import { existsSync, mkdirSync, readFileSync, unlinkSync, writeFileSync } from "node:fs";
-import { join } from "node:path";
-import { spawn } from "node:child_process";
-
-import { HUB_PID_DIR, PKG_ROOT } from "./state-store.mjs";
-export { nativeGetStatus } from "./native-control.mjs";
-
-const HUB_PID_FILE = join(HUB_PID_DIR, "hub.pid");
-const LOOPBACK_HOSTS = new Set(["127.0.0.1", "localhost", "::1"]);
-
-export function formatHostForUrl(host) {
-  return host.includes(":") ? `[${host}]` : host;
-}
-
-export function buildHubBaseUrl(host, port) {
-  return `http://${formatHostForUrl(host)}:${port}`;
-}
-
-export function getDefaultHubPort() {
-  const envPortRaw = Number(process.env.TFX_HUB_PORT || "27888");
-  return Number.isFinite(envPortRaw) && envPortRaw > 0 ? envPortRaw : 27888;
-}
-
-export function getDefaultHubUrl() {
-  return `${buildHubBaseUrl("127.0.0.1", getDefaultHubPort())}/mcp`;
-}
-
-function normalizeLoopbackHost(host) {
-  if (typeof host !== "string") return "127.0.0.1";
-  const candidate = host.trim();
-  return LOOPBACK_HOSTS.has(candidate) ? candidate : "127.0.0.1";
-}
-
-async function probeHubStatus(host, port, timeoutMs = 1500) {
-  try {
-    const res = await fetch(`${buildHubBaseUrl(host, port)}/status`, {
-      signal: AbortSignal.timeout(timeoutMs),
-    });
-    if (!res.ok) return null;
-    const data = await res.json();
-    return data?.hub ? data : null;
-  } catch {
-    return null;
-  }
-}
-
-export async function getHubInfo() {
-  const probePort = getDefaultHubPort();
-
-  if (existsSync(HUB_PID_FILE)) {
-    try {
-      const raw = JSON.parse(readFileSync(HUB_PID_FILE, "utf8"));
-      const pid = Number(raw?.pid);
-      if (!Number.isFinite(pid) || pid <= 0) throw new Error("invalid pid");
-      process.kill(pid, 0);
-      const host = normalizeLoopbackHost(raw?.host);
-      const port = Number(raw?.port) || 27888;
-      const status = await probeHubStatus(host, port, 1200);
-      return {
-        ...raw,
-        pid,
-        host,
-        port,
-        url: `${buildHubBaseUrl(host, port)}/mcp`,
-        ...(status ? {} : { degraded: true }),
-      };
-    } catch {
-      try { unlinkSync(HUB_PID_FILE); } catch {}
-    }
-  }
-
-  for (const portCandidate of Array.from(new Set([probePort, 27888]))) {
-    const data = await probeHubStatus("127.0.0.1", portCandidate, 1200);
-    if (!data) continue;
-    const port = Number(data.port) || portCandidate;
-    const pid = Number(data.pid);
-    const recovered = {
-      pid: Number.isFinite(pid) ? pid : null,
-      host: "127.0.0.1",
-      port,
-      url: `${buildHubBaseUrl("127.0.0.1", port)}/mcp`,
-      discovered: true,
-    };
-    if (Number.isFinite(recovered.pid) && recovered.pid > 0) {
-      try {
-        mkdirSync(HUB_PID_DIR, { recursive: true });
-        writeFileSync(HUB_PID_FILE, JSON.stringify({ ...recovered, started: Date.now() }));
-      } catch {}
-    }
-    return recovered;
-  }
-  return null;
-}
-
-export async function startHubDaemon() {
-  const serverPath = join(PKG_ROOT, "hub", "server.mjs");
-  if (!existsSync(serverPath)) {
-    const error = new Error("hub/server.mjs 없음");
-    error.code = "HUB_SERVER_MISSING";
-    throw error;
-  }
-
-  const child = spawn(process.execPath, [serverPath], {
-    env: { ...process.env },
-    stdio: "ignore",
-    detached: true,
-    windowsHide: true,
-  });
-  child.unref();
-
-  const expectedPort = getDefaultHubPort();
-  const deadline = Date.now() + 3000;
-  while (Date.now() < deadline) {
-    const status = await probeHubStatus("127.0.0.1", expectedPort, 500);
-    if (status?.hub) {
-      return {
-        pid: Number(status.pid) || child.pid,
-        host: "127.0.0.1",
-        port: expectedPort,
-        url: `${buildHubBaseUrl("127.0.0.1", expectedPort)}/mcp`,
-      };
-    }
-    await new Promise((resolve) => setTimeout(resolve, 100));
-  }
-
-  return null;
-}
-
-/**
- * Hub가 살아있는지 확인하고, 죽어있으면 재시작을 시도한다.
- * exponential backoff: 1초, 2초, 4초
- * 모든 재시작 실패 시 에러를 throw한다 (silent fail 아님).
- * @param {number} [maxRetries=3]
- * @returns {Promise<object>} Hub 정보
- * @throws {Error} 모든 재시작 시도 실패 시
- */
-export async function ensureHubAlive(maxRetries = 3) {
-  const hub = await getHubInfo();
-  if (hub && !hub.degraded) return hub;
-
-  let lastError = null;
-  for (let i = 0; i < maxRetries; i++) {
-    try {
-      const restarted = await startHubDaemon();
-      if (restarted) {
-        // 재시작 후 연결 복구 확인
-        const recovered = await getHubInfo();
-        if (recovered) return recovered;
-      }
-    } catch (err) {
-      lastError = err;
-    }
-    // 다음 재시도 전 대기: 1초, 2초, 4초 (마지막 시도 후에는 대기 없음)
-    if (i < maxRetries - 1) {
-      const backoffMs = Math.pow(2, i) * 1000; // i=0: 1초, i=1: 2초, i=2: 4초
-      await new Promise((resolve) => setTimeout(resolve, backoffMs));
-    }
-  }
-
-  const error = new Error(`Hub 재시작 ${maxRetries}회 모두 실패${lastError ? `: ${lastError.message}` : ""}`);
-  error.code = "HUB_RESTART_FAILED";
-  error.cause = lastError;
-  throw error;
-}
-
-export async function fetchHubTaskList(state) {
-  const hubBase = (state?.hubUrl || getDefaultHubUrl()).replace(/\/mcp$/, "");
-  const teamName = state?.native?.teamName || state?.sessionName || null;
-  if (!teamName) return [];
-
-  try {
-    const res = await fetch(`${hubBase}/bridge/team/task-list`, {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({ team_name: teamName }),
-      signal: AbortSignal.timeout(2000),
-    });
-    const data = await res.json();
-    return data?.ok ? (data.data?.tasks || []) : [];
-  } catch {
-    return [];
-  }
-}
-
-export async function publishLeadControl(state, targetMember, command, reason = "") {
-  const hubBase = (state?.hubUrl || getDefaultHubUrl()).replace(/\/mcp$/, "");
-  const leadAgent = (state?.members || []).find((member) => member.role === "lead")?.agentId || "lead";
-
-  try {
-    const res = await fetch(`${hubBase}/bridge/control`, {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({
-        from_agent: leadAgent,
-        to_agent: targetMember.agentId,
-        command,
-        reason,
-        payload: {
-          issued_by: leadAgent,
-          issued_at: Date.now(),
-        },
-      }),
-    });
-    return !!res.ok;
-  } catch {
-    return false;
-  }
-}
+import { existsSync, mkdirSync, readFileSync, unlinkSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { spawn } from "node:child_process";
+
+import { HUB_PID_DIR, PKG_ROOT } from "./state-store.mjs";
+export { nativeGetStatus } from "./native-control.mjs";
+
+const HUB_PID_FILE = join(HUB_PID_DIR, "hub.pid");
+const LOOPBACK_HOSTS = new Set(["127.0.0.1", "localhost", "::1"]);
+
+export function formatHostForUrl(host) {
+  return host.includes(":") ? `[${host}]` : host;
+}
+
+export function buildHubBaseUrl(host, port) {
+  return `http://${formatHostForUrl(host)}:${port}`;
+}
+
+export function getDefaultHubPort() {
+  const envPortRaw = Number(process.env.TFX_HUB_PORT || "27888");
+  return Number.isFinite(envPortRaw) && envPortRaw > 0 ? envPortRaw : 27888;
+}
+
+export function getDefaultHubUrl() {
+  return `${buildHubBaseUrl("127.0.0.1", getDefaultHubPort())}/mcp`;
+}
+
+function normalizeLoopbackHost(host) {
+  if (typeof host !== "string") return "127.0.0.1";
+  const candidate = host.trim();
+  return LOOPBACK_HOSTS.has(candidate) ? candidate : "127.0.0.1";
+}
+
+async function probeHubStatus(host, port, timeoutMs = 1500) {
+  try {
+    const res = await fetch(`${buildHubBaseUrl(host, port)}/status`, {
+      signal: AbortSignal.timeout(timeoutMs),
+    });
+    if (!res.ok) return null;
+    const data = await res.json();
+    return data?.hub ? data : null;
+  } catch {
+    return null;
+  }
+}
+
+export async function getHubInfo() {
+  const probePort = getDefaultHubPort();
+
+  if (existsSync(HUB_PID_FILE)) {
+    try {
+      const raw = JSON.parse(readFileSync(HUB_PID_FILE, "utf8"));
+      const pid = Number(raw?.pid);
+      if (!Number.isFinite(pid) || pid <= 0) throw new Error("invalid pid");
+      process.kill(pid, 0);
+      const host = normalizeLoopbackHost(raw?.host);
+      const port = Number(raw?.port) || 27888;
+      const status = await probeHubStatus(host, port, 1200);
+      return {
+        ...raw,
+        pid,
+        host,
+        port,
+        url: `${buildHubBaseUrl(host, port)}/mcp`,
+        ...(status ? {} : { degraded: true }),
+      };
+    } catch {
+      try { unlinkSync(HUB_PID_FILE); } catch {}
+    }
+  }
+
+  for (const portCandidate of Array.from(new Set([probePort, 27888]))) {
+    const data = await probeHubStatus("127.0.0.1", portCandidate, 1200);
+    if (!data) continue;
+    const port = Number(data.port) || portCandidate;
+    const pid = Number(data.pid);
+    const recovered = {
+      pid: Number.isFinite(pid) ? pid : null,
+      host: "127.0.0.1",
+      port,
+      url: `${buildHubBaseUrl("127.0.0.1", port)}/mcp`,
+      discovered: true,
+    };
+    if (Number.isFinite(recovered.pid) && recovered.pid > 0) {
+      try {
+        mkdirSync(HUB_PID_DIR, { recursive: true });
+        writeFileSync(HUB_PID_FILE, JSON.stringify({ ...recovered, started: Date.now() }));
+      } catch {}
+    }
+    return recovered;
+  }
+  return null;
+}
+
+export async function startHubDaemon() {
+  const serverPath = join(PKG_ROOT, "hub", "server.mjs");
+  if (!existsSync(serverPath)) {
+    const error = new Error("hub/server.mjs 없음");
+    error.code = "HUB_SERVER_MISSING";
+    throw error;
+  }
+
+  const child = spawn(process.execPath, [serverPath], {
+    env: { ...process.env },
+    stdio: "ignore",
+    detached: true,
+    windowsHide: true,
+  });
+  child.unref();
+
+  const expectedPort = getDefaultHubPort();
+  const deadline = Date.now() + 3000;
+  while (Date.now() < deadline) {
+    const status = await probeHubStatus("127.0.0.1", expectedPort, 500);
+    if (status?.hub) {
+      return {
+        pid: Number(status.pid) || child.pid,
+        host: "127.0.0.1",
+        port: expectedPort,
+        url: `${buildHubBaseUrl("127.0.0.1", expectedPort)}/mcp`,
+      };
+    }
+    await new Promise((resolve) => setTimeout(resolve, 100));
+  }
+
+  return null;
+}
+
+/**
+ * Hub가 살아있는지 확인하고, 죽어있으면 재시작을 시도한다.
+ * exponential backoff: 1초, 2초, 4초
+ * 모든 재시작 실패 시 에러를 throw한다 (silent fail 아님).
+ * @param {number} [maxRetries=3]
+ * @returns {Promise<object>} Hub 정보
+ * @throws {Error} 모든 재시작 시도 실패 시
+ */
+export async function ensureHubAlive(maxRetries = 3) {
+  const hub = await getHubInfo();
+  if (hub && !hub.degraded) return hub;
+
+  let lastError = null;
+  for (let i = 0; i < maxRetries; i++) {
+    try {
+      const restarted = await startHubDaemon();
+      if (restarted) {
+        // 재시작 후 연결 복구 확인
+        const recovered = await getHubInfo();
+        if (recovered) return recovered;
+      }
+    } catch (err) {
+      lastError = err;
+    }
+    // 다음 재시도 전 대기: 1초, 2초, 4초 (마지막 시도 후에는 대기 없음)
+    if (i < maxRetries - 1) {
+      const backoffMs = Math.pow(2, i) * 1000; // i=0: 1초, i=1: 2초, i=2: 4초
+      await new Promise((resolve) => setTimeout(resolve, backoffMs));
+    }
+  }
+
+  const error = new Error(`Hub 재시작 ${maxRetries}회 모두 실패${lastError ? `: ${lastError.message}` : ""}`);
+  error.code = "HUB_RESTART_FAILED";
+  error.cause = lastError;
+  throw error;
+}
+
+export async function fetchHubTaskList(state) {
+  const hubBase = (state?.hubUrl || getDefaultHubUrl()).replace(/\/mcp$/, "");
+  const teamName = state?.native?.teamName || state?.sessionName || null;
+  if (!teamName) return [];
+
+  try {
+    const res = await fetch(`${hubBase}/bridge/team/task-list`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ team_name: teamName }),
+      signal: AbortSignal.timeout(2000),
+    });
+    const data = await res.json();
+    return data?.ok ? (data.data?.tasks || []) : [];
+  } catch {
+    return [];
+  }
+}
+
+export async function publishLeadControl(state, targetMember, command, reason = "") {
+  const hubBase = (state?.hubUrl || getDefaultHubUrl()).replace(/\/mcp$/, "");
+  const leadAgent = (state?.members || []).find((member) => member.role === "lead")?.agentId || "lead";
+
+  try {
+    const res = await fetch(`${hubBase}/bridge/control`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        from_agent: leadAgent,
+        to_agent: targetMember.agentId,
+        command,
+        reason,
+        payload: {
+          issued_by: leadAgent,
+          issued_at: Date.now(),
+        },
+      }),
+    });
+    return !!res.ok;
+  } catch {
+    return false;
+  }
+}