import { type MergedOntology } from './types';
/**
 * 原子写入——先写临时文件，再 rename 覆盖目标。
 * rename 在同文件系统上是原子操作，防止并发写脏读。
 */
/**
 * 解析 Markdown 文件的 YAML frontmatter
 */
/** 单条跳过记录 */
export interface OntologySkipEntry {
    /** 实体文件名（entities/ 目录内相对名） */
    file: string;
    /** 病因分类：no-frontmatter（缺 --- 分隔符）/ yaml-error（YAML 语法错）/ unreadable（文件不可读） */
    reason: 'no-frontmatter' | 'yaml-error' | 'unreadable';
    /** 病因补充说明（YAML 异常消息等） */
    detail?: string;
}
/** skip-log.json 落盘形状 */
export interface OntologySkipLog {
    /** 本次合并时间（ISO 8601） */
    mergedAt: string;
    /** 扫描的实体文件总数 */
    scanned: number;
    /** 跳过清单 */
    skipped: OntologySkipEntry[];
}
/**
 * 读取最近一次 mergeOntology 的跳过清单（内存版，测试/进程内对账用）
 */
export declare function getLastMergeSkipLog(): OntologySkipLog;
/**
 * 合并 Ontology——扫描所有数据源并写入 ontology/ 目录
 * @param configDir .sofagent/ 配置目录路径
 * @returns MergedOntology 合并结果
 */
export declare function mergeOntology(configDir: string): MergedOntology;
/**
 * 检查 ontology/ 目录是否存在（用于 --doctor）
 * @param configDir .sofagent/ 配置目录路径
 * @returns 存在且在 24 小时内更新过
 */
export declare function checkOntologyStatus(configDir: string): {
    exists: boolean;
    fresh: boolean;
    objectCount: number;
    actionCount: number;
    constraintCount: number;
};
/** 迁移请求 */
export interface LifecycleMigrationRequest {
    /** 实体名（entities/<name>.md 的 name） */
    entityName: string;
    /** 审阅人（对齐 v1.3.6 approver 语义——Ed25519 身份码或人名） */
    approver: string;
    /** 审阅意见（留痕） */
    reviewNote?: string;
}
/** 迁移结果 */
export interface LifecycleMigrationResult {
    ok: boolean;
    reason?: string;
    /** 迁移前后的 lifecycle */
    from?: string;
    to?: string;
}
/**
 * branch → trunk 状态迁移（审阅门）。
 *
 * 审阅门语义（对齐 v1.3.6 workflow approver + 审计模块硬证据）：
 *   - approver 必填（空审阅人 = 非法迁移）
 *   - 仅 branch 态可迁移（trunk → trunk 幂等拒绝；未知实体拒绝）
 *   - 迁移在 frontmatter 写入 lifecycle: trunk + verified 追加记录
 *     （OKF 三级信任：审阅人审核 = process 级验证留痕）
 *   - trunk 回退走 git snapshot（不在本函数——回滚是物理动作）
 *
 * @param knowledgeDir knowledge/ 目录（entities/ 所在）
 * @param req 迁移请求
 */
export declare function migrateToTrunk(knowledgeDir: string, req: LifecycleMigrationRequest): LifecycleMigrationResult;
/**
 * 与 v1.3.4 能力市场五环状态对齐（验收 4——避免两套状态并存）。
 *
 * 映射：trunk ↔ 已发布+养护中（published/maintained）· branch ↔ 待发布/评价中
 * （pending-review/reviewing）。市场侧消费 lifecycle 时用本表换算。
 */
export declare const LIFECYCLE_TO_MARKET_RING: Record<string, string>;
//# sourceMappingURL=merge-engine.d.ts.map