triflux 7.1.4 → 7.2.2

package/skills/tfx-hub/SKILL.md

@@ -1,136 +1,205 @@
----
-name: tfx-hub
-description: >
-  tfx-hub MCP 메시지 버스 관리. CLI 에이전트 간 실시간 통신 허브를 시작/중지/상태확인하고,
-  hub 도메인의 자유형 작업도 처리합니다.
-  Use when: hub, 허브, 메시지 버스, message bus, 브릿지, bridge, MCP 서버 관리, 에이전트 통신
-triggers:
-  - tfx-hub
-argument-hint: "<start|stop|status|자유형 작업 설명>"
----
-
-# tfx-hub — MCP 메시지 버스 관리 + 개방형 작업
-
-> CLI 에이전트(Codex/Gemini/Claude) 간 실시간 메시지 허브를 관리합니다.
-> **커맨드 매칭 + fallthrough**: start/stop/status에 매칭되면 즉시 실행,
-> 매칭 안 되면 **hub 도메인 컨텍스트를 활용한 범용 작업**으로 처리합니다.
-
-## 입력 해석 규칙
-
-```
-/tfx-hub start          → 커맨드 매칭 → 허브 시작
-/tfx-hub stop           → 커맨드 매칭 → 허브 중지
-/tfx-hub status         → 커맨드 매칭 → 상태 확인
-/tfx-hub 테스트해줘      → fallthrough → hub 관련 범용 작업으로 처리
-/tfx-hub 문서 저장해     → fallthrough → hub 관련 범용 작업으로 처리
-/tfx-hub 브릿지 분석해   → fallthrough → hub 관련 범용 작업으로 처리
-```
-
-**fallthrough 규칙**: 인자가 start/stop/status/--port 등 커맨드 키워드에 매칭되지 않으면,
-사용자의 입력을 **hub/브릿지/메시지버스 도메인의 자유형 작업**으로 해석한다.
-
-fallthrough 라우팅:
-```bash
-# tfx-route.sh 경유 (권장)
-Bash("bash ~/.claude/scripts/tfx-route.sh {에이전트} '{hub 컨텍스트 + 작업}' {mcp_profile}")
-
-# codex 직접 호출 시 — 반드시 exec 서브커맨드 포함
-Bash("codex exec --dangerously-bypass-approvals-and-sandbox --skip-git-repo-check '{작업}'")
-Bash("codex --profile xhigh exec --dangerously-bypass-approvals-and-sandbox --skip-git-repo-check '{작업}'")
-#          ↑ --profile은 exec 앞에, --skip-git-repo-check은 exec 뒤에
-
-# Claude 네이티브 (탐색/검증)
-Agent(subagent_type="oh-my-claudecode:explore", prompt="{작업}")
-```
-
-## 커맨드
-
-### 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` | 사용자 입력 응답 |
-
-## 브릿지 REST 엔드포인트 (4개)
-
-| 엔드포인트 | 설명 |
-|-----------|------|
-| `POST /bridge/register` | 에이전트 등록 (프로세스 수명 기반 lease) |
-| `POST /bridge/result` | 결과 발행 (topic fanout) |
-| `POST /bridge/context` | 선행 컨텍스트 폴링 (auto_ack) |
-| `POST /bridge/deregister` | 에이전트 offline 마킹 |
-
-## 프로젝트 구조
-
-```
-hub/
-├── server.mjs    # MCP 서버 + REST 브릿지 엔드포인트
-├── store.mjs     # SQLite WAL 상태 저장소
-├── router.mjs    # Actor mailbox 라우터 + QoS
-├── tools.mjs     # MCP 도구 8개 정의
-├── hitl.mjs      # Human-in-the-Loop 매니저
-├── bridge.mjs    # tfx-route.sh ↔ hub 브릿지 CLI
-└── schema.sql    # DB 스키마
-```
-
-## 상태
-
-**dev 전용** — 로컬 테스트 목적. 프로덕션 배포 전 안정화 필요.
+---
+name: tfx-hub
+description: >
+  tfx-hub MCP 메시지 버스 관리. CLI 에이전트 간 실시간 통신 허브를 시작/중지/상태확인하고,
+  hub 도메인의 자유형 작업도 처리합니다.
+  Use when: hub, 허브, 메시지 버스, message bus, 브릿지, bridge, MCP 서버 관리, 에이전트 통신
+triggers:
+  - tfx-hub
+argument-hint: "<start|stop|status|자유형 작업 설명>"
+---
+
+# tfx-hub — MCP 메시지 버스 관리 + 개방형 작업
+
+> CLI 에이전트(Codex/Gemini/Claude) 간 실시간 메시지 허브를 관리합니다.
+> **커맨드 매칭 + fallthrough**: start/stop/status에 매칭되면 즉시 실행,
+> 매칭 안 되면 **hub 도메인 컨텍스트를 활용한 범용 작업**으로 처리합니다.
+
+## 입력 해석 규칙
+
+```
+/tfx-hub start          → 커맨드 매칭 → 허브 시작
+/tfx-hub stop           → 커맨드 매칭 → 허브 중지
+/tfx-hub status         → 커맨드 매칭 → 상태 확인
+/tfx-hub 테스트해줘      → fallthrough → hub 관련 범용 작업으로 처리
+/tfx-hub 문서 저장해     → fallthrough → hub 관련 범용 작업으로 처리
+/tfx-hub 브릿지 분석해   → fallthrough → hub 관련 범용 작업으로 처리
+```
+
+**fallthrough 규칙**: 인자가 start/stop/status/--port 등 커맨드 키워드에 매칭되지 않으면,
+사용자의 입력을 **hub/브릿지/메시지버스 도메인의 자유형 작업**으로 해석한다.
+
+fallthrough 라우팅:
+```bash
+# tfx-route.sh 경유 (권장)
+Bash("bash ~/.claude/scripts/tfx-route.sh {에이전트} '{hub 컨텍스트 + 작업}' {mcp_profile}")
+
+# codex 직접 호출 시 — 반드시 exec 서브커맨드 포함
+Bash("codex exec --dangerously-bypass-approvals-and-sandbox --skip-git-repo-check '{작업}'")
+Bash("codex --profile xhigh exec --dangerously-bypass-approvals-and-sandbox --skip-git-repo-check '{작업}'")
+#          ↑ --profile은 exec 앞에, --skip-git-repo-check은 exec 뒤에
+
+# Claude 네이티브 (탐색/검증)
+Agent(subagent_type="oh-my-claudecode:explore", prompt="{작업}")
+```
+
+## 커맨드
+
+### 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 도구 (20개)
+
+### Core — 기본 통신
+
+| 도구 | 설명 |
+|------|------|
+| `register` | 에이전트 등록 + lease 발급 |
+| `status` | 허브/에이전트/큐/트레이스 상태 조회 |
+| `publish` | 이벤트/응답 메시지 발행 (topic fanout 지원) |
+| `ask` | 다른 에이전트에게 질문 (request/reply, await_response_ms 폴링 지원) |
+| `handoff` | 작업 인계 (acceptance_criteria 지정 가능) |
+| `poll_messages` | 수신함에서 메시지 폴링 **(Deprecated — Named Pipe 사용)** |
+
+### Assign — 비차단 작업 할당
+
+| 도구 | 설명 |
+|------|------|
+| `assign_async` | AWS CAO 스타일 비차단 job 생성 + 워커 실시간 전달 |
+| `assign_result` | job 진행/완료 결과 보고 |
+| `assign_status` | job 단건 상태 또는 목록 조회 |
+
+### Team — Claude Native Teams 프록시
+
+| 도구 | 설명 |
+|------|------|
+| `team_info` | Teams 메타/멤버/경로 정보 조회 |
+| `team_task_list` | task 목록 조회 (owner/status 필터) |
+| `team_task_update` | task claim/update |
+| `team_send_message` | Teams inbox에 메시지 append |
+
+### Pipeline — 파이프라인 관리
+
+| 도구 | 설명 |
+|------|------|
+| `pipeline_init` | 새 파이프라인 초기화 |
+| `pipeline_state` | 파이프라인 상태 조회 |
+| `pipeline_advance` | 다음 단계로 전이 (전이 규칙 + fix loop 바운딩) |
+| `pipeline_advance_gated` | HITL 승인 게이트 포함 전이 |
+| `pipeline_list` | 활성 파이프라인 목록 조회 |
+
+### HITL — Human-in-the-Loop
+
+| 도구 | 설명 |
+|------|------|
+| `request_human_input` | 사용자 입력 요청 (CAPTCHA/승인/자격증명/선택/텍스트) |
+| `submit_human_input` | 사용자 입력 응답 (accept/decline/cancel) |
+
+## 브릿지 REST 엔드포인트 (4개)
+
+| 엔드포인트 | 설명 |
+|-----------|------|
+| `POST /bridge/register` | 에이전트 등록 (프로세스 수명 기반 lease) |
+| `POST /bridge/result` | 결과 발행 (topic fanout) |
+| `POST /bridge/context` | 선행 컨텍스트 폴링 (auto_ack) |
+| `POST /bridge/deregister` | 에이전트 offline 마킹 |
+
+## 프로젝트 구조
+
+```
+hub/
+├── server.mjs            # MCP 서버 + REST 브릿지 엔드포인트
+├── store.mjs             # SQLite WAL 상태 저장소
+├── router.mjs            # Actor mailbox 라우터 + QoS
+├── tools.mjs             # MCP 도구 20개 정의
+├── hitl.mjs              # Human-in-the-Loop 매니저
+├── bridge.mjs            # tfx-route.sh ↔ hub 브릿지 CLI
+├── schema.sql            # DB 스키마
+├── paths.mjs             # 경로 상수 (PID 파일, DB 경로 등)
+├── pipe.mjs              # Named Pipe 서버 (push 구독 채널)
+├── assign-callbacks.mjs  # assign job 콜백 처리
+├── intent.mjs            # 인텐트 파싱
+├── reflexion.mjs         # reflexion 루프
+├── research.mjs          # 리서치 프록시
+├── token-mode.mjs        # 토큰 모드 관리
+├── pipeline/             # 파이프라인 엔진
+│   ├── index.mjs         # createPipeline() 팩토리
+│   ├── state.mjs         # 파이프라인 상태 CRUD
+│   ├── transitions.mjs   # 전이 규칙
+│   └── gates/            # HITL 게이트 (selfcheck, confidence)
+├── delegator/            # 작업 위임 레이어
+│   ├── index.mjs
+│   ├── service.mjs
+│   ├── contracts.mjs
+│   └── tool-definitions.mjs
+├── team/                 # Claude Native Teams 통합
+│   ├── nativeProxy.mjs   # Teams MCP 프록시
+│   ├── orchestrator.mjs  # 팀 오케스트레이터
+│   ├── session.mjs       # 세션 관리
+│   ├── dashboard.mjs     # TUI 대시보드
+│   ├── tui.mjs           # TUI 렌더러
+│   └── cli/              # tfx team CLI 커맨드
+├── workers/              # CLI 워커 어댑터
+│   ├── factory.mjs
+│   ├── claude-worker.mjs
+│   ├── codex-mcp.mjs
+│   ├── gemini-worker.mjs
+│   └── delegator-mcp.mjs
+├── middleware/           # 요청 미들웨어
+│   └── request-logger.mjs
+├── quality/              # 품질 검사
+│   └── deslop.mjs
+└── public/               # 정적 자산 (대시보드 HTML, 트레이 아이콘)
+```
+
+## 상태
+
+**dev 전용** — 로컬 테스트 목적. 프로덕션 배포 전 안정화 필요.

package/skills/tfx-multi/SKILL.md

@@ -83,13 +83,13 @@ preflight와 Agent 생성을 병렬로 실행하여 사용자 체감 지연을
 **실행 명령 (Lead가 호출하는 유일한 명령):**
 
 ```
-Bash("tfx multi --teammate-mode headless --auto-attach --assign 'codex:{프롬프트1}:{역할1}' --assign 'gemini:{프롬프트2}:{역할2}' --timeout 600")
+Bash("tfx multi --teammate-mode headless --auto-attach --dashboard --assign 'codex:{프롬프트1}:{역할1}' --assign 'gemini:{프롬프트2}:{역할2}' --timeout 600")
 ```
 
 **예시:**
 
 ```
-Bash("tfx multi --teammate-mode headless --auto-attach --assign 'codex:코드 리뷰하고 개선 사항 제안:reviewer' --assign 'gemini:API 문서 작성:writer' --assign 'codex:보안 취약점 분석:security' --timeout 600")
+Bash("tfx multi --teammate-mode headless --auto-attach --dashboard --assign 'codex:코드 리뷰하고 개선 사항 제안:reviewer' --assign 'gemini:API 문서 작성:writer' --assign 'codex:보안 취약점 분석:security' --timeout 600")
 ```
 
 **Claude 워커가 Read/Edit 필요한 경우 (하이브리드):**
@@ -98,7 +98,7 @@ Claude 워커는 headless에서 실행 불가 (Read/Edit 도구 필요). CLI 워
 
 ```
 # 1. CLI 워커를 headless로 dispatch
-Bash("tfx multi --teammate-mode headless --auto-attach --assign 'codex:{프롬프트}:{역할}' --assign 'gemini:{프롬프트}:{역할}' --timeout 600")
+Bash("tfx multi --teammate-mode headless --auto-attach --dashboard --assign 'codex:{프롬프트}:{역할}' --assign 'gemini:{프롬프트}:{역할}' --timeout 600")
 
 # 2. Claude 워커를 Agent로 병렬 실행 (headless Bash와 동시에 spawn)
 Agent(subagent_type="...", prompt="...", run_in_background=true)
@@ -107,9 +107,9 @@ Agent(subagent_type="...", prompt="...", run_in_background=true)
 **결정 로직:**
 ```
 if 모든 워커가 CLI (codex/gemini):
-  → Bash("tfx multi --teammate-mode headless --auto-attach --assign ...")
+  → Bash("tfx multi --teammate-mode headless --auto-attach --dashboard --assign ...")
 elif CLI + Claude 혼합:
-  → CLI 워커: Bash("tfx multi --teammate-mode headless --assign ...")
+  → CLI 워커: Bash("tfx multi --teammate-mode headless --auto-attach --dashboard --assign ...")
   → Claude 워커: Agent(subagent_type, run_in_background=true)
 elif psmux 미설치:
   → Phase 3-fallback (아래)
@@ -118,7 +118,9 @@ elif psmux 미설치:
 **headless 엔진이 자동으로 수행하는 것:**
 - psmux 세션 생성 + progressive split-window
 - Windows Terminal 자동 팝업 (autoAttach)
+- `--dashboard` TUI 대시보드 자동 표시 (headless-guard가 기본 주입)
 - triflux 테마 적용 (Catppuccin Mocha status bar)
+- 워커 요약 dashboard 스플릿
 - CLI 명령 dispatch + 완료 토큰 폴링
 - 결과 수집 + JSON stdout 출력
 - 세션 정리
@@ -137,6 +139,10 @@ headless stdout 출력에서 성공/실패 워커를 파싱.
 psmux가 없는 환경에서만 사용. Agent slim wrapper로 CLI를 실행.
 `hub/team/native.mjs`의 `buildSlimWrapperPrompt()` 기반.
 
+**팀 이름 생성 (`generateTeamName`):**
+`tfx-${Date.now().toString(36).slice(-4)}${Math.random().toString(36).slice(2, 6)}`
+타임스탬프 base36 끝 4자 + 난수 4자 조합. 예: `tfx-p1q2r3s4`.
+
 > 래퍼 규칙 상세 → [`references/agent-wrapper-rules.md`](references/agent-wrapper-rules.md)
 
 ## 전제 조건

package/.mcp.json

@@ -1,8 +0,0 @@
-{
-  "mcpServers": {
-    "tfx-hub": {
-      "type": "url",
-      "url": "http://127.0.0.1:27888/mcp"
-    }
-  }
-}