/** 查询命中方式：direct=关键词直接命中 / intent_retry=空命中后用任务意图二次检索命中 / visibility_fallback=仍空，返回可见性清单 */
export type KnowledgeQueryMatchMode = "direct" | "intent_retry" | "visibility_fallback";
/** query 审计记录（摘要字段，不含返回正文） */
export interface KnowledgeQueryAuditRecord {
    keywords: string[];
    hitCount: number;
    hitIds: string[];
    empty: boolean;
    matchMode: KnowledgeQueryMatchMode;
}
/** 组装单行审计 JSON；字段全截断，长 keywords 不报错。 */
export declare function buildKnowledgeQueryAuditLine(record: KnowledgeQueryAuditRecord): string;
/** 追加一行 query 审计；文件超上限时保留最近一半行重写。任何失败仅 debug，不向上抛。 */
export declare function appendKnowledgeQueryAudit(projectRoot: string, record: KnowledgeQueryAuditRecord): Promise<void>;