/**
 * Knowledge context section for compiled platform output (KG Req 6.4, 9.2).
 *
 * Every platform adapter embeds this section in its instruction artifact
 * (CLAUDE.md, Kiro steering, .cursorrules, AGENTS.md, Windsurf rules). When
 * the project has no knowledge graph the section is omitted entirely: no noise
 * for non-adopters.
 *
 * When the project *has* one and the block still goes — every source file broken,
 * or the index unreadable — the caller is told, with the file named where there is
 * one. The block used to vanish from `CLAUDE.md` with nothing said: the parser's
 * warning reached `engine.warnings` and nothing read it, and an index that could not
 * be opened threw past the `try` meant to contain it
 * (knowledge-block-vanishes-silently/AC-1 – AC-4).
 *
 * What it must never do is keep the old rows when the sources stop parsing. That is
 * serving stale facts, the defect knowledge-index-misses-merged-yaml removed; the
 * block goes, and someone is told (AC-6).
 *
 * @module
 */
/** The rendered block and what the caller must print about it. */
export interface KnowledgeSection {
    /** The `# Codebase Knowledge` block, or null when it is left out. */
    markdown: string | null;
    /**
     * Everything wrong with the sources or the index, for the caller to print once per
     * run — not once per platform, which is why rendering is the caller's to hoist
     * (AC-5, design DD1).
     */
    warnings: string[];
}
/**
 * Render the "Codebase Knowledge" markdown section, and the warnings to print
 * about it.
 *
 * @param projectRoot - Absolute project root.
 * @param maxTokens - Token budget for the generated summary (default 2000).
 */
export declare function renderKnowledgeSection(projectRoot: string, maxTokens?: number): KnowledgeSection;
//# sourceMappingURL=knowledge-section.d.ts.map