@winspan/claude-forge 8.41.0 → 8.50.6

package/src/cli/commands/init.ts

@@ -0,0 +1,204 @@
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import readline from 'readline';
+import type { Command } from 'commander';
+import { FORGE_HOME, FORGE_PATHS } from '../../core/constants.js';
+import { copyHookScripts, backupSettings, injectHooks } from '../init/hook-manager.js';
+import chalk from 'chalk';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+// Fallback if the upstream /v1/models probe fails — keep this in sync with the
+// latest GA opus family release. Bump when Anthropic ships a newer opus.
+const FALLBACK_MODEL = 'claude-opus-4-7';
+
+function prompt(question: string): Promise<string> {
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+  return new Promise((resolve) => {
+    rl.question(question, (answer) => {
+      rl.close();
+      resolve(answer.trim());
+    });
+  });
+}
+
+function rankOpusId(id: string): [number, number, number] | null {
+  // Recognise ids like claude-opus-4-7, claude-opus-4-7-20260101, claude-3-opus-20240229.
+  // Return a tuple that sorts highest-first: [major, minor, dateInt].
+  const newStyle = /^claude-opus-(\d+)-(\d+)(?:-(\d{8}))?$/.exec(id);
+  if (newStyle) {
+    const major = parseInt(newStyle[1], 10);
+    const minor = parseInt(newStyle[2], 10);
+    const date = newStyle[3] ? parseInt(newStyle[3], 10) : 0;
+    return [major, minor, date];
+  }
+  // Legacy `claude-3-opus-YYYYMMDD` gets mapped to (3, 0, date) so it ranks below the 4.x family.
+  const legacy = /^claude-(\d+)-opus(?:-(\d{8}))?$/.exec(id);
+  if (legacy) {
+    return [parseInt(legacy[1], 10), 0, legacy[2] ? parseInt(legacy[2], 10) : 0];
+  }
+  return null;
+}
+
+async function pickDefaultModel(apiKey: string, baseUrl: string): Promise<string> {
+  if (!apiKey) return FALLBACK_MODEL;
+
+  const modelsUrl = baseUrl.endsWith('/v1')
+    ? `${baseUrl}/models`
+    : `${baseUrl.replace(/\/$/, '')}/v1/models`;
+
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), 5000);
+  try {
+    const res = await fetch(modelsUrl, {
+      redirect: 'follow',
+      signal: controller.signal,
+      headers: {
+        'Authorization': `Bearer ${apiKey}`,
+        'x-api-key': apiKey,
+      },
+    });
+    if (!res.ok) return FALLBACK_MODEL;
+    const payload = (await res.json()) as { data?: Array<{ id?: string }> };
+    const ids = (payload.data ?? []).map((m) => m.id).filter((id): id is string => typeof id === 'string');
+
+    const ranked = ids
+      .map((id) => ({ id, rank: rankOpusId(id) }))
+      .filter((x): x is { id: string; rank: [number, number, number] } => x.rank !== null)
+      .sort((a, b) => {
+        for (let i = 0; i < 3; i++) {
+          if (a.rank[i] !== b.rank[i]) return b.rank[i] - a.rank[i];
+        }
+        return 0;
+      });
+
+    return ranked[0]?.id ?? FALLBACK_MODEL;
+  } catch {
+    return FALLBACK_MODEL;
+  } finally {
+    clearTimeout(timer);
+  }
+}
+
+export function register(program: Command): void {
+  program
+    .command('init')
+    .description('Initialize Claude Forge hooks and configuration')
+    .option('--skip-prompts', 'Skip interactive prompts and use defaults')
+    .action(async (opts) => {
+      console.log(chalk.bold.cyan('\n🔧 Claude Forge 初始化向导\n'));
+
+      const skipPrompts = opts.skipPrompts;
+      // 1. Create ~/.claude-forge/ directory
+      if (!fs.existsSync(FORGE_HOME)) {
+        fs.mkdirSync(FORGE_HOME, { recursive: true });
+        console.log(chalk.green('✓'), 'Created', FORGE_HOME);
+      } else {
+        console.log(chalk.gray('→'), FORGE_HOME, 'already exists');
+      }
+
+      // 2. Interactive configuration
+      let apiKey = process.env.ANTHROPIC_API_KEY || '';
+      let baseUrl = 'https://api.anthropic.com';
+      let webPort = 3721;
+
+      if (!skipPrompts) {
+        console.log(chalk.yellow('\n📝 配置选项（直接回车使用默认值）\n'));
+
+        const apiKeyInput = await prompt(
+          `Anthropic API Key (可选，用于 AI 功能) [${apiKey ? '已设置' : '留空'}]: `
+        );
+        if (apiKeyInput) apiKey = apiKeyInput;
+
+        const baseUrlInput = await prompt(`API Base URL [${baseUrl}]: `);
+        if (baseUrlInput) baseUrl = baseUrlInput;
+        if (baseUrl.startsWith('http://')) {
+          baseUrl = 'https://' + baseUrl.slice('http://'.length);
+        }
+
+        const portInput = await prompt(`Web 管理后台端口 [${webPort}]: `);
+        if (portInput && !isNaN(parseInt(portInput))) {
+          webPort = parseInt(portInput);
+        }
+      }
+
+      // 2b. Resolve default model: try upstream /v1/models, fall back to a recent default
+      if (apiKey) {
+        process.stdout.write(chalk.gray('→ 正在从 ') + baseUrl + chalk.gray(' 获取最新模型...'));
+      }
+      const defaultModel = await pickDefaultModel(apiKey, baseUrl);
+      if (apiKey) {
+        process.stdout.write(
+          '\r' +
+            chalk.green('✓') +
+            ' 默认模型：' +
+            chalk.cyan(defaultModel) +
+            (defaultModel === FALLBACK_MODEL ? chalk.gray('（fallback，未联网拉取）') : '') +
+            '                    \n',
+        );
+      }
+
+      // 3. Generate config.yaml
+      const configPath = FORGE_PATHS.config();
+      const configContent = `# Claude Forge 配置文件
+# 生成时间: ${new Date().toISOString()}
+
+# AI 服务配置（用于 CLAUDE.md 生成、Skill 语义匹配、Patch 建议）
+ai:
+  api_key: ${apiKey ? `"${apiKey}"` : '""  # 留空则禁用 AI 功能'}
+  model: "${defaultModel}"
+  base_url: "${baseUrl}"
+
+# Web 管理后台
+web:
+  enabled: true
+  port: ${webPort}
+
+# 数据存储
+storage:
+  path: "~/.claude-forge/data.db"
+
+# 技能匹配（可选，使用 AI 语义匹配）
+skill_matching:
+  api_key: ${apiKey ? `"${apiKey}"` : '""  # 留空则使用关键词匹配'}
+`;
+
+      fs.writeFileSync(configPath, configContent, 'utf-8');
+      console.log(chalk.green('\n✓'), 'Created config:', configPath);
+
+      // 4. Copy hook scripts
+      copyHookScripts();
+      console.log(chalk.green('✓'), 'Hook scripts installed');
+
+      // 5. Backup settings.json
+      const bp = backupSettings();
+      if (bp) {
+        console.log(chalk.green('✓'), 'Settings backed up to', bp);
+      }
+
+      // 7. Inject hooks into Claude Code settings
+      injectHooks();
+      console.log(chalk.green('✓'), 'Hooks injected into Claude Code settings');
+
+      // 8. Summary
+      console.log(chalk.bold.green('\n✅ Claude Forge 初始化成功！\n'));
+      console.log(chalk.yellow('下一步：'));
+      console.log('  1. 重启 Claude Code 使 hooks 生效');
+      console.log('  2. 启动守护进程：claude-forge daemon start');
+      console.log('  3. 访问管理后台：http://localhost:' + webPort);
+
+      // 8b. 提示用户注册 MCP（可选步骤）
+      console.log(chalk.bold('\n📡 可选：注册 MCP Server'));
+      console.log(chalk.dim('  启用 Agent 动态调用 Skill 功能，运行：'));
+      console.log(chalk.cyan('  cf mcp register\n'));
+
+      if (!apiKey) {
+        console.log(chalk.gray('💡 提示：未配置 API Key，AI 功能（分类器、质量检查）将被禁用'));
+        console.log(chalk.gray('   如需启用，请编辑：' + configPath));
+      }
+    });
+}

package/src/cli/commands/logs.ts

@@ -0,0 +1,181 @@
+import type { Command } from 'commander';
+import { SQLiteStorage, type SessionSummary, type Injection } from '../../core/storage/sqlite.js';
+import { ConfigManager } from '../../core/config.js';
+import { expandPath } from '../../core/utils/path.js';
+import { existsSync } from 'node:fs';
+import type { ForgeEvent } from '../../core/types.js';
+
+function toLocal(ts: string): Date {
+  return new Date(ts.endsWith('Z') ? ts : ts + 'Z');
+}
+
+function fmtTime(ts: string): string {
+  const d = toLocal(ts);
+  return d.toLocaleTimeString('zh-CN', { hour: '2-digit', minute: '2-digit', second: '2-digit', hour12: false });
+}
+
+function fmtDateTime(ts: string): string {
+  const d = toLocal(ts);
+  return d.toLocaleString('zh-CN', {
+    month: '2-digit', day: '2-digit',
+    hour: '2-digit', minute: '2-digit',
+    hour12: false,
+  });
+}
+
+function formatEventFlat(e: ForgeEvent): string {
+  const time = fmtDateTime(e.timestamp);
+  const hook = e.hook_type.padEnd(16);
+  const tool = (e.tool_name ?? '').padEnd(8);
+  return `[${time}] ${hook}| ${tool}| ${extractDetail(e)}`;
+}
+
+function formatEventGrouped(e: ForgeEvent): string {
+  const time = fmtTime(e.timestamp);
+  const hook = e.hook_type.padEnd(16);
+  const tool = (e.tool_name ?? '').padEnd(8);
+  return `  [${time}] ${hook}| ${tool}| ${extractDetail(e)}`;
+}
+
+function extractDetail(e: ForgeEvent): string {
+  if (e.user_prompt) return e.user_prompt.slice(0, 80);
+  if (!e.tool_input) return '';
+  const input = e.tool_input as Record<string, unknown>;
+  if (input.command) return String(input.command).slice(0, 80);
+  if (input.file_path) return String(input.file_path);
+  return JSON.stringify(input).slice(0, 80);
+}
+
+export function register(program: Command): void {
+  program
+    .command('logs')
+    .description('View Claude Code execution logs')
+    .option('-f, --follow', 'Follow new events in real-time')
+    .option('-n, --limit <n>', 'Number of events to show', '50')
+    .option('-s, --session <id>', 'Filter by session ID')
+    .option('-p, --project <path>', 'Filter by project path')
+    .option('-t, --hook <type>', 'Filter by hook type')
+    .option('--flat', 'Flat output (no session grouping)')
+    .option('--injections', 'Show injection content')
+    .action(async (opts) => {
+      const config = new ConfigManager().get();
+      const dbPath = expandPath(config.storage.path);
+      if (!existsSync(dbPath)) {
+        console.error('Database not found. Is the daemon running?');
+        process.exit(1);
+      }
+
+      const storage = new SQLiteStorage(dbPath);
+      const limit = Math.min(parseInt(opts.limit, 10) || 50, 500);
+
+      if (opts.flat || opts.session) {
+        showFlat(storage, opts, limit);
+      } else {
+        showGrouped(storage, opts, limit);
+      }
+
+      if (!opts.follow) {
+        storage.close();
+        return;
+      }
+
+      console.log('\n--- following (Ctrl+C to stop) ---\n');
+
+      storage.on('event', (e: ForgeEvent) => {
+        const ok = (!opts.session || e.session_id === opts.session)
+          && (!opts.project || e.project_path === opts.project)
+          && (!opts.hook || e.hook_type === opts.hook);
+        if (ok) console.log(formatEventFlat(e));
+      });
+
+      let lastId: string | null = null;
+      const pollInterval = setInterval(() => {
+        const fresh = storage.queryEvents({ limit: 20 } as any);
+        fresh.reverse();
+        for (const e of fresh) {
+          if (lastId && e.event_id === lastId) break;
+          console.log(formatEventFlat(e));
+        }
+        if (fresh.length > 0) lastId = fresh[fresh.length - 1].event_id ?? lastId;
+      }, 1000);
+
+      process.on('SIGINT', () => {
+        clearInterval(pollInterval);
+        storage.close();
+        process.exit(0);
+      });
+    });
+}
+
+function showFlat(storage: SQLiteStorage, opts: any, limit: number): void {
+  const filter: Record<string, unknown> = { limit };
+  if (opts.session) filter.session_id = opts.session;
+  if (opts.project) filter.project_path = opts.project;
+  if (opts.hook) filter.hook_type = opts.hook;
+  const events = storage.queryEvents(filter as any);
+  events.reverse();
+  if (events.length === 0) { console.log('No events found.'); return; }
+  for (const e of events) console.log(formatEventFlat(e));
+}
+
+function showGrouped(storage: SQLiteStorage, opts: any, limit: number): void {
+  const sessions = storage.querySessions({
+    project_path: opts.project,
+    limit: Math.max(Math.ceil(limit / 10), 5),
+  });
+  if (sessions.length === 0) { console.log('No sessions found.'); return; }
+
+  const showInj = !!opts.injections;
+  const eventsPerSession = Math.min(Math.ceil(limit / sessions.length), 100);
+  for (const sess of sessions) {
+    printSessionHeader(sess);
+
+    if (showInj) {
+      const injections = storage.queryInjections({ session_id: sess.session_id, limit: 50 });
+      if (injections.length > 0) {
+        const injMap = new Map<string, Injection[]>();
+        for (const inj of injections) {
+          const key = inj.event_id ?? '__no_event__';
+          if (!injMap.has(key)) injMap.set(key, []);
+          injMap.get(key)!.push(inj);
+        }
+
+        const events = storage.queryEvents({ session_id: sess.session_id, limit: eventsPerSession } as any);
+        events.reverse();
+        for (const e of events) {
+          console.log(formatEventGrouped(e));
+          const eventInj = injMap.get(e.event_id ?? '') ?? [];
+          for (const inj of eventInj) {
+            printInjection(inj);
+          }
+        }
+      } else {
+        const events = storage.queryEvents({ session_id: sess.session_id, limit: eventsPerSession } as any);
+        events.reverse();
+        for (const e of events) console.log(formatEventGrouped(e));
+      }
+    } else {
+      const events = storage.queryEvents({ session_id: sess.session_id, limit: eventsPerSession } as any);
+      events.reverse();
+      for (const e of events) console.log(formatEventGrouped(e));
+    }
+    console.log('');
+  }
+}
+
+function printInjection(inj: Injection): void {
+  const icon = inj.injection_type === 'reason' ? '🚫' : '💉';
+  const preview = inj.content.slice(0, 120).replace(/\n/g, ' ');
+  console.log(`    ${icon} [${inj.source_handler}] ${inj.injection_type} (${inj.content.length} chars): ${preview}`);
+}
+
+function printSessionHeader(sess: SessionSummary): void {
+  const shortId = sess.session_id.slice(0, 8);
+  const start = fmtDateTime(sess.start_time);
+  const end = fmtTime(sess.end_time);
+  const prompt = sess.first_prompt
+    ? `"${sess.first_prompt.slice(0, 60)}${sess.first_prompt.length > 60 ? '...' : ''}"`
+    : '(无提示词)';
+  console.log(`━━ 会话 ${shortId} [${start} ~ ${end}] ${sess.event_count} events ━━`);
+  console.log(`   ${prompt}\n`);
+}

package/src/cli/commands/mcp.ts

@@ -0,0 +1,244 @@
+/**
+ * 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 { homedir } from 'node:os';
+import { join } from 'node:path';
+import chalk from 'chalk';
+import { ConfigManager } from '../../core/config.js';
+import { DEFAULTS } 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 = join(homedir(), '.claude-forge', 'daemon.token');
+  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(join(homedir(), '.claude-forge', 'daemon.pid'));
+}
+
+/**
+ * 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);
+}