closer-code 1.0.0

package/src/utils/version.js

@@ -0,0 +1,33 @@
+/**
+ * 版本信息工具
+ */
+
+import { readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+/**
+ * 获取包版本号
+ * @returns {string} 版本号
+ */
+export function getVersion() {
+  try {
+    const packagePath = join(__dirname, '../../package.json');
+    const packageJson = JSON.parse(readFileSync(packagePath, 'utf-8'));
+    return packageJson.version || '1.0.0';
+  } catch (error) {
+    return '1.0.0';
+  }
+}
+
+/**
+ * 显示版本信息
+ */
+export function showVersion() {
+  const version = getVersion();
+  console.log(`cloco v${version}`);
+  console.log('AI 编程助理 - 通过对话完成编码、调试和任务规划');
+}

package/src/utils/workflow-test.js

@@ -0,0 +1,271 @@
+/**
+ * Workflow 测试工具
+ * 用于执行两轮对话的 workflow 测试
+ */
+
+import fs from 'fs/promises';
+import path from 'path';
+import { createConversation, WORKFLOW_PROMPT_PREFIX } from '../conversation.js';
+import { loadConfig } from '../config.js';
+
+/**
+ * 列出所有可用的 workflow 测试
+ */
+export async function listWorkflows() {
+  const workflowsDir = path.resolve('test/workflows');
+
+  try {
+    const entries = await fs.readdir(workflowsDir, { withFileTypes: true });
+    const workflows = [];
+
+    for (const entry of entries) {
+      if (entry.isDirectory()) {
+        const testDir = path.join(workflowsDir, entry.name);
+        const promptPath = path.join(testDir, 'prompt.md');
+        const expectPath = path.join(testDir, 'expect.md');
+
+        // 检查必需的文件是否存在
+        try {
+          await fs.access(promptPath);
+          await fs.access(expectPath);
+
+          // 读取描述
+          let description = '';
+          try {
+            const descPath = path.join(testDir, 'description.md');
+            description = await fs.readFile(descPath, 'utf-8');
+          } catch {
+            // description.md 可选
+          }
+
+          workflows.push({
+            name: entry.name,
+            path: testDir,
+            description: description.trim()
+          });
+        } catch {
+          // 缺少必需文件，跳过
+        }
+      }
+    }
+
+    return workflows;
+  } catch (error) {
+    if (error.code === 'ENOENT') {
+      return [];
+    }
+    throw error;
+  }
+}
+
+/**
+ * 运行单个 workflow 测试
+ * @param {string} testName - 测试名称
+ * @param {Object} options - 选项
+ * @returns {Object} 测试结果
+ */
+export async function runWorkflowTest(testName, options = {}) {
+  const workflowsDir = path.resolve('test/workflows');
+  const testDir = path.join(workflowsDir, testName);
+  const promptPath = path.join(testDir, 'prompt.md');
+  const expectPath = path.join(testDir, 'expect.md');
+
+  // 验证测试目录存在
+  try {
+    await fs.access(testDir);
+    await fs.access(promptPath);
+    await fs.access(expectPath);
+  } catch (error) {
+    throw new Error(`Workflow test "${testName}" not found or incomplete`);
+  }
+
+  // 读取文件
+  const prompt = await fs.readFile(promptPath, 'utf-8');
+  const expect = await fs.readFile(expectPath, 'utf-8');
+
+  // 加载配置
+  const config = await loadConfig();
+
+  // 设置工作目录为测试目录
+  config.behavior.workingDir = testDir;
+
+  // 创建对话会话（workflow 测试模式）
+  const conversation = await createConversation(config, true);
+
+  const startTime = Date.now();
+  const iterations = [];
+
+  try {
+    // 第1轮：执行任务
+    if (options.verbose) {
+      console.log(`\n${'='.repeat(60)}`);
+      console.log(`第1轮: 执行任务`);
+      console.log(`${'='.repeat(60)}`);
+    }
+
+    const response1 = await conversation.sendMessage(
+      WORKFLOW_PROMPT_PREFIX + '\n\n' + prompt,
+      (event) => {
+        if (options.verbose) {
+          handleProgress(event, options);
+        }
+      }
+    );
+
+    iterations.push({
+      round: 1,
+      content: response1.content,
+      toolCalls: response1.toolCalls || []
+    });
+
+    if (options.verbose) {
+      console.log(`\n${'─'.repeat(60)}`);
+      console.log(`响应:`, response1.content);
+      console.log(`${'─'.repeat(60)}`);
+    }
+
+    // 第2轮：验证结果
+    if (options.verbose) {
+      console.log(`\n${'='.repeat(60)}`);
+      console.log(`第2轮: 验证结果`);
+      console.log(`${'='.repeat(60)}`);
+    }
+
+    const response2 = await conversation.sendMessage(
+      WORKFLOW_PROMPT_PREFIX + '\n\n' + expect,
+      (event) => {
+        if (options.verbose) {
+          handleProgress(event, options);
+        }
+      }
+    );
+
+    iterations.push({
+      round: 2,
+      content: response2.content,
+      toolCalls: response2.toolCalls || []
+    });
+
+    if (options.verbose) {
+      console.log(`\n${'─'.repeat(60)}`);
+      console.log(`响应:`, response2.content);
+      console.log(`${'─'.repeat(60)}`);
+    }
+
+    // 检查验收结果
+    const passed = response2.content?.includes('WORKFLOW TEST AS EXPECTED');
+    const endTime = Date.now();
+    const duration = endTime - startTime;
+
+    console.log(`\n[DEBUG] Response 2 content:`, response2.content?.substring(0, 200));
+    console.log(`[DEBUG] Passed:`, passed);
+
+    return {
+      name: testName,
+      passed,
+      duration,
+      iterations,
+      error: null
+    };
+
+  } catch (error) {
+    const endTime = Date.now();
+    const duration = endTime - startTime;
+
+    console.error(`[DEBUG] Error:`, error.message);
+    console.error(`[DEBUG] Stack:`, error.stack);
+
+    return {
+      name: testName,
+      passed: false,
+      duration,
+      iterations,
+      error: error.message
+    };
+  }
+}
+
+/**
+ * 处理进度事件
+ */
+function handleProgress(event, options) {
+  switch (event.type) {
+    case 'token':
+      process.stdout.write(event.content);
+      break;
+    case 'tool_start':
+      console.log(`\n[工具调用] ${event.tool}`, JSON.stringify(event.input, null, 2));
+      break;
+    case 'tool_complete':
+      console.log(`[工具完成] ${event.tool}`);
+      if (options.debug) {
+        console.log(JSON.stringify(event.result, null, 2));
+      }
+      break;
+    case 'error':
+      console.error(`\n[错误]`, event.error);
+      break;
+  }
+}
+
+/**
+ * 格式化测试结果输出
+ */
+export function formatTestResult(result, options = {}) {
+  const { name, passed, duration, error } = result;
+
+  if (options.json) {
+    return JSON.stringify(result, null, 2);
+  }
+
+  const statusIcon = passed ? '✅' : '❌';
+  const statusText = passed ? '通过' : '失败';
+  const durationSec = (duration / 1000).toFixed(2);
+
+  let output = `\n${statusIcon} ${name} - ${statusText} (${durationSec}s)`;
+
+  if (error) {
+    output += `\n   错误: ${error}`;
+  }
+
+  if (options.verbose && result.iterations) {
+    result.iterations.forEach((iter, idx) => {
+      output += `\n\n   第${idx + 1}轮对话:`;
+      output += `\n   ${'─'.repeat(50)}`;
+      output += `\n   ${iter.content.split('\n').join('\n   ')}`;
+
+      if (iter.toolCalls && iter.toolCalls.length > 0) {
+        output += `\n   工具调用: ${iter.toolCalls.join(', ')}`;
+      }
+    });
+  }
+
+  return output;
+}
+
+/**
+ * 格式化多个测试结果
+ */
+export function formatTestResults(results, options = {}) {
+  if (options.json) {
+    return JSON.stringify(results, null, 2);
+  }
+
+  const passed = results.filter(r => r.passed).length;
+  const failed = results.filter(r => !r.passed).length;
+  const total = results.length;
+
+  let output = `\n${'='.repeat(60)}`;
+  output += `\nWorkflow 测试结果汇总`;
+  output += `\n${'='.repeat(60)}`;
+  output += `\n总计: ${total}, 通过: ${passed}, 失败: ${failed}`;
+  output += `\n${'='.repeat(60)}\n`;
+
+  results.forEach(result => {
+    output += formatTestResult(result, options);
+  });
+
+  output += `\n${'='.repeat(60)}\n`;
+
+  return output;
+}

package/src/utils/workflow.js

@@ -0,0 +1,268 @@
+/**
+ * Workflow 自动化执行引擎
+ * 支持多轮对话迭代和验收标准验证
+ */
+
+import fs from 'fs/promises';
+import path from 'path';
+import { createConversation } from '../conversation.js';
+import { validateExpect } from './validator.js';
+import { showSuccess, showError, showInfo, showWarning } from './cli.js';
+
+/**
+ * 解析 workflow 路径
+ */
+function resolveWorkflowPath(workflowPath) {
+  // 如果是绝对路径，直接使用
+  if (path.isAbsolute(workflowPath)) {
+    return workflowPath;
+  }
+
+  // 尝试相对于当前工作目录
+  const relativeToCwd = path.resolve(process.cwd(), workflowPath);
+
+  // 尝试相对于项目根目录的 workflow 目录
+  const relativeToProject = path.resolve(process.cwd(), 'workflow', workflowPath);
+
+  // 检查哪个路径存在
+  return relativeToCwd; // 优先使用用户提供的路径
+}
+
+/**
+ * 加载 workflow 案例
+ */
+async function loadWorkflowCase(workflowDir) {
+  const promptPath = path.join(workflowDir, 'prompt.md');
+  const expectPath = path.join(workflowDir, 'expect.md');
+
+  let prompt, expect;
+
+  try {
+    prompt = await fs.readFile(promptPath, 'utf-8');
+  } catch (error) {
+    throw new Error(`无法读取 prompt.md: ${error.message}`);
+  }
+
+  try {
+    expect = await fs.readFile(expectPath, 'utf-8');
+  } catch (error) {
+    throw new Error(`无法读取 expect.md: ${error.message}`);
+  }
+
+  return { prompt: prompt.trim(), expect: expect.trim(), workflowDir };
+}
+
+/**
+ * 处理进度事件
+ */
+function handleProgress(event, options) {
+  if (!options.verbose && !options.debug) {
+    return;
+  }
+
+  switch (event.type) {
+    case 'token':
+      // 流式输出 token（仅在 debug 模式）
+      if (options.debug) {
+        process.stdout.write(event.token);
+      }
+      break;
+    case 'tool_start':
+      showInfo(`⚡ 执行工具: ${event.tool}`);
+      break;
+    case 'tool_complete':
+      if (event.error) {
+        showError(`工具 ${event.tool} 失败: ${event.error}`);
+      } else {
+        showSuccess(`工具 ${event.tool} 完成`);
+      }
+      break;
+    case 'error':
+      showError(`错误: ${event.error}`);
+      break;
+  }
+}
+
+/**
+ * 运行 workflow
+ */
+export async function runWorkflow(workflowPath, args, options) {
+  const workflowDir = resolveWorkflowPath(workflowPath);
+
+  showInfo(`🎯 开始执行 workflow: ${workflowPath}`);
+
+  // 1. 加载案例
+  let caseData;
+  try {
+    caseData = await loadWorkflowCase(workflowDir);
+    console.log(`\n📝 需求:\n${caseData.prompt}\n`);
+    console.log(`✅ 验收标准:\n${caseData.expect}\n`);
+  } catch (error) {
+    showError(error.message);
+    return {
+      success: false,
+      error: error.message
+    };
+  }
+
+  // 2. 初始化配置
+  const maxIterations = parseInt(options.maxIterations) || 5;
+  console.log(`🔄 最大迭代次数: ${maxIterations}\n`);
+
+  // 3. 创建对话会话
+  let conversation;
+  try {
+    conversation = await createConversation();
+  } catch (error) {
+    showError(`创建对话失败: ${error.message}`);
+    return {
+      success: false,
+      error: `Failed to create conversation: ${error.message}`
+    };
+  }
+
+  // 4. 迭代执行
+  let lastValidationResult = null;
+
+  for (let iteration = 1; iteration <= maxIterations; iteration++) {
+    console.log(`\n${'='.repeat(50)}`);
+    console.log(`第 ${iteration}/${maxIterations} 轮`);
+    console.log('='.repeat(50));
+
+    // 构造用户消息
+    let userMessage;
+    if (iteration === 1) {
+      // 第一轮：发送原始需求
+      userMessage = caseData.prompt;
+    } else {
+      // 后续轮：告知 AI 继续改进
+      userMessage = `请继续改进。当前未满足验收标准：\n${caseData.expect}\n\n上次验证结果：${lastValidationResult?.reason || '请检查并改进'}`;
+    }
+
+    // 发送到 AI
+    let response;
+    try {
+      console.log(`\n📤 发送消息到 AI...`);
+
+      response = await conversation.sendMessage(userMessage, (event) => {
+        handleProgress(event, options);
+      });
+
+      // 显示 AI 响应摘要
+      const content = response.content || '';
+      const preview = content.length > 200 ? content.substring(0, 200) + '...' : content;
+      console.log(`\n🤖 AI 响应:\n${preview}\n`);
+
+    } catch (error) {
+      showError(`AI 交互失败: ${error.message}`);
+
+      return {
+        success: false,
+        iterations: iteration,
+        error: `AI interaction failed: ${error.message}`,
+        lastValidation: lastValidationResult
+      };
+    }
+
+    // 5. 验证结果
+    try {
+      console.log(`\n🔍 验证验收标准...`);
+
+      lastValidationResult = await validateExpect(
+        caseData.expect,
+        workflowDir,
+        options.verbose
+      );
+
+      if (lastValidationResult.passed) {
+        console.log(`\n${'='.repeat(50)}`);
+        showSuccess(`✅ 验收标准已满足！`);
+        console.log(`📊 总迭代次数: ${iteration}`);
+
+        if (lastValidationResult.details) {
+          console.log(`\n验证详情:`);
+          lastValidationResult.details.forEach(detail => {
+            console.log(`  ✓ ${detail.check}`);
+          });
+        }
+
+        return {
+          success: true,
+          iterations: iteration,
+          validation: lastValidationResult,
+          response: response
+        };
+      } else {
+        showWarning(`验证未通过: ${lastValidationResult.reason}`);
+
+        if (lastValidationResult.details && options.verbose) {
+          console.log(`\n验证详情:`);
+          lastValidationResult.details.forEach(detail => {
+            console.log(`  ${detail.passed ? '✓' : '✗'} ${detail.check}: ${detail.reason}`);
+          });
+        }
+      }
+
+    } catch (error) {
+      showError(`验证失败: ${error.message}`);
+
+      // 验证失败不应中断整个流程，记录后继续
+      lastValidationResult = {
+        passed: false,
+        reason: `Validation error: ${error.message}`
+      };
+    }
+  }
+
+  // 达到最大迭代次数
+  console.log(`\n${'='.repeat(50)}`);
+  showError(`❌ 达到最大迭代次数 (${maxIterations})，任务未完成`);
+
+  if (lastValidationResult) {
+    console.log(`\n最后验证结果: ${lastValidationResult.reason}`);
+  }
+
+  return {
+    success: false,
+    iterations: maxIterations,
+    reason: 'Max iterations reached',
+    lastValidation: lastValidationResult
+  };
+}
+
+/**
+ * 列出可用的 workflow 案例
+ */
+export async function listWorkflows() {
+  const workflowDir = path.resolve(process.cwd(), 'workflow');
+
+  try {
+    const entries = await fs.readdir(workflowDir, { withFileTypes: true });
+    const workflows = [];
+
+    for (const entry of entries) {
+      if (entry.isDirectory()) {
+        const casePath = path.join(workflowDir, entry.name);
+        const promptPath = path.join(casePath, 'prompt.md');
+        const expectPath = path.join(casePath, 'expect.md');
+
+        try {
+          await fs.access(promptPath);
+          await fs.access(expectPath);
+
+          workflows.push({
+            name: entry.name,
+            path: casePath
+          });
+        } catch {
+          // 缺少必要文件，跳过
+        }
+      }
+    }
+
+    return workflows;
+  } catch (error) {
+    // workflow 目录不存在
+    return [];
+  }
+}

package/test/demo-file-naming.js

@@ -0,0 +1,92 @@
+#!/usr/bin/env node
+/**
+ * 演示改进后的文件命名
+ * 
+ * 文件名格式: {md5-hash}-{directory-name}.json
+ * 例如: 06aecb89a562f1a6038cca327538315e-project-beta.json
+ */
+
+import {
+  loadHistory,
+  saveHistory,
+  listHistory,
+  clearHistory
+} from '../src/config.js';
+import path from 'path';
+import crypto from 'crypto';
+
+const colors = {
+  reset: '\x1b[0m',
+  green: '\x1b[32m',
+  blue: '\x1b[34m',
+  yellow: '\x1b[33m',
+  cyan: '\x1b[36m',
+  magenta: '\x1b[35m'
+};
+
+function log(message, color = 'reset') {
+  console.log(`${colors[color]}${message}${colors.reset}`);
+}
+
+console.log('\n' + '='.repeat(70));
+log('  改进后的文件命名演示', 'cyan');
+console.log('='.repeat(70) + '\n');
+
+// 测试项目路径
+const testProjects = [
+  path.join(process.cwd(), 'test-projects', 'my-awesome-app'),
+  path.join(process.cwd(), 'test-projects', 'api-server'),
+  path.join(process.cwd(), 'test-projects', 'frontend-v2'),
+  path.join(process.cwd(), 'test-projects', 'data.processor'),
+];
+
+log('📝 创建测试项目历史...\n', 'yellow');
+
+// 为每个项目创建一些历史
+testProjects.forEach((projectPath, i) => {
+  const history = [
+    { role: 'user', content: `项目 ${i + 1} 的第一条消息` },
+    { role: 'assistant', content: `收到！正在处理项目 ${i + 1}` }
+  ];
+  saveHistory(history, projectPath);
+  log(`✓ 已创建: ${path.basename(projectPath)}`, 'green');
+});
+
+log('\n📂 历史文件命名示例:\n', 'cyan');
+
+// 列出所有项目
+const projects = listHistory();
+
+projects.forEach((p, i) => {
+  const dirName = path.basename(p.projectPath);
+  log(`${i + 1}. 项目: ${dirName}`, 'blue');
+  log(`   完整路径: ${p.projectPath}`, 'reset');
+  log(`   消息数: ${p.messageCount}`, 'green');
+  log(`   最后更新: ${new Date(p.lastUpdated).toLocaleString('zh-CN')}`, 'reset');
+  
+  // 显示对应的文件名
+  const hash = crypto.createHash('md5').update(p.projectPath).digest('hex');
+  const cleanDirName = dirName.replace(/[^a-zA-Z0-9_-]/g, '_');
+  log(`   文件名: ${hash}-${cleanDirName}.json`, 'magenta');
+  log('', 'reset');
+});
+
+console.log('='.repeat(70));
+log('✨ 文件命名优势:', 'cyan');
+console.log('='.repeat(70));
+log('1. 哈希值前缀 - 确保文件名唯一性', 'green');
+log('2. 目录名后缀 - 便于人类识别和查阅', 'green');
+log('3. 特殊字符处理 - 避免文件系统问题', 'green');
+log('4. 示例对比:', 'yellow');
+log('   ❌ 旧: 06aecb89a562f1a6038cca327538315e.json', 'red');
+log('   ✅ 新: 06aecb89a562f1a6038cca327538315e-my-awesome-app.json', 'green');
+console.log('='.repeat(70) + '\n');
+
+// 清理测试数据
+log('🧹 清理测试数据...\n', 'yellow');
+testProjects.forEach(projectPath => {
+  clearHistory(projectPath);
+});
+
+log('✓ 清理完成', 'green');
+log('\n演示结束！\n', 'cyan');