ai-git-tools 2.0.78 → 2.0.80

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

@@ -1,132 +0,0 @@
-import { existsSync } from 'fs';
-import { resolve } from 'path';
-
-/**
- * 解析命令列參數
- */
-export function parseCliArgs() {
-  const args = process.argv.slice(2);
-  const config = {
-    baseBranch: null,
-    headBranch: null,
-    model: null,
-    preview: false,
-    noConfirm: false,
-    interactiveReviewers: undefined,
-    autoLabels: null,
-    includeImpactAnalysis: null,
-  };
-
-  for (let i = 0; i < args.length; i++) {
-    switch (args[i]) {
-      case '--base':
-        config.baseBranch = args[++i];
-        break;
-      case '--head':
-        config.headBranch = args[++i];
-        break;
-      case '--model':
-        config.model = args[++i];
-        break;
-      case '--preview':
-        config.preview = true;
-        break;
-      case '--no-confirm':
-        config.noConfirm = true;
-        break;
-      case '--interactive-reviewers':
-        config.interactiveReviewers = true;
-        break;
-      case '--auto-labels':
-        config.autoLabels = true;
-        break;
-      case '--include-impact':
-        config.includeImpactAnalysis = true;
-        break;
-      case '--help':
-        showHelp();
-        process.exit(0);
-        break;
-      default:
-        // 忽略未知的參數
-        break;
-    }
-  }
-
-  return config;
-}
-
-/**
- * 載入配置
- */
-export async function loadConfig() {
-  // 1. 載入預設配置
-  const configPath = resolve(process.cwd(), '.ai-git-config.mjs');
-  let config = null;
-
-  if (existsSync(configPath)) {
-    const userConfig = await import(configPath);
-    config = userConfig.default;
-  } else {
-    // 使用內建預設值
-    config = {
-      ai: { model: 'gpt-4.1', maxDiffLength: 8000, maxRetries: 3 },
-      github: { defaultBase: 'release', autoLabels: true, includeImpactAnalysis: false },
-      reviewers: { interactiveReviewers: true, maxSuggested: 5, gitHistoryDepth: 20, excludeAuthors: [] },
-      output: { verbose: false, saveHistory: false },
-    };
-  }
-
-  // 2. 合併命令列參數
-  const cliConfig = parseCliArgs();
-
-  // 合併配置（CLI 參數優先）
-  if (cliConfig.model) config.ai.model = cliConfig.model;
-  if (cliConfig.interactiveReviewers !== undefined) config.reviewers.interactiveReviewers = cliConfig.interactiveReviewers;
-  if (cliConfig.autoLabels !== null) config.github.autoLabels = cliConfig.autoLabels;
-  if (cliConfig.includeImpactAnalysis !== null) config.github.includeImpactAnalysis = cliConfig.includeImpactAnalysis;
-
-  // 其他 CLI 參數直接加入 config
-  config.baseBranch = cliConfig.baseBranch;
-  config.headBranch = cliConfig.headBranch;
-  config.preview = cliConfig.preview;
-  config.noConfirm = cliConfig.noConfirm;
-
-  return config;
-}
-
-/**
- * 顯示幫助訊息
- */
-function showHelp() {
-  console.log(`
-使用方式：
-  npx ai-git-tools pr [選項]
-
-選項：
-  --base <branch>      指定目標分支 (預設: 使用配置檔的 defaultBase 或自動偵測)
-  --model <model>      指定 AI 模型 (預設: gpt-4.1)
-  --preview            僅預覽 PR 內容，不實際創建
-  --no-confirm         跳過確認直接創建
-  --interactive-reviewers  啟用互動式 reviewer 選擇 (預設啟用)
-  --auto-labels        自動添加 Labels (預設啟用)
-  --help               顯示此說明
-
-範例：
-  npx ai-git-tools pr
-  npx ai-git-tools pr --base release-2025-m12.1
-  npx ai-git-tools pr --preview
-  npx ai-git-tools pr --no-confirm
-
-配置檔範例 (.ai-git-config.js)：
-  export default {
-    github: {
-      defaultBase: 'release-2025-m12.1',  // 指定預設目標分支
-      autoLabels: true,
-    },
-    reviewers: {
-      interactiveReviewers: true,  // 啟用互動式選擇 reviewers
-    },
-  };
-  `);
-}

package/src/pr-modules/core/git-operations.js

@@ -1,248 +0,0 @@
-import { execSync } from 'child_process';
-import { CONSTANTS } from '../utils/constants.js';
-import { PRError } from '../utils/helpers.js';
-
-/**
- * Git 操作封裝
- */
-export class GitOperations {
-  /**
-   * 偵測可用的 release 分支
-   */
-  detectReleaseBranches() {
-    try {
-      // 嘗試同步遠端（含 --prune 以清除已刪除的遠端分支），失敗就用本機已知的遠端資訊
-      try {
-        execSync('git fetch --prune origin', { stdio: 'ignore', timeout: 15000 });
-      } catch (_) {
-        // fetch 失敗，繼續使用已經 cache 的遠端分支
-      }
-      const branches = execSync('git branch -r', { encoding: 'utf-8' })
-        .split('\n')
-        .map((b) => b.trim())
-        .filter((b) => b.startsWith('origin/release-'))
-        .map((b) => b.replace('origin/', ''));
-      return branches;
-    } catch (error) {
-      return [];
-    }
-  }
-
-  /**
-   * 找到最新的 release 分支
-   */
-  findLatestReleaseBranch() {
-    const branches = this.detectReleaseBranches();
-    if (branches.length === 0) return null;
-
-    // 優先選月分支(-m)，其次週分支(-w)，最後 fallback 到全部 release 分支
-    const monthlyBranches = branches.filter((b) => b.includes('-m'));
-    const weeklyBranches = branches.filter((b) => b.includes('-w'));
-    const priorityBranches =
-      monthlyBranches.length > 0
-        ? monthlyBranches
-        : weeklyBranches.length > 0
-          ? weeklyBranches
-          : branches;
-
-    priorityBranches.sort().reverse();
-    return priorityBranches[0] || null;
-  }
-
-  /**
-   * 獲取當前分支
-   */
-  getCurrentBranch() {
-    return execSync('git rev-parse --abbrev-ref HEAD').toString().trim();
-  }
-
-  /**
-   * 獲取變更統計
-   */
-  getChangeStats(baseBranch, headBranch, useRemoteHead = false) {
-    try {
-      // 使用本地 headBranch 以確保能檢測到未推送的變更
-      const headRef = useRemoteHead ? `origin/${headBranch}` : headBranch;
-      const stats = execSync(`git diff --shortstat origin/${baseBranch}...${headRef}`, {
-        encoding: 'utf-8',
-      }).trim();
-
-      const filesChanged = execSync(
-        `git diff --name-only origin/${baseBranch}...${headRef} | wc -l`,
-        { encoding: 'utf-8' }
-      ).trim();
-
-      return { stats, filesChanged: parseInt(filesChanged, 10) };
-    } catch (error) {
-      return { stats: '無法獲取統計', filesChanged: 0 };
-    }
-  }
-
-  /**
-   * 獲取變更的檔案列表
-   */
-  getChangedFiles(baseBranch, headBranch, useRemoteHead = false) {
-    try {
-      // 使用本地 headBranch 以確保能檢測到未推送的變更
-      const headRef = useRemoteHead ? `origin/${headBranch}` : headBranch;
-      const files = execSync(`git diff --name-only origin/${baseBranch}...${headRef}`, {
-        encoding: 'utf-8',
-      })
-        .split('\n')
-        .filter(Boolean);
-      return files;
-    } catch (error) {
-      return [];
-    }
-  }
-
-  /**
-   * 獲取 commit 列表
-   */
-  getCommits(baseBranch, headBranch, options = {}) {
-    const { oneline = true, noDecorate = true, useRemoteHead = false } = options;
-    try {
-      // 使用本地 headBranch 以確保能檢測到未推送的 commit
-      const headRef = useRemoteHead ? `origin/${headBranch}` : headBranch;
-      let cmd = `git log origin/${baseBranch}..${headRef}`;
-      if (oneline) cmd += ' --oneline';
-      if (noDecorate) cmd += ' --no-decorate';
-
-      return execSync(cmd, { encoding: 'utf-8' });
-    } catch (error) {
-      throw new PRError(
-        '無法比較分支差異',
-        'GIT_COMPARE_FAILED',
-        ['檢查遠端分支是否存在: git branch -r', '執行診斷: npm run diagnose:pr'],
-        `git log origin/${baseBranch}..${headBranch}`
-      );
-    }
-  }
-
-  /**
-   * 獲取 diff
-   */
-  getDiff(baseBranch, headBranch, useRemoteHead = false, maxBuffer = CONSTANTS.MAX_BUFFER_SIZE) {
-    try {
-      // 使用本地 headBranch 以確保能檢測到未推送的變更
-      const headRef = useRemoteHead ? `origin/${headBranch}` : headBranch;
-      return execSync(`git diff origin/${baseBranch}...${headRef}`, {
-        encoding: 'utf-8',
-        maxBuffer,
-      });
-    } catch (error) {
-      // 嘗試替代方案
-      const headRef = useRemoteHead ? `origin/${headBranch}` : headBranch;
-      return execSync(`git diff origin/${baseBranch}..${headRef}`, {
-        encoding: 'utf-8',
-        maxBuffer,
-      });
-    }
-  }
-
-  /**
-   * 推送到遠端
-   */
-  async push(branch) {
-    try {
-      execSync(`git push -u origin ${branch}`, {
-        stdio: ['ignore', 'inherit', 'pipe'],
-        encoding: 'utf-8',
-      });
-      return true;
-    } catch (error) {
-      const errMsg = (error.stderr || error.message || '').toString();
-      const is403 = errMsg.includes('403') || errMsg.includes('Write access') || errMsg.includes('write access');
-      if (is403) {
-        throw new PRError(
-          '\u63a8送失敗：git 沒有寫入權限',
-          'GIT_PUSH_FORBIDDEN',
-          [
-            '建議執行以下指令讓 git 使用 gh 的認證:',
-            '  gh auth setup-git',
-            '或者改用 SSH 權限:',
-            '  git remote set-url origin git@github.com:<org>/<repo>.git',
-          ],
-          `git push -u origin ${branch}`
-        );
-      }
-      throw new PRError(
-        '推送失敗',
-        'GIT_PUSH_FAILED',
-        ['檢查是否有推送權限', '檢查遠端分支是否有衝突', '檢查網路連接'],
-        `git push -u origin ${branch}`
-      );
-    }
-  }
-
-  /**
-   * 同步遠端資訊
-   */
-  async fetch() {
-    try {
-      execSync('git fetch origin', { stdio: 'ignore' });
-      return true;
-    } catch (error) {
-      return false;
-    }
-  }
-
-  /**
-   * 智能截斷 diff
-   */
-  truncateDiff(diff, maxLength = CONSTANTS.MAX_DIFF_LENGTH) {
-    if (diff.length <= maxLength) return diff;
-
-    const lines = diff.split('\n');
-    const header = lines.slice(0, CONSTANTS.DIFF_CONTEXT_LINES).join('\n');
-    const footer = lines.slice(-CONSTANTS.DIFF_CONTEXT_LINES).join('\n');
-
-    const middle = `\n\n... [已省略 ${lines.length - 100} 行變更] ...\n\n`;
-
-    return header + middle + footer;
-  }
-
-  /**
-   * 獲取當前用戶資訊
-   */
-  getCurrentUser() {
-    try {
-      const email = execSync('git config user.email', { encoding: 'utf-8' }).trim();
-      const name = execSync('git config user.name', { encoding: 'utf-8' }).trim();
-      let githubUser = null;
-
-      try {
-        githubUser = execSync('gh api user --jq .login', {
-          encoding: 'utf-8',
-          stdio: ['pipe', 'pipe', 'pipe'],
-        }).trim();
-      } catch {
-        // GitHub CLI 未認證或未安裝
-      }
-
-      return { email, name, githubUser };
-    } catch (error) {
-      return null;
-    }
-  }
-
-  /**
-   * 獲取 repository owner
-   */
-  getRepoOwner() {
-    try {
-      const remoteUrl = execSync('git config --get remote.origin.url', {
-        encoding: 'utf-8',
-      }).trim();
-
-      // 解析 GitHub URL
-      const httpsMatch = remoteUrl.match(/github\.com[/:]([^/]+)\//);
-      const sshMatch = remoteUrl.match(/github\.com:([^/]+)\//);
-
-      const owner = httpsMatch?.[1] || sshMatch?.[1];
-      return owner || null;
-    } catch (error) {
-      return null;
-    }
-  }
-}

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

@@ -1,40 +0,0 @@
-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));
-  }
-}

package/src/pr-modules/utils/helpers.js

@@ -1,75 +0,0 @@
-import { colors } from './constants.js';
-
-/**
- * 日誌工具
- */
-export const log = {
-  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}`),
-};
-
-/**
- * 自訂錯誤類別
- */
-export class PRError extends Error {
-  constructor(message, code, suggestions = [], diagnosticCommand = null) {
-    super(message);
-    this.name = 'PRError';
-    this.code = code;
-    this.suggestions = suggestions;
-    this.diagnosticCommand = diagnosticCommand;
-  }
-}
-
-/**
- * 錯誤處理器
- */
-export function handleError(error) {
-  if (error instanceof PRError) {
-    log.error(error.message);
-
-    if (error.suggestions && error.suggestions.length > 0) {
-      console.log(`\n${colors.cyan}💡 建議解決方案:${colors.reset}`);
-      error.suggestions.forEach((suggestion, index) => {
-        console.log(`  ${index + 1}. ${suggestion}`);
-      });
-    }
-
-    if (error.diagnosticCommand) {
-      console.log(`\n${colors.yellow}🔍 診斷命令:${colors.reset}`);
-      console.log(`  ${error.diagnosticCommand}`);
-    }
-  } else {
-    log.error(`錯誤: ${error.message}`);
-    if (error.stack) {
-      console.error(error.stack);
-    }
-  }
-}
-
-/**
- * 取得 skills 規則的文字摘要（供 AI prompt 使用）
- */
-export function getSkillsSummaryForPrompt(PROJECT_SKILLS_CONTEXT) {
-  const rbp = PROJECT_SKILLS_CONTEXT.reactBestPractices
-    .map((r) => `  - [${r.id}] ${r.category}: ${r.desc}`)
-    .join('\n');
-  const fg = PROJECT_SKILLS_CONTEXT.frontendGuidelines;
-  return `
-## 專案規範（來自 .github/skills/）
-
-### React Best Practices 規則（共 ${PROJECT_SKILLS_CONTEXT.reactBestPractices.length} 條核心規則）
-${rbp}
-
-### Frontend Guidelines 規範
-- 架構: ${fg.architecture}
-- 元件命名: ${fg.naming.component}
-- 工具檔案: ${fg.naming.utility}
-- 變數: ${fg.naming.variable} / 常數: ${fg.naming.constant} / 布林值: ${fg.naming.boolean}
-- Import 順序: ${fg.importOrder}
-- 狀態管理: 客戶端=${fg.stateManagement.client} | 伺服器=${fg.stateManagement.server} | 表單=${fg.stateManagement.form}
-`;
-}