niceeval 0.12.1 → 0.12.2-canary.31

package/dist/report/components/shared-compute.js

@@ -1,48 +0,0 @@
-// 跨组件族共用的计算辅助:summaries(sampleSummary)、entity-lists(experimentListData)与
-// 题型构成(evaluationKindComposition)共用同一条 selectedEvalIds
-// 投影规则与同一套组级统计折叠,住在这里而不是任一族自己的 compute.ts,避免重复实现分叉。
-import { selectedEvalIdsOf } from "../../sample/index.js";
-import { evalLevelStats } from "../../shared/verdict.js";
-import { experimentIdOf, fullEvalKey } from "../model/aggregate.js";
-/**
- * 每个 attempt 只在其真实来源快照声明的 `selectedEvalIds` 内才保留——两个来源(不同
- * experiment,或手挑快照)声明不同 eval 集时各自只统计自己选中的那部分,未选择的 eval
- * (即使恰好在同一次运行里跑过)不进分母、不污染另一个来源。第三方快照缺该字段时
- * `selectedEvalIdsOf` 退化为其实际 evals,过滤天然是 no-op。宿主注入的 `current()` Sample
- * 在选择时已按这条规则收窄,这里对真实 Sample 是幂等的;只对作者手工拼的 `Run[]`
- * 真正生效。`experimentListData` / `sampleSummary` / `evaluationKindComposition` 共用
- * 同一条规则,保证经 `SampleOverview` 展开后收到的 spec 与
- * 直接调用同一份 input 深相等。
- */
-export function selectedAttemptsOnly(attempts) {
-    const selectedByExperimentSnapshot = new Map();
-    return attempts.filter((a) => {
-        let selected = selectedByExperimentSnapshot.get(a.run);
-        if (!selected)
-            selectedByExperimentSnapshot.set(a.run, (selected = new Set(selectedEvalIdsOf(a.run))));
-        return selected.has(a.evalId);
-    });
-}
-export function tallyOf() {
-    return { passed: 0, failed: 0, errored: 0, skipped: 0 };
-}
-/** 一批 Item 的组级统计(experimentListData / sampleSummary 共用)。 */
-export function summarizeItems(items) {
-    const experimentIds = new Set();
-    for (const item of items)
-        experimentIds.add(experimentIdOf(item));
-    const stats = evalLevelStats(items.map((item) => ({ verdict: item.attempt.result.verdict, key: fullEvalKey(item) })), (r) => r.key);
-    let lastRunAt;
-    for (const item of items) {
-        const startedAt = item.run.startedAt;
-        if (lastRunAt === undefined || startedAt > lastRunAt)
-            lastRunAt = startedAt;
-    }
-    return {
-        experiments: experimentIds.size,
-        evals: stats.evals,
-        attempts: items.length,
-        verdicts: { passed: stats.passed, failed: stats.failed, errored: stats.errored, skipped: stats.skipped },
-        lastRunAt,
-    };
-}

package/dist/report/components/shared-faces.d.ts

@@ -1,8 +0,0 @@
-import type { MetricValue } from "../model/calculation.ts";
-import type { VerdictTally } from "../model/types.ts";
-import { type ReportLocale } from "../model/locale.ts";
-export declare const MISSING_MARK = "\u2014";
-/** 格子的文本形态:渲染面按 unit/format 格式化;覆盖不全带 samples/total 角标。 */
-export declare function cellText(cell: MetricValue, locale: ReportLocale): string;
-/** verdict 计票的紧凑文案("3 passed · 1 failed"):非零判定逐个列,全部为零如实 —。 */
-export declare function verdictTallyText(tally: VerdictTally, locale: ReportLocale): string;

package/dist/report/components/shared-faces.js

@@ -1,21 +0,0 @@
-// 跨组件族共用的 text 面辅助:MetricValue / VerdictTally 的文本渲染。
-// 与 ../cell.tsx 的 MetricCellView 是同一份契约的 text/web 两面。
-import { formatMetricValue } from "../model/format.js";
-import { localeText } from "../model/locale.js";
-export const MISSING_MARK = "—";
-/** 格子的文本形态:渲染面按 unit/format 格式化;覆盖不全带 samples/total 角标。 */
-export function cellText(cell, locale) {
-    const display = formatMetricValue(cell.value, cell.unit, cell.format, locale);
-    if (cell.value === null)
-        return display;
-    return cell.samples < cell.total ? `${display} ${cell.samples}/${cell.total}` : display;
-}
-/** verdict 计票的紧凑文案("3 passed · 1 failed"):非零判定逐个列,全部为零如实 —。 */
-export function verdictTallyText(tally, locale) {
-    const parts = [];
-    for (const kind of ["passed", "failed", "errored", "skipped"]) {
-        if (tally[kind] > 0)
-            parts.push(`${tally[kind]} ${localeText(locale, `verdict.${kind}`)}`);
-    }
-    return parts.length > 0 ? parts.join(" · ") : MISSING_MARK;
-}

package/dist/report/components/shared.d.ts

@@ -1,52 +0,0 @@
-import type { ReportLocale } from "../model/locale.ts";
-import type { WebContext } from "../definition/tree.ts";
-import type { AttemptLocator } from "../../record/locator.ts";
-import type { ReportTarget } from "../definition/report.ts";
-/**
- * 标准库 attempt 详情页的 id 约定(library.md「参数化页:attempt 与 experiment 详情」)。
- * 这个字符串字面量只在这里写一次——`targetOfRefs`、宿主 text 面的下钻命令默认实现、
- * `niceeval show @<locator>` 的 page 查找都 import 这个常量,不各自重新拼 `"attempt"`。
- * 核心的 page 分派(`renderTarget`、`report.ts` 的装载规范化)本身仍然不认识这个 id——
- * 只有"标准库约定 attempt 是哪个 id"这一条知识集中在一处。
- */
-export declare const ATTEMPT_PAGE_ID = "attempt";
-/** 拼 class 名:过滤空值,末尾接使用者透传的 className。 */
-export declare function cx(...parts: (string | undefined | false)[]): string;
-/**
- * 官方数据组件的值 props：只接收已经算好的 Content。
- * 取数在 page.render / 公开 to* 转换里完成，组件不绑定 Source。
- */
-export type ValueProps<Data, Presentation = object> = {
-    data: Data;
-} & Presentation;
-export declare function isObject(value: unknown): value is globalThis.Record<string, unknown>;
-/** LocalizedText = string | globalThis.Record<string, string>(src/shared/types.ts)。 */
-export declare function isLocalizedText(value: unknown): boolean;
-/**
- * 字段路径前缀的结构校验原语:通过为 `null`,否则给出带完整字段路径的具体问题
- * (如 `"rows[2].cells.costUSD.samples" must be a number`)。每个族的 validate*Data
- * 用这些原语递归拼自己的形状,不重新发明逐字段判断。
- */
-export declare function cellProblem(value: unknown, path: string): string | null;
-export declare function isCell(value: unknown): boolean;
-/** 四态 tally { passed, failed, errored, skipped } 的字段路径前缀校验。 */
-export declare function tallyProblem(value: unknown, path: string): string | null;
-export declare function isTally(value: unknown): boolean;
-/** 数组的逐项校验:每项跑 `itemCheck(item, "path[i]")`,第一个非 null 问题即返回。 */
-export declare function arrayProblem(value: unknown, path: string, itemCheck: (item: unknown, itemPath: string) => string | null): string | null;
-export type Validator = (data: unknown) => string | null;
-export declare function dataShapeError(component: string, dataFnName: string, shape: string, problem: string): Error;
-/**
- * 全库唯一的默认下钻目标规则(library.md「目标与下钻」):`refs` 恰好一个 locator 时指向
- * 标准库 attempt 详情目标;零个或多个都返回 `undefined`——多证据压成一个链接必然指错,宁可
- * 不成链(表格格子不受此限,每条 ref 各成一个单 locator 链接,见调用方逐条列出的写法)。
- * 「一个图形点该指向谁」由放点的上层决定,原语在上层没有显式声明目标时才落到这条默认规则。
- */
-export declare function targetOfRefs(refs: readonly AttemptLocator[]): ReportTarget | undefined;
-/** 单个已知 locator 的 href:经 `targetOfRefs` 得到目标,再经 `ctx.href` 换成 URL(同一条唯一通道)。 */
-export declare function hrefForLocator(ctx: WebContext, locator: AttemptLocator): string | undefined;
-export interface ChromeProps {
-    /** chrome 文案 locale;省略时随宿主上下文(宿主外默认 "en")。 */
-    locale?: ReportLocale;
-    className?: string;
-}

package/dist/report/components/shared.js

@@ -1,95 +0,0 @@
-// 官方双面组件的共用装配机制:普通值 props、data 结构校验原语(isObject /
-// isLocalizedText / isCell / isTally / cellProblem / tallyProblem / arrayProblem /
-// dataShapeError)、`targetOfRefs`/`hrefForLocator` 下钻目标解析、`ChromeProps` 呈现选项
-// 基类、`cx` classname 拼接——每个组件族在自己的 index.tsx 里用这些原语递归拼自己的
-// validate*Data(字段路径要覆盖到嵌套 MetricValue/Tally,不只顶层哨兵),具体的 validate*Data
-// 与组件导出留在各族。
-/**
- * 标准库 attempt 详情页的 id 约定(library.md「参数化页:attempt 与 experiment 详情」)。
- * 这个字符串字面量只在这里写一次——`targetOfRefs`、宿主 text 面的下钻命令默认实现、
- * `niceeval show @<locator>` 的 page 查找都 import 这个常量,不各自重新拼 `"attempt"`。
- * 核心的 page 分派(`renderTarget`、`report.ts` 的装载规范化)本身仍然不认识这个 id——
- * 只有"标准库约定 attempt 是哪个 id"这一条知识集中在一处。
- */
-export const ATTEMPT_PAGE_ID = "attempt";
-/** 拼 class 名:过滤空值,末尾接使用者透传的 className。 */
-export function cx(...parts) {
-    return parts.filter(Boolean).join(" ");
-}
-// ───────────────────────── data 结构校验(版本漂移防线)─────────────────────────
-export function isObject(value) {
-    return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-/** LocalizedText = string | globalThis.Record<string, string>(src/shared/types.ts)。 */
-export function isLocalizedText(value) {
-    if (typeof value === "string")
-        return true;
-    return isObject(value) && Object.values(value).every((entry) => typeof entry === "string");
-}
-/**
- * 字段路径前缀的结构校验原语:通过为 `null`,否则给出带完整字段路径的具体问题
- * (如 `"rows[2].cells.costUSD.samples" must be a number`)。每个族的 validate*Data
- * 用这些原语递归拼自己的形状,不重新发明逐字段判断。
- */
-export function cellProblem(value, path) {
-    if (!isObject(value))
-        return `"${path}" must be a MetricValue { value, samples, total, basis, refs }`;
-    if (!(value.value === null || typeof value.value === "number"))
-        return `"${path}.value" must be a number or null`;
-    if (typeof value.samples !== "number")
-        return `"${path}.samples" must be a number`;
-    if (typeof value.total !== "number")
-        return `"${path}.total" must be a number`;
-    if (typeof value.basis !== "string")
-        return `"${path}.basis" must be a MetricBasis string`;
-    if (!Array.isArray(value.refs) || !value.refs.every((ref) => typeof ref === "string")) {
-        return `"${path}.refs" must be an array of locator strings`;
-    }
-    return null;
-}
-export function isCell(value) {
-    return cellProblem(value, "cell") === null;
-}
-/** 四态 tally { passed, failed, errored, skipped } 的字段路径前缀校验。 */
-export function tallyProblem(value, path) {
-    if (!isObject(value))
-        return `"${path}" must be a tally { passed, failed, errored, skipped }`;
-    for (const key of ["passed", "failed", "errored", "skipped"]) {
-        if (typeof value[key] !== "number")
-            return `"${path}.${key}" must be a number`;
-    }
-    return null;
-}
-export function isTally(value) {
-    return tallyProblem(value, "tally") === null;
-}
-/** 数组的逐项校验:每项跑 `itemCheck(item, "path[i]")`,第一个非 null 问题即返回。 */
-export function arrayProblem(value, path, itemCheck) {
-    if (!Array.isArray(value))
-        return `"${path}" must be an array`;
-    for (let i = 0; i < value.length; i++) {
-        const problem = itemCheck(value[i], `${path}[${i}]`);
-        if (problem !== null)
-            return problem;
-    }
-    return null;
-}
-export function dataShapeError(component, dataFnName, shape, problem) {
-    return new Error(`<${component}> received data that does not match the current ${shape} shape: ${problem}. ` +
-        `It may have been computed by a different niceeval version (component data carries no schemaVersion; the support window is same-version write and read). ` +
-        `Recompute it with ${dataFnName}() from this niceeval version, then re-render.`);
-}
-/**
- * 全库唯一的默认下钻目标规则(library.md「目标与下钻」):`refs` 恰好一个 locator 时指向
- * 标准库 attempt 详情目标;零个或多个都返回 `undefined`——多证据压成一个链接必然指错,宁可
- * 不成链(表格格子不受此限,每条 ref 各成一个单 locator 链接,见调用方逐条列出的写法)。
- * 「一个图形点该指向谁」由放点的上层决定,原语在上层没有显式声明目标时才落到这条默认规则。
- */
-export function targetOfRefs(refs) {
-    return refs.length === 1 ? { page: ATTEMPT_PAGE_ID, params: { locator: refs[0] } } : undefined;
-}
-/** 单个已知 locator 的 href:经 `targetOfRefs` 得到目标,再经 `ctx.href` 换成 URL(同一条唯一通道)。 */
-export function hrefForLocator(ctx, locator) {
-    const target = targetOfRefs([locator]);
-    return target === undefined ? undefined : ctx.href(target);
-}

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

@@ -1,14 +0,0 @@
-import type { ReactElement } from "react";
-import type { HeroData } from "../../model/types.ts";
-import { type LocalizedText, type ReportLocale } from "../../model/locale.ts";
-import type { HeroBrandProps } from "./hero-types.ts";
-/**
- * 站点标题区(纯 web 渲染面):可选品牌内容 + `<h1>` 标题 + meta 行 + NiceEval 品牌行。
- * 嵌入自有 React 页面时配合 `heroData()` 使用。
- */
-export declare function HeroCard({ title, data, logo, description, links, className, locale, }: HeroBrandProps & {
-    title: LocalizedText;
-    data: HeroData;
-    className?: string;
-    locale?: ReportLocale;
-}): ReactElement;

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

@@ -1,35 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { DEFAULT_REPORT_LOCALE, localeText, resolveLocalizedText } from "../../model/locale.js";
-import { cx } from "../shared.js";
-import { PoweredBy } from "./PoweredBy.js";
-/** ISO 时间 → 按 locale 的「最后运行」显示(年月日 时:分);不可解析原样返回。 */
-function formatLastRun(iso, locale) {
-    const date = new Date(iso);
-    if (Number.isNaN(date.valueOf()))
-        return iso;
-    try {
-        return new Intl.DateTimeFormat(locale, {
-            year: "numeric",
-            month: "short",
-            day: "numeric",
-            hour: "2-digit",
-            minute: "2-digit",
-        }).format(date);
-    }
-    catch {
-        return iso;
-    }
-}
-/**
- * 站点标题区(纯 web 渲染面):可选品牌内容 + `<h1>` 标题 + meta 行 + NiceEval 品牌行。
- * 嵌入自有 React 页面时配合 `heroData()` 使用。
- */
-export function HeroCard({ title, data, logo, description, links = [], className, locale = DEFAULT_REPORT_LOCALE, }) {
-    const meta = data.latestStartedAt === null
-        ? localeText(locale, "hero.noRuns")
-        : [
-            localeText(locale, "hero.lastRun", { time: formatLastRun(data.latestStartedAt, locale) }),
-            ...(data.runs > 1 ? [localeText(locale, "hero.composedRuns", { n: data.runs })] : []),
-        ].join(" · ");
-    return (_jsxs("header", { className: cx("niceeval-report", "niceeval-hero", className), children: [logo !== undefined ? (_jsx("img", { className: "niceeval-hero-logo", src: logo.src, alt: resolveLocalizedText(logo.alt, locale) })) : null, _jsx("h1", { className: "niceeval-hero-title", children: resolveLocalizedText(title, locale) }), description !== undefined ? (_jsx("p", { className: "niceeval-hero-description", children: resolveLocalizedText(description, locale) })) : null, links.length > 0 ? (_jsx("nav", { className: "niceeval-hero-links", children: links.map((link) => (_jsx("a", { className: "niceeval-hero-link", href: link.href, rel: "noopener", children: resolveLocalizedText(link.label, locale) }, `${link.href}:${resolveLocalizedText(link.label, locale)}`))) })) : null, _jsx("p", { className: "niceeval-hero-meta", children: meta }), _jsx(PoweredBy, {})] }));
-}

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

@@ -1,5 +0,0 @@
-import type { ReactElement } from "react";
-/** 品牌行的固定去处:niceeval 官网,utm 标记「来自报告的品牌行」。 */
-export declare const POWERED_BY_HREF = "https://niceeval.com/?utm_source=report&utm_medium=powered-by";
-/** 一行品牌色小字 `Powered by NiceEval`,链接官网;HeroCard 的品牌行与它同一渲染。 */
-export declare function PoweredBy(): ReactElement;

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

@@ -1,7 +0,0 @@
-import { jsx as _jsx } from "react/jsx-runtime";
-/** 品牌行的固定去处:niceeval 官网,utm 标记「来自报告的品牌行」。 */
-export const POWERED_BY_HREF = "https://niceeval.com/?utm_source=report&utm_medium=powered-by";
-/** 一行品牌色小字 `Powered by NiceEval`,链接官网;HeroCard 的品牌行与它同一渲染。 */
-export function PoweredBy() {
-    return (_jsx("p", { className: "niceeval-report niceeval-powered-by", children: _jsx("a", { href: POWERED_BY_HREF, target: "_blank", rel: "noopener", children: "Powered by NiceEval" }) }));
-}

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

@@ -1,34 +0,0 @@
-import type { CopyFixPromptData, HeroData, ReportInput, SampleIssue, SnapshotDiagnosticsData, TraceWaterfallRow } from "../../model/types.ts";
-/**
- * `heroData(input)`:站点标题区的运行 meta——`latestStartedAt` 取范围内最新快照的开始时间
- * (空范围为 null,不编造当前时间),`runs` 计贡献当前水位的快照数
- * (docs/feature/reports/components/site/hero-card.md)。
- */
-export declare function heroData(input: ReportInput): Promise<HeroData>;
-/**
- * `scopeWarningsData(input)`:Sample 携带的挑选警告原样透出;`input` 是裸 `Run[]` 时
- * 没有挑选过程、没有警告,返回空数组,也如实
- * (docs/feature/reports/components/summaries/sample-notices.md)。
- */
-export declare function scopeWarningsData(input: ReportInput): Promise<readonly SampleIssue[]>;
-/**
- * `snapshotDiagnosticsData(input)`:只投影 diagnostics 非空的真实 Run,不携带 `evals` 或
- * `AttemptHandle`,不跨快照合并;按 experiment id 字典序排列,同一实验内按 startedAt 从新到旧
- * (docs/feature/reports/library.md)。
- */
-export declare function snapshotDiagnosticsData(input: ReportInput): Promise<SnapshotDiagnosticsData>;
-/**
- * `copyFixPromptData(input)`:把范围内全部失败(verdict 为 failed / errored 的 attempt)
- * 整理成一段可交给 coding agent 的修复 prompt——逐失败含 eval id、主失败摘要与 attempt
- * 下钻命令(`niceeval show @<locator>`)。prompt 面向 agent,固定英文
- * (docs/feature/reports/components/summaries/sample-fix-prompt.md)。
- */
-export declare function copyFixPromptData(input: ReportInput): Promise<CopyFixPromptData>;
-/**
- * `traceWaterfallData(input)`:每个 attempt 一行的执行时间瀑布摘要。span 事实只来自
- * trace artifact(经 AttemptHandle 懒加载的 canonical OTel span);runner 生命周期节点
- * (`result.phases`)不进瀑布。行内只汇总顶层 span(parentSpanId 缺失或不在本 trace 内),
- * 按 startOffsetMs 升序;trace 缺失或为空时 `durationMs` 为 null、行照常出现
- * (docs/feature/reports/components/primitives/waterfall.md)。
- */
-export declare function traceWaterfallData(input: ReportInput): Promise<readonly TraceWaterfallRow[]>;

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

@@ -1,144 +0,0 @@
-// 计算函数(*Data):ReportInput → 一份组件数据。站点组件族(Hero / ScopeWarnings /
-// CopyFixPrompt / TraceWaterfall)的 *Data 都住在这里
-// (docs/feature/reports/components/site/README.md)。
-//
-// 共同约定(docs/feature/reports/architecture.md「指标聚合不变量」):
-// - 第一参收 ReportInput = Sample | readonly Run[];issues 不进组件数据(宿主统一显示);
-// - null ≠ 0:缺数据不编数。
-import { collectItems, evalIdOf, experimentIdOf, locatorOf, resolveInput } from "../../model/aggregate.js";
-import { attemptListData } from "../entity-lists/compute.js";
-// ───────────────────────── 站点组件的计算函数(hero / issues / fix prompt / trace)─────────────────────────
-/**
- * `heroData(input)`:站点标题区的运行 meta——`latestStartedAt` 取范围内最新快照的开始时间
- * (空范围为 null,不编造当前时间),`runs` 计贡献当前水位的快照数
- * (docs/feature/reports/components/site/hero-card.md)。
- */
-export async function heroData(input) {
-    const { runs } = resolveInput(input);
-    let latest = null;
-    for (const run of runs) {
-        if (latest === null || run.startedAt > latest)
-            latest = run.startedAt;
-    }
-    return { latestStartedAt: latest, runs: runs.length };
-}
-/**
- * `scopeWarningsData(input)`:Sample 携带的挑选警告原样透出;`input` 是裸 `Run[]` 时
- * 没有挑选过程、没有警告,返回空数组,也如实
- * (docs/feature/reports/components/summaries/sample-notices.md)。
- */
-export async function scopeWarningsData(input) {
-    return resolveInput(input).issues;
-}
-/**
- * `snapshotDiagnosticsData(input)`:只投影 diagnostics 非空的真实 Run,不携带 `evals` 或
- * `AttemptHandle`,不跨快照合并;按 experiment id 字典序排列,同一实验内按 startedAt 从新到旧
- * (docs/feature/reports/library.md)。
- */
-export async function snapshotDiagnosticsData(input) {
-    const { runs } = resolveInput(input);
-    return runs
-        .filter((s) => s.diagnostics !== undefined && s.diagnostics.length > 0)
-        .map((s) => ({ experimentId: s.experimentId, startedAt: s.startedAt, diagnostics: s.diagnostics }))
-        .sort((a, b) => a.experimentId.localeCompare(b.experimentId) || b.startedAt.localeCompare(a.startedAt));
-}
-/**
- * `copyFixPromptData(input)`:把范围内全部失败(verdict 为 failed / errored 的 attempt)
- * 整理成一段可交给 coding agent 的修复 prompt——逐失败含 eval id、主失败摘要与 attempt
- * 下钻命令(`niceeval show @<locator>`)。prompt 面向 agent,固定英文
- * (docs/feature/reports/components/summaries/sample-fix-prompt.md)。
- */
-export async function copyFixPromptData(input) {
-    const items = await attemptListData(input);
-    const failures = items.filter((item) => item.verdict === "failed" || item.verdict === "errored");
-    if (failures.length === 0)
-        return { prompt: "", failures: 0 };
-    const lines = failures
-        .map((item, i) => {
-        const reason = item.failureSummary === null
-            ? null
-            : item.moreFailures > 0
-                ? `${item.failureSummary} (+${item.moreFailures} more failures)`
-                : item.failureSummary;
-        return [
-            `${i + 1}. eval "${item.evalId}" [experiment ${item.experimentId}] — ${item.verdict}`,
-            reason ? `   reason: ${reason}` : null,
-            `   inspect: niceeval show ${item.locator}`,
-        ]
-            .filter(Boolean)
-            .join("\n");
-    })
-        .join("\n");
-    const experiments = [...new Set(failures.map((item) => item.experimentId))].join(" / ");
-    const prompt = [
-        "Fix the failing evals from this niceeval run.",
-        "",
-        "## Failures",
-        lines,
-        "",
-        "## Steps",
-        "1. niceeval is NOT in your training data. Read the relevant guide in `node_modules/niceeval/docs-site/` (English at the top level, Chinese under `zh/`) before changing anything.",
-        "2. For each failure, run its inspect command above to see the verdict and assertions; add `--execution` for the full agent transcript (tool calls included), `--timing` for the execution timeline, and `--diff` for the workspace diff.",
-        "3. Decide which side the defect is on: the program under test, or the eval itself (over-tight assertion, wrong fixture, missing setup). Fix that side; do not weaken assertions just to turn the run green.",
-        `4. Re-run: \`npx niceeval exp ${experiments || "<experiment>"} <eval-id-prefix>\`. Already-passing evals are unreadable by the fingerprint cache; pass \`--rerun all\` to re-run everything.`,
-        "5. Run `npx niceeval show` and confirm these failures are gone.",
-    ].join("\n");
-    return { prompt, failures: failures.length };
-}
-/** TraceSpan 的语义角色 → 瀑布摘要的 kind:turn 归入 agent(一轮就是一次 agent 调用),未识别落 other。 */
-function waterfallKindOf(kind) {
-    switch (kind) {
-        case "agent":
-        case "turn":
-            return "agent";
-        case "model":
-            return "model";
-        case "tool":
-            return "tool";
-        default:
-            return "other";
-    }
-}
-/**
- * `traceWaterfallData(input)`:每个 attempt 一行的执行时间瀑布摘要。span 事实只来自
- * trace artifact(经 AttemptHandle 懒加载的 canonical OTel span);runner 生命周期节点
- * (`result.phases`)不进瀑布。行内只汇总顶层 span(parentSpanId 缺失或不在本 trace 内),
- * 按 startOffsetMs 升序;trace 缺失或为空时 `durationMs` 为 null、行照常出现
- * (docs/feature/reports/components/primitives/waterfall.md)。
- */
-export async function traceWaterfallData(input) {
-    const { runs, attempts } = resolveInput(input);
-    const items = collectItems(runs, attempts);
-    return Promise.all(items.map(async (item) => {
-        const spans = await item.attempt.trace();
-        if (spans === null || spans.length === 0) {
-            return {
-                experimentId: experimentIdOf(item),
-                evalId: evalIdOf(item),
-                locator: locatorOf(item),
-                durationMs: null,
-                spans: [],
-            };
-        }
-        const t0 = Math.min(...spans.map((s) => s.startMs));
-        const t1 = Math.max(...spans.map((s) => s.endMs));
-        const ids = new Set(spans.map((s) => s.spanId));
-        const topLevel = spans.filter((s) => s.parentSpanId === undefined || !ids.has(s.parentSpanId));
-        const summaries = topLevel
-            .map((s) => ({
-            name: s.name,
-            kind: waterfallKindOf(s.kind),
-            startOffsetMs: s.startMs - t0,
-            durationMs: s.endMs - s.startMs,
-            failed: s.status === "error",
-        }))
-            .sort((a, b) => a.startOffsetMs - b.startOffsetMs);
-        return {
-            experimentId: experimentIdOf(item),
-            evalId: evalIdOf(item),
-            locator: locatorOf(item),
-            durationMs: Math.max(0, t1 - t0),
-            spans: summaries,
-        };
-    }));
-}

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

@@ -1 +0,0 @@
-export { runNoticesContent, sampleFixPromptContent, sampleNoticesContent, sampleTracesContent, } from "./projections.ts";

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

@@ -1,2 +0,0 @@
-// 站点组件 Content 投影：compute 领域结果 → 原语 Content 形状。
-export { runNoticesContent, sampleFixPromptContent, sampleNoticesContent, sampleTracesContent, } from "./projections.js";

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

@@ -1,9 +0,0 @@
-import type { HeroData } from "../../model/types.ts";
-import type { LocalizedText } from "../../model/locale.ts";
-import type { TextContext } from "../../definition/tree.ts";
-import type { HeroBrandProps } from "./hero-types.ts";
-/**
- * HeroCard 的 text 面:标题行 + meta 行(最后运行时间;空范围为内置「暂无运行」文案;
- * 多快照时标注合成来源),不含品牌行(品牌行是纯 web 件,text 面零输出)。
- */
-export declare function heroCardText(title: LocalizedText, data: HeroData, branding: HeroBrandProps, ctx: TextContext): string;

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

@@ -1,34 +0,0 @@
-// HeroCard 的 text 面:同一份算好的数据,渲染成终端字符(niceeval show 的形态)。零 react、零 IO、纯同步。
-import { localeText, resolveLocalizedText } from "../../model/locale.js";
-import { wrapDisplay } from "../../model/text-layout.js";
-/** ISO 时间 → "YYYY-MM-DD HH:mm"(本地时区);不可解析原样返回。 */
-function formatDateTimeMinute(iso) {
-    const date = new Date(iso);
-    if (Number.isNaN(date.valueOf()))
-        return iso;
-    const pad = (n) => String(n).padStart(2, "0");
-    return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())} ${pad(date.getHours())}:${pad(date.getMinutes())}`;
-}
-/**
- * HeroCard 的 text 面:标题行 + meta 行(最后运行时间;空范围为内置「暂无运行」文案;
- * 多快照时标注合成来源),不含品牌行(品牌行是纯 web 件,text 面零输出)。
- */
-export function heroCardText(title, data, branding, ctx) {
-    const locale = ctx.locale;
-    const meta = data.latestStartedAt === null
-        ? localeText(locale, "hero.noRuns")
-        : [
-            localeText(locale, "hero.lastRun", { time: formatDateTimeMinute(data.latestStartedAt) }),
-            ...(data.runs > 1 ? [localeText(locale, "hero.composedSnapshots", { n: data.runs })] : []),
-        ].join(" · ");
-    const lines = [resolveLocalizedText(title, locale)];
-    if (branding.description !== undefined) {
-        lines.push(...wrapDisplay(resolveLocalizedText(branding.description, locale), ctx.width));
-    }
-    for (const link of branding.links ?? []) {
-        const label = resolveLocalizedText(link.label, locale);
-        lines.push(label === link.href ? label : `${label} (${link.href})`);
-    }
-    lines.push(meta);
-    return lines.join("\n");
-}

package/dist/report/components/site-components/hero-types.d.ts

@@ -1,17 +0,0 @@
-import type { LocalizedText } from "../../model/locale.ts";
-/** Hero 顶部的产品标记。src 与原生 img 一样接收浏览器可读取的 URL。 */
-export interface HeroLogo {
-    src: string;
-    alt: LocalizedText;
-}
-/** Hero 内的一条主要外链。 */
-export interface HeroLink {
-    label: LocalizedText;
-    href: string;
-}
-/** Hero / HeroCard 共用的可选品牌内容。 */
-export interface HeroBrandProps {
-    logo?: HeroLogo;
-    description?: LocalizedText;
-    links?: readonly HeroLink[];
-}

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

@@ -1,34 +0,0 @@
-import type { HeroData } from "../../model/types.ts";
-import type { LocalizedText } from "../../model/locale.ts";
-import { type ChromeProps } from "../shared.ts";
-import type { HeroBrandProps, HeroLink, HeroLogo } from "./hero-types.ts";
-import { validateCopyFixPromptData, validateHeroData, validateScopeWarningsData, validateSnapshotDiagnosticsData, validateTraceWaterfallData } from "./validators.ts";
-import type { Sample } from "../../../record/types.ts";
-export { validateCopyFixPromptData, validateHeroData, validateScopeWarningsData, validateSnapshotDiagnosticsData, validateTraceWaterfallData, };
-export interface HeroProps extends HeroBrandProps {
-    title?: LocalizedText;
-    className?: string;
-    /** 显式 Sample；省略时用 ComposeContext.scope。 */
-    input?: Sample;
-}
-export interface HeroCardProps extends HeroBrandProps {
-    title: LocalizedText;
-    data: HeroData;
-    className?: string;
-}
-export declare const HeroCard: import("../../definition/tree.ts").ReportComponent<HeroCardProps>;
-export declare const Hero: import("../../definition/tree.ts").ReportComponent<HeroProps>;
-export type { HeroLink, HeroLogo };
-export declare const PoweredBy: import("../../definition/tree.ts").ReportComponent<Record<never, never>>;
-export type SampleNoticesProps = ChromeProps & {
-    input?: Sample;
-};
-export type RunNoticesProps = ChromeProps & {
-    input?: Sample;
-};
-export type SampleFixPromptProps = ChromeProps & {
-    input?: Sample;
-};
-export declare const SampleNotices: import("../../definition/tree.ts").ReportComponent<SampleNoticesProps>;
-export declare const RunNotices: import("../../definition/tree.ts").ReportComponent<RunNoticesProps>;
-export declare const SampleFixPrompt: import("../../definition/tree.ts").ReportComponent<SampleFixPromptProps>;

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

@@ -1,55 +0,0 @@
-import { jsx as _jsx } from "react/jsx-runtime";
-// 站点身份件(Hero / HeroCard / PoweredBy)与提示组合；取数走公开 to*，组件只接普通值。
-import { defineComponent } from "../../definition/tree.js";
-import { Callouts, CopyBlock } from "../../definition/primitives.js";
-import { dataShapeError } from "../shared.js";
-import { heroCardText } from "./faces.js";
-import { HeroCard as HeroCardWeb } from "./HeroCard.js";
-import { PoweredBy as PoweredByWeb } from "./PoweredBy.js";
-import { validateCopyFixPromptData, validateHeroData, validateScopeWarningsData, validateSnapshotDiagnosticsData, validateTraceWaterfallData, } from "./validators.js";
-import { toHeroData, toRunNotices, toSampleFixPrompt, toSampleNotices, } from "../../model/conversions.js";
-export { validateCopyFixPromptData, validateHeroData, validateScopeWarningsData, validateSnapshotDiagnosticsData, validateTraceWaterfallData, };
-const assertHeroData = (data) => {
-    const problem = validateHeroData(data);
-    if (problem !== null)
-        throw dataShapeError("HeroCard", "toHeroData", "HeroData", problem);
-    return data;
-};
-export const HeroCard = defineComponent({
-    dimensions: () => ({}),
-    web: (props, ctx) => {
-        assertHeroData(props.data);
-        return _jsx(HeroCardWeb, { ...props, locale: ctx.locale });
-    },
-    text: (props, ctx) => {
-        assertHeroData(props.data);
-        return heroCardText(props.title, props.data, props, ctx);
-    },
-});
-HeroCard.displayName = "HeroCard";
-export const Hero = defineComponent(async ({ title, className, input, ...branding }, ctx) => {
-    const data = await toHeroData(input ?? ctx.scope);
-    return (_jsx(HeroCard, { title: title ?? ctx.report.title, data: data, className: className, ...branding }));
-});
-Hero.displayName = "Hero";
-export const PoweredBy = defineComponent({
-    dimensions: () => ({}),
-    web: () => _jsx(PoweredByWeb, {}),
-    text: () => "",
-});
-PoweredBy.displayName = "PoweredBy";
-export const SampleNotices = defineComponent(async (props, ctx) => {
-    const items = await toSampleNotices(props.input ?? ctx.scope);
-    return _jsx(Callouts, { items: items, locale: props.locale, className: props.className });
-});
-SampleNotices.displayName = "SampleNotices";
-export const RunNotices = defineComponent(async (props, ctx) => {
-    const items = await toRunNotices(props.input ?? ctx.scope);
-    return _jsx(Callouts, { items: items, locale: props.locale, className: props.className });
-});
-RunNotices.displayName = "RunNotices";
-export const SampleFixPrompt = defineComponent(async (props, ctx) => {
-    const content = await toSampleFixPrompt(props.input ?? ctx.scope);
-    return _jsx(CopyBlock, { content: content, locale: props.locale, className: props.className });
-});
-SampleFixPrompt.displayName = "SampleFixPrompt";