triflux 8.11.0 → 8.11.2

package/README.ko.md

@@ -10,7 +10,7 @@
 
 <p align="center">
   <strong>Consensus Intelligence 기반 Tri-CLI 오케스트레이션</strong><br>
-  <em>Claude + Codex + Gemini — 3자 토론, Anti-Herding 검증, Deep/Light 변형을 갖춘 33개 스킬.</em>
+  <em>Claude + Codex + Gemini — 3자 토론, Anti-Herding 검증, Deep/Light 변형을 갖춘 35개 스킬.</em>
 </p>
 
 <p align="center">
@@ -27,7 +27,7 @@
 <p align="center">
   <a href="#빠른-시작">빠른 시작</a> ·
   <a href="#tri-cli-합의-엔진">Tri-CLI 합의 엔진</a> ·
-  <a href="#33개-스킬">33개 스킬</a> ·
+  <a href="#35개-스킬">35개 스킬</a> ·
   <a href="#아키텍처">아키텍처</a> ·
   <a href="#deep-vs-light">Deep vs Light</a> ·
   <a href="#보안">보안</a>
@@ -86,7 +86,7 @@ tfx setup
 
 ### 주요 특징
 
-- **33개 스킬** — Light 11개 + Deep 10개 + Infrastructure 12개, 9개 도메인으로 구성
+- **35개 스킬** — Light 11개 + Deep 10개 + Infrastructure 12개, 9개 도메인으로 구성
 - **Tri-Debate Engine** — 3개 CLI가 독립 분석 후 Anti-Herding, 교차 검증, 합의 점수 산출
 - **Deep/Light 변형** — 모든 기능에 토큰 효율적인 Light 모드와 정밀한 Deep 모드를 제공
 - **Consensus Gate** — Deep 스킬은 3개 CLI 중 2개 이상의 동의를 요구하며, 학습된 가중치로 CLI 신뢰도를 추적
@@ -128,7 +128,7 @@ Phase 3: Resolution (합의율 < 70%일 경우)
 
 ---
 
-## 33개 스킬
+## 35개 스킬
 
 ### 리서치
 
@@ -313,6 +313,7 @@ tfx setup
 # Team — Multi-CLI 병렬 오케스트레이션
 /tfx-multi "refactor auth + update UI + add tests"
 ```
+n> **참고**: Deep 스킬(`/tfx-deep-*`, `/tfx-persist`, `/tfx-ralph`)은 완전한 Tri-CLI 합의(Tier 1)를 위해 **psmux**(또는 tmux), **triflux Hub**, **Codex CLI**, **Gemini CLI**가 필요합니다. 전제조건이 충족되지 않으면 Tier 3(Claude 단독, single-model) 모드로 자동 전환됩니다. `tfx doctor`로 환경을 확인하세요.
 
 ---
 

package/README.md

@@ -10,7 +10,7 @@
 
 <p align="center">
   <strong>Tri-CLI Orchestration with Consensus Intelligence</strong><br>
-  <em>Claude + Codex + Gemini — 3-party debate, anti-herding verification, and 33 skills with Deep/Light variants.</em>
+  <em>Claude + Codex + Gemini — 3-party debate, anti-herding verification, and 35 skills with Deep/Light variants.</em>
 </p>
 
 <p align="center">
@@ -27,7 +27,7 @@
 <p align="center">
   <a href="#quick-start">Quick Start</a> ·
   <a href="#tri-cli-consensus">Tri-CLI Consensus</a> ·
-  <a href="#33-skills">33 Skills</a> ·
+  <a href="#35-skills">35 Skills</a> ·
   <a href="#architecture">Architecture</a> ·
   <a href="#deep-vs-light">Deep vs Light</a> ·
   <a href="#security">Security</a>
@@ -86,7 +86,7 @@ tfx setup
 
 ### Highlights
 
-- **33 Skills** — 11 Light + 10 Deep + 12 Infrastructure, organized across 9 domains
+- **35 Skills** — 11 Light + 10 Deep + 12 Infrastructure, organized across 9 domains
 - **Tri-Debate Engine** — 3-CLI independent analysis with anti-herding, cross-validation, and consensus scoring
 - **Deep/Light Variants** — Every capability has a token-efficient Light mode and a thorough Deep mode
 - **Consensus Gate** — Deep skills require 2/3+ CLI agreement; learned weights track CLI reliability over time
@@ -128,7 +128,7 @@ Phase 3: Resolution (if consensus < 70%)
 
 ---
 
-## 33 Skills
+## 35 Skills
 
 ### Research
 
@@ -313,6 +313,7 @@ tfx setup
 # Team — Multi-CLI parallel orchestration
 /tfx-multi "refactor auth + update UI + add tests"
 ```
+n> **Note**: Deep skills (`/tfx-deep-*`, `/tfx-persist`, `/tfx-ralph`) require **psmux** (or tmux), **triflux Hub**, **Codex CLI**, and **Gemini CLI** for full Tri-CLI consensus (Tier 1). Without these prerequisites, skills automatically degrade to Tier 3 (Claude-only, single-model) mode. Run `tfx doctor` to check your environment.
 
 ---
 

package/hub/team/psmux.mjs

@@ -323,12 +323,15 @@ function escapeRegExp(value) {
 
 function psmux(args, opts = {}) {
   const normalizedArgs = normalizePsmuxArgs(args);
+  // PSMUX_SESSION 제거 — 기존 psmux 세션 내에서 호출 시 중첩 세션 차단 방지
+  const { PSMUX_SESSION: _, ...cleanEnv } = process.env;
   try {
     const result = childProcess.execFileSync(PSMUX_BIN, normalizedArgs, {
       encoding: "utf8",
       timeout: PSMUX_TIMEOUT_MS,
       stdio: ["pipe", "pipe", "pipe"],
       windowsHide: true,
+      env: cleanEnv,
       ...opts,
     });
     return result != null ? String(result).trim() : "";

package/package.json

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

package/scripts/headless-guard.mjs

@@ -153,6 +153,11 @@ function deny(reason) {
 }
 
 async function main() {
+  // P0: TFX_ALLOW_DIRECT_CLI 환경변수 바이패스 — psmux 세션 생성 불가 시 수동 활성화
+  if (process.env.TFX_ALLOW_DIRECT_CLI === "1") {
+    nudge("[headless-guard] direct CLI mode (TFX_ALLOW_DIRECT_CLI=1)");
+  }
+
   // psmux 미설치 → 전부 통과
   if (!isPsmuxInstalled()) process.exit(0);
 

package/skills/tfx-deep-analysis/SKILL.md

@@ -13,6 +13,57 @@ argument-hint: "<분석 대상 — 파일, 디렉토리, 또는 주제>"
 > Claude(아키텍처) + Codex(구현/보안) + Gemini(UX/문서화) → Tri-Debate → 합의.
 > 3자 전문 관점의 편향 없는 분석.
 
+## 전제조건 프로브 및 Tier Degradation
+
+> **진입 즉시 실행** — 10초 내 가시적 출력을 보장한다. 빈 stdout + exit 0 **금지**.
+
+### 환경 프로브
+
+워크플로우 진입 전, 아래 프로브를 실행하여 가용 환경을 감지한다:
+
+```bash
+psmux --version 2>/dev/null && \
+  curl -sf http://127.0.0.1:27888/status >/dev/null && \
+  codex --version 2>/dev/null && \
+  gemini --version 2>/dev/null
+```
+
+### Tier 판정
+
+| Tier | 조건 | 실행 방식 |
+|------|------|----------|
+| **Tier 1** | psmux + Hub + Codex + Gemini 전부 정상 | 기존 headless multi (변경 없음) |
+| **Tier 2** | 일부 CLI만 가용 (Codex 또는 Gemini 중 하나) | 가용 CLI + Claude Agent 조합 |
+| **Tier 3** | headless 불가 또는 `claude -p` one-shot | Claude Agent only |
+
+```
+IF claude -p (one-shot 모드):
+  → Tier 3 즉시 fallback
+
+IF psmux 없음 OR Hub 미응답:
+  → Tier 3
+
+IF Codex 없음 AND Gemini 없음:
+  → Tier 3
+
+IF Codex 없음 OR Gemini 없음:
+  → Tier 2
+
+ELSE:
+  → Tier 1
+```
+
+### Tier 3 진입 시 필수 출력
+
+```
+⚠ [Tier 3] headless multi 환경 미충족 — single-model 모드로 실행합니다 (consensus 미적용)
+  누락: {missing_components}
+  권장: psmux, Hub, Codex CLI, Gemini CLI 설치 후 재실행
+```
+
+Tier 3에서는 모든 headless dispatch(`tfx multi ...`)를 **Claude Agent**(subagent)로 대체한다.
+Tier 2에서는 누락된 CLI만 Claude Agent로 대체한다.
+
 ## HARD RULES
 
 > headless-guard가 이 규칙 위반을 **자동 차단**한다. 우회 불가.

package/skills/tfx-deep-plan/SKILL.md

@@ -17,6 +17,57 @@ argument-hint: "<구현할 기능 설명>"
 
 ---
 
+## 전제조건 프로브 및 Tier Degradation
+
+> **진입 즉시 실행** — 10초 내 가시적 출력을 보장한다. 빈 stdout + exit 0 **금지**.
+
+### 환경 프로브
+
+워크플로우 진입 전, 아래 프로브를 실행하여 가용 환경을 감지한다:
+
+```bash
+psmux --version 2>/dev/null && \
+  curl -sf http://127.0.0.1:27888/status >/dev/null && \
+  codex --version 2>/dev/null && \
+  gemini --version 2>/dev/null
+```
+
+### Tier 판정
+
+| Tier | 조건 | 실행 방식 |
+|------|------|----------|
+| **Tier 1** | psmux + Hub + Codex + Gemini 전부 정상 | 기존 headless multi (변경 없음) |
+| **Tier 2** | 일부 CLI만 가용 (Codex 또는 Gemini 중 하나) | 가용 CLI + Claude Agent 조합 |
+| **Tier 3** | headless 불가 또는 `claude -p` one-shot | Claude Agent only |
+
+```
+IF claude -p (one-shot 모드):
+  → Tier 3 즉시 fallback
+
+IF psmux 없음 OR Hub 미응답:
+  → Tier 3
+
+IF Codex 없음 AND Gemini 없음:
+  → Tier 3
+
+IF Codex 없음 OR Gemini 없음:
+  → Tier 2
+
+ELSE:
+  → Tier 1
+```
+
+### Tier 3 진입 시 필수 출력
+
+```
+⚠ [Tier 3] headless multi 환경 미충족 — single-model 모드로 실행합니다 (consensus 미적용)
+  누락: {missing_components}
+  권장: psmux, Hub, Codex CLI, Gemini CLI 설치 후 재실행
+```
+
+Tier 3에서는 모든 headless dispatch(`tfx multi ...`)를 **Claude Agent**(subagent)로 대체한다.
+Tier 2에서는 누락된 CLI만 Claude Agent로 대체한다.
+
 ## HARD RULES
 
 > headless-guard가 이 규칙 위반을 **자동 차단**한다. 우회 불가.

package/skills/tfx-deep-review/SKILL.md

@@ -19,6 +19,57 @@ argument-hint: "[파일 경로 또는 변경 설명]"
 **Anti-Herding**: Round 1에서 3개 CLI가 서로의 결과를 보지 않고 독립 리뷰.
 **Consensus Only**: 2개 이상 CLI가 동일 이슈를 지적한 항목만 최종 보고 → false-positive 87% 감소.
 
+## 전제조건 프로브 및 Tier Degradation
+
+> **진입 즉시 실행** — 10초 내 가시적 출력을 보장한다. 빈 stdout + exit 0 **금지**.
+
+### 환경 프로브
+
+워크플로우 진입 전, 아래 프로브를 실행하여 가용 환경을 감지한다:
+
+```bash
+psmux --version 2>/dev/null && \
+  curl -sf http://127.0.0.1:27888/status >/dev/null && \
+  codex --version 2>/dev/null && \
+  gemini --version 2>/dev/null
+```
+
+### Tier 판정
+
+| Tier | 조건 | 실행 방식 |
+|------|------|----------|
+| **Tier 1** | psmux + Hub + Codex + Gemini 전부 정상 | 기존 headless multi (변경 없음) |
+| **Tier 2** | 일부 CLI만 가용 (Codex 또는 Gemini 중 하나) | 가용 CLI + Claude Agent 조합 |
+| **Tier 3** | headless 불가 또는 `claude -p` one-shot | Claude Agent only |
+
+```
+IF claude -p (one-shot 모드):
+  → Tier 3 즉시 fallback
+
+IF psmux 없음 OR Hub 미응답:
+  → Tier 3
+
+IF Codex 없음 AND Gemini 없음:
+  → Tier 3
+
+IF Codex 없음 OR Gemini 없음:
+  → Tier 2
+
+ELSE:
+  → Tier 1
+```
+
+### Tier 3 진입 시 필수 출력
+
+```
+⚠ [Tier 3] headless multi 환경 미충족 — single-model 모드로 실행합니다 (consensus 미적용)
+  누락: {missing_components}
+  권장: psmux, Hub, Codex CLI, Gemini CLI 설치 후 재실행
+```
+
+Tier 3에서는 모든 headless dispatch(`tfx multi ...`)를 **Claude Agent**(subagent)로 대체한다.
+Tier 2에서는 누락된 CLI만 Claude Agent로 대체한다.
+
 ## HARD RULES
 
 > headless-guard가 이 규칙 위반을 **자동 차단**한다. 우회 불가.

package/skills/tfx-persist/SKILL.md

@@ -15,6 +15,57 @@ argument-hint: "<완료할 작업 설명>"
 > OMC ralph 오마주. 핵심 차별점: 검증자가 단일 agent가 아니라 **3-CLI consensus**.
 > The boulder never stops — but it stops being wrong.
 
+## 전제조건 프로브 및 Tier Degradation
+
+> **진입 즉시 실행** — 10초 내 가시적 출력을 보장한다. 빈 stdout + exit 0 **금지**.
+
+### 환경 프로브
+
+워크플로우 진입 전, 아래 프로브를 실행하여 가용 환경을 감지한다:
+
+```bash
+psmux --version 2>/dev/null && \
+  curl -sf http://127.0.0.1:27888/status >/dev/null && \
+  codex --version 2>/dev/null && \
+  gemini --version 2>/dev/null
+```
+
+### Tier 판정
+
+| Tier | 조건 | 실행 방식 |
+|------|------|----------|
+| **Tier 1** | psmux + Hub + Codex + Gemini 전부 정상 | 기존 headless multi (변경 없음) |
+| **Tier 2** | 일부 CLI만 가용 (Codex 또는 Gemini 중 하나) | 가용 CLI + Claude Agent 조합 |
+| **Tier 3** | headless 불가 또는 `claude -p` one-shot | Claude Agent only |
+
+```
+IF claude -p (one-shot 모드):
+  → Tier 3 즉시 fallback
+
+IF psmux 없음 OR Hub 미응답:
+  → Tier 3
+
+IF Codex 없음 AND Gemini 없음:
+  → Tier 3
+
+IF Codex 없음 OR Gemini 없음:
+  → Tier 2
+
+ELSE:
+  → Tier 1
+```
+
+### Tier 3 진입 시 필수 출력
+
+```
+⚠ [Tier 3] headless multi 환경 미충족 — single-model 모드로 실행합니다 (consensus 미적용)
+  누락: {missing_components}
+  권장: psmux, Hub, Codex CLI, Gemini CLI 설치 후 재실행
+```
+
+Tier 3에서는 모든 headless dispatch(`tfx multi ...`)를 **Claude Agent**(subagent)로 대체한다.
+Tier 2에서는 누락된 CLI만 Claude Agent로 대체한다.
+
 ## HARD RULES
 
 > headless-guard가 이 규칙 위반을 **자동 차단**한다. 우회 불가.

package/skills/tfx-ralph/SKILL.md

@@ -0,0 +1,81 @@
+---
+name: tfx-ralph
+description: "작업이 완전히 끝날 때까지 멈추지 않고 반복 실행해야 할 때 사용한다. 'ralph', '끝까지 해', '멈추지 마', 'don't stop', '완료될 때까지', '다 될 때까지 계속' 같은 요청에 반드시 사용. 여러 기준을 모두 충족해야 하는 복잡한 구현 작업에 적극 활용."
+triggers:
+  - ralph
+  - don't stop
+  - 끝까지
+  - until done
+  - 멈추지 마
+argument-hint: "<완료할 작업 설명>"
+---
+
+# tfx-ralph — Alias for tfx-persist
+
+> `tfx-ralph`는 `tfx-persist`의 alias이다. 동일한 Tri-Verified Persistence Loop을 실행한다.
+> The boulder never stops — but it stops being wrong.
+
+## 실행 계약
+
+이 스킬은 `tfx-persist`와 **완전히 동일한 실행 흐름**을 공유한다:
+
+1. **동일한 headless multi 경로** — `tfx multi --teammate-mode headless` 기반 3자 검증
+2. **동일한 degradation 체인** — Tier 1 (전체 가용) → Tier 2 (부분 가용) → Tier 3 (Claude only)
+3. **동일한 워크플로우** — Goal Definition → Execution Loop → Final Verification → Deslop Pass
+
+## 전제조건 프로브 및 Tier Degradation
+
+> **진입 즉시 실행** — 10초 내 가시적 출력을 보장한다. 빈 stdout + exit 0 **금지**.
+
+### 환경 프로브
+
+```bash
+psmux --version 2>/dev/null && \
+  curl -sf http://127.0.0.1:27888/status >/dev/null && \
+  codex --version 2>/dev/null && \
+  gemini --version 2>/dev/null
+```
+
+### Tier 판정
+
+| Tier | 조건 | 실행 방식 |
+|------|------|----------|
+| **Tier 1** | psmux + Hub + Codex + Gemini 전부 정상 | 기존 headless multi (변경 없음) |
+| **Tier 2** | 일부 CLI만 가용 (Codex 또는 Gemini 중 하나) | 가용 CLI + Claude Agent 조합 |
+| **Tier 3** | headless 불가 또는 `claude -p` one-shot | Claude Agent only |
+
+```
+IF claude -p (one-shot 모드):
+  → Tier 3 즉시 fallback
+
+IF psmux 없음 OR Hub 미응답:
+  → Tier 3
+
+IF Codex 없음 AND Gemini 없음:
+  → Tier 3
+
+IF Codex 없음 OR Gemini 없음:
+  → Tier 2
+
+ELSE:
+  → Tier 1
+```
+
+### Tier 3 진입 시 필수 출력
+
+```
+⚠ [Tier 3] headless multi 환경 미충족 — single-model 모드로 실행합니다 (consensus 미적용)
+  누락: {missing_components}
+  권장: psmux, Hub, Codex CLI, Gemini CLI 설치 후 재실행
+```
+
+Tier 3에서는 모든 headless dispatch(`tfx multi ...`)를 **Claude Agent**(subagent)로 대체한다.
+Tier 2에서는 누락된 CLI만 Claude Agent로 대체한다.
+
+## 라우팅
+
+```
+/tfx-ralph "{task}" → /tfx-persist "{task}" 로 내부 전달
+```
+
+전체 워크플로우, 토큰 예산, Anti-Stuck 메커니즘은 [tfx-persist/SKILL.md](../tfx-persist/SKILL.md)를 참조하라.