/**
 * Evidence Metadata Refresh — 设计接口 / stub(未实现)。
 *
 * 设计意图:engine_revision / ruleset_hash 等判定指纹变化后,旧 evidence 的 metadata(engine_revision 等)过期,
 * 需批量识别/标记 stale,使消费方(deliver / advance / doctor / verify 复用判定)正确识别需重验的 evidence,
 * 而非依赖每条 evidence 在被读取时逐一手动重算 stale(散落 + 易漏)。
 *
 * 当前状态:stub(接口设计完成,实现待后续)。
 *
 * 约束(实现时必须遵守):
 * - **禁止后台任务**:refresh 须由显式调用(运营 / 升级流程 / doctor)触发,不自动轮询
 *   (避免与 verify / upgrade 流程竞争 + 静默改 evidence + 不可预期的 stale 风暴)。
 * - append-only:不删除 / 不重写 evidence;只标记 stale 或派生 metadata 视图。
 * - HMAC 保护:任何派生标记须经签名(防伪造 stale 攻击)。
 * - 审计:返回刷新摘要供运营审计。
 */
export interface EvidenceMetadataRefreshOptions {
    /** 限定 task_id(空 = 全量扫描,运营慎用)。 */
    taskId?: string;
    /** mark_stale=仅标记 stale(默认,轻量)/ recompute=重算 metadata(重,须重跑判定)。 */
    mode?: "mark_stale" | "recompute";
}
export interface EvidenceMetadataRefreshResult {
    /** 扫描的 evidence 总数。 */
    scanned: number;
    /** 标记 stale 的 evidence 数(metadata 过期,需重验)。 */
    markedStale: number;
    /** 重算 metadata 的 evidence 数(mode=recompute)。 */
    recomputed: number;
    /** 跳过数(已 fresh / 不可读 / fail-closed 排除)。 */
    skipped: number;
}
/**
 * 刷新 evidence metadata(stub,未实现)。
 *
 * 语义:engine_revision 等判定指纹变化后,批量识别旧 evidence 的过期 metadata,
 * 标记 stale 或重算(mode=recompute),使消费方识别需重验。
 *
 * 触发:显式调用(运营 / 升级流程),**非后台任务**。
 *
 * 未实现:当前返回空摘要 stub。实现须保证 append-only + HMAC + 审计,且不引入后台轮询。
 */
export declare function refreshEvidenceMetadata(_projectRoot: string, _options?: EvidenceMetadataRefreshOptions): Promise<EvidenceMetadataRefreshResult>;