triflux 8.2.3 → 8.3.1

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 방식)

package/tui/codex-profile.mjs

@@ -0,0 +1,402 @@
+#!/usr/bin/env node
+// tui/codex-profile.mjs — Interactive Codex Profile Manager
+import { readFileSync, writeFileSync, existsSync, mkdirSync, copyFileSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+import {
+  clear, box, table, divider, label, ok, warn, fail, info,
+  select, confirm, input, spinner,
+  RESET, DIM, BOLD, CYAN, AMBER, GREEN, RED, YELLOW, WHITE, GRAY,
+  onExit, showCursor,
+} from "./core.mjs";
+
+const CODEX_DIR = join(homedir(), ".codex");
+const CONFIG_PATH = join(CODEX_DIR, "config.toml");
+
+const KNOWN_MODELS = [
+  { label: "gpt-5.4",            hint: "최신 플래그십" },
+  { label: "gpt-5.3-codex",      hint: "코딩 특화" },
+  { label: "gpt-5.1-codex-mini", hint: "경량 Spark" },
+  { label: "o3",                  hint: "추론 특화" },
+  { label: "o4-mini",             hint: "추론 경량" },
+  { label: "직접 입력",            hint: "" },
+];
+
+const EFFORT_LEVELS = [
+  { label: "low",    hint: "빠른 응답, 최소 추론" },
+  { label: "medium", hint: "균형 잡힌 추론" },
+  { label: "high",   hint: "깊은 추론" },
+  { label: "xhigh",  hint: "최대 추론 (느림)" },
+];
+
+// ── TOML Parsing ──
+
+function readConfig() {
+  if (!existsSync(CONFIG_PATH)) return { raw: "", defaults: {}, profiles: [] };
+  const raw = readFileSync(CONFIG_PATH, "utf8");
+  return { raw, ...parseConfig(raw) };
+}
+
+function parseConfig(raw) {
+  const lines = raw.split("\n");
+  const defaults = {};
+  const profiles = [];
+  let currentSection = null;
+  let currentProfile = null;
+
+  for (const line of lines) {
+    const trimmed = line.trim();
+    if (!trimmed || trimmed.startsWith("#")) continue;
+
+    const sectionMatch = trimmed.match(/^\[(.+)\]$/);
+    if (sectionMatch) {
+      const name = sectionMatch[1];
+      const profileMatch = name.match(/^profiles\.(\w+)$/);
+      if (profileMatch) {
+        currentSection = "profile";
+        currentProfile = { name: profileMatch[1] };
+        profiles.push(currentProfile);
+      } else {
+        currentSection = name;
+        currentProfile = null;
+      }
+      continue;
+    }
+
+    const kvMatch = trimmed.match(/^(\w+)\s*=\s*(.+)$/);
+    if (kvMatch) {
+      const [, key, rawVal] = kvMatch;
+      const value = rawVal.replace(/^["']|["']$/g, "").trim();
+      if (currentSection === "profile" && currentProfile) {
+        currentProfile[key] = value;
+      } else if (!currentSection) {
+        defaults[key] = value;
+      }
+    }
+  }
+
+  return { defaults, profiles };
+}
+
+function writeProfile(raw, profileName, props) {
+  const lines = raw.split("\n");
+  const sectionRe = new RegExp(`^\\[profiles\\.${escRe(profileName)}\\]\\s*$`);
+  let inSection = false;
+  let sectionStart = -1;
+  let sectionEnd = lines.length;
+
+  for (let i = 0; i < lines.length; i++) {
+    if (sectionRe.test(lines[i].trim())) {
+      inSection = true;
+      sectionStart = i;
+      continue;
+    }
+    if (inSection && lines[i].trim().startsWith("[")) {
+      sectionEnd = i;
+      break;
+    }
+  }
+
+  if (sectionStart === -1) {
+    // Append new profile section
+    const newLines = [`[profiles.${profileName}]`];
+    for (const [k, v] of Object.entries(props)) {
+      newLines.push(`${k} = "${v}"`);
+    }
+    return raw.trimEnd() + "\n" + newLines.join("\n") + "\n";
+  }
+
+  // Replace existing section body
+  const newBody = [];
+  for (const [k, v] of Object.entries(props)) {
+    newBody.push(`${k} = "${v}"`);
+  }
+  lines.splice(sectionStart + 1, sectionEnd - sectionStart - 1, ...newBody);
+  return lines.join("\n");
+}
+
+function deleteProfile(raw, profileName) {
+  const lines = raw.split("\n");
+  const sectionRe = new RegExp(`^\\[profiles\\.${escRe(profileName)}\\]\\s*$`);
+  let inSection = false;
+  let start = -1;
+  let end = lines.length;
+
+  for (let i = 0; i < lines.length; i++) {
+    if (sectionRe.test(lines[i].trim())) {
+      inSection = true;
+      start = i;
+      continue;
+    }
+    if (inSection && lines[i].trim().startsWith("[")) {
+      end = i;
+      break;
+    }
+  }
+
+  if (start === -1) return raw;
+  // Remove trailing blank lines too
+  while (end < lines.length && lines[end].trim() === "") end++;
+  lines.splice(start, end - start);
+  return lines.join("\n");
+}
+
+function setDefault(raw, key, value) {
+  const lines = raw.split("\n");
+  const keyRe = new RegExp(`^${escRe(key)}\\s*=`);
+
+  for (let i = 0; i < lines.length; i++) {
+    if (lines[i].trim().startsWith("[")) break; // hit first section
+    if (keyRe.test(lines[i].trim())) {
+      lines[i] = `${key} = "${value}"`;
+      return lines.join("\n");
+    }
+  }
+
+  // Key not found — insert before first section
+  for (let i = 0; i < lines.length; i++) {
+    if (lines[i].trim().startsWith("[")) {
+      lines.splice(i, 0, `${key} = "${value}"`);
+      return lines.join("\n");
+    }
+  }
+
+  return raw + `\n${key} = "${value}"\n`;
+}
+
+function escRe(s) {
+  return s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+
+// ── UI Flows ──
+
+function showStatus(config) {
+  const { defaults, profiles } = config;
+
+  console.log();
+  label("기본 모델", `${WHITE}${defaults.model || "미설정"}${RESET}`);
+  label("기본 Effort", `${WHITE}${defaults.model_reasoning_effort || "미설정"}${RESET}`);
+  console.log();
+
+  if (profiles.length === 0) {
+    warn("등록된 프로파일이 없습니다.");
+    return;
+  }
+
+  const headers = ["프로파일", "모델", "Effort", "기타"];
+  const rows = profiles.map((p) => {
+    const extras = Object.entries(p)
+      .filter(([k]) => !["name", "model", "model_reasoning_effort"].includes(k))
+      .map(([k, v]) => `${k}=${v}`)
+      .join(", ");
+    return [
+      `${CYAN}${p.name}${RESET}`,
+      p.model || DIM + "inherit" + RESET,
+      effortColor(p.model_reasoning_effort),
+      extras ? `${DIM}${extras}${RESET}` : "",
+    ];
+  });
+
+  table(headers, rows);
+}
+
+function effortColor(effort) {
+  if (!effort) return `${DIM}inherit${RESET}`;
+  const colors = { low: GREEN, medium: CYAN, high: YELLOW, xhigh: RED };
+  return `${colors[effort] || ""}${effort}${RESET}`;
+}
+
+async function pickModel(current) {
+  const idx = KNOWN_MODELS.findIndex((m) => m.label === current);
+  const choice = await select("모델 선택", KNOWN_MODELS, { initial: Math.max(0, idx) });
+  if (!choice) return null;
+  if (choice.value.label === "직접 입력") {
+    return await input("모델 ID", current || "");
+  }
+  return choice.value.label;
+}
+
+async function pickEffort(current) {
+  const idx = EFFORT_LEVELS.findIndex((e) => e.label === current);
+  const choice = await select("Reasoning Effort 선택", EFFORT_LEVELS, { initial: Math.max(0, idx) });
+  if (!choice) return null;
+  return choice.value.label;
+}
+
+async function editProfile(config) {
+  const { profiles } = config;
+  if (profiles.length === 0) {
+    warn("편집할 프로파일이 없습니다.");
+    return config;
+  }
+
+  const options = profiles.map((p) => ({
+    label: p.name,
+    hint: `${DIM}${p.model || "inherit"} / ${p.model_reasoning_effort || "inherit"}${RESET}`,
+  }));
+
+  const picked = await select("편집할 프로파일", options);
+  if (!picked) return config;
+
+  const profile = profiles[picked.index];
+  console.log();
+  info(`현재: ${BOLD}${profile.name}${RESET} → ${profile.model} / ${profile.model_reasoning_effort}`);
+
+  const newModel = await pickModel(profile.model);
+  if (newModel === null) return config;
+
+  const newEffort = await pickEffort(profile.model_reasoning_effort);
+  if (newEffort === null) return config;
+
+  console.log();
+  info(`변경: ${profile.model} → ${BOLD}${newModel}${RESET}, ${profile.model_reasoning_effort} → ${BOLD}${newEffort}${RESET}`);
+
+  if (!(await confirm("저장하시겠습니까?"))) return config;
+
+  const props = { model: newModel, model_reasoning_effort: newEffort };
+  // Preserve extra props (like model_temperature)
+  for (const [k, v] of Object.entries(profile)) {
+    if (!["name", "model", "model_reasoning_effort"].includes(k)) props[k] = v;
+  }
+
+  let raw = writeProfile(config.raw, profile.name, props);
+  save(raw);
+  ok(`${profile.name} 프로파일 저장 완료`);
+  return readConfig();
+}
+
+async function editDefault(config) {
+  const { defaults } = config;
+  info(`현재 기본 모델: ${BOLD}${defaults.model || "미설정"}${RESET}`);
+  info(`현재 기본 Effort: ${BOLD}${defaults.model_reasoning_effort || "미설정"}${RESET}`);
+
+  const newModel = await pickModel(defaults.model);
+  if (newModel === null) return config;
+
+  const newEffort = await pickEffort(defaults.model_reasoning_effort);
+  if (newEffort === null) return config;
+
+  console.log();
+  info(`변경: ${defaults.model} → ${BOLD}${newModel}${RESET}, ${defaults.model_reasoning_effort} → ${BOLD}${newEffort}${RESET}`);
+
+  if (!(await confirm("저장하시겠습니까?"))) return config;
+
+  let raw = setDefault(config.raw, "model", newModel);
+  raw = setDefault(raw, "model_reasoning_effort", newEffort);
+  save(raw);
+  ok("기본 설정 저장 완료");
+  return readConfig();
+}
+
+async function addProfile(config) {
+  const name = await input("새 프로파일 이름");
+  if (!name) return config;
+
+  if (config.profiles.some((p) => p.name === name)) {
+    fail(`'${name}' 프로파일이 이미 존재합니다.`);
+    return config;
+  }
+
+  const model = await pickModel("");
+  if (!model) return config;
+
+  const effort = await pickEffort("");
+  if (!effort) return config;
+
+  console.log();
+  info(`추가: ${BOLD}${name}${RESET} → ${model} / ${effort}`);
+  if (!(await confirm("저장하시겠습니까?"))) return config;
+
+  const raw = writeProfile(config.raw, name, { model, model_reasoning_effort: effort });
+  save(raw);
+  ok(`${name} 프로파일 추가 완료`);
+  return readConfig();
+}
+
+async function removeProfile(config) {
+  const { profiles } = config;
+  if (profiles.length === 0) {
+    warn("삭제할 프로파일이 없습니다.");
+    return config;
+  }
+
+  const options = profiles.map((p) => ({ label: p.name, hint: `${p.model}` }));
+  const picked = await select("삭제할 프로파일", options);
+  if (!picked) return config;
+
+  const name = profiles[picked.index].name;
+  if (!(await confirm(`${RED}${name}${RESET} 프로파일을 삭제하시겠습니까?`, false))) {
+    return config;
+  }
+
+  const raw = deleteProfile(config.raw, name);
+  save(raw);
+  ok(`${name} 프로파일 삭제 완료`);
+  return readConfig();
+}
+
+function save(content) {
+  if (!existsSync(CODEX_DIR)) mkdirSync(CODEX_DIR, { recursive: true });
+
+  // Backup before write
+  if (existsSync(CONFIG_PATH)) {
+    const backupPath = CONFIG_PATH + ".bak";
+    copyFileSync(CONFIG_PATH, backupPath);
+  }
+
+  writeFileSync(CONFIG_PATH, content, "utf8");
+}
+
+// ── Main Loop ──
+
+const MENU = [
+  { label: "프로파일 모델 변경",   hint: "모델/effort 수정" },
+  { label: "기본 모델 변경",       hint: "top-level default" },
+  { label: "프로파일 추가",        hint: "새 프로파일 생성" },
+  { label: "프로파일 삭제",        hint: "기존 프로파일 제거" },
+  { label: "종료",                hint: "Ctrl+C" },
+];
+
+async function main() {
+  onExit(() => {});
+  clear();
+
+  let config = readConfig();
+
+  if (!existsSync(CONFIG_PATH)) {
+    fail(`config.toml 미존재: ${CONFIG_PATH}`);
+    info("codex를 먼저 설치하거나 /tfx-setup을 실행하세요.");
+    process.exit(1);
+  }
+
+  while (true) {
+    box("Codex Profile Manager", 46);
+    showStatus(config);
+    console.log();
+
+    const choice = await select("작업 선택", MENU);
+    if (!choice || choice.index === 4) {
+      console.log();
+      info("종료합니다.");
+      showCursor();
+      break;
+    }
+
+    console.log();
+    switch (choice.index) {
+      case 0: config = await editProfile(config); break;
+      case 1: config = await editDefault(config); break;
+      case 2: config = await addProfile(config); break;
+      case 3: config = await removeProfile(config); break;
+    }
+
+    console.log();
+    divider(46);
+  }
+}
+
+main().catch((e) => {
+  showCursor();
+  console.error(e);
+  process.exit(1);
+});