autosnippet 3.2.3 → 3.2.6

package/lib/cli/SetupService.js

@@ -48,13 +48,11 @@ import {
   existsSync,
   mkdirSync,
   readdirSync,
-  readFileSync,
-  realpathSync,
   writeFileSync,
 } from 'node:fs';
 import { dirname, join, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
-import { checkWriteSafety } from '../service/cursor/FileProtection.js';
+import { FileDeployer } from './deploy/FileDeployer.js';
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
@@ -172,9 +170,6 @@ export class SetupService {
       writeFileSync(configPath, JSON.stringify(config, null, 2));
     }
 
-    // 确保 .autosnippet/ 在主仓库 .gitignore 中
-    this._ensureGitignore();
-
     // .env — AI 配置模板
     this._ensureEnvFile();
 
@@ -433,633 +428,21 @@ export class SetupService {
   /* ═══ Step 3: IDE 集成 ═══════════════════════════════ */
 
   stepIDE() {
-    const configured = [];
-
-    // MCP 配置（总是写入/合并，不会跳过）
-    this._configureVSCodeMCP();
-    configured.push('vscode-mcp');
-    this._configureCursorMCP();
-    configured.push('cursor-mcp');
-
-    // 模板文件（可能因已存在/用户文件而跳过）
-    if (this._copyCopilotInstructions()) configured.push('copilot-instructions');
-    this._ensureTaskGraphInstructions();
-    if (this._generateAgentInstructionFiles()) configured.push('agent-instructions');
-    if (this._copyCursorRules()) configured.push('cursor-rules');
-    if (this._copySkillsTemplate()) configured.push('skills-template');
-    if (this._copyCursorWorkflow()) configured.push('cursor-workflow');
-    if (this._copyClaudeHooks()) configured.push('claude-hooks');
-    if (this._copyGuardCI()) configured.push('guard-ci');
-    if (this._installPreCommitHook()) configured.push('pre-commit-hook');
-    // NOTE: .qoder/ .trae/ 不再自动创建，用户可通过 `asd mirror` 按需生成
-
-    const extResult = this._installVSCodeExtension();
-    if (extResult) {
-      configured.push(...extResult);
-    }
-    return { configured };
-  }
-
-  /**
-   * @private 构建 + 安装 VSCode Extension (.vsix)
-   *
-   * 流程：
-   *   1. 编译 TypeScript（tsc）
-   *   2. 打包 .vsix（vsce package）
-   *   3. 探测所有可用的 VS Code 兼容 IDE CLI
-   *   4. 对每个 IDE 执行 --install-extension
-   *
-   * 支持：VS Code / Cursor / Codex 等基于 VS Code 的 IDE。
-   * 找不到任何 IDE CLI 时静默跳过，不阻断 setup 流程。
-   *
-   * @returns {string[]|null} 安装成功的 IDE 列表, 或 null
-   */
-  _installVSCodeExtension() {
-    const extDir = join(REPO_ROOT, 'resources', 'vscode-ext');
-    const pkgJson = join(extDir, 'package.json');
-
-    if (!existsSync(pkgJson)) {
-      return null;
-    }
-
-    // ── 1. 编译 TypeScript ──
-    try {
-      execSync('npx tsc -p ./tsconfig.json', { cwd: extDir, stdio: 'pipe' });
-    } catch (e) {
-      console.error(`   ⚠ VSCode Extension 编译失败: ${e.stderr?.toString().trim() || e.message}`);
-      return null;
-    }
-
-    // ── 2. 打包 .vsix ──
-    let vsixPath;
-    try {
-      const out = execSync('npx @vscode/vsce package --no-dependencies 2>&1', {
-        cwd: extDir,
-        stdio: 'pipe',
-        encoding: 'utf8',
-      });
-      // 从输出中提取 vsix 文件路径:  "DONE  Packaged: /path/to/autosnippet-0.1.0.vsix ..."
-      const m = out.match(/Packaged:\s*(.+\.vsix)/);
-      if (m) {
-        vsixPath = m[1].trim();
-      }
-    } catch (e) {
-      console.error(`   ⚠ VSCode Extension 打包失败: ${e.message}`);
-      return null;
-    }
-
-    // fallback: 扫描目录找 .vsix 文件
-    if (!vsixPath || !existsSync(vsixPath)) {
-      try {
-        const files = readdirSync(extDir).filter((f) => f.endsWith('.vsix'));
-        if (files.length > 0) {
-          // 取最新的
-          files.sort().reverse();
-          vsixPath = join(extDir, files[0]);
-        }
-      } catch {
-        /* ignore */
-      }
-    }
-
-    if (!vsixPath || !existsSync(vsixPath)) {
-      console.error('   ⚠ 找不到 .vsix 文件，跳过 Extension 安装');
-      return null;
-    }
-
-    // ── 3. 探测可用的 IDE CLI ──
-    const cliCandidates = this._discoverIDEClis();
-    if (cliCandidates.length === 0) {
-      console.error('   ⚠ 未找到 VS Code / Cursor 等 IDE CLI，跳过 Extension 安装');
-      console.error('     提示: 手动安装 → 在 IDE 中 Cmd+Shift+P → "Install from VSIX"');
-      console.error(`     文件: ${vsixPath}`);
-      return null;
-    }
-
-    // ── 4. 逐个安装 ──
-    const installed = [];
-    for (const { name, cli } of cliCandidates) {
-      try {
-        execSync(`"${cli}" --install-extension "${vsixPath}" --force 2>&1`, {
-          stdio: 'pipe',
-          encoding: 'utf8',
-          timeout: 30_000,
-        });
-        installed.push(`vscode-ext:${name}`);
-      } catch (e) {
-        console.error(`   ⚠ ${name} Extension 安装失败: ${e.message}`);
-      }
-    }
-    return installed.length > 0 ? installed : null;
-  }
-
-  /**
-   * @private 探测系统中所有 VS Code 兼容 IDE 的 CLI 路径
-   * @returns {{ name: string, cli: string }[]}
-   */
-  _discoverIDEClis() {
-    const candidates = [];
-
-    // 1. PATH 中的命令（跨平台: which → Unix, where → Windows）
-    const whichCmd = process.platform === 'win32' ? 'where' : 'which';
-    for (const cmd of ['code', 'cursor', 'codex', 'code-insiders']) {
-      try {
-        const p = execSync(`${whichCmd} ${cmd}`, {
-          encoding: 'utf8',
-          stdio: ['pipe', 'pipe', 'ignore'],
-        })
-          .trim()
-          .split(/\r?\n/)[0];
-        if (p) {
-          candidates.push({ name: cmd, cli: p });
-        }
-      } catch {
-        /* not in PATH */
-      }
-    }
-
-    // 2. 平台特定的 IDE 安装路径
-    if (process.platform === 'darwin') {
-      // macOS: /Applications/xxx.app/Contents/Resources/app/bin/
-      const appPaths = [
-        { name: 'vscode', app: '/Applications/Visual Studio Code.app', bin: 'code' },
-        {
-          name: 'vscode-insiders',
-          app: '/Applications/Visual Studio Code - Insiders.app',
-          bin: 'code-insiders',
-        },
-        { name: 'cursor', app: '/Applications/Cursor.app', bin: 'cursor' },
-        { name: 'codex', app: '/Applications/Codex.app', bin: 'codex' },
-      ];
-      for (const { name, app, bin } of appPaths) {
-        const cli = join(app, 'Contents', 'Resources', 'app', 'bin', bin);
-        if (existsSync(cli) && !candidates.some((c) => c.name === name)) {
-          candidates.push({ name, cli });
-        }
-      }
-    } else if (process.platform === 'win32') {
-      // Windows: %LOCALAPPDATA%\Programs\xxx
-      const localAppData =
-        process.env.LOCALAPPDATA || join(process.env.USERPROFILE || '', 'AppData', 'Local');
-      const winPaths = [
-        { name: 'vscode', dir: 'Microsoft VS Code', bin: 'bin/code.cmd' },
-        {
-          name: 'vscode-insiders',
-          dir: 'Microsoft VS Code Insiders',
-          bin: 'bin/code-insiders.cmd',
-        },
-        { name: 'cursor', dir: 'cursor', bin: 'cursor.exe' },
-      ];
-      for (const { name, dir, bin } of winPaths) {
-        const cli = join(localAppData, 'Programs', dir, bin);
-        if (existsSync(cli) && !candidates.some((c) => c.name === name)) {
-          candidates.push({ name, cli });
-        }
-      }
-    } else {
-      // Linux: 常见安装路径
-      const linuxPaths = [
-        { name: 'vscode', bin: '/usr/share/code/bin/code' },
-        { name: 'vscode', bin: '/usr/bin/code' },
-        { name: 'cursor', bin: '/usr/bin/cursor' },
-        { name: 'cursor', bin: `${process.env.HOME || ''}/.local/bin/cursor` },
-      ];
-      for (const { name, bin } of linuxPaths) {
-        if (existsSync(bin) && !candidates.some((c) => c.name === name)) {
-          candidates.push({ name, cli: bin });
-        }
-      }
-    }
-
-    // 3. 去重（同一个二进制不重复安装）— 使用 Node.js 原生 realpathSync 替代 readlink -f
-    const seen = new Set();
-    return candidates.filter((c) => {
-      let realPath = c.cli;
-      try {
-        realPath = realpathSync(c.cli);
-      } catch {
-        /* use as-is */
-      }
-      if (seen.has(realPath)) {
-        return false;
-      }
-      seen.add(realPath);
-      return true;
+    const deployer = new FileDeployer({
+      projectRoot: this.projectRoot,
+      force: this.force,
     });
-  }
-
-  /** @private .vscode/mcp.json → VSCode MCP (新标准格式) */
-  _configureVSCodeMCP() {
-    const vscodeDir = join(this.projectRoot, '.vscode');
-    const mcpConfigPath = join(vscodeDir, 'mcp.json');
-    mkdirSync(vscodeDir, { recursive: true });
+    const { deployed, skipped, errors } = deployer.deployAll('setup');
 
-    let config = {};
-    if (existsSync(mcpConfigPath)) {
-      try {
-        config = JSON.parse(readFileSync(mcpConfigPath, 'utf8'));
-      } catch {
-        /* ignore */
+    if (errors.length > 0) {
+      for (const { id, error } of errors) {
+        console.error(`   ⚠ ${id}: ${error}`);
       }
     }
 
-    if (!config.servers) {
-      config.servers = {};
-    }
-    config.servers.autosnippet = {
-      type: 'stdio',
-      command: 'asd-mcp',
-      env: {
-        ASD_PROJECT_DIR: this.projectRoot,
-      },
-    };
-
-    writeFileSync(mcpConfigPath, JSON.stringify(config, null, 2));
+    return { configured: deployed };
   }
 
-  /**
-   * @private .cursor/mcp.json
-   *
-   * 初始 setup 时不写入 autoApprove — 让用户首次使用时亲眼看到并手动授权每个工具。
-   * 首次 `autosnippet_bootstrap` 成功后，bootstrap-external.js 会自动注入 autoApprove，
-   * 后续调用无需再点击授权。升级时 UpgradeService 也会注入。
-   */
-  _configureCursorMCP() {
-    const cursorDir = join(this.projectRoot, '.cursor');
-    const configPath = join(cursorDir, 'mcp.json');
-    mkdirSync(cursorDir, { recursive: true });
-
-    let existing = {};
-    if (existsSync(configPath)) {
-      try {
-        existing = JSON.parse(readFileSync(configPath, 'utf8'));
-      } catch {
-        /* ignore */
-      }
-    }
-
-    if (!existing.mcpServers) {
-      existing.mcpServers = {};
-    }
-    existing.mcpServers.autosnippet = {
-      command: 'asd-mcp',
-      env: {
-        ASD_PROJECT_DIR: this.projectRoot,
-      },
-    };
-
-    writeFileSync(configPath, JSON.stringify(existing, null, 2));
-  }
-
-  /** @private .github/copilot-instructions.md (static template fallback) */
-  _copyCopilotInstructions() {
-    const src = join(REPO_ROOT, 'templates', 'copilot-instructions.md');
-    if (!existsSync(src)) {
-      return false;
-    }
-
-    const destDir = join(this.projectRoot, '.github');
-    const dest = join(destDir, 'copilot-instructions.md');
-    if (existsSync(dest) && !this.force) {
-      return false;
-    }
-
-    // 即使 --force，也不覆盖用户原有的非 AutoSnippet 文件
-    const { canWrite } = checkWriteSafety(dest);
-    if (!canWrite) {
-      return false;
-    }
-
-    mkdirSync(destDir, { recursive: true });
-    copyFileSync(src, dest);
-    return true;
-  }
-
-  /** @private TaskGraph 决策记忆激活段落注入 */
-  _ensureTaskGraphInstructions() {
-    const githubDir = join(this.projectRoot, '.github');
-    const filePath = join(githubDir, 'copilot-instructions.md');
-
-    // 使用 HTML 注释标记界定段落，避免标题被编辑后重复追加（D3）
-    const BEGIN_MARKER = '<!-- autosnippet:begin -->';
-    const END_MARKER = '<!-- autosnippet:end -->';
-
-    const autosnippetSection = `
-${BEGIN_MARKER}
-## AutoSnippet
-
-This project uses AutoSnippet for knowledge management and decision tracking.
-In VS Code Agent Mode, type \`#asd\` before your message to activate project memory.
-
-### ⚠️ MANDATORY — Call \`autosnippet_ready\` FIRST
-
-Before doing ANY work, you MUST call \`autosnippet_ready()\` at the start of every conversation.
-This loads **active team decisions** and **pending tasks** that you must respect.
-Skipping this step will cause you to contradict team agreements.
-
-\`\`\`
-autosnippet_ready()           → Load decisions + context (ALWAYS FIRST)
-autosnippet_decide(record)    → Save new team agreement
-autosnippet_task(create/close) → Task lifecycle
-\`\`\`
-${END_MARKER}
-`;
-
-    if (!existsSync(githubDir)) {
-      mkdirSync(githubDir, { recursive: true });
-    }
-
-    if (existsSync(filePath)) {
-      const existing = readFileSync(filePath, 'utf8');
-      // 通过 HTML 注释标记检测，不依赖可编辑的标题文本
-      if (existing.includes(BEGIN_MARKER)) {
-        // 替换现有段落（支持升级）
-        const updated = existing.replace(
-          new RegExp(`${BEGIN_MARKER}[\\s\\S]*?${END_MARKER}`),
-          autosnippetSection.trim()
-        );
-        writeFileSync(filePath, updated);
-        return { action: 'updated' };
-      }
-      // 追加到末尾
-      writeFileSync(filePath, existing + '\n' + autosnippetSection);
-      return { action: 'appended' };
-    }
-
-    writeFileSync(filePath, autosnippetSection.trimStart());
-    return { action: 'created' };
-  }
-
-  /**
-   * @private 生成 AGENTS.md + CLAUDE.md 静态骨架
-   * setup 阶段没有知识库数据，所以只生成指向 MCP 的基础版本。
-   * bootstrap / delivery pipeline 完成后会用动态版本覆盖。
-   */
-  _generateAgentInstructionFiles() {
-    const projectName = this.projectRoot.split('/').pop();
-    let wrote = false;
-
-    // AGENTS.md
-    const agentsPath = join(this.projectRoot, 'AGENTS.md');
-    if (!existsSync(agentsPath) || this.force) {
-      const { canWrite } = checkWriteSafety(agentsPath);
-      if (canWrite) {
-        const agentsContent = [
-          `# ${projectName} — Agent Instructions`,
-          '',
-          '> Auto-generated by AutoSnippet.',
-          '',
-          '## AutoSnippet Integration',
-          '',
-          'This project uses **AutoSnippet** for knowledge management and decision tracking.',
-          '',
-          '### MCP Tools',
-          '',
-          '- `autosnippet_search` — Search knowledge',
-          '- `autosnippet_knowledge` — Browse/get recipes',
-          '- `autosnippet_submit_knowledge` — Submit candidate',
-          '- `autosnippet_guard` — Code compliance check',
-          '- `autosnippet_health` — Service health & KB stats',
-          '- `autosnippet_ready` — Session entry point (loads decisions + tasks)',
-          '- `autosnippet_decide` — Decision management (record/revise/unpin)',
-          '- `autosnippet_task` — Task CRUD (create/claim/close/fail/defer)',
-          '',
-          '### VS Code Agent Mode',
-          '',
-          'Type `#asd` before your message in Agent Mode to activate project memory.',
-          '',
-          '### Constraints',
-          '',
-          '1. Do NOT modify knowledge base files directly.',
-          '2. Create or update knowledge only through MCP tools.',
-          '',
-        ].join('\n');
-        writeFileSync(agentsPath, agentsContent);
-        wrote = true;
-      } else {
-      }
-    }
-
-    // CLAUDE.md
-    const claudePath = join(this.projectRoot, 'CLAUDE.md');
-    if (!existsSync(claudePath) || this.force) {
-      const { canWrite } = checkWriteSafety(claudePath);
-      if (canWrite) {
-        const claudeContent = [
-          `# ${projectName} — Claude Code Instructions`,
-          '',
-          '> Auto-generated by AutoSnippet.',
-          '',
-          '## AutoSnippet Integration',
-          '',
-          'This project uses AutoSnippet for knowledge management and decision tracking.',
-          '',
-          '### MCP Tools',
-          '',
-          '- `autosnippet_search` — Search knowledge',
-          '- `autosnippet_knowledge` — Browse/get recipes',
-          '- `autosnippet_submit_knowledge` — Submit candidate',
-          '- `autosnippet_guard` — Code compliance check',
-          '- `autosnippet_health` — Service health & KB stats',
-          '- `autosnippet_ready` — Session entry point (loads decisions + tasks)',
-          '- `autosnippet_decide` — Decision management (record/revise/unpin)',
-          '- `autosnippet_task` — Task CRUD (create/claim/close/fail/defer)',
-          '',
-          '### Claude + VS Code',
-          '',
-          'Claude Code uses MCP tools directly. Run `asd server` to start the API server.',
-          'In VS Code Agent Mode, type `#asd` before your message to activate project memory.',
-          '',
-          '### Constraints',
-          '',
-          '1. Do NOT modify knowledge base files directly.',
-          '2. Create or update knowledge only through MCP tools.',
-          '',
-        ].join('\n');
-        writeFileSync(claudePath, claudeContent);
-        wrote = true;
-      } else {
-      }
-    }
-    return wrote;
-  }
-
-  /** @private .cursor/rules/autosnippet-conventions.mdc */
-  _copyCursorRules() {
-    const src = join(REPO_ROOT, 'templates', 'cursor-rules', 'autosnippet-conventions.mdc');
-    if (!existsSync(src)) {
-      return false;
-    }
-
-    const destDir = join(this.projectRoot, '.cursor', 'rules');
-    const dest = join(destDir, 'autosnippet-conventions.mdc');
-    if (existsSync(dest) && !this.force) {
-      return false;
-    }
-
-    mkdirSync(destDir, { recursive: true });
-    copyFileSync(src, dest);
-    return true;
-  }
-
-  /** @private .cursor/rules/autosnippet-skills.mdc — Project Skills 索引模板 */
-  _copySkillsTemplate() {
-    const src = join(REPO_ROOT, 'templates', 'cursor-rules', 'autosnippet-skills.mdc');
-    if (!existsSync(src)) {
-      return false;
-    }
-
-    const destDir = join(this.projectRoot, '.cursor', 'rules');
-    const dest = join(destDir, 'autosnippet-skills.mdc');
-    if (existsSync(dest) && !this.force) {
-      return false;
-    }
-
-    mkdirSync(destDir, { recursive: true });
-    copyFileSync(src, dest);
-    return true;
-  }
-  /** @private .cursor/rules/autosnippet-workflow.mdc — TaskGraph & Guard 工作流 */
-  _copyCursorWorkflow() {
-    const src = join(REPO_ROOT, 'templates', 'cursor-rules', 'autosnippet-workflow.mdc');
-    if (!existsSync(src)) {
-      return false;
-    }
-
-    const destDir = join(this.projectRoot, '.cursor', 'rules');
-    const dest = join(destDir, 'autosnippet-workflow.mdc');
-    if (existsSync(dest) && !this.force) {
-      return false;
-    }
-
-    mkdirSync(destDir, { recursive: true });
-    copyFileSync(src, dest);
-    return true;
-  }
-
-  /**
-   * @private .claude/hooks.yaml — Claude Code SessionStart hook
-   * 会话开始时自动 prime TaskGraph 上下文
-   */
-  _copyClaudeHooks() {
-    const src = join(REPO_ROOT, 'templates', 'claude-hooks.yaml');
-    if (!existsSync(src)) {
-      return false;
-    }
-
-    const claudeDir = join(this.projectRoot, '.claude');
-    const dest = join(claudeDir, 'hooks.yaml');
-    if (existsSync(dest) && !this.force) {
-      return false;
-    }
-
-    // 即使 --force，也不覆盖用户自己的 hooks 文件
-    const { canWrite } = checkWriteSafety(dest);
-    if (!canWrite) {
-      return false;
-    }
-
-    mkdirSync(claudeDir, { recursive: true });
-    copyFileSync(src, dest);
-    return true;
-  }
-
-  /**
-   * @private .github/workflows/autosnippet-guard.yml — Guard CI/CD workflow
-   * 在 push/PR 时自动运行 Guard 合规检查
-   */
-  _copyGuardCI() {
-    const src = join(REPO_ROOT, 'templates', 'guard-ci.yml');
-    if (!existsSync(src)) {
-      return false;
-    }
-
-    const destDir = join(this.projectRoot, '.github', 'workflows');
-    const dest = join(destDir, 'autosnippet-guard.yml');
-    if (existsSync(dest) && !this.force) {
-      return false;
-    }
-
-    const { canWrite } = checkWriteSafety(dest);
-    if (!canWrite) {
-      return false;
-    }
-
-    mkdirSync(destDir, { recursive: true });
-    copyFileSync(src, dest);
-    return true;
-  }
-
-  /**
-   * @private .git/hooks/pre-commit — Guard pre-commit hook
-   * 如果项目使用 husky，则安装到 .husky/pre-commit
-   * 否则安装到 .git/hooks/pre-commit
-   * 已存在 pre-commit hook 时不覆盖（避免破坏用户现有 hook）
-   */
-  _installPreCommitHook() {
-    const src = join(REPO_ROOT, 'templates', 'pre-commit-guard.sh');
-    if (!existsSync(src)) {
-      return false;
-    }
-
-    // 优先检查 husky
-    const huskyDir = join(this.projectRoot, '.husky');
-    const gitHooksDir = join(this.projectRoot, '.git', 'hooks');
-
-    let dest;
-    if (existsSync(huskyDir)) {
-      // 项目使用 husky — 安装到 .husky/pre-commit
-      dest = join(huskyDir, 'pre-commit');
-    } else if (existsSync(join(this.projectRoot, '.git'))) {
-      // 普通 git 项目 — 安装到 .git/hooks/pre-commit
-      dest = join(gitHooksDir, 'pre-commit');
-      mkdirSync(gitHooksDir, { recursive: true });
-    } else {
-      // 非 git 项目，跳过
-      return false;
-    }
-
-    // 已存在 pre-commit hook 时不覆盖（可能是用户自己的 hook）
-    if (existsSync(dest) && !this.force) {
-      return false;
-    }
-
-    // 即使 --force，也不覆盖用户自己的 pre-commit hook
-    const { canWrite } = checkWriteSafety(dest);
-    if (!canWrite) {
-      return false;
-    }
-
-    copyFileSync(src, dest);
-    // 确保可执行
-    try {
-      execSync(`chmod +x "${dest}"`, { stdio: 'pipe' });
-    } catch {
-      /* Windows 不需要 chmod */
-    }
-    return true;
-  }
-
-  /** @private 镜像 .cursor/rules/ 中的 autosnippet-* 文件到目标 IDE 目录（Qoder / Trae 兼容）
-   *  只复制 autosnippet- 前缀的文件，不触碰用户自己创建的规则 */
-  _mirrorCursorToIDE(targetDirName) {
-    const cursorRulesDir = join(this.projectRoot, '.cursor', 'rules');
-    if (!existsSync(cursorRulesDir)) {
-      return;
-    }
-
-    const targetRulesDir = join(this.projectRoot, targetDirName, 'rules');
-    mkdirSync(targetRulesDir, { recursive: true });
-
-    // 只镜像 autosnippet- 前缀的文件，保留目标目录中用户已有的其他文件
-    const files = readdirSync(cursorRulesDir).filter(
-      (f) => (f.endsWith('.mdc') || f.endsWith('.md')) && f.startsWith('autosnippet-')
-    );
-    for (const file of files) {
-      const destName = file.endsWith('.mdc') ? file.replace(/\.mdc$/, '.md') : file;
-      copyFileSync(join(cursorRulesDir, file), join(targetRulesDir, destName));
-    }
-  }
   /* ═══ Step 4: 数据库初始化 ═══════════════════════════ */
 
   async stepDatabase() {
@@ -1156,99 +539,6 @@ ${END_MARKER}
     }
   }
 
-  /** @private 确保项目 .gitignore 正确配置 AutoSnippet 相关规则 */
-  _ensureGitignore() {
-    const giPath = join(this.projectRoot, '.gitignore');
-    let content = existsSync(giPath) ? readFileSync(giPath, 'utf8') : '';
-    let changed = false;
-
-    // ── v2.4.0 迁移：旧格式 ".autosnippet/" → 新格式 ".autosnippet/*" ──
-    // 旧格式会忽略整个目录（git 不遍历内部），导致 skills/ 和 config.json 无法被 negation 恢复
-    // 新格式忽略目录内所有文件，允许 negation 模式取消特定子路径
-    if (content.includes('.autosnippet/') && !content.includes('.autosnippet/*')) {
-      content = content.replace(/^\.autosnippet\/$/m, '.autosnippet/*');
-      changed = true;
-    }
-
-    // ── 必须忽略：.autosnippet/*（运行时缓存、DB、向量索引、memory） ──
-    if (!content.includes('.autosnippet/') && !content.includes('.autosnippet/*')) {
-      content += `\n# AutoSnippet 运行时缓存（不入库）\n.autosnippet/*\n`;
-      changed = true;
-    }
-
-    // ── 必须跟踪：.autosnippet/config.json（项目配置） ──
-    if (!content.includes('!.autosnippet/config.json')) {
-      content += `!.autosnippet/config.json\n`;
-      changed = true;
-    }
-
-    // ── 必须忽略：.env（包含 API Key 等敏感信息） ──
-    if (!content.includes('.env') || (!content.match(/^\.env$/m) && !content.match(/^\.env\s/m))) {
-      content += `\n# AutoSnippet 环境变量（含 API Key，不入库）\n.env\n`;
-      changed = true;
-    }
-
-    // ── 必须忽略：logs/（winston 运行日志，可达数十 MB） ──
-    if (!content.match(/^logs\/?$/m)) {
-      content += `\n# AutoSnippet 运行日志\nlogs/\n`;
-      changed = true;
-    }
-
-    // ── 必须忽略：.autosnippet-drafts/（AI 草稿临时目录） ──
-    if (!content.includes('.autosnippet-drafts')) {
-      content += `\n# AutoSnippet AI 草稿（临时）\n.autosnippet-drafts/\n`;
-      changed = true;
-    }
-
-    // ── 必须忽略：_draft_*.md（AI Agent 在项目根目录创建的草稿文件） ──
-    if (!content.includes('_draft_*.md')) {
-      content += `\n# AutoSnippet AI 草稿文件（项目根目录临时文件）\n_draft_*.md\n`;
-      changed = true;
-    }
-
-    // ── 必须忽略：常见系统 / 编辑器临时文件 ──
-    if (!content.includes('.DS_Store')) {
-      content += `\n# macOS 元数据\n.DS_Store\n`;
-      changed = true;
-    }
-    if (!content.includes('nohup.out')) {
-      content += `nohup.out\n`;
-      changed = true;
-    }
-    if (!content.match(/\*\.sw[a-p]/)) {
-      content += `*.sw[a-p]\n`;
-      changed = true;
-    }
-
-    // Skills 已迁移到 AutoSnippet/skills/（知识库目录内），自动跟随 Git
-
-    // ── 清理旧版本的 .autosnippet/skills/ negation（已迁移，不再需要）──
-    if (content.includes('!.autosnippet/skills/')) {
-      content = content.replace(/^!?\.autosnippet\/skills\/.*\n?/gm, '');
-      changed = true;
-    }
-
-    // ── 必须跟踪：AutoSnippet/（知识库子仓库）──
-    // 如果用户误将 AutoSnippet/ 加入忽略，追加 !AutoSnippet/ 取消忽略
-    const lines = content.split('\n');
-    const hasIgnoreAS = lines.some((l) => {
-      const t = l.trim();
-      return (
-        (t === 'AutoSnippet/' || t === 'AutoSnippet') && !t.startsWith('#') && !t.startsWith('!')
-      );
-    });
-    const hasNegation = lines.some((l) => l.trim() === '!AutoSnippet/');
-
-    if (hasIgnoreAS && !hasNegation) {
-      content += `\n# AutoSnippet 知识库必须入库（取消上方忽略）\n!AutoSnippet/\n`;
-      changed = true;
-    }
-
-    if (changed) {
-      writeFileSync(giPath, content);
-    }
-  }
-
   /** @private 在指定目录执行 git 命令 */
   _git(args, cwd) {
     try {