TypeScript
/**
* 인터랙티브 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, "");
}