closer-code 1.0.0

package/scenarios/scenario1-batch-converter.js

@@ -0,0 +1,247 @@
+/**
+ * 场景一：批量文件格式转换器
+ *
+ * 功能：
+ * 1. 使用 searchFiles 查找特定类型的文件
+ * 2. 使用 readFile 读取每个文件内容
+ * 3. 转换文件格式（例如：JSON -> YAML）
+ * 4. 使用 writeFile 写入转换后的文件
+ *
+ * 工具验证：searchFiles, readFile, writeFile
+ */
+
+import fs from 'fs/promises';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { glob } from 'glob';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+// 模拟工具执行器
+class MockToolExecutor {
+  constructor() {
+    this.workingDir = path.resolve(__dirname, '..');
+    this.callLog = [];
+  }
+
+  log(toolName, input, result) {
+    this.callLog.push({
+      tool: toolName,
+      input,
+      success: result.success,
+      timestamp: new Date().toISOString()
+    });
+  }
+
+  // searchFiles 工具
+  async searchFiles({ pattern, cwd }) {
+    const searchDir = cwd ? path.resolve(this.workingDir, cwd) : this.workingDir;
+    const files = await glob(pattern, { cwd: searchDir });
+
+    const result = {
+      success: true,
+      data: { files, count: files.length }
+    };
+    this.log('searchFiles', { pattern, cwd }, result);
+    return result;
+  }
+
+  // readFile 工具
+  async readFile({ filePath, encoding = 'utf-8' }) {
+    try {
+      const fullPath = path.resolve(this.workingDir, filePath);
+      const content = await fs.readFile(fullPath, encoding);
+
+      const result = {
+        success: true,
+        data: { content, path: fullPath }
+      };
+      this.log('readFile', { filePath, encoding }, result);
+      return result;
+    } catch (error) {
+      const result = { success: false, error: error.message };
+      this.log('readFile', { filePath }, result);
+      return result;
+    }
+  }
+
+  // writeFile 工具
+  async writeFile({ filePath, content, encoding = 'utf-8' }) {
+    try {
+      const fullPath = path.resolve(this.workingDir, filePath);
+      await fs.writeFile(fullPath, content, encoding);
+
+      const result = {
+        success: true,
+        data: { path: fullPath, size: content.length }
+      };
+      this.log('writeFile', { filePath, size: content.length }, result);
+      return result;
+    } catch (error) {
+      const result = { success: false, error: error.message };
+      this.log('writeFile', { filePath }, result);
+      return result;
+    }
+  }
+
+  // 获取调用日志
+  getCallLog() {
+    return this.callLog;
+  }
+
+  // 打印统计信息
+  printSummary() {
+    console.log('\n=== 工具调用统计 ===');
+    const stats = {};
+    this.callLog.forEach(log => {
+      stats[log.tool] = (stats[log.tool] || 0) + 1;
+    });
+    Object.entries(stats).forEach(([tool, count]) => {
+      console.log(`  ${tool}: ${count} 次`);
+    });
+    console.log(`  总计: ${this.callLog.length} 次`);
+  }
+}
+
+// JSON 到 YAML 的简单转换器
+function jsonToYaml(obj, indent = 0) {
+  const spaces = '  '.repeat(indent);
+  let yaml = '';
+
+  for (const [key, value] of Object.entries(obj)) {
+    if (Array.isArray(value)) {
+      yaml += `${spaces}${key}:\n`;
+      value.forEach(item => {
+        if (typeof item === 'object' && item !== null) {
+          yaml += `${spaces}-\n${jsonToYaml(item, indent + 2)}`;
+        } else {
+          yaml += `${spaces}  - ${JSON.stringify(item)}\n`;
+        }
+      });
+    } else if (typeof value === 'object' && value !== null) {
+      yaml += `${spaces}${key}:\n${jsonToYaml(value, indent + 1)}`;
+    } else {
+      yaml += `${spaces}${key}: ${JSON.stringify(value)}\n`;
+    }
+  }
+
+  return yaml;
+}
+
+// 批量转换场景
+async function runBatchConverterScenario() {
+  console.log('\n========================================');
+  console.log('场景一：批量文件格式转换器');
+  console.log('========================================\n');
+
+  const executor = new MockToolExecutor();
+
+  try {
+    // 步骤 1: 搜索所有 JSON 配置文件
+    console.log('步骤 1: 搜索 JSON 配置文件...');
+    const searchResult = await executor.searchFiles({
+      pattern: '*.json',
+      cwd: '.'
+    });
+
+    if (!searchResult.success) {
+      throw new Error('搜索文件失败');
+    }
+
+    console.log(`  找到 ${searchResult.data.count} 个 JSON 文件`);
+    const jsonFiles = searchResult.data.files.filter(f =>
+      !f.includes('node_modules') && !f.includes('package-lock.json')
+    );
+    console.log(`  过滤后: ${jsonFiles.length} 个文件\n`);
+
+    // 步骤 2: 读取并转换每个文件
+    const conversions = [];
+    for (const jsonFile of jsonFiles) {
+      console.log(`步骤 2: 读取 ${jsonFile}...`);
+      const readResult = await executor.readFile({ filePath: jsonFile });
+
+      if (!readResult.success) {
+        console.log(`  ✗ 读取失败: ${readResult.error}`);
+        continue;
+      }
+
+      try {
+        const jsonData = JSON.parse(readResult.data.content);
+        const yamlContent = jsonToYaml(jsonData);
+
+        // 步骤 3: 写入 YAML 文件
+        const yamlFile = jsonFile.replace('.json', '.yaml');
+        console.log(`步骤 3: 写入 ${yamlFile}...`);
+        const writeResult = await executor.writeFile({
+          filePath: `scenarios/output/${path.basename(yamlFile)}`,
+          content: yamlContent
+        });
+
+        if (writeResult.success) {
+          console.log(`  ✓ 转换成功: ${jsonFile} -> ${yamlFile}`);
+          conversions.push({
+            from: jsonFile,
+            to: yamlFile,
+            size: writeResult.data.size
+          });
+        }
+      } catch (parseError) {
+        console.log(`  ✗ 解析失败: ${parseError.message}`);
+      }
+      console.log('');
+    }
+
+    // 打印结果
+    console.log('========================================');
+    console.log('转换结果汇总');
+    console.log('========================================');
+    console.log(`成功转换: ${conversions.length} 个文件`);
+    conversions.forEach(c => {
+      console.log(`  ${c.from} -> ${c.to} (${c.size} bytes)`);
+    });
+
+    executor.printSummary();
+
+    return {
+      success: true,
+      conversions,
+      toolCalls: executor.getCallLog()
+    };
+  } catch (error) {
+    console.error('\n场景执行失败:', error.message);
+    return { success: false, error: error.message };
+  }
+}
+
+// 创建输出目录
+async function ensureOutputDir() {
+  const dir = path.resolve(__dirname, 'output');
+  try {
+    await fs.mkdir(dir, { recursive: true });
+  } catch {
+    // 目录可能已存在
+  }
+}
+
+// 主函数
+async function main() {
+  await ensureOutputDir();
+  const result = await runBatchConverterScenario();
+
+  if (result.success) {
+    console.log('\n✓ 场景一执行成功\n');
+    process.exit(0);
+  } else {
+    console.log('\n✗ 场景一执行失败\n');
+    process.exit(1);
+  }
+}
+
+// 导出以便其他脚本使用
+export { runBatchConverterScenario };
+
+// 如果直接运行此脚本
+if (import.meta.url === `file://${process.argv[1]}`) {
+  main();
+}

package/scenarios/scenario2-code-analyzer.js

@@ -0,0 +1,375 @@
+/**
+ * 场景二：代码分析报告生成器
+ *
+ * 功能：
+ * 1. 使用 searchCode 搜索代码模式（函数定义、类定义等）
+ * 2. 使用 bash 执行代码统计命令（cloc, tokei 等）
+ * 3. 使用 writeFile 生成分析报告
+ *
+ * 工具验证：searchCode, bash, writeFile
+ */
+
+import fs from 'fs/promises';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { spawn } from 'child_process';
+import { glob } from 'glob';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+class MockToolExecutor {
+  constructor() {
+    this.workingDir = path.resolve(__dirname, '..');
+    this.callLog = [];
+  }
+
+  log(toolName, input, result) {
+    this.callLog.push({
+      tool: toolName,
+      input,
+      success: result.success,
+      timestamp: new Date().toISOString()
+    });
+  }
+
+  // searchCode 工具 - 使用 ripgrep 搜索代码
+  async searchCode({ pattern, path: searchPath, fileType }) {
+    try {
+      const searchDir = searchPath ? path.resolve(this.workingDir, searchPath) : this.workingDir;
+      const rgPath = path.join(this.workingDir, 'node_modules', '.bin', 'rg');
+
+      // 构建 ripgrep 命令
+      let args = [pattern, searchDir, '--json', '-n'];
+      if (fileType) {
+        args.push('-t', fileType);
+      }
+
+      const results = [];
+      const proc = spawn(rgPath, args, { shell: true });
+
+      for await (const line of proc.stdout) {
+        try {
+          const data = JSON.parse(line.toString());
+          if (data.type === 'match') {
+            results.push({
+              file: path.relative(this.workingDir, data.path),
+              line: data.line_number,
+              text: data.lines.text
+            });
+          }
+        } catch {
+          // 忽略解析错误
+        }
+      }
+
+      const result = {
+        success: true,
+        data: { matches: results, count: results.length }
+      };
+      this.log('searchCode', { pattern, searchPath, fileType }, result);
+      return result;
+    } catch (error) {
+      const result = { success: false, error: error.message };
+      this.log('searchCode', { pattern }, result);
+      return result;
+    }
+  }
+
+  // bash 工具 - 执行 shell 命令
+  async bash({ command, timeout = 30000 }) {
+    return new Promise((resolve) => {
+      const proc = spawn('bash', ['-lc', command], {
+        cwd: this.workingDir,
+        shell: true,
+        env: { ...process.env, PATH: process.env.PATH }
+      });
+
+      let stdout = '';
+      let stderr = '';
+
+      proc.stdout.on('data', (data) => {
+        stdout += data.toString();
+      });
+
+      proc.stderr.on('data', (data) => {
+        stderr += data.toString();
+      });
+
+      const timer = setTimeout(() => {
+        proc.kill('SIGKILL');
+        resolve({
+          success: false,
+          data: { error: 'Command timeout' },
+          error: 'Command timeout'
+        });
+      }, timeout);
+
+      proc.on('close', (exitCode) => {
+        clearTimeout(timer);
+        const result = {
+          success: exitCode === 0,
+          data: {
+            stdout: stdout.trim(),
+            stderr: stderr.trim(),
+            exitCode
+          }
+        };
+        this.log('bash', { command }, result);
+        resolve(result);
+      });
+
+      proc.on('error', (error) => {
+        clearTimeout(timer);
+        const result = {
+          success: false,
+          data: null,
+          error: error.message
+        };
+        this.log('bash', { command }, result);
+        resolve(result);
+      });
+    });
+  }
+
+  // writeFile 工具
+  async writeFile({ filePath, content, encoding = 'utf-8' }) {
+    try {
+      const fullPath = path.resolve(this.workingDir, filePath);
+      await fs.mkdir(path.dirname(fullPath), { recursive: true });
+      await fs.writeFile(fullPath, content, encoding);
+
+      const result = {
+        success: true,
+        data: { path: fullPath, size: content.length }
+      };
+      this.log('writeFile', { filePath, size: content.length }, result);
+      return result;
+    } catch (error) {
+      const result = { success: false, error: error.message };
+      this.log('writeFile', { filePath }, result);
+      return result;
+    }
+  }
+
+  getCallLog() {
+    return this.callLog;
+  }
+
+  printSummary() {
+    console.log('\n=== 工具调用统计 ===');
+    const stats = {};
+    this.callLog.forEach(log => {
+      stats[log.tool] = (stats[log.tool] || 0) + 1;
+    });
+    Object.entries(stats).forEach(([tool, count]) => {
+      console.log(`  ${tool}: ${count} 次`);
+    });
+    console.log(`  总计: ${this.callLog.length} 次`);
+  }
+}
+
+// 代码分析报告生成器
+async function runCodeAnalyzerScenario() {
+  console.log('\n========================================');
+  console.log('场景二：代码分析报告生成器');
+  console.log('========================================\n');
+
+  const executor = new MockToolExecutor();
+
+  try {
+    const report = {
+      timestamp: new Date().toISOString(),
+      project: path.basename(executor.workingDir),
+      sections: []
+    };
+
+    // 步骤 1: 统计代码行数
+    console.log('步骤 1: 统计代码行数...');
+    const locResult = await executor.bash({
+      command: 'find src -name "*.js" -type f | wc -l'
+    });
+
+    if (locResult.success) {
+      const fileCount = locResult.data.stdout;
+      console.log(`  找到 ${fileCount} 个 JavaScript 文件`);
+
+      // 统计总行数
+      const linesResult = await executor.bash({
+        command: 'find src -name "*.js" -type f -exec cat {} \\; | wc -l'
+      });
+
+      if (linesResult.success) {
+        report.sections.push({
+          title: '代码行数统计',
+          data: {
+            jsFiles: parseInt(fileCount),
+            totalLines: parseInt(linesResult.data.stdout)
+          }
+        });
+        console.log(`  总行数: ${linesResult.data.stdout}\n`);
+      }
+    }
+
+    // 步骤 2: 搜索函数定义
+    console.log('步骤 2: 搜索函数定义...');
+    const functionResult = await executor.searchCode({
+      pattern: 'function\\s+\\w+|const\\s+\\w+\\s*=\\s*(async\\s*)?\\(',
+      path: 'src',
+      fileType: 'js'
+    });
+
+    if (functionResult.success) {
+      console.log(`  找到 ${functionResult.data.count} 个函数定义`);
+      report.sections.push({
+        title: '函数定义统计',
+        data: {
+          count: functionResult.data.count,
+          samples: functionResult.data.matches.slice(0, 5).map(m => ({
+            file: m.file,
+            line: m.line,
+            text: m.text.trim().substring(0, 60)
+          }))
+        }
+      });
+      console.log(`  示例:\n`);
+      functionResult.data.matches.slice(0, 3).forEach(m => {
+        console.log(`    ${m.file}:${m.line} - ${m.text.trim().substring(0, 50)}...`);
+      });
+      console.log('');
+    }
+
+    // 步骤 3: 搜索类定义
+    console.log('步骤 3: 搜索类定义...');
+    const classResult = await executor.searchCode({
+      pattern: 'class\\s+\\w+',
+      path: 'src',
+      fileType: 'js'
+    });
+
+    if (classResult.success) {
+      console.log(`  找到 ${classResult.data.count} 个类定义`);
+      report.sections.push({
+        title: '类定义统计',
+        data: {
+          count: classResult.data.count,
+          classes: classResult.data.matches.map(m => ({
+            file: m.file,
+            line: m.line,
+            name: m.text.match(/class\s+(\w+)/)?.[1] || 'Unknown'
+          }))
+        }
+      });
+      console.log('');
+    }
+
+    // 步骤 4: 搜索导入语句
+    console.log('步骤 4: 分析依赖关系...');
+    const importResult = await executor.searchCode({
+      pattern: '^import\\s+.*from',
+      path: 'src',
+      fileType: 'js'
+    });
+
+    if (importResult.success) {
+      const dependencies = new Set();
+      importResult.data.matches.forEach(m => {
+        const match = m.text.match(/from\s+['"]([^'"]+)['"]/);
+        if (match && !match[1].startsWith('.')) {
+          dependencies.add(match[1]);
+        }
+      });
+
+      console.log(`  找到 ${importResult.data.count} 个导入语句`);
+      console.log(`  外部依赖: ${dependencies.size} 个\n`);
+
+      report.sections.push({
+        title: '依赖关系分析',
+        data: {
+          totalImports: importResult.data.count,
+          externalDependencies: Array.from(dependencies)
+        }
+      });
+    }
+
+    // 步骤 5: 生成 Markdown 报告
+    console.log('步骤 5: 生成分析报告...');
+    let markdown = `# 代码分析报告\n\n`;
+    markdown += `- 项目: ${report.project}\n`;
+    markdown += `- 生成时间: ${report.timestamp}\n\n`;
+
+    report.sections.forEach(section => {
+      markdown += `## ${section.title}\n\n`;
+      if (section.title === '代码行数统计') {
+        markdown += `- JavaScript 文件数: ${section.data.jsFiles}\n`;
+        markdown += `- 总代码行数: ${section.data.totalLines}\n\n`;
+      } else if (section.title === '函数定义统计') {
+        markdown += `- 函数总数: ${section.data.count}\n\n`;
+        markdown += `### 示例函数\n\n`;
+        section.data.samples.forEach(s => {
+          markdown += `\`${s.file}:${s.line}\` - ${s.text}\n\n`;
+        });
+      } else if (section.title === '类定义统计') {
+        markdown += `- 类总数: ${section.data.count}\n\n`;
+        markdown += `### 类列表\n\n`;
+        section.data.classes.forEach(c => {
+          markdown += `- \`${c.name}\` (${c.file}:${c.line})\n`;
+        });
+        markdown += '\n';
+      } else if (section.title === '依赖关系分析') {
+        markdown += `- 总导入语句: ${section.data.totalImports}\n`;
+        markdown += `- 外部依赖: ${section.data.externalDependencies.length}\n\n`;
+        markdown += `### 外部依赖列表\n\n`;
+        section.data.externalDependencies.forEach(dep => {
+          markdown += `- ${dep}\n`;
+        });
+        markdown += '\n';
+      }
+    });
+
+    const writeResult = await executor.writeFile({
+      filePath: 'scenarios/output/code-analysis-report.md',
+      content: markdown
+    });
+
+    if (writeResult.success) {
+      console.log(`  ✓ 报告已生成: ${writeResult.data.path} (${writeResult.data.size} bytes)\n`);
+    }
+
+    // 打印统计
+    console.log('========================================');
+    console.log('分析完成');
+    console.log('========================================');
+    report.sections.forEach(section => {
+      console.log(`${section.title}: ✓`);
+    });
+    executor.printSummary();
+
+    return {
+      success: true,
+      report,
+      toolCalls: executor.getCallLog()
+    };
+  } catch (error) {
+    console.error('\n场景执行失败:', error.message);
+    return { success: false, error: error.message };
+  }
+}
+
+async function main() {
+  const result = await runCodeAnalyzerScenario();
+
+  if (result.success) {
+    console.log('\n✓ 场景二执行成功\n');
+    process.exit(0);
+  } else {
+    console.log('\n✗ 场景二执行失败\n');
+    process.exit(1);
+  }
+}
+
+export { runCodeAnalyzerScenario };
+
+if (import.meta.url === `file://${process.argv[1]}`) {
+  main();
+}