@triflux/remote 10.50.2 → 10.52.0

package/scripts/lib/env-probe.mjs

@@ -1,76 +1,12 @@
-import { execSync, spawn } from "node:child_process";
 import { createHash } from "node:crypto";
 import { existsSync, readFileSync } from "node:fs";
 import { homedir } from "node:os";
-import { dirname, join } from "node:path";
-import { fileURLToPath } from "node:url";
-import { resolveHubPortForContext } from "../../hub/hub-lifecycle.mjs";
+import { join } from "node:path";
 import { whichCommand, whichCommandAsync } from "@triflux/core/hub/platform.mjs";
 
-const HUB_DEFAULT_PORT = 27888;
-const DEFAULT_STATUS_URL = "http://127.0.0.1:27888/status";
-const _sab = new Int32Array(new SharedArrayBuffer(4));
 const CLI_PROBE_CACHE = new Map();
 const CLI_PROBE_PROMISES = new Map();
 
-const __filename = fileURLToPath(import.meta.url);
-const DEFAULT_PKG_ROOT = join(dirname(__filename), "..", "..");
-
-function sleepSync(ms) {
-  Atomics.wait(_sab, 0, 0, ms);
-}
-
-function fetchHubStatus({
-  execSyncFn = execSync,
-  statusUrl = resolveDefaultStatusUrl(),
-  timeout = 3000,
-} = {}) {
-  const response = execSyncFn(`curl -sf ${statusUrl}`, {
-    timeout,
-    encoding: "utf8",
-    windowsHide: true,
-  });
-  const data = JSON.parse(response);
-  return {
-    ok: true,
-    state: data?.hub?.state || "unknown",
-    pid: data?.pid,
-  };
-}
-
-export function resolveDefaultStatusUrl(
-  env = process.env,
-  cwd = process.cwd(),
-) {
-  const port = resolveHubPortForContext({
-    env,
-    cwd,
-    defaultPort: HUB_DEFAULT_PORT,
-  });
-  return `http://127.0.0.1:${port}/status`;
-}
-
-function resolveStatusUrlForContext({
-  statusUrl,
-  env = process.env,
-  cwd = process.cwd(),
-} = {}) {
-  try {
-    const url = new URL(String(statusUrl));
-    url.port = String(
-      resolveHubPortForContext({
-        port: url.port,
-        env,
-        cwd,
-        defaultPort: HUB_DEFAULT_PORT,
-      }),
-    );
-    return url.toString();
-  } catch {
-    return resolveDefaultStatusUrl(env, cwd);
-  }
-}
-
 function normalizeCliName(name) {
   return String(name ?? "").trim() || null;
 }
@@ -125,7 +61,7 @@ async function resolveCliProbe(name, options = {}) {
   return toCliResult(path);
 }
 
-export async function checkCli(name, options = {}) {
+async function checkCli(name, options = {}) {
   const cliName = normalizeCliName(name);
   if (!cliName) return { ok: false };
 
@@ -168,11 +104,6 @@ export async function probeClis(names, options = {}) {
   return mapCliResults(cliNames, results);
 }
 
-export function resetCliProbeCache() {
-  CLI_PROBE_CACHE.clear();
-  CLI_PROBE_PROMISES.clear();
-}
-
 export function detectCodexAuthState({
   homeDir = homedir(),
   existsSyncFn = existsSync,
@@ -237,63 +168,3 @@ export function detectCodexPlan(options = {}) {
   const { plan, source } = detectCodexAuthState(options);
   return { plan, source };
 }
-
-export function checkHub({
-  env = process.env,
-  cwd = process.cwd(),
-  pkgRoot = DEFAULT_PKG_ROOT,
-  statusUrl = resolveDefaultStatusUrl(env, cwd),
-  restart = true,
-  requestTimeoutMs = 3000,
-  pollAttempts = 8,
-  pollIntervalMs = 500,
-  execSyncFn = execSync,
-  spawnFn = spawn,
-  existsSyncFn = existsSync,
-  sleepSyncFn = sleepSync,
-} = {}) {
-  const guardedStatusUrl = resolveStatusUrlForContext({ statusUrl, env, cwd });
-  try {
-    return fetchHubStatus({
-      execSyncFn,
-      statusUrl: guardedStatusUrl,
-      timeout: requestTimeoutMs,
-    });
-  } catch {}
-
-  if (!restart) return { ok: false, state: "unreachable", restart: "disabled" };
-
-  const serverPath = join(pkgRoot, "hub", "server.mjs");
-  if (!existsSyncFn(serverPath))
-    return { ok: false, state: "unreachable", restart: "no_server" };
-
-  try {
-    const child = spawnFn(process.execPath, [serverPath], {
-      env: { ...env, TFX_HUB_PORT: String(new URL(guardedStatusUrl).port) },
-      detached: true,
-      stdio: "ignore",
-      windowsHide: true,
-    });
-    child.unref();
-  } catch {
-    return { ok: false, state: "unreachable", restart: "spawn_failed" };
-  }
-
-  for (let i = 0; i < pollAttempts; i++) {
-    sleepSyncFn(pollIntervalMs);
-    try {
-      const status = fetchHubStatus({
-        execSyncFn,
-        statusUrl: guardedStatusUrl,
-        timeout: Math.min(requestTimeoutMs, 1000),
-      });
-      if (status.state === "healthy") {
-        return { ...status, restarted: true };
-      }
-    } catch {}
-  }
-
-  return { ok: false, state: "unreachable", restart: "timeout" };
-}
-
-export { DEFAULT_PKG_ROOT, DEFAULT_STATUS_URL };

package/scripts/lib/gemini-profiles.mjs

@@ -30,36 +30,10 @@ const DEFAULT_GEMINI_PROFILES = {
   },
 };
 
-// 1회 마이그레이션 테이블: 옛 ID 형식 모델값 → agy display name.
-// null = 카탈로그에서 빠진 모델(2.5 계열, 3 Flash) → 해당 프로필 제거 대상.
-const LEGACY_MODEL_MIGRATION = {
-  "gemini-3.1-pro-preview": "Gemini 3.1 Pro (High)",
-  "gemini-3-flash-preview": null,
-  "Gemini 3 Flash": null,
-  "gemini-2.5-pro": null,
-  "gemini-2.5-flash": null,
-  "gemini-2.5-flash-lite": null,
-};
-// 과거 setup 이 자동 생성했던 프로필 이름. 정책상 더 쓰지 않으므로 제거한다.
-// 사용자가 직접 이름 붙인 프로필은 건드리지 않는다.
-const LEGACY_PROFILE_NAMES = [
-  "pro25",
-  "flash25",
-  "lite25",
-  "flash3",
-  "pro31",
-  "pro31_low",
-  "flash35",
-  "flash35_high",
-  "flash35_low",
-];
-// 과거 setup 이 자동 생성한 기본 model 값. 사용자가 고른 값이 아니므로 새 기본으로 올린다.
-const LEGACY_DEFAULT_MODELS = new Set(["Gemini 3.5 Flash (Medium)"]);
-
 // ── 용도별 effort (SSOT) ──
 // 한 세대(3.8 Flash)만 쓰고 역할에 따라 effort 를 나눈다. 키는 tfx 에이전트/역할 이름
 // (agent-map.json 의 에이전트, tfx multi --assign 의 role). bash(tfx-route.sh)와
-// 실행 모드와 cli-agy가 이 표를 공유한다.
+// 실행 모드(execution-mode)가 이 표를 읽는다.
 //   High   : 판단이 결과를 좌우하는 역할 (검토, 설계, 디버깅, 분석)
 //   Medium : 생성/작성/실행 (기본값)
 //   Low    : 분류, 요약, 추출, 번역처럼 짧고 기계적인 작업
@@ -182,40 +156,6 @@ function ensureGeminiProfiles({
     )
       cfg.profiles = {};
 
-    // ── 1회 마이그레이션: deprecated 2.5 프로필 prune + 옛 ID 형식 → display name ──
-    // merge-only 로직만으로는 기존 사용자 파일에 남은 stale 프로필/옛 모델 ID 가
-    // 정리되지 않으므로, 신규 default 를 채우기 전에 마이그레이션을 먼저 적용한다.
-    let migrated = false;
-    for (const legacy of LEGACY_PROFILE_NAMES) {
-      if (cfg.profiles[legacy]) {
-        delete cfg.profiles[legacy];
-        migrated = true;
-      }
-    }
-    for (const [pname, pval] of Object.entries(cfg.profiles)) {
-      const mid = typeof pval === "string" ? pval : pval?.model;
-      if (mid && Object.hasOwn(LEGACY_MODEL_MIGRATION, mid)) {
-        const repl = LEGACY_MODEL_MIGRATION[mid];
-        if (repl === null) {
-          delete cfg.profiles[pname];
-        } else if (typeof pval === "string") {
-          cfg.profiles[pname] = repl;
-        } else {
-          cfg.profiles[pname].model = repl;
-        }
-        migrated = true;
-      }
-    }
-    if (
-      typeof cfg.model === "string" &&
-      (Object.hasOwn(LEGACY_MODEL_MIGRATION, cfg.model) ||
-        LEGACY_DEFAULT_MODELS.has(cfg.model))
-    ) {
-      // 옛 ID 형식/이전 세대 자동 생성 기본값은 새 기본(DEFAULT)으로 정규화한다.
-      cfg.model = DEFAULT_GEMINI_PROFILES.model;
-      migrated = true;
-    }
-
     let added = 0;
     for (const [name, value] of Object.entries(
       DEFAULT_GEMINI_PROFILES.profiles,
@@ -227,12 +167,7 @@ function ensureGeminiProfiles({
     }
     if (!cfg.model) cfg.model = DEFAULT_GEMINI_PROFILES.model;
 
-    if (added > 0 || migrated) {
-      if (migrated) {
-        try {
-          copyFileSync(profilesPath, profilesPath + `.bak.${Date.now()}`);
-        } catch {}
-      }
+    if (added > 0) {
       writeFileSync(profilesPath, JSON.stringify(cfg, null, 2) + "\n", {
         encoding: "utf8",
         mode: 0o600,
@@ -260,8 +195,6 @@ function ensureGeminiProfiles({
 export {
   DEFAULT_GEMINI_PROFILES,
   ensureGeminiProfiles,
-  GEMINI_DEFAULT_PURPOSE_PROFILE,
-  GEMINI_PROFILE_BY_PURPOSE,
   resolveGeminiModel,
   resolveGeminiProfileForPurpose,
 };

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

@@ -9,6 +9,7 @@ import {
   readFileSync,
   realpathSync,
   renameSync,
+  rmSync,
   statSync,
   unlinkSync,
   writeFileSync,
@@ -781,3 +782,285 @@ export function cleanupLegacyMcp({
   }
   return result;
 }
+
+const HUB_SERVER = "tfx-hub";
+const HUB_TASK = "TrifluxHubEnsure";
+const HUB_CONFIG_FILES = [
+  [".claude.json", "json"],
+  [".claude/settings.json", "json"],
+  [".claude/mcp.json", "json"],
+  [".codex/config.json", "json"],
+  [".codex/config.toml", "toml"],
+  [".gemini/settings.json", "json"],
+  [".gemini/config/mcp_config.json", "json"],
+];
+
+// 허브가 등록한 항목은 loopback 의 /mcp 주소다. 다른 모양이면 사용자 항목으로 본다.
+function isHubEntry(config) {
+  if (!config || typeof config !== "object" || Array.isArray(config))
+    return false;
+  return [config.url, config.httpUrl, config.serverUrl].some((value) => {
+    try {
+      const url = new URL(value);
+      return (
+        url.protocol === "http:" &&
+        ["127.0.0.1", "localhost", "[::1]"].includes(url.hostname) &&
+        url.pathname === "/mcp"
+      );
+    } catch {
+      return false;
+    }
+  });
+}
+
+function removeHubFromJson(original, file, warnings) {
+  const data = JSON.parse(original);
+  if (!data || typeof data !== "object" || Array.isArray(data))
+    throw new Error(`${file}: JSON 객체가 아닙니다`);
+  const groups = [
+    data.mcpServers,
+    ...Object.values(data.projects ?? {}).map((project) => project?.mcpServers),
+  ];
+  let count = 0;
+  for (const entries of groups) {
+    if (
+      !entries ||
+      typeof entries !== "object" ||
+      Array.isArray(entries) ||
+      !(HUB_SERVER in entries)
+    )
+      continue;
+    if (!isHubEntry(entries[HUB_SERVER])) {
+      warnings.push(`${file}: ${HUB_SERVER} 항목의 소유를 확인할 수 없어 보존`);
+      continue;
+    }
+    delete entries[HUB_SERVER];
+    count++;
+  }
+  return {
+    output: count ? `${JSON.stringify(data, null, 2)}\n` : original,
+    count,
+  };
+}
+
+function removeHubFromToml(original, file, warnings) {
+  const data = toml.parse(original);
+  const entry = data.mcp_servers?.[HUB_SERVER];
+  if (!entry) return { output: original, count: 0 };
+  if (!isHubEntry(entry)) {
+    warnings.push(`${file}: ${HUB_SERVER} 항목의 소유를 확인할 수 없어 보존`);
+    return { output: original, count: 0 };
+  }
+  // [mcp_servers.tfx-hub] 와 그 하위 표만 다음 표 머리글 전까지 걷어낸다.
+  const hubHeader = new RegExp(
+    `^\\s*\\[\\s*mcp_servers\\s*\\.\\s*(?:"${HUB_SERVER}"|'${HUB_SERVER}'|${HUB_SERVER})\\s*(?:\\.[^\\]]*)?\\]`,
+  );
+  const kept = [];
+  let skipping = false;
+  let trailing = [];
+  for (const line of original.split(/(?<=\n)/)) {
+    if (/^\s*\[/.test(line)) {
+      skipping = hubHeader.test(line);
+      if (!skipping) {
+        while (trailing[0]?.trim() === "" && kept.at(-1)?.trim() === "")
+          trailing.shift();
+        kept.push(...trailing);
+      }
+      trailing = [];
+    } else if (skipping) {
+      trailing = /^\s*(?:#.*)?\r?\n?$/.test(line) ? [...trailing, line] : [];
+      continue;
+    }
+    if (!skipping) kept.push(line);
+  }
+  const output = kept.join("");
+  delete data.mcp_servers[HUB_SERVER];
+  if (!Object.keys(data.mcp_servers).length) delete data.mcp_servers;
+  try {
+    if (!isDeepStrictEqual(toml.parse(output), data))
+      throw new Error("TOML 구조 불일치");
+  } catch {
+    warnings.push(`${file}: 이주 결과 TOML 검증 실패, 파일 보존`);
+    return { output: original, count: 0 };
+  }
+  return { output, count: 1 };
+}
+
+function hubCommandLine(pid, platform, run) {
+  const result =
+    platform === "win32"
+      ? runPowerShell(
+          run,
+          `(Get-CimInstance Win32_Process -Filter 'ProcessId=${pid}').CommandLine`,
+        )
+      : tryRun(run, "ps", ["-p", String(pid), "-o", "command="]);
+  if (result.ok) return result.output.trim() || null;
+  // ps 는 프로세스가 없을 때 status 1 로 끝난다. PowerShell 실패는 확인 불가다.
+  return platform !== "win32" && result.status === 1 ? null : undefined;
+}
+
+function stopHub(home, platform, run, result) {
+  const pidFile = join(home, ".claude/cache/tfx-hub/hub.pid");
+  const target = fileTarget(pidFile);
+  if (!target) return;
+  let pid;
+  try {
+    pid = Number(JSON.parse(readFileSync(target, "utf8")).pid);
+  } catch {
+    /* 아래에서 보존 처리 */
+  }
+  if (!Number.isInteger(pid) || pid <= 1) {
+    result.warnings.push(`${pidFile}: pid 를 읽을 수 없어 보존`);
+    return;
+  }
+  const command = hubCommandLine(pid, platform, run);
+  if (command === undefined) {
+    result.warnings.push(`${pidFile}: pid ${pid} 확인 실패, 종료하지 않음`);
+    return;
+  }
+  if (command !== null) {
+    if (!/[/\\]hub[/\\]server\.mjs(?:["'\s]|$)/.test(command)) {
+      // 허브가 아닌 프로세스는 건드리지 않고 우리 파일만 지운다.
+      unlinkSync(target);
+      result.changed = true;
+      return;
+    }
+    const stopped =
+      platform === "win32"
+        ? tryRun(run, "taskkill", ["/F", "/T", "/PID", String(pid)])
+        : tryRun(run, "kill", ["-TERM", String(pid)]);
+    let gone = false;
+    for (let attempt = 0; stopped.ok && attempt < 10 && !gone; attempt++) {
+      gone = hubCommandLine(pid, platform, run) === null;
+      if (!gone)
+        Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, 100);
+    }
+    if (!gone) {
+      result.warnings.push(`${pidFile}: pid ${pid} 종료 확인 실패, 파일 보존`);
+      return;
+    }
+    result.hubStopped = true;
+  }
+  unlinkSync(target);
+  result.changed = true;
+}
+
+function removeHubTask(run, result) {
+  const query = tryRun(run, "schtasks.exe", [
+    "/Query",
+    "/TN",
+    HUB_TASK,
+    "/FO",
+    "LIST",
+    "/V",
+  ]);
+  if (!query.ok) return;
+  if (!query.output.includes("hub-ensure.mjs")) {
+    result.warnings.push(`${HUB_TASK}: hub-ensure 작업이 아니라 보존`);
+    return;
+  }
+  const removed = tryRun(run, "schtasks.exe", [
+    "/Delete",
+    "/TN",
+    HUB_TASK,
+    "/F",
+  ]);
+  if (removed.ok) result.changed = true;
+  else result.warnings.push(`${HUB_TASK}: 예약 작업 삭제 실패`);
+}
+
+/** cwd 의 프로젝트 MCP 파일 중 제거된 허브가 만든 tfx-hub 항목이 있는 파일을 돌려준다. */
+export function findProjectHubEntries(cwd = process.cwd()) {
+  return [".mcp.json", ".claude/mcp.json"].flatMap((relative) => {
+    const file = join(cwd, relative);
+    try {
+      const data = JSON.parse(readFileSync(file, "utf8"));
+      return isHubEntry(data?.mcpServers?.[HUB_SERVER]) ? [file] : [];
+    } catch {
+      return [];
+    }
+  });
+}
+
+/** 제거된 허브의 설정 항목, 실행 중인 프로세스, 예약 작업, 설치본 스냅샷(gemini, codex)을 정리한다. */
+export function cleanupTfxHub({
+  home = homedir(),
+  platform = osPlatform(),
+  run = defaultRun,
+  pluginRoot,
+} = {}) {
+  const result = {
+    ok: true,
+    changed: false,
+    removed: 0,
+    backups: [],
+    warnings: [],
+    hubStopped: false,
+  };
+  const injected = run !== defaultRun;
+  // 테스트에서는 실제 홈과 시스템 명령을 건드리지 않는다.
+  if (
+    !injected &&
+    (process.env.NODE_TEST_CONTEXT || process.env.TRIFLUX_TEST_HOME)
+  ) {
+    result.skipped = true;
+    return result;
+  }
+  for (const [relative, kind] of HUB_CONFIG_FILES) {
+    const file = join(home, relative);
+    try {
+      const target = fileTarget(file);
+      if (!target) continue;
+      const original = readFileSync(target, "utf8");
+      const plan =
+        kind === "toml"
+          ? removeHubFromToml(original, file, result.warnings)
+          : removeHubFromJson(original, file, result.warnings);
+      if (!plan.count) continue;
+      if (
+        fileTarget(file) !== target ||
+        readFileSync(target, "utf8") !== original
+      ) {
+        result.warnings.push(`${file}: 검사 후 변경되어 건너뜀`);
+        continue;
+      }
+      result.backups.push(writeAtomic(file, target, plan.output));
+      result.removed += plan.count;
+      result.changed = true;
+    } catch {
+      result.warnings.push(`${file}: 설정 형식 또는 읽기 실패`);
+      result.ok = false;
+    }
+  }
+  const realSystem =
+    injected ||
+    (resolve(home) === resolve(homedir()) && platform === osPlatform());
+  if (realSystem) {
+    try {
+      stopHub(home, platform, run, result);
+      if (platform === "win32") removeHubTask(run, result);
+    } catch (error) {
+      result.ok = false;
+      result.warnings.push(`허브 프로세스 정리 실패: ${error.message}`);
+    }
+  } else {
+    result.warnings.push("격리 HOME: 허브 프로세스와 예약 작업 정리는 건너뜀");
+  }
+  for (const name of pluginRoot
+    ? ["gemini-snapshots", "codex-snapshots"]
+    : []) {
+    const snapshots = join(pluginRoot, "references", name);
+    // EBUSY, EPERM, 읽기 전용 설치 디렉터리에서도 setup 이 멈추지 않게 한다.
+    try {
+      if (lstatSync(snapshots, { throwIfNoEntry: false })?.isDirectory()) {
+        rmSync(snapshots, { recursive: true, force: true });
+        result.changed = true;
+      }
+    } catch (error) {
+      result.warnings.push(
+        `${snapshots}: 삭제 실패 (${error.code ?? error.message})`,
+      );
+    }
+  }
+  return result;
+}

package/scripts/lib/machine-profile.mjs

@@ -14,7 +14,7 @@ import { readFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { join, resolve } from "node:path";
 
-export const MACHINE_PROFILE_FILENAME = "machine-profile.env";
+const MACHINE_PROFILE_FILENAME = "machine-profile.env";
 
 export const MACHINE_PROFILE_KEYS = Object.freeze([
   "TFX_MACHINE_PROFILE_VERSION",
@@ -28,9 +28,9 @@ export const MACHINE_PROFILE_KEYS = Object.freeze([
   "TFX_STALL_KILL",
 ]);
 
-export const MACHINE_PROFILE_KEY_SET = new Set(MACHINE_PROFILE_KEYS);
+const MACHINE_PROFILE_KEY_SET = new Set(MACHINE_PROFILE_KEYS);
 
-export const MACHINE_PROFILE_VALUE_RE = /^[A-Za-z0-9_.-]+$/u;
+const MACHINE_PROFILE_VALUE_RE = /^[A-Za-z0-9_.-]+$/u;
 
 // CLI 이름과 disable 키의 대응. 이 두 개가 TFX_DISABLE_* SSOT 의 전부다.
 const CLI_DISABLE_KEYS = Object.freeze({
@@ -248,20 +248,6 @@ export function normalizeCliName(cli) {
   return CLI_ALIASES[key] || null;
 }
 
-/**
- * 세션 문맥 주입용 한 줄. 형식은 고정이며 소비자가 파싱하지 않고 그대로 보여준다.
- *
- * @param {ReturnType<typeof resolveCliPolicy>} policy
- * @returns {string}
- */
-export function formatCliPolicyLine(policy) {
-  const codex = policy?.codexDisabled ? "off" : "on";
-  const antigravity = policy?.antigravityDisabled ? "off" : "on";
-  const codexSource = policy?.source?.codex || "default";
-  const antigravitySource = policy?.source?.antigravity || "default";
-  return `cli-policy: codex=${codex} antigravity=${antigravity} (SSOT: TFX_DISABLE_*; codex<-${codexSource}, antigravity<-${antigravitySource})`;
-}
-
 /**
  * 차단된 CLI 실행 요청에 쓸 오류를 만든다. throw 는 호출자가 한다. 정책상 허용된
  * CLI 이거나 모르는 이름이면 null 을 준다.