triflux 10.53.0 → 10.54.0

package/README.ko.md

@@ -18,10 +18,6 @@
   <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-374151?style=flat-square" alt="License: MIT"></a>
 </p>
 
-<p align="center">
-  <img alt="triflux demo" src="docs/assets/demo-multi.gif" width="680">
-</p>
-
 triflux는 코딩 작업을 Claude, Codex, Antigravity 사이에서 나눠 맡기는 Claude Code 플러그인이자
 npm CLI다. `/tfx-auto`에 할 일을 한 번 적으면 triflux가 CLI 레인(기본은 Codex)을 고르고, 임의
 셸 명령 대신 관리된 경로로 실행한다. 필요하면 로컬 병렬 워커, Claude↔Codex 라이브 세션, 원격 호스트로 작업을 나눈다.
@@ -135,7 +131,6 @@ Codex는 이름 붙은 프로필로 실행한다. 모델 ID는 `~/.codex/<프로
 | `tfx setup` / `tfx doctor` | 파일·HUD·MCP·프로필 동기화 / 진단과 복구(`--fix`, `--json`) |
 | `tfx multi` | tmux 기반 로컬 멀티 CLI 팀 |
 | `tfx mcp` | 관리형 MCP 레지스트리: `list`, `sync`, `add`, `remove` |
-| `tfx cto` | 저장소 단위 권위 콘솔: `collect`, `status`, `hygiene`(dry-run) |
 | `bash ~/.claude/scripts/tfx-route.sh code-reviewer "<지시>"` | 정책에 따라 `codex exec review`로 리뷰 전달 |
 | `tfx list`, `tfx update`, `tfx version` | 설치된 스킬, 업데이트, 버전 |
 | `tfx-live` | 라이브 세션 브리지(`/tfx-live` 스킬과 같은 명령) |
@@ -169,11 +164,6 @@ Claude Code Bash 도구의 600초 제한에 걸리지 않는다. 이후 `--job-s
 다른 경로로 넘어가지 않고 실패한다. 자세한 내용은
 [`.claude/rules/tfx-machine-profile.md`](.claude/rules/tfx-machine-profile.md).
 
-**CTO lake.** `tfx cto collect`로 `.triflux/lake/`의 저장소 스냅샷을 갱신하고,
-`tfx cto status`로 생성 시각과 경과 시간을 확인한다. `tfx cto hygiene --dry-run`는 dry-run 결과를
-보고한다. 트레이와 쓰이지 않는 CTO 운영 명령은 제거하였다
-([ADR-0024](docs/adr/0024-cto-explicit-queries-only.md)). 자동 수집은 기본으로 꺼져 있고 `TFX_CTO_AUTO_COLLECT=1` 로 켠다([ADR-0018](docs/_archive/adr/0018-cto-auto-behaviors-opt-in.md)).
-
 **원격 호스트.** `/tfx-remote`는 `~/.config/triflux/hosts.json`
 (Windows는 `%APPDATA%\triflux\hosts.json`)에서 호스트를 읽는다. 세션 시작은
 `remote-spawn.mjs`의 `--host <host> --prompt "<요청>"` 옵션을 사용한다.
@@ -184,18 +174,22 @@ Claude Code Bash 도구의 600초 제한에 걸리지 않는다. 이후 `--job-s
 ```mermaid
 graph TD
     User([Claude Code 프롬프트 / 셸]) --> Skills["/tfx-auto · /tfx-live · /tfx-remote"]
+    User --> Lead["/tfx-lead"]
     User --> CLI[tfx CLI]
+    Lead -->|"지시서, 교차 리뷰, 머지"| Live
     Skills --> Route[tfx-route.sh]
     Skills --> Live[tfx-live]
     CLI --> Team["tfx multi"]
     Route --> Codex[Codex CLI]
     Route --> Agy[Antigravity agy]
     Route --> Claude[Claude Code]
-    Team --> Route
-    Live -->|UDS 또는 tmux| Sessions[Claude / Codex TUI 세션]
-    Route --> UI["HUD · claude agents 패널"]
-    Team --> UI
-    CLI --> Lake[(".triflux/lake (tfx cto)")]
+    Team -->|headless 워커| Route
+    Team --> Index[("결과 색인: tfx-headless/*.results.json")]
+    Team --> Rows["claude agents 행"]
+    Rows -->|Enter| Room["워커 tmux 방"]
+    Live -->|"codex queue, tmux 폴백"| CodexTUI[Codex TUI 세션]
+    Live -->|"UDS 또는 tmux"| ClaudeTUI[Claude Code 세션]
+    Route --> HUD[HUD]
 ```
 
 패키지 구성과 실행 경로는 [ARCHITECTURE.md](ARCHITECTURE.md), 문서 지도는

package/README.md

@@ -18,10 +18,6 @@
   <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-374151?style=flat-square" alt="License: MIT"></a>
 </p>
 
-<p align="center">
-  <img alt="triflux demo" src="docs/assets/demo-multi.gif" width="680">
-</p>
-
 triflux is a Claude Code plugin and npm CLI that routes coding work across Claude, Codex,
 and Antigravity. You describe the task once with `/tfx-auto`; triflux picks the CLI lane
 (Codex by default), runs it through managed routes instead of ad-hoc shell commands, and
@@ -137,7 +133,6 @@ escalation chain: [`.claude/rules/tfx-escalation-chain.md`](.claude/rules/tfx-es
 | `tfx setup` / `tfx doctor` | Sync files, HUD, MCP, profiles / diagnose and repair (`--fix`, `--json`) |
 | `tfx multi` | Local multi-CLI team in tmux |
 | `tfx mcp` | Managed MCP registry: `list`, `sync`, `add`, `remove` |
-| `tfx cto` | Repo-local authority console: `collect`, `status`, `hygiene` (dry-run) |
 | `bash ~/.claude/scripts/tfx-route.sh code-reviewer "<instruction>"` | Send review to Codex (`codex exec review` via policy) |
 | `tfx list`, `tfx update`, `tfx version` | Installed skills, update, version |
 | `tfx-live` | Live session bridge (same as the `/tfx-live` skill) |
@@ -171,32 +166,31 @@ tmux pane the worker runs in.
 removes a CLI from routing; if no allowed CLI is available the route fails instead of silently
 falling back. Details: [`.claude/rules/tfx-machine-profile.md`](.claude/rules/tfx-machine-profile.md).
 
-**CTO lake.** Run `tfx cto collect` to refresh the repo snapshot in `.triflux/lake/`, then
-`tfx cto status` to inspect it with its generation time and age. `tfx cto hygiene --dry-run` reports
-dry-run findings. The tray and unused CTO operating commands were removed
-([ADR-0024](docs/adr/0024-cto-explicit-queries-only.md)). Automatic collection stays off unless `TFX_CTO_AUTO_COLLECT=1` is set ([ADR-0018](docs/_archive/adr/0018-cto-auto-behaviors-opt-in.md)).
-
-**원격 호스트.** `/tfx-remote`는 `~/.config/triflux/hosts.json`에서 호스트를 읽는다
-(Windows: `%APPDATA%\triflux\hosts.json`). 세션 시작은 `remote-spawn.mjs`의
-`--host <host> --prompt "<요청>"` 옵션을 사용한다. [실행 옵션](skills/tfx-remote/SKILL.md)을 따른다.
+**Remote hosts.** `/tfx-remote` reads hosts from `~/.config/triflux/hosts.json`
+(Windows: `%APPDATA%\triflux\hosts.json`). Start a session with `remote-spawn.mjs`
+`--host <host> --prompt "<request>"`. Options: [skills/tfx-remote/SKILL.md](skills/tfx-remote/SKILL.md).
 
 ## Architecture
 
 ```mermaid
 graph TD
     User([Claude Code prompt / shell]) --> Skills["/tfx-auto · /tfx-live · /tfx-remote"]
+    User --> Lead["/tfx-lead"]
     User --> CLI[tfx CLI]
+    Lead -->|"briefs, cross review, merge"| Live
     Skills --> Route[tfx-route.sh]
     Skills --> Live[tfx-live]
     CLI --> Team["tfx multi"]
     Route --> Codex[Codex CLI]
     Route --> Agy[Antigravity agy]
     Route --> Claude[Claude Code]
-    Team --> Route
-    Live -->|UDS or tmux| Sessions[Claude / Codex TUI sessions]
-    Route --> UI["HUD · claude agents panel"]
-    Team --> UI
-    CLI --> Lake[(".triflux/lake (tfx cto)")]
+    Team -->|headless workers| Route
+    Team --> Index[("results index: tfx-headless/*.results.json")]
+    Team --> Rows["claude agents rows"]
+    Rows -->|Enter| Room["worker tmux room"]
+    Live -->|"codex queue, tmux fallback"| CodexTUI[Codex TUI sessions]
+    Live -->|"UDS or tmux"| ClaudeTUI[Claude Code sessions]
+    Route --> HUD[HUD]
 ```
 
 Package layout and execution paths: [ARCHITECTURE.md](ARCHITECTURE.md). Documentation map:

package/adapters/codex/skills/tfx-live/SKILL.md

@@ -114,7 +114,7 @@ Codex `wait`는 `--session` 또는 `--thread UUID`의 rollout에서 표식이
 
 명시한 `--config-dir`은 정확히 일치하는 daemon만 선택한다. `CLAUDE_CONFIG_DIR`도 해당 env 디렉터리로 제한한다. stale endpoint 복구는 같은 source configDir 안에서만 재시도한다. attach 전 예외는 `inputSent: false`이므로 `auto`의 tmux fallback이 가능하다. attach 뒤 전송 여부가 불명확하면 `status: "unknown"`으로 보고하고 재전송하지 않는다.
 
-직접 `tmux capture-pane`과 `tmux send-keys`를 쓸 때는 전송·pane 진단에 한정한다. Claude pane에 `C-c`를 보내지 않는다. 자동 세션 탐색에는 `tmr ls --json`을 사용한다.
+직접 `tmux capture-pane`과 `tmux send-keys`를 쓸 때는 전송·pane 진단에 한정한다. Claude pane에 `C-c`를 보내지 않는다. 자동 세션 탐색에는 `tmr ls --json`으로 pane 별 에이전트, 상태, 클라이언트 수, 마지막 활동을 본다. tmr 이 없으면 아래 `tfx-live list-sessions`와 `tmux ls -F '#{session_name} #{session_attached}'`를 쓴다. tmr 은 macOS(arm64) 에서 `tfx setup` 이 설치를 묻는다.
 
 ## 세션 탐색과 연결
 

package/bin/tfx-live.mjs

@@ -11,7 +11,7 @@ import {
   stat,
   writeFile,
 } from "node:fs/promises";
-import { homedir, tmpdir } from "node:os";
+import { homedir } from "node:os";
 import { join as pathJoin, resolve as pathResolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { promisify } from "node:util";
@@ -20,6 +20,7 @@ import {
   readCodexSessionRecords,
   registryDir,
 } from "../hub/lib/codex-session-registry.mjs";
+import { privateTmpDir } from "../hub/lib/private-tmp.mjs";
 import { resolveHardCeilingMs } from "../hub/lib/worker-lifecycle.mjs";
 import { exposeLiveSession } from "../hub/team/agents-row.mjs";
 import {
@@ -1932,8 +1933,9 @@ async function callBridgeVerb(bridgePath, verb, payload, timeoutMs) {
   let payloadFile = null;
   let args;
   if (json.length > PAYLOAD_FILE_THRESHOLD) {
+    // 페이로드에 프롬프트가 들어 있어 사용자별 0700 디렉터리에 쓴다.
     payloadFile = pathJoin(
-      tmpdir(),
+      privateTmpDir("tfx-live"),
       `codex-live-payload-${process.pid}-${Date.now()}.json`,
     );
     await writeFile(payloadFile, json, "utf8");
@@ -4098,13 +4100,11 @@ function peerArtifactPaths(sessionA, sessionB) {
   const preferredDir =
     process.env.TFX_LIVE_ARTIFACT_DIR ??
     pathJoin(homedir(), ".claude", "cache", "triflux", "tfx-live", "peer-runs");
-  const fallbackDir = pathJoin(tmpdir(), "triflux-live");
   let artifactDir = preferredDir;
   try {
     mkdirSync(artifactDir, { recursive: true });
   } catch {
-    artifactDir = fallbackDir;
-    mkdirSync(artifactDir, { recursive: true });
+    artifactDir = privateTmpDir("tfx-live");
   }
   const safe = (value) =>
     String(value)

package/bin/triflux.mjs

@@ -36,7 +36,10 @@ import {
   inspectMacTimeoutDependency,
 } from "../scripts/lib/doctor-env-checks.mjs";
 import { ensureGeminiProfiles } from "../scripts/lib/gemini-profiles.mjs";
-import { cleanupLegacyHooks } from "../scripts/lib/legacy-hook-cleanup.mjs";
+import {
+  cleanupAgyHooks,
+  cleanupLegacyHooks,
+} from "../scripts/lib/legacy-hook-cleanup.mjs";
 import {
   cleanupLegacyMcp,
   cleanupTfxHub,
@@ -58,19 +61,20 @@ import {
   formatPsmuxUpdateGuidance,
   probePsmuxSupport,
 } from "../scripts/lib/psmux-info.mjs";
+import { writesRealHomeInTest } from "../scripts/lib/test-env.mjs";
 import {
   applyStatusLine,
+  cleanupStaleSkills,
   ensureCodexProfiles,
   ensureTrifluxMods,
   getVersion,
-  isLocalDevSkillDir,
   isSkillSupportedOnPlatform,
   LEGACY_CODEX_MODELS,
   listInlineProfileNames,
   persistSettings,
-  REMOVED_SKILL_NAMES,
   REQUIRED_CODEX_PROFILES,
-  SKILL_ALIASES,
+  retireOldInstallFiles,
+  runConsentSteps,
   SYNC_MAP,
   syncSkills,
 } from "../scripts/setup.mjs";
@@ -265,16 +269,6 @@ const CLI_COMMAND_SCHEMAS = Object.freeze({
       },
     },
   },
-  cto: {
-    usage: "tfx cto <collect|status|hygiene> [options]",
-    description: "repo-local authority layer console",
-    subcommands: {
-      collect: "refresh .triflux/lake/current.json from authority sources",
-      status: "print the current authority summary",
-      hygiene:
-        "project CTO hygiene counts and actionable dry-run rows (--dry-run)",
-    },
-  },
   multi: {
     usage:
       "tfx multi [--dashboard-layout lite|single|split-2col|split-3col|auto] <subcommand|task>",
@@ -311,15 +305,10 @@ const CLI_COMMAND_SCHEMAS = Object.freeze({
     },
   },
   update: {
-    usage: "tfx update [--dev]",
+    usage: "tfx update",
     description:
       "설치 방식(plugin/npm/git)을 감지해 triflux를 업데이트하고 setup/cache를 재동기화",
     options: [
-      {
-        name: "--dev / dev",
-        type: "boolean",
-        description: "npm 설치 모드에서 dev tag로 업데이트",
-      },
       {
         name: "--help",
         type: "boolean",
@@ -550,12 +539,6 @@ function whichInShell(cmd, shell) {
   }
 }
 
-function isDevUpdateRequested(argv = process.argv) {
-  return (
-    argv.includes("--dev") || argv.includes("@dev") || argv.includes("dev")
-  );
-}
-
 function checkShellAvailable(shell) {
   const cmds = {
     bash: "bash --version",
@@ -703,7 +686,7 @@ function sumMemoryEstimateMb(panes, { execFile = execFileSync } = {}) {
   return seen ? total : null;
 }
 
-export function inspectDetachedTmuxSessions({
+function inspectDetachedTmuxSessions({
   prefix = DEFAULT_TMUX_CLEANUP_PREFIX,
   ageMin = DEFAULT_TMUX_CLEANUP_AGE_MIN,
   platform = process.platform,
@@ -782,7 +765,7 @@ export function inspectDetachedTmuxSessions({
   };
 }
 
-export async function cleanupDetachedTmuxSessions({
+async function cleanupDetachedTmuxSessions({
   sessions,
   dryRun = true,
   apply = false,
@@ -1129,12 +1112,6 @@ function listSkillSyncActions() {
     if (!isSkillSupportedOnPlatform(join(skillsSrc, name))) continue;
     actions.push(describeSyncAction(src, dst, `skill:${name}`));
   }
-  for (const { alias, source } of SKILL_ALIASES) {
-    const src = join(skillsSrc, source, "SKILL.md");
-    const dst = join(CLAUDE_DIR, "skills", alias, "SKILL.md");
-    if (!existsSync(src)) continue;
-    actions.push(describeSyncAction(src, dst, `skill-alias:${alias}`));
-  }
   return actions;
 }
 
@@ -1242,7 +1219,7 @@ function reportSkillSync() {
   ok(`스킬: ${result.total}개 확인, 파일 ${result.changed}개 반영`);
 }
 
-function cmdSetup(options = {}) {
+async function cmdSetup(options = {}) {
   const {
     dryRun = false,
     fromUpdate = false,
@@ -1253,6 +1230,10 @@ function cmdSetup(options = {}) {
     printJson(buildSetupDryRunPlan());
     return;
   }
+  if (writesRealHomeInTest()) {
+    info("setup: skip (테스트가 홈을 격리하지 않음)");
+    return;
+  }
 
   const cleanup = cleanupLegacyHooks({
     settingsPath: join(CLAUDE_DIR, "settings.json"),
@@ -1264,10 +1245,18 @@ function cmdSetup(options = {}) {
       fix: `${join(CLAUDE_DIR, "settings.json")}의 JSON 문법과 쓰기 권한을 확인하세요.`,
     });
   }
+  // agy 는 hooks.json 의 훅을 실행하므로 지워진 훅 스크립트를 가리키는 항목을 남기지 않는다.
+  const agyCleanup = cleanupAgyHooks();
+  if (agyCleanup.changed) ok("agy 옛 triflux-session 훅 정리됨");
+  else if (!agyCleanup.ok) warn(`agy 옛 훅 정리 실패: ${agyCleanup.error}`);
   // 이주가 막혀도 setup 은 계속한다. 남은 항목은 경고로 알린다.
-  for (const warning of cleanupLegacyMcp().warnings) warn(warning);
+  const mcpBackups = new Map();
+  for (const warning of cleanupLegacyMcp({ backups: mcpBackups }).warnings)
+    warn(warning);
   const hubCleanup = cleanupTfxHub({
     pluginRoot: existsSync(join(PKG_ROOT, ".git")) ? undefined : PKG_ROOT,
+    log: info,
+    backups: mcpBackups,
   });
   for (const warning of hubCleanup.warnings) warn(warning);
   if (hubCleanup.changed) ok("제거된 허브의 설정과 실행 흔적 정리");
@@ -1278,35 +1267,10 @@ function cmdSetup(options = {}) {
   for (const target of SYNC_MAP) {
     syncFile(target.src, target.dst, target.label);
   }
+  retireOldInstallFiles(info);
   reportSkillSync();
   ensureTrifluxMods({ install: mods, log: console.log, warn });
 
-  // ── 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 서버 미실행 — 무시 */
-    }
-  }
-
   // ── 결과 추적 ──
   const summary = [];
 
@@ -1402,6 +1366,35 @@ function cmdSetup(options = {}) {
     });
   }
 
+  // Codex 프로필 정리가 끝난 뒤에 훅을 다룬다.
+  await runConsentSteps({ log: info, warn });
+
+  // ── 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 서버 미실행이면 무시 */
+    }
+  }
+
   // CLI 존재 확인
   const cliChecks = [
     { name: "codex", install: "npm i -g @openai/codex" },
@@ -1510,6 +1503,16 @@ function statusBadge(status) {
   }
 }
 
+// URL 은 같고 헤더만 다르면 그렇게 보여 준다. URL 만 찍으면 같은 값끼리 불일치로 보인다.
+function isHeaderOnlyMismatch(row) {
+  return Boolean(row.expectedUrl) && row.expectedUrl === row.actualUrl;
+}
+
+// stdio 항목은 명령이 같고 인자만 다를 수 있어 인자까지 보여 준다.
+function mcpTarget(url, command, args = []) {
+  return url || [command, ...args].filter(Boolean).join(" ");
+}
+
 function buildMcpStatusRows(statusInfo) {
   const registryRows = statusInfo.rows
     .filter((row) => row.type === "registry")
@@ -1520,7 +1523,9 @@ function buildMcpStatusRows(statusInfo) {
       else if (row.status === "missing") detail = "registry only";
       else if (row.status === "missing-file") detail = "config missing";
       else if (row.status === "mismatch")
-        detail = `expected ${row.expectedUrl || row.expectedCommand}`;
+        detail = isHeaderOnlyMismatch(row)
+          ? `header ${row.headerStatus}: ${row.expectedHeaderNames.join(", ")}`
+          : `expected ${mcpTarget(row.expectedUrl, row.expectedCommand, row.expectedArgs)}`;
       else if (row.status === "invalid-config") detail = "parse error";
       else if (row.status === "skipped") detail = row.message || "skipped";
       else if (row.status === "stdio") detail = "configured as stdio";
@@ -2260,38 +2265,29 @@ async function cmdDoctor(options = {}) {
       });
     }
 
-    // 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)) {
-          if (isSkillSupportedOnPlatform(join(pkgSkillsDir, n)))
-            pkgSkills.add(n);
-        }
-      }
-      for (const { alias } of SKILL_ALIASES) pkgSkills.add(alias);
-
-      for (const n of readdirSync(userSkillsDir)) {
-        if (
-          !REMOVED_SKILL_NAMES.includes(n) &&
-          !existsSync(join(pkgSkillsDir, n))
-        )
-          continue;
-        if (isLocalDevSkillDir(join(userSkillsDir, n))) continue;
-        if (!pkgSkills.has(n)) staleSkills.push(n);
-      }
-    }
+    // Stale 스킬 체크: setup 과 같은 판정으로 지울 관리 사본과 보존할 사용자 사본을 나눈다.
+    const { removed: staleSkills, preserved: keptSkills } = cleanupStaleSkills(
+      join(CLAUDE_DIR, "skills"),
+      join(PKG_ROOT, "skills"),
+      { dryRun: true },
+    );
     if (staleSkills.length > 0) {
       warn(`구형 스킬 ${staleSkills.length}개 감지: ${staleSkills.join(", ")}`);
       info("관리 사본 정리: tfx setup 또는 tfx update");
+    }
+    if (keptSkills.length > 0) {
+      warn(
+        `구형 스킬 사용자 사본 ${keptSkills.length}개: ${keptSkills.join(", ")}`,
+      );
+      info("setup 은 고친 사본을 보존한다. 필요 없으면 직접 지우세요.");
+    }
+    if (staleSkills.length + keptSkills.length > 0) {
       addDoctorCheck(report, {
         name: "stale-skills",
         status: "issues",
         skills: staleSkills,
-        fix: "tfx setup",
+        preserved: keptSkills,
+        ...(staleSkills.length > 0 ? { fix: "tfx setup" } : {}),
       });
       issues++;
     } else {
@@ -2357,7 +2353,6 @@ async function cmdDoctor(options = {}) {
           // --fix 모드: npm install 실행 (Windows 호환 shell: true)
           info(`npm install 실행 중 (${PKG_ROOT})...`);
           try {
-            const { execFileSync } = await import("node:child_process");
             execFileSync("npm", ["install", "--no-audit", "--no-fund"], {
               cwd: PKG_ROOT,
               stdio: "inherit",
@@ -2728,10 +2723,7 @@ async function cmdDoctor(options = {}) {
           }
         } else {
           // --fix 없이는 개수만 보고
-          const { execSync: execSyncDoctor } = await import(
-            "node:child_process"
-          );
-          const countStr = execSyncDoctor(
+          const countStr = execSync(
             `powershell -NoProfile -WindowStyle Hidden -Command "(Get-Process node -ErrorAction SilentlyContinue).Count"`,
             { encoding: "utf8", timeout: 5000 },
           ).trim();
@@ -2875,9 +2867,22 @@ async function cmdDoctor(options = {}) {
         }
 
         for (const row of mismatchRows) {
-          warn(`${row.label}: ${row.name} URL 불일치`);
-          info(`expected ${row.expectedUrl}`);
-          if (row.actualUrl) info(`actual   ${row.actualUrl}`);
+          if (isHeaderOnlyMismatch(row)) {
+            warn(`${row.label}: ${row.name} 헤더 불일치 (${row.headerStatus})`);
+            info(`expected ${row.expectedHeaderNames.join(", ") || "없음"}`);
+            info(`actual   ${row.actualHeaderNames.join(", ") || "없음"}`);
+            continue;
+          }
+          warn(`${row.label}: ${row.name} 설정 불일치`);
+          info(
+            `expected ${mcpTarget(row.expectedUrl, row.expectedCommand, row.expectedArgs)}`,
+          );
+          const actualTarget = mcpTarget(
+            row.actualUrl,
+            row.actualCommand,
+            row.actualArgs,
+          );
+          if (actualTarget) info(`actual   ${actualTarget}`);
         }
 
         for (const row of missingFileRows) {
@@ -3070,6 +3075,44 @@ async function cmdDoctor(options = {}) {
           : "남은 triflux command hook 없음",
       );
     }
+
+    // 옛 setup 이 agy hooks.json 에 넣은 triflux-session 훅. 스크립트가 사라져 실행되면 실패한다.
+    // 옛 설치기 모양과 같은 것만 지우고, 다른 모양은 사용자가 정리하도록 경고만 한다.
+    const agyHooks = cleanupAgyHooks({ dryRun: !fix });
+    const agyRemaining = agyHooks.ok && fix ? 0 : agyHooks.removed;
+    const agyLeftover = agyHooks.leftover;
+    addDoctorCheck(report, {
+      name: "legacy-agy-hooks",
+      status: !agyHooks.ok
+        ? "error"
+        : agyRemaining + agyLeftover.length > 0
+          ? "issues"
+          : "ok",
+      remaining: agyRemaining,
+      leftover: agyLeftover,
+      path: agyHooks.hooksPath,
+      ...(agyHooks.ok ? {} : { error: agyHooks.error }),
+      ...(agyRemaining > 0 ? { fix: "tfx doctor --fix" } : {}),
+    });
+    if (!agyHooks.ok) {
+      fail(`agy 훅 점검 실패: ${agyHooks.error}`);
+      issues++;
+    } else {
+      if (agyRemaining > 0) {
+        warn(
+          "agy hooks.json 에 옛 triflux-session 훅이 남음: tfx doctor --fix",
+        );
+        issues += agyRemaining;
+      } else if (fix && agyHooks.changed) {
+        ok("agy 옛 triflux-session 훅 정리됨");
+      }
+      if (agyLeftover.length > 0) {
+        warn(
+          `agy 훅 ${agyLeftover.join(", ")} 이 지워진 agy-session-hook.mjs 를 가리킴. 직접 정리: ${agyHooks.hooksPath}`,
+        );
+        issues += agyLeftover.length;
+      }
+    }
     if (fix) {
       try {
         execFileSync(
@@ -3159,9 +3202,7 @@ async function cmdUpdate(args = []) {
     return;
   }
 
-  const isDev = isDevUpdateRequested(args);
-  const tagLabel = isDev ? ` ${YELLOW}--dev${RESET}` : "";
-  console.log(`\n${BOLD}triflux update${RESET}${tagLabel}\n`);
+  console.log(`\n${BOLD}triflux update${RESET}\n`);
 
   // 1. 설치 방식 감지
   const pluginsFile = join(CLAUDE_DIR, "plugins", "installed_plugins.json");
@@ -3259,9 +3300,7 @@ async function cmdUpdate(args = []) {
         break;
       }
       case "npm-global": {
-        const npmCmd = isDev
-          ? "npm install -g triflux@dev"
-          : "npm install -g triflux@latest";
+        const npmCmd = "npm install -g triflux@latest";
         let result;
         try {
           result = execSync(npmCmd, {
@@ -3284,14 +3323,12 @@ async function cmdUpdate(args = []) {
             .trim()
             .split(/\r?\n/)[0];
         }
-        ok(`${npmCmd} — ${result || "완료"}`);
+        ok(`${npmCmd}: ${result || "완료"}`);
         updated = true;
         break;
       }
       case "npm-local": {
-        const npmLocalCmd = isDev
-          ? "npm install triflux@dev"
-          : "npm update triflux";
+        const npmLocalCmd = "npm update triflux";
         const result = execSync(npmLocalCmd, {
           encoding: "utf8",
           timeout: 60000,
@@ -3301,9 +3338,7 @@ async function cmdUpdate(args = []) {
         })
           .trim()
           .split(/\r?\n/)[0];
-        ok(
-          `${isDev ? "npm install triflux@dev" : "npm update triflux"} — ${result || "완료"}`,
-        );
+        ok(`${npmLocalCmd}: ${result || "완료"}`);
         updated = true;
         break;
       }
@@ -3702,10 +3737,8 @@ function cmdHelp() {
     ${DIM}  --help${RESET}       ${GRAY}--audit, --diagnose 등 전체 옵션${RESET}
     ${WHITE_BRIGHT}tfx mcp${RESET}        ${GRAY}MCP registry 관리 (list/sync/add/remove)${RESET}
     ${WHITE_BRIGHT}tfx update${RESET}     ${GRAY}최신 안정 버전으로 업데이트${RESET}
-    ${DIM}  --dev / dev${RESET}   ${GRAY}dev 태그로 업데이트${RESET}
     ${WHITE_BRIGHT}tfx list${RESET}       ${GRAY}설치된 스킬 목록${RESET}
     ${WHITE_BRIGHT}tfx multi${RESET}      ${GRAY}멀티-CLI 팀 모드 (tmux)${RESET}
-    ${WHITE_BRIGHT}tfx cto${RESET}        ${GRAY}저장소 스냅숏 수집과 조회 (collect/status/hygiene)${RESET}
     ${WHITE_BRIGHT}tfx version${RESET}    ${GRAY}버전 표시${RESET}
     ${WHITE_BRIGHT}tfx-live${RESET}       ${GRAY}Claude·Codex 라이브 세션 (tfx-live --help)${RESET}
 
@@ -3761,7 +3794,7 @@ async function main() {
         printCommandHelp("setup");
         return;
       }
-      cmdSetup({
+      await cmdSetup({
         dryRun: cmdArgs.includes("--dry-run"),
         fromUpdate: cmdArgs.includes("--from-update"),
         mods: cmdArgs.includes("--mods"),
@@ -3789,6 +3822,7 @@ async function main() {
         } catch (e) {
           process.stdout.write(e.stdout || "");
           if (e.stderr) process.stderr.write(e.stderr);
+          process.exitCode = Number.isInteger(e.status) ? e.status : EXIT_ERROR;
         }
         return;
       }
@@ -3857,18 +3891,6 @@ async function main() {
       }
       cmdList({ json: JSON_OUTPUT });
       return;
-    case "cto": {
-      if (cmdArgs.some(isHelpArg)) {
-        printCommandHelp("cto");
-        return;
-      }
-      const { pathToFileURL } = await import("node:url");
-      const { cmdCto } = await import(
-        pathToFileURL(join(PKG_ROOT, "cto", "index.mjs")).href
-      );
-      await cmdCto(cmdArgs, { json: JSON_OUTPUT });
-      return;
-    }
     case "multi": {
       if (cmdArgs.some(isHelpArg)) {
         const { pathToFileURL } = await import("node:url");

package/config/mcp-registry.json

@@ -36,7 +36,7 @@
       "policy": "stdio",
       "transport": "stdio",
       "command": "npx",
-      "args": ["-y", "@brave/brave-search-mcp-server"],
+      "args": ["-y", "@brave/brave-search-mcp-server@2.1.4"],
       "env": {
         "BRAVE_API_KEY": { "env": "BRAVE_API_KEY" }
       },