export type HandoffLifecycleStatus = "open" | "accepted" | "blocked" | "completed";
export interface HandoffLifecycleEvent {
    timestamp_utc: string;
    status: HandoffLifecycleStatus;
    actor: string;
    note?: string;
}
export interface HandoffRecord {
    handoff_id: string;
    created_at: string;
    updated_at: string;
    from: string;
    to: string;
    title: string;
    task_type?: string;
    priority?: string;
    source_file?: string;
    status: HandoffLifecycleStatus;
    history: HandoffLifecycleEvent[];
}
export interface HandoffRegistryFile {
    version: 1;
    updated_at: string;
    handoffs: Record<string, HandoffRecord>;
}
export interface RegisterHandoffInput {
    handoff_id: string;
    from: string;
    to: string;
    title: string;
    task_type?: string;
    priority?: string;
    source_file?: string;
    actor?: string;
    note?: string;
}
export interface AcknowledgeHandoffInput {
    handoff_id: string;
    status: HandoffLifecycleStatus;
    actor?: string;
    note?: string;
}
export interface HandoffAckResult {
    ok: boolean;
    error?: string;
    allowed?: HandoffLifecycleStatus[];
    previous_status?: HandoffLifecycleStatus;
    record?: HandoffRecord;
    path: string;
}
export declare function readHandoffRegistry(): HandoffRegistryFile;
export declare function registerHandoff(input: RegisterHandoffInput): {
    record: HandoffRecord;
    path: string;
    duplicate?: boolean;
};
export declare function acknowledgeHandoff(input: AcknowledgeHandoffInput): HandoffAckResult;
export declare function getHandoffRegistryPath(): string;
/**
 * Concurrency-safe variant of registerHandoff.
 */
export declare function registerHandoffSafe(input: RegisterHandoffInput): Promise<{
    record: HandoffRecord;
    path: string;
    duplicate?: boolean;
}>;
/**
 * Concurrency-safe variant of acknowledgeHandoff.
 */
export declare function acknowledgeHandoffSafe(input: AcknowledgeHandoffInput): Promise<HandoffAckResult>;
//# sourceMappingURL=handoff-registry.d.ts.map