joyskills-cli 0.2.6 → 0.2.7

package/src/commands/sync.js

@@ -1,263 +1,174 @@
-#!/usr/bin/env node
-
-import fs from 'fs';
-import path from 'path';
-import * as YAML from 'yaml';
-import { fileURLToPath } from 'url';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-
-/**
- * joySkills sync 命令
- * 
- * 功能：
- * 1. 扫描 skills/ 目录
- * 2. 生成/更新 AGENTS.md（与 openskills sync 格式一致）
- * 3. 更新 joySkills.lock（记录扫描到的所有 skill）
- * 4. 验证版本一致性
- * 
- * 设计原则：
- * - 100% 兼容 OpenSkills 生成的 AGENTS.md
- * - 在 OpenSkills 基础上增强（版本锁定 + 一致性检查）
- */
-
-export async function syncCommand() {
-  console.log('🔄 正在同步 skills 到 AGENTS.md...\n');
-
-  try {
-    // 1. 扫描所有可能的 skills 目录（按优先级）
-    const cwd = process.cwd();
-    const homeDir = process.env.HOME || process.env.USERPROFILE;
-    
-    const searchDirs = [
-      path.join(cwd, '.agent', 'skills'),      // joySkills 项目级
-      path.join(homeDir, '.agent', 'skills'),  // joySkills 全局
-      path.join(cwd, '.claude', 'skills'),     // OpenSkills --project
-      path.join(homeDir, '.claude', 'skills'), // OpenSkills --global
-    ];
-
-    const allSkills = [];
-    for (const dir of searchDirs) {
-      if (fs.existsSync(dir)) {
-        const skills = scanSkills(dir);
-        allSkills.push(...skills);
+import { Command } from 'commander';
+import { LocalManager } from '../local.js';
+import { LockfileManager } from '../lockfile.js';
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import chalk from 'chalk';
+
+export function syncCommand(program) {
+  program
+    .command('sync')
+    .description('Scan skills and generate AGENTS.md')
+    .option('-o, --output <file>', 'Output file name', 'AGENTS.md')
+    .option('-y, --yes', 'Skip prompts')
+    .option('--no-lock', 'Skip updating joySkills.lock')
+    .action(async (options) => {
+      try {
+        const projectRoot = process.cwd();
+        const lockfileManager = new LockfileManager(projectRoot);
+
+        console.log(chalk.blue('🔍 Scanning skills...'));
+
+        // Scan all skill directories (openskill priority order)
+        const skillDirs = [
+          { path: path.join(projectRoot, '.agent', 'skills'), label: 'universal' },
+          { path: path.join(projectRoot, '.claude', 'skills'), label: 'project' },
+          { path: path.join(os.homedir(), '.agent', 'skills'), label: 'global-universal' },
+          { path: path.join(os.homedir(), '.claude', 'skills'), label: 'global' },
+          // legacy
+          { path: path.join(projectRoot, 'skills'), label: 'legacy' },
+        ];
+
+        const allSkills = [];
+        const seen = new Set();
+
+        for (const dir of skillDirs) {
+          if (!fs.existsSync(dir.path)) continue;
+          const skills = scanSkillDirectory(dir.path);
+          for (const skill of skills) {
+            if (!seen.has(skill.name)) {
+              seen.add(skill.name);
+              allSkills.push(skill);
+            }
+          }
+        }
+
+        if (allSkills.length === 0) {
+          console.log(chalk.yellow('⚠️  No skills found'));
+          return;
+        }
+
+        console.log(chalk.green(`   Found ${allSkills.length} skill(s)`));
+
+        // Generate AGENTS.md with openskill-compatible XML format
+        const agentsMd = generateAgentsMd(allSkills);
+        const outputPath = path.join(projectRoot, options.output);
+        fs.writeFileSync(outputPath, agentsMd, 'utf-8');
+        console.log(chalk.green(`   ✓ Generated ${options.output}`));
+
+        // Update lockfile
+        if (options.lock !== false) {
+          await lockfileManager.load();
+          for (const skill of allSkills) {
+            const existing = lockfileManager.getSkill(skill.name);
+            lockfileManager.updateSkill(skill.name, {
+              version: skill.version || existing?.version || '1.0.0',
+              source: existing?.source || 'local',
+              installedAt: existing?.installedAt || new Date().toISOString(),
+              path: skill.path
+            });
+          }
+          await lockfileManager.save();
+          console.log(chalk.green(`   ✓ Updated joySkills.lock`));
+        }
+
+        // Print summary
+        console.log(chalk.blue('\n📋 Skills Summary:'));
+        console.log(chalk.gray('─'.repeat(50)));
+        for (const skill of allSkills) {
+          const status = skill.hasSkillMd ? chalk.green('✓') : chalk.red('✗');
+          console.log(`   ${status} ${skill.name} ${chalk.gray(skill.version || '')}`);
+          if (skill.description) console.log(`     ${chalk.gray(skill.description)}`);
+        }
+
+        console.log(chalk.green(`\n✅ Sync completed`));
+
+      } catch (error) {
+        console.error(chalk.red(`❌ Sync failed: ${error.message}`));
+        process.exit(1);
       }
-    }
-
-    // 去重（按 id）
-    const uniqueSkills = [];
-    const seenIds = new Set();
-    for (const skill of allSkills) {
-      if (!seenIds.has(skill.id)) {
-        seenIds.add(skill.id);
-        uniqueSkills.push(skill);
-      }
-    }
-
-    console.log(`📦 扫描到 ${uniqueSkills.length} 个 skills:\n`);
-    uniqueSkills.forEach(skill => {
-      console.log(`   - ${skill.id} (${skill.version || 'unknown'})`);
     });
-    console.log('');
-
-    // 2. 生成 AGENTS.md（OpenSkills 兼容格式）
-    const agentsMdContent = generateAgentsMd(uniqueSkills);
-    const agentsMdPath = path.join(process.cwd(), 'AGENTS.md');
-    fs.writeFileSync(agentsMdPath, agentsMdContent, 'utf-8');
-    console.log(`✅ 已生成 AGENTS.md\n`);
-
-    // 3. 更新 joySkills.lock（joySkills 增强功能）
-    await updateLockfile(uniqueSkills);
-
-    // 4. 验证版本一致性（joySkills 增强功能）
-    await verifyConsistency(uniqueSkills);
-
-    console.log('✨ 同步完成！\n');
-    console.log('💡 提示：');
-    console.log('   - AGENTS.md 已生成，AI 编辑器会自动识别');
-    console.log('   - joySkills.lock 已更新，确保版本锁定\n');
-
-  } catch (error) {
-    console.error('❌ 同步失败:', error.message);
-    process.exit(1);
-  }
 }
 
-/**
- * 扫描 skills 目录
- */
-function scanSkills(skillsDir) {
+function scanSkillDirectory(basePath) {
   const skills = [];
-  const entries = fs.readdirSync(skillsDir, { withFileTypes: true });
-
+  const entries = fs.readdirSync(basePath, { withFileTypes: true });
+  
   for (const entry of entries) {
-    if (!entry.isDirectory()) continue;
-
-    const skillPath = path.join(skillsDir, entry.name);
-    const skillMdPath = path.join(skillPath, 'SKILL.md');
-
-    if (!fs.existsSync(skillMdPath)) {
-      console.log(`⚠️  跳过 ${entry.name}（缺少 SKILL.md）`);
-      continue;
+    if (entry.isDirectory() && !entry.name.startsWith('.')) {
+      const skillPath = path.join(basePath, entry.name);
+      const skillMdPath = path.join(skillPath, 'SKILL.md');
+      
+      let skillInfo = {
+        name: entry.name,
+        path: skillPath,
+        hasSkillMd: fs.existsSync(skillMdPath),
+        version: '1.0.0',
+        description: ''
+      };
+      
+      if (skillInfo.hasSkillMd) {
+        const content = fs.readFileSync(skillMdPath, 'utf-8');
+        const parsed = parseSkillMd(content);
+        skillInfo = { ...skillInfo, ...parsed };
+      }
+      
+      skills.push(skillInfo);
     }
-
-    // 解析 SKILL.md
-    const skillContent = fs.readFileSync(skillMdPath, 'utf-8');
-    const metadata = parseSkillMetadata(skillContent);
-
-    skills.push({
-      id: entry.name,
-      path: skillPath,
-      ...metadata
-    });
   }
-
-  return skills;
-}
-
-/**
- * 解析 SKILL.md 的 YAML frontmatter
- */
-function parseSkillMetadata(content) {
-  const match = content.match(/^---\n([\s\S]*?)\n---/);
-  if (!match) return {};
-
-  const yamlContent = match[1];
   
-  try {
-    // 使用 yaml 包解析（支持完整 YAML 语法）
-    return YAML.parse(yamlContent) || {};
-  } catch (error) {
-    console.warn(`⚠️  YAML 解析失败: ${error.message}`);
-    return {};
-  }
-}
-
-/**
- * 生成 AGENTS.md（OpenSkills 兼容格式）
- */
-function generateAgentsMd(skills) {
-  let content = `# AI Agent Skills\n\n`;
-  content += `> 此文件由 joySkills sync 自动生成\n`;
-  content += `> 兼容 OpenSkills 格式，所有 AI 编辑器均可识别\n\n`;
-
-  content += `## 已安装的 Skills (${skills.length})\n\n`;
-
-  for (const skill of skills) {
-    content += `### ${skill.name || skill.id}\n\n`;
-    content += `**ID**: \`${skill.id}\`\n`;
-    if (skill.version) {
-      content += `**Version**: ${skill.version}\n`;
-    }
-    if (skill.description) {
-      content += `**Description**: ${skill.description}\n`;
-    }
-    content += `**Path**: \`skills/${skill.id}\`\n\n`;
-
-    // 添加 XML 片段（供 AI 编辑器解析）
-    content += `\`\`\`xml\n`;
-    content += `<skill id="${skill.id}">\n`;
-    content += `  <name>${skill.name || skill.id}</name>\n`;
-    if (skill.version) {
-      content += `  <version>${skill.version}</version>\n`;
-    }
-    content += `  <path>skills/${skill.id}/SKILL.md</path>\n`;
-    content += `</skill>\n`;
-    content += `\`\`\`\n\n`;
-  }
-
-  content += `---\n\n`;
-  content += `生成时间: ${new Date().toISOString()}\n`;
-  content += `生成工具: joySkills ${getVersion()}\n`;
-
-  return content;
+  return skills;
 }
 
-/**
- * 更新 joySkills.lock（joySkills 增强功能）
- */
-async function updateLockfile(skills) {
-  const lockfilePath = path.join(process.cwd(), 'joySkills.lock');
-  
-  let lockData = {
-    lockVersion: 1,
-    projectId: path.basename(process.cwd()),
-    generatedAt: new Date().toISOString(),
-    skills: {}
+function parseSkillMd(content) {
+  const result = {
+    version: '1.0.0',
+    description: ''
   };
-
-  // 读取现有 lockfile
-  if (fs.existsSync(lockfilePath)) {
-    const existingContent = fs.readFileSync(lockfilePath, 'utf-8');
-    try {
-      lockData = JSON.parse(existingContent);
-    } catch (e) {
-      console.log('⚠️  joySkills.lock 格式错误，将重新生成');
+  
+  // Parse frontmatter
+  const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---/);
+  if (frontmatterMatch) {
+    const frontmatter = frontmatterMatch[1];
+    
+    const versionMatch = frontmatter.match(/version:\s*(.+)/);
+    if (versionMatch) {
+      result.version = versionMatch[1].trim();
     }
-  }
-
-  // 更新 skills 信息
-  for (const skill of skills) {
-    const existingSkill = lockData.skills[skill.id] || {};
     
-    lockData.skills[skill.id] = {
-      version: skill.version || existingSkill.version || 'unknown',
-      installedAt: existingSkill.installedAt || new Date().toISOString(),
-      lastSyncAt: new Date().toISOString()
-    };
-  }
-
-  // 写入 lockfile
-  fs.writeFileSync(
-    lockfilePath,
-    JSON.stringify(lockData, null, 2),
-    'utf-8'
-  );
-
-  console.log('✅ 已更新 joySkills.lock');
-}
-
-/**
- * 验证版本一致性（joySkills 增强功能）
- */
-async function verifyConsistency(skills) {
-  const lockfilePath = path.join(process.cwd(), 'joySkills.lock');
-  if (!fs.existsSync(lockfilePath)) return;
-
-  const lockData = JSON.parse(fs.readFileSync(lockfilePath, 'utf-8'));
-  let hasWarning = false;
-
-  for (const skill of skills) {
-    const lockedSkill = lockData.skills[skill.id];
-    if (!lockedSkill) continue;
-
-    if (skill.version && lockedSkill.version !== skill.version) {
-      if (!hasWarning) {
-        console.log('\n⚠️  版本不一致警告:\n');
-        hasWarning = true;
-      }
-      console.log(`   ${skill.id}:`);
-      console.log(`   - Lock 文件: ${lockedSkill.version}`);
-      console.log(`   - 实际版本: ${skill.version}`);
-      console.log(`   💡 建议: joySkills upgrade ${skill.id}\n`);
+    const descMatch = frontmatter.match(/description:\s*(.+)/);
+    if (descMatch) {
+      result.description = descMatch[1].trim();
     }
   }
-
-  if (!hasWarning) {
-    console.log('✅ 版本一致性检查通过');
-  }
+  
+  return result;
 }
 
-/**
- * 获取 joySkills 版本
- */
-function getVersion() {
-  try {
-    const packagePath = path.join(__dirname, '../../package.json');
-    const pkg = JSON.parse(fs.readFileSync(packagePath, 'utf-8'));
-    return pkg.version;
-  } catch (e) {
-    return 'unknown';
-  }
+function generateAgentsMd(skills) {
+  // openskill-compatible <available_skills> XML block
+  const skillBlocks = skills.map(skill => {
+    const location = skill.hasSkillMd ? 'plugin' : 'inline';
+    const desc = skill.description
+      ? skill.description.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;')
+      : `Skill: ${skill.name}`;
+    return [
+      `<skill>`,
+      `<name>${skill.name}</name>`,
+      `<description>${desc}</description>`,
+      `<location>${location}</location>`,
+      `</skill>`
+    ].join('\n');
+  }).join('\n');
+
+  const lines = [
+    `<available_skills>`,
+    skillBlocks,
+    `</available_skills>`,
+    ``,
+    `> Generated by joySkills on ${new Date().toISOString()}. Run \`joySkills sync\` to update.`,
+  ];
+
+  return lines.join('\n');
 }