@winspan/claude-forge 8.51.1 → 8.54.3

package/src/cli/commands/mcp.ts

@@ -1,242 +0,0 @@
-/**
- * cf mcp — MCP server 注册与管理命令
- *
- * 子命令：
- *   cf mcp status       — 检查 MCP server 是否已注册到 Claude Code
- *   cf mcp register     — 向 Claude Code 注册 claude-forge MCP server（user scope）
- *   cf mcp unregister   — 从 Claude Code 移除注册
- *
- * 实现要点：
- *   - claude mcp 配置存储在 ~/.claude.json（而非 ~/.claude/settings.json）
- *   - HTTP transport 必须显式 `--transport http`，不能用 `--url`
- *   - 默认注册到 user scope (`-s user`)，让所有项目都能用
- *   - 必须把 daemon token 作为 `Authorization: Bearer ...` header 传入，
- *     否则 MCP 调用会被 401 拦截
- */
-
-import { Command } from 'commander';
-import { execSync } from 'node:child_process';
-import { existsSync, readFileSync } from 'node:fs';
-import chalk from 'chalk';
-import { ConfigManager } from '../../core/config.js';
-import { DEFAULTS, FORGE_PATHS } from '../../core/constants.js';
-
-const SERVER_NAME = 'claude-forge';
-const SCOPE = 'user'; // user scope: 全局可用
-
-/**
- * 检查 Claude Code 是否已安装（通过检查 claude CLI 是否存在）
- */
-export function isClaudeCodeInstalled(): boolean {
-  try {
-    execSync('command -v claude', { stdio: 'ignore' });
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-/**
- * 读取 daemon token（如果存在）
- */
-function readDaemonToken(): string | null {
-  const tokenPath = FORGE_PATHS.daemonToken();
-  if (!existsSync(tokenPath)) return null;
-  try {
-    return readFileSync(tokenPath, 'utf-8').trim() || null;
-  } catch {
-    return null;
-  }
-}
-
-/**
- * 检查 claude-forge MCP server 是否已注册
- *
- * 通过 `claude mcp get <name>` 退出码判断：成功 = 已注册
- */
-export function isMcpRegistered(): { registered: boolean; url?: string } {
-  try {
-    const output = execSync(`claude mcp get ${SERVER_NAME}`, {
-      stdio: ['ignore', 'pipe', 'ignore'],
-      encoding: 'utf-8',
-    });
-    // 从输出中尝试提取 URL（容错，匹配失败也认为已注册）
-    const urlMatch = output.match(/URL:\s*(\S+)/i);
-    return { registered: true, url: urlMatch?.[1] };
-  } catch {
-    return { registered: false };
-  }
-}
-
-/**
- * 获取 daemon 的 MCP server URL
- */
-export function getMcpServerUrl(): string {
-  const config = new ConfigManager().get();
-  const port = config.web.port ?? DEFAULTS.WEB_PORT;
-  return `http://127.0.0.1:${port}/mcp`;
-}
-
-/**
- * 是否处于 daemon 运行中（通过 pid 文件存在性判断，松散探测）
- */
-function isDaemonRunning(): boolean {
-  return existsSync(FORGE_PATHS.daemonPid());
-}
-
-/**
- * cf mcp status
- */
-export function statusCommand(): void {
-  console.log(chalk.bold('🔍 MCP Server Status\n'));
-
-  // 1. 检查 Claude Code 是否安装
-  const claudeInstalled = isClaudeCodeInstalled();
-  console.log(
-    claudeInstalled
-      ? chalk.green('✓ Claude Code CLI installed')
-      : chalk.red('✗ Claude Code CLI not found (install from claude.ai/code)'),
-  );
-
-  if (!claudeInstalled) {
-    console.log(chalk.dim('\n  Cannot check registration without Claude Code CLI.'));
-    return;
-  }
-
-  // 2. 检查 MCP server 是否注册
-  const { registered, url } = isMcpRegistered();
-  if (registered) {
-    console.log(chalk.green(`✓ MCP server registered${url ? `: ${url}` : ''}`));
-  } else {
-    console.log(chalk.yellow('⚠ MCP server not registered'));
-    console.log(chalk.dim('  Run `cf mcp register` to register'));
-  }
-
-  // 3. 检查 daemon 是否运行
-  console.log(
-    isDaemonRunning()
-      ? chalk.green('✓ Daemon running')
-      : chalk.yellow('⚠ Daemon not running (start with `cf daemon start`)'),
-  );
-
-  // 4. 检查 daemon token
-  const token = readDaemonToken();
-  console.log(
-    token
-      ? chalk.green('✓ Daemon token present')
-      : chalk.yellow('⚠ Daemon token missing (start daemon at least once)'),
-  );
-
-  // 5. 显示预期的 MCP URL
-  console.log(chalk.dim(`\nExpected MCP URL: ${getMcpServerUrl()}`));
-  console.log(chalk.dim(`Scope: ${SCOPE} (available in all projects)`));
-}
-
-/**
- * cf mcp register
- */
-export function registerCommand(): void {
-  console.log(chalk.bold('📡 Registering MCP Server\n'));
-
-  // 1. 检查 Claude Code CLI
-  if (!isClaudeCodeInstalled()) {
-    console.error(chalk.red('✗ Claude Code CLI not found'));
-    console.error(chalk.dim('  Install from https://claude.ai/code'));
-    process.exit(1);
-  }
-
-  // 2. 检查是否已注册
-  const { registered, url: existingUrl } = isMcpRegistered();
-  if (registered) {
-    console.log(chalk.yellow(`⚠ MCP server already registered${existingUrl ? `: ${existingUrl}` : ''}`));
-    console.log(chalk.dim('  Run `cf mcp unregister` first if you want to re-register'));
-    return;
-  }
-
-  // 3. 读取 daemon token（必需，否则 MCP 调用会 401）
-  const token = readDaemonToken();
-  if (!token) {
-    console.error(chalk.red('✗ Daemon token not found'));
-    console.error(chalk.dim('  Start daemon at least once: cf daemon start'));
-    console.error(chalk.dim('  This generates ~/.claude-forge/daemon.token'));
-    process.exit(1);
-  }
-
-  // 4. 获取 MCP URL
-  const mcpUrl = getMcpServerUrl();
-
-  // 5. 执行注册命令
-  // claude mcp add --transport http -s user claude-forge <url> -H "Authorization: Bearer <token>"
-  console.log(chalk.dim(`Registering: ${mcpUrl}`));
-  console.log(chalk.dim(`Scope: ${SCOPE} (all projects)`));
-  console.log(chalk.dim(`Token: <hidden>\n`));
-
-  try {
-    execSync(
-      `claude mcp add --transport http -s ${SCOPE} ${SERVER_NAME} "${mcpUrl}" -H "Authorization: Bearer ${token}"`,
-      { stdio: 'inherit' },
-    );
-    console.log(chalk.green('\n✓ MCP server registered successfully'));
-    console.log(chalk.dim('  Restart Claude Code (or open a new session) to apply'));
-  } catch (err) {
-    console.error(chalk.red('\n✗ Registration failed'));
-    if (err instanceof Error) {
-      console.error(chalk.dim(err.message));
-    }
-    process.exit(1);
-  }
-}
-
-/**
- * cf mcp unregister
- */
-export function unregisterCommand(): void {
-  console.log(chalk.bold('🗑️  Unregistering MCP Server\n'));
-
-  if (!isClaudeCodeInstalled()) {
-    console.error(chalk.red('✗ Claude Code CLI not found'));
-    process.exit(1);
-  }
-
-  const { registered } = isMcpRegistered();
-  if (!registered) {
-    console.log(chalk.yellow('⚠ MCP server not registered'));
-    return;
-  }
-
-  try {
-    execSync(`claude mcp remove -s ${SCOPE} ${SERVER_NAME}`, { stdio: 'inherit' });
-    console.log(chalk.green('\n✓ MCP server unregistered'));
-  } catch (err) {
-    console.error(chalk.red('\n✗ Unregister failed'));
-    if (err instanceof Error) {
-      console.error(chalk.dim(err.message));
-    }
-    process.exit(1);
-  }
-}
-
-/**
- * 注册 cf mcp 命令组
- */
-export function register(program: Command): void {
-  const mcp = program
-    .command('mcp')
-    .description('MCP server registration and management');
-
-  mcp
-    .command('status')
-    .description('Check MCP server registration status')
-    .action(statusCommand);
-
-  mcp
-    .command('register')
-    .description('Register claude-forge MCP server with Claude Code (user scope)')
-    .action(registerCommand);
-
-  mcp
-    .command('unregister')
-    .alias('remove')
-    .description('Unregister claude-forge MCP server from Claude Code')
-    .action(unregisterCommand);
-}

package/src/cli/commands/menu.ts

@@ -1,357 +0,0 @@
-import readline from 'readline';
-import { spawn } from 'child_process';
-import { createRequire } from 'module';
-import type { Command } from 'commander';
-import { DEFAULTS } from '../../core/constants.js';
-
-const require = createRequire(import.meta.url);
-const { version } = require('../../../package.json') as { version: string };
-
-export function registerMenuCommand(program: Command): void {
-  program
-    .command('menu')
-    .description('Interactive menu for common operations')
-    .action(async () => {
-      await showMainMenu();
-    });
-}
-
-async function showMainMenu(): Promise<void> {
-  console.clear();
-  console.log('\x1b[36m╔════════════════════════════════════════╗\x1b[0m');
-  console.log(`\x1b[36m║  Claude Forge v${version.padEnd(24)}║\x1b[0m`);
-  console.log('\x1b[36m╚════════════════════════════════════════╝\x1b[0m\n');
-
-  console.log('  \x1b[33m[1]\x1b[0m 🚀 运行与状态');
-  console.log('  \x1b[33m[2]\x1b[0m 📊 会话与日志');
-  console.log('  \x1b[33m[3]\x1b[0m ⚙️  项目治理');
-  console.log('  \x1b[33m[4]\x1b[0m 🤖 AI 配置');
-  console.log('  \x1b[33m[5]\x1b[0m 📡 MCP Server');
-  console.log('');
-  console.log('  \x1b[33m[0]\x1b[0m 退出\n');
-
-  const choice = await prompt('请选择');
-
-  switch (choice) {
-    case '1': await showRuntimeMenu(); break;
-    case '2': await showSessionMenu(); break;
-    case '3': await showGovernanceMenu(); break;
-    case '4': await showAIConfigMenu(); break;
-    case '5': await showMcpMenu(); break;
-    case '0': process.exit(0);
-    default:
-      console.log('\x1b[31m无效选择\x1b[0m');
-      await waitForKey();
-  }
-  await showMainMenu();
-}
-
-async function showRuntimeMenu(): Promise<void> {
-  console.clear();
-  console.log('\x1b[36m═══ 🚀 运行与状态 ═══\x1b[0m\n');
-  console.log('  \x1b[33m[1]\x1b[0m 启动 daemon');
-  console.log('  \x1b[33m[2]\x1b[0m 停止 daemon');
-  console.log('  \x1b[33m[3]\x1b[0m 查看状态');
-  console.log('  \x1b[33m[4]\x1b[0m 打开 Web Dashboard');
-  console.log('');
-  console.log('  \x1b[33m[0]\x1b[0m 返回\n');
-
-  const choice = await prompt('请选择');
-  switch (choice) {
-    case '1': await runCommand('daemon', ['start']); await waitForKey(); break;
-    case '2': await runCommand('daemon', ['stop']); await waitForKey(); break;
-    case '3': await runCommand('status', []); await waitForKey(); break;
-    case '4': openDashboard(); await waitForKey(); break;
-    case '0': return;
-    default: console.log('\x1b[31m无效选择\x1b[0m'); await waitForKey();
-  }
-  await showRuntimeMenu();
-}
-
-async function showSessionMenu(): Promise<void> {
-  console.clear();
-  console.log('\x1b[36m═══ 📊 会话与日志 ═══\x1b[0m\n');
-  console.log('  \x1b[33m[1]\x1b[0m 最近会话（按会话分组）');
-  console.log('  \x1b[33m[2]\x1b[0m 最近事件（平铺）');
-  console.log('  \x1b[33m[3]\x1b[0m 查看注入历史');
-  console.log('  \x1b[33m[4]\x1b[0m 实时跟踪（follow）');
-  console.log('');
-  console.log('  \x1b[33m[0]\x1b[0m 返回\n');
-
-  const choice = await prompt('请选择');
-  switch (choice) {
-    case '1': await runCommand('logs', ['-n', '20']); await waitForKey(); break;
-    case '2': await runCommand('logs', ['--flat', '-n', '50']); await waitForKey(); break;
-    case '3': await runCommand('logs', ['--injections', '-n', '10']); await waitForKey(); break;
-    case '4': await runCommand('logs', ['--follow']); break;
-    case '0': return;
-    default: console.log('\x1b[31m无效选择\x1b[0m'); await waitForKey();
-  }
-  await showSessionMenu();
-}
-
-async function showGovernanceMenu(): Promise<void> {
-  console.clear();
-  console.log('\x1b[36m═══ ⚙️  项目治理 ═══\x1b[0m\n');
-  console.log('  \x1b[33m[1]\x1b[0m 管理 CLAUDE.md');
-  console.log('  \x1b[33m[2]\x1b[0m 查看技能列表');
-  console.log('  \x1b[33m[3]\x1b[0m 查看配置');
-  console.log('  \x1b[33m[4]\x1b[0m 初始化项目');
-  console.log('');
-  console.log('  \x1b[33m[0]\x1b[0m 返回\n');
-
-  const choice = await prompt('请选择');
-  switch (choice) {
-    case '1': await runCommand('claudemd', ['--help']); await waitForKey(); break;
-    case '2': await runCommand('skills', ['list']); await waitForKey(); break;
-    case '3': await runCommand('config', ['show']); await waitForKey(); break;
-    case '4': await runCommand('init', []); await waitForKey(); break;
-    case '0': return;
-    default: console.log('\x1b[31m无效选择\x1b[0m'); await waitForKey();
-  }
-  await showGovernanceMenu();
-}
-
-function runCommand(cmd: string, args: string[]): Promise<void> {
-  return new Promise((resolve) => {
-    console.log(`\n\x1b[90m$ cf ${cmd} ${args.join(' ')}\x1b[0m\n`);
-    const child = spawn('node', [process.argv[1], cmd, ...args], {
-      stdio: 'inherit',
-      cwd: process.cwd(),
-    });
-    child.on('close', () => resolve());
-  });
-}
-
-function openDashboard(): void {
-  console.log('\x1b[32m正在打开 Web Dashboard...\x1b[0m');
-  console.log(`访问: \x1b[36mhttp://localhost:${DEFAULTS.WEB_PORT}\x1b[0m\n`);
-  const open = process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'start' : 'xdg-open';
-  spawn(open, [`http://localhost:${DEFAULTS.WEB_PORT}`], { detached: true, stdio: 'ignore' }).unref();
-}
-
-function prompt(question: string): Promise<string> {
-  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-  return new Promise((resolve) => {
-    rl.question(`\x1b[32m${question}: \x1b[0m`, (answer) => {
-      rl.close();
-      resolve(answer.trim());
-    });
-  });
-}
-
-function waitForKey(): Promise<void> {
-  return new Promise((resolve) => {
-    console.log('\n\x1b[90m按任意键继续...\x1b[0m');
-    process.stdin.setRawMode(true);
-    process.stdin.resume();
-    process.stdin.once('data', () => {
-      process.stdin.setRawMode(false);
-      process.stdin.pause();
-      resolve();
-    });
-  });
-}
-
-async function showAIConfigMenu(): Promise<void> {
-  console.clear();
-  console.log('\x1b[36m═══ 🤖 AI 配置 ═══\x1b[0m\n');
-  console.log('  \x1b[33m[1]\x1b[0m 查看当前配置');
-  console.log('  \x1b[33m[2]\x1b[0m 设置 API Key');
-  console.log('  \x1b[33m[3]\x1b[0m 设置 Base URL');
-  console.log('  \x1b[33m[4]\x1b[0m 选择模型');
-  console.log('  \x1b[33m[5]\x1b[0m 测试连接');
-  console.log('');
-  console.log('  \x1b[33m[0]\x1b[0m 返回\n');
-
-  const choice = await prompt('请选择');
-  switch (choice) {
-    case '1': await showCurrentAIConfig(); await waitForKey(); break;
-    case '2': await setAPIKey(); await waitForKey(); break;
-    case '3': await setBaseURL(); await waitForKey(); break;
-    case '4': await selectModel(); await waitForKey(); break;
-    case '5': await testConnection(); await waitForKey(); break;
-    case '0': return;
-    default: console.log('\x1b[31m无效选择\x1b[0m'); await waitForKey();
-  }
-  await showAIConfigMenu();
-}
-
-async function showCurrentAIConfig(): Promise<void> {
-  try {
-    const { ConfigManager } = await import('../../core/config.js');
-    const { FORGE_PATHS } = await import('../../core/constants.js');
-    const configManager = new ConfigManager();
-    const config = configManager.get();
-
-    const maskApiKey = (key: string): string => {
-      if (!key || key.length < 10) return '(未设置)';
-      return key.slice(0, 6) + '***' + key.slice(-4);
-    };
-
-    console.log('\n\x1b[36m当前 AI 配置：\x1b[0m');
-    console.log(`  API Key:   ${maskApiKey(config.ai.api_key)}`);
-    console.log(`  Base URL:  ${config.ai.base_url || '(未设置)'}`);
-    console.log(`  Model:     ${config.ai.model}`);
-    console.log(`  Provider:  ${config.ai.provider}`);
-    console.log(`\n配置文件: ${FORGE_PATHS.config()}`);
-  } catch (err) {
-    console.log(`\x1b[31m读取配置失败: ${err}\x1b[0m`);
-  }
-}
-
-async function setAPIKey(): Promise<void> {
-  try {
-    const apiKey = await prompt('请输入 API Key');
-    if (!apiKey) {
-      console.log('\x1b[31mAPI Key 不能为空\x1b[0m');
-      return;
-    }
-
-    const { ConfigManager } = await import('../../core/config.js');
-    const configManager = new ConfigManager();
-    const config = configManager.get();
-    config.ai.api_key = apiKey;
-    configManager.save();
-
-    console.log('\x1b[32m✓ API Key 已保存\x1b[0m');
-    console.log('\x1b[90m提示: 重启 daemon 后生效\x1b[0m');
-  } catch (err) {
-    console.log(`\x1b[31m保存失败: ${err}\x1b[0m`);
-  }
-}
-
-async function setBaseURL(): Promise<void> {
-  try {
-    const baseUrl = await prompt('请输入 Base URL (留空使用默认)');
-
-    const { ConfigManager } = await import('../../core/config.js');
-    const configManager = new ConfigManager();
-    const config = configManager.get();
-    config.ai.base_url = baseUrl || undefined;
-    configManager.save();
-
-    console.log('\x1b[32m✓ Base URL 已保存\x1b[0m');
-    console.log('\x1b[90m提示: 重启 daemon 后生效\x1b[0m');
-  } catch (err) {
-    console.log(`\x1b[31m保存失败: ${err}\x1b[0m`);
-  }
-}
-
-async function selectModel(): Promise<void> {
-  try {
-    console.log('\n\x1b[36m正在获取模型列表...\x1b[0m');
-
-    const response = await fetch(`http://localhost:${DEFAULTS.WEB_PORT}/api/ai/models`);
-    if (!response.ok) {
-      const text = await response.text();
-      console.log(`\x1b[31m获取模型列表失败: ${text}\x1b[0m`);
-      console.log('\x1b[90m提示: 请先配置 API Key 和 Base URL，并确保 daemon 正在运行\x1b[0m');
-      return;
-    }
-
-    const data = await response.json() as { data?: Array<{ id: string }> };
-    const models = data.data || [];
-
-    if (models.length === 0) {
-      console.log('\x1b[31m未找到可用模型\x1b[0m');
-      return;
-    }
-
-    console.log('\n\x1b[36m可用模型：\x1b[0m');
-    models.forEach((m, i) => {
-      console.log(`  \x1b[33m[${i + 1}]\x1b[0m ${m.id}`);
-    });
-    console.log('  \x1b[33m[0]\x1b[0m 取消\n');
-
-    const choice = await prompt('请选择模型');
-    const idx = parseInt(choice) - 1;
-
-    if (choice === '0') return;
-    if (idx < 0 || idx >= models.length) {
-      console.log('\x1b[31m无效选择\x1b[0m');
-      return;
-    }
-
-    const selectedModel = models[idx].id;
-    const { ConfigManager } = await import('../../core/config.js');
-    const configManager = new ConfigManager();
-    const config = configManager.get();
-    config.ai.model = selectedModel;
-    configManager.save();
-
-    console.log(`\x1b[32m✓ 已选择模型: ${selectedModel}\x1b[0m`);
-    console.log('\x1b[90m提示: 重启 daemon 后生效\x1b[0m');
-  } catch (err) {
-    console.log(`\x1b[31m操作失败: ${err}\x1b[0m`);
-  }
-}
-
-async function testConnection(): Promise<void> {
-  try {
-    console.log('\n\x1b[36m正在测试连接...\x1b[0m');
-
-    const { ConfigManager } = await import('../../core/config.js');
-    const configManager = new ConfigManager();
-    const config = configManager.get();
-
-    const apiKey = config.ai.api_key;
-    const baseUrl = config.ai.base_url || 'https://api.anthropic.com';
-    const model = config.ai.model;
-
-    if (!apiKey) {
-      console.log('\x1b[31m请先配置 API Key\x1b[0m');
-      return;
-    }
-
-    const messagesUrl = baseUrl.endsWith('/v1')
-      ? `${baseUrl}/messages`
-      : `${baseUrl}/v1/messages`;
-
-    const response = await fetch(messagesUrl, {
-      method: 'POST',
-      headers: {
-        'Content-Type': 'application/json',
-        'x-api-key': apiKey,
-        'anthropic-version': '2023-06-01',
-      },
-      body: JSON.stringify({
-        model,
-        max_tokens: 10,
-        messages: [{ role: 'user', content: 'ping' }],
-      }),
-    });
-
-    if (!response.ok) {
-      const text = await response.text();
-      console.log(`\x1b[31m连接失败: ${response.status} ${text}\x1b[0m`);
-      return;
-    }
-
-    const data = await response.json() as { model?: string };
-    console.log(`\x1b[32m✓ 连接成功！\x1b[0m`);
-    console.log(`  模型: ${data.model || model}`);
-  } catch (err) {
-    console.log(`\x1b[31m测试失败: ${err}\x1b[0m`);
-  }
-}
-
-async function showMcpMenu(): Promise<void> {
-  console.clear();
-  console.log('\x1b[36m═══ 📡 MCP Server ═══\x1b[0m\n');
-  console.log('  \x1b[33m[1]\x1b[0m 查看状态');
-  console.log('  \x1b[33m[2]\x1b[0m 注册到 Claude Code');
-  console.log('  \x1b[33m[3]\x1b[0m 取消注册');
-  console.log('');
-  console.log('  \x1b[33m[0]\x1b[0m 返回\n');
-
-  const choice = await prompt('请选择');
-  switch (choice) {
-    case '1': await runCommand('mcp', ['status']); await waitForKey(); break;
-    case '2': await runCommand('mcp', ['register']); await waitForKey(); break;
-    case '3': await runCommand('mcp', ['unregister']); await waitForKey(); break;
-    case '0': return;
-    default: console.log('\x1b[31m无效选择\x1b[0m'); await waitForKey();
-  }
-  await showMcpMenu();
-}