/**
 * Handoff frontmatter — parser.
 *
 *       Phase 1, Task 4.
 *
 * Reads a markdown handoff file from disk and splits it into:
 *   - `frontmatter`: structured `HandoffFrontmatter` (parsed from YAML)
 *   - `body`:        the trailing prose
 *
 * Backward compat: legacy handoffs without a `---` frontmatter block are
 * returned with `schema_version: '0'` and `status: 'unknown'` so older
 * artifacts remain readable without any migration step.
 *
 * Required-field enforcement: any `HandoffFrontmatter` with schema_version
 * `'1'` MUST carry all six required fields. Missing fields raise
 * `IncompleteHandoffError` rather than silently substituting defaults.
 */
import type { HandoffFrontmatter } from './handoff-types.js';
export declare class IncompleteHandoffError extends Error {
    readonly code: "INCOMPLETE_HANDOFF";
    constructor(message: string);
}
export interface ParsedHandoff {
    readonly frontmatter: HandoffFrontmatter;
    readonly body: string;
}
export declare function parseHandoff(filePath: string): ParsedHandoff;