triflux 10.20.0 → 10.20.2

package/.claude-plugin/marketplace.json

@@ -9,7 +9,7 @@
     {
       "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.20.0",
+      "version": "10.20.2",
       "author": {
         "name": "tellang"
       },
@@ -30,5 +30,5 @@
       ]
     }
   ],
-  "version": "10.20.0"
+  "version": "10.20.2"
 }

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "triflux",
-  "version": "10.20.0",
+  "version": "10.20.2",
   "description": "CLI-first multi-model orchestrator for Claude Code — route tasks to Codex, Gemini, and Claude",
   "author": {
     "name": "tellang"

package/README.ko.md

@@ -10,15 +10,15 @@
 
 <p align="center">
   <strong>Consensus Intelligence 기반 Tri-CLI 오케스트레이션</strong><br>
-  <em>Claude + Codex + Gemini — 21개 코어 스킬, 23개 thin alias, 자연어 라우팅, 교차 모델 리뷰.</em>
+  <em>Claude + Codex + Gemini — 13개 공개 코어 스킬, 11개 호환 alias, 자연어 라우팅, 교차 모델 리뷰.</em>
 </p>
 
 <p align="center">
   <a href="https://www.npmjs.com/package/triflux"><img src="https://img.shields.io/npm/v/triflux?style=flat-square&color=FFAF00&label=npm" alt="npm version"></a>
   <a href="https://www.npmjs.com/package/triflux"><img src="https://img.shields.io/npm/dm/triflux?style=flat-square&color=F5C242" alt="npm downloads"></a>
   <a href="https://github.com/tellang/triflux/stargazers"><img src="https://img.shields.io/github/stars/tellang/triflux?style=flat-square&color=FFAF00" alt="GitHub stars"></a>
-  <img src="https://img.shields.io/badge/skills-21_core-F5C242?style=flat-square" alt="21개 코어 스킬">
-  <sub>+ 23개 thin alias</sub>
+  <img src="https://img.shields.io/badge/skills-13_core-F5C242?style=flat-square" alt="13개 코어 스킬">
+  <sub>+ 11개 호환 alias</sub>
   <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-374151?style=flat-square" alt="License: MIT"></a>
 </p>
 
@@ -29,7 +29,7 @@
 <p align="center">
   <a href="#빠른-시작">빠른 시작</a> ·
   <a href="#tri-cli-합의-엔진">Tri-CLI 합의 엔진</a> ·
-  <a href="#전체-21개-스킬-23개-thin-alias-포함">전체 21개 스킬</a> ·
+  <a href="#전체-13개-코어-스킬-호환-alias-포함">전체 13개 스킬</a> ·
   <a href="#아키텍처">아키텍처</a> ·
   <a href="#deep-vs-light">Deep vs Light</a> ·
   <a href="#보안">보안</a>
@@ -57,15 +57,14 @@ npm install -g triflux
 ### 사용법
 
 ```bash
-# Light — 단일 모델로 빠르게 실행
+# Deep 기본값 — 3자 합의로 실행
 /tfx-research "React 19 Server Actions best practices"
 /tfx-review
 /tfx-plan "add JWT auth middleware"
 
-# Deep — 중요한 작업에 3자 합의 적용
-/tfx-deep-research "microservice architecture comparison 2026"
-/tfx-deep-review
-/tfx-deep-plan "migrate REST to GraphQL"
+# Quick opt-out — 단일 모델로 빠르게 실행
+/tfx-review --quick
+/tfx-plan "add JWT auth middleware" --quick
 
 # Debate — 3개의 독립적인 의견을 확보
 /tfx-debate "Redis vs PostgreSQL LISTEN/NOTIFY for real-time events"
@@ -77,7 +76,7 @@ npm install -g triflux
 /tfx-multi "refactor auth + update UI + add tests"
 
 # Remote — setup, spawn, attach, resume를 하나의 표면으로
-/tfx-remote-setup                              # 인터랙티브 호스트 설정 위저드 (Tailscale + SSH)
+/tfx-remote setup                              # 인터랙티브 호스트 설정 위저드 (Tailscale + SSH)
 /tfx-remote spawn ultra4 "보안 리뷰 실행"       # 원격 호스트에서 세션 실행
 ```
 
@@ -89,9 +88,9 @@ npm install -g triflux
 
 ### v10.11.0 주요 특징
 
-- **자연어 라우팅** — "리뷰해줘"라고 말하면 `/tfx-review`가 자동 호출. "제대로/꼼꼼히" 수정자로 Deep 변형 자동 에스컬레이션
+- **자연어 라우팅** — "리뷰해줘"라고 말하면 `/tfx-review`가 자동 호출. 기본은 Deep이고 `--quick`으로 빠른 경로를 명시
 - **교차 모델 리뷰** — Claude가 작성하면 Codex가 리뷰, Codex가 작성하면 Claude가 리뷰. 동일 모델 self-approve 차단. 커밋 전 미검증 파일 nudge
-- **정확한 카탈로그** — 44개 스킬 파일 기준 `21 core + 23 thin alias`
+- **정확한 카탈로그** — 33개 스킬 파일 기준 `13 public core + 11 compatibility alias + 9 internal helper`
 - **Phase 3** — `--retry ralph`, `--retry auto-escalate`, `--lead codex`, `--max-iterations N`, 4단계 `DEFAULT_ESCALATION_CHAIN`
 - **Phase 4** — `tfx-auto --shape debate|panel|consensus`, `tfx-remote` 단일 진입점, `tfx-psmux-rules`는 `.claude/rules/tfx-psmux.md`로 이동
 - **하위 호환성 유지** — `tfx-persist`, `tfx-debate`, `tfx-multi`, `tfx-remote-spawn` 같은 기존 이름은 thin alias로 계속 지원
@@ -142,44 +141,39 @@ Phase 4 이후에는 `tfx-auto`가 하나의 front door 역할을 맡습니다.
 
 ---
 
-## 전체 21개 스킬 (23개 thin alias 포함)
+## 전체 13개 코어 스킬 (호환 alias 포함)
 
 ### 리서치
 
 | 스킬 | 상태 | 설명 |
 |------|------|------|
-| `tfx-research` | Active | Exa/Brave/Tavily 자동 선택을 통한 빠른 웹 검색 |
-| `tfx-find` | Active | 파일, 심볼, 패턴 중심의 빠른 코드베이스 탐색 |
+| `tfx-index` | Core | 프로젝트 인덱싱과 컨텍스트 압축 |
 
-Aliases (fold into `tfx-auto` flags): `tfx-deep-research`, `tfx-autoresearch`
+내부 라우팅 helper: `tfx-research`, `tfx-find`
 
 ### 분석 및 계획
 
 | 스킬 | 상태 | 설명 |
 |------|------|------|
-| `tfx-analysis` | Active | 빠른 코드/아키텍처 분석 |
-| `tfx-plan` | Active | 빠른 구현 계획 수립 |
-| `tfx-interview` | Active | 소크라테스식 요구사항 탐색 |
+| _독립 공개 표면 없음_ | — | 분석, 계획, 인터뷰는 내부 helper로 라우팅 |
 
-Aliases (fold into `tfx-auto` flags): `tfx-deep-analysis`, `tfx-deep-plan`, `tfx-deep-interview`
+내부 라우팅 helper: `tfx-analysis`, `tfx-plan`, `tfx-interview`
 
 ### 실행
 
 | 스킬 | 상태 | 설명 |
 |------|------|------|
-| `tfx-auto` | Active | 플래그 기반 라우팅과 legacy surface folding을 담당하는 통합 CLI 오케스트레이터 |
+| `tfx-auto` | Core | 플래그 기반 라우팅과 legacy surface folding을 담당하는 통합 CLI 오케스트레이터 |
 
-Aliases (fold into `tfx-auto` flags): `tfx-autopilot`, `tfx-fullcycle`, `tfx-codex`, `tfx-gemini`
+호환 alias: `tfx-autopilot`, `tfx-fullcycle`, `tfx-multi`, `tfx-persist`, `tfx-swarm`
 
 ### 리뷰 및 QA
 
 | 스킬 | 상태 | 설명 |
 |------|------|------|
-| `tfx-review` | Active | 빠른 코드 리뷰 |
-| `tfx-qa` | Active | Test → Fix → Retest 순환 (최대 3회) |
-| `tfx-prune` | Active | AI slop 제거, dead code 및 과한 추상화 정리 |
+| _독립 공개 표면 없음_ | — | 리뷰, QA, 정리는 내부 helper로 라우팅 |
 
-Aliases (fold into `tfx-auto` flags): `tfx-deep-review`, `tfx-deep-qa`
+내부 라우팅 helper: `tfx-review`, `tfx-qa`, `tfx-prune`
 
 ### 토론 및 의사결정
 
@@ -187,35 +181,33 @@ Aliases (fold into `tfx-auto` flags): `tfx-deep-review`, `tfx-deep-qa`
 |------|------|------|
 | _독립 active 표면 없음_ | — | debate, consensus, panel은 이제 `tfx-auto --mode consensus`의 출력 shape로 통합 |
 
-Aliases (fold into `tfx-auto` flags): `tfx-consensus`, `tfx-debate`, `tfx-panel`
+호환 alias: `tfx-consensus`, `tfx-debate`, `tfx-panel`
 
 ### 지속 실행 및 라우팅
 
 | 스킬 | 상태 | 설명 |
 |------|------|------|
-| `tfx-index` | Active | 프로젝트 인덱싱으로 94% 토큰 절감 (58K→3K) |
-| `tfx-hooks` | Active | Claude Code hook priority 관리 |
-| `tfx-profile` | Active | Codex/Gemini CLI 프로필 관리 |
+| `tfx-hooks` | Core | Claude Code hook priority 관리 |
+| `tfx-profile` | Core | Codex/Gemini CLI 프로필 관리 |
 
-Aliases (fold into `tfx-auto` flags): `tfx-persist`, `tfx-ralph`, `tfx-autoroute`, `tfx-auto-codex`
+내부 라우팅 helper: `tfx-ralph`
 
 ### 오케스트레이션
 
 | 스킬 | 상태 | 설명 |
 |------|------|------|
-| `tfx-hub` | Active | MCP 메시지 버스 관리 |
-| `tfx-codex-swarm` | Active | Codex swarm 실행 표면 |
-| `merge-worktree` | Active | swarm 결과용 worktree merge helper |
+| `tfx-hub` | Core | MCP 메시지 버스 관리 |
+| `merge-worktree` | Core | swarm 결과용 worktree merge helper |
 
-Aliases (fold into active surfaces): `tfx-multi`, `tfx-swarm`
+Swarm 실행은 `tfx-auto --parallel swarm` 과 `tfx swarm` CLI로 노출된다.
 
 ### 원격
 
 | 스킬 | 상태 | 설명 |
 |------|------|------|
-| `tfx-remote` | Active | setup, spawn, list, attach, send, resume, probe, rules를 묶는 원격 command family |
+| `tfx-remote` | Core | setup, spawn, list, attach, send, resume, probe, rules를 묶는 원격 command family |
 
-Aliases (fold into active surfaces): `tfx-remote-spawn`, `tfx-remote-setup`, `tfx-psmux-rules` — Phase 4에서 `.claude/rules/tfx-psmux.md`로 이동
+호환 alias: `tfx-remote-spawn`, `tfx-remote-setup`, `tfx-psmux-rules` — Phase 4에서 `.claude/rules/tfx-psmux.md`로 이동
 
 ### 메타
 
@@ -225,6 +217,7 @@ Aliases (fold into active surfaces): `tfx-remote-spawn`, `tfx-remote-setup`, `tf
 | `tfx-setup` | Active | 초기 설정 마법사 |
 | `tfx-doctor` | Active | 진단 및 자동 복구 |
 | `tfx-ship` | Active | ship workflow orchestration |
+| `tfx-wt` | Active | Windows Terminal 탭/패인 제어 |
 | `star-prompt` | Active | postinstall GitHub star prompt |
 
 ---
@@ -316,15 +309,14 @@ npm install -g triflux
 ### 사용법
 
 ```bash
-# Light — 단일 모델로 빠르게 실행
+# Deep 기본값 — 3자 합의로 실행
 /tfx-research "React 19 Server Actions best practices"
 /tfx-review
 /tfx-plan "add JWT auth middleware"
 
-# Deep — 중요한 작업에 3자 합의 적용
-/tfx-deep-research "microservice architecture comparison 2026"
-/tfx-deep-review
-/tfx-deep-plan "migrate REST to GraphQL"
+# Quick opt-out — 단일 모델로 빠르게 실행
+/tfx-review --quick
+/tfx-plan "add JWT auth middleware" --quick
 
 # Debate — 3개의 독립적인 의견을 확보
 /tfx-debate "Redis vs PostgreSQL LISTEN/NOTIFY for real-time events"

package/README.md

@@ -11,7 +11,7 @@
 <h3 align="center">Tri-CLI Orchestration with Consensus Intelligence</h3>
 
 <p align="center">
-  Route tasks across <strong>Claude + Codex + Gemini</strong> — 21 core skills, natural language routing,<br>
+  Route tasks across <strong>Claude + Codex + Gemini</strong> — 13 public core skills, natural language routing,<br>
   cross-model review, and reflexion-based adaptive learning.
 </p>
 
@@ -19,8 +19,8 @@
   <a href="https://www.npmjs.com/package/triflux"><img src="https://img.shields.io/npm/v/triflux?style=flat-square&color=FFAF00&label=npm" alt="npm version"></a>
   <a href="https://www.npmjs.com/package/triflux"><img src="https://img.shields.io/npm/dm/triflux?style=flat-square&color=F5C242" alt="npm downloads"></a>
   <a href="https://github.com/tellang/triflux/stargazers"><img src="https://img.shields.io/github/stars/tellang/triflux?style=flat-square&color=FFAF00" alt="GitHub stars"></a>
-  <img src="https://img.shields.io/badge/skills-21_core-F5C242?style=flat-square" alt="21 core skills">
-  <sub>+ 23 thin aliases</sub>
+  <img src="https://img.shields.io/badge/skills-13_core-F5C242?style=flat-square" alt="13 core skills">
+  <sub>+ 11 compatibility aliases</sub>
   <img src="https://img.shields.io/badge/node-%3E%3D18-374151?style=flat-square" alt="Node >= 18">
   <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-374151?style=flat-square" alt="License: MIT"></a>
 </p>
@@ -33,7 +33,7 @@
   <a href="#quick-start">Quick Start</a> &middot;
   <a href="#core-engine">Core Engine</a> &middot;
   <a href="#killer-skills">Killer Skills</a> &middot;
-  <a href="#all-21-skills-plus-23-thin-aliases">All 21 Skills</a> &middot;
+  <a href="#all-13-core-skills-plus-compatibility-aliases">All 13 Skills</a> &middot;
   <a href="#deep-vs-light">Deep vs Light</a> &middot;
   <a href="#architecture">Architecture</a> &middot;
   <a href="#security">Security</a>
@@ -45,7 +45,7 @@
 
 Most AI coding tools talk to **one model**. triflux talks to **three** — and makes them argue.
 
-triflux is not a collection of skills. It is a **multi-model parallel orchestration harness**. The 21 core skills and 23 thin aliases are what it does. The harness — consensus engine, message bus, router, and security guard — is what makes it different.
+triflux is not a collection of skills. It is a **multi-model parallel orchestration harness**. The 13 public core skills, 11 compatibility aliases, and internal routed helpers are what it does. The harness — consensus engine, message bus, router, and security guard — is what makes it different.
 
 Every Deep skill runs Claude, Codex, and Gemini **independently** (no cross-visibility), then cross-validates their findings. Only consensus-verified results survive. The result: **87% fewer false positives** compared to single-model review.
 
@@ -54,10 +54,10 @@ Phase 4 folds the legacy surface into one front door: `tfx-auto` with flag-based
 You don't need to memorize commands. Say what you want in natural language — triflux routes to the right skill automatically:
 
 ```
-"review this"          → /tfx-review       (Light — single model, fast)
-"review this thoroughly" → /tfx-deep-review  (Deep — 3-party consensus)
+"review this"          → /tfx-review       (Deep by default — 3-party consensus)
+"review this --quick"  → /tfx-review --quick  (quick opt-out)
 "리뷰해줘"              → /tfx-review       (Korean works too)
-"제대로 리뷰해"          → /tfx-deep-review  (depth modifier detected)
+"제대로 리뷰해"          → /tfx-review       (depth modifier detected)
 ```
 
 ---
@@ -83,8 +83,8 @@ Then run `tfx setup` to configure your environment.
 
 ```bash
 # 3-party consensus — three models argue, only consensus survives
-/tfx-deep-review
-/tfx-deep-plan "migrate REST to GraphQL"
+/tfx-review
+/tfx-plan "migrate REST to GraphQL"
 
 # Swarm — split PRD into shards, parallel worktree execution
 /tfx-swarm
@@ -266,13 +266,13 @@ Each shard gets its own git worktree, file-lease enforcement prevents conflicts,
 /tfx-auto "implement full auth flow with tests" --retry ralph --max-iterations 10
 ```
 
-### 3-Party Consensus Reviews — `tfx-deep-review` / `tfx-deep-plan`
+### 3-Party Consensus Reviews — `tfx-review` / `tfx-plan`
 
 The bread-and-butter Deep skills. Three models independently review your code or plan your implementation, then cross-validate. Only consensus-verified findings survive.
 
 ```bash
-/tfx-deep-review            # 3-party code review
-/tfx-deep-plan "migrate to GraphQL"  # 3-party planning
+/tfx-review            # 3-party code review by default
+/tfx-plan "migrate to GraphQL"  # 3-party planning by default
 ```
 
 ### Structured Debate — `tfx-debate` (alias for `tfx-auto --mode consensus --shape debate`)
@@ -285,7 +285,7 @@ Three models take independent positions on a technical question, debate, and con
 
 ---
 
-## All 21 Skills (plus 23 thin aliases)
+## All 13 Core Skills (plus compatibility aliases)
 
 <details>
 <summary>Expand full skill list</summary>
@@ -294,38 +294,33 @@ Three models take independent positions on a technical question, debate, and con
 
 | Skill | Type | Description |
 |-------|------|-------------|
-| `tfx-research` | Active | Quick web search via Exa/Brave/Tavily auto-selection |
-| `tfx-find` | Active | Fast codebase search — files, symbols, patterns |
+| `tfx-index` | Core | Project indexing and context compression |
 
-Aliases (fold into `tfx-auto` flags): `tfx-deep-research`, `tfx-autoresearch`
+Internal routed helpers: `tfx-research`, `tfx-find`
 
 ### Analysis & Planning
 
 | Skill | Type | Description |
 |-------|------|-------------|
-| `tfx-analysis` | Active | Quick code/architecture analysis |
-| `tfx-plan` | Active | Quick implementation plan |
-| `tfx-interview` | Active | Socratic requirements exploration |
+| _No standalone public surface_ | — | Analysis, planning, and interview route through internal helpers |
 
-Aliases (fold into `tfx-auto` flags): `tfx-deep-analysis`, `tfx-deep-plan`, `tfx-deep-interview`
+Internal routed helpers: `tfx-analysis`, `tfx-plan`, `tfx-interview`
 
 ### Execution
 
 | Skill | Type | Description |
 |-------|------|-------------|
-| `tfx-auto` | Active | Unified CLI orchestrator — auto-triage, flag-based routing, and legacy surface folding |
+| `tfx-auto` | Core | Unified CLI orchestrator — auto-triage, flag-based routing, and legacy surface folding |
 
-Aliases (fold into `tfx-auto` flags): `tfx-autopilot`, `tfx-fullcycle`, `tfx-codex`, `tfx-gemini`
+Compatibility aliases: `tfx-autopilot`, `tfx-fullcycle`, `tfx-multi`, `tfx-persist`, `tfx-swarm`
 
 ### Review & QA
 
 | Skill | Type | Description |
 |-------|------|-------------|
-| `tfx-review` | Active | Quick code review |
-| `tfx-qa` | Active | Test → Fix → Retest cycle (max 3 rounds) |
-| `tfx-prune` | Active | AI slop removal — dead code, over-abstraction cleanup |
+| _No standalone public surface_ | — | Review, QA, and cleanup route through internal helpers |
 
-Aliases (fold into `tfx-auto` flags): `tfx-deep-review`, `tfx-deep-qa`
+Internal routed helpers: `tfx-review`, `tfx-qa`, `tfx-prune`
 
 ### Debate & Decision
 
@@ -333,27 +328,25 @@ Aliases (fold into `tfx-auto` flags): `tfx-deep-review`, `tfx-deep-qa`
 |-------|------|-------------|
 | _No standalone active surface_ | — | Debate, consensus, and panel shapes now route through `tfx-auto --mode consensus` |
 
-Aliases (fold into `tfx-auto` flags): `tfx-consensus`, `tfx-debate`, `tfx-panel`
+Compatibility aliases: `tfx-consensus`, `tfx-debate`, `tfx-panel`
 
 ### Persistence & Routing
 
 | Skill | Type | Description |
 |-------|------|-------------|
-| `tfx-index` | Active | Project indexing — 94% token reduction (58K → 3K) |
-| `tfx-hooks` | Active | Claude Code hook priority manager |
-| `tfx-profile` | Active | Codex/Gemini CLI profile management |
+| `tfx-hooks` | Core | Claude Code hook priority manager |
+| `tfx-profile` | Core | Codex/Gemini CLI profile management |
 
-Aliases (fold into `tfx-auto` flags): `tfx-persist`, `tfx-ralph`, `tfx-autoroute`, `tfx-auto-codex`
+Internal routed helper: `tfx-ralph`
 
 ### Orchestration & Infrastructure
 
 | Skill | Description |
 |-------|-------------|
 | `tfx-hub` | MCP message bus — Named Pipe & HTTP bridge |
-| `tfx-codex-swarm` | Codex swarm execution surface |
 | `merge-worktree` | Worktree merge helper for swarm results |
 
-Aliases (fold into active surfaces): `tfx-multi`, `tfx-swarm`
+Swarm execution is exposed through `tfx-auto --parallel swarm` and the `tfx swarm` CLI.
 
 ### Remote
 
@@ -361,7 +354,7 @@ Aliases (fold into active surfaces): `tfx-multi`, `tfx-swarm`
 |-------|-------------|
 | `tfx-remote` | Unified remote command family — setup, spawn, list, attach, send, resume, probe, rules |
 
-Aliases (fold into active surfaces): `tfx-remote-spawn`, `tfx-remote-setup`, `tfx-psmux-rules` — moved to `.claude/rules/tfx-psmux.md` in Phase 4
+Compatibility aliases: `tfx-remote-spawn`, `tfx-remote-setup`, `tfx-psmux-rules` — rules moved to `.claude/rules/tfx-psmux.md` in Phase 4
 
 ### Meta & Tooling
 
@@ -371,6 +364,7 @@ Aliases (fold into active surfaces): `tfx-remote-spawn`, `tfx-remote-setup`, `tf
 | `tfx-setup` | Initial setup wizard |
 | `tfx-doctor` | Diagnostics and auto-repair |
 | `tfx-ship` | Ship workflow orchestration |
+| `tfx-wt` | Windows Terminal tab/pane control |
 | `star-prompt` | GitHub star prompt for postinstall |
 
 </details>
@@ -494,7 +488,7 @@ The monitor visualizes:
 - **Consensus shapes** — `--shape consensus|debate|panel` folds ensemble behaviors into the main router
 - **Remote consolidation** — `tfx-remote` becomes the single remote surface while `tfx-remote-spawn` remains a thin alias
 - **Rules relocation** — `tfx-psmux-rules` moved out of the skill surface to `.claude/rules/tfx-psmux.md`
-- **Legacy compatibility** — 23 thin aliases remain for transition safety and are slated for later removal
+- **Legacy compatibility** — 11 compatibility aliases remain for transition safety and are slated for later removal
 
 </details>
 

package/bin/triflux.mjs

@@ -77,6 +77,7 @@ import {
   getVersion,
   getWindowsHubAutostartStatus,
   hasProfileSection,
+  isSetupUserStateFile,
   LEGACY_CODEX_MODELS,
   REQUIRED_CODEX_PROFILES,
   replaceProfileSection,
@@ -332,10 +333,13 @@ const CLI_COMMAND_SCHEMAS = Object.freeze({
     ],
   },
   swarm: {
-    usage: "tfx swarm [run] <prd-path> [--dry-run|--json|--filter <shard>]",
+    usage:
+      "tfx swarm [run|preflight] <prd-path> [--dry-run|--json|--filter <shard>]",
     description: "PRD 기반 멀티모델 x 멀티기기 스웜 실행 (#93)",
     subcommands: {
       run: "tfx swarm run <prd-path> — verb 명시 실행 (기본 경로와 동일)",
+      preflight:
+        "tfx swarm preflight <prd-path> [--json] — 실행 전 go/no-go 리포트 출력",
       plan: "tfx swarm plan <prd-path> [--json] — 실행 없이 계획만 출력",
       list: "tfx swarm list [--json] — 활성 스웜 세션 조회 (synapse status)",
       status: "tfx swarm status [--json] — list alias",
@@ -1206,6 +1210,7 @@ function cmdSetup(options = {}) {
       if (existsSync(refSrc)) {
         mkdirSync(refDst, { recursive: true });
         for (const refFile of readdirSync(refSrc)) {
+          if (isSetupUserStateFile(refFile)) continue;
           const rSrc = join(refSrc, refFile);
           const rDst = join(refDst, refFile);
           if (statSync(rSrc).isFile()) {
@@ -6163,6 +6168,7 @@ async function main() {
 
   ${BOLD}Subcommands${RESET}
     ${WHITE_BRIGHT}tfx swarm run <prd>${RESET}    ${GRAY}${s.subcommands.run}${RESET}
+    ${WHITE_BRIGHT}tfx swarm preflight <prd>${RESET} ${GRAY}${s.subcommands.preflight}${RESET}
     ${WHITE_BRIGHT}tfx swarm plan <prd>${RESET}   ${GRAY}${s.subcommands.plan}${RESET}
     ${WHITE_BRIGHT}tfx swarm list${RESET}         ${GRAY}${s.subcommands.list}${RESET}
     ${WHITE_BRIGHT}tfx swarm status${RESET}       ${GRAY}${s.subcommands.status}${RESET}
@@ -6173,9 +6179,8 @@ ${s.options.map((o) => `    ${DIM}${o.name.padEnd(16)}${RESET} ${GRAY}${o.descri
         return;
       }
       await checkHubRunning();
-      const { cmdSwarmRun, cmdSwarmPlan, cmdSwarmList } = await import(
-        "../hub/team/swarm-cli.mjs"
-      );
+      const { cmdSwarmRun, cmdSwarmPlan, cmdSwarmList, cmdSwarmPreflight } =
+        await import("../hub/team/swarm-cli.mjs");
       if (sub === "list" || sub === "status") {
         await cmdSwarmList(cmdArgs.slice(1), { json: JSON_OUTPUT });
         return;
@@ -6184,6 +6189,10 @@ ${s.options.map((o) => `    ${DIM}${o.name.padEnd(16)}${RESET} ${GRAY}${o.descri
         await cmdSwarmPlan(cmdArgs.slice(1), { json: JSON_OUTPUT });
         return;
       }
+      if (sub === "preflight") {
+        await cmdSwarmPreflight(cmdArgs.slice(1), { json: JSON_OUTPUT });
+        return;
+      }
       if (sub === "run") {
         await cmdSwarmRun(cmdArgs.slice(1), { json: JSON_OUTPUT });
         return;

package/hooks/hook-orchestrator.mjs

@@ -504,7 +504,7 @@ async function main() {
   }
 
   // ── PostToolUse: 컨텍스트 압축 nudge (인라인, 프로세스 추가 없음) ──
-  if (eventName === "PostToolUse" && !blocked) {
+  if (eventName === "PostToolUse" && toolName !== "Bash" && !blocked) {
     try {
       const home = process.env.HOME || process.env.USERPROFILE || "";
       const snapshotPath = join(

package/hooks/hook-registry.json

@@ -8,6 +8,19 @@
     "external_priority": 100
   },
   "events": {
+    "PermissionRequest": [
+      {
+        "id": "tfx-permission-safe-allow",
+        "source": "triflux",
+        "matcher": "Bash",
+        "command": "node \"${PLUGIN_ROOT}/hooks/permission-safe-allow.mjs\"",
+        "priority": 0,
+        "enabled": true,
+        "timeout": 2,
+        "blocking": false,
+        "description": "안전한 repo-local Bash PermissionRequest 자동 허용 (#245)"
+      }
+    ],
     "PreToolUse": [
       {
         "id": "tfx-safety-guard",
@@ -97,6 +110,17 @@
         "timeout": 3,
         "blocking": false,
         "description": "감시 대상 MCP 설정 변경 감지 → stdio MCP 자동 치환"
+      },
+      {
+        "id": "tfx-post-tool-tips",
+        "source": "triflux",
+        "matcher": "Bash|Edit|Write",
+        "command": "node \"${PLUGIN_ROOT}/hooks/post-tool-tips.mjs\"",
+        "priority": 2,
+        "enabled": true,
+        "timeout": 2,
+        "blocking": false,
+        "description": "중요 경로 변경 시 opt-in rules reminder 주입 (#245)"
       }
     ],
     "PostToolUseFailure": [
@@ -226,7 +250,7 @@
         "enabled": true,
         "timeout": 5,
         "blocking": true,
-        "description": "활성 파이프라인 감지 → 종료 차단"
+        "description": "컨텍스트 guard/retry cap + 활성 파이프라인 감지 → Stop 차단"
       },
       {
         "id": "ext-session-vault-export",
@@ -252,18 +276,68 @@
         "description": "MCP 고아 프로세스 정리"
       }
     ],
+    "SessionEnd": [
+      {
+        "id": "tfx-session-end-cleanup",
+        "source": "triflux",
+        "matcher": "*",
+        "command": "node \"${PLUGIN_ROOT}/hooks/session-end-cleanup.mjs\"",
+        "priority": 0,
+        "enabled": true,
+        "timeout": 3,
+        "blocking": false,
+        "description": "세션 종료 시 lifecycle 상태 보고 및 opt-in 정리 (#245)"
+      }
+    ],
+    "SubagentStart": [
+      {
+        "id": "tfx-subagent-tracker",
+        "source": "triflux",
+        "matcher": "*",
+        "command": "node \"${PLUGIN_ROOT}/hooks/subagent-tracker.mjs\"",
+        "priority": 0,
+        "enabled": true,
+        "timeout": 2,
+        "blocking": false,
+        "description": "서브에이전트 lifecycle 시작/종료 상태 추적 (#245)"
+      }
+    ],
     "SubagentStop": [
+      {
+        "id": "tfx-subagent-tracker",
+        "source": "triflux",
+        "matcher": "*",
+        "command": "node \"${PLUGIN_ROOT}/hooks/subagent-tracker.mjs\"",
+        "priority": 0,
+        "enabled": true,
+        "timeout": 2,
+        "blocking": false,
+        "description": "서브에이전트 lifecycle 시작/종료 상태 추적 (#245)"
+      },
       {
         "id": "tfx-subagent-verifier",
         "source": "triflux",
         "matcher": "*",
         "command": "node \"${PLUGIN_ROOT}/hooks/subagent-verifier.mjs\"",
-        "priority": 0,
+        "priority": 1,
         "enabled": true,
         "timeout": 3,
         "blocking": false,
         "description": "서브에이전트 결과 품질 체크"
       }
+    ],
+    "PreCompact": [
+      {
+        "id": "tfx-pre-compact-snapshot",
+        "source": "triflux",
+        "matcher": "*",
+        "command": "node \"${PLUGIN_ROOT}/hooks/pre-compact-snapshot.mjs\"",
+        "priority": 0,
+        "enabled": true,
+        "timeout": 3,
+        "blocking": false,
+        "description": "compact 직전 repo-local 진행 상태 스냅샷 주입 (#245)"
+      }
     ]
   }
 }