export type GitRemote = {
    name: string;
    url: string;
};
export type GitBranch = {
    name: string;
    current: boolean;
    ref?: string;
};
export type GitTag = {
    name: string;
    ref: string;
};
export type GitCommit = {
    sha: string;
    subject: string;
    authorName: string;
    authorEmail: string;
    timestamp: number;
};
export type GitWorkingTreeState = {
    clean: boolean;
    modified: number;
    added: number;
    deleted: number;
    untracked: number;
};
export type GitRepositoryState = {
    gitDir: string;
    headRef?: string;
    headSha?: string;
    isBare: boolean;
    isShallow: boolean;
    formatVersion?: number;
};
export interface GitProvider {
    /** Return true if the given path is inside a Git working tree. */
    isGitRepository(path: string): Promise<boolean>;
    /** Read repository identity and format metadata. */
    getRepositoryState(path: string): Promise<GitRepositoryState | undefined>;
    /** List configured remotes. */
    getRemotes(path: string): Promise<GitRemote[]>;
    /** List local branches. */
    getBranches(path: string): Promise<GitBranch[]>;
    /** List tags. */
    getTags(path: string): Promise<GitTag[]>;
    /** Read recent commits from the current branch. */
    getRecentCommits(path: string, limit: number): Promise<GitCommit[]>;
    /** Report working tree cleanliness. */
    getWorkingTreeState(path: string): Promise<GitWorkingTreeState>;
}
/**
 * In-memory GitProvider for testing.
 */
export declare function createInMemoryGitProvider(repositoryState?: Record<string, GitRepositoryState | undefined>, remotes?: Record<string, GitRemote[]>, branches?: Record<string, GitBranch[]>, tags?: Record<string, GitTag[]>, commits?: Record<string, GitCommit[]>, workingTreeStates?: Record<string, GitWorkingTreeState>): GitProvider;