ai-git-tools 2.0.39 → 2.0.41

package/bin/cli.js

@@ -15,6 +15,7 @@ import { commitCommand } from '../src/commands/commit.js';
 import { commitAllCommand } from '../src/commands/commit-all.js';
 import { prCommand } from '../src/commands/pr.js';
 import { initCommand } from '../src/commands/init.js';
+import { autodevCommand } from '../src/commands/autodev.js';
 
 // 讀取 package.json 獲取版本號
 const __filename = fileURLToPath(import.meta.url);
@@ -96,4 +97,24 @@ program
     }
   });
 
+// AutoDev 命令
+program
+  .command('autodev <issue>')
+  .description('全自動開發流程：Issue → 測試 → commit-all → PR')
+  .option('--dry-run', '乾運行：顯示計劃但不執行')
+  .option('-v, --verbose', '詳細輸出')
+  .option('--framework <name>', '強制指定測試框架（jest / vitest / mocha）')
+  .option('--skip-commit', '跳過自動 commit')
+  .option('--skip-pr', '跳過自動 PR 建立')
+  .option('--skip-all', '只執行測試並發佈評論')
+  .option('--commit-only', '執行測試 + commit，不建立 PR')
+  .action(async (issue, options) => {
+    try {
+      await autodevCommand(issue, options);
+      process.exit(0);
+    } catch (error) {
+      process.exit(1);
+    }
+  });
+
 program.parse();

package/package.json

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

package/src/commands/autodev.js

@@ -0,0 +1,51 @@
+/**
+ * AutoDev 命令
+ * 完整自動化開發流程：Issue 解析 → 測試 → 發佈評論 → commit-all → PR
+ *
+ * 使用方式：
+ *   ai autodev <issue>
+ *   ai autodev 123
+ *   ai autodev https://github.com/org/repo/issues/123
+ *   ai autodev 123 --dry-run
+ *   ai autodev 123 --skip-pr
+ */
+
+import { AutodevWorkflow } from '../dev-modules/core/autodev-workflow.js';
+import { loadAutodevConfig } from '../core/config-loader.js';
+import { handleError } from '../utils/helpers.js';
+
+/**
+ * AutoDev 命令主函數
+ * @param {string|number} issueInput - Issue 編號或 URL
+ * @param {Object} cliOptions - 來自 commander 的選項
+ */
+export async function autodevCommand(issueInput, cliOptions = {}) {
+  if (!issueInput) {
+    console.error('❌ 請提供 Issue 編號或 URL');
+    console.error('   用法：ai autodev <issue>');
+    console.error('   範例：ai autodev 123');
+    process.exit(1);
+  }
+
+  try {
+    // 載入設定
+    const config = await loadAutodevConfig();
+
+    // 合併 CLI 選項（CLI 優先）
+    const options = {
+      dryRun:    cliOptions.dryRun    ?? false,
+      verbose:   cliOptions.verbose   ?? config.verbose ?? false,
+      framework: cliOptions.framework ?? config.framework ?? null,
+      skipCommit: cliOptions.skipCommit ?? config.skipCommit ?? false,
+      skipPr:    cliOptions.skipPr    ?? config.skipPr    ?? false,
+      skipAll:   cliOptions.skipAll   ?? false,
+      commitOnly: cliOptions.commitOnly ?? false,
+    };
+
+    const workflow = new AutodevWorkflow(config);
+    await workflow.execute(issueInput, options);
+  } catch (error) {
+    handleError(error);
+    throw error;
+  }
+}

package/src/commands/commit-all.js

@@ -459,3 +459,82 @@ export async function commitAllCommand() {
     throw error;
   }
 }
+
+// ─────────────────────────────────────────────────────────────
+// 程序化 API（供 ai autodev 呼叫，不影響 CLI 行為）
+// ─────────────────────────────────────────────────────────────
+
+/**
+ * 程序化執行 commit-all 邏輯，供其他模組呼叫
+ * 不會呼叫 process.exit()，而是回傳結果物件
+ *
+ * @param {Object} [options]
+ * @param {boolean} [options.verbose]
+ * @returns {Promise<{ success: boolean, commitCount: number, message: string }>}
+ */
+export async function commitAllProgrammatic(options = {}) {
+  const logger = new Logger();
+
+  try {
+    const config = await loadCommitConfig();
+    if (options.verbose) {
+      config.output.verbose = true;
+    }
+
+    const changes = getAllChanges();
+    if (changes.length === 0) {
+      return { success: true, commitCount: 0, message: '沒有需要提交的變更' };
+    }
+
+    const groups = await analyzeAndGroupChanges(changes, config);
+    if (!groups || groups.length === 0) {
+      return { success: false, commitCount: 0, message: 'AI 分析失敗，無法產生分組' };
+    }
+
+    // 補入未分組的檔案
+    const groupedIndices = new Set(groups.flatMap((g) => g.file_indices));
+    const ungrouped = [...Array(changes.length).keys()].filter((i) => !groupedIndices.has(i));
+    if (ungrouped.length > 0) {
+      groups.push({
+        group_name: '其他變更',
+        commit_type: 'chore',
+        commit_scope: 'misc',
+        file_indices: ungrouped,
+        description: '未能自動分類的其他變更',
+      });
+    }
+
+    let successCount = 0;
+    for (let i = 0; i < groups.length; i++) {
+      const group = groups[i];
+      const groupFiles = group.file_indices.map((index) => changes[index]);
+      const ok = await commitGroup(group, groupFiles, config);
+      if (ok) successCount++;
+    }
+
+    // 清理 staged
+    try {
+      execSync('git reset HEAD -- .', { stdio: 'ignore' });
+    } catch (_) { /* 忽略 */ }
+
+    if (successCount === 0) {
+      return { success: false, commitCount: 0, message: '所有群組提交失敗' };
+    }
+
+    // 取得最新 commit hash
+    let commitHash = '';
+    try {
+      commitHash = execSync('git rev-parse --short HEAD', { encoding: 'utf-8' }).trim();
+    } catch (_) { /* 忽略 */ }
+
+    return {
+      success: true,
+      commitCount: successCount,
+      commitHash,
+      message: `成功提交 ${successCount}/${groups.length} 個群組`,
+    };
+  } catch (error) {
+    logger.error(`commitAllProgrammatic 失敗：${error.message}`);
+    return { success: false, commitCount: 0, message: error.message };
+  }
+}

package/src/commands/pr.js

@@ -62,3 +62,66 @@ export async function prCommand() {
     throw error;
   }
 }
+
+// ─────────────────────────────────────────────────────────────
+// 程序化 API（供 ai autodev 呼叫，不影響 CLI 行為）
+// ─────────────────────────────────────────────────────────────
+
+/**
+ * 程序化執行 PR 建立流程，供其他模組呼叫
+ * 不互動（noConfirm = true），直接建立 PR 並回傳結果
+ *
+ * @param {Object} [options]
+ * @param {string} [options.base]       - 目標分支
+ * @param {string} [options.head]       - 來源分支
+ * @param {boolean} [options.verbose]
+ * @param {Object} [options.testResults] - 注入測試結果到 PR 描述（保留供未來擴充）
+ * @returns {Promise<{ success: boolean, prUrl: string|null, prNumber: number|null, message: string }>}
+ */
+export async function prProgrammatic(options = {}) {
+  const logger = new Logger();
+
+  if (!checkGHAuth(logger)) {
+    return { success: false, prUrl: null, prNumber: null, message: 'GitHub CLI 未登入' };
+  }
+
+  try {
+    const config = await loadConfig();
+
+    // 程序化呼叫：跳過互動確認
+    config.noConfirm = true;
+    if (options.base) config.baseBranch = options.base;
+    if (options.head) config.headBranch = options.head;
+    if (options.verbose) config.output.verbose = true;
+
+    const workflow = new PRWorkflow(config);
+
+    // 攔截 PRWorkflow 建立的 PR URL
+    let prUrl = null;
+    let prNumber = null;
+    const originalCreatePR = workflow.createPR?.bind(workflow);
+    if (originalCreatePR) {
+      workflow.createPR = async (...args) => {
+        const url = await originalCreatePR(...args);
+        prUrl = url;
+        if (url) {
+          const match = url.match(/\/pull\/(\d+)/);
+          if (match) prNumber = parseInt(match[1], 10);
+        }
+        return url;
+      };
+    }
+
+    await workflow.execute();
+
+    return {
+      success: true,
+      prUrl,
+      prNumber,
+      message: prUrl ? `PR 已建立：${prUrl}` : 'PR 執行完成',
+    };
+  } catch (error) {
+    logger.error(`prProgrammatic 失敗：${error.message}`);
+    return { success: false, prUrl: null, prNumber: null, message: error.message };
+  }
+}

package/src/core/config-loader.js

@@ -179,3 +179,46 @@ export async function loadPRConfig() {
 
   return config;
 }
+
+/**
+ * 載入 AutoDev 配置
+ * 讀取 .ai-git-config.js（或 .mjs）的 autodev 區塊
+ * 所有欄位皆選填，未設定時使用合理預設值
+ *
+ * @returns {Promise<Object>}
+ */
+export async function loadAutodevConfig() {
+  const defaults = {
+    framework: null,       // null = 自動偵測
+    testPaths: [],         // 空 = 自動發現
+    testTimeout: 300_000,  // 5 分鐘
+    skipCommit: false,
+    skipPr: false,
+    verbose: false,
+    projectRoot: process.cwd(),
+  };
+
+  // 支援 .ai-git-config.js 和 .ai-git-config.mjs
+  const candidates = [
+    resolve(process.cwd(), '.ai-git-config.js'),
+    resolve(process.cwd(), '.ai-git-config.mjs'),
+  ];
+
+  let userAutodev = {};
+  for (const configPath of candidates) {
+    if (existsSync(configPath)) {
+      try {
+        const imported = await import(`file://${configPath}`);
+        userAutodev = (imported.default || {}).autodev || {};
+        break;
+      } catch (error) {
+        console.warn(`⚠️  載入 autodev 配置失敗: ${error.message}`);
+      }
+    }
+  }
+
+  return {
+    ...defaults,
+    ...userAutodev,
+  };
+}

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 [];
+    }
+  }
+}