import type { SearchResult } from "@younndai/lyt-vault";
export declare const NDCG_K = 10;
export declare function dcg(grades: readonly number[]): number;
export declare function round3(x: number): number;
export interface GradedQuery {
    id: string;
    query: string;
    scope: "federation" | "vault" | "mesh";
    scopeTarget?: string;
    grades: Record<string, number>;
    traps?: string[];
}
export interface GradedQueryScore {
    id: string;
    query: string;
    nResults: number;
    recall: number;
    mrr: number;
    ndcg: number;
    pAt1: number;
    trapHits: number;
}
export declare function scoreGradedQuery(q: GradedQuery, results: readonly SearchResult[]): GradedQueryScore;
export interface GradedAggregate {
    queries: number;
    ndcg: number;
    recall: number;
    mrr: number;
    pAt1: number;
    cleanliness: number;
}
export declare function aggregateGraded(scores: readonly GradedQueryScore[]): GradedAggregate;
//# sourceMappingURL=ir-metrics.d.ts.map