@chongyan/autospec 1.0.1 → 1.0.2

package/scripts/evolution/knowledge-loader.js

@@ -1,346 +0,0 @@
-/**
- * Knowledge Loader - 知识加载器
- *
- * 实现三级优先级加载：项目 > 用户全局 > 组织
- * 集成记忆模块的全局路径和双模式逻辑
- */
-
-import fs from 'fs';
-import path from 'path';
-import os from 'os';
-import {
-  GLOBAL_AUTOSPEC_DIR,
-  GLOBAL_AUTOSPEC_SUBDIRS,
-  ORG_AUTOSPEC_DIR,
-  ORG_AUTOSPEC_SUBDIRS,
-  KNOWLEDGE_SCOPE,
-  KNOWLEDGE_ZONES
-} from '../install/constants.js';
-
-// 缓存
-const knowledgeCache = new Map();
-const CACHE_TTL = 5000; // 5秒缓存
-
-/**
- * 获取全局知识库根目录
- * @returns {string} 全局知识库根目录
- */
-export function getGlobalKnowledgeRoot() {
-  return path.join(os.homedir(), GLOBAL_AUTOSPEC_DIR);
-}
-
-/**
- * 获取组织知识库根目录
- * @param {string} orgName - 组织名称
- * @returns {string} 组织知识库根目录
- */
-export function getOrgKnowledgeRoot(orgName) {
-  return path.join(os.homedir(), ORG_AUTOSPEC_DIR, orgName);
-}
-
-/**
- * 获取项目知识库根目录
- * @param {string} projectRoot - 项目根目录
- * @returns {string} 项目知识库根目录
- */
-export function getProjectKnowledgeRoot(projectRoot) {
-  return path.join(projectRoot, '.autospec');
-}
-
-/**
- * 解析知识文件路径
- * @param {string} scope - 作用域 (global|org|project)
- * @param {string} type - 知识类型 (knowledge|skills|roles|environment)
- * @param {string} name - 知识名称
- * @param {Object} options - 选项
- * @returns {string} 完整文件路径
- */
-export function resolveKnowledgePath(scope, type, name, options = {}) {
-  const { projectRoot = '.', orgName = null } = options;
-
-  switch (scope) {
-    case KNOWLEDGE_SCOPE.GLOBAL:
-      return path.join(getGlobalKnowledgeRoot(), GLOBAL_AUTOSPEC_SUBDIRS[type.toUpperCase()] || type, name);
-
-    case KNOWLEDGE_SCOPE.ORG:
-      if (!orgName) {
-        throw new Error('orgName is required for org scope');
-      }
-      return path.join(getOrgKnowledgeRoot(orgName), ORG_AUTOSPEC_SUBDIRS[type.toUpperCase()] || type, name);
-
-    case KNOWLEDGE_SCOPE.PROJECT:
-    default:
-      return path.join(getProjectKnowledgeRoot(projectRoot), type, name);
-  }
-}
-
-/**
- * 安全地读取文件
- * @param {string} filePath - 文件路径
- * @returns {string|null} 文件内容
- */
-function safeReadFile(filePath) {
-  try {
-    if (!fs.existsSync(filePath)) {
-      return null;
-    }
-    return fs.readFileSync(filePath, 'utf-8');
-  } catch (e) {
-    return null;
-  }
-}
-
-/**
- * 安全地读取 JSON 文件
- * @param {string} filePath - 文件路径
- * @param {any} defaultValue - 默认值
- * @returns {any} 解析后的数据
- */
-function safeReadJson(filePath, defaultValue = null) {
-  try {
-    const content = safeReadFile(filePath);
-    if (!content) {
-      return defaultValue;
-    }
-    return JSON.parse(content);
-  } catch (e) {
-    return defaultValue;
-  }
-}
-
-/**
- * 获取知识缓存键
- * @param {string} scope - 作用域
- * @param {string} type - 类型
- * @param {string} name - 名称
- * @returns {string} 缓存键
- */
-function getCacheKey(scope, type, name) {
-  return `${scope}:${type}:${name}`;
-}
-
-/**
- * 加载知识（带缓存）
- * @param {string} scope - 作用域
- * @param {string} type - 类型
- * @param {string} name - 名称
- * @param {Object} options - 选项
- * @returns {Object|null} 知识内容
- */
-export function loadKnowledge(scope, type, name, options = {}) {
-  const { useCache = true, projectRoot = '.', orgName = null } = options;
-  const cacheKey = getCacheKey(scope, type, name);
-
-  if (useCache) {
-    const cached = knowledgeCache.get(cacheKey);
-    if (cached && Date.now() - cached.timestamp < CACHE_TTL) {
-      return cached.data;
-    }
-  }
-
-  const filePath = resolveKnowledgePath(scope, type, name, { projectRoot, orgName });
-  const content = safeReadFile(filePath);
-
-  if (content && useCache) {
-    knowledgeCache.set(cacheKey, { data: content, timestamp: Date.now() });
-  }
-
-  return content;
-}
-
-/**
- * 加载知识 JSON（带缓存）
- * @param {string} scope - 作用域
- * @param {string} type - 类型
- * @param {string} name - 名称
- * @param {Object} options - 选项
- * @returns {any} 知识内容
- */
-export function loadKnowledgeJson(scope, type, name, options = {}) {
-  const { useCache = true, projectRoot = '.', orgName = null } = options;
-  const cacheKey = `json:${getCacheKey(scope, type, name)}`;
-
-  if (useCache) {
-    const cached = knowledgeCache.get(cacheKey);
-    if (cached && Date.now() - cached.timestamp < CACHE_TTL) {
-      return cached.data;
-    }
-  }
-
-  const filePath = resolveKnowledgePath(scope, type, name, { projectRoot, orgName });
-  const data = safeReadJson(filePath, null);
-
-  if (data && useCache) {
-    knowledgeCache.set(cacheKey, { data, timestamp: Date.now() });
-  }
-
-  return data;
-}
-
-/**
- * 三级优先级加载知识
- * 优先级：项目 > 用户全局 > 组织
- *
- * @param {string} type - 知识类型
- * @param {string} name - 知识名称
- * @param {Object} options - 选项
- * @returns {Object} 加载结果 { content, scope, path }
- */
-export function loadKnowledgeWithFallback(type, name, options = {}) {
-  const { projectRoot = '.', orgName = null, preferScope = null } = options;
-
-  // 如果指定了偏好作用域，优先尝试
-  if (preferScope) {
-    const content = loadKnowledge(preferScope, type, name, { projectRoot, orgName });
-    if (content) {
-      return {
-        content,
-        scope: preferScope,
-        path: resolveKnowledgePath(preferScope, type, name, { projectRoot, orgName })
-      };
-    }
-  }
-
-  // 1. 优先加载项目知识
-  const projectContent = loadKnowledge(KNOWLEDGE_SCOPE.PROJECT, type, name, { projectRoot });
-  if (projectContent) {
-    return {
-      content: projectContent,
-      scope: KNOWLEDGE_SCOPE.PROJECT,
-      path: resolveKnowledgePath(KNOWLEDGE_SCOPE.PROJECT, type, name, { projectRoot })
-    };
-  }
-
-  // 2. 回退到全局知识
-  const globalContent = loadKnowledge(KNOWLEDGE_SCOPE.GLOBAL, type, name, { projectRoot });
-  if (globalContent) {
-    return {
-      content: globalContent,
-      scope: KNOWLEDGE_SCOPE.GLOBAL,
-      path: resolveKnowledgePath(KNOWLEDGE_SCOPE.GLOBAL, type, name, { projectRoot })
-    };
-  }
-
-  // 3. 最后回退到组织知识
-  if (orgName) {
-    const orgContent = loadKnowledge(KNOWLEDGE_SCOPE.ORG, type, name, { projectRoot, orgName });
-    if (orgContent) {
-      return {
-        content: orgContent,
-        scope: KNOWLEDGE_SCOPE.ORG,
-        path: resolveKnowledgePath(KNOWLEDGE_SCOPE.ORG, type, name, { projectRoot, orgName })
-      };
-    }
-  }
-
-  return { content: null, scope: null, path: null };
-}
-
-/**
- * 加载技能（带版本支持）
- * @param {string} skillName - 技能名称
- * @param {Object} options - 选项
- * @returns {Object} 技能内容
- */
-export function loadSkill(skillName, options = {}) {
-  const { version = 'latest', projectRoot = '.', orgName = null } = options;
-
-  // 尝试加载指定版本
-  if (version !== 'latest') {
-    const versionedResult = loadKnowledgeWithFallback('skills', `${skillName}/v${version}/SKILL.md`, options);
-    if (versionedResult.content) {
-      return versionedResult;
-    }
-  }
-
-  // 尝试加载最新版本
-  const latestResult = loadKnowledgeWithFallback('skills', `${skillName}/SKILL.md`, options);
-  if (latestResult.content) {
-    return latestResult;
-  }
-
-  // 尝试从 plugins 源码加载
-  const sourcePath = path.join(process.cwd(), 'plugins', 'skills', skillName, 'SKILL.md');
-  const sourceContent = safeReadFile(sourcePath);
-  if (sourceContent) {
-    return {
-      content: sourceContent,
-      scope: 'source',
-      path: sourcePath
-    };
-  }
-
-  return { content: null, scope: null, path: null };
-}
-
-/**
- * 获取知识分区
- * @param {string} knowledgePath - 知识路径
- * @returns {string} 知识分区
- */
-export function getKnowledgeZone(knowledgePath) {
-  // 冻结区检测
-  if (/\/knowledge\/principles\/(constitution|evolution|design-philosophy)\.md$/.test(knowledgePath)) {
-    return KNOWLEDGE_ZONES.FROZEN;
-  }
-
-  // 受控区检测
-  if (/\/knowledge\/(process|guides\/support|config|checklists)\//.test(knowledgePath)) {
-    return KNOWLEDGE_ZONES.CONTROLLED;
-  }
-
-  // 自由区检测
-  if (/\/knowledge\/guides\/stages\/|\/knowledge\/domain\/|\/plugins\/skills\//.test(knowledgePath)) {
-    return KNOWLEDGE_ZONES.FREE;
-  }
-
-  // 默认返回受控区
-  return KNOWLEDGE_ZONES.CONTROLLED;
-}
-
-/**
- * 检查知识是否存在
- * @param {string} scope - 作用域
- * @param {string} type - 类型
- * @param {string} name - 名称
- * @param {Object} options - 选项
- * @returns {boolean} 是否存在
- */
-export function knowledgeExists(scope, type, name, options = {}) {
-  const { projectRoot = '.', orgName = null } = options;
-  const filePath = resolveKnowledgePath(scope, type, name, { projectRoot, orgName });
-  return fs.existsSync(filePath);
-}
-
-/**
- * 清除知识缓存
- * @param {string} scope - 作用域（可选）
- */
-export function clearKnowledgeCache(scope = null) {
-  if (scope) {
-    for (const key of knowledgeCache.keys()) {
-      if (key.startsWith(`${scope}:`)) {
-        knowledgeCache.delete(key);
-      }
-    }
-  } else {
-    knowledgeCache.clear();
-  }
-}
-
-export default {
-  // 路径解析
-  getGlobalKnowledgeRoot,
-  getOrgKnowledgeRoot,
-  getProjectKnowledgeRoot,
-  resolveKnowledgePath,
-  // 加载
-  loadKnowledge,
-  loadKnowledgeJson,
-  loadKnowledgeWithFallback,
-  loadSkill,
-  // 工具
-  getKnowledgeZone,
-  knowledgeExists,
-  clearKnowledgeCache
-};

package/scripts/evolution/marketplace.js

@@ -1,317 +0,0 @@
-/**
- * Marketplace - 插件市场集成
- *
- * 实现插件市场发布接口、搜索/安装、生成兼容 Claude Code 的 plugin.json
- */
-
-import fs from 'fs';
-import path from 'path';
-import os from 'os';
-import {
-  GLOBAL_AUTOSPEC_DIR,
-  KNOWLEDGE_SCOPE
-} from '../install/constants.js';
-import { getLatestSkillVersion, listSkillVersions, getVersionHistory } from './version-manager.js';
-
-/**
- * 获取市场目录
- * @returns {string} 市场目录
- */
-function getMarketplaceDir() {
-  return path.join(os.homedir(), '.claude/autospec/marketplace');
-}
-
-/**
- * 获取市场索引文件路径
- * @returns {string} 索引文件路径
- */
-function getMarketplaceIndexPath() {
-  return path.join(getMarketplaceDir(), 'index.json');
-}
-
-/**
- * 安全地读取 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;
-  }
-}
-
-/**
- * 生成 plugin.json（Claude Code 格式）
- *
- * @param {string} skillName - 技能名称
- * @param {Object} options - 选项
- * @returns {Object} plugin.json 内容
- */
-export function generatePluginJson(skillName, options = {}) {
-  const { version = '1.0.0', description = '', author = '', namespace = 'autospec' } = options;
-
-  // 获取技能内容
-  const content = getLatestSkillVersion(skillName);
-  const versions = listSkillVersions(skillName);
-
-  // 从技能内容中提取描述
-  let skillDescription = description;
-  if (!skillDescription && content) {
-    const match = content.match(/^---\n([\s\S]*?)\n---/);
-    if (match) {
-      const frontmatter = match[1];
-      const descMatch = frontmatter.match(/description:\s*(.+)/);
-      if (descMatch) {
-        skillDescription = descMatch[1].trim();
-      }
-    }
-  }
-
-  return {
-    name: `${namespace}-${skillName}`,
-    version,
-    namespace,
-    description: skillDescription || `${skillName} skill`,
-    skills: [
-      {
-        name: skillName,
-        path: `skills/${skillName}/SKILL.md`,
-        versions: versions.map(v => v.version)
-      }
-    ],
-    author: author || 'AutoSpec User',
-    releasedAt: new Date().toISOString()
-  };
-}
-
-/**
- * 发布到市场
- *
- * @param {string} skillName - 技能名称
- * @param {Object} options - 选项
- * @returns {Object} 发布结果 { success, marketplaceUrl }
- */
-export function publishToMarketplace(skillName, options = {}) {
-  const { version = '1.0.0', description = '', author = '', isPublic = false } = options;
-
-  const marketplaceDir = getMarketplaceDir();
-  const skillMarketplaceDir = path.join(marketplaceDir, skillName);
-
-  try {
-    // 创建技能市场目录
-    if (!fs.existsSync(skillMarketplaceDir)) {
-      fs.mkdirSync(skillMarketplaceDir, { recursive: true });
-    }
-
-    // 获取最新版本内容
-    const content = getLatestSkillVersion(skillName);
-    if (!content) {
-      return { success: false, error: '技能不存在或无法获取内容' };
-    }
-
-    // 写入技能文件
-    const skillPath = path.join(skillMarketplaceDir, 'SKILL.md');
-    fs.writeFileSync(skillPath, content);
-
-    // 生成并写入 plugin.json
-    const pluginJson = generatePluginJson(skillName, { version, description, author });
-    const pluginPath = path.join(skillMarketplaceDir, 'plugin.json');
-    safeWriteJson(pluginPath, pluginJson);
-
-    // 更新市场索引
-    const indexPath = getMarketplaceIndexPath();
-    const index = safeReadJson(indexPath, { skills: [], lastUpdated: null });
-
-    const existingIndex = index.skills.findIndex(s => s.name === skillName);
-    const skillEntry = {
-      name: skillName,
-      version,
-      description: pluginJson.description,
-      author,
-      isPublic,
-      publishedAt: new Date().toISOString()
-    };
-
-    if (existingIndex >= 0) {
-      index.skills[existingIndex] = skillEntry;
-    } else {
-      index.skills.push(skillEntry);
-    }
-
-    index.lastUpdated = new Date().toISOString();
-    safeWriteJson(indexPath, index);
-
-    // 生成市场 URL（本地路径）
-    const marketplaceUrl = `file://${skillMarketplaceDir}`;
-
-    return {
-      success: true,
-      marketplaceUrl,
-      skillName,
-      version
-    };
-  } catch (e) {
-    return {
-      success: false,
-      error: e.message
-    };
-  }
-}
-
-/**
- * 从市场安装技能
- *
- * @param {string} skillName - 技能名称
- * @param {Object} options - 选项
- * @returns {Object} 安装结果 { success, path }
- */
-export function installFromMarketplace(skillName, options = {}) {
-  const { targetScope = KNOWLEDGE_SCOPE.GLOBAL, orgName = null } = options;
-
-  const marketplaceDir = getMarketplaceDir();
-  const skillMarketplaceDir = path.join(marketplaceDir, skillName);
-  const skillPath = path.join(skillMarketplaceDir, 'SKILL.md');
-
-  if (!fs.existsSync(skillPath)) {
-    return { success: false, error: '市场技能不存在' };
-  }
-
-  try {
-    // 读取市场技能内容
-    const content = fs.readFileSync(skillPath, 'utf-8');
-
-    // 目标目录
-    const targetDir = targetScope === KNOWLEDGE_SCOPE.ORG
-      ? path.join(os.homedir(), '.claude/autospec/orgs', orgName, 'skills')
-      : path.join(os.homedir(), GLOBAL_AUTOSPEC_DIR, 'skills');
-
-    const targetPath = path.join(targetDir, skillName);
-
-    // 创建目标目录
-    if (!fs.existsSync(targetPath)) {
-      fs.mkdirSync(targetPath, { recursive: true });
-    }
-
-    // 写入技能文件
-    const targetSkillPath = path.join(targetPath, 'SKILL.md');
-    fs.writeFileSync(targetSkillPath, content);
-
-    return {
-      success: true,
-      path: targetSkillPath
-    };
-  } catch (e) {
-    return {
-      success: false,
-      error: e.message
-    };
-  }
-}
-
-/**
- * 搜索市场技能
- *
- * @param {string} query - 搜索关键词
- * @returns {Array} 搜索结果
- */
-export function searchMarketplace(query) {
-  const indexPath = getMarketplaceIndexPath();
-  const index = safeReadJson(indexPath, { skills: [] });
-
-  if (!query) {
-    return index.skills;
-  }
-
-  const queryLower = query.toLowerCase();
-
-  return index.skills.filter(skill =>
-    skill.name.toLowerCase().includes(queryLower) ||
-    (skill.description && skill.description.toLowerCase().includes(queryLower))
-  );
-}
-
-/**
- * 获取市场技能列表
- *
- * @returns {Array} 技能列表
- */
-export function listMarketplaceSkills() {
-  const indexPath = getMarketplaceIndexPath();
-  const index = safeReadJson(indexPath, { skills: [], lastUpdated: null });
-
-  return {
-    skills: index.skills,
-    lastUpdated: index.lastUpdated,
-    count: index.skills.length
-  };
-}
-
-/**
- * 从市场移除技能
- *
- * @param {string} skillName - 技能名称
- * @returns {Object} 移除结果
- */
-export function removeFromMarketplace(skillName) {
-  const marketplaceDir = getMarketplaceDir();
-  const skillMarketplaceDir = path.join(marketplaceDir, skillName);
-
-  if (!fs.existsSync(skillMarketplaceDir)) {
-    return { success: false, error: '市场技能不存在' };
-  }
-
-  try {
-    // 删除技能目录
-    fs.rmSync(skillMarketplaceDir, { recursive: true });
-
-    // 更新市场索引
-    const indexPath = getMarketplaceIndexPath();
-    const index = safeReadJson(indexPath, { skills: [], lastUpdated: null });
-
-    index.skills = index.skills.filter(s => s.name !== skillName);
-    index.lastUpdated = new Date().toISOString();
-    safeWriteJson(indexPath, index);
-
-    return { success: true };
-  } catch (e) {
-    return {
-      success: false,
-      error: e.message
-    };
-  }
-}
-
-export default {
-  generatePluginJson,
-  publishToMarketplace,
-  installFromMarketplace,
-  searchMarketplace,
-  listMarketplaceSkills,
-  removeFromMarketplace
-};