/**
 * Upgrade Reconcile — plan 编排 + 判定。
 *
 * createUpgradePlan 编排 revision / impact / propagation / state_io 生成升级计划；
 * shouldBlockForUpgrade 给出升级是否阻断的判定。
 *
 * 职责边界：
 * - 负责：编排升级计划（漂移、影响、失效验证记录、下游闭包和推荐起点）并落盘 state
 * - 不负责：实际清理派生状态（cleanup.ts 负责）、不覆盖用户业务文件
 *
 * 被谁调用：server/tools/middleware.ts、core/tool_invocation_policy.ts
 * 调用谁：revision（currentUpgradeRevisions/projectContracts）、impact（deriveImpactInstances/collectStaleEvidenceViews/chooseRecommendedStart）、propagation（dedupeRefs/downstreamClosure）、state_io（readUpgradeState/writeUpgradeState/writeUpgradePlan）、internals（artifactKey/projectHasUpgradeHistory）、context/templates/template_manifest_io（loadProjectVersion）
 *
 * 数据流：项目版本 + 当前 revisions + 契约 → 漂移与失效证据聚合 → UpgradePlan + 写 state.status
 * 持久化：写 .soloforge/upgrade/plans/{plan_id}.json 与 .soloforge/upgrade/state.json；读项目 template manifest（loadProjectVersion）
 */
import type { UpgradePlan } from "./types.js";
export declare function shouldBlockForUpgrade(projectRoot: string): Promise<boolean>;
export declare function createUpgradePlan(projectRoot: string): Promise<UpgradePlan>;