ai-git-tools 1.0.0

package/src/core/git-operations.js

@@ -0,0 +1,263 @@
+/**
+ * Git 操作工具
+ * 
+ * 封裝常用的 Git 命令操作
+ */
+
+import { execSync } from 'child_process';
+import { readFileSync, existsSync } from 'fs';
+
+export class GitOperations {
+  /**
+   * 執行 Git 命令
+   */
+  static exec(command, options = {}) {
+    try {
+      return execSync(command, {
+        encoding: 'utf-8',
+        stdio: options.silent ? 'pipe' : 'inherit',
+        ...options,
+      }).toString();
+    } catch (error) {
+      if (options.throwOnError !== false) {
+        throw error;
+      }
+      return '';
+    }
+  }
+
+  /**
+   * 檢查是否在 Git 倉庫中
+   */
+  static isGitRepository() {
+    try {
+      GitOperations.exec('git rev-parse --git-dir', { silent: true });
+      return true;
+    } catch {
+      return false;
+    }
+  }
+
+  /**
+   * 獲取當前分支名稱
+   */
+  static getCurrentBranch() {
+    return GitOperations.exec('git branch --show-current', { silent: true }).trim();
+  }
+
+  /**
+   * 獲取遠端 URL
+   */
+  static getRemoteUrl(remoteName = 'origin') {
+    return GitOperations.exec(`git remote get-url ${remoteName}`, { 
+      silent: true,
+      throwOnError: false,
+    }).trim();
+  }
+
+  /**
+   * 從遠端 URL 解析組織和倉庫名稱
+   */
+  static parseRemoteUrl(url) {
+    const match = url.match(/github\.com[:/]([^/]+)\/([^/.]+)/);
+    if (match) {
+      return {
+        org: match[1],
+        repo: match[2],
+      };
+    }
+    return { org: null, repo: null };
+  }
+
+  /**
+   * 獲取 staged 變更的 diff
+   */
+  static getStagedDiff() {
+    return GitOperations.exec('git diff --staged', { silent: true });
+  }
+
+  /**
+   * 獲取所有未提交的變更
+   */
+  static getAllChanges() {
+    const status = GitOperations.exec('git status --porcelain', { silent: true });
+    
+    if (!status.trim()) {
+      return [];
+    }
+
+    const changes = [];
+    const lines = status.split('\n').filter(line => line.trim());
+
+    for (const line of lines) {
+      const statusCode = line.substring(0, 2);
+      const filePath = line.substring(3).trim();
+
+      // 跳過已刪除的檔案
+      if (statusCode.includes('D')) {
+        continue;
+      }
+
+      // 跳過不需要的檔案
+      if (
+        filePath.includes('node_modules/') ||
+        filePath.includes('.next/') ||
+        filePath.includes('dist/') ||
+        filePath.includes('build/') ||
+        filePath.includes('.DS_Store')
+      ) {
+        continue;
+      }
+
+      const isNew = statusCode.includes('?') || statusCode.includes('A');
+      const isStaged = statusCode[0] !== ' ' && statusCode[0] !== '?';
+
+      changes.push({
+        filePath,
+        isNew,
+        isStaged,
+        statusCode,
+      });
+    }
+
+    return changes;
+  }
+
+  /**
+   * 獲取檔案的變更內容
+   */
+  static getFileDiff(filePath, isNew = false) {
+    try {
+      if (isNew) {
+        // 新檔案：讀取完整內容（前 100 行）
+        if (!existsSync(filePath)) {
+          return '[檔案不存在]';
+        }
+        const content = readFileSync(filePath, 'utf-8');
+        const lines = content.split('\n').slice(0, 100);
+        return `[新檔案]\n${lines.join('\n')}${lines.length >= 100 ? '\n...' : ''}`;
+      }
+      
+      // 已存在檔案：獲取 diff
+      const diff = GitOperations.exec(`git diff HEAD -- "${filePath}"`, { 
+        silent: true,
+        throwOnError: false,
+      });
+      return diff || '[無變更]';
+    } catch (error) {
+      return `[讀取錯誤: ${error.message}]`;
+    }
+  }
+
+  /**
+   * Add 檔案
+   */
+  static addFile(filePath) {
+    GitOperations.exec(`git add "${filePath}"`);
+  }
+
+  /**
+   * Add 多個檔案
+   */
+  static addFiles(filePaths) {
+    for (const filePath of filePaths) {
+      GitOperations.addFile(filePath);
+    }
+  }
+
+  /**
+   * Reset staged 檔案
+   */
+  static resetStaged() {
+    try {
+      GitOperations.exec('git reset HEAD -- .', { silent: true, throwOnError: false });
+    } catch {
+      // 忽略錯誤
+    }
+  }
+
+  /**
+   * 執行 commit
+   */
+  static async commit(message) {
+    // 使用臨時檔案避免 commit message 中的特殊字符問題
+    const { writeFileSync, unlinkSync } = await import('fs');
+    const tmpFile = '.git/COMMIT_EDITMSG_TMP';
+    
+    try {
+      writeFileSync(tmpFile, message, 'utf-8');
+      GitOperations.exec(`git commit -F ${tmpFile}`);
+      unlinkSync(tmpFile);
+    } catch (error) {
+      try {
+        unlinkSync(tmpFile);
+      } catch {
+        // 忽略刪除臨時檔案的錯誤
+      }
+      throw error;
+    }
+  }
+
+  /**
+   * 獲取最近的 commits
+   */
+  static getRecentCommits(count = 5) {
+    return GitOperations.exec(`git log -${count} --oneline`, { silent: true });
+  }
+
+  /**
+   * 獲取兩個分支之間的 diff
+   */
+  static getDiffBetweenBranches(base, head) {
+    return GitOperations.exec(`git diff ${base}...${head}`, { silent: true });
+  }
+
+  /**
+   * 獲取兩個分支之間的 commit 列表
+   */
+  static getCommitsBetweenBranches(base, head) {
+    const output = GitOperations.exec(`git log ${base}..${head} --oneline`, { silent: true });
+    return output.split('\n').filter(line => line.trim());
+  }
+
+  /**
+   * 檢查分支是否存在
+   */
+  static branchExists(branchName) {
+    try {
+      GitOperations.exec(`git rev-parse --verify ${branchName}`, { 
+        silent: true,
+        throwOnError: true,
+      });
+      return true;
+    } catch {
+      return false;
+    }
+  }
+
+  /**
+   * 獲取檔案的 Git 歷史貢獻者
+   */
+  static getFileContributors(filePath, depth = 20) {
+    try {
+      const output = GitOperations.exec(
+        `git log -${depth} --pretty=format:"%ae|%an" -- "${filePath}"`,
+        { silent: true, throwOnError: false }
+      );
+      
+      const contributors = new Map();
+      const lines = output.split('\n').filter(line => line.trim());
+      
+      for (const line of lines) {
+        const [email, name] = line.split('|');
+        if (email && name) {
+          contributors.set(email, name);
+        }
+      }
+      
+      return Array.from(contributors.entries()).map(([email, name]) => ({ email, name }));
+    } catch {
+      return [];
+    }
+  }
+}

package/src/core/github-api.js

@@ -0,0 +1,139 @@
+/**
+ * GitHub API 工具
+ * 
+ * 封裝 GitHub CLI 操作
+ */
+
+import { execSync } from 'child_process';
+
+export class GitHubAPI {
+  /**
+   * 執行 gh 命令
+   */
+  static exec(command, options = {}) {
+    try {
+      return execSync(`gh ${command}`, {
+        encoding: 'utf-8',
+        stdio: options.silent ? 'pipe' : 'inherit',
+        ...options,
+      }).toString();
+    } catch (error) {
+      if (options.throwOnError !== false) {
+        throw error;
+      }
+      return '';
+    }
+  }
+
+  /**
+   * 檢查 GitHub CLI 是否已安裝並已認證
+   */
+  static isAvailable() {
+    try {
+      GitHubAPI.exec('--version', { silent: true });
+      GitHubAPI.exec('auth status', { silent: true });
+      return true;
+    } catch {
+      return false;
+    }
+  }
+
+  /**
+   * 創建 Pull Request
+   */
+  static createPR(options = {}) {
+    const {
+      title,
+      body,
+      base,
+      head,
+      draft = false,
+      reviewers = [],
+      labels = [],
+    } = options;
+
+    let command = 'pr create';
+    
+    if (title) command += ` --title "${title.replace(/"/g, '\\"')}"`;
+    if (body) command += ` --body "${body.replace(/"/g, '\\"')}"`;
+    if (base) command += ` --base "${base}"`;
+    if (head) command += ` --head "${head}"`;
+    if (draft) command += ' --draft';
+    
+    if (reviewers.length > 0) {
+      command += ` --reviewer ${reviewers.join(',')}`;
+    }
+    
+    if (labels.length > 0) {
+      command += ` --label ${labels.join(',')}`;
+    }
+
+    return GitHubAPI.exec(command);
+  }
+
+  /**
+   * 獲取最新的 release 分支
+   */
+  static getLatestReleaseBranch() {
+    try {
+      const output = GitHubAPI.exec('api repos/{owner}/{repo}/branches --jq ".[].name"', {
+        silent: true,
+      });
+      
+      const branches = output.split('\n').filter(line => line.trim());
+      const releaseBranches = branches
+        .filter(branch => branch.startsWith('release-'))
+        .sort()
+        .reverse();
+      
+      return releaseBranches[0] || null;
+    } catch {
+      return null;
+    }
+  }
+
+  /**
+   * 檢查 PR 是否已存在
+   */
+  static prExists(base, head) {
+    try {
+      const output = GitHubAPI.exec(
+        `pr list --base ${base} --head ${head} --json number --jq "length"`,
+        { silent: true, throwOnError: false }
+      );
+      
+      return parseInt(output.trim()) > 0;
+    } catch {
+      return false;
+    }
+  }
+
+  /**
+   * 獲取倉庫資訊
+   */
+  static getRepoInfo() {
+    try {
+      const output = GitHubAPI.exec('repo view --json owner,name', { silent: true });
+      const data = JSON.parse(output);
+      
+      return {
+        owner: data.owner?.login || null,
+        name: data.name || null,
+      };
+    } catch {
+      return { owner: null, name: null };
+    }
+  }
+
+  /**
+   * 獲取可用的 Labels
+   */
+  static getLabels() {
+    try {
+      const output = GitHubAPI.exec('label list --json name --jq ".[].name"', { silent: true });
+      return output.split('\n').filter(line => line.trim());
+    } catch {
+      return [];
+    }
+  }
+}

package/src/index.js

@@ -0,0 +1,16 @@
+/**
+ * AI Git Tools - Main Entry Point
+ * 
+ * Export all core modules for programmatic usage
+ */
+
+export { commitCommand } from './commands/commit.js';
+export { commitAllCommand } from './commands/commit-all.js';
+export { prCommand } from './commands/pr.js';
+export { workflowCommand } from './commands/workflow.js';
+export { initCommand } from './commands/init.js';
+
+export { loadConfig } from './core/config-loader.js';
+export { AIClient } from './core/ai-client.js';
+export { GitOperations } from './core/git-operations.js';
+export { GitHubAPI } from './core/github-api.js';

package/src/utils/helpers.js

@@ -0,0 +1,88 @@
+/**
+ * 工具函數
+ */
+
+import chalk from 'chalk';
+
+/**
+ * 錯誤處理
+ */
+export function handleError(error) {
+  console.error(chalk.red('\n❌ 錯誤:'), error.message);
+  
+  if (error.stack && process.env.DEBUG) {
+    console.error(chalk.gray(error.stack));
+  }
+}
+
+/**
+ * 驗證 commit message
+ */
+export function validateCommitMessage(message) {
+  if (!message || message.length === 0) {
+    return { valid: false, reason: 'Commit message 為空' };
+  }
+
+  if (message.length < 5) {
+    return { valid: false, reason: 'Commit message 太短（少於 5 個字元）' };
+  }
+
+  // 檢查是否只包含特殊字元或空白
+  if (!/[a-zA-Z0-9\u4e00-\u9fa5]/.test(message)) {
+    return { valid: false, reason: 'Commit message 不包含有效字元' };
+  }
+
+  return { valid: true };
+}
+
+/**
+ * 截斷長文本
+ */
+export function truncateText(text, maxLength) {
+  if (text.length <= maxLength) {
+    return text;
+  }
+  
+  return text.substring(0, maxLength) + '\n\n... [文本已截斷]';
+}
+
+/**
+ * 格式化檔案列表
+ */
+export function formatFileList(files) {
+  return files.map((file, index) => {
+    const status = file.isNew ? '新增' : '修改';
+    return `   [${index}] ${status} - ${file.filePath}`;
+  }).join('\n');
+}
+
+/**
+ * 取得專案類型提示
+ */
+export function getProjectTypePrompt() {
+  return `你是一個資深前端工程師，熟悉現代 Web 開發規範。`;
+}
+
+/**
+ * 取得 Conventional Commits 規則
+ */
+export function getConventionalCommitsRules() {
+  return `**Commit Message 規則**：
+1. 使用 Conventional Commits 格式：type(scope): subject
+2. type 必須是：feat/fix/docs/style/refactor/test/chore/perf 其中之一
+3. scope: 影響範圍（選填，如 api、ui、config、auth 等）
+4. subject 限制在 50 字內，使用繁體中文
+5. 如果變更複雜，加上 body 說明（使用 bullet points）
+
+**重要**：
+- 直接輸出 commit message 純文字，不要使用 markdown 程式碼區塊（\`\`\`）
+- 不要加上任何前綴說明或後綴文字
+- 第一行是標題，如有需要可加上空行後的詳細說明`;
+}
+
+/**
+ * 延遲執行
+ */
+export function delay(ms) {
+  return new Promise(resolve => setTimeout(resolve, ms));
+}

package/src/utils/logger.js

@@ -0,0 +1,123 @@
+/**
+ * Logger 工具
+ * 
+ * 提供格式化的日誌輸出
+ */
+
+import chalk from 'chalk';
+import ora from 'ora';
+
+export class Logger {
+  constructor(verbose = false) {
+    this.verbose = verbose;
+    this.spinner = null;
+  }
+
+  /**
+   * 標題
+   */
+  header(text) {
+    console.log(chalk.cyan.bold(`\n${'='.repeat(60)}`));
+    console.log(chalk.cyan.bold(text));
+    console.log(chalk.cyan.bold('='.repeat(60)));
+  }
+
+  /**
+   * 成功訊息
+   */
+  success(text) {
+    console.log(chalk.green('✅ ' + text));
+  }
+
+  /**
+   * 錯誤訊息
+   */
+  error(text) {
+    console.log(chalk.red('❌ ' + text));
+  }
+
+  /**
+   * 警告訊息
+   */
+  warn(text) {
+    console.log(chalk.yellow('⚠️  ' + text));
+  }
+
+  /**
+   * 資訊訊息
+   */
+  info(text) {
+    console.log(chalk.blue('ℹ️  ' + text));
+  }
+
+  /**
+   * 除錯訊息（只在 verbose 模式顯示）
+   */
+  debug(text) {
+    if (this.verbose) {
+      console.log(chalk.gray('🔍 ' + text));
+    }
+  }
+
+  /**
+   * 分隔線
+   */
+  divider(char = '-', length = 50) {
+    console.log(char.repeat(length));
+  }
+
+  /**
+   * 程式碼區塊
+   */
+  code(text) {
+    this.divider();
+    console.log(text);
+    this.divider();
+  }
+
+  /**
+   * 開始 spinner
+   */
+  startSpinner(text) {
+    this.spinner = ora(text).start();
+  }
+
+  /**
+   * 更新 spinner 文字
+   */
+  updateSpinner(text) {
+    if (this.spinner) {
+      this.spinner.text = text;
+    }
+  }
+
+  /**
+   * 停止 spinner（成功）
+   */
+  succeedSpinner(text) {
+    if (this.spinner) {
+      this.spinner.succeed(text);
+      this.spinner = null;
+    }
+  }
+
+  /**
+   * 停止 spinner（失敗）
+   */
+  failSpinner(text) {
+    if (this.spinner) {
+      this.spinner.fail(text);
+      this.spinner = null;
+    }
+  }
+
+  /**
+   * 顯示進度
+   */
+  progress(current, total, text = '') {
+    const percentage = Math.round((current / total) * 100);
+    const bar = '█'.repeat(Math.round(percentage / 2));
+    const empty = '░'.repeat(50 - Math.round(percentage / 2));
+    console.log(`\r${bar}${empty} ${percentage}% ${text}`);
+  }
+}

package/templates/.ai-git-config.template.js

@@ -0,0 +1,38 @@
+/**
+ * AI Git Tools 配置檔範本
+ * 
+ * 此配置檔用於：
+ * - gitai commit：自動生成單個 commit
+ * - gitai commit-all：智能分析並批量 commit
+ * - gitai pr：自動生成 PR
+ * - gitai workflow：完整工作流程
+ */
+export default {
+  // AI 設定
+  ai: {
+    model: 'gpt-4.1', // AI 模型：gpt-4.1, claude-haiku-4.5, claude-sonnet-4.5
+    maxDiffLength: 8000, // 最大 diff 長度（字元）- 太小會導致 AI 看不到完整變更
+    maxRetries: 3, // API 失敗時的最大重試次數
+  },
+
+  // GitHub 設定（用於 PR 工具）
+  github: {
+    orgName: null, // GitHub 組織名稱（自動從 git remote 取得）
+    defaultBase: 'auto', // 預設目標分支：'auto' | 'main' | 'develop' | 'master'
+    autoLabels: true, // 自動添加 Labels
+  },
+
+  // Reviewer 設定（用於 PR 工具）
+  reviewers: {
+    autoSelect: false, // 是否啟用 reviewer 選擇功能（true: 啟用互動選擇 | false: 跳過選擇）
+    maxSuggested: 5, // 最多建議的 reviewers 數量（基於 Git 歷史分析）
+    gitHistoryDepth: 20, // Git 歷史分析深度（查看最近 N 筆 commit）
+    excludeAuthors: [], // 排除特定作者（email 或 username），例如: ['bot@', 'ci-user']
+  },
+
+  // 輸出設定
+  output: {
+    verbose: false, // 顯示詳細輸出
+    saveHistory: false, // 儲存操作歷史（未來功能）
+  },
+};