niceeval 0.5.2 → 0.5.4

package/src/view/data.test.ts

@@ -7,7 +7,7 @@ import { mkdir, mkdtemp, rm, writeFile } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
 import { afterEach, describe, expect, it } from "vitest";
-import { IncompatibleResultsError, loadLatestResultsPerEval, loadViewScan } from "./data.ts";
+import { IncompatibleResultsError, ViewInputError, loadLatestResultsPerEval, loadViewScan } from "./data.ts";
 import { createRunWriter } from "../results/index.ts";
 import { RESULTS_FORMAT, RESULTS_SCHEMA_VERSION, type EvalResult, type RunSummary } from "../types.ts";
 
@@ -182,7 +182,7 @@ describe("loadViewScan · 跨快照去重(--resume 携带的复印件只算一
 });
 
 describe("loadViewScan · createRunWriter 写出的落盘直接可读(writer/reader 同一契约)", () => {
-  it("writer roundtrip:官方榜单、快照与 attemptRef 都从写入面产物算出", async () => {
+  it("writer roundtrip:默认报告、快照与 attemptRef 都从写入面产物算出", async () => {
     const root = await makeRoot();
     const writer = await createRunWriter(root, { producer: { name: "niceeval", version: "0.4.6" } });
     const snap = writer.snapshot({
@@ -252,3 +252,27 @@ describe("loadLatestResultsPerEval(续跑携带基线,口径与旧 loader 一致
     expect(withArtifacts.artifactBase).toBe("2026-01-02T00-00-00/artifacts/e1/a0");
   });
 });
+
+describe("loadViewScan · 零可读结果直说,不渲染空页面", () => {
+  it("目录真空:抛 ViewInputError,给「先跑一轮」提示(与 show 同文案)", async () => {
+    const root = await makeRoot();
+    await expect(loadViewScan(root)).rejects.toBeInstanceOf(ViewInputError);
+    await expect(loadViewScan(root)).rejects.toThrow(/niceeval exp/);
+  });
+
+  it("全被跳过:错误逐条列目录与原因,niceeval 落盘的 schemaVersion 场景给出可跑的 npx 命令", async () => {
+    const root = await makeRoot();
+    await writeRun(root, "2026-07-02T08-00-00-000Z", summaryOf([], { schemaVersion: 999, producer: { name: "niceeval", version: "9.9.9" } }));
+    await writeRun(root, "2026-07-04T08-00-00-000Z", "{not json");
+
+    const err = await loadViewScan(root).then(
+      () => { throw new Error("expected ViewInputError"); },
+      (e) => e as Error,
+    );
+    expect(err).toBeInstanceOf(ViewInputError);
+    expect(err.message).toContain("2 run directories were skipped");
+    expect(err.message).toContain("incompatible-version, schemaVersion 999");
+    expect(err.message).toContain("npx niceeval@9.9.9 view ");
+    expect(err.message).toContain("malformed");
+  });
+});

package/src/view/data.ts

@@ -140,6 +140,7 @@ export async function loadLatestResultsPerEval(root = ".niceeval"): Promise<Eval
  * 位置前缀 / --experiment / --report 在场时,报告槽选集经 composeShowSelection 合成
  * (与 `niceeval show` 同一口径,两扇门判决不分叉);全部缺省时维持 results.latest(),
  * 默认行为不变。证据室数据(快照明细 / skipped)恒为全量,深链在任何收窄下都可达。
+ * 零可读结果一律抛 ViewInputError,不渲染/导出空页面(server 起不来,--out 非零退出)。
  */
 export async function loadViewScan(input?: string, opts: ViewScanOptions = {}): Promise<ViewScan> {
   const target = resolve(input ?? ".niceeval");
@@ -150,9 +151,11 @@ export async function loadViewScan(input?: string, opts: ViewScanOptions = {}):
   const patterns = opts.patterns ?? [];
   const narrowed = patterns.length > 0 || opts.experiment !== undefined || opts.report !== undefined;
 
-  // 组合语义的输入校验,与 show 同文案:匹配不到直说,不渲染一张空页面。
-  if (opts.report && results.experiments.length === 0) {
-    throw new ViewInputError(t("cli.show.noResults", { root: target }).trimEnd());
+  // 零可读结果直说,不渲染/导出一张空页面(与 show 的「匹配不到直说」同一原则;
+  // CI 静态发布还靠这个非零退出保住上一次部署,空报告不顶上线)。零可读最常见的
+  // 根因不是目录空,而是落盘整批 schemaVersion 不兼容被跳过,所以带上 skipped 摘要。
+  if (results.experiments.length === 0) {
+    throw new ViewInputError(noReadableResults(target, results.skipped));
   }
   if (
     opts.experiment !== undefined &&
@@ -248,7 +251,7 @@ export async function loadViewScan(input?: string, opts: ViewScanOptions = {}):
 
 /**
  * 报告槽渲染:装载报告文件(dev server 语义 —— 文件变更下次请求整页重算,经 mtime
- * cache-busting)→ 注入与官方榜单同口径的选集 → web 面 renderToStaticMarkup 成静态 HTML。
+ * cache-busting)→ 注入与默认报告同口径的选集 → web 面 renderToStaticMarkup 成静态 HTML。
  * react-dom 只在 --report 在场时动态加载,默认 CLI 路径不背 react。
  * attemptHref 缺省即 `#/attempt/<run>/<result>`(view 的 attempt 深链路由)。
  */
@@ -318,6 +321,27 @@ function annotateResult(
   return { annotated };
 }
 
+/**
+ * 零可读结果的报错文案。目录真空时给「先跑一轮」的入门提示(与 show 的 noResults 同形态);
+ * 有 skipped 时逐条列目录与原因——schemaVersion 不兼容的 niceeval 落盘给出可跑的
+ * npx 命令,让「全被跳过」和「真没跑过」在错误里就能分清,不用进查看器排查。
+ */
+function noReadableResults(target: string, skipped: SkippedRun[]): string {
+  if (skipped.length === 0) return t("cli.view.noResults", { root: target }).trimEnd();
+  const lines = skipped.map((skip) => {
+    const notice = toSkippedNotice(skip);
+    const version = notice.schemaVersion !== undefined ? `, schemaVersion ${notice.schemaVersion}` : "";
+    const hint = notice.command ? ` — view it with \`${notice.command.trim()}\`` : "";
+    return `  ${notice.dir}: ${notice.reason}${version}${hint}`;
+  });
+  const runs = skipped.length === 1 ? "1 run directory was" : `${skipped.length} run directories were`;
+  return [
+    `No readable results under ${target} — ${runs} skipped:`,
+    ...lines,
+    "Re-run your experiments with this niceeval to produce fresh results.",
+  ].join("\n");
+}
+
 function toSkippedNotice(skip: SkippedRun): SkippedRunNotice {
   const dir = relative(process.cwd(), skip.dir) || ".";
   const command =

package/src/view/shared/types.ts

@@ -72,7 +72,7 @@ export interface ViewData {
   composedRuns: number;
   /** 官方 KPI(RunOverview.data 产物):totals + 选中快照元信息 + 选集 warnings 随行。 */
   overview: OverviewData;
-  /** 官方榜单(MetricTable.data,rows: "experiment"):每个实验最新一次快照的口径。 */
+  /** 默认报告(MetricTable.data,rows: "experiment"):每个实验最新一次快照的口径。 */
   table: TableData;
   /** 整体单行(MetricTable.data,常量维度):hero 的官方通过率,同一台聚合引擎。 */
   overall: TableData;