import type { ProbeOutcome } from "../schema.js";
/** 文档校验结果（供 doc-structure-match probe + checkDocsText 命令共享） */
export interface DocValidationResult {
    ok: boolean;
    errors: string[];
    /** 仅供错误信息输出——文档路径（绝对或相对） */
    docPath: string;
    /** 内联原因（如 “无 frontmatter”） */
    reason?: string;
}
/** 两级查找 schema 文件路径：项目级覆盖 > builtin 默认。
 *  - 项目级：`cwd/.pt/schemas/<schemaName>`（用户自建覆盖，粒度 = 单文件名）
 *  - builtin fallback：`src/builtin/schemas/<schemaName>`（随包发布，跨项目复用）
 *  - 返回 null 表示两级都不存在（调用方决定 INCONCLUSIVE / 抛错） */
export declare function resolveSchemaPath(cwd: string, schemaName: string): string | null;
/** 内核函数：给定文档路径 + schema 名，返回校验结果（不构造 ProbeOutcome）。
 *  - 错误格式：完整错误描述列表（供 probe / 命令层格式化）
 *  - IO 错误不熔，抛 Error（命令层 / probe 层各自决定 INCONCLUSIVE / 错误提示） */
export declare function validateDoc(cwd: string, docPath: string, schemaName: string): Promise<DocValidationResult>;
/** doc-structure-match probe：校验文档 frontmatter 是否符合指定 schema 文件。
 *  - params.path：文档相对路径（如 .pt/docs/issues/xxx.md）
 *  - params.schema：schema 文件名（如 issue.frontmatter.schema.json） */
export declare function docStructureMatch(cwd: string, params: Record<string, string>): Promise<ProbeOutcome>;