import type { SurpriseEdgeResult, BridgeEdgeResult, ExecutionFlow, KnowledgeGapResult } from './types';
export interface SuggestedQuestion {
    /** The user-facing prompt. */
    text: string;
    /** Anomaly category that produced this question. */
    kind: 'surprise' | 'bridge' | 'untested' | 'flow';
    /** 0..1 ranking score — higher = more interesting. */
    score: number;
    /** File paths referenced in the question, for in-TUI highlighting. */
    focusPaths: string[];
}
export interface SuggestInput {
    surprises?: readonly SurpriseEdgeResult[];
    bridges?: readonly BridgeEdgeResult[];
    untested?: readonly KnowledgeGapResult[];
    flows?: readonly ExecutionFlow[];
}
export interface SuggestOptions {
    /** Max questions returned, after cross-category de-duplication. Default 5. */
    limit?: number;
    /** Per-category cap before interleaving. Default 2. */
    perCategory?: number;
}
/**
 * Generates ranked, de-duplicated suggested questions from graph
 * anomaly outputs. Deterministic for a given input — sorting is total
 * (score desc, then path, then text) so snapshot tests are stable.
 */
export declare function generateSuggestedQuestions(input: SuggestInput, opts?: SuggestOptions): SuggestedQuestion[];
//# sourceMappingURL=suggest.d.ts.map