joyskills-cli 0.2.9 → 0.3.0

package/src/skill-loader.js

@@ -0,0 +1,207 @@
+/**
+ * SkillLoader - 统一加载 Skills
+ * 支持项目级和用户级目录，自动合并同名 Skill（项目级优先）
+ */
+
+import * as fs from 'fs';
+import * as path from 'path';
+import { getAllSkillPaths, getAgentProjectPath, getAgentGlobalPath } from './agents.js';
+
+/**
+ * Skill 对象
+ */
+export class Skill {
+  constructor(name, skillPath, scope, agent, metadata = {}) {
+    this.name = name;
+    this.path = skillPath;
+    this.scope = scope; // 'project' | 'global'
+    this.agent = agent;
+    this.metadata = metadata;
+    this.version = metadata.version || '1.0.0';
+    this.description = metadata.description || '';
+  }
+}
+
+/**
+ * SkillLoader 类
+ */
+export class SkillLoader {
+  constructor(projectRoot) {
+    this.projectRoot = projectRoot;
+    this.skillsCache = null;
+  }
+
+  /**
+   * 扫描单个目录中的所有 Skills
+   */
+  scanDirectory(dirPath, scope, agent) {
+    const skills = [];
+    
+    if (!fs.existsSync(dirPath)) {
+      return skills;
+    }
+
+    const entries = fs.readdirSync(dirPath, { withFileTypes: true });
+    
+    for (const entry of entries) {
+      if (!entry.isDirectory() || entry.name.startsWith('.')) {
+        continue;
+      }
+
+      const skillPath = path.join(dirPath, entry.name);
+      const skillMdPath = path.join(skillPath, 'SKILL.md');
+      
+      if (!fs.existsSync(skillMdPath)) {
+        continue;
+      }
+
+      // 解析 SKILL.md
+      const metadata = this.parseSkillMd(skillMdPath);
+      
+      skills.push(new Skill(
+        entry.name,
+        skillPath,
+        scope,
+        agent,
+        metadata
+      ));
+    }
+
+    return skills;
+  }
+
+  /**
+   * 解析 SKILL.md 的 frontmatter
+   */
+  parseSkillMd(skillMdPath) {
+    try {
+      const content = fs.readFileSync(skillMdPath, 'utf-8');
+      const metadata = {};
+      
+      // 解析 YAML frontmatter
+      const frontmatterMatch = content.match(/^---\s*\n([\s\S]*?)\n---/);
+      if (frontmatterMatch) {
+        const frontmatter = frontmatterMatch[1];
+        
+        // 简单解析 key: value
+        const lines = frontmatter.split('\n');
+        for (const line of lines) {
+          const match = line.match(/^(\w+):\s*(.+)$/);
+          if (match) {
+            metadata[match[1]] = match[2].trim();
+          }
+        }
+      }
+      
+      return metadata;
+    } catch (e) {
+      return {};
+    }
+  }
+
+  /**
+   * 加载所有 Skills（项目级 + 用户级）
+   * 同名 Skill，项目级优先覆盖用户级
+   */
+  loadAllSkills(agentId = null) {
+    if (this.skillsCache) {
+      return this.skillsCache;
+    }
+
+    const skillPaths = getAllSkillPaths(this.projectRoot, agentId);
+    const skillMap = new Map();
+
+    // 按优先级顺序扫描（高优先级在后，覆盖低优先级）
+    for (const { path: dirPath, scope, agent } of skillPaths.reverse()) {
+      const skills = this.scanDirectory(dirPath, scope, agent);
+      
+      for (const skill of skills) {
+        // 项目级覆盖用户级，同名 Skill 后加载的覆盖先加载的
+        skillMap.set(skill.name, skill);
+      }
+    }
+
+    this.skillsCache = Array.from(skillMap.values());
+    return this.skillsCache;
+  }
+
+  /**
+   * 仅加载项目级 Skills
+   */
+  loadProjectSkills(agentId = null) {
+    const allSkills = this.loadAllSkills(agentId);
+    return allSkills.filter(s => s.scope === 'project');
+  }
+
+  /**
+   * 仅加载用户级 Skills
+   */
+  loadGlobalSkills(agentId = null) {
+    const allSkills = this.loadAllSkills(agentId);
+    return allSkills.filter(s => s.scope === 'global');
+  }
+
+  /**
+   * 获取指定 Skill
+   */
+  getSkill(skillName, agentId = null) {
+    const skills = this.loadAllSkills(agentId);
+    return skills.find(s => s.name === skillName);
+  }
+
+  /**
+   * 检查 Skill 是否存在
+   */
+  hasSkill(skillName, agentId = null) {
+    return !!this.getSkill(skillName, agentId);
+  }
+
+  /**
+   * 获取 Skill 路径
+   */
+  getSkillPath(skillName, agentId = null) {
+    const skill = this.getSkill(skillName, agentId);
+    return skill ? skill.path : null;
+  }
+
+  /**
+   * 清除缓存
+   */
+  clearCache() {
+    this.skillsCache = null;
+  }
+
+  /**
+   * 获取 Skill 统计信息
+   */
+  getStats(agentId = null) {
+    const allSkills = this.loadAllSkills(agentId);
+    const projectSkills = allSkills.filter(s => s.scope === 'project');
+    const globalSkills = allSkills.filter(s => s.scope === 'global');
+
+    return {
+      total: allSkills.length,
+      project: projectSkills.length,
+      global: globalSkills.length,
+      agents: [...new Set(allSkills.map(s => s.agent))],
+    };
+  }
+}
+
+/**
+ * 便捷的加载函数
+ */
+export function loadSkills(projectRoot, agentId = null) {
+  const loader = new SkillLoader(projectRoot);
+  return loader.loadAllSkills(agentId);
+}
+
+export function loadProjectSkills(projectRoot, agentId = null) {
+  const loader = new SkillLoader(projectRoot);
+  return loader.loadProjectSkills(agentId);
+}
+
+export function loadGlobalSkills(projectRoot, agentId = null) {
+  const loader = new SkillLoader(projectRoot);
+  return loader.loadGlobalSkills(agentId);
+}

package/src/version-checker.js

@@ -0,0 +1,129 @@
+/**
+ * VersionChecker - 技能版本检查
+ * 检查已安装技能是否有更新
+ */
+
+import * as fs from 'fs';
+import * as path from 'path';
+import simpleGit from 'simple-git';
+import { SkillLoader } from './skill-loader.js';
+
+/**
+ * 获取 Skill 的 Git 信息
+ */
+export async function getSkillGitInfo(skillPath) {
+  try {
+    const git = simpleGit(skillPath);
+    const isRepo = await git.checkIsRepo();
+    
+    if (!isRepo) {
+      return null;
+    }
+
+    const remotes = await git.getRemotes(true);
+    const origin = remotes.find(r => r.name === 'origin');
+    
+    if (!origin) {
+      return null;
+    }
+
+    const log = await git.log({ maxCount: 1 });
+    const latestCommit = log.latest;
+
+    return {
+      remote: origin.refs.fetch,
+      commit: latestCommit?.hash || null,
+      date: latestCommit?.date || null,
+      message: latestCommit?.message || null,
+    };
+  } catch (e) {
+    return null;
+  }
+}
+
+/**
+ * 检查远程是否有更新
+ */
+export async function checkRemoteUpdate(skillPath, currentCommit) {
+  try {
+    const git = simpleGit(skillPath);
+    const isRepo = await git.checkIsRepo();
+    
+    if (!isRepo) {
+      return { hasUpdate: false, error: 'Not a git repository' };
+    }
+
+    // 获取远程更新（不合并）
+    await git.fetch(['--depth', '1']);
+    
+    const log = await git.log({ 
+      from: currentCommit,
+      to: 'HEAD',
+      maxCount: 10
+    });
+
+    const commitsBehind = log.total;
+    
+    return {
+      hasUpdate: commitsBehind > 0,
+      commitsBehind,
+      latestCommit: log.latest,
+    };
+  } catch (e) {
+    return { hasUpdate: false, error: e.message };
+  }
+}
+
+/**
+ * 检查单个 Skill
+ */
+export async function checkSkill(skill) {
+  const gitInfo = await getSkillGitInfo(skill.path);
+  
+  if (!gitInfo) {
+    return {
+      name: skill.name,
+      hasUpdate: false,
+      currentVersion: skill.version,
+      source: 'local',
+      error: 'Not a git repository',
+    };
+  }
+
+  const updateInfo = await checkRemoteUpdate(skill.path, gitInfo.commit);
+
+  return {
+    name: skill.name,
+    hasUpdate: updateInfo.hasUpdate,
+    currentVersion: skill.version,
+    commitsBehind: updateInfo.commitsBehind,
+    latestCommit: updateInfo.latestCommit,
+    remote: gitInfo.remote,
+    source: 'git',
+  };
+}
+
+/**
+ * 检查所有 Skills
+ */
+export async function checkAllSkills(projectRoot) {
+  const loader = new SkillLoader(projectRoot);
+  const skills = loader.loadAllSkills();
+  
+  const results = [];
+  
+  for (const skill of skills) {
+    const result = await checkSkill(skill);
+    results.push(result);
+  }
+
+  return results;
+}
+
+/**
+ * 获取可更新的 Skills
+ */
+export async function getUpdatableSkills(projectRoot) {
+  const results = await checkAllSkills(projectRoot);
+  return results.filter(r => r.hasUpdate);
+}