export interface CopyLatestBoilerplateResult {
    promptCopied: boolean;
    templateCopied: boolean;
}
/**
 * Copy the latest bundled docspec-prompt.md and docspec-template.md into .docspec/.
 * Overwrites existing files so the project gets the current boilerplate.
 */
export declare function copyLatestBoilerplate(repoRoot: string): Promise<CopyLatestBoilerplateResult>;
export interface EnsureDocAndDocspecOptions {
    /** If true, overwrite existing docspec file (markdown is never overwritten). If false, skip when docspec exists. */
    overwrite?: boolean;
}
export interface EnsureDocAndDocspecResult {
    markdownCreated: boolean;
    docspecCreated: boolean;
}
/**
 * Ensure both the markdown file and its docspec exist. Creates an empty markdown file and a
 * docspec from the template when missing. Markdown is only created when missing (never overwritten).
 * Docspec is overwritten when options.overwrite is true.
 * @param markdownPath Repo-relative markdown path (e.g. README.md, docs/deploy.md).
 * @param repoRoot Repo root directory.
 * @param options.overwrite If true, overwrite existing docspec; if false, skip when docspec exists. Does not affect markdown.
 * @returns Which files were created or overwritten.
 */
export declare function ensureDocAndDocspec(markdownPath: string, repoRoot: string, options?: EnsureDocAndDocspecOptions): Promise<EnsureDocAndDocspecResult>;
/**
 * Generate docspec content as a string (for library use)
 * @param targetFilePath Path to the target markdown file (e.g., "README.md")
 */
export declare function generateDocspecContent(targetFilePath: string): string;
//# sourceMappingURL=create.d.ts.map