triflux 10.9.29 → 10.9.30

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.30",
+      "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.30"
+}

package/.claude-plugin/plugin.json

@@ -0,0 +1,22 @@
+{
+  "name": "triflux",
+  "version": "10.9.30",
+  "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

@@ -308,6 +308,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 +561,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 +892,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 +1226,21 @@ 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 = [];
 
@@ -5356,6 +5411,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/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) {