sumulige-claude 1.5.1 → 1.6.0

package/lib/errors.js

@@ -1,305 +0,0 @@
-/**
- * Structured Error Types
- *
- * Provides structured error information with recovery hints.
- * All errors include:
- * - Error code for programmatic handling
- * - Severity level (info/warn/error/critical)
- * - Details object with context
- * - Hints array with recovery suggestions
- * - Optional documentation URL
- *
- * @module lib/errors
- */
-
-/**
- * Base SMC Error class
- */
-class SMCError extends Error {
-  /**
-   * @param {string} message - Error message
-   * @param {Object} options - Error options
-   * @param {string} options.code - Error code (e.g., 'ERR_CONFIG')
-   * @param {string} options.severity - Severity level: 'info' | 'warn' | 'error' | 'critical'
-   * @param {Object} options.details - Additional error details
-   * @param {string[]} options.hints - Recovery hints
-   * @param {string} options.docUrl - Documentation URL
-   */
-  constructor(message, options = {}) {
-    super(message);
-    this.name = this.constructor.name;
-    this.code = options.code || 'ERR_UNKNOWN';
-    this.severity = options.severity || 'error';
-    this.details = options.details || {};
-    this.hints = options.hints || [];
-    this.docUrl = options.docUrl;
-
-    // Maintain proper stack trace
-    Error.captureStackTrace?.(this, this.constructor);
-  }
-
-  /**
-   * Convert error to JSON-serializable object
-   */
-  toJSON() {
-    return {
-      name: this.name,
-      code: this.code,
-      message: this.message,
-      severity: this.severity,
-      details: this.details,
-      hints: this.hints,
-      docUrl: this.docUrl
-    };
-  }
-
-  /**
-   * Format error for console output
-   */
-  toString() {
-    let output = `[${this.code}] ${this.message}`;
-    if (this.hints.length > 0) {
-      output += '\n\nSuggestions:\n';
-      this.hints.forEach((h, i) => {
-        output += `  ${i + 1}. ${h}\n`;
-      });
-    }
-    if (this.docUrl) {
-      output += `\nDocs: ${this.docUrl}\n`;
-    }
-    return output;
-  }
-
-  /**
-   * Check if this error has a specific severity level or higher
-   * @param {string} minSeverity - Minimum severity to check against
-   * @returns {boolean}
-   */
-  hasSeverity(minSeverity) {
-    const levels = { info: 0, warn: 1, error: 2, critical: 3 };
-    return levels[this.severity] >= levels[minSeverity];
-  }
-}
-
-/**
- * Configuration-related errors
- * Used for config file parsing, validation, and loading issues
- */
-class ConfigError extends SMCError {
-  /**
-   * @param {string} message - Error message
-   * @param {Object[]} errors - Array of validation errors
-   * @param {string[]} fixes - Array of auto-fix suggestions
-   * @param {Object} options - Additional options passed to SMCError
-   */
-  constructor(message, errors = [], fixes = [], options = {}) {
-    super(message, {
-      code: 'ERR_CONFIG',
-      severity: 'critical',
-      ...options
-    });
-    this.errors = errors;
-    this.fixes = fixes;
-    this.details = {
-      errorCount: errors.length,
-      fixCount: fixes.length,
-      criticalCount: errors.filter(e => e.severity === 'critical').length,
-      errorCount: errors.length,
-      fixCount: fixes.length,
-      criticalCount: errors.filter(e => e.severity === 'critical').length
-    };
-  }
-
-  /**
-   * Format config error for console output
-   */
-  toString() {
-    let output = `ConfigError: ${this.message}\n`;
-
-    if (this.details.errorCount > 0) {
-      output += `\nErrors (${this.details.errorCount}):\n`;
-      this.errors.forEach(e => {
-        const icon = e.severity === 'critical' ? 'X' : e.severity === 'error' ? 'E' : 'W';
-        output += `  [${icon}] ${e.path}: ${e.message}\n`;
-        if (e.fix) {
-          output += `      Fix: ${e.fix}\n`;
-        }
-      });
-    }
-
-    if (this.details.fixCount > 0) {
-      output += `\nSuggested fixes:\n`;
-      this.fixes.forEach((f, i) => {
-        output += `  ${i + 1}. ${f}\n`;
-      });
-    }
-
-    return output;
-  }
-}
-
-/**
- * Validation errors
- * Used when data validation fails
- */
-class ValidationError extends SMCError {
-  constructor(message, options = {}) {
-    super(message, {
-      code: 'ERR_VALIDATION',
-      severity: 'error',
-      ...options
-    });
-  }
-}
-
-/**
- * Quality gate errors
- * Used when quality checks fail
- */
-class QualityGateError extends SMCError {
-  /**
-   * @param {string} message - Error message
-   * @param {Object} results - Quality check results
-   * @param {Object} options - Additional options
-   */
-  constructor(message, results = {}, options = {}) {
-    super(message, {
-      code: 'ERR_QUALITY_GATE',
-      severity: 'error',
-      ...options
-    });
-    this.results = results;
-    this.details = {
-      passed: results.passed || false,
-      total: results.summary?.total || 0,
-      critical: results.summary?.critical || 0,
-      error: results.summary?.error || 0,
-      warn: results.summary?.warn || 0
-    };
-  }
-}
-
-/**
- * Migration errors
- * Used during config migration
- */
-class MigrationError extends SMCError {
-  constructor(message, options = {}) {
-    super(message, {
-      code: 'ERR_MIGRATION',
-      severity: 'critical',
-      ...options
-    });
-  }
-}
-
-/**
- * File operation errors
- * Used for file read/write issues
- */
-class FileError extends SMCError {
-  constructor(message, filePath, options = {}) {
-    super(message, {
-      code: 'ERR_FILE',
-      severity: 'error',
-      ...options
-    });
-    this.filePath = filePath;
-    this.details.file = filePath;
-  }
-}
-
-/**
- * Rule execution errors
- * Used when a quality rule fails to execute
- */
-class RuleError extends SMCError {
-  constructor(message, ruleId, options = {}) {
-    super(message, {
-      code: 'ERR_RULE',
-      severity: 'warn',
-      ...options
-    });
-    this.ruleId = ruleId;
-    this.details.rule = ruleId;
-  }
-}
-
-/**
- * Parse error details from AJV validation output
- * @param {Object[]} ajvErrors - AJV validation errors
- * @returns {Object[]} Parsed error objects
- */
-function parseAJVErrors(ajvErrors) {
-  return ajvErrors.map(error => {
-    const path = error.instancePath || 'root';
-    const message = error.message || 'Validation failed';
-
-    return {
-      path,
-      message,
-      severity: getSeverityFromKeyword(error.keyword),
-      expected: error.schema?.type || error.schema?.enum?.join('|'),
-      actual: error.data,
-      keyword: error.keyword,
-      fix: generateFixFromError(error)
-    };
-  });
-}
-
-/**
- * Map AJV keyword to severity level
- * @param {string} keyword - AJV error keyword
- * @returns {string} Severity level
- */
-function getSeverityFromKeyword(keyword) {
-  const severityMap = {
-    required: 'critical',
-    type: 'error',
-    enum: 'error',
-    pattern: 'warn',
-    format: 'warn',
-    minimum: 'warn',
-    maximum: 'warn',
-    minLength: 'warn',
-    maxLength: 'warn'
-  };
-  return severityMap[keyword] || 'warn';
-}
-
-/**
- * Generate auto-fix suggestion from AJV error
- * @param {Object} error - AJV error object
- * @returns {string|null} Fix suggestion
- */
-function generateFixFromError(error) {
-  const fixes = {
-    required: `Add missing field: ${error.params?.missingProperty}`,
-    pattern: `Value must match pattern: ${error.schema?.pattern}`,
-    enum: `Value must be one of: ${error.schema?.enum?.join(', ')}`,
-    type: `Change type to: ${error.schema?.type}`,
-    minimum: `Value must be >= ${error.schema?.minimum}`,
-    maximum: `Value must be <= ${error.schema?.maximum}`,
-    minLength: `Length must be >= ${error.schema?.minLength}`,
-    maxLength: `Length must be <= ${error.schema?.maxLength}`
-  };
-  return fixes[error.keyword] || null;
-}
-
-module.exports = {
-  // Base class
-  SMCError,
-
-  // Specific error types
-  ConfigError,
-  ValidationError,
-  QualityGateError,
-  MigrationError,
-  FileError,
-  RuleError,
-
-  // Utility functions
-  parseAJVErrors,
-  getSeverityFromKeyword,
-  generateFixFromError
-};

package/lib/incremental-sync.js

@@ -1,274 +0,0 @@
-/**
- * Incremental Sync Manager
- *
- * 增量同步功能，只同步变更的文件
- */
-
-const fs = require('fs');
-const path = require('path');
-const versionManifest = require('./version-manifest');
-
-const TEMPLATE_DIR = path.join(__dirname, '../template');
-
-/**
- * 复制文件
- */
-function copyFile(src, dest) {
-  const dir = path.dirname(dest);
-  if (!fs.existsSync(dir)) {
-    fs.mkdirSync(dir, { recursive: true });
-  }
-  fs.copyFileSync(src, dest);
-}
-
-/**
- * 合并 JSON 配置
- */
-function mergeJsonConfig(src, dest) {
-  let existing = {};
-  if (fs.existsSync(dest)) {
-    try {
-      existing = JSON.parse(fs.readFileSync(dest, 'utf-8'));
-    } catch (e) {
-      existing = {};
-    }
-  }
-
-  const newConfig = JSON.parse(fs.readFileSync(src, 'utf-8'));
-
-  // 深度合并
-  const merged = deepMerge(existing, newConfig);
-
-  const dir = path.dirname(dest);
-  if (!fs.existsSync(dir)) {
-    fs.mkdirSync(dir, { recursive: true });
-  }
-  fs.writeFileSync(dest, JSON.stringify(merged, null, 2));
-}
-
-/**
- * 深度合并对象
- */
-function deepMerge(target, source) {
-  const result = { ...target };
-
-  for (const key of Object.keys(source)) {
-    if (source[key] && typeof source[key] === 'object' && !Array.isArray(source[key])) {
-      result[key] = deepMerge(result[key] || {}, source[key]);
-    } else {
-      result[key] = source[key];
-    }
-  }
-
-  return result;
-}
-
-/**
- * 应用单个变更
- */
-function applyChange(change, projectDir, rules) {
-  const rule = rules[change.type];
-  if (!rule) return { success: false, reason: 'Unknown change type' };
-
-  const action = rule[change.action];
-  if (!action) return { success: false, reason: 'Unknown action' };
-
-  try {
-    switch (change.type) {
-      case 'hook':
-        return applyHookChange(change, projectDir, action);
-      case 'config':
-        return applyConfigChange(change, projectDir, action);
-      case 'command':
-        return applyCommandChange(change, projectDir, action);
-      case 'lib':
-        return applyLibChange(change, projectDir, action);
-      case 'skill':
-        return applySkillChange(change, projectDir, action);
-      default:
-        return { success: true, skipped: true };
-    }
-  } catch (e) {
-    return { success: false, reason: e.message };
-  }
-}
-
-/**
- * 应用 hook 变更
- */
-function applyHookChange(change, projectDir, action) {
-  const hookName = change.name;
-  const src = path.join(TEMPLATE_DIR, '.claude/hooks', `${hookName}.cjs`);
-  const dest = path.join(projectDir, '.claude/hooks', `${hookName}.cjs`);
-
-  if (action === 'copy') {
-    if (fs.existsSync(src)) {
-      copyFile(src, dest);
-      return { success: true, action: 'copied', file: dest };
-    }
-    return { success: false, reason: 'Source file not found' };
-  }
-
-  if (action === 'delete') {
-    if (fs.existsSync(dest)) {
-      fs.unlinkSync(dest);
-      return { success: true, action: 'deleted', file: dest };
-    }
-    return { success: true, skipped: true };
-  }
-
-  return { success: true, skipped: true };
-}
-
-/**
- * 应用配置变更
- */
-function applyConfigChange(change, projectDir, action) {
-  const configName = change.name;
-  let src, dest;
-
-  if (configName === 'settings.json') {
-    src = path.join(TEMPLATE_DIR, '.claude/settings.json');
-    dest = path.join(projectDir, '.claude/settings.json');
-  } else if (configName === 'hook-registry.json') {
-    src = path.join(TEMPLATE_DIR, '.claude/hooks/hook-registry.json');
-    dest = path.join(projectDir, '.claude/hooks/hook-registry.json');
-  } else {
-    src = path.join(TEMPLATE_DIR, '.claude', configName);
-    dest = path.join(projectDir, '.claude', configName);
-  }
-
-  if (action === 'copy') {
-    if (fs.existsSync(src)) {
-      copyFile(src, dest);
-      return { success: true, action: 'copied', file: dest };
-    }
-    return { success: false, reason: 'Source file not found' };
-  }
-
-  if (action === 'merge') {
-    if (fs.existsSync(src)) {
-      mergeJsonConfig(src, dest);
-      return { success: true, action: 'merged', file: dest };
-    }
-    return { success: false, reason: 'Source file not found' };
-  }
-
-  return { success: true, skipped: true };
-}
-
-/**
- * 应用命令变更
- */
-function applyCommandChange(change, projectDir, action) {
-  const commandName = change.name;
-  const src = path.join(TEMPLATE_DIR, '.claude/commands', `${commandName}.md`);
-  const dest = path.join(projectDir, '.claude/commands', `${commandName}.md`);
-
-  if (action === 'copy') {
-    if (fs.existsSync(src)) {
-      copyFile(src, dest);
-      return { success: true, action: 'copied', file: dest };
-    }
-    return { success: false, reason: 'Source file not found' };
-  }
-
-  return { success: true, skipped: true };
-}
-
-/**
- * 应用库文件变更
- */
-function applyLibChange(change, projectDir, action) {
-  const libPath = change.name;
-  const src = path.join(TEMPLATE_DIR, '.claude', libPath);
-  const dest = path.join(projectDir, '.claude', libPath);
-
-  if (action === 'copy') {
-    if (fs.existsSync(src)) {
-      copyFile(src, dest);
-      return { success: true, action: 'copied', file: dest };
-    }
-    return { success: false, reason: 'Source file not found' };
-  }
-
-  return { success: true, skipped: true };
-}
-
-/**
- * 应用技能变更
- */
-function applySkillChange(change, projectDir, action) {
-  // 技能同步由现有的 sync 命令处理
-  return { success: true, skipped: true, reason: 'Skills handled by full sync' };
-}
-
-/**
- * 执行增量同步
- */
-function incrementalSync(projectDir, options = {}) {
-  const summary = versionManifest.getUpdateSummary(projectDir);
-
-  if (!summary.needsUpdate) {
-    return {
-      success: true,
-      message: 'Already up to date',
-      changes: []
-    };
-  }
-
-  if (summary.isNewInstall) {
-    return {
-      success: false,
-      message: 'New installation detected. Please run full sync first.',
-      needsFullSync: true
-    };
-  }
-
-  if (summary.hasBreakingChanges && !options.force) {
-    return {
-      success: false,
-      message: 'Breaking changes detected. Use --force to continue.',
-      hasBreakingChanges: true,
-      changes: summary.changes
-    };
-  }
-
-  const rules = versionManifest.getSyncRules();
-  const results = [];
-
-  for (const versionChange of summary.changes) {
-    for (const change of versionChange.changes) {
-      const result = applyChange(change, projectDir, rules);
-      results.push({
-        version: versionChange.version,
-        change,
-        result
-      });
-    }
-  }
-
-  // 更新项目版本
-  versionManifest.setProjectVersion(projectDir, summary.toVersion);
-
-  return {
-    success: true,
-    message: `Updated from ${summary.fromVersion} to ${summary.toVersion}`,
-    fromVersion: summary.fromVersion,
-    toVersion: summary.toVersion,
-    results: results
-  };
-}
-
-/**
- * 检查更新
- */
-function checkForUpdates(projectDir) {
-  return versionManifest.getUpdateSummary(projectDir);
-}
-
-module.exports = {
-  incrementalSync,
-  checkForUpdates,
-  applyChange
-};