triflux 10.9.29 → 10.9.31

package/.claude-plugin/marketplace.json

@@ -0,0 +1,34 @@
+{
+  "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
+  "name": "triflux",
+  "description": "CLI-first multi-model orchestrator — Codex/Gemini/Claude routing with DAG execution, auto-triage, and cost optimization",
+  "owner": {
+    "name": "tellang"
+  },
+  "plugins": [
+    {
+      "name": "triflux",
+      "description": "Tri-CLI orchestrator for Claude Code. Routes tasks across Claude + Codex + Gemini with consensus intelligence, natural language routing, 42 skills, and cross-model review.",
+      "version": "10.9.31",
+      "author": {
+        "name": "tellang"
+      },
+      "source": {
+        "source": "npm",
+        "package": "triflux"
+      },
+      "category": "productivity",
+      "homepage": "https://github.com/tellang/triflux",
+      "tags": [
+        "multi-model",
+        "codex",
+        "gemini",
+        "cli-routing",
+        "orchestration",
+        "cost-optimization",
+        "dag-execution"
+      ]
+    }
+  ],
+  "version": "10.9.31"
+}

package/.claude-plugin/plugin.json

@@ -0,0 +1,22 @@
+{
+  "name": "triflux",
+  "version": "10.9.31",
+  "description": "CLI-first multi-model orchestrator for Claude Code — route tasks to Codex, Gemini, and Claude",
+  "author": {
+    "name": "tellang"
+  },
+  "repository": "https://github.com/tellang/triflux",
+  "homepage": "https://github.com/tellang/triflux",
+  "license": "MIT",
+  "keywords": [
+    "claude-code",
+    "plugin",
+    "codex",
+    "gemini",
+    "cli-routing",
+    "orchestration",
+    "multi-model"
+  ],
+  "skills": "./skills/",
+  "hooks": "./hooks/hooks.json"
+}

package/bin/triflux.mjs

@@ -154,7 +154,8 @@ const CLI_COMMAND_SCHEMAS = Object.freeze({
       {
         name: "--diagnose",
         type: "boolean",
-        description: "진단 번들(zip) 생성: spawn-trace + hook timing + system info",
+        description:
+          "진단 번들(zip) 생성: spawn-trace + hook timing + system info",
       },
       {
         name: "--json",
@@ -308,6 +309,42 @@ const CLI_COMMAND_SCHEMAS = Object.freeze({
       },
     ],
   },
+  swarm: {
+    usage: "tfx swarm <prd-path> [--dry-run|--json|--filter <shard>]",
+    description: "PRD 기반 멀티모델 x 멀티기기 스웜 실행 (#93)",
+    subcommands: {
+      plan: "tfx swarm plan <prd-path> [--json] — 실행 없이 계획만 출력",
+      list: "tfx swarm list [--json] — 활성 스웜 세션 조회 (synapse status)",
+      status: "tfx swarm status [--json] — list alias",
+    },
+    options: [
+      {
+        name: "--dry-run",
+        type: "boolean",
+        description: "PRD 분석만 수행, shard를 실행하지 않음",
+      },
+      {
+        name: "--json",
+        type: "boolean",
+        description: "구조화된 JSON 출력",
+      },
+      {
+        name: "--filter",
+        type: "string",
+        description: "특정 shard만 실행 (이름 매칭)",
+      },
+      {
+        name: "--max-restarts",
+        type: "number",
+        description: "shard별 최대 재시작 횟수 (기본 2)",
+      },
+      {
+        name: "--logs-dir",
+        type: "string",
+        description: "이벤트 로그 출력 디렉토리 오버라이드",
+      },
+    ],
+  },
   why: {
     usage: "tfx why <path> [--json]",
     description: "해당 경로의 마지막 커밋에서 X-Intent 트레일러 추출",
@@ -525,6 +562,10 @@ function whichInShell(cmd, shell) {
       ["-c", `source ~/.bashrc 2>/dev/null && command -v "${cmd}" 2>/dev/null`],
     ],
     cmd: ["cmd", ["/c", "where", cmd]],
+    zsh: [
+      "zsh",
+      ["-c", `source ~/.zshrc 2>/dev/null && command -v "${cmd}" 2>/dev/null`],
+    ],
     pwsh: [
       "pwsh",
       [
@@ -852,7 +893,7 @@ function getClaudeRoutingSyncSummary(results) {
 
 function checkCliCrossShell(cmd, installHint) {
   const shells =
-    process.platform === "win32" ? ["bash", "cmd", "pwsh"] : ["bash"];
+    process.platform === "win32" ? ["bash", "cmd", "pwsh"] : ["bash", "zsh"];
   let anyFound = false;
   let bashMissing = false;
   const shellResults = [];
@@ -1186,6 +1227,24 @@ function cmdSetup(options = {}) {
     }
   }
 
+  // ── tmux 기본 셸 확인 (macOS/Linux) ──
+  if (process.platform !== "win32" && which("tmux")) {
+    try {
+      const shellOut = execSync(
+        "tmux show-options -g default-shell 2>/dev/null",
+        {
+          encoding: "utf8",
+          timeout: 3000,
+        },
+      ).trim();
+      if (shellOut) {
+        ok(`tmux 기본 셸: ${shellOut.split(/\s+/).pop() || "확인 완료"}`);
+      }
+    } catch {
+      /* tmux 서버 미실행 — 무시 */
+    }
+  }
+
   // ── 결과 추적 ──
   const summary = [];
 
@@ -1881,7 +1940,10 @@ async function cmdDoctor(options = {}) {
       }
       {
         const claudeGuide = ensureGlobalClaudeRoutingSection(CLAUDE_DIR);
-        if (claudeGuide.skipped && claudeGuide.reason !== "global_sync_disabled")
+        if (
+          claudeGuide.skipped &&
+          claudeGuide.reason !== "global_sync_disabled"
+        )
           warn(`CLAUDE.md 라우팅 섹션 확인 실패: ${claudeGuide.reason}`);
         else if (
           claudeGuide.action === "created" ||
@@ -2449,6 +2511,86 @@ async function cmdDoctor(options = {}) {
       addDoctorCheck(report, { name: "stale-skills", status: "ok" });
     }
 
+    // 8.5 Dev 의존성 (npm link 환경에서 node_modules 누락 감지 — Issue #101)
+    section("Dev Dependencies");
+    try {
+      const pkgJsonPath = join(PKG_ROOT, "package.json");
+      const nodeModulesPath = join(PKG_ROOT, "node_modules");
+      const pkgJson = JSON.parse(readFileSync(pkgJsonPath, "utf8"));
+      const runtimeDeps = Object.keys(pkgJson.dependencies || {});
+      const isLinkedDev = (() => {
+        try {
+          const stat = statSync(nodeModulesPath);
+          return stat.isDirectory();
+        } catch {
+          return false;
+        }
+      })();
+      const missingDeps = [];
+      if (!isLinkedDev) {
+        // node_modules 전체 누락 — 전역 install 또는 미압축 릴리즈일 가능성
+        if (runtimeDeps.length > 0) {
+          missingDeps.push(...runtimeDeps);
+        }
+      } else {
+        for (const dep of runtimeDeps) {
+          const depPath = join(nodeModulesPath, ...dep.split("/"));
+          if (!existsSync(depPath)) missingDeps.push(dep);
+        }
+      }
+      if (missingDeps.length === 0) {
+        ok(
+          `의존성 ${runtimeDeps.length}개 설치됨${
+            isLinkedDev ? ` ${DIM}(dev)${RESET}` : ""
+          }`,
+        );
+        addDoctorCheck(report, {
+          name: "dev-deps",
+          status: "ok",
+          total: runtimeDeps.length,
+          linkedDev: isLinkedDev,
+        });
+      } else {
+        const head = missingDeps.slice(0, 5);
+        const tail = missingDeps.length > 5 ? `+${missingDeps.length - 5}` : "";
+        warn(
+          `누락 의존성 ${missingDeps.length}개: ${head.join(", ")}${tail ? ` ${tail}` : ""}`,
+        );
+        info("수정: tfx doctor --fix 또는 `npm install` (PKG_ROOT 내)");
+        addDoctorCheck(report, {
+          name: "dev-deps",
+          status: "missing",
+          missing: missingDeps,
+          linkedDev: isLinkedDev,
+          pkgRoot: PKG_ROOT,
+          fix: "tfx doctor --fix",
+        });
+        issues++;
+        if (fix) {
+          // --fix 모드: npm install 실행 (Windows 호환 shell: true)
+          info(`npm install 실행 중 (${PKG_ROOT})...`);
+          try {
+            const { execFileSync } = await import("node:child_process");
+            execFileSync("npm", ["install", "--no-audit", "--no-fund"], {
+              cwd: PKG_ROOT,
+              stdio: "inherit",
+              shell: process.platform === "win32",
+            });
+            ok("npm install 완료 — 의존성 복구됨");
+          } catch (err) {
+            warn(`npm install 실패: ${err?.message || err}`);
+          }
+        }
+      }
+    } catch (err) {
+      warn(`dev 의존성 체크 실패: ${err?.message || err}`);
+      addDoctorCheck(report, {
+        name: "dev-deps",
+        status: "error",
+        error: String(err?.message || err),
+      });
+    }
+
     // 9. 플러그인 등록
     section("Plugin");
     const pluginsFile = join(CLAUDE_DIR, "plugins", "installed_plugins.json");
@@ -4794,13 +4936,35 @@ async function cmdHub(args = [], options = {}) {
         });
       }
 
+      // Issue #102: spawn stderr 를 임시 파일로 캡처해 실패 시 root cause 노출.
+      // detached spawn 은 pipe 유지가 까다로우니 fd 리다이렉트로 접근.
+      const { openSync: _openSync, closeSync: _closeSync } = await import(
+        "node:fs"
+      );
+      const { tmpdir: _tmpdir } = await import("node:os");
+      const startupErrPath = join(
+        _tmpdir(),
+        `tfx-hub-start-${Date.now()}-${process.pid}.err`,
+      );
+      let errFd;
+      try {
+        errFd = _openSync(startupErrPath, "w");
+      } catch {
+        errFd = undefined;
+      }
+
       const child = spawn(process.execPath, [serverPath], {
         env: { ...process.env, TFX_HUB_PORT: port },
-        stdio: "ignore",
+        stdio: ["ignore", "ignore", errFd ?? "ignore"],
         detached: true,
         windowsHide: true,
       });
       child.unref();
+      if (errFd !== undefined) {
+        try {
+          _closeSync(errFd);
+        } catch {}
+      }
 
       // PID 파일 확인 (최대 3초 대기, 100ms 폴링)
       let started = false;
@@ -4824,13 +4988,46 @@ async function cmdHub(args = [], options = {}) {
         console.log("");
         autoRegisterMcp(hubInfo.url, { codexEnabled: true });
         console.log("");
+        // 성공했으면 임시 stderr 파일 정리
+        try {
+          unlinkSync(startupErrPath);
+        } catch {}
       } else {
-        // 직접 포그라운드 모드로 안내
-        console.log(
-          `\n  ${YELLOW}⚠${RESET} 백그라운드 시작 실패 — 포그라운드로 실행:`,
-        );
+        // Issue #102: 캡처된 stderr 에서 root cause 추출
+        let rootCause = "";
+        try {
+          rootCause = readFileSync(startupErrPath, "utf8").trim();
+        } catch {}
+
+        console.log(`\n  ${YELLOW}⚠${RESET} 백그라운드 시작 실패`);
+
+        if (rootCause) {
+          // 가장 유용한 에러 라인 강조 (ERR_*, Error:, throw)
+          const highlight = rootCause
+            .split(/\r?\n/)
+            .find((line) => /ERR_[A-Z_]+|^Error:|cannot find/i.test(line));
+          if (highlight) {
+            console.log(`    ${RED}▸ ${highlight.trim()}${RESET}`);
+          }
+          console.log(`\n  ${DIM}전체 로그: ${startupErrPath}${RESET}`);
+          // 원인별 실전 힌트
+          if (/Cannot find package/i.test(rootCause)) {
+            console.log(
+              `  ${DIM}힌트: \`cd ${PKG_ROOT} && npm install\` 로 의존성 복구 (특히 \`npm link\` 환경).${RESET}`,
+            );
+          } else if (/EADDRINUSE/i.test(rootCause)) {
+            console.log(
+              `  ${DIM}힌트: 포트 ${port} 이 이미 사용 중. \`tfx hub stop\` 후 재시도.${RESET}`,
+            );
+          }
+        } else {
+          console.log(
+            `    ${DIM}stderr 캡처 실패 — 아래 명령으로 포그라운드 실행해 원인 확인:${RESET}`,
+          );
+        }
+
         console.log(
-          `    ${DIM}TFX_HUB_PORT=${port} node ${serverPath}${RESET}\n`,
+          `\n  ${DIM}포그라운드 실행: TFX_HUB_PORT=${port} node ${serverPath}${RESET}\n`,
         );
       }
       break;
@@ -5198,9 +5395,15 @@ async function main() {
         const auditScript = join(PKG_ROOT, "scripts", "config-audit.mjs");
         const auditArgs = JSON_OUTPUT ? ["--json"] : [];
         try {
-          const out = execFileSync(process.execPath, [auditScript, ...auditArgs], {
-            timeout: 15000, encoding: "utf8", windowsHide: true,
-          });
+          const out = execFileSync(
+            process.execPath,
+            [auditScript, ...auditArgs],
+            {
+              timeout: 15000,
+              encoding: "utf8",
+              windowsHide: true,
+            },
+          );
           process.stdout.write(out);
         } catch (e) {
           process.stdout.write(e.stdout || "");
@@ -5213,8 +5416,12 @@ async function main() {
         const result = await diagnose({ json: JSON_OUTPUT });
         if (!JSON_OUTPUT) {
           if (result.ok) {
-            console.log(`\n  ${GREEN_BRIGHT}✓${RESET} 진단 번들 생성: ${result.zipPath}`);
-            console.log(`  spawn 이벤트: ${result.traceCount}건, 훅 타이밍: ${result.hookTimingCount}건\n`);
+            console.log(
+              `\n  ${GREEN_BRIGHT}✓${RESET} 진단 번들 생성: ${result.zipPath}`,
+            );
+            console.log(
+              `  spawn 이벤트: ${result.traceCount}건, 훅 타이밍: ${result.hookTimingCount}건\n`,
+            );
           } else {
             console.log(`\n  ${RED}✗${RESET} 진단 실패: ${result.error}\n`);
           }
@@ -5342,9 +5549,7 @@ async function main() {
       return;
     }
     case "synapse": {
-      const { cmdSynapseStatus } = await import(
-        "../hub/team/synapse-cli.mjs"
-      );
+      const { cmdSynapseStatus } = await import("../hub/team/synapse-cli.mjs");
       const sub = cmdArgs[0] || "status";
       if (sub !== "status") {
         throw createCliError(`synapse 서브커맨드 미지원: ${sub}`, {
@@ -5356,6 +5561,30 @@ async function main() {
       await cmdSynapseStatus(cmdArgs.slice(1), { json: JSON_OUTPUT });
       return;
     }
+    case "swarm": {
+      await checkHubRunning();
+      const { cmdSwarmRun, cmdSwarmPlan, cmdSwarmList } = await import(
+        "../hub/team/swarm-cli.mjs"
+      );
+      const sub = cmdArgs[0] || "";
+      if (sub === "list" || sub === "status") {
+        await cmdSwarmList(cmdArgs.slice(1), { json: JSON_OUTPUT });
+        return;
+      }
+      if (sub === "plan") {
+        await cmdSwarmPlan(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>]",
+        });
+      }
+      await cmdSwarmRun(cmdArgs, { json: JSON_OUTPUT });
+      return;
+    }
     case "why": {
       const { cmdSynapseWhy } = await import("../hub/team/synapse-cli.mjs");
       await cmdSynapseWhy(cmdArgs, { json: JSON_OUTPUT });

package/config/mcp-registry.json

@@ -0,0 +1,29 @@
+{
+  "$schema": "mcp-registry-schema",
+  "version": 1,
+  "description": "MCP 서버 중앙 레지스트리 — 진실의 원천",
+  "defaults": {
+    "transport": "hub-url",
+    "hub_base": "http://127.0.0.1:27888"
+  },
+  "servers": {
+    "tfx-hub": {
+      "transport": "hub-url",
+      "url": "http://127.0.0.1:27888/mcp",
+      "safe": true,
+      "targets": ["claude", "gemini", "codex"],
+      "description": "triflux Hub MCP 서버"
+    }
+  },
+  "policies": {
+    "stdio_action": "replace-with-hub",
+    "unknown_server_action": "warn",
+    "watched_paths": [
+      "~/.gemini/settings.json",
+      "~/.codex/config.toml",
+      "~/.claude/settings.json",
+      "~/.claude/settings.local.json",
+      ".mcp.json"
+    ]
+  }
+}

package/hooks/error-context.mjs

@@ -16,7 +16,7 @@ const ERROR_HINTS = [
   },
   {
     pattern: /EACCES.*permission denied/i,
-    hint: "권한 부족. Windows에서는 관리자 권한, Unix에서는 chmod/sudo를 확인하세요.",
+    hint: "권한 부족. macOS/Linux에서는 chmod/sudo, Windows에서는 관리자 권한을 확인하세요.",
   },
   {
     pattern: /EADDRINUSE/i,

package/hooks/keyword-rules.json

@@ -11,12 +11,7 @@
       "skill": null,
       "action": "suppress_all",
       "priority": 0,
-      "supersedes": [
-        "tfx-multi",
-        "tfx-unified",
-        "tfx-codex",
-        "tfx-gemini"
-      ],
+      "supersedes": ["tfx-multi", "tfx-unified", "tfx-codex", "tfx-gemini"],
       "exclusive": true,
       "state": null,
       "mcp_route": null
@@ -62,9 +57,7 @@
       ],
       "skill": "tfx-swarm",
       "priority": 1,
-      "supersedes": [
-        "tfx-codex"
-      ],
+      "supersedes": ["tfx-codex"],
       "exclusive": false,
       "state": null,
       "mcp_route": null
@@ -111,9 +104,7 @@
       ],
       "skill": "tfx-auto",
       "priority": 2,
-      "supersedes": [
-        "tfx-auto-codex"
-      ],
+      "supersedes": ["tfx-auto-codex"],
       "exclusive": false,
       "state": null,
       "mcp_route": null
@@ -249,9 +240,7 @@
       ],
       "skill": "tfx-wt",
       "priority": 1,
-      "supersedes": [
-        "tfx-unified"
-      ],
+      "supersedes": ["tfx-unified"],
       "exclusive": false,
       "state": null,
       "mcp_route": null
@@ -270,9 +259,7 @@
       ],
       "skill": "tfx-wt",
       "priority": 1,
-      "supersedes": [
-        "tfx-unified"
-      ],
+      "supersedes": ["tfx-unified"],
       "exclusive": false,
       "state": null,
       "mcp_route": null
@@ -291,9 +278,7 @@
       ],
       "skill": "tfx-wt",
       "priority": 1,
-      "supersedes": [
-        "tfx-unified"
-      ],
+      "supersedes": ["tfx-unified"],
       "exclusive": false,
       "state": null,
       "mcp_route": null
@@ -312,9 +297,7 @@
       ],
       "skill": "tfx-wt",
       "priority": 1,
-      "supersedes": [
-        "tfx-unified"
-      ],
+      "supersedes": ["tfx-unified"],
       "exclusive": false,
       "state": null,
       "mcp_route": null

package/hooks/safety-guard.mjs

@@ -11,6 +11,22 @@
 import { existsSync, readFileSync } from "node:fs";
 import { join } from "node:path";
 
+// ── 로컬 우회 플래그 ──────────────────────────────────────────
+// LOCAL ONLY — Issue #89 대안 API 구현 전까지 psmux kill 시리즈 우회용.
+// 활성 조건 (OR):
+//   1) env: TFX_CLEANUP_BYPASS=1
+//   2) 파일: .claude/cleanup-bypass 존재 (repo root)
+// 파일 방식은 Claude Code Bash 도구가 훅에 env 전달 못하는 경우에도 동작.
+// 정식 해결: hub/team/psmux.mjs 에 listSessions/killSessionByTitle/pruneStale 노출.
+const CLEANUP_BYPASS = (() => {
+  if (process.env.TFX_CLEANUP_BYPASS === "1") return true;
+  try {
+    return existsSync(join(process.cwd(), ".claude", "cleanup-bypass"));
+  } catch {
+    return false;
+  }
+})();
+
 // ── 차단 규칙 ──────────────────────────────────────────────
 const BLOCK_RULES = [
   {
@@ -44,14 +60,16 @@ const BLOCK_RULES = [
   {
     pattern: /\bpsmux\s+kill-session\b/i,
     reason:
-      "raw psmux kill-session 차단 — WT ConPTY 프리징 위험. 안전 경로: node hub/team/psmux.mjs kill --session <name>",
+      "raw psmux kill-session 차단 — WT ConPTY 프리징 위험. 대안: listSessions()/killSessionByTitle()/pruneStale() 또는 node hub/team/psmux.mjs --internal kill-by-title <prefix|/regex/> (또는 TFX_CLEANUP_BYPASS=1/.claude/cleanup-bypass)",
     skipIfGit: true,
+    cleanupBypass: true,
   },
   {
     pattern: /\bpsmux\s+kill-server\b/i,
     reason:
-      "psmux kill-server 차단 — 모든 세션이 즉시 종료됩니다. node hub/team/psmux.mjs kill-swarm 사용",
+      "psmux kill-server 차단 — 모든 세션이 즉시 종료됩니다. node hub/team/psmux.mjs kill-swarm 사용 (또는 TFX_CLEANUP_BYPASS=1)",
     skipIfGit: true,
+    cleanupBypass: true,
   },
 ];
 
@@ -70,8 +88,11 @@ const WT_DIRECT_BLOCK_MESSAGE =
   "  wt.createTab({ title, command, profile, cwd })  — 새 탭\n" +
   "  wt.splitPane({ direction: 'H'|'V', title, command })  — 패인 분할\n" +
   "  wt.applySplitLayout([{ title, command, direction }])  — 다중 배치\n" +
-  '사용법: node -e "import(\'./hub/team/wt-manager.mjs\').then(m => { const wt = m.createWtManager(); wt.createTab({ title: \'제목\', command: \'pwsh\' }); })"';
+  "사용법: node -e \"import('./hub/team/wt-manager.mjs').then(m => { const wt = m.createWtManager(); wt.createTab({ title: '제목', command: 'pwsh' }); })\"";
 
+const PSMUX_INTERNAL_WRAPPER_PATTERNS = [
+  /node(?:\.exe)?\s+.*hub[\\/]+team[\\/]+psmux\.mjs\s+--internal\s+(?:list|kill-by-title|prune-stale)\b/i,
+];
 
 // ── SSH+PowerShell bash 문법 차단 ────────────────────────────
 // 원격 기본 셸이 PowerShell인 호스트에 bash redirect/glob을 보내면 오동작
@@ -261,6 +282,10 @@ function main() {
     return hasSegmentInvocation(cmd, [/\bpsmux\s+kill-(session|server)\b/i]);
   }
 
+  function isAllowedPsmuxWrapperInvocation(cmd) {
+    return hasSegmentInvocation(cmd, PSMUX_INTERNAL_WRAPPER_PATTERNS);
+  }
+
   function isWtDirectInvocation(cmd) {
     return hasSegmentInvocation(cmd, WT_DIRECT_PATTERNS);
   }
@@ -269,6 +294,10 @@ function main() {
     blockCommand(WT_DIRECT_BLOCK_MESSAGE, command);
   }
 
+  if (isAllowedPsmuxWrapperInvocation(command)) {
+    process.exit(0);
+  }
+
   // 0.1. reflexion 적응형 패널티 — 이전 세션에서 차단된 패턴 사전 경고
   const penalties = loadReflexionPenalties();
   if (penalties.length > 0) {
@@ -299,7 +328,10 @@ function main() {
 
   // 0.5. SSH → Windows(PowerShell) 호스트에만 bash 문법 전달 차단
   // macOS/Linux 대상은 bash/zsh이므로 허용. hosts.json OS로 판별.
-  if (hasSegmentInvocation(command, [/^\s*ssh\s+/i]) && isSshTargetWindows(command)) {
+  if (
+    hasSegmentInvocation(command, [/^\s*ssh\s+/i]) &&
+    isSshTargetWindows(command)
+  ) {
     const segments = command.split(/\s*(?:&&|;|\|\||\|)\s*/);
     for (const seg of segments) {
       const sshMatch = seg.trim().match(/^ssh\s+\S+\s+(.*)/s);
@@ -317,12 +349,18 @@ function main() {
 
   // 1. BLOCK 체크 — exit 2로 차단
   for (const rule of BLOCK_RULES) {
+    if (rule.cleanupBypass && CLEANUP_BYPASS) continue;
     if (rule.skipIfGit && !isPsmuxInvocation(command)) continue;
     if (rule.pattern.test(command)) {
       blockCommand(`[triflux safety-guard] BLOCKED: ${rule.reason}`, command);
     }
   }
 
+  // wt 정리 명령 우회 (TFX_CLEANUP_BYPASS=1 한정). new-tab/split-pane만 차단 유지하려면 아래 조건 세분화.
+  if (CLEANUP_BYPASS) {
+    // bypass 모드에서는 아래 wt 검사를 이미 통과한 상태. 추가 작업 없음.
+  }
+
   // 2. WARN 체크 — allow + additionalContext
   const warnings = [];
   for (const rule of WARN_RULES) {