autosnippet 3.2.9 → 3.2.11

package/scripts/install-vscode-copilot.js

@@ -1,333 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * AutoSnippet VSCode Copilot 安装脚本
- *
- * 功能：
- * 1. 自动配置 VSCode 全局和工作区 settings.json
- * 2. 创建推荐扩展配置 (.vscode/extensions.json)
- * 3. 生成或更新项目指令 (.github/copilot-instructions.md)
- * 4. 验证 MCP 服务器连接
- * 5. 提供快速启动指导
- *
- * 使用:
- *   node scripts/install-vscode-copilot.js [--path /path/to/project] [--global|--workspace]
- *   npm run install:vscode-copilot
- *
- * 选项:
- *   --path <path>      指定项目根目录（默认为 cwd）
- *   --global           仅配置全局 settings.json（~/.config/Code/User/settings.json）
- *   --workspace        仅配置工作区 settings.json（.vscode/settings.json）
- *   --skip-verify      跳过验证步骤
- *   --quiet            安静模式（无输出）
- */
-
-import { dirname } from 'node:path';
-import { fileURLToPath } from 'node:url';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-
-import fs from 'node:fs';
-import { createRequire } from 'node:module';
-import path from 'node:path';
-
-const require = createRequire(import.meta.url);
-
-const args = require('minimist')(process.argv.slice(2));
-const projectPath = args.path || args.p || process.cwd();
-
-// 检测是否在 AutoSnippet 仓库内执行
-const isAutoSnippetRepo =
-  fs.existsSync(path.join(projectPath, 'bin/mcp-server.js')) &&
-  fs.existsSync(path.join(projectPath, 'bin/asd')) &&
-  fs.existsSync(path.join(projectPath, 'package.json'));
-
-// 默认只做工作区配置，不做全局配置
-// 如果在 AutoSnippet 仓库内执行且未明确指定 --path，跳过所有配置
-const configWorkspace = !args.global && !isAutoSnippetRepo && (args.path || !isAutoSnippetRepo);
-const skipVerify = args['skip-verify'];
-const isQuiet = args.quiet || process.env.ASD_QUIET === 'true';
-
-// ============ 颜色定义 ============
-const colors = {
-  reset: '\x1b[0m',
-  green: '\x1b[32m',
-  yellow: '\x1b[33m',
-  blue: '\x1b[34m',
-  red: '\x1b[31m',
-};
-
-function log(msg, color = 'reset') {
-  if (!isQuiet) {
-  }
-}
-
-function error(msg) {
-  console.error(colors.red + msg + colors.reset);
-}
-
-// ============ 助手函数 ============
-
-function readJsonFile(filePath, defaultValue = {}) {
-  if (!fs.existsSync(filePath)) {
-    return defaultValue;
-  }
-  try {
-    const content = fs.readFileSync(filePath, 'utf8');
-    return JSON.parse(content);
-  } catch (e) {
-    log(`⚠️  无法解析 ${filePath}: ${e.message}`, 'yellow');
-    return defaultValue;
-  }
-}
-
-function writeJsonFile(filePath, data) {
-  try {
-    fs.mkdirSync(path.dirname(filePath), { recursive: true });
-    fs.writeFileSync(filePath, `${JSON.stringify(data, null, 2)}\n`, 'utf8');
-    return true;
-  } catch (e) {
-    error(`✗ 无法写入 ${filePath}: ${e.message}`);
-    return false;
-  }
-}
-
-// ============ 获取 MCP 服务器路径 ============
-
-function getMcpServerPath() {
-  const scriptPath = path.join(projectPath, 'bin/mcp-server.js');
-  if (!fs.existsSync(scriptPath)) {
-    error(`✗ MCP Server 不存在: ${scriptPath}`);
-    error(`  请确保在 AutoSnippet 项目目录下运行此脚本`);
-    process.exit(1);
-  }
-  return scriptPath;
-}
-
-// ============ 配置 VSCode settings.json ============
-
-function configureVSCodeSettings() {
-  log('\n📝 配置 VSCode MCP 设置...', 'blue');
-
-  if (isAutoSnippetRepo && !args.path) {
-    log('ℹ️  检测到在 AutoSnippet 仓库内执行，仅配置全局设置', 'yellow');
-    log('   如需为其他项目配置，请使用: --path /path/to/project', 'yellow');
-  }
-
-  const mcpServerPath = getMcpServerPath();
-  const mcpServerConfig = {
-    type: 'stdio',
-    command: 'node',
-    args: [mcpServerPath],
-    env: {
-      ASD_UI_URL: 'http://localhost:3000',
-    },
-  };
-
-  let configured = false;
-
-  // 工作区配置 → .vscode/mcp.json（新标准格式）
-  if (configWorkspace) {
-    const vscodeDir = path.join(projectPath, '.vscode');
-    const mcpConfigPath = path.join(vscodeDir, 'mcp.json');
-
-    let config = {};
-    if (fs.existsSync(mcpConfigPath)) {
-      try {
-        config = JSON.parse(fs.readFileSync(mcpConfigPath, 'utf8'));
-      } catch {
-        /* ignore */
-      }
-    }
-
-    if (!config.servers) {
-      config.servers = {};
-    }
-    config.servers.autosnippet = mcpServerConfig;
-
-    if (writeJsonFile(mcpConfigPath, config)) {
-      log(`✅ 工作区 MCP 配置完成: ${mcpConfigPath}`, 'green');
-      configured = true;
-    }
-  }
-
-  return configured;
-}
-
-// ============ 创建推荐扩展配置 ============
-
-function createExtensionsJson() {
-  log('\n📦 创建推荐扩展配置...', 'blue');
-
-  const extensionsPath = path.join(projectPath, '.vscode/extensions.json');
-  const extensions = {
-    recommendations: ['GitHub.copilot', 'GitHub.copilot-chat'],
-    unwantedRecommendations: [],
-  };
-
-  if (writeJsonFile(extensionsPath, extensions)) {
-    log(`✅ 扩展推荐配置完成: ${extensionsPath}`, 'green');
-    return true;
-  }
-  return false;
-}
-
-// ============ 生成项目指令 ============
-
-function createCopilotInstructions() {
-  log('\n📖 生成项目指令 (.github/copilot-instructions.md)...', 'blue');
-
-  const instructionsPath = path.join(projectPath, '.github/copilot-instructions.md');
-
-  // 检查是否已存在
-  if (fs.existsSync(instructionsPath)) {
-    log(`✓ 项目指令已存在，跳过创建`, 'yellow');
-    return true;
-  }
-
-  // 从模板文件读取内容
-  const templatePath = path.join(__dirname, '..', 'templates', 'copilot-instructions.md');
-  if (!fs.existsSync(templatePath)) {
-    error(`✗ 模板文件不存在: ${templatePath}`);
-    return false;
-  }
-
-  const instructions = fs.readFileSync(templatePath, 'utf8');
-
-  try {
-    fs.mkdirSync(path.dirname(instructionsPath), { recursive: true });
-    fs.writeFileSync(instructionsPath, instructions, 'utf8');
-    log(`✅ 项目指令生成完成: ${instructionsPath}`, 'green');
-    return true;
-  } catch (e) {
-    error(`✗ 生成项目指令失败: ${e.message}`);
-    return false;
-  }
-}
-
-// ============ 验证配置 ============
-
-function verifyConfiguration() {
-  if (skipVerify) {
-    return;
-  }
-
-  log('\n🔍 验证配置...', 'blue');
-
-  // 检查工作区 MCP 配置（.vscode/mcp.json）
-  if (configWorkspace) {
-    const mcpConfigPath = path.join(projectPath, '.vscode/mcp.json');
-    if (fs.existsSync(mcpConfigPath)) {
-      const config = readJsonFile(mcpConfigPath, {});
-      if (config.servers?.autosnippet) {
-        log(`✅ VSCode 工作区 MCP 配置验证成功 (.vscode/mcp.json)`, 'green');
-      } else {
-        log(`⚠️  .vscode/mcp.json 中未找到 autosnippet 服务器`, 'yellow');
-      }
-    } else {
-      log(`⚠️  未找到 .vscode/mcp.json`, 'yellow');
-    }
-  }
-
-  // 检查推荐扩展
-  const extensionsPath = path.join(projectPath, '.vscode/extensions.json');
-  if (fs.existsSync(extensionsPath)) {
-    log(`✅ 推荐扩展配置存在`, 'green');
-  }
-
-  // 检查项目指令
-  const instructionsPath = path.join(projectPath, '.github/copilot-instructions.md');
-  if (fs.existsSync(instructionsPath)) {
-    log(`✅ 项目指令存在`, 'green');
-  }
-}
-
-// ============ 提供快速启动指导 ============
-
-function printQuickStart() {
-  log(`\n${'='.repeat(60)}`, 'blue');
-  log('🎉 VSCode Copilot 配置完成！', 'green');
-  log('='.repeat(60), 'blue');
-
-  log('\n⚡ 3 步快速启动：\n', 'blue');
-
-  log('1️⃣  启动 Dashboard');
-  log('   $ asd ui', 'yellow');
-  log('   确认输出: ✓ Server running on http://localhost:3000\n');
-
-  log('2️⃣  重启 VSCode');
-  log('   $ code -r\n');
-
-  log('3️⃣  在 VSCode Copilot Chat 中测试');
-  log('   ⌘+⇧+I 打开 Copilot Chat');
-  log('   输入: @autosnippet search async', 'yellow');
-  log('   预期: 返回 async/await 代码片段\n');
-
-  log('📚 可用命令：\n', 'blue');
-  log('   @autosnippet search <关键词>      # 代码搜索');
-  log('   @autosnippet recipes list          # 查看 Recipe');
-  log('   @autosnippet create                # 创建 Recipe');
-  log('   @autosnippet guard                 # 代码审查');
-  log('   @autosnippet when <场景>           # 决策辅助\n');
-
-  log('📖 项目指令位置：');
-  log(`   ${path.join(projectPath, '.github/copilot-instructions.md')}`, 'yellow');
-
-  log('\n📝 配置位置：');
-  if (configWorkspace) {
-    log(`   MCP: ${path.join(projectPath, '.vscode/mcp.json')}`, 'yellow');
-  }
-
-  log('\n💡 提示：');
-  log('   - 首次配置需要重启 VSCode');
-  log('   - MCP 服务器需要 Node.js 18.0+');
-  log('   - Dashboard 运行在 http://localhost:3000');
-  log('   - MCP 配置位于 .vscode/mcp.json（可加入版本控制共享给团队）\n');
-
-  log(`${'='.repeat(60)}\n`, 'blue');
-}
-
-// ============ 主程序 ============
-
-async function main() {
-  log('\n🚀 AutoSnippet VSCode Copilot 安装程序', 'blue');
-  log(`📍 项目路径: ${projectPath}\n`, 'blue');
-
-  const results = {
-    settings: false,
-    extensions: false,
-    instructions: false,
-  };
-
-  // 配置 settings.json
-  results.settings = configureVSCodeSettings();
-
-  // 创建推荐扩展配置
-  results.extensions = createExtensionsJson();
-
-  // 生成项目指令
-  results.instructions = createCopilotInstructions();
-
-  // 验证配置
-  verifyConfiguration();
-
-  // 提供快速启动指导
-  printQuickStart();
-
-  // 返回状态
-  const allSuccess = Object.values(results).every((v) => v);
-  if (allSuccess) {
-    log('✅ 所有配置完成！', 'green');
-    process.exit(0);
-  } else {
-    log('⚠️  部分配置可能未完成，请检查上述消息', 'yellow');
-    process.exit(1);
-  }
-}
-
-// 运行
-main().catch((err) => {
-  error(`✗ 配置失败: ${err.message}`);
-  process.exit(1);
-});

package/scripts/migrate-md-to-knowledge.mjs

@@ -1,355 +0,0 @@
-#!/usr/bin/env node
-/**
- * migrate-md-to-knowledge.mjs — 将旧格式 .md 文件迁移为统一 Knowledge 格式
- *
- * 扫描 AutoSnippet/candidates/ 和 AutoSnippet/recipes/ 下的旧格式 .md 文件，
- * 用旧 parser 解析 → 转换为 KnowledgeEntry → 用 KnowledgeFileWriter 重新序列化。
- *
- * 旧文件会备份到 AutoSnippet/_backup/{candidates|recipes}/ 目录下。
- *
- * 用法:
- *   node scripts/migrate-md-to-knowledge.mjs [projectRoot]
- *
- *   --dry-run    只报告，不写入
- *   --no-backup  不创建备份
- */
-
-import fs from 'node:fs';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-
-// ── 解析命令行 ──
-const args = process.argv.slice(2);
-const dryRun = args.includes('--dry-run');
-const noBackup = args.includes('--no-backup');
-const projectRoot = args.find((a) => !a.startsWith('--')) || process.cwd();
-
-// ── 动态导入（兼容 ESM） ──
-// NOTE: 旧的 RecipeFileWriter / CandidateFileWriter 已统一为 KnowledgeFileWriter
-// parseKnowledgeMarkdown 兼容解析旧格式
-const { parseKnowledgeMarkdown } = await import('../lib/service/knowledge/KnowledgeFileWriter.js');
-const parseRecipeMarkdown = parseKnowledgeMarkdown;
-const parseCandidateMarkdown = parseKnowledgeMarkdown;
-const { KnowledgeEntry } = await import('../lib/domain/knowledge/KnowledgeEntry.js');
-const { KnowledgeFileWriter } = await import('../lib/service/knowledge/KnowledgeFileWriter.js');
-const { Lifecycle } = await import('../lib/domain/knowledge/Lifecycle.js');
-const { inferKind: inferKindV3 } = await import('../lib/domain/knowledge/Lifecycle.js');
-
-const RECIPES_DIR = 'AutoSnippet/recipes';
-const CANDIDATES_DIR = 'AutoSnippet/candidates';
-const BACKUP_DIR = 'AutoSnippet/_backup';
-
-const recipesDir = path.join(projectRoot, RECIPES_DIR);
-const candidatesDir = path.join(projectRoot, CANDIDATES_DIR);
-const backupDir = path.join(projectRoot, BACKUP_DIR);
-
-const report = {
-  recipes: { total: 0, migrated: 0, skipped: 0, errors: [] },
-  candidates: { total: 0, migrated: 0, skipped: 0, errors: [] },
-};
-
-// ── 工具函数 ──
-
-function collectMdFiles(dir) {
-  if (!fs.existsSync(dir)) {
-    return [];
-  }
-  const results = [];
-  const walk = (curDir, base) => {
-    for (const entry of fs.readdirSync(curDir, { withFileTypes: true })) {
-      const full = path.join(curDir, entry.name);
-      const rel = base ? `${base}/${entry.name}` : entry.name;
-      if (entry.isDirectory()) {
-        walk(full, rel);
-      } else if (entry.name.endsWith('.md') && !entry.name.startsWith('_')) {
-        results.push({ absPath: full, relPath: rel });
-      }
-    }
-  };
-  walk(dir, '');
-  return results;
-}
-
-function backupFile(absPath, type) {
-  if (noBackup || dryRun) {
-    return;
-  }
-  const rel = path.relative(type === 'recipe' ? recipesDir : candidatesDir, absPath);
-  const dest = path.join(backupDir, type === 'recipe' ? 'recipes' : 'candidates', rel);
-  const destDir = path.dirname(dest);
-  if (!fs.existsSync(destDir)) {
-    fs.mkdirSync(destDir, { recursive: true });
-  }
-  fs.copyFileSync(absPath, dest);
-}
-
-/**
- * 判断文件是否已经是新格式（包含 lifecycle 和 _content 字段）
- */
-function isAlreadyNewFormat(content) {
-  const fm = content.match(/^---\s*\r?\n([\s\S]*?)\r?\n---/);
-  if (!fm) {
-    return false;
-  }
-  return fm[1].includes('lifecycle:') && fm[1].includes('_content:');
-}
-
-// ═══ Recipe 迁移 ═══
-
-function migrateRecipe(absPath, relPath) {
-  const content = fs.readFileSync(absPath, 'utf8');
-
-  // 跳过已迁移的文件
-  if (isAlreadyNewFormat(content)) {
-    report.recipes.skipped++;
-    return;
-  }
-
-  const parsed = parseRecipeMarkdown(content, relPath);
-
-  // 映射旧 Recipe 字段 → KnowledgeEntry wire format
-  const statusMap = {
-    active: Lifecycle.ACTIVE,
-    deprecated: Lifecycle.DEPRECATED,
-    draft: Lifecycle.DRAFT,
-  };
-
-  // 提取旧 dimensions
-  const quality = parsed.quality || {};
-  const stats = parsed.statistics || {};
-
-  const wireData = {
-    id: parsed.id,
-    title: parsed.title,
-    trigger: parsed.trigger || '',
-    description: parsed.summaryCn || parsed.summaryEn || '',
-    lifecycle: statusMap[parsed.status] || Lifecycle.ACTIVE,
-    lifecycle_history: [],
-    probation: false,
-    language: parsed.language || 'swift',
-    category: parsed.category || 'general',
-    kind: parsed.kind || inferKindV3(parsed.knowledgeType || 'code-pattern'),
-    knowledge_type: parsed.knowledgeType || 'code-pattern',
-    complexity: parsed.complexity || 'intermediate',
-    scope: parsed.scope || 'universal',
-    difficulty: parsed.difficulty || null,
-    tags: parsed.tags || [],
-    summary_cn: parsed.summaryCn || '',
-    summary_en: parsed.summaryEn || '',
-    usage_guide_cn: parsed.usageGuideCn || '',
-    usage_guide_en: parsed.usageGuideEn || '',
-    content: {
-      pattern: '',
-      markdown: '',
-      rationale: '',
-      steps: [],
-      code_changes: [],
-      verification: null,
-    },
-    relations: parsed.relations || {},
-    constraints: parsed.constraints || {},
-    reasoning: {},
-    quality: {
-      completeness: quality.codeCompleteness ?? quality.completeness ?? 0,
-      adaptation: quality.projectAdaptation ?? quality.adaptation ?? 0,
-      documentation: quality.documentationClarity ?? quality.documentation ?? 0,
-      overall: quality.overall ?? 0,
-      grade: quality.grade || 'F',
-    },
-    stats: {
-      views: stats.viewCount ?? stats.views ?? 0,
-      adoptions: stats.adoptionCount ?? stats.adoptions ?? 0,
-      applications: stats.applicationCount ?? stats.applications ?? 0,
-      guard_hits: stats.guardHitCount ?? stats.guard_hits ?? 0,
-      search_hits: stats.searchHits ?? stats.search_hits ?? 0,
-      authority: parsed.authority ?? stats.authority ?? 0,
-    },
-    headers: parsed.headers || [],
-    header_paths: [],
-    module_name: '',
-    include_headers: false,
-    agent_notes: null,
-    ai_insight: null,
-    reviewed_by: null,
-    reviewed_at: null,
-    rejection_reason: parsed.deprecationReason || null,
-    source: 'migration',
-    source_file: `${RECIPES_DIR}/${relPath}`,
-    source_candidate_id: parsed.sourceCandidate || null,
-    created_by: parsed.createdBy || 'system',
-    created_at: parsed.createdAt || Math.floor(Date.now() / 1000),
-    updated_at: parsed.updatedAt || Math.floor(Date.now() / 1000),
-    published_at: parsed.publishedAt || null,
-    published_by: parsed.publishedBy || null,
-  };
-
-  // 提取 body 内容到 content
-  const bodyMatch = content.match(/^---[\s\S]*?---\s*\r?\n([\s\S]*)$/);
-  if (bodyMatch) {
-    const body = bodyMatch[1].trim();
-    const codeMatch = body.match(/```\w*\n([\s\S]*?)```/);
-    if (codeMatch) {
-      wireData.content.pattern = codeMatch[1].trimEnd();
-    }
-    // 如果有完整 markdown 内容（项目特写）
-    if (body.includes('— 项目特写') || (body.length > 500 && body.startsWith('#'))) {
-      wireData.content.markdown = body;
-      wireData.content.pattern = '';
-    }
-  }
-
-  // 构建实体并重新序列化
-  const entry = KnowledgeEntry.fromJSON(wireData);
-  const writer = new KnowledgeFileWriter(projectRoot);
-  const newMarkdown = writer.serialize(entry);
-
-  if (!dryRun) {
-    backupFile(absPath, 'recipe');
-    fs.writeFileSync(absPath, newMarkdown, 'utf8');
-  }
-
-  report.recipes.migrated++;
-}
-
-// ═══ Candidate 迁移 ═══
-
-function migrateCandidate(absPath, relPath) {
-  const content = fs.readFileSync(absPath, 'utf8');
-
-  // 跳过已迁移的文件
-  if (isAlreadyNewFormat(content)) {
-    report.candidates.skipped++;
-    return;
-  }
-
-  const parsed = parseCandidateMarkdown(content, relPath);
-
-  // 映射旧 Candidate 状态 → lifecycle
-  const statusMap = {
-    pending: Lifecycle.PENDING,
-    approved: Lifecycle.APPROVED,
-    rejected: Lifecycle.REJECTED,
-    applied: Lifecycle.ACTIVE,
-    draft: Lifecycle.DRAFT,
-  };
-
-  const meta = parsed._metadata || {};
-  const reasoning = parsed._reasoning || {};
-  const code = parsed._bodyCode || '';
-
-  // 判断内容类型
-  const isMarkdown = code && (code.includes('— 项目特写') || /^#{1,3}\s/.test(code.trimStart()));
-
-  const wireData = {
-    id: parsed.id,
-    title: meta.title || meta.description || (code ? code.substring(0, 60) : ''),
-    trigger: meta.trigger || '',
-    description: meta.description || '',
-    lifecycle: statusMap[parsed.status] || Lifecycle.PENDING,
-    lifecycle_history: parsed._statusHistory || [],
-    probation: false,
-    language: parsed.language || 'swift',
-    category: meta.category || parsed.category || 'general',
-    kind: inferKindV3(meta.knowledgeType || 'code-pattern'),
-    knowledge_type: meta.knowledgeType || 'code-pattern',
-    complexity: meta.complexity || 'intermediate',
-    scope: meta.scope || 'universal',
-    difficulty: meta.difficulty || null,
-    tags: meta.tags || [],
-    summary_cn: meta.summary || meta.summary_cn || '',
-    summary_en: meta.summary_en || '',
-    usage_guide_cn: meta.usageGuide || meta.usageGuide_cn || '',
-    usage_guide_en: meta.usageGuide_en || '',
-    content: {
-      pattern: isMarkdown ? '' : code,
-      markdown: isMarkdown ? code : '',
-      rationale:
-        meta.rationale || (typeof reasoning === 'object' ? reasoning.whyStandard : '') || '',
-      steps: meta.steps || [],
-      code_changes: meta.codeChanges || [],
-      verification: meta.verification || null,
-    },
-    relations: Array.isArray(meta.relations)
-      ? {
-          related: meta.relations.map((r) =>
-            typeof r === 'string' ? { target: r, description: '' } : r
-          ),
-        }
-      : meta.relations || {},
-    constraints: meta.constraints || {},
-    reasoning: {
-      why_standard: (typeof reasoning === 'object' ? reasoning.whyStandard : '') || '',
-      sources: (typeof reasoning === 'object' ? reasoning.sources : []) || [],
-      confidence: (typeof reasoning === 'object' ? reasoning.confidence : 0.7) ?? 0.7,
-      quality_signals: (typeof reasoning === 'object' ? reasoning.qualitySignals : {}) || {},
-      alternatives: (typeof reasoning === 'object' ? reasoning.alternatives : []) || [],
-    },
-    quality: meta.quality || {},
-    stats: {},
-    headers: meta.headers || [],
-    header_paths: [],
-    module_name: '',
-    include_headers: false,
-    agent_notes: null,
-    ai_insight: null,
-    reviewed_by: parsed.approvedBy || parsed.rejectedBy || null,
-    reviewed_at: parsed.approvedAt || null,
-    rejection_reason: parsed.rejectionReason || null,
-    source: parsed.source || 'migration',
-    source_file: `${CANDIDATES_DIR}/${relPath}`,
-    source_candidate_id: null,
-    created_by: parsed.createdBy || 'system',
-    created_at: parsed.createdAt || Math.floor(Date.now() / 1000),
-    updated_at: parsed.updatedAt || Math.floor(Date.now() / 1000),
-    published_at: null,
-    published_by: null,
-  };
-
-  // 构建实体并重新序列化
-  const entry = KnowledgeEntry.fromJSON(wireData);
-  const writer = new KnowledgeFileWriter(projectRoot);
-  const newMarkdown = writer.serialize(entry);
-
-  if (!dryRun) {
-    backupFile(absPath, 'candidate');
-    fs.writeFileSync(absPath, newMarkdown, 'utf8');
-  }
-
-  report.candidates.migrated++;
-}
-
-// ── 迁移 Recipes ──
-const recipeFiles = collectMdFiles(recipesDir);
-report.recipes.total = recipeFiles.length;
-
-for (const { absPath, relPath } of recipeFiles) {
-  try {
-    migrateRecipe(absPath, relPath);
-  } catch (err) {
-    report.recipes.errors.push({ file: relPath, error: err.message });
-    console.error(`  ❌ ${relPath}: ${err.message}`);
-  }
-}
-
-// ── 迁移 Candidates ──
-const candidateFiles = collectMdFiles(candidatesDir);
-report.candidates.total = candidateFiles.length;
-
-for (const { absPath, relPath } of candidateFiles) {
-  try {
-    migrateCandidate(absPath, relPath);
-  } catch (err) {
-    report.candidates.errors.push({ file: relPath, error: err.message });
-    console.error(`  ❌ ${relPath}: ${err.message}`);
-  }
-}
-
-if (!noBackup && !dryRun) {
-}
-
-if (report.recipes.errors.length + report.candidates.errors.length > 0) {
-  for (const _e of [...report.recipes.errors, ...report.candidates.errors]) {
-  }
-}