/**
 * pipeline/compare.ts
 *
 * Core comparison primitive for the evaluation framework.
 *
 * Takes two ScoreSummary objects (baseline and experiment) and produces a
 * structured ComparisonReport with overall, per-area, and per-dimension
 * deltas, plus improved/regressed/unchanged classification.
 *
 * This is the single function that backs all comparison scenarios:
 * doc improvement, model comparison, branch validation, etc.
 * What varies is what produced each ScoreSummary — the comparison
 * logic is always the same.
 *
 * @see docs/ideas/evaluation-roadmap.md — BP5: Make comparison a primitive
 * @see docs/ideas/metrics-design.md — Tier 4: Comparison results
 */
import { type ChangeClass, type ComparableSummary, type CompareOptions, type ComparisonReport } from "./types.js";
/** Classify a delta as improved, regressed, or unchanged given a threshold */
export declare function classifyChange(delta: number, threshold: number): ChangeClass;
/**
 * Compare two evaluation score summaries and produce a structured report.
 *
 * This is a pure function — no side effects, no file I/O.
 *
 * @param baseline  The "before" or "control" score summary
 * @param experiment  The "after" or "treatment" score summary
 * @param options  Optional configuration (noise threshold, etc.)
 * @returns A ComparisonReport with deltas, classifications, and breakdowns
 */
export declare function compare(baseline: ComparableSummary, experiment: ComparableSummary, options?: CompareOptions): ComparisonReport;
