@winspan/claude-forge 8.51.1 → 8.54.3

package/src/cli/commands/executions.ts

@@ -1,115 +0,0 @@
-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

@@ -1,204 +0,0 @@
-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

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