niceeval 0.9.0 → 0.9.1

package/src/view/data.ts

@@ -20,6 +20,7 @@ import {
   type HostReportAsset,
 } from "../show/report-host.ts";
 import { selectCurrentResults, filterExperiments } from "../results/select.ts";
+import { evalPrefixPredicate } from "../shared/aggregate.ts";
 import type { EvalResult } from "../types.ts";
 import type {
   SkippedRunNotice,
@@ -61,9 +62,9 @@ export interface ViewScan {
 
 /** view 宿主输入的组合语义(与 show 对齐,docs/feature/reports/architecture.md「Scope 是计算入口」)。 */
 export interface ViewScanOptions {
-  /** eval id 前缀(位置参数):收窄报告槽 Scope;证据室(快照明细)不收窄,深链恒可达。 */
+  /** eval id 前缀(位置参数):把根滤成有效根,页面 Scope 与证据(快照明细、artifact 清单)一致收窄。 */
   patterns?: string[];
-  /** experiment id 前缀(--experiment):Scope 只留该实验。 */
+  /** experiment id 前缀(--exp):有效根只留匹配实验。 */
   experiment?: string;
   /** --report 报告文件:相对 cwd 的路径。装载失败抛 ReportLoadError(CLI 打印后退出)。 */
   report?: { path: string; cwd: string };
@@ -175,10 +176,12 @@ export async function loadLatestResultsPerEval(root = ".niceeval"): Promise<Eval
 /**
  * `niceeval view` 的数据装载入口:server 每次请求现读现算,`--out` 导出用同一份。
  * 报告槽 Selection 恒经 selectCurrentResults 合成(现刻水位;与 `niceeval show` 调同一个
- * 函数,裸跑与局部收窄不分叉),位置前缀 / --experiment 只作为 scope 传入,不切换选择口径。
+ * 函数,裸跑与局部收窄不分叉),位置前缀 / --exp 只作为 scope 传入,不切换选择口径。
  * --report 本身不改挑选——它只换报告槽的填充,注入的 Selection 与裸跑同一份,
  * 「裸跑 ≡ --report <ExperimentComparison>」靠这条成立(docs/feature/reports/architecture.md「Selection 是计算入口」)。
- * 证据室数据(快照明细 / skipped)恒为全量,深链在任何收窄下都可达。
+ * 命令行收窄作用在有效根上(docs/feature/reports/view.md 开篇):证据室数据与 artifact 清单
+ * 与页面一致地只含收窄后的范围,本地与导出无分叉——收窄导出的站点(烘进 HTML 的数据、
+ * 证据文件)只含收窄到的内容。收窄之内、不在现刻水位里的历史 attempt 仍在有效根里,深链可达。
  * 零可读结果一律抛 ViewInputError,不渲染/导出空页面(server 起不来,--out 非零退出)。
  */
 export async function loadViewScan(input?: string, opts: ViewScanOptions = {}): Promise<ViewScan> {
@@ -228,6 +231,12 @@ export async function loadViewScan(input?: string, opts: ViewScanOptions = {}):
   // 静态渲染成 HTML(en / zh-CN 各一遍,切界面语言不重算数据)。
   const slot = await renderReportSlot(opts.report, opts.page, results, selection, opts.pageFailure ?? "throw");
 
+  // 有效根:命令行收窄把根滤成只含匹配实验与 attempt(docs/feature/reports/view.md 开篇)。
+  // 证据室数据与 artifact 清单从这里取数,与页面 Scope 一致收窄——本地与导出无分叉,
+  // 收窄导出的站点(烘进 HTML 的数据、证据文件)只含收窄后的范围。
+  const scopedExperiments = filterExperiments(results.experiments, opts.experiment);
+  const matchEval = patterns.length > 0 ? evalPrefixPredicate(patterns) : () => true;
+
   // 跨快照按身份键去重:--resume 携带的条目在多份落盘里重复,只保留最新快照里的那份
   // (与官方计算函数的聚合口径一致,Runs / Traces 的计数因此不被复印件灌票)。
   const artifactDirs = new Map<string, string>();
@@ -236,13 +245,15 @@ export async function loadViewScan(input?: string, opts: ViewScanOptions = {}):
   // 与报告槽 Selection(现刻水位,可能合成自更早快照)是两个独立概念,不混用。
   const latestSet = new Set(latestPerExperiment.snapshots);
   const allAttempts: AttemptHandle[] = [];
-  for (const exp of results.experiments) {
-    for (const snap of exp.snapshots) allAttempts.push(...snap.attempts);
+  for (const exp of scopedExperiments) {
+    for (const snap of exp.snapshots) allAttempts.push(...snap.attempts.filter((a) => matchEval(a.evalId)));
   }
   const survivors = new Set(dedupeAttempts(allAttempts).attempts);
 
   const snapshots: ViewSnapshot[] = [];
-  for (const exp of results.experiments) {
+  for (const exp of scopedExperiments) {
+    // 整个实验没有匹配 eval 时不携带:有效根里没有它,连快照元数据也不烘进页面。
+    if (patterns.length > 0 && !exp.evalIds.some((id) => matchEval(id))) continue;
     for (const snap of exp.snapshots) {
       const kept = snap.attempts.filter((a) => survivors.has(a));
       const latest = latestSet.has(snap);
@@ -267,10 +278,10 @@ export async function loadViewScan(input?: string, opts: ViewScanOptions = {}):
     }
   }
 
-  // 全局最新快照(跨全部实验):viewData.lastRunAt 从这里取。页内 hero 的「最后运行」
+  // 全局最新快照(跨有效根内全部实验):viewData.lastRunAt 从这里取。页内 hero 的「最后运行」
   // 显示由 Hero 组件按 heroData(scope) 自己算,不吃这份字段。
   let latestSnapshot: Snapshot | undefined;
-  for (const exp of results.experiments) {
+  for (const exp of scopedExperiments) {
     const candidate = exp.snapshots[0];
     if (!candidate) continue;
     if (!latestSnapshot || candidate.startedAt > latestSnapshot.startedAt) latestSnapshot = candidate;

package/src/view/index.ts

@@ -80,18 +80,8 @@ export async function buildView(opts: ViewOptions = {}): Promise<string> {
       `--out expects a directory, got "${opts.out}". Single-file HTML export was removed: code, transcript and trace views need artifact files next to the page. Export a directory instead (e.g. --out site) and serve it with any static host.`,
     );
   }
-  // --out 与位置参数 / --experiment 互斥(docs/feature/reports/view.md「静态导出」):报告槽收窄
-  // 只影响报告,证据室恒随根完整——允许同用会让发布者误以为站点只含该实验,实际根里全部
-  // attempt 的证据都已出站。按实验收窄发布 = 用 copySnapshots 构建只含它的发布根,再对新根导出。
-  if ((opts.scan?.patterns?.length ?? 0) > 0 || opts.scan?.experiment !== undefined) {
-    throw new ViewInputError(
-      "--out exports the whole results root and cannot be combined with eval prefixes or --experiment.\n" +
-        "To publish a site for one experiment, build a narrower results root and export that:\n" +
-        '  const results = await openResults(".niceeval");\n' +
-        '  await copySnapshots(results.latest().filter((s) => s.experimentId.startsWith("<prefix>/")), "<publish-root>");\n' +
-        "Then: niceeval view --results <publish-root> --out <site>",
-    );
-  }
+  // 位置参数 / --exp 对导出同义于本地:收窄作用在有效根上,出站的页面数据与证据文件
+  // 只含收窄后的范围(docs/feature/reports/view.md「静态导出」:出站的就是收窄到的)。
   // 静态导出保持「任一页失败整体失败」(pageFailure 缺省 "throw"),不产出半套站点。
   const plan = await planSite(opts.input, opts.scan);
   await writeSite(plan, out);

package/src/view/server.ts

@@ -1,8 +1,8 @@
 // HTTP server:把站点管线(site.ts 的 planSite)产出的同一份产物挂在 127.0.0.1 上按路径服务。
 // 这里不携带任何取数或布局知识——查不到清单条目就是 404,与 `--out` 写盘的文件逐字节一致
-// (docs/feature/reports/view.md 开篇;奇偶由 site-parity 测试守护)。宿主语义只有三条,全部
-// 作用在管线输入端:打开首页整份重建(数据永远是盘上最新)、单页渲染失败折成页内错误块
-// (pageFailure: "embed")、报告槽可被位置参数 / --experiment 收窄。
+// (docs/feature/reports/view.md 开篇;奇偶由 site-parity 测试守护)。宿主语义只有两条,全部
+// 作用在管线之外:打开首页整份重建(数据永远是盘上最新)、单页渲染失败折成页内错误块
+// (pageFailure: "embed")。位置参数 / --exp 收窄是管线输入,不是宿主语义——两宿主同义。
 
 import { createServer, type Server } from "node:http";
 import { type ViewScanOptions } from "./data.ts";
@@ -13,7 +13,7 @@ export interface ViewOptions {
   input?: string;
   out?: string;
   port?: number;
-  /** 报告槽的组合语义(位置前缀 / --experiment / --report),透传给站点管线。 */
+  /** 站点管线的组合语义(位置前缀 / --exp 收窄有效根,--report 换报告槽),透传给管线。 */
   scan?: ViewScanOptions;
 }
 

package/src/view/styles.css

@@ -73,7 +73,24 @@ a { color: inherit; }
   z-index: 10;
   backdrop-filter: blur(10px);
 }
-/* 页头无品牌位:品牌是页内组件(PoweredBy / Hero 的品牌行,nre-powered-by),宿主不渲染。 */
+/* 页头左端的恒定品牌位:NiceEval 字标 + 45° 方块 mark,外链官网(App.tsx 的 .brand)。
+   与 hero 下 nre-powered-by 品牌行同族,由宿主渲染、报告定义不能覆盖或移除。 */
+.brand {
+  display: flex;
+  align-items: baseline;
+  gap: 12px;
+  font-weight: 690;
+  font-size: 20px;
+  flex: 0 0 auto;
+  text-decoration: none;
+}
+.mark {
+  width: 18px;
+  height: 18px;
+  border: 1.25px solid var(--text);
+  transform: rotate(45deg);
+  display: inline-block;
+}
 /* 顶部导航 .nav / .nav-tab → components/ui/tabs.tsx(Radix Tabs + Tailwind utilities)。 */
 .lang-switch {
   display: inline-flex;

package/src/view/view-report.test.ts

@@ -2,7 +2,7 @@
 // niceeval view 的报告槽与宿主组合语义(docs/feature/reports/architecture.md「Selection 是计算入口」
 // 与裁决记录 6;公开行为准绳 docs-site/zh/how-to/viewing-results.mdx / custom-reports.mdx)。
 // 覆盖:
-// - 组合语义与 show 对齐:位置前缀收窄报告槽 Scope、--experiment 过滤、匹配不到直说;
+// - 组合语义与 show 对齐:位置前缀收窄报告槽 Scope、--exp 过滤、匹配不到直说;
 // - 输入语义:位置参数只表示 eval id 前缀(不随文件系统状态改变),结果根走 --results,
 //   单开一份快照走 --snapshot(文件不可读时失败);
 // - 报告槽恒在:裸跑填充内建报告,--report 整槽替换;en / zh-CN 双语各渲染一遍;
@@ -162,7 +162,7 @@ function bareReportHtml(scan: ViewScan): { en: string; "zh-CN": string } {
 // ───────────────────────── 组合语义(与 show 对齐) ─────────────────────────
 
 describe("loadViewScan · 组合语义", () => {
-  it("位置前缀收窄对全部页生效(含内建 Attempts 页);attempt 详情路由对完整结果根解析,被滤掉的深链仍可达", async () => {
+  it("位置前缀收窄作用在有效根上:全部页与证据室一致缩小,被滤掉的 attempt 不烘进页面数据", async () => {
     const root = await seedRoot();
     const scan = await loadViewScan(root, { patterns: ["weather"] });
     const { viewData } = scan;
@@ -176,16 +176,22 @@ describe("loadViewScan · 组合语义", () => {
     expect(pageHtml(scan, "traces").en).not.toContain("fixtures/button");
     const bare = await loadViewScan(root);
     expect(pageHtml(bare, "attempts").en).toContain("fixtures/button"); // 不收窄时在场,对照
-    // attempt 详情路由不是页:viewData.snapshots 全量通道保留,被滤掉的 attempt 深链仍解析成功。
+    // 有效根即证据室:被滤掉的 attempt 不在 viewData.snapshots 里,深链两宿主一致不可达。
     const filteredOut = viewData.snapshots
       .flatMap((s) => s.results)
       .find((r) => r.id === "fixtures/button");
-    expect(filteredOut?.locator).toBeTruthy();
+    expect(filteredOut).toBeUndefined();
+    expect(scan.artifactDirs.size).toBe(
+      [...scan.artifactDirs.keys()].filter((base) => base.includes("weather/brooklyn")).length,
+    );
+    // 收窄之内、不在现刻水位的口径差异由 --exp 深链测试覆盖;不收窄时深链照常可达,对照:
+    const inBare = bare.viewData.snapshots.flatMap((s) => s.results).find((r) => r.id === "fixtures/button");
+    expect(inBare?.locator).toBeTruthy();
     const { resolveAttemptLocator } = await import("./app/lib/attempt-route.ts");
-    expect(resolveAttemptLocator(viewData.snapshots, filteredOut!.locator!)).toBe(filteredOut);
+    expect(resolveAttemptLocator(bare.viewData.snapshots, inBare!.locator!)).toBe(inBare);
   });
 
-  it("--experiment 过滤:报告槽 Selection 只留该实验", async () => {
+  it("--exp 过滤:报告槽 Selection 只留该实验", async () => {
     const root = await seedRoot();
     const reportHtml = bareReportHtml(await loadViewScan(root, { experiment: "compare/codex" }));
     expect(reportHtml.en).toContain("compare/codex");
@@ -468,18 +474,41 @@ describe("buildView · --out 与 --report", () => {
     expect(existsSync(join(exported, "o11y.json"))).toBe(false);
   });
 
-  it("--out 与位置参数 / --experiment 互斥:报错含 copySnapshots + filter 下一步", async () => {
+  it("--out 接受收窄,出站的就是收窄到的:被滤掉实验的证据文件与页面数据都不出站", async () => {
     const root = await seedRoot();
+    // 两个实验各写一份 events.json:导出后只有收窄内的那份在站里。
+    const bubDir = join(root, "compare_bub", "2026-07-08T10-00-00-000Z", "weather", "brooklyn", "a0");
+    const codexDir = join(root, "compare_codex", "2026-07-09T10-00-00-000Z", "weather", "brooklyn", "a0");
+    for (const dir of [bubDir, codexDir]) {
+      await mkdir(dir, { recursive: true });
+      await writeFile(join(dir, "events.json"), "[]", "utf-8");
+    }
+
     const out = join(root, "site");
-    for (const scan of [{ patterns: ["weather"] }, { experiment: "compare/bub" }]) {
-      const attempt = buildView({ input: root, out, scan });
-      await expect(attempt).rejects.toBeInstanceOf(ViewInputError);
-      await expect(
-        buildView({ input: root, out, scan }),
-      ).rejects.toThrow(/copySnapshots/);
+    await buildView({ input: root, out, scan: { patterns: [], experiment: "compare/codex" } });
+    expect(existsSync(join(out, "artifact", "compare_codex/2026-07-09T10-00-00-000Z/weather/brooklyn/a0", "events.json"))).toBe(true);
+    // 被滤掉的实验:证据树整目录不出站,页面数据(烘进 HTML 的 viewData 与报告块)也不含它。
+    expect(existsSync(join(out, "artifact", "compare_bub"))).toBe(false);
+    const html = await readFile(join(out, "index.html"), "utf-8");
+    expect(html).not.toContain("compare/bub");
+    expect(html).toContain("compare/codex");
+  });
+
+  it("eval 前缀收窄导出:不匹配 attempt 的证据不出站", async () => {
+    const root = await seedRoot();
+    const weatherDir = join(root, "compare_bub", "2026-07-08T10-00-00-000Z", "weather", "brooklyn", "a0");
+    const buttonDir = join(root, "compare_bub", "2026-07-08T10-00-00-000Z", "fixtures", "button", "a0");
+    for (const dir of [weatherDir, buttonDir]) {
+      await mkdir(dir, { recursive: true });
+      await writeFile(join(dir, "events.json"), "[]", "utf-8");
     }
-    // 同参数不带 --out 时照常收窄报告槽(不报错)。
-    await expect(loadViewScan(root, { patterns: ["weather"] })).resolves.toBeTruthy();
+
+    const out = join(root, "site");
+    await buildView({ input: root, out, scan: { patterns: ["weather"] } });
+    expect(existsSync(join(out, "artifact", "compare_bub/2026-07-08T10-00-00-000Z/weather/brooklyn/a0", "events.json"))).toBe(true);
+    expect(existsSync(join(out, "artifact", "compare_bub/2026-07-08T10-00-00-000Z/fixtures"))).toBe(false);
+    const html = await readFile(join(out, "index.html"), "utf-8");
+    expect(html).not.toContain("fixtures/button");
   });
 
   it("默认导出(无 --report):报告槽填充 ExperimentComparison,双语块与增强 runtime 恒内联", async () => {