ai-git-tools 2.0.18 → 2.0.20

package/README.md

@@ -158,7 +158,6 @@ npx ai-git-tools pr [選項]
 
 選項:
   -b, --base <branch>          目標分支 (預設: 配置檔的 defaultBase 或自動偵測)
-  -h, --head <branch>          來源分支 (預設: 當前分支，通常不需指定)
   -m, --model <model>          指定 AI 模型
   --preview                    僅預覽，不創建 PR
   --no-confirm                 跳過確認直接創建
@@ -212,16 +211,16 @@ export default {
 
   // GitHub 設定
   github: {
-    defaultBase: 'release', // 預設目標分支
+    defaultBase: 'release', // 預設目標分支：'release'=自動查找最新，或指定具體分支名
     autoLabels: true, // 自動添加 Labels
   },
 
   // Reviewer 設定
   reviewers: {
-    interactiveReviewers: false, // 啟用 reviewer 選擇
+    interactiveReviewers: true, // true=啟用互動式選擇，false=不添加任何 reviewers
     maxSuggested: 5, // 最多建議人數
     gitHistoryDepth: 20, // Git 歷史分析深度
-    excludeAuthors: [], // 排除特定作者
+    excludeAuthors: [], // 排除特定作者（最高優先順序，即使手動選擇也會被過濾）
   },
 
   // 輸出設定
@@ -232,6 +231,44 @@ export default {
 };
 \`\`\`
 
+### defaultBase 配置說明
+
+\`defaultBase\` 支援兩種模式：
+
+#### 1. 自動模式（推薦）
+```javascript
+github: {
+  defaultBase: 'release',  // 自動查找最新的 release 分支
+}
+```
+- 工具會自動偵測所有 \`release-*\` 或 \`release/*\` 格式的分支
+- 自動選擇最新版本（優先選擇月度分支，如 release-2025-m12.1）
+- 適合經常更新 release 版本的專案
+
+#### 2. 具體分支模式
+```javascript
+github: {
+  defaultBase: 'release-2025-m12.1',  // 固定使用此分支
+}
+```
+- 直接使用指定的分支名稱
+- 適合需要固定某個版本的情況
+- 或使用 \`main\`、\`develop\` 等標準分支
+
+**範例輸出**：
+```bash
+# 使用 defaultBase: 'release'
+配置檔指定使用 release 分支，正在偵測最新版本...
+📋 偵測到的 release 分支:
+  月度分支 (優先):
+    1. release-2025-m12.1 ← 最新
+    2. release-2025-m11.1
+✅ 自動選擇最新 release 分支: release-2025-m12.1
+
+# 使用 defaultBase: 'release-2025-m12.1'
+✅ 使用配置檔指定的分支: release-2025-m12.1
+```
+
 ## 🔧 環境需求
 
 - **Node.js** >= 18.0.0
@@ -267,7 +304,7 @@ npx ai-git-tools commit-all
 ### 場景 3：快速發 PR
 
 \`\`\`bash
-npx ai-git-tools pr --auto-reviewers --auto-labels
+npx ai-git-tools pr --auto-labels
 # ✅ 自動生成完整的 PR 標題和描述
 # ✅ 建議合適的 reviewers
 # ✅ 添加相關的 labels

package/bin/cli.js

@@ -51,13 +51,10 @@ program
   .command('pr')
   .description('AI 自動生成 PR 並創建 Pull Request')
   .option('--base <branch>', '指定目標分支')
-  .option('--head <branch>', '指定來源分支')
   .option('--model <model>', '指定 AI 模型')
   .option('--org <org-name>', '指定 GitHub 組織名稱')
-  .option('--draft', '創建草稿 PR')
   .option('--preview', '僅預覽 PR 內容，不實際創建')
   .option('--no-confirm', '跳過確認直接創建')
-  .option('--auto-reviewers', '自動選擇 reviewers')
   .option('--auto-labels', '自動添加 Labels')
   .option('--no-labels', '不添加 Labels')
   .action(prCommand);

package/package.json

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

package/src/core/config-loader.js

@@ -119,27 +119,18 @@ export function parsePRCliArgs() {
       case '--base':
         config.baseBranch = args[++i];
         break;
-      case '--head':
-        config.headBranch = args[++i];
-        break;
       case '--model':
         config.model = args[++i];
         break;
       case '--org':
         config.orgName = args[++i];
         break;
-      case '--draft':
-        config.draft = true;
-        break;
       case '--preview':
         config.preview = true;
         break;
       case '--no-confirm':
         config.noConfirm = true;
         break;
-      case '--auto-reviewers':
-        config.autoReviewers = true;
-        break;
       case '--auto-labels':
         config.autoLabels = true;
         break;

package/src/pr-modules/core/config-loader.js

@@ -100,7 +100,6 @@ function showHelp() {
 
 選項：
   --base <branch>      指定目標分支 (預設: 使用配置檔的 defaultBase 或自動偵測)
-  --head <branch>      指定來源分支 (預設: 當前分支，通常不需要指定)
   --model <model>      指定 AI 模型 (預設: gpt-4.1)
   --preview            僅預覽 PR 內容，不實際創建
   --no-confirm         跳過確認直接創建

package/src/pr-modules/core/workflow.js

@@ -101,8 +101,31 @@ export class PRWorkflow {
     if (!baseBranch) {
       // 優先使用配置檔中的 defaultBase
       if (this.config.github?.defaultBase) {
-        baseBranch = this.config.github.defaultBase;
-        log.success(`使用配置檔指定的分支: ${baseBranch}\n`);
+        const defaultBase = this.config.github.defaultBase;
+        
+        // 如果 defaultBase 是 'release'，則自動查找最新的 release 分支
+        if (defaultBase === 'release' || defaultBase.match(/^release$/i)) {
+          log.step('配置檔指定使用 release 分支，正在偵測最新版本...\n');
+          const allBranches = this.git.detectReleaseBranches();
+          const latestRelease = this.git.findLatestReleaseBranch();
+
+          if (latestRelease) {
+            baseBranch = latestRelease;
+            this.displayDetectedBranches(allBranches, latestRelease);
+            log.success(`自動選擇最新 release 分支: ${baseBranch}`);
+            log.info(`提示: 使用 --base <分支名> 指定其他分支\n`);
+          } else {
+            throw new PRError('未偵測到任何 release 分支', 'NO_RELEASE_BRANCH', [
+              '使用 --base 參數指定目標分支',
+              '或在 .ai-git-config.js 中設置具體的分支名（如 release-2025-m12.1）',
+              '確認遠端分支存在: git branch -r | grep release',
+            ]);
+          }
+        } else {
+          // 使用配置檔中指定的具體分支名
+          baseBranch = defaultBase;
+          log.success(`使用配置檔指定的分支: ${baseBranch}\n`);
+        }
       } else {
         // 如果沒有配置，則自動偵測最新的 release 分支
         log.step('正在偵測 release 分支...\n');
@@ -324,6 +347,13 @@ export class PRWorkflow {
       return null;
     }
 
+    // 如果禁用互動式選擇，不添加任何 reviewers
+    if (!this.config.reviewers.interactiveReviewers) {
+      console.log('ℹ️  已禁用 reviewer 選擇（interactiveReviewers: false）\n');
+      log.info('提示: 你可以在創建 PR 後手動添加 reviewers\n');
+      return null;
+    }
+
     // 獲取當前用戶
     const currentUser = this.git.getCurrentUser();
 
@@ -332,12 +362,6 @@ export class PRWorkflow {
       changeData.changedFiles
     );
 
-    // 如果禁用互動式選擇，直接自動選擇
-    if (!this.config.reviewers.interactiveReviewers) {
-      console.log('🤖 自動選擇 reviewers（基於 Git 歷史）\n');
-      return this.reviewerSelector.autoSelectReviewers(suggestedReviewers, currentUser);
-    }
-
     // 抓取 GitHub 團隊資訊（只在互動模式需要）
     const teams = await this.github.fetchTeams();
 

package/src/pr-modules/reviewers/reviewer-selector.js

@@ -178,16 +178,30 @@ export class ReviewerSelector {
       }
     });
 
+    // 應用 excludeAuthors 過濾（優先順序最高）
+    const filteredIndividuals = selectedIndividuals.filter((login) => {
+      const shouldExclude = this.excludeAuthors.some((excluded) => {
+        const normalizedExcluded = excluded.toLowerCase();
+        return login.toLowerCase().includes(normalizedExcluded);
+      });
+      
+      if (shouldExclude) {
+        log.warning(`已排除 @${login}（在 excludeAuthors 列表中）`);
+      }
+      
+      return !shouldExclude;
+    });
+
     console.log('');
     if (selectedTeams.length > 0) {
       log.success(`已選擇團隊: ${selectedTeams.join(', ')}`);
     }
-    if (selectedIndividuals.length > 0) {
-      log.success(`已選擇個人: ${selectedIndividuals.map((u) => `@${u}`).join(', ')}`);
+    if (filteredIndividuals.length > 0) {
+      log.success(`已選擇個人: ${filteredIndividuals.map((u) => `@${u}`).join(', ')}`);
     }
     console.log('');
 
-    return { teams: selectedTeams, individuals: selectedIndividuals };
+    return { teams: selectedTeams, individuals: filteredIndividuals };
   }
 
   /**
@@ -217,16 +231,10 @@ export class ReviewerSelector {
   }
 
   /**
-   * 選擇 Reviewers（根據模式）
+   * 選擇 Reviewers（互動模式）
    */
   async select(teamsData, suggestedReviewers, currentUser) {
-    if (this.interactiveReviewers) {
-      // interactiveReviewers: true 表示啟用互動式選擇（手動選擇）
-      return this.selectInteractive(teamsData, suggestedReviewers, currentUser);
-    } else {
-      // interactiveReviewers: false 表示自動選擇（基於 Git 歷史）
-      console.log('🤖 自動選擇 reviewers（基於 Git 歷史）\n');
-      return this.autoSelectReviewers(suggestedReviewers, currentUser);
-    }
+    // 此方法現在只在 interactiveReviewers: true 時被調用
+    return this.selectInteractive(teamsData, suggestedReviewers, currentUser);
   }
 }