/** * Project Version Store — 项目安装版本读写。 * * 职责边界: * - 负责:读取和写入 .soloforge/version.json * - 不负责:模板复制、模板清单构建或资产同步 * * 被谁调用:升级计划与升级清理 * 调用谁:node:fs、node:path、shared/helpers * * 数据流:项目路径 + 版本对象 → 版本文件 * 持久化:.soloforge/version.json */ /** 版本文件结构 */ export interface ProjectVersionInfo { project_schema_version: string; soloforge_package_version: string; contract_registry_version: string; template_manifest_version: string; adapter_prompt_version: string; created_at: string; last_migrated_at: string; } /** 读取项目版本信息,不存在返回 null;损坏抛出(不伪装成"未安装"致错误迁移决策) */ export declare function loadProjectVersion(projectPath: string): ProjectVersionInfo | null; /** 写入项目版本信息(原子:tmp+rename,治原 writeFileSyncRecursive 非原子写半写损坏炸瘫升级流) */ export declare function saveProjectVersion(projectPath: string, version: ProjectVersionInfo): void;