triflux 10.13.7 → 10.13.9

package/bin/triflux.mjs

@@ -318,9 +318,10 @@ const CLI_COMMAND_SCHEMAS = Object.freeze({
     ],
   },
   swarm: {
-    usage: "tfx swarm <prd-path> [--dry-run|--json|--filter <shard>]",
+    usage: "tfx swarm [run] <prd-path> [--dry-run|--json|--filter <shard>]",
     description: "PRD 기반 멀티모델 x 멀티기기 스웜 실행 (#93)",
     subcommands: {
+      run: "tfx swarm run <prd-path> — verb 명시 실행 (기본 경로와 동일)",
       plan: "tfx swarm plan <prd-path> [--json] — 실행 없이 계획만 출력",
       list: "tfx swarm list [--json] — 활성 스웜 세션 조회 (synapse status)",
       status: "tfx swarm status [--json] — list alias",
@@ -4760,7 +4761,9 @@ ${updateNotice}
     ${WHITE_BRIGHT}tfx tray${RESET}       ${GRAY}Windows 시스템 트레이 실행${RESET}
     ${DIM}  --detach${RESET}      ${GRAY}백그라운드 트레이 프로세스로 분리${RESET}
     ${WHITE_BRIGHT}tfx multi${RESET}       ${GRAY}멀티-CLI 팀 모드 (tmux + Hub)${RESET}
-    ${WHITE_BRIGHT}tfx swarm${RESET}       ${GRAY}PRD 기반 worktree 격리 병렬 실행${RESET}
+    ${WHITE_BRIGHT}tfx swarm${RESET}       ${GRAY}PRD 기반 worktree 격리 병렬 실행 (run/plan/list)${RESET}
+    ${WHITE_BRIGHT}tfx synapse${RESET}     ${GRAY}스웜 세션 registry 조회 / lease 관리${RESET}
+    ${WHITE_BRIGHT}tfx why${RESET}         ${GRAY}경로의 마지막 커밋 X-Intent 트레일러 추출${RESET}
     ${WHITE_BRIGHT}tfx codex-team${RESET} ${GRAY}Codex 전용 팀 모드 (기본 lead/agents: codex)${RESET}
     ${WHITE_BRIGHT}tfx notion-read${RESET} ${GRAY}Notion 페이지 → 마크다운 (Codex/Gemini MCP)${RESET}
     ${WHITE_BRIGHT}tfx version${RESET}    ${GRAY}버전 표시${RESET}
@@ -5829,6 +5832,7 @@ async function main() {
     ${WHITE_BRIGHT}${s.usage}${RESET}
 
   ${BOLD}Subcommands${RESET}
+    ${WHITE_BRIGHT}tfx swarm run <prd>${RESET}    ${GRAY}${s.subcommands.run}${RESET}
     ${WHITE_BRIGHT}tfx swarm plan <prd>${RESET}   ${GRAY}${s.subcommands.plan}${RESET}
     ${WHITE_BRIGHT}tfx swarm list${RESET}         ${GRAY}${s.subcommands.list}${RESET}
     ${WHITE_BRIGHT}tfx swarm status${RESET}       ${GRAY}${s.subcommands.status}${RESET}
@@ -5850,11 +5854,15 @@ ${s.options.map((o) => `    ${DIM}${o.name.padEnd(16)}${RESET} ${GRAY}${o.descri
         await cmdSwarmPlan(cmdArgs.slice(1), { json: JSON_OUTPUT });
         return;
       }
+      if (sub === "run") {
+        await cmdSwarmRun(cmdArgs.slice(1), { json: JSON_OUTPUT });
+        return;
+      }
       if (!sub || sub.startsWith("--")) {
         throw createCliError("PRD 경로가 필요합니다", {
           exitCode: EXIT_ARG_ERROR,
           reason: "argError",
-          fix: "tfx swarm <prd-path> [--dry-run|--json|--filter <shard>]",
+          fix: "tfx swarm [run] <prd-path> [--dry-run|--json|--filter <shard>]",
         });
       }
       await cmdSwarmRun(cmdArgs, { json: JSON_OUTPUT });

package/hub/team/swarm-cli.mjs

@@ -13,6 +13,54 @@ const RED = "\u001b[91m";
 const YELLOW = "\u001b[93m";
 const GRAY = "\u001b[90m";
 
+/**
+ * #116-C: non-TTY background 환경에서 `tfx swarm` 실행은 codex worker spawn 이
+ * 무한 hang 한다 (stdin TTY 대기 또는 hub MCP lease race).
+ *
+ * - stdout/stdin 모두 non-TTY 이면 fail-fast — 명시 복구 경로 안내.
+ * - `TFX_ALLOW_NON_TTY_SWARM=1` opt-in 시 경고만 남기고 통과 (테스트/CI).
+ * - pure function — 테스트하기 쉽게 deps 주입 가능.
+ *
+ * @param {{
+ *   stdoutIsTTY?: boolean,
+ *   stdinIsTTY?: boolean,
+ *   env?: Record<string,string|undefined>,
+ * }} [deps]
+ * @returns {{ ok: boolean, optIn: boolean, warnings: string[], reason?: string }}
+ */
+export function assertTtyForSwarm(deps = {}) {
+  const stdoutIsTTY =
+    typeof deps.stdoutIsTTY === "boolean"
+      ? deps.stdoutIsTTY
+      : Boolean(process.stdout.isTTY);
+  const stdinIsTTY =
+    typeof deps.stdinIsTTY === "boolean"
+      ? deps.stdinIsTTY
+      : Boolean(process.stdin.isTTY);
+  const env = deps.env || process.env;
+  const warnings = [];
+
+  if (stdoutIsTTY || stdinIsTTY) {
+    return { ok: true, optIn: false, warnings };
+  }
+
+  if (env.TFX_ALLOW_NON_TTY_SWARM === "1") {
+    warnings.push(
+      "non-TTY 환경 감지 — TFX_ALLOW_NON_TTY_SWARM=1 opt-in 으로 진행합니다. codex worker spawn hang 가능성 존재 (#116-C).",
+    );
+    return { ok: true, optIn: true, warnings };
+  }
+
+  const reason =
+    "tfx swarm 은 TTY 가 필요합니다 — non-TTY 환경 (run_in_background, nohup 등) 에서 codex worker spawn 이 hang 합니다 (#116-C).\n" +
+    "  복구 경로:\n" +
+    "    1) 터미널에서 직접 실행: tfx swarm <prd>\n" +
+    "    2) tmux 경로: tfx multi --teammate-mode tmux --auto-attach --dashboard --assign ...\n" +
+    "    3) opt-in (위험): TFX_ALLOW_NON_TTY_SWARM=1 tfx swarm <prd>";
+
+  return { ok: false, optIn: false, warnings, reason };
+}
+
 export function parseFlags(args) {
   const flags = {
     dryRun: false,
@@ -121,6 +169,14 @@ export async function cmdSwarmRun(args, { json = false } = {}) {
     return;
   }
 
+  const ttyGate = assertTtyForSwarm();
+  for (const w of ttyGate.warnings) {
+    console.error(`  ${YELLOW}⚠${RESET} ${w}`);
+  }
+  if (!ttyGate.ok) {
+    throw new Error(ttyGate.reason);
+  }
+
   const logsDir =
     flags.logsDir ||
     join(process.cwd(), ".triflux", "swarm-logs", `run-${Date.now()}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "triflux",
-  "version": "10.13.7",
+  "version": "10.13.9",
   "description": "CLI-first multi-model orchestrator for Claude Code — route tasks to Codex, Gemini, and Claude",
   "type": "module",
   "bin": {