triflux 10.14.2 → 10.14.3

package/package.json

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

package/scripts/__tests__/mcp-guard-engine.test.mjs

@@ -101,14 +101,16 @@ describe("mcp guard engine", () => {
     );
   });
 
-  it("replaces stdio MCP entries with tfx-hub and writes a backup", () => {
+  it("replaces stdio MCP entries with tfx-hub and writes a backup (TFX_HUB_PORT env overrides)", () => {
     const homeDir = createHomeDir();
     withHome(homeDir);
+    process.env.TFX_HUB_PORT = "30123";
 
+    // hub.pid port 는 무시되어야 한다 (PR #158: pid = host hint only).
     const pidPath = join(homeDir, ".claude", "cache", "tfx-hub", "hub.pid");
     writeFileSync(
       pidPath,
-      JSON.stringify({ host: "127.0.0.1", port: 30123 }),
+      JSON.stringify({ host: "127.0.0.1", port: 40404 }),
       "utf8",
     );
 
@@ -141,9 +143,18 @@ describe("mcp guard engine", () => {
     assert.equal(Object.hasOwn(updated.mcpServers, "unsafe-stdio"), false);
   });
 
-  it("uses hub.pid port before registry fallback when resolving Hub URL", () => {
+  it("uses TFX_HUB_PORT env as single source when resolving Hub URL", () => {
     const homeDir = createHomeDir();
     withHome(homeDir);
+    process.env.TFX_HUB_PORT = "29991";
+
+    assert.equal(resolveHubUrl(), "http://127.0.0.1:29991/mcp");
+  });
+
+  it("ignores hub.pid port (pid is host hint only, PR #158 policy)", () => {
+    const homeDir = createHomeDir();
+    withHome(homeDir);
+    delete process.env.TFX_HUB_PORT;
 
     writeFileSync(
       join(homeDir, ".claude", "cache", "tfx-hub", "hub.pid"),
@@ -151,6 +162,8 @@ describe("mcp guard engine", () => {
       "utf8",
     );
 
-    assert.equal(resolveHubUrl(), "http://127.0.0.1:29991/mcp");
+    // env 없음 + hub.pid port 존재 → registry/default 27888 fallback.
+    // pid port cascade 가 제거되어 29991 이 쓰이면 안 됨.
+    assert.equal(resolveHubUrl(), "http://127.0.0.1:27888/mcp");
   });
 });

package/scripts/lib/mcp-guard-engine.mjs

@@ -851,14 +851,13 @@ export function resolveHubUrl() {
         : DEFAULT_HUB_PATH,
   };
 
+  // PR #158 정책: port = TFX_HUB_PORT env (없으면 registry/default 27888) single source.
+  // hub.pid 는 loopback host 힌트 전용. 과거 pid port cascade 는 오염된 port 영속화의
+  // 원인이었고 hub-ensure.resolveHubTarget 에서 이미 제거됨. 여기도 일관 적용.
   const hubPidPath = join(homedir(), ".claude", "cache", "tfx-hub", "hub.pid");
   if (existsSync(hubPidPath)) {
     try {
       const info = readJsonFile(hubPidPath);
-      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;