@triflux/remote 10.53.0 → 10.55.0

package/scripts/lib/install-retire.mjs

@@ -0,0 +1,203 @@
+import { createHash } from "node:crypto";
+import {
+  existsSync,
+  lstatSync,
+  mkdirSync,
+  readdirSync,
+  readFileSync,
+  renameSync,
+  rmdirSync,
+  rmSync,
+  writeFileSync,
+} from "node:fs";
+import { dirname, join, relative } from "node:path";
+
+// 설치본에서 triflux 가 배포하는 디렉터리. ~/.claude 기준.
+const ROOTS = ["scripts", "hud", "hub"];
+const RETIRED_DIR = ".tfx-retired";
+const KEEP_DAYS = 30;
+const MANIFEST = "scripts/.tfx-manifest.json";
+// 2026-10-08 까지 저장소의 hub, hud, scripts 아래에 있었던 모든 파일 내용의 git blob id 앞 12자리.
+// 이 뒤로 빠지는 파일은 매니페스트가 맡는다.
+const HISTORY_FILE = new URL("./install-blob-history.json", import.meta.url);
+const HUB_CACHE = "cache/tfx-hub";
+// 제거된 허브와 계정 브로커만 쓰던 캐시. 지금 코드가 읽는 파일은 넣지 않는다.
+const HUB_CACHE_RETIRE = [
+  /^state\.db(?:-wal|-shm)?$/,
+  /^hub\.log$/,
+  /^team-logs$/,
+  /^synapse-sessions\.json$/,
+  /^team-native-.+\.json$/,
+];
+// 토큰 사본은 보관하지 않고 바로 지운다.
+const HUB_CACHE_DELETE = [
+  /^accounts\.json$/,
+  /^broker-state\.json$/,
+  /^codex-auth-.+\.json$/,
+  /^gemini-auth-.+\.json$/,
+  /^gemini-accounts-.+\.json$/,
+];
+
+export function gitBlobId(content) {
+  return createHash("sha1")
+    .update(`blob ${content.length}\0`)
+    .update(content)
+    .digest("hex");
+}
+
+function loadHistory() {
+  try {
+    return new Set(JSON.parse(readFileSync(HISTORY_FILE, "utf8")));
+  } catch {
+    return new Set();
+  }
+}
+
+function readManifest(claudeDir) {
+  try {
+    return (
+      JSON.parse(readFileSync(join(claudeDir, MANIFEST), "utf8")).files ?? {}
+    );
+  } catch {
+    return {};
+  }
+}
+
+// Windows 체크아웃에서 복사된 사본은 CRLF 일 수 있어 LF 로 맞춘 내용도 비교한다.
+function isShippedContent(content, rel, history, manifest) {
+  const ids = [gitBlobId(content)];
+  const text = content.toString("utf8");
+  if (text.includes("\r\n"))
+    ids.push(gitBlobId(Buffer.from(text.replaceAll("\r\n", "\n"))));
+  return ids.some((id) => history.has(id.slice(0, 12)) || manifest[rel] === id);
+}
+
+function walkFiles(dir) {
+  if (!existsSync(dir)) return [];
+  return readdirSync(dir, { withFileTypes: true }).flatMap((entry) => {
+    const path = join(dir, entry.name);
+    if (entry.isDirectory())
+      return entry.name === "node_modules" ? [] : walkFiles(path);
+    return entry.isFile() ? [path] : [];
+  });
+}
+
+function moveTo(claudeDir, day, rel) {
+  let target = join(claudeDir, RETIRED_DIR, day, rel);
+  for (let n = 1; existsSync(target); n++)
+    target = join(claudeDir, RETIRED_DIR, day, `${rel}.${n}`);
+  mkdirSync(dirname(target), { recursive: true });
+  renameSync(join(claudeDir, rel), target);
+}
+
+function removeEmptyDirs(dir, keepSelf = true) {
+  if (!existsSync(dir) || !lstatSync(dir).isDirectory()) return;
+  for (const entry of readdirSync(dir, { withFileTypes: true }))
+    if (entry.isDirectory()) removeEmptyDirs(join(dir, entry.name), false);
+  if (!keepSelf && readdirSync(dir).length === 0) rmdirSync(dir);
+}
+
+function retireHubCache(claudeDir, day, result) {
+  const cache = join(claudeDir, HUB_CACHE);
+  if (!existsSync(cache)) return;
+  for (const name of readdirSync(cache)) {
+    const rel = `${HUB_CACHE}/${name}`;
+    if (HUB_CACHE_DELETE.some((pattern) => pattern.test(name))) {
+      rmSync(join(claudeDir, rel), { recursive: true, force: true });
+      result.deleted.push(rel);
+    } else if (HUB_CACHE_RETIRE.some((pattern) => pattern.test(name))) {
+      moveTo(claudeDir, day, rel);
+      result.moved.push(rel);
+    }
+  }
+}
+
+function pruneRetired(claudeDir, now, result) {
+  const root = join(claudeDir, RETIRED_DIR);
+  if (!existsSync(root)) return;
+  const cutoff = now.getTime() - KEEP_DAYS * 24 * 60 * 60 * 1000;
+  for (const name of readdirSync(root)) {
+    const day = Date.parse(`${name}T00:00:00Z`);
+    if (!/^\d{4}-\d{2}-\d{2}$/.test(name) || !(day < cutoff)) continue;
+    rmSync(join(root, name), { recursive: true, force: true });
+    result.pruned.push(name);
+  }
+}
+
+/**
+ * 지금 패키지가 배포하지 않는 옛 triflux 설치 파일을 ~/.claude/.tfx-retired/<날짜>/ 로 옮긴다.
+ * triflux 가 배포한 내용 그대로인 파일만 옮기고, 고쳤거나 처음 보는 파일은 두며, 30일 지난 보관분은 지운다.
+ */
+export function retireInstallLeftovers({
+  claudeDir,
+  keep,
+  now = new Date(),
+  history = loadHistory(),
+}) {
+  const result = {
+    moved: [],
+    failed: [],
+    deleted: [],
+    pruned: [],
+    warnings: [],
+  };
+  const day = now.toISOString().slice(0, 10);
+  const manifest = readManifest(claudeDir);
+  for (const root of ROOTS) {
+    // 루트가 다른 체크아웃을 가리키는 링크면 옮기기가 그 원본을 지운다.
+    if (
+      lstatSync(join(claudeDir, root), {
+        throwIfNoEntry: false,
+      })?.isSymbolicLink()
+    )
+      continue;
+    for (const file of walkFiles(join(claudeDir, root))) {
+      const rel = relative(claudeDir, file).replaceAll("\\", "/");
+      const name = rel.split("/").pop();
+      // 숨김 파일은 setup 상태 파일이고 omc-hud 는 OMC 소유다.
+      if (keep.has(rel) || name.startsWith(".") || name.startsWith("omc-hud"))
+        continue;
+      try {
+        if (!isShippedContent(readFileSync(file), rel, history, manifest))
+          continue;
+        moveTo(claudeDir, day, rel);
+        result.moved.push(rel);
+      } catch (error) {
+        result.failed.push(rel);
+        result.warnings.push(
+          `${rel}: 옮기기 실패 (${error.code ?? error.message})`,
+        );
+      }
+    }
+    removeEmptyDirs(join(claudeDir, root));
+  }
+  try {
+    retireHubCache(claudeDir, day, result);
+    pruneRetired(claudeDir, now, result);
+  } catch (error) {
+    result.warnings.push(
+      `옛 허브 캐시 정리 실패: ${error.code ?? error.message}`,
+    );
+  }
+  return result;
+}
+
+/**
+ * 이번에 배포한 파일의 blob id 를 남겨, 다음 버전에서 빠지는 파일을 같은 기준으로 옮기게 한다.
+ * 옮기지 못한 파일(retained)은 이전 근거를 그대로 들고 가 다음 setup 이 다시 시도하게 한다.
+ */
+export function writeInstallManifest(claudeDir, files, retained = []) {
+  const previous = readManifest(claudeDir);
+  const entries = {};
+  for (const rel of retained) if (previous[rel]) entries[rel] = previous[rel];
+  for (const rel of files) {
+    try {
+      entries[rel] = gitBlobId(readFileSync(join(claudeDir, rel)));
+    } catch {
+      // 복사되지 않은 파일
+    }
+  }
+  const path = join(claudeDir, MANIFEST);
+  mkdirSync(dirname(path), { recursive: true });
+  writeFileSync(path, `${JSON.stringify({ files: entries }, null, 2)}\n`);
+}

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

@@ -12,6 +12,7 @@ import {
 } from "node:fs";
 import { homedir } from "node:os";
 import { dirname, join } from "node:path";
+import { writeRotatedBackup } from "./backup-rotation.mjs";
 
 // 설치된 Triflux 실행 대상만 식별한다.
 const MANAGED_FILENAMES = [
@@ -64,21 +65,17 @@ const packageTarget = new RegExp(
 const pluginRootTarget = new RegExp(
   String.raw`^\$\{(?:CLAUDE_)?PLUGIN_ROOT\}[/\\](?:hooks|scripts)[/\\](?:${uniqueTargetNames})$`,
 );
-const gateSuffix = ".claude/scripts/tfx-gate-activate.mjs";
-
-function isInstalledGateTarget(target) {
+// 옛 setup 이 ~/.claude/scripts 에 복사하고 직접 등록한 스크립트.
+function isInstalledScript(target, name) {
   const normalized = target.replaceAll("\\", "/");
+  const suffix = `.claude/scripts/${name}`;
   if (
-    ["${HOME}", "$HOME", "~"].some(
-      (root) => normalized === `${root}/${gateSuffix}`,
-    )
+    ["${HOME}", "$HOME", "~"].some((root) => normalized === `${root}/${suffix}`)
   )
     return true;
-  const installedTargets = [join(homedir(), gateSuffix)];
+  const installedTargets = [join(homedir(), suffix)];
   if (process.env.CLAUDE_CONFIG_DIR)
-    installedTargets.push(
-      join(process.env.CLAUDE_CONFIG_DIR, "scripts/tfx-gate-activate.mjs"),
-    );
+    installedTargets.push(join(process.env.CLAUDE_CONFIG_DIR, "scripts", name));
   return installedTargets.some(
     (installed) => normalized === installed.replaceAll("\\", "/"),
   );
@@ -99,7 +96,7 @@ function matchesTarget(target) {
   return (
     packageTarget.test(resolvedFallback) ||
     pluginRootTarget.test(target) ||
-    isInstalledGateTarget(target)
+    isInstalledScript(target, "tfx-gate-activate.mjs")
   );
 }
 
@@ -108,8 +105,17 @@ export function isLegacyTrifluxHook(hook) {
     return false;
   const command = hook.command;
   const executable = readCommandToken(command);
-  if (!executable || !/(?:^|[/\\])node(?:\.exe)?$/.test(executable.value))
-    return false;
+  if (!executable) return false;
+  // headless-guard 는 2026-09-07 에 제거됐지만 옛 setup 이 bash 로 등록한 항목이 남는다.
+  if (/(?:^|[/\\])bash(?:\.exe)?$/.test(executable.value)) {
+    const script = readCommandToken(executable.rest);
+    return (
+      !!script &&
+      !script.rest.trim() &&
+      isInstalledScript(script.value, "headless-guard-fast.sh")
+    );
+  }
+  if (!/(?:^|[/\\])node(?:\.exe)?$/.test(executable.value)) return false;
   const target = readCommandToken(executable.rest);
   if (!target) return false;
   // 옛 inline bootstrap만 제거한다.
@@ -228,3 +234,132 @@ export function cleanupLegacyHooks({
   }
   return result;
 }
+
+const AGY_HOOK_GROUP = "triflux-session";
+
+// 옛 ensure-agy-hooks 의 quoteCommandPath 와 같은 인용.
+function quoteAgyCommandPath(value) {
+  return `"${String(value).replace(/\\/g, "\\\\").replace(/"/g, '\\"')}"`;
+}
+
+function unquoteAgyCommandPath(quoted) {
+  return quoted.slice(1, -1).replace(/\\(["\\])/g, "$1");
+}
+
+function lastSegments(path, count) {
+  return path.split(/[/\\]+/u).slice(-count);
+}
+
+// 옛 설치기가 만든 명령을 풀어 같은 공식으로 다시 만들었을 때 똑같아야 한다.
+// 첫 버전은 node 경로를 따옴표 없이, 이후 버전은 따옴표로 감쌌다.
+function isInstallerAgyCommand(command) {
+  const match = /^(?:("(?:[^"\\]|\\.)*")|([^"]+)) ("(?:[^"\\]|\\.)*")$/u.exec(
+    command,
+  );
+  if (!match) return false;
+  // 따옴표 없는 node 경로(첫 버전의 process.execPath)는 공백과 셸 기호가 없는 절대 경로만 인정한다.
+  // 공백이 있으면 "node 사용자스크립트" 와 구분할 수 없어 지우지 않고 doctor 경고로 남긴다.
+  if (
+    match[2] &&
+    !/^(?:\/|[A-Za-z]:[\\/]|\\\\)[^\s"';&|`$<>]*$/u.test(match[2])
+  )
+    return false;
+  const nodeBin = match[1] ? unquoteAgyCommandPath(match[1]) : match[2];
+  const script = unquoteAgyCommandPath(match[3]);
+  if (/[\r\n]/u.test(nodeBin + script)) return false;
+  const [dir, file] = lastSegments(script, 2);
+  if (dir !== "hooks" || file !== "agy-session-hook.mjs") return false;
+  if (!/^node(?:js)?(?:\.exe)?$/iu.test(lastSegments(nodeBin, 1)[0]))
+    return false;
+  const rebuilt = `${match[1] ? quoteAgyCommandPath(nodeBin) : nodeBin} ${quoteAgyCommandPath(script)}`;
+  return rebuilt === command;
+}
+
+// 모든 버전의 옛 설치기가 쓴 그룹 모양과 정확히 같을 때만 우리 것이다.
+function isInstallerAgyGroup(group) {
+  if (!group || typeof group !== "object" || Array.isArray(group)) return false;
+  const keys = Object.keys(group).sort().join(",");
+  if (keys !== "PreInvocation,enabled" || group.enabled !== true) return false;
+  const entries = group.PreInvocation;
+  if (!Array.isArray(entries) || entries.length !== 1) return false;
+  const [entry] = entries;
+  return (
+    Object.keys(entry || {})
+      .sort()
+      .join(",") === "command,timeout,type" &&
+    entry.type === "command" &&
+    entry.timeout === 15 &&
+    typeof entry.command === "string" &&
+    isInstallerAgyCommand(entry.command)
+  );
+}
+
+// 자동으로 지우지 않은 그룹 중 훅 스크립트를 언급하는 것. doctor 가 경고만 한다.
+function agyHookMentions(hooks) {
+  return Object.entries(hooks)
+    .filter(([, group]) =>
+      JSON.stringify(group ?? null).includes("agy-session-hook.mjs"),
+    )
+    .map(([name]) => name);
+}
+
+/** agy hooks.json 에서 옛 setup 이 등록한 triflux-session 훅을 지운다. */
+export function cleanupAgyHooks({ geminiConfigHome, dryRun = false } = {}) {
+  const hooksPath = join(
+    geminiConfigHome || join(homedir(), ".gemini", "config"),
+    "hooks.json",
+  );
+  const result = {
+    ok: true,
+    changed: false,
+    wouldChange: false,
+    removed: 0,
+    leftover: [],
+    hooksPath,
+    backupPath: null,
+    error: null,
+  };
+  // 테스트 실행 중에는 명시 경로 없이 실제 HOME 을 고치지 않는다.
+  if (!geminiConfigHome && process.env.TEST_LOCK_PID) return result;
+  try {
+    if (!existsSync(hooksPath)) return result;
+    const targetPath = realpathSync(hooksPath);
+    const original = readFileSync(targetPath, "utf8");
+    const hooks = JSON.parse(original);
+    if (!hooks || typeof hooks !== "object" || Array.isArray(hooks))
+      return result;
+    const ours = isInstallerAgyGroup(hooks[AGY_HOOK_GROUP]);
+    if (ours) {
+      result.removed = 1;
+      result.wouldChange = true;
+    }
+    result.leftover = agyHookMentions(hooks).filter(
+      (name) => !(ours && name === AGY_HOOK_GROUP),
+    );
+    if (!ours || dryRun) return result;
+
+    delete hooks[AGY_HOOK_GROUP];
+    const mode = statSync(targetPath).mode & 0o777;
+    const stamp = new Date()
+      .toISOString()
+      .replace(/[-:.TZ]/g, "")
+      .slice(0, 14);
+    result.backupPath = writeRotatedBackup(targetPath, original, {
+      label: "bak-tfx-agy-hooks",
+      suffix: stamp,
+      mode,
+    });
+    const temporary = `${targetPath}.tfx-${process.pid}-${Date.now()}.tmp`;
+    writeFileSync(temporary, `${JSON.stringify(hooks, null, 2)}\n`, {
+      encoding: "utf8",
+      flag: "wx",
+      mode,
+    });
+    renameSync(temporary, targetPath);
+    result.changed = true;
+  } catch (error) {
+    result.ok = false;
+    result.error = error.message;
+  }
+  return result;
+}