triflux 10.13.10 → 10.14.1

package/bin/triflux.mjs

@@ -61,6 +61,7 @@ import {
   probePsmuxSupport,
 } from "../scripts/lib/psmux-info.mjs";
 import {
+  buildWindowsHubAutostartCommand,
   cleanupStaleSkills,
   ensureCodexHubServerConfig,
   ensureCodexProfiles,
@@ -68,6 +69,7 @@ import {
   extractManagedHookFilename,
   getManagedRegistryHooks,
   getVersion,
+  getWindowsHubAutostartStatus,
   hasProfileSection,
   LEGACY_CODEX_MODELS,
   REQUIRED_CODEX_PROFILES,
@@ -123,7 +125,7 @@ const NORMALIZED_ARGS = RAW_ARGS.filter((arg) => arg !== "--json");
 
 const CLI_COMMAND_SCHEMAS = Object.freeze({
   setup: {
-    usage: "tfx setup [--dry-run]",
+    usage: "tfx setup [--dry-run] [--enable-hub-autostart]",
     description: "파일 동기화 + HUD/MCP 설정",
     options: [
       {
@@ -131,6 +133,12 @@ const CLI_COMMAND_SCHEMAS = Object.freeze({
         type: "boolean",
         description: "실제 변경 없이 예정 작업을 JSON으로 출력",
       },
+      {
+        name: "--enable-hub-autostart",
+        type: "boolean",
+        description:
+          "Windows 로그인 시 tfx-hub를 보장하는 Task Scheduler 항목 등록",
+      },
     ],
   },
   doctor: {
@@ -1115,6 +1123,16 @@ function buildSetupDryRunPlan() {
   const defaultHubUrl = `http://127.0.0.1:${process.env.TFX_HUB_PORT || "27888"}/mcp`;
   actions.push(...previewMcpRegistrationActions(defaultHubUrl));
   actions.push(previewStatusLineAction());
+  const autostart = getWindowsHubAutostartStatus();
+  actions.push({
+    type: "hub-autostart",
+    platform: process.platform,
+    taskName: autostart.taskName,
+    change: autostart.supported && !autostart.registered ? "available" : "noop",
+    registered: autostart.registered,
+    command: autostart.supported ? buildWindowsHubAutostartCommand() : null,
+    enableWith: "tfx setup --enable-hub-autostart",
+  });
 
   return {
     dry_run: true,
@@ -1123,7 +1141,12 @@ function buildSetupDryRunPlan() {
 }
 
 function cmdSetup(options = {}) {
-  const { dryRun = false, overrideVersion, skipClaudeMdSync = false } = options;
+  const {
+    dryRun = false,
+    overrideVersion,
+    skipClaudeMdSync = false,
+    enableHubAutostart = false,
+  } = options;
   if (dryRun) {
     printJson(buildSetupDryRunPlan());
     return;
@@ -1351,6 +1374,67 @@ function cmdSetup(options = {}) {
     console.log("");
   }
 
+  if (process.platform === "win32") {
+    const status = getWindowsHubAutostartStatus();
+    if (enableHubAutostart) {
+      try {
+        const script = join(PKG_ROOT, "scripts", "setup.mjs");
+        execFileSync(
+          process.execPath,
+          [script, "--enable-hub-autostart", "--sync"],
+          {
+            stdio: ["ignore", "pipe", "pipe"],
+            timeout: 10000,
+            windowsHide: true,
+          },
+        );
+        // subprocess silent-catch 회귀 가드: schtasks /Query 로 실제 등록 재검증.
+        const verified = getWindowsHubAutostartStatus();
+        if (verified.registered) {
+          ok(`Hub autostart: ${verified.taskName} 등록됨`);
+          summary.push({
+            item: "Hub autostart",
+            status: "✅",
+            detail: `${verified.taskName} 등록됨`,
+          });
+        } else {
+          warn(
+            "Hub autostart 등록 실패: subprocess 성공했으나 /Query 에서 미발견",
+          );
+          summary.push({
+            item: "Hub autostart",
+            status: "⚠️",
+            detail: "등록 실패 (subprocess silent catch 의심)",
+          });
+        }
+      } catch (error) {
+        warn(`Hub autostart 등록 실패: ${renderErrorMessage(error.message)}`);
+        summary.push({
+          item: "Hub autostart",
+          status: "⚠️",
+          detail: "등록 실패",
+        });
+      }
+    } else if (status.registered) {
+      ok(`Hub autostart: ${status.taskName} 이미 등록됨`);
+      summary.push({
+        item: "Hub autostart",
+        status: "✅",
+        detail: "이미 등록됨",
+      });
+    } else {
+      warn(
+        "Hub autostart 미등록 — Codex 단독 시작 전 hub가 죽어 있으면 MCP가 실패할 수 있음",
+      );
+      info("등록: tfx setup --enable-hub-autostart");
+      summary.push({
+        item: "Hub autostart",
+        status: "⏭️",
+        detail: "미등록",
+      });
+    }
+  }
+
   // HUD statusLine 설정
   console.log(`${CYAN}[HUD 설정]${RESET}`);
   const settingsPath = join(CLAUDE_DIR, "settings.json");
@@ -5579,7 +5663,10 @@ async function main() {
 
   switch (cmd) {
     case "setup":
-      cmdSetup({ dryRun: cmdArgs.includes("--dry-run") });
+      cmdSetup({
+        dryRun: cmdArgs.includes("--dry-run"),
+        enableHubAutostart: cmdArgs.includes("--enable-hub-autostart"),
+      });
       return;
     case "doctor": {
       if (cmdArgs.includes("--audit")) {

package/hub/team/conductor.mjs

@@ -696,6 +696,8 @@ export function createConductor(opts = {}) {
       },
       {
         ...probeOpts,
+        writeStateFile:
+          probeOpts.writeStateFile ?? process.env.TFX_PROBE_WRITE_STATE === "1",
         onProbe: (result) => handleProbeResult(session, result),
       },
     );

package/hub/team/health-probe.mjs

@@ -2,6 +2,10 @@
 // 기존 cli-adapter-base.mjs:stallThresholdMs(30s)와 headless.mjs:STALL_DEFAULTS(120s)를
 // 4단계 probe 모델로 교체. stdout+stderr 통합 스트림으로 평가 (F3 해결).
 
+import { mkdirSync, unlinkSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { dirname, join } from "node:path";
+
 /**
  * Health probe level 정의.
  * L0: Process alive (PID 존재 + exit code 없음)
@@ -25,6 +29,8 @@ export const PROBE_DEFAULTS = Object.freeze({
   l2ThresholdMs: 30_000,
   l3ThresholdMs: 120_000,
   enableL2: false,
+  writeStateFile: false,
+  stateDir: join(tmpdir(), "tfx-probe"),
 });
 
 /**
@@ -96,6 +102,49 @@ export function createHealthProbe(session, opts = {}) {
     inputWaitPattern: null,
   };
 
+  function getStateFilePath() {
+    if (typeof config.stateFile === "string" && config.stateFile.length > 0) {
+      return config.stateFile;
+    }
+    const pid = session.pid;
+    if (pid == null || pid <= 0) return null;
+    return join(config.stateDir, `${pid}.json`);
+  }
+
+  function deriveState(result) {
+    if (result.l0 === "fail") return "exited";
+    if (result.l1 === "input_wait") return "input_wait";
+    if (result.l2 === "fail") return "mcp_initializing";
+    if (result.l1 === "stall") return "stalled";
+    if (result.l3 === "timeout") return "reasoning";
+    return "active";
+  }
+
+  function writeState(result) {
+    if (!config.writeStateFile && !config.stateFile) return;
+    const stateFile = getStateFilePath();
+    if (!stateFile) return;
+    try {
+      mkdirSync(dirname(stateFile), { recursive: true });
+      writeFileSync(
+        stateFile,
+        JSON.stringify(
+          {
+            pid: session.pid ?? null,
+            state: deriveState(result),
+            result,
+            updatedAt: new Date(result.ts).toISOString(),
+          },
+          null,
+          2,
+        ) + "\n",
+        "utf8",
+      );
+    } catch {
+      // probe state is advisory only.
+    }
+  }
+
   /**
    * L0: Process alive check.
    */
@@ -227,6 +276,7 @@ export function createHealthProbe(session, opts = {}) {
       ts: Date.now(),
     };
     status.lastProbeAt = result.ts;
+    writeState(result);
 
     if (typeof config.onProbe === "function") {
       config.onProbe(result);
@@ -259,6 +309,12 @@ export function createHealthProbe(session, opts = {}) {
       clearInterval(timer);
       timer = null;
     }
+    if (config.writeStateFile || config.stateFile) {
+      try {
+        const stateFile = getStateFilePath();
+        if (stateFile) unlinkSync(stateFile);
+      } catch {}
+    }
   }
 
   /** L1 tracking 리셋 (restart 후 호출) */

package/hub/team/retry-state-machine.mjs

@@ -39,8 +39,8 @@ export const MODES = Object.freeze({
 });
 
 const DEFAULT_ESCALATION_CHAIN = Object.freeze([
-  Object.freeze({ cli: "codex", model: "gpt-5-mini" }),
-  Object.freeze({ cli: "codex", model: "gpt-5" }),
+  Object.freeze({ cli: "codex", model: "gpt-5.4-mini" }),
+  Object.freeze({ cli: "codex", model: "gpt-5.5" }),
   Object.freeze({ cli: "claude", model: "sonnet-4-6" }),
   Object.freeze({ cli: "claude", model: "opus-4-7" }),
 ]);

package/package.json

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

package/scripts/hub-ensure.mjs

@@ -13,6 +13,7 @@ import { fileURLToPath } from "url";
 const LOOPBACK_HOSTS = new Set(["127.0.0.1", "localhost", "::1"]);
 const PLUGIN_ROOT = dirname(dirname(fileURLToPath(import.meta.url)));
 const HUB_PID_FILE = join(homedir(), ".claude", "cache", "tfx-hub", "hub.pid");
+const HUB_DEFAULT_PORT = 27888;
 
 function formatHostForUrl(host) {
   return host.includes(":") ? `[${host}]` : host;
@@ -34,29 +35,33 @@ async function syncHubConfigsIfAvailable({ hubUrl }) {
       await mod.syncCodexHubUrl({ hubUrl });
     }
     if (typeof mod?.syncProjectMcpJson === "function") {
-      await mod.syncProjectMcpJson({ hubUrl, projectRoot: PLUGIN_ROOT });
+      // 사용자 작업 디렉토리의 .mcp.json 을 sync 대상으로 한다.
+      // 이전에는 PLUGIN_ROOT(triflux 설치 경로)를 넘겨서 설치 경로의 .mcp.json
+      // 만 sync 되고 사용자 실제 프로젝트는 drift 되던 증상이 있었다.
+      await mod.syncProjectMcpJson({ hubUrl, projectRoot: process.cwd() });
     }
   } catch {
     // sync는 best-effort이며 hub-ensure 성공/실패를 좌우하지 않는다.
   }
 }
 
-function resolveHubTarget() {
+export function resolveHubTarget() {
   const envPortRaw = Number(process.env.TFX_HUB_PORT || "");
   const envPort =
     Number.isFinite(envPortRaw) && envPortRaw > 0 ? envPortRaw : null;
   const target = {
     host: "127.0.0.1",
-    port: envPort || 27888,
+    port: envPort ?? HUB_DEFAULT_PORT,
   };
 
+  // PID 파일의 port는 source of truth가 아니다. host 힌트만 재사용한다.
+  // 과거에는 `!envPort`일 때 PID file의 port로 target.port를 덮었으나,
+  // 이는 이전 세션의 오염된 port(비표준 포트)가 cascade로 영속화되는 버그 원인이었다.
+  // 포트는 오직 TFX_HUB_PORT env(없으면 HUB_DEFAULT_PORT=27888)만 source of truth다.
+  // client config 는 sync-hub-mcp-settings.mjs가 이 hubUrl로 재동기화한다.
   if (existsSync(HUB_PID_FILE)) {
     try {
       const info = JSON.parse(readFileSync(HUB_PID_FILE, "utf8"));
-      if (!envPort) {
-        const pidPort = Number(info?.port);
-        if (Number.isFinite(pidPort) && pidPort > 0) target.port = pidPort;
-      }
       if (typeof info?.host === "string") {
         const host = info.host.trim();
         if (LOOPBACK_HOSTS.has(host)) target.host = host;