@triflux/remote 10.1.0 → 10.26.0

package/hub/team/tui-lite.mjs

@@ -1,114 +1,56 @@
-import { altScreenOff, altScreenOn, BG, bold, box, clearScreen, clearToEnd, color, cursorHide, cursorHome, cursorShow, dim, eraseBelow, FG, MOCHA, padRight, progressBar, statusBadge, stripAnsi, truncate, wcswidth } from "./ansi.mjs";
+import {
+  altScreenOff,
+  altScreenOn,
+  BG,
+  bold,
+  box,
+  clearScreen,
+  clearToEnd,
+  color,
+  cursorHide,
+  cursorHome,
+  cursorShow,
+  dim,
+  eraseBelow,
+  FG,
+  MOCHA,
+  moveTo,
+  padRight,
+  progressBar,
+  statusBadge,
+  stripAnsi,
+  truncate,
+} from "./ansi.mjs";
+import {
+  normalizeWorkerState as coreNormalizeWorkerState,
+  formatTokens,
+  loadVersion,
+  resolveViewportColumns,
+  resolveViewportRows,
+  runtimeStatus,
+  sanitizeFiles,
+  VALID_TABS as VALID_TABS_ARRAY,
+  wrapText as wrapTextFull,
+} from "./tui-core.mjs";
 
-const FALLBACK_COLUMNS = 100, FALLBACK_ROWS = 24;
-const VALID_TABS = new Set(["log", "detail", "files"]);
-
-let VERSION = "lite";
-try { const { createRequire } = await import("node:module"); VERSION = createRequire(import.meta.url)("../../package.json").version; } catch {}
-
-const clamp = (value, min, max) => Math.min(max, Math.max(min, value));
-
-function sanitizeBlock(text, rawMode = false) {
-  const value = String(text || "").replace(/\r/g, "");
-  const cleaned = rawMode
-    ? value
-    : value
-        .replace(/```[\s\S]*?(?:```|$)/g, "\n")
-        .replace(/^\s*```.*$/gm, "")
-        .replace(/^(?:PS\s+\S[^\n]*?>|>\s+|\$\s+)[^\n]*/gm, "");
-  return cleaned
-    .split("\n")
-    .map((line) => line.trim())
-    .filter(Boolean)
-    .filter((line) => line !== "--- HANDOFF ---")
-    .join("\n")
-    .trim();
-}
-
-function sanitizeOneLine(text, fallback = "") {
-  return sanitizeBlock(text).replace(/\s+/g, " ").trim() || fallback;
-}
-
-function sanitizeFiles(files) {
-  const list = Array.isArray(files) ? files : String(files || "").split(",");
-  return list.map((entry) => sanitizeOneLine(entry)).filter(Boolean);
-}
-
-function normalizeTokens(tokens) {
-  if (tokens === null || tokens === undefined || tokens === "") return "";
-  if (typeof tokens === "number" && Number.isFinite(tokens)) return tokens;
-  const raw = sanitizeOneLine(tokens);
-  const match = raw.match(/(\d+(?:[.,]\d+)?\s*[kKmM]?)/);
-  return match ? match[1].replace(/\s+/g, "").toLowerCase() : raw;
-}
-
-function formatTokens(tokens) {
-  if (!tokens && tokens !== 0) return "n/a";
-  if (typeof tokens === "number") {
-    if (tokens >= 1_000_000) return `${(tokens / 1_000_000).toFixed(1)}m`;
-    if (tokens >= 1_000) return `${(tokens / 1_000).toFixed(1)}k`;
-  }
-  return String(tokens);
-}
+const VERSION = await loadVersion("lite");
+const VALID_TABS = new Set(VALID_TABS_ARRAY);
 
 function wrap(text, width) {
-  const limit = Math.max(8, width);
-  const lines = [];
-  for (const rawLine of sanitizeBlock(text).split("\n")) {
-    const words = rawLine.split(/\s+/).filter(Boolean);
-    if (words.length === 0) continue;
-    let current = "";
-    for (const word of words) {
-      const next = current ? `${current} ${word}` : word;
-      if (wcswidth(next) <= limit) {
-        current = next;
-        continue;
-      }
-      if (current) lines.push(current);
-      current = word;
-      while (wcswidth(current) > limit) {
-        lines.push(current.slice(0, limit));
-        current = current.slice(limit);
-      }
-    }
-    if (current) lines.push(current);
-  }
-  return lines;
+  return wrapTextFull(text, width);
 }
 
-const runtimeStatus = (worker) => worker?.handoff?.status || worker?.status || "pending";
-
 function normalizeWorkerState(existing = {}, state = {}) {
-  const handoff = state.handoff === undefined
-    ? existing.handoff
-    : {
-        ...(existing.handoff || {}),
-        ...(state.handoff || {}),
-        verdict: state.handoff?.verdict !== undefined ? sanitizeOneLine(state.handoff.verdict) : existing.handoff?.verdict,
-        confidence: state.handoff?.confidence !== undefined ? sanitizeOneLine(state.handoff.confidence) : existing.handoff?.confidence,
-        status: state.handoff?.status !== undefined ? sanitizeOneLine(state.handoff.status) : existing.handoff?.status,
-        files_changed: state.handoff?.files_changed !== undefined ? sanitizeFiles(state.handoff.files_changed) : existing.handoff?.files_changed,
-      };
-  return {
-    ...existing,
-    ...state,
-    cli: state.cli !== undefined ? sanitizeOneLine(state.cli, existing.cli || "codex") : (existing.cli || "codex"),
-    status: state.status !== undefined ? sanitizeOneLine(state.status, existing.status || "pending") : (existing.status || "pending"),
-    snapshot: state.snapshot !== undefined ? sanitizeBlock(state.snapshot) : existing.snapshot,
-    summary: state.summary !== undefined ? sanitizeBlock(state.summary) : existing.summary,
-    detail: state.detail !== undefined ? sanitizeBlock(state.detail) : existing.detail,
-    findings: state.findings !== undefined ? sanitizeFiles(state.findings) : existing.findings,
-    files_changed: state.files_changed !== undefined ? sanitizeFiles(state.files_changed) : existing.files_changed,
-    confidence: state.confidence !== undefined ? sanitizeOneLine(state.confidence) : existing.confidence,
-    tokens: state.tokens !== undefined ? normalizeTokens(state.tokens) : existing.tokens,
-    progress: state.progress !== undefined ? clamp(Number(state.progress) || 0, 0, 1) : existing.progress,
-    handoff,
-  };
+  return coreNormalizeWorkerState(existing, state);
 }
 
 function frame(lines, width, border = MOCHA.border) {
   const body = lines.length ? lines : [dim("내용 없음")];
-  const rendered = box(body.map((line) => padRight(truncate(line, width - 4), width - 4)), width, border);
+  const rendered = box(
+    body.map((line) => padRight(truncate(line, width - 4), width - 4)),
+    width,
+    border,
+  );
   return [rendered.top, ...rendered.body, rendered.bot];
 }
 
@@ -128,9 +70,10 @@ function buildHeader(width, names, workers, pipeline, startedAt) {
     else if (status === "running" || status === "in_progress") counts.running++;
   }
   const elapsed = Math.max(0, Math.round((Date.now() - startedAt) / 1000));
-  const line1 = color(` triflux ${VERSION} `, FG.black, BG.header)
-    + ` ${bold(`phase ${pipeline.phase || "exec"}`)}`
-    + ` ${dim(`+${elapsed}s`)} ${names.length} workers`;
+  const line1 =
+    color(` triflux ${VERSION} `, FG.white, BG.header) +
+    ` ${bold(`phase ${pipeline.phase || "exec"}`)}` +
+    ` ${dim(`+${elapsed}s`)} ${names.length} workers`;
   const line2 = `${color(`ok ${counts.ok}`, MOCHA.ok)}  ${color(`partial ${counts.partial}`, MOCHA.partial)}  ${color(`failed ${counts.failed}`, MOCHA.fail)}  ${color(`running ${counts.running}`, MOCHA.executing)}`;
   return [padRight(line1, width), padRight(line2, width)];
 }
@@ -139,11 +82,17 @@ function buildWorkerRail(names, workers, selectedWorker, width) {
   const lines = names.length
     ? names.map((name, index) => {
         const worker = workers.get(name);
+        const displayName = worker?.displayName || name;
         const status = runtimeStatus(worker);
-        const pct = Math.round(((worker?.progress ?? (status === "completed" ? 1 : 0)) || 0) * 100);
-        const token = worker?.tokens ? ` tok ${formatTokens(worker.tokens)}` : "";
-        const prefix = name === selectedWorker ? color("▶", MOCHA.blue) : dim("·");
-        return `${prefix} ${index + 1}.${name} ${stripAnsi(statusBadge(status))} ${pct}%${token}`;
+        const pct = Math.round(
+          ((worker?.progress ?? (status === "completed" ? 1 : 0)) || 0) * 100,
+        );
+        const token = worker?.tokens
+          ? ` tok ${formatTokens(worker.tokens)}`
+          : "";
+        const prefix =
+          name === selectedWorker ? color("▶", MOCHA.blue) : dim("·");
+        return `${prefix} ${index + 1}.${displayName} ${stripAnsi(statusBadge(status))} ${pct}%${token}`;
       })
     : [dim("workers 없음")];
   return frame(lines, width);
@@ -167,7 +116,7 @@ function buildDetail(workerName, worker, width, tab, helpVisible) {
   }
   if (!workerName || !worker) return frame([dim("선택된 워커 없음")], width);
   const detailLines = [
-    bold(workerName),
+    bold(worker.displayName || workerName),
     `status ${runtimeStatus(worker)}`,
     `progress ${Math.round((worker.progress || 0) * 100)}% ${progressBar(Math.round((worker.progress || 0) * 100), 12)}`,
     `tokens ${formatTokens(worker.tokens)}`,
@@ -175,12 +124,27 @@ function buildDetail(workerName, worker, width, tab, helpVisible) {
     `verdict ${worker.handoff?.verdict || worker.summary || worker.snapshot || "-"}`,
   ];
   if (tab === "files") {
-    const files = [...sanitizeFiles(worker.handoff?.files_changed), ...sanitizeFiles(worker.files_changed)];
-    detailLines.push(...(files.length ? files.map((file) => `files ${file}`) : ["files 없음"]));
+    const files = [
+      ...sanitizeFiles(worker.handoff?.files_changed),
+      ...sanitizeFiles(worker.files_changed),
+    ];
+    detailLines.push(
+      ...(files.length ? files.map((file) => `files ${file}`) : ["files 없음"]),
+    );
   } else if (tab === "detail") {
-    detailLines.push(...wrap(worker.detail || worker.summary || worker.snapshot || "", width - 4));
+    detailLines.push(
+      ...wrap(
+        worker.detail || worker.summary || worker.snapshot || "",
+        width - 4,
+      ),
+    );
   } else {
-    detailLines.push(...wrap(worker.summary || worker.snapshot || worker.detail || "", width - 4));
+    detailLines.push(
+      ...wrap(
+        worker.summary || worker.snapshot || worker.detail || "",
+        width - 4,
+      ),
+    );
   }
   return frame(detailLines, width, MOCHA.thinking);
 }
@@ -209,14 +173,21 @@ export function createLiteDashboard(opts = {}) {
   let detailExpanded = true;
   let focusTab = "log";
   let helpVisible = false;
+  let prevFrame = [];
+  let prevWidth = 0;
   let inputAttached = false;
   let rawModeEnabled = false;
 
-  const write = (text) => { if (!closed) stream.write(text); };
+  const write = (text) => {
+    if (!closed) stream.write(text);
+  };
   const workerNames = () => [...workers.keys()].sort();
-  const viewportColumns = () => Math.max(48, columns || stream?.columns || process.stdout?.columns || FALLBACK_COLUMNS);
-  const viewportRows = () => Math.max(10, rows || stream?.rows || process.stdout?.rows || FALLBACK_ROWS);
-  const ensureSelection = (names) => { if (names.length && (!selectedWorker || !workers.has(selectedWorker))) selectedWorker = names[0]; };
+  const viewportColumns = () => resolveViewportColumns({ columns, stream });
+  const viewportRows = () => resolveViewportRows({ rows, stream });
+  const ensureSelection = (names) => {
+    if (names.length && (!selectedWorker || !workers.has(selectedWorker)))
+      selectedWorker = names[0];
+  };
 
   function selectRelative(offset) {
     const names = workerNames();
@@ -227,9 +198,18 @@ export function createLiteDashboard(opts = {}) {
   }
 
   function triggerOpenSelected() {
-    if (typeof onOpenSelectedWorker !== "function" || !selectedWorker || !workers.has(selectedWorker)) return;
+    if (
+      typeof onOpenSelectedWorker !== "function" ||
+      !selectedWorker ||
+      !workers.has(selectedWorker)
+    )
+      return;
     try {
-      const result = onOpenSelectedWorker(selectedWorker, workers.get(selectedWorker), new Map(workers));
+      const result = onOpenSelectedWorker(
+        selectedWorker,
+        workers.get(selectedWorker),
+        new Map(workers),
+      );
       if (result && typeof result.catch === "function") result.catch(() => {});
     } catch {}
   }
@@ -237,7 +217,11 @@ export function createLiteDashboard(opts = {}) {
   function triggerOpenAll() {
     if (typeof onOpenAllWorkers !== "function") return;
     try {
-      const result = onOpenAllWorkers(selectedWorker, workers.get(selectedWorker), new Map(workers));
+      const result = onOpenAllWorkers(
+        selectedWorker,
+        workers.get(selectedWorker),
+        new Map(workers),
+      );
       if (result && typeof result.catch === "function") result.catch(() => {});
     } catch {}
   }
@@ -263,10 +247,26 @@ export function createLiteDashboard(opts = {}) {
       return;
     }
     if (key === "\r" || key === "\n") {
-      triggerOpenSelected();
+      if (
+        typeof onOpenSelectedWorker === "function" &&
+        selectedWorker &&
+        workers.has(selectedWorker)
+      ) {
+        triggerOpenSelected();
+      } else {
+        // 콜백 없거나 선택 워커 없으면 탭 순환
+        const tabs = ["log", "detail", "files"];
+        focusTab = tabs[(tabs.indexOf(focusTab) + 1) % tabs.length];
+      }
+      render();
       return;
     }
-    if (key === "\x1b[13;2u" || key === "\x1b[27;13;2~" || key === "\x1b\r" || key === "\x1b\n") {
+    if (
+      key === "\x1b[13;2u" ||
+      key === "\x1b[27;13;2~" ||
+      key === "\x1b\r" ||
+      key === "\x1b\n"
+    ) {
       triggerOpenAll();
       return;
     }
@@ -297,7 +297,7 @@ export function createLiteDashboard(opts = {}) {
 
   function attachInput() {
     if (inputAttached) return;
-    if (!isTTY || !input?.isTTY || typeof input?.on !== "function") return;
+    if (!input?.isTTY || typeof input?.on !== "function") return;
     inputAttached = true;
     if (typeof input.setRawMode === "function") {
       input.setRawMode(true);
@@ -313,20 +313,53 @@ export function createLiteDashboard(opts = {}) {
     const width = viewportColumns();
     const height = viewportRows();
     const header = buildHeader(width, names, workers, pipeline, startedAt);
-    const railOnly = !detailExpanded || names.length <= 1 || width < 100 || layout === "single";
+    const railOnly =
+      !detailExpanded ||
+      names.length <= 1 ||
+      width < 100 ||
+      layout === "single";
     if (railOnly) {
-      const sections = [header, ...buildWorkerRail(names, workers, selectedWorker, width)];
-      if (detailExpanded) sections.push(...buildDetail(selectedWorker, workers.get(selectedWorker), width, focusTab, helpVisible));
+      const sections = [
+        header,
+        ...buildWorkerRail(names, workers, selectedWorker, width),
+      ];
+      if (detailExpanded)
+        sections.push(
+          ...buildDetail(
+            selectedWorker,
+            workers.get(selectedWorker),
+            width,
+            focusTab,
+            helpVisible,
+          ),
+        );
       return fitHeight(sections, width, height);
     }
     const railWidth = Math.max(28, Math.floor(width * 0.32));
     const detailWidth = width - railWidth - 1;
     const bodyHeight = Math.max(6, height - header.length);
-    const rail = fitHeight(buildWorkerRail(names, workers, selectedWorker, railWidth), railWidth, bodyHeight);
-    const detail = fitHeight(buildDetail(selectedWorker, workers.get(selectedWorker), detailWidth, focusTab, helpVisible), detailWidth, bodyHeight);
+    const rail = fitHeight(
+      buildWorkerRail(names, workers, selectedWorker, railWidth),
+      railWidth,
+      bodyHeight,
+    );
+    const detail = fitHeight(
+      buildDetail(
+        selectedWorker,
+        workers.get(selectedWorker),
+        detailWidth,
+        focusTab,
+        helpVisible,
+      ),
+      detailWidth,
+      bodyHeight,
+    );
     return [
       ...header,
-      ...Array.from({ length: bodyHeight }, (_, index) => `${rail[index]}${dim("│")}${detail[index]}`),
+      ...Array.from(
+        { length: bodyHeight },
+        (_, index) => `${rail[index]}${dim("│")}${detail[index]}`,
+      ),
     ];
   }
 
@@ -337,18 +370,43 @@ export function createLiteDashboard(opts = {}) {
     const rowsOut = buildRows();
     if (isTTY) {
       const width = viewportColumns();
-      const padded = rowsOut.map((line) => padRight(String(line ?? ""), width) + clearToEnd);
-      write(cursorHome + padded.join("\n") + eraseBelow);
+      const padded = rowsOut.map((line) => padRight(String(line ?? ""), width));
+      // Full redraw on first frame or terminal resize to avoid artifacts
+      if (prevFrame.length === 0 || width !== prevWidth) {
+        prevWidth = width;
+        write(
+          cursorHome +
+            padded.map((l) => l + clearToEnd).join("\n") +
+            eraseBelow,
+        );
+        prevFrame = padded;
+        return;
+      }
+      // Diff-based rendering: only rewrite lines that actually changed
+      let buf = "";
+      for (let i = 0; i < padded.length; i++) {
+        if (padded[i] !== prevFrame[i]) {
+          buf += moveTo(i + 1, 1) + padded[i] + clearToEnd;
+        }
+      }
+      if (prevFrame.length > padded.length) {
+        buf += moveTo(padded.length + 1, 1) + eraseBelow;
+      }
+      if (buf) write(buf);
+      prevFrame = padded;
     } else write(`${rowsOut.join("\n")}\n`);
   }
 
   function close() {
     if (closed) return;
     if (timer) clearInterval(timer);
-    if (inputAttached && typeof input?.off === "function") input.off("data", handleInput);
-    if (rawModeEnabled && typeof input?.setRawMode === "function") input.setRawMode(false);
+    if (inputAttached && typeof input?.off === "function")
+      input.off("data", handleInput);
+    if (rawModeEnabled && typeof input?.setRawMode === "function")
+      input.setRawMode(false);
     if (inputAttached && typeof input?.pause === "function") input.pause();
     if (isTTY) write(cursorShow + altScreenOff);
+    prevFrame = [];
     closed = true;
   }
 
@@ -359,22 +417,53 @@ export function createLiteDashboard(opts = {}) {
   }
 
   return {
-    updateWorker(name, state) { workers.set(name, normalizeWorkerState(workers.get(name), state)); ensureSelection(workerNames()); },
-    updatePipeline(state) { pipeline = { ...pipeline, ...state }; },
-    setStartTime(ms) { startedAt = ms; },
-    selectWorker(name) { if (workers.has(name)) selectedWorker = name; },
-    toggleDetail(force) { detailExpanded = typeof force === "boolean" ? force : !detailExpanded; },
+    updateWorker(name, state) {
+      workers.set(name, normalizeWorkerState(workers.get(name), state));
+      ensureSelection(workerNames());
+    },
+    updatePipeline(state) {
+      pipeline = { ...pipeline, ...state };
+    },
+    setStartTime(ms) {
+      startedAt = ms;
+    },
+    selectWorker(name) {
+      if (workers.has(name)) selectedWorker = name;
+    },
+    toggleDetail(force) {
+      detailExpanded = typeof force === "boolean" ? force : !detailExpanded;
+    },
     render,
-    getWorkers() { return new Map(workers); },
-    getFrameCount() { return frameCount; },
-    getPipelineState() { return { ...pipeline }; },
-    getSelectedWorker() { return selectedWorker; },
-    isDetailExpanded() { return detailExpanded; },
-    getFocusTab() { return focusTab; },
-    setFocusTab(tab) { if (VALID_TABS.has(tab)) focusTab = tab; },
-    getLayout() { return layout; },
-    toggleHelp(force) { helpVisible = typeof force === "boolean" ? force : !helpVisible; },
-    isHelpVisible() { return helpVisible; },
+    getWorkers() {
+      return new Map(workers);
+    },
+    getFrameCount() {
+      return frameCount;
+    },
+    getPipelineState() {
+      return { ...pipeline };
+    },
+    getSelectedWorker() {
+      return selectedWorker;
+    },
+    isDetailExpanded() {
+      return detailExpanded;
+    },
+    getFocusTab() {
+      return focusTab;
+    },
+    setFocusTab(tab) {
+      if (VALID_TABS.has(tab)) focusTab = tab;
+    },
+    getLayout() {
+      return layout;
+    },
+    toggleHelp(force) {
+      helpVisible = typeof force === "boolean" ? force : !helpVisible;
+    },
+    isHelpVisible() {
+      return helpVisible;
+    },
     close,
   };
 }

package/hub/team/tui-remote-adapter.mjs

@@ -4,17 +4,13 @@
 // tui.mjs updateWorker() 호환 형식으로 변환한다.
 // 완료/실패 시 notify.mjs 자동 호출.
 
-import { readFileSync } from "node:fs";
-import { join } from "node:path";
-import { fileURLToPath } from "node:url";
 import { EventEmitter } from "node:events";
 
+import { readHosts } from "@triflux/core/hub/lib/hosts-compat.mjs";
 import { STATES } from "./conductor.mjs";
 
 // ── 상수 ─────────────────────────────────────────────────────────────────────
 
-const HOSTS_JSON_REL = "../../references/hosts.json";
-
 const CONDUCTOR_STATE_TO_TUI_STATUS = Object.freeze({
   [STATES.INIT]: "pending",
   [STATES.STARTING]: "pending",
@@ -31,21 +27,6 @@ const SESSION_PREFIX = "tfx-spawn-";
 
 // ── 유틸 ─────────────────────────────────────────────────────────────────────
 
-function loadHostsJson(hostsJsonPath) {
-  try {
-    const raw = readFileSync(hostsJsonPath, "utf8");
-    return JSON.parse(raw);
-  } catch {
-    return { hosts: {} };
-  }
-}
-
-function resolveHostsJsonPath(overridePath) {
-  if (overridePath) return overridePath;
-  const thisDir = fileURLToPath(new URL(".", import.meta.url));
-  return join(thisDir, HOSTS_JSON_REL);
-}
-
 function resolveSshUser(hostsData, host) {
   if (!host || !hostsData?.hosts) return null;
   return hostsData.hosts[host]?.ssh_user || null;
@@ -90,9 +71,8 @@ function mapConductorStateToStatus(conductorState) {
 function buildWorkerData(entry, watcherSession, hostsData) {
   const host = entry.host || resolveHostFromSessionName(entry.id);
   const snapshot = watcherSession?.lastOutput || "";
-  const probeLevel = entry.health?.level
-    || watcherSession?.lastProbeLevel
-    || null;
+  const probeLevel =
+    entry.health?.level || watcherSession?.lastProbeLevel || null;
 
   return Object.freeze({
     cli: entry.agent || "claude",
@@ -115,15 +95,18 @@ function buildWorkerData(entry, watcherSession, hostsData) {
  * remote-watcher 전용 엔트리 → TUI 워커 데이터 (conductor 미등록 세션).
  */
 function buildWatcherOnlyWorkerData(watcherRecord, hostsData) {
-  const host = watcherRecord.host
-    || resolveHostFromSessionName(watcherRecord.sessionName);
+  const host =
+    watcherRecord.host || resolveHostFromSessionName(watcherRecord.sessionName);
 
   return Object.freeze({
     cli: "claude",
     role: resolveRole(null, watcherRecord.sessionName),
-    status: watcherRecord.state === "completed" ? "completed"
-      : watcherRecord.state === "failed" ? "failed"
-        : "running",
+    status:
+      watcherRecord.state === "completed"
+        ? "completed"
+        : watcherRecord.state === "failed"
+          ? "failed"
+          : "running",
     host: host || "unknown",
     remote: true,
     sshUser: resolveSshUser(hostsData, host),
@@ -142,7 +125,7 @@ function buildWatcherOnlyWorkerData(watcherRecord, hostsData) {
  * @param {object} opts.conductor — createConductor() 인스턴스
  * @param {object} [opts.watcher] — createRemoteWatcher() 인스턴스 (nullable)
  * @param {object} [opts.notifier] — createNotifier() 인스턴스 (nullable)
- * @param {string} [opts.hostsJsonPath] — hosts.json 경로 override
+ * @param {string} [opts.repoRoot] — hosts fallback 탐색용 repo root override
  * @param {number} [opts.pollMs=10000] — conductor snapshot 폴링 간격
  * @param {object} [opts.deps] — 테스트용 의존성 주입
  * @returns {{ start, stop, getWorkers, on, off }}
@@ -158,14 +141,13 @@ export function createRemoteAdapter(opts = {}) {
 
   if (!conductor) throw new Error("conductor is required");
 
-  const hostsJsonPath = resolveHostsJsonPath(opts.hostsJsonPath);
-  const loadHosts = deps.loadHostsJson || loadHostsJson;
+  const loadHosts = deps.readHosts || readHosts;
   const setIntervalFn = deps.setInterval || setInterval;
   const clearIntervalFn = deps.clearInterval || clearInterval;
   const _nowFn = deps.now || Date.now;
 
   const emitter = new EventEmitter();
-  let hostsData = loadHosts(hostsJsonPath);
+  let hostsData = loadHosts(opts.repoRoot);
   let workers = new Map();
   let pollHandle = null;
   let running = false;
@@ -321,7 +303,9 @@ export function createRemoteAdapter(opts = {}) {
     // watcher-only 세션 (conductor 미등록)
     if (watcher) {
       const watcherStatus = watcher.getStatus();
-      for (const [sessionName, record] of Object.entries(watcherStatus.sessions || {})) {
+      for (const [sessionName, record] of Object.entries(
+        watcherStatus.sessions || {},
+      )) {
         if (conductorSessionIds.has(sessionName)) continue;
         const paneName = buildPaneName(sessionName);
         const workerData = buildWatcherOnlyWorkerData(record, hostsData);
@@ -339,7 +323,7 @@ export function createRemoteAdapter(opts = {}) {
     running = true;
 
     // hosts.json 리로드
-    hostsData = loadHosts(hostsJsonPath);
+    hostsData = loadHosts(opts.repoRoot);
 
     // conductor stateChange 구독
     conductor.on("stateChange", handleStateChange);