closer-code 1.0.0

package/src/commands/batch.js

@@ -0,0 +1,62 @@
+/**
+ * 批处理模式命令
+ * 支持单次对话和 workflow 模式
+ */
+
+export default async function batchCommand(args, options) {
+  // Workflow 模式：支持多轮迭代和验收标准验证
+  if (options.workflow) {
+    const { runWorkflow } = await import('../utils/workflow.js');
+    const result = await runWorkflow(options.workflow, args, options);
+
+    // 根据 JSON 选项格式化输出
+    if (options.json || options.j) {
+      console.log(JSON.stringify(result, null, 2));
+    }
+
+    // 设置退出码
+    process.exit(result.success ? 0 : 1);
+    return;
+  }
+
+  // 常规批处理模式：单次对话
+  // 临时保存原始 process.argv
+  const originalArgv = process.argv.slice();
+
+  // 构建新的 argv 数组，模拟直接调用 batch-cli.js
+  process.argv = [
+    process.argv[0], // node
+    process.argv[1], // 当前脚本
+  ];
+
+  // 添加选项
+  if (options.help || options.h) {
+    process.argv.push('--help');
+  }
+  if (options.json || options.j) {
+    process.argv.push('--json');
+  }
+  if (options.verbose || options.v) {
+    process.argv.push('--verbose');
+  }
+  if (options.debug || options.d) {
+    process.argv.push('--debug');
+  }
+  if (options.file || options.f) {
+    process.argv.push('--file', options.file || options.f);
+  }
+
+  // 添加提示词参数
+  if (args.length > 0) {
+    process.argv.push(args.join(' '));
+  }
+
+  try {
+    // 导入并运行批处理模式
+    const { runBatch } = await import('../batch-cli.js');
+    await runBatch();
+  } finally {
+    // 恢复原始 process.argv
+    process.argv = originalArgv;
+  }
+}

package/src/commands/chat.js

@@ -0,0 +1,10 @@
+/**
+ * 交互模式命令
+ * 暂时桥接到现有的 closer-cli.jsx
+ */
+
+export default async function chatCommand(args, options) {
+  // 动态导入并运行现有的交互模式
+  // 由于 closer-cli.jsx 是 jsx 文件且使用 ink，我们直接导入它的主逻辑
+  await import('../closer-cli.jsx');
+}

package/src/commands/config.js

@@ -0,0 +1,154 @@
+/**
+ * 配置管理命令
+ */
+
+import { loadConfig, saveConfig, updateConfig } from '../config.js';
+import { showError, showSuccess, showTip, showInfo } from '../utils/cli.js';
+import { execSync } from 'child_process';
+import { join } from 'path';
+import os from 'os';
+
+const CONFIG_DIR = join(os.homedir(), '.closer-code');
+const CONFIG_FILE = join(CONFIG_DIR, 'config.json');
+
+/**
+ * 显示配置
+ */
+function showConfig(config, key = null) {
+  if (key) {
+    // 显示特定配置项
+    const keys = key.split('.');
+    let value = config;
+    for (const k of keys) {
+      value = value?.[k];
+    }
+    if (value === undefined) {
+      showError(`配置项不存在: ${key}`);
+    } else {
+      console.log(`${key}: ${JSON.stringify(value, null, 2)}`);
+    }
+  } else {
+    // 显示所有配置
+    console.log(JSON.stringify(config, null, 2));
+  }
+}
+
+/**
+ * 设置配置项
+ */
+function setConfig(key, value) {
+  if (!key || value === undefined) {
+    showError('用法: cloco config set <key> <value>');
+    return;
+  }
+
+  try {
+    // 解析值（支持 JSON 和原始类型）
+    let parsedValue;
+    try {
+      parsedValue = JSON.parse(value);
+    } catch {
+      parsedValue = value;
+    }
+
+    // 使用点号表示法设置嵌套属性
+    const keys = key.split('.');
+    const update = {};
+    let current = update;
+    for (let i = 0; i < keys.length - 1; i++) {
+      current[keys[i]] = {};
+      current = current[keys[i]];
+    }
+    current[keys[keys.length - 1]] = parsedValue;
+
+    updateConfig(update);
+    showSuccess(`已设置 ${key} = ${JSON.stringify(parsedValue)}`);
+  } catch (error) {
+    showError(`设置配置失败: ${error.message}`);
+  }
+}
+
+/**
+ * 获取配置项
+ */
+function getConfigValue(key) {
+  if (!key) {
+    showError('用法: cloco config get <key>');
+    return;
+  }
+
+  const config = loadConfig();
+  showConfig(config, key);
+}
+
+/**
+ * 打开配置文件编辑器
+ */
+function openConfigInEditor() {
+  try {
+    const editor = process.env.EDITOR || process.env.VISUAL || 'code';
+
+    if (!editor) {
+      showTip('未设置编辑器。请设置环境变量 EDITOR 或 VISUAL');
+      showTip('例如: export EDITOR=code');
+      showInfo(`配置文件位置: ${CONFIG_FILE}`);
+      return;
+    }
+
+    showInfo(`正在使用 ${editor} 打开配置文件...`);
+    execSync(`${editor} "${CONFIG_FILE}"`, { stdio: 'inherit' });
+  } catch (error) {
+    showError(`打开编辑器失败: ${error.message}`);
+  }
+}
+
+/**
+ * 重置配置
+ */
+function resetConfig() {
+  try {
+    // 导入默认配置
+    const { DEFAULT_CONFIG } = '../config.js';
+    saveConfig(DEFAULT_CONFIG);
+    showSuccess('配置已重置为默认值');
+  } catch (error) {
+    showError(`重置配置失败: ${error.message}`);
+  }
+}
+
+/**
+ * 配置管理主命令
+ */
+export default async function configCommand(args, options) {
+  const action = args[0];
+  const config = loadConfig();
+
+  switch (action) {
+    case 'set':
+      setConfig(args[1], args[2]);
+      break;
+
+    case 'get':
+      getConfigValue(args[1]);
+      break;
+
+    case 'edit':
+      openConfigInEditor();
+      break;
+
+    case 'reset':
+      resetConfig();
+      break;
+
+    case 'show':
+    case undefined:
+      showConfig(config);
+      break;
+
+    default:
+      showError(`未知操作: ${action}`);
+      showTip('可用操作: set, get, edit, reset, show');
+      showTip('运行 "cloco help" 查看更多信息');
+      process.exit(1);
+  }
+}

package/src/commands/help.js

@@ -0,0 +1,76 @@
+/**
+ * 帮助文档系统
+ */
+
+import { getVersion } from '../utils/version.js';
+
+/**
+ * 显示主帮助信息
+ */
+export async function showHelp() {
+  const version = getVersion();
+
+  console.log(`
+Cloco - AI 编程助手 v${version}
+
+使用方式:
+  cloco [选项] [提示词]
+  cloco -b|--batch [选项] <提示词>
+  cloco config <操作> [参数]
+  cloco setup|upgrade|version|help
+
+交互模式:
+  cloco                              # 启动交互式对话（默认）
+                                       # 首次使用会自动运行配置向导
+
+批处理模式:
+  cloco -b "分析代码"                  # 短选项
+  cloco --batch "列出文件"             # 长选项
+  cloco -b --json "生成代码" > out.js  # JSON 格式输出
+  cloco -b --file prompt.txt          # 从文件读取提示词
+  cloco -b --verbose "分析"            # 详细输出（包含工具调用）
+
+配置管理:
+  cloco config                        # 查看当前配置
+  cloco config set <key> <value>      # 设置配置项
+  cloco config get <key>              # 获取配置项
+  cloco config edit                   # 打开配置文件
+  cloco config reset                  # 重置为默认配置
+
+其他命令:
+  cloco setup                         # 手动运行配置向导
+  cloco upgrade                       # 检查版本更新
+  cloco version                       # 显示版本信息
+  cloco help                          # 显示此帮助信息
+
+选项:
+  -b, --batch                         # 批处理模式
+  -j, --json                          # JSON 格式输出
+  -f, --file <文件>                   # 从文件读取提示词
+  --verbose                           # 详细输出模式
+  -d, --debug                         # 启用调试日志
+  -h, --help                          # 显示帮助信息
+  -v, --version                       # 显示版本信息
+
+环境变量:
+  CLOSER_AI_PROVIDER                  # AI 提供商 (anthropic, openai, ollama)
+  CLOSER_ANTHROPIC_API_KEY            # Anthropic API Key
+  CLOSER_OPENAI_API_KEY               # OpenAI API Key
+  CLOSER_DEBUG_LOG                    # 启用调试日志 (设为 1)
+
+文档:
+  https://github.com/your-repo/closer-code
+
+示例:
+  # 快速开始
+  cloco                               # 首次使用会引导配置
+
+  # 批处理任务
+  cloco -b "解释这个函数"
+  cloco -b --json "生成代码" > output.json
+
+  # 配置管理
+  cloco config set ai.provider openai
+  cloco config get ai.provider
+`);
+}

package/src/commands/history.js

@@ -0,0 +1,192 @@
+#!/usr/bin/env node
+/**
+ * 历史管理命令
+ * 
+ * 用法:
+ *   node history.js list              - 列出所有项目的历史
+ *   node history.js show <path>       - 显示指定项目的历史
+ *   node history.js clear <path>      - 清除指定项目的历史
+ *   node history.js export <path>     - 导出指定项目的历史
+ *   node history.js migrate           - 迁移旧的历史文件
+ */
+
+import {
+  loadHistory,
+  saveHistory,
+  clearHistory,
+  listHistory,
+  migrateHistory
+} from '../config.js';
+import fs from 'fs';
+
+const colors = {
+  reset: '\x1b[0m',
+  green: '\x1b[32m',
+  red: '\x1b[31m',
+  blue: '\x1b[34m',
+  yellow: '\x1b[33m',
+  cyan: '\x1b[36m',
+  magenta: '\x1b[35m'
+};
+
+function log(message, color = 'reset') {
+  console.log(`${colors[color]}${message}${colors.reset}`);
+}
+
+function formatMessage(msg, index) {
+  const role = msg.role || 'unknown';
+  const content = msg.content || '';
+  const preview = typeof content === 'string' 
+    ? content.substring(0, 60) + (content.length > 60 ? '...' : '')
+    : '[Non-text content]';
+  
+  return `${index + 1}. [${role}] ${preview}`;
+}
+
+async function cmdList() {
+  log('\n📚 所有项目历史\n', 'cyan');
+  
+  const projects = listHistory();
+  
+  if (projects.length === 0) {
+    log('  没有找到任何项目历史', 'yellow');
+    return;
+  }
+  
+  // 按最后更新时间排序
+  projects.sort((a, b) => new Date(b.lastUpdated) - new Date(a.lastUpdated));
+  
+  projects.forEach((p, i) => {
+    log(`\n${i + 1}. ${p.projectPath}`, 'green');
+    log(`   消息数: ${p.messageCount}`, 'blue');
+    log(`   最后更新: ${new Date(p.lastUpdated).toLocaleString('zh-CN')}`, 'blue');
+  });
+  
+  log(`\n共 ${projects.length} 个项目\n`, 'cyan');
+}
+
+async function cmdShow(projectPath) {
+  if (!projectPath) {
+    log('错误: 请指定项目路径', 'red');
+    log('用法: node history.js show <project-path>', 'yellow');
+    return;
+  }
+  
+  log(`\n📖 项目历史: ${projectPath}\n`, 'cyan');
+  
+  const history = loadHistory(projectPath);
+  
+  if (history.length === 0) {
+    log('  该项目没有历史记录', 'yellow');
+    return;
+  }
+  
+  log(`共 ${history.length} 条消息:\n`, 'blue');
+  
+  history.forEach((msg, i) => {
+    log(formatMessage(msg, i), 'reset');
+  });
+  
+  log('\n', 'reset');
+}
+
+async function cmdClear(projectPath) {
+  if (!projectPath) {
+    log('错误: 请指定项目路径', 'red');
+    log('用法: node history.js clear <project-path>', 'yellow');
+    return;
+  }
+  
+  log(`\n⚠️  确定要清除项目历史吗: ${projectPath}?`, 'yellow');
+  log('这将删除该项目的所有对话历史，且无法恢复。\n', 'yellow');
+  
+  // 在实际使用中，这里可以添加确认逻辑
+  clearHistory(projectPath);
+  
+  log('✓ 项目历史已清除\n', 'green');
+}
+
+async function cmdExport(projectPath) {
+  if (!projectPath) {
+    log('错误: 请指定项目路径', 'red');
+    log('用法: node history.js export <project-path>', 'yellow');
+    return;
+  }
+  
+  const history = loadHistory(projectPath);
+  
+  if (history.length === 0) {
+    log(`项目 ${projectPath} 没有历史记录`, 'yellow');
+    return;
+  }
+  
+  // 生成导出文件名
+  const timestamp = new Date().toISOString().replace(/[:.]/g, '-').substring(0, 19);
+  const exportFile = `history-export-${timestamp}.json`;
+  
+  try {
+    fs.writeFileSync(exportFile, JSON.stringify(history, null, 2));
+    log(`\n✓ 历史已导出到: ${exportFile}`, 'green');
+    log(`  共 ${history.length} 条消息\n`, 'blue');
+  } catch (error) {
+    log(`\n✗ 导出失败: ${error.message}\n`, 'red');
+  }
+}
+
+async function cmdMigrate() {
+  log('\n🔄 开始迁移旧的历史文件...\n', 'cyan');
+  
+  migrateHistory();
+  
+  log('\n✓ 迁移完成\n', 'green');
+}
+
+async function main() {
+  const args = process.argv.slice(2);
+  const command = args[0];
+  const param = args[1];
+  
+  log('\n' + '='.repeat(60), 'cyan');
+  log('  项目历史管理工具', 'cyan');
+  log('='.repeat(60) + '\n', 'cyan');
+  
+  switch (command) {
+    case 'list':
+      await cmdList();
+      break;
+    case 'show':
+      await cmdShow(param);
+      break;
+    case 'clear':
+      await cmdClear(param);
+      break;
+    case 'export':
+      await cmdExport(param);
+      break;
+    case 'migrate':
+      await cmdMigrate();
+      break;
+    case 'help':
+    case '--help':
+    case '-h':
+      log('用法: node history.js <command> [options]\n', 'cyan');
+      log('命令:', 'yellow');
+      log('  list              列出所有项目的历史', 'blue');
+      log('  show <path>       显示指定项目的历史', 'blue');
+      log('  clear <path>      清除指定项目的历史', 'blue');
+      log('  export <path>     导出指定项目的历史', 'blue');
+      log('  migrate           迁移旧的历史文件', 'blue');
+      log('  help              显示此帮助信息\n', 'blue');
+      break;
+    default:
+      log('错误: 未知命令', 'red');
+      log('使用 "node history.js help" 查看帮助\n', 'yellow');
+      process.exit(1);
+  }
+}
+
+main().catch(error => {
+  log(`\n✗ 错误: ${error.message}\n`, 'red');
+  console.error(error);
+  process.exit(1);
+});

package/src/commands/setup.js

@@ -0,0 +1,17 @@
+/**
+ * 初始化向导命令
+ * 导入并运行现有的设置脚本
+ */
+
+export default async function setupCommand(args, options) {
+  // 导入现有的设置脚本
+  const setupModule = await import('../setup.js');
+
+  // 如果 setup.js 导出了 main 函数，调用它
+  if (setupModule.main) {
+    await setupModule.main();
+  } else {
+    // 否则尝试运行默认导出
+    setupModule.default?.();
+  }
+}

package/src/commands/upgrade.js

@@ -0,0 +1,101 @@
+/**
+ * 版本更新检查命令
+ */
+
+import { getVersion } from '../utils/version.js';
+import { showInfo, showSuccess, showTip } from '../utils/cli.js';
+
+/**
+ * 检查 npm 上的最新版本
+ */
+async function checkLatestVersion() {
+  try {
+    const https = await import('https');
+    const packageJson = await import('../../package.json', { assert: { type: 'json' } });
+
+    return new Promise((resolve, reject) => {
+      const options = {
+        hostname: 'registry.npmjs.org',
+        path: `/${packageJson.default.name}`,
+        method: 'GET',
+        headers: {
+          'User-Agent': 'cloco'
+        }
+      };
+
+      const req = https.request(options, (res) => {
+        let data = '';
+        res.on('data', (chunk) => { data += chunk; });
+        res.on('end', () => {
+          try {
+            const packageInfo = JSON.parse(data);
+            resolve(packageInfo['dist-tags']?.latest || null);
+          } catch (error) {
+            reject(error);
+          }
+        });
+      });
+
+      req.on('error', reject);
+      req.setTimeout(5000, () => {
+        req.destroy();
+        reject(new Error('请求超时'));
+      });
+      req.end();
+    });
+  } catch (error) {
+    console.error('无法检查更新:', error.message);
+    return null;
+  }
+}
+
+/**
+ * 比较版本号
+ */
+function compareVersions(current, latest) {
+  const currentParts = current.split('.').map(Number);
+  const latestParts = latest.split('.').map(Number);
+
+  for (let i = 0; i < Math.max(currentParts.length, latestParts.length); i++) {
+    const currentPart = currentParts[i] || 0;
+    const latestPart = latestParts[i] || 0;
+
+    if (currentPart < latestPart) return -1;
+    if (currentPart > latestPart) return 1;
+  }
+
+  return 0;
+}
+
+/**
+ * 升级命令主函数
+ */
+export default async function upgradeCommand(args, options) {
+  showInfo('检查更新...');
+
+  const currentVersion = getVersion();
+  const latestVersion = await checkLatestVersion();
+
+  if (!latestVersion) {
+    showTip('无法获取最新版本信息');
+    showInfo(`当前版本: ${currentVersion}`);
+    return;
+  }
+
+  console.log(`✅ 当前版本: ${currentVersion}`);
+  console.log(`📦 最新版本: ${latestVersion}`);
+
+  const comparison = compareVersions(currentVersion, latestVersion);
+
+  if (comparison < 0) {
+    console.log('\n💡 有新版本可用！');
+    showTip('运行以下命令更新:');
+    console.log('   npm update -g closer-code');
+    console.log('\n   或查看更新日志:');
+    console.log(`   https://github.com/your-repo/closer-code/releases/tag/v${latestVersion}`);
+  } else if (comparison === 0) {
+    showSuccess('您正在使用最新版本！');
+  } else {
+    showInfo('您正在使用开发版本，比发布版本更新');
+  }
+}