@gong-ym/ai-spec-auto 0.2.13 → 0.2.15

package/src/governance/rollback.js

@@ -1,360 +1,360 @@
-/**
- * P3.5 版本回滚
- *
- * 资产版本回滚、锁回滚、适配器重新生成、回滚验证
- */
-
-// ============================================================
-// 常量
-// ============================================================
-
-const ROLLBACK_STATUS = Object.freeze({
-  PENDING: 'pending',
-  IN_PROGRESS: 'in_progress',
-  COMPLETED: 'completed',
-  FAILED: 'failed',
-  VERIFIED: 'verified',
-});
-
-const VALID_ROLLBACK_STATUS = new Set(Object.values(ROLLBACK_STATUS));
-
-// ============================================================
-// 版本回滚管理器
-// ============================================================
-
-class RollbackManager {
-  constructor(options = {}) {
-    /** @type {Map<string, object[]>} assetId → 版本记录[] */
-    this.versions = new Map();
-    /** @type {Map<string, object[]>} projectId → 锁版本记录[] */
-    this.lockVersions = new Map();
-    /** @type {Map<string, object>} rollbackId → 回滚记录 */
-    this.rollbacks = new Map();
-    /** @type {Function|null} 审计日志回调 */
-    this._auditCallback = options.onAudit || null;
-    /** @type {number} */
-    this._nextVersionId = 1;
-    /** @type {number} */
-    this._nextRollbackId = 1;
-  }
-
-  /**
-   * 注册资产版本
-   * @param {object} params
-   * @returns {object} 版本记录
-   */
-  registerVersion({ assetId, version, content = {}, metadata = {} }) {
-    if (!assetId || !version) {
-      throw new Error('assetId, version 必填');
-    }
-
-    const versionId = `ver-${this._nextVersionId++}`;
-    const record = {
-      versionId,
-      assetId,
-      version,
-      content: { ...content },
-      metadata: { ...metadata },
-      createdAt: new Date().toISOString(),
-    };
-
-    if (!this.versions.has(assetId)) {
-      this.versions.set(assetId, []);
-    }
-    this.versions.get(assetId).push(record);
-
-    return { ...record };
-  }
-
-  /**
-   * 列出资产所有版本
-   * @param {string} assetId
-   * @returns {object[]}
-   */
-  listVersions(assetId) {
-    const versions = this.versions.get(assetId) || [];
-    return versions.map(v => ({ ...v }));
-  }
-
-  /**
-   * 注册锁版本
-   * @param {object} params
-   * @returns {object} 锁版本记录
-   */
-  registerLockVersion({ projectId, lockVersion, lockData = {} }) {
-    if (!projectId || !lockVersion) {
-      throw new Error('projectId, lockVersion 必填');
-    }
-
-    const record = {
-      lockVersionId: `lock-${this._nextVersionId++}`,
-      projectId,
-      lockVersion,
-      lockData: { ...lockData },
-      createdAt: new Date().toISOString(),
-    };
-
-    if (!this.lockVersions.has(projectId)) {
-      this.lockVersions.set(projectId, []);
-    }
-    this.lockVersions.get(projectId).push(record);
-
-    return { ...record };
-  }
-
-  /**
-   * 回滚资产到指定版本
-   * @param {string} assetId
-   * @param {string} targetVersion
-   * @param {string} operatorId
-   * @returns {object} { ok, rollback?, error? }
-   */
-  rollbackAssetVersion(assetId, targetVersion, operatorId) {
-    if (!assetId || !targetVersion || !operatorId) {
-      return { ok: false, error: 'assetId, targetVersion, operatorId 必填' };
-    }
-
-    const versions = this.versions.get(assetId) || [];
-    const target = versions.find(v => v.version === targetVersion);
-    if (!target) {
-      return { ok: false, error: `资产 ${assetId} 没有版本 ${targetVersion}` };
-    }
-
-    const rollbackId = `rb-${this._nextRollbackId++}`;
-    const now = new Date().toISOString();
-
-    // 回滚不删除旧版本，而是创建新版本记录指向目标版本
-    const newVersion = this.registerVersion({
-      assetId,
-      version: `rollback-${Date.now()}`,
-      content: { ...target.content },
-      metadata: { rollbackFrom: versions[versions.length - 1]?.version, rollbackTo: targetVersion },
-    });
-
-    const rollback = {
-      rollbackId,
-      type: 'asset_version',
-      assetId,
-      targetVersion,
-      operatorId,
-      status: ROLLBACK_STATUS.COMPLETED,
-      newVersionId: newVersion.versionId,
-      createdAt: now,
-      completedAt: now,
-      verifiedAt: null,
-      verificationResult: null,
-    };
-
-    this.rollbacks.set(rollbackId, rollback);
-    this._audit('rollback', operatorId, assetId, 'rollback_asset_version', 'success', { targetVersion });
-
-    return { ok: true, rollback: { ...rollback } };
-  }
-
-  /**
-   * 回滚项目锁
-   * @param {string} projectId
-   * @param {string} targetLockVersion
-   * @param {string} operatorId
-   * @returns {object} { ok, rollback?, error? }
-   */
-  rollbackLock(projectId, targetLockVersion, operatorId) {
-    if (!projectId || !targetLockVersion || !operatorId) {
-      return { ok: false, error: 'projectId, targetLockVersion, operatorId 必填' };
-    }
-
-    const locks = this.lockVersions.get(projectId) || [];
-    const target = locks.find(l => l.lockVersion === targetLockVersion);
-    if (!target) {
-      return { ok: false, error: `项目 ${projectId} 没有锁版本 ${targetLockVersion}` };
-    }
-
-    const rollbackId = `rb-${this._nextRollbackId++}`;
-    const now = new Date().toISOString();
-
-    // 创建新的锁版本记录
-    const newLock = this.registerLockVersion({
-      projectId,
-      lockVersion: `rollback-${Date.now()}`,
-      lockData: { ...target.lockData },
-    });
-
-    const rollback = {
-      rollbackId,
-      type: 'lock',
-      projectId,
-      targetLockVersion,
-      operatorId,
-      status: ROLLBACK_STATUS.COMPLETED,
-      newLockVersionId: newLock.lockVersionId,
-      createdAt: now,
-      completedAt: now,
-      verifiedAt: null,
-      verificationResult: null,
-    };
-
-    this.rollbacks.set(rollbackId, rollback);
-    this._audit('rollback', operatorId, projectId, 'rollback_lock', 'success', { targetLockVersion });
-
-    return { ok: true, rollback: { ...rollback } };
-  }
-
-  /**
-   * 重新生成适配器输出
-   * @param {string} projectId
-   * @param {string} targetVersion
-   * @param {string[]} adapterNames
-   * @returns {object} { ok, rollback?, error? }
-   */
-  rollbackAdapters(projectId, targetVersion, adapterNames) {
-    if (!projectId || !targetVersion) {
-      return { ok: false, error: 'projectId, targetVersion 必填' };
-    }
-    if (!adapterNames || !Array.isArray(adapterNames) || adapterNames.length === 0) {
-      return { ok: false, error: 'adapterNames 必填且不能为空' };
-    }
-
-    const rollbackId = `rb-${this._nextRollbackId++}`;
-    const now = new Date().toISOString();
-
-    // 模拟适配器重新生成结果
-    const adapterResults = adapterNames.map(name => ({
-      adapter: name,
-      status: 'regenerated',
-      targetVersion,
-    }));
-
-    const rollback = {
-      rollbackId,
-      type: 'adapter',
-      projectId,
-      targetVersion,
-      adapterNames: [...adapterNames],
-      adapterResults,
-      status: ROLLBACK_STATUS.COMPLETED,
-      createdAt: now,
-      completedAt: now,
-      verifiedAt: null,
-      verificationResult: null,
-    };
-
-    this.rollbacks.set(rollbackId, rollback);
-    this._audit('rollback', 'system', projectId, 'rollback_adapters', 'success', { targetVersion, adapterNames });
-
-    return { ok: true, rollback: { ...rollback } };
-  }
-
-  /**
-   * 验证回滚结果
-   * @param {string} projectId
-   * @param {string} rollbackId
-   * @returns {object} { ok, verified?, error? }
-   */
-  verifyRollback(projectId, rollbackId) {
-    const rollback = this.rollbacks.get(rollbackId);
-    if (!rollback) {
-      return { ok: false, error: `回滚记录 ${rollbackId} 不存在` };
-    }
-    if (rollback.status === ROLLBACK_STATUS.VERIFIED) {
-      return { ok: false, error: '回滚已验证，不可重复验证' };
-    }
-    if (rollback.status !== ROLLBACK_STATUS.COMPLETED) {
-      return { ok: false, error: `回滚状态为 ${rollback.status}，不可验证` };
-    }
-
-    const now = new Date().toISOString();
-    rollback.status = ROLLBACK_STATUS.VERIFIED;
-    rollback.verifiedAt = now;
-    rollback.verificationResult = {
-      passed: true,
-      checks: ['version_integrity', 'content_match', 'metadata_consistent'],
-      verifiedAt: now,
-    };
-
-    this._audit('rollback', 'system', projectId || '', 'verify_rollback', 'success', { rollbackId });
-
-    return { ok: true, verified: { ...rollback } };
-  }
-
-  /**
-   * 获取回滚历史
-   * @param {string} projectId
-   * @returns {object[]}
-   */
-  getRollbackHistory(projectId) {
-    const result = [];
-    for (const rb of this.rollbacks.values()) {
-      if (!projectId || rb.projectId === projectId || rb.assetId === projectId) {
-        result.push({ ...rb });
-      }
-    }
-    return result;
-  }
-
-  /**
-   * 获取单个回滚记录
-   * @param {string} rollbackId
-   * @returns {object|null}
-   */
-  getRollback(rollbackId) {
-    const rb = this.rollbacks.get(rollbackId);
-    return rb ? { ...rb } : null;
-  }
-
-  /**
-   * 获取统计
-   * @returns {object}
-   */
-  getStats() {
-    const byType = {};
-    const byStatus = {};
-    for (const rb of this.rollbacks.values()) {
-      byType[rb.type] = (byType[rb.type] || 0) + 1;
-      byStatus[rb.status] = (byStatus[rb.status] || 0) + 1;
-    }
-    return {
-      totalRollbacks: this.rollbacks.size,
-      totalVersions: [...this.versions.values()].reduce((s, a) => s + a.length, 0),
-      totalLockVersions: [...this.lockVersions.values()].reduce((s, a) => s + a.length, 0),
-      byType,
-      byStatus,
-    };
-  }
-
-  /**
-   * 重置
-   */
-  reset() {
-    this.versions.clear();
-    this.lockVersions.clear();
-    this.rollbacks.clear();
-    this._nextVersionId = 1;
-    this._nextRollbackId = 1;
-  }
-
-  // ============================================================
-  // 内部方法
-  // ============================================================
-
-  _audit(eventType, actor, target, action, result, metadata) {
-    if (this._auditCallback) {
-      this._auditCallback({ eventType, actor, target, action, result, metadata });
-    }
-  }
-}
-
-/**
- * 工厂函数
- * @param {object} [options]
- * @returns {RollbackManager}
- */
-function createRollbackManager(options) {
-  return new RollbackManager(options);
-}
-
-module.exports = {
-  ROLLBACK_STATUS,
-  VALID_ROLLBACK_STATUS,
-  RollbackManager,
-  createRollbackManager,
-};
+/**
+ * P3.5 版本回滚
+ *
+ * 资产版本回滚、锁回滚、适配器重新生成、回滚验证
+ */
+
+// ============================================================
+// 常量
+// ============================================================
+
+const ROLLBACK_STATUS = Object.freeze({
+  PENDING: 'pending',
+  IN_PROGRESS: 'in_progress',
+  COMPLETED: 'completed',
+  FAILED: 'failed',
+  VERIFIED: 'verified',
+});
+
+const VALID_ROLLBACK_STATUS = new Set(Object.values(ROLLBACK_STATUS));
+
+// ============================================================
+// 版本回滚管理器
+// ============================================================
+
+class RollbackManager {
+  constructor(options = {}) {
+    /** @type {Map<string, object[]>} assetId → 版本记录[] */
+    this.versions = new Map();
+    /** @type {Map<string, object[]>} projectId → 锁版本记录[] */
+    this.lockVersions = new Map();
+    /** @type {Map<string, object>} rollbackId → 回滚记录 */
+    this.rollbacks = new Map();
+    /** @type {Function|null} 审计日志回调 */
+    this._auditCallback = options.onAudit || null;
+    /** @type {number} */
+    this._nextVersionId = 1;
+    /** @type {number} */
+    this._nextRollbackId = 1;
+  }
+
+  /**
+   * 注册资产版本
+   * @param {object} params
+   * @returns {object} 版本记录
+   */
+  registerVersion({ assetId, version, content = {}, metadata = {} }) {
+    if (!assetId || !version) {
+      throw new Error('assetId, version 必填');
+    }
+
+    const versionId = `ver-${this._nextVersionId++}`;
+    const record = {
+      versionId,
+      assetId,
+      version,
+      content: { ...content },
+      metadata: { ...metadata },
+      createdAt: new Date().toISOString(),
+    };
+
+    if (!this.versions.has(assetId)) {
+      this.versions.set(assetId, []);
+    }
+    this.versions.get(assetId).push(record);
+
+    return { ...record };
+  }
+
+  /**
+   * 列出资产所有版本
+   * @param {string} assetId
+   * @returns {object[]}
+   */
+  listVersions(assetId) {
+    const versions = this.versions.get(assetId) || [];
+    return versions.map(v => ({ ...v }));
+  }
+
+  /**
+   * 注册锁版本
+   * @param {object} params
+   * @returns {object} 锁版本记录
+   */
+  registerLockVersion({ projectId, lockVersion, lockData = {} }) {
+    if (!projectId || !lockVersion) {
+      throw new Error('projectId, lockVersion 必填');
+    }
+
+    const record = {
+      lockVersionId: `lock-${this._nextVersionId++}`,
+      projectId,
+      lockVersion,
+      lockData: { ...lockData },
+      createdAt: new Date().toISOString(),
+    };
+
+    if (!this.lockVersions.has(projectId)) {
+      this.lockVersions.set(projectId, []);
+    }
+    this.lockVersions.get(projectId).push(record);
+
+    return { ...record };
+  }
+
+  /**
+   * 回滚资产到指定版本
+   * @param {string} assetId
+   * @param {string} targetVersion
+   * @param {string} operatorId
+   * @returns {object} { ok, rollback?, error? }
+   */
+  rollbackAssetVersion(assetId, targetVersion, operatorId) {
+    if (!assetId || !targetVersion || !operatorId) {
+      return { ok: false, error: 'assetId, targetVersion, operatorId 必填' };
+    }
+
+    const versions = this.versions.get(assetId) || [];
+    const target = versions.find(v => v.version === targetVersion);
+    if (!target) {
+      return { ok: false, error: `资产 ${assetId} 没有版本 ${targetVersion}` };
+    }
+
+    const rollbackId = `rb-${this._nextRollbackId++}`;
+    const now = new Date().toISOString();
+
+    // 回滚不删除旧版本，而是创建新版本记录指向目标版本
+    const newVersion = this.registerVersion({
+      assetId,
+      version: `rollback-${Date.now()}`,
+      content: { ...target.content },
+      metadata: { rollbackFrom: versions[versions.length - 1]?.version, rollbackTo: targetVersion },
+    });
+
+    const rollback = {
+      rollbackId,
+      type: 'asset_version',
+      assetId,
+      targetVersion,
+      operatorId,
+      status: ROLLBACK_STATUS.COMPLETED,
+      newVersionId: newVersion.versionId,
+      createdAt: now,
+      completedAt: now,
+      verifiedAt: null,
+      verificationResult: null,
+    };
+
+    this.rollbacks.set(rollbackId, rollback);
+    this._audit('rollback', operatorId, assetId, 'rollback_asset_version', 'success', { targetVersion });
+
+    return { ok: true, rollback: { ...rollback } };
+  }
+
+  /**
+   * 回滚项目锁
+   * @param {string} projectId
+   * @param {string} targetLockVersion
+   * @param {string} operatorId
+   * @returns {object} { ok, rollback?, error? }
+   */
+  rollbackLock(projectId, targetLockVersion, operatorId) {
+    if (!projectId || !targetLockVersion || !operatorId) {
+      return { ok: false, error: 'projectId, targetLockVersion, operatorId 必填' };
+    }
+
+    const locks = this.lockVersions.get(projectId) || [];
+    const target = locks.find(l => l.lockVersion === targetLockVersion);
+    if (!target) {
+      return { ok: false, error: `项目 ${projectId} 没有锁版本 ${targetLockVersion}` };
+    }
+
+    const rollbackId = `rb-${this._nextRollbackId++}`;
+    const now = new Date().toISOString();
+
+    // 创建新的锁版本记录
+    const newLock = this.registerLockVersion({
+      projectId,
+      lockVersion: `rollback-${Date.now()}`,
+      lockData: { ...target.lockData },
+    });
+
+    const rollback = {
+      rollbackId,
+      type: 'lock',
+      projectId,
+      targetLockVersion,
+      operatorId,
+      status: ROLLBACK_STATUS.COMPLETED,
+      newLockVersionId: newLock.lockVersionId,
+      createdAt: now,
+      completedAt: now,
+      verifiedAt: null,
+      verificationResult: null,
+    };
+
+    this.rollbacks.set(rollbackId, rollback);
+    this._audit('rollback', operatorId, projectId, 'rollback_lock', 'success', { targetLockVersion });
+
+    return { ok: true, rollback: { ...rollback } };
+  }
+
+  /**
+   * 重新生成适配器输出
+   * @param {string} projectId
+   * @param {string} targetVersion
+   * @param {string[]} adapterNames
+   * @returns {object} { ok, rollback?, error? }
+   */
+  rollbackAdapters(projectId, targetVersion, adapterNames) {
+    if (!projectId || !targetVersion) {
+      return { ok: false, error: 'projectId, targetVersion 必填' };
+    }
+    if (!adapterNames || !Array.isArray(adapterNames) || adapterNames.length === 0) {
+      return { ok: false, error: 'adapterNames 必填且不能为空' };
+    }
+
+    const rollbackId = `rb-${this._nextRollbackId++}`;
+    const now = new Date().toISOString();
+
+    // 模拟适配器重新生成结果
+    const adapterResults = adapterNames.map(name => ({
+      adapter: name,
+      status: 'regenerated',
+      targetVersion,
+    }));
+
+    const rollback = {
+      rollbackId,
+      type: 'adapter',
+      projectId,
+      targetVersion,
+      adapterNames: [...adapterNames],
+      adapterResults,
+      status: ROLLBACK_STATUS.COMPLETED,
+      createdAt: now,
+      completedAt: now,
+      verifiedAt: null,
+      verificationResult: null,
+    };
+
+    this.rollbacks.set(rollbackId, rollback);
+    this._audit('rollback', 'system', projectId, 'rollback_adapters', 'success', { targetVersion, adapterNames });
+
+    return { ok: true, rollback: { ...rollback } };
+  }
+
+  /**
+   * 验证回滚结果
+   * @param {string} projectId
+   * @param {string} rollbackId
+   * @returns {object} { ok, verified?, error? }
+   */
+  verifyRollback(projectId, rollbackId) {
+    const rollback = this.rollbacks.get(rollbackId);
+    if (!rollback) {
+      return { ok: false, error: `回滚记录 ${rollbackId} 不存在` };
+    }
+    if (rollback.status === ROLLBACK_STATUS.VERIFIED) {
+      return { ok: false, error: '回滚已验证，不可重复验证' };
+    }
+    if (rollback.status !== ROLLBACK_STATUS.COMPLETED) {
+      return { ok: false, error: `回滚状态为 ${rollback.status}，不可验证` };
+    }
+
+    const now = new Date().toISOString();
+    rollback.status = ROLLBACK_STATUS.VERIFIED;
+    rollback.verifiedAt = now;
+    rollback.verificationResult = {
+      passed: true,
+      checks: ['version_integrity', 'content_match', 'metadata_consistent'],
+      verifiedAt: now,
+    };
+
+    this._audit('rollback', 'system', projectId || '', 'verify_rollback', 'success', { rollbackId });
+
+    return { ok: true, verified: { ...rollback } };
+  }
+
+  /**
+   * 获取回滚历史
+   * @param {string} projectId
+   * @returns {object[]}
+   */
+  getRollbackHistory(projectId) {
+    const result = [];
+    for (const rb of this.rollbacks.values()) {
+      if (!projectId || rb.projectId === projectId || rb.assetId === projectId) {
+        result.push({ ...rb });
+      }
+    }
+    return result;
+  }
+
+  /**
+   * 获取单个回滚记录
+   * @param {string} rollbackId
+   * @returns {object|null}
+   */
+  getRollback(rollbackId) {
+    const rb = this.rollbacks.get(rollbackId);
+    return rb ? { ...rb } : null;
+  }
+
+  /**
+   * 获取统计
+   * @returns {object}
+   */
+  getStats() {
+    const byType = {};
+    const byStatus = {};
+    for (const rb of this.rollbacks.values()) {
+      byType[rb.type] = (byType[rb.type] || 0) + 1;
+      byStatus[rb.status] = (byStatus[rb.status] || 0) + 1;
+    }
+    return {
+      totalRollbacks: this.rollbacks.size,
+      totalVersions: [...this.versions.values()].reduce((s, a) => s + a.length, 0),
+      totalLockVersions: [...this.lockVersions.values()].reduce((s, a) => s + a.length, 0),
+      byType,
+      byStatus,
+    };
+  }
+
+  /**
+   * 重置
+   */
+  reset() {
+    this.versions.clear();
+    this.lockVersions.clear();
+    this.rollbacks.clear();
+    this._nextVersionId = 1;
+    this._nextRollbackId = 1;
+  }
+
+  // ============================================================
+  // 内部方法
+  // ============================================================
+
+  _audit(eventType, actor, target, action, result, metadata) {
+    if (this._auditCallback) {
+      this._auditCallback({ eventType, actor, target, action, result, metadata });
+    }
+  }
+}
+
+/**
+ * 工厂函数
+ * @param {object} [options]
+ * @returns {RollbackManager}
+ */
+function createRollbackManager(options) {
+  return new RollbackManager(options);
+}
+
+module.exports = {
+  ROLLBACK_STATUS,
+  VALID_ROLLBACK_STATUS,
+  RollbackManager,
+  createRollbackManager,
+};