ai-git-tools 2.0.40 → 2.0.42

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-git-tools",
-  "version": "2.0.40",
+  "version": "2.0.42",
   "description": "AI-powered Git automation tools for commit messages and PR generation",
   "main": "src/index.js",
   "type": "module",

package/src/core/config-loader.js

@@ -196,6 +196,9 @@ export async function loadAutodevConfig() {
     skipPr: false,
     verbose: false,
     projectRoot: process.cwd(),
+    // AI 設定（可被 autodev 子區塊或全域 ai 區塊覆蓋）
+    aiModel: 'gpt-4.1',
+    maxRetries: 3,
   };
 
   // 支援 .ai-git-config.js 和 .ai-git-config.mjs
@@ -205,11 +208,14 @@ export async function loadAutodevConfig() {
   ];
 
   let userAutodev = {};
+  let userAi = {};
   for (const configPath of candidates) {
     if (existsSync(configPath)) {
       try {
         const imported = await import(`file://${configPath}`);
-        userAutodev = (imported.default || {}).autodev || {};
+        const root = imported.default || {};
+        userAutodev = root.autodev || {};
+        userAi = root.ai || {};  // 讀取全域 ai 區塊
         break;
       } catch (error) {
         console.warn(`⚠️  載入 autodev 配置失敗: ${error.message}`);
@@ -219,6 +225,10 @@ export async function loadAutodevConfig() {
 
   return {
     ...defaults,
+    // 全域 ai 區塊優先度低於 autodev 子區塊
+    aiModel: userAutodev.aiModel ?? userAi.model ?? defaults.aiModel,
+    maxRetries: userAutodev.maxRetries ?? userAi.maxRetries ?? defaults.maxRetries,
+    // 其他 autodev 欄位
     ...userAutodev,
   };
 }

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

@@ -0,0 +1,189 @@
+/**
+ * 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);
+
+    console.log('   🤖 調用 AI 生成代碼框架...');
+
+    let response;
+    try {
+      response = await AIClient.sendAndWait(
+        prompt,
+        this.model,
+        this.config.maxRetries || 3
+      );
+    } catch (error) {
+      console.warn(`   ⚠️  AI 調用失敗：${error.message}`);
+      return [];
+    }
+
+    // 解析 AI 回應
+    const files = this._parseResponse(response);
+    console.log(`   生成 ${files.length} 個檔案`);
+    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') {
+        skipped.push(`${file.filePath} (${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}`);
+        skipped.push(file.filePath);
+        continue;
+      }
+
+      // 寫入檔案
+      try {
+        writeFileSync(fullPath, file.content, 'utf-8');
+        written.push(file.filePath);
+      } catch (e) {
+        console.warn(`   ⚠️  無法寫入 ${file.filePath}`);
+        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 {
+      // 找 JSON 陣列
+      const match = response.match(/\[[\s\S]*\]/);
+      if (!match) {
+        console.warn('   ⚠️  無法從 AI 回應找到 JSON 陣列');
+        return [];
+      }
+
+      const files = JSON.parse(match[0]);
+      if (!Array.isArray(files)) {
+        console.warn('   ⚠️  AI 回應不是陣列格式');
+        return [];
+      }
+
+      return files.map((f) => ({
+        filePath: f.filePath || '',
+        content: f.content || '',
+        type: f.type || 'new',
+        reason: f.reason || null,
+      }));
+    } catch (error) {
+      console.warn(`   ⚠️  解析 AI 回應失敗：${error.message}`);
+      return [];
+    }
+  }
+}

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

@@ -7,6 +7,7 @@ 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';
@@ -31,6 +32,10 @@ export class AutodevWorkflow {
     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();
   }
 
@@ -50,11 +55,15 @@ export class AutodevWorkflow {
     step(++stepIdx, TOTAL, '解析 Issue...');
     const issueData = await this._parseIssue(issueInput, options);
 
-    // ── 2. 偵測框架 ──────────────────────────────────────────
+    // ── 2. AI 自動開發（生成代碼框架）────────────────────────
+    step(++stepIdx, TOTAL, '生成代碼框架...');
+    const generatedFiles = await this._generateCode(issueData, options);
+
+    // ── 3. 偵測框架 ──────────────────────────────────────────
     step(++stepIdx, TOTAL, '偵測測試框架...');
     const framework = this._detectFramework(options);
 
-    // ── 3. 發現測試檔案 ──────────────────────────────────────
+    // ── 4. 發現測試檔案 ──────────────────────────────────────
     step(++stepIdx, TOTAL, '搜尋測試檔案...');
     const testFiles = this.testDetector.discoverTests(framework, {
       testPaths: this.config.testPaths,
@@ -63,11 +72,12 @@ export class AutodevWorkflow {
 
     if (options.dryRun) {
       console.log('\n🔍 乾運行模式：以下是執行計劃\n');
-      console.log(`   Issue   : #${issueData.number} - ${issueData.title}`);
-      console.log(`   框架    : ${framework}`);
-      console.log(`   測試數量: ${testFiles.length} 個檔案`);
-      console.log(`   Commit  : ${this._willCommit(options) ? '✅ 會執行' : '⏭️ 跳過'}`);
-      console.log(`   PR      : ${this._willCreatePR(options) ? '✅ 會執行' : '⏭️ 跳過'}`);
+      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;
     }
 
@@ -75,7 +85,7 @@ export class AutodevWorkflow {
       console.warn('   ⚠️  未找到任何測試檔案，跳過測試步驟');
     }
 
-    // ── 4. 執行測試 ──────────────────────────────────────────
+    // ── 5. 執行測試 ──────────────────────────────────────────
     step(++stepIdx, TOTAL, `執行 ${framework} 測試...`);
     const executor = createExecutor(framework, {
       timeout: this.config.testTimeout,
@@ -92,13 +102,15 @@ export class AutodevWorkflow {
       `   ${allPassed ? '✅' : '❌'} ${testResults.passed}/${testResults.total} 通過（${passRate}%）· ${(testResults.duration / 1000).toFixed(1)}s`
     );
 
-    // ── 5. 格式化結果 ─────────────────────────────────────────
+    // ── 6. 格式化結果 ─────────────────────────────────────────
     step(++stepIdx, TOTAL, '格式化測試結果...');
-    const meta = {};
+    const meta = {
+      generatedFiles: generatedFiles.length,
+    };
     let markdown = this.formatter.formatAsMarkdown(testResults, issueData, meta);
 
-    // ── 6. 發佈到 Issue 評論（初稿，無 commit/PR 資訊）─────────
-    step(++stepIdx, TOTAL, `發佈測試結果到 Issue #${issueData.number}...`);
+    // ── 7. 發佈到 Issue 評論（初稿，無 commit/PR 資訊）─────────
+    step(++stepIdx, TOTAL, `發佈結果到 Issue #${issueData.number}...`);
     const commentResult = await this._postOrUpdateComment(
       issueData,
       markdown,
@@ -108,7 +120,7 @@ export class AutodevWorkflow {
       console.log(`   📝 評論已發佈：${commentResult.url}`);
     }
 
-    // ── 7. 若測試失敗，停止 ───────────────────────────────────
+    // ── 8. 若測試失敗，停止 ───────────────────────────────────
     if (!allPassed && testResults.total > 0) {
       console.log('\n❌ 測試未全部通過，已停止自動 commit / PR');
       console.log('   修復失敗的測試後，重新執行 `ai autodev <issue>`');
@@ -120,7 +132,7 @@ export class AutodevWorkflow {
       console.warn('   ⚠️  無測試可執行，繼續後續流程');
     }
 
-    // ── 8. 自動 commit-all ───────────────────────────────────
+    // ── 9. 自動 commit-all ───────────────────────────────────
     if (this._willCommit(options)) {
       step(++stepIdx, TOTAL, '自動提交（ai commit-all）...');
       const commitResult = await commitAllProgrammatic({ verbose: options.verbose });
@@ -133,7 +145,7 @@ export class AutodevWorkflow {
       console.log(`   ✅ ${commitResult.message}（${commitResult.commitHash}）`);
     }
 
-    // ── 9. 自動建立 PR ────────────────────────────────────────
+    // ── 10. 自動建立 PR ───────────────────────────────────────
     if (this._willCreatePR(options)) {
       step(++stepIdx, TOTAL, '自動建立 PR（ai pr）...');
       const prResult = await prProgrammatic({ verbose: options.verbose });
@@ -154,11 +166,12 @@ export class AutodevWorkflow {
     // ── 完成摘要 ──────────────────────────────────────────────
     console.log('\n' + '═'.repeat(60));
     console.log('🎉 ai autodev 完成！');
-    console.log(`   Issue    : #${issueData.number} - ${issueData.title}`);
-    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(`   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));
   }
 
@@ -173,6 +186,34 @@ export class AutodevWorkflow {
     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);
+      console.log(`   ✅ 已寫入 ${written.length} 個檔案`);
+      if (skipped.length > 0) {
+        console.warn(`   ⚠️  跳過 ${skipped.length} 個檔案`);
+      }
+
+      if (options.verbose) {
+        written.forEach((f) => console.log(`      新建: ${f}`));
+      }
+
+      return written;
+    } catch (error) {
+      console.error(`   ❌ 代碼生成失敗：${error.message}`);
+      return [];
+    }
+  }
+
   _detectFramework(options) {
     const forced = options.framework || this.config.framework;
     if (forced) {
@@ -223,8 +264,8 @@ export class AutodevWorkflow {
   }
 
   _calcTotalSteps(options) {
-    // 基本步驟：Issue解析 + 框架偵測 + 測試發現 + 執行 + 格式化 + 發佈
-    let count = 6;
+    // 基本步驟：Issue解析 + 代碼生成 + 框架偵測 + 測試發現 + 執行 + 格式化 + 發佈
+    let count = 7;
     if (this._willCommit(options)) count++;
     if (this._willCreatePR(options)) count++;
     return count;