/**
 * Ensure .docspec/docspec-prompt.md exists, seeding from bundled default (or legacy agent-prompt.md /
 * review-task.md) if missing. Call this from `docspec create` so both template and prompt are seeded on first run.
 */
export declare function ensureDocspecPromptFile(repoRoot: string): Promise<void>;
export type ReviewMode = "inline" | "batch";
export interface DocspecReviewOptions {
    /** Markdown file path(s) to review (repo-relative). When set, only these docspecs are included; no PR diff. */
    reviewFiles?: string[];
    /** List of changed file paths (repo-relative). If not set and no reviewFiles, base and merge must be set. */
    changedFiles?: string[];
    /** Base SHA for git diff (e.g. PR base or last-run marker). */
    base?: string;
    /** Merge SHA for git diff (e.g. PR merge commit or HEAD). */
    merge?: string;
    /** Base branch name (e.g. main, develop). Used to tell the agent which branch to target when creating PRs. */
    baseRef?: string;
    /** Max number of docspecs to include. */
    maxDocspecs?: number;
    /** Max characters of diff/diffstat to include. */
    maxDiffChars?: number;
    /** Max number of changed file paths to list in batch mode. */
    maxChangedFiles?: number;
    /** Repo root (default process.cwd()). */
    repoRoot?: string;
    /**
     * Prompt shape. "inline" (default) embeds full diff + docspec/markdown content.
     * "batch" emits a compact summary (diffstat + path pairs) for daily multi-commit windows.
     */
    mode?: ReviewMode;
    /**
     * Commit SHAs to exclude when computing the changed-file set (e.g. previous docspec-bot
     * squash merges). Files touched only by excluded commits are dropped; files also touched
     * by a non-excluded commit stay in scope.
     */
    excludeCommits?: string[];
}
/**
 * Build the review prompt (sync markdown with docspecs). When reviewFiles is set, only those
 * docspecs are included (no diff). Otherwise uses PR/window changed files and diff.
 * Covers Case A (existing docspec+markdown), Case B (new docs from changes), Case C (existing markdown without docspec).
 * If options.outputPath is set, writes the prompt to that file.
 */
export declare function buildDocspecReviewPrompt(options: DocspecReviewOptions & {
    outputPath?: string;
}): Promise<{
    prompt: string;
    outputPath: string | null;
}>;
//# sourceMappingURL=review.d.ts.map