ai-git-tools 2.0.40 → 2.0.41

package/package.json

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

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

@@ -0,0 +1,169 @@
+/**
+ * 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. 設計必要的檔案結構和代碼框架
+3. 生成初始實現（可以有 TODO 註釋表示待完成部分）
+
+## 輸出格式
+請回傳 JSON 陣列，每個物件包含：
+\`\`\`json
+[
+  {
+    "filePath": "src/components/MyComponent.tsx",
+    "content": "// 完整的檔案內容...",
+    "type": "new"
+  },
+  {
+    "filePath": "src/utils/helper.ts",
+    "content": "// ...",
+    "type": "new"
+  }
+]
+\`\`\`
+
+只回傳 JSON，不要其他文字。
+
+## 檔案類型指南
+- TypeScript/JavaScript：包含正確的 import/export
+- React：使用 functional components + hooks
+- 包含基本的 JSDoc 註釋
+- 包含 TODO 或 FIXME 註釋提示需要補完的部分
+
+專案根目錄：${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;