@chongyan/autospec 1.0.1 → 1.0.2

package/scripts/evolution/version-manager.js

@@ -1,371 +0,0 @@
-/**
- * Version Manager - 版本管理器
- *
- * 实现版本标签管理、回滚逻辑、历史查询
- */
-
-import fs from 'fs';
-import path from 'path';
-import os from 'os';
-import {
-  GLOBAL_AUTOSPEC_DIR,
-  KNOWLEDGE_SCOPE
-} from '../install/constants.js';
-
-/**
- * 获取全局技能目录
- * @returns {string} 全局技能目录
- */
-function getGlobalSkillsDir() {
-  return path.join(os.homedir(), GLOBAL_AUTOSPEC_DIR, 'skills');
-}
-
-/**
- * 获取组织技能目录
- * @param {string} orgName - 组织名称
- * @returns {string} 组织技能目录
- */
-function getOrgSkillsDir(orgName) {
-  return path.join(os.homedir(), '.claude/autospec/orgs', orgName, 'skills');
-}
-
-/**
- * 安全地读取 JSON 文件
- * @param {string} filePath - 文件路径
- * @param {any} defaultValue - 默认值
- * @returns {any} 解析后的数据
- */
-function safeReadJson(filePath, defaultValue = null) {
-  try {
-    if (!fs.existsSync(filePath)) {
-      return defaultValue;
-    }
-    const content = fs.readFileSync(filePath, 'utf-8');
-    return JSON.parse(content);
-  } catch (e) {
-    return defaultValue;
-  }
-}
-
-/**
- * 安全地写入 JSON 文件
- * @param {string} filePath - 文件路径
- * @param {any} data - 数据
- * @returns {boolean} 是否成功
- */
-function safeWriteJson(filePath, data) {
-  try {
-    const dir = path.dirname(filePath);
-    if (!fs.existsSync(dir)) {
-      fs.mkdirSync(dir, { recursive: true });
-    }
-    fs.writeFileSync(filePath, JSON.stringify(data, null, 2));
-    return true;
-  } catch (e) {
-    return false;
-  }
-}
-
-/**
- * 解析版本号
- * @param {string} version - 版本号字符串
- * @returns {Object} 解析结果 { major, minor, patch, raw }
- */
-function parseVersion(version) {
-  const match = version.match(/^v?(\d+)\.(\d+)\.(\d+)$/);
-  if (match) {
-    return {
-      major: parseInt(match[1], 10),
-      minor: parseInt(match[2], 10),
-      patch: parseInt(match[3], 10),
-      raw: version
-    };
-  }
-  return { major: 0, minor: 0, patch: 0, raw: version };
-}
-
-/**
- * 比较版本号
- * @param {string} v1 - 版本1
- * @param {string} v2 - 版本2
- * @returns {number} -1: v1 < v2, 0: v1 = v2, 1: v1 > v2
- */
-function compareVersions(v1, v2) {
-  const p1 = parseVersion(v1);
-  const p2 = parseVersion(v2);
-
-  if (p1.major !== p2.major) return p1.major - p2.major;
-  if (p1.minor !== p2.minor) return p1.minor - p2.minor;
-  return p1.patch - p2.patch;
-}
-
-/**
- * 获取技能版本目录
- * @param {string} skillName - 技能名称
- * @param {string} scope - 作用域
- * @param {string} orgName - 组织名称
- * @returns {string} 技能版本目录
- */
-function getSkillVersionDir(skillName, scope, orgName = null) {
-  const baseDir = scope === KNOWLEDGE_SCOPE.ORG
-    ? getOrgSkillsDir(orgName)
-    : getGlobalSkillsDir();
-
-  return path.join(baseDir, skillName);
-}
-
-/**
- * 发布技能新版本
- *
- * @param {string} skillName - 技能名称
- * @param {string} content - 技能内容
- * @param {Object} options - 选项
- * @returns {Object} 发布结果 { success, version, path }
- */
-export function publishSkillVersion(skillName, content, options = {}) {
-  const { scope = KNOWLEDGE_SCOPE.GLOBAL, orgName = null, version = null, message = '' } = options;
-
-  const versionDir = getSkillVersionDir(skillName, scope, orgName);
-
-  // 确定版本号
-  const newVersion = version || getNextVersion(skillName, scope, orgName);
-  const versionPath = path.join(versionDir, `v${newVersion}`);
-
-  try {
-    // 创建版本目录
-    if (!fs.existsSync(versionPath)) {
-      fs.mkdirSync(versionPath, { recursive: true });
-    }
-
-    // 写入技能文件
-    const skillFilePath = path.join(versionPath, 'SKILL.md');
-    fs.writeFileSync(skillFilePath, content);
-
-    // 更新版本历史
-    const historyFilePath = path.join(versionDir, 'versions.json');
-    const history = safeReadJson(historyFilePath, { versions: [], latest: null });
-
-    history.versions = history.versions || [];
-    history.versions.push({
-      version: newVersion,
-      releasedAt: new Date().toISOString(),
-      message: message || `Release v${newVersion}`
-    });
-    history.latest = newVersion;
-
-    safeWriteJson(historyFilePath, history);
-
-    // 更新 latest 符号链接
-    const latestLink = path.join(versionDir, 'latest');
-    if (fs.existsSync(latestLink)) {
-      fs.unlinkSync(latestLink);
-    }
-    // 注意：符号链接创建可能需要管理员权限，这里用副本代替
-    fs.copyFileSync(skillFilePath, path.join(versionDir, 'SKILL.md'));
-
-    return {
-      success: true,
-      version: newVersion,
-      path: skillFilePath
-    };
-  } catch (e) {
-    return {
-      success: false,
-      error: e.message
-    };
-  }
-}
-
-/**
- * 获取下一个版本号
- * @param {string} skillName - 技能名称
- * @param {string} scope - 作用域
- * @param {string} orgName - 组织名称
- * @returns {string} 下一个版本号
- */
-function getNextVersion(skillName, scope, orgName = null) {
-  const versionDir = getSkillVersionDir(skillName, scope, orgName);
-  const historyFilePath = path.join(versionDir, 'versions.json');
-  const history = safeReadJson(historyFilePath, { versions: [] });
-
-  if (!history.versions || history.versions.length === 0) {
-    return '1.0.0';
-  }
-
-  // 获取最新版本
-  const latestVersion = history.versions[history.versions.length - 1].version;
-  const parsed = parseVersion(latestVersion);
-
-  // 递增 patch 版本
-  parsed.patch += 1;
-
-  return `${parsed.major}.${parsed.minor}.${parsed.patch}`;
-}
-
-/**
- * 回滚到指定版本
- *
- * @param {string} skillName - 技能名称
- * @param {string} targetVersion - 目标版本
- * @param {Object} options - 选项
- * @returns {Object} 回滚结果 { success, version }
- */
-export function rollbackSkillVersion(skillName, targetVersion, options = {}) {
-  const { scope = KNOWLEDGE_SCOPE.GLOBAL, orgName = null } = options;
-
-  const versionDir = getSkillVersionDir(skillName, scope, orgName);
-  const versionPath = path.join(versionDir, `v${targetVersion}`);
-  const skillFilePath = path.join(versionPath, 'SKILL.md');
-
-  if (!fs.existsSync(skillFilePath)) {
-    return { success: false, error: `版本 v${targetVersion} 不存在` };
-  }
-
-  try {
-    // 读取目标版本内容
-    const content = fs.readFileSync(skillFilePath, 'utf-8');
-
-    // 写入当前版本（覆盖 latest）
-    const latestPath = path.join(versionDir, 'SKILL.md');
-    fs.writeFileSync(latestPath, content);
-
-    // 记录回滚历史
-    const historyFilePath = path.join(versionDir, 'versions.json');
-    const history = safeReadJson(historyFilePath, { versions: [], latest: null });
-
-    history.versions.push({
-      version: targetVersion,
-      action: 'rollback',
-      rolledBackAt: new Date().toISOString()
-    });
-    history.latest = targetVersion;
-
-    safeWriteJson(historyFilePath, history);
-
-    return {
-      success: true,
-      version: targetVersion
-    };
-  } catch (e) {
-    return {
-      success: false,
-      error: e.message
-    };
-  }
-}
-
-/**
- * 获取版本历史
- *
- * @param {string} skillName - 技能名称
- * @param {Object} options - 选项
- * @returns {Object} 版本历史
- */
-export function getVersionHistory(skillName, options = {}) {
-  const { scope = KNOWLEDGE_SCOPE.GLOBAL, orgName = null } = options;
-
-  const versionDir = getSkillVersionDir(skillName, scope, orgName);
-  const historyFilePath = path.join(versionDir, 'versions.json');
-
-  return safeReadJson(historyFilePath, { versions: [], latest: null });
-}
-
-/**
- * 获取所有版本列表
- *
- * @param {string} skillName - 技能名称
- * @param {Object} options - 选项
- * @returns {Array} 版本列表
- */
-export function listSkillVersions(skillName, options = {}) {
-  const { scope = KNOWLEDGE_SCOPE.GLOBAL, orgName = null } = options;
-
-  const versionDir = getSkillVersionDir(skillName, scope, orgName);
-
-  if (!fs.existsSync(versionDir)) {
-    return [];
-  }
-
-  const entries = fs.readdirSync(versionDir, { withFileTypes: true });
-  const versions = [];
-
-  for (const entry of entries) {
-    if (entry.isDirectory() && entry.name.startsWith('v')) {
-      const versionPath = path.join(versionDir, entry.name, 'SKILL.md');
-      if (fs.existsSync(versionPath)) {
-        const stats = fs.statSync(versionPath);
-        versions.push({
-          version: entry.name.substring(1), // 去掉 'v' 前缀
-          path: versionPath,
-          releasedAt: stats.mtime.toISOString()
-        });
-      }
-    }
-  }
-
-  // 按版本号排序
-  return versions.sort((a, b) => compareVersions(b.version, a.version));
-}
-
-/**
- * 获取指定版本内容
- *
- * @param {string} skillName - 技能名称
- * @param {string} version - 版本号
- * @param {Object} options - 选项
- * @returns {string|null} 技能内容
- */
-export function getSkillVersion(skillName, version, options = {}) {
-  const { scope = KNOWLEDGE_SCOPE.GLOBAL, orgName = null } = options;
-
-  const versionDir = getSkillVersionDir(skillName, scope, orgName);
-  const skillFilePath = path.join(versionDir, `v${version}`, 'SKILL.md');
-
-  try {
-    if (fs.existsSync(skillFilePath)) {
-      return fs.readFileSync(skillFilePath, 'utf-8');
-    }
-    return null;
-  } catch (e) {
-    return null;
-  }
-}
-
-/**
- * 获取最新版本内容
- *
- * @param {string} skillName - 技能名称
- * @param {Object} options - 选项
- * @returns {string|null} 技能内容
- */
-export function getLatestSkillVersion(skillName, options = {}) {
-  const { scope = KNOWLEDGE_SCOPE.GLOBAL, orgName = null } = options;
-
-  const versionDir = getSkillVersionDir(skillName, scope, orgName);
-  const latestPath = path.join(versionDir, 'SKILL.md');
-
-  try {
-    if (fs.existsSync(latestPath)) {
-      return fs.readFileSync(latestPath, 'utf-8');
-    }
-
-    // 尝试从 versions.json 获取最新版本
-    const history = getVersionHistory(skillName, { scope, orgName });
-    if (history.latest) {
-      return getSkillVersion(skillName, history.latest, { scope, orgName });
-    }
-
-    return null;
-  } catch (e) {
-    return null;
-  }
-}
-
-export default {
-  publishSkillVersion,
-  rollbackSkillVersion,
-  getVersionHistory,
-  listSkillVersions,
-  getSkillVersion,
-  getLatestSkillVersion
-};