import type { GitFacts } from '@manehorizons/cadence-types';
export interface GitFactsOptions {
    /** Run a best-effort `git fetch --quiet` first so ahead/behind are current.
     *  Soft: offline / no remote leaves fetched=false and facts still valid. */
    fetch?: boolean;
}
/** Best-effort, read-only. Never throws: non-repo / missing git → unavailable. */
export declare function readGitFacts(root: string, opts?: GitFactsOptions): Promise<GitFacts>;
//# sourceMappingURL=git-facts.d.ts.map