ai-git-tools 2.0.68 → 2.0.70

package/src/commands/write-and-test.js

@@ -1,469 +0,0 @@
-/**
- * write-and-test 命令
- * 為指定檔案生成 Jest 測試，執行測試，失敗時自動修復（最多 2 次）
- */
-
-import { resolve, basename, dirname, join } from 'path';
-import { existsSync, readFileSync, writeFileSync, unlinkSync } from 'fs';
-import { execSync } from 'child_process';
-import { tmpdir } from 'os';
-import { TestGenerator } from '../core/test-generator.js';
-import { TestRunner } from '../core/test-runner.js';
-import { AIClient } from '../core/ai-client.js';
-import { Logger } from '../utils/logger.js';
-
-const STATE_FILE = '.ai-git-dev-state.json';
-
-function loadDevState() {
-  const statePath = join(process.cwd(), STATE_FILE);
-  if (!existsSync(statePath)) return null;
-  try {
-    return JSON.parse(readFileSync(statePath, 'utf-8'));
-  } catch {
-    return null;
-  }
-}
-
-export const TEST_TYPE_CHOICES = [
-  {
-    name: '寫測試（自動判斷 Jest 單元測試 / 元件測試）',
-    value: 'auto',
-  },
-  {
-    name: '寫 Jest 單元測試',
-    value: 'unit',
-  },
-  {
-    name: '寫元件測試',
-    value: 'component',
-  },
-  {
-    name: '同時寫 Jest 單元測試 + 元件測試',
-    value: 'both',
-  },
-];
-
-export function normalizeTestTypeSelection(testType = 'auto') {
-  const rawValues = Array.isArray(testType)
-    ? testType
-    : String(testType)
-      .split(',')
-      .map((value) => value.trim())
-      .filter(Boolean);
-
-  const normalizedValues = rawValues.length > 0 ? rawValues : ['auto'];
-  const resolvedValues = normalizedValues.flatMap((value) => {
-    const normalized = value.toLowerCase();
-
-    if (normalized === 'auto' || normalized === 'unit' || normalized === 'component') {
-      return normalized;
-    }
-
-    if (normalized === 'both' || normalized === 'all') {
-      return ['unit', 'component'];
-    }
-
-    if (normalized === 'jest' || normalized === 'jest-unit' || normalized === 'unit-test') {
-      return 'unit';
-    }
-
-    if (normalized === 'component-test' || normalized === 'react-component') {
-      return 'component';
-    }
-
-    throw new Error(`不支援的測試類型：${value}`);
-  });
-
-  return [...new Set(resolvedValues)];
-}
-
-export function resolveRequestedTestTypes(sourceFilePath, requestedTestType = 'auto') {
-  const normalizedTestTypes = normalizeTestTypeSelection(requestedTestType);
-
-  if (!normalizedTestTypes.includes('auto')) {
-    return normalizedTestTypes;
-  }
-
-  const sourceCode = readFileSync(sourceFilePath, 'utf-8');
-  const inferredTestType = TestGenerator.resolveTestType(sourceFilePath, sourceCode, 'auto');
-
-  return [...new Set(
-    normalizedTestTypes.flatMap((testType) => (testType === 'auto' ? inferredTestType : testType))
-  )];
-}
-
-function formatTestTypes(testTypes) {
-  const labels = {
-    auto: '自動判斷',
-    unit: 'Jest 單元測試',
-    component: '元件測試',
-  };
-
-  return testTypes.map((testType) => labels[testType] || testType).join('、');
-}
-
-export async function writeAndTestCommand(options = {}) {
-  const logger = new Logger();
-
-  // 自動從 state 檔讀取 file / issue（指令列將覆蓋）
-  const state = loadDevState();
-  const issueNumber = options.issue || state?.issueNumber;
-  const maxFixes = parseInt(options.maxFixes || '3', 10);
-
-  // 決定要處理的檔案清單
-  let sourceFiles = [];
-  let fromState = false;
-  let fromGit = false;
-
-  if (options.file) {
-    // 明確指定單一檔案
-    sourceFiles = [options.file];
-  } else if (state?.filePath) {
-    // 從上一步 dev-from-issue 讀取
-    sourceFiles = [state.filePath];
-    fromState = true;
-  } else {
-    // 從 git 偵測所有異動的原始碼檔案
-    sourceFiles = await detectChangedSourceFiles(logger);
-    fromGit = sourceFiles.length > 0;
-  }
-
-  if (sourceFiles.length === 0) {
-    logger.error('偵測不到異動的原始碼，請用 --file 指定目標檔案。');
-    throw new Error('缺少原始碼路徑');
-  }
-
-  logger.header('write-and-test');
-  if (fromState) {
-    logger.info('從上一步 dev-from-issue 自動讀取');
-  } else if (fromGit) {
-    logger.info(`從 git 異動記錄偵測到 ${sourceFiles.length} 個檔案`);
-  }
-  console.log('');
-
-  const allResults = [];
-  for (const filePath of sourceFiles) {
-    const result = await processOneFile({ filePath, maxFixes, fromState, fromGit, options, logger });
-    allResults.push({ filePath, ...result });
-  }
-
-  // 所有檔案處理完成後，才發射一則聚合報告
-  if (issueNumber) {
-    await postAggregatedReport(issueNumber, allResults, options.model, logger);
-  }
-
-  return allResults.length === 1 ? allResults[0] : allResults;
-}
-
-async function processOneFile({ filePath, maxFixes, fromState, fromGit, options, logger }) {
-  const testDir = options.testDir || '__tests__';
-  const absoluteSourcePath = resolve(process.cwd(), filePath);
-  if (!existsSync(absoluteSourcePath)) {
-    logger.error(`原始碼不存在：${absoluteSourcePath}`);
-    throw new Error(`找不到原始碼：${absoluteSourcePath}`);
-  }
-
-  // 自動偵測時預設 both，手動指定時依 --test-type
-  const resolvedTestTypes = resolveRequestedTestTypes(absoluteSourcePath, options.testType || (fromState || fromGit ? 'both' : 'auto'));
-  const testTargets = resolvedTestTypes.map((testType) => ({
-    testType,
-    testFilePath: deriveTestFilePath(absoluteSourcePath, testType, testDir),
-  }));
-
-  console.log(`── ${filePath}`);
-  console.log(`   測試類型：${formatTestTypes(resolvedTestTypes)}`);
-  testTargets.forEach(({ testType, testFilePath }) => {
-    console.log(`   ${testType === 'component' ? '元件測試' : '單元測試'}：${testFilePath}`);
-  });
-  console.log('');
-
-
-  // 1. 生成測試
-  logger.step('正在生成測試代碼...');
-  const generatedTests = [];
-  for (const { testType, testFilePath } of testTargets) {
-    const generatedTest = await TestGenerator.generateTests(
-      absoluteSourcePath,
-      testFilePath,
-      testType,
-      options.model
-    );
-    generatedTests.push(generatedTest);
-    logger.success(`測試已寫入：${testFilePath}`);
-  }
-  logger.info(`實際測試類型：${formatTestTypes(generatedTests.map(({ testType }) => testType))}`);
-
-  // 2. 執行測試 + 自動修復循環
-  let lastErrors = [];
-  for (let attempt = 0; attempt <= maxFixes; attempt++) {
-    if (attempt > 0) {
-      logger.step(`正在進行第 ${attempt}/${maxFixes} 次自動修復...`);
-      await TestGenerator.generateFix(absoluteSourcePath, lastErrors, attempt, options.model);
-      logger.success('修復代碼已更新。');
-    }
-
-    logger.step(`正在執行測試${attempt > 0 ? `（第 ${attempt} 次修復後）` : ''}...`);
-    const result = await TestRunner.runTests(generatedTests.map(({ testFilePath }) => testFilePath));
-
-    if (result.success) {
-      logger.success('所有測試通過！ 🎉');
-      return {
-        success: true,
-        testFilePaths: generatedTests.map(({ testFilePath }) => testFilePath),
-        testTypes: generatedTests.map(({ testType }) => testType),
-        attempts: attempt,
-      };
-    }
-
-    lastErrors = result.errors;
-    logger.warning(`測試失敗（${result.errors.length} 個錯誤）：`);
-    result.errors.forEach((e) => {
-      console.log('');
-      console.log(e.split('\n').slice(0, 10).join('\n'));
-    });
-
-    if (attempt >= maxFixes) {
-      // 已達最大嘗試次數，升級給使用者
-      logger.section('⚠️  自動修復失敗，需要人工介入');
-      console.log(`已嘗試自動修復 ${maxFixes} 次，測試仍未通過。`);
-      console.log('');
-      console.log('請手動查看以下錯誤並修正：');
-      lastErrors.forEach((e, i) => {
-        console.log(`\n[錯誤 ${i + 1}]`);
-        console.log(e);
-      });
-      console.log('');
-      console.log(`原始碼路徑：${absoluteSourcePath}`);
-      generatedTests.forEach(({ testFilePath }) => {
-        console.log(`測試路徑  ：${testFilePath}`);
-      });
-      const failedResult = {
-        success: false,
-        testFilePaths: generatedTests.map(({ testFilePath }) => testFilePath),
-        errors: lastErrors,
-        testTypes: generatedTests.map(({ testType }) => testType),
-        attempts: maxFixes,
-      };
-      return failedResult;
-    }
-  }
-}
-
-// ============================================================
-// GitHub Issue 測試報告留言
-// ============================================================
-
-/**
- * 生成 mermaid 流程圖（基於原始碼邏輯）
- */
-async function generateMermaidDiagram(sourceFilePath, model) {
-  const sourceFileName = basename(sourceFilePath);
-  let sourceCode = '';
-  try {
-    sourceCode = readFileSync(sourceFilePath, 'utf-8').split('\n').slice(0, 150).join('\n');
-  } catch {
-    return null;
-  }
-
-  const prompt = `你是一位軟體工程師。請閱讀以下原始碼，生成一個 Mermaid flowchart 圖，描述這個模組的主要邏輯流程。
-
-## 規則
-- 只輸出 mermaid 程式碼區塊（含 \`\`\`mermaid 與結尾 \`\`\`），不要有任何說明
-- 使用 flowchart TD 格式
-- 節點文字使用繁體中文
-- 保持簡潔，最多 20 個節點
-
-## 檔案：${sourceFileName}
-
-\`\`\`
-${sourceCode}
-\`\`\``.trim();
-
-  try {
-    const raw = await AIClient.sendAndWait(prompt, model);
-    const match = raw.match(/```mermaid[\s\S]*?```/);
-    return match ? match[0] : null;
-  } catch {
-    return null;
-  }
-}
-
-/**
- * 將所有檔案的測試結果彙整為一則 Issue 留言，並為通過的檔案附上 mermaid 流程圖
- * @param {Array<{filePath,success,testFilePaths,testTypes,attempts,errors?}>} allResults
- */
-async function postAggregatedReport(issueNumber, allResults, model, logger) {
-  if (!allResults || allResults.length === 0) return;
-
-  logger.step(`正在將測試報告發佈到 Issue #${issueNumber}...`);
-
-  const cwd = process.cwd();
-  const total = allResults.length;
-  const passed = allResults.filter((r) => r.success).length;
-  const failed = total - passed;
-  const typeLabels = { unit: 'Jest 單元測試', component: '元件測試', auto: '自動判斷' };
-
-  // 摘要表格
-  const summaryEmoji = failed === 0 ? '✅' : '⚠️';
-  const header =
-    `## ${summaryEmoji} 測試報告總覽\n\n` +
-    `**異動檔案**：${total} 個｜**通過**：${passed}｜**失敗**：${failed}\n\n` +
-    `| 狀態 | 檔案 | 測試類型 | 結果 |\n` +
-    `| :---: | --- | --- | --- |\n`;
-
-  const tableRows = allResults.map((r) => {
-    const relPath = r.filePath.replace(cwd + '/', '');
-    const testTypesStr = (r.testTypes || []).map((t) => typeLabels[t] || t).join('、');
-    const statusEmoji = r.success ? '✅' : '❌';
-    const resultStr = r.success
-      ? r.attempts > 0 ? `通過（修復 ${r.attempts} 次）` : '一次通過'
-      : `失敗（已嘗試修復 ${r.attempts} 次）`;
-    return `| ${statusEmoji} | \`${relPath}\` | ${testTypesStr} | ${resultStr} |`;
-  });
-
-  // 個別檔案詳情
-  const fileDetails = allResults.map((r) => {
-    const relPath = r.filePath.replace(cwd + '/', '');
-    const statusEmoji = r.success ? '✅' : '❌';
-    const relTestPaths = (r.testFilePaths || [])
-      .map((p) => `- \`${p.replace(cwd + '/', '')}\``)
-      .join('\n');
-
-    let section = `\n---\n\n### ${statusEmoji} \`${relPath}\`\n\n**測試檔案**：\n${relTestPaths}\n`;
-
-    if (!r.success && r.errors?.length) {
-      const errorSummary = r.errors
-        .slice(0, 2)
-        .map((e, i) => `**錯誤 ${i + 1}**\n\`\`\`\n${e.split('\n').slice(0, 12).join('\n')}\n\`\`\``)
-        .join('\n\n');
-      section += `\n**錯誤摘要**：\n\n${errorSummary}\n`;
-    }
-
-    return section;
-  });
-
-  // 為通過的檔案生成 mermaid 流程圖
-  const mermaidSections = [];
-  for (const r of allResults.filter((r) => r.success)) {
-    const absPath = resolve(cwd, r.filePath);
-    const diagram = await generateMermaidDiagram(absPath, model);
-    if (diagram) {
-      const relPath = r.filePath.replace(cwd + '/', '');
-      mermaidSections.push(`\n### \`${relPath}\`\n\n${diagram}`);
-    }
-  }
-
-  const mermaidBlock =
-    mermaidSections.length > 0
-      ? `\n---\n\n## 📊 邏輯流程圖\n${mermaidSections.join('\n')}\n`
-      : '';
-
-  const body = header + tableRows.join('\n') + fileDetails.join('') + mermaidBlock;
-
-  const tmpFile = join(tmpdir(), `ai-git-tools-report-${Date.now()}.md`);
-  try {
-    writeFileSync(tmpFile, body, 'utf-8');
-    execSync(`gh issue comment ${issueNumber} --body-file "${tmpFile}"`, {
-      encoding: 'utf-8',
-      stdio: 'pipe',
-      cwd,
-    });
-    logger.success(`測試報告已發佈到 Issue #${issueNumber}`);
-  } catch (error) {
-    logger.warning(`無法發佈到 Issue（${error.message}），請確認 gh CLI 已登入且有 Issue 存取權限。`);
-  } finally {
-    try { unlinkSync(tmpFile); } catch { /* 忽略清理失敗 */ }
-  }
-}
-
-/**
- * 依據原始檔案路徑推導測試檔案路徑
- * @param {string} testDir - 測試輸出目錄：'__tests__'（預設） 或 相對專案根的路徑（如 'tests'）
- */
-export function deriveTestFilePath(sourceFilePath, testType = 'unit', testDir = '__tests__') {
-  const cwd = process.cwd();
-  const name = basename(sourceFilePath).replace(/\.(js|jsx|ts|tsx|mjs|cjs)$/, '');
-  const ext = /\.(ts|tsx)$/.test(sourceFilePath) ? '.ts' : '.js';
-  const suffix = testType === 'component' ? 'component' : 'unit';
-
-  if (testDir === '__tests__') {
-    // 預設：放在原始檔旁的 __tests__ 子目錄
-    return join(dirname(sourceFilePath), '__tests__', `${name}.${suffix}.test${ext}`);
-  }
-
-  // 自訂目錄：放在專案根 testDir 底下，保留原始檔的相對路徑結構
-  const relDir = dirname(sourceFilePath).replace(cwd, '').replace(/^\//, '');
-  return join(cwd, testDir, relDir, `${name}.${suffix}.test${ext}`);
-}
-
-/**
- * 透過 git 偵測所有異動的原始碼檔案（回傳陣列）
- * 優先順序：staged → 工作區（unstaged+untracked） → 整個 branch（vs main/master） → 最近 10 commits
- * 排除測試檔、設定檔、lock 檔
- */
-async function detectChangedSourceFiles(logger) {
-  const SOURCE_EXTENSIONS = /\.(js|jsx|ts|tsx|mjs|cjs)$/;
-  const EXCLUDED = /(__tests__|\.test\.|\.spec\.|\.config\.|node_modules|dist\/|\.lock$|package\.json)/;
-  const cwd = process.cwd();
-
-  function filterSourceFiles(raw) {
-    return raw
-      .split('\n')
-      .map((f) => f.trim().replace(/^[MADRCU?!\s]+/, '').replace(/^"(.*)"$/, '$1'))
-      .filter((f) => f && SOURCE_EXTENSIONS.test(f) && !EXCLUDED.test(f) && existsSync(resolve(cwd, f)));
-  }
-
-  function run(cmd) {
-    return execSync(cmd, { encoding: 'utf-8', stdio: 'pipe', cwd });
-  }
-
-  try {
-    // 1. staged 檔案
-    const staged = filterSourceFiles(run('git diff --cached --name-only'));
-
-    // 2. unstaged + untracked
-    const unstaged = filterSourceFiles(run('git diff --name-only'));
-    const untracked = filterSourceFiles(run('git ls-files --others --exclude-standard'));
-    const working = [...new Set([...unstaged, ...untracked])];
-
-    // 3. 整個 branch 相對於 upstream / main / master 的變更
-    const branchFiles = getBranchChangedFiles(filterSourceFiles, run);
-
-    // 合併全部（去重）；staged > working > branch
-    const all = [...new Set([...staged, ...working, ...branchFiles])];
-
-    if (all.length > 0) {
-      const breakdown = [
-        staged.length && `staged ${staged.length}`,
-        working.length && `工作區 ${working.length}`,
-        branchFiles.length && `branch ${branchFiles.length}`,
-      ].filter(Boolean).join('、');
-      logger.info(`偵測到 ${all.length} 個異動檔案（${breakdown}）`);
-      return all;
-    }
-  } catch {
-    // git 取得失敗，直接回傳空陣列
-  }
-
-  return [];
-}
-
-function getBranchChangedFiles(filterSourceFiles, run) {
-  // 依序嘗試找到 merge-base，再比較 HEAD
-  const baseCandidates = ['@{u}', 'origin/main', 'origin/master', 'main', 'master'];
-  for (const base of baseCandidates) {
-    try {
-      const mergeBase = run(`git merge-base HEAD ${base}`).trim();
-      const files = filterSourceFiles(run(`git diff --name-only ${mergeBase}...HEAD`));
-      if (files.length > 0) return files;
-    } catch {
-      continue;
-    }
-  }
-  // 最後 fallback：最近 10 commits
-  try {
-    return filterSourceFiles(run('git diff --name-only HEAD~10...HEAD'));
-  } catch {
-    return [];
-  }
-}

package/src/core/test-generator.js

@@ -1,165 +0,0 @@
-/**
- * TestGenerator 服務
- * 為指定的原始碼檔案使用 AIClient 生成 Jest 測試
- */
-
-import { readFileSync, writeFileSync, mkdirSync } from 'fs';
-import { dirname } from 'path';
-import { AIClient } from './ai-client.js';
-
-export class TestGenerator {
-  /**
-   * 為原始檔案生成測試並寫入測試檔案
-   * @param {string} sourceFilePath - 原始碼路徑（絕對路徑）
-   * @param {string} testFilePath - 測試檔案輸出路徑（絕對路徑）
-   * @param {'auto'|'unit'|'component'} testType - 測試類型（預設 'auto'）
-   * @param {string} [model] - AI 模型（可選）
-   * @returns {Promise<{ testFilePath, linesCount, testType: 'unit'|'component' }>}
-   */
-  static async generateTests(sourceFilePath, testFilePath, testType = 'auto', model) {
-    let sourceCode;
-    try {
-      sourceCode = readFileSync(sourceFilePath, 'utf-8');
-    } catch {
-      throw new Error(`無法讀取原始碼：${sourceFilePath}`);
-    }
-
-    const resolvedTestType = TestGenerator.resolveTestType(sourceFilePath, sourceCode, testType);
-    const prompt = TestGenerator._buildPrompt(sourceCode, sourceFilePath, resolvedTestType);
-    const rawTests = await AIClient.sendAndWait(prompt, model);
-    const testCode = TestGenerator._finalizeTestCode(
-      TestGenerator._cleanCode(rawTests),
-      resolvedTestType
-    );
-
-    // 確保目錄存在
-    mkdirSync(dirname(testFilePath), { recursive: true });
-    writeFileSync(testFilePath, testCode, 'utf-8');
-
-    return {
-      testFilePath,
-      linesCount: testCode.split('\n').length,
-      testType: resolvedTestType,
-    };
-  }
-
-  /**
-   * 解析最終測試類型
-   * @param {string} sourceFilePath
-   * @param {string} sourceCode
-   * @param {'auto'|'unit'|'component'} requestedTestType
-   * @returns {'unit'|'component'}
-   */
-  static resolveTestType(sourceFilePath, sourceCode, requestedTestType = 'auto') {
-    if (requestedTestType === 'unit' || requestedTestType === 'component') {
-      return requestedTestType;
-    }
-
-    const normalizedPath = sourceFilePath.toLowerCase();
-    const looksLikeComponentPath = /\.(jsx|tsx)$/.test(normalizedPath)
-      || /component|page|view|screen/.test(normalizedPath);
-    const hasReactImport = /from\s+['"]react['"]|from\s+['"]react-dom['"]/.test(sourceCode);
-    const hasTestingLibraryHint = /use(State|Effect|Memo|Callback|Reducer|Ref|Context)|React\./.test(sourceCode);
-    const hasJsx = /<([A-Z][\w]*|[a-z][\w-]*)(\s[^>]*)?>/.test(sourceCode);
-
-    return looksLikeComponentPath || hasReactImport || hasTestingLibraryHint || hasJsx
-      ? 'component'
-      : 'unit';
-  }
-
-  /**
-   * 使用錯誤訊息重新生成修復後的原始碼
-   * @param {string} sourceFilePath - 原始碼路徑
-   * @param {string[]} testErrors - Jest 錯誤訊息陣列
-   * @param {number} attempt - 第幾次修復嘗試（1 或 2）
-   * @param {string} [model] - AI 模型（可選）
-   * @returns {Promise<void>}
-   */
-  static async generateFix(sourceFilePath, testErrors, attempt, model) {
-    let sourceCode;
-    try {
-      sourceCode = readFileSync(sourceFilePath, 'utf-8');
-    } catch {
-      throw new Error(`無法讀取原始碼：${sourceFilePath}`);
-    }
-
-    const prompt = TestGenerator._buildFixPrompt(sourceCode, testErrors, attempt);
-    const rawFixed = await AIClient.sendAndWait(prompt, model);
-    const fixedCode = TestGenerator._cleanCode(rawFixed);
-
-    writeFileSync(sourceFilePath, fixedCode, 'utf-8');
-  }
-
-  /**
-   * 建立測試生成 prompt
-   */
-  static _buildPrompt(sourceCode, sourceFilePath, testType) {
-    return `你是一位 Jest 測試專家。請為以下 ${testType === 'component' ? 'React 元件' : '模組'} 撰寫全面的 ${testType} 測試。
-
-## 原始碼（${sourceFilePath}）
-\`\`\`
-${sourceCode}
-\`\`\`
-
-## 測試要求
-1. 使用現代 Jest 語法（describe / it / expect）
-2. 涵蓋所有主要函數及邊界情況
-3. Mock 所有外部依賴（檔案系統、網路、子程序等）
-4. 使用 beforeEach / afterEach 管理測試狀態
-5. 測試名稱使用繁體中文描述
-${testType === 'component'
-      ? '6. 使用 @testing-library/react 撰寫互動與渲染測試\n7. 檔案最前面必須加上 /** @jest-environment jsdom */ 註解'
-      : '6. 以純邏輯與副作用隔離為主，避免使用 DOM API'}
-
-## 輸出規則
-- 只輸出可直接執行的測試程式碼
-- 不要 markdown 區塊（\`\`\`）、不要任何說明文字
-- 第一行必須是 /** @jest-environment jsdom */ 或 import / require 陳述式`.trim();
-  }
-
-  /**
-   * 建立修復 prompt
-   */
-  static _buildFixPrompt(sourceCode, testErrors, attempt) {
-    return `這是第 ${attempt} 次修復嘗試。以下是目前的原始碼和失敗的測試錯誤，請修正原始碼使測試通過。
-
-## 當前原始碼
-\`\`\`
-${sourceCode}
-\`\`\`
-
-## 測試錯誤
-${testErrors.join('\n')}
-
-## 修復規則
-- 只修改原始碼，不修改測試
-- 保留原有功能，只修正造成測試失敗的部分
-- 只輸出修正後的完整原始碼，不要任何說明文字
-- 不要 markdown 區塊（\`\`\`）`.trim();
-  }
-
-  /**
-   * 移除 AI 回傳中的 markdown code fence
-   */
-  static _cleanCode(raw) {
-    return raw
-      .replace(/^```[\w]*\n?/gm, '')
-      .replace(/\n?```$/gm, '')
-      .trim();
-  }
-
-  /**
-   * 針對元件測試補上必要的 jsdom 設定
-   */
-  static _finalizeTestCode(testCode, testType) {
-    if (testType !== 'component') {
-      return testCode;
-    }
-
-    if (testCode.startsWith('/** @jest-environment jsdom */')) {
-      return testCode;
-    }
-
-    return `/** @jest-environment jsdom */\n${testCode}`;
-  }
-}