export type CodegraphPreflightResult = {
    available: true;
    block: string;
    fileCount: number;
    truncated: boolean;
} | {
    available: false;
    note: string;
};
/** Cap for the directory histogram in the rendered structure block. */
export declare const CODEGRAPH_STRUCTURE_MAX_DIRS = 40;
/** Cap for bare root files listed in the rendered structure block. */
export declare const CODEGRAPH_STRUCTURE_MAX_ROOT_FILES = 12;
export interface CodegraphStructureFileEntry {
    readonly path: string;
}
export interface CodegraphStructureRenderOptions {
    readonly maxDirs?: number;
    readonly maxRootFiles?: number;
}
export interface CodegraphStructureSummary {
    /** Full `## Codegraph structure` markdown block, ending on its own paragraph. */
    block: string;
    total: number;
    truncated: boolean;
}
/** Strip a leading `./` (upstream codegraph paths may carry it). */
export declare function normalizeCodegraphPath(path: string): string;
export declare function parseFilesPayload(stdout: string): {
    ok: boolean;
    entries: CodegraphStructureFileEntry[];
};