niceeval 0.11.2 → 0.11.3

package/dist/report/components/site-components/index.d.ts

@@ -19,7 +19,7 @@ export interface HeroProps {
  * 合成物,没有单独的 spec 等价形。web 面渲染 hero 标题(h1)、按渲染 locale 格式化的运行
  * meta(latestStartedAt 为 null 时内置「暂无运行」文案)与品牌行(等同 PoweredBy,恒含、
  * 无拆除 prop);text 面输出标题行与 meta 行,不含品牌行
- * (docs/feature/reports/library/site-components.md「HeroCard」)。
+ * (docs/feature/reports/components/site/hero-card.md)。
  */
 export declare const HeroCard: ReportComponent<HeroCardProps>;
 /** `HeroCard` 的 props:标题 + `heroData()` 的产物,只有 data 形态。 */
@@ -32,14 +32,14 @@ export interface HeroCardProps {
  * `Hero`:页首的站点标题区——标题、最后运行时间、快照合成来源,恒含品牌行。官方组合组件,
  * 与手写 `<HeroCard title={title ?? ctx.report.title} data={await heroData(ctx.scope)} />`
  * 严格等价、没有私有能力;读 `ctx.report` 意味着输出跟随站点,要站点无关的标题区直接用
- * `HeroCard` 显式传值(docs/feature/reports/library/site-components.md「Hero」)。
+ * `HeroCard` 显式传值(docs/feature/reports/components/site/hero.md)。
  */
 export declare const Hero: ReportComponent<HeroProps>;
 /**
  * `PoweredBy`:唯一的品牌件,无 props 双面组件。web 面渲染指向 niceeval 官网的一行品牌色
  * 小字(`utm_source=report&utm_medium=powered-by`,`rel` 仅 `noopener` 以保留 Referer);
  * text 面零输出。没有任何配置——品牌契约是「提供一个组件,不给开关」:不想要品牌就不用
- * 这些组件、自己写替代组件(docs/feature/reports/library/site-components.md「PoweredBy」)。
+ * 这些组件、自己写替代组件(docs/feature/reports/components/site/powered-by.md)。
  */
 export declare const PoweredBy: ReportComponent<Record<never, never>>;
 /** `ScopeWarnings` 的 props:spec 形态取宿主 Scope 的 warnings,data 形态收 `ScopeWarning[]`。 */
@@ -49,7 +49,7 @@ export type ScopeWarningsProps = DataProps<readonly ScopeWarning[], Record<never
  * 按「下一步动作」聚合渲染(带 experimentId 的按实验聚合、非实验作用域按 kind 聚合;
  * 实验作用域组在前、非实验作用域组在后);web 面组头带去重后的可复制命令、明细收原生
  * `<details>`(总条数 ≤ 3 默认展开),text 面同构但不折叠。空警告集与裸 `Snapshot[]` 输入
- * 两面零输出(docs/feature/reports/library/site-components.md「ScopeWarnings」)。
+ * 两面零输出(docs/feature/reports/components/site/sample-warnings.md)。
  */
 export declare const ScopeWarnings: ReportComponent<ScopeWarningsProps>;
 /** `SnapshotDiagnostics` 的 props:spec 形态从宿主 `Scope | Snapshot[]` 投影,data 形态收 `SnapshotDiagnosticsData`。 */
@@ -60,7 +60,7 @@ export type SnapshotDiagnosticsProps = DataProps<SnapshotDiagnosticsData, Record
  * web 面整个区域是默认折叠的原生 `<details>`,`<summary>` 恒可见汇总涉及的 experiment 数、
  * Snapshot 数、记录数(按 count 计数)与最高严重度;单诊断快照退化成一行,不摆空壳层级;
  * text 面同构但不折叠。空诊断集两面零输出
- * (docs/feature/reports/library/site-components.md「SnapshotDiagnostics」)。
+ * (docs/feature/reports/components/site/run-diagnostics.md)。
  */
 export declare const SnapshotDiagnostics: ReportComponent<SnapshotDiagnosticsProps>;
 /** `CopyFixPrompt` 的 props:spec 形态无选项,data 形态收 `copyFixPromptData()` 的产物。 */
@@ -69,7 +69,7 @@ export type CopyFixPromptProps = DataProps<CopyFixPromptData, Record<never, neve
  * `CopyFixPrompt`:把当前范围的全部失败整理成一段可交给 coding agent 的修复 prompt。
  * prompt 在 resolve 阶段算好、烘进静态 HTML,无 JS 时在折叠块里完整可读,「复制」是增强层
  * 行为;`failures` 为 0 时两面零输出;text 面恒零输出——终端里的等价能力是 `show` 的
- * attempt 下钻命令本身(docs/feature/reports/library/site-components.md「CopyFixPrompt」)。
+ * attempt 下钻命令本身(docs/feature/reports/components/site/copy-fix-prompt.md)。
  */
 export declare const CopyFixPrompt: ReportComponent<CopyFixPromptProps>;
 /** `TraceWaterfall` 的 props:spec 形态无选项,data 形态收 `traceWaterfallData()` 的产物。 */
@@ -81,6 +81,6 @@ export type TraceWaterfallProps = DataProps<readonly TraceWaterfallRow[], Record
  * 的原始 span(agent / model / tool)。web 面静态渲染顶层 span 分解条(失败 span 带失败
  * 标记),行链接 attempt 详情;text 面每 attempt 一行(locator、总耗时、span 计数与失败
  * 标记)+ 可复制的 `--timing` 下钻命令。trace 缺失的行照常出现并如实显示缺失;runner
- * 生命周期节点不进瀑布(docs/feature/reports/library/site-components.md「TraceWaterfall」)。
+ * 生命周期节点不进瀑布(docs/feature/reports/components/site/trace-waterfall.md)。
  */
 export declare const TraceWaterfall: ReportComponent<TraceWaterfallProps>;

package/dist/report/components/site-components/index.js

@@ -149,7 +149,7 @@ const assertHeroData = (data) => {
  * 合成物,没有单独的 spec 等价形。web 面渲染 hero 标题(h1)、按渲染 locale 格式化的运行
  * meta(latestStartedAt 为 null 时内置「暂无运行」文案)与品牌行(等同 PoweredBy,恒含、
  * 无拆除 prop);text 面输出标题行与 meta 行,不含品牌行
- * (docs/feature/reports/library/site-components.md「HeroCard」)。
+ * (docs/feature/reports/components/site/hero-card.md)。
  */
 export const HeroCard = defineComponent({
     web: (props, ctx) => {
@@ -166,7 +166,7 @@ HeroCard.displayName = "HeroCard";
  * `Hero`:页首的站点标题区——标题、最后运行时间、快照合成来源,恒含品牌行。官方组合组件,
  * 与手写 `<HeroCard title={title ?? ctx.report.title} data={await heroData(ctx.scope)} />`
  * 严格等价、没有私有能力;读 `ctx.report` 意味着输出跟随站点,要站点无关的标题区直接用
- * `HeroCard` 显式传值(docs/feature/reports/library/site-components.md「Hero」)。
+ * `HeroCard` 显式传值(docs/feature/reports/components/site/hero.md)。
  */
 export const Hero = defineComponent(async ({ title, className }, ctx) => (_jsx(HeroCard, { title: title ?? ctx.report.title, data: await heroData(ctx.scope), className: className })));
 Hero.displayName = "Hero";
@@ -174,7 +174,7 @@ Hero.displayName = "Hero";
  * `PoweredBy`:唯一的品牌件,无 props 双面组件。web 面渲染指向 niceeval 官网的一行品牌色
  * 小字(`utm_source=report&utm_medium=powered-by`,`rel` 仅 `noopener` 以保留 Referer);
  * text 面零输出。没有任何配置——品牌契约是「提供一个组件,不给开关」:不想要品牌就不用
- * 这些组件、自己写替代组件(docs/feature/reports/library/site-components.md「PoweredBy」)。
+ * 这些组件、自己写替代组件(docs/feature/reports/components/site/powered-by.md)。
  */
 export const PoweredBy = defineComponent({
     web: () => _jsx(PoweredByWeb, {}),
@@ -186,7 +186,7 @@ PoweredBy.displayName = "PoweredBy";
  * 按「下一步动作」聚合渲染(带 experimentId 的按实验聚合、非实验作用域按 kind 聚合;
  * 实验作用域组在前、非实验作用域组在后);web 面组头带去重后的可复制命令、明细收原生
  * `<details>`(总条数 ≤ 3 默认展开),text 面同构但不折叠。空警告集与裸 `Snapshot[]` 输入
- * 两面零输出(docs/feature/reports/library/site-components.md「ScopeWarnings」)。
+ * 两面零输出(docs/feature/reports/components/site/sample-warnings.md)。
  */
 export const ScopeWarnings = makeDataComponent({
     name: "ScopeWarnings",
@@ -204,7 +204,7 @@ export const ScopeWarnings = makeDataComponent({
  * web 面整个区域是默认折叠的原生 `<details>`,`<summary>` 恒可见汇总涉及的 experiment 数、
  * Snapshot 数、记录数(按 count 计数)与最高严重度;单诊断快照退化成一行,不摆空壳层级;
  * text 面同构但不折叠。空诊断集两面零输出
- * (docs/feature/reports/library/site-components.md「SnapshotDiagnostics」)。
+ * (docs/feature/reports/components/site/run-diagnostics.md)。
  */
 export const SnapshotDiagnostics = makeDataComponent({
     name: "SnapshotDiagnostics",
@@ -220,7 +220,7 @@ export const SnapshotDiagnostics = makeDataComponent({
  * `CopyFixPrompt`:把当前范围的全部失败整理成一段可交给 coding agent 的修复 prompt。
  * prompt 在 resolve 阶段算好、烘进静态 HTML,无 JS 时在折叠块里完整可读,「复制」是增强层
  * 行为;`failures` 为 0 时两面零输出;text 面恒零输出——终端里的等价能力是 `show` 的
- * attempt 下钻命令本身(docs/feature/reports/library/site-components.md「CopyFixPrompt」)。
+ * attempt 下钻命令本身(docs/feature/reports/components/site/copy-fix-prompt.md)。
  */
 export const CopyFixPrompt = makeDataComponent({
     name: "CopyFixPrompt",
@@ -237,7 +237,7 @@ export const CopyFixPrompt = makeDataComponent({
  * 的原始 span(agent / model / tool)。web 面静态渲染顶层 span 分解条(失败 span 带失败
  * 标记),行链接 attempt 详情;text 面每 attempt 一行(locator、总耗时、span 计数与失败
  * 标记)+ 可复制的 `--timing` 下钻命令。trace 缺失的行照常出现并如实显示缺失;runner
- * 生命周期节点不进瀑布(docs/feature/reports/library/site-components.md「TraceWaterfall」)。
+ * 生命周期节点不进瀑布(docs/feature/reports/components/site/trace-waterfall.md)。
  */
 export const TraceWaterfall = makeDataComponent({
     name: "TraceWaterfall",

package/dist/report/components/site-components/scope-warnings.d.ts

@@ -27,6 +27,6 @@ export declare function warningDetailsLabel(locale: ReportLocale, n: number): st
  * 其余(含未登记 kind)按 kind 聚合。组排序:实验作用域组在前(按实验 id 字典序),
  * 非实验作用域组在后(按 kind);类别两档制(integrity / freshness)已随 stale-snapshot /
  * partial-coverage 一并删除——三种 warning kind 都是同一类完整性事实,不再需要档位区分
- * (docs/feature/reports/library/site-components.md「聚合轴是动作,不是发生顺序」)。
+ * (docs/feature/reports/components/site/sample-warnings.md「聚合轴是动作,不是发生顺序」)。
  */
 export declare function groupScopeWarnings(input: readonly ScopeWarning[], locale: ReportLocale): GroupedScopeWarnings;

package/dist/report/components/site-components/scope-warnings.js

@@ -1,7 +1,7 @@
 // ScopeWarnings 的聚合层:把 Scope 警告按「下一步动作」组织成组,web / text 两面共用
-// (docs/feature/reports/library/site-components.md「聚合轴是动作,不是发生顺序」)。
+// (docs/feature/reports/components/site/sample-warnings.md「聚合轴是动作,不是发生顺序」)。
 // message 是完整叙述的单源,这里只组织、不改写;徽标 / 组头文案按 kind 表登记的模板
-// (docs/feature/results/library.md「警告 kind 全集」)经 locale 词典渲染,未登记的 kind
+// (docs/feature/record/library.md「警告 kind 全集」)经 locale 词典渲染,未登记的 kind
 // 回退为单独成组、逐条 message 原样。
 import { localeText } from "../../model/locale.js";
 /** 实验作用域且登记了徽标模板的 kind 才进实验组;其余(含未登记 kind)按 kind 聚合。 */
@@ -31,7 +31,7 @@ function dedupeCommand(members) {
  * 其余(含未登记 kind)按 kind 聚合。组排序:实验作用域组在前(按实验 id 字典序),
  * 非实验作用域组在后(按 kind);类别两档制(integrity / freshness)已随 stale-snapshot /
  * partial-coverage 一并删除——三种 warning kind 都是同一类完整性事实,不再需要档位区分
- * (docs/feature/reports/library/site-components.md「聚合轴是动作,不是发生顺序」)。
+ * (docs/feature/reports/components/site/sample-warnings.md「聚合轴是动作,不是发生顺序」)。
  */
 export function groupScopeWarnings(input, locale) {
     const warnings = input;

package/dist/report/components/site-components/snapshot-diagnostics.js

@@ -1,5 +1,5 @@
 // SnapshotDiagnostics 的聚合层:把 snapshotDiagnosticsData 的产物按来源 experiment 分组,
-// web / text 两面共用(docs/feature/reports/library/site-components.md「SnapshotDiagnostics」)。
+// web / text 两面共用(docs/feature/reports/components/site/run-diagnostics.md)。
 // 输入已经由 snapshotDiagnosticsData 按 experiment id 字典序、组内 startedAt 新到旧排好序,
 // 这里只按 experimentId 分桶,不重新排序、不跨来源合并 DiagnosticRecord。
 import { localeText } from "../../model/locale.js";

package/dist/report/components/summaries/compute.d.ts

@@ -1,7 +1,7 @@
 import type { ReportInput, ScopeSummaryData } from "../../model/types.ts";
 /**
  * `scopeSummaryData(input)`:范围摘要——快照时间窗、experiment / eval / attempt 数、
- * 两级判定计票、端到端通过率与总成本(docs/feature/reports/library/summaries.md)。
+ * 两级判定计票、端到端通过率与总成本(docs/feature/reports/components/summaries/sample-summary.md)。
  * data 恒携带两级计票;通过率来自官方两级指标引擎,不从任一计票重算。
  */
 export declare function scopeSummaryData(input: ReportInput): Promise<ScopeSummaryData>;

package/dist/report/components/summaries/compute.js

@@ -1,5 +1,5 @@
 // 计算函数(*Data):ReportInput → 一份组件数据。ScopeSummary 的 scopeSummaryData 住在这里
-// (docs/feature/reports/library/summaries.md)。ExperimentComparison 是纯组合组件,不产生
+// (docs/feature/reports/components/summaries/README.md)。ExperimentComparison 是纯组合组件,不产生
 // 独立的 data,没有对应的计算函数。
 //
 // 共同约定(docs/feature/reports/architecture.md「指标聚合不变量」):
@@ -21,7 +21,7 @@ const totalCostMetric = defineMetric({
 });
 /**
  * `scopeSummaryData(input)`:范围摘要——快照时间窗、experiment / eval / attempt 数、
- * 两级判定计票、端到端通过率与总成本(docs/feature/reports/library/summaries.md)。
+ * 两级判定计票、端到端通过率与总成本(docs/feature/reports/components/summaries/sample-summary.md)。
  * data 恒携带两级计票;通过率来自官方两级指标引擎,不从任一计票重算。
  */
 export async function scopeSummaryData(input) {

package/dist/report/components/summaries/faces.js

@@ -14,7 +14,7 @@ export function scopeSummaryText(data, votes, ctx) {
     const tally = votes === "attempt" ? data.attemptVerdicts : data.evalVerdicts;
     const head = [
         // 计分制 Scope 隐藏通过率只显示总分;混型 Scope 两者都显示;纯通过制 Scope 只显示通过率
-        // (现状不变),见 docs/feature/reports/library/summaries.md「ScopeSummary」。
+        // (现状不变),见 docs/feature/reports/components/summaries/sample-summary.md。
         ...(data.scoringComposition !== "points"
             ? [`${localeText(locale, "scopeSummary.passRate")} ${cellText(data.endToEndPassRate, locale)}`]
             : []),

package/dist/report/components/summaries/index.d.ts

@@ -24,7 +24,7 @@ export type ExperimentComparisonProps = ComparisonChrome & {
  * 「同引用 input + 深相等 spec」记忆化保证。主读数按 scoringComposition(input) 切换:
  * "pass" 用 endToEndPassRate、"points" 用 totalScore;"mixed" 按题型把 input 拆成两个
  * 子 Scope,散点与 ExperimentList 每组各一份、各用各的主读数,ScopeSummary 始终是整个
- * input 一份(docs/feature/reports/library/summaries.md「ExperimentComparison」)。
+ * input 一份(docs/feature/reports/components/summaries/experiment-comparison.md)。
  */
 export declare const ExperimentComparison: ReportComponent<ExperimentComparisonProps>;
 export {};

package/dist/report/components/summaries/index.js

@@ -90,7 +90,7 @@ function filterInputBySnapshot(input, predicate) {
  * 「同引用 input + 深相等 spec」记忆化保证。主读数按 scoringComposition(input) 切换:
  * "pass" 用 endToEndPassRate、"points" 用 totalScore;"mixed" 按题型把 input 拆成两个
  * 子 Scope,散点与 ExperimentList 每组各一份、各用各的主读数,ScopeSummary 始终是整个
- * input 一份(docs/feature/reports/library/summaries.md「ExperimentComparison」)。
+ * input 一份(docs/feature/reports/components/summaries/experiment-comparison.md)。
  */
 export const ExperimentComparison = defineComponent(async (props, ctx) => {
     const input = props.input ?? ctx.scope;

package/dist/report/index.js

@@ -27,7 +27,7 @@ export { ScopeSummary, ExperimentComparison } from "./components/summaries/index
 export { AttemptList, EvalList, ExperimentList, FailureList } from "./components/entity-lists/index.js";
 export { DeltaTable, MetricBars, MetricLine, MetricMatrix, MetricScatter, MetricTable, Scoreboard, StabilityMatrix, } from "./components/metric-views/index.js";
 export { CopyFixPrompt, Hero, HeroCard, PoweredBy, ScopeWarnings, SnapshotDiagnostics, TraceWaterfall, } from "./components/site-components/index.js";
-// Attempt 详情组件族(docs/feature/reports/library/attempt-detail.md):11 个叶子 + 2 个
+// Attempt 详情组件族(docs/feature/reports/components/attempt-detail/README.md):11 个叶子 + 2 个
 // 只装配叶子的组合组件(AttemptAssessment / AttemptDetail),都从 niceeval/report 导出。
 export { AttemptAssertions, AttemptAssessment, AttemptConversation, AttemptDetail, AttemptDiagnostics, AttemptDiff, AttemptError, AttemptFixPrompt, AttemptSource, AttemptSummary, AttemptTimeline, AttemptTrace, UsageTable, } from "./components/attempt-detail/index.js";
 // 计算函数(组件解析面的具名形式,与组件成对;spec 形态下由管线代调,data 形态与

package/dist/report/model/aggregate.d.ts

@@ -7,7 +7,7 @@ import { evalPrefixPredicate } from "../../shared/aggregate.ts";
  * `ReportInput` 归一化:Scope 分支直接消费它已经按口径物化好的 `attempts`(不再重新
  * flatten `snapshots`——真实 Snapshot 各自持有完整、未按 Scope 口径收窄的 evals/attempts,
  * 只有 `Scope.attempts` 才是这次选择的真正结果);裸 `Snapshot[]` 分支没有挑选过程,取全部
- * (docs/feature/results/library.md「官方现刻水位」)。
+ * (docs/feature/record/library.md「官方现刻水位」)。
  */
 export declare function resolveInput(input: ReportInput): {
     snapshots: readonly Snapshot[];
@@ -30,7 +30,7 @@ export interface Item {
 export declare function experimentIdOf(item: Item): string;
 export declare function evalIdOf(item: Item): string;
 /**
- * 历史执行判定(docs/feature/results/library.md「时效:新执行与历史执行」):携带条目,或
+ * 历史执行判定(docs/feature/sample/library.md「时效:新执行与历史执行」):携带条目,或
  * 真实来源(`item.snapshot`)早于该实验在这份输入里的水位基准(`item.watermark`)——
  * latest() 口径下二者是同一个对象,比较恒假,只剩 carried 生效;current() 口径下贡献
  * 来源可能有多个,水位基准是其中 startedAt 最新的一个。

package/dist/report/model/aggregate.js

@@ -17,7 +17,7 @@ const KEY_SEP = "\u0000";
  * `ReportInput` 归一化:Scope 分支直接消费它已经按口径物化好的 `attempts`(不再重新
  * flatten `snapshots`——真实 Snapshot 各自持有完整、未按 Scope 口径收窄的 evals/attempts,
  * 只有 `Scope.attempts` 才是这次选择的真正结果);裸 `Snapshot[]` 分支没有挑选过程,取全部
- * (docs/feature/results/library.md「官方现刻水位」)。
+ * (docs/feature/record/library.md「官方现刻水位」)。
  */
 export function resolveInput(input) {
     if (Array.isArray(input)) {
@@ -34,7 +34,7 @@ export function evalIdOf(item) {
     return item.attempt.evalId || item.attempt.result.id;
 }
 /**
- * 历史执行判定(docs/feature/results/library.md「时效:新执行与历史执行」):携带条目,或
+ * 历史执行判定(docs/feature/sample/library.md「时效:新执行与历史执行」):携带条目,或
  * 真实来源(`item.snapshot`)早于该实验在这份输入里的水位基准(`item.watermark`)——
  * latest() 口径下二者是同一个对象,比较恒假,只剩 carried 生效;current() 口径下贡献
  * 来源可能有多个,水位基准是其中 startedAt 最新的一个。

package/dist/report/model/format.d.ts

@@ -55,7 +55,7 @@ export declare function formatReportDateTimeRange(fromIso: string, toIso: string
  * 历史执行的紧凑时距("3d" / "2h" / "5m" / "10s"):自 `startedAt` 起算,渲染时刻由调用方
  * 传入(`nowIso` 缺省当前时刻)——粒度阈值复用 `gapParts`(与曾经的 stale-snapshot message
  * 同一套单源,见 `results/select.ts`),只是这里的呈现是紧凑单字母,不是完整单词
- * (docs/feature/reports/library/entity-lists.md「时效标注」)。
+ * (docs/feature/reports/components/entity-lists/README.md「时效标注」)。
  */
 export declare function formatHistoricalGap(startedAtIso: string, nowIso?: string): string;
 /** passed / failed / errored / skipped 的判定符。 */
@@ -67,7 +67,7 @@ export declare function verdictMark(verdict: Verdict): string;
 export declare function fitFailureSummary(summary: string, maxChars: number): string;
 /**
  * 一份 `ExperimentList` data 的题型构成:主读数列该显示 Pass rate、Total score,还是两者
- * 并存(docs/feature/reports/library/entity-lists.md「ExperimentList」主读数列)。与
+ * 并存(docs/feature/reports/components/entity-lists/experiment-list.md 主读数列)。与
  * `entity-lists/compute.ts` 里 `experimentListData` 默认排序专用的 `listScoringComposition`
  * 同一套判据——跳过 `attempts === 0` 的行(coverage-only 占位,`scoring` 是占位默认值不是
  * 读到的事实,一屏占位行不该把纯计分制列表误判成 mixed)。web 面与 text 面在这里读同一份

package/dist/report/model/format.js

@@ -223,7 +223,7 @@ export function formatReportDateTimeRange(fromIso, toIso, locale) {
  * 历史执行的紧凑时距("3d" / "2h" / "5m" / "10s"):自 `startedAt` 起算,渲染时刻由调用方
  * 传入(`nowIso` 缺省当前时刻)——粒度阈值复用 `gapParts`(与曾经的 stale-snapshot message
  * 同一套单源,见 `results/select.ts`),只是这里的呈现是紧凑单字母,不是完整单词
- * (docs/feature/reports/library/entity-lists.md「时效标注」)。
+ * (docs/feature/reports/components/entity-lists/README.md「时效标注」)。
  */
 export function formatHistoricalGap(startedAtIso, nowIso = new Date().toISOString()) {
     const { n, unit } = gapParts(startedAtIso, nowIso);
@@ -253,7 +253,7 @@ export function fitFailureSummary(summary, maxChars) {
 // ── ExperimentList(web ExperimentList.tsx / text faces.ts)共用的题型构成判据 ──
 /**
  * 一份 `ExperimentList` data 的题型构成:主读数列该显示 Pass rate、Total score,还是两者
- * 并存(docs/feature/reports/library/entity-lists.md「ExperimentList」主读数列)。与
+ * 并存(docs/feature/reports/components/entity-lists/experiment-list.md 主读数列)。与
  * `entity-lists/compute.ts` 里 `experimentListData` 默认排序专用的 `listScoringComposition`
  * 同一套判据——跳过 `attempts === 0` 的行(coverage-only 占位,`scoring` 是占位默认值不是
  * 读到的事实,一屏占位行不该把纯计分制列表误判成 mixed)。web 面与 text 面在这里读同一份

package/dist/report/model/metrics.js

@@ -16,8 +16,8 @@
 //   assistantTurns(assistant-turns)                null     实测;o11y 缺失→null 同左  同左          lower
 //   repeatedFailedCommands(repeated-failed-commands) null   实测;o11y 缺失→null 同左  同左          lower
 //
-// bounds(自然边界,驱动图轴呼吸边距的钳制,见 docs/feature/reports/library/metric-views.md
-// 「图轴值域」):三个通过率指标与 examScore 是 { min: 0, max: 1 };其余七个(totalScore、
+// bounds(自然边界,驱动图轴呼吸边距的钳制,见 docs/feature/reports/components/charts/README.md
+// 「值域」):三个通过率指标与 examScore 是 { min: 0, max: 1 };其余七个(totalScore、
 // durationMs、tokens、costUSD、assistantTurns、repeatedFailedCommands)是 { min: 0 }。
 //
 // 两档指标(docs/feature/reports/library/metrics.md「内置指标」):以上除 assistantTurns 与
@@ -187,7 +187,7 @@ export const tokens = defineMetric({
             return null;
         const usage = a.result.usage;
         // input/output 缺失(协议没提供)→ null,不拿 0 冒充「实测就是 0」
-        // (docs/feature/results/architecture.md#usage)。
+        // (docs/feature/record/architecture.md#usage)。
         if (!usage || usage.inputTokens === undefined || usage.outputTokens === undefined)
             return null;
         // 只加 input + output:缓存读写量大但便宜,计进去会把缓存热的 agent 画成 token 大户;

package/dist/report/model/types.d.ts

@@ -40,7 +40,7 @@ export interface Metric<Name extends string = string> {
     /**
      * 指标值的自然边界(如通过率 0–1、成本下界 0)。图轴呼吸边距不越过声明的边界——
      * 贴边数据点如实落在框线上(如通过率 100%),那是指标的自然边界,不是裁剪
-     * (docs/feature/reports/library/metric-views.md「图轴值域」)。
+     * (docs/feature/reports/components/charts/README.md「值域」)。
      */
     bounds?: {
         min?: number;
@@ -114,7 +114,7 @@ export interface MetricColumn {
     unit?: string;
     /** 渲染提示:排序方向、轴向、涨跌配色。 */
     better?: "higher" | "lower";
-    /** = metric.bounds,原样投影;图轴值域推定读这里(docs/feature/reports/library/metric-views.md「图轴值域」)。 */
+    /** = metric.bounds,原样投影;图轴值域推定读这里(docs/feature/reports/components/charts/README.md「值域」)。 */
     bounds?: {
         min?: number;
         max?: number;
@@ -139,7 +139,7 @@ export interface MetricCell {
     refs: AttemptLocator[];
 }
 /**
- * 数据形状的字段命名规则(docs/feature/reports/library/metric-views.md「共用数据形状」):
+ * 数据形状的字段命名规则(docs/feature/reports/components/tables/README.md「共用数据形状」):
  * 维度名字段 = 产生它的选项名 + `Dimension` 后缀,值是解析后的维度 name;
  * 条目数组一律叫 `rows`(Matrix 的稀疏格子叫 `cells`);条目内的 key / series 是维度值,不带后缀。
  */
@@ -231,8 +231,7 @@ export interface ScoreboardData {
     }>;
 }
 /**
- * `DeltaTable` 的一格:同一条件值 × eval 的折叠(docs/feature/reports/library/metric-views.md
- * 「DeltaTable」)。`verdict` / `totalScore` 用与榜单同一套题目级判定口径(`totalScore` 取各
+ * `DeltaTable` 的一格:同一条件值 × eval 的折叠(docs/feature/reports/components/tables/delta-table.md)。`verdict` / `totalScore` 用与榜单同一套题目级判定口径(`totalScore` 取各
  * attempt 的均值);`totalTokens` / `totalCostUSD` 是该题在该条件下全部 attempt 的**合计**,
  * 不是均值。
  */
@@ -343,7 +342,7 @@ export type ScoringComposition = "pass" | "points" | "mixed";
 /**
  * 一个范围的摘要:快照时间窗、experiment / eval / attempt 数、两级判定计票、端到端通过率
  * 和总成本。eval 的身份键是 experimentId + evalId;data 恒携带两级计票,渲染面显示哪一级
- * 由呈现 prop `votes` 决定,不改变 data(docs/feature/reports/library/summaries.md)。
+ * 由呈现 prop `votes` 决定,不改变 data(docs/feature/reports/components/summaries/sample-summary.md)。
  */
 export interface ScopeSummaryData {
     /** 贡献当前数据的快照时间范围;空范围为 null,不编造当前时间。 */
@@ -375,7 +374,7 @@ export interface ScopeSummaryData {
     totalCostUSD: MetricCell;
 }
 /**
- * `HeroCard` 的数据(docs/feature/reports/library/site-components.md):站点标题区的
+ * `HeroCard` 的数据(docs/feature/reports/components/site/hero-card.md):站点标题区的
  * 运行 meta——最后运行时间与快照合成来源。标题不在 data 里,它是站点声明与 Scope 的合成物,
  * 经 `HeroCardProps.title` 传入。
  */
@@ -386,7 +385,7 @@ export interface HeroData {
     snapshots: number;
 }
 /**
- * `SnapshotDiagnostics` 一条来源快照的诊断投影(docs/feature/reports/library/site-components.md):
+ * `SnapshotDiagnostics` 一条来源快照的诊断投影(docs/feature/reports/components/site/run-diagnostics.md):
  * 只携带 experimentId / startedAt / DiagnosticRecord,不带 Snapshot 本体、`evals` 或
  * `AttemptHandle`,避免把文件读取能力拖进浏览器边界。
  */
@@ -402,7 +401,7 @@ export interface SnapshotDiagnosticsItem {
 export type SnapshotDiagnosticsData = readonly SnapshotDiagnosticsItem[];
 /**
  * `CopyFixPrompt` 的数据:resolve 期算好的修复 prompt 全文与参与的失败数
- * (docs/feature/reports/library/site-components.md)。
+ * (docs/feature/reports/components/site/copy-fix-prompt.md)。
  */
 export interface CopyFixPromptData {
     /** 修复 prompt 全文;失败逐条含 eval id、主失败摘要与 attempt 下钻命令。 */
@@ -728,7 +727,7 @@ export interface AttemptConversationData {
     locator: AttemptLocator;
     rounds: AttemptConversationRound[];
     /**
-     * `commands.json` 的投影(见 docs/feature/results/architecture.md#commandsjson):按关联
+     * `commands.json` 的投影(见 docs/feature/record/architecture.md#commandsjson):按关联
      * timing 节点(`timingNodeId` 对应 `PhaseTiming.children` 中 `kind === "command"` 的节点)
      * 的 `startOffsetMs` 排序;关联不到 timing 节点的排在最后,不按数组偶然顺序猜时间。没有失败
      * 命令时字段省略,不摆空数组。
@@ -744,14 +743,14 @@ export interface AttemptDiagnosticsData {
 }
 /**
  * `UsageTable` 的 data:判定、轮数、工具调用数、token 拆分与成本摊成的单行用量摘要;组装口径单源
- * 见 docs/feature/reports/library/attempt-detail.md#usagetable-组装口径单源。identity 字段
+ * 见 docs/feature/reports/components/attempt-detail/usage-table.md#组装口径单源。identity 字段
  * (`locator`/`experimentId`/`evalId`/`attempt`/`verdict`)恒有——它们不是「usage 有没有」的一部分,
  * 是这一行归属哪个 attempt 的身份。其余字段各自独立地只在事实真实存在时出现:
  *
  * - `turns`/`toolCalls`:events 派生(与 `o11y.json` 行为摘要同源),只在有非空 events 时出现,
  *   哪怕派生值恰好是 0(有 events 但零轮/零工具调用是观测到的事实,不是缺失)。
  * - `usage`:落盘 `Usage` 原样,只在 `result.usage` 存在时出现。桶恒互斥,`inputTokens` 本身
- *   就是未缓存输入(契约见 docs/feature/results/architecture.md#usage);"uncached in" 标注只在
+ *   就是未缓存输入(契约见 docs/feature/record/architecture.md#usage);"uncached in" 标注只在
  *   `cacheReadTokens` 在场时由 face 层给出,不派生第二个字段。
  * - `estimatedCostUSD`:能算出成本(`usage.costUSD` 或 `result.estimatedCostUSD`)时才出现。
  *

package/dist/results/locator.js

@@ -1,4 +1,4 @@
-// AttemptLocator:Attempt 的不透明、可复制、可发布的短标识(定稿见 docs/feature/results/library.md
+// AttemptLocator:Attempt 的不透明、可复制、可发布的短标识(定稿见 docs/feature/record/library.md
 // 「按 locator 寻址一个 attempt」、docs/concepts.md「Attempt 定位符」、docs/feature/reports/view.md 的 `#/attempt/@<locator>` 路由)。
 //
 // locator 由不可变身份元组 {experimentId, 快照 startedAt, evalId, attempt 下标(0-indexed)}

package/dist/results/select.d.ts

@@ -20,7 +20,7 @@ export interface ResultScope {
     fresh?: boolean;
 }
 /**
- * current() 跨快照拼接的可比性前提所比较的字段集(docs/feature/results/library.md
+ * current() 跨快照拼接的可比性前提所比较的字段集(docs/feature/record/library.md
  * 「官方现刻水位」):会改变单题被测行为或判定的字段。runs / earlyExit / maxConcurrency /
  * selectedEvalIds / evalFilterFingerprint / description 是编排与选题字段,不参与比较。
  */
@@ -40,7 +40,7 @@ export declare function deepEqualJson(a: unknown, b: unknown): boolean;
 /**
  * 一个快照实际选中的 eval id 全集:优先读落盘的 `experiment.selectedEvalIds`(niceeval 自己的
  * 写入面必有此字段);第三方 harness 未实现该字段时退化为该快照实际写出的 `evals`,不把整份
- * 来源排除在外(见 docs/feature/results/architecture.md「selectedEvalIds」)。
+ * 来源排除在外(见 docs/feature/record/architecture.md「selectedEvalIds」)。
  */
 export declare function selectedEvalIdsOf(snapshot: Snapshot): readonly string[];
 /**
@@ -49,7 +49,7 @@ export declare function selectedEvalIdsOf(snapshot: Snapshot): readonly string[]
  * 快照」,带 eval 前缀的局部重跑会产出残缺快照;现刻水位承诺「不会因为一次局部重跑变残缺」,
  * 所以在实验的历史快照上逐 eval 向更早的 run 补齐——但补齐只发生在 `Scope.attempts` 这份
  * 物化选择上,真正贡献过至少一道题的来源 Snapshot 原样进 `Scope.snapshots`,不重建、不
- * 合并成报告专用对象(见 docs/feature/results/library.md「官方现刻水位」)。
+ * 合并成报告专用对象(见 docs/feature/record/library.md「官方现刻水位」)。
  *
  * **可比性前提**:每个 experiment 以最新快照的可比性配置(agent / model / reasoningEffort /
  * flags / budget / timeoutMs / sandbox)为基准,只有配置与基准深相等的历史快照才参与补齐;
@@ -102,7 +102,7 @@ export declare function filterExperiments(experiments: Experiment[], filter?: st
 /**
  * 时效标注(`↩` + 人话时距)的粒度选择:选粒度最大的单位,四舍五入。结构化形态是单源——
  * entity-lists 渲染面的紧凑时距("3d")与曾经的 stale-snapshot message 用同一套阈值,
- * 阈值不写两份(docs/feature/reports/library/entity-lists.md「时效标注」)。
+ * 阈值不写两份(docs/feature/reports/components/entity-lists/README.md「时效标注」)。
  */
 export declare function gapParts(fromIso: string, toIso: string): {
     n: number;

package/dist/results/select.js

@@ -1,4 +1,4 @@
-// 快照 Scope 与 attempt 去重(定稿见 docs/feature/results/library.md「选择快照」「官方现刻水位」「身份键与去重」)。
+// 快照 Scope 与 attempt 去重(定稿见 docs/feature/record/library.md「选择快照」「官方现刻水位」「身份键与去重」)。
 //
 // 选择器长在集合上(results.latest() / results.current()),不是 DSL,只是最常用的两种口径。
 // 选择器必须诚实:残缺、落后、未收尾都被算出来,以结构化 warnings 随 Scope 走 ——
@@ -23,7 +23,7 @@ export function selectLatest(results, opts) {
         // fresh: true 只保留新执行的 attempt——在 latest() 口径下,选中集合永远只有这一份
         // 快照,「所属快照早于该实验在 Scope 中最新快照」这条历史出身天生不成立(只有它自己),
         // 唯一的历史出身是携带条目(attempt.carried)。只过滤显式物化的 attempts 集,不克隆/
-        // 改写来源 Snapshot 的 evals(见 docs/feature/results/library.md「选择快照」)。
+        // 改写来源 Snapshot 的 evals(见 docs/feature/record/library.md「选择快照」)。
         const picked = fresh ? raw.attempts.filter((a) => !a.carried) : raw.attempts;
         attempts.push(...picked);
         // 覆盖事实:分母 = 该实验已知 eval 并集(本地历史 ∪ 各快照携带的 knownEvalIds),
@@ -84,7 +84,7 @@ export function deepEqualJson(a, b) {
 /**
  * 一个快照实际选中的 eval id 全集:优先读落盘的 `experiment.selectedEvalIds`(niceeval 自己的
  * 写入面必有此字段);第三方 harness 未实现该字段时退化为该快照实际写出的 `evals`,不把整份
- * 来源排除在外(见 docs/feature/results/architecture.md「selectedEvalIds」)。
+ * 来源排除在外(见 docs/feature/record/architecture.md「selectedEvalIds」)。
  */
 export function selectedEvalIdsOf(snapshot) {
     return snapshot.experiment?.selectedEvalIds ?? snapshot.evals.map((ev) => ev.id);
@@ -95,7 +95,7 @@ export function selectedEvalIdsOf(snapshot) {
  * 快照」,带 eval 前缀的局部重跑会产出残缺快照;现刻水位承诺「不会因为一次局部重跑变残缺」,
  * 所以在实验的历史快照上逐 eval 向更早的 run 补齐——但补齐只发生在 `Scope.attempts` 这份
  * 物化选择上,真正贡献过至少一道题的来源 Snapshot 原样进 `Scope.snapshots`,不重建、不
- * 合并成报告专用对象(见 docs/feature/results/library.md「官方现刻水位」)。
+ * 合并成报告专用对象(见 docs/feature/record/library.md「官方现刻水位」)。
  *
  * **可比性前提**:每个 experiment 以最新快照的可比性配置(agent / model / reasoningEffort /
  * flags / budget / timeoutMs / sandbox)为基准,只有配置与基准深相等的历史快照才参与补齐;
@@ -347,7 +347,7 @@ export function filterExperiments(experiments, filter) {
 /**
  * 时效标注(`↩` + 人话时距)的粒度选择:选粒度最大的单位,四舍五入。结构化形态是单源——
  * entity-lists 渲染面的紧凑时距("3d")与曾经的 stale-snapshot message 用同一套阈值,
- * 阈值不写两份(docs/feature/reports/library/entity-lists.md「时效标注」)。
+ * 阈值不写两份(docs/feature/reports/components/entity-lists/README.md「时效标注」)。
  */
 export function gapParts(fromIso, toIso) {
     const ms = Math.max(0, Date.parse(toIso) - Date.parse(fromIso));

package/dist/results/types.d.ts

@@ -2,7 +2,7 @@ import type { DiagnosticRecord, EvalResult, ExperimentRunInfo, LocalizedText } f
 import type { FailedCommandEvidence, O11ySummary, StreamEvent, TraceSpan } from "../types.ts";
 import type { AgentSetupManifest, DiffData, SourceArtifact } from "../types.ts";
 import type { AttemptLocator } from "./locator.ts";
-/** attempt 级 artifact 的种类;文件名见 format.ts 的 artifactFileOf,布局见 docs/feature/results/architecture.md。 */
+/** attempt 级 artifact 的种类;文件名见 format.ts 的 artifactFileOf,布局见 docs/feature/record/architecture.md。 */
 export declare const ARTIFACT_KINDS: readonly ["commands", "events", "trace", "o11y", "agentSetup", "diff", "sources"];
 export type ArtifactKind = (typeof ARTIFACT_KINDS)[number];
 /** 写这份结果的工具:niceeval 自己,或经 niceeval/results 写入面转换的第三方 harness。 */
@@ -14,7 +14,7 @@ export interface Producer {
 /**
  * `snapshot.json` 的持久化契约:快照元数据 —— 身份、快照级字段与版本元数据,
  * 不含任何逐 attempt 数据。快照开始时写入;收尾时补写 `completedAt`。
- * 字段规则与版本判定见 docs/feature/results/architecture.md「snapshot.json」「版本与升级设计」。
+ * 字段规则与版本判定见 docs/feature/record/architecture.md「snapshot.json」「版本与升级设计」。
  */
 export interface SnapshotMeta {
     /** 恒为 "niceeval.results";和 schemaVersion、producer 一起构成持久化契约,永不移动或改名。 */
@@ -39,7 +39,7 @@ export interface SnapshotMeta {
     diagnostics?: DiagnosticRecord[];
     /**
      * experiment 作用域生命周期代码经 `ctx.fact()` 上报的运行事实;与 completedAt 同批在快照
-     * 封口补写。字段契约见 result.json 的 facts 小节(docs/feature/results/architecture.md#facts运行事实)。
+     * 封口补写。字段契约见 result.json 的 facts 小节(docs/feature/record/architecture.md#facts运行事实)。
      */
     facts?: Record<string, string | number | boolean>;
     /** 写入时刻该实验已知的 eval 并集 —— 残缺检测的分母随数据走(copySnapshots 自动补记,writer 可声明)。 */
@@ -85,7 +85,7 @@ export interface AttemptHandle {
     /**
      * 携带条目投影:true = fingerprint 未变、上一轮终态结果合入本快照(`result.artifactBase`
      * 有值);false = 本快照那次运行真实执行。`startedAt` 为原执行时刻,不因携带而改写
-     * (时效语义见 docs/feature/results/library.md「时效:新执行与历史执行」)。
+     * (时效语义见 docs/feature/sample/library.md「时效:新执行与历史执行」)。
      */
     carried: boolean;
     /** 非零 Sandbox 命令的 stdout/stderr 证据(`commands.json`);没有失败命令时 null。 */
@@ -178,7 +178,7 @@ export interface Results {
      * 每个实验取最新一次快照,返回 Scope(快照与挑选警告绑在一起走)。
      * `experiments` 是 experiment id 前缀过滤(string | string[]),同 CLI 位置参数语义。
      * `fresh: true` 只保留新执行的 attempt(排除携带条目),被排除的题按覆盖事实进入
-     * `coverage.missingEvalIds`(见 docs/feature/results/library.md「时效:新执行与历史执行」)。
+     * `coverage.missingEvalIds`(见 docs/feature/sample/library.md「时效:新执行与历史执行」)。
      */
     latest(opts?: {
         experiments?: string | string[];
@@ -189,7 +189,7 @@ export interface Results {
      * 跨历史拼出当前判定水位。可比性前提:每个 experiment 以最新快照的可比性配置
      * (agent / model / reasoningEffort / flags / budget / timeoutMs / sandbox)为基准,
      * 配置不一致的旧快照不贡献 attempt,缺口进 `coverage.missingEvalIds`
-     * (见 docs/feature/results/library.md「官方现刻水位」)。`fresh: true` 同 `latest()`。
+     * (见 docs/feature/record/library.md「官方现刻水位」)。`fresh: true` 同 `latest()`。
      */
     current(opts?: {
         experiments?: string | string[];
@@ -199,7 +199,7 @@ export interface Results {
 /**
  * 一个实验的覆盖事实:已知 eval 并集(分母)与当前口径下没有任何 attempt 的题。
  * `missingEvalIds` 永远被算出来,不静默——渲染面把它转成榜单占位行
- * (见 docs/feature/results/library.md「选择快照」「时效:新执行与历史执行」)。
+ * (见 docs/feature/sample/library.md「选择快照」「时效:新执行与历史执行」)。
  */
 export interface ScopeCoverage {
     experimentId: string;
@@ -235,7 +235,7 @@ export interface Scope {
 /**
  * 挑选警告:每种带 kind、可判断的结构化字段和渲染好的英文 message;能用一条命令直接推进的
  * kind 同时带 `command`(已替换真实 id,复制即跑)。kind 是契约的一部分,全集与触发条件见
- * docs/feature/results/library.md「警告 kind 全集」——三种都是**定位不到任何一行**的完整性
+ * docs/feature/record/library.md「警告 kind 全集」——三种都是**定位不到任何一行**的完整性
  * 事实:覆盖缺口(行级事实,见 `ScopeCoverage`)与时效(`AttemptHandle.carried` 投影的行级
  * 属性)不在这个联合里。
  */