triflux 7.4.0 → 7.5.1

package/README.ko.md

@@ -1,45 +1,45 @@
-[English](README.md) | [한국어](README.ko.md)
-
-<p align="center">
-  <picture>
-    <source media="(prefers-color-scheme: dark)" srcset="docs/assets/logo-dark.svg">
-    <source media="(prefers-color-scheme: light)" srcset="docs/assets/logo-light.svg">
-    <img alt="triflux" src="docs/assets/logo-dark.svg" width="200">
-  </picture>
-</p>
-
-<p align="center">
-  <strong>Claude Code를 위한 멀티모델 오케스트레이션 허브</strong><br>
-  <em>Claude 토큰 절약의 핵심. 고성능 Hub IPC를 통해 모든 작업을 Codex와 Gemini로 라우팅하세요.</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>
-  <a href="https://github.com/tellang/triflux/actions"><img src="https://img.shields.io/github/actions/workflow/status/tellang/triflux/ci.yml?style=flat-square&label=CI" alt="CI"></a>
-  <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>
-
-<p align="center">
-  <picture>
-    <source media="(prefers-color-scheme: dark)" srcset="docs/assets/demo-dark.gif">
-    <source media="(prefers-color-scheme: light)" srcset="docs/assets/demo-light.gif">
-    <img alt="triflux 데모" src="docs/assets/demo-dark.gif" width="680">
-  </picture>
-</p>
-
-<p align="center">
-  <a href="#빠른-시작">빠른 시작</a> ·
-  <a href="#아키텍처">아키텍처</a> ·
-  <a href="#파이프라인-thorough-모드">파이프라인</a> ·
-  <a href="#위임delegator-mcp">위임 MCP</a> ·
-  <a href="#에이전트-타입-21">에이전트 타입</a> ·
-  <a href="#보안">보안</a>
-</p>
-
----
-
+[English](README.md) | [한국어](README.ko.md)
+
+<p align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="docs/assets/logo-dark.svg">
+    <source media="(prefers-color-scheme: light)" srcset="docs/assets/logo-light.svg">
+    <img alt="triflux" src="docs/assets/logo-dark.svg" width="200">
+  </picture>
+</p>
+
+<p align="center">
+  <strong>Claude Code를 위한 멀티모델 오케스트레이션 허브</strong><br>
+  <em>Claude 토큰 절약의 핵심. 고성능 Hub IPC를 통해 모든 작업을 Codex와 Gemini로 라우팅하세요.</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>
+  <a href="https://github.com/tellang/triflux/actions"><img src="https://img.shields.io/github/actions/workflow/status/tellang/triflux/ci.yml?style=flat-square&label=CI" alt="CI"></a>
+  <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>
+
+<p align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="docs/assets/demo-dark.gif">
+    <source media="(prefers-color-scheme: light)" srcset="docs/assets/demo-light.gif">
+    <img alt="triflux 데모" src="docs/assets/demo-dark.gif" width="680">
+  </picture>
+</p>
+
+<p align="center">
+  <a href="#빠른-시작">빠른 시작</a> ·
+  <a href="#아키텍처">아키텍처</a> ·
+  <a href="#파이프라인-thorough-모드">파이프라인</a> ·
+  <a href="#위임delegator-mcp">위임 MCP</a> ·
+  <a href="#에이전트-타입-21">에이전트 타입</a> ·
+  <a href="#보안">보안</a>
+</p>
+
+---
+
 ## v5의 새로운 기능
 
 **triflux v5**는 v4의 오케스트레이션 기반을 유지하면서 파이프라인을 더 똑똑하고, 더 phase-aware하게, 더 협업적으로 발전시켰습니다. 멀티태스크 오케스트레이션에서는 이제 `--thorough`가 기본 경로이므로, 계획, 승인, 검증, 복구가 기본값으로 활성화됩니다.
@@ -57,50 +57,50 @@
 - **위임(Delegator) MCP** — 에이전트와 유연하게 상호작용할 수 있는 전용 MCP 도구(`delegate`, `reply`, `status`).
 - **psmux / Windows 네이티브** — `tmux` (WSL)와 `psmux` (Windows Terminal 네이티브)를 모두 지원하는 하이브리드 세션 관리.
 - **QoS 대시보드** — AIMD 기반 동적 배치 사이징 및 실시간 상태 모니터링.
-- **21종 이상의 전문 에이전트** — `scientist-deep`부터 `spark_fast`까지, 작업에 최적화된 에이전트 라인업.
-
----
-
-## 아키텍처
-
-triflux는 **Hub-and-Spoke** 아키텍처를 사용합니다. 상주형 허브가 상태, 인증, 작업 라우팅을 총괄하며 고성능 네임드 파이프를 통해 통신합니다.
-
-```mermaid
-graph TD
-    User([사용자 / Claude Code]) <-->|슬래시 명령어| TFX_CLI[tfx CLI]
-    TFX_CLI <-->|Named Pipe / HTTP| HUB[triflux Hub 서버]
-    
-    subgraph "오케스트레이션 허브"
-        HUB <--> STORE[(SQLite 저장소)]
-        HUB <--> DASH[QoS 대시보드]
-        HUB <--> DELEGATOR[위임 서비스]
-    end
-    
-    DELEGATOR <-->|Spawn| CODEX[Codex CLI]
-    DELEGATOR <-->|Spawn| GEMINI[Gemini CLI]
-    DELEGATOR <-->|Native| CLAUDE[Claude Code]
-    
-    HUB -.->|MCP 브리지| External[외부 MCP 클라이언트]
-```
-
----
-
-## 빠른 시작
-
-### 1. 설치
-
-```bash
-npm install -g triflux
-```
-
-### 2. 설정 (필수)
-
-스크립트를 동기화하고 Claude Code에 스킬을 등록하며 HUD를 설정합니다.
-
-```bash
-tfx setup
-```
-
+- **21종 이상의 전문 에이전트** — `scientist-deep`부터 `spark_fast`까지, 작업에 최적화된 에이전트 라인업.
+
+---
+
+## 아키텍처
+
+triflux는 **Hub-and-Spoke** 아키텍처를 사용합니다. 상주형 허브가 상태, 인증, 작업 라우팅을 총괄하며 고성능 네임드 파이프를 통해 통신합니다.
+
+```mermaid
+graph TD
+    User([사용자 / Claude Code]) <-->|슬래시 명령어| TFX_CLI[tfx CLI]
+    TFX_CLI <-->|Named Pipe / HTTP| HUB[triflux Hub 서버]
+    
+    subgraph "오케스트레이션 허브"
+        HUB <--> STORE[(SQLite 저장소)]
+        HUB <--> DASH[QoS 대시보드]
+        HUB <--> DELEGATOR[위임 서비스]
+    end
+    
+    DELEGATOR <-->|Spawn| CODEX[Codex CLI]
+    DELEGATOR <-->|Spawn| GEMINI[Gemini CLI]
+    DELEGATOR <-->|Native| CLAUDE[Claude Code]
+    
+    HUB -.->|MCP 브리지| External[외부 MCP 클라이언트]
+```
+
+---
+
+## 빠른 시작
+
+### 1. 설치
+
+```bash
+npm install -g triflux
+```
+
+### 2. 설정 (필수)
+
+스크립트를 동기화하고 Claude Code에 스킬을 등록하며 HUD를 설정합니다.
+
+```bash
+tfx setup
+```
+
 ### 3. 사용 방법
 
 ```bash
@@ -134,65 +134,65 @@ v5 파이프라인은 복잡한 엔지니어링 작업에서 기본이 되는 th
 Phase-aware MCP 필터링으로 `plan`, `prd`, `verify`는 읽기 중심으로 제한되며, `prd` → `exec` 전이는 `pipeline_advance_gated`로 승인 대기를 걸 수 있습니다.
 
 ---
-
-## 위임(Delegator) MCP
-
-MCP 도구를 통해 허브와 직접 상호작용하세요.
-
-- **`delegate`**: 프롬프트를 특정 프로바이더로 라우팅하거나 허브에 판단을 맡깁니다. `sync`(동기) 및 `async`(비동기) 모드를 지원합니다.
-- **`reply`**: 실행 중인 에이전트와 대화를 이어갑니다 (현재 Gemini 직접 실행 모드 지원).
-- **`status`**: 비동기 백그라운드 작업의 진행 상황을 확인합니다.
-
----
-
-## 에이전트 타입 (21종+)
-
-| 에이전트 | CLI | 용도 |
-|---------|-----|------|
-| **executor** | Codex | 표준적인 코드 구현 및 리팩터링. |
-| **build-fixer** | Codex/Gemini | 빌드 및 타입 에러 즉시 수정. |
-| **architect** | Codex | 상위 레벨 시스템 설계 및 계획. |
-| **scientist-deep** | Codex | 철저한 조사 및 심층 분석. |
-| **code-reviewer** | Codex | 보안 및 로직 중심의 코드 리뷰. |
-| **security-reviewer**| Codex | 취약점 및 권한 설정 감사. |
-| **quality-reviewer** | Codex | 로직 결함 및 유지보수성 감사. |
-| **designer** | Gemini | UI/UX 및 문서 디자인. |
-| **writer** | Gemini | 기술 문서 작성 및 설명. |
-| **spark** | Gemini | 가벼운 프로토타이핑 및 빠른 처리. |
-| **verifier** | Claude | 최종 검증 및 유효성 확인. |
-| **test-engineer** | Claude | 포괄적인 테스트 스위트 생성. |
-| *...기타* | | `debugger`, `planner`, `critic`, `analyst`, `scientist`, `explore`, `qa-tester` |
-
----
-
+
+## 위임(Delegator) MCP
+
+MCP 도구를 통해 허브와 직접 상호작용하세요.
+
+- **`delegate`**: 프롬프트를 특정 프로바이더로 라우팅하거나 허브에 판단을 맡깁니다. `sync`(동기) 및 `async`(비동기) 모드를 지원합니다.
+- **`reply`**: 실행 중인 에이전트와 대화를 이어갑니다 (현재 Gemini 직접 실행 모드 지원).
+- **`status`**: 비동기 백그라운드 작업의 진행 상황을 확인합니다.
+
+---
+
+## 에이전트 타입 (21종+)
+
+| 에이전트 | CLI | 용도 |
+|---------|-----|------|
+| **executor** | Codex | 표준적인 코드 구현 및 리팩터링. |
+| **build-fixer** | Codex/Gemini | 빌드 및 타입 에러 즉시 수정. |
+| **architect** | Codex | 상위 레벨 시스템 설계 및 계획. |
+| **scientist-deep** | Codex | 철저한 조사 및 심층 분석. |
+| **code-reviewer** | Codex | 보안 및 로직 중심의 코드 리뷰. |
+| **security-reviewer**| Codex | 취약점 및 권한 설정 감사. |
+| **quality-reviewer** | Codex | 로직 결함 및 유지보수성 감사. |
+| **designer** | Gemini | UI/UX 및 문서 디자인. |
+| **writer** | Gemini | 기술 문서 작성 및 설명. |
+| **spark** | Gemini | 가벼운 프로토타이핑 및 빠른 처리. |
+| **verifier** | Claude | 최종 검증 및 유효성 확인. |
+| **test-engineer** | Claude | 포괄적인 테스트 스위트 생성. |
+| *...기타* | | `debugger`, `planner`, `critic`, `analyst`, `scientist`, `explore`, `qa-tester` |
+
+---
+
 ## 보안
 
 triflux v5는 안전한 전문 개발 환경을 위해 설계되었습니다.
-
-- **허브 토큰 인증** — `TFX_HUB_TOKEN`을 이용한 보안 IPC (Bearer 인증).
-- **Localhost 전용** — 허브가 기본적으로 `127.0.0.1`에만 바인딩되어 외부 접근을 차단합니다.
-- **CORS 잠금** — QoS 대시보드에 대한 엄격한 오리진(Origin) 체크.
-- **인젝션 방어** — `psmux` 및 `tmux` 실행 시 쉘 명령어 새니타이징(Sanitizing).
-
----
-
-## QoS 대시보드
-
-`http://localhost:27888/dashboard`에서 오케스트레이션 상태를 모니터링하세요.
-
-- **AIMD 배치 사이징** — 작업 성공률에 따라 병렬 작업 수(3 → 10)를 자동으로 조절합니다.
-- **토큰 절약량** — Codex/Gemini 라우팅을 통해 절약된 Claude 토큰을 실시간으로 추적합니다.
-- **할당량 추적** — Codex 및 Gemini의 속도 제한(Rate Limit)을 실시간으로 확인합니다.
-
----
-
-## 플랫폼 지원
-
-- **Linux / macOS**: 네이티브 `tmux` 통합 지원.
-- **Windows**: **psmux** (PowerShell Multiplexer)와 Windows Terminal을 활용한 네이티브 윈도우 환경 지원.
-
----
-
-<p align="center">
-  <sub>MIT License · Made with ❤️ by <a href="https://github.com/tellang">tellang</a></sub>
-</p>
+
+- **허브 토큰 인증** — `TFX_HUB_TOKEN`을 이용한 보안 IPC (Bearer 인증).
+- **Localhost 전용** — 허브가 기본적으로 `127.0.0.1`에만 바인딩되어 외부 접근을 차단합니다.
+- **CORS 잠금** — QoS 대시보드에 대한 엄격한 오리진(Origin) 체크.
+- **인젝션 방어** — `psmux` 및 `tmux` 실행 시 쉘 명령어 새니타이징(Sanitizing).
+
+---
+
+## QoS 대시보드
+
+`http://localhost:27888/dashboard`에서 오케스트레이션 상태를 모니터링하세요.
+
+- **AIMD 배치 사이징** — 작업 성공률에 따라 병렬 작업 수(3 → 10)를 자동으로 조절합니다.
+- **토큰 절약량** — Codex/Gemini 라우팅을 통해 절약된 Claude 토큰을 실시간으로 추적합니다.
+- **할당량 추적** — Codex 및 Gemini의 속도 제한(Rate Limit)을 실시간으로 확인합니다.
+
+---
+
+## 플랫폼 지원
+
+- **Linux / macOS**: 네이티브 `tmux` 통합 지원.
+- **Windows**: **psmux** (PowerShell Multiplexer)와 Windows Terminal을 활용한 네이티브 윈도우 환경 지원.
+
+---
+
+<p align="center">
+  <sub>MIT License · Made with ❤️ by <a href="https://github.com/tellang">tellang</a></sub>
+</p>

package/README.md

@@ -1,45 +1,45 @@
-[English](README.md) | [한국어](README.ko.md)
-
-<p align="center">
-  <picture>
-    <source media="(prefers-color-scheme: dark)" srcset="docs/assets/logo-dark.svg">
-    <source media="(prefers-color-scheme: light)" srcset="docs/assets/logo-light.svg">
-    <img alt="triflux" src="docs/assets/logo-dark.svg" width="200">
-  </picture>
-</p>
-
-<p align="center">
-  <strong>The Multi-Model Orchestration Hub for Claude Code</strong><br>
-  <em>Vanish Claude tokens. Route tasks to Codex and Gemini via high-performance Hub IPC.</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>
-  <a href="https://github.com/tellang/triflux/actions"><img src="https://img.shields.io/github/actions/workflow/status/tellang/triflux/ci.yml?style=flat-square&label=CI" alt="CI"></a>
-  <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>
-
-<p align="center">
-  <picture>
-    <source media="(prefers-color-scheme: dark)" srcset="docs/assets/demo-dark.gif">
-    <source media="(prefers-color-scheme: light)" srcset="docs/assets/demo-light.gif">
-    <img alt="triflux demo" src="docs/assets/demo-dark.gif" width="680">
-  </picture>
-</p>
-
-<p align="center">
-  <a href="#quick-start">Quick Start</a> ·
-  <a href="#architecture">Architecture</a> ·
-  <a href="#pipeline-thorough">Pipeline</a> ·
-  <a href="#delegator-mcp">Delegator MCP</a> ·
-  <a href="#agent-types">Agent Types</a> ·
-  <a href="#security">Security</a>
-</p>
-
----
-
+[English](README.md) | [한국어](README.ko.md)
+
+<p align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="docs/assets/logo-dark.svg">
+    <source media="(prefers-color-scheme: light)" srcset="docs/assets/logo-light.svg">
+    <img alt="triflux" src="docs/assets/logo-dark.svg" width="200">
+  </picture>
+</p>
+
+<p align="center">
+  <strong>The Multi-Model Orchestration Hub for Claude Code</strong><br>
+  <em>Vanish Claude tokens. Route tasks to Codex and Gemini via high-performance Hub IPC.</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>
+  <a href="https://github.com/tellang/triflux/actions"><img src="https://img.shields.io/github/actions/workflow/status/tellang/triflux/ci.yml?style=flat-square&label=CI" alt="CI"></a>
+  <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>
+
+<p align="center">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="docs/assets/demo-dark.gif">
+    <source media="(prefers-color-scheme: light)" srcset="docs/assets/demo-light.gif">
+    <img alt="triflux demo" src="docs/assets/demo-dark.gif" width="680">
+  </picture>
+</p>
+
+<p align="center">
+  <a href="#quick-start">Quick Start</a> ·
+  <a href="#architecture">Architecture</a> ·
+  <a href="#pipeline-thorough">Pipeline</a> ·
+  <a href="#delegator-mcp">Delegator MCP</a> ·
+  <a href="#agent-types">Agent Types</a> ·
+  <a href="#security">Security</a>
+</p>
+
+---
+
 ## What's New in v5?
 
 **triflux v5** keeps the v4 orchestration foundation intact while making the pipeline smarter, more phase-aware, and more collaborative. For multi-task orchestration, `--thorough` is now the default path, so planning, approval, verification, and recovery stay on by default instead of being bolted on later.
@@ -57,50 +57,50 @@
 - **Delegator MCP** — Native MCP tools (`delegate`, `reply`, `status`) for seamless agent interaction.
 - **psmux / Windows Native** — Hybrid support for `tmux` (WSL) and `psmux` (Windows Terminal native).
 - **QoS Dashboard** — Real-time health monitoring with AIMD-based dynamic batch sizing.
-- **21+ specialized agents** — From `scientist-deep` to `spark_fast`, each optimized for specific tasks.
-
----
-
-## Architecture
-
-triflux uses a **Hub-and-Spoke** architecture. The resident Hub manages state, authentication, and task routing via high-performance Named Pipes.
-
-```mermaid
-graph TD
-    User([User / Claude Code]) <-->|Slash Commands| TFX_CLI[tfx CLI]
-    TFX_CLI <-->|Named Pipe / HTTP| HUB[triflux Hub Server]
-    
-    subgraph "Orchestration Hub"
-        HUB <--> STORE[(SQLite Store)]
-        HUB <--> DASH[QoS Dashboard]
-        HUB <--> DELEGATOR[Delegator Service]
-    end
-    
-    DELEGATOR <-->|Spawn| CODEX[Codex CLI]
-    DELEGATOR <-->|Spawn| GEMINI[Gemini CLI]
-    DELEGATOR <-->|Native| CLAUDE[Claude Code]
-    
-    HUB -.->|MCP Bridge| External[External MCP Clients]
-```
-
----
-
-## Quick Start
-
-### 1. Install
-
-```bash
-npm install -g triflux
-```
-
-### 2. Setup (Required)
-
-Synchronize scripts, register skills to Claude Code, and configure the HUD.
-
-```bash
-tfx setup
-```
-
+- **21+ specialized agents** — From `scientist-deep` to `spark_fast`, each optimized for specific tasks.
+
+---
+
+## Architecture
+
+triflux uses a **Hub-and-Spoke** architecture. The resident Hub manages state, authentication, and task routing via high-performance Named Pipes.
+
+```mermaid
+graph TD
+    User([User / Claude Code]) <-->|Slash Commands| TFX_CLI[tfx CLI]
+    TFX_CLI <-->|Named Pipe / HTTP| HUB[triflux Hub Server]
+    
+    subgraph "Orchestration Hub"
+        HUB <--> STORE[(SQLite Store)]
+        HUB <--> DASH[QoS Dashboard]
+        HUB <--> DELEGATOR[Delegator Service]
+    end
+    
+    DELEGATOR <-->|Spawn| CODEX[Codex CLI]
+    DELEGATOR <-->|Spawn| GEMINI[Gemini CLI]
+    DELEGATOR <-->|Native| CLAUDE[Claude Code]
+    
+    HUB -.->|MCP Bridge| External[External MCP Clients]
+```
+
+---
+
+## Quick Start
+
+### 1. Install
+
+```bash
+npm install -g triflux
+```
+
+### 2. Setup (Required)
+
+Synchronize scripts, register skills to Claude Code, and configure the HUD.
+
+```bash
+tfx setup
+```
+
 ### 3. Usage
 
 ```bash
@@ -134,65 +134,65 @@ The v5 pipeline is the default thorough execution loop for complex engineering w
 Phase-aware MCP filtering keeps `plan`, `prd`, and `verify` read-heavy, while the `prd` → `exec` handoff can be gated through `pipeline_advance_gated`.
 
 ---
-
-## Delegator MCP
-
-Interact with the Hub directly through MCP tools.
-
-- **`delegate`**: Route a prompt to a specific provider or let the Hub decide. Supports `sync` and `async` modes.
-- **`reply`**: Continue multi-turn conversations with a running agent (currently Gemini direct).
-- **`status`**: Check the progress of asynchronous background tasks.
-
----
-
-## Agent Types (21+)
-
-| Agent | CLI | Purpose |
-|-------|-----|---------|
-| **executor** | Codex | Standard implementation & refactoring. |
-| **build-fixer** | Codex/Gemini | Instant fixes for build/type errors. |
-| **architect** | Codex | High-level system design & planning. |
-| **scientist-deep** | Codex | Exhaustive research & deep analysis. |
-| **code-reviewer** | Codex | Security & Logic focused code review. |
-| **security-reviewer**| Codex | Vulnerability & Permission audit. |
-| **quality-reviewer** | Codex | Logic & Maintainability audit. |
-| **designer** | Gemini | UI/UX & documentation design. |
-| **writer** | Gemini | Technical writing & explanations. |
-| **spark** | Gemini | Lightweight, fast prototyping. |
-| **verifier** | Claude | Final verification & validation. |
-| **test-engineer** | Claude | Comprehensive test suite generation. |
-| *...and more* | | `debugger`, `planner`, `critic`, `analyst`, `scientist`, `explore`, `qa-tester` |
-
----
-
+
+## Delegator MCP
+
+Interact with the Hub directly through MCP tools.
+
+- **`delegate`**: Route a prompt to a specific provider or let the Hub decide. Supports `sync` and `async` modes.
+- **`reply`**: Continue multi-turn conversations with a running agent (currently Gemini direct).
+- **`status`**: Check the progress of asynchronous background tasks.
+
+---
+
+## Agent Types (21+)
+
+| Agent | CLI | Purpose |
+|-------|-----|---------|
+| **executor** | Codex | Standard implementation & refactoring. |
+| **build-fixer** | Codex/Gemini | Instant fixes for build/type errors. |
+| **architect** | Codex | High-level system design & planning. |
+| **scientist-deep** | Codex | Exhaustive research & deep analysis. |
+| **code-reviewer** | Codex | Security & Logic focused code review. |
+| **security-reviewer**| Codex | Vulnerability & Permission audit. |
+| **quality-reviewer** | Codex | Logic & Maintainability audit. |
+| **designer** | Gemini | UI/UX & documentation design. |
+| **writer** | Gemini | Technical writing & explanations. |
+| **spark** | Gemini | Lightweight, fast prototyping. |
+| **verifier** | Claude | Final verification & validation. |
+| **test-engineer** | Claude | Comprehensive test suite generation. |
+| *...and more* | | `debugger`, `planner`, `critic`, `analyst`, `scientist`, `explore`, `qa-tester` |
+
+---
+
 ## Security
 
 triflux v5 is designed for secure, professional environments:
-
-- **Hub Token Auth** — Secure IPC using `TFX_HUB_TOKEN` (Bearer Auth).
-- **Localhost Only** — Default Hub binding to `127.0.0.1` prevents external access.
-- **CORS Lockdown** — Strict origin checking for the QoS Dashboard.
-- **Injection Protection** — Sanitized shell command execution in `psmux` and `tmux`.
-
----
-
-## QoS Dashboard
-
-Monitor your orchestration health at `http://localhost:27888/dashboard`.
-
-- **AIMD Batch Sizing** — Automatically scales parallel tasks (3 → 10) based on success rates.
-- **Token Savings** — Real-time tracking of Claude tokens saved by routing to Codex/Gemini.
-- **Rate Limit Tracking** — Live monitoring of Codex and Gemini quotas.
-
----
-
-## Platform Support
-
-- **Linux / macOS**: Native `tmux` integration.
-- **Windows**: **psmux** (PowerShell Multiplexer) + Windows Terminal hybrid for a native Windows experience.
-
----
-
-<p align="center">
-  <sub>MIT License · Made with ❤️ by <a href="https://github.com/tellang">tellang</a></sub>
-</p>
+
+- **Hub Token Auth** — Secure IPC using `TFX_HUB_TOKEN` (Bearer Auth).
+- **Localhost Only** — Default Hub binding to `127.0.0.1` prevents external access.
+- **CORS Lockdown** — Strict origin checking for the QoS Dashboard.
+- **Injection Protection** — Sanitized shell command execution in `psmux` and `tmux`.
+
+---
+
+## QoS Dashboard
+
+Monitor your orchestration health at `http://localhost:27888/dashboard`.
+
+- **AIMD Batch Sizing** — Automatically scales parallel tasks (3 → 10) based on success rates.
+- **Token Savings** — Real-time tracking of Claude tokens saved by routing to Codex/Gemini.
+- **Rate Limit Tracking** — Live monitoring of Codex and Gemini quotas.
+
+---
+
+## Platform Support
+
+- **Linux / macOS**: Native `tmux` integration.
+- **Windows**: **psmux** (PowerShell Multiplexer) + Windows Terminal hybrid for a native Windows experience.
+
+---
+
+<p align="center">
+  <sub>MIT License · Made with ❤️ by <a href="https://github.com/tellang">tellang</a></sub>
+</p>