ai-git-tools 2.0.8 → 2.0.10

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

@@ -0,0 +1,371 @@
+import { createInterface } from 'readline';
+import { GitOperations } from './git-operations.js';
+import { GitHubAPI } from './github-api.js';
+import { AIAnalyzer } from '../ai/code-analyzer.js';
+import { LabelAnalyzer } from '../ai/label-analyzer.js';
+import { ReviewerSelector } from '../reviewers/reviewer-selector.js';
+import { Logger } from '../ui/logger.js';
+import { PRError, log } from '../utils/helpers.js';
+import { CONSTANTS, colors } from '../utils/constants.js';
+
+/**
+ * PR 工作流程編排
+ */
+export class PRWorkflow {
+  constructor(config) {
+    this.config = config;
+    this.git = new GitOperations();
+    this.github = new GitHubAPI({ orgName: config.github.orgName });
+    this.ai = new AIAnalyzer({ model: config.ai.model });
+    this.labelAnalyzer = new LabelAnalyzer();
+    this.reviewerSelector = new ReviewerSelector({
+      autoReviewers: config.reviewers.autoSelect,
+      maxSuggested: config.reviewers.maxSuggested,
+      gitHistoryDepth: config.reviewers.gitHistoryDepth,
+      excludeAuthors: config.reviewers.excludeAuthors,
+    });
+    this.logger = new Logger();
+  }
+
+  /**
+   * 執行完整工作流程
+   */
+  async execute() {
+    // 1. 驗證環境和分支
+    const { baseBranch, headBranch } = await this.detectAndValidateBranches();
+
+    // 2. 檢查是否有變更
+    await this.validateChanges(baseBranch, headBranch);
+
+    // 3. 推送到遠端（預覽模式跳過）
+    if (!this.config.preview) {
+      await this.pushToRemote(headBranch);
+    }
+
+    // 4. 收集變更資訊
+    const changeData = this.collectChangeData(baseBranch, headBranch);
+
+    // 5. AI 分析和生成 PR 內容
+    const prContent = await this.generatePRContent(changeData);
+
+    // 6. 顯示預覽
+    this.displayPreview(prContent, changeData.stats);
+
+    // 預覽模式：僅顯示不創建
+    if (this.config.preview) {
+      log.info('預覽模式：未創建 PR');
+      return;
+    }
+
+    // 7. 選擇 Reviewers
+    const reviewers = await this.selectReviewers(changeData);
+
+    // 8. 確認創建
+    if (!this.config.noConfirm) {
+      const confirmed = await this.askConfirmation('是否創建此 Pull Request?');
+      if (!confirmed) {
+        log.info('已取消創建 PR');
+        return;
+      }
+    }
+
+    // 9. 創建 PR
+    const prUrl = await this.createPR(prContent, baseBranch, headBranch, reviewers);
+
+    // 10. 添加 Labels（如果啟用）
+    if (this.config.github.autoLabels && prUrl) {
+      const prNumber = prUrl.split('/').pop();
+      await this.addLabels(prNumber, {
+        ...prContent,
+        stats: changeData.stats,
+      });
+    }
+
+    this.logger.success('完成！');
+  }
+
+  /**
+   * 偵測和驗證分支
+   */
+  async detectAndValidateBranches() {
+    // 獲取當前分支
+    const currentBranch = this.git.getCurrentBranch();
+    let headBranch = this.config.headBranch || currentBranch;
+    let baseBranch = this.config.baseBranch;
+
+    // 自動偵測 base branch
+    if (!baseBranch) {
+      log.step('正在偵測 release 分支...\n');
+      const allBranches = this.git.detectReleaseBranches();
+      const latestRelease = this.git.findLatestReleaseBranch();
+
+      if (latestRelease) {
+        baseBranch = latestRelease;
+        this.displayDetectedBranches(allBranches, latestRelease);
+        log.success(`自動選擇最新分支: ${baseBranch}`);
+        log.info(`提示: 使用 --base <分支名> 指定其他分支\n`);
+      } else {
+        throw new PRError('未偵測到任何 release 分支', 'NO_RELEASE_BRANCH', [
+          '使用 --base 參數指定目標分支',
+          '確認遠端分支存在: git branch -r | grep release',
+        ]);
+      }
+    }
+
+    // 檢查是否在 base branch
+    if (currentBranch === baseBranch) {
+      throw new PRError(`你目前在 ${baseBranch} 分支，請切換到 feature 分支`, 'ON_BASE_BRANCH', [
+        '切換到 feature 分支: git checkout <feature-branch>',
+      ]);
+    }
+
+    console.log(`📊 準備創建 PR: ${headBranch} → ${baseBranch}\n`);
+
+    return { baseBranch, headBranch };
+  }
+
+  /**
+   * 顯示偵測到的分支
+   */
+  displayDetectedBranches(allBranches, latestRelease) {
+    const monthlyBranches = allBranches.filter((b) => b.includes('-m'));
+    const weeklyBranches = allBranches.filter((b) => b.includes('-w'));
+
+    console.log('📋 偵測到的 release 分支:\n');
+
+    if (monthlyBranches.length > 0) {
+      console.log('  月度分支 (優先):');
+      monthlyBranches.slice(0, 3).forEach((branch, index) => {
+        const marker = branch === latestRelease ? ' ← 最新' : '';
+        console.log(`    ${index + 1}. ${branch}${marker}`);
+      });
+      if (monthlyBranches.length > 3) {
+        console.log(`    ... 還有 ${monthlyBranches.length - 3} 個月度分支`);
+      }
+    }
+
+    if (weeklyBranches.length > 0) {
+      console.log('\n  週度分支:');
+      weeklyBranches.slice(0, 3).forEach((branch, index) => {
+        const marker = branch === latestRelease ? ' ← 最新' : '';
+        console.log(`    ${index + 1}. ${branch}${marker}`);
+      });
+      if (weeklyBranches.length > 3) {
+        console.log(`    ... 還有 ${weeklyBranches.length - 3} 個週度分支`);
+      }
+    }
+
+    console.log('');
+  }
+
+  /**
+   * 驗證變更
+   */
+  async validateChanges(baseBranch, headBranch) {
+    // 先同步遠端資訊
+    log.step('正在同步遠端資訊...');
+    await this.git.fetch();
+    log.success('同步完成\n');
+
+    // 檢查本地 commit 差異
+    let localCommits;
+    try {
+      localCommits = this.git.getCommits(baseBranch, headBranch, {
+        oneline: true,
+        noDecorate: true,
+      });
+    } catch (error) {
+      throw new PRError(
+        `無法比較分支差異，請確認 origin/${baseBranch} 分支存在`,
+        'BRANCH_COMPARE_FAILED',
+        ['同步遠端: git fetch origin', `檢查分支: git branch -r | grep ${baseBranch}`]
+      );
+    }
+
+    if (!localCommits.trim()) {
+      throw new PRError(`${headBranch} 和 origin/${baseBranch} 之間沒有新的 commit`, 'NO_COMMITS', [
+        '檢查當前分支: git branch',
+        `查看分支歷史: git log origin/${baseBranch}..${headBranch}`,
+        '確認是否有未提交的變更: git status',
+      ]);
+    }
+
+    // 顯示 commit 預覽
+    console.log(`${colors.cyan}📝 本地 commit 預覽（相對於 origin/${baseBranch}）:${colors.reset}`);
+    const commitLines = localCommits.split('\n');
+    console.log(
+      commitLines
+        .slice(0, CONSTANTS.MAX_COMMIT_PREVIEW)
+        .map((line) => `  ${line}`)
+        .join('\n')
+    );
+    if (commitLines.length > CONSTANTS.MAX_COMMIT_PREVIEW) {
+      console.log(`  ... 還有 ${commitLines.length - CONSTANTS.MAX_COMMIT_PREVIEW} 個 commit`);
+    }
+    console.log('');
+  }
+
+  /**
+   * 推送到遠端
+   */
+  async pushToRemote(headBranch) {
+    log.step(`推送到遠端分支: origin/${headBranch}`);
+    await this.git.push(headBranch);
+    log.success('推送成功\n');
+
+    // 等待 GitHub 同步
+    log.info('等待 GitHub 同步...');
+    await new Promise((resolve) => setTimeout(resolve, CONSTANTS.GITHUB_SYNC_DELAY));
+
+    // 重新同步
+    await this.git.fetch();
+    log.success('同步完成\n');
+  }
+
+  /**
+   * 收集變更資料
+   */
+  collectChangeData(baseBranch, headBranch) {
+    const stats = this.git.getChangeStats(baseBranch, headBranch);
+    const changedFiles = this.git.getChangedFiles(baseBranch, headBranch);
+    const commits = this.git.getCommits(baseBranch, headBranch);
+    const diff = this.git.getDiff(baseBranch, headBranch);
+    const truncatedDiff = this.git.truncateDiff(diff);
+
+    console.log(`📈 變更統計: ${stats.stats}`);
+    console.log(`📁 影響檔案: ${stats.filesChanged} 個\n`);
+
+    if (truncatedDiff.length < diff.length) {
+      log.info(`變更內容較大，已智能截斷 (${diff.length} → ${truncatedDiff.length} 字元)\n`);
+    }
+
+    return { stats, changedFiles, commits, diff: truncatedDiff };
+  }
+
+  /**
+   * 生成 PR 內容
+   */
+  async generatePRContent(changeData) {
+    log.step(`正在使用 AI 生成 PR 內容 (${this.config.ai.model})...\n`);
+
+    // 生成 PR 標題和描述
+    const { title, body } = await this.ai.generatePRContent(changeData.commits, changeData.diff);
+
+    // 分析影響範圍
+    log.step('正在使用 AI 深度分析影響範圍和潛在問題...\n');
+    const { blastRadius, warnings } = await this.ai.analyzeImpact(
+      changeData.changedFiles,
+      changeData.diff,
+      changeData.commits
+    );
+
+    // 顯示分析結果摘要
+    this.displayAnalysisSummary(blastRadius, warnings);
+
+    // 將分析結果附加到 body
+    const enhancedBody = this.ai.appendAnalysisToBody(body, blastRadius, warnings);
+
+    return { title, body: enhancedBody, blastRadius, warnings };
+  }
+
+  /**
+   * 顯示分析結果摘要
+   */
+  displayAnalysisSummary(blastRadius, warnings) {
+    console.log(`${colors.cyan}📊 AI 分析結果:${colors.reset}`);
+    if (blastRadius.modules.length > 0) {
+      console.log(`  • 影響模組: ${blastRadius.modules.join('、')}`);
+    }
+    if (blastRadius.impacts.length > 0) {
+      console.log(`  • 影響層面: ${blastRadius.impacts.join('、')}`);
+    }
+    const riskEmojiMap = { 高: '🔴', 中: '🟡', 低: '🟢' };
+    const riskEmoji = riskEmojiMap[blastRadius.riskLevel] || '🟢';
+    console.log(`  • 風險等級: ${riskEmoji} ${blastRadius.riskLevel}`);
+    if (warnings.length > 0) {
+      console.log(`  • 發現 ${warnings.length} 個注意事項`);
+    }
+    console.log('');
+  }
+
+  /**
+   * 顯示 PR 預覽
+   */
+  displayPreview(prContent, stats) {
+    console.log(`\n${'═'.repeat(80)}`);
+    console.log(`${colors.bright}📋 PR 預覽${colors.reset}`);
+    console.log('═'.repeat(80));
+    console.log(`\n${colors.cyan}標題:${colors.reset} ${prContent.title}\n`);
+    console.log(`${colors.cyan}統計:${colors.reset} ${stats.stats}`);
+    console.log(`${colors.cyan}檔案數:${colors.reset} ${stats.filesChanged} 個檔案\n`);
+    console.log('─'.repeat(80));
+    console.log(`${colors.cyan}描述:${colors.reset}\n`);
+    console.log(prContent.body);
+    console.log(`\n${'═'.repeat(80)}\n`);
+  }
+
+  /**
+   * 選擇 Reviewers
+   */
+  async selectReviewers(changeData) {
+    if (this.config.noConfirm) {
+      return null;
+    }
+
+    // 獲取當前用戶
+    const currentUser = this.git.getCurrentUser();
+
+    // 抓取 GitHub 團隊資訊
+    const teams = await this.github.fetchTeams();
+
+    // 根據 Git History 建議 Reviewers
+    const suggestedReviewers = this.reviewerSelector.getReviewersByGitHistory(
+      changeData.changedFiles
+    );
+
+    // 選擇 Reviewers
+    return await this.reviewerSelector.select(teams, suggestedReviewers, currentUser);
+  }
+
+  /**
+   * 創建 PR
+   */
+  async createPR(prContent, baseBranch, headBranch, reviewers) {
+    return await this.github.createOrUpdatePR({
+      title: prContent.title,
+      body: prContent.body,
+      baseBranch,
+      headBranch,
+      reviewers,
+      config: this.config,
+    });
+  }
+
+  /**
+   * 添加 Labels
+   */
+  async addLabels(prNumber, prData) {
+    log.step('正在分析並添加 Labels...');
+    const labels = await this.labelAnalyzer.analyzeAndApply(prNumber, prData);
+    if (labels.length > 0) {
+      console.log(`📌 已添加 Labels: ${labels.join(', ')}\n`);
+    }
+  }
+
+  /**
+   * 互動式確認
+   */
+  askConfirmation(question) {
+    return new Promise((resolve) => {
+      const rl = createInterface({
+        input: process.stdin,
+        output: process.stdout,
+      });
+
+      rl.question(`${question} (y/N): `, (answer) => {
+        rl.close();
+        resolve(answer.toLowerCase() === 'y' || answer.toLowerCase() === 'yes');
+      });
+    });
+  }
+}

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

@@ -0,0 +1,232 @@
+import { execSync } from 'child_process';
+import { CONSTANTS, colors } from '../utils/constants.js';
+import { log } from '../utils/helpers.js';
+import { InteractiveSelect } from '../ui/interactive-select.js';
+
+/**
+ * Reviewer 選擇器
+ */
+export class ReviewerSelector {
+  constructor(config = {}) {
+    this.interactiveReviewers = config.interactiveReviewers !== undefined ? config.interactiveReviewers : true;
+    this.maxSuggested = config.maxSuggested || 5;
+    this.gitHistoryDepth = config.gitHistoryDepth || 20;
+    this.excludeAuthors = config.excludeAuthors || [];
+  }
+
+  /**
+   * 根據 Git History 找出最常修改這些檔案的人
+   */
+  getReviewersByGitHistory(changedFiles, limit = null) {
+    const contributors = {};
+    const actualLimit = limit || this.maxSuggested;
+
+    changedFiles.forEach((file) => {
+      try {
+        const logOutput = execSync(
+          `git log -${this.gitHistoryDepth} --format="%ae|%an" -- "${file}"`,
+          {
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+          }
+        );
+
+        logOutput
+          .split('\n')
+          .filter(Boolean)
+          .forEach((line) => {
+            const [email, name] = line.split('|');
+            if (email && email.includes('@')) {
+              // 檢查是否在排除列表中
+              const shouldExclude = this.excludeAuthors.some((excluded) => {
+                const normalizedExcluded = excluded.toLowerCase();
+                return (
+                  email.toLowerCase().includes(normalizedExcluded) ||
+                  (name && name.toLowerCase().includes(normalizedExcluded))
+                );
+              });
+
+              if (!shouldExclude) {
+                const key = email.toLowerCase();
+                contributors[key] = {
+                  email,
+                  name: name || email.split('@')[0],
+                  commits: (contributors[key]?.commits || 0) + 1,
+                };
+              }
+            }
+          });
+      } catch (error) {
+        // 忽略單個檔案的錯誤
+      }
+    });
+
+    // 排序並取前 N 名
+    return Object.values(contributors)
+      .sort((a, b) => b.commits - a.commits)
+      .slice(0, actualLimit);
+  }
+
+  /**
+   * 互動式選擇 Reviewers
+   */
+  async selectInteractive(teamsData, suggestedReviewers, currentUser) {
+    console.log(`\n${'═'.repeat(80)}`);
+    console.log(`${colors.bright}🎯 選擇 Reviewers${colors.reset}`);
+    console.log(`${'═'.repeat(80)}\n`);
+
+    // 解構 teams 和 members
+    const teams = teamsData.teams || {};
+    const orgMembers = teamsData.members || [];
+
+    // 顯示建議的 Reviewers（基於 Git History）
+    if (suggestedReviewers && suggestedReviewers.length > 0) {
+      console.log(`${colors.cyan}💡 建議 Reviewers（基於 Git 歷史）:${colors.reset}`);
+      suggestedReviewers.forEach((reviewer, idx) => {
+        if (currentUser && reviewer.email.toLowerCase() === currentUser.email.toLowerCase()) {
+          return;
+        }
+        console.log(
+          `   ${idx + 1}. ${colors.green}${reviewer.name}${colors.reset} (${reviewer.email}) - ${
+            reviewer.commits
+          } commits`
+        );
+      });
+      console.log('');
+    }
+
+    // 準備選項列表
+    const options = [];
+
+    // 加入團隊選項
+    const teamsList = Object.values(teams);
+    teamsList.forEach((team) => {
+      const memberCount = team.members.length;
+      const memberNames = team.members
+        .slice(0, 3)
+        .map((m) => m.name)
+        .join(', ');
+      const moreText = memberCount > 3 ? ` ... +${memberCount - 3} 人` : '';
+
+      options.push({
+        type: 'team',
+        slug: team.slug,
+        label: `👥 ${team.name}`,
+        extra: ` ${colors.blue}(${team.slug} - ${memberCount} 位成員: ${memberNames}${moreText})${colors.reset}`,
+      });
+    });
+
+    // 收集所有個人成員
+    const allMembersMap = new Map();
+
+    Object.values(teams).forEach((team) => {
+      team.members.forEach((member) => {
+        if (!currentUser || member.login !== currentUser.githubUser) {
+          allMembersMap.set(member.login, member);
+        }
+      });
+    });
+
+    orgMembers.forEach((member) => {
+      if (!currentUser || member.login !== currentUser.githubUser) {
+        allMembersMap.set(member.login, member);
+      }
+    });
+
+    const uniqueMembers = Array.from(allMembersMap.values()).sort((a, b) =>
+      a.name.localeCompare(b.name)
+    );
+
+    // 加入個人成員選項
+    uniqueMembers.forEach((member) => {
+      options.push({
+        type: 'individual',
+        login: member.login,
+        label: `👤 @${member.login}`,
+        extra: ` ${colors.magenta}(${member.name})${colors.reset}`,
+      });
+    });
+
+    if (options.length === 0) {
+      console.log(`${colors.yellow}未找到可用的 reviewers${colors.reset}`);
+      console.log(`${colors.blue}提示: 你仍可以在創建 PR 後手動添加 reviewers${colors.reset}\n`);
+      return { teams: [], individuals: [] };
+    }
+
+    console.log(
+      `${colors.green}找到 ${teamsList.length} 個團隊和 ${uniqueMembers.length} 位成員${colors.reset}\n`
+    );
+
+    // 使用互動式選擇
+    const selector = new InteractiveSelect();
+    const result = await selector.select(options, '🎯 選擇 Reviewers');
+
+    if (result.cancelled || result.selected.length === 0) {
+      console.log(`${colors.yellow}未選擇任何 reviewer${colors.reset}\n`);
+      return { teams: [], individuals: [] };
+    }
+
+    // 分類選中的項目
+    const selectedTeams = [];
+    const selectedIndividuals = [];
+
+    result.selected.forEach((item) => {
+      if (item.type === 'team') {
+        selectedTeams.push(item.slug);
+      } else if (item.type === 'individual') {
+        selectedIndividuals.push(item.login);
+      }
+    });
+
+    console.log('');
+    if (selectedTeams.length > 0) {
+      log.success(`已選擇團隊: ${selectedTeams.join(', ')}`);
+    }
+    if (selectedIndividuals.length > 0) {
+      log.success(`已選擇個人: ${selectedIndividuals.map((u) => `@${u}`).join(', ')}`);
+    }
+    console.log('');
+
+    return { teams: selectedTeams, individuals: selectedIndividuals };
+  }
+
+  /**
+   * 自動選擇 Reviewers（非互動模式）
+   */
+  autoSelectReviewers(suggestedReviewers, currentUser) {
+    const reviewers = suggestedReviewers
+      .filter((r) => {
+        // 過濾當前用戶
+        if (currentUser && r.email.toLowerCase() === currentUser.email.toLowerCase()) {
+          return false;
+        }
+        // 過濾排除列表中的作者
+        const shouldExclude = this.excludeAuthors.some((excluded) => {
+          const normalizedExcluded = excluded.toLowerCase();
+          return (
+            r.email.toLowerCase().includes(normalizedExcluded) ||
+            (r.name && r.name.toLowerCase().includes(normalizedExcluded))
+          );
+        });
+        return !shouldExclude;
+      })
+      .slice(0, CONSTANTS.AUTO_REVIEWERS_COUNT)
+      .map((r) => r.email.split('@')[0]);
+
+    return { teams: [], individuals: 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);
+    }
+  }
+}

package/src/{utils → pr-modules/ui}/interactive-select.js

@@ -1,31 +1,8 @@
-/**
- * 互動式選擇工具（使用方向鍵和空白鍵）
- * 基於 scripts/ai-pr-modules/ui/interactive-select.mjs
- */
-
 import { emitKeypressEvents } from 'readline';
-
-// ANSI 顏色碼
-const colors = {
-  reset: '\x1b[0m',
-  bright: '\x1b[1m',
-  cyan: '\x1b[36m',
-  green: '\x1b[32m',
-  yellow: '\x1b[33m',
-  magenta: '\x1b[35m',
-  blue: '\x1b[34m',
-};
-
-// 游標控制
-const cursor = {
-  hide: '\x1b[?25l',
-  show: '\x1b[?25h',
-  up: (n = 1) => `\x1b[${n}A`,
-  clearLine: '\x1b[2K',
-};
+import { colors, cursor } from '../utils/constants.js';
 
 /**
- * 互動式選擇器
+ * 互動式選擇工具（使用方向鍵和空白鍵）
  */
 export class InteractiveSelect {
   /**
@@ -70,12 +47,12 @@ export class InteractiveSelect {
           const isCurrent = idx === currentIndex;
 
           const checkbox = isSelected ? `${colors.green}[✓]${colors.reset}` : '[ ]';
-          const cursorMarker = isCurrent ? `${colors.cyan}▶${colors.reset}` : ' ';
+          const cursor_marker = isCurrent ? `${colors.cyan}▶${colors.reset}` : ' ';
           const label = item.label || item.name || item.login;
           const extra = item.extra || '';
 
           process.stdout.write(cursor.clearLine);
-          console.log(`${cursorMarker} ${checkbox} ${label}${extra}`);
+          console.log(`${cursor_marker} ${checkbox} ${label}${extra}`);
         });
       };
 

package/src/pr-modules/ui/logger.js

@@ -0,0 +1,40 @@
+import { colors } from '../utils/constants.js';
+
+/**
+ * 日誌輸出工具
+ */
+export class Logger {
+  info(msg) {
+    console.log(`${colors.blue}ℹ${colors.reset} ${msg}`);
+  }
+
+  success(msg) {
+    console.log(`${colors.green}✅${colors.reset} ${msg}`);
+  }
+
+  warning(msg) {
+    console.log(`${colors.yellow}⚠️${colors.reset} ${msg}`);
+  }
+
+  error(msg) {
+    console.log(`${colors.red}❌${colors.reset} ${msg}`);
+  }
+
+  step(msg) {
+    console.log(`${colors.cyan}▶${colors.reset} ${msg}`);
+  }
+
+  header(msg) {
+    console.log(`\n${colors.bright}🤖 ${msg}${colors.reset}\n`);
+  }
+
+  separator(char = '═', length = 80) {
+    console.log(char.repeat(length));
+  }
+
+  section(title) {
+    console.log(`\n${'═'.repeat(80)}`);
+    console.log(`${colors.bright}${title}${colors.reset}`);
+    console.log('═'.repeat(80));
+  }
+}