triflux 9.4.0 → 9.5.1

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "triflux",
-  "version": "9.3.0",
+  "version": "9.5.1",
   "description": "CLI-first multi-model orchestrator for Claude Code — route tasks to Codex, Gemini, and Claude",
   "author": {
     "name": "tellang"

package/bin/triflux.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 // triflux CLI — setup, doctor, version
-import { copyFileSync, existsSync, readFileSync, writeFileSync, mkdirSync, chmodSync, readdirSync, unlinkSync, statSync, openSync, closeSync } from "fs";
+import { copyFileSync, existsSync, readFileSync, readSync, writeFileSync, mkdirSync, chmodSync, readdirSync, unlinkSync, statSync, openSync, closeSync } from "fs";
 import { join, dirname } from "path";
 import { homedir } from "os";
 import { execSync, execFileSync, spawn } from "child_process";
@@ -13,9 +13,9 @@ import { cleanupStaleOmcTeams, inspectStaleOmcTeams } from "../hub/team/staleSta
 import { getPipelineStateDbPath } from "../hub/pipeline/state.mjs";
 import { ensureGeminiProfiles } from "../scripts/lib/gemini-profiles.mjs";
 import {
-  SYNC_MAP, SKILL_ALIASES, REQUIRED_CODEX_PROFILES,
+  SYNC_MAP, SKILL_ALIASES, REQUIRED_CODEX_PROFILES, LEGACY_CODEX_MODELS,
   syncAliasedSkillDir, hasProfileSection, replaceProfileSection,
-  ensureCodexProfiles, getVersion,
+  ensureCodexProfiles, getVersion, cleanupStaleSkills, DEPRECATED_SKILLS,
 } from "../scripts/setup.mjs";
 
 const PKG_ROOT = dirname(dirname(fileURLToPath(import.meta.url)));
@@ -720,6 +720,25 @@ function cmdSetup(options = {}) {
     } else {
       ok(`스킬: ${skillTotal}개 최신 상태`);
     }
+    // Stale 스킬 정리 (패키지에서 제거된 tfx-* 스킬 삭제)
+    const staleCleanup = cleanupStaleSkills(skillsDst, skillsSrc);
+    if (staleCleanup.count > 0) {
+      ok(`구형 스킬 ${staleCleanup.count}개 제거: ${staleCleanup.removed.join(", ")}`);
+    }
+  }
+
+  // ── psmux 기본 셸 자동 수정 (cmd.exe → PowerShell) ──
+  if (process.platform === "win32" && which("psmux")) {
+    try {
+      const shellOut = execSync("psmux show-options -g default-shell 2>NUL", { encoding: "utf8", timeout: 3000 }).trim();
+      if (!/powershell|pwsh/i.test(shellOut)) {
+        const pwsh = which("pwsh") ? "pwsh" : (which("powershell.exe") ? "powershell.exe" : "");
+        if (pwsh) {
+          execSync(`psmux set-option -g default-shell "${pwsh}"`, { timeout: 3000, stdio: "pipe" });
+          ok(`psmux 기본 셸 → ${pwsh}`);
+        }
+      }
+    } catch { /* psmux 서버 미실행 — 무시 */ }
   }
 
   // ── 결과 추적 ──
@@ -822,22 +841,55 @@ function cmdSetup(options = {}) {
     }
   }
 
-  // Star request (버전 게이팅)
+  // Star request (버전 게이팅 + 인터랙티브 [y/n])
   const showStar = STAR_PROMPT_VERSIONS.length === 0 || STAR_PROMPT_VERSIONS.includes(PKG.version);
   if (showStar) {
+    let ghOk = false;
     try {
       execFileSync("gh", ["auth", "status"], { timeout: 5000, stdio: ["pipe", "pipe", "pipe"] });
+      ghOk = true;
+    } catch {}
+
+    if (!ghOk) {
+      // gh 미설치/미인증 — URL만 표시
+      console.log();
+      info(`${AMBER}⭐${RESET} 하나가 큰 차이를 만듭니다. ${CYAN}https://github.com/tellang/triflux${RESET}`);
+    } else {
+      let alreadyStarred = false;
       try {
         execFileSync("gh", ["api", "user/starred/tellang/triflux"], { timeout: 5000, stdio: ["pipe", "pipe", "pipe"] });
+        alreadyStarred = true;
+      } catch {}
+
+      if (alreadyStarred) {
         console.log();
         ok(`이미 함께하고 계시군요. ${AMBER}⭐${RESET}`);
-      } catch {
+      } else {
+        // 인터랙티브 confirm
         console.log();
-        info(`${AMBER}⭐${RESET} 하나가 큰 차이를 만듭니다. ${CYAN}https://github.com/tellang/triflux${RESET}`);
+        process.stdout.write(`    ${AMBER}⭐${RESET} 하나가 큰 차이를 만듭니다. Star? ${DIM}[y/N]${RESET} `);
+        let answer = "";
+        try {
+          const buf = Buffer.alloc(128);
+          const n = readSync(0, buf, 0, 128);
+          answer = buf.toString("utf8", 0, n).trim().toLowerCase();
+        } catch {
+          // non-interactive stdin — 건너뜀
+        }
+        if (answer.startsWith("y")) {
+          try {
+            execFileSync("gh", ["api", "-X", "PUT", "/user/starred/tellang/triflux"], {
+              timeout: 5000, stdio: ["pipe", "pipe", "pipe"],
+            });
+            ok(`함께해 주셔서 감사합니다. ${AMBER}⭐${RESET}`);
+          } catch {
+            info(`${CYAN}https://github.com/tellang/triflux${RESET}`);
+          }
+        } else if (answer === "") {
+          // 아무 입력 없이 Enter — 조용히 URL만
+          console.log(`      ${DIM}https://github.com/tellang/triflux${RESET}`);
+        }
       }
-    } catch {
-      console.log();
-      info(`${AMBER}⭐${RESET} 하나가 큰 차이를 만듭니다. ${CYAN}https://github.com/tellang/triflux${RESET}`);
     }
   }
 
@@ -1079,7 +1131,9 @@ async function cmdDoctor(options = {}) {
       const missingProfiles = [];
       for (const profile of REQUIRED_CODEX_PROFILES) {
         if (hasProfileSection(codexConfig, profile.name)) {
-          ok(`${profile.name}: 정상`);
+          ok(`${profile.name}: 정상${profile.proOnly ? ` ${DIM}(Pro 전용)${RESET}` : ""}`);
+        } else if (profile.proOnly) {
+          info(`${profile.name}: 미설정 ${DIM}(Pro 전용 — Plus/기본에서는 불필요)${RESET}`);
         } else {
           missingProfiles.push(profile.name);
           warn(`${profile.name}: 미설정`);
@@ -1099,6 +1153,18 @@ async function cmdDoctor(options = {}) {
       issues++;
     }
 
+    // Codex 구형 모델 감지
+    if (existsSync(CODEX_CONFIG_PATH)) {
+      const codexContent = readFileSync(CODEX_CONFIG_PATH, "utf8");
+      const legacyFound = LEGACY_CODEX_MODELS.filter(m => codexContent.includes(`"${m}"`));
+      if (legacyFound.length > 0) {
+        warn(`구형 모델 감지: ${legacyFound.join(", ")}`);
+        info("최신 프로필로 마이그레이션: tfx setup 또는 tfx profile");
+        addDoctorCheck(report, { name: "codex-legacy-models", status: "issues", models: legacyFound, fix: "tfx setup" });
+        issues++;
+      }
+    }
+
     // 5. Gemini CLI
     section(`Gemini CLI ${BLUE}●${RESET}`);
     const geminiCli = checkCliCrossShell("gemini", "npm install -g @google/gemini-cli");
@@ -1111,6 +1177,22 @@ async function cmdDoctor(options = {}) {
     });
     // API 키 검사 제거 — bash exec 기반이므로 API 키 불필요
 
+    // Gemini 구형 모델 감지
+    const geminiProfilesPath = join(homedir(), ".gemini", "triflux-profiles.json");
+    const LEGACY_GEMINI_MODELS = ["gemini-2.0-flash", "gemini-1.5-pro", "gemini-1.5-flash", "gemini-2.5-pro-preview"];
+    if (existsSync(geminiProfilesPath)) {
+      try {
+        const geminiContent = readFileSync(geminiProfilesPath, "utf8");
+        const geminiLegacy = LEGACY_GEMINI_MODELS.filter(m => geminiContent.includes(m));
+        if (geminiLegacy.length > 0) {
+          warn(`구형 모델 감지: ${geminiLegacy.join(", ")}`);
+          info("최신 프로필로 마이그레이션: tfx setup 또는 tfx profile");
+          addDoctorCheck(report, { name: "gemini-legacy-models", status: "issues", models: geminiLegacy, fix: "tfx setup" });
+          issues++;
+        }
+      } catch {}
+    }
+
     // 6. Claude Code
     section(`Claude Code ${AMBER}●${RESET}`);
     const claudePath = which("claude");
@@ -1123,7 +1205,53 @@ async function cmdDoctor(options = {}) {
       issues++;
     }
 
-  // 7. 스킬 설치 상태
+    // 7. psmux (Windows only)
+    if (process.platform === "win32") {
+      section("psmux (터미널 멀티플렉서)");
+      const psmuxPath = which("psmux");
+      if (psmuxPath) {
+        ok("설치됨");
+        // 기본 셸 확인: psmux 세션의 기본 셸이 PowerShell인지 cmd.exe인지
+        let shellOk = false;
+        try {
+          const defaultShell = execSync("psmux show-options -g default-shell 2>NUL", { encoding: "utf8", timeout: 3000 }).trim();
+          shellOk = /powershell|pwsh/i.test(defaultShell);
+        } catch {
+          // show-options 실패 시 pwsh/powershell 존재 여부로 판단
+          shellOk = !!which("pwsh") || !!which("powershell.exe");
+        }
+        if (shellOk) {
+          ok("기본 셸: PowerShell");
+          addDoctorCheck(report, { name: "psmux", status: "ok", path: psmuxPath, shell: "powershell" });
+        } else {
+          if (fix) {
+            // --fix: PowerShell로 자동 변경
+            const pwshBin = which("pwsh") ? "pwsh" : "powershell.exe";
+            try {
+              execSync(`psmux set-option -g default-shell "${pwshBin}"`, { timeout: 3000, stdio: "pipe" });
+              ok(`기본 셸 → ${pwshBin} 으로 변경 완료`);
+              addDoctorCheck(report, { name: "psmux", status: "ok", path: psmuxPath, shell: pwshBin, fixed: true });
+              report.actions.push("psmux default-shell → " + pwshBin);
+            } catch (e) {
+              fail(`기본 셸 변경 실패: ${e.message}`);
+              addDoctorCheck(report, { name: "psmux", status: "issues", path: psmuxPath, shell: "cmd", fix: `psmux set-option -g default-shell "${pwshBin}"` });
+              issues++;
+            }
+          } else {
+            warn("기본 셸이 cmd.exe — headless 명령 실패 가능");
+            info(`수정: tfx doctor --fix 또는 psmux set-option -g default-shell "powershell.exe"`);
+            addDoctorCheck(report, { name: "psmux", status: "issues", path: psmuxPath, shell: "cmd", fix: "tfx doctor --fix" });
+            issues++;
+          }
+        }
+      } else {
+        info(`미설치 ${GRAY}(선택 — 멀티모델 병렬 실행에 필요)${RESET}`);
+        info(`설치: winget install marlocarlo.psmux`);
+        addDoctorCheck(report, { name: "psmux", status: "skipped", detail: "미설치 (선택)", fix: "winget install marlocarlo.psmux" });
+      }
+    }
+
+  // 8. 스킬 설치 상태
   section("Skills");
   const skillsSrc = join(PKG_ROOT, "skills");
   const skillsDst = join(CLAUDE_DIR, "skills");
@@ -1153,7 +1281,32 @@ async function cmdDoctor(options = {}) {
       addDoctorCheck(report, { name: "skills", status: "missing", installed: 0, total: 0, fix: "패키지 skills 디렉토리를 확인하세요." });
     }
 
-    // 8. 플러그인 등록
+    // Stale 스킬 체크
+    const staleSkills = [];
+    const userSkillsDir = join(CLAUDE_DIR, "skills");
+    if (existsSync(userSkillsDir)) {
+      const pkgSkillsDir = join(PKG_ROOT, "skills");
+      const pkgSkills = new Set();
+      if (existsSync(pkgSkillsDir)) {
+        for (const n of readdirSync(pkgSkillsDir)) pkgSkills.add(n);
+      }
+      for (const { alias } of SKILL_ALIASES) pkgSkills.add(alias);
+
+      for (const n of readdirSync(userSkillsDir)) {
+        if (!n.startsWith("tfx-")) continue;
+        if (!pkgSkills.has(n)) staleSkills.push(n);
+      }
+    }
+    if (staleSkills.length > 0) {
+      warn(`구형 스킬 ${staleSkills.length}개 감지: ${staleSkills.join(", ")}`);
+      info("제거: tfx setup 또는 tfx update");
+      addDoctorCheck(report, { name: "stale-skills", status: "issues", skills: staleSkills, fix: "tfx setup" });
+      issues++;
+    } else {
+      addDoctorCheck(report, { name: "stale-skills", status: "ok" });
+    }
+
+    // 9. 플러그인 등록
     section("Plugin");
     const pluginsFile = join(CLAUDE_DIR, "plugins", "installed_plugins.json");
     if (existsSync(pluginsFile)) {
@@ -1171,7 +1324,7 @@ async function cmdDoctor(options = {}) {
       info("플러그인 시스템 감지 안 됨 — npm 단독 사용");
     }
 
-  // 9. MCP 인벤토리
+  // 10. MCP 인벤토리
   section("MCP Inventory");
   const mcpCache = join(CLAUDE_DIR, "cache", "mcp-inventory.json");
   if (existsSync(mcpCache)) {
@@ -1240,7 +1393,7 @@ async function cmdDoctor(options = {}) {
     issues++;
   }
 
-  // 10. CLI 이슈 트래커
+  // 11. CLI 이슈 트래커
   section("CLI Issues");
   const issuesFile = join(CLAUDE_DIR, "cache", "cli-issues.jsonl");
   if (existsSync(issuesFile)) {
@@ -1320,7 +1473,7 @@ async function cmdDoctor(options = {}) {
     ok("이슈 로그 없음 (정상)");
   }
 
-  // 11. Team Sessions
+  // 12. Team Sessions
   section("Team Sessions");
   const teamSessionReport = inspectTeamSessions();
   if (!teamSessionReport.mux) {
@@ -1370,7 +1523,7 @@ async function cmdDoctor(options = {}) {
     }
   }
 
-  // 12. OMC stale team 상태
+  // 13. OMC stale team 상태
   section("OMC Stale Teams");
   const omcTeamReport = inspectStaleOmcTeams({
     startDir: process.cwd(),
@@ -1460,7 +1613,7 @@ async function cmdDoctor(options = {}) {
     ok("Windows 전용 검사 — 건너뜀");
   }
 
-  // 13. Stale Teams (Claude teams/ + tasks/ 자동 감지)
+  // 14. Stale Teams (Claude teams/ + tasks/ 자동 감지)
   section("Stale Teams");
   const teamsDir = join(CLAUDE_DIR, "teams");
   const tasksDir = join(CLAUDE_DIR, "tasks");

package/hub/team/psmux.mjs

@@ -28,6 +28,23 @@ const PSMUX_BIN = (() => {
 })();
 const GIT_BASH = process.env.GIT_BASH_PATH || "C:\\Program Files\\Git\\bin\\bash.exe";
 const IS_WINDOWS = process.platform === "win32";
+
+/** Windows psmux 세션의 기본 셸을 PowerShell로 강제한다 (pwsh7 우선, ps5 fallback). */
+const PWSH_BIN = (() => {
+  if (!IS_WINDOWS) return "";
+  if (process.env.PSMUX_SHELL) return process.env.PSMUX_SHELL;
+  // pwsh 7 우선
+  try {
+    childProcess.execFileSync("pwsh", ["-NoLogo", "-NoProfile", "-Command", "exit 0"], { stdio: "ignore", timeout: 3000, windowsHide: true });
+    return "pwsh";
+  } catch { /* not found */ }
+  // powershell 5 fallback
+  try {
+    childProcess.execFileSync("powershell.exe", ["-NoLogo", "-NoProfile", "-Command", "exit 0"], { stdio: "ignore", timeout: 3000, windowsHide: true });
+    return "powershell.exe";
+  } catch { /* not found */ }
+  return ""; // 둘 다 없으면 psmux 기본 셸 사용
+})();
 const PSMUX_TIMEOUT_MS = 10000;
 const COMPLETION_PREFIX = "__TRIFLUX_DONE__:";
 const CAPTURE_ROOT = process.env.PSMUX_CAPTURE_ROOT || join(tmpdir(), "psmux-steering");
@@ -145,7 +162,15 @@ function randomToken(prefix) {
 
 function ensurePsmuxInstalled() {
   if (!hasPsmux()) {
-    throw new Error("psmux가 설치되어 있지 않습니다.");
+    throw new Error(
+      "psmux가 설치되어 있지 않습니다.\n\n" +
+      "psmux는 Codex/Gemini CLI를 병렬 세션으로 실행하는 터미널 멀티플렉서입니다.\n" +
+      "설치 방법 (택 1):\n" +
+      "  winget install marlocarlo.psmux\n" +
+      "  scoop install psmux\n" +
+      "  npm install -g psmux\n\n" +
+      "설치 후 터미널을 재시작하세요."
+    );
   }
 }
 
@@ -409,7 +434,7 @@ export function createPsmuxSession(sessionName, opts = {}) {
   const limitedPaneCount = layout === "2x2" ? Math.min(paneCount, 4) : paneCount;
   const sessionTarget = `${sessionName}:0`;
 
-  const leadPane = psmuxExec([
+  const newSessionArgs = [
     "new-session",
     "-d",
     "-P",
@@ -421,7 +446,15 @@ export function createPsmuxSession(sessionName, opts = {}) {
     "220",
     "-y",
     "55",
-  ]);
+  ];
+  // Windows: psmux 기본 셸이 cmd.exe일 수 있으므로 PowerShell 강제
+  if (PWSH_BIN) newSessionArgs.push(PWSH_BIN, "-NoLogo", "-NoProfile");
+  const leadPane = psmuxExec(newSessionArgs);
+
+  // split-window로 생성되는 pane도 동일 셸 사용
+  if (PWSH_BIN) {
+    try { psmuxExec(["set-option", "-t", sessionName, "default-command", `${PWSH_BIN} -NoLogo -NoProfile`]); } catch { /* 미지원 시 무시 */ }
+  }
 
   if (layout === "2x2" && limitedPaneCount >= 3) {
     const rightPane = psmuxExec([
@@ -976,7 +1009,10 @@ export async function waitForCompletion(sessionName, paneNameOrTarget, token, ti
  */
 export function spawnWorker(sessionName, workerName, cmd) {
   if (!hasPsmux()) {
-    throw new Error("psmux가 설치되어 있지 않습니다. psmux를 먼저 설치하세요.");
+    throw new Error(
+      "psmux가 설치되어 있지 않습니다.\n" +
+      "설치: winget install marlocarlo.psmux  (또는 scoop install psmux / npm i -g psmux)"
+    );
   }
 
   // remain-on-exit: 종료된 pane이 즉시 사라지는 것 방지
@@ -1017,7 +1053,7 @@ export function spawnWorker(sessionName, workerName, cmd) {
  */
 export function getWorkerStatus(sessionName, workerName) {
   if (!hasPsmux()) {
-    throw new Error("psmux가 설치되어 있지 않습니다.");
+    throw new Error("psmux 미설치. 설치: winget install marlocarlo.psmux (또는 npm i -g psmux)");
   }
   try {
     const pane = resolvePane(sessionName, workerName);
@@ -1042,7 +1078,7 @@ export function getWorkerStatus(sessionName, workerName) {
  */
 export function killWorker(sessionName, workerName) {
   if (!hasPsmux()) {
-    throw new Error("psmux가 설치되어 있지 않습니다.");
+    throw new Error("psmux 미설치. 설치: winget install marlocarlo.psmux (또는 npm i -g psmux)");
   }
   try {
     const { paneId, status } = getWorkerStatus(sessionName, workerName);
@@ -1101,7 +1137,7 @@ export function killWorker(sessionName, workerName) {
  */
 export function captureWorkerOutput(sessionName, workerName, lines = 50) {
   if (!hasPsmux()) {
-    throw new Error("psmux가 설치되어 있지 않습니다.");
+    throw new Error("psmux 미설치. 설치: winget install marlocarlo.psmux (또는 npm i -g psmux)");
   }
   try {
     const { paneId } = getWorkerStatus(sessionName, workerName);

package/hub/team/tui-viewer.mjs

@@ -35,7 +35,7 @@ try {
   execFileSync("psmux", ["--version"], { encoding: "utf8", timeout: 2000 });
 } catch {
   process.stderr.write(
-    "ERROR: psmux not found or not executable. Install psmux before running tui-viewer.\n",
+    "ERROR: psmux 미설치. 설치: winget install marlocarlo.psmux (또는 npm i -g psmux)\n",
   );
   process.exit(1);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "triflux",
-  "version": "9.4.0",
+  "version": "9.5.1",
   "description": "CLI-first multi-model orchestrator for Claude Code — route tasks to Codex, Gemini, and Claude",
   "type": "module",
   "bin": {

package/scripts/session-spawn-helper.mjs

@@ -155,7 +155,7 @@ async function main() {
   }
 
   if (!hasPsmux()) {
-    process.stderr.write("ERROR: psmux가 설치되어 있지 않습니다. npm install -g psmux\n");
+    process.stderr.write("ERROR: psmux 미설치. 설치: winget install marlocarlo.psmux (또는 npm i -g psmux)\n");
     process.exit(1);
   }
 

package/scripts/setup.mjs

@@ -4,7 +4,7 @@
 // - hud-qos-status.mjs를 ~/.claude/hud/에 동기화
 // - skills/를 ~/.claude/skills/에 동기화
 
-import { copyFileSync, mkdirSync, readFileSync, writeFileSync, readdirSync, existsSync, chmodSync, unlinkSync } from "fs";
+import { copyFileSync, mkdirSync, readFileSync, writeFileSync, readdirSync, existsSync, chmodSync, unlinkSync, rmSync } from "fs";
 import { join, dirname } from "path";
 import { homedir } from "os";
 import { spawn, execFileSync } from "child_process";
@@ -52,6 +52,7 @@ const REQUIRED_CODEX_PROFILES = [
       'model = "gpt-5.3-codex-spark"',
       'model_reasoning_effort = "low"',
     ],
+    proOnly: true, // Pro 플랜 전용 — Plus/기본에서는 미동작
   },
 ];
 
@@ -62,6 +63,54 @@ const SKILL_ALIASES = [
   },
 ];
 
+/** 패키지에서 제거된 스킬 목록 — setup/update 시 ~/.claude/skills/에서 자동 삭제 */
+const DEPRECATED_SKILLS = [
+  "tfx-eval",
+  "tfx-learn",
+  "tfx-wrapup",
+];
+
+/** 마이그레이션 대상 구형 Codex 모델 — 이 모델을 사용하는 프로필을 감지하여 안내 */
+const LEGACY_CODEX_MODELS = ["o4-mini", "o3", "o3-pro", "o1", "o1-mini", "o1-pro", "gpt-4.1", "gpt-4.1-mini", "gpt-4.1-nano", "codex-mini-latest"];
+
+/**
+ * ~/.claude/skills/ 에서 패키지에 없는 stale tfx-* 스킬을 제거한다.
+ * @param {string} skillsDst - ~/.claude/skills/ 경로
+ * @param {string} skillsSrc - 패키지의 skills/ 경로
+ * @returns {{ removed: string[], count: number }}
+ */
+function cleanupStaleSkills(skillsDst, skillsSrc) {
+  const removed = [];
+  if (!existsSync(skillsDst)) return { removed, count: 0 };
+
+  const packageSkills = new Set();
+  if (existsSync(skillsSrc)) {
+    for (const name of readdirSync(skillsSrc)) {
+      packageSkills.add(name);
+    }
+  }
+  // aliases도 유효한 스킬로 등록
+  for (const { alias } of SKILL_ALIASES) {
+    packageSkills.add(alias);
+  }
+
+  for (const name of readdirSync(skillsDst)) {
+    // tfx- 접두사가 아닌 스킬은 사용자 커스텀 — 건드리지 않음
+    if (!name.startsWith("tfx-")) continue;
+    if (packageSkills.has(name)) continue;
+
+    // 패키지에 없는 tfx-* 스킬 → 삭제
+    const skillDir = join(skillsDst, name);
+    try {
+      rmSync(skillDir, { recursive: true, force: true });
+      removed.push(name);
+    } catch {
+      // 삭제 실패 시 무시
+    }
+  }
+  return { removed, count: removed.length };
+}
+
 function buildAliasedSkillContent(srcContent, { alias, source }) {
   return srcContent
     .replace(/^name:\s*.+$/m, `name: ${alias}`)
@@ -366,7 +415,9 @@ export {
   replaceProfileSection, hasProfileSection, escapeRegExp, detectDevMode,
   SYNC_MAP, BREADCRUMB_PATH, PLUGIN_ROOT, CLAUDE_DIR,
   SKILL_ALIASES, REQUIRED_CODEX_PROFILES,
+  DEPRECATED_SKILLS, LEGACY_CODEX_MODELS,
   buildAliasedSkillContent, syncAliasedSkillDir, getVersion, ensureCodexProfiles,
+  cleanupStaleSkills,
 };
 
 async function main() {
@@ -769,24 +820,70 @@ if (existsSync(HUB_PID_FILE)) {
 }
 
 // ── psmux 자동 설치 (Windows, headless 모드용) ──
+// psmux: Windows용 터미널 멀티플렉서. Codex/Gemini CLI를 병렬 세션으로 실행할 때 필요.
+// 없어도 triflux 기본 기능은 동작하지만, headless 멀티모델 오케스트레이션이 비활성화됨.
 
+let psmuxInstalled = false;
 if (process.platform === "win32") {
   try {
     execFileSync("where", ["psmux"], { stdio: "ignore" });
+    psmuxInstalled = true;
   } catch {
     // psmux 미설치 — winget으로 자동 설치 시도
-    console.log("  psmux 미설치 — winget으로 설치 중...");
+    console.log("  psmux 미설치 — 자동 설치 시도 중...");
     try {
       execFileSync("winget", ["install", "--id", "marlocarlo.psmux", "--accept-package-agreements", "--accept-source-agreements"], {
         stdio: ["ignore", "pipe", "pipe"],
         timeout: 60000,
       });
       console.log("  \x1b[32m✓\x1b[0m psmux 설치 완료");
+      psmuxInstalled = true;
       synced++;
     } catch {
-      console.log("  \x1b[33m⚠\x1b[0m psmux 자동 설치 실패 — 수동 설치: winget install psmux");
+      console.log([
+        "  \x1b[33m⚠\x1b[0m psmux 자동 설치 실패 — 수동 설치 방법:",
+        "    \x1b[36m옵션 1:\x1b[0m winget install marlocarlo.psmux",
+        "    \x1b[36m옵션 2:\x1b[0m scoop install psmux",
+        "    \x1b[36m옵션 3:\x1b[0m npm install -g psmux",
+        "  \x1b[2m(없어도 기본 기능은 동작합니다 — 멀티모델 병렬 실행만 비활성화)\x1b[0m",
+      ].join("\n"));
     }
   }
+} else {
+  // non-Windows: tmux 사용 (psmux 불필요)
+  psmuxInstalled = true;
+}
+
+// ── psmux 기본 셸 자동 수정 (cmd.exe → PowerShell) ──
+if (psmuxInstalled && process.platform === "win32") {
+  try {
+    const shellOut = execFileSync("psmux", ["show-options", "-g", "default-shell"], { encoding: "utf8", timeout: 3000, stdio: ["pipe", "pipe", "pipe"] }).trim();
+    if (!/powershell|pwsh/i.test(shellOut)) {
+      // pwsh(7) 우선, powershell.exe(5) fallback
+      let pwsh = "";
+      try { execFileSync("where", ["pwsh"], { stdio: "ignore" }); pwsh = "pwsh"; } catch {
+        try { execFileSync("where", ["powershell.exe"], { stdio: "ignore" }); pwsh = "powershell.exe"; } catch {}
+      }
+      if (pwsh) {
+        execFileSync("psmux", ["set-option", "-g", "default-shell", pwsh], { timeout: 3000, stdio: "ignore" });
+        console.log(`  \x1b[32m✓\x1b[0m psmux 기본 셸 → ${pwsh}`);
+        synced++;
+      }
+    }
+  } catch {
+    // psmux show-options 미지원 또는 서버 미실행 — 무시
+  }
+}
+
+// ── stale 스킬 정리 (패키지에서 제거된 tfx-* 스킬 삭제) ──
+{
+  const skillsDst = join(CLAUDE_DIR, "skills");
+  const skillsSrc = join(PLUGIN_ROOT, "skills");
+  const cleanup = cleanupStaleSkills(skillsDst, skillsSrc);
+  if (cleanup.count > 0) {
+    console.log(`  \x1b[32m✓\x1b[0m ${cleanup.count}개 구형 스킬 제거: ${cleanup.removed.join(", ")}`);
+    synced++;
+  }
 }
 
 // ── HUD 에러 캐시 자동 클리어 (업데이트/재설치 시) ──
@@ -907,6 +1004,7 @@ ${B}╚════════════════════════
   ${G}✓${R} hud-qos-status   → ~/.claude/hud/
   ${G}✓${R} ${synced > 0 ? synced + " files synced" : "all files up to date"}
   ${G}✓${R} HUD statusLine   → settings.json
+  ${psmuxInstalled ? `${G}✓${R} psmux            → headless 멀티모델 오케스트레이션` : `${Y}○${R} psmux 미설치     → ${D}winget install marlocarlo.psmux${R} ${D}(선택)${R}`}
 
 ${B}Commands:${R}
   ${C}triflux${R} setup     파일 동기화 + HUD 설정
@@ -930,6 +1028,19 @@ ${B}Skills (Claude Code):${R}
 ${Y}!${R} 세션 재시작 후 스킬이 활성화됩니다
 ${D}https://github.com/tellang/triflux${R}
 `);
+
+  // ── GitHub Star 체크 (비인터랙티브 — postinstall에서는 confirm 불가) ──
+  try {
+    execFileSync("gh", ["auth", "status"], { timeout: 5000, stdio: ["pipe", "pipe", "pipe"] });
+    try {
+      execFileSync("gh", ["api", "user/starred/tellang/triflux"], { timeout: 5000, stdio: ["pipe", "pipe", "pipe"] });
+      console.log(`  ${G}⭐${R} 이미 함께하고 계시군요.`);
+    } catch {
+      console.log(`  ${Y}⭐${R} 하나가 큰 차이를 만듭니다. ${D}https://github.com/tellang/triflux${R}`);
+    }
+  } catch {
+    // gh 미설치/미인증 — 무시
+  }
 }
 
 process.exit(0);