ai-git-tools 2.0.39 → 2.0.41

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

@@ -0,0 +1,90 @@
+/**
+ * 測試結果格式化模組
+ * 將 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');
+  }
+}

package/src/dev-modules/test/test-detector.js

@@ -0,0 +1,170 @@
+/**
+ * 測試框架檢測模組
+ * 自動偵測專案使用的測試框架（Jest / Vitest / Mocha）
+ * 並發現所有相關測試檔案
+ */
+
+import { existsSync, readdirSync, statSync, readFileSync } from 'fs';
+import { resolve, join } from 'path';
+
+/** 支援的框架識別字 */
+export const FRAMEWORKS = {
+  JEST: 'jest',
+  VITEST: 'vitest',
+  MOCHA: 'mocha',
+};
+
+export class TestDetector {
+  /**
+   * @param {string} projectRoot - 專案根目錄（預設 process.cwd()）
+   */
+  constructor(projectRoot = process.cwd()) {
+    this.projectRoot = projectRoot;
+  }
+
+  /**
+   * 偵測測試框架
+   * 優先順序：設定檔 > package.json scripts > package.json devDependencies
+   * @returns {string|null} 框架名稱或 null
+   */
+  detectFramework() {
+    const root = this.projectRoot;
+
+    // 1. 專用設定檔
+    if (
+      existsSync(join(root, 'vitest.config.ts')) ||
+      existsSync(join(root, 'vitest.config.js')) ||
+      existsSync(join(root, 'vitest.config.mjs'))
+    ) {
+      return FRAMEWORKS.VITEST;
+    }
+
+    if (
+      existsSync(join(root, 'jest.config.js')) ||
+      existsSync(join(root, 'jest.config.ts')) ||
+      existsSync(join(root, 'jest.config.mjs')) ||
+      existsSync(join(root, 'jest.config.json'))
+    ) {
+      return FRAMEWORKS.JEST;
+    }
+
+    if (
+      existsSync(join(root, '.mocharc.js')) ||
+      existsSync(join(root, '.mocharc.cjs')) ||
+      existsSync(join(root, '.mocharc.json')) ||
+      existsSync(join(root, '.mocharc.yml')) ||
+      existsSync(join(root, '.mocharc.yaml'))
+    ) {
+      return FRAMEWORKS.MOCHA;
+    }
+
+    // 2. package.json
+    const pkgPath = join(root, 'package.json');
+    if (existsSync(pkgPath)) {
+      try {
+        const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+
+        // test script
+        const testScript = pkg.scripts?.test || '';
+        if (/\bvitest\b/.test(testScript)) return FRAMEWORKS.VITEST;
+        if (/\bjest\b/.test(testScript)) return FRAMEWORKS.JEST;
+        if (/\bmocha\b/.test(testScript)) return FRAMEWORKS.MOCHA;
+
+        // devDependencies / dependencies
+        const allDeps = {
+          ...pkg.devDependencies,
+          ...pkg.dependencies,
+        };
+        if (allDeps.vitest) return FRAMEWORKS.VITEST;
+        if (allDeps.jest || allDeps['@jest/core']) return FRAMEWORKS.JEST;
+        if (allDeps.mocha) return FRAMEWORKS.MOCHA;
+      } catch (_) {
+        // 解析失敗，繼續往下
+      }
+    }
+
+    return null;
+  }
+
+  /**
+   * 遞迴搜尋符合 patterns 的檔案
+   * @param {string} dir
+   * @param {RegExp[]} patterns
+   * @param {string[]} excludes - 排除目錄名稱
+   * @returns {string[]}
+   */
+  _glob(dir, patterns, excludes = ['node_modules', 'dist', '.next', 'coverage', '.git']) {
+    const results = [];
+
+    let entries;
+    try {
+      entries = readdirSync(dir);
+    } catch (_) {
+      return results;
+    }
+
+    for (const entry of entries) {
+      if (excludes.includes(entry)) continue;
+      const fullPath = join(dir, entry);
+      let stat;
+      try {
+        stat = statSync(fullPath);
+      } catch (_) {
+        continue;
+      }
+
+      if (stat.isDirectory()) {
+        results.push(...this._glob(fullPath, patterns, excludes));
+      } else if (patterns.some((p) => p.test(entry))) {
+        results.push(fullPath);
+      }
+    }
+
+    return results;
+  }
+
+  /**
+   * 依框架發現測試檔案
+   * @param {string} framework
+   * @param {Object} [config] - 可選：{ testPaths?: string[] }
+   * @returns {string[]}
+   */
+  discoverTests(framework, config = {}) {
+    // 若使用者明確指定路徑，直接回傳（轉為絕對路徑）
+    if (config.testPaths && config.testPaths.length > 0) {
+      return config.testPaths.map((p) => resolve(this.projectRoot, p));
+    }
+
+    const commonPatterns = [
+      /\.test\.(js|ts|jsx|tsx|mjs|cjs)$/,
+      /\.spec\.(js|ts|jsx|tsx|mjs|cjs)$/,
+    ];
+
+    switch (framework) {
+      case FRAMEWORKS.JEST:
+      case FRAMEWORKS.VITEST:
+        return this._glob(this.projectRoot, commonPatterns);
+
+      case FRAMEWORKS.MOCHA: {
+        // Mocha 慣例：test/ 或 tests/ 目錄
+        const mochaPatterns = [/\.(js|ts|mjs|cjs)$/];
+        const dirs = ['test', 'tests', 'spec', 'specs'].map((d) =>
+          join(this.projectRoot, d)
+        );
+        const results = [];
+        for (const d of dirs) {
+          if (existsSync(d)) {
+            results.push(...this._glob(d, mochaPatterns));
+          }
+        }
+        // 也搜尋根目錄的 .test. / .spec. 檔案
+        results.push(...this._glob(this.projectRoot, commonPatterns));
+        return [...new Set(results)];
+      }
+
+      default:
+        // 未知框架，使用通用 patterns
+        return this._glob(this.projectRoot, commonPatterns);
+    }
+  }
+}

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

@@ -0,0 +1,90 @@
+/**
+ * Vitest 測試執行器
+ * 使用 --reporter=json 取得結構化輸出
+ */
+
+import { execSync } from 'child_process';
+import { ExecutorBase } from './executor-base.js';
+
+export class VitestExecutor extends ExecutorBase {
+  constructor(options = {}) {
+    super(options);
+    this.framework = 'vitest';
+  }
+
+  /**
+   * 執行 Vitest，回傳標準化 TestResults
+   * @param {string[]} testPaths
+   * @param {Object} options
+   * @returns {Promise<import('./executor-base.js').TestResults>}
+   */
+  async run(testPaths = [], options = {}) {
+    const pathArgs = testPaths.length > 0 ? testPaths.join(' ') : '';
+    const cmd = `npx vitest run --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) {
+      output = error.stdout || error.output?.[1] || '';
+    }
+
+    return this.parseResults(output);
+  }
+
+  /**
+   * 將 Vitest --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;
+    }
+
+    // Vitest JSON 結構
+    const sum = (json.numPassedTests ?? 0) + (json.numFailedTests ?? 0) + (json.numPendingTests ?? 0);
+    const numTotalTests = json.numTotalTests ?? sum;
+    result.total = numTotalTests;
+    result.passed = json.numPassedTests ?? 0;
+    result.failed = json.numFailedTests ?? 0;
+    result.skipped = json.numPendingTests ?? 0;
+    result.duration = json.testResults?.reduce(
+      (acc, s) => acc + (s.perfStats?.runtime ?? s.duration ?? 0),
+      0
+    ) ?? 0;
+
+    for (const suite of json.testResults ?? []) {
+      const suiteName =
+        suite.name?.replace(process.cwd(), '').replace(/^\//, '') ?? '';
+      for (const t of suite.assertionResults ?? []) {
+        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/pr-modules/core/github-api.js

@@ -394,4 +394,88 @@ export class GitHubAPI {
       log.error('無法添加團隊 reviewers，請手動操作');
     }
   }
+
+  // ─────────────────────────────────────────────────────────────
+  // Issue 評論功能（供 ai autodev 使用）
+  // ─────────────────────────────────────────────────────────────
+
+  /**
+   * 在 Issue 上發佈評論
+   * @param {string} owner
+   * @param {string} repo
+   * @param {number} issueNumber
+   * @param {string} body - Markdown 內容
+   * @returns {{ id: number, url: string }}
+   */
+  postCommentOnIssue(owner, repo, issueNumber, body) {
+    const tmpFile = `/tmp/ai-autodev-comment-${Date.now()}.json`;
+    try {
+      const payload = JSON.stringify({ body });
+      writeFileSync(tmpFile, payload, 'utf-8');
+      const result = execSync(
+        `gh api repos/${owner}/${repo}/issues/${issueNumber}/comments --input "${tmpFile}"`,
+        { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] }
+      );
+      const data = JSON.parse(result);
+      return { id: data.id, url: data.html_url };
+    } finally {
+      this.safeUnlink(tmpFile);
+    }
+  }
+
+  /**
+   * 更新已存在的 Issue 評論
+   * @param {string} owner
+   * @param {string} repo
+   * @param {number} commentId
+   * @param {string} body
+   * @returns {{ id: number, url: string }}
+   */
+  editIssueComment(owner, repo, commentId, body) {
+    const tmpFile = `/tmp/ai-autodev-edit-${Date.now()}.json`;
+    try {
+      const payload = JSON.stringify({ body });
+      writeFileSync(tmpFile, payload, 'utf-8');
+      const result = execSync(
+        `gh api repos/${owner}/${repo}/issues/comments/${commentId} --input "${tmpFile}" -X PATCH`,
+        { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] }
+      );
+      const data = JSON.parse(result);
+      return { id: data.id, url: data.html_url };
+    } finally {
+      this.safeUnlink(tmpFile);
+    }
+  }
+
+  /**
+   * 尋找 Issue 上含有特定 marker 的評論（用於重複執行時更新而非重建）
+   * @param {string} owner
+   * @param {string} repo
+   * @param {number} issueNumber
+   * @param {string} marker - 識別字串
+   * @returns {{ id: number }|null}
+   */
+  findCommentWithMarker(owner, repo, issueNumber, marker) {
+    try {
+      const result = execSync(
+        `gh api repos/${owner}/${repo}/issues/${issueNumber}/comments --jq '.[] | {id, body}'`,
+        { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] }
+      );
+      // 每行一個 JSON 物件
+      const lines = result.trim().split('\n').filter(Boolean);
+      for (const line of lines) {
+        try {
+          const obj = JSON.parse(line);
+          if (obj.body && obj.body.includes(marker)) {
+            return { id: obj.id };
+          }
+        } catch (_) {
+          // 忽略解析錯誤
+        }
+      }
+      return null;
+    } catch (_) {
+      return null;
+    }
+  }
 }