ai-git-tools 1.0.0

package/src/commands/pr.js

@@ -0,0 +1,305 @@
+/**
+ * PR 命令
+ * 
+ * 生成 PR 標題、描述並創建 Pull Request
+ */
+
+import chalk from 'chalk';
+import inquirer from 'inquirer';
+import { loadConfig } from '../core/config-loader.js';
+import { AIClient } from '../core/ai-client.js';
+import { GitOperations } from '../core/git-operations.js';
+import { GitHubAPI } from '../core/github-api.js';
+import { Logger } from '../utils/logger.js';
+import { 
+  handleError, 
+  truncateText,
+  getProjectTypePrompt,
+} from '../utils/helpers.js';
+
+/**
+ * 決定 base 分支
+ */
+async function determineBaseBranch(config, logger) {
+  if (config.baseBranch && config.baseBranch !== 'auto') {
+    return config.baseBranch;
+  }
+
+  // 嘗試找最新的 release 分支
+  logger.startSpinner('尋找目標分支...');
+  const latestRelease = GitHubAPI.getLatestReleaseBranch();
+  
+  if (latestRelease) {
+    logger.succeedSpinner(`自動選擇目標分支: ${latestRelease}`);
+    return latestRelease;
+  }
+
+  // 預設使用 main 或 master
+  const defaultBranch = GitOperations.branchExists('main') ? 'main' : 'master';
+  logger.succeedSpinner(`使用預設分支: ${defaultBranch}`);
+  return defaultBranch;
+}
+
+/**
+ * 使用 AI 生成 PR 內容
+ */
+async function generatePRContent(baseBranch, headBranch, config, logger) {
+  logger.startSpinner('AI 正在分析變更並生成 PR 內容...');
+
+  // 獲取 diff 和 commits
+  const diff = GitOperations.getDiffBetweenBranches(baseBranch, headBranch);
+  const commits = GitOperations.getCommitsBetweenBranches(baseBranch, headBranch);
+
+  const truncatedDiff = truncateText(diff, config.ai.maxDiffLength);
+
+  const aiClient = new AIClient(config);
+
+  const prompt = `${getProjectTypePrompt()}
+
+請根據以下資訊生成一個 Pull Request 的標題和描述。
+
+**Commits 列表**：
+${commits.join('\n')}
+
+**Git Diff**：
+${truncatedDiff}
+
+**輸出格式**（JSON）：
+{
+  "title": "PR 標題（簡短、繁體中文，50 字內）",
+  "description": "PR 描述（使用 Markdown 格式，繁體中文）"
+}
+
+**PR 描述應包含**：
+1. ## 📝 變更摘要（簡述主要變更）
+2. ## ✨ 主要功能（列出新增功能或修正項目）
+3. ## 🔧 技術細節（選填，如有重要的技術變更）
+4. ## ✅ 測試（如何測試這些變更）
+
+請只輸出 JSON，不要其他文字。`;
+
+  const response = await aiClient.sendAndWait(prompt);
+  await aiClient.stop();
+
+  try {
+    const prContent = AIClient.parseJSON(response);
+    logger.succeedSpinner('PR 內容生成完成');
+    return prContent;
+  } catch (error) {
+    logger.failSpinner('生成 PR 內容失敗');
+    throw new Error(`無法解析 AI 回應: ${error.message}`);
+  }
+}
+
+/**
+ * 選擇 Reviewers
+ */
+async function selectReviewers(changedFiles, config, logger) {
+  if (!config.reviewers.autoSelect) {
+    return [];
+  }
+
+  logger.startSpinner('分析潛在的 reviewers...');
+
+  const contributorsMap = new Map();
+
+  // 分析每個變更檔案的貢獻者
+  for (const file of changedFiles.slice(0, 10)) { // 限制分析前 10 個檔案
+    const contributors = GitOperations.getFileContributors(
+      file,
+      config.reviewers.gitHistoryDepth
+    );
+
+    for (const { email, name } of contributors) {
+      // 排除設定中的作者
+      if (config.reviewers.excludeAuthors.some(pattern => email.includes(pattern))) {
+        continue;
+      }
+
+      const count = contributorsMap.get(email) || 0;
+      contributorsMap.set(email, count + 1);
+    }
+  }
+
+  // 排序並取前 N 位
+  const suggested = Array.from(contributorsMap.entries())
+    .sort((a, b) => b[1] - a[1])
+    .slice(0, config.reviewers.maxSuggested)
+    .map(([email]) => email);
+
+  logger.succeedSpinner(`找到 ${suggested.length} 位潛在 reviewers`);
+
+  if (suggested.length === 0) {
+    return [];
+  }
+
+  // 互動式選擇
+  const { selectedReviewers } = await inquirer.prompt([
+    {
+      type: 'checkbox',
+      name: 'selectedReviewers',
+      message: '選擇 Reviewers:',
+      choices: suggested.map(email => ({
+        name: email,
+        value: email,
+      })),
+    },
+  ]);
+
+  return selectedReviewers;
+}
+
+/**
+ * 智能選擇 Labels
+ */
+function suggestLabels(prContent, availableLabels) {
+  const suggestions = [];
+  const title = prContent.title.toLowerCase();
+  const description = prContent.description.toLowerCase();
+
+  // 根據關鍵字建議 labels
+  const labelKeywords = {
+    bug: ['fix', 'bug', '修正', '錯誤'],
+    enhancement: ['feat', 'feature', '新增', '功能'],
+    documentation: ['docs', '文件', 'readme'],
+    refactor: ['refactor', '重構'],
+    performance: ['perf', 'performance', '效能', '優化'],
+    test: ['test', '測試'],
+    ui: ['ui', 'style', '樣式', '介面'],
+    api: ['api', 'endpoint'],
+  };
+
+  for (const [label, keywords] of Object.entries(labelKeywords)) {
+    if (availableLabels.includes(label)) {
+      if (keywords.some(kw => title.includes(kw) || description.includes(kw))) {
+        suggestions.push(label);
+      }
+    }
+  }
+
+  return suggestions;
+}
+
+/**
+ * PR 命令處理器
+ */
+export async function prCommand(options) {
+  const logger = new Logger(options.verbose);
+
+  try {
+    logger.header('AI Auto PR Generator');
+
+    // 檢查環境
+    if (!GitOperations.isGitRepository()) {
+      logger.error('當前目錄不是 Git 倉庫');
+      process.exit(1);
+    }
+
+    if (!GitHubAPI.isAvailable()) {
+      logger.error('GitHub CLI 未安裝或未認證');
+      logger.info('請先安裝並設定 GitHub CLI:');
+      logger.info('  brew install gh');
+      logger.info('  gh auth login');
+      process.exit(1);
+    }
+
+    // 載入配置
+    const config = await loadConfig(options);
+
+    // 確定分支
+    const headBranch = config.headBranch || GitOperations.getCurrentBranch();
+    const baseBranch = await determineBaseBranch(config, logger);
+
+    console.log(chalk.cyan(`\n📌 分支資訊:`));
+    console.log(`   Base: ${baseBranch}`);
+    console.log(`   Head: ${headBranch}`);
+
+    // 檢查 PR 是否已存在
+    if (GitHubAPI.prExists(baseBranch, headBranch)) {
+      logger.warn('PR 已存在');
+      process.exit(0);
+    }
+
+    // 生成 PR 內容
+    const prContent = await generatePRContent(baseBranch, headBranch, config, logger);
+
+    console.log(chalk.cyan('\n📝 PR 標題:'));
+    logger.code(prContent.title);
+
+    console.log(chalk.cyan('\n📄 PR 描述:'));
+    logger.code(prContent.description);
+
+    // 如果是預覽模式，不創建 PR
+    if (config.preview) {
+      logger.info('預覽模式，不創建 PR');
+      process.exit(0);
+    }
+
+    // 確認是否創建 PR
+    if (!config.noConfirm) {
+      const { confirm } = await inquirer.prompt([
+        {
+          type: 'confirm',
+          name: 'confirm',
+          message: '是否創建 PR？',
+          default: true,
+        },
+      ]);
+
+      if (!confirm) {
+        logger.info('已取消');
+        process.exit(0);
+      }
+    }
+
+    // 選擇 Reviewers
+    let reviewers = [];
+    if (config.reviewers.autoSelect) {
+      const changes = GitOperations.getAllChanges();
+      const changedFiles = changes.map(c => c.filePath);
+      reviewers = await selectReviewers(changedFiles, config, logger);
+    }
+
+    // 選擇 Labels
+    let labels = [];
+    if (config.github.autoLabels) {
+      const availableLabels = GitHubAPI.getLabels();
+      const suggestedLabels = suggestLabels(prContent, availableLabels);
+      
+      if (suggestedLabels.length > 0) {
+        const { selectedLabels } = await inquirer.prompt([
+          {
+            type: 'checkbox',
+            name: 'selectedLabels',
+            message: '選擇 Labels:',
+            choices: suggestedLabels.map(label => ({
+              name: label,
+              value: label,
+              checked: true,
+            })),
+          },
+        ]);
+        labels = selectedLabels;
+      }
+    }
+
+    // 創建 PR
+    logger.startSpinner('正在創建 PR...');
+    
+    GitHubAPI.createPR({
+      title: prContent.title,
+      body: prContent.description,
+      base: baseBranch,
+      head: headBranch,
+      draft: config.draft,
+      reviewers,
+      labels,
+    });
+
+    logger.succeedSpinner('PR 創建成功！');
+
+  } catch (error) {
+    handleError(error);
+    process.exit(1);
+  }
+}

package/src/commands/workflow.js

@@ -0,0 +1,36 @@
+/**
+ * Workflow 命令
+ * 
+ * 完整工作流程：commit-all + pr
+ */
+
+import chalk from 'chalk';
+import { commitAllCommand } from './commit-all.js';
+import { prCommand } from './pr.js';
+import { Logger } from '../utils/logger.js';
+import { handleError } from '../utils/helpers.js';
+
+/**
+ * Workflow 命令處理器
+ */
+export async function workflowCommand(options) {
+  const logger = new Logger(options.verbose);
+
+  try {
+    logger.header('完整工作流程：Commit All + PR');
+
+    // 步驟 1: Commit All
+    console.log(chalk.cyan('\n🔄 步驟 1: 智能分析並提交所有變更\n'));
+    await commitAllCommand(options);
+
+    // 步驟 2: 創建 PR
+    console.log(chalk.cyan('\n🔄 步驟 2: 創建 Pull Request\n'));
+    await prCommand(options);
+
+    logger.header('工作流程完成！');
+
+  } catch (error) {
+    handleError(error);
+    process.exit(1);
+  }
+}

package/src/core/ai-client.js

@@ -0,0 +1,115 @@
+/**
+ * AI Client
+ * 
+ * 封裝 GitHub Copilot SDK 的 AI 客戶端
+ */
+
+import { CopilotClient } from '@github/copilot-sdk';
+
+export class AIClient {
+  constructor(config = {}) {
+    this.config = config;
+    this.client = null;
+    this.session = null;
+  }
+
+  /**
+   * 初始化客戶端
+   */
+  async initialize() {
+    if (!this.client) {
+      this.client = new CopilotClient();
+    }
+    return this.client;
+  }
+
+  /**
+   * 創建會話
+   */
+  async createSession(options = {}) {
+    await this.initialize();
+    
+    this.session = await this.client.createSession({
+      model: options.model || this.config.ai?.model || 'gpt-4.1',
+      ...options,
+    });
+    
+    return this.session;
+  }
+
+  /**
+   * 發送請求並等待回應（帶重試機制）
+   */
+  async sendAndWait(prompt, options = {}) {
+    const maxRetries = options.maxRetries || this.config.ai?.maxRetries || 3;
+    let lastError = null;
+
+    for (let attempt = 1; attempt <= maxRetries; attempt++) {
+      try {
+        if (!this.session) {
+          await this.createSession(options);
+        }
+
+        const response = await this.session.sendAndWait({ prompt });
+        return response?.data?.content || '';
+      } catch (error) {
+        lastError = error;
+        
+        if (this.config.output?.verbose) {
+          console.log(`⚠️  嘗試 ${attempt}/${maxRetries} 失敗: ${error.message}`);
+        }
+        
+        // 如果還有重試機會，重新創建 session
+        if (attempt < maxRetries) {
+          this.session = null;
+          continue;
+        }
+      }
+    }
+
+    throw new Error(`AI 請求失敗（嘗試 ${maxRetries} 次）: ${lastError?.message || '未知錯誤'}`);
+  }
+
+  /**
+   * 停止客戶端
+   */
+  async stop() {
+    if (this.client) {
+      await this.client.stop();
+      this.client = null;
+      this.session = null;
+    }
+  }
+
+  /**
+   * 清理回應內容（移除 markdown 程式碼區塊等）
+   */
+  static cleanResponse(response) {
+    if (!response) return '';
+
+    let cleaned = response.trim();
+
+    // 移除 markdown 程式碼區塊標記
+    cleaned = cleaned.replace(/^```[\w]*\n/gm, '');
+    cleaned = cleaned.replace(/\n```$/gm, '');
+    cleaned = cleaned.replace(/^```$/gm, '');
+
+    // 移除開頭和結尾的引號
+    cleaned = cleaned.replace(/^["']|["']$/g, '');
+
+    return cleaned.trim();
+  }
+
+  /**
+   * 解析 JSON 回應
+   */
+  static parseJSON(response) {
+    const cleaned = AIClient.cleanResponse(response);
+    
+    try {
+      return JSON.parse(cleaned);
+    } catch (error) {
+      throw new Error(`無法解析 AI 回應為 JSON: ${error.message}`);
+    }
+  }
+}

package/src/core/config-loader.js

@@ -0,0 +1,165 @@
+/**
+ * 配置載入器
+ * 
+ * 負責載入和合併配置檔案與命令列參數
+ */
+
+import { existsSync } from 'fs';
+import { resolve } from 'path';
+
+/**
+ * 預設配置
+ */
+export const DEFAULT_CONFIG = {
+  ai: {
+    model: 'gpt-4.1',
+    maxDiffLength: 8000,
+    maxRetries: 3,
+  },
+  github: {
+    orgName: null, // 自動從 git remote 取得
+    defaultBase: 'auto',
+    autoLabels: true,
+  },
+  reviewers: {
+    autoSelect: false,
+    maxSuggested: 5,
+    gitHistoryDepth: 20,
+    excludeAuthors: [],
+  },
+  output: {
+    verbose: false,
+    saveHistory: false,
+  },
+};
+
+/**
+ * 載入配置檔案
+ */
+async function loadConfigFile() {
+  const configFiles = [
+    '.ai-git-config.js',
+    '.ai-git-config.mjs',
+    'ai-git.config.js',
+    'ai-git.config.mjs',
+  ];
+
+  for (const configFile of configFiles) {
+    const configPath = resolve(process.cwd(), configFile);
+    if (existsSync(configPath)) {
+      try {
+        const imported = await import(configPath);
+        return imported.default || {};
+      } catch (error) {
+        console.warn(`警告: 無法載入配置檔案 ${configFile}:`, error.message);
+      }
+    }
+  }
+
+  return {};
+}
+
+/**
+ * 深度合併物件
+ */
+function deepMerge(target, source) {
+  const output = { ...target };
+  
+  if (isObject(target) && isObject(source)) {
+    Object.keys(source).forEach(key => {
+      if (isObject(source[key])) {
+        if (!(key in target)) {
+          Object.assign(output, { [key]: source[key] });
+        } else {
+          output[key] = deepMerge(target[key], source[key]);
+        }
+      } else {
+        Object.assign(output, { [key]: source[key] });
+      }
+    });
+  }
+  
+  return output;
+}
+
+function isObject(item) {
+  return item && typeof item === 'object' && !Array.isArray(item);
+}
+
+/**
+ * 載入完整配置（配置檔 + CLI 參數）
+ */
+export async function loadConfig(cliOptions = {}) {
+  // 1. 載入配置檔案
+  const userConfig = await loadConfigFile();
+  
+  // 2. 合併預設配置與使用者配置
+  let config = deepMerge(DEFAULT_CONFIG, userConfig);
+  
+  // 3. 合併 CLI 參數（最高優先權）
+  if (cliOptions.model) {
+    config.ai.model = cliOptions.model;
+  }
+  
+  if (cliOptions.verbose !== undefined) {
+    config.output.verbose = cliOptions.verbose;
+  }
+  
+  if (cliOptions.maxDiff) {
+    config.ai.maxDiffLength = cliOptions.maxDiff;
+  }
+  
+  if (cliOptions.maxRetries) {
+    config.ai.maxRetries = cliOptions.maxRetries;
+  }
+  
+  // GitHub 相關
+  if (cliOptions.org) {
+    config.github.orgName = cliOptions.org;
+  }
+  
+  if (cliOptions.base) {
+    config.github.defaultBase = cliOptions.base;
+  }
+  
+  if (cliOptions.autoReviewers !== undefined) {
+    config.reviewers.autoSelect = cliOptions.autoReviewers;
+  }
+  
+  if (cliOptions.autoLabels !== undefined) {
+    config.github.autoLabels = cliOptions.autoLabels;
+  }
+  
+  // 其他 CLI 參數
+  config.baseBranch = cliOptions.base || null;
+  config.headBranch = cliOptions.head || null;
+  config.draft = cliOptions.draft || false;
+  config.preview = cliOptions.preview || false;
+  config.noConfirm = cliOptions.noConfirm || false;
+  
+  return config;
+}
+
+/**
+ * 驗證配置
+ */
+export function validateConfig(config) {
+  const errors = [];
+  
+  if (!config.ai?.model) {
+    errors.push('AI model 未設定');
+  }
+  
+  if (config.ai?.maxDiffLength && config.ai.maxDiffLength < 1000) {
+    errors.push('maxDiffLength 太小（最少 1000）');
+  }
+  
+  if (config.ai?.maxRetries && (config.ai.maxRetries < 1 || config.ai.maxRetries > 10)) {
+    errors.push('maxRetries 必須在 1-10 之間');
+  }
+  
+  return {
+    valid: errors.length === 0,
+    errors,
+  };
+}