ai-git-tools 2.0.48 → 2.0.49

package/src/dev-modules/ai/code-generator.js

@@ -1,288 +0,0 @@
-/**
- * AI 代碼生成器
- * 基於 Issue 描述，調用 AI 生成代碼框架/實現
- */
-
-import { AIClient } from '../../core/ai-client.js';
-
-/**
- * @typedef {Object} GeneratedCode
- * @property {string} filePath - 要建立/修改的檔案路徑
- * @property {string} content - 代碼內容
- * @property {string} type - 'new' | 'modify' | 'skip'
- * @property {string|null} reason - 若 skip 時的原因
- */
-
-export class CodeGenerator {
-  constructor(config = {}) {
-    this.config = config;
-    this.model = config.aiModel || 'gpt-4.1';
-  }
-
-  /**
-   * 基於 Issue 生成代碼檔案
-   * @param {import('../core/issue-parser.js').IssueData} issueData
-   * @param {string} [projectRoot] - 專案根目錄
-   * @returns {Promise<GeneratedCode[]>}
-   */
-  async generateCodeFiles(issueData, projectRoot = process.cwd()) {
-    const prompt = this._buildPrompt(issueData, projectRoot);
-
-    const VALID_MODELS = [
-      'gpt-4.1',
-      'gpt-4o',
-      'claude-haiku-4.5',
-      'claude-sonnet-4.5',
-      'claude-sonnet-4.6',
-      'o3',
-      'o4-mini',
-    ];
-    if (!VALID_MODELS.includes(this.model)) {
-      console.warn(`   ⚠️  model「${this.model}」可能無效！支援的模型：${VALID_MODELS.join(', ')}`);
-    }
-
-    // Claude 模型使用 extended thinking，需要更長的等待時間
-    const isClaude = this.model.toLowerCase().includes('claude');
-    const timeout = isClaude ? 300_000 : 120_000; // Claude 5 分鐘，GPT 2 分鐘
-    const timeoutMinutes = timeout / 60_000;
-
-    console.log(`   🤖 調用 AI 生成代碼框架（model: ${this.model}，最多等待 ${timeoutMinutes} 分鐘）...`);
-    if (isClaude) {
-      console.log('   ℹ️  Claude 模型使用 extended thinking 模式，回應時間較長，請耐心等候');
-      console.log('   💡 若等待太久，可改用較快的模型：在 .ai-git-config 的 autodev.aiModel 改為 "gpt-4.1"');
-    }
-
-    let response;
-    try {
-      response = await AIClient.sendAndWait(
-        prompt,
-        this.model,
-        this.config.maxRetries || 3,
-        timeout
-      );
-    } catch (error) {
-      console.warn(`   ❌ AI 調用最終失敗：${error.message}`);
-      console.warn('   💡 排查建議：');
-      console.warn(`      1. 確認 model「${this.model}」已在你的 Copilot 方案中啟用`);
-      console.warn(
-        '      2. 嘗試改用 gpt-4.1：在 .ai-git-config 的 autodev.aiModel 改為 "gpt-4.1"'
-      );
-      console.warn('      3. 確認 gh auth status 有登入 GitHub');
-      return [];
-    }
-
-    if (!response) {
-      console.warn('   ⚠️  AI 回傳空回應');
-      return [];
-    }
-
-    // 解析 AI 回應
-    const files = this._parseResponse(response);
-    if (files.length === 0) {
-      console.warn('   ⚠️  AI 未回傳任何檔案（可能 JSON 格式有誤）');
-    } else {
-      console.log(`   ✅ AI 規劃生成 ${files.length} 個檔案：`);
-      files.forEach(f => {
-        const icon =
-          f.filePath.includes('.test.') || f.filePath.includes('__tests__') ? '🧪' : '📄';
-        console.log(`      ${icon} ${f.filePath}`);
-      });
-    }
-    return files;
-  }
-
-  /**
-   * 寫入生成的檔案到磁盤
-   * @param {GeneratedCode[]} files
-   * @param {string} projectRoot
-   * @returns {Promise<{ written: string[], skipped: string[] }>}
-   */
-  async writeFiles(files, projectRoot = process.cwd()) {
-    const { writeFileSync, mkdirSync, existsSync } = await import('fs');
-    const { dirname, resolve } = await import('path');
-
-    const written = [];
-    const skipped = [];
-
-    for (const file of files) {
-      if (file.type === 'skip') {
-        console.log(`   ⏭️  跳過 ${file.filePath}${file.reason ? ` (${file.reason})` : ''}`);
-        skipped.push(`${file.filePath}${file.reason ? ` (${file.reason})` : ''}`);
-        continue;
-      }
-
-      const fullPath = resolve(projectRoot, file.filePath);
-      const dir = dirname(fullPath);
-
-      // 建立目錄
-      try {
-        if (!existsSync(dir)) {
-          mkdirSync(dir, { recursive: true });
-        }
-      } catch (e) {
-        console.warn(`   ⚠️  無法建立目錄 ${dir}：${e.message}`);
-        skipped.push(file.filePath);
-        continue;
-      }
-
-      // 寫入檔案（即時顯示）
-      try {
-        const isTest = file.filePath.includes('.test.') || file.filePath.includes('__tests__');
-        const icon = isTest ? '🧪' : '📄';
-        const existed = existsSync(fullPath);
-        writeFileSync(fullPath, file.content, 'utf-8');
-        written.push(file.filePath);
-        console.log(`   ${icon} ${existed ? '更新' : '新建'} ${file.filePath}`);
-      } catch (e) {
-        console.warn(`   ⚠️  無法寫入 ${file.filePath}：${e.message}`);
-        skipped.push(file.filePath);
-      }
-    }
-
-    return { written, skipped };
-  }
-
-  // ── 私有輔助方法
-
-  _buildPrompt(issueData, projectRoot) {
-    const { title, body, labels } = issueData;
-
-    return `你是一個資深軟體工程師，負責基於 GitHub Issue 生成完整的代碼框架和測試用例。
-
-## Issue 資訊
-標題：${title}
-標籤：${labels.join(', ') || '無'}
-描述：
-${body}
-
-## 任務
-1. 分析上方 Issue 的需求
-2. **同時**設計兩套檔案：
-   a. 實現檔案（src/ 中的原始碼）
-   b. 測試檔案（tests/ 或 __tests__/ 中的測試）
-3. 生成初始實現和初始測試
-
-## 重要：測試檔案生成
-- 對每個實現檔案，都生成對應的測試檔案
-- 測試檔案應放在 \`tests/\` 或 \`src/__tests__/\` 目錄
-- 測試應覆蓋主要功能（可使用 TODO 標記待補充的測試用例）
-- 測試檔案命名：實現檔案 \`.js\` → 測試檔案 \`.test.js\`
-  - 例：\`src/utils/helper.js\` → \`tests/utils/helper.test.js\`
-
-## 輸出格式
-請回傳 JSON 陣列，包含**源文件和測試文件**：
-\`\`\`json
-[
-  {
-    "filePath": "src/components/MyComponent.jsx",
-    "content": "// React 元件實現...",
-    "type": "new"
-  },
-  {
-    "filePath": "tests/components/MyComponent.test.jsx",
-    "content": "// Jest 測試...",
-    "type": "new"
-  },
-  {
-    "filePath": "src/utils/helper.js",
-    "content": "// 工具函數...",
-    "type": "new"
-  },
-  {
-    "filePath": "tests/utils/helper.test.js",
-    "content": "// 單元測試...",
-    "type": "new"
-  }
-]
-\`\`\`
-
-只回傳 JSON，不要其他文字。
-
-## 測試框架指南（假設 Jest）
-- \`describe('名稱', () => { ... })\` 分組
-- \`test('應該...', () => { ... })\` 單一測試
-- 包含 arrange-act-assert 結構
-- 對 TODO 部分用 \`test.todo('待實現')\`
-- 可包含 \`// TODO: 補充邊界情況\` 註釋
-
-專案根目錄：${projectRoot}`;
-  }
-
-  _parseResponse(response) {
-    try {
-      // 1. 先去掉 markdown code fence（```json ... ``` 或 ``` ... ```）
-      const stripped = response
-        .replace(/```json\s*/gi, '')
-        .replace(/```\s*/g, '')
-        .trim();
-
-      // 2. 嘗試直接 parse 整個回應（AI 可能真的只回傳 JSON）
-      try {
-        const direct = JSON.parse(stripped);
-        if (Array.isArray(direct)) return this._normalizeFiles(direct);
-      } catch (_) {
-        // 繼續下一步
-      }
-
-      // 3. 用括號計數找出最外層完整 JSON 陣列（比貪婪 regex 更可靠）
-      const start = stripped.indexOf('[');
-      if (start === -1) {
-        console.warn('   ⚠️  無法從 AI 回應找到 JSON 陣列');
-        if (process.env.AUTODEV_DEBUG) {
-          console.log('   --- AI 原始回應（前 500 字）---');
-          console.log(response.slice(0, 500));
-        }
-        return [];
-      }
-
-      let depth = 0;
-      let inString = false;
-      let escape = false;
-      let end = -1;
-
-      for (let i = start; i < stripped.length; i++) {
-        const ch = stripped[i];
-        if (escape) { escape = false; continue; }
-        if (ch === '\\' && inString) { escape = true; continue; }
-        if (ch === '"') { inString = !inString; continue; }
-        if (inString) continue;
-        if (ch === '[') depth++;
-        else if (ch === ']') {
-          depth--;
-          if (depth === 0) { end = i; break; }
-        }
-      }
-
-      if (end === -1) {
-        console.warn('   ⚠️  AI 回應中的 JSON 陣列括號不匹配');
-        return [];
-      }
-
-      const jsonStr = stripped.slice(start, end + 1);
-      const files = JSON.parse(jsonStr);
-
-      if (!Array.isArray(files)) {
-        console.warn('   ⚠️  AI 回應不是陣列格式');
-        return [];
-      }
-
-      return this._normalizeFiles(files);
-    } catch (error) {
-      console.warn(`   ⚠️  解析 AI 回應失敗：${error.message}`);
-      if (process.env.AUTODEV_DEBUG) {
-        console.log('   --- AI 原始回應（前 800 字）---');
-        console.log(response.slice(0, 800));
-      }
-      console.warn('   💡 設定環境變數 AUTODEV_DEBUG=1 可查看 AI 完整回應內容');
-      return [];
-    }
-  }
-
-  _normalizeFiles(files) {
-    return files.map(f => ({
-      filePath: f.filePath || '',
-      content: f.content || '',
-      type: f.type || 'new',
-      reason: f.reason || null,
-    }));
-  }}

package/src/dev-modules/core/autodev-workflow.js

@@ -1,305 +0,0 @@
-/**
- * AutoDev 工作流程編排
- * 整合 Issue 解析 → 測試執行 → 結果發佈 → commit-all → PR
- */
-
-import { IssueParser } from './issue-parser.js';
-import { TestDetector } from '../test/test-detector.js';
-import { createExecutor } from '../test/executor-factory.js';
-import { ResultFormatter, COMMENT_MARKER } from '../test/result-formatter.js';
-import { CodeGenerator } from '../ai/code-generator.js';
-import { GitHubAPI } from '../../pr-modules/core/github-api.js';
-import { commitAllProgrammatic } from '../../commands/commit-all.js';
-import { prProgrammatic } from '../../commands/pr.js';
-
-/**
- * @typedef {Object} AutodevOptions
- * @property {boolean} [dryRun]         - 乾運行：只顯示計劃，不執行
- * @property {boolean} [verbose]        - 詳細輸出
- * @property {string}  [framework]      - 強制指定框架（覆蓋自動偵測）
- * @property {boolean} [skipCommit]     - 跳過 commit-all
- * @property {boolean} [skipPr]         - 跳過 PR 建立
- * @property {boolean} [skipAll]        - 只測試 + 發佈評論，跳過 commit 和 PR
- * @property {boolean} [commitOnly]     - 測試 + commit，不建立 PR
- * @property {boolean} [skipTests]      - 無測試可執行時繼續（而非停止）
- */
-
-export class AutodevWorkflow {
-  /**
-   * @param {Object} config - .ai-git-config.js 的 autodev 區塊
-   */
-  constructor(config = {}) {
-    this.config = config;
-    this.issueParser = new IssueParser();
-    this.testDetector = new TestDetector(config.projectRoot || process.cwd());
-    this.formatter = new ResultFormatter();
-    this.codeGenerator = new CodeGenerator({
-      aiModel: config.aiModel,
-      maxRetries: config.maxRetries,
-    });
-    this.github = new GitHubAPI();
-  }
-
-  /**
-   * 主執行流程
-   * @param {string|number} issueInput
-   * @param {AutodevOptions} options
-   */
-  async execute(issueInput, options = {}) {
-    const step = (n, total, msg) =>
-      console.log(`\n[${n}/${total}] ${msg}`);
-
-    const TOTAL = this._calcTotalSteps(options);
-    let stepIdx = 0;
-
-    // ── 1. 解析 Issue ────────────────────────────────────────
-    step(++stepIdx, TOTAL, '解析 Issue...');
-    const issueData = await this._parseIssue(issueInput, options);
-
-    // ── 2. AI 自動開發（生成代碼框架）────────────────────────
-    step(++stepIdx, TOTAL, '生成代碼框架...');
-    const generatedFiles = await this._generateCode(issueData, options);
-
-    // ── 3. 偵測框架 ──────────────────────────────────────────
-    step(++stepIdx, TOTAL, '偵測測試框架...');
-    const framework = this._detectFramework(options);
-
-    // ── 4. 發現測試檔案 ──────────────────────────────────────
-    step(++stepIdx, TOTAL, '搜尋測試檔案...');
-    const testFiles = this.testDetector.discoverTests(framework, {
-      testPaths: this.config.testPaths,
-    });
-    console.log(`   找到 ${testFiles.length} 個測試檔案`);
-
-    if (options.dryRun) {
-      console.log('\n🔍 乾運行模式：以下是執行計劃\n');
-      console.log(`   Issue      : #${issueData.number} - ${issueData.title}`);
-      console.log(`   代碼檔案   : ${generatedFiles.length} 個將被建立`);
-      console.log(`   框架       : ${framework}`);
-      console.log(`   測試數量   : ${testFiles.length} 個檔案`);
-      console.log(`   Commit     : ${this._willCommit(options) ? '✅ 會執行' : '⏭️ 跳過'}`);
-      console.log(`   PR         : ${this._willCreatePR(options) ? '✅ 會執行' : '⏭️ 跳過'}`);
-      return;
-    }
-
-    if (testFiles.length === 0) {
-      console.warn('   ⚠️  未找到任何測試檔案，跳過測試步驟');
-    }
-
-    // ── 5. 執行測試 ──────────────────────────────────────────
-    step(++stepIdx, TOTAL, `執行 ${framework} 測試...`);
-    const executor = createExecutor(framework, {
-      timeout: this.config.testTimeout,
-    });
-    const testResults = await executor.run(testFiles, {
-      verbose: options.verbose,
-      projectRoot: this.config.projectRoot || process.cwd(),
-    });
-    const allPassed = testResults.failed === 0 && testResults.total > 0;
-    const passRate = testResults.total > 0
-      ? ((testResults.passed / testResults.total) * 100).toFixed(1)
-      : '-';
-    console.log(
-      `   ${allPassed ? '✅' : '❌'} ${testResults.passed}/${testResults.total} 通過（${passRate}%）· ${(testResults.duration / 1000).toFixed(1)}s`
-    );
-
-    // ── 6. 格式化結果 ─────────────────────────────────────────
-    step(++stepIdx, TOTAL, '格式化測試結果...');
-    const meta = {
-      generatedFiles: generatedFiles.length,
-    };
-    let markdown = this.formatter.formatAsMarkdown(testResults, issueData, meta);
-
-    // ── 7. 發佈到 Issue 評論（初稿，無 commit/PR 資訊）─────────
-    step(++stepIdx, TOTAL, `發佈結果到 Issue #${issueData.number}...`);
-    const commentResult = await this._postOrUpdateComment(
-      issueData,
-      markdown,
-      options
-    );
-    if (commentResult) {
-      console.log(`   📝 評論已發佈：${commentResult.url}`);
-    }
-
-    // ── 8. 若測試失敗，停止 ───────────────────────────────────
-    if (!allPassed && testResults.total > 0) {
-      console.log('\n❌ 測試未全部通過，已停止自動 commit / PR');
-      console.log('   修復失敗的測試後，重新執行 `ai autodev <issue>`');
-      return;
-    }
-
-    // 若沒有測試：預設停止，加 --skip-tests 才繼續
-    if (testResults.total === 0) {
-      if (options.skipTests) {
-        console.warn('   ⚠️  無測試可執行（--skip-tests 已啟用，繼續後續流程）');
-      } else {
-        const projectRoot = this.config.projectRoot || process.cwd();
-        console.log('\n⏸️  無測試可執行，已停止自動 commit / PR');
-        console.log('\n   最常見原因：測試檔案引用的套件尚未安裝');
-        console.log(`   👉 請先在目標專案目錄安裝依賴：`);
-        console.log(`      cd ${projectRoot}`);
-        console.log(`      npm install`);
-        console.log(`      npx jest --listTests   # 確認測試檔案是否被偵測到`);
-        console.log('\n   其他可能原因：');
-        console.log('   2. 生成的測試語法有誤（Jest 無法解析）');
-        console.log('   3. testPaths 設定未涵蓋新生成的測試路徑');
-        console.log('\n   安裝依賴並確認後，重新執行：');
-        console.log('   ai autodev <issue>');
-        console.log('\n   若確定要跳過測試直接 commit/PR：');
-        console.log('   ai autodev <issue> --skip-tests');
-        return;
-      }
-    }
-
-    // ── 9. 自動 commit-all ───────────────────────────────────
-    if (this._willCommit(options)) {
-      step(++stepIdx, TOTAL, '自動提交（ai commit-all）...');
-      const commitResult = await commitAllProgrammatic({ verbose: options.verbose });
-      if (!commitResult.success) {
-        console.error(`   ❌ 提交失敗：${commitResult.message}`);
-        console.log('   請手動執行 `ai commit-all`，然後再次執行 `ai pr`');
-        return;
-      }
-      meta.commitHash = commitResult.commitHash;
-      console.log(`   ✅ ${commitResult.message}（${commitResult.commitHash}）`);
-    }
-
-    // ── 10. 自動建立 PR ───────────────────────────────────────
-    if (this._willCreatePR(options)) {
-      step(++stepIdx, TOTAL, '自動建立 PR（ai pr）...');
-      const prResult = await prProgrammatic({ verbose: options.verbose });
-      if (!prResult.success) {
-        console.error(`   ❌ PR 建立失敗：${prResult.message}`);
-        return;
-      }
-      meta.prUrl = prResult.prUrl;
-      console.log(`   ✅ PR 已建立：${prResult.prUrl}`);
-    }
-
-    // ── 更新 Issue 評論（加入 commit/PR 資訊）───────────────
-    if (commentResult && (meta.commitHash || meta.prUrl)) {
-      markdown = this.formatter.formatAsMarkdown(testResults, issueData, meta);
-      await this._postOrUpdateComment(issueData, markdown, options, commentResult.id);
-    }
-
-    // ── 完成摘要 ──────────────────────────────────────────────
-    console.log('\n' + '═'.repeat(60));
-    console.log('🎉 ai autodev 完成！');
-    console.log(`   Issue      : #${issueData.number} - ${issueData.title}`);
-    if (generatedFiles.length > 0) console.log(`   代碼檔案   : ${generatedFiles.length} 個已建立`);
-    console.log(`   測試       : ${testResults.passed}/${testResults.total} 通過`);
-    if (meta.commitHash) console.log(`   Commit     : ${meta.commitHash}`);
-    if (meta.prUrl)      console.log(`   PR         : ${meta.prUrl}`);
-    if (commentResult)   console.log(`   評論       : ${commentResult.url}`);
-    console.log('═'.repeat(60));
-  }
-
-  // ── 私有輔助方法 ─────────────────────────────────────────────
-
-  async _parseIssue(issueInput, options) {
-    const issueData = await this.issueParser.parse(issueInput);
-    if (options.verbose) {
-      console.log(`   #${issueData.number}: ${issueData.title}`);
-      console.log(`   倉庫: ${issueData.owner}/${issueData.repo}`);
-    }
-    return issueData;
-  }
-
-  async _generateCode(issueData, options) {
-    try {
-      const projectRoot = this.config.projectRoot || process.cwd();
-      const files = await this.codeGenerator.generateCodeFiles(issueData, projectRoot);
-
-      if (files.length === 0) {
-        console.log('   ℹ️  沒有需要生成的代碼檔案');
-        return [];
-      }
-
-      // 寫入檔案（每個檔案會即時顯示名稱）
-      const { written, skipped } = await this.codeGenerator.writeFiles(files, projectRoot);
-
-      if (skipped.length > 0) {
-        console.warn(`   ⚠️  跳過 ${skipped.length} 個檔案`);
-      }
-
-      // 顯示 git diff --stat 讓用戶看到實際變動
-      if (written.length > 0) {
-        console.log(`\n   ✅ 共寫入 ${written.length} 個檔案，git 變動摘要：`);
-        try {
-          const { execSync } = await import('child_process');
-          const stat = execSync('git diff --stat HEAD 2>/dev/null || git status --short', {
-            cwd: projectRoot,
-            encoding: 'utf-8',
-          }).trim();
-          if (stat) {
-            stat.split('\n').forEach((line) => console.log(`   ${line}`));
-          }
-        } catch (_) {
-          // git diff 失敗不影響流程
-        }
-      }
-
-      return written;
-    } catch (error) {
-      console.error(`   ❌ 代碼生成失敗：${error.message}`);
-      return [];
-    }
-  }
-
-  _detectFramework(options) {
-    const forced = options.framework || this.config.framework;
-    if (forced) {
-      console.log(`   使用指定框架：${forced}`);
-      return forced;
-    }
-    const detected = this.testDetector.detectFramework();
-    if (!detected) {
-      throw new Error(
-        '無法自動偵測測試框架\n請在 .ai-git-config.js 的 autodev.framework 指定：jest / vitest / mocha'
-      );
-    }
-    console.log(`   偵測到框架：${detected}`);
-    return detected;
-  }
-
-  async _postOrUpdateComment(issueData, markdown, options, existingCommentId = null) {
-    if (options.dryRun) return null;
-
-    try {
-      const { owner, repo, number } = issueData;
-
-      // 若有已知 ID，直接更新
-      if (existingCommentId) {
-        return this.github.editIssueComment(owner, repo, existingCommentId, markdown);
-      }
-
-      // 搜尋相同 marker 的舊評論
-      const existing = this.github.findCommentWithMarker(owner, repo, number, COMMENT_MARKER);
-      if (existing) {
-        return this.github.editIssueComment(owner, repo, existing.id, markdown);
-      }
-
-      return this.github.postCommentOnIssue(owner, repo, number, markdown);
-    } catch (error) {
-      console.error(`   ⚠️  發佈評論失敗：${error.message}`);
-      return null;
-    }
-  }
-
-  _willCommit(options) {
-    return !options.skipAll && !options.skipCommit && !options.dryRun;
-  }
-
-  _willCreatePR(options) {
-    if (options.commitOnly) return false;
-    return !options.skipAll && !options.skipPr && !options.dryRun;
-  }
-
-  _calcTotalSteps(options) {
-    // 基本步驟：Issue解析 + 代碼生成 + 框架偵測 + 測試發現 + 執行 + 格式化 + 發佈
-    let count = 7;
-    if (this._willCommit(options)) count++;
-    if (this._willCreatePR(options)) count++;
-    return count;
-  }
-}