triflux 9.3.0 → 9.4.0

package/scripts/tfx-route.sh

@@ -617,12 +617,23 @@ codex_gte() {
 _GEMINI_PROFILE_CACHE=""
 resolve_gemini_profile() {
   local profile="$1"
+  if [[ "$profile" == gemini-* ]]; then
+    echo "$profile"
+    return
+  fi
   if [[ -z "$_GEMINI_PROFILE_CACHE" && -f "$GEMINI_PROFILES_PATH" ]]; then
     _GEMINI_PROFILE_CACHE=$(cat "$GEMINI_PROFILES_PATH" 2>/dev/null || echo "{}")
   fi
+  local settings_path="${HOME}/.gemini/settings.json"
+  local settings_cache="{}"
+  if [[ -f "$settings_path" ]]; then
+    settings_cache=$(cat "$settings_path" 2>/dev/null || echo "{}")
+  fi
   local result
   result=$("$NODE_BIN" -e "
     const name = process.argv[1];
+    const primaryRaw = process.argv[2] || '{}';
+    const settingsRaw = process.argv[3] || '{}';
     const defaults = {
       pro31: 'gemini-3.1-pro-preview',
       flash3: 'gemini-3-flash-preview',
@@ -630,13 +641,74 @@ resolve_gemini_profile() {
       flash25: 'gemini-2.5-flash',
       lite25: 'gemini-2.5-flash-lite'
     };
-    try {
-      const cfg = JSON.parse(process.argv[2] || '{}');
-      const p = cfg.profiles?.[name];
-      if (p?.model) { process.stdout.write(p.model); return; }
-    } catch {}
-    process.stdout.write(defaults[name] || 'gemini-3.1-pro-preview');
-  " "$profile" "$_GEMINI_PROFILE_CACHE" 2>/dev/null)
+
+    if (typeof name === 'string' && name.startsWith('gemini-')) {
+      process.stdout.write(name);
+      process.exit(0);
+    }
+
+    const parseJson = (raw) => {
+      try {
+        const parsed = JSON.parse(raw);
+        return parsed && typeof parsed === 'object' ? parsed : {};
+      } catch {
+        return {};
+      }
+    };
+
+    const getModelValue = (entry) => {
+      if (!entry) return '';
+      if (typeof entry === 'string') return entry;
+      if (typeof entry !== 'object') return '';
+      if (typeof entry.model === 'string') return entry.model;
+      if (typeof entry.name === 'string' && entry.name.startsWith('gemini-')) return entry.name;
+      if (entry.model && typeof entry.model.name === 'string') return entry.model.name;
+      return '';
+    };
+
+    const getProfileBuckets = (cfg) => {
+      const buckets = [];
+      if (cfg.profiles && typeof cfg.profiles === 'object') buckets.push(cfg.profiles);
+      if (cfg.model?.profiles && typeof cfg.model.profiles === 'object') buckets.push(cfg.model.profiles);
+      if (cfg.modelProfiles && typeof cfg.modelProfiles === 'object') buckets.push(cfg.modelProfiles);
+      if (cfg.models && typeof cfg.models === 'object') buckets.push(cfg.models);
+      return buckets;
+    };
+
+    const getDefaultModel = (cfg) => {
+      return (
+        (typeof cfg.defaultModel === 'string' && cfg.defaultModel) ||
+        (typeof cfg.default_profile === 'string' && cfg.default_profile) ||
+        (typeof cfg.defaultProfile === 'string' && cfg.defaultProfile) ||
+        (typeof cfg.model === 'string' && cfg.model) ||
+        (typeof cfg.model?.default === 'string' && cfg.model.default) ||
+        ''
+      );
+    };
+
+    const sources = [parseJson(primaryRaw), parseJson(settingsRaw)];
+    for (const cfg of sources) {
+      for (const bucket of getProfileBuckets(cfg)) {
+        const value = getModelValue(bucket[name]);
+        if (value) {
+          process.stdout.write(value);
+          process.exit(0);
+        }
+      }
+    }
+
+    if (name === 'default') {
+      for (const cfg of sources) {
+        const value = getDefaultModel(cfg);
+        if (value) {
+          process.stdout.write(value);
+          process.exit(0);
+        }
+      }
+    }
+
+    process.stdout.write(defaults[name] || defaults.pro31);
+  " "$profile" "$_GEMINI_PROFILE_CACHE" "$settings_cache" 2>/dev/null)
   echo "${result:-gemini-3.1-pro-preview}"
 }
 
@@ -853,6 +925,7 @@ CODEX_MCP_TRANSPORT_EXIT_CODE=70
 
 apply_cli_mode() {
   local codex_base="--dangerously-bypass-approvals-and-sandbox --skip-git-repo-check"
+  local gemini_tier=""
 
   case "$TFX_CLI_MODE" in
     codex)
@@ -894,7 +967,12 @@ apply_cli_mode() {
           *)
             CLI_ARGS="-m $(resolve_gemini_profile flash3) -y --prompt"; CLI_EFFORT="flash3" ;;
         esac
-        echo "[tfx-route] TFX_CLI_MODE=gemini: $AGENT_TYPE → gemini($CLI_EFFORT)로 리매핑" >&2
+        case "$CLI_EFFORT" in
+          pro*) gemini_tier="pro" ;;
+          flash*|lite*) gemini_tier="flash" ;;
+          *) gemini_tier="$CLI_EFFORT" ;;
+        esac
+        echo "[tfx-route] TFX_CLI_MODE=gemini: $AGENT_TYPE → gemini($gemini_tier)로 리매핑" >&2
       fi ;;
     auto)
       if [[ "$CLI_TYPE" == "codex" ]] && ! command -v "$CODEX_BIN" &>/dev/null; then
@@ -1226,7 +1304,7 @@ _gemini_run_once() {
   else
     "$TIMEOUT_BIN" "$TIMEOUT_SEC" "$CLI_CMD" "${g_args[@]}" "$prompt" >"$STDOUT_LOG" 2>"$STDERR_LOG" &
   fi
-  echo "$!"
+  GEMINI_RUN_PID=$!
 }
 
 gemini_with_retry() {
@@ -1243,7 +1321,12 @@ gemini_with_retry() {
   while (( attempt < max_retries )); do
     exit_code_local=0
     local pid
-    pid=$(_gemini_run_once "$use_tee_flag" "$prompt" "${g_args[@]}")
+    _gemini_run_once "$use_tee_flag" "$prompt" "${g_args[@]}"
+    pid="${GEMINI_RUN_PID:-}"
+    if [[ -z "$pid" ]]; then
+      echo "[tfx-route] Gemini: worker pid 획득 실패" >&2
+      return 1
+    fi
 
     local health_ok=true
     local intervals=(1 2 3 5 8)

package/skills/tfx-psmux-rules/SKILL.md

@@ -153,34 +153,121 @@ Get-Content 'C:\path\prompts\prompt.md' -Raw | codex
 
 ---
 
-## RULE 5: WT 패인 정리 (프리징 방지)
+## RULE 5: WT 세션 정리 — CRITICAL (프리징 치명 버그)
 
-WT 패인이 psmux 세션에 attach된 상태에서 `kill-session`하면 WT가 프리징된다.
+> **이 규칙을 위반하면 Windows Terminal이 완전히 프리징된다.**
+> 복구 방법은 작업 관리자에서 WindowsTerminal.exe 강제 종료뿐이다.
+> **모든 열린 탭/세션이 유실된다.** 절대 위반하지 마라.
 
-### MUST (3단계 정리)
+### 프리징 원인
+
+WT 패인이 `psmux attach-session`으로 세션에 연결된 상태에서
+`psmux kill-session`을 직접 호출하면 WT의 PTY 핸들이 dangling 상태가 되어
+**전체 WT 프로세스가 응답 불능**이 된다.
+
+### MUST — 3단계 정리 (순서 반드시 준수)
 
 ```bash
-# 1) graceful exit
-for s in $(psmux list-sessions -F '#{session_name}' 2>/dev/null | grep codex-swarm); do
+# 1) graceful exit — 각 세션 내 프로세스를 정상 종료
+for s in $(psmux list-sessions -F '#{session_name}' 2>/dev/null | grep "$PREFIX"); do
   psmux send-keys -t "$s" "exit" Enter 2>/dev/null || true
 done
 
-# 2) WT 패인 종료 대기
+# 2) WT 패인 분리 대기 — exit이 WT에 전파되는 시간 필요
 sleep 2
 
-# 3) 잔여 세션 강제 종료
-for s in $(psmux list-sessions -F '#{session_name}' 2>/dev/null | grep codex-swarm); do
+# 3) 잔여 세션 강제 종료 — exit이 먹히지 않은 경우만
+for s in $(psmux list-sessions -F '#{session_name}' 2>/dev/null | grep "$PREFIX"); do
   psmux kill-session -t "$s" 2>/dev/null || true
 done
 ```
 
-### MUST NOT
+### MUST NOT — 아래 패턴은 전부 프리징 유발
 
 ```bash
-# WRONG — WT 프리징 발생
-for s in $(psmux list-sessions -F '#{session_name}' 2>/dev/null | grep codex-swarm); do
-  psmux kill-session -t "$s"
-done
+# WRONG 1 — exit 없이 바로 kill
+psmux kill-session -t "$session"
+
+# WRONG 2 — sleep 없이 exit 직후 kill
+psmux send-keys -t "$s" "exit" Enter
+psmux kill-session -t "$s"   # ← WT가 아직 PTY를 잡고 있음
+
+# WRONG 3 — detach 직후 kill
+psmux send-keys -t "$s" "psmux detach" Enter
+psmux kill-session -t "$s"   # ← detach 완료 전에 kill → 프리징
+```
+
+### WT 패인 직접 닫기 (세션이 아닌 WT 쪽에서 정리)
+
+```bash
+# WT 패인을 닫는 것이 세션 kill보다 안전
+wt.exe -w 0 close-pane    # 현재 포커스된 패인 닫기
+```
+
+---
+
+## RULE 5-1: psmux 경로 탐색
+
+psmux는 환경마다 설치 위치가 다르다. `hub/team/psmux.mjs`의 `PSMUX_BIN`이
+자동 탐색하지만, 스크립트에서 직접 psmux를 호출할 때도 경로를 고려해야 한다.
+
+탐색 우선순위:
+1. `$PSMUX_BIN` 환경변수 (설정 시 최우선)
+2. PATH의 `psmux`
+3. `%LOCALAPPDATA%\psmux\psmux.exe` (Windows 기본)
+4. `%APPDATA%\npm\psmux.cmd` (npm global)
+5. `~\scoop\shims\psmux.exe` (Scoop)
+
+---
+
+## RULE 5-2: WT 명령 치트시트
+
+### 패인 분할
+
+```bash
+# 현재 창에서 수평 분할 (상/하)
+wt.exe -w 0 sp -H -p triflux --title "worker" psmux attach-session -t SESSION
+
+# 현재 창에서 수직 분할 (좌/우)
+wt.exe -w 0 sp -V -p triflux --title "worker" psmux attach-session -t SESSION
+
+# 2x2 그리드 (4 패인)
+wt.exe -w 0 \
+  sp -H -p triflux --title "w1" psmux attach-session -t S1 \; \
+  sp -V -p triflux --title "w2" psmux attach-session -t S2 \; \
+  move-focus up \; \
+  sp -V -p triflux --title "w3" psmux attach-session -t S3
+```
+
+### 포커스 이동
+
+```bash
+wt.exe -w 0 move-focus up|down|left|right
+```
+
+### 패인 닫기 (세션 kill보다 안전)
+
+```bash
+wt.exe -w 0 close-pane
+```
+
+### 필수 옵션
+
+| 옵션 | 의미 | 필수 여부 |
+|------|------|----------|
+| `-w 0` | 현재 WT 윈도우 | 필수 (없으면 새 창) |
+| `-p triflux` | triflux WT 프로파일 | 필수 (테마/셸 일관성) |
+| `--title "name"` | 패인 제목 | 권장 (식별용) |
+| `sp -H` / `sp -V` | 분할 방향 | 필수 |
+
+### 새 탭 금지
+
+```bash
+# WRONG — 새 탭 생성 (nt)
+wt.exe -w 0 nt -p triflux ...
+
+# RIGHT — split-pane (sp)
+wt.exe -w 0 sp -V -p triflux ...
 ```
 
 ---

package/skills/tfx-research/SKILL.md

@@ -57,7 +57,7 @@ AskUserQuestion:
 최적화된 쿼리를 Gemini CLI로 전달한다. Gemini는 네이티브 Google Search를 사용해 검색과 요약을 모두 수행한다:
 
 ```
-Bash("bash scripts/tfx-route.sh gemini exec 'Research the following topic. Use Google Search to find current information. Return a structured markdown summary with sources: {optimized_query}'")
+Bash("bash scripts/tfx-route.sh gemini 'Research the following topic. Use Google Search to find current information. Return a structured markdown summary with sources: {optimized_query}' auto 120")
 ```
 
 Gemini가 반환하는 결과에는 검색 결과, 출처 URL, 핵심 요약이 포함된다. Claude는 이 단계에서 토큰을 소비하지 않는다.

package/skills/tfx-setup/SKILL.md

@@ -11,7 +11,10 @@ argument-hint: "[doctor]"
 
 # tfx-setup — triflux 초기 설정 위저드
 
-> 설치 후 최초 1회 실행 권장. HUD 설정, CLI 확인, 전체 진단을 수행합니다.
+> 설치 후 최초 1회 + **매 업데이트 후** 실행 권장.
+> `tfx update` 완료 후에도 이 스킬의 단계 1.5(훅 등록 확인)를 반드시 실행하여
+> 신규/변경된 훅이 settings.json에 반영되도록 한다.
+> 훅 우선순위 관리는 `tfx-hooks` 스킬의 오케스트레이터 패턴을 따른다.
 
 ## 워크플로우
 
@@ -43,6 +46,19 @@ Bash("triflux setup")
 
 스크립트/HUD/스킬을 `~/.claude/`에 배포. 결과 표시.
 
+#### 단계 1.5: 훅 등록 확인
+
+`~/.claude/settings.json`을 Read 도구로 읽어 필수 훅이 등록되어 있는지 확인한다.
+
+필수 훅 목록:
+| 이벤트 | matcher | 스크립트 | 역할 |
+|--------|---------|---------|------|
+| PreToolUse | Bash\|Agent | headless-guard-fast.sh | Codex/Gemini 직접 호출 차단 |
+| PreToolUse | Bash | psmux-safety-guard.mjs | psmux kill-session 직접 호출 차단 (WT 프리징 방지) |
+| PreToolUse | Skill | tfx-gate-activate.mjs | tfx-multi 게이트 |
+
+누락된 훅이 있으면 update-config 스킬로 등록한다. 이미 있으면 ✅ 표시.
+
 #### 단계 2: HUD 설정
 
 `~/.claude/settings.json`을 Read 도구로 읽어 `statusLine` 확인.