export type DocsRepositorySource = "worktree" | "index";
/**
 * One coherent repository view for documentation commands.
 *
 * Worktree mode preserves the interactive commands' existing behavior. Index
 * mode reads both path membership and file bytes through Git, so a pre-commit
 * hook validates the exact index Git handed to it. During a path-scoped commit,
 * Git exposes its temporary partial-commit index through GIT_INDEX_FILE; the
 * view deliberately inherits that environment instead of rediscovering the
 * shared working tree.
 */
export interface DocsRepositoryView {
    readonly root: string;
    readonly source: DocsRepositorySource;
    readonly trackedPaths: readonly string[];
    has(path: string): boolean;
    directFileNames(directory: string): string[];
    readTexts(paths: readonly string[]): Promise<Map<string, string>>;
    byteLength(path: string): Promise<number | null>;
}
export declare function createDocsRepositoryView(root: string, source?: DocsRepositorySource): Promise<DocsRepositoryView>;
//# sourceMappingURL=docs-repository-view.d.ts.map