niceeval 0.8.1 → 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 = {}):
     }
   }
 
-  // 全局最新快照(跨全部实验):hero 的「最近一次运行」时刻从这里取。
-  // hero 标题不从这里取——它走标题回退链(resolveReportTitle,进 viewData.report.title)。
+  // 全局最新快照(跨有效根内全部实验):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/shared/types.ts

@@ -33,8 +33,9 @@ export interface ViewReportPageMeta {
 /**
  * 规范化后的报告外壳声明(docs/feature/reports/library/shell.md):壳(导航 / 页脚)由前端
  * 渲染,页内容消费 <template> 静态块。title 已走完回退链(def.title → 唯一且相同的快照 name →
- * 内置文案「Eval 运行结果 / Eval Results」),落点是首页 hero 与浏览器标题——页头品牌位恒为
- * NiceEval 字标,不归 title;scripts / styles 是注入资产,不进 viewData。
+ * 内置文案「Eval 运行结果 / Eval Results」),宿主落点只有浏览器 <title>(文档单例);
+ * 页内 hero 标题由 Hero 组件消费同一取值链,品牌是组件、宿主页头不渲染任何品牌位。
+ * scripts / styles 是注入资产,不进 viewData。
  * link 的 icon 是内联 SVG 字符串(原样透传、原样内联),不收组件——viewData 就是序列化边界。
  */
 export interface ViewReportMeta {
@@ -70,7 +71,11 @@ export interface ViewSnapshot {
   results: ViewEvalResult[];
 }
 
-/** 目录扫描里被跳过的 run 在页面顶部的提示条目;三种原因与 niceeval/results 的 skipped 一致。 */
+/**
+ * 目录扫描里被跳过的 run 的结构化条目;三种原因与 niceeval/results 的 skipped 一致。
+ * 页面上的呈现不走它:不可读快照已形成 `unreadable-snapshot` Scope warning,由报告页内的
+ * `ScopeWarnings` 组件显示;这里只随 viewData 携带原始事实。
+ */
 export interface SkippedRunNotice {
   /** run 目录,相对 cwd。 */
   dir: string;
@@ -92,11 +97,11 @@ export interface SkippedRunNotice {
 export interface ViewData {
   /** 最近一次 run 的 startedAt(ISO);没有历史 run 时缺省。 */
   lastRunAt?: string;
-  /** 报告槽 Selection 合成自几个物理 run;hero「合成来源」标注。 */
+  /** 报告槽 Selection 合成自几个物理 run。 */
   composedRuns: number;
-  /** 全部历史快照(跨快照按身份键去重后);修复 prompt 吃 latest,Attempts / Traces 吃全部。 */
+  /** 全部历史快照(跨快照按身份键去重后);attempt 详情路由对这份完整集合解析,不随报告 Scope 收窄。 */
   snapshots: ViewSnapshot[];
-  /** 读不了的落盘(三种原因);前端顶部横幅展示,不静默。 */
+  /** 读不了的落盘(三种原因);呈现走报告页内的 ScopeWarnings(unreadable-snapshot warning)。 */
   skippedRuns?: SkippedRunNotice[];
   /** 报告外壳与页导航的声明(规范化后);缺省时前端按单页 `report` 兜底。 */
   report?: ViewReportMeta;

package/src/view/styles.css

@@ -63,8 +63,8 @@ a { color: inherit; }
   align-items: center;
   justify-content: space-between;
   /* space-between 只在有富余空间时才撑开相邻项;.shell-links 的 margin-left:auto 会把富余
-     空间全部吸收到它左侧,导致品牌与导航贴脸、shell-links 与语言切换贴脸。显式 gap 保证
-     每一对相邻项(品牌—导航、shell-links—语言切换)恒有最小间距,不依赖富余空间。 */
+     空间全部吸收到它左侧,导致相邻项贴脸。显式 gap 保证每一对相邻项(导航—shell-links、
+     shell-links—语言切换)恒有最小间距,不依赖富余空间。 */
   gap: 28px;
   padding: 0 clamp(20px, 5vw, 80px);
   background: color-mix(in oklch, var(--bg), transparent 4%);
@@ -73,12 +73,16 @@ a { color: inherit; }
   z-index: 10;
   backdrop-filter: blur(10px);
 }
+/* 页头左端的恒定品牌位: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;
@@ -121,219 +125,13 @@ main {
   margin: 0 auto;
   padding: clamp(52px, 7vw, 82px) 0 72px;
 }
-.hero {
-  text-align: center;
-  max-width: 740px;
-  margin: 0 auto clamp(38px, 6vw, 58px);
-}
-h1 {
-  margin: 0;
-  font-size: clamp(42px, 5.6vw, 66px);
-  line-height: 0.94;
-  font-weight: 760;
-  letter-spacing: 0;
-}
-.subtitle {
-  margin: 20px auto 0;
-  color: color-mix(in oklch, var(--muted), var(--text) 12%);
-  font-size: clamp(17px, 2vw, 21px);
-  line-height: 1.58;
-  max-width: 660px;
-}
-.meta {
-  display: flex;
-  flex-wrap: wrap;
-  justify-content: center;
-  gap: 14px;
-  margin-top: 24px;
-  color: var(--muted);
-  font-size: 14px;
-}
-.meta b { color: var(--text); font-weight: 570; }
-/* --report 报告槽:server 侧渲染好的静态报告 HTML(nre-* 类的样式随包 styles.css 注入),
-   这里只给槽位留呼吸空间,不覆盖报告自己的样式。 */
+/* 报告槽:server 侧渲染好的静态报告 HTML(nre-* 类的样式随包 styles.css 注入),
+   这里只给槽位留呼吸空间,不覆盖报告自己的样式。hero、警告区、批量修复 prompt 都是
+   页内组件(nre-hero / nre-warnings / nre-copy-fix-prompt),宿主不再有对应 chrome。 */
 .report-slot {
   margin: 0 auto 36px;
 }
-/* schemaVersion 不匹配等读不了的 run:报告槽不解析它们,这里占位提示。同一原因(且文案
-   完全相同)的条目按 SkippedRunsBanner 分组折叠,不逐条重复整句原因 + 命令——那是原实现
-   把首屏挤满、警示色又淡到看不出来的根因。 */
-.incompatible-banner {
-  border: 1px solid color-mix(in oklch, var(--warn), var(--line) 35%);
-  border-left: 3px solid var(--warn);
-  border-radius: 8px;
-  background: color-mix(in oklch, var(--warn), var(--panel) 85%);
-  padding: 12px 16px 14px;
-  margin: 0 auto 36px;
-  font-size: 13px;
-}
-.ib-head {
-  display: flex;
-  align-items: center;
-  gap: 8px;
-}
-.ib-head b { font-weight: 640; }
-.ib-icon {
-  width: 16px;
-  height: 16px;
-  flex-shrink: 0;
-  color: var(--warn);
-  stroke-width: 2;
-}
-.ib-groups {
-  display: grid;
-  gap: 10px;
-  margin-top: 10px;
-}
-.ib-group-head {
-  display: flex;
-  align-items: baseline;
-  gap: 8px;
-}
-.ib-group-count {
-  display: inline-flex;
-  align-items: center;
-  justify-content: center;
-  min-width: 20px;
-  height: 20px;
-  padding: 0 6px;
-  flex-shrink: 0;
-  border-radius: 999px;
-  background: color-mix(in oklch, var(--warn), var(--panel) 72%);
-  color: var(--text);
-  font-size: 11px;
-  font-weight: 640;
-  font-variant-numeric: tabular-nums;
-}
-.ib-group-desc { color: var(--soft); }
-.ib-group ul {
-  margin: 5px 0 0;
-  padding: 0;
-  list-style: none;
-  display: grid;
-  gap: 3px;
-}
-.ib-group li {
-  display: flex;
-  align-items: center;
-  gap: 8px;
-  min-height: 22px;
-}
-.ib-dir {
-  font-family: var(--mono, ui-monospace, monospace);
-  font-weight: 560;
-}
-.ib-more {
-  color: var(--soft);
-  font-size: 12px;
-}
-.ib-copy {
-  display: inline-flex;
-  align-items: center;
-  justify-content: center;
-  width: 22px;
-  height: 22px;
-  flex-shrink: 0;
-  border: 1px solid var(--line);
-  border-radius: 5px;
-  background: var(--panel);
-  color: var(--muted);
-  cursor: pointer;
-  transition: color 0.12s, border-color 0.12s;
-}
-.ib-copy svg { width: 12px; height: 12px; stroke: currentColor; fill: none; stroke-width: 2; }
-.ib-copy:hover { color: var(--text); border-color: var(--line-strong); }
-.ib-copy.is-copied { color: var(--good); border-color: color-mix(in oklch, var(--good), var(--line) 40%); }
-.ib-toggle {
-  display: inline-flex;
-  align-items: center;
-  gap: 4px;
-  margin-top: 10px;
-  border: 0;
-  background: none;
-  color: var(--muted);
-  font: inherit;
-  font-size: 12px;
-  cursor: pointer;
-  padding: 0;
-}
-.ib-toggle svg { width: 12px; height: 12px; transition: transform 0.12s; }
-.ib-toggle svg.is-open { transform: rotate(90deg); }
-.ib-toggle:hover { color: var(--text); }
-
-.section-head {
-  display: flex;
-  align-items: end;
-  justify-content: space-between;
-  gap: 18px;
-  margin-bottom: 16px;
-}
-h2 {
-  margin: 0;
-  font-size: clamp(24px, 2.6vw, 31px);
-  line-height: 1.1;
-  font-weight: 720;
-}
-.controls {
-  display: flex;
-  gap: 8px;
-  align-items: center;
-  flex-wrap: wrap;
-}
-.search {
-  height: 36px;
-  min-width: 320px;
-  border: 1px solid var(--line);
-  border-radius: 7px;
-  padding: 0 12px;
-  background: var(--panel);
-  color: var(--text);
-  outline: none;
-}
-.search:focus { border-color: var(--focus); }
-.table-wrap {
-  border: 1px solid var(--line);
-  border-radius: 8px;
-  overflow: auto;
-  background: var(--panel);
-}
-table {
-  width: 100%;
-  border-collapse: collapse;
-  min-width: 1040px;
-}
-th, td {
-  border-bottom: 1px solid var(--line);
-  padding: 0 16px;
-  height: 52px;
-  text-align: left;
-  vertical-align: middle;
-  font-size: 14px;
-}
-th {
-  color: var(--muted);
-  font-weight: 500;
-  background: var(--panel);
-  position: sticky;
-  top: 0;
-  z-index: 2;
-}
-tbody tr:last-child td { border-bottom: 0; }
-.section-sub-head {
-  display: flex;
-  align-items: center;
-  justify-content: space-between;
-  gap: 18px;
-  margin-bottom: 16px;
-  min-height: 36px;
-}
-.group-detail-label {
-  font-size: 15px;
-  font-weight: 680;
-  color: var(--text);
-}
 .name { font-weight: 610; }
-.sub { color: var(--muted); font-size: 12px; margin-top: 3px; }
 .num {
   font-variant-numeric: tabular-nums;
   white-space: nowrap;
@@ -343,12 +141,6 @@ tbody tr:last-child td { border-bottom: 0; }
 .bad { color: var(--bad); }
 .warn { color: var(--warn); }
 .infra-err { color: var(--warn); }
-.eval-id {
-  display: flex;
-  align-items: center;
-  overflow-wrap: anywhere;
-  font-weight: 560;
-}
 .copy-all-errors {
   height: 36px;
   display: inline-flex;
@@ -702,41 +494,10 @@ pre {
   font-size: 12px;
   line-height: 1.5;
 }
-.empty {
-  border: 1px dashed var(--line-strong);
-  border-radius: 8px;
-  padding: 40px 24px;
-  color: var(--muted);
-  text-align: center;
-  background: var(--panel);
-}
-a.brand { text-decoration: none; color: inherit; }
-a.brand:hover { opacity: 0.75; }
-.traces-entry {
-  border: 1px solid var(--line);
-  border-radius: 8px;
-  background: var(--panel);
-  margin-bottom: 12px;
-  padding: 14px 18px;
-}
-.traces-entry-head {
-  display: flex;
-  align-items: baseline;
-  gap: 12px;
-  margin-bottom: 8px;
-  font-size: 13px;
-}
-.traces-verdict { font-weight: 600; min-width: 52px; }
-.traces-exp { color: var(--muted); flex: 1; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
-.traces-dur { color: var(--soft); }
 @media (max-width: 760px) {
   .topbar { padding: 0 20px; }
   .lang-switch button { min-width: 40px; }
   main { width: min(100vw - 28px, 1120px); padding-top: 42px; }
-  .hero { text-align: left; margin-left: 0; }
-  .meta { justify-content: flex-start; }
-  .section-head { align-items: stretch; flex-direction: column; }
-  .search { width: 100%; min-width: 0; }
   .detail { padding: 18px 16px 20px; }
   .config-strip { gap: 6px; }
   .detail-kpis { grid-template-columns: repeat(2, minmax(0, 1fr)); row-gap: 10px; }
@@ -1194,8 +955,4 @@ li.tnode-row::before { content: ""; width: 4px; flex-shrink: 0; }
   color: var(--soft);
   font-size: 12px;
 }
-/* 品牌行:hero 之下、品牌蓝,恒带官网链接(shell.md「行为约束」)。 */
-.hero .powered-by { display: block; margin-top: 16px; font-size: 12px; }
-.hero .powered-by a { color: var(--blue); text-decoration: none; }
-.hero .powered-by a:hover { text-decoration: underline; }
 .nre-page-error pre { white-space: pre-wrap; }