// 旧格式(v2/v3)→ 当前格式(v1)的纯转换:不做任何 IO,便于隔离单测。 // // 旧版(DS Bot 时期)只有三个角色 lead / shangshu / gongbu,各绑定一个 Bot(真实存的是 // sessionId),项目还有 roomId、delivery、submissionSeq、maxReworks 等业务字段,以及 // 顶层 reviews / dispatches / reworks / artifacts / leases / events 六类记录。 // 新版固定十席,只认识项目与十席的会话/模型/说明。 // // 迁移原则: // 1. 能一一对应的直接搬:三角色 → lead / shangshu / gongbu 三席,Bot 的 sessionId 即会话 ID。 // 2. 不做任何猜测式绑定:其余七席保持 pending 空席,不生成替代会话。 // 3. 无法对应的角色、会话、模型与全部旧业务记录原样保存在 legacy 中,一条不丢。 // 4. leases 是运行期租约,只存档、不恢复为“运行中”。 // 5. 转换结果必须通过新版 validateState 才返回;否则视为转换失败,调用方不得写盘。 import { SEAT_IDS } from './roles.js' import { STATE_VERSION, emptySeat, validateState, validModel } from './schema.js' export const LEGACY_VERSIONS = Object.freeze([2, 3]) // 旧版角色 id 与新版席 id 同名,因此是一一对应的直搬。 const LEGACY_ROLE_TO_SEAT = Object.freeze({ lead: 'lead', shangshu: 'shangshu', gongbu: 'gongbu' }) // 旧项目里这些字段新版没有对应位置,全部收进 project.legacy。 const PROJECT_LEGACY_KEYS = Object.freeze([ 'roomId', 'delivery', 'submissionSeq', 'maxReworks', 'schemaVersion', 'workDir', ]) // 顶层这些字段是新版自己的,其余未知字段收进 legacy.extras。 const TOP_KNOWN_KEYS = Object.freeze([ 'version', 'seq', 'projects', 'reviews', 'dispatches', 'reworks', 'artifacts', 'leases', 'events', ]) function isObject(v) { return v !== null && typeof v === 'object' && !Array.isArray(v) } function isStr(v) { return typeof v === 'string' && v.trim() !== '' } function cleanModel(model) { if (model === null || model === undefined || !validModel(model)) return null const out = { provider: model.provider, model: model.model } if (typeof model.reasoningEffort === 'string') out.reasoningEffort = model.reasoningEffort return out } export function isLegacyState(raw) { return isObject(raw) && LEGACY_VERSIONS.includes(raw.version) } function fail(code, message) { return { ok: false, code, message } } function pickProjectId(legacy, usedIds) { // 优先沿用宿主工作区 ID:这样用户再次打开同一工作区时接上旧项目,而不是新建一个。 const preferred = [] if (isStr(legacy.workspaceId)) preferred.push(legacy.workspaceId) if (isStr(legacy.id)) preferred.push(legacy.id) for (const candidate of preferred) { if (!usedIds.has(candidate)) return candidate } const base = preferred[0] ?? 'legacy-project' let index = 2 while (usedIds.has(`${base}-${index}`)) index += 1 return `${base}-${index}` } function migrateProject(legacy, key, usedIds, fromVersion, now, warnings) { if (!isObject(legacy)) return fail('sansheng/state-corrupt', `旧项目 ${key} 不是对象,无法迁移`) const legacyId = isStr(legacy.id) ? legacy.id : key if (isStr(legacy.id) && legacy.id !== key) { // 旧数据里项目键与 id 不一致属于可疑数据,但不阻断:保留原值并在提示中说明。 warnings.push(`项目键 ${key} 与项目 id ${legacy.id} 不一致,已按 id 归档`) } const id = pickProjectId({ ...legacy, id: legacyId }, usedIds) usedIds.add(id) const seats = {} for (const seatId of SEAT_IDS) seats[seatId] = emptySeat(seatId) const unmappedBots = {} const unmappedModels = {} const bots = isObject(legacy.bots) ? legacy.bots : {} const models = isObject(legacy.models) ? legacy.models : {} for (const [role, rawSessionId] of Object.entries(bots)) { const seatId = LEGACY_ROLE_TO_SEAT[role] if (!seatId) { unmappedBots[role] = rawSessionId; continue } if (!isStr(rawSessionId)) { warnings.push(`项目 ${legacyId} 的 ${role} 没有有效会话 ID,该席保持未绑定`) continue } const seat = seats[seatId] seat.sessionId = rawSessionId seat.plannedSessionId = rawSessionId seat.status = 'bound' seat.updatedAt = Number.isFinite(legacy.updatedAt) ? legacy.updatedAt : now } // 旧版三角色缺任何一个都提示,不代建会话。 for (const role of Object.keys(LEGACY_ROLE_TO_SEAT)) { if (!isStr(bots[role])) warnings.push(`项目 ${legacyId} 缺少 ${role} 的旧会话,对应席保持未绑定`) } for (const [role, rawModel] of Object.entries(models)) { const seatId = LEGACY_ROLE_TO_SEAT[role] if (!seatId) { unmappedModels[role] = rawModel; continue } if (rawModel === null || rawModel === undefined) continue const model = cleanModel(rawModel) if (model) seats[seatId].model = model else { unmappedModels[role] = rawModel warnings.push(`项目 ${legacyId} 的 ${role} 模型格式无法识别,已原样保留;该席显示为未选择模型`) } } const extras = {} for (const [k, v] of Object.entries(legacy)) { if (['id', 'name', 'workspaceId', 'workDir', 'path', 'bots', 'models', 'createdAt', 'updatedAt', ...PROJECT_LEGACY_KEYS].includes(k)) continue extras[k] = v } return { ok: true, id, project: { id, name: isStr(legacy.name) ? legacy.name : legacyId, workspaceId: isStr(legacy.workspaceId) ? legacy.workspaceId : null, path: isStr(legacy.workDir) ? legacy.workDir : (isStr(legacy.path) ? legacy.path : null), status: 'pending', seats, revision: 0, createdAt: Number.isFinite(legacy.createdAt) ? legacy.createdAt : now, updatedAt: Number.isFinite(legacy.updatedAt) ? legacy.updatedAt : now, legacy: { fromVersion, legacyId, roomId: isStr(legacy.roomId) ? legacy.roomId : null, delivery: isObject(legacy.delivery) ? legacy.delivery : null, submissionSeq: Number.isFinite(legacy.submissionSeq) ? legacy.submissionSeq : 0, maxReworks: Number.isFinite(legacy.maxReworks) ? legacy.maxReworks : null, schemaVersion: Number.isFinite(legacy.schemaVersion) ? legacy.schemaVersion : fromVersion, workDir: isStr(legacy.workDir) ? legacy.workDir : null, unmappedBots, unmappedModels, extras, }, }, } } export function migrateLegacyState(raw, { now = Date.now() } = {}) { if (!isLegacyState(raw)) { return fail('sansheng/state-unsupported', `状态文件格式不受支持(版本 ${String(raw?.version)}),可升级的旧格式为 2/3`) } if (!isObject(raw.projects)) return fail('sansheng/state-corrupt', '旧状态缺少 projects 对象,无法迁移') const warnings = [] const projects = {} const usedIds = new Set() for (const [key, value] of Object.entries(raw.projects)) { const result = migrateProject(value, key, usedIds, raw.version, now, warnings) if (!result.ok) return result projects[result.id] = result.project } const extras = {} for (const [k, v] of Object.entries(raw)) { if (!TOP_KNOWN_KEYS.includes(k)) extras[k] = v } const state = { version: STATE_VERSION, seq: Number.isFinite(raw.seq) ? raw.seq : 0, projects, legacy: { fromVersion: raw.version, migratedAt: now, notes: warnings, reviews: Array.isArray(raw.reviews) ? raw.reviews : [], dispatches: Array.isArray(raw.dispatches) ? raw.dispatches : [], reworks: Array.isArray(raw.reworks) ? raw.reworks : [], artifacts: isObject(raw.artifacts) ? raw.artifacts : {}, events: Array.isArray(raw.events) ? raw.events : [], // 运行期租约只存档;新版不读 leases,绝不能把它当成“正在运行”。 leases: { restored: false, note: '旧版 leases 仅存档,不恢复为运行中状态', items: isObject(raw.leases) ? raw.leases : {}, }, extras, }, } const valid = validateState(state) if (!valid.ok) return fail('sansheng/state-migrate-failed', `旧数据转换后未通过校验:${valid.error}`) return { ok: true, state, warnings } }