/**
 * 知识生命周期管理 — 问题七 (Knowledge Lifecycle)。
 *
 * 管理知识条目的生命周期状态、主权和健康检查。
 * - knowledge_lifecycle_status 使用规范字段名（draft/quarantine/active/pending_review/deprecated）
 * - sovereignty 使用 normal / core（与问题正文和 Batch 1 一致）
 * - staged 不再作为生命周期主状态，改为 knowledge_write_stage
 * - core 不再作为生命周期状态，改为 sovereignty=core
 */
import type { KnowledgeLifecycleStatus, KnowledgeSovereignty, KnowledgeWriteStage, KnowledgeHealthFinding, KnowledgeEvidence } from "./knowledge_template_contracts.js";
export type { KnowledgeLifecycleStatus, KnowledgeSovereignty, KnowledgeWriteStage };
/** 知识条目 — 使用 knowledge_lifecycle_status，不使用泛称 state/status */
export interface KnowledgeLifecycleEntry {
    /** 条目 ID */
    id: string;
    /** 知识生命周期状态 — 使用 knowledge_lifecycle_status */
    knowledge_lifecycle_status: KnowledgeLifecycleStatus;
    /** 知识主权 — sovereignty: normal / core */
    sovereignty: KnowledgeSovereignty;
    /** 写入阶段 — staged / committed */
    knowledge_write_stage: KnowledgeWriteStage;
    /** 创建时间戳 */
    created_at: string;
    /** 最后更新时间戳 */
    updated_at: string;
    /** 内容摘要 */
    content_summary?: string;
    /** 来源路径 */
    source_path?: string;
}
/** 晋级请求 */
export interface PromotionRequest {
    entry_id: string;
    from_status: KnowledgeLifecycleStatus;
    to_status: KnowledgeLifecycleStatus;
    from_sovereignty: KnowledgeSovereignty;
    to_sovereignty: KnowledgeSovereignty;
    evidence_ids: string[];
    requested_by: "ai_inference" | "drift_detection" | "human" | "sync_mechanism" | "user_instruction";
}
/** 晋级判定结果 */
export interface PromotionResult {
    allowed: boolean;
    reason: string;
    blocked_by?: string;
    requires_human: boolean;
}
/**
 * 评估知识晋级请求。
 * 硬规则：
 * - AI inference 不得直接晋级到 active/core
 * - core 知识变更必须人工确认
 * - draft/quarantine 不得自动晋级 active/core
 * - 无 evidence 不得晋级
 */
export declare function evaluatePromotion(request: PromotionRequest): PromotionResult;
/**
 * 判断知识条目是否可注入。
 * 硬规则：
 * - active 可注入
 * - draft/quarantine/deprecated 不注入
 * - pending_review 默认不注入，advisory 例外
 * - core + active 可注入
 * - core + pending_review 不自动降级
 */
export declare function isInjectable(status: KnowledgeLifecycleStatus, advisory?: boolean): {
    injectable: boolean;
    reason: string;
};
/**
 * 知识健康检查 — 覆盖 8 类 category。
 * 异步版本: 漂移检测改用 fs.promises.readFile 消除同步 I/O。
 */
export declare function checkKnowledgeHealth(entries: KnowledgeLifecycleEntry[], evidenceMap: Map<string, KnowledgeEvidence[]>): Promise<KnowledgeHealthFinding[]>;
/**
 * 列出所有知识条目（空实现，实际由上层 knowledge loader 提供）。
 */
export declare function listKnowledgeEntries(): KnowledgeLifecycleEntry[];
/**
 * 从旧路径推断 sovereignty。
 * patterns/core/ 下的旧知识默认推断为 sovereignty=core。
 */
export declare function inferSovereigntyFromPath(sourcePath: string): KnowledgeSovereignty;
/**
 * 执行 auto_action — 根据 health check 的自动动作建议修改知识状态。
 * 仅 mark_pending_review: 将 active 条目自动降级为 pending_review。
 *
 * @param findings - health check 产出
 * @param getEntry - 获取条目的回调（由调用方注入 KnowledgeIndexManager.getEntry）
 * @param updateStatus - 更新条目状态的回调
 * @returns 被执行的条目 ID 列表
 */
export declare function executeAutoActions(findings: KnowledgeHealthFinding[], getEntry: (id: string) => {
    status: string;
    knowledge_lifecycle_status?: string;
} | undefined, updateStatus: (id: string, newStatus: KnowledgeLifecycleStatus) => void): string[];
//# sourceMappingURL=knowledge_lifecycle.d.ts.map