export interface MetadataInvariant {
    ok: boolean;
    message: string;
}
export interface MetadataSnapshot {
    command_definitions_total: number;
    workflow_command_definitions: number;
    workflow_base_definitions: number;
    workflow_extended_definitions: number;
    workflow_base_files: number;
    workflow_command_files: number;
    workflow_total_expected: number;
    agent_definitions: number;
    agent_content_files: number;
    mode_definitions: number;
    mode_content_files: number;
    persona_definitions: number;
    persona_content_files: number;
    skill_definitions: number;
    skill_content_files: number;
    invariants: MetadataInvariant[];
}
export declare const METADATA_MARKER_START = "<!-- supercodex:metadata:start -->";
export declare const METADATA_MARKER_END = "<!-- supercodex:metadata:end -->";
export declare const METADATA_README_ANCHOR = "## Why SuperCodex";
export declare function collectMetadataSnapshot(): MetadataSnapshot;
export declare function renderMetadataReadmeBlock(snapshot: MetadataSnapshot): string;
export declare function renderMetadataDoc(snapshot: MetadataSnapshot): string;
export declare function upsertMetadataReadmeBlock(content: string, block: string): string;