dsh-sansheng-liubu/src/shared/migrate.js

194 lines
8.1 KiB
JavaScript
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

// 旧格式(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 }
}