@triflux/remote 10.0.0-alpha.1 → 10.0.0

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

@@ -0,0 +1,393 @@
+// hub/team/tui-remote-adapter.mjs — 원격 세션을 TUI 워커 형식으로 변환하는 어댑터
+//
+// conductor.mjs의 stateChange 이벤트(primary) + remote-watcher.mjs(supplemental)를
+// 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 { 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",
+  [STATES.HEALTHY]: "running",
+  [STATES.STALLED]: "running",
+  [STATES.INPUT_WAIT]: "running",
+  [STATES.FAILED]: "running",
+  [STATES.RESTARTING]: "running",
+  [STATES.COMPLETED]: "completed",
+  [STATES.DEAD]: "failed",
+});
+
+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;
+}
+
+/**
+ * tfx-spawn-{host}-{id} 형식에서 host를 추출한다.
+ * @param {string} sessionName
+ * @returns {string|null}
+ */
+function resolveHostFromSessionName(sessionName) {
+  if (!sessionName || !sessionName.startsWith(SESSION_PREFIX)) return null;
+  const rest = sessionName.slice(SESSION_PREFIX.length);
+  const dashIdx = rest.indexOf("-");
+  if (dashIdx === -1) return rest || null;
+  return rest.slice(0, dashIdx) || null;
+}
+
+/**
+ * sessionName에서 role을 파생한다.
+ * conductor config.id가 있으면 우선 사용, 없으면 sessionName 자체.
+ */
+function resolveRole(configId, sessionName) {
+  return configId || sessionName || "unknown";
+}
+
+function buildPaneName(sessionName) {
+  return `remote:${sessionName}`;
+}
+
+function mapConductorStateToStatus(conductorState) {
+  return CONDUCTOR_STATE_TO_TUI_STATUS[conductorState] || "pending";
+}
+
+/**
+ * conductor snapshot 엔트리 → TUI 워커 데이터.
+ * @param {object} entry — conductor getSnapshot() 엔트리
+ * @param {object} watcherSession — remote-watcher의 세션 레코드 (nullable)
+ * @param {object} hostsData — hosts.json 데이터
+ * @returns {object}
+ */
+function buildWorkerData(entry, watcherSession, hostsData) {
+  const host = entry.host || resolveHostFromSessionName(entry.id);
+  const snapshot = watcherSession?.lastOutput || "";
+  const probeLevel = entry.health?.level
+    || watcherSession?.lastProbeLevel
+    || null;
+
+  return Object.freeze({
+    cli: entry.agent || "claude",
+    role: resolveRole(entry.id, entry.id),
+    status: mapConductorStateToStatus(entry.state),
+    host: host || "unknown",
+    remote: true,
+    sshUser: resolveSshUser(hostsData, host),
+    sessionName: entry.id,
+    snapshot,
+    conductor: Object.freeze({
+      state: entry.state,
+      restarts: entry.restarts || 0,
+      probeLevel,
+    }),
+  });
+}
+
+/**
+ * remote-watcher 전용 엔트리 → TUI 워커 데이터 (conductor 미등록 세션).
+ */
+function buildWatcherOnlyWorkerData(watcherRecord, hostsData) {
+  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",
+    host: host || "unknown",
+    remote: true,
+    sshUser: resolveSshUser(hostsData, host),
+    sessionName: watcherRecord.sessionName,
+    snapshot: watcherRecord.lastOutput || "",
+    conductor: null,
+  });
+}
+
+// ── 팩토리 ───────────────────────────────────────────────────────────────────
+
+/**
+ * 원격 세션 어댑터 팩토리.
+ *
+ * @param {object} opts
+ * @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 {number} [opts.pollMs=10000] — conductor snapshot 폴링 간격
+ * @param {object} [opts.deps] — 테스트용 의존성 주입
+ * @returns {{ start, stop, getWorkers, on, off }}
+ */
+export function createRemoteAdapter(opts = {}) {
+  const {
+    conductor,
+    watcher = null,
+    notifier = null,
+    pollMs = 10_000,
+    deps = {},
+  } = opts;
+
+  if (!conductor) throw new Error("conductor is required");
+
+  const hostsJsonPath = resolveHostsJsonPath(opts.hostsJsonPath);
+  const loadHosts = deps.loadHostsJson || loadHostsJson;
+  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 workers = new Map();
+  let pollHandle = null;
+  let running = false;
+
+  // ── conductor stateChange 핸들러 (primary) ──
+
+  function handleStateChange({ sessionId, from, to, reason }) {
+    const snapshots = conductor.getSnapshot();
+    const entry = snapshots.find((s) => s.id === sessionId);
+    if (!entry || !entry.remote) return;
+
+    const watcherStatus = getWatcherSession(sessionId);
+    const workerData = buildWorkerData(entry, watcherStatus, hostsData);
+    const paneName = buildPaneName(sessionId);
+
+    workers = new Map(workers);
+    workers.set(paneName, workerData);
+
+    emitter.emit("workerUpdate", { ...workerData, paneName });
+
+    if (to === STATES.COMPLETED) {
+      emitter.emit("workerCompleted", {
+        name: paneName,
+        host: workerData.host,
+        exitCode: 0,
+      });
+      notifyIfAvailable({
+        type: "completed",
+        sessionId,
+        host: workerData.host,
+        summary: `completed (${reason})`,
+      });
+    } else if (to === STATES.DEAD) {
+      emitter.emit("workerFailed", {
+        name: paneName,
+        host: workerData.host,
+        reason,
+      });
+      notifyIfAvailable({
+        type: "failed",
+        sessionId,
+        host: workerData.host,
+        summary: `dead: ${reason}`,
+      });
+    } else if (to === STATES.INPUT_WAIT) {
+      emitter.emit("workerInputWait", {
+        name: paneName,
+        host: workerData.host,
+        pattern: reason,
+      });
+      notifyIfAvailable({
+        type: "inputWait",
+        sessionId,
+        host: workerData.host,
+        summary: `input_wait: ${reason}`,
+      });
+    }
+  }
+
+  // ── remote-watcher 이벤트 핸들러 (supplemental) ──
+
+  function handleWatcherCompleted({ sessionName, exitCode, host }) {
+    if (isConductorTracked(sessionName)) return;
+
+    const paneName = buildPaneName(sessionName);
+    notifyIfAvailable({
+      type: "completed",
+      sessionId: sessionName,
+      host: host || resolveHostFromSessionName(sessionName),
+      summary: `exit ${exitCode ?? 0}`,
+    });
+    emitter.emit("workerCompleted", {
+      name: paneName,
+      host: host || resolveHostFromSessionName(sessionName),
+      exitCode: exitCode ?? 0,
+    });
+  }
+
+  function handleWatcherFailed({ sessionName, reason, host }) {
+    if (isConductorTracked(sessionName)) return;
+
+    const paneName = buildPaneName(sessionName);
+    notifyIfAvailable({
+      type: "failed",
+      sessionId: sessionName,
+      host: host || resolveHostFromSessionName(sessionName),
+      summary: reason || "session failed",
+    });
+    emitter.emit("workerFailed", {
+      name: paneName,
+      host: host || resolveHostFromSessionName(sessionName),
+      reason: reason || "session failed",
+    });
+  }
+
+  function handleWatcherInputWait({ sessionName, inputWaitPattern, host }) {
+    if (isConductorTracked(sessionName)) return;
+
+    const paneName = buildPaneName(sessionName);
+    notifyIfAvailable({
+      type: "inputWait",
+      sessionId: sessionName,
+      host: host || resolveHostFromSessionName(sessionName),
+      summary: `input_wait: ${inputWaitPattern || "unknown"}`,
+    });
+    emitter.emit("workerInputWait", {
+      name: paneName,
+      host: host || resolveHostFromSessionName(sessionName),
+      pattern: inputWaitPattern || "unknown",
+    });
+  }
+
+  // ── 내부 헬퍼 ──
+
+  function isConductorTracked(sessionName) {
+    const snapshots = conductor.getSnapshot();
+    return snapshots.some((s) => s.id === sessionName && s.remote);
+  }
+
+  function getWatcherSession(sessionName) {
+    if (!watcher) return null;
+    const status = watcher.getStatus();
+    return status.sessions?.[sessionName] || null;
+  }
+
+  function notifyIfAvailable(event) {
+    if (!notifier) return;
+    try {
+      notifier.notify(event);
+    } catch {
+      // notify 실패는 adapter를 중단시키지 않는다
+    }
+  }
+
+  /**
+   * conductor snapshot을 폴링하여 모든 원격 워커를 갱신.
+   */
+  function pollConductorSnapshot() {
+    const snapshots = conductor.getSnapshot();
+    const nextWorkers = new Map(workers);
+    const conductorSessionIds = new Set();
+
+    for (const entry of snapshots) {
+      if (!entry.remote) continue;
+      conductorSessionIds.add(entry.id);
+
+      const watcherSession = getWatcherSession(entry.id);
+      const workerData = buildWorkerData(entry, watcherSession, hostsData);
+      const paneName = buildPaneName(entry.id);
+      nextWorkers.set(paneName, workerData);
+    }
+
+    // watcher-only 세션 (conductor 미등록)
+    if (watcher) {
+      const watcherStatus = watcher.getStatus();
+      for (const [sessionName, record] of Object.entries(watcherStatus.sessions || {})) {
+        if (conductorSessionIds.has(sessionName)) continue;
+        const paneName = buildPaneName(sessionName);
+        const workerData = buildWatcherOnlyWorkerData(record, hostsData);
+        nextWorkers.set(paneName, workerData);
+      }
+    }
+
+    workers = nextWorkers;
+  }
+
+  // ── 공개 API ───────────────────────────────────────────────────────────────
+
+  function start() {
+    if (running) return;
+    running = true;
+
+    // hosts.json 리로드
+    hostsData = loadHosts(hostsJsonPath);
+
+    // conductor stateChange 구독
+    conductor.on("stateChange", handleStateChange);
+
+    // watcher 이벤트 구독
+    if (watcher) {
+      watcher.on("sessionCompleted", handleWatcherCompleted);
+      watcher.on("sessionFailed", handleWatcherFailed);
+      watcher.on("sessionInputWait", handleWatcherInputWait);
+    }
+
+    // 초기 snapshot 로드
+    pollConductorSnapshot();
+
+    // 주기적 폴링 (snapshot 갱신용 — stateChange가 primary)
+    pollHandle = setIntervalFn(() => {
+      pollConductorSnapshot();
+    }, pollMs);
+    pollHandle?.unref?.();
+  }
+
+  function stop() {
+    if (!running) return;
+    running = false;
+
+    conductor.off("stateChange", handleStateChange);
+
+    if (watcher) {
+      watcher.off("sessionCompleted", handleWatcherCompleted);
+      watcher.off("sessionFailed", handleWatcherFailed);
+      watcher.off("sessionInputWait", handleWatcherInputWait);
+    }
+
+    if (pollHandle) {
+      clearIntervalFn(pollHandle);
+      pollHandle = null;
+    }
+  }
+
+  function getWorkers() {
+    return new Map(workers);
+  }
+
+  return Object.freeze({
+    start,
+    stop,
+    getWorkers,
+    on: emitter.on.bind(emitter),
+    off: emitter.off.bind(emitter),
+  });
+}

package/hub/team/tui.mjs

@@ -30,6 +30,8 @@ import {
   clearToEnd,
 } from "./ansi.mjs";
 
+import { execFile as _execFile } from "node:child_process";
+
 // package.json에서 동적 로드 (실패 시 fallback)
 let VERSION = "7.x";
 try {
@@ -481,9 +483,13 @@ function buildWorkerRail(name, st, opts = {}) {
       ? dim("~")
       : " ";
   const hb = heartbeat(status, status === "running" ? currentShimmer(time) : 0, st._statusChangedAt, time);
+  // host 배지 (원격 워커용)
+  const hostBadge = st.host && st.host !== "local"
+    ? color(`[${st.host}]`, MOCHA.mauve) + " "
+    : "";
   const displayRole = dedupeRole(role, name, cli);
   const title = truncate(
-    `${selMark} ${hb} ${color(name, FG.triflux)} ${color("•", MOCHA.overlay)} ${color(cli, cliColor(cli))}${displayRole ? ` ${color(`(${displayRole})`, MOCHA.overlay)}` : ""}`,
+    `${selMark} ${hb} ${hostBadge}${color(name, FG.triflux)} ${color("•", MOCHA.overlay)} ${color(cli, cliColor(cli))}${displayRole ? ` ${color(`(${displayRole})`, MOCHA.overlay)}` : ""}`,
     innerWidth,
   );
 
@@ -509,7 +515,7 @@ function buildWorkerRail(name, st, opts = {}) {
     const progress = Number.isFinite(st.progress) ? clamp(st.progress, 0, 1) : (status === "running" ? 0.3 : 1);
     const percent = Math.round(progress * 100);
     const compactLine1 = truncate(
-      `${selMark} ${hb} ${color(name, FG.triflux)} ${dim("•")} ${color(cli, cliColor(cli))} ${statusBadge(status)} ${String(percent).padStart(3)}%`,
+      `${selMark} ${hb} ${hostBadge}${color(name, FG.triflux)} ${dim("•")} ${color(cli, cliColor(cli))} ${statusBadge(status)} ${String(percent).padStart(3)}%`,
       innerWidth,
     );
     const verdict = sanitizeOneLine(st.handoff?.verdict || st.summary || st.snapshot, status);
@@ -901,6 +907,17 @@ export function createLogDashboard(opts = {}) {
       return;
     }
 
+    // Enter: 선택된 워커 세션에 attach (k9s 패턴)
+    if (key === "\r" || key === "\n") {
+      if (!selectedWorker) return;
+      const w = workers.get(selectedWorker);
+      if (!w) return;
+      const sessionTarget = w.sessionName || w.paneName;
+      if (!sessionTarget) return;
+      attachToSession(w);
+      return;
+    }
+
     // Tab: rail ↔ detail 포커스 전환
     if (key === "\t") {
       focus = focus === "rail" ? "detail" : "rail";
@@ -959,6 +976,51 @@ export function createLogDashboard(opts = {}) {
     }
   }
 
+  // ── Enter→attach (k9s 패턴) ───────────────────────────────────────────
+  function attachToSession(worker) {
+    const execFileFn = opts.deps?.execFile || _execFile;
+    // 1. rawMode 해제 + input 일시정지 (키 이벤트 차단)
+    if (rawModeEnabled && typeof input?.setRawMode === "function") input.setRawMode(false);
+    if (typeof input?.pause === "function") input.pause();
+    // 2. altScreen 퇴장
+    exitAltScreen();
+
+    const sessionName = worker.sessionName || worker.paneName;
+    if (worker.remote && worker.sshUser) {
+      // 원격: SSH + psmux attach in new WT tab
+      const host = worker.host || "unknown";
+      const ip = worker._sshIp || host;
+      const title = `${host}:${worker.role || sessionName}`;
+      execFileFn("wt.exe", ["-w", "0", "nt", "--title", title, "--",
+        "ssh", `${worker.sshUser}@${ip}`, "-t", `psmux attach -t ${sessionName}`],
+        { detached: true, stdio: "ignore", windowsHide: false }, () => {});
+    } else {
+      // 로컬: psmux attach in new WT tab
+      const title = worker.role || sessionName;
+      execFileFn("wt.exe", ["-w", "0", "nt", "--title", title, "--",
+        "psmux", "attach", "-t", sessionName],
+        { detached: true, stdio: "ignore", windowsHide: false }, () => {});
+    }
+
+    // 3. 200ms 후 altScreen 복귀 + rawMode 재활성화
+    setTimeout(() => {
+      enterAltScreen();
+      if (typeof input?.setRawMode === "function") { input.setRawMode(true); rawModeEnabled = true; }
+      if (typeof input?.resume === "function") input.resume();
+      render();
+    }, 200);
+  }
+
+  // ── flash 메시지 (완료/실패 알림용) ────────────────────────────────────
+  let flashMessage = "";
+  let flashTimer = null;
+  function showFlash(msg, durationMs = 5000) {
+    flashMessage = msg;
+    if (flashTimer) clearTimeout(flashTimer);
+    flashTimer = setTimeout(() => { flashMessage = ""; render(); }, durationMs);
+    render();
+  }
+
   function attachInput() {
     if (inputAttached) return;
     if (!isTTY || (!forceTTY && !input?.isTTY) || typeof input?.on !== "function") return;
@@ -1000,6 +1062,10 @@ export function createLogDashboard(opts = {}) {
 
     // Tier1: 상단 고정 2행
     const tier1 = buildTier1(names, workers, pipeline, elapsed, totalCols, VERSION, renderTime);
+    // flash 메시지 (완료/실패 알림)
+    if (flashMessage) {
+      tier1.push(truncate(` ${color("▸", MOCHA.green)} ${flashMessage}`, totalCols));
+    }
 
     // 레이아웃 결정
     let effectiveLayout = layoutHint;
@@ -1235,11 +1301,149 @@ export function createLogDashboard(opts = {}) {
       return helpOverlay;
     },
 
+    showFlash,
+
+    attachWorker(name) {
+      const w = workers.get(name);
+      if (w) attachToSession(w);
+    },
+
     close() {
       doClose();
     },
   };
 }
 
+// ── Conductor Tier: 세션 테이블 렌더러 ─────────────────────────────────
+//
+// renderConductorTier(snapshot, cols)
+//   snapshot: conductor.getSnapshot() 반환 배열
+//   cols:     터미널 폭 (기본 100)
+//
+// 레이아웃:
+//   ┌─ CONDUCTOR ──────────────────────────────────────────┐
+//   │ ID       Agent   Host   Health       Last Out  Restarts Why │
+//   │ abc123   codex   local  ■ OK         2s ago    0           │
+//   └──────────────────────────────────────────────────────┘
+//
+// Health 색상: healthy=green, stalled=yellow, input_wait=cyan,
+//              failed=red, dead/init/starting=dim
+
+const CONDUCTOR_STATE_LABEL = {
+  init:        { label: 'INIT',       seq: MOCHA.subtext  },
+  starting:    { label: 'START',      seq: MOCHA.executing },
+  healthy:     { label: 'OK',         seq: MOCHA.ok        },
+  stalled:     { label: 'STALL',      seq: MOCHA.yellow    },
+  input_wait:  { label: 'INPUT_WAIT', seq: FG.cyan         },
+  failed:      { label: 'FAIL',       seq: MOCHA.fail      },
+  restarting:  { label: 'RESTART',    seq: MOCHA.partial   },
+  dead:        { label: 'DEAD',       seq: FG.gray         },
+  completed:   { label: 'DONE',       seq: MOCHA.ok        },
+};
+
+function conductorHealthCell(state) {
+  const entry = CONDUCTOR_STATE_LABEL[state] || { label: state.toUpperCase(), seq: FG.gray };
+  return `${entry.seq}■ ${entry.label}${RESET}`;
+}
+
+function conductorRelTime(ms) {
+  if (!ms) return '—';
+  const sec = Math.round((Date.now() - ms) / 1000);
+  if (sec < 0)   return '—';
+  if (sec < 60)  return `${sec}s ago`;
+  if (sec < 3600) return `${Math.floor(sec / 60)}m ago`;
+  return `${Math.floor(sec / 3600)}h ago`;
+}
+
+/**
+ * Conductor 세션 테이블을 문자열 배열(행 목록)로 렌더링.
+ *
+ * @param {object[]} snapshot — conductor.getSnapshot() 결과
+ * @param {number}   [cols=100] — 터미널 폭
+ * @returns {string[]} 렌더링된 행 목록 (altScreen rowBuf.set()에 바로 삽입 가능)
+ */
+export function renderConductorTier(snapshot, cols = 100) {
+  const width = Math.max(48, cols);
+  const inner = width - 4; // border: '│ ' + content + ' │'
+
+  // ── 열 너비 계산 ────────────────────────────────────────
+  // ID(8) Agent(7) Host(6) Health(dyn) LastOut(dyn) Restarts(8) Why(rest)
+  const COL_ID       = 8;
+  const COL_AGENT    = 7;
+  const COL_HOST     = 6;
+  const COL_RESTARTS = 4;
+  const COL_HEALTH   = 12; // '■ INPUT_WAIT' = 12 chars
+  const COL_LASTOUT  = 9;  // '999m ago' = 8 + space
+  // Why gets the remainder
+  const fixedCols = COL_ID + COL_AGENT + COL_HOST + COL_HEALTH + COL_LASTOUT + COL_RESTARTS + 6; // 6 spaces between cols
+  const COL_WHY = Math.max(4, inner - fixedCols);
+
+  function cell(text, width_) {
+    return clip(String(text ?? ''), width_);
+  }
+
+  function buildRow(id, agent, host, healthCell, lastOut, restarts, why) {
+    const idC       = cell(id,       COL_ID);
+    const agentC    = cell(agent,    COL_AGENT);
+    const hostC     = cell(host,     COL_HOST);
+    const restartsC = cell(String(restarts ?? 0), COL_RESTARTS);
+    const lastOutC  = clip(lastOut,  COL_LASTOUT);
+    const whyC      = cell(why,      COL_WHY);
+    // healthCell already has ANSI codes; pad its visible width manually
+    const healthVis = wcswidth(stripAnsi(healthCell));
+    const healthPad = Math.max(0, COL_HEALTH - healthVis);
+    const healthC   = healthCell + ' '.repeat(healthPad);
+
+    return `${idC} ${agentC} ${hostC} ${healthC} ${lastOutC} ${restartsC} ${whyC}`;
+  }
+
+  const boxWidth = inner;
+
+  // ── 타이틀 행 ───────────────────────────────────────────
+  const titleText = ` CONDUCTOR `;
+  const titleColored = bold(color(titleText, FG.accent));
+  // Border top with title embedded: ┌─ CONDUCTOR ──...─┐
+  const dashLen = Math.max(0, boxWidth - titleText.length);
+  const dashLeft = 1;
+  const dashRight = Math.max(0, dashLen - dashLeft);
+  const borderSeq = MOCHA.border;
+  const topBorder =
+    `${borderSeq}┌${'─'.repeat(dashLeft)}${RESET}${titleColored}${borderSeq}${'─'.repeat(dashRight)}┐${RESET}`;
+
+  // ── ヘッダー行 ───────────────────────────────────────────
+  const headerRow = buildRow('ID', 'Agent', 'Host', clip('Health', COL_HEALTH), 'Last Out', 'Rst', 'Why');
+  const headerLine = `${borderSeq}│${RESET} ${dim(headerRow)} ${borderSeq}│${RESET}`;
+
+  // ── データ行 ────────────────────────────────────────────
+  const dataLines = [];
+  if (!snapshot || snapshot.length === 0) {
+    const emptyMsg = color('(no sessions)', FG.muted);
+    const emptyPad = clip(stripAnsi(emptyMsg) === '(no sessions)' ? emptyMsg : emptyMsg, inner);
+    dataLines.push(`${borderSeq}│${RESET} ${padRight(emptyMsg, inner - 2)} ${borderSeq}│${RESET}`);
+  } else {
+    for (const s of snapshot) {
+      const id       = String(s.id   ?? '').slice(0, COL_ID);
+      const agent    = String(s.agent ?? 'unknown').slice(0, COL_AGENT);
+      const host     = 'local';
+      const state    = s.state ?? 'init';
+      const healthCell = conductorHealthCell(state);
+      const lastOut  = conductorRelTime(s.health?.lastProbeAt ?? null);
+      const restarts = s.restarts ?? 0;
+      // derive "why" from last state transition context
+      const why = s.health?.inputWaitPattern
+        ? String(s.health.inputWaitPattern).slice(0, COL_WHY)
+        : '';
+
+      const rowText = buildRow(id, agent, host, healthCell, lastOut, restarts, why);
+      dataLines.push(`${borderSeq}│${RESET} ${rowText} ${borderSeq}│${RESET}`);
+    }
+  }
+
+  // ── Bottom border ─────────────────────────────────────
+  const botBorder = `${borderSeq}└${'─'.repeat(boxWidth)}┘${RESET}`;
+
+  return [topBorder, headerLine, ...dataLines, botBorder];
+}
+
 // 하위 호환
 export { createLogDashboard as createTui };