triflux 2.5.1 → 3.1.0-dev.1

package/skills/tfx-doctor/SKILL.md

@@ -27,7 +27,7 @@ argument-hint: "[--fix|--reset]"
 
 `triflux doctor`를 실행하여 다음을 진단합니다:
 
-- cli-route.sh 설치 상태
+- tfx-route.sh 설치 상태
 - HUD 설치 및 설정 상태
 - Codex/Gemini/Claude CLI 경로 (크로스 셸)
 - 스킬 설치 상태
@@ -39,7 +39,7 @@ argument-hint: "[--fix|--reset]"
 
 진단 전에 자동 수정을 시도합니다:
 
-1. cli-route.sh, HUD, 스킬 파일 재동기화
+1. tfx-route.sh, HUD, 스킬 파일 재동기화
 2. 에러/손상된 캐시 파일 정리
 3. 수정 완료 후 전체 진단 실행 → 결과 보고
 

package/skills/tfx-gemini/SKILL.md

@@ -58,7 +58,7 @@ argument-hint: "\"작업 설명\" | N:gemini \"작업 설명\""
 
 1. **Phase 3 CLI 실행 시** `TFX_CLI_MODE=gemini`을 환경변수로 전달:
    ```bash
-   TFX_CLI_MODE=gemini bash ~/.claude/scripts/cli-route.sh {agent} '{prompt}' {mcp_profile}
+   TFX_CLI_MODE=gemini bash ~/.claude/scripts/tfx-route.sh {agent} '{prompt}' {mcp_profile}
    ```
 
 2. **Phase 2 트리아지에서** codex 분류 결과를 gemini로 강제 변환:

package/skills/tfx-hub/SKILL.md

@@ -0,0 +1,83 @@
+# tfx-hub — MCP 메시지 버스 관리
+
+> CLI 에이전트(Codex/Gemini/Claude) 간 실시간 메시지 허브를 관리합니다.
+> **tfx-auto와 완전 독립** — 별도 스킬로 운영됩니다.
+
+## 사용법
+
+```
+/tfx-hub start               ← 허브 데몬 시작 (기본 포트 27888)
+/tfx-hub start --port 28000  ← 커스텀 포트
+/tfx-hub stop                ← 허브 중지
+/tfx-hub status              ← 상태/메트릭 확인
+```
+
+## 커맨드
+
+### start — 허브 시작
+
+```bash
+Bash("node hub/server.mjs", run_in_background=true)
+```
+
+- Streamable HTTP MCP 서버를 `http://127.0.0.1:27888/mcp` 에서 시작
+- SQLite WAL DB: `~/.claude/cache/tfx-hub/state.db`
+- PID 파일: `~/.claude/cache/tfx-hub/hub.pid`
+- 환경변수: `TFX_HUB_PORT` (포트), `TFX_HUB_DB` (DB 경로)
+
+### stop — 허브 중지
+
+```bash
+# PID 파일에서 프로세스 ID 읽어서 종료
+Bash("node -e \"
+  const fs = require('fs');
+  const path = require('path');
+  const pidFile = path.join(require('os').homedir(), '.claude/cache/tfx-hub/hub.pid');
+  if (fs.existsSync(pidFile)) {
+    const info = JSON.parse(fs.readFileSync(pidFile, 'utf8'));
+    process.kill(info.pid, 'SIGTERM');
+    console.log('tfx-hub 종료 (PID ' + info.pid + ')');
+  } else {
+    console.log('tfx-hub 미실행');
+  }
+\"")
+```
+
+### status — 상태 확인
+
+```bash
+# HTTP 상태 엔드포인트 조회
+Bash("curl -s http://127.0.0.1:27888/status 2>/dev/null || echo '{\"error\":\"hub 미실행\"}'")
+```
+
+## 각 CLI 등록 방법
+
+허브 시작 후 각 CLI에 MCP 서버로 등록:
+
+```bash
+# Codex
+codex mcp add tfx-hub --url http://127.0.0.1:27888/mcp
+
+# Gemini (settings.json)
+# mcpServers.tfx-hub.url = "http://127.0.0.1:27888/mcp"
+
+# Claude
+claude mcp add --transport http tfx-hub http://127.0.0.1:27888/mcp
+```
+
+## MCP 도구 (8개)
+
+| 도구 | 설명 |
+|------|------|
+| `register` | 에이전트 등록 + lease 발급 |
+| `status` | 허브/에이전트/큐 상태 조회 |
+| `publish` | 이벤트/응답 메시지 발행 |
+| `ask` | 다른 에이전트에게 질문 (request/reply) |
+| `poll_messages` | 수신함에서 메시지 폴링 |
+| `handoff` | 작업 인계 |
+| `request_human_input` | 사용자 입력 요청 (CAPTCHA/승인) |
+| `submit_human_input` | 사용자 입력 응답 |
+
+## 상태
+
+**dev 전용** — 로컬 테스트 목적. 프로덕션 배포 전 안정화 필요.

package/skills/tfx-setup/SKILL.md

@@ -74,7 +74,7 @@ Bash("triflux doctor")
 
 | 항목 | 상태 |
 |------|------|
-| cli-route.sh | ✅ v1.5 |
+| tfx-route.sh | ✅ v2.0 |
 | HUD (hud-qos-status.mjs) | ✅ v1.7 |
 | HUD 설정 (settings.json) | ✅ statusLine 등록됨 |
 | Codex CLI | ✅ / ⚠️ 미설치 (선택) |