triflux 4.2.6 → 4.2.7

package/skills/tfx-workspace/skill-snapshot/tfx-auto/SKILL.md

@@ -1,217 +0,0 @@
----
-name: tfx-auto
-description: 통합 CLI 오케스트레이터. 커맨드 숏컷(단일) + 자동 분류/분해(병렬) + 수동 병렬. tfx-route.sh 기반.
-triggers:
-  - tfx-auto
-  - implement
-  - build
-  - research
-  - brainstorm
-  - design
-  - test
-  - analyze
-  - troubleshoot
-  - improve
-  - cleanup
-  - explain
-  - document
-  - pm
-  - reflect
-  - estimate
-  - spec-panel
-  - business-panel
-  - index-repo
-argument-hint: "<command|task> [args...]"
----
-
-# tfx-auto — 통합 CLI 오케스트레이터
-
-> **MANDATORY RULES**
->
-> 1. **실행**: CLI 에이전트는 반드시 `Bash("bash ~/.claude/scripts/tfx-route.sh ...")`. Claude 네이티브(explore/verifier/test-engineer/qa-tester)만 `Agent()`.
-> 2. **비용**: Codex 우선 → Gemini → Claude 최후 수단. `claude` 선택 전 "Codex로 가능한가?" 재확인.
-> 3. **DAG**: SEQUENTIAL/DAG이면 레벨 기반 순차 실행. `.omc/context/{sid}/` 생성, context_output 저장, 실패 시 후속 SKIP.
-> 4. **트리아지**: Codex `--full-auto` 분류 + Opus 인라인 분해. Agent 스폰 금지.
-
-## 모드
-
-| 입력 형식 | 모드 | 트리아지 |
-|-----------|------|----------|
-| `/implement JWT 추가` | 커맨드 숏컷 | 없음 (즉시 실행) |
-| `/tfx-auto "리팩터링 + UI"` | 자동 | Codex 분류 → Opus 분해 |
-| `/tfx-auto 3:codex "리뷰"` | 수동 | Opus 분해만 |
-
-## 커맨드 숏컷
-
-커맨드명 매칭 시 트리아지 없이 즉시 실행. 패턴: `Bash("bash ~/.claude/scripts/tfx-route.sh {에이전트} '{PROMPT}' {MCP}")`.
-
-### Codex 직행
-
-| 커맨드 | 에이전트 | MCP |
-|--------|---------|-----|
-| `implement` | executor | implement |
-| `build` | build-fixer | implement |
-| `research` | document-specialist | analyze |
-| `brainstorm` | analyst | analyze |
-| `design` | architect | analyze |
-| `troubleshoot` | debugger | implement |
-| `cleanup` | executor | implement |
-| `pm` | planner | analyze |
-
-### 2단계: `improve`
-
-1단계 `code-reviewer '{PROMPT}' review` → 사용자 승인 → 2단계 `executor '리뷰 반영: {요약}' implement`
-
-### 병렬
-
-| 커맨드 | 에이전트들 (병렬, run_in_background=true) | MCP |
-|--------|------------------------------------------|-----|
-| `analyze` | quality-reviewer + security-reviewer | review |
-| `spec-panel` | architect + analyst + critic | analyze |
-| `business-panel` | analyst + architect | analyze |
-
-### Gemini 직행
-
-| 커맨드 | 에이전트 | MCP |
-|--------|---------|-----|
-| `explain` | writer | docs |
-| `document` | writer | docs |
-
-### Claude 네이티브
-
-| 커맨드 | 실행 |
-|--------|------|
-| `test` | `Agent(subagent_type="oh-my-claudecode:test-engineer", model="sonnet")` |
-| `reflect` | `Agent(subagent_type="oh-my-claudecode:verifier", model="sonnet")` |
-
-### 복합
-
-| 커맨드 | 흐름 |
-|--------|------|
-| `estimate` | explore(haiku) → analyst(codex): 영향범위, 복잡도(S/M/L/XL), 리스크 |
-| `index-repo` | explore(haiku) × 2 → Write(PROJECT_INDEX.md). mode=quick/update/full |
-
-## 트리아지
-
-**자동 모드:**
-1. Codex 분류: `codex exec --full-auto --skip-git-repo-check` → JSON `{parts: [{description, agent: "codex|gemini|claude"}]}`
-2. Opus 인라인 분해: `{graph_type: "INDEPENDENT|SEQUENTIAL|DAG", subtasks: [{id, description, scope, agent, mcp_profile, depends_on, context_output, context_input}]}`
-3. 실패 시 Opus가 직접 분류+분해
-
-**수동 모드 (`N:agent_type`):** Codex 분류 건너뜀 → Opus가 N개 서브태스크 분해. N > 10 거부.
-
-## 멀티 태스크 라우팅 (트리아지 후)
-
-> **트리아지 결과 서브태스크가 2개 이상이면 tfx-multi Native Teams 모드로 자동 전환한다.**
-
-| 서브태스크 수 | 실행 경로 | 이유 |
-|--------------|----------|------|
-| 1개 | tfx-auto 직접 실행 (아래 "실행" 섹션) | 팀 오버헤드 불필요, 경량 fire-and-forget |
-| 2개+ | **tfx-multi Phase 3** (TeamCreate → TaskCreate → Agent 래퍼) | Shift+Down 네비게이션, 상태 추적, fallback |
-
-**전환 방법:** 트리아지 완료 후 서브태스크 배열을 그대로 tfx-multi Phase 3에 전달한다.
-tfx-multi의 Phase 2(트리아지)는 건너뛰고 Phase 3a(TeamCreate)부터 시작한다.
-
-```
-if subtasks.length >= 2:
-  → tfx-multi Phase 3 실행 (트리아지 결과 재사용)
-  → TeamCreate → TaskCreate × N → Agent 래퍼 spawn (Phase 3a~3c)
-  → Phase 4 결과 수집 → Phase 5 정리
-else:
-  → tfx-auto 직접 실행 (아래)
-```
-
-## 실행
-
-### CLI 에이전트 (Codex/Gemini)
-
-```bash
-# Level 0 / INDEPENDENT
-Bash("bash ~/.claude/scripts/tfx-route.sh {agent} '{prompt}' {mcp_profile}", run_in_background=true)
-
-# Level 1+ (컨텍스트 의존) — 4번째=timeout(빈값), 5번째=context_file
-Bash("bash ~/.claude/scripts/tfx-route.sh {agent} '{prompt}' {mcp_profile} '' .omc/context/{sid}/combined-{tid}.md", run_in_background=true)
-```
-
-### Claude 네이티브
-
-```
-Agent(subagent_type="oh-my-claudecode:{agent}", model="{model}", prompt="{prompt}", run_in_background=true)
-# 컨텍스트 있으면 prompt에 <prior_context>...</prior_context> 추가
-```
-
-### 에이전트 매핑
-
-| 입력 | CLI | MCP |
-|------|-----|-----|
-| codex / executor / debugger / deep-executor | Codex | implement |
-| architect / planner / critic / analyst | Codex (xhigh) | analyze |
-| scientist / document-specialist | Codex | analyze |
-| code-reviewer / security-reviewer / quality-reviewer | Codex (review) | review |
-| gemini / designer / writer | Gemini | docs |
-| claude / explore / verifier / test-engineer / qa-tester | Claude native | — |
-
-### MCP 프로필 자동 결정
-
-| 에이전트 | MCP |
-|----------|-----|
-| executor, build-fixer, debugger, deep-executor | implement |
-| architect, planner, critic, analyst, scientist, document-specialist | analyze |
-| code-reviewer, security-reviewer, quality-reviewer | review |
-| designer, writer | docs |
-
-### 결과 파싱
-
-여기서 `failed`는 `tfx-route.sh`/CLI 종료 결과를 뜻한다. Claude Code `TaskUpdate` 상태값이 아니다.
-
-| exit_code + status | 사용할 출력 |
-|--------------------|-----------|
-| 0 + success | `=== OUTPUT ===` 섹션 |
-| 124 + timeout | `=== PARTIAL OUTPUT ===` |
-| ≠0 + failed | STDERR → Claude fallback |
-
-OUTPUT 추출: `echo "$result" | sed -n '/^=== OUTPUT ===/,/^=== /{/^=== OUTPUT ===/d;/^=== /d;p}'`
-
-### 실패 처리
-
-1차 → `Agent(subagent_type="oh-my-claudecode:executor", model="sonnet")` fallback.
-2차 연속 실패 → 실패 보고 + 성공 결과만 종합.
-
-### 보고 형식
-
-```markdown
-## tfx-auto 완료
-**모드**: {auto|manual} | **그래프**: {type} | **레벨**: {N}
-| # | 서브태스크 | Agent | CLI | MCP | 레벨 | 상태 | 시간 |
-### 워커 {n}: {제목}
-(출력 요약)
-### Token Savings Report
-(node ~/.claude/scripts/token-snapshot.mjs report {session-id})
-```
-
-## 필수 조건
-
-- `~/.claude/scripts/tfx-route.sh` (필수)
-- codex: `npm install -g @openai/codex` | gemini: `npm install -g @google/gemini-cli`
-
-## 에러 레퍼런스
-
-| 에러 | 처리 |
-|------|------|
-| `tfx-route.sh: not found` | tfx-route.sh 생성 |
-| `codex/gemini: not found` | npm install -g |
-| timeout / failed (`tfx-route.sh` 결과) | stderr → Claude fallback |
-| N > 10 | 10 이하로 조정 |
-| 순환 의존 | 분해 재시도 |
-| 컨텍스트 > 32KB | 비례 절삭 |
-
-> Claude Code `TaskUpdate`를 사용할 때는 `status: "failed"`를 쓰지 않는다.
-> 실패 보고는 `status: "completed"` + `metadata.result: "failed"`로 표현한다.
-
-## Troubleshooting
-
-`/tfx-doctor` 진단 | `/tfx-doctor --fix` 자동 수정 | `/tfx-doctor --reset` 캐시 초기화
-
-## 상세 레퍼런스
-
-DAG 알고리즘, 컨텍스트 머지 규칙, 토큰 스냅샷, 보고서 상세 → [`docs/tfx-auto-internals.md`](../../docs/tfx-auto-internals.md)

package/skills/tfx-workspace/skill-snapshot/tfx-auto-codex/SKILL.md

@@ -1,77 +0,0 @@
----
-name: tfx-auto-codex
-description: Codex 리드형 tfx-auto. Claude 네이티브 역할을 Codex로 치환하고 Gemini 사용은 유지합니다.
-triggers:
-  - tfx-auto-codex
-argument-hint: "\"작업 설명\" | N:agent_type \"작업 설명\""
----
-
-# tfx-auto-codex — Codex 리드형 tfx-auto
-
-> 목적: 기존 `tfx-auto`의 오케스트레이션 패턴을 유지하면서
-> Claude 네이티브 역할(`explore`, `verifier`, `test-engineer`, `qa-tester`)을
-> Codex로 치환해 Codex/Gemini만으로 실행한다.
-
-## 핵심 원칙
-
-1. **Codex 라우팅 유지**
-   - 구현/분석/리뷰/디버깅/검증은 Codex 우선.
-2. **Gemini 유지**
-   - `designer`, `writer`는 Gemini 경로를 그대로 사용.
-3. **Claude 네이티브 제거**
-   - 실행 시 `TFX_NO_CLAUDE_NATIVE=1`로 강제.
-4. **고난도 설계는 xhigh**
-   - 설계/분해/비판 검토 성격의 작업은 `codex --profile xhigh` 기준으로 운용.
-
-## 사용법
-
-```bash
-/tfx-auto-codex "인증 리팩터링 + UI 개선 + 테스트 보강"
-/tfx-auto-codex 3:codex "src/api, src/auth, src/payment 병렬 리뷰"
-/tfx-auto-codex 2:gemini "온보딩 UI 카피 + 접근성 개선"
-```
-
-## 실행 규칙
-
-`tfx-auto` 워크플로우(입력 파싱 → 트리아지 → 분해 → DAG 실행 → 수집/보고)를 그대로 사용한다.
-
-단, **실행 명령은 아래 환경변수를 반드시 포함**한다:
-
-```bash
-TFX_NO_CLAUDE_NATIVE=1 bash ~/.claude/scripts/tfx-route.sh {agent} '{prompt}' {mcp_profile}
-```
-
-### 역할 치환 (자동)
-
-`TFX_NO_CLAUDE_NATIVE=1`일 때:
-
-- `explore` -> Codex `fast`
-- `verifier` -> Codex `thorough review`
-- `test-engineer` -> Codex `high`
-- `qa-tester` -> Codex `thorough review`
-
-## 트리아지 기준
-
-- `codex`: 코드 구현/수정/분석/리뷰/디버깅/테스트/검증/리서치
-- `gemini`: 문서/UI/디자인/멀티모달
-
-Claude 타입 반환은 기본적으로 허용하지 않는다.
-분류 결과에 `claude`가 포함되면 `codex`로 치환 후 분해를 진행한다.
-단, Codex CLI 미설치 환경에서는 실행 안전성을 위해 `claude-native` fallback이 유지될 수 있다.
-
-## 권장 프로필
-
-- 설계/계획/비판적 검토: `xhigh`
-- 일반 구현/수정: `high`
-- 리뷰: `thorough`
-- 빠른 탐색: `fast`
-
-## 의존성
-
-- `~/.claude/scripts/tfx-route.sh` 최신 동기화 상태
-- Codex CLI 설치
-- Gemini CLI 설치 (UI/문서 경로 사용 시)
-
-## Troubleshooting
-
-문제 발생 시 `/tfx-doctor` 실행. (`--fix` 자동 수정, `--reset` 캐시 초기화)

package/skills/tfx-workspace/skill-snapshot/tfx-codex/SKILL.md

@@ -1,65 +0,0 @@
----
-name: tfx-codex
-description: Codex-Only 오케스트레이터. tfx-auto 워크플로우를 Codex 전용으로 고정합니다.
-triggers:
-  - tfx-codex
-argument-hint: "\"작업 설명\" | N:codex \"작업 설명\""
----
-
-# tfx-codex — Codex-Only 오케스트레이터
-
-> Codex CLI만 사용하여 모든 외부 CLI 작업을 라우팅합니다.
-> Gemini CLI가 없는 환경에서 사용합니다.
-
-## 사용법
-
-```
-/tfx-codex "작업 설명"
-/tfx-codex N:codex "작업 설명"
-```
-
-## 동작 원리
-
-`tfx-auto`와 동일한 워크플로우를 사용하되, `TFX_CLI_MODE=codex` 환경변수를 설정하여
-모든 Gemini 에이전트(designer, writer)를 Codex로 리매핑합니다.
-
-### 에이전트 라우팅
-
-| 에이전트 | 원래 CLI | tfx-codex에서 |
-|----------|---------|-------------|
-| executor, build-fixer, debugger | Codex | Codex (변경 없음) |
-| architect, planner, critic, analyst | Codex | Codex (변경 없음) |
-| code-reviewer, security-reviewer | Codex | Codex (변경 없음) |
-| scientist, document-specialist | Codex | Codex (변경 없음) |
-| **designer** | ~~Gemini~~ | **Codex** (effort: high) — UI 코드 생성 |
-| **writer** | ~~Gemini~~ | **Codex Spark** (effort: spark_fast) — 경량 문서 |
-| explore | Claude Haiku | Claude Haiku (변경 없음) |
-| verifier, test-engineer | Claude Sonnet | Claude Sonnet (변경 없음) |
-
-## 실행 규칙
-
-**tfx-auto SKILL.md의 모든 Phase(1~6) 워크플로우를 그대로 따릅니다.**
-
-유일한 차이점:
-
-1. **Phase 3 CLI 실행 시** `TFX_CLI_MODE=codex`를 환경변수로 전달:
-   ```bash
-   TFX_CLI_MODE=codex bash ~/.claude/scripts/tfx-route.sh {agent} '{prompt}' {mcp_profile}
-   ```
-
-2. **Phase 2 트리아지에서** gemini 분류 결과를 codex로 강제 변환:
-   - Codex 분류가 `gemini`를 반환하면 → `codex`로 교체
-   - Opus 분해에서 designer/writer → Codex 에이전트 + implement/analyze MCP 프로필
-
-3. **MCP 프로필 조정**:
-   - designer: `implement` (코드 기반 UI 작업)
-   - writer: `analyze` (문서 기반 리서치+작성)
-
-## 필수 조건
-
-- [Codex CLI](https://github.com/openai/codex): `npm install -g @openai/codex`
-- Gemini CLI 불필요
-
-## Troubleshooting
-
-문제 발생 시 `/tfx-doctor` 실행. (`--fix` 자동 수정, `--reset` 캐시 초기화)

package/skills/tfx-workspace/skill-snapshot/tfx-doctor/SKILL.md

@@ -1,94 +0,0 @@
----
-name: tfx-doctor
-description: >
-  triflux 진단 및 수리 도구. CLI 미발견, HUD 미표시, 캐시 오류,
-  스킬 미설치 등 문제를 진단하고 자동 수정합니다.
-  Use when: not working, broken, error, 안 돼, 이상해, 에러, 캐시, reset
-triggers:
-  - tfx-doctor
-argument-hint: "[--fix|--reset]"
----
-
-# tfx-doctor — triflux 진단 및 수리
-
-> 뭔가 안 될 때, HUD가 이상할 때, CLI가 안 보일 때 실행하세요.
-
-## 사용법
-
-```
-/tfx-doctor            ← 진단만 (읽기 전용)
-/tfx-doctor --fix      ← 진단 + 자동 수정
-/tfx-doctor --reset    ← 캐시 전체 초기화
-```
-
-## 동작
-
-### 기본 모드 (`/tfx-doctor`)
-
-`triflux doctor`를 실행하여 다음을 진단합니다:
-
-- tfx-route.sh 설치 상태
-- HUD 설치 및 설정 상태
-- Codex/Gemini/Claude CLI 경로 (크로스 셸)
-- 스킬 설치 상태
-- 플러그인 등록 상태
-- MCP 인벤토리 캐시
-- CLI 이슈 트래커
-- 잔존 팀(orphan teams) 감지 (`~/.claude/teams/`)
-
-### 수정 모드 (`/tfx-doctor --fix`)
-
-진단 전에 자동 수정을 시도합니다:
-
-1. tfx-route.sh, HUD, 스킬 파일 재동기화
-2. 에러/손상된 캐시 파일 정리
-3. 수정 완료 후 전체 진단 실행 → 결과 보고
-
-### 초기화 모드 (`/tfx-doctor --reset`)
-
-HUD 캐시 및 모든 triflux 관련 캐시를 전체 삭제합니다:
-
-| 삭제 대상 | 설명 |
-|-----------|------|
-| claude-usage-cache.json | Claude 사용량 캐시 |
-| codex-rate-limits-cache.json | Codex 레이트 리밋 캐시 |
-| gemini-quota/session/rpm cache | Gemini 할당량/세션/RPM 캐시 |
-| sv-accumulator.json | 절약량 누적 캐시 |
-| mcp-inventory.json | MCP 서버 인벤토리 |
-| cli-issues.jsonl | CLI 이슈 로그 |
-| triflux-update-check.json | 업데이트 확인 캐시 |
-| .claude-refresh-lock | 리프레시 락 파일 |
-
-초기화 후 다음 세션에서 캐시가 새로 생성됩니다.
-
-## 실행 방법
-
-```bash
-# 진단만
-Bash("triflux doctor")
-
-# 진단 + 자동 수정
-Bash("triflux doctor --fix")
-
-# 캐시 전체 초기화
-Bash("triflux doctor --reset")
-```
-
-결과를 사용자에게 보고합니다.
-
-## 자동 제안 트리거
-
-사용자가 다음과 같이 말하면 이 스킬 실행을 고려하세요:
-
-- "HUD가 안 보여" / "HUD 이상해" / "상태줄이 안 나와"
-- "codex/gemini가 안 돼" / "CLI 안 됨"
-- "캐시 초기화" / "리셋" / "reset"
-- "triflux 안 돼" / "뭔가 안 돼" / "에러"
-
-## 에러 처리
-
-| 상황 | 처리 |
-|------|------|
-| 캐시 디렉토리 없음 | 정상 — 삭제할 파일 없음 보고 |
-| 파일 삭제 권한 없음 | 수동 삭제 안내 |
-| --fix 후에도 이슈 남음 | Codex/Gemini 설치는 수동 필요 안내 |

package/skills/tfx-workspace/skill-snapshot/tfx-gemini/SKILL.md

@@ -1,82 +0,0 @@
----
-name: tfx-gemini
-description: Gemini-Only 오케스트레이터. tfx-auto 워크플로우를 Gemini 전용으로 고정합니다.
-triggers:
-  - tfx-gemini
-argument-hint: "\"작업 설명\" | N:gemini \"작업 설명\""
----
-
-# tfx-gemini — Gemini-Only 오케스트레이터
-
-> Gemini CLI만 사용하여 모든 외부 CLI 작업을 라우팅합니다.
-> Codex CLI가 없는 환경에서 사용합니다.
-
-## 사용법
-
-```
-/tfx-gemini "작업 설명"
-/tfx-gemini N:gemini "작업 설명"
-```
-
-## 동작 원리
-
-`tfx-auto`와 동일한 워크플로우를 사용하되, `TFX_CLI_MODE=gemini` 환경변수를 설정하여
-모든 Codex 에이전트를 Gemini로 리매핑합니다.
-
-### 에이전트 라우팅
-
-| 에이전트 | 원래 CLI | tfx-gemini에서 |
-|----------|---------|--------------|
-| **executor, debugger, deep-executor** | ~~Codex~~ | **Gemini Pro** |
-| **build-fixer** | ~~Codex~~ | **Gemini Flash** |
-| **architect, planner, critic, analyst** | ~~Codex~~ | **Gemini Pro** |
-| **code-reviewer, security-reviewer, quality-reviewer** | ~~Codex~~ | **Gemini Pro** |
-| **scientist, scientist-deep** | ~~Codex~~ | **Gemini Pro/Flash** |
-| **document-specialist** | ~~Codex~~ | **Gemini Flash** |
-| designer | Gemini | Gemini (변경 없음) |
-| writer | Gemini | Gemini (변경 없음) |
-| explore | Claude Haiku | Claude Haiku (변경 없음) |
-| verifier, test-engineer | Claude Sonnet | Claude Sonnet (변경 없음) |
-
-### 모델 분기
-
-| 복잡도 | Gemini 모델 | 대상 에이전트 | 근거 |
-|--------|------------|-------------|------|
-| 높음 | `gemini-3.1-pro-preview` | executor, debugger, deep-executor | 구현/분석 깊이 필요 |
-| 높음 | `gemini-3.1-pro-preview` | architect, planner, critic, analyst | 설계 품질 |
-| 높음 | `gemini-3.1-pro-preview` | code-reviewer, security-reviewer, quality-reviewer | 리뷰 품질 |
-| 높음 | `gemini-3.1-pro-preview` | scientist-deep | 심층 리서치 |
-| 낮음 | `gemini-3-flash-preview` | build-fixer, spark | 빠른 수정/린트 |
-| 낮음 | `gemini-3-flash-preview` | scientist, document-specialist | 일반 검색+요약 |
-| 낮음 | `gemini-3-flash-preview` | writer | 문서/가이드 생성 |
-
-## 실행 규칙
-
-**tfx-auto SKILL.md의 모든 Phase(1~6) 워크플로우를 그대로 따릅니다.**
-
-유일한 차이점:
-
-1. **Phase 3 CLI 실행 시** `TFX_CLI_MODE=gemini`을 환경변수로 전달:
-   ```bash
-   TFX_CLI_MODE=gemini bash ~/.claude/scripts/tfx-route.sh {agent} '{prompt}' {mcp_profile}
-   ```
-
-2. **Phase 2 트리아지에서** codex 분류 결과를 gemini로 강제 변환:
-   - Codex 분류가 `codex`를 반환하면 → `gemini`로 교체
-   - Opus 분해에서 모든 Codex 에이전트 → Gemini 모델 매핑
-
-3. **Phase 2a Codex 분류 단계를 건너뜀**:
-   - Codex CLI가 없으므로 Opus가 직접 분류+분해 수행
-
-4. **Windows 안정화 자동 적용**:
-   - 모든 Gemini 워커에 `--timeout 60` + health check
-   - hang 감지 시 자동 재시도
-
-## 필수 조건
-
-- [Gemini CLI](https://github.com/google-gemini/gemini-cli): `npm install -g @google/gemini-cli`
-- Codex CLI 불필요
-
-## Troubleshooting
-
-문제 발생 시 `/tfx-doctor` 실행. (`--fix` 자동 수정, `--reset` 캐시 초기화)

package/skills/tfx-workspace/skill-snapshot/tfx-hub/SKILL.md

@@ -1,133 +0,0 @@
----
-name: tfx-hub
-description: tfx-hub 개방형 스킬 — 커맨드(start/stop/status) + 자유형 작업 모두 처리
-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 전용** — 로컬 테스트 목적. 프로덕션 배포 전 안정화 필요.