niceeval 0.12.1 → 0.12.2-canary.31

package/src/show/json.test.ts

@@ -1,412 +0,0 @@
-// cases: docs/engineering/testing/unit/reports.md
-//
-// 覆盖类别:「--json 投影」。本文件只证明 envelope 字段与跨视图不变量:format/schemaVersion/view/sample 回显;同 fixture
-// 下 text 面与 --json 面选出同一批实体、共有派生字段同值(由同一次组件 resolve 产物构造保证,
-// 不是两套手写投影分别实现再比对);JSON 是 text 的数据超集(允许保留 text 省略的字段,不能
-// 反向要求字段集合相等);字段名复用落盘类型、不重命名;timing 的 JSON 面恒为完整树,不受
-// --timing=summary/full 影响;与 --report、--expand、重复证据 flag 的互斥用法错误;stdout 只有
-// 单个 JSON 文档。逐视图 `data` 的完整字段形状(deltaTableData/stabilityMatrixData/
-// usageTableData/attempt-detail 各 *Data)不在本文件重复断言,单源在各自组件的测试里。
-
-import { afterEach, beforeAll, afterAll, describe, expect, it } from "vitest";
-import { mkdir, mkdtemp, rm, writeFile } from "node:fs/promises";
-import { tmpdir } from "node:os";
-import { join } from "node:path";
-import { openRecord } from "../record/index.ts";
-import { RECORD_FORMAT, RECORD_SCHEMA_VERSION, type EvalResult, type Verdict } from "../types.ts";
-import { runShow, type ShowFlags } from "./index.ts";
-import type { ShowJson } from "./json.ts";
-import { setConfiguredLocale } from "../i18n/index.ts";
-import { completeEvidenceCoverage } from "../assertions/coverage.ts";
-
-// ───────────────────────── fixture 工具(自成一份,不跨文件耦合) ─────────────────────────
-
-const roots: string[] = [];
-async function makeRoot(): Promise<string> {
-  const root = await mkdtemp(join(tmpdir(), "niceeval-show-json-"));
-  roots.push(root);
-  return root;
-}
-afterEach(async () => {
-  await Promise.all(roots.splice(0).map((r) => rm(r, { recursive: true, force: true })));
-});
-
-beforeAll(() => {
-  setConfiguredLocale("en");
-});
-afterAll(() => {
-  setConfiguredLocale(undefined);
-});
-
-type AttemptFixture = Pick<EvalResult, "id" | "verdict" | "evidenceCoverage"> &
-  Partial<Pick<EvalResult, "attempt" | "durationMs" | "assertions" | "estimatedCostUSD" | "startedAt" | "usage" | "phases">>;
-
-function res(id: string, verdict: Verdict, extra: Partial<AttemptFixture> = {}): AttemptFixture {
-  return { id, verdict, attempt: 0, durationMs: 1000, assertions: [], evidenceCoverage: completeEvidenceCoverage, ...extra };
-}
-
-function cleanDirName(id: string): string {
-  return id.replace(/[^\w.@-]/g, "_");
-}
-
-interface SnapshotOpts {
-  experimentId: string;
-  agent?: string;
-  startedAt: string;
-}
-
-async function writeSnapshot(root: string, snapDirName: string, opts: SnapshotOpts, results: AttemptFixture[]): Promise<void> {
-  const dir = join(root, cleanDirName(opts.experimentId), snapDirName);
-  await mkdir(dir, { recursive: true });
-  const meta = {
-    format: RECORD_FORMAT,
-    schemaVersion: RECORD_SCHEMA_VERSION,
-    producer: { name: "niceeval", version: "0.4.6" },
-    runId: `${cleanDirName(opts.experimentId)}:${snapDirName}`,
-    experimentId: opts.experimentId,
-    agent: opts.agent ?? "bub",
-    startedAt: opts.startedAt,
-    configHash: "fixture-config",
-    completedAt: opts.startedAt,
-    experiment: {
-      attempts: 1,
-      earlyExit: true,
-      selectedEvalIds: results.map((result) => result.id),
-      sandboxLayer: {},
-      sandboxPlansByEval: {},
-      agentInstalls: [],
-    },
-  };
-  await writeFile(join(dir, "run.json"), JSON.stringify(meta, null, 2), "utf-8");
-  for (const r of results) {
-    const attemptDir = join(dir, r.id, `a${r.attempt ?? 0}`);
-    await mkdir(attemptDir, { recursive: true });
-    await writeFile(join(attemptDir, "result.json"), JSON.stringify(r, null, 2), "utf-8");
-  }
-}
-
-interface Captured {
-  out: string;
-  err: string;
-  code: number;
-}
-
-async function show(root: string, patterns: string[], flags: ShowFlags = {}): Promise<Captured> {
-  let out = "";
-  let err = "";
-  const code = await runShow(root, patterns, { record: root, ...flags }, {
-    out: (s) => (out += s),
-    err: (s) => (err += s),
-    width: 100,
-    now: Date.parse("2026-07-09T10:01:00.000Z"),
-  });
-  return { out, err, code };
-}
-
-async function showJson(root: string, patterns: string[], flags: ShowFlags = {}): Promise<{ doc: ShowJson; err: string; code: number }> {
-  const { out, err, code } = await show(root, patterns, { ...flags, json: true });
-  expect(code, `expected --json call to succeed; stderr: ${err}`).toBe(0);
-  return { doc: JSON.parse(out) as ShowJson, err, code };
-}
-
-// ───────────────────────── envelope 形状 ─────────────────────────
-
-describe("--json envelope 形状", () => {
-  async function seedTwoExperimentsRoot(): Promise<string> {
-    const root = await makeRoot();
-    await writeSnapshot(root, "2026-07-08T10-00-00-000Z", { experimentId: "dev-e2b/codex", startedAt: "2026-07-08T10:00:00.000Z" }, [
-      res("weather/brooklyn", "passed", { estimatedCostUSD: 0.05, usage: { inputTokens: 100, outputTokens: 20 } }),
-      res("weather/queens", "failed"),
-    ]);
-    await writeSnapshot(root, "2026-07-08T10-00-00-000Z", { experimentId: "dev-e2b/claude", startedAt: "2026-07-08T10:00:00.000Z" }, [
-      res("weather/brooklyn", "passed"),
-    ]);
-    return root;
-  }
-
-  it("leaderboard:format/schemaVersion/view/sample 回显", async () => {
-    const root = await seedTwoExperimentsRoot();
-    const { doc } = await showJson(root, []);
-    expect(doc.format).toBe("niceeval.show");
-    expect(doc.schemaVersion).toBe(1);
-    expect(doc.view).toBe("leaderboard");
-    expect(doc.sample.resultsRoot).toBe(root);
-    expect(doc.sample.fresh).toBe(false);
-    expect(doc.sample.experiments.sort()).toEqual(["dev-e2b/claude", "dev-e2b/codex"]);
-    expect(doc.sample.evalPrefix).toBeUndefined();
-  });
-
-  it("compare:view 与 sample.experiments 顺序即条件顺序,首个是基准", async () => {
-    const root = await seedTwoExperimentsRoot();
-    const { doc } = await showJson(root, [], { experiment: ["dev-e2b/codex", "dev-e2b/claude"] });
-    expect(doc.view).toBe("compare");
-    expect(doc.sample.experiments).toEqual(["dev-e2b/codex", "dev-e2b/claude"]);
-  });
-
-  it("eval id 前缀回显进 sample.evalPrefix", async () => {
-    const root = await seedTwoExperimentsRoot();
-    const { doc } = await showJson(root, ["weather/brooklyn"]);
-    expect(doc.sample.evalPrefix).toBe("weather/brooklyn");
-  });
-
-  it("--fresh 回显进 sample.fresh", async () => {
-    const root = await seedTwoExperimentsRoot();
-    const { doc } = await showJson(root, [], { fresh: true });
-    expect(doc.sample.fresh).toBe(true);
-  });
-
-  it("usage:view 为 usage,sample.experiments 反映 --exp 收窄", async () => {
-    const root = await seedTwoExperimentsRoot();
-    const { doc } = await showJson(root, [], { experiment: ["dev-e2b/codex"], usage: true });
-    expect(doc.view).toBe("usage");
-    expect(doc.sample.experiments).toEqual(["dev-e2b/codex"]);
-  });
-
-  it("stats:view 为 stats", async () => {
-    const root = await seedTwoExperimentsRoot();
-    const { doc } = await showJson(root, [], { stats: true });
-    expect(doc.view).toBe("stats");
-  });
-
-  it("@<locator> 默认首页:view 为 attempt", async () => {
-    const root = await seedTwoExperimentsRoot();
-    const results = await openRecord(root);
-    const locator = results.experiments.find((e) => e.id === "dev-e2b/codex")!.latestRun.evals[0]!.attempts[0]!.locator!;
-    const { doc } = await showJson(root, [locator]);
-    expect(doc.view).toBe("attempt");
-    expect(doc.sample.experiments).toEqual(["dev-e2b/codex"]);
-  });
-
-  // locator 的寻址作用域是整个记录根,不是现刻水位(docs/feature/record/architecture.md
-  // 「locator 的唯一性」):`--history` 印出的历史 Run attempt 必须能被同一个 `@<locator>` 打开。
-  // 区分力靠「同一个 evalId 在新旧两个 Run 里各有一条」——现刻水位只留新的那条,旧的那条
-  // 曾被当成「不在选中范围内」而报 not-found。
-  it("@<locator> 指向历史 Run 的 attempt 时照样打开,不受现刻水位收窄", async () => {
-    const root = await makeRoot();
-    await writeSnapshot(root, "2026-07-07T09-00-00-000Z", { experimentId: "dev-e2b/codex", startedAt: "2026-07-07T09:00:00.000Z" }, [
-      res("weather/brooklyn", "failed"),
-    ]);
-    await writeSnapshot(root, "2026-07-08T10-00-00-000Z", { experimentId: "dev-e2b/codex", startedAt: "2026-07-08T10:00:00.000Z" }, [
-      res("weather/brooklyn", "passed"),
-    ]);
-    const results = await openRecord(root);
-    const experiment = results.experiments.find((e) => e.id === "dev-e2b/codex")!;
-    const olderRun = experiment.runs.find((r) => r.startedAt !== experiment.latestRun.startedAt)!;
-    const historical = olderRun.evals[0]!.attempts[0]!;
-    expect(historical.locator).not.toBe(experiment.latestRun.evals[0]!.attempts[0]!.locator);
-
-    const { doc } = await showJson(root, [historical.locator!]);
-    expect(doc.view).toBe("attempt");
-    expect(doc.sample.experiments).toEqual(["dev-e2b/codex"]);
-    expect((doc.data as { summary: { verdict: string } }).summary.verdict).toBe("failed");
-  });
-});
-
-// ───────────────────────── text 面与 --json 面同一批实体、共有字段同值 ─────────────────────────
-
-describe("--json 与 text 面同值(同一次组件 resolve 产物)", () => {
-  it("显式 --source 在 attempt 没有源码证据时非零退出，text 与 JSON 都不伪造空文档", async () => {
-    const root = await makeRoot();
-    await writeSnapshot(root, "2026-07-08T10-00-00-000Z", { experimentId: "dev/e2b", startedAt: "2026-07-08T10:00:00.000Z" }, [
-      res("weather/no-source", "passed"),
-    ]);
-
-    const text = await show(root, [], { source: true });
-    expect(text.code).toBe(1);
-    expect(text.out).toBe("");
-    expect(text.err).toContain("Source evidence unavailable");
-
-    const json = await show(root, [], { source: true, json: true });
-    expect(json.code).toBe(1);
-    expect(json.out).toBe("");
-    expect(json.err).toContain("Source evidence unavailable");
-  });
-
-  it("--source --json 不沿用终端的源码裁行预算", async () => {
-    const root = await makeRoot();
-    const experimentId = "dev/e2b";
-    const snapDir = "2026-07-08T10-00-00-000Z";
-    const evalId = "weather/source";
-    const content = Array.from({ length: 20 }, (_, index) => `line ${index + 1};`).join("\n");
-    await writeSnapshot(root, snapDir, { experimentId, startedAt: "2026-07-08T10:00:00.000Z" }, [
-      res(evalId, "passed", {
-        assertions: [{
-          name: "captured source",
-          severity: "soft",
-          outcome: "passed",
-          score: 1,
-          loc: { file: "evals/source.ts", line: 10, callers: [] },
-        }],
-      }),
-    ]);
-    const snapshotDir = join(root, cleanDirName(experimentId), snapDir);
-    const sha256 = "source-json-budget";
-    await mkdir(join(snapshotDir, "sources"), { recursive: true });
-    await writeFile(
-      join(snapshotDir, evalId, "a0", "sources.json"),
-      JSON.stringify([{ path: "evals/source.ts", sha256, role: "entry" }]),
-      "utf-8",
-    );
-    await writeFile(join(snapshotDir, "sources", `${sha256}.json`), JSON.stringify({ content }), "utf-8");
-
-    const { doc } = await showJson(root, [], { source: true });
-    expect(doc.view).toBe("source");
-    if (doc.view !== "source" || Array.isArray(doc.data)) throw new Error("expected one source result");
-    expect((doc.data as { source?: { spine: { lines: unknown[] } } | null }).source?.spine.lines).toHaveLength(20);
-  });
-
-  it("--usage:text 面的成本/token 数字与 --json 该行的落盘字段同值", async () => {
-    const root = await makeRoot();
-    await writeSnapshot(root, "2026-07-08T10-00-00-000Z", { experimentId: "dev/e2b", startedAt: "2026-07-08T10:00:00.000Z" }, [
-      res("weather/brooklyn", "passed", { estimatedCostUSD: 0.05, usage: { inputTokens: 100, outputTokens: 20 } }),
-      res("weather/queens", "failed"),
-    ]);
-    const text = await show(root, [], { experiment: ["dev/e2b"], usage: true });
-    const { doc } = await showJson(root, [], { experiment: ["dev/e2b"], usage: true });
-    expect(text.code).toBe(0);
-    expect(doc.view).toBe("usage");
-    if (doc.view !== "usage") throw new Error("expected usage view");
-    const rows = doc.data;
-    const brooklyn = rows.find((r) => r.evalId === "weather/brooklyn")!;
-    // 同一个 fixture:text 面渲染出的成本数字与 --json 该 attempt 的落盘字段一致——两面消费的是
-    // 同一次 usageRowsOf() 产物(show/index.ts 的 usageRowsOf),不是各自重新聚合的两份数字。
-    expect(text.out).toContain("$0.05");
-    expect(brooklyn.estimatedCostUSD).toBe(0.05);
-    expect(brooklyn.usage?.outputTokens).toBe(20);
-    // 两面选出同一批实体:text 面两行都出现,json 面两行都出现,locator 集合相同。
-    const jsonLocators = rows.map((r) => r.locator).sort();
-    const textLocators = [...text.out.matchAll(/@1[0-9A-HJKMNP-TV-Z]{12}/g)].map((m) => m[0]).sort();
-    expect(jsonLocators).toEqual(textLocators);
-  });
-
-  it("--json 是 text 的数据超集:text 面的缺失占位 — 在 JSON 里是整字段省略,不是 0", async () => {
-    const root = await makeRoot();
-    await writeSnapshot(root, "2026-07-08T10-00-00-000Z", { experimentId: "dev/e2b", startedAt: "2026-07-08T10:00:00.000Z" }, [
-      res("weather/queens", "failed"),
-    ]);
-    const text = await show(root, [], { experiment: ["dev/e2b"], usage: true });
-    const { doc } = await showJson(root, [], { experiment: ["dev/e2b"], usage: true });
-    expect(doc.view).toBe("usage");
-    if (doc.view !== "usage") throw new Error("expected usage view");
-    const row = doc.data[0]!;
-    const queensLine = text.out.split("\n").find((l) => l.includes("weather/queens"))!;
-    expect(queensLine.trim().endsWith("—")).toBe(true);
-    expect("usage" in row).toBe(false);
-    expect("estimatedCostUSD" in row).toBe(false);
-    expect("turns" in row).toBe(false);
-  });
-
-  it("字段名复用落盘类型,不重命名(UsageTableData 的身份字段原样出现)", async () => {
-    const root = await makeRoot();
-    await writeSnapshot(root, "2026-07-08T10-00-00-000Z", { experimentId: "dev/e2b", startedAt: "2026-07-08T10:00:00.000Z" }, [
-      res("weather/brooklyn", "passed"),
-    ]);
-    const { doc } = await showJson(root, [], { experiment: ["dev/e2b"], usage: true });
-    expect(doc.view).toBe("usage");
-    if (doc.view !== "usage") throw new Error("expected usage view");
-    const row = doc.data[0]!;
-    expect(Object.keys(row).sort()).toEqual(["attempt", "evalId", "experimentId", "locator", "verdict"].sort());
-  });
-});
-
-// ───────────────────────── timing:JSON 恒为完整树 ─────────────────────────
-
-describe("--timing 的 --json 面恒为完整树", () => {
-  it("--timing(summary) 与 --timing=full 的 --json data 逐字节相同——不受 text 预算影响", async () => {
-    const root = await makeRoot();
-    await writeSnapshot(root, "2026-07-08T10-00-00-000Z", { experimentId: "dev/e2b", startedAt: "2026-07-08T10:00:00.000Z" }, [
-      res("weather/brooklyn", "passed", {
-        phases: [
-          { name: "sandbox.queue", durationMs: 10 },
-          { name: "sandbox.create", durationMs: 200 },
-          { name: "agent.setup", durationMs: 300 },
-        ],
-      }),
-    ]);
-    const locator = (await openRecord(root)).experiments[0]!.latestRun.evals[0]!.attempts[0]!.locator!;
-    const summaryDoc = await showJson(root, [locator], { timing: "summary" });
-    const fullDoc = await showJson(root, [locator], { timing: "full" });
-    expect(summaryDoc.doc.data).toEqual(fullDoc.doc.data);
-    expect(summaryDoc.doc.data).not.toBeNull();
-  });
-});
-
-// ───────────────────────── history:AttemptJson 全字段投影(不进组件模型) ─────────────────────────
-
-describe("--history 的 --json 面:直接投影 AttemptJson,不是 text 面的单行摘要", () => {
-  it("分节按 experimentId + evalId,每条 attempt 携带完整落盘字段 + 归属身份", async () => {
-    const root = await makeRoot();
-    await writeSnapshot(root, "2026-07-08T10-00-00-000Z", { experimentId: "dev/e2b", startedAt: "2026-07-08T10:00:00.000Z" }, [
-      res("weather/brooklyn", "passed", { assertions: [], durationMs: 1234 }),
-    ]);
-    const { doc } = await showJson(root, [], { history: true });
-    expect(doc.view).toBe("history");
-    if (doc.view !== "history") throw new Error("expected history view");
-    const sections = doc.data.sections;
-    expect(sections).toHaveLength(1);
-    expect(sections[0]!.experimentId).toBe("dev/e2b");
-    expect(sections[0]!.evalId).toBe("weather/brooklyn");
-    const attempt = sections[0]!.attempts[0]!;
-    // AttemptJson = 落盘 AttemptRecord 全字段 + 归属身份;durationMs/assertions 这类落盘字段
-    // 原样出现(text 面的 attemptHistory 反而把它们折成单行摘要,不包含这些字段)。
-    expect(attempt.durationMs).toBe(1234);
-    expect(attempt.assertions).toEqual([]);
-    expect(attempt.experimentId).toBe("dev/e2b");
-    expect(attempt.runStartedAt).toBe("2026-07-08T10:00:00.000Z");
-  });
-});
-
-// ───────────────────────── 用法冲突 ─────────────────────────
-
-describe("--json 的用法冲突", () => {
-  it("与 --report 互斥", async () => {
-    const root = await makeRoot();
-    await writeSnapshot(root, "2026-07-08T10-00-00-000Z", { experimentId: "dev/e2b", startedAt: "2026-07-08T10:00:00.000Z" }, [
-      res("weather/brooklyn", "passed"),
-    ]);
-    const { err, code } = await show(root, [], { json: true, report: "reports/x.tsx" });
-    expect(code).toBe(1);
-    expect(err).toContain("error:");
-    expect(err).toContain("fix:");
-    expect(err).toContain("--json cannot combine with --report");
-  });
-
-  it("与 --expand 互斥", async () => {
-    const root = await makeRoot();
-    await writeSnapshot(root, "2026-07-08T10-00-00-000Z", { experimentId: "dev/e2b", startedAt: "2026-07-08T10:00:00.000Z" }, [
-      res("weather/brooklyn", "passed"),
-    ]);
-    const { err, code } = await show(root, [], { json: true, execution: true, expand: "t1.c1" });
-    expect(code).toBe(1);
-    expect(err).toContain("error:");
-    expect(err).toContain("--json cannot combine with --expand");
-  });
-
-  it("同时点多个证据 flag 时按用法错误退出:JSON 的 view 是单一枚举值,没有合并形状", async () => {
-    const root = await makeRoot();
-    await writeSnapshot(root, "2026-07-08T10-00-00-000Z", { experimentId: "dev/e2b", startedAt: "2026-07-08T10:00:00.000Z" }, [
-      res("weather/brooklyn", "passed"),
-    ]);
-    const { err, code } = await show(root, [], { json: true, source: true, execution: true });
-    expect(code).toBe(1);
-    expect(err).toContain("error:");
-    expect(err).toContain("--json requires exactly one of");
-  });
-});
-
-// ───────────────────────── stdout 单文档 ─────────────────────────
-
-describe("--json 的 stdout 形状", () => {
-  it("stdout 只有一个 JSON 文档:单行 + 末尾换行,不是 NDJSON", async () => {
-    const root = await makeRoot();
-    await writeSnapshot(root, "2026-07-08T10-00-00-000Z", { experimentId: "dev/e2b", startedAt: "2026-07-08T10:00:00.000Z" }, [
-      res("weather/brooklyn", "passed"),
-    ]);
-    const { out, code } = await show(root, [], { json: true });
-    expect(code).toBe(0);
-    const newlineCount = (out.match(/\n/g) ?? []).length;
-    expect(newlineCount).toBe(1);
-    expect(out.endsWith("\n")).toBe(true);
-    expect(() => JSON.parse(out)).not.toThrow();
-  });
-});

package/src/show/json.ts

@@ -1,106 +0,0 @@
-// niceeval show --json —— 信封与通用 attempt 投影(契约:docs/feature/reports/show/json.md)。
-// `data` 字段本身不是第二套形状:逐 view 指向对应报告组件的 `*Data` 产物,字段单源住在各组件
-// 分篇(docs/feature/reports/architecture.md「show 的切片是组件选择」)。本文件只装配信封、
-// 通用 attempt 投影与 stdout 单文档序列化,不重复声明任何组件的字段形状。
-
-import type { AttemptHandle } from "../record/index.ts";
-import type { EvalResult } from "../types.ts";
-import type {
-  AnnotatedSourceResult,
-  AttemptDetailsResult,
-  ComparisonResult,
-  ConversationResult,
-  DiffResult,
-  HistoryResult,
-  StabilityResult,
-  StandardOverviewResult,
-  TimingResult,
-  UsageResult,
-} from "../report/tasks.ts";
-
-/** 信封 `view` 的穷尽集合,与 docs/feature/reports/show/json.md「data:按 view 找组件声明」的表逐行对应。 */
-export type ShowJsonView =
-  | "leaderboard"
-  | "compare"
-  | "attempt"
-  | "source"
-  | "execution"
-  | "timing"
-  | "usage"
-  | "diff"
-  | "history"
-  | "stats";
-
-export interface ShowJsonSample {
-  resultsRoot: string;
-  evalPrefix?: string;
-  /** 解析后的 experiment id 全集;对照视图下顺序即条件顺序,首个是基准。 */
-  experiments: string[];
-  fresh: boolean;
-}
-
-interface ShowJsonBase {
-  format: "niceeval.show";
-  /** 破坏性形状变更时递增;新增可选字段不递增,消费方忽略未知字段。 */
-  schemaVersion: 1;
-  /** 本次调用解析后的范围回显。 */
-  sample: ShowJsonSample;
-}
-
-type OneOrMany<Result> = Result | readonly Result[];
-
-/** `view` 判别 `data` 的完整联合；消费方收窄 view 后不再面对 unknown。 */
-export type ShowJson =
-  | (ShowJsonBase & { view: "leaderboard"; data: StandardOverviewResult })
-  | (ShowJsonBase & { view: "compare"; data: ComparisonResult })
-  | (ShowJsonBase & { view: "attempt"; data: AttemptDetailsResult })
-  | (ShowJsonBase & { view: "source"; data: OneOrMany<AnnotatedSourceResult> })
-  | (ShowJsonBase & { view: "execution"; data: OneOrMany<ConversationResult> })
-  | (ShowJsonBase & { view: "timing"; data: OneOrMany<TimingResult> })
-  | (ShowJsonBase & { view: "usage"; data: readonly UsageResult[] })
-  | (ShowJsonBase & { view: "diff"; data: OneOrMany<DiffResult> })
-  | (ShowJsonBase & { view: "history"; data: HistoryResult })
-  | (ShowJsonBase & { view: "stats"; data: StabilityResult });
-
-/**
- * attempt 的通用投影(docs/feature/reports/show/json.md「通用 attempt 投影」):落盘
- * `EvalResult` 全字段 + 归属身份。`AttemptHandle.result` 已
- * 把快照级字段拼合成的瘦身条目(见 `src/record/types.ts` 的 `AttemptHandle` 字段注释);
- * `experimentId` 与 `runStartedAt` 补足「归属身份」,与组件自己的 `*Data` 声明共用同一条
- * 「字段名复用落盘类型、不发明第二套命名」纪律。只有 [`history`](../../docs/feature/reports/show/history.md)
- * 这个不进组件模型的切片直接消费它——其余 view 的 `data` 字段单源在各自组件的 `*Data` 声明,
- * 那些声明各自已经携带自己需要的身份子集(如 `UsageTableData.experimentId`/`.evalId`/`.attempt`),
- * 不重复套这层通用投影。
- */
-export type AttemptJson = EvalResult & {
-  experimentId: string;
-  runStartedAt: string;
-};
-
-export function attemptJsonOf(attempt: AttemptHandle): AttemptJson {
-  return { ...attempt.result, experimentId: attempt.experimentId, runStartedAt: attempt.run.startedAt };
-}
-
-/** 信封的 `sample` 字段;`patterns` 为空时省略 `evalPrefix`。 */
-export function buildShowSample(input: {
-  resultsRoot: string;
-  patterns: readonly string[];
-  experiments: readonly string[];
-  fresh: boolean;
-}): ShowJsonSample {
-  return {
-    resultsRoot: input.resultsRoot,
-    ...(input.patterns.length > 0 ? { evalPrefix: input.patterns.join(",") } : {}),
-    experiments: [...input.experiments],
-    fresh: input.fresh,
-  };
-}
-
-/**
- * stdout 的单文档序列化(docs/feature/reports/show/json.md「输出是一个顶层 JSON 文档」):不
- * 缩进(单行,jq 友好、与 `exp --dry --json` 的 `renderJsonPlanDocument` 同一惯例),末尾补一个
- * 换行,不是 NDJSON——一次调用只有这一个文档。
- */
-export function renderShowJson(doc: ShowJson): string {
-  return `${JSON.stringify(doc)}\n`;
-}