sumulige-claude 1.5.1 → 1.6.0

package/scripts/update-registry.mjs

@@ -1,325 +0,0 @@
-#!/usr/bin/env node
-/**
- * Update Marketplace Registry
- *
- * This script scans the skills directory and generates the marketplace.json
- * registry file for Claude Code's native plugin system.
- *
- * Usage: node scripts/update-registry.mjs
- */
-
-import fs from 'fs';
-import path from 'path';
-import { fileURLToPath } from 'url';
-import { execSync } from 'child_process';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-const ROOT_DIR = path.join(__dirname, '..');
-const MARKETPLACE_FILE = path.join(ROOT_DIR, '.claude-plugin', 'marketplace.json');
-const SKILLS_DIR = path.join(ROOT_DIR, 'template', '.claude', 'skills');
-const CATEGORIES_FILE = path.join(ROOT_DIR, 'config', 'skill-categories.json');
-
-// ============================================================================
-// Logging Utilities
-// ============================================================================
-
-const COLORS = {
-  reset: '\x1b[0m',
-  green: '\x1b[32m',
-  blue: '\x1b[34m',
-  yellow: '\x1b[33m',
-  gray: '\x1b[90m'
-};
-
-function log(message, color = 'reset') {
-  console.log(`${COLORS[color]}${message}${COLORS.reset}`);
-}
-
-// ============================================================================
-// File System Utilities
-// ============================================================================
-
-/**
- * Recursively find all skill directories
- */
-function findSkillDirs(dir, basePath = dir) {
-  if (!fs.existsSync(dir)) {
-    return [];
-  }
-
-  const skills = [];
-  const entries = fs.readdirSync(dir, { withFileTypes: true });
-
-  for (const entry of entries) {
-    if (entry.isDirectory()) {
-      const fullPath = path.join(dir, entry.name);
-
-      // Skip template and examples directories
-      if (['template', 'examples', '__tests__'].includes(entry.name)) {
-        continue;
-      }
-
-      // Check if this is a skill directory (contains SKILL.md or metadata.yaml)
-      const hasSkillFile = fs.existsSync(path.join(fullPath, 'SKILL.md'));
-      const hasMetadata = fs.existsSync(path.join(fullPath, 'metadata.yaml'));
-      const hasSourceJson = fs.existsSync(path.join(fullPath, '.source.json'));
-
-      if (hasSkillFile || hasMetadata || hasSourceJson) {
-        const relativePath = path.relative(basePath, fullPath);
-        skills.push({
-          name: entry.name,
-          path: fullPath,
-          relativePath: relativePath,
-          hasSourceJson
-        });
-      } else {
-        // Recurse into subdirectories
-        skills.push(...findSkillDirs(fullPath, basePath));
-      }
-    }
-  }
-
-  return skills;
-}
-
-/**
- * Parse YAML metadata file
- */
-function parseMetadata(skillDir) {
-  const metadataPath = path.join(skillDir, 'metadata.yaml');
-
-  if (!fs.existsSync(metadataPath)) {
-    return null;
-  }
-
-  try {
-    const content = fs.readFileSync(metadataPath, 'utf8');
-    // Simple YAML parser for basic key: value format
-    const result = {};
-    let currentKey = null;
-
-    content.split('\n').forEach(line => {
-      const trimmed = line.trim();
-
-      // Skip comments and empty lines
-      if (!trimmed || trimmed.startsWith('#')) {
-        return;
-      }
-
-      // Key: Value pair
-      const match = trimmed.match(/^([^:]+):\s*(.*)$/);
-      if (match) {
-        currentKey = match[1];
-        let value = match[2];
-
-        // Handle array values
-        if (value.startsWith('[')) {
-          try {
-            value = JSON.parse(value.replace(/'/g, '"'));
-          } catch (e) {
-            value = [];
-          }
-        } else if (value === '[]') {
-          value = [];
-        } else if (value === 'true') {
-          value = true;
-        } else if (value === 'false') {
-          value = false;
-        }
-
-        result[currentKey] = value;
-      } else if (currentKey && trimmed.startsWith('-')) {
-        // Array item continuation
-        if (!Array.isArray(result[currentKey])) {
-          result[currentKey] = [];
-        }
-        result[currentKey].push(trimmed.slice(1).trim());
-      }
-    });
-
-    return result;
-  } catch (error) {
-    log(`Warning: Failed to parse ${metadataPath}`, 'yellow');
-    return null;
-  }
-}
-
-/**
- * Parse .source.json file
- */
-function parseSourceJson(skillDir) {
-  const sourcePath = path.join(skillDir, '.source.json');
-
-  if (!fs.existsSync(sourcePath)) {
-    return null;
-  }
-
-  try {
-    const content = fs.readFileSync(sourcePath, 'utf-8');
-    return JSON.parse(content);
-  } catch (error) {
-    return null;
-  }
-}
-
-/**
- * Get skill description from SKILL.md
- */
-function getSkillDescription(skillDir) {
-  const skillPath = path.join(skillDir, 'SKILL.md');
-
-  if (!fs.existsSync(skillPath)) {
-    return null;
-  }
-
-  try {
-    const content = fs.readFileSync(skillPath, 'utf-8');
-    // Extract first heading or first paragraph
-    const lines = content.split('\n');
-
-    for (const line of lines) {
-      const trimmed = line.trim();
-      // Skip title
-      if (trimmed.startsWith('#')) {
-        continue;
-      }
-      // Return first non-empty, non-comment line
-      if (trimmed && !trimmed.startsWith('>') && !trimmed.startsWith('<!--')) {
-        return trimmed.replace(/^>/, '').trim();
-      }
-    }
-
-    return null;
-  } catch (error) {
-    return null;
-  }
-}
-
-/**
- * Determine skill category
- */
-function getSkillCategory(skillPath, categories) {
-  // Check if path contains a category
-  const pathParts = skillPath.split(path.sep);
-
-  for (const part of pathParts) {
-    if (categories[part]) {
-      return part;
-    }
-  }
-
-  return 'tools'; // Default category
-}
-
-// ============================================================================
-// Registry Generation
-// ============================================================================
-
-/**
- * Generate the marketplace.json registry
- */
-function generateRegistry() {
-  log('📋 Generating Marketplace Registry', 'blue');
-  log('=====================================', 'gray');
-  log('');
-
-  // Load categories
-  let categories = {};
-  if (fs.existsSync(CATEGORIES_FILE)) {
-    categories = JSON.parse(fs.readFileSync(CATEGORIES_FILE, 'utf-8')).categories || {};
-  }
-
-  // Find all skill directories
-  log('Scanning skills directory...', 'gray');
-  const skills = findSkillDirs(SKILLS_DIR);
-  log(`Found ${skills.length} skill(s)`, 'gray');
-  log('');
-
-  if (skills.length === 0) {
-    log('No skills found. Registry will be empty.', 'yellow');
-    return;
-  }
-
-  // Build plugin entries
-  const pluginSkills = [];
-
-  for (const skill of skills) {
-    log(`Processing: ${skill.name}`, 'gray');
-
-    // Get metadata
-    const metadata = parseMetadata(skill.path);
-    const sourceJson = parseSourceJson(skill.path);
-    const description = metadata?.description || getSkillDescription(skill.path) || 'No description';
-
-    // Determine category
-    const category = metadata?.category || getSkillCategory(skill.relativePath, categories);
-
-    // Build relative path from .claude-plugin
-    const relativeFromPlugin = path.join('..', 'template', '.claude', 'skills', skill.relativePath);
-
-    pluginSkills.push({
-      name: skill.name,
-      description: description,
-      path: `./${relativeFromPlugin}`,
-      category: category,
-      external: !!sourceJson
-    });
-  }
-
-  // Build the full registry
-  const registry = {
-    name: 'smc-skills',
-    description: 'Sumulige Claude Agent Harness - Curated skill collection for AI coding agents',
-    homepage: 'https://github.com/sumulige/sumulige-claude',
-    owner: {
-      name: 'sumulige',
-      email: 'sumulige@example.com'
-    },
-    plugins: [
-      {
-        name: 'smc-skills',
-        description: 'Multi-agent orchestration harness with curated skills. Includes Conductor, Architect, Builder, Reviewer, Librarian agents plus RAG-based skill discovery system.',
-        source: './',
-        skills: pluginSkills.map(s => s.path),
-        strict: false,
-        skill_list: pluginSkills
-      }
-    ],
-    metadata: {
-      version: getPackageVersion(),
-      generated_at: new Date().toISOString(),
-      skill_count: skills.length,
-      categories: categories
-    }
-  };
-
-  // Write registry file
-  log('', 'gray');
-  log(`Writing registry to: ${MARKETPLACE_FILE}`, 'gray');
-  fs.writeFileSync(MARKETPLACE_FILE, JSON.stringify(registry, null, 2));
-
-  log('', 'gray');
-  log('=====================================', 'gray');
-  log(`✅ Registry generated with ${skills.length} skills`, 'green');
-  log('=====================================', 'gray');
-}
-
-/**
- * Get package version
- */
-function getPackageVersion() {
-  try {
-    const pkgPath = path.join(ROOT_DIR, 'package.json');
-    const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
-    return pkg.version || '1.0.0';
-  } catch (error) {
-    return '1.0.0';
-  }
-}
-
-// ============================================================================
-// Run
-// ============================================================================
-
-generateRegistry();

package/sources.yaml

@@ -1,83 +0,0 @@
-# SMC External Skills Sources
-# ===========================
-# 此清单定义了从外部仓库同步到本项目的技能。
-# GitHub Actions 工作流会读取此文件并每日自动同步上游技能。
-#
-# 添加技能：提交 PR 添加条目到此处。参考 CONTRIBUTING.md。
-
-version: 1
-skills:
-  # ─────────────────────────────────────────────────────────────────────────────
-  # manus-kickoff - Native skill (maintained directly in this repo)
-  # ─────────────────────────────────────────────────────────────────────────────
-  - name: manus-kickoff
-    description: Manus-style project kickoff workflow for AI autonomous development
-    native: true  # Maintained directly in this repo
-    target:
-      category: workflow
-      path: template/.claude/skills/manus-kickoff
-    author:
-      name: sumulige
-      github: sumulige
-    license: MIT
-    homepage: https://github.com/sumulige/sumulige-claude
-
-  # ─────────────────────────────────────────────────────────────────────────────
-  # Example: Adding an external skill (commented out)
-  # ─────────────────────────────────────────────────────────────────────────────
-  # - name: dev-browser
-  #   description: Browser automation with persistent page state
-  #   source:
-  #     repo: SawyerHood/dev-browser
-  #     path: skills/dev-browser
-  #     ref: main
-  #   target:
-  #     category: automation
-  #     path: template/.claude/skills/automation/dev-browser
-  #   author:
-  #     name: Sawyer Hood
-  #     github: SawyerHood
-  #   license: MIT
-  #   homepage: https://github.com/SawyerHood/dev-browser
-  #   verified: false
-  #   sync:
-  #     include:
-  #       - SKILL.md
-  #       - references/
-  #       - scripts/
-  #       - src/
-  #       - package.json
-  #     exclude:
-  #       - node_modules/
-  #       - "*.lock"
-
-# ─────────────────────────────────────────────────────────────────────────────
-# Schema Reference
-# ─────────────────────────────────────────────────────────────────────────────
-#
-# skills[]:
-#   name: Required. Unique skill identifier (lowercase, hyphens ok)
-#   description: Required. One-line description for marketplace listings
-#
-#   native: Optional. Set true if skill is maintained directly in this repo
-#
-#   source: Required for external skills
-#     repo: GitHub owner/repo (e.g., "SawyerHood/dev-browser")
-#     path: Path to skill folder within repo
-#     ref: Branch, tag, or commit SHA (default: main)
-#
-#   target: Required
-#     category: One of: tools, development, productivity, automation, data, documentation, workflow
-#     path: Target path in smc-skills repo
-#
-#   author: Required
-#     name: Display name
-#     github: GitHub username
-#
-#   license: Required. SPDX identifier (MIT, Apache-2.0, etc.)
-#   homepage: Required. Link to project homepage or repo
-#   verified: Optional. Set true after manual review (default: false)
-#
-#   sync: Optional. Fine-grained sync control
-#     include: List of files/folders to copy
-#     exclude: Glob patterns to skip

package/tests/README.md

@@ -1,263 +0,0 @@
-# Sumulige Claude - 测试计划与报告
-
-> 测试覆盖所有核心模块，确保代码质量
-> 最后更新：2025-01-15
-
----
-
-## 📊 测试覆盖率概览
-
-```
-Test Suites: 5 passed, 5 total
-Tests:       78 passed, 78 total
-```
-
-| 模块 | 语句覆盖率 | 分支覆盖率 | 函数覆盖率 | 行覆盖率 | 状态 |
-|------|-----------|-----------|-----------|---------|------|
-| utils.js | 100% | 100% | 100% | 100% | ✅ |
-| migrations.js | 86.66% | 75% | 87.5% | 88.67% | ✅ |
-| config.js | 86.2% | 90.9% | 75% | 86.2% | ✅ |
-| marketplace.js | 28.11% | 11.5% | 50% | 29.41% | ⚠️ |
-| commands.js | 26.23% | 15.38% | 37.03% | 26.37% | ⚠️ |
-| **总体** | **36.58%** | **26.95%** | **54.38%** | **36.72%** | 📊 |
-
----
-
-## 🧪 测试文件结构
-
-```
-tests/
-├── README.md              # 本文档
-├── utils.test.js          # 工具函数测试 (100%)
-├── config.test.js         # 配置管理测试 (86.2%)
-├── migrations.test.js     # 版本迁移测试 (86.66%)
-├── marketplace.test.js    # 市场功能测试 (28.11%)
-└── commands.test.js       # CLI 命令测试 (26.23%)
-```
-
----
-
-## 📋 测试用例详情
-
-### utils.test.js (23 tests)
-
-```javascript
-// copyRecursive - 递归复制目录
-✓ should return 0 when source does not exist
-✓ should copy files recursively
-✓ should set execute permission for script files
-✓ should not overwrite when overwrite=false
-✓ should overwrite when overwrite=true
-
-// ensureDir - 创建目录
-✓ should create directory if not exists
-✓ should not error if directory already exists
-✓ should create nested directories
-
-// toTitleCase - 标题大小写转换
-✓ should convert string to title case
-✓ should handle single word
-✓ should handle empty string
-✓ should handle already capitalized string
-✓ should handle strings with multiple spaces
-✓ should preserve special characters
-```
-
-### config.test.js (7 tests)
-
-```javascript
-✓ should return default config when no user config exists
-✓ should return DEFAULTS constant
-✓ should create directory and save config
-✓ should not error when directory exists
-✓ should export required constants
-✓ should have correct paths
-```
-
-### migrations.test.js (18 tests)
-
-```javascript
-// getProjectVersion
-✓ should return 1.0.0 when version file does not exist
-✓ should read version from file
-✓ should trim whitespace from version
-✓ should return 1.0.0 on read error
-
-// setProjectVersion
-✓ should write version to file
-✓ should add newline after version
-✓ should create .claude directory if not exists
-
-// compareVersions
-✓ should return -1 when v1 < v2
-✓ should return 1 when v1 > v2
-✓ should return 0 when v1 === v2
-✓ should handle version comparison correctly
-✓ should handle version strings with different formats
-
-// runMigrations
-✓ should return success when already at latest version
-✓ should return success when version is newer than template
-✓ should return correct structure when pending migrations exist
-✓ should handle missing settings.json gracefully
-```
-
-### marketplace.test.js (18 tests)
-
-```javascript
-// parseSimpleYaml
-✓ should parse version number
-✓ should parse skill names
-✓ should handle empty skills array
-✓ should skip comments
-✓ should handle empty lines
-
-// marketplaceCommands
-✓ marketplace:list - should be a function
-✓ marketplace:list - should output to console
-✓ marketplace:install - should show usage when no skill name provided
-✓ marketplace:sync - should be a function
-✓ marketplace:sync - should output sync message
-✓ marketplace:add - should show usage when no repo provided
-✓ marketplace:add - should validate repo format
-✓ marketplace:remove - should show usage when no skill name provided
-✓ marketplace:status - should be a function
-✓ marketplace:status - should output status information
-```
-
-### commands.test.js (12 tests)
-
-```javascript
-// exports
-✓ should export runCommand function
-✓ should export commands object
-✓ should have all expected commands
-
-// runCommand
-✓ should call the correct command function
-✓ should pass arguments to command function
-✓ should handle unknown commands gracefully
-
-// init
-✓ should be a function
-✓ should not throw
-
-// sync
-✓ should be a function
-✓ should not throw
-
-// agent
-✓ should show usage when no task provided
-✓ should display agent information when task provided
-
-// skill:create
-✓ should show usage when no skill name provided
-✓ should validate skill name format
-```
-
----
-
-## 🚀 运行测试
-
-```bash
-# 运行所有测试
-npm test
-
-# 运行测试并生成覆盖率报告
-npm run test:coverage
-
-# 监视模式
-npm run test:watch
-```
-
----
-
-## 📦 依赖项
-
-```json
-{
-  "devDependencies": {
-    "jest": "^30.2.0",
-    "mock-fs": "^5.5.0",
-    "prettier": "^3.7.4",
-    "sinon": "^21.0.1",
-    "yaml": "^2.8.2"
-  }
-}
-```
-
----
-
-## 🔧 测试策略
-
-### 使用的工具
-
-| 工具 | 用途 |
-|------|------|
-| Jest | 测试框架 + 断言 |
-| mock-fs | 文件系统模拟 |
-| sinon | 函数 stub 和 spy |
-
-### Mock 策略
-
-1. **文件系统操作**：使用 `mock-fs` 模拟文件系统
-2. **外部命令**：使用 `sinon.stub` 模拟 `execSync`
-3. **Console 输出**：使用 `jest.spyOn(console, 'log')` 捕获输出
-
-### 已知限制
-
-1. **commands.js** 覆盖率低 - 该模块依赖外部命令和实际文件操作
-2. **marketplace.js** YAML 解析逻辑复杂，简化了测试场景
-3. 集成测试未覆盖，建议后续添加端到端测试
-
----
-
-## 🎯 改进建议
-
-### 短期改进
-
-1. 为 commands.js 添加更多单元测试（目标：40%+）
-2. 补充 marketplace.js 的 YAML 解析边界测试
-3. 添加错误处理的测试用例
-
-### 长期改进
-
-1. 添加集成测试覆盖完整的 CLI 工作流
-2. 添加性能测试确保大型项目下的响应速度
-3. 考虑添加快照测试用于模板文件验证
-
----
-
-## 📝 测试最佳实践
-
-### 遵循的原则
-
-1. **AAA 模式**：Arrange-Act-Assert
-2. **单一职责**：每个测试只验证一个行为
-3. **独立性**：测试之间不共享状态
-4. **可读性**：测试名称清晰描述测试内容
-
-### 示例
-
-```javascript
-describe('toTitleCase', () => {
-  it('should convert string to title case', () => {
-    // Arrange
-    const input = 'hello world';
-
-    // Act
-    const result = utils.toTitleCase(input);
-
-    // Assert
-    expect(result).toBe('Hello World');
-  });
-});
-```
-
----
-
-## 🔗 相关资源
-
-- [Jest 文档](https://jestjs.io/)
-- [mock-fs 文档](https://github.com/tschaub/mock-fs)
-- [Sinon.JS 文档](https://sinonjs.org/)