/**
 * +5% multiplicative bonus for files that conventionally serve as a
 * module's entry point. Cheap disambiguation for files-with-the-same-name
 * cases.
 */
export declare function entryPointBonus(filePath: string): number;
/**
 * Path-suffix alignment. When the user typed a path-shaped query (one
 * containing a separator), files whose path *ends* with that fragment
 * are dramatically more likely to be the intended target. Score by the
 * number of matched trailing segments × per-segment weight.
 *
 * Returns a multiplicative factor in [1.0, 1.4]. No-op (1.0) for
 * non-path queries or when no suffix overlap exists.
 *
 * Borrowed shape from fff.nvim score.rs:677-700.
 */
export declare function pathSuffixAlignmentBonus(query: string, filePath: string): number;
/**
 * When the MCP caller provides the file the user is currently editing,
 * penalize candidates by directory distance. Files in the same dir or a
 * sibling are more relevant than something across the repo. Borrowed
 * from fff.nvim path_utils.rs:36-92.
 *
 * Returns a multiplicative factor in (0.5, 1.0]. No-op when currentFile
 * is undefined.
 *
 * The penalty is gentle because the structural signals (PageRank, RRF)
 * already do a lot of work — we only want to break ties between two
 * otherwise-equivalent candidates.
 */
export declare function currentFileDistancePenalty(candidatePath: string, currentFile: string | undefined): number;