triflux 10.58.0 → 10.59.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "triflux",
-  "version": "10.58.0",
+  "version": "10.59.0",
   "description": "CLI-first multi-model orchestrator for Claude Code — route tasks to Codex, Antigravity, and Claude",
   "type": "module",
   "bin": {

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

@@ -151,15 +151,16 @@ export async function offerTmrInstall({
   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) {
-    log("tmr 이 없다. tfx setup 에서 설치를 물을 수 있다.");
+    notice("tmr 이 없다. tfx setup 에서 설치를 물을 수 있다.");
     return "deferred";
   }
   if (!(await ask("tmr 을 설치할까요? (tmux 세션 목록 도구, ~/.local/bin)"))) {
-    log("tmr 설치를 건너뜀.");
+    notice("tmr 설치를 건너뜀.");
     return "declined";
   }
   try {
@@ -174,7 +175,7 @@ export async function offerTmrInstall({
         .split(delimiter)
         .includes(binDir)
     )
-      log(`${binDir} 가 PATH 에 없다. 셸 설정에 추가한다.`);
+      warn(`${binDir} 가 PATH 에 없다. 셸 설정에 추가한다.`);
     return "installed";
   } catch (error) {
     warn(`tmr 설치 실패: ${error?.message || error}`);