triflux 3.2.0-dev.5 → 3.2.0-dev.7

package/README.ko.md

@@ -212,11 +212,13 @@ tfx doctor
 |--------|------|
 | `tfx setup` | 스크립트 + HUD + 스킬 동기화 |
 | `tfx doctor` | CLI 진단 + 이슈 추적 |
-| `tfx update` | 최신 버전으로 업데이트 |
-| `tfx list` | 설치된 스킬 목록 |
-| `tfx version` | 버전 표시 |
-
-축약: `tfx` = `triflux`, `tfl` = `triflux`
+| `tfx update` | 최신 안정 버전으로 업데이트 |
+| `tfx list` | 설치된 스킬 목록 |
+| `tfx version` | 버전 표시 |
+
+축약: `tfx` = `triflux`, `tfl` = `triflux`
+
+dev 채널 업데이트: `tfx update --dev` (`dev` 별칭 지원)
 
 ### HUD 상태 표시줄
 

package/README.md

@@ -212,11 +212,13 @@ tfx doctor
 |---------|-------------|
 | `tfx setup` | Sync scripts + HUD + skills |
 | `tfx doctor` | CLI diagnostics + issue tracker |
-| `tfx update` | Update to latest version |
-| `tfx list` | List installed skills |
-| `tfx version` | Show version info |
-
-Shortcuts: `tfx` = `triflux`, `tfl` = `triflux`
+| `tfx update` | Update to latest stable version |
+| `tfx list` | List installed skills |
+| `tfx version` | Show version info |
+
+Shortcuts: `tfx` = `triflux`, `tfl` = `triflux`
+
+Dev channel update: `tfx update --dev` (`dev` alias supported)
 
 ### HUD Status Bar
 

package/bin/triflux.mjs

@@ -3,9 +3,10 @@
 import { copyFileSync, existsSync, readFileSync, writeFileSync, mkdirSync, chmodSync, readdirSync, unlinkSync } from "fs";
 import { join, dirname } from "path";
 import { homedir } from "os";
-import { execSync, spawn } from "child_process";
-
-const PKG_ROOT = dirname(dirname(new URL(import.meta.url).pathname)).replace(/^\/([A-Z]:)/, "$1");
+import { execSync, spawn } from "child_process";
+import { fileURLToPath } from "url";
+
+const PKG_ROOT = dirname(dirname(fileURLToPath(import.meta.url)));
 const CLAUDE_DIR = join(homedir(), ".claude");
 const CODEX_DIR = join(homedir(), ".codex");
 const CODEX_CONFIG_PATH = join(CODEX_DIR, "config.toml");
@@ -67,7 +68,7 @@ function which(cmd) {
   } catch { return null; }
 }
 
-function whichInShell(cmd, shell) {
+function whichInShell(cmd, shell) {
   const cmds = {
     bash: `bash -c "source ~/.bashrc 2>/dev/null && command -v ${cmd} 2>/dev/null"`,
     cmd: `cmd /c where ${cmd} 2>nul`,
@@ -82,8 +83,12 @@ function whichInShell(cmd, shell) {
       stdio: ["pipe", "pipe", "ignore"],
     }).trim();
     return result.split(/\r?\n/)[0] || null;
-  } catch { return null; }
-}
+  } catch { return null; }
+}
+
+function isDevUpdateRequested(argv = process.argv) {
+  return argv.includes("--dev") || argv.includes("@dev") || argv.includes("dev");
+}
 
 function checkShellAvailable(shell) {
   const cmds = { bash: "bash --version", cmd: "cmd /c echo ok", pwsh: "pwsh -NoProfile -c echo ok" };
@@ -676,9 +681,9 @@ function cmdDoctor(options = {}) {
   }
 }
 
-function cmdUpdate() {
-  const isDev = process.argv.includes("--dev");
-  const tagLabel = isDev ? ` ${YELLOW}@dev${RESET}` : "";
+function cmdUpdate() {
+  const isDev = isDevUpdateRequested(process.argv);
+  const tagLabel = isDev ? ` ${YELLOW}--dev${RESET}` : "";
   console.log(`\n${BOLD}triflux update${RESET}${tagLabel}\n`);
 
   // 1. 설치 방식 감지
@@ -755,7 +760,7 @@ function cmdUpdate() {
           timeout: 60000,
           stdio: ["pipe", "pipe", "ignore"],
         }).trim().split(/\r?\n/)[0];
-        ok(`${isDev ? "npm install -g @dev" : "npm update -g"} — ${result || "완료"}`);
+        ok(`${isDev ? "npm install -g triflux@dev" : "npm update -g triflux"} — ${result || "완료"}`);
         updated = true;
         break;
       }
@@ -767,7 +772,7 @@ function cmdUpdate() {
           cwd: process.cwd(),
           stdio: ["pipe", "pipe", "ignore"],
         }).trim().split(/\r?\n/)[0];
-        ok(`npm update — ${result || "완료"}`);
+        ok(`${isDev ? "npm install triflux@dev" : "npm update triflux"} — ${result || "완료"}`);
         updated = true;
         break;
       }
@@ -914,8 +919,8 @@ ${updateNotice}
     ${WHITE_BRIGHT}tfx doctor${RESET}     ${GRAY}CLI 진단 + 이슈 확인${RESET}
     ${DIM}  --fix${RESET}        ${GRAY}진단 + 자동 수정${RESET}
     ${DIM}  --reset${RESET}      ${GRAY}캐시 전체 초기화${RESET}
-    ${WHITE_BRIGHT}tfx update${RESET}     ${GRAY}최신 버전으로 업데이트${RESET}
-    ${DIM}  --dev${RESET}         ${GRAY}dev 태그로 업데이트${RESET}
+    ${WHITE_BRIGHT}tfx update${RESET}     ${GRAY}최신 안정 버전으로 업데이트${RESET}
+    ${DIM}  --dev / dev${RESET}   ${GRAY}dev 태그로 업데이트${RESET}
     ${WHITE_BRIGHT}tfx list${RESET}       ${GRAY}설치된 스킬 목록${RESET}
     ${WHITE_BRIGHT}tfx hub${RESET}        ${GRAY}MCP 메시지 버스 관리 (start/stop/status)${RESET}
     ${WHITE_BRIGHT}tfx team${RESET}       ${GRAY}멀티-CLI 팀 모드 (tmux + Hub)${RESET}
@@ -961,27 +966,31 @@ async function cmdCodexTeam() {
     return;
   }
 
-  const hasAgents = args.includes("--agents");
-  const hasLead = args.includes("--lead");
-  const hasLayout = args.includes("--layout");
-  const isControl = passthrough.has(sub);
-  const inject = [];
-  if (!isControl && !hasLead) inject.push("--lead", "codex");
-  if (!isControl && !hasAgents) inject.push("--agents", "codex,codex");
-  if (!isControl && !hasLayout) inject.push("--layout", "1xN");
-  const forwarded = isControl ? args : [...inject, ...args];
-
-  const { pathToFileURL } = await import("node:url");
-  const { cmdTeam } = await import(pathToFileURL(join(PKG_ROOT, "hub", "team", "cli.mjs")).href);
-
-  const prevArgv = process.argv;
-  process.argv = [prevArgv[0], prevArgv[1], "team", ...forwarded];
-  try {
-    await cmdTeam();
-  } finally {
-    process.argv = prevArgv;
-  }
-}
+  const hasAgents = args.includes("--agents");
+  const hasLead = args.includes("--lead");
+  const hasLayout = args.includes("--layout");
+  const isControl = passthrough.has(sub);
+  const normalizedArgs = isControl && args.length ? [sub, ...args.slice(1)] : args;
+  const inject = [];
+  if (!isControl && !hasLead) inject.push("--lead", "codex");
+  if (!isControl && !hasAgents) inject.push("--agents", "codex,codex");
+  if (!isControl && !hasLayout) inject.push("--layout", "1xN");
+  const forwarded = isControl ? normalizedArgs : [...inject, ...args];
+
+  const prevArgv = process.argv;
+  const prevProfile = process.env.TFX_TEAM_PROFILE;
+  process.env.TFX_TEAM_PROFILE = "codex-team";
+  const { pathToFileURL } = await import("node:url");
+  const { cmdTeam } = await import(pathToFileURL(join(PKG_ROOT, "hub", "team", "cli.mjs")).href);
+  process.argv = [prevArgv[0], prevArgv[1], "team", ...forwarded];
+  try {
+    await cmdTeam();
+  } finally {
+    process.argv = prevArgv;
+    if (typeof prevProfile === "string") process.env.TFX_TEAM_PROFILE = prevProfile;
+    else delete process.env.TFX_TEAM_PROFILE;
+  }
+}
 
 // ── hub 서브커맨드 ──
 
@@ -1062,10 +1071,40 @@ function autoRegisterMcp(mcpUrl) {
   } catch (e) { warn(`Claude 등록 실패: ${e.message}`); }
 }
 
-function cmdHub() {
-  const sub = process.argv[3] || "status";
-
-  switch (sub) {
+async function cmdHub() {
+  const sub = process.argv[3] || "status";
+  const defaultPortRaw = Number(process.env.TFX_HUB_PORT || "27888");
+  const probePort = Number.isFinite(defaultPortRaw) && defaultPortRaw > 0 ? defaultPortRaw : 27888;
+  const formatHostForUrl = (host) => host.includes(":") ? `[${host}]` : host;
+  const probeHubStatus = async (host = "127.0.0.1", port = probePort, timeoutMs = 3000) => {
+    try {
+      const res = await fetch(`http://${formatHostForUrl(host)}:${port}/status`, {
+        signal: AbortSignal.timeout(timeoutMs),
+      });
+      if (!res.ok) return null;
+      const data = await res.json();
+      return data?.hub ? data : null;
+    } catch {
+      return null;
+    }
+  };
+  const recoverPidFile = (statusData, defaultHost = "127.0.0.1") => {
+    const pid = Number(statusData?.pid);
+    const port = Number(statusData?.port) || probePort;
+    if (!Number.isFinite(pid) || pid <= 0) return;
+    try {
+      mkdirSync(HUB_PID_DIR, { recursive: true });
+      writeFileSync(HUB_PID_FILE, JSON.stringify({
+        pid,
+        port,
+        host: defaultHost,
+        url: `http://${formatHostForUrl(defaultHost)}:${port}/mcp`,
+        started: Date.now(),
+      }));
+    } catch {}
+  };
+
+  switch (sub) {
     case "start": {
       // 이미 실행 중인지 확인
       if (existsSync(HUB_PID_FILE)) {
@@ -1096,13 +1135,13 @@ function cmdHub() {
       });
       child.unref();
 
-      // PID 파일 확인 (최대 3초 대기, 100ms 폴링)
-      let started = false;
-      const deadline = Date.now() + 3000;
-      while (Date.now() < deadline) {
-        if (existsSync(HUB_PID_FILE)) { started = true; break; }
-        execSync("node -e \"setTimeout(()=>{},100)\"", { stdio: "ignore", timeout: 500 });
-      }
+      // PID 파일 확인 (최대 3초 대기, 100ms 폴링)
+      let started = false;
+      const deadline = Date.now() + 3000;
+      while (Date.now() < deadline) {
+        if (existsSync(HUB_PID_FILE)) { started = true; break; }
+        await new Promise((r) => setTimeout(r, 100));
+      }
 
       if (started) {
         const hubInfo = JSON.parse(readFileSync(HUB_PID_FILE, "utf8"));
@@ -1121,11 +1160,20 @@ function cmdHub() {
       break;
     }
 
-    case "stop": {
-      if (!existsSync(HUB_PID_FILE)) {
-        console.log(`\n  ${DIM}hub 미실행${RESET}\n`);
-        return;
-      }
+    case "stop": {
+      if (!existsSync(HUB_PID_FILE)) {
+        const probed = await probeHubStatus("127.0.0.1", probePort, 1500)
+          || (probePort === 27888 ? null : await probeHubStatus("127.0.0.1", 27888, 1500));
+        if (probed && Number.isFinite(Number(probed.pid))) {
+          try {
+            process.kill(Number(probed.pid), "SIGTERM");
+            console.log(`\n  ${GREEN_BRIGHT}✓${RESET} hub 종료됨 (PID ${probed.pid})${DIM} (probe)${RESET}\n`);
+            return;
+          } catch {}
+        }
+        console.log(`\n  ${DIM}hub 미실행${RESET}\n`);
+        return;
+      }
       try {
         const info = JSON.parse(readFileSync(HUB_PID_FILE, "utf8"));
         process.kill(info.pid, "SIGTERM");
@@ -1137,14 +1185,36 @@ function cmdHub() {
       }
       break;
     }
-
-    case "status": {
-      if (!existsSync(HUB_PID_FILE)) {
-        console.log(`\n  ${AMBER}${BOLD}⬡ tfx-hub${RESET} ${RED}offline${RESET}\n`);
-        return;
-      }
-      try {
-        const info = JSON.parse(readFileSync(HUB_PID_FILE, "utf8"));
+
+    case "status": {
+      if (!existsSync(HUB_PID_FILE)) {
+        const probed = await probeHubStatus();
+        if (!probed) {
+          const fallback = probePort === 27888 ? null : await probeHubStatus("127.0.0.1", 27888, 1500);
+          if (fallback) {
+          console.log(`\n  ${AMBER}${BOLD}⬡ tfx-hub${RESET} ${GREEN_BRIGHT}online${RESET} ${DIM}(default port probe 성공)${RESET}`);
+          console.log(`    URL:     http://127.0.0.1:${fallback.port || 27888}/mcp`);
+          if (fallback.pid !== undefined) console.log(`    PID:     ${fallback.pid}`);
+          if (fallback.hub?.state) console.log(`    State:   ${fallback.hub.state}`);
+          if (fallback.sessions !== undefined) console.log(`    Sessions: ${fallback.sessions}`);
+          recoverPidFile(fallback, "127.0.0.1");
+          console.log("");
+          return;
+        }
+          console.log(`\n  ${AMBER}${BOLD}⬡ tfx-hub${RESET} ${RED}offline${RESET}\n`);
+          return;
+        }
+        console.log(`\n  ${AMBER}${BOLD}⬡ tfx-hub${RESET} ${GREEN_BRIGHT}online${RESET} ${DIM}(pid file 없음 / probe 성공)${RESET}`);
+        console.log(`    URL:     http://127.0.0.1:${probed.port || probePort}/mcp`);
+        if (probed.pid !== undefined) console.log(`    PID:     ${probed.pid}`);
+        if (probed.hub?.state) console.log(`    State:   ${probed.hub.state}`);
+        if (probed.sessions !== undefined) console.log(`    Sessions: ${probed.sessions}`);
+        recoverPidFile(probed, "127.0.0.1");
+        console.log("");
+        return;
+      }
+      try {
+        const info = JSON.parse(readFileSync(HUB_PID_FILE, "utf8"));
         process.kill(info.pid, 0); // 생존 확인
         const uptime = Date.now() - info.started;
         const uptimeStr = uptime < 60000 ? `${Math.round(uptime / 1000)}초`
@@ -1154,28 +1224,39 @@ function cmdHub() {
         console.log(`\n  ${AMBER}${BOLD}⬡ tfx-hub${RESET} ${GREEN_BRIGHT}online${RESET}`);
         console.log(`    URL:     ${info.url}`);
         console.log(`    PID:     ${info.pid}`);
-        console.log(`    Uptime:  ${uptimeStr}`);
-
-        // HTTP 상태 조회 시도
-        try {
-          const statusUrl = info.url.replace("/mcp", "/status");
-          const result = execSync(`curl -s "${statusUrl}"`, { encoding: "utf8", timeout: 3000, stdio: ["pipe", "pipe", "ignore"] });
-          const data = JSON.parse(result);
-          if (data.hub) {
-            console.log(`    State:   ${data.hub.state}`);
-          }
+        console.log(`    Uptime:  ${uptimeStr}`);
+
+        // HTTP 상태 조회 시도
+        try {
+          const host = typeof info.host === "string" ? info.host : "127.0.0.1";
+          const port = Number(info.port) || probePort;
+          const data = await probeHubStatus(host, port, 3000);
+          if (data.hub) {
+            console.log(`    State:   ${data.hub.state}`);
+          }
           if (data.sessions !== undefined) {
             console.log(`    Sessions: ${data.sessions}`);
           }
         } catch {}
 
         console.log("");
-      } catch {
-        try { unlinkSync(HUB_PID_FILE); } catch {}
-        console.log(`\n  ${AMBER}${BOLD}⬡ tfx-hub${RESET} ${RED}offline${RESET} ${DIM}(stale PID 정리됨)${RESET}\n`);
-      }
-      break;
-    }
+      } catch {
+        try { unlinkSync(HUB_PID_FILE); } catch {}
+        const probed = await probeHubStatus();
+        if (!probed) {
+          console.log(`\n  ${AMBER}${BOLD}⬡ tfx-hub${RESET} ${RED}offline${RESET} ${DIM}(stale PID 정리됨)${RESET}\n`);
+          break;
+        }
+        console.log(`\n  ${AMBER}${BOLD}⬡ tfx-hub${RESET} ${GREEN_BRIGHT}online${RESET} ${DIM}(stale PID 정리 후 probe 성공)${RESET}`);
+        console.log(`    URL:     http://127.0.0.1:${probed.port || probePort}/mcp`);
+        if (probed.pid !== undefined) console.log(`    PID:     ${probed.pid}`);
+        if (probed.hub?.state) console.log(`    State:   ${probed.hub.state}`);
+        if (probed.sessions !== undefined) console.log(`    Sessions: ${probed.sessions}`);
+        recoverPidFile(probed, "127.0.0.1");
+        console.log("");
+      }
+      break;
+    }
 
     default:
       console.log(`\n  ${AMBER}${BOLD}⬡ tfx-hub${RESET}\n`);
@@ -1200,7 +1281,7 @@ switch (cmd) {
   }
   case "update":  cmdUpdate(); break;
   case "list": case "ls": cmdList(); break;
-  case "hub":     cmdHub(); break;
+  case "hub":     await cmdHub(); break;
   case "team": {
     const { pathToFileURL } = await import("node:url");
     const { cmdTeam } = await import(pathToFileURL(join(PKG_ROOT, "hub", "team", "cli.mjs")).href);

package/hub/server.mjs

@@ -116,16 +116,25 @@ export async function startHub({ port = 27888, dbPath, host = '127.0.0.1' } = {}
       return res.end();
     }
 
-    // /status — 허브 상태 (브라우저/curl 용)
-    if (req.url === '/' || req.url === '/status') {
-      res.writeHead(200, { 'Content-Type': 'application/json' });
-      return res.end(JSON.stringify({
-        ...router.getStatus('hub').data,
-        sessions: transports.size,
-        pid: process.pid,
-        port,
-      }));
-    }
+    // /status — 상세 상태 (브라우저/curl 용)
+    if (req.url === '/' || req.url === '/status') {
+      const status = router.getStatus('hub').data;
+      res.writeHead(200, { 'Content-Type': 'application/json' });
+      return res.end(JSON.stringify({
+        ...status,
+        sessions: transports.size,
+        pid: process.pid,
+        port,
+      }));
+    }
+
+    // /health, /healthz — 최소 헬스 응답 (레거시 호환)
+    if (req.url === '/health' || req.url === '/healthz') {
+      const status = router.getStatus('hub').data;
+      const healthy = status?.hub?.state === 'healthy';
+      res.writeHead(healthy ? 200 : 503, { 'Content-Type': 'application/json' });
+      return res.end(JSON.stringify({ ok: healthy }));
+    }
 
     // /bridge/* — 경량 REST 엔드포인트 (tfx-route.sh 브릿지용)
     if (req.url.startsWith('/bridge')) {

package/hub/team/cli.mjs

@@ -1,9 +1,9 @@
 // hub/team/cli.mjs — tfx team CLI 진입점
 // bin/triflux.mjs에서 import하여 사용
-import { existsSync, readFileSync, writeFileSync, mkdirSync, unlinkSync } from "node:fs";
-import { join, dirname } from "node:path";
-import { homedir } from "node:os";
-import { execSync, spawn } from "node:child_process";
+import { existsSync, readFileSync, writeFileSync, mkdirSync, unlinkSync } from "node:fs";
+import { join, dirname } from "node:path";
+import { homedir } from "node:os";
+import { spawn } from "node:child_process";
 
 import {
   createSession,
@@ -27,10 +27,18 @@ import { buildCliCommand, startCliInPane, injectPrompt, sendKeys } from "./pane.
 import { orchestrate, decomposeTask, buildLeadPrompt, buildPrompt } from "./orchestrator.mjs";
 
 // ── 상수 ──
-const PKG_ROOT = dirname(dirname(dirname(new URL(import.meta.url).pathname))).replace(/^\/([A-Z]:)/, "$1");
-const HUB_PID_DIR = join(homedir(), ".claude", "cache", "tfx-hub");
-const HUB_PID_FILE = join(HUB_PID_DIR, "hub.pid");
-const TEAM_STATE_FILE = join(HUB_PID_DIR, "team-state.json");
+const PKG_ROOT = dirname(dirname(dirname(new URL(import.meta.url).pathname))).replace(/^\/([A-Z]:)/, "$1");
+const HUB_PID_DIR = join(homedir(), ".claude", "cache", "tfx-hub");
+const HUB_PID_FILE = join(HUB_PID_DIR, "hub.pid");
+const LOOPBACK_HOSTS = new Set(["127.0.0.1", "localhost", "::1"]);
+const TEAM_PROFILE = (() => {
+  const raw = String(process.env.TFX_TEAM_PROFILE || "team").trim().toLowerCase();
+  return raw === "codex-team" ? "codex-team" : "team";
+})();
+const TEAM_STATE_FILE = join(
+  HUB_PID_DIR,
+  TEAM_PROFILE === "codex-team" ? "team-state-codex-team.json" : "team-state.json",
+);
 
 const TEAM_SUBCOMMANDS = new Set([
   "status", "attach", "stop", "kill", "send", "list", "help", "tasks", "task", "focus", "interrupt", "control", "debug",
@@ -61,52 +69,149 @@ function loadTeamState() {
   }
 }
 
-function saveTeamState(state) {
-  mkdirSync(HUB_PID_DIR, { recursive: true });
-  writeFileSync(TEAM_STATE_FILE, JSON.stringify(state, null, 2) + "\n");
-}
-
-function clearTeamState() {
-  try { unlinkSync(TEAM_STATE_FILE); } catch {}
-}
-
-// ── Hub 유틸 ──
-
-function getHubInfo() {
-  if (!existsSync(HUB_PID_FILE)) return null;
-  try {
-    const info = JSON.parse(readFileSync(HUB_PID_FILE, "utf8"));
-    process.kill(info.pid, 0); // 프로세스 생존 확인
-    return info;
-  } catch {
-    return null;
-  }
-}
-
-function startHubDaemon() {
-  const serverPath = join(PKG_ROOT, "hub", "server.mjs");
-  if (!existsSync(serverPath)) {
-    fail("hub/server.mjs 없음 — hub 모듈이 설치되지 않음");
+function saveTeamState(state) {
+  mkdirSync(HUB_PID_DIR, { recursive: true });
+  const nextState = { ...state, profile: TEAM_PROFILE };
+  writeFileSync(TEAM_STATE_FILE, JSON.stringify(nextState, null, 2) + "\n");
+}
+
+function clearTeamState() {
+  try { unlinkSync(TEAM_STATE_FILE); } catch {}
+}
+
+// ── Hub 유틸 ──
+
+function formatHostForUrl(host) {
+  return host.includes(":") ? `[${host}]` : host;
+}
+
+function buildHubBaseUrl(host, port) {
+  return `http://${formatHostForUrl(host)}:${port}`;
+}
+
+function getDefaultHubPort() {
+  const envPortRaw = Number(process.env.TFX_HUB_PORT || "27888");
+  return Number.isFinite(envPortRaw) && envPortRaw > 0 ? envPortRaw : 27888;
+}
+
+function getDefaultHubUrl() {
+  return `${buildHubBaseUrl("127.0.0.1", getDefaultHubPort())}/mcp`;
+}
+
+function getDefaultHubBase() {
+  return getDefaultHubUrl().replace(/\/mcp$/, "");
+}
+
+function normalizeLoopbackHost(host) {
+  if (typeof host !== "string") return "127.0.0.1";
+  const candidate = host.trim();
+  return LOOPBACK_HOSTS.has(candidate) ? candidate : "127.0.0.1";
+}
+
+async function probeHubStatus(host, port, timeoutMs = 1500) {
+  try {
+    const res = await fetch(`${buildHubBaseUrl(host, port)}/status`, {
+      signal: AbortSignal.timeout(timeoutMs),
+    });
+    if (!res.ok) return null;
+    const data = await res.json();
+    return data?.hub ? data : null;
+  } catch {
+    return null;
+  }
+}
+
+async function getHubInfo() {
+  const probePort = getDefaultHubPort();
+
+  if (existsSync(HUB_PID_FILE)) {
+    try {
+      const raw = JSON.parse(readFileSync(HUB_PID_FILE, "utf8"));
+      const pid = Number(raw?.pid);
+      if (!Number.isFinite(pid) || pid <= 0) throw new Error("invalid pid");
+      process.kill(pid, 0); // 프로세스 생존 확인
+      const host = normalizeLoopbackHost(raw?.host);
+      const port = Number(raw.port) || 27888;
+      const status = await probeHubStatus(host, port, 1200);
+      if (!status) {
+        // transient timeout/응답 지연은 stale로 단정하지 않고 기존 PID 정보를 유지한다.
+        return {
+          ...raw,
+          pid,
+          host,
+          port,
+          url: `${buildHubBaseUrl(host, port)}/mcp`,
+          degraded: true,
+        };
+      }
+      return {
+        ...raw,
+        pid,
+        host,
+        port,
+        url: `${buildHubBaseUrl(host, port)}/mcp`,
+      };
+    } catch {
+      try { unlinkSync(HUB_PID_FILE); } catch {}
+    }
+  }
+
+  // PID 파일이 없거나 stale인 경우에도 실제 Hub가 떠 있으면 재사용
+  const candidates = Array.from(new Set([probePort, 27888]));
+  for (const portCandidate of candidates) {
+    const data = await probeHubStatus("127.0.0.1", portCandidate, 1200);
+    if (!data) continue;
+    const port = Number(data.port) || portCandidate;
+    const pid = Number(data.pid);
+    const recovered = {
+      pid: Number.isFinite(pid) ? pid : null,
+      host: "127.0.0.1",
+      port,
+      url: `${buildHubBaseUrl("127.0.0.1", port)}/mcp`,
+      discovered: true,
+    };
+    if (Number.isFinite(recovered.pid) && recovered.pid > 0) {
+      try {
+        mkdirSync(HUB_PID_DIR, { recursive: true });
+        writeFileSync(HUB_PID_FILE, JSON.stringify({
+          pid: recovered.pid,
+          port: recovered.port,
+          host: recovered.host,
+          url: recovered.url,
+          started: Date.now(),
+        }));
+      } catch {}
+    }
+    return recovered;
+  }
+  return null;
+}
+
+async function startHubDaemon() {
+  const serverPath = join(PKG_ROOT, "hub", "server.mjs");
+  if (!existsSync(serverPath)) {
+    fail("hub/server.mjs 없음 — hub 모듈이 설치되지 않음");
     return null;
   }
 
-  const child = spawn(process.execPath, [serverPath], {
-    env: { ...process.env },
-    stdio: "ignore",
-    detached: true,
-  });
-  child.unref();
-
-  // PID 파일 확인 (최대 3초 대기)
-  const deadline = Date.now() + 3000;
-  while (Date.now() < deadline) {
-    if (existsSync(HUB_PID_FILE)) {
-      return JSON.parse(readFileSync(HUB_PID_FILE, "utf8"));
-    }
-    execSync('node -e "setTimeout(()=>{},100)"', { stdio: "ignore", timeout: 500 });
-  }
-  return null;
-}
+  const child = spawn(process.execPath, [serverPath], {
+    env: { ...process.env },
+    stdio: "ignore",
+    detached: true,
+  });
+  child.unref();
+
+  const expectedPort = getDefaultHubPort();
+
+  // Hub 상태 확인 (최대 3초 대기)
+  const deadline = Date.now() + 3000;
+  while (Date.now() < deadline) {
+    const info = await getHubInfo();
+    if (info && info.port === expectedPort) return info;
+    await new Promise((r) => setTimeout(r, 100));
+  }
+  return null;
+}
 
 // ── 인자 파싱 ──
 
@@ -316,8 +421,8 @@ function resolveMember(state, selector) {
   return null;
 }
 
-async function publishLeadControl(state, targetMember, command, reason = "") {
-  const hubBase = (state?.hubUrl || "http://127.0.0.1:27888/mcp").replace(/\/mcp$/, "");
+async function publishLeadControl(state, targetMember, command, reason = "") {
+  const hubBase = (state?.hubUrl || getDefaultHubUrl()).replace(/\/mcp$/, "");
   const leadAgent = (state?.members || []).find((m) => m.role === "lead")?.agentId || "lead";
 
   const payload = {
@@ -351,8 +456,8 @@ function isWtMode(state) {
   return state?.teammateMode === "wt";
 }
 
-function isTeamAlive(state) {
-  if (!state) return false;
+function isTeamAlive(state) {
+  if (!state) return false;
   if (isNativeMode(state)) {
     try {
       process.kill(state.native.supervisorPid, 0);
@@ -361,12 +466,14 @@ function isTeamAlive(state) {
       return false;
     }
   }
-  if (isWtMode(state)) {
-    // WT pane 상태를 신뢰성 있게 조회할 API가 없어 세션 환경/실행기 존재 여부로 판정
-    return hasWindowsTerminal() && hasWindowsTerminalSession();
-  }
-  return sessionExists(state.sessionName);
-}
+  if (isWtMode(state)) {
+    // WT pane 상태를 신뢰성 있게 조회할 API가 없어, WT_SESSION은 힌트로만 사용한다.
+    if (!hasWindowsTerminal()) return false;
+    if (hasWindowsTerminalSession()) return true;
+    return Array.isArray(state.members) && state.members.length > 0;
+  }
+  return sessionExists(state.sessionName);
+}
 
 async function nativeRequest(state, path, body = {}) {
   if (!isNativeMode(state)) return null;
@@ -464,7 +571,7 @@ async function startNativeSupervisor({ sessionId, task, lead, agents, subtasks,
 
 // ── 서브커맨드 ──
 
-async function teamStart() {
+async function teamStart() {
   const { agents, lead, layout, teammateMode, task } = parseTeamArgs();
   if (!task) {
     console.log(`\n  ${AMBER}${BOLD}⬡ tfx team${RESET}\n`);
@@ -477,10 +584,10 @@ async function teamStart() {
 
   console.log(`\n  ${AMBER}${BOLD}⬡ tfx team${RESET}\n`);
 
-  let hub = getHubInfo();
-  if (!hub) {
-    process.stdout.write("  Hub 시작 중...");
-    hub = startHubDaemon();
+  let hub = await getHubInfo();
+  if (!hub) {
+    process.stdout.write("  Hub 시작 중...");
+    hub = await startHubDaemon();
     if (hub) {
       console.log(` ${GREEN}✓${RESET}`);
     } else {
@@ -493,7 +600,7 @@ async function teamStart() {
 
   const sessionId = `tfx-team-${Date.now().toString(36).slice(-4)}`;
   const subtasks = decomposeTask(task, agents.length);
-  const hubUrl = hub?.url || "http://127.0.0.1:27888/mcp";
+  const hubUrl = hub?.url || getDefaultHubUrl();
   let effectiveTeammateMode = teammateMode;
 
   if (teammateMode === "wt") {
@@ -751,17 +858,20 @@ async function teamStart() {
     tasks,
   });
 
-  const taskListCommand = `${process.execPath} ${join(PKG_ROOT, "bin", "triflux.mjs")} team tasks`;
+  const profilePrefix = TEAM_PROFILE === "team" ? "" : `TFX_TEAM_PROFILE=${TEAM_PROFILE} `;
+  const taskListCommand = `${profilePrefix}${process.execPath} ${join(PKG_ROOT, "bin", "triflux.mjs")} team tasks`;
   configureTeammateKeybindings(sessionId, {
     inProcess: false,
     taskListCommand,
   });
 
-  console.log(`\n  ${GREEN}${BOLD}팀 세션 준비 완료${RESET}`);
-  console.log(`  ${DIM}Shift+Down: 다음 팀메이트 전환${RESET}`);
-  console.log(`  ${DIM}Escape: 현재 팀메이트 인터럽트${RESET}`);
-  console.log(`  ${DIM}Ctrl+T: 태스크 목록${RESET}`);
-  console.log(`  ${DIM}Ctrl+B → D: 세션 분리 (백그라운드)${RESET}\n`);
+  console.log(`\n  ${GREEN}${BOLD}팀 세션 준비 완료${RESET}`);
+  console.log(`  ${DIM}Shift+Down: 다음 팀메이트 전환${RESET}`);
+  console.log(`  ${DIM}Shift+Tab / Shift+Left: 이전 팀메이트 전환${RESET}`);
+  console.log(`  ${DIM}Escape: 현재 팀메이트 인터럽트${RESET}`);
+  console.log(`  ${DIM}Ctrl+T: 태스크 목록${RESET}`);
+  console.log(`  ${DIM}참고: 일부 터미널/호스트에서 Shift+Up 전달이 제한될 수 있음${RESET}`);
+  console.log(`  ${DIM}Ctrl+B → D: 세션 분리 (백그라운드)${RESET}\n`);
 
   if (process.stdout.isTTY && process.stdin.isTTY) {
     attachSession(sessionId);
@@ -785,10 +895,13 @@ async function teamStatus() {
   console.log(`\n  ${AMBER}${BOLD}⬡ tfx team${RESET} ${status}\n`);
   console.log(`    세션:   ${state.sessionName}`);
   console.log(`    모드:   ${state.teammateMode || "tmux"}`);
-  console.log(`    리드:   ${state.lead || "claude"}`);
-  console.log(`    워커:   ${(state.agents || []).join(", ")}`);
-  console.log(`    Uptime: ${uptime}`);
-  console.log(`    태스크: ${(state.tasks || []).length}`);
+  console.log(`    리드:   ${state.lead || "claude"}`);
+  console.log(`    워커:   ${(state.agents || []).join(", ")}`);
+  console.log(`    Uptime: ${uptime}`);
+  console.log(`    태스크: ${(state.tasks || []).length}`);
+  if (isWtMode(state) && !hasWindowsTerminalSession()) {
+    console.log(`    ${DIM}WT_SESSION 미감지: 생존성은 heuristics로 판정됨${RESET}`);
+  }
 
   const members = state.members || [];
   if (members.length) {
@@ -841,8 +954,8 @@ async function teamStatus() {
  * @param {object} state — team-state.json
  * @returns {Promise<Array>}
  */
-async function fetchHubTaskList(state) {
-  const hubBase = (state?.hubUrl || "http://127.0.0.1:27888/mcp").replace(/\/mcp$/, "");
+async function fetchHubTaskList(state) {
+  const hubBase = (state?.hubUrl || getDefaultHubUrl()).replace(/\/mcp$/, "");
   // teamName: native 모드는 state에 저장된 팀 이름, SKILL.md 모드는 세션 이름 기반
   const teamName = state?.native?.teamName || state?.sessionName || null;
   if (!teamName) return [];
@@ -952,7 +1065,7 @@ async function teamDebug() {
   const linesIdx = process.argv.findIndex((a) => a === "--lines" || a === "-n");
   const lines = linesIdx !== -1 ? Math.max(3, parseInt(process.argv[linesIdx + 1] || "20", 10) || 20) : 20;
   const mux = detectMultiplexer() || "none";
-  const hub = getHubInfo();
+  const hub = await getHubInfo();
 
   console.log(`\n  ${AMBER}${BOLD}⬡ Team Debug${RESET}\n`);
   console.log(`    platform:  ${process.platform}`);
@@ -970,9 +1083,10 @@ async function teamDebug() {
     return;
   }
 
-  console.log(`\n  ${BOLD}state${RESET}`);
-  console.log(`    session:   ${state.sessionName}`);
-  console.log(`    mode:      ${state.teammateMode || "tmux"}`);
+  console.log(`\n  ${BOLD}state${RESET}`);
+  console.log(`    session:   ${state.sessionName}`);
+  console.log(`    profile:   ${state.profile || TEAM_PROFILE}`);
+  console.log(`    mode:      ${state.teammateMode || "tmux"}`);
   console.log(`    lead:      ${state.lead}`);
   console.log(`    agents:    ${(state.agents || []).join(", ")}`);
   console.log(`    alive:     ${isTeamAlive(state) ? "yes" : "no"}`);
@@ -1336,13 +1450,15 @@ function teamHelp() {
     ${WHITE}tfx team kill${RESET}                        ${GRAY}모든 팀 세션 강제 종료${RESET}
     ${WHITE}tfx team list${RESET}                        ${GRAY}활성 세션 목록${RESET}
 
-  ${BOLD}키 조작(Claude teammate 스타일, tmux 모드)${RESET}
-    ${WHITE}Shift+Down${RESET}  ${GRAY}다음 팀메이트${RESET}
-    ${WHITE}Shift+Up${RESET}    ${GRAY}이전 팀메이트${RESET}
-    ${WHITE}Escape${RESET}      ${GRAY}현재 팀메이트 인터럽트${RESET}
-    ${WHITE}Ctrl+T${RESET}      ${GRAY}태스크 목록 토글${RESET}
-`);
-}
+  ${BOLD}키 조작(Claude teammate 스타일, tmux 모드)${RESET}
+    ${WHITE}Shift+Down${RESET}  ${GRAY}다음 팀메이트${RESET}
+    ${WHITE}Shift+Tab${RESET}   ${GRAY}이전 팀메이트 (권장)${RESET}
+    ${WHITE}Shift+Left${RESET}  ${GRAY}이전 팀메이트 (대체)${RESET}
+    ${WHITE}Shift+Up${RESET}    ${GRAY}이전 팀메이트 (환경 따라 미동작 가능)${RESET}
+    ${WHITE}Escape${RESET}      ${GRAY}현재 팀메이트 인터럽트${RESET}
+    ${WHITE}Ctrl+T${RESET}      ${GRAY}태스크 목록 토글${RESET}
+`);
+}
 
 // ── 메인 진입점 ──
 
@@ -1350,8 +1466,9 @@ function teamHelp() {
  * tfx team 서브커맨드 라우터
  * bin/triflux.mjs에서 호출
  */
-export async function cmdTeam() {
-  const sub = process.argv[3];
+export async function cmdTeam() {
+  const rawSub = process.argv[3];
+  const sub = typeof rawSub === "string" ? rawSub.toLowerCase() : rawSub;
 
   switch (sub) {
     case "status":    return teamStatus();
@@ -1370,13 +1487,13 @@ export async function cmdTeam() {
     case "--help":
     case "-h":
       return teamHelp();
-    case undefined:
-      return teamHelp();
-    default:
-      // 서브커맨드가 아니면 작업 문자열로 간주
-      if (!sub.startsWith("-") && TEAM_SUBCOMMANDS.has(sub)) {
-        return teamHelp();
-      }
-      return teamStart();
-  }
-}
+    case undefined:
+      return teamHelp();
+    default:
+      // 서브커맨드가 아니면 작업 문자열로 간주
+      if (typeof sub === "string" && !sub.startsWith("-") && TEAM_SUBCOMMANDS.has(sub)) {
+        return teamHelp();
+      }
+      return teamStart();
+  }
+}

package/hub/team/session.mjs

@@ -393,33 +393,49 @@ export function focusPane(target, opts = {}) {
   }
 }
 
-/**
- * 팀메이트 조작 키 바인딩 설정
- * - Shift+Down: 다음 팀메이트
- * - Shift+Up: 이전 팀메이트
- * - Escape: 현재 팀메이트 인터럽트(C-c)
- * - Ctrl+T: 태스크 목록 표시
- * @param {string} sessionName
+/**
+ * 팀메이트 조작 키 바인딩 설정
+ * - Shift+Down: 다음 팀메이트
+ * - Shift+Up: 이전 팀메이트
+ * - Shift+Left / Shift+Tab: 이전 팀메이트 대체 키
+ * - Shift+Right: 다음 팀메이트 대체 키
+ * - Escape: 현재 팀메이트 인터럽트(C-c)
+ * - Ctrl+T: 태스크 목록 표시
+ * @param {string} sessionName
  * @param {object} opts
  * @param {boolean} opts.inProcess
  * @param {string} opts.taskListCommand
  */
-export function configureTeammateKeybindings(sessionName, opts = {}) {
-  const { inProcess = false, taskListCommand = "" } = opts;
-  const cond = `#{==:#{session_name},${sessionName}}`;
-
-  if (inProcess) {
-    // 단일 뷰(zoom) 상태에서 팀메이트 순환
-    tmux(`bind-key -T root -n S-Down if-shell -F '${cond}' 'select-pane -t :.+ \\; resize-pane -Z' 'send-keys S-Down'`);
-    tmux(`bind-key -T root -n S-Up if-shell -F '${cond}' 'select-pane -t :.- \\; resize-pane -Z' 'send-keys S-Up'`);
-  } else {
-    // 분할 뷰에서 팀메이트 순환
-    tmux(`bind-key -T root -n S-Down if-shell -F '${cond}' 'select-pane -t :.+' 'send-keys S-Down'`);
-    tmux(`bind-key -T root -n S-Up if-shell -F '${cond}' 'select-pane -t :.-' 'send-keys S-Up'`);
-  }
-
-  // 현재 활성 pane 인터럽트
-  tmux(`bind-key -T root -n Escape if-shell -F '${cond}' 'send-keys C-c' 'send-keys Escape'`);
+export function configureTeammateKeybindings(sessionName, opts = {}) {
+  const { inProcess = false, taskListCommand = "" } = opts;
+  const cond = `#{==:#{session_name},${sessionName}}`;
+
+  // Shift+Up이 터미널/호스트 조합에 따라 전달되지 않는 경우가 있어
+  // 좌/우/Shift+Tab 대체 키를 함께 바인딩한다.
+  const bindNext = inProcess
+    ? `'select-pane -t :.+ \\; resize-pane -Z'`
+    : `'select-pane -t :.+'`;
+  const bindPrev = inProcess
+    ? `'select-pane -t :.- \\; resize-pane -Z'`
+    : `'select-pane -t :.-'`;
+
+  if (inProcess) {
+    // 단일 뷰(zoom) 상태에서 팀메이트 순환
+    tmux(`bind-key -T root -n S-Down if-shell -F '${cond}' ${bindNext} 'send-keys S-Down'`);
+    tmux(`bind-key -T root -n S-Up if-shell -F '${cond}' ${bindPrev} 'send-keys S-Up'`);
+  } else {
+    // 분할 뷰에서 팀메이트 순환
+    tmux(`bind-key -T root -n S-Down if-shell -F '${cond}' ${bindNext} 'send-keys S-Down'`);
+    tmux(`bind-key -T root -n S-Up if-shell -F '${cond}' ${bindPrev} 'send-keys S-Up'`);
+  }
+
+  // 대체 키: 일부 환경에서 S-Up이 누락될 때 사용
+  tmux(`bind-key -T root -n S-Right if-shell -F '${cond}' ${bindNext} 'send-keys S-Right'`);
+  tmux(`bind-key -T root -n S-Left if-shell -F '${cond}' ${bindPrev} 'send-keys S-Left'`);
+  tmux(`bind-key -T root -n BTab if-shell -F '${cond}' ${bindPrev} 'send-keys BTab'`);
+
+  // 현재 활성 pane 인터럽트
+  tmux(`bind-key -T root -n Escape if-shell -F '${cond}' 'send-keys C-c' 'send-keys Escape'`);
 
   // 태스크 목록 토글 (tmux 3.2+ popup 우선, 실패 시 안내 메시지)
   if (taskListCommand) {

package/package.json

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

package/scripts/hub-ensure.mjs

@@ -0,0 +1,83 @@
+#!/usr/bin/env node
+// SessionStart 훅에서 호출되는 Hub 보장 스크립트.
+// - /status 기반 헬스체크
+// - 비정상 시 Hub를 detached로 기동
+
+import { existsSync, readFileSync } from "fs";
+import { join, dirname } from "path";
+import { homedir } from "os";
+import { spawn } from "child_process";
+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");
+
+function formatHostForUrl(host) {
+  return host.includes(":") ? `[${host}]` : host;
+}
+
+function buildHubBaseUrl(host, port) {
+  return `http://${formatHostForUrl(host)}:${port}`;
+}
+
+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,
+  };
+
+  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;
+      }
+    } catch {
+      // ignore parse errors and use env/default
+    }
+  }
+
+  return target;
+}
+
+async function isHubHealthy(host, port) {
+  try {
+    const res = await fetch(`${buildHubBaseUrl(host, port)}/status`, {
+      signal: AbortSignal.timeout(1000),
+    });
+    if (!res.ok) return false;
+    const data = await res.json();
+    return data?.hub?.state === "healthy";
+  } catch {
+    return false;
+  }
+}
+
+function startHubDetached(port) {
+  const serverPath = join(PLUGIN_ROOT, "hub", "server.mjs");
+  if (!existsSync(serverPath)) return;
+
+  try {
+    const child = spawn(process.execPath, [serverPath], {
+      env: { ...process.env, TFX_HUB_PORT: String(port) },
+      detached: true,
+      stdio: "ignore",
+    });
+    child.unref();
+  } catch {
+    // best effort
+  }
+}
+
+const { host, port } = resolveHubTarget();
+if (!(await isHubHealthy(host, port))) {
+  startHubDetached(port);
+}

package/scripts/setup.mjs

@@ -4,11 +4,13 @@
 // - hud-qos-status.mjs를 ~/.claude/hud/에 동기화
 // - skills/를 ~/.claude/skills/에 동기화
 
-import { copyFileSync, mkdirSync, readFileSync, writeFileSync, readdirSync, existsSync, chmodSync, unlinkSync } from "fs";
-import { join, dirname } from "path";
-import { homedir } from "os";
-
-const PLUGIN_ROOT = dirname(dirname(new URL(import.meta.url).pathname)).replace(/^\/([A-Z]:)/, "$1");
+import { copyFileSync, mkdirSync, readFileSync, writeFileSync, readdirSync, existsSync, chmodSync, unlinkSync } from "fs";
+import { join, dirname } from "path";
+import { homedir } from "os";
+import { spawn } from "child_process";
+import { fileURLToPath } from "url";
+
+const PLUGIN_ROOT = dirname(dirname(fileURLToPath(import.meta.url)));
 const CLAUDE_DIR = join(homedir(), ".claude");
 const CODEX_DIR = join(homedir(), ".codex");
 const CODEX_CONFIG_PATH = join(CODEX_DIR, "config.toml");
@@ -50,15 +52,24 @@ const SYNC_MAP = [
   },
 ];
 
-function getVersion(filePath) {
-  try {
-    const content = readFileSync(filePath, "utf8");
-    const match = content.match(/VERSION\s*=\s*"([^"]+)"/);
-    return match ? match[1] : null;
-  } catch {
-    return null;
-  }
-}
+function getVersion(filePath) {
+  try {
+    const content = readFileSync(filePath, "utf8");
+    const match = content.match(/VERSION\s*=\s*"([^"]+)"/);
+    return match ? match[1] : null;
+  } catch {
+    return null;
+  }
+}
+
+function shouldSyncTextFile(src, dst) {
+  if (!existsSync(dst)) return true;
+  try {
+    return readFileSync(src, "utf8") !== readFileSync(dst, "utf8");
+  } catch {
+    return true;
+  }
+}
 
 function escapeRegExp(value) {
   return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
@@ -113,15 +124,13 @@ for (const { src, dst, label } of SYNC_MAP) {
     copyFileSync(src, dst);
     try { chmodSync(dst, 0o755); } catch {}
     synced++;
-  } else {
-    const srcVersion = getVersion(src);
-    const dstVersion = getVersion(dst);
-    if (srcVersion && dstVersion && srcVersion !== dstVersion) {
-      copyFileSync(src, dst);
-      try { chmodSync(dst, 0o755); } catch {}
-      synced++;
-    }
-  }
+  } else {
+    if (shouldSyncTextFile(src, dst)) {
+      copyFileSync(src, dst);
+      try { chmodSync(dst, 0o755); } catch {}
+      synced++;
+    }
+  }
 }
 
 // ── 스킬 동기화 ──
@@ -291,18 +300,36 @@ if (codexProfilesAdded > 0) {
   synced++;
 }
 
-// ── MCP 인벤토리 백그라운드 갱신 ──
-
-import { spawn } from "child_process";
-
-const mcpCheck = join(PLUGIN_ROOT, "scripts", "mcp-check.mjs");
-if (existsSync(mcpCheck)) {
-  const child = spawn(process.execPath, [mcpCheck], {
+// ── MCP 인벤토리 백그라운드 갱신 ──
+
+const mcpCheck = join(PLUGIN_ROOT, "scripts", "mcp-check.mjs");
+if (existsSync(mcpCheck)) {
+  const child = spawn(process.execPath, [mcpCheck], {
     detached: true,
     stdio: "ignore",
   });
-  child.unref(); // 부모 프로세스와 분리 — 비동기 실행
-}
+  child.unref(); // 부모 프로세스와 분리 — 비동기 실행
+}
+
+// ── Hub 헬스체크 + 자동 기동 (세션 시작 백그라운드) ──
+// setup 훅이 포그라운드 지연을 만들지 않도록 별도 detached 프로세스로 처리한다.
+const hubEnsure = join(PLUGIN_ROOT, "scripts", "hub-ensure.mjs");
+const isPostinstall = process.env.npm_lifecycle_event === "postinstall";
+const isCi = /^(1|true)$/i.test(process.env.CI || "");
+const disableHubAutostart = process.env.TFX_DISABLE_HUB_AUTOSTART === "1";
+
+if (!isPostinstall && !isCi && !disableHubAutostart && existsSync(hubEnsure)) {
+  try {
+    const child = spawn(process.execPath, [hubEnsure], {
+      env: process.env,
+      detached: true,
+      stdio: "ignore",
+    });
+    child.unref();
+  } catch {
+    // best effort: 실패해도 setup 흐름은 지속
+  }
+}
 
 // ── postinstall 배너 (npm install 시에만 출력) ──
 
@@ -330,11 +357,12 @@ ${B}╚════════════════════════
   ${G}✓${R} ${synced > 0 ? synced + " files synced" : "all files up to date"}
   ${G}✓${R} HUD statusLine   → settings.json
 
-${B}Commands:${R}
-  ${C}triflux${R} setup     파일 동기화 + HUD 설정
-  ${C}triflux${R} doctor    CLI 진단 (Codex/Gemini 확인)
-  ${C}triflux${R} list      설치된 스킬 목록
-  ${C}triflux${R} update    최신 버전으로 업데이트
+${B}Commands:${R}
+  ${C}triflux${R} setup     파일 동기화 + HUD 설정
+  ${C}triflux${R} doctor    CLI 진단 (Codex/Gemini 확인)
+  ${C}triflux${R} list      설치된 스킬 목록
+  ${C}triflux${R} update    최신 안정 버전으로 업데이트
+  ${C}triflux${R} update --dev  dev 채널로 업데이트 (${D}dev 별칭 지원${R})
 
 ${B}Shortcuts:${R}
   ${C}tfx${R}                 triflux 축약

package/skills/tfx-team/SKILL.md

@@ -35,6 +35,22 @@ argument-hint: '"작업 설명" | --agents codex,gemini "작업" | --tmux "작
 
 ## 실행 워크플로우
 
+### Phase 0: 사전 점검 정책 (출력 최소화)
+
+세션 시작 전 점검은 **리드 포그라운드에서 단계별로 장황하게 출력하지 않는다.**
+
+- 원칙:
+  - 사전 점검은 워커 생성과 **비동기 병렬**로 수행한다.
+  - 사용자가 요청하지 않으면 `Searched for ...`, 개별 `Bash(...)` 로그를 전면 보고하지 않는다.
+  - 리드에는 요약 한 줄만 노출한다. 예: `preflight: ok (route/hub)`
+  - Hub 점검은 `/status`를 기준으로 한다 (`/health` 단독 판정 금지).
+- 권장 체크 예시:
+  - `curl -sf http://127.0.0.1:27888/status >/dev/null && echo "Hub: OK" || echo "Hub: NOT RUNNING"`
+- 실패 시에만 상세를 노출한다:
+  - `tfx-route.sh` 없음
+  - Hub 비정상/미기동
+  - 필수 CLI 미설치
+
 ### Phase 1: 입력 파싱
 
 ```
@@ -192,7 +208,8 @@ Agent({
 ```
 "팀 '{teamName}' 생성 완료.
 Codex/Gemini 워커가 슬림 래퍼 Agent로 네비게이션에 등록되었습니다.
-Shift+Down으로 워커 간 전환이 가능합니다."
+Shift+Down으로 다음 워커, Shift+Tab/Shift+Left로 이전 워커 전환이 가능합니다.
+(Shift+Up은 일부 환경에서 동작하지 않을 수 있음)"
 ```
 
 ### Phase 4: 결과 수집 (truth source = team_task_list)
@@ -262,6 +279,7 @@ Bash("node {PKG_ROOT}/bin/triflux.mjs team --no-attach --agents {agents.join(','
 - **codex/gemini CLI** — 해당 에이전트 사용 시
 - **tfx setup** — tfx-route.sh 동기화 + AGENT_TEAMS 자동 설정 (사전 실행 권장)
 - **Hub bridge 활성 상태** — 기본 `http://127.0.0.1:27888` (`/bridge/team/*`, `/bridge/result` 사용)
+- **출력 정책** — preflight는 비동기/요약 출력이 기본이며, 실패 시에만 상세 출력
 
 ## 에러 처리