TypeScript
import { existsSync, readFileSync } from "node:fs";
/**
* 로컬 서버 (PRD v2 §W2, --view serve). 의존성 0 — node:http 로 runs/ 디렉터리를 서빙.
* 루트(/)는 모든 run 의 라이브 인덱스. 각 run 의 report.html/graph.html 은 self-contained 그대로 제공.
* 보안: outDir 밖 경로 접근 차단(path traversal 방지).
*/
import { createServer } from "node:http";
import { normalize, resolve } from "node:path";
import { THEME, svgWordmark } from "../brand";
import { esc } from "../flow";
import { listRuns, loadMeta } from "../recorder";
const TYPES: Record<string, string> = {
".html": "text/html; charset=utf-8",
".json": "application/json; charset=utf-8",
".jsonl": "application/x-ndjson; charset=utf-8",
".txt": "text/plain; charset=utf-8",
".svg": "image/svg+xml",
};
function indexPage(outDir: string): string {
const runs = listRuns(outDir);
const rows = runs
.map((id) => {
const meta = loadMeta(outDir, id);
const bench = meta?.bench ?? "?";
const mock = meta?.mock ? " · mock" : "";
return `<li><code>${esc(id)}</code> <span class="b">${esc(bench)}${mock}</span>
<a href="/${esc(id)}/report.html">report</a> · <a href="/${esc(id)}/graph.html">graph</a></li>`;
})
.join("\n");
return `<!doctype html><html lang="en"><head><meta charset="utf-8"><title>theseus — runs</title>
<style>
body{font-family:ui-sans-serif,system-ui,sans-serif;background:${THEME.sea};color:${THEME.sail};margin:0;padding:28px}
header{display:flex;align-items:center;gap:14px;margin-bottom:18px}
ul{list-style:none;padding:0;max-width:760px}
li{background:${THEME.hull};border:1px solid rgba(255,255,255,.08);border-radius:10px;padding:10px 14px;margin:8px 0;display:flex;gap:12px;align-items:center}
code{font-family:ui-monospace,monospace}
.b{color:${THEME.foam};flex:1;font-size:13px}
a{color:${THEME.rope};text-decoration:none;font-weight:600}
a:hover{text-decoration:underline}
</style></head><body>
<header>${svgWordmark()}<span style="opacity:.7">runs index</span></header>
${runs.length ? `<ul>${rows}</ul>` : "<p>no runs yet</p>"}
</body></html>`;
}
export interface ServeHandle {
port: number;
url: string;
close: () => void;
}
export function serveRuns(outDir: string, port: number): Promise<ServeHandle> {
const rootAbs = resolve(outDir);
const server = createServer((req, res) => {
const urlPath = decodeURIComponent((req.url ?? "/").split("?")[0] ?? "/");
if (urlPath === "/" || urlPath === "/index.html") {
res.writeHead(200, { "content-type": "text/html; charset=utf-8" });
res.end(indexPage(outDir));
return;
}
// path traversal 방지: 정규화 후 rootAbs 하위만 허용
const target = resolve(rootAbs, `.${normalize(urlPath)}`);
if (!target.startsWith(rootAbs) || !existsSync(target)) {
res.writeHead(404, { "content-type": "text/plain" });
res.end("not found");
return;
}
const ext = target.slice(target.lastIndexOf("."));
try {
res.writeHead(200, { "content-type": TYPES[ext] ?? "application/octet-stream" });
res.end(readFileSync(target));
} catch {
res.writeHead(500, { "content-type": "text/plain" });
res.end("read error");
}
});
return new Promise((resolvePromise, reject) => {
server.on("error", reject);
server.listen(port, () => {
const addr = server.address();
const actual = addr && typeof addr === "object" ? addr.port : port;
resolvePromise({
port: actual,
url: `http://localhost:${actual}`,
close: () => server.close(),
});
});
});
}