/**
 * 文档治理 — 问题二十一 核心实现。
 *
 * 职责:
 * - 制品策略定义（允许/禁止内容、事实源、更新触发条件）
 * - 设计文档准入校验（proposed/accepted_in_memo 不得写入正式设计文档）
 * - 禁止内容合规检查
 * - 注册表与设计文档状态冲突检测
 * - 备忘录决策停滞检测
 */
import type { DocumentationArtifactPolicy, DesignDocEligibility } from "./knowledge_template_contracts.js";
/** 文档治理发现 */
export interface DocGovernanceFinding {
    id: string;
    severity: "hard_fail" | "warning" | "info";
    rule: string;
    artifact_type: DocumentationArtifactPolicy["artifact"];
    message_zh: string;
    evidence_ref?: string;
}
export declare const BUILTIN_ARTIFACT_POLICIES: DocumentationArtifactPolicy[];
/**
 * 校验设计文档准入资格。
 *
 * 只有 "verified" 或 "design_doc_eligible" 状态可以写入正式设计文档。
 * "proposed" 或 "accepted_in_memo" 状态不得进入正式设计文档（硬拒绝）。
 * 必须提供证据引用。
 */
export declare function validateDesignDocEligibility(eligibility: DesignDocEligibility): {
    allowed: boolean;
    reason: string;
};
/**
 * 检查文档内容合规性 — 扫描禁止内容模式。
 *
 * 对每个匹配的禁止模式生成一条发现。
 * 如果传入自定义 forbiddenPatterns，以自定义列表为准；
 * 否则使用内置制品策略中该 artifact 类型的禁止列表。
 */
export declare function checkDocContentCompliance(artifactType: DocumentationArtifactPolicy["artifact"], content: string, forbiddenPatterns?: string[]): DocGovernanceFinding[];
/**
 * 检查注册表与设计文档之间的状态冲突。
 *
 * 注册表为事实源：如果注册表中某策略为 advisory（建议级），
 * 但设计文档中声称该策略为 enforced（强制级），则产生硬拒绝发现。
 */
export declare function checkRegistryDesignDocConflict(registryState: string, designDocState: string): DocGovernanceFinding | null;
/**
 * 检查备忘录决策停滞 — accepted_in_memo 状态超过阈值未推进。
 *
 * 这些决策在备忘录中被接受，但长期未推进到 verified 或 design_doc_eligible，
 * 可能意味着遗忘或阻塞，需要提醒开发者关注。
 */
export declare function checkAcceptedMemoStaleness(eligibilities: DesignDocEligibility[], staleThresholdDays: number): DocGovernanceFinding[];
//# sourceMappingURL=documentation_governance.d.ts.map