@triflux/remote 10.58.0 → 10.59.1

package/package.json

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

package/scripts/lib/cli-output.mjs

@@ -0,0 +1,228 @@
+const AGENT_ENV = [
+  ["claude-code", ["CLAUDECODE", "CLAUDE_CODE"]],
+  ["codex", ["CODEX_SANDBOX", "CODEX_CI", "CODEX_THREAD_ID"]],
+  ["gemini-cli", ["GEMINI_CLI"]],
+  ["antigravity", ["ANTIGRAVITY_AGENT"]],
+  ["opencode", ["OPENCODE_CLIENT"]],
+  ["cursor", ["CURSOR_AGENT"]],
+];
+
+const enabled = (value) =>
+  Boolean(value) && !/^(0|false|no|off)$/iu.test(value);
+
+export function outputOptions(
+  args = [],
+  { env = process.env, input = process.stdin, output = process.stdout } = {},
+) {
+  const agent =
+    AGENT_ENV.find(([, keys]) => keys.some((key) => enabled(env[key])))?.[0] ||
+    (enabled(env.AI_AGENT)
+      ? env.AI_AGENT === "1"
+        ? "ai-agent"
+        : env.AI_AGENT
+      : null);
+  const json = args.includes("--json");
+  return {
+    json,
+    quiet: args.includes("--quiet") || args.includes("-q"),
+    verbose: args.includes("--verbose"),
+    check: args.includes("--check"),
+    agent,
+    nonInteractive:
+      json ||
+      Boolean(agent) ||
+      !input?.isTTY ||
+      !output?.isTTY ||
+      enabled(env.CI) ||
+      enabled(env.DOCKER) ||
+      env.npm_lifecycle_event === "postinstall",
+    color:
+      Boolean(output?.isTTY) &&
+      env.NO_COLOR === undefined &&
+      env.TERM !== "dumb" &&
+      (env.FORCE_COLOR === undefined ||
+        ["", "true", "1", "2", "3"].includes(env.FORCE_COLOR)),
+  };
+}
+
+// setup/update JSON 계약: command, outcome, message, alreadyInGoalState,
+// from, to, changed, unchanged, targets, warnings, notices.
+// 해당 결과에만 포함: installMode, installPath, exitCode.
+// 내부 자식 결과에만 포함: files, steps, elapsed.
+export function createCliResult(command, version) {
+  return {
+    command,
+    outcome: "ok",
+    message: "",
+    alreadyInGoalState: true,
+    from: version,
+    to: version,
+    changed: [],
+    unchanged: 0,
+    targets: [],
+    warnings: [],
+    notices: [],
+    files: [],
+    steps: [],
+  };
+}
+
+export function recordFile(result, path, change) {
+  result.files.push({ path, change });
+  if (change === "noop") result.unchanged++;
+  else {
+    result.changed.push(path);
+    result.alreadyInGoalState = false;
+  }
+}
+
+export function addWarning(result, code, message) {
+  if (!result.warnings.some((warning) => warning.message === message))
+    result.warnings.push({ code, message });
+}
+
+export function addStep(result, message) {
+  result.steps.push(message);
+  result.alreadyInGoalState = false;
+}
+
+export function addNotice(result, message) {
+  if (!result.notices.includes(message)) result.notices.push(message);
+}
+
+export function commandErrorMessage(error) {
+  const message = error.message.split(/\r?\n/)[0];
+  const cause = String(error.stderr || "")
+    .split(/\r?\n/)
+    .find((line) => line.trim())
+    ?.trim();
+  return cause && !message.includes(cause) ? `${message}: ${cause}` : message;
+}
+
+function updateCommand(result, rollback = false) {
+  if (["git-local", "plugin"].includes(result.installMode))
+    return rollback ? `git checkout v${result.from}` : "git pull";
+  const version = rollback ? result.from : "latest";
+  return result.installMode === "npm-local"
+    ? rollback
+      ? `npm i triflux@${version}`
+      : "npm update triflux"
+    : `npm i -g triflux@${version}`;
+}
+
+export function renderCliResult(result, options = {}) {
+  const { json, quiet, verbose, check, agent, nonInteractive, color, details } =
+    options;
+  if (json) {
+    const { files, steps, elapsed, ...publicResult } = result;
+    return `${JSON.stringify(details ? result : publicResult)}\n`;
+  }
+  const mark = (symbol) =>
+    color
+      ? `\x1b[${symbol === "✗" ? 31 : symbol === "!" ? 33 : 32}m${symbol}\x1b[0m`
+      : symbol;
+  const lines = [];
+  if (result.outcome === "failed") {
+    lines.push(
+      `${mark("✗")} ${result.command === "update" ? "업데이트" : "설정"} 실패: ${result.message}`,
+    );
+    if (result.command === "update") {
+      if (result.installPath) lines.push(`실행 경로: ${result.installPath}`);
+      lines.push(`직접 실행: ${updateCommand(result)}`);
+      if (result.from !== result.to)
+        lines.push(`되돌리기: ${updateCommand(result, true)}`);
+    }
+  } else if (result.outcome === "skipped") {
+    if (!quiet) lines.push(`skipped: ${result.message}`);
+  } else if (!quiet) {
+    if (result.command === "update") {
+      const versionChanged = result.from !== result.to;
+      const version = versionChanged
+        ? `${result.from} -> ${result.to}`
+        : `${result.to} 최신`;
+      if (check)
+        lines.push(
+          versionChanged
+            ? `업데이트 있음: ${result.from} -> ${result.to}`
+            : `${mark("✓")} triflux ${version}`,
+        );
+      else {
+        const time = `${(result.elapsed / 1000).toFixed(1)}s`;
+        const detail =
+          !versionChanged && !result.changed.length
+            ? `파일 ${result.unchanged}개 일치, ${time}`
+            : time;
+        lines.push(`${mark("✓")} triflux ${version} (${detail})`);
+        if (versionChanged)
+          lines.push(
+            `  https://github.com/tellang/triflux/releases/tag/v${result.to}`,
+          );
+      }
+      if (result.changed.length)
+        lines.push(
+          `파일 ${result.changed.length}개 반영 (${result.unchanged}개 그대로)`,
+        );
+    } else {
+      const context = agent
+        ? ` (에이전트: ${agent}, 비대화식)`
+        : nonInteractive
+          ? " (비대화식)"
+          : "";
+      lines.push(`triflux ${result.to} setup${context}`);
+    }
+    if (!check) {
+      if (result.command === "update" || verbose) {
+        for (const { path, change } of result.files) {
+          if (change === "noop" && !verbose) continue;
+          lines.push(
+            `  ${mark(change === "create" ? "+" : change === "noop" ? "✓" : "~")} ${path}`,
+          );
+        }
+      }
+      if (
+        result.command === "setup" ||
+        !result.alreadyInGoalState ||
+        result.warnings.length
+      ) {
+        for (const { name, status, detail } of result.targets)
+          lines.push(
+            `  ${mark(status === "ok" ? "✓" : status === "skipped" ? "-" : "✗")} ${name.padEnd(8)} ${detail}`,
+          );
+      }
+      for (const step of result.steps) lines.push(`  ${mark("✓")} ${step}`);
+    }
+  }
+  for (const warning of result.warnings)
+    lines.push(`${mark("!")} ${warning.message}`);
+  if (!quiet)
+    for (const notice of result.notices) lines.push(`안내: ${notice}`);
+  if (!quiet && result.outcome === "ok" && !check) {
+    if (result.command === "setup") {
+      lines.push(
+        `설정 완료${result.warnings.length ? `, 경고 ${result.warnings.length}건` : ""}`,
+        "다음: tfx doctor",
+      );
+    } else if (result.warnings.length || result.from !== result.to) {
+      if (result.from !== result.to && result.installPath)
+        lines.push(`되돌리기 실행 경로: ${result.installPath}`);
+      lines.push(
+        `${result.warnings.length ? `경고 ${result.warnings.length}건. ` : ""}${result.from !== result.to ? `되돌리기: ${updateCommand(result, true)}` : ""}`.trim(),
+      );
+    }
+  }
+  return lines.length ? `${lines.join("\n")}\n` : "";
+}
+
+export function postinstallMessage(version, report) {
+  if (!report) return "저장소 체크아웃이라 setup 을 건너뜀. 설정: tfx setup\n";
+  const status =
+    report.outcome === "failed"
+      ? `실패: ${report.message}`
+      : report.outcome === "skipped"
+        ? `건너뜀: ${report.message}`
+        : "완료";
+  const warnings = report.warnings
+    .map(({ message }) => `! ${message}\n`)
+    .join("");
+  return `triflux ${version} 설치됨. 설정 ${status}${report.warnings.length ? `, 경고 ${report.warnings.length}건` : ""}. 확인: tfx setup\n${warnings}`;
+}

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

@@ -1053,7 +1053,7 @@ function listHubProcesses(platform, run) {
 
 // 허브는 제거됐으므로 triflux 패키지의 hub/server.mjs 로 확인된 프로세스는 설치본,
 // 체크아웃, worktree 를 가리지 않고 종료한다(2026-10-08 결정).
-function stopHubs(home, platform, run, result, log) {
+function stopHubs(home, platform, run, result) {
   const processes = listHubProcesses(platform, run);
   if (!processes) {
     result.warnings.push("허브 프로세스 조회 실패, 종료하지 않음");
@@ -1064,7 +1064,6 @@ function stopHubs(home, platform, run, result, log) {
     if (Number(pid) === process.pid || typeof command !== "string") continue;
     const root = trifluxHubRoot(processArgv(pid, command, platform));
     if (!root) continue;
-    log(`허브 종료: pid ${pid} (${root})`);
     const stopped =
       platform === "win32"
         ? tryRun(run, "taskkill", ["/F", "/T", "/PID", String(pid)])
@@ -1157,7 +1156,6 @@ export function cleanupTfxHub({
   platform = osPlatform(),
   run = defaultRun,
   pluginRoot,
-  log = () => {},
   backups,
 } = {}) {
   const result = {
@@ -1210,7 +1208,7 @@ export function cleanupTfxHub({
     (resolve(home) === resolve(homedir()) && platform === osPlatform());
   if (realSystem) {
     try {
-      stopHubs(home, platform, run, result, log);
+      stopHubs(home, platform, run, result);
       if (platform === "win32") removeHubTasks(run, result);
     } catch (error) {
       result.ok = false;

package/scripts/lib/tmr-install.mjs

@@ -0,0 +1,184 @@
+import { execFileSync } from "node:child_process";
+import { createHash } from "node:crypto";
+import {
+  chmodSync,
+  copyFileSync,
+  linkSync,
+  lstatSync,
+  mkdirSync,
+  mkdtempSync,
+  readdirSync,
+  rmSync,
+  symlinkSync,
+  writeFileSync,
+} from "node:fs";
+import { tmpdir } from "node:os";
+import { delimiter, join } from "node:path";
+
+// 버전과 체크섬은 이 상수 한 곳에서만 올린다. 받은 파일은 이 sha256 으로만 믿는다.
+export const TMR_RELEASE = Object.freeze({
+  version: "0.1.0",
+  asset: "tmux-rooms-cli-0.1.0-macos-arm64.zip",
+  sha256: "342b34768a6f054d6bda6d3a63de37aeae08c5304d4531eecedf9631805a282f",
+});
+const releaseBase = ({ version }) =>
+  `https://github.com/tellang/tmux-rooms/releases/download/v${version}`;
+
+export function tmrSupported(platform = process.platform, arch = process.arch) {
+  return platform === "darwin" && arch === "arm64";
+}
+
+export function tmrBinDir(home) {
+  return join(home, ".local", "bin");
+}
+
+export function findTmr({ home, env = process.env }) {
+  const dirs = [
+    tmrBinDir(home),
+    ...String(env.PATH || "").split(delimiter),
+  ].filter(Boolean);
+  // 깨진 링크도 사용자 것으로 보고 건드리지 않는다. 읽을 수 없는 PATH 항목은 건너뛴다.
+  for (const dir of dirs)
+    for (const name of ["tmuxrooms", "tmr"]) {
+      try {
+        if (lstatSync(join(dir, name), { throwIfNoEntry: false }))
+          return join(dir, name);
+      } catch {}
+    }
+  return null;
+}
+
+async function download(url, fetchFn) {
+  const response = await fetchFn(url, { signal: AbortSignal.timeout(60_000) });
+  if (!response.ok) throw new Error(`${url}: HTTP ${response.status}`);
+  return Buffer.from(await response.arrayBuffer());
+}
+
+function sha256(buffer) {
+  return createHash("sha256").update(buffer).digest("hex");
+}
+
+function extractWithDitto(zipPath, directory) {
+  execFileSync("ditto", ["-x", "-k", zipPath, directory], {
+    stdio: "ignore",
+    timeout: 30_000,
+  });
+}
+
+/** 체크섬이 맞는 tmuxrooms 를 ~/.local/bin 에 넣고 상대 링크 tmr 을 만든다. */
+export async function installTmr({
+  home,
+  release = TMR_RELEASE,
+  fetchFn = fetch,
+  extract = extractWithDitto,
+  run = execFileSync,
+  symlink = symlinkSync,
+}) {
+  const base = releaseBase(release);
+  const zip = await download(`${base}/${release.asset}`, fetchFn);
+  if (sha256(zip) !== release.sha256)
+    throw new Error("zip 체크섬이 고정값과 다르다");
+  const sums = (await download(`${base}/SHA256SUMS`, fetchFn))
+    .toString("utf8")
+    .split(/\r?\n/)
+    .map((line) => line.trim().split(/\s+/));
+  const listed = sums.find(([, name]) => name === release.asset)?.[0];
+  if (listed !== release.sha256)
+    throw new Error("SHA256SUMS 의 값이 고정값과 다르다");
+
+  const work = mkdtempSync(join(tmpdir(), "tfx-tmr-"));
+  try {
+    const zipPath = join(work, release.asset);
+    const out = join(work, "out");
+    writeFileSync(zipPath, zip);
+    mkdirSync(out);
+    extract(zipPath, out);
+    const extracted = join(out, "tmuxrooms");
+    // zip 에는 실행 파일 하나만 있어야 한다. 다른 구성이면 받은 것을 쓰지 않는다.
+    const entries = readdirSync(out);
+    if (
+      entries.length !== 1 ||
+      entries[0] !== "tmuxrooms" ||
+      !lstatSync(extracted).isFile()
+    )
+      throw new Error("zip 구성이 예상과 다르다");
+
+    const binDir = tmrBinDir(home);
+    mkdirSync(binDir, { recursive: true, mode: 0o755 });
+    const target = join(binDir, "tmuxrooms");
+    // 임시 파일은 이번 시도만 쓰는 디렉터리에 둔다. 정리할 때 남의 파일을 지우지 않는다.
+    const staging = mkdtempSync(join(binDir, ".tfx-tmr-"));
+    try {
+      const temporary = join(staging, "tmuxrooms");
+      copyFileSync(extracted, temporary);
+      chmodSync(temporary, 0o755);
+      // 묻는 사이 다른 쪽이 tmuxrooms 를 만들었으면 덮지 않고 실패한다(EEXIST).
+      linkSync(temporary, target);
+    } finally {
+      rmSync(staging, { recursive: true, force: true });
+    }
+    const link = join(binDir, "tmr");
+    // 이미 있는 tmr 은 사용자 것일 수 있어 건드리지 않는다. 링크를 못 만들어도
+    // 체크섬이 맞는 tmuxrooms 는 완전한 설치본이라 지우지 않고 안내만 남긴다.
+    let linked = false;
+    try {
+      if (!lstatSync(link, { throwIfNoEntry: false })) {
+        symlink("tmuxrooms", link);
+        linked = true;
+      }
+    } catch {}
+
+    let runs = true;
+    try {
+      run(target, ["--help"], { stdio: "ignore", timeout: 10_000 });
+    } catch {
+      runs = false;
+    }
+    return { target, link, linked, runs };
+  } finally {
+    rmSync(work, { recursive: true, force: true });
+  }
+}
+
+/** setup 동의 단계. macOS arm64 에서 tmr 이 없을 때만 묻고, 물을 수 없으면 안내만 남긴다. */
+export async function offerTmrInstall({
+  interactive,
+  ask,
+  home,
+  env = process.env,
+  platform = process.platform,
+  arch = process.arch,
+  install = installTmr,
+  log = console.log,
+  warn = console.warn,
+  notice = console.log,
+}) {
+  if (!tmrSupported(platform, arch)) return "not-needed";
+  if (findTmr({ home, env })) return "present";
+  if (!interactive) {
+    notice("tmr 이 없다. tfx setup 에서 설치를 물을 수 있다.");
+    return "deferred";
+  }
+  if (!(await ask("tmr 을 설치할까요? (tmux 세션 목록 도구, ~/.local/bin)"))) {
+    notice("tmr 설치를 건너뜀.");
+    return "declined";
+  }
+  try {
+    const { target, link, linked, runs } = await install({ home });
+    log(`tmr ${TMR_RELEASE.version} 설치: ${target}`);
+    if (!linked && !lstatSync(link, { throwIfNoEntry: false }))
+      warn(`tmr 링크를 만들지 못했다. 직접 만든다: ln -s tmuxrooms "${link}"`);
+    if (!runs) warn(`설치한 ${target} 가 실행되지 않는다.`);
+    const binDir = tmrBinDir(home);
+    if (
+      !String(env.PATH || "")
+        .split(delimiter)
+        .includes(binDir)
+    )
+      warn(`${binDir} 가 PATH 에 없다. 셸 설정에 추가한다.`);
+    return "installed";
+  } catch (error) {
+    warn(`tmr 설치 실패: ${error?.message || error}`);
+    return "failed";
+  }
+}