/**
 * doc-insert handler — PR-5a-1
 *
 * Markdown section upsert into a target file (e.g. CLAUDE.md).
 *
 * Semantics:
 *   - If the target file does not exist, it is created with the section.
 *   - If the section header already exists (## <header>), the section body
 *     is replaced in-place (idempotent replace).
 *   - If the section header is absent, the header + body is appended at the
 *     end of the file.
 *
 * Idempotency: applying the same doc-insert twice produces the same file.
 *
 * @connexum/ai-governance PR-5a-1
 */
import { DocInsertPayload, RemediationDiff } from '../types';
export interface DocInsertApplyResult {
    filePath: string;
    before: string;
    after: string;
    diff: RemediationDiff;
    alreadyApplied: boolean;
}
/**
 * Compute the updated file content for a doc-insert.
 * Returns before + after strings; caller decides whether to write.
 */
export declare function applyDocInsert(agentDir: string, payload: DocInsertPayload): DocInsertApplyResult;
/**
 * Write the updated file to disk.
 */
export declare function writeDocInsert(agentDir: string, payload: DocInsertPayload): DocInsertApplyResult;
//# sourceMappingURL=doc-insert.d.ts.map