/** @internal — exposed for testing only */
export declare function resetShieldContextHintsWarning(): void;
export interface ShieldContextAnnotation {
    /** Relative file path within the project */
    file: string;
    /** 1-based line number where the annotation was found */
    line: number;
    /** The annotation text (trimmed) */
    text: string;
}
/**
 * Extract structured shield/totem-context annotations from changed files.
 * Returns file, line number, and text for each annotation found.
 * Used by the Trap Ledger to record override events.
 */
export declare function extractShieldContextAnnotations(changedFiles: string[], cwd: string): ShieldContextAnnotation[];
/**
 * Auto-detect contextual hints from the diff and changed files.
 * Accepts optional pre-computed annotations to avoid double file reads.
 */
export declare function extractShieldHints(diff: string, changedFiles: string[], cwd: string, precomputedAnnotations?: ShieldContextAnnotation[]): string[];
//# sourceMappingURL=shield-hints.d.ts.map