@triflux/remote 10.50.2 → 10.52.0

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

@@ -1,377 +0,0 @@
-// hub/team/tui-remote-adapter.mjs — 원격 세션을 TUI 워커 형식으로 변환하는 어댑터
-//
-// conductor.mjs의 stateChange 이벤트(primary) + remote-watcher.mjs(supplemental)를
-// tui.mjs updateWorker() 호환 형식으로 변환한다.
-// 완료/실패 시 notify.mjs 자동 호출.
-
-import { EventEmitter } from "node:events";
-
-import { readHosts } from "@triflux/core/hub/lib/hosts-compat.mjs";
-import { STATES } from "./conductor.mjs";
-
-// ── 상수 ─────────────────────────────────────────────────────────────────────
-
-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 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?.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.repoRoot] — hosts fallback 탐색용 repo root 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 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(opts.repoRoot);
-  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?.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(opts.repoRoot);
-
-    // 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-synapse.mjs

@@ -1,223 +0,0 @@
-// hub/team/tui-synapse.mjs — Synapse 실시간 관제 (Phase 3)
-// HTTP polling 기반 이벤트 수신 + 메트릭 수집 + 스파크라인 렌더링
-
-import { color, dim, MOCHA } from "./ansi.mjs";
-import { sparkline } from "./tui-widgets.mjs";
-
-const DEFAULT_SYNAPSE_BASE_URL = "http://127.0.0.1:27888";
-const DEFAULT_POLL_INTERVAL_MS = 2000;
-const MAX_METRIC_SAMPLES = 30;
-
-// ── SynapseEventStream ────────────────────────────────────────────────────
-/**
- * Synapse 서버로부터 이벤트를 polling으로 수신
- * @param {object} [opts]
- * @param {string} [opts.baseUrl] - Synapse 서버 URL
- * @param {number} [opts.pollIntervalMs] - polling 간격
- * @param {function} [opts.fetchImpl] - fetch 구현 (테스트용)
- * @param {function} [opts.onEvent] - 이벤트 콜백
- * @param {function} [opts.onError] - 에러 콜백
- */
-export function createSynapseEventStream(opts = {}) {
-  const {
-    baseUrl = DEFAULT_SYNAPSE_BASE_URL,
-    pollIntervalMs = DEFAULT_POLL_INTERVAL_MS,
-    onEvent,
-    onError,
-  } = opts;
-
-  const fetchImpl = opts.fetchImpl || globalThis.fetch?.bind(globalThis);
-  let timer = null;
-  let lastEventId = 0;
-  let running = false;
-
-  async function poll(force = false) {
-    if (!fetchImpl || (!running && !force)) return;
-    try {
-      const url = new URL("/synapse/events", baseUrl);
-      url.searchParams.set("since", String(lastEventId));
-      const res = await fetchImpl(url.toString(), {
-        method: "GET",
-        headers: { accept: "application/json" },
-        signal: AbortSignal.timeout?.(5000),
-      });
-      if (!res.ok) return;
-      const data = await res.json();
-      if (Array.isArray(data.events)) {
-        for (const event of data.events) {
-          if (event.id > lastEventId) lastEventId = event.id;
-          onEvent?.(event);
-        }
-      }
-    } catch (err) {
-      onError?.(err);
-    }
-  }
-
-  return {
-    start() {
-      if (running) return;
-      running = true;
-      // 즉시 첫 poll + 주기적 반복
-      poll();
-      timer = setInterval(poll, pollIntervalMs);
-      if (timer.unref) timer.unref();
-    },
-
-    stop() {
-      running = false;
-      if (timer) {
-        clearInterval(timer);
-        timer = null;
-      }
-    },
-
-    get isRunning() {
-      return running;
-    },
-
-    /** 테스트/수동 용: 즉시 poll 실행 (running 상태 무관) */
-    async pollOnce() {
-      await poll(true);
-    },
-
-    reset() {
-      lastEventId = 0;
-    },
-  };
-}
-
-// ── MetricsCollector ──────────────────────────────────────────────────────
-/**
- * Synapse 이벤트에서 메트릭(토큰, 지연시간, 성공률)을 수집
- */
-export function createMetricsCollector(opts = {}) {
-  const { maxSamples = MAX_METRIC_SAMPLES } = opts;
-
-  const metrics = {
-    tokenRates: [], // 초당 토큰 소비율
-    latencies: [], // 요청 지연시간 (ms)
-    successRates: [], // 성공률 (0-1)
-    eventCount: 0,
-    lastEventAt: 0,
-  };
-
-  function pushSample(arr, value) {
-    arr.push(value);
-    if (arr.length > maxSamples) arr.shift();
-  }
-
-  return {
-    /** Synapse 이벤트를 처리하여 메트릭 갱신 */
-    ingest(event) {
-      if (!event || typeof event !== "object") return;
-      metrics.eventCount++;
-      metrics.lastEventAt = Date.now();
-
-      // 토큰 소비율
-      if (typeof event.tokens === "number" && event.tokens > 0) {
-        const elapsed = event.elapsed || 1;
-        pushSample(metrics.tokenRates, event.tokens / elapsed);
-      }
-
-      // 지연시간
-      if (typeof event.latencyMs === "number") {
-        pushSample(metrics.latencies, event.latencyMs);
-      }
-
-      // 성공률 (이벤트별 ok/fail)
-      if (event.status) {
-        const ok =
-          event.status === "ok" || event.status === "completed" ? 1 : 0;
-        pushSample(metrics.successRates, ok);
-      }
-    },
-
-    /** 현재 메트릭 스냅샷 반환 */
-    snapshot() {
-      const avgLatency =
-        metrics.latencies.length > 0
-          ? metrics.latencies.reduce((a, b) => a + b, 0) /
-            metrics.latencies.length
-          : 0;
-      const avgSuccessRate =
-        metrics.successRates.length > 0
-          ? metrics.successRates.reduce((a, b) => a + b, 0) /
-            metrics.successRates.length
-          : 1;
-      const lastTokenRate =
-        metrics.tokenRates.length > 0
-          ? metrics.tokenRates[metrics.tokenRates.length - 1]
-          : 0;
-
-      return {
-        tokenRates: [...metrics.tokenRates],
-        latencies: [...metrics.latencies],
-        successRates: [...metrics.successRates],
-        avgLatency: Math.round(avgLatency),
-        avgSuccessRate: Math.round(avgSuccessRate * 100),
-        lastTokenRate: Math.round(lastTokenRate),
-        eventCount: metrics.eventCount,
-        lastEventAt: metrics.lastEventAt,
-      };
-    },
-
-    reset() {
-      metrics.tokenRates.length = 0;
-      metrics.latencies.length = 0;
-      metrics.successRates.length = 0;
-      metrics.eventCount = 0;
-      metrics.lastEventAt = 0;
-    },
-  };
-}
-
-// ── Tier1 메트릭 렌더러 ───────────────────────────────────────────────────
-/**
- * Synapse 메트릭을 Tier1에 표시할 한 줄 문자열로 렌더링
- * @param {object} snapshot - MetricsCollector.snapshot() 결과
- * @param {number} [width=60] - 최대 표시 폭
- * @returns {string} 렌더링된 메트릭 행
- */
-export function renderMetricsTier1(snapshot, width = 60) {
-  if (!snapshot || snapshot.eventCount === 0) {
-    return dim("synapse: waiting for events…");
-  }
-
-  const parts = [];
-
-  // 토큰 스파크라인
-  if (snapshot.tokenRates.length > 0) {
-    const spark = sparkline(snapshot.tokenRates, 8, MOCHA.executing);
-    parts.push(
-      `tok/s ${spark} ${color(String(snapshot.lastTokenRate), MOCHA.executing)}`,
-    );
-  }
-
-  // 지연시간
-  if (snapshot.latencies.length > 0) {
-    const latColor =
-      snapshot.avgLatency > 1000
-        ? MOCHA.fail
-        : snapshot.avgLatency > 500
-          ? MOCHA.partial
-          : MOCHA.ok;
-    parts.push(`lat ${color(`${snapshot.avgLatency}ms`, latColor)}`);
-  }
-
-  // 성공률
-  if (snapshot.successRates.length > 0) {
-    const srColor =
-      snapshot.avgSuccessRate < 80
-        ? MOCHA.fail
-        : snapshot.avgSuccessRate < 95
-          ? MOCHA.partial
-          : MOCHA.ok;
-    parts.push(`ok ${color(`${snapshot.avgSuccessRate}%`, srColor)}`);
-  }
-
-  // 이벤트 카운트
-  parts.push(dim(`ev:${snapshot.eventCount}`));
-
-  return parts.join(dim(" │ "));
-}

package/hub/team/worker-completion-validator.mjs

@@ -1,79 +0,0 @@
-// hub/team/worker-completion-validator.mjs — Enforce worker completion schema.
-// Issue #115 Lane 1 / F7_worker_did_not_commit.
-//
-// A shard worker that reports `status: "ok"` MUST include a non-empty
-// `commits_made` array. Non-ok statuses are valid terminal reports, but they
-// are not allowed to masquerade as successful completion.
-
-import { readFileSync } from "node:fs";
-import { dirname, join } from "node:path";
-import { fileURLToPath } from "node:url";
-
-import Ajv from "ajv";
-
-const schemaPath = join(
-  dirname(fileURLToPath(import.meta.url)),
-  "schemas",
-  "worker-completion.json",
-);
-const schema = JSON.parse(readFileSync(schemaPath, "utf8"));
-
-const ajv = new Ajv({ allErrors: true, strict: false });
-const compiled = ajv.compile(schema);
-
-/**
- * Validate a worker completion payload against worker-completion.json.
- * Returns `{ ok: true }` when the payload satisfies the schema, otherwise
- * `{ ok: false, reason }` with a short human-readable reason string.
- *
- * @param {unknown} payload
- * @returns {{ ok: boolean, reason?: string }}
- */
-export function validateWorkerCompletion(payload) {
-  if (payload === null || typeof payload !== "object") {
-    return { ok: false, reason: "payload_not_object" };
-  }
-
-  const status = payload.status;
-  if (!["ok", "failed", "blocked"].includes(status)) {
-    return { ok: false, reason: `invalid_status:${status ?? "undefined"}` };
-  }
-
-  const schemaPayload =
-    status === "blocked" ? { ...payload, status: "failed" } : payload;
-  const valid = compiled(schemaPayload);
-  if (!valid) {
-    const firstError = compiled.errors?.[0];
-    const reason = formatError(firstError, payload);
-    return { ok: false, reason };
-  }
-
-  return { ok: true };
-}
-
-function formatError(err, payload) {
-  if (!err) return "schema_validation_failed";
-
-  // Map Ajv keywords to short, actionable reasons.
-  if (
-    err.keyword === "required" &&
-    err.params?.missingProperty === "commits_made"
-  ) {
-    return "missing_commits_made";
-  }
-  if (err.keyword === "minItems" && err.instancePath === "/commits_made") {
-    return "empty_commits_made";
-  }
-  if (err.keyword === "enum" && err.instancePath === "/status") {
-    return `invalid_status:${payload?.status ?? "undefined"}`;
-  }
-  if (err.keyword === "type" && err.instancePath === "/commits_made") {
-    return "commits_made_not_array";
-  }
-  if (err.keyword === "required" && err.params?.missingProperty === "status") {
-    return "missing_status";
-  }
-
-  const path = err.instancePath || "(root)";
-  return `${err.keyword}@${path}:${err.message}`;
-}