/**
 * Near-miss reporting for smarter_cache and search_memory.
 *
 * Both tools already compute a top candidate's similarity on a miss and then discard it,
 * returning a miss that looks identical whether the best match was 5% similar (nothing
 * related exists) or 74% similar against a 75% floor (this is very likely the same question,
 * phrased differently — the caller should consider update_memory on the existing entry
 * instead of storing a fresh, near-duplicate one). This module only buckets and formats a
 * number both tools already had; it does not change the floor or invent new scoring.
 */
export interface NearMissCandidate {
    id: string;
    query: string;
    similarity: number;
}
export interface NearMissResult {
    nearMiss: boolean;
    hint?: string;
}
/**
 * `candidate` is the top-ranked result on a miss (similarity below `threshold`), or undefined
 * if the corpus had nothing at all to compare against. `band` is how close under the
 * threshold still counts as "near" — default 0.08, i.e. a 0.75 floor treats 0.67+ as a near
 * miss.
 */
export declare function bucketNearMiss(candidate: NearMissCandidate | undefined, threshold: number, band?: number): NearMissResult;
//# sourceMappingURL=NearMiss.d.ts.map