/**
 * discovery-log — record the source-tracking `discovery:` block on a citation
 * sidecar (#1499). Adds or replaces the block in the sidecar frontmatter,
 * preserving the rest of the file. Dry-run unless `write`.
 *
 * The `discovery` block is OPTIONAL by design (SOURCE-TRACKING §0): `date` +
 * `surface` are the only meaningful required fields; `curator-id` is set only
 * when the source came through a named, repeatable curator.
 *
 * @source historical: documentation/SOURCE-TRACKING.md §1
 */
export interface DiscoveryFields {
    surface: string;
    date?: string;
    via?: string;
    curatorId?: string;
    harvestBatch?: string;
    harvestedBy?: string;
}
export interface DiscoveryLogOptions extends DiscoveryFields {
    write?: boolean;
}
export interface DiscoveryLogResult {
    refId: string;
    status: 'wrote' | 'dry-run' | 'skip';
    message: string;
    /** The rendered discovery block (always present). */
    block: string;
    /** The full sidecar content after splicing (dry-run + wrote). */
    content?: string;
}
/** Render the `discovery:` YAML block (2-space indented under the key). */
export declare function renderDiscoveryBlock(f: DiscoveryFields, today: string): string;
/** Add or replace the discovery block in REF-XXX-citations.md frontmatter. */
export declare function logDiscovery(corpusRoot: string, refId: string, opts: DiscoveryLogOptions): DiscoveryLogResult;
//# sourceMappingURL=discovery-log.d.ts.map