@winspan/claude-forge 8.41.0 → 8.51.0

package/src/cli/commands/executions.ts

@@ -0,0 +1,115 @@
+import type { Command } from 'commander';
+import fs from 'node:fs';
+import path from 'node:path';
+import { execSync } from 'node:child_process';
+import { resolveGitRoot } from '../../core/utils/git.js';
+
+export function registerExecutionsCommand(program: Command): void {
+  const cmd = program.command('executions').description('管理 Agent/Skill 执行文档');
+
+  // cf executions list — 列出所有执行文档
+  cmd
+    .command('list')
+    .description('列出所有执行文档')
+    .option('--limit <n>', '限制数量', '20')
+    .option('--date <date>', '按日期筛选（YYYY-MM-DD）')
+    .action(async (opts) => {
+      const baseDir = path.join(resolveGitRoot(), '.claude-forge', 'executions', 'by-route');
+      if (!fs.existsSync(baseDir)) {
+        console.log('暂无执行文档。请先触发 Agent/Skill 执行。');
+        return;
+      }
+      const limit = parseInt(opts.limit) || 20;
+
+      // 列出 route 目录，按 mtime 倒序
+      const routes = fs.readdirSync(baseDir, { withFileTypes: true })
+        .filter(d => d.isDirectory())
+        .map(d => ({
+          name: d.name,
+          mtime: fs.statSync(path.join(baseDir, d.name)).mtime,
+        }))
+        .sort((a, b) => b.mtime.getTime() - a.mtime.getTime())
+        .slice(0, limit);
+
+      console.log(`找到 ${routes.length} 个执行记录：\n`);
+      for (const r of routes) {
+        const overviewPath = path.join(baseDir, r.name, 'overview.md');
+        let summary = '(无 overview)';
+        if (fs.existsSync(overviewPath)) {
+          // 读 frontmatter 的 user_prompt 字段
+          const content = fs.readFileSync(overviewPath, 'utf-8').slice(0, 1000);
+          const m = content.match(/user_prompt:\s*["']?(.+?)["']?\n/);
+          if (m) summary = m[1].slice(0, 60);
+        }
+        const time = r.mtime.toISOString().slice(0, 19).replace('T', ' ');
+        console.log(`${time}  ${r.name.slice(0, 24)}  ${summary}`);
+      }
+    });
+
+  // cf executions open <route_id> — 用 IDE / 编辑器打开
+  cmd
+    .command('open <route_id>')
+    .description('打开指定执行的 overview 文档')
+    .action((routeId: string) => {
+      const baseDir = path.join(resolveGitRoot(), '.claude-forge', 'executions', 'by-route');
+      if (!fs.existsSync(baseDir)) {
+        console.error('执行文档目录不存在。');
+        process.exit(1);
+      }
+      // 模糊匹配
+      const dirs = fs.readdirSync(baseDir).filter(d => d.includes(routeId));
+      if (dirs.length === 0) {
+        console.error(`未找到匹配的执行记录：${routeId}`);
+        process.exit(1);
+      }
+      const target = path.join(baseDir, dirs[0], 'overview.md');
+      if (!fs.existsSync(target)) {
+        console.error(`overview.md 不存在：${target}`);
+        process.exit(1);
+      }
+      // 用系统默认编辑器或 cat
+      const editor = process.env.EDITOR || process.env.VISUAL;
+      if (editor) {
+        execSync(`${editor} "${target}"`, { stdio: 'inherit' });
+      } else {
+        console.log(fs.readFileSync(target, 'utf-8'));
+      }
+    });
+
+  // cf executions clean — 清理旧文档
+  cmd
+    .command('clean')
+    .description('清理超过指定天数的执行文档')
+    .option('--before <days>', '清理 N 天前的文档', '30')
+    .option('--dry-run', '只显示将删除的文件，不实际删除')
+    .action(async (opts) => {
+      const baseDir = path.join(resolveGitRoot(), '.claude-forge', 'executions', 'by-route');
+      if (!fs.existsSync(baseDir)) {
+        console.log('执行文档目录不存在，无需清理。');
+        return;
+      }
+      const days = parseInt(opts.before) || 30;
+      const cutoff = Date.now() - days * 24 * 60 * 60 * 1000;
+      const toDelete: string[] = [];
+
+      for (const d of fs.readdirSync(baseDir, { withFileTypes: true })) {
+        if (!d.isDirectory()) continue;
+        const dirPath = path.join(baseDir, d.name);
+        const stat = fs.statSync(dirPath);
+        if (stat.mtime.getTime() < cutoff) {
+          toDelete.push(dirPath);
+        }
+      }
+
+      console.log(`将删除 ${toDelete.length} 个超过 ${days} 天的执行记录${opts.dryRun ? '（dry-run，不实际删除）' : ''}:`);
+      for (const p of toDelete) {
+        console.log(`  - ${path.basename(p)}`);
+        if (!opts.dryRun) {
+          fs.rmSync(p, { recursive: true, force: true });
+        }
+      }
+      if (!opts.dryRun && toDelete.length > 0) {
+        console.log(`已清理 ${toDelete.length} 个目录。`);
+      }
+    });
+}

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, DEFAULTS } 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: number = DEFAULTS.WEB_PORT;
+
+      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;
+  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`);
+}