niceeval 0.5.3 → 0.6.0

package/src/show/compose.ts

@@ -1,140 +1,20 @@
-// show 宿主的选集合成与时间轴口径(docs-site/zh/guides/viewing-results.mdx 是行为规范)。
+// show 专属的跨 run 时间轴口径(--history;docs-site/zh/guides/viewing-results.mdx 是行为规范)。
 //
-// 「现刻水位」= 每个 experiment × eval 取时间上最新的那份判决,跨 run 合成:
-// results.latest() 只挑「每实验最新快照」,带 eval 前缀的局部重跑会产出残缺快照;
-// 榜单承诺「不会因为一次局部重跑变残缺」,所以宿主在实验的全部历史快照上逐 eval
-// 向更早的 run 补齐,再把合成好的选集注入报告槽——内置默认报告与 --report 吃同一份,
-// 官方榜单口径 = 宿主注入口径。本文件只消费 niceeval/results 的读取面。
+// 现刻水位 Selection(两个宿主共用)住在 ../results/select.ts 的 selectCurrentResults;
+// 本文件只留 show 独有的时间轴计算:每个快照 / 每次真实执行一行,resume 携带的复印件不占行。
+// 数据只消费 niceeval/results 的读取面。
 
-import { foldEvalOutcome } from "../shared/outcome.ts";
-import { evalPrefixPredicate } from "../report/aggregate.ts";
+import { foldEvalVerdict } from "../shared/verdict.ts";
 import { attemptCostUSD } from "../report/metrics.ts";
-import { makeSelection } from "../results/select.ts";
-import type { ResultOutcome } from "../types.ts";
-import type {
-  AttemptHandle,
-  Eval,
-  Experiment,
-  Results,
-  Selection,
-  SelectionWarning,
-  Snapshot,
-} from "../results/index.ts";
-
-export interface ComposeOptions {
-  /** experiment id 前缀(--experiment),与 latest({ experiments }) 同一分段匹配语义。 */
-  experiment?: string;
-  /** eval id 前缀(位置参数),收窄选集覆盖的 eval;覆盖警告分母 = 已知并集 ∩ 范围。 */
-  patterns?: string[];
-}
-
-/** --experiment 的实验过滤,同 results.latest({ experiments }) 的分段前缀语义。 */
-export function filterExperiments(experiments: Experiment[], prefix?: string): Experiment[] {
-  if (prefix === undefined) return experiments;
-  const p = prefix.replace(/\/+$/, "");
-  return experiments.filter((exp) => exp.id === p || exp.id.startsWith(p + "/"));
-}
-
-/**
- * 合成「现刻水位」选集:每个实验一份合成快照,快照里每道题的判决取该题最后一次
- * 出现的快照(--resume 携带的复印件身份与原判决相同,取到哪份内容都一致)。
- * 警告随选集重算:partial-coverage 的分母 = 已知并集 ∩ 范围;stale / synthetic
- * 与 results.latest() 同口径。
- */
-export function composeShowSelection(results: Results, opts: ComposeOptions = {}): Selection {
-  const match =
-    opts.patterns && opts.patterns.length > 0 ? evalPrefixPredicate(opts.patterns) : () => true;
-  const experiments = filterExperiments(results.experiments, opts.experiment);
-
-  const snapshots: Snapshot[] = [];
-  const warnings: SelectionWarning[] = [];
-
-  for (const exp of experiments) {
-    // 逐题取最新:快照按最新在前,首个出现即最新判决
-    const taken = new Map<string, { ev: Eval; snapshot: Snapshot }>();
-    for (const snapshot of exp.snapshots) {
-      for (const ev of snapshot.evals) {
-        if (!match(ev.id) || taken.has(ev.id)) continue;
-        taken.set(ev.id, { ev, snapshot });
-      }
-    }
-    if (taken.size === 0) continue;
-
-    const picks = [...taken.values()].sort((a, b) => a.ev.id.localeCompare(b.ev.id));
-    let startedAt = "";
-    let newest: Snapshot = picks[0].snapshot;
-    for (const pick of picks) {
-      if (pick.snapshot.startedAt > startedAt) {
-        startedAt = pick.snapshot.startedAt;
-        newest = pick.snapshot;
-      }
-    }
-    const evals = picks.map((p) => p.ev);
-    const base = exp.latest;
-    snapshots.push({
-      experimentId: exp.id,
-      startedAt,
-      agent: base.agent,
-      ...(base.model !== undefined ? { model: base.model } : {}),
-      ...(base.producer ? { producer: base.producer } : {}),
-      schemaVersion: base.schemaVersion,
-      evals,
-      attempts: evals.flatMap((ev) => ev.attempts),
-      runDir: newest.runDir,
-      ...(base.synthetic ? { synthetic: true } : {}),
-      ...(base.knownEvalIds ? { knownEvalIds: [...base.knownEvalIds] } : {}),
-    });
-
-    // 残缺检测:跨 run 补齐后仍缺,只可能是历史上见过(或 knownEvalIds 声明过)
-    // 却从未在可读落盘里出现的题 —— 分母收窄到范围内,不让范围外的缺口刷屏。
-    const total = exp.evalIds.filter(match).length;
-    if (evals.length < total) {
-      const hint = base.synthetic
-        ? "re-run the experiment for a full snapshot"
-        : `re-run \`niceeval exp ${exp.id}\` for a full snapshot`;
-      warnings.push({
-        kind: "partial-coverage",
-        experimentId: exp.id,
-        covered: evals.length,
-        total,
-        message: `verdicts cover ${evals.length} of ${total} evals seen in history; ${hint}`,
-      });
-    }
-  }
-
-  let latestStartedAt = "";
-  for (const snapshot of snapshots) {
-    if (snapshot.startedAt > latestStartedAt) latestStartedAt = snapshot.startedAt;
-  }
-  for (const snapshot of snapshots) {
-    if (snapshot.startedAt < latestStartedAt) {
-      warnings.push({
-        kind: "stale-snapshot",
-        experimentId: snapshot.experimentId,
-        startedAt: snapshot.startedAt,
-        latestStartedAt,
-        message: `verdicts for "${snapshot.experimentId}" were produced at ${snapshot.startedAt}, before the latest run in this selection (${latestStartedAt})`,
-      });
-    }
-    if (snapshot.synthetic) {
-      warnings.push({
-        kind: "synthetic-experiment-id",
-        experimentId: snapshot.experimentId,
-        runDir: snapshot.runDir.dir,
-        message: `run "${snapshot.runDir.dir}" has results without experimentId; grouped as "${snapshot.experimentId}" by agent/model`,
-      });
-    }
-  }
-
-  return makeSelection(snapshots, warnings);
-}
+import type { Verdict } from "../types.ts";
+import type { AttemptHandle, Experiment } from "../results/index.ts";
 
 // ───────────────────────── 时间轴(--history)─────────────────────────
 
 export interface EvalHistoryRow {
   /** 该次真实执行所在 run(快照)的时刻。 */
   startedAt: string;
-  outcome: ResultOutcome;
+  verdict: Verdict;
   attempts: number;
   costUSD: number | null;
   /** 最新一次 attempt 的第一条失败断言("gate calledTool(...)")。 */
@@ -151,7 +31,7 @@ function attemptKey(attempt: AttemptHandle): string | undefined {
 
 /**
  * 单 eval 的跨 run 时间轴:每次真实执行一行,新→旧。--resume 携带的复印件
- * (身份键与原判决相同的条目)不占行 —— 否则趋势会被复印件灌满假数据。
+ * (身份键与原判定相同的条目)不占行 —— 否则趋势会被复印件灌满假数据。
  */
 export function evalHistory(exp: Experiment, evalId: string): EvalHistoryRow[] {
   const rows: EvalHistoryRow[] = [];
@@ -171,7 +51,7 @@ export function evalHistory(exp: Experiment, evalId: string): EvalHistoryRow[] {
       seen.add(key);
       fresh.push(attempt);
     }
-    if (fresh.length === 0) continue; // 纯复印件:判决在更早的行里已经出现过
+    if (fresh.length === 0) continue; // 纯复印件:判定在更早的行里已经出现过
     let cost: number | null = null;
     for (const attempt of fresh) {
       const c = attemptCostUSD(attempt.result);
@@ -181,7 +61,7 @@ export function evalHistory(exp: Experiment, evalId: string): EvalHistoryRow[] {
     const failed = latest.result.assertions.find((a) => !a.passed);
     rows.push({
       startedAt: snapshot.startedAt,
-      outcome: foldEvalOutcome(fresh.map((a) => a.result)),
+      verdict: foldEvalVerdict(fresh.map((a) => a.result)),
       attempts: fresh.length,
       costUSD: cost,
       ...(failed ? { failedAssertion: `${failed.severity} ${failed.name}` } : {}),
@@ -203,7 +83,7 @@ export function experimentHistory(exp: Experiment): ExperimentHistoryRow[] {
   return exp.snapshots.map((snapshot) => {
     let passed = 0;
     for (const ev of snapshot.evals) {
-      if (foldEvalOutcome(ev.attempts.map((a) => a.result)) === "passed") passed += 1;
+      if (foldEvalVerdict(ev.attempts.map((a) => a.result)) === "passed") passed += 1;
     }
     let cost: number | null = null;
     for (const attempt of snapshot.attempts) {

package/src/show/index.ts

@@ -1,53 +1,72 @@
 // niceeval show —— 终端宿主(行为规范:docs-site/zh/guides/viewing-results.mdx;
-// 宿主组合语义:docs/reports.md「宿主输入的组合语义」)。
+// 宿主组合语义:docs/feature/reports/architecture.md「Selection 是计算入口」)。
 //
-// 位置参数 = eval id 前缀(选「看哪些 eval」),flag 选「看哪个切面」:
-//   裸跑 / 前缀       报告槽 —— 内置默认报告的 text 面(show ≡ show --report <内置默认报告>)
+// 位置参数 = eval id 前缀,或 `@<locator>`(精确指名单个 attempt,见 results/locator.ts):
+//   裸跑 / 前缀       show 专用的紧凑 attempt 索引(单 eval 前缀仍进入详情)
 //   恰好一个 eval     单 eval 详情(attempt / 断言明细,宿主本体)
-//   --transcript / --trace / --diff[=路径]   证据切面(宿主本体):出现即走证据室,不渲染报告槽
+//   @<locator>        精确 attempt:无证据 flag → 紧凑全景;带 flag → 对应证据切面
+//   --eval / --execution / --diff[=路径]   证据切面(宿主本体):出现即走证据室,不渲染报告槽
 //   --history        跨 run 时间轴(内置趋势视图),与 --report 互斥
-//   --report <文件>  整槽换成用户报告;位置前缀 / --run / --experiment 先收窄选集再注入
-//   --run <目录>     结果根换成该目录;--experiment 选集只留该实验;--attempt 指定详情/证据的 attempt
+//   --report <文件>  整槽换成用户报告;位置前缀 / --run / --experiment 先收窄 Selection 再注入
+//   --run <目录>     结果根换成该目录;--experiment Selection 只留该实验
 //
-// 数据全部走 niceeval/results 的读取面(openResults + 合成选集),不自己爬目录。
+// 数据全部走 niceeval/results 的读取面(openResults + 合成 Selection + loadAttemptEvidence),
+// 不自己爬目录、不自己重算证据 capability。
 
 import { existsSync } from "node:fs";
 import { join, resolve } from "node:path";
-import { openResults, type AttemptRef, type Results } from "../results/index.ts";
-import { defineReport, renderReportToText, type ReportDefinition } from "../report/report.ts";
-import { ReportLoadError, loadReportFile } from "../report/load.ts";
-import { DefaultReport } from "../report/default-report.tsx";
-import { t } from "../i18n/index.ts";
 import {
-  composeShowSelection,
-  evalHistory,
-  experimentHistory,
-  filterExperiments,
-} from "./compose.ts";
+  openResults,
+  resolveLocator,
+  loadAttemptEvidence,
+  ATTEMPT_LOCATOR_PREFIX,
+  LocatorNotFoundError,
+  MalformedLocatorError,
+} from "../results/index.ts";
+// report.ts / load.ts have no JSX of their own, but ReportDefinition / ReportLoadError must
+// come from the SAME module instance CostPassRateComparison (built-ins, .tsx) is built
+// against — `unique symbol` branding and `instanceof` are keyed by declaration site, so a raw
+// src copy and the compiled dist copy of "the same" ReportDefinition are, to TypeScript and to
+// `instanceof`, two different types. The package-owned report runtime ships as precompiled
+// ESM (dist/report/**, built by `pnpm run build:report`, immune to a consumer's cwd/tsconfig
+// when niceeval is linked in — see tsconfig.report-build.json); show pulls all of it from
+// there, not just the .tsx-touching pieces.
+import { renderReportToText } from "../../dist/report/report.js";
+import { ReportLoadError, loadReportFile } from "../../dist/report/load.js";
+import { detectLocale, t } from "../i18n/index.ts";
+import { foldEvalVerdict } from "../shared/verdict.ts";
+import { selectCurrentResults, filterExperiments } from "../results/select.ts";
+import { evalHistory, experimentHistory } from "./compose.ts";
 import {
   attemptArtifactsPath,
+  attemptEvidenceHeader,
+  attemptIndexLine,
+  attemptOverviewText,
   attemptsOfEval,
+  cheapCapabilities,
   diffText,
-  displayAttemptNumber,
   evalDetailText,
   evalHistoryText,
+  evalSourceText,
+  executionText,
   experimentHistoryText,
   pickDetailAttempt,
-  traceText,
-  transcriptText,
+  skippedRunsText,
+  showIndexText,
+  verdictReasonLine,
 } from "./render.ts";
 
 export interface ShowFlags {
-  transcript?: boolean;
-  trace?: boolean;
+  /** 该 attempt 运行时保存的 Eval 源码,断言标回源码行(证据切面)。 */
+  eval?: boolean;
+  /** 该 attempt 的标准执行事件流 + OTel enrichment(证据切面)。 */
+  execution?: boolean;
   /** --diff(文件级摘要)。 */
   diff?: boolean;
   /** --diff=<路径>(单个文件的完整改动;路径必须 = 连写,位置参数永远留给 eval id 前缀)。 */
   diffPath?: string;
   history?: boolean;
   experiment?: string;
-  /** 人看的 1 计序号(详情块显示的 attempt 3 就传 3)。 */
-  attempt?: number;
   run?: string;
   report?: string;
 }
@@ -63,33 +82,13 @@ export interface ShowIO {
 /** 可预期的用户错误:打一句英文直说问题与下一步,退出码 1,不抛堆栈。 */
 class ShowError extends Error {}
 
-/** 内置默认报告:报告槽的出厂填充 —— `niceeval show` ≡ `show --report <这一份>`。 */
-const builtinDefaultReport: ReportDefinition = defineReport(() => ({
-  type: DefaultReport,
-  props: {},
-}));
-
 function clampWidth(columns: number | undefined): number {
   if (!Number.isFinite(columns) || (columns ?? 0) <= 0) return 80;
   return Math.max(40, Math.min(columns as number, 160));
 }
 
 // --report 的装载移到中性模块(两个宿主共用),show 的导出面与错误行为不变。
-export { loadReportFile } from "../report/load.ts";
-
-/** 报告里的下钻命令:AttemptRef → `niceeval show <eval id>`(查不到时退 view 深链)。 */
-function makeAttemptCommand(results: Results): (ref: AttemptRef) => string {
-  const byRef = new Map<string, string>();
-  for (const run of results.runDirs) {
-    for (const attempt of run.attempts) {
-      byRef.set(`${attempt.ref.run}/${attempt.ref.result}`, attempt.evalId);
-    }
-  }
-  return (ref) => {
-    const id = byRef.get(`${ref.run}/${ref.result}`);
-    return id !== undefined ? `niceeval show ${id}` : `niceeval view "#/attempt/${ref.run}/${ref.result}"`;
-  };
-}
+export { loadReportFile } from "../../dist/report/load.js";
 
 export async function runShow(
   cwd: string,
@@ -122,9 +121,9 @@ async function show(
   flags: ShowFlags,
   io: { out: (s: string) => void; err: (s: string) => void; width: number; now: number },
 ): Promise<void> {
-  const evidence = flags.transcript === true || flags.trace === true || flags.diff === true || flags.diffPath !== undefined;
+  const evidence = flags.eval === true || flags.execution === true || flags.diff === true || flags.diffPath !== undefined;
 
-  // 组合语义矩阵(docs/reports.md):--history 与 --report 互斥,先于任何 IO 报出来。
+  // 组合语义矩阵(docs/feature/reports/show.md「选择结果范围」):--history 与 --report 互斥,先于任何 IO 报出来。
   if (flags.history && flags.report !== undefined) {
     throw new ShowError(t("cli.show.historyReportConflict"));
   }
@@ -136,13 +135,47 @@ async function show(
 
   const results = await openResults(root);
   if (results.experiments.length === 0) {
-    const skipped =
-      results.skipped.length > 0
-        ? `\n${results.skipped.map((s) => `  skipped ${s.dir} (${s.reason})`).join("\n")}\n`
-        : "";
+    const skipped = results.skipped.length > 0 ? `\n${skippedRunsText(results.skipped, root, cwd)}\n` : "";
     throw new ShowError(t("cli.show.noResults", { root }) + skipped);
   }
 
+  // `@<locator>` 位置参数:身份直达单个 attempt,与 eval id 前缀匹配完全不同的语义
+  // (`@` 打头对 eval id 天然无歧义,见 locator.ts),必须在下面的前缀匹配逻辑之前分流掉,
+  // 不然 "@1x7f3q" 会被当成一个谁都匹配不到的 eval id 前缀,报「no eval match」这种文不对题的
+  // 错误。这一步只解析并渲染出「当前 show 对单个已解析 attempt 能渲染的东西」(单 eval 详情 /
+  // 三个证据切面)——真正的 `--eval`/`--execution`/`--diff` 统一 attempt 全景是后续阶段。
+  const locatorArg = patterns.find((p) => p.startsWith(ATTEMPT_LOCATOR_PREFIX));
+  if (locatorArg !== undefined) {
+    if (patterns.length !== 1) {
+      throw new ShowError(
+        `An attempt locator ("${locatorArg}") must be the only positional argument; got ${patterns.length}: ${patterns.join(", ")}.`,
+      );
+    }
+    let attempt;
+    try {
+      attempt = resolveLocator(results, locatorArg);
+    } catch (e) {
+      if (e instanceof MalformedLocatorError) throw new ShowError(t("cli.show.locatorMalformed", { message: e.message }));
+      if (e instanceof LocatorNotFoundError) throw new ShowError(t("cli.show.locatorNotFound", { message: e.message }));
+      throw e;
+    }
+    const attemptEvidence = await loadAttemptEvidence(attempt);
+    const header = attemptEvidenceHeader(attemptEvidence);
+    const artifactPath = attemptArtifactsPath(attempt, cwd);
+    if (evidence) {
+      const blocks: string[] = [];
+      if (flags.eval) blocks.push(evalSourceText(attemptEvidence, { header, artifactPath, width: io.width }));
+      if (flags.execution) blocks.push(executionText(attemptEvidence, { header, artifactPath, width: io.width }));
+      if (flags.diff || flags.diffPath !== undefined) {
+        blocks.push(diffText({ header, diff: attemptEvidence.diff, artifactPath, file: flags.diffPath }));
+      }
+      io.out(blocks.join("\n\n") + "\n");
+      return;
+    }
+    io.out(attemptOverviewText(attemptEvidence, { header, artifactPath, width: io.width }) + "\n");
+    return;
+  }
+
   if (flags.experiment !== undefined && filterExperiments(results.experiments, flags.experiment).length === 0) {
     throw new ShowError(
       t("cli.show.noExperimentMatch", {
@@ -152,7 +185,7 @@ async function show(
     );
   }
 
-  const selection = composeShowSelection(results, { experiment: flags.experiment, patterns });
+  const selection = selectCurrentResults(results, { experiment: flags.experiment, patterns });
   const matchedEvalIds = [
     ...new Set(selection.snapshots.flatMap((s) => s.evals.map((e) => e.id))),
   ].sort();
@@ -169,31 +202,36 @@ async function show(
   // 证据切面是宿主本体:出现即走证据室,不渲染报告槽(与默认报告同规则)。
   if (evidence) {
     if (matchedEvalIds.length !== 1) {
-      throw new ShowError(t("cli.show.evidenceNeedsEval", { matched: matchedEvalIds.length }));
+      // 撞多个 eval 时不止说「有几个」,直接给紧凑索引(locator + capability 字母 + 失败原因)
+      // 让 agent 一步摘到 `@<locator>`,不必再跑一轮 `show <eval id>` 才知道选谁。
+      const index = matchedEvalIds
+        .map((evalId) => {
+          const attempts = attemptsOfEval(selection.snapshots, evalId);
+          const rep = pickDetailAttempt(attempts);
+          const verdict = foldEvalVerdict(attempts.map((a) => a.result));
+          return attemptIndexLine({
+            evalId,
+            verdict,
+            locator: rep?.locator,
+            capabilities: rep ? cheapCapabilities(rep.result) : { eval: false, execution: false, timing: false, diff: false },
+            reason: rep ? verdictReasonLine(rep.result) : undefined,
+          });
+        })
+        .join("\n");
+      throw new ShowError(t("cli.show.evidenceNeedsEval", { matched: matchedEvalIds.length, index }));
     }
     const evalId = matchedEvalIds[0];
     const attempts = attemptsOfEval(selection.snapshots, evalId);
-    const picked = pickDetailAttempt(attempts, flags.attempt);
-    if (!picked) {
-      throw new ShowError(
-        t("cli.show.attemptNotFound", {
-          attempt: flags.attempt ?? "?",
-          evalId,
-          available: attempts.map((a) => displayAttemptNumber(a)).join(", ") || "(none)",
-        }),
-      );
-    }
-    const header = `attempt ${displayAttemptNumber(picked)} · ${picked.experimentId} · ${picked.result.outcome}`;
+    const picked = pickDetailAttempt(attempts);
+    if (!picked) throw new Error(`internal error: eval "${evalId}" matched by selection but has no attempts`);
+    const attemptEvidence = await loadAttemptEvidence(picked);
+    const header = attemptEvidenceHeader(attemptEvidence);
     const artifactPath = attemptArtifactsPath(picked, cwd);
     const blocks: string[] = [];
-    if (flags.transcript) {
-      blocks.push(transcriptText({ header, events: await picked.events(), artifactPath, width: io.width }));
-    }
-    if (flags.trace) {
-      blocks.push(traceText({ header, spans: await picked.trace(), artifactPath, width: io.width }));
-    }
+    if (flags.eval) blocks.push(evalSourceText(attemptEvidence, { header, artifactPath, width: io.width }));
+    if (flags.execution) blocks.push(executionText(attemptEvidence, { header, artifactPath, width: io.width }));
     if (flags.diff || flags.diffPath !== undefined) {
-      blocks.push(diffText({ header, diff: await picked.diff(), artifactPath, file: flags.diffPath }));
+      blocks.push(diffText({ header, diff: attemptEvidence.diff, artifactPath, file: flags.diffPath }));
     }
     io.out(blocks.join("\n\n") + "\n");
     return;
@@ -219,20 +257,13 @@ async function show(
     return;
   }
 
-  // 单 eval 详情(宿主本体);--report 在场时报告槽优先,前缀只用来收窄选集。
+  // 单 eval 详情(宿主本体);--report 在场时报告槽优先,前缀只用来收窄 Selection。
+  // 挑哪个 attempt 展开明细不再收数字 --attempt——pickDetailAttempt 的默认启发式
+  // (最新一次失败,没有失败挑最新一次)是唯一路径;精确选某一次走 `@<locator>`。
   if (flags.report === undefined && patterns.length > 0 && matchedEvalIds.length === 1) {
     const evalId = matchedEvalIds[0];
     const attempts = attemptsOfEval(selection.snapshots, evalId);
-    const detail = pickDetailAttempt(attempts, flags.attempt);
-    if (flags.attempt !== undefined && !detail) {
-      throw new ShowError(
-        t("cli.show.attemptNotFound", {
-          attempt: flags.attempt,
-          evalId,
-          available: attempts.map((a) => displayAttemptNumber(a)).join(", ") || "(none)",
-        }),
-      );
-    }
+    const detail = pickDetailAttempt(attempts);
     io.out(
       evalDetailText({
         evalId,
@@ -246,18 +277,18 @@ async function show(
     return;
   }
 
-  if (flags.attempt !== undefined) {
-    // --attempt 只对单 eval 的详情/证据生效;报告槽/榜单下无从对位。
-    throw new ShowError(t("cli.show.attemptNeedsEval"));
+  // 裸 show 是终端诊断索引(docs/feature/reports/show.md),不是 web 默认分析报告的 text 面。
+  // --report 才进入可替换报告槽；view 仍可选择 CostPassRateComparison 作为自己的默认面。
+  // locale = CLI 界面语言(NICEEVAL_LANG / LC_* / LANG 检测):报告 chrome 文案跟随
+  // 终端语言(docs/feature/reports/library.md「locale:渲染面的语言」);Locale 与 ReportLocale 同为
+  // "en" | "zh-CN",直接传递。
+  if (flags.report === undefined) {
+    io.out(showIndexText(selection, io.width) + "\n");
+    return;
   }
-
-  // 报告槽:--report 整槽替换,否则内置默认报告(同一条渲染路径)。
-  const definition =
-    flags.report !== undefined ? await loadReportFile(cwd, flags.report) : builtinDefaultReport;
-  const text = await renderReportToText(
-    definition,
-    { selection, results },
-    { width: io.width, attemptCommand: makeAttemptCommand(results) },
-  );
+  const definition = await loadReportFile(cwd, flags.report);
+  // attemptCommand 留给 renderReportToText 的默认值:AttemptLocator 已经是可直接 `niceeval show
+  // @<locator>` 的真实 CLI 语法,不需要再反查 eval id 拼一条近似命令(见 tree.ts 的默认实现)。
+  const text = await renderReportToText(definition, { selection, results }, { width: io.width, locale: detectLocale() });
   io.out(text + "\n");
 }