triflux 7.3.1 → 7.4.0

package/hud/constants.mjs

@@ -20,6 +20,9 @@ export const OMC_PLUGIN_USAGE_CACHE_PATH = join(homedir(), ".claude", "plugins",
 export const CLAUDE_USAGE_STALE_MS_SOLO = 5 * 60 * 1000; // OMC 없을 때: 5분 캐시
 export const CLAUDE_USAGE_STALE_MS_WITH_OMC = 15 * 60 * 1000; // OMC 있을 때: 15분 (OMC가 30초마다 갱신)
 export const CLAUDE_USAGE_429_BACKOFF_MS = 10 * 60 * 1000; // 429 에러 시 10분 backoff
+export const GEMINI_429_BASE_DELAY_MS = 2000;
+export const GEMINI_429_MAX_RETRIES = 3;
+export const GEMINI_429_COOLDOWN_MS = 30000;
 export const CLAUDE_USAGE_ERROR_BACKOFF_MS = 3 * 60 * 1000; // 기타 에러 시 3분 backoff
 export const CLAUDE_API_TIMEOUT_MS = 10_000;
 export const FIVE_HOUR_MS = 5 * 60 * 60 * 1000;

package/package.json

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

package/scripts/headless-guard.mjs

@@ -8,16 +8,23 @@
  * v2: 마커 파일 의존 제거. psmux 설치 여부만으로 판단.
  *     Opus가 SKILL.md를 무시해도 auto-route가 작동한다.
  *
+ * v3: A(gate) + B(nudge) — OMC 패턴 도입
+ *     A: tfx-multi 활성 시 headless dispatch 전까지 Agent 작업 위임 차단
+ *     B: dispatch 후 네이티브 드리프트 감지 시 nudge
+ *     상태: $TMPDIR/tfx-multi-state.json (tfx-multi-activate.mjs가 생성)
+ *
  * 동작:
  * - psmux 설치 + Bash(tfx-route.sh) → updatedInput: tfx multi --headless --assign
  * - psmux 설치 + Bash(codex exec / gemini -p) → deny
  * - psmux 설치 + Agent(codex/gemini CLI 래핑) → deny
  * - psmux 미설치 → 전부 통과
+ * - tfx-multi 활성 + Agent(work) before dispatch → deny (A: gate)
+ * - tfx-multi 활성 + Agent(work) after dispatch → nudge (B: nudge)
  *
  * 성능: psmux 감지 결과를 5분간 캐시 ($TMPDIR/tfx-psmux-check.json)
  */
 
-import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { existsSync, readFileSync, writeFileSync, unlinkSync } from "node:fs";
 import { execFileSync } from "node:child_process";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
@@ -25,6 +32,42 @@ import { join } from "node:path";
 const CACHE_FILE = join(tmpdir(), "tfx-psmux-check.json");
 const CACHE_TTL_MS = 5 * 60 * 1000; // 5분
 
+// ── tfx-multi 상태 관리 (A+B) ──
+const MULTI_STATE_FILE = join(tmpdir(), "tfx-multi-state.json");
+const MULTI_EXPIRE_MS = 30 * 60 * 1000; // 30분 자동 만료
+const GATE_THRESHOLD = 2;   // A: dispatch 전 허용할 Agent 호출 수
+const NUDGE_THRESHOLD = 4;  // B: dispatch 후 nudge 트리거 횟수
+
+function readMultiState() {
+  try {
+    if (!existsSync(MULTI_STATE_FILE)) return null;
+    const state = JSON.parse(readFileSync(MULTI_STATE_FILE, "utf8"));
+    if (!state.active) return null;
+    // 자동 만료
+    if (Date.now() - state.activatedAt > MULTI_EXPIRE_MS) {
+      try { unlinkSync(MULTI_STATE_FILE); } catch { /* ignore */ }
+      return null;
+    }
+    return state;
+  } catch { return null; }
+}
+
+function writeMultiState(state) {
+  try {
+    writeFileSync(MULTI_STATE_FILE, JSON.stringify(state));
+  } catch { /* ignore */ }
+}
+
+function nudge(message) {
+  process.stdout.write(JSON.stringify({
+    hookSpecificOutput: {
+      hookEventName: "PreToolUse",
+      additionalContext: message,
+    },
+  }));
+  process.exit(0);
+}
+
 function isPsmuxInstalled() {
   // 캐시 확인
   try {
@@ -135,8 +178,14 @@ async function main() {
   if (toolName === "Bash") {
     const cmd = toolInput.command || "";
 
-    // headless 명령은 통과
+    // headless 명령은 통과 + dispatch 감지 (A: gate 해제)
     if (cmd.includes("tfx multi") || cmd.includes("triflux.mjs multi")) {
+      const multiState = readMultiState();
+      if (multiState && cmd.includes("--assign")) {
+        multiState.dispatched = true;
+        multiState.nativeWorkCallsSinceDispatch = 0;
+        writeMultiState(multiState);
+      }
       process.exit(0);
     }
 
@@ -197,15 +246,53 @@ async function main() {
     }
   }
 
-  // ── Agent: CLI 워커 래핑 → deny (Claude native는 통과) ──
+  // ── Agent: A(gate) + B(nudge) + CLI 래핑 deny ──
   if (toolName === "Agent") {
     const subType = (toolInput.subagent_type || "").toLowerCase();
-    // Claude native subagent types → 무조건 통과
     const NATIVE_TYPES = new Set(["explore", "plan", "general-purpose", ""]);
-    if (NATIVE_TYPES.has(subType)) process.exit(0);
-    // oh-my-claudecode 계열도 통과
-    if (subType.startsWith("oh-my-claudecode:")) process.exit(0);
+    const isNative = NATIVE_TYPES.has(subType) || subType.startsWith("oh-my-claudecode:");
+
+    // ── A+B: tfx-multi 상태 기반 처리 ──
+    const multiState = readMultiState();
+    if (multiState && multiState.active && isNative) {
+      if (!multiState.dispatched) {
+        // ── A: gate — dispatch 전, Agent 작업 위임 제한 ──
+        multiState.nativeWorkCalls = (multiState.nativeWorkCalls || 0) + 1;
+        writeMultiState(multiState);
+
+        if (multiState.nativeWorkCalls > GATE_THRESHOLD) {
+          deny(
+            `[headless-guard] tfx-multi gate: Agent(${subType || "default"}) 호출 ${multiState.nativeWorkCalls}회 — headless에 먼저 dispatch하세요.\n` +
+            'Bash("tfx multi --teammate-mode headless --auto-attach --dashboard --assign \'codex:프롬프트:역할\' --timeout 600")',
+          );
+        }
+        // 허용 범위 내 → 경고 + 통과
+        nudge(
+          `[headless-guard] tfx-multi 활성 (${multiState.nativeWorkCalls}/${GATE_THRESHOLD}). ` +
+          "headless dispatch 후 작업을 시작하세요.",
+        );
+      } else {
+        // ── B: nudge — dispatch 후, 네이티브 드리프트 감지 ──
+        multiState.nativeWorkCallsSinceDispatch = (multiState.nativeWorkCallsSinceDispatch || 0) + 1;
+        writeMultiState(multiState);
+
+        if (multiState.nativeWorkCallsSinceDispatch >= NUDGE_THRESHOLD) {
+          multiState.nativeWorkCallsSinceDispatch = 0;
+          writeMultiState(multiState);
+          nudge(
+            "[headless-guard] nudge: headless 워커가 실행 중입니다. " +
+            "결과를 기다리거나 추가 --assign으로 위임하세요.",
+          );
+        }
+      }
+      // native → 통과 (gate deny 안 걸린 경우)
+      process.exit(0);
+    }
+
+    // native → 통과 (tfx-multi 비활성)
+    if (isNative) process.exit(0);
 
+    // ── CLI 래핑 체크 (기존) ──
     const combined = `${(toolInput.prompt || "").toLowerCase()} ${(toolInput.description || "").toLowerCase()}`;
     const cliPatterns = [
       /codex\s+(exec|run|실행)/,

package/scripts/setup.mjs

@@ -30,6 +30,20 @@ function detectDevMode(root = PLUGIN_ROOT) {
 const BREADCRUMB_PATH = join(CLAUDE_DIR, "scripts", ".tfx-pkg-root");
 
 const REQUIRED_CODEX_PROFILES = [
+  {
+    name: "fast",
+    lines: [
+      'model = "gpt-5.3-codex"',
+      'model_reasoning_effort = "low"',
+    ],
+  },
+  {
+    name: "normal",
+    lines: [
+      'model = "gpt-5.3-codex"',
+      'model_reasoning_effort = "medium"',
+    ],
+  },
   {
     name: "high",
     lines: [
@@ -37,6 +51,14 @@ const REQUIRED_CODEX_PROFILES = [
       'model_reasoning_effort = "high"',
     ],
   },
+  {
+    name: "thorough",
+    lines: [
+      'model = "gpt-5.3-codex"',
+      'model_reasoning_effort = "high"',
+      'model_temperature = 0.2',
+    ],
+  },
   {
     name: "xhigh",
     lines: [
@@ -51,6 +73,13 @@ const REQUIRED_CODEX_PROFILES = [
       'model_reasoning_effort = "low"',
     ],
   },
+  {
+    name: "spark_balanced",
+    lines: [
+      'model = "gpt-5.1-codex-mini"',
+      'model_reasoning_effort = "medium"',
+    ],
+  },
 ];
 
 // ── 파일 동기화 ──
@@ -186,6 +215,11 @@ const SYNC_MAP = [
     dst: join(CLAUDE_DIR, "scripts", "headless-guard-fast.sh"),
     label: "headless-guard-fast.sh",
   },
+  {
+    src: join(PLUGIN_ROOT, "scripts", "tfx-gate-activate.mjs"),
+    dst: join(CLAUDE_DIR, "scripts", "tfx-gate-activate.mjs"),
+    label: "tfx-gate-activate.mjs",
+  },
 ];
 
 function getVersion(filePath) {
@@ -533,6 +567,37 @@ function applyHooks(s) {
     }
   }
 
+  // ── PreToolUse 훅: tfx-gate-activate (Skill 감지 → A+B gate) ──
+  const gateScriptPath = join(CLAUDE_DIR, "scripts", "tfx-gate-activate.mjs").replace(/\\/g, "/");
+  const hasGateHook = s.hooks.PreToolUse.some((entry) =>
+    Array.isArray(entry.hooks) &&
+    entry.hooks.some((h) => typeof h.command === "string" && h.command.includes("tfx-gate-activate")),
+  );
+
+  if (!hasGateHook && existsSync(gateScriptPath.replace(/\//g, "\\"))) {
+    s.hooks.PreToolUse.push({
+      matcher: "Skill",
+      hooks: [
+        {
+          type: "command",
+          command: `node "${gateScriptPath}"`,
+          timeout: 2,
+        },
+      ],
+    });
+    changed = true;
+  } else if (hasGateHook) {
+    for (const entry of s.hooks.PreToolUse) {
+      if (!Array.isArray(entry.hooks)) continue;
+      for (const h of entry.hooks) {
+        if (typeof h.command === "string" && h.command.includes("tfx-gate-activate") && !h.command.includes(gateScriptPath)) {
+          h.command = `node "${gateScriptPath}"`;
+          changed = true;
+        }
+      }
+    }
+  }
+
   return changed;
 }
 

package/scripts/tfx-gate-activate.mjs

@@ -0,0 +1,89 @@
+#!/usr/bin/env node
+/**
+ * tfx-multi-activate.mjs — PreToolUse(Skill) 훅
+ *
+ * /tfx-multi 스킬 호출을 감지하여 상태 파일을 설정한다.
+ * headless-guard.mjs가 이 상태를 읽어 A(gate) + B(nudge)를 수행.
+ *
+ * 상태 파일: $TMPDIR/tfx-multi-state.json
+ * 자동 만료: 30분
+ */
+
+import { writeFileSync, existsSync, readFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+
+const STATE_FILE = join(tmpdir(), "tfx-multi-state.json");
+const EXPIRE_MS = 30 * 60 * 1000; // 30분
+
+async function main() {
+  let raw = "";
+  for await (const chunk of process.stdin) raw += chunk;
+
+  if (!raw.trim()) {
+    process.exit(0);
+  }
+
+  let input;
+  try {
+    input = JSON.parse(raw);
+  } catch {
+    process.exit(0);
+  }
+
+  const toolName = input.tool_name || "";
+  const toolInput = input.tool_input || {};
+
+  if (toolName !== "Skill") {
+    process.exit(0);
+  }
+
+  const skill = (toolInput.skill || "").toLowerCase();
+
+  // 모든 tfx CLI 라우팅 스킬에 gate 적용
+  const TFX_ROUTING_SKILLS = new Set([
+    "tfx-multi", "tfx-team", "tfx-auto", "tfx-auto-codex",
+    "tfx-codex", "tfx-gemini", "tfx-autoresearch",
+  ]);
+
+  if (TFX_ROUTING_SKILLS.has(skill)) {
+    // 활성화: 상태 파일 생성/갱신
+    const state = {
+      active: true,
+      activatedAt: Date.now(),
+      dispatched: false,
+      nativeWorkCalls: 0,
+      nativeWorkCallsSinceDispatch: 0,
+    };
+    writeFileSync(STATE_FILE, JSON.stringify(state));
+
+    // additionalContext로 Lead에게 알림
+    process.stdout.write(
+      JSON.stringify({
+        hookSpecificOutput: {
+          hookEventName: "PreToolUse",
+          additionalContext:
+            "[tfx-multi] gate 활성화됨. CLI 작업은 headless로 dispatch 필수:\n" +
+            'Bash("tfx multi --teammate-mode headless --auto-attach --dashboard --assign \'codex:프롬프트:역할\' --timeout 600")',
+        },
+      }),
+    );
+    process.exit(0);
+  }
+
+  // /tfx-multi 외 스킬 호출 시: 기존 상태 만료 체크만
+  if (existsSync(STATE_FILE)) {
+    try {
+      const state = JSON.parse(readFileSync(STATE_FILE, "utf8"));
+      if (Date.now() - state.activatedAt > EXPIRE_MS) {
+        // 만료 → 삭제하지 않고 headless-guard가 처리
+      }
+    } catch {
+      /* ignore */
+    }
+  }
+
+  process.exit(0);
+}
+
+main().catch(() => process.exit(0));

package/scripts/tfx-route-post.mjs

@@ -264,19 +264,23 @@ function trackCliIssue(cliType, agent, stderrText, exitCode) {
 
     const snippet = stderrText.substring(0, 200).replace(/\n/g, " ");
 
-    appendFileSync(
-      issuesFile,
-      JSON.stringify({
-        ts: Date.now(),
-        cli: cliType,
-        agent,
-        pattern: matched.pattern,
-        msg: matched.msg,
-        severity: matched.severity,
-        snippet,
-        resolved: false,
-      }) + "\n",
-    );
+    const retryCount = (matched.pattern === "rate_limit" && cliType === "gemini")
+      ? parseInt(process.env.TFX_GEMINI_429_RETRIES || "0")
+      : undefined;
+
+    const issueEntry = {
+      ts: Date.now(),
+      cli: cliType,
+      agent,
+      pattern: matched.pattern,
+      msg: matched.msg,
+      severity: matched.severity,
+      snippet,
+      resolved: false,
+    };
+    if (retryCount !== undefined) issueEntry.retry_count = retryCount;
+
+    appendFileSync(issuesFile, JSON.stringify(issueEntry) + "\n");
 
     // 자동 회전
     const content = readFileSync(issuesFile, "utf-8").trim();

package/scripts/tfx-route.sh

@@ -566,12 +566,31 @@ capture_workspace_signature() {
   git status --short --untracked-files=all --ignore-submodules=all 2>/dev/null || return 1
 }
 
+# ── Codex CLI 버전 감지 (캐시) ──
+_CODEX_VERSION=""
+get_codex_version() {
+  if [[ -n "$_CODEX_VERSION" ]]; then echo "$_CODEX_VERSION"; return; fi
+  local raw
+  raw=$("$CODEX_BIN" --version 2>/dev/null | grep -oE '[0-9]+\.[0-9]+\.[0-9]+' | head -1)
+  _CODEX_VERSION="${raw:-0.0.0}"
+  echo "$_CODEX_VERSION"
+}
+
+# codex_gte <min_version>: 현재 버전이 min 이상이면 true(0), 아니면 false(1)
+codex_gte() {
+  local min="$1"
+  local cur
+  cur=$(get_codex_version)
+  printf '%s\n%s' "$min" "$cur" | sort -V | head -1 | grep -q "^${min}$"
+}
+
 # ── 라우팅 테이블 ──
 # CLI_TYPE/CLI_CMD: agent-map.json 단일 소스. 상세 설정: 아래 case 문.
 # 반환: CLI_TYPE, CLI_CMD, CLI_ARGS, CLI_EFFORT, DEFAULT_TIMEOUT, RUN_MODE, OPUS_OVERSIGHT
 route_agent() {
   local agent="$1"
   local codex_base="--dangerously-bypass-approvals-and-sandbox --skip-git-repo-check"
+  echo "[tfx-route] Codex 버전: $(get_codex_version)" >&2
   local map_file
   map_file="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/../hub/team/agent-map.json"
   # ── breadcrumb 폴백 (synced 환경: ~/.claude/scripts/) ──
@@ -669,13 +688,20 @@ route_agent() {
       CLI_ARGS="-m gemini-3-flash-preview -y --prompt"
       CLI_EFFORT="flash"; DEFAULT_TIMEOUT=900; RUN_MODE="bg"; OPUS_OVERSIGHT="false" ;;
 
-    # ─── 탐색/검증/테스트 (Claude-native 우선, TFX_NO_CLAUDE_NATIVE=1일 때만 Codex 리매핑) ───
-    explore|verifier|test-engineer|qa-tester)
-      CLI_EFFORT="n/a"; DEFAULT_TIMEOUT=600; RUN_MODE="fg"; OPUS_OVERSIGHT="false"
-      case "$agent" in
-        test-engineer|qa-tester) DEFAULT_TIMEOUT=1200; RUN_MODE="bg" ;;
-      esac
-      ;;
+    # ─── 탐색 (Claude-native: Glob/Grep/Read 직접 접근) ───
+    explore)
+      CLI_EFFORT="n/a"; DEFAULT_TIMEOUT=600; RUN_MODE="fg"; OPUS_OVERSIGHT="false" ;;
+
+    # ─── 검증/테스트 (Codex: 무료 + 파일 쓰기 가능) ───
+    verifier)
+      CLI_ARGS="exec --profile thorough ${codex_base} review"
+      CLI_EFFORT="thorough"; DEFAULT_TIMEOUT=1200; RUN_MODE="fg"; OPUS_OVERSIGHT="false" ;;
+    test-engineer)
+      CLI_ARGS="exec ${codex_base}"
+      CLI_EFFORT="high"; DEFAULT_TIMEOUT=1200; RUN_MODE="bg"; OPUS_OVERSIGHT="false" ;;
+    qa-tester)
+      CLI_ARGS="exec --profile thorough ${codex_base} review"
+      CLI_EFFORT="thorough"; DEFAULT_TIMEOUT=1200; RUN_MODE="bg"; OPUS_OVERSIGHT="false" ;;
 
     # ─── 경량 ───
     spark)
@@ -1108,6 +1134,90 @@ run_stream_worker() {
   return "$exit_code_local"
 }
 
+# Gemini 429 지수 백오프 재시도 래퍼
+# 사용: gemini_with_retry <use_tee_flag> <gemini_args_array_name> <prompt>
+# 429/rate limit 감지 시 최대 3회 재시도 (2→4→8초 백오프)
+_gemini_run_once() {
+  local use_tee_flag="$1"
+  local prompt="$2"
+  shift 2
+  local -a g_args=("$@")
+
+  if [[ "$use_tee_flag" == "true" ]]; then
+    timeout "$TIMEOUT_SEC" "$CLI_CMD" "${g_args[@]}" "$prompt" 2>"$STDERR_LOG" | tee "$STDOUT_LOG" &
+  else
+    timeout "$TIMEOUT_SEC" "$CLI_CMD" "${g_args[@]}" "$prompt" >"$STDOUT_LOG" 2>"$STDERR_LOG" &
+  fi
+  echo "$!"
+}
+
+gemini_with_retry() {
+  local use_tee_flag="$1"
+  local prompt="$2"
+  shift 2
+  local -a g_args=("$@")
+
+  local max_retries=3
+  local attempt=0
+  local delay=2
+  local exit_code_local=0
+
+  while (( attempt < max_retries )); do
+    exit_code_local=0
+    local pid
+    pid=$(_gemini_run_once "$use_tee_flag" "$prompt" "${g_args[@]}")
+
+    local health_ok=true
+    local intervals=(1 2 3 5 8)
+    for wait_sec in "${intervals[@]}"; do
+      sleep "$wait_sec"
+      if [[ -s "$STDOUT_LOG" ]] || [[ -s "$STDERR_LOG" ]]; then
+        break
+      fi
+      if ! kill -0 "$pid" 2>/dev/null; then
+        health_ok=false
+        echo "[tfx-route] Gemini: 출력 없이 프로세스 종료 (${wait_sec}초 체크)" >&2
+        break
+      fi
+    done
+
+    local hb_pid
+    if [[ "$health_ok" == "false" ]]; then
+      wait "$pid" 2>/dev/null
+    else
+      heartbeat_monitor "$pid" &
+      hb_pid=$!
+      wait "$pid" || exit_code_local=$?
+      kill "$hb_pid" 2>/dev/null; wait "$hb_pid" 2>/dev/null
+    fi
+
+    # 성공 시 즉시 반환
+    if [[ $exit_code_local -eq 0 ]]; then
+      return 0
+    fi
+
+    # 429 / rate limit 감지
+    if grep -qiE '429|rate.limit|too many requests' "$STDERR_LOG" 2>/dev/null; then
+      attempt=$(( attempt + 1 ))
+      if (( attempt < max_retries )); then
+        echo "[tfx-route] Gemini 429 감지. ${delay}초 후 재시도 ($attempt/$max_retries)..." >&2
+        sleep "$delay"
+        delay=$(( delay * 2 ))
+        : > "$STDOUT_LOG"
+        : > "$STDERR_LOG"
+        continue
+      else
+        echo "[tfx-route] Gemini 429: ${max_retries}회 재시도 실패" >&2
+      fi
+    fi
+
+    # 비-429 에러 또는 최대 재시도 초과 시 즉시 반환
+    return "$exit_code_local"
+  done
+
+  return "$exit_code_local"
+}
+
 run_legacy_gemini() {
   local prompt="$1"
   local use_tee_flag="$2"
@@ -1133,45 +1243,7 @@ run_legacy_gemini() {
     fi
   fi
 
-  if [[ "$use_tee_flag" == "true" ]]; then
-    timeout "$TIMEOUT_SEC" "$CLI_CMD" "${gemini_args[@]}" "$prompt" 2>"$STDERR_LOG" | tee "$STDOUT_LOG" &
-  else
-    timeout "$TIMEOUT_SEC" "$CLI_CMD" "${gemini_args[@]}" "$prompt" >"$STDOUT_LOG" 2>"$STDERR_LOG" &
-  fi
-  local pid=$!
-
-  local health_ok=true
-  local intervals=(1 2 3 5 8)
-  for wait_sec in "${intervals[@]}"; do
-    sleep "$wait_sec"
-    if [[ -s "$STDOUT_LOG" ]] || [[ -s "$STDERR_LOG" ]]; then
-      break
-    fi
-    if ! kill -0 "$pid" 2>/dev/null; then
-      health_ok=false
-      echo "[tfx-route] Gemini: 출력 없이 프로세스 종료 (${wait_sec}초 체크)" >&2
-      break
-    fi
-  done
-
-  local exit_code_local=0
-  local hb_pid
-  if [[ "$health_ok" == "false" ]]; then
-    wait "$pid" 2>/dev/null
-    echo "[tfx-route] Gemini crash 감지, 재시도 중..." >&2
-    if [[ "$use_tee_flag" == "true" ]]; then
-      timeout "$TIMEOUT_SEC" "$CLI_CMD" "${gemini_args[@]}" "$prompt" 2>"$STDERR_LOG" | tee "$STDOUT_LOG" &
-    else
-      timeout "$TIMEOUT_SEC" "$CLI_CMD" "${gemini_args[@]}" "$prompt" >"$STDOUT_LOG" 2>"$STDERR_LOG" &
-    fi
-    pid=$!
-  fi
-
-  heartbeat_monitor "$pid" &
-  hb_pid=$!
-  wait "$pid" || exit_code_local=$?
-  kill "$hb_pid" 2>/dev/null; wait "$hb_pid" 2>/dev/null
-  return "$exit_code_local"
+  gemini_with_retry "$use_tee_flag" "$prompt" "${gemini_args[@]}"
 }
 
 resolve_codex_mcp_script() {

package/skills/tfx-auto/SKILL.md

@@ -31,7 +31,7 @@ argument-hint: "<command|task> [args...]"
 > 1. **실행**: CLI 에이전트는 반드시 `Bash("bash ~/.claude/scripts/tfx-route.sh ...")`. Claude 네이티브(explore/verifier/test-engineer/qa-tester)만 `Agent()`.
 > 2. **비용**: Codex 우선 → Gemini → Claude 최후 수단. `claude` 선택 전 "Codex로 가능한가?" 재확인.
 > 3. **DAG**: SEQUENTIAL/DAG이면 레벨 기반 순차 실행. `.omc/context/{sid}/` 생성, context_output 저장, 실패 시 후속 SKIP.
-> 4. **트리아지**: Codex `--full-auto` 분류 + Opus 인라인 분해. Agent 스폰 금지.
+> 4. **트리아지**: Codex `exec --full-auto` 분류 + Opus 인라인 분해. Agent 스폰 금지.
 > 5. **thorough**: `-t`/`--thorough` 시 파이프라인 init 필수. 커맨드 숏컷은 항상 quick.
 
 ## 모드

package/skills/tfx-multi/SKILL.md

@@ -62,7 +62,7 @@ preflight와 Agent 생성을 병렬로 실행하여 사용자 체감 지연을
 ### Phase 2: 트리아지 (tfx-auto와 동일)
 
 **자동 모드:**
-1. Codex `--full-auto --skip-git-repo-check` 분류 → JSON `{parts: [{description, agent}]}`
+1. Codex `exec --skip-git-repo-check` 분류 → JSON `{parts: [{description, agent}]}`
 2. Opus 인라인 분해 → 서브태스크 배열 `[{cli, subtask, role}]`
 3. Codex 분류 실패 시 → Opus가 직접 분류+분해