@chongyan/autospec 1.0.2 → 1.0.4

package/plugins/skills/project-evolve-scanner/scripts/dependency-reuse-checker.js

@@ -1,395 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Dependency Reuse Checker
- *
- * 检查依赖包复用情况，识别重复造轮子
- *
- * 功能：
- * 1. 扫描项目依赖（package.json / pom.xml / build.gradle / go.mod 等）
- * 2. 提取功能需求关键词，匹配现有依赖包
- * 3. 检查团队组件使用手册
- * 4. 搜索项目现有代码中是否有可复用的实现
- * 5. 输出"依赖包优先"建议
- */
-
-import fs from 'fs';
-import path from 'path';
-import { fileURLToPath } from 'url';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-
-// 常见功能关键词与依赖包映射
-const FUNCTION_TO_PACKAGES = {
-  // HTTP 请求
-  'http': ['axios', 'fetch', 'node-fetch', 'got', 'request'],
-  'request': ['axios', 'fetch', 'node-fetch', 'got', 'request'],
-  'fetch': ['axios', 'fetch', 'node-fetch', 'got'],
-
-  // 数据处理
-  'json': ['fast-json-stable-stringify', 'lodash', 'ramda'],
-  'date': ['dayjs', 'moment', 'date-fns', 'luxon'],
-  'format': ['sprintf-js', 'numeral', 'decimal.js'],
-
-  // 验证
-  'validate': ['joi', 'yup', 'zod', 'validator'],
-  'schema': ['joi', 'yup', 'zod', 'ajv'],
-  'type': ['joi', 'yup', 'zod', 'runtypes'],
-
-  // 工具
-  'deep': ['lodash', 'ramda', 'deep-equal'],
-  'clone': ['lodash', 'ramda', 'clone-deep'],
-  'merge': ['lodash', 'ramda', 'deepmerge'],
-  'pick': ['lodash', 'ramda', 'filter-obj'],
-  'omit': ['lodash', 'ramda', 'filter-obj'],
-
-  // 加密
-  'crypto': ['crypto-js', 'bcrypt', 'argon2', 'scrypt'],
-  'hash': ['crypto-js', 'bcrypt', 'argon2', 'md5'],
-  'encrypt': ['crypto-js', 'bcrypt', 'argon2'],
-  'password': ['bcrypt', 'argon2', 'scrypt'],
-
-  // 异步
-  'promise': ['bluebird'],
-  'async': ['async', 'p-series', 'p-map'],
-  'retry': ['async-retry', 'p-retry', 'promise-retry'],
-  'timeout': ['timeout-abort-controller'],
-
-  // 日志
-  'log': ['winston', 'pino', 'loglevel', 'bunyan'],
-  'logger': ['winston', 'pino', 'bunyan'],
-
-  // 测试
-  'test': ['jest', 'mocha', 'ava', 'tap'],
-  'mock': ['jest-mock', 'sinon', 'proxyquire', 'mock-fs'],
-  'coverage': ['nyc', 'c8', 'istanbul'],
-
-  // 命令行
-  'cli': ['commander', 'yargs', 'meow', 'argparse'],
-  'prompt': ['inquirer', 'prompts', 'enquirer'],
-  'table': ['cli-table', 'table', 'ascii-table'],
-
-  // 文件
-  'glob': ['glob', 'fast-glob', 'minimatch'],
-  'fs': ['fs-extra', 'graceful-fs'],
-  'watch': ['chokidar', 'watch', 'gaze'],
-
-  // 环境
-  'env': ['dotenv', 'env-var', 'envalid'],
-  'config': ['convict', 'config', 'node-config'],
-
-  // 邮件
-  'email': ['nodemailer', 'sendgrid', 'mailgun-js'],
-  'mail': ['nodemailer', 'sendgrid', 'mailgun-js'],
-
-  // 缓存
-  'cache': ['node-cache', 'memory-cache', 'lru-cache'],
-  'redis': ['ioredis', 'node-redis', 'redis'],
-
-  // WebSocket
-  'websocket': ['ws', 'socket.io', 'primus'],
-  'socket': ['socket.io', 'ws', 'primus'],
-
-  // 验证
-  'email-validate': ['email-validator', 'validator'],
-  'url-validate': ['validator', 'is-url'],
-  'phone': ['phone', 'libphonenumber-js'],
-};
-
-// 解析命令行参数
-function parseArgs() {
-  const args = process.argv.slice(2);
-  const options = {
-    project: '.',
-    verbose: false,
-    output: null,
-  };
-
-  for (let i = 0; i < args.length; i++) {
-    switch (args[i]) {
-      case '--project':
-      case '-p':
-        options.project = args[++i];
-        break;
-      case '--verbose':
-      case '-v':
-        options.verbose = true;
-        break;
-      case '--output':
-      case '-o':
-        options.output = args[++i];
-        break;
-      case '--help':
-      case '-h':
-        printHelp();
-        process.exit(0);
-        break;
-    }
-  }
-
-  return options;
-}
-
-function printHelp() {
-  console.log(`
-Dependency Reuse Checker
-
-用法：
-  node dependency-reuse-checker.js --project <path> [选项]
-
-选项：
-  -p, --project <path>   项目路径（默认：当前目录）
-  -o, --output <path>   输出报告路径（默认：stdout）
-  -v, --verbose         详细输出
-  -h, --help            显示帮助
-
-示例：
-  node dependency-reuse-checker.js --project ./my-project
-  node dependency-reuse-checker.js --project ./my-project --output report.json
-`);
-}
-
-// 读取项目依赖
-function readDependencies(projectPath) {
-  const deps = {
-    dependencies: {},
-    devDependencies: {},
-  };
-
-  // package.json
-  const packageJsonPath = path.join(projectPath, 'package.json');
-  if (fs.existsSync(packageJsonPath)) {
-    try {
-      const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
-      deps.dependencies = packageJson.dependencies || {};
-      deps.devDependencies = packageJson.devDependencies || {};
-    } catch (e) {
-      console.error('解析 package.json 失败:', e.message);
-    }
-  }
-
-  return deps;
-}
-
-// 扫描代码中的功能关键词
-function scanCodeForKeywords(projectPath) {
-  const keywords = new Set();
-  const patterns = [
-    /require\s*\(\s*['"]([^'"]+)['"]\s*\)/g,
-    /import\s+.*?\s+from\s+['"]([^'"]+)['"]/g,
-  ];
-
-  function scanDir(dir) {
-    if (!fs.existsSync(dir)) return;
-
-    const files = fs.readdirSync(dir);
-    for (const file of files) {
-      const fullPath = path.join(dir, file);
-      const stat = fs.statSync(fullPath);
-
-      if (stat.isDirectory()) {
-        // 跳过 node_modules 和隐藏目录
-        if (file !== 'node_modules' && !file.startsWith('.')) {
-          scanDir(fullPath);
-        }
-      } else if (/\.(js|ts|jsx|tsx)$/.test(file)) {
-        try {
-          const content = fs.readFileSync(fullPath, 'utf-8');
-          for (const pattern of patterns) {
-            let match;
-            while ((match = pattern.exec(content)) !== null) {
-              const pkg = match[1];
-              // 检查是否是本地模块
-              if (!pkg.startsWith('.') && !pkg.startsWith('/')) {
-                // 提取关键词
-                const basePkg = pkg.split('/')[0].replace('@', '');
-                if (FUNCTION_TO_PACKAGES[basePkg]) {
-                  keywords.add(basePkg);
-                }
-              }
-            }
-          }
-        } catch (e) {
-          // 忽略读取错误
-        }
-      }
-    }
-  }
-
-  const srcDir = path.join(projectPath, 'src');
-  const libDir = path.join(projectPath, 'lib');
-  const appDir = path.join(projectPath, 'app');
-
-  scanDir(fs.existsSync(srcDir) ? srcDir : projectPath);
-  if (fs.existsSync(libDir)) scanDir(libDir);
-  if (fs.existsSync(appDir)) scanDir(appDir);
-
-  return Array.from(keywords);
-}
-
-// 检查是否有可复用的现有实现
-function checkExistingImplementation(projectPath, keyword) {
-  const results = [];
-
-  // 搜索可能的工具函数目录
-  const utilsDirs = ['utils', 'util', 'helpers', 'helper', 'lib', 'tools', 'common'];
-
-  function searchDir(dir, depth = 0) {
-    if (depth > 3) return; // 限制搜索深度
-
-    if (!fs.existsSync(dir)) return;
-
-    try {
-      const files = fs.readdirSync(dir);
-      for (const file of files) {
-        const fullPath = path.join(dir, file);
-        const stat = fs.statSync(fullPath);
-
-        if (stat.isDirectory()) {
-          if (!file.startsWith('.') && file !== 'node_modules') {
-            searchDir(fullPath, depth + 1);
-          }
-        } else if (/\.(js|ts)$/.test(file)) {
-          try {
-            const content = fs.readFileSync(fullPath, 'utf-8');
-            if (content.toLowerCase().includes(keyword.toLowerCase())) {
-              results.push({
-                file: path.relative(projectPath, fullPath),
-                match: keyword,
-              });
-            }
-          } catch (e) {
-            // 忽略
-          }
-        }
-      }
-    } catch (e) {
-      // 忽略权限错误
-    }
-  }
-
-  for (const utilsDir of utilsDirs) {
-    searchDir(path.join(projectPath, utilsDir));
-  }
-
-  return results;
-}
-
-// 生成建议
-function generateSuggestions(keyword, existingDeps, existingImpl) {
-  const suggestions = [];
-
-  // 检查是否已安装相关包
-  const relatedPkgs = FUNCTION_TO_PACKAGES[keyword] || [];
-  const installed = relatedPkgs.filter(pkg =>
-    existingDeps.dependencies[pkg] || existingDeps.devDependencies[pkg]
-  );
-
-  if (installed.length > 0) {
-    suggestions.push({
-      type: 'use-existing',
-      message: `已安装相关依赖: ${installed.join(', ')}`,
-      priority: 'high',
-    });
-  }
-
-  // 检查是否有现有实现
-  if (existingImpl.length > 0) {
-    suggestions.push({
-      type: 'use-existing',
-      message: `发现现有实现: ${existingImpl.map(e => e.file).join(', ')}`,
-      priority: 'medium',
-    });
-  }
-
-  // 建议使用依赖包
-  if (installed.length === 0 && existingImpl.length === 0) {
-    suggestions.push({
-      type: 'consider-package',
-      message: `建议使用依赖包: ${relatedPkgs.join(', ')}`,
-      priority: 'low',
-    });
-  }
-
-  return suggestions;
-}
-
-// 主函数
-async function main() {
-  const options = parseArgs();
-
-  console.log('🔍 Dependency Reuse Checker\n');
-
-  try {
-    // 1. 读取项目依赖
-    console.log('📦 读取项目依赖...');
-    const deps = readDependencies(options.project);
-    console.log(`   依赖: ${Object.keys(deps.dependencies).length}`);
-    console.log(`   开发依赖: ${Object.keys(deps.devDependencies).length}`);
-
-    // 2. 扫描代码关键词
-    console.log('\n🔎 扫描代码关键词...');
-    const keywords = scanCodeForKeywords(options.project);
-    console.log(`   发现关键词: ${keywords.join(', ')}`);
-
-    // 3. 分析每个关键词
-    console.log('\n📊 分析复用机会...\n');
-    const results = [];
-
-    for (const keyword of keywords) {
-      const existingImpl = checkExistingImplementation(options.project, keyword);
-      const suggestions = generateSuggestions(keyword, deps, existingImpl);
-
-      results.push({
-        keyword,
-        suggestions,
-        existingImplementation: existingImpl,
-      });
-
-      if (options.verbose) {
-        console.log(`\n[${keyword}]`);
-        for (const s of suggestions) {
-          console.log(`  - ${s.message}`);
-        }
-      }
-    }
-
-    // 4. 生成报告
-    const report = {
-      timestamp: new Date().toISOString(),
-      project: options.project,
-      summary: {
-        totalKeywords: keywords.length,
-        reuseOpportunities: results.filter(r => r.suggestions.some(s => s.type === 'use-existing')).length,
-        newPackageSuggestions: results.filter(r => r.suggestions.some(s => s.type === 'consider-package')).length,
-      },
-      results,
-    };
-
-    // 5. 输出
-    if (options.output) {
-      fs.writeFileSync(options.output, JSON.stringify(report, null, 2));
-      console.log(`\n✅ 报告已保存: ${options.output}`);
-    } else {
-      console.log('\n📋 总结:');
-      console.log(`   关键词总数: ${report.summary.totalKeywords}`);
-      console.log(`   复用机会: ${report.summary.reuseOpportunities}`);
-      console.log(`   新包建议: ${report.summary.newPackageSuggestions}`);
-    }
-
-    process.exit(0);
-
-  } catch (error) {
-    console.error('\n❌ 检查失败:', error.message);
-    if (options.verbose) {
-      console.error(error.stack);
-    }
-    process.exit(1);
-  }
-}
-
-main().catch(error => {
-  console.error('未捕获的错误:', error);
-  process.exit(1);
-});

package/plugins/skills/project-evolve-scanner/scripts/subsystem-coverage.js

@@ -1,315 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Subsystem Coverage Checker
- *
- * 检查多系统开发中的子系统实现覆盖情况
- *
- * 功能：
- * 1. 读取设计文档，提取子系统清单
- * 2. 扫描代码目录，检测实际修改的文件
- * 3. 对比两者，输出覆盖报告
- * 4. 供 CLI 命令和 Hook 调用
- */
-
-import fs from 'fs';
-import path from 'path';
-import { fileURLToPath } from 'url';
-import { loadState, getSubsystemCoverage, normalizeSubsystems } from '../state.js';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-
-/**
- * 读取设计文档，提取子系统清单
- * @param {string} projectDir - 项目根目录
- * @returns {Array} 设计文档中定义的子系统列表
- */
-function extractSubsystemsFromDesign(projectDir) {
-  const designDir = path.join(projectDir, 'design');
-  const overviewPath = path.join(designDir, 'overview.md');
-
-  if (!fs.existsSync(overviewPath)) {
-    return [];
-  }
-
-  const content = fs.readFileSync(overviewPath, 'utf-8');
-  const subsystems = [];
-
-  // 简单的子系统提取逻辑
-  // 匹配 ##子系统名称 或 ### 子系统名称
-  const lines = content.split('\n');
-  for (const line of lines) {
-    const match = line.match(/^#{2,3}\s+(.+)$/);
-    if (match) {
-      const name = match[1].trim();
-      // 过滤掉非子系统标题
-      if (!['概述', ' Overview', '架构', ' Architecture', '目录', 'TOC'].includes(name)) {
-        subsystems.push({
-          name,
-          path: name.toLowerCase().replace(/\s+/g, '-'),
-        });
-      }
-    }
-  }
-
-  return subsystems;
-}
-
-/**
- * 扫描代码目录，检测实际实现的文件
- * @param {string} projectDir - 项目根目录
- * @returns {Object} 各子系统的文件列表
- */
-function scanCodeDirectories(projectDir) {
-  const result = {
-    backend: [],
-    frontend: [],
-    mobile: [],
-    data: [],
-    other: [],
-  };
-
-  const dirs = {
-    backend: ['backend', 'server', 'api', 'service'],
-    frontend: ['frontend', 'web', 'client', 'app'],
-    mobile: ['mobile', 'ios', 'android'],
-    data: ['data', 'warehouse', 'datalake'],
-  };
-
-  function scanDir(dir, category) {
-    if (!fs.existsSync(dir)) return;
-
-    try {
-      const files = fs.readdirSync(dir, { withFileTypes: true });
-      for (const file of files) {
-        const fullPath = path.join(dir, file.name);
-        if (file.isDirectory()) {
-          if (!file.name.startsWith('.') && file.name !== 'node_modules') {
-            scanDir(fullPath, category);
-          }
-        } else if (/\.(js|ts|jsx|tsx|java|go|py|rb)$/.test(file.name)) {
-          result[category].push(path.relative(projectDir, fullPath));
-        }
-      }
-    } catch (e) {
-      // 忽略权限错误
-    }
-  }
-
-  for (const [category, dirNames] of Object.entries(dirs)) {
-    for (const dirName of dirNames) {
-      const dirPath = path.join(projectDir, dirName);
-      if (fs.existsSync(dirPath)) {
-        scanDir(dirPath, category);
-      }
-    }
-  }
-
-  // 其他目录
-  const rootFiles = fs.readdirSync(projectDir, { withFileTypes: true });
-  for (const file of rootFiles) {
-    if (file.isDirectory() && !file.name.startsWith('.') && !['node_modules', 'design', 'docs', 'scripts'].includes(file.name)) {
-      const category = 'other';
-      scanDir(path.join(projectDir, file.name), category);
-    }
-  }
-
-  return result;
-}
-
-/**
- * 对比设计与实现，生成覆盖报告
- * @param {Array} designSubsystems - 设计文档中的子系统
- * @param {Object} codeFiles - 实际代码文件
- * @returns {Object} 覆盖报告
- */
-function generateCoverageReport(designSubsystems, codeFiles) {
-  const report = {
-    total: designSubsystems.length,
-    covered: 0,
-    uncovered: [],
-    details: [],
-  };
-
-  for (const subsystem of designSubsystems) {
-    const subsystemPath = subsystem.path;
-    const matchedFiles = [];
-
-    // 搜索匹配的文件
-    for (const [category, files] of Object.entries(codeFiles)) {
-      for (const file of files) {
-        if (file.includes(subsystemPath) || file.includes(subsystem.name.toLowerCase())) {
-          matchedFiles.push({ file, category });
-        }
-      }
-    }
-
-    if (matchedFiles.length > 0) {
-      report.covered++;
-      report.details.push({
-        subsystem: subsystem.name,
-        status: 'covered',
-        files: matchedFiles,
-      });
-    } else {
-      report.uncovered.push(subsystem.name);
-      report.details.push({
-        subsystem: subsystem.name,
-        status: 'uncovered',
-        files: [],
-      });
-    }
-  }
-
-  report.coverage = report.total > 0 ? Math.round((report.covered / report.total) * 100) : 0;
-
-  return report;
-}
-
-/**
- * 解析命令行参数
- */
-function parseArgs() {
-  const args = process.argv.slice(2);
-  const options = {
-    project: '.',
-    verbose: false,
-    output: null,
-    json: false,
-  };
-
-  for (let i = 0; i < args.length; i++) {
-    switch (args[i]) {
-      case '--project':
-      case '-p':
-        options.project = args[++i];
-        break;
-      case '--verbose':
-      case '-v':
-        options.verbose = true;
-        break;
-      case '--output':
-      case '-o':
-        options.output = args[++i];
-        break;
-      case '--json':
-        options.json = true;
-        break;
-      case '--help':
-      case '-h':
-        printHelp();
-        process.exit(0);
-        break;
-    }
-  }
-
-  return options;
-}
-
-function printHelp() {
-  console.log(`
-Subsystem Coverage Checker
-
-用法：
-  node subsystem-coverage.js --project <path> [选项]
-
-选项：
-  -p, --project <path>   项目路径（默认：当前目录）
-  -o, --output <path>   输出报告路径（默认：stdout）
-  -v, --verbose         详细输出
-  -j, --json            JSON 格式输出
-  -h, --help            显示帮助
-
-示例：
-  node subsystem-coverage.js --project ./my-project
-  node subsystem-coverage.js --project ./my-project --output report.json
-`);
-}
-
-/**
- * 主函数
- */
-async function main() {
-  const options = parseArgs();
-
-  console.log('🔍 Subsystem Coverage Checker\n');
-
-  try {
-    // 1. 提取设计文档中的子系统
-    console.log('📋 提取设计文档子系统...');
-    const designSubsystems = extractSubsystemsFromDesign(options.project);
-    console.log(`   发现子系统: ${designSubsystems.length}`);
-
-    if (designSubsystems.length === 0) {
-      console.log('\n⚠️  未找到设计文档或子系统定义');
-      console.log('   请确保 design/overview.md 存在且包含子系统标题');
-      process.exit(0);
-    }
-
-    // 2. 扫描代码目录
-    console.log('\n📂 扫描代码目录...');
-    const codeFiles = scanCodeDirectories(options.project);
-    let totalFiles = 0;
-    for (const files of Object.values(codeFiles)) {
-      totalFiles += files.length;
-    }
-    console.log(`   扫描文件: ${totalFiles}`);
-
-    // 3. 生成覆盖报告
-    console.log('\n📊 生成覆盖报告...\n');
-    const report = generateCoverageReport(designSubsystems, codeFiles);
-
-    // 4. 输出报告
-    if (options.json) {
-      const output = JSON.stringify(report, null, 2);
-      if (options.output) {
-        fs.writeFileSync(options.output, output);
-        console.log(`✅ 报告已保存: ${options.output}`);
-      } else {
-        console.log(output);
-      }
-    } else {
-      console.log(`覆盖率: ${report.coverage}%`);
-      console.log(`已覆盖: ${report.covered}/${report.total}`);
-
-      if (report.uncovered.length > 0) {
-        console.log(`\n⚠️  未覆盖的子系统:`);
-        for (const name of report.uncovered) {
-          console.log(`   - ${name}`);
-        }
-      }
-
-      if (options.verbose) {
-        console.log('\n📝 详细情况:');
-        for (const detail of report.details) {
-          console.log(`\n${detail.subsystem}: ${detail.status}`);
-          if (detail.files.length > 0) {
-            for (const f of detail.files) {
-              console.log(`   - ${f.file} (${f.category})`);
-            }
-          }
-        }
-      }
-
-      if (options.output) {
-        fs.writeFileSync(options.output, JSON.stringify(report, null, 2));
-        console.log(`\n✅ 报告已保存: ${options.output}`);
-      }
-    }
-
-    process.exit(0);
-
-  } catch (error) {
-    console.error('\n❌ 检查失败:', error.message);
-    if (options.verbose) {
-      console.error(error.stack);
-    }
-    process.exit(1);
-  }
-}
-
-main().catch(error => {
-  console.error('未捕获的错误:', error);
-  process.exit(1);
-});