import type { PlanContext } from "./plan.js";
export interface GitReadOptions {
    /** Preserve exact stdout bytes when Git itself supplies record delimiters. */
    trim?: boolean;
}
/**
 * Run a read-only git command scoped to the repo root, through the injected
 * Runner (so tests stay hermetic). Returns trimmed stdout, or `undefined` when
 * git is absent / the command fails — callers branch on `undefined` rather than
 * inspecting exit codes.
 */
export declare function gitRead(ctx: PlanContext, args: string[], options?: GitReadOptions): Promise<string | undefined>;
/** Parse a base-10 int from possibly-undefined git output; `fallback` on miss. */
export declare function gitInt(s: string | undefined, fallback?: number): number;