ai-git-tools 2.0.48 → 2.0.49

package/src/dev-modules/core/issue-parser.js

@@ -1,144 +0,0 @@
-/**
- * Issue 解析模組
- * 負責解析 Issue 編號/URL，並從 GitHub API 擷取 Issue 資料
- */
-
-import { execSync } from 'child_process';
-
-/**
- * 標準化 IssueData 結構
- * @typedef {Object} IssueData
- * @property {number} number - Issue 編號
- * @property {string} title - Issue 標題
- * @property {string} body - Issue 說明
- * @property {string[]} labels - 標籤列表
- * @property {string} owner - 倉庫擁有者
- * @property {string} repo - 倉庫名稱
- * @property {string} url - Issue URL
- */
-
-export class IssueParser {
-  /**
-   * 解析輸入（數字字串或完整 URL）為 Issue 編號
-   * @param {string|number} input - Issue 編號或 GitHub Issue URL
-   * @returns {number} Issue 編號
-   */
-  parseIssueNumber(input) {
-    const str = String(input).trim();
-
-    // 純數字
-    if (/^\d+$/.test(str)) {
-      return parseInt(str, 10);
-    }
-
-    // GitHub URL 格式：https://github.com/owner/repo/issues/123
-    const urlMatch = str.match(/\/issues\/(\d+)/);
-    if (urlMatch) {
-      return parseInt(urlMatch[1], 10);
-    }
-
-    throw new Error(
-      `無效的 Issue 輸入：「${input}」\n請提供 Issue 編號（如 123）或完整 URL（如 https://github.com/owner/repo/issues/123）`
-    );
-  }
-
-  /**
-   * 從 GitHub URL 解析倉庫資訊
-   * @param {string} url
-   * @returns {{ owner: string, repo: string, issueNumber: number }}
-   */
-  parseIssueURL(url) {
-    const match = url.match(/github\.com\/([^/]+)\/([^/]+)\/issues\/(\d+)/);
-    if (!match) {
-      throw new Error(`無法解析 GitHub Issue URL：${url}`);
-    }
-    return {
-      owner: match[1],
-      repo: match[2].replace(/\.git$/, ''),
-      issueNumber: parseInt(match[3], 10),
-    };
-  }
-
-  /**
-   * 從 git remote 自動偵測 owner/repo
-   * @returns {{ owner: string, repo: string }}
-   */
-  detectRepoFromRemote() {
-    try {
-      const remoteUrl = execSync('git remote get-url origin', {
-        encoding: 'utf-8',
-        stdio: ['pipe', 'pipe', 'pipe'],
-      }).trim();
-
-      // HTTPS: https://github.com/owner/repo.git
-      const httpsMatch = remoteUrl.match(/github\.com\/([^/]+)\/([^/\s]+?)(?:\.git)?$/);
-      if (httpsMatch) {
-        return { owner: httpsMatch[1], repo: httpsMatch[2] };
-      }
-
-      // SSH: git@github.com:owner/repo.git
-      const sshMatch = remoteUrl.match(/github\.com:([^/]+)\/([^/\s]+?)(?:\.git)?$/);
-      if (sshMatch) {
-        return { owner: sshMatch[1], repo: sshMatch[2] };
-      }
-
-      throw new Error('無法從 git remote 解析 owner/repo');
-    } catch (error) {
-      throw new Error(`偵測 git remote 失敗：${error.message}`);
-    }
-  }
-
-  /**
-   * 透過 GitHub CLI 擷取 Issue 資料
-   * @param {string} owner
-   * @param {string} repo
-   * @param {number} issueNumber
-   * @returns {IssueData}
-   */
-  async fetchIssue(owner, repo, issueNumber) {
-    try {
-      const json = execSync(
-        `gh api repos/${owner}/${repo}/issues/${issueNumber}`,
-        { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] }
-      );
-      const data = JSON.parse(json);
-
-      return {
-        number: data.number,
-        title: data.title,
-        body: data.body || '',
-        labels: (data.labels || []).map((l) => l.name),
-        owner,
-        repo,
-        url: data.html_url,
-      };
-    } catch (error) {
-      if (error.message.includes('404')) {
-        throw new Error(
-          `Issue #${issueNumber} 不存在於 ${owner}/${repo}\n請確認 Issue 編號正確，且你有存取該倉庫的權限`
-        );
-      }
-      throw new Error(`擷取 Issue 失敗：${error.message}`);
-    }
-  }
-
-  /**
-   * 解析輸入並完整擷取 Issue 資料（主要入口）
-   * @param {string|number} input - Issue 編號或 URL
-   * @returns {Promise<IssueData>}
-   */
-  async parse(input) {
-    const str = String(input).trim();
-
-    // 如果是完整 URL，直接解析 owner/repo
-    if (str.startsWith('http')) {
-      const { owner, repo, issueNumber } = this.parseIssueURL(str);
-      return this.fetchIssue(owner, repo, issueNumber);
-    }
-
-    // 否則從 git remote 偵測
-    const issueNumber = this.parseIssueNumber(str);
-    const { owner, repo } = this.detectRepoFromRemote();
-    return this.fetchIssue(owner, repo, issueNumber);
-  }
-}

package/src/dev-modules/test/executor-base.js

@@ -1,74 +0,0 @@
-/**
- * 測試執行器基礎類別
- * 定義標準介面與 TestResults 結構
- */
-
-/**
- * @typedef {Object} TestCase
- * @property {string} name - 測試名稱
- * @property {string} suite - 所屬 suite（describe 區塊）
- * @property {boolean} passed
- * @property {number} duration - 毫秒
- * @property {string|null} error - 失敗時的錯誤訊息
- */
-
-/**
- * @typedef {Object} TestResults
- * @property {string} framework
- * @property {number} total
- * @property {number} passed
- * @property {number} failed
- * @property {number} skipped
- * @property {number} duration - 總毫秒數
- * @property {TestCase[]} tests
- * @property {string|null} rawOutput
- */
-
-export class ExecutorBase {
-  /**
-   * @param {Object} options
-   * @param {number} [options.timeout=300000] - 5 分鐘
-   */
-  constructor(options = {}) {
-    this.timeout = options.timeout ?? 300_000;
-  }
-
-  /**
-   * 執行測試（子類別實作）
-   * @param {string[]} testPaths
-   * @param {Object} options
-   * @returns {Promise<TestResults>}
-   */
-  // eslint-disable-next-line no-unused-vars
-  async run(testPaths, options = {}) {
-    throw new Error('子類別必須實作 run() 方法');
-  }
-
-  /**
-   * 解析 JSON 輸出（子類別實作）
-   * @param {string} output
-   * @returns {TestResults}
-   */
-  // eslint-disable-next-line no-unused-vars
-  parseResults(output) {
-    throw new Error('子類別必須實作 parseResults() 方法');
-  }
-
-  /**
-   * 建立空的 TestResults 骨架
-   * @param {string} framework
-   * @returns {TestResults}
-   */
-  emptyResults(framework) {
-    return {
-      framework,
-      total: 0,
-      passed: 0,
-      failed: 0,
-      skipped: 0,
-      duration: 0,
-      tests: [],
-      rawOutput: null,
-    };
-  }
-}

package/src/dev-modules/test/executor-factory.js

@@ -1,29 +0,0 @@
-/**
- * 測試執行器工廠
- * 依框架名稱回傳對應的執行器實例
- */
-
-import { JestExecutor } from './jest-executor.js';
-import { VitestExecutor } from './vitest-executor.js';
-import { MochaExecutor } from './mocha-executor.js';
-import { FRAMEWORKS } from './test-detector.js';
-
-/**
- * @param {string} framework - 'jest' | 'vitest' | 'mocha'
- * @param {Object} options - 傳遞給執行器的選項（如 timeout）
- * @returns {import('./executor-base.js').ExecutorBase}
- */
-export function createExecutor(framework, options = {}) {
-  switch (framework) {
-    case FRAMEWORKS.JEST:
-      return new JestExecutor(options);
-    case FRAMEWORKS.VITEST:
-      return new VitestExecutor(options);
-    case FRAMEWORKS.MOCHA:
-      return new MochaExecutor(options);
-    default:
-      throw new Error(
-        `不支援的測試框架：「${framework}」\n目前支援：jest、vitest、mocha\n請在 .ai-git-config.js 的 autodev.framework 指定框架`
-      );
-  }
-}

package/src/dev-modules/test/jest-executor.js

@@ -1,107 +0,0 @@
-/**
- * Jest 測試執行器
- * 使用 --json 取得結構化輸出
- */
-
-import { execSync } from 'child_process';
-import { existsSync } from 'fs';
-import { join } from 'path';
-import { ExecutorBase } from './executor-base.js';
-
-export class JestExecutor extends ExecutorBase {
-  constructor(options = {}) {
-    super(options);
-    this.framework = 'jest';
-  }
-
-  /**
-   * 執行 Jest，回傳標準化 TestResults
-   * @param {string[]} testPaths - 若為空則執行全部
-   * @param {Object} options
-   * @param {boolean} [options.verbose]
-   * @returns {Promise<import('./executor-base.js').TestResults>}
-   */
-  async run(testPaths = [], options = {}) {
-    const pathArgs = testPaths.length > 0 ? testPaths.join(' ') : '';
-    const cmd = `npx jest --json --forceExit --passWithNoTests ${pathArgs}`;
-    const projectRoot = options.projectRoot || process.cwd();
-
-    // 若 node_modules 不存在，自動執行 npm install 安裝依賴
-    const nodeModulesPath = join(projectRoot, 'node_modules');
-    if (!existsSync(nodeModulesPath)) {
-      console.log('   📦 偵測到 node_modules 不存在，自動執行 npm install...');
-      try {
-        execSync('npm install', {
-          cwd: projectRoot,
-          stdio: 'inherit',
-          timeout: 120_000, // 2 分鐘安裝時間上限
-        });
-        console.log('   ✅ 依賴安裝完成');
-      } catch (err) {
-        console.warn(`   ⚠️  npm install 失敗：${err.message}`);
-        console.warn('   跳過測試步驟，代碼已生成但未驗證');
-        return this.emptyResults(this.framework);
-      }
-    }
-
-    if (options.verbose) {
-      console.log(`   執行命令：${cmd}`);
-    }
-
-    let output = '';
-    try {
-      output = execSync(cmd, {
-        encoding: 'utf-8',
-        timeout: this.timeout,
-        stdio: ['pipe', 'pipe', 'pipe'],
-        cwd: projectRoot,
-      });
-    } catch (error) {
-      // Jest 測試失敗時 exit code 非 0，但 stdout 仍有 JSON
-      output = error.stdout || error.output?.[1] || '';
-    }
-
-    return this.parseResults(output);
-  }
-
-  /**
-   * 將 Jest --json 輸出解析為標準 TestResults
-   * @param {string} output
-   * @returns {import('./executor-base.js').TestResults}
-   */
-  parseResults(output) {
-    const result = this.emptyResults(this.framework);
-    result.rawOutput = output;
-
-    let json;
-    try {
-      // Jest --json 可能混有非 JSON 前綴，找第一個 { 開始
-      const start = output.indexOf('{');
-      if (start === -1) return result;
-      json = JSON.parse(output.slice(start));
-    } catch (_) {
-      return result;
-    }
-
-    result.total = json.numTotalTests ?? 0;
-    result.passed = json.numPassedTests ?? 0;
-    result.failed = json.numFailedTests ?? 0;
-    result.skipped = (json.numPendingTests ?? 0) + (json.numTodoTests ?? 0);
-    result.duration = json.testResults?.reduce((acc, s) => acc + (s.perfStats?.runtime ?? 0), 0) ?? 0;
-
-    for (const suite of json.testResults ?? []) {
-      const suiteName = suite.testFilePath?.replace(process.cwd(), '').replace(/^\//, '') ?? '';
-      for (const t of suite.testResults ?? []) {
-        result.tests.push({
-          name: t.fullName ?? t.title,
-          suite: suiteName,
-          passed: t.status === 'passed',
-          duration: t.duration ?? 0,
-          error: t.failureMessages?.join('\n') || null,
-        });
-      }
-    }
-
-    return result;
-  }
-}

package/src/dev-modules/test/mocha-executor.js

@@ -1,95 +0,0 @@
-/**
- * Mocha 測試執行器
- * 使用 --reporter json 取得結構化輸出
- */
-
-import { execSync } from 'child_process';
-import { ExecutorBase } from './executor-base.js';
-
-export class MochaExecutor extends ExecutorBase {
-  constructor(options = {}) {
-    super(options);
-    this.framework = 'mocha';
-  }
-
-  /**
-   * 執行 Mocha，回傳標準化 TestResults
-   * @param {string[]} testPaths
-   * @param {Object} options
-   * @returns {Promise<import('./executor-base.js').TestResults>}
-   */
-  async run(testPaths = [], options = {}) {
-    const pathArgs =
-      testPaths.length > 0 ? testPaths.map((p) => `"${p}"`).join(' ') : '"test/**/*.js" "tests/**/*.js"';
-    const cmd = `npx mocha --reporter json ${pathArgs}`;
-
-    if (options.verbose) {
-      console.log(`   執行命令：${cmd}`);
-    }
-
-    let output = '';
-    try {
-      output = execSync(cmd, {
-        encoding: 'utf-8',
-        timeout: this.timeout,
-        stdio: ['pipe', 'pipe', 'pipe'],
-        cwd: options.projectRoot || process.cwd(),
-      });
-    } catch (error) {
-      // Mocha 失敗時 exit code 非 0，stdout 仍有 JSON
-      output = error.stdout || error.output?.[1] || '';
-    }
-
-    return this.parseResults(output);
-  }
-
-  /**
-   * 將 Mocha --reporter json 輸出解析為標準 TestResults
-   * @param {string} output
-   * @returns {import('./executor-base.js').TestResults}
-   */
-  parseResults(output) {
-    const result = this.emptyResults(this.framework);
-    result.rawOutput = output;
-
-    let json;
-    try {
-      const start = output.indexOf('{');
-      if (start === -1) return result;
-      json = JSON.parse(output.slice(start));
-    } catch (_) {
-      return result;
-    }
-
-    const stats = json.stats || {};
-    result.total = stats.tests ?? 0;
-    result.passed = stats.passes ?? 0;
-    result.failed = stats.failures ?? 0;
-    result.skipped = stats.pending ?? 0;
-    result.duration = stats.duration ?? 0;
-
-    // passes
-    for (const t of json.passes ?? []) {
-      result.tests.push({
-        name: t.fullTitle ?? t.title,
-        suite: t.fullTitle?.replace(t.title, '').trim() ?? '',
-        passed: true,
-        duration: t.duration ?? 0,
-        error: null,
-      });
-    }
-
-    // failures
-    for (const t of json.failures ?? []) {
-      result.tests.push({
-        name: t.fullTitle ?? t.title,
-        suite: t.fullTitle?.replace(t.title, '').trim() ?? '',
-        passed: false,
-        duration: t.duration ?? 0,
-        error: t.err?.message || t.err?.stack || null,
-      });
-    }
-
-    return result;
-  }
-}

package/src/dev-modules/test/result-formatter.js

@@ -1,90 +0,0 @@
-/**
- * 測試結果格式化模組
- * 將 TestResults 轉換為 GitHub Markdown 格式，供發佈到 Issue
- */
-
-/** 唯一識別標記，用於在多次執行時更新同一則評論 */
-export const COMMENT_MARKER = '<!-- ai-autodev-test-results -->';
-
-export class ResultFormatter {
-  /**
-   * 將 TestResults 格式化為 Markdown 字串
-   * @param {import('./executor-base.js').TestResults} results
-   * @param {import('../core/issue-parser.js').IssueData} issueData
-   * @param {Object} [meta] - 額外的 meta 資訊
-   * @returns {string}
-   */
-  formatAsMarkdown(results, issueData, meta = {}) {
-    const now = new Date().toISOString().replace('T', ' ').slice(0, 19);
-    const passRate = results.total > 0
-      ? ((results.passed / results.total) * 100).toFixed(1)
-      : '0.0';
-    const allPassed = results.failed === 0 && results.total > 0;
-    const statusEmoji = allPassed ? '✅' : '❌';
-    const durationSec = (results.duration / 1000).toFixed(2);
-
-    const lines = [
-      COMMENT_MARKER,
-      '',
-      `## ${statusEmoji} 自動測試報告`,
-      '',
-      `> 由 \`ai autodev\` 自動執行 · ${now} UTC`,
-      '',
-      '### 摘要',
-      '',
-      '| 項目 | 結果 |',
-      '|------|------|',
-      `| 框架 | \`${results.framework}\` |`,
-      `| 總測試數 | ${results.total} |`,
-      `| ✅ 通過 | ${results.passed} |`,
-      `| ❌ 失敗 | ${results.failed} |`,
-      `| ⏭️ 跳過 | ${results.skipped} |`,
-      `| 通過率 | **${passRate}%** |`,
-      `| 執行時間 | ${durationSec}s |`,
-      '',
-    ];
-
-    // 失敗詳情
-    const failedTests = results.tests.filter((t) => !t.passed);
-    if (failedTests.length > 0) {
-      lines.push('### ❌ 失敗測試');
-      lines.push('');
-      for (const t of failedTests.slice(0, 20)) {
-        lines.push(`#### \`${t.name}\``);
-        if (t.suite) lines.push(`- **Suite**: ${t.suite}`);
-        if (t.error) {
-          lines.push('```');
-          lines.push(t.error.slice(0, 500));
-          lines.push('```');
-        }
-        lines.push('');
-      }
-      if (failedTests.length > 20) {
-        lines.push(`> ... 還有 ${failedTests.length - 20} 個失敗測試未顯示`);
-        lines.push('');
-      }
-    }
-
-    // 後續步驟
-    lines.push('### 下一步');
-    lines.push('');
-    if (allPassed) {
-      lines.push('- 🎉 所有測試通過！');
-      if (meta.commitHash) {
-        lines.push(`- 📦 已自動提交：\`${meta.commitHash}\``);
-      }
-      if (meta.prUrl) {
-        lines.push(`- 🔗 已自動建立 PR：${meta.prUrl}`);
-      }
-    } else {
-      lines.push('- 請修復上方列出的失敗測試');
-      lines.push('- 修復後重新執行 `ai autodev <issue>`');
-      if (results.failed > 0) {
-        lines.push(`- 或執行 \`npx ${results.framework} --watch\` 進行偵錯`);
-      }
-    }
-
-    lines.push('');
-    return lines.join('\n');
-  }
-}