@winspan/claude-forge 8.41.0 → 8.51.0

package/src/cli/commands/mcp.ts

@@ -0,0 +1,242 @@
+/**
+ * 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

@@ -0,0 +1,357 @@
+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();
+}