/**
 * Shared YAML-frontmatter parsing + status reads for lifecycle docs
 * (plans / issues / handoffs). Kept generic: no host-specific vocabulary, so
 * it can live next to docs-sweep / docs-lint and ship in the published package.
 */
export interface ParsedFrontmatter {
    /** Parsed YAML mapping (empty object when there is no frontmatter). */
    data: Record<string, unknown>;
    /** Document body after the closing `---` (or the whole text when none). */
    body: string;
    /** Raw YAML block text, or null when the doc has no frontmatter. */
    raw: string | null;
}
/** Doc lifecycle kinds that carry a status. */
export type DocKind = "plan" | "issue" | "handoff";
/**
 * Split leading YAML frontmatter from a markdown document.
 * Never throws: malformed YAML yields an empty `data` with the block still
 * stripped from `body`, so status readers do not need try/catch.
 */
export declare function parseFrontmatter(text: string): ParsedFrontmatter;
/** Read a canonical v2 lifecycle status, or null when absent or invalid. */
export declare function readDocStatus(filePath: string, kind?: DocKind): string | null;
/** Same as {@link readDocStatus} but from an in-memory string (testable). */
export declare function readDocStatusFromText(content: string, kind?: DocKind): string | null;
/** Whether a doc carries a non-empty status in leading YAML frontmatter. */
export declare function hasYamlStatus(content: string): boolean;
//# sourceMappingURL=docs-frontmatter.d.ts.map