triflux 5.0.0 → 5.0.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.ko.md +53 -43
- package/README.md +53 -43
- package/package.json +3 -2
package/README.ko.md
CHANGED
|
@@ -40,17 +40,23 @@
|
|
|
40
40
|
|
|
41
41
|
---
|
|
42
42
|
|
|
43
|
-
##
|
|
44
|
-
|
|
45
|
-
**triflux
|
|
46
|
-
|
|
47
|
-
### 주요 특징
|
|
48
|
-
|
|
49
|
-
-
|
|
50
|
-
-
|
|
51
|
-
-
|
|
52
|
-
-
|
|
53
|
-
- **
|
|
43
|
+
## v5의 새로운 기능
|
|
44
|
+
|
|
45
|
+
**triflux v5**는 v4의 오케스트레이션 기반을 유지하면서 파이프라인을 더 똑똑하고, 더 phase-aware하게, 더 협업적으로 발전시켰습니다. 멀티태스크 오케스트레이션에서는 이제 `--thorough`가 기본 경로이므로, 계획, 승인, 검증, 복구가 기본값으로 활성화됩니다.
|
|
46
|
+
|
|
47
|
+
### 주요 특징
|
|
48
|
+
|
|
49
|
+
- **`--thorough` 기본화** — 멀티태스크 오케스트레이션은 기본적으로 `plan` → `prd` → `exec` → `verify` → `fix` 전체 파이프라인을 실행합니다. 경량 경로가 필요할 때만 `--quick`을 명시합니다.
|
|
50
|
+
- **Opus × Codex Scout 계획 협업** — `plan` 단계에서 Opus가 설계를 주도하고 Codex scout 워커가 코드베이스를 병렬 탐색한 뒤 최종 계획에 반영합니다.
|
|
51
|
+
- **DAG 기반 라우팅 휴리스틱** — `dag_width`와 `complexity`를 함께 반영해 `quick_single`, `thorough_single`, `quick_team`, `thorough_team`, `batch_single` 전략 중 하나를 선택합니다.
|
|
52
|
+
- **피드백 루프 복원** — 워커는 여러 차례 재실행될 수 있고, 최종 완료 전 리드의 피드백을 다시 받아 반영할 수 있습니다.
|
|
53
|
+
- **HITL 승인 게이트** — `pipeline_advance_gated`를 통해 단계 전이 전에 사람 승인 체크포인트를 삽입합니다.
|
|
54
|
+
- **Phase-aware MCP 필터링** — 파이프라인 단계에 따라 MCP 노출을 조정해 `plan`, `prd`, `verify`는 읽기 중심으로 유지하고 `exec`는 더 넓은 도구 세트를 사용합니다.
|
|
55
|
+
- **Plan 파일 영속화** — 최종 계획 Markdown을 `.tfx/plans/{team}-plan.md`에 저장하고 파이프라인 artifact로 추적합니다.
|
|
56
|
+
- **Hub IPC 아키텍처** — Named Pipe 및 HTTP MCP 브리지를 활용한 초고속 상주형 허브 서버.
|
|
57
|
+
- **위임(Delegator) MCP** — 에이전트와 유연하게 상호작용할 수 있는 전용 MCP 도구(`delegate`, `reply`, `status`).
|
|
58
|
+
- **psmux / Windows 네이티브** — `tmux` (WSL)와 `psmux` (Windows Terminal 네이티브)를 모두 지원하는 하이브리드 세션 관리.
|
|
59
|
+
- **QoS 대시보드** — AIMD 기반 동적 배치 사이징 및 실시간 상태 모니터링.
|
|
54
60
|
- **21종 이상의 전문 에이전트** — `scientist-deep`부터 `spark_fast`까지, 작업에 최적화된 에이전트 라인업.
|
|
55
61
|
|
|
56
62
|
---
|
|
@@ -95,35 +101,39 @@ npm install -g triflux
|
|
|
95
101
|
tfx setup
|
|
96
102
|
```
|
|
97
103
|
|
|
98
|
-
### 3. 사용 방법
|
|
99
|
-
|
|
100
|
-
```bash
|
|
101
|
-
# 자동 모드 — 허브를 통한
|
|
102
|
-
/tfx-auto "인증 리팩터링 + UI 업데이트 + 테스트 추가"
|
|
103
|
-
|
|
104
|
-
#
|
|
105
|
-
/tfx-auto --
|
|
106
|
-
|
|
107
|
-
# 직접 위임
|
|
108
|
-
/tfx-delegate "최신 React 패턴 조사" --provider gemini
|
|
109
|
-
```
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
|
120
|
-
|
|
121
|
-
| **
|
|
122
|
-
| **
|
|
123
|
-
| **
|
|
124
|
-
| **
|
|
125
|
-
|
|
126
|
-
|
|
104
|
+
### 3. 사용 방법
|
|
105
|
+
|
|
106
|
+
```bash
|
|
107
|
+
# 자동 모드 — 허브를 통한 thorough 멀티태스크 오케스트레이션
|
|
108
|
+
/tfx-auto "인증 리팩터링 + UI 업데이트 + 테스트 추가"
|
|
109
|
+
|
|
110
|
+
# quick 모드 — 전체 계획/검증 루프 생략
|
|
111
|
+
/tfx-auto --quick "작은 회귀 버그 수정"
|
|
112
|
+
|
|
113
|
+
# 직접 위임
|
|
114
|
+
/tfx-delegate "최신 React 패턴 조사" --provider gemini
|
|
115
|
+
```
|
|
116
|
+
|
|
117
|
+
v5에서는 멀티태스크 오케스트레이션이 기본적으로 `--thorough`로 실행되며, 더 가벼운 경로가 필요할 때 `--quick`을 사용합니다.
|
|
118
|
+
|
|
119
|
+
---
|
|
120
|
+
|
|
121
|
+
## 파이프라인: `--thorough` 모드
|
|
122
|
+
|
|
123
|
+
v5 파이프라인은 복잡한 엔지니어링 작업에서 기본이 되는 thorough 실행 루프입니다. Plan 산출물은 영속화되고, PRD 핸드오프에는 사람 승인 게이트를 둘 수 있으며, verify/fix 단계는 워커 피드백 루프를 복원합니다.
|
|
124
|
+
|
|
125
|
+
| 단계 | 설명 |
|
|
126
|
+
|------|------|
|
|
127
|
+
| **plan** | Opus가 설계를 주도하고 Codex scout가 병렬 탐색을 수행하며, 계획 산출물을 파일로 영속화합니다. |
|
|
128
|
+
| **prd** | 상세한 기술 명세서(Technical Spec / PRD)를 생성하고 승인 체크포인트를 준비합니다. |
|
|
129
|
+
| **exec** | 실제 코드 구현을 수행합니다. |
|
|
130
|
+
| **verify** | 테스트를 실행하고 구현 결과가 PRD와 일치하는지 검증합니다. |
|
|
131
|
+
| **fix** | (루프) 검증 단계에서 발견된 실패를 리드 피드백과 함께 재실행하여 수정합니다 (최대 3회). |
|
|
132
|
+
| **ralph** | (재시작) 수정 루프 실패 시, 새로운 통찰을 바탕으로 `plan`부터 다시 시작합니다 (최대 10회). |
|
|
133
|
+
|
|
134
|
+
Phase-aware MCP 필터링으로 `plan`, `prd`, `verify`는 읽기 중심으로 제한되며, `prd` → `exec` 전이는 `pipeline_advance_gated`로 승인 대기를 걸 수 있습니다.
|
|
135
|
+
|
|
136
|
+
---
|
|
127
137
|
|
|
128
138
|
## 위임(Delegator) MCP
|
|
129
139
|
|
|
@@ -155,9 +165,9 @@ MCP 도구를 통해 허브와 직접 상호작용하세요.
|
|
|
155
165
|
|
|
156
166
|
---
|
|
157
167
|
|
|
158
|
-
## 보안
|
|
159
|
-
|
|
160
|
-
triflux
|
|
168
|
+
## 보안
|
|
169
|
+
|
|
170
|
+
triflux v5는 안전한 전문 개발 환경을 위해 설계되었습니다.
|
|
161
171
|
|
|
162
172
|
- **허브 토큰 인증** — `TFX_HUB_TOKEN`을 이용한 보안 IPC (Bearer 인증).
|
|
163
173
|
- **Localhost 전용** — 허브가 기본적으로 `127.0.0.1`에만 바인딩되어 외부 접근을 차단합니다.
|
package/README.md
CHANGED
|
@@ -40,17 +40,23 @@
|
|
|
40
40
|
|
|
41
41
|
---
|
|
42
42
|
|
|
43
|
-
## What's New in
|
|
44
|
-
|
|
45
|
-
**triflux
|
|
46
|
-
|
|
47
|
-
### Key Features
|
|
48
|
-
|
|
49
|
-
-
|
|
50
|
-
- **
|
|
51
|
-
- **
|
|
52
|
-
- **
|
|
53
|
-
- **
|
|
43
|
+
## What's New in v5?
|
|
44
|
+
|
|
45
|
+
**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.
|
|
46
|
+
|
|
47
|
+
### Key Features
|
|
48
|
+
|
|
49
|
+
- **`--thorough` by Default** — Multi-task orchestration now defaults to the full `plan` → `prd` → `exec` → `verify` → `fix` pipeline. Reach for `--quick` only when you explicitly want the lighter path.
|
|
50
|
+
- **Opus × Codex Scout Planning** — In `plan`, Opus leads architecture decisions while Codex scout workers explore the codebase in parallel and feed findings back into the final plan.
|
|
51
|
+
- **DAG-based Routing Heuristics** — Routing now considers both `dag_width` and `complexity` to choose between `quick_single`, `thorough_single`, `quick_team`, `thorough_team`, and `batch_single`.
|
|
52
|
+
- **Restored Feedback Loop** — Workers can be re-run for multiple iterations and receive lead feedback before final completion.
|
|
53
|
+
- **HITL Approval Gate** — `pipeline_advance_gated` inserts a human approval checkpoint before gated phase transitions.
|
|
54
|
+
- **Phase-aware MCP Filtering** — MCP exposure changes by pipeline phase so `plan`, `prd`, and `verify` stay read-focused while `exec` keeps broader tooling.
|
|
55
|
+
- **Persistent Plan Files** — Final plan markdown is saved to `.tfx/plans/{team}-plan.md` and tracked as a pipeline artifact.
|
|
56
|
+
- **Hub IPC Architecture** — Lightning-fast resident Hub server with Named Pipe & HTTP MCP bridge.
|
|
57
|
+
- **Delegator MCP** — Native MCP tools (`delegate`, `reply`, `status`) for seamless agent interaction.
|
|
58
|
+
- **psmux / Windows Native** — Hybrid support for `tmux` (WSL) and `psmux` (Windows Terminal native).
|
|
59
|
+
- **QoS Dashboard** — Real-time health monitoring with AIMD-based dynamic batch sizing.
|
|
54
60
|
- **21+ specialized agents** — From `scientist-deep` to `spark_fast`, each optimized for specific tasks.
|
|
55
61
|
|
|
56
62
|
---
|
|
@@ -95,35 +101,39 @@ Synchronize scripts, register skills to Claude Code, and configure the HUD.
|
|
|
95
101
|
tfx setup
|
|
96
102
|
```
|
|
97
103
|
|
|
98
|
-
### 3. Usage
|
|
99
|
-
|
|
100
|
-
```bash
|
|
101
|
-
# Auto mode —
|
|
102
|
-
/tfx-auto "refactor auth + update UI + add tests"
|
|
103
|
-
|
|
104
|
-
#
|
|
105
|
-
/tfx-auto --
|
|
106
|
-
|
|
107
|
-
# Direct Delegation
|
|
108
|
-
/tfx-delegate "research latest React patterns" --provider gemini
|
|
109
|
-
```
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
|
120
|
-
|
|
121
|
-
| **
|
|
122
|
-
| **
|
|
123
|
-
| **
|
|
124
|
-
| **
|
|
125
|
-
|
|
126
|
-
|
|
104
|
+
### 3. Usage
|
|
105
|
+
|
|
106
|
+
```bash
|
|
107
|
+
# Auto mode — Thorough multi-task orchestration via Hub
|
|
108
|
+
/tfx-auto "refactor auth + update UI + add tests"
|
|
109
|
+
|
|
110
|
+
# Quick mode — Skip the full planning/verification loop
|
|
111
|
+
/tfx-auto --quick "fix a small regression"
|
|
112
|
+
|
|
113
|
+
# Direct Delegation
|
|
114
|
+
/tfx-delegate "research latest React patterns" --provider gemini
|
|
115
|
+
```
|
|
116
|
+
|
|
117
|
+
In v5, multi-task orchestration defaults to `--thorough`; use `--quick` when you explicitly want the lighter path.
|
|
118
|
+
|
|
119
|
+
---
|
|
120
|
+
|
|
121
|
+
## Pipeline: `--thorough` Mode
|
|
122
|
+
|
|
123
|
+
The v5 pipeline is the default thorough execution loop for complex engineering work. Plan artifacts are persisted, PRD handoff can be gated by human approval, and verify/fix restores the worker feedback loop.
|
|
124
|
+
|
|
125
|
+
| Phase | Description |
|
|
126
|
+
|-------|-------------|
|
|
127
|
+
| **plan** | Opus-led solution design with parallel Codex scout exploration and a persisted plan artifact. |
|
|
128
|
+
| **prd** | Generate a detailed Technical Specification / PRD and prepare the approval checkpoint. |
|
|
129
|
+
| **exec** | Perform the actual code implementation. |
|
|
130
|
+
| **verify** | Run tests and verify the implementation against the PRD. |
|
|
131
|
+
| **fix** | (Loop) Re-run workers with lead feedback to fix failures identified in the verify phase (Max 3). |
|
|
132
|
+
| **ralph** | (Reset) If the fix loop fails, restart from `plan` with new insights (Max 10). |
|
|
133
|
+
|
|
134
|
+
Phase-aware MCP filtering keeps `plan`, `prd`, and `verify` read-heavy, while the `prd` → `exec` handoff can be gated through `pipeline_advance_gated`.
|
|
135
|
+
|
|
136
|
+
---
|
|
127
137
|
|
|
128
138
|
## Delegator MCP
|
|
129
139
|
|
|
@@ -155,9 +165,9 @@ Interact with the Hub directly through MCP tools.
|
|
|
155
165
|
|
|
156
166
|
---
|
|
157
167
|
|
|
158
|
-
## Security
|
|
159
|
-
|
|
160
|
-
triflux
|
|
168
|
+
## Security
|
|
169
|
+
|
|
170
|
+
triflux v5 is designed for secure, professional environments:
|
|
161
171
|
|
|
162
172
|
- **Hub Token Auth** — Secure IPC using `TFX_HUB_TOKEN` (Bearer Auth).
|
|
163
173
|
- **Localhost Only** — Default Hub binding to `127.0.0.1` prevents external access.
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "triflux",
|
|
3
|
-
"version": "5.0.
|
|
3
|
+
"version": "5.0.2",
|
|
4
4
|
"description": "CLI-first multi-model orchestrator for Claude Code — route tasks to Codex, Gemini, and Claude",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"bin": {
|
|
@@ -49,7 +49,8 @@
|
|
|
49
49
|
"better-sqlite3": "^12.6.2",
|
|
50
50
|
"pino": "^10.3.1",
|
|
51
51
|
"pino-pretty": "^13.1.3",
|
|
52
|
-
"systray2": "^2.1.4"
|
|
52
|
+
"systray2": "^2.1.4",
|
|
53
|
+
"zod": "^4.0.0"
|
|
53
54
|
},
|
|
54
55
|
"keywords": [
|
|
55
56
|
"claude-code",
|