triflux 9.3.0 → 9.5.0

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "triflux",
-  "version": "9.0.0",
+  "version": "9.3.0",
   "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, rmSync, 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";
@@ -12,6 +12,11 @@ import { forceCleanupTeam } from "../hub/team/nativeProxy.mjs";
 import { cleanupStaleOmcTeams, inspectStaleOmcTeams } from "../hub/team/staleState.mjs";
 import { getPipelineStateDbPath } from "../hub/pipeline/state.mjs";
 import { ensureGeminiProfiles } from "../scripts/lib/gemini-profiles.mjs";
+import {
+  SYNC_MAP, SKILL_ALIASES, REQUIRED_CODEX_PROFILES, LEGACY_CODEX_MODELS,
+  syncAliasedSkillDir, hasProfileSection, replaceProfileSection,
+  ensureCodexProfiles, getVersion, cleanupStaleSkills, DEPRECATED_SKILLS,
+} from "../scripts/setup.mjs";
 
 const PKG_ROOT = dirname(dirname(fileURLToPath(import.meta.url)));
 const CLAUDE_DIR = join(homedir(), ".claude");
@@ -22,72 +27,6 @@ const PKG = JSON.parse(readFileSync(join(PKG_ROOT, "package.json"), "utf8"));
 // 이 배열에 포함된 버전에서만 star prompt를 표시한다 (빈 배열 = 모든 버전에서 표시)
 const STAR_PROMPT_VERSIONS = [];
 
-const REQUIRED_CODEX_PROFILES = [
-  {
-    name: "codex53_high",
-    lines: [
-      'model = "gpt-5.3-codex"',
-      'model_reasoning_effort = "high"',
-    ],
-  },
-  {
-    name: "codex53_xhigh",
-    lines: [
-      'model = "gpt-5.3-codex"',
-      'model_reasoning_effort = "xhigh"',
-    ],
-  },
-  {
-    name: "spark53_low",
-    lines: [
-      'model = "gpt-5.3-codex-spark"',
-      'model_reasoning_effort = "low"',
-    ],
-  },
-];
-
-const SKILL_ALIASES = [
-  {
-    alias: "tfx-ralph",
-    source: "tfx-persist",
-  },
-];
-
-function buildAliasedSkillContent(srcContent, { alias, source }) {
-  return srcContent
-    .replace(/^name:\s*.+$/m, `name: ${alias}`)
-    .replaceAll(source, alias)
-    .replace(/^#\s+.+$/m, `# ${alias} — Compatibility Alias for ${source}`);
-}
-
-function syncAliasedSkillDir(srcDir, dstDir, { alias, source }) {
-  if (!existsSync(dstDir)) mkdirSync(dstDir, { recursive: true });
-
-  let count = 0;
-  for (const entry of readdirSync(srcDir, { withFileTypes: true })) {
-    const srcPath = join(srcDir, entry.name);
-    const dstPath = join(dstDir, entry.name);
-
-    if (entry.isDirectory()) {
-      count += syncAliasedSkillDir(srcPath, dstPath, { alias, source });
-      continue;
-    }
-
-    if (!entry.name.endsWith(".md")) continue;
-
-    const rawContent = readFileSync(srcPath, "utf8");
-    const nextContent = entry.name === "SKILL.md"
-      ? buildAliasedSkillContent(rawContent, { alias, source })
-      : rawContent;
-
-    if (!existsSync(dstPath) || readFileSync(dstPath, "utf8") !== nextContent) {
-      writeFileSync(dstPath, nextContent, "utf8");
-      count++;
-    }
-  }
-
-  return count;
-}
 
 // ── 색상 체계 (triflux brand: amber/orange accent) ──
 const CYAN = "\x1b[36m";
@@ -328,13 +267,6 @@ function checkShellAvailable(shell) {
   } catch { return false; }
 }
 
-function getVersion(filePath) {
-  try {
-    const content = readFileSync(filePath, "utf8");
-    const match = content.match(/VERSION\s*=\s*"([^"]+)"/);
-    return match ? match[1] : null;
-  } catch { return null; }
-}
 
 function parseSessionCreated(rawValue) {
   const value = String(rawValue || "").trim();
@@ -459,57 +391,35 @@ async function cleanupStaleTeamSessions(staleSessions) {
   return { cleaned, failed };
 }
 
-function escapeRegExp(value) {
-  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-}
-
-function hasProfileSection(tomlContent, profileName) {
-  const section = `^\\[profiles\\.${escapeRegExp(profileName)}\\]\\s*$`;
-  return new RegExp(section, "m").test(tomlContent);
-}
-
-function ensureCodexProfiles() {
-  try {
-    if (!existsSync(CODEX_DIR)) mkdirSync(CODEX_DIR, { recursive: true });
-
-    const original = existsSync(CODEX_CONFIG_PATH)
-      ? readFileSync(CODEX_CONFIG_PATH, "utf8")
-      : "";
-
-    let updated = original;
-    let added = 0;
 
-    for (const profile of REQUIRED_CODEX_PROFILES) {
-      if (hasProfileSection(updated, profile.name)) continue;
+function previewCodexProfiles() {
+  const original = existsSync(CODEX_CONFIG_PATH)
+    ? readFileSync(CODEX_CONFIG_PATH, "utf8")
+    : "";
+  let updated = original;
+  const profiles = [];
 
+  for (const profile of REQUIRED_CODEX_PROFILES) {
+    const before = updated;
+    if (hasProfileSection(updated, profile.name)) {
+      updated = replaceProfileSection(updated, profile.name, profile.lines);
+    } else {
       if (updated.length > 0 && !updated.endsWith("\n")) updated += "\n";
       if (updated.trim().length > 0) updated += "\n";
       updated += `[profiles.${profile.name}]\n${profile.lines.join("\n")}\n`;
-      added++;
     }
-
-    if (added > 0) {
-      writeFileSync(CODEX_CONFIG_PATH, updated, "utf8");
+    if (updated !== before) {
+      profiles.push(profile.name);
     }
-
-    return { ok: true, added };
-  } catch (e) {
-    return { ok: false, added: 0, message: e.message };
   }
-}
 
-function previewCodexProfiles() {
-  const original = existsSync(CODEX_CONFIG_PATH)
-    ? readFileSync(CODEX_CONFIG_PATH, "utf8")
-    : "";
-  const missingProfiles = REQUIRED_CODEX_PROFILES
-    .filter((profile) => !hasProfileSection(original, profile.name))
-    .map((profile) => profile.name);
+  const windowsSandbox = process.platform === "win32" && !updated.includes("[windows]");
 
   return {
     path: CODEX_CONFIG_PATH,
-    missingProfiles,
-    change: missingProfiles.length > 0 ? (original ? "update" : "create") : "noop",
+    profiles,
+    windowsSandbox,
+    change: profiles.length > 0 || windowsSandbox ? (original ? "update" : "create") : "noop",
   };
 }
 
@@ -637,101 +547,6 @@ function checkCliCrossShell(cmd, installHint) {
 
 // ── 명령어 ──
 
-function getSetupSyncTargets() {
-  return [
-    {
-      src: join(PKG_ROOT, "scripts", "tfx-route.sh"),
-      dst: join(CLAUDE_DIR, "scripts", "tfx-route.sh"),
-      label: "tfx-route.sh",
-    },
-    {
-      src: join(PKG_ROOT, "hud", "hud-qos-status.mjs"),
-      dst: join(CLAUDE_DIR, "hud", "hud-qos-status.mjs"),
-      label: "hud-qos-status.mjs",
-    },
-    {
-      src: join(PKG_ROOT, "scripts", "notion-read.mjs"),
-      dst: join(CLAUDE_DIR, "scripts", "notion-read.mjs"),
-      label: "notion-read.mjs",
-    },
-    {
-      src: join(PKG_ROOT, "scripts", "tfx-route-post.mjs"),
-      dst: join(CLAUDE_DIR, "scripts", "tfx-route-post.mjs"),
-      label: "tfx-route-post.mjs",
-    },
-    {
-      src: join(PKG_ROOT, "scripts", "tfx-batch-stats.mjs"),
-      dst: join(CLAUDE_DIR, "scripts", "tfx-batch-stats.mjs"),
-      label: "tfx-batch-stats.mjs",
-    },
-    {
-      src: join(PKG_ROOT, "scripts", "lib", "mcp-filter.mjs"),
-      dst: join(CLAUDE_DIR, "scripts", "lib", "mcp-filter.mjs"),
-      label: "lib/mcp-filter.mjs",
-    },
-    {
-      src: join(PKG_ROOT, "scripts", "lib", "mcp-server-catalog.mjs"),
-      dst: join(CLAUDE_DIR, "scripts", "lib", "mcp-server-catalog.mjs"),
-      label: "lib/mcp-server-catalog.mjs",
-    },
-    {
-      src: join(PKG_ROOT, "scripts", "lib", "keyword-rules.mjs"),
-      dst: join(CLAUDE_DIR, "scripts", "lib", "keyword-rules.mjs"),
-      label: "lib/keyword-rules.mjs",
-    },
-    {
-      src: join(PKG_ROOT, "scripts", "lib", "gemini-profiles.mjs"),
-      dst: join(CLAUDE_DIR, "scripts", "lib", "gemini-profiles.mjs"),
-      label: "lib/gemini-profiles.mjs",
-    },
-    {
-      src: join(PKG_ROOT, "scripts", "tfx-route-worker.mjs"),
-      dst: join(CLAUDE_DIR, "scripts", "tfx-route-worker.mjs"),
-      label: "tfx-route-worker.mjs",
-    },
-    {
-      src: join(PKG_ROOT, "hub", "workers", "codex-mcp.mjs"),
-      dst: join(CLAUDE_DIR, "scripts", "hub", "workers", "codex-mcp.mjs"),
-      label: "hub/workers/codex-mcp.mjs",
-    },
-    {
-      src: join(PKG_ROOT, "hub", "workers", "delegator-mcp.mjs"),
-      dst: join(CLAUDE_DIR, "scripts", "hub", "workers", "delegator-mcp.mjs"),
-      label: "hub/workers/delegator-mcp.mjs",
-    },
-    {
-      src: join(PKG_ROOT, "hub", "workers", "interface.mjs"),
-      dst: join(CLAUDE_DIR, "scripts", "hub", "workers", "interface.mjs"),
-      label: "hub/workers/interface.mjs",
-    },
-    {
-      src: join(PKG_ROOT, "hub", "workers", "gemini-worker.mjs"),
-      dst: join(CLAUDE_DIR, "scripts", "hub", "workers", "gemini-worker.mjs"),
-      label: "hub/workers/gemini-worker.mjs",
-    },
-    {
-      src: join(PKG_ROOT, "hub", "workers", "claude-worker.mjs"),
-      dst: join(CLAUDE_DIR, "scripts", "hub", "workers", "claude-worker.mjs"),
-      label: "hub/workers/claude-worker.mjs",
-    },
-    {
-      src: join(PKG_ROOT, "hub", "workers", "factory.mjs"),
-      dst: join(CLAUDE_DIR, "scripts", "hub", "workers", "factory.mjs"),
-      label: "hub/workers/factory.mjs",
-    },
-    {
-      src: join(PKG_ROOT, "scripts", "remote-spawn.mjs"),
-      dst: join(CLAUDE_DIR, "scripts", "remote-spawn.mjs"),
-      label: "remote-spawn.mjs",
-    },
-    {
-      src: join(PKG_ROOT, "hub", "team", "psmux.mjs"),
-      dst: join(CLAUDE_DIR, "hub", "team", "psmux.mjs"),
-      label: "hub/team/psmux.mjs",
-    },
-  ];
-}
-
 function listSkillSyncActions() {
   const skillsSrc = join(PKG_ROOT, "skills");
   if (!existsSync(skillsSrc)) return [];
@@ -816,7 +631,7 @@ function previewMcpRegistrationActions(mcpUrl) {
 
 function buildSetupDryRunPlan() {
   const actions = [
-    ...getSetupSyncTargets().map(({ src, dst, label }) => describeSyncAction(src, dst, label)),
+    ...SYNC_MAP.map(({ src, dst, label }) => describeSyncAction(src, dst, label)),
     ...listSkillSyncActions(),
   ];
   const codexProfiles = previewCodexProfiles();
@@ -824,7 +639,8 @@ function buildSetupDryRunPlan() {
     type: "codex-profiles",
     path: codexProfiles.path,
     change: codexProfiles.change,
-    profiles: codexProfiles.missingProfiles,
+    profiles: codexProfiles.profiles,
+    windowsSandbox: codexProfiles.windowsSandbox,
   });
 
   const defaultHubUrl = `http://127.0.0.1:${process.env.TFX_HUB_PORT || "27888"}/mcp`;
@@ -846,7 +662,7 @@ function cmdSetup(options = {}) {
 
   console.log(`\n${BOLD}triflux setup${RESET}\n`);
 
-  for (const target of getSetupSyncTargets()) {
+  for (const target of SYNC_MAP) {
     syncFile(target.src, target.dst, target.label);
   }
 
@@ -904,6 +720,11 @@ function cmdSetup(options = {}) {
     } else {
       ok(`스킬: ${skillTotal}개 최신 상태`);
     }
+    // Stale 스킬 정리 (패키지에서 제거된 tfx-* 스킬 삭제)
+    const staleCleanup = cleanupStaleSkills(skillsDst, skillsSrc);
+    if (staleCleanup.count > 0) {
+      ok(`구형 스킬 ${staleCleanup.count}개 제거: ${staleCleanup.removed.join(", ")}`);
+    }
   }
 
   // ── 결과 추적 ──
@@ -913,9 +734,9 @@ function cmdSetup(options = {}) {
   if (!codexProfileResult.ok) {
     warn(`Codex profiles 설정 실패: ${codexProfileResult.message}`);
     summary.push({ item: "Codex profiles", status: "⚠️", detail: codexProfileResult.message });
-  } else if (codexProfileResult.added > 0) {
-    ok(`Codex profiles: ${codexProfileResult.added}개 추가됨 (~/.codex/config.toml)`);
-    summary.push({ item: "Codex profiles", status: "✅", detail: `${codexProfileResult.added}개 추가됨` });
+  } else if (codexProfileResult.changed > 0) {
+    ok(`Codex profiles: ${codexProfileResult.changed}개 반영됨 (~/.codex/config.toml)`);
+    summary.push({ item: "Codex profiles", status: "✅", detail: `${codexProfileResult.changed}개 반영됨` });
   } else {
     ok("Codex profiles: 이미 준비됨");
     summary.push({ item: "Codex profiles", status: "✅", detail: "이미 준비됨" });
@@ -1006,22 +827,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}`);
     }
   }
 
@@ -1158,7 +1012,7 @@ async function cmdDoctor(options = {}) {
     // ── fix 모드: 파일 동기화 + 캐시 정리 후 진단 ──
     if (fix) {
     section("Auto Fix");
-    for (const target of getSetupSyncTargets()) {
+    for (const target of SYNC_MAP) {
       syncFile(target.src, target.dst, target.label);
     }
     // 스킬 동기화
@@ -1182,8 +1036,8 @@ async function cmdDoctor(options = {}) {
     const profileFix = ensureCodexProfiles();
     if (!profileFix.ok) {
       warn(`Codex Profiles 자동 복구 실패: ${profileFix.message}`);
-    } else if (profileFix.added > 0) {
-      ok(`Codex Profiles: ${profileFix.added}개 추가됨`);
+    } else if (profileFix.changed > 0) {
+      ok(`Codex Profiles: ${profileFix.changed}개 반영됨`);
     } else {
       info("Codex Profiles: 이미 최신 상태");
     }
@@ -1263,7 +1117,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}: 미설정`);
@@ -1283,6 +1139,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");
@@ -1295,6 +1163,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");
@@ -1307,7 +1191,38 @@ 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 {
+          warn("기본 셸이 cmd.exe — headless 명령 실패 가능");
+          info("수정: psmux set-option -g default-shell \"powershell.exe\"");
+          addDoctorCheck(report, { name: "psmux", status: "issues", path: psmuxPath, shell: "cmd", fix: 'psmux set-option -g default-shell "powershell.exe"' });
+          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");
@@ -1337,7 +1252,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)) {
@@ -1355,7 +1295,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)) {
@@ -1424,7 +1364,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)) {
@@ -1504,7 +1444,7 @@ async function cmdDoctor(options = {}) {
     ok("이슈 로그 없음 (정상)");
   }
 
-  // 11. Team Sessions
+  // 12. Team Sessions
   section("Team Sessions");
   const teamSessionReport = inspectTeamSessions();
   if (!teamSessionReport.mux) {
@@ -1554,7 +1494,7 @@ async function cmdDoctor(options = {}) {
     }
   }
 
-  // 12. OMC stale team 상태
+  // 13. OMC stale team 상태
   section("OMC Stale Teams");
   const omcTeamReport = inspectStaleOmcTeams({
     startDir: process.cwd(),
@@ -1644,7 +1584,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/pipe.mjs

@@ -18,6 +18,7 @@ import {
   listPipelineStates,
   readPipelineState,
 } from './pipeline/state.mjs';
+import { safeJsonParse } from './workers/worker-utils.mjs';
 
 const DEFAULT_HEARTBEAT_TTL_MS = 60000;
 
@@ -29,14 +30,6 @@ export function getPipePath(sessionId = process.pid) {
   return join('/tmp', `triflux-${sessionId}.sock`);
 }
 
-function safeJsonParse(line) {
-  try {
-    return JSON.parse(line);
-  } catch {
-    return null;
-  }
-}
-
 function normalizeTopics(topics) {
   if (!Array.isArray(topics)) return [];
   return topics