triflux 8.2.3 → 8.3.0

package/skills/tfx-doctor/SKILL.md

@@ -1,94 +1,161 @@
----
-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 설치는 수동 필요 안내 |
+---
+name: tfx-doctor
+description: >
+  triflux 진단 및 수리 도구. AskUserQuestion 기반 인터랙티브 선택지로
+  CLI 미발견, HUD 미표시, 캐시 오류, 스킬 미설치 등을 진단하고 자동 수정합니다.
+  Use when: not working, broken, error, 안 돼, 이상해, 에러, 캐시, reset, doctor
+triggers:
+  - tfx-doctor
+argument-hint: "[--fix|--reset]"
+---
+
+# tfx-doctor — triflux 진단 및 수리
+
+> 뭔가 안 될 때, HUD가 이상할 때, CLI가 안 보일 때 실행하세요.
+
+## 워크플로우
+
+### Step 1: 모드 선택 (AskUserQuestion)
+
+인자 없이 호출된 경우 모드를 선택한다:
+
+```
+question: "어떤 진단 모드를 실행하시겠습니까?"
+header: "모드"
+options:
+  - label: "진단 (Diagnose)"
+    description: "읽기 전용 전체 검사 — 아무것도 수정하지 않음"
+  - label: "수정 (Fix)"
+    description: "파일 동기화 + 캐시 정리 후 진단 실행"
+  - label: "캐시 관리 (Cache)"
+    description: "캐시 파일별 상태 조회, 선택적 삭제"
+  - label: "전체 초기화 (Reset)"
+    description: "모든 캐시 삭제 + 재생성 (위험)"
+```
+
+`--fix`, `--reset` 인자가 있으면 바로 해당 모드로 실행.
+
+### Step 2: 모드별 실행
+
+#### 진단 모드
+
+```bash
+Bash("triflux doctor --json")
+```
+
+JSON 결과를 파싱하여 마크다운 테이블로 표시:
+
+```
+| 항목 | 상태 | 비고 |
+|------|------|------|
+| tfx-route.sh | ✅ | v2.0 |
+| HUD | ✅ | 설치됨 |
+| Codex CLI | ✅ | found |
+| Gemini CLI | ⚠ | 미설치 (선택) |
+| ...  | ... | ... |
+```
+
+이슈가 발견되면 AskUserQuestion:
+```
+question: "N개 이슈가 발견되었습니다. 자동 수정을 시도하시겠습니까?"
+header: "수정"
+options:
+  - label: "자동 수정 실행 (Recommended)"
+    description: "triflux doctor --fix 실행"
+  - label: "건너뛰기"
+    description: "수정 없이 결과만 확인"
+```
+
+#### 수정 모드
+
+```bash
+Bash("triflux doctor --fix")
+```
+
+결과를 보고한다.
+
+#### 캐시 관리
+
+`~/.claude/cache/` 디렉토리의 캐시 파일들을 Read/Glob으로 조회:
+
+| 캐시 파일 | 설명 |
+|-----------|------|
+| claude-usage-cache.json | Claude 사용량 |
+| codex-rate-limits-cache.json | Codex 레이트 리밋 |
+| gemini-quota-cache.json | Gemini 쿼터 |
+| sv-accumulator.json | 절약량 누적 |
+| mcp-inventory.json | MCP 서버 인벤토리 |
+| cli-issues.jsonl | CLI 이슈 로그 |
+| triflux-update-check.json | 업데이트 체크 |
+
+존재하는 캐시 파일 목록과 크기를 테이블로 표시 후 AskUserQuestion:
+
+```
+question: "어떻게 삭제하시겠습니까?"
+header: "삭제"
+options:
+  - label: "전체 삭제"
+    description: "모든 캐시 파일 삭제"
+  - label: "에러 캐시만 삭제"
+    description: "파싱 에러가 있는 파일만 삭제"
+  - label: "선택 삭제"
+    description: "파일 하나씩 선택하여 삭제"
+  - label: "취소"
+    description: "삭제하지 않음"
+```
+
+"선택 삭제" 시 각 파일에 대해 AskUserQuestion으로 삭제 여부 확인.
+
+#### 전체 초기화
+
+위험 확인:
+```
+question: "전체 캐시를 초기화하시겠습니까? 다음 세션에서 재생성됩니다."
+header: "확인"
+options:
+  - label: "초기화 실행"
+    description: "모든 캐시 삭제 + MCP/사용량 캐시 재생성"
+  - label: "취소"
+    description: "아무것도 하지 않음"
+```
+
+확인 시:
+```bash
+Bash("triflux doctor --reset")
+```
+
+### Step 3: 후속 조치
+
+실행 완료 후 AskUserQuestion:
+```
+question: "다른 작업을 하시겠습니까?"
+header: "계속"
+options:
+  - label: "다른 모드 실행"
+    description: "진단/수정/캐시/초기화 메뉴로 돌아감"
+  - label: "종료"
+    description: "doctor 종료"
+```
+
+## 진단 항목
+
+- tfx-route.sh 설치 상태
+- HUD 설치 및 설정 상태
+- Codex/Gemini/Claude CLI 경로 (크로스 셸)
+- Codex Profiles (필수 프로파일 존재 여부)
+- 스킬 설치 상태
+- 플러그인 등록 상태
+- MCP 인벤토리 캐시
+- 잔존 팀(orphan teams) 감지
+
+## 에러 처리
+
+| 상황 | 처리 |
+|------|------|
+| 캐시 디렉토리 없음 | 정상 — 삭제할 파일 없음 보고 |
+| 파일 삭제 권한 없음 | 수동 삭제 안내 |
+| --fix 후에도 이슈 남음 | Codex/Gemini 설치는 수동 필요 안내 |
+
+## standalone TUI
+
+터미널에서 직접 실행도 가능: `node tui/doctor.mjs` (arrow key 방식)

package/skills/tfx-hub/SKILL.md

@@ -36,7 +36,7 @@ Bash("bash ~/.claude/scripts/tfx-route.sh {에이전트} '{hub 컨텍스트 +
 
 # 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 '{작업}'")
+Bash("codex --profile gpt54_xhigh exec --dangerously-bypass-approvals-and-sandbox --skip-git-repo-check '{작업}'")
 #          ↑ --profile은 exec 앞에, --skip-git-repo-check은 exec 뒤에
 
 # Claude 네이티브 (탐색/검증)

package/skills/tfx-profile/SKILL.md

@@ -0,0 +1,149 @@
+---
+name: tfx-profile
+description: >
+  Codex CLI 프로파일/모델 관리 인터랙티브 UI. tfx-route가 사용하는
+  프로파일 목록 조회, 모델 변경, effort 조정, 추가/삭제를 AskUserQuestion 기반
+  인터랙티브 선택지로 수행합니다.
+  Use when: codex profile, codex model, 프로파일 변경, 모델 변경, effort 변경,
+  codex 설정, profile manager, 프로파일 관리, 어떤 모델, tfx profile
+triggers:
+  - tfx-profile
+argument-hint: "[--list]"
+---
+
+# codex-profile — Codex 프로파일 매니저
+
+> Codex CLI 프로파일의 모델/effort를 AskUserQuestion 선택지로 관리합니다.
+
+## 워크플로우
+
+### Step 1: config.toml 읽기 + 현재 상태 표시
+
+`~/.codex/config.toml`을 Read 도구로 읽고 프로파일 테이블을 마크다운으로 출력한다:
+
+```
+| 프로파일 | 모델 | Effort |
+|----------|------|--------|
+| fast | gpt-5.3-codex | low |
+| ...  | ...           | ...  |
+```
+
+기본 모델(top-level `model`)과 기본 effort도 함께 표시.
+
+### Step 2: 작업 선택 (AskUserQuestion)
+
+AskUserQuestion으로 메인 메뉴를 제시한다:
+
+```
+question: "어떤 작업을 하시겠습니까?"
+header: "작업"
+options:
+  - label: "프로파일 모델 변경"
+    description: "기존 프로파일의 모델/effort를 수정"
+  - label: "기본 모델 변경"
+    description: "top-level default 모델/effort 수정"
+  - label: "프로파일 추가"
+    description: "새 프로파일 생성"
+  - label: "프로파일 삭제"
+    description: "기존 프로파일 제거"
+```
+
+### Step 3: 선택에 따른 세부 플로우
+
+#### 프로파일 모델 변경
+
+1. AskUserQuestion으로 프로파일 선택 (현재 프로파일 목록에서 2-4개씩 나눠서, 또는 "Other"로 직접 입력)
+2. AskUserQuestion으로 모델 선택:
+   ```
+   question: "모델을 선택하세요"
+   header: "Model"
+   options:
+     - label: "gpt-5.4"
+       description: "최신 플래그십"
+     - label: "gpt-5.3-codex"
+       description: "코딩 특화 (Recommended)"
+     - label: "gpt-5.1-codex-mini"
+       description: "경량 Spark"
+     - label: "o3"
+       description: "추론 특화"
+   ```
+3. AskUserQuestion으로 effort 선택:
+   ```
+   question: "Reasoning Effort 레벨을 선택하세요"
+   header: "Effort"
+   options:
+     - label: "low"
+       description: "빠른 응답, 최소 추론"
+     - label: "medium"
+       description: "균형 잡힌 추론"
+     - label: "high"
+       description: "깊은 추론"
+     - label: "xhigh"
+       description: "최대 추론 (느림)"
+   ```
+4. 변경 diff를 preview로 보여주고 Edit 도구로 config.toml 수정
+
+#### 기본 모델 변경
+
+위와 동일한 모델/effort 선택 후 top-level `model`, `model_reasoning_effort` 수정.
+
+#### 프로파일 추가
+
+1. AskUserQuestion(Other)으로 프로파일 이름 입력
+2. 모델 선택 → effort 선택
+3. config.toml 끝에 새 `[profiles.name]` 섹션 추가
+
+#### 프로파일 삭제
+
+1. 프로파일 선택
+2. AskUserQuestion 확인: "정말 삭제하시겠습니까?"
+3. 해당 섹션 제거
+
+### Step 4: 결과 확인
+
+변경된 config.toml을 다시 읽어 업데이트된 테이블 표시.
+"계속하시겠습니까?" AskUserQuestion → 반복 또는 종료.
+
+## config.toml 수정 규칙
+
+- **백업 필수**: 수정 전 원본 내용을 기억해둘 것 (rollback 가능하도록)
+- **프로파일 섹션 형식**: `[profiles.name]\nmodel = "..."\nmodel_reasoning_effort = "..."`
+- **다른 섹션 건드리지 않기**: `[notice]`, `[features]`, `[mcp_servers.*]`, `[projects.*]` 등은 절대 수정 금지
+- **Edit 도구 사용**: old_string → new_string으로 정확한 섹션만 치환
+
+## 참조
+
+### 알려진 모델
+
+| 모델 | 용도 |
+|------|------|
+| gpt-5.4 | 최신 플래그십 |
+| gpt-5.3-codex | 코딩 특화 |
+| gpt-5.1-codex-mini | 경량 Spark |
+| o3 | 추론 특화 |
+| o4-mini | 추론 경량 |
+
+### Effort 레벨
+
+| 레벨 | 설명 |
+|------|------|
+| low | 빠른 응답, 최소 추론 |
+| medium | 균형 잡힌 추론 |
+| high | 깊은 추론 |
+| xhigh | 최대 추론 (느림) |
+
+### config.toml 경로
+
+`~/.codex/config.toml` (`$HOME/.codex/config.toml`)
+
+## 에러 처리
+
+| 상황 | 처리 |
+|------|------|
+| config.toml 미존재 | `/tfx-setup` 안내 |
+| 파싱 실패 | 백업 후 수동 수정 안내 |
+| 중복 프로파일명 | 이미 존재함 알림, 기존 편집으로 전환 |
+
+## standalone TUI
+
+터미널에서 직접 실행도 가능: `node tui/codex-profile.mjs` (arrow key 방식)

package/skills/tfx-setup/SKILL.md

@@ -1,101 +1,160 @@
----
-name: tfx-setup
-description: triflux 초기 설정 및 진단을 수행합니다.
-triggers:
-  - tfx-setup
-argument-hint: "[doctor]"
----
-
-# tfx-setup — triflux 초기 설정 및 진단
-
-> 설치 후 최초 1회 실행 권장. HUD 설정, CLI 확인, 전체 진단을 수행합니다.
-
-## 사용법
-
-```
-/tfx-setup
-/tfx-setup doctor    ← 진단만 실행
-```
-
-## 동작
-
-### 기본 모드 (`/tfx-setup`)
-
-1. **파일 동기화** — `triflux setup` 실행
-2. **HUD 설정** — `settings.json`에 statusLine 자동 등록
-3. **CLI 진단** — `triflux doctor` 실행
-4. **결과 보고** — 설정 상태 요약
-
-### 진단 모드 (`/tfx-setup doctor`)
-
-`triflux doctor`만 실행하고 결과를 보고합니다.
-
-## 실행 방법
-
-### Step 1: 파일 동기화
-
-```bash
-Bash("triflux setup")
-```
-
-### Step 2: HUD 설정 확인 및 적용
-
-`~/.claude/settings.json`을 읽어 `statusLine` 설정을 확인합니다.
-
-**statusLine이 없거나 hud-qos-status.mjs를 가리키지 않는 경우:**
-
-```javascript
-// settings.json에 추가할 statusLine 설정
-{
-  "statusLine": {
-    "type": "command",
-    "command": "\"<NODE_PATH>\" \"<HOME>/.claude/hud/hud-qos-status.mjs\""
-  }
-}
-```
-
-- `<NODE_PATH>`: `node -e "console.log(process.execPath)"` 결과
-- `<HOME>`: `~` 또는 홈 디렉토리 절대 경로
-- Windows: 경로에 공백이 있으면 큰따옴표로 감싸기
-- **기존 statusLine이 있으면 덮어쓰기 전 사용자에게 확인**
-
-Read 도구로 `~/.claude/settings.json`을 읽고, Edit 도구로 statusLine을 추가/수정합니다.
-
-### Step 3: CLI 진단
-
-```bash
-Bash("triflux doctor")
-```
-
-### Step 4: 결과 보고
-
-```markdown
-## tfx-setup 완료
-
-| 항목 | 상태 |
-|------|------|
-| tfx-route.sh | ✅ v2.0 |
-| HUD (hud-qos-status.mjs) | ✅ v1.7 |
-| HUD 설정 (settings.json) | ✅ statusLine 등록됨 |
-| Codex CLI | ✅ / ⚠️ 미설치 (선택) |
-| Gemini CLI | ✅ / ⚠️ 미설치 (선택) |
-| 스킬 | ✅ N개 설치됨 |
-
-### 다음 단계
-- Codex 미설치 시: `npm install -g @openai/codex`
-- Gemini 미설치 시: `npm install -g @google/gemini-cli`
-- 세션 재시작하면 HUD가 표시됩니다
-```
-
-## 에러 처리
-
-| 상황 | 처리 |
-|------|------|
-| `triflux: command not found` | `npm install -g triflux` 안내 |
-| `settings.json` 파싱 실패 | 백업 생성 후 새로 작성 |
-| 기존 statusLine이 다른 HUD | 사용자에게 덮어쓸지 확인 |
-| node.exe 경로에 공백 | 큰따옴표로 감싸기 |
-
-## Troubleshooting
-
-문제 발생 시 `/tfx-doctor` 실행. (`--fix` 자동 수정, `--reset` 캐시 초기화)
+---
+name: tfx-setup
+description: >
+  triflux 초기 설정 및 진단. AskUserQuestion 기반 인터랙티브 위저드로
+  파일 동기화, HUD 설정, Codex 프로파일, CLI 진단, MCP 확인을 수행합니다.
+  Use when: setup, 설정, 설치, install, 초기화, 처음, 시작, wizard
+triggers:
+  - tfx-setup
+argument-hint: "[doctor]"
+---
+
+# tfx-setup — triflux 초기 설정 위저드
+
+> 설치 후 최초 1회 실행 권장. HUD 설정, CLI 확인, 전체 진단을 수행합니다.
+
+## 워크플로우
+
+### Step 1: 모드 선택 (AskUserQuestion)
+
+```
+question: "어떤 설정 모드를 실행하시겠습니까?"
+header: "모드"
+options:
+  - label: "전체 설정 (Recommended)"
+    description: "5단계 순서 실행: 동기화 → HUD → 프로파일 → CLI → MCP"
+  - label: "단계별 선택"
+    description: "필요한 단계만 골라서 실행"
+  - label: "현재 상태 확인"
+    description: "설정 없이 진단만 수행"
+```
+
+`doctor` 인자가 있으면 바로 `triflux doctor` 실행.
+
+### Step 2: 전체 설정 (5단계)
+
+각 단계를 순서대로 실행하며 결과를 보고한다.
+
+#### 단계 1: 파일 동기화
+
+```bash
+Bash("triflux setup")
+```
+
+스크립트/HUD/스킬을 `~/.claude/`에 배포. 결과 표시.
+
+#### 단계 2: HUD 설정
+
+`~/.claude/settings.json`을 Read 도구로 읽어 `statusLine` 확인.
+
+- statusLine이 이미 `hud-qos-status.mjs`를 가리키면 → ✅ 표시
+- statusLine이 없으면 → AskUserQuestion:
+  ```
+  question: "HUD statusLine을 설정하시겠습니까?"
+  header: "HUD"
+  options:
+    - label: "설정 (Recommended)"
+      description: "hud-qos-status.mjs를 statusLine으로 등록"
+    - label: "건너뛰기"
+      description: "나중에 수동 설정"
+  ```
+- statusLine이 다른 값이면 → AskUserQuestion:
+  ```
+  question: "기존 statusLine을 triflux HUD로 교체하시겠습니까?"
+  header: "HUD"
+  options:
+    - label: "교체"
+      description: "기존 statusLine을 triflux HUD로 덮어씀"
+    - label: "유지"
+      description: "현재 statusLine 유지"
+  ```
+
+설정 시 Edit 도구로 settings.json 수정:
+```json
+{
+  "statusLine": {
+    "type": "command",
+    "command": "\"<NODE_PATH>\" \"<HOME>/.claude/hud/hud-qos-status.mjs\""
+  }
+}
+```
+
+#### 단계 3: Codex 프로파일
+
+`~/.codex/config.toml`을 Read 도구로 읽어 필수 프로파일 존재 여부 확인.
+필수: `codex53_high`, `codex53_xhigh`, `spark53_low`.
+
+- 모두 존재 → ✅ 표시
+- 누락 있으면 → AskUserQuestion:
+  ```
+  question: "누락된 Codex 프로파일 N개를 생성하시겠습니까?"
+  header: "Profiles"
+  options:
+    - label: "생성 (Recommended)"
+      description: "누락된 프로파일을 config.toml에 추가"
+    - label: "건너뛰기"
+      description: "나중에 /tfx-profile로 관리"
+  ```
+
+#### 단계 4: CLI 진단
+
+`triflux doctor --json`을 Bash로 실행하여 CLI 존재 여부 확인.
+결과를 테이블로 표시.
+
+#### 단계 5: MCP 서버 확인
+
+`~/.claude/cache/mcp-inventory.json` 존재 여부 + 서버 수 확인.
+없으면 재생성 여부를 AskUserQuestion으로 확인.
+
+### Step 3: 단계별 선택
+
+AskUserQuestion(multiSelect):
+```
+question: "실행할 단계를 선택하세요"
+header: "단계"
+multiSelect: true
+options:
+  - label: "파일 동기화"
+    description: "스크립트/HUD/스킬 배포"
+  - label: "HUD 설정"
+    description: "settings.json statusLine 등록"
+  - label: "Codex 프로파일"
+    description: "필수 프로파일 생성"
+  - label: "CLI + MCP 진단"
+    description: "CLI 존재 + MCP 인벤토리 확인"
+```
+
+선택된 단계만 순서대로 실행.
+
+### Step 4: 결과 요약
+
+```
+## tfx-setup 완료
+
+| 항목 | 상태 |
+|------|------|
+| 파일 동기화 | ✅ |
+| HUD 설정 | ✅ statusLine 등록됨 |
+| Codex 프로파일 | ✅ 3개 확인 |
+| Codex CLI | ✅ |
+| Gemini CLI | ⚠ 미설치 (선택) |
+| MCP 인벤토리 | ✅ N개 서버 |
+
+### 다음 단계
+- Codex 미설치 시: `npm install -g @openai/codex`
+- Gemini 미설치 시: `npm install -g @google/gemini-cli`
+- 세션 재시작하면 HUD가 표시됩니다
+```
+
+## 에러 처리
+
+| 상황 | 처리 |
+|------|------|
+| `triflux: command not found` | `npm install -g triflux` 안내 |
+| `settings.json` 파싱 실패 | 백업 생성 후 새로 작성 |
+| 기존 statusLine이 다른 HUD | 교체/유지 AskUserQuestion |
+| node.exe 경로에 공백 | 큰따옴표로 감싸기 |
+
+## standalone TUI
+
+터미널에서 직접 실행도 가능: `node tui/setup.mjs` (arrow key 방식)