@triflux/remote 10.1.0 → 10.25.1

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

@@ -1,69 +1,86 @@
-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,
-    },
-  };
-}
+import { buildCliCommand } from "../../../pane.mjs";
+import { createWtSession } from "../../../session.mjs";
+import { warn } from "../../render.mjs";
+import { toAgentId } from "../../services/member-selector.mjs";
+import { buildTasks } from "../../services/task-model.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 = await 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,
+    },
+  };
+}

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

@@ -1,16 +1,22 @@
-import { AMBER, BOLD, DIM, GRAY, GREEN, RED, RESET } from "../../shared.mjs";
 import { hasWindowsTerminalSession } from "../../session.mjs";
+import { AMBER, BOLD, DIM, GRAY, GREEN, RED, RESET } from "../../shared.mjs";
+import { formatCompletionSuffix } from "../render.mjs";
 import { fetchHubTaskList, nativeGetStatus } from "../services/hub-client.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 { formatCompletionSuffix } from "../render.mjs";
 
 export async function teamStatus(args = []) {
   const json = process.env.TFX_OUTPUT_JSON === "1" || args.includes("--json");
   const state = loadTeamState();
   if (!state) {
     if (json) {
-      process.stdout.write(`${JSON.stringify({ status: "offline", sessionName: null, alive: false }, null, 2)}\n`);
+      process.stdout.write(
+        `${JSON.stringify({ status: "offline", sessionName: null, alive: false }, null, 2)}\n`,
+      );
       return;
     }
     console.log(`\n  ${DIM}활성 팀 세션 없음${RESET}\n`);
@@ -48,37 +54,60 @@ export async function teamStatus(args = []) {
     return;
   }
 
-  console.log(`\n  ${AMBER}${BOLD}⬡ tfx multi${RESET} ${alive ? `${GREEN}● active${RESET}` : `${RED}● dead${RESET}`}\n`);
+  console.log(
+    `\n  ${AMBER}${BOLD}⬡ tfx multi${RESET} ${alive ? `${GREEN}● active${RESET}` : `${RED}● dead${RESET}`}\n`,
+  );
   console.log(`    세션:   ${state.sessionName}`);
   console.log(`    모드:   ${state.teammateMode || "tmux"}`);
   console.log(`    리드:   ${state.lead || "claude"}`);
   console.log(`    워커:   ${(state.agents || []).join(", ")}`);
-  console.log(`    Uptime: ${alive ? `${Math.round((Date.now() - state.startedAt) / 60000)}분` : "-"}`);
+  console.log(
+    `    Uptime: ${alive ? `${Math.round((Date.now() - state.startedAt) / 60000)}분` : "-"}`,
+  );
   console.log(`    태스크: ${(state.tasks || []).length}`);
   if (isWtMode(state) && !hasWindowsTerminalSession()) {
-    console.log(`    ${DIM}WT_SESSION 미감지: 생존성은 heuristics로 판정됨${RESET}`);
+    console.log(
+      `    ${DIM}WT_SESSION 미감지: 생존성은 heuristics로 판정됨${RESET}`,
+    );
   }
 
   for (const member of state.members || []) {
-    console.log(`    - ${member.name} (${member.cli}) ${DIM}${member.role}${RESET} ${DIM}${member.pane}${RESET}`);
+    console.log(
+      `    - ${member.name} (${member.cli}) ${DIM}${member.role}${RESET} ${DIM}${member.pane}${RESET}`,
+    );
   }
 
   if (isNativeMode(state) && alive) {
     for (const member of payload.nativeMembers) {
-      console.log(`    • ${member.name}: ${member.status}${formatCompletionSuffix(member)}${member.lastPreview ? ` ${DIM}${member.lastPreview}${RESET}` : ""}`);
+      console.log(
+        `    • ${member.name}: ${member.status}${formatCompletionSuffix(member)}${member.lastPreview ? ` ${DIM}${member.lastPreview}${RESET}` : ""}`,
+      );
     }
   }
 
   if (alive) {
-    const hubTasks = payload.hubTasks || await fetchHubTaskList(state);
+    const hubTasks = payload.hubTasks || (await fetchHubTaskList(state));
     if (hubTasks.length) {
-      const completed = hubTasks.filter((task) => task.status === "completed").length;
+      const completed = hubTasks.filter(
+        (task) => task.status === "completed",
+      ).length;
       const failed = hubTasks.filter((task) => task.status === "failed").length;
-      console.log(`\n  ${BOLD}Hub Tasks${RESET} ${DIM}(${completed}/${hubTasks.length} done)${RESET}`);
+      console.log(
+        `\n  ${BOLD}Hub Tasks${RESET} ${DIM}(${completed}/${hubTasks.length} done)${RESET}`,
+      );
       for (const task of hubTasks) {
-        const icon = task.status === "completed" ? `${GREEN}✓${RESET}` : task.status === "in_progress" ? `${AMBER}●${RESET}` : task.status === "failed" ? `${RED}✗${RESET}` : `${GRAY}○${RESET}`;
+        const icon =
+          task.status === "completed"
+            ? `${GREEN}✓${RESET}`
+            : task.status === "in_progress"
+              ? `${AMBER}●${RESET}`
+              : task.status === "failed"
+                ? `${RED}✗${RESET}`
+                : `${GRAY}○${RESET}`;
         const owner = task.owner ? ` ${GRAY}[${task.owner}]${RESET}` : "";
-        console.log(`    ${icon} ${task.subject || task.description?.slice(0, 50) || ""}${owner}`);
+        console.log(
+          `    ${icon} ${task.subject || task.description?.slice(0, 50) || ""}${owner}`,
+        );
       }
       if (failed > 0) console.log(`    ${RED}⚠ ${failed}건 실패${RESET}`);
     }

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

@@ -1,9 +1,9 @@
 import { closeWtSession, killSession, sessionExists } from "../../session.mjs";
 import { DIM, RESET } from "../../shared.mjs";
+import { ok } from "../render.mjs";
 import { nativeRequest } from "../services/native-control.mjs";
 import { isNativeMode, isWtMode } from "../services/runtime-mode.mjs";
 import { clearTeamState, loadTeamState } from "../services/state-store.mjs";
-import { ok } from "../render.mjs";
 
 export async function teamStop() {
   const state = loadTeamState();
@@ -14,11 +14,18 @@ export async function teamStop() {
 
   if (isNativeMode(state)) {
     await nativeRequest(state, "/stop", {});
-    try { process.kill(state.native.supervisorPid, "SIGTERM"); } catch {}
+    try {
+      process.kill(state.native.supervisorPid, "SIGTERM");
+    } catch {}
     ok(`세션 종료: ${state.sessionName}`);
   } else if (isWtMode(state)) {
-    const closed = closeWtSession({ layout: state?.wt?.layout || state?.layout || "1xN", paneCount: state?.wt?.paneCount ?? (state.members || []).length });
-    ok(`세션 종료: ${state.sessionName}${closed ? ` (${closed} panes closed)` : ""}`);
+    const closed = closeWtSession({
+      layout: state?.wt?.layout || state?.layout || "1xN",
+      paneCount: state?.wt?.paneCount ?? (state.members || []).length,
+    });
+    ok(
+      `세션 종료: ${state.sessionName}${closed ? ` (${closed} panes closed)` : ""}`,
+    );
   } else if (sessionExists(state.sessionName)) {
     killSession(state.sessionName);
     ok(`세션 종료: ${state.sessionName}`);

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

@@ -1,8 +1,11 @@
 import { DIM, RESET, WHITE } from "../../shared.mjs";
+import { ok } from "../render.mjs";
 import { isTeamAlive } from "../services/runtime-mode.mjs";
 import { loadTeamState, saveTeamState } from "../services/state-store.mjs";
-import { normalizeTaskStatus, updateTaskStatus } from "../services/task-model.mjs";
-import { ok } from "../render.mjs";
+import {
+  normalizeTaskStatus,
+  updateTaskStatus,
+} from "../services/task-model.mjs";
 
 export function teamTaskUpdate(args = []) {
   const state = loadTeamState();
@@ -14,7 +17,9 @@ export function teamTaskUpdate(args = []) {
   const nextStatus = normalizeTaskStatus(args[0]);
   const taskId = String(args[1] || "").toUpperCase();
   if (!nextStatus || !taskId) {
-    console.log(`\n  사용법: ${WHITE}tfx multi task <pending|progress|done> <T1>${RESET}\n`);
+    console.log(
+      `\n  사용법: ${WHITE}tfx multi task <pending|progress|done> <T1>${RESET}\n`,
+    );
     return;
   }
 

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

@@ -1,13 +1,13 @@
-import { DIM, RESET } from "../../shared.mjs";
-import { isTeamAlive } from "../services/runtime-mode.mjs";
-import { loadTeamState } from "../services/state-store.mjs";
-import { renderTasks } from "../render.mjs";
-
-export function teamTasks() {
-  const state = loadTeamState();
-  if (!state || !isTeamAlive(state)) {
-    console.log(`\n  ${DIM}활성 팀 세션 없음${RESET}\n`);
-    return;
-  }
-  renderTasks(state.tasks || []);
-}
+import { DIM, RESET } from "../../shared.mjs";
+import { renderTasks } from "../render.mjs";
+import { isTeamAlive } from "../services/runtime-mode.mjs";
+import { loadTeamState } from "../services/state-store.mjs";
+
+export function teamTasks() {
+  const state = loadTeamState();
+  if (!state || !isTeamAlive(state)) {
+    console.log(`\n  ${DIM}활성 팀 세션 없음${RESET}\n`);
+    return;
+  }
+  renderTasks(state.tasks || []);
+}

package/hub/team/cli/index.mjs

@@ -1,5 +1,3 @@
-import { renderTeamHelp } from "./help.mjs";
-import { resolveTeamCommand } from "./manifest.mjs";
 import { teamAttach } from "./commands/attach.mjs";
 import { teamControl } from "./commands/control.mjs";
 import { teamDebug } from "./commands/debug.mjs";
@@ -13,6 +11,8 @@ import { teamStatus } from "./commands/status.mjs";
 import { teamStop } from "./commands/stop.mjs";
 import { teamTaskUpdate } from "./commands/task.mjs";
 import { teamTasks } from "./commands/tasks.mjs";
+import { renderTeamHelp } from "./help.mjs";
+import { resolveTeamCommand } from "./manifest.mjs";
 
 const handlers = {
   attach: teamAttach,

package/hub/team/cli/manifest.mjs

@@ -1,18 +1,46 @@
 export const TEAM_COMMANDS = [
   { name: "status", usage: "tfx multi status", desc: "현재 팀 상태" },
-  { name: "debug", usage: "tfx multi debug [--lines 30]", desc: "강화 디버그 출력" },
+  {
+    name: "debug",
+    usage: "tfx multi debug [--lines 30]",
+    desc: "강화 디버그 출력",
+  },
   { name: "tasks", usage: "tfx multi tasks", desc: "공유 태스크 목록" },
-  { name: "task", usage: "tfx multi task <pending|progress|done> <T1>", desc: "태스크 상태 갱신" },
+  {
+    name: "task",
+    usage: "tfx multi task <pending|progress|done> <T1>",
+    desc: "태스크 상태 갱신",
+  },
   { name: "attach", usage: "tfx multi attach [--wt]", desc: "세션 재연결" },
-  { name: "focus", usage: "tfx multi focus <lead|이름|번호> [--wt]", desc: "특정 팀메이트 포커스" },
-  { name: "send", usage: "tfx multi send <lead|이름|번호> \"msg\"", desc: "팀메이트에 메시지 주입" },
-  { name: "interrupt", usage: "tfx multi interrupt <대상>", desc: "팀메이트 인터럽트(C-c)" },
-  { name: "control", usage: "tfx multi control <대상> <cmd> [사유]", desc: "리드 제어명령 전송" },
+  {
+    name: "focus",
+    usage: "tfx multi focus <lead|이름|번호> [--wt]",
+    desc: "특정 팀메이트 포커스",
+  },
+  {
+    name: "send",
+    usage: 'tfx multi send <lead|이름|번호> "msg"',
+    desc: "팀메이트에 메시지 주입",
+  },
+  {
+    name: "interrupt",
+    usage: "tfx multi interrupt <대상>",
+    desc: "팀메이트 인터럽트(C-c)",
+  },
+  {
+    name: "control",
+    usage: "tfx multi control <대상> <cmd> [사유]",
+    desc: "리드 제어명령 전송",
+  },
   { name: "stop", usage: "tfx multi stop", desc: "graceful 종료" },
   { name: "kill", usage: "tfx multi kill", desc: "모든 팀 세션 강제 종료" },
   { name: "list", usage: "tfx multi list", desc: "활성 세션 목록" },
   { name: "help", usage: "tfx multi help", desc: "도움말" },
-  { name: "start", usage: "tfx multi start [options]", desc: "새 팀 세션 시작 (기본 커맨드)" },
+  {
+    name: "start",
+    usage: "tfx multi start [options]",
+    desc: "새 팀 세션 시작 (기본 커맨드)",
+  },
 ];
 
 export const TEAM_COMMAND_ALIASES = new Map([
@@ -25,5 +53,7 @@ export const TEAM_SUBCOMMANDS = new Set(TEAM_COMMANDS.map(({ name }) => name));
 export function resolveTeamCommand(raw) {
   if (typeof raw !== "string") return null;
   const command = raw.toLowerCase();
-  return TEAM_SUBCOMMANDS.has(command) ? command : (TEAM_COMMAND_ALIASES.get(command) || null);
+  return TEAM_SUBCOMMANDS.has(command)
+    ? command
+    : TEAM_COMMAND_ALIASES.get(command) || null;
 }

package/hub/team/cli/render.mjs

@@ -1,30 +1,52 @@
-import { AMBER, BOLD, DIM, GRAY, GREEN, RED, RESET, WHITE, YELLOW } from "../shared.mjs";
-
-export function ok(msg) { console.log(`  ${GREEN}✓${RESET} ${msg}`); }
-export function warn(msg) { console.log(`  ${YELLOW}⚠${RESET} ${msg}`); }
-export function fail(msg) { console.log(`  ${RED}✗${RESET} ${msg}`); }
-
-export function renderTasks(tasks = []) {
-  if (!tasks.length) {
-    console.log(`\n  ${DIM}태스크 없음${RESET}\n`);
-    return;
-  }
-
-  console.log(`\n  ${AMBER}${BOLD}⬡ Team Tasks${RESET}\n`);
-  for (const task of tasks) {
-    const dep = task.depends_on?.length ? ` ${DIM}(deps: ${task.depends_on.join(",")})${RESET}` : "";
-    const owner = task.owner ? ` ${GRAY}[${task.owner}]${RESET}` : "";
-    console.log(`    ${WHITE}${task.id}${RESET} ${String(task.status || "").padEnd(11)} ${task.title}${owner}${dep}`);
-  }
-  console.log("");
-}
-
-export function formatCompletionSuffix(member) {
-  if (!member?.completionStatus) return "";
-  if (member.completionStatus === "abnormal") {
-    return ` ${RED}[abnormal:${member.completionReason || "unknown"}]${RESET}`;
-  }
-  if (member.completionStatus === "normal") return ` ${GREEN}[route-ok]${RESET}`;
-  if (member.completionStatus === "unchecked") return ` ${GRAY}[route-unchecked]${RESET}`;
-  return "";
-}
+import {
+  AMBER,
+  BOLD,
+  DIM,
+  GRAY,
+  GREEN,
+  RED,
+  RESET,
+  WHITE,
+  YELLOW,
+} from "../shared.mjs";
+
+export function ok(msg) {
+  console.log(`  ${GREEN}✓${RESET} ${msg}`);
+}
+export function warn(msg) {
+  console.log(`  ${YELLOW}⚠${RESET} ${msg}`);
+}
+export function fail(msg) {
+  console.log(`  ${RED}✗${RESET} ${msg}`);
+}
+
+export function renderTasks(tasks = []) {
+  if (!tasks.length) {
+    console.log(`\n  ${DIM}태스크 없음${RESET}\n`);
+    return;
+  }
+
+  console.log(`\n  ${AMBER}${BOLD}⬡ Team Tasks${RESET}\n`);
+  for (const task of tasks) {
+    const dep = task.depends_on?.length
+      ? ` ${DIM}(deps: ${task.depends_on.join(",")})${RESET}`
+      : "";
+    const owner = task.owner ? ` ${GRAY}[${task.owner}]${RESET}` : "";
+    console.log(
+      `    ${WHITE}${task.id}${RESET} ${String(task.status || "").padEnd(11)} ${task.title}${owner}${dep}`,
+    );
+  }
+  console.log("");
+}
+
+export function formatCompletionSuffix(member) {
+  if (!member?.completionStatus) return "";
+  if (member.completionStatus === "abnormal") {
+    return ` ${RED}[abnormal:${member.completionReason || "unknown"}]${RESET}`;
+  }
+  if (member.completionStatus === "normal")
+    return ` ${GREEN}[route-ok]${RESET}`;
+  if (member.completionStatus === "unchecked")
+    return ` ${GRAY}[route-unchecked]${RESET}`;
+  return "";
+}

package/hub/team/cli/services/attach-fallback.mjs

@@ -1,54 +1,74 @@
-import { spawn } from "node:child_process";
-
-import {
-  getSessionAttachedCount,
-  hasWindowsTerminal,
-  resolveAttachCommand,
-} from "../../session.mjs";
-import { PKG_ROOT } from "./state-store.mjs";
-
-export async function launchAttachInWindowsTerminal(sessionName) {
-  if (!hasWindowsTerminal()) return false;
-
-  let attachSpec;
-  try {
-    attachSpec = resolveAttachCommand(sessionName);
-  } catch {
-    return false;
-  }
-
-  const beforeAttached = getSessionAttachedCount(sessionName);
-  try {
-    const child = spawn("wt", ["-w", "0", "split-pane", "-V", "-d", PKG_ROOT, attachSpec.command, ...attachSpec.args], {
-      detached: true,
-      stdio: "ignore",
-      windowsHide: false,
-    });
-    child.unref();
-
-    if (beforeAttached == null) return true;
-    const deadline = Date.now() + 3500;
-    while (Date.now() < deadline) {
-      await new Promise((resolve) => setTimeout(resolve, 120));
-      const nowAttached = getSessionAttachedCount(sessionName);
-      if (typeof nowAttached === "number" && nowAttached > beforeAttached) return true;
-    }
-  } catch {}
-  return false;
-}
-
-export function buildManualAttachCommand(sessionName) {
-  try {
-    const spec = resolveAttachCommand(sessionName);
-    return [spec.command, ...spec.args].map((value) => {
-      const text = String(value);
-      return /\s/.test(text) ? `"${text.replace(/"/g, '\\"')}"` : text;
-    }).join(" ");
-  } catch {
-    return `tmux attach-session -t ${sessionName}`;
-  }
-}
-
-export function wantsWtAttachFallback(args = [], env = process.env) {
-  return args.includes("--wt") || args.includes("--spawn-wt") || env.TFX_ATTACH_WT_AUTO === "1";
-}
+import { spawn } from "node:child_process";
+
+import {
+  getSessionAttachedCount,
+  hasWindowsTerminal,
+  resolveAttachCommand,
+} from "../../session.mjs";
+import { PKG_ROOT } from "./state-store.mjs";
+
+export async function launchAttachInWindowsTerminal(sessionName) {
+  if (!hasWindowsTerminal()) return false;
+
+  let attachSpec;
+  try {
+    attachSpec = resolveAttachCommand(sessionName);
+  } catch {
+    return false;
+  }
+
+  const beforeAttached = getSessionAttachedCount(sessionName);
+  try {
+    const child = spawn(
+      "wt",
+      [
+        "-w",
+        "0",
+        "split-pane",
+        "-V",
+        "-d",
+        PKG_ROOT,
+        attachSpec.command,
+        ...attachSpec.args,
+      ],
+      {
+        detached: true,
+        stdio: "ignore",
+        windowsHide: false,
+      },
+    );
+    child.unref();
+
+    if (beforeAttached == null) return true;
+    const deadline = Date.now() + 3500;
+    while (Date.now() < deadline) {
+      await new Promise((resolve) => setTimeout(resolve, 120));
+      const nowAttached = getSessionAttachedCount(sessionName);
+      if (typeof nowAttached === "number" && nowAttached > beforeAttached)
+        return true;
+    }
+  } catch {}
+  return false;
+}
+
+export function buildManualAttachCommand(sessionName) {
+  try {
+    const spec = resolveAttachCommand(sessionName);
+    return [spec.command, ...spec.args]
+      .map((value) => {
+        const text = String(value);
+        return /\s/.test(text) ? `"${text.replace(/"/g, '\\"')}"` : text;
+      })
+      .join(" ");
+  } catch {
+    return `tmux attach-session -t ${sessionName}`;
+  }
+}
+
+export function wantsWtAttachFallback(args = [], env = process.env) {
+  return (
+    args.includes("--wt") ||
+    args.includes("--spawn-wt") ||
+    env.TFX_ATTACH_WT_AUTO === "1"
+  );
+}