import type { WarpContext } from "./context.js";
import { type StaleDocReport } from "./stale-docs.js";
import type { GitClient } from "../ports/git.js";
/** Options for the drift sentinel scan. */
export interface DriftSentinelOptions {
    readonly cwd: string;
    readonly git: GitClient;
    /** Glob pattern for markdown files to check. Defaults to all tracked .md files. */
    readonly pattern?: string;
}
/** Full drift report across all scanned doc files. */
export interface DriftSentinelReport {
    /** True if no stale or unknown symbols were found in any doc. */
    readonly passed: boolean;
    /** Per-file results. */
    readonly results: readonly StaleDocReport[];
    /** Total stale symbol count across all files. */
    readonly totalStale: number;
    /** Total unknown symbol count across all files. */
    readonly totalUnknown: number;
}
/**
 * Scan all markdown files in the repo for stale symbol references.
 *
 * For each tracked `.md` file, runs `checkStaleDocs` against the WARP
 * graph. Returns a structured report with pass/fail verdict suitable
 * for pre-commit hook exit codes.
 */
export declare function runDriftSentinel(ctx: WarpContext, options: DriftSentinelOptions): Promise<DriftSentinelReport>;
//# sourceMappingURL=drift-sentinel.d.ts.map