Skip to content
TypeScript
6.1 KB
Raw Blame
/**
 * 인터랙티브 TUI (PRD v2 §W4) — ink.
 * runs 목록 → combo 표 → combo 상세(메트릭 + 흐름 트리). 화살표/enter/esc/q.
 * JSX 미사용(React.createElement) → 빌드 설정 불필요. ink/react 는 lazy dynamic import,
 * 미설치/비-TTY 면 runInk 가 false 를 반환해 tui.ts 가 cli-table3 폴백.
 */
import { existsSync, readFileSync, readdirSync } from "node:fs";
import { join } from "node:path";
import { type Translator, translator } from "../i18n";
import { aggregateAll, bestByPerspectiveDetailed, sortCombos } from "../metrics";
import type { ComboMetrics } from "../metrics";
import type { FlowGraph, Lang } from "../models";
import { listRuns, loadMeta, loadResults } from "../recorder";
import { renderFlowTree } from "../viz/terminal";

function safe(s: string): string {
  return s.replace(/[^A-Za-z0-9._+-]/g, "_");
}

/** runs/<id>/work/<combo>/<task>/0/flow.json 중 하나를 best-effort 로드. */
function loadComboFlow(runDir: string, comboId: string): FlowGraph | null {
  const base = join(runDir, "work", safe(comboId));
  if (!existsSync(base)) return null;
  try {
    for (const task of readdirSync(base)) {
      const f = join(base, task, "0", "flow.json");
      if (existsSync(f)) return JSON.parse(readFileSync(f, "utf8")) as FlowGraph;
    }
  } catch {
    // ignore
  }
  return null;
}

export interface InkOpts {
  out: string;
  language: Lang;
}

/** ink 앱 실행. 성공 시 종료까지 대기 후 true, 미가용 시 false. 절대 throw 금지. */
export async function runInk(opts: InkOpts): Promise<boolean> {
  if (!process.stdout.isTTY) return false;
  let ink: any;
  let React: any;
  try {
    ink = await import("ink");
    React = (await import("react")).default ?? (await import("react"));
  } catch {
    return false;
  }

  const { render, Box, Text, useInput, useApp } = ink;
  const h = React.createElement;
  const t: Translator = translator(opts.language);
  const runs = listRuns(opts.out);

  const App = () => {
    const app = useApp();
    const [screen, setScreen] = React.useState("runs");
    const [runIdx, setRunIdx] = React.useState(0);
    const [comboIdx, setComboIdx] = React.useState(0);

    const runId = runs[runIdx];
    const metrics: ComboMetrics[] = runId
      ? sortCombos(aggregateAll(loadResults(opts.out, runId)))
      : [];

    useInput((input: string, key: any) => {
      if (input === "q") {
        app.exit();
        return;
      }
      if (screen === "runs") {
        if (key.upArrow) setRunIdx((i: number) => Math.max(0, i - 1));
        if (key.downArrow) setRunIdx((i: number) => Math.min(runs.length - 1, i + 1));
        if (key.return && runs.length) {
          setComboIdx(0);
          setScreen("combos");
        }
      } else if (screen === "combos") {
        if (key.upArrow) setComboIdx((i: number) => Math.max(0, i - 1));
        if (key.downArrow) setComboIdx((i: number) => Math.min(metrics.length - 1, i + 1));
        if (key.return && metrics.length) setScreen("detail");
        if (key.leftArrow || key.escape) setScreen("runs");
      } else if (screen === "detail") {
        if (key.leftArrow || key.escape) setScreen("combos");
      }
    });

    const header = h(
      Text,
      { color: "cyan", bold: true },
      `⛵ theseus — ${t("results_table")}  `,
      h(Text, { color: "gray" }, "(↑↓ move · ⏎ select · ← back · q quit)"),
    );

    if (screen === "runs") {
      return h(
        Box,
        { flexDirection: "column" },
        header,
        h(Text, { color: "gray" }, `${t("run_id")}s:`),
        ...runs.map((id, i) => {
          const meta = loadMeta(opts.out, id);
          return h(
            Text,
            { key: id, color: i === runIdx ? "green" : undefined, inverse: i === runIdx },
            `${i === runIdx ? "❯ " : "  "}${id}  ${meta?.bench ?? "?"}${meta?.mock ? " ·mock" : ""}`,
          );
        }),
        runs.length === 0 ? h(Text, { color: "yellow" }, "no runs found") : null,
      );
    }

    if (screen === "combos") {
      return h(
        Box,
        { flexDirection: "column" },
        header,
        h(
          Text,
          { color: "gray" },
          `${runId}  —  ${t("col_combo")} (${t("col_subagents")}/${t("col_tokens")}/${t("col_cost")})`,
        ),
        ...metrics.map((m, i) =>
          h(
            Text,
            {
              key: m.comboId,
              color: i === comboIdx ? "green" : undefined,
              inverse: i === comboIdx,
            },
            `${i === comboIdx ? "❯ " : "  "}${m.comboId.padEnd(26)} ` +
              `${String(m.subagentCount).padStart(3)}  ${(m.totalTokens / 1000).toFixed(0)}k  ` +
              `${m.costUsd === null ? "null" : `$${m.costUsd.toFixed(3)}`}  ${m.accuracy.toFixed(0)}%`,
          ),
        ),
      );
    }

    // detail
    const m = metrics[comboIdx];
    if (!m) return header;
    const flow = runId ? loadComboFlow(join(opts.out, runId), m.comboId) : null;
    const picks = bestByPerspectiveDetailed(metrics, opts.language)
      .filter((p) => p.comboId === m.comboId)
      .map((p) => p.label);
    return h(
      Box,
      { flexDirection: "column" },
      header,
      h(Text, { bold: true, color: "cyan" }, m.comboId),
      h(
        Text,
        null,
        `${t("col_acc")}: ${m.accuracy.toFixed(1)}%   ${t("col_subagents")}: ${m.subagentCount}   ${t("col_tokens")}: ${m.totalTokens.toLocaleString("en-US")}`,
      ),
      h(
        Text,
        null,
        `${t("col_cost")}: ${m.costUsd === null ? "null (uncollected)" : `$${m.costUsd.toFixed(4)} (${m.costSource})`}   ${t("col_toolcalls")}: ${m.toolCalls}`,
      ),
      picks.length ? h(Text, { color: "green" }, `★ ${picks.join(", ")}`) : null,
      h(Text, { color: "gray" }, `\n${t("sec_flow")}:`),
      h(Text, null, flow ? stripAnsi(renderFlowTree(flow)) : "  (no flow.json)"),
    );
  };

  const instance = render(h(App));
  await instance.waitUntilExit();
  return true;
}

function stripAnsi(s: string): string {
  // 트리 렌더는 picocolors 색을 포함 — ink Text 안에서는 평문이 안전.
  // biome-ignore lint/suspicious/noControlCharactersInRegex: ANSI 제거
  return s.replace(/\x1b\[[0-9;]*m/g, "");
}