@triflux/remote 10.66.0 → 10.67.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@triflux/remote",
-  "version": "10.66.0",
+  "version": "10.67.1",
   "description": "triflux remote — team mode, psmux, MCP workers.",
   "type": "module",
   "main": "hub/index.mjs",

package/scripts/lib/legacy-mcp-cleanup.mjs

@@ -1,4 +1,5 @@
 import { execFileSync } from "node:child_process";
+import { createHash } from "node:crypto";
 import {
   chmodSync,
   constants,
@@ -16,7 +17,7 @@ import {
 } from "node:fs";
 import { createRequire } from "node:module";
 import { homedir, platform as osPlatform, userInfo } from "node:os";
-import { basename, dirname, join, resolve } from "node:path";
+import { basename, dirname, join, resolve, sep } from "node:path";
 import { isDeepStrictEqual } from "node:util";
 import { loadRegistryOrDefault, pinnedArgs } from "./mcp-guard-engine.mjs";
 
@@ -1137,17 +1138,104 @@ function removeHubTasks(run, result) {
   }
 }
 
-/** cwd 의 프로젝트 MCP 파일 중 제거된 허브가 만든 tfx-hub 항목이 있는 파일을 돌려준다. */
-export function findProjectHubEntries(cwd = process.cwd()) {
-  return [".mcp.json", ".claude/mcp.json"].flatMap((relative) => {
-    const file = join(cwd, relative);
+/**
+ * cwd 부터 HOME 바로 아래까지 프로젝트 MCP 파일에서 제거된 허브와 gateway 가 남긴 항목을 찾는다.
+ * Claude Code 는 상위 폴더의 .mcp.json 도 읽는다. HOME 의 파일은 setup 이 정리하므로 보지 않는다.
+ * @returns {{ file: string, names: string[] }[]}
+ */
+export function findProjectLegacyMcpEntries(
+  cwd = process.cwd(),
+  home = homedir(),
+) {
+  // macOS 의 /var 와 /private/var 처럼 링크가 낀 경로도 HOME 에서 멈추도록 실제 경로로 비교한다.
+  const real = (path) => {
     try {
-      const data = JSON.parse(readFileSync(file, "utf8"));
-      return isHubEntry(data?.mcpServers?.[HUB_SERVER]) ? [file] : [];
+      return realpathSync(path);
     } catch {
-      return [];
+      return resolve(path);
     }
-  });
+  };
+  const stop = real(home);
+  const start = real(cwd);
+  const dirs = start === stop ? [] : [start];
+  // HOME 밖에서 실행하면 cwd 만 본다. --fix 가 HOME 밖 상위 폴더를 고치지 않게 한다.
+  if (start.startsWith(stop + sep))
+    for (let dir = dirname(start); dir !== stop; dir = dirname(dir))
+      dirs.push(dir);
+  return dirs.flatMap((dir) =>
+    [".mcp.json", ".claude/mcp.json"].flatMap((relative) => {
+      const file = join(dir, relative);
+      let servers;
+      try {
+        servers = JSON.parse(readFileSync(file, "utf8"))?.mcpServers;
+      } catch {
+        return [];
+      }
+      if (!servers || typeof servers !== "object") return [];
+      const names = Object.entries(servers)
+        .filter(([name, config]) =>
+          name === HUB_SERVER
+            ? isHubEntry(config)
+            : [config?.url, config?.httpUrl].some(
+                (value) => ownedUrl(value)?.valid,
+              ),
+        )
+        .map(([name]) => name);
+      return names.length ? [{ file, names }] : [];
+    }),
+  );
+}
+
+/**
+ * doctor --fix: 위에서 찾은 프로젝트 파일에서 tfx-hub 를 지우고 gateway 항목은 setup 과 같이 직접 연결로 바꾼다.
+ * 원본은 저장소에 커밋되지 않게 ~/.config/triflux/backups/project-mcp 에 남긴다. 소유를 확인할 수 없는 항목이 있거나 심볼릭 링크인 파일은 건드리지 않는다.
+ */
+export function cleanupProjectLegacyMcp({
+  cwd = process.cwd(),
+  home = homedir(),
+  env = process.env,
+} = {}) {
+  const result = { ok: true, changed: [], backups: [], warnings: [] };
+  const backupDir = join(home, ".config/triflux/backups/project-mcp");
+  for (const { file } of findProjectLegacyMcpEntries(cwd, home)) {
+    try {
+      // 파일이나 .claude 가 링크면 다른 클라이언트 설정(agy 등)을 가리킬 수 있고 대상이 바뀔 수도 있어 고치지 않는다.
+      // 폴더 목록은 실제 경로이므로 실제 경로가 같으면 경로 어디에도 링크가 없다.
+      if (realpathSync(file) !== file) {
+        result.warnings.push(`${file}: 심볼릭 링크라 건너뜀`);
+        continue;
+      }
+      const original = readFileSync(file, "utf8");
+      const migrated = patchJson(original, file, home, env, result.warnings);
+      if (migrated.blocked) continue;
+      const plan = removeHubFromJson(migrated.output, file, result.warnings);
+      if (!migrated.count && !plan.count) continue;
+      if (
+        realpathSync(file) !== file ||
+        readFileSync(file, "utf8") !== original
+      ) {
+        result.warnings.push(`${file}: 검사 후 변경되어 건너뜀`);
+        continue;
+      }
+      mkdirSync(backupDir, { recursive: true });
+      chmodSync(backupDir, 0o700);
+      // 경로 전체를 이름에 쓰면 255바이트를 넘을 수 있어 경로 해시로 짓는다. 원래 경로는 결과의 backups 와 짝을 이룬다.
+      const backup = backupFile(
+        join(
+          backupDir,
+          `${createHash("sha256").update(file).digest("hex").slice(0, 16)}-${basename(file)}`,
+        ),
+        original,
+      );
+      writeAtomic(file, file, plan.output, new Map([[file, backup]]));
+      result.backups.push(backup);
+      result.changed.push(file);
+    } catch {
+      result.ok = false;
+      result.warnings.push(`${file}: 설정 형식 또는 읽기 실패`);
+    }
+  }
+  return result;
 }
 
 /** 제거된 허브의 설정 항목, 실행 중인 프로세스, 예약 작업, 설치본 스냅샷(gemini, codex)을 정리한다. */