ai-git-tools 2.0.70 → 2.0.71

package/bin/cli.js

@@ -2,14 +2,11 @@
 
 /**
  * AI Git Tools CLI
- *
+ * 
  * AI-powered Git automation for commit messages and PR generation
  * 完全重寫版本基於 scripts/ 原始實現
  */
 
-// 抑制 @github/copilot-sdk 子程序的 node:sqlite 實驗性警告
-process.env.NODE_NO_WARNINGS = '1';
-
 import { Command } from 'commander';
 import { readFileSync } from 'fs';
 import { fileURLToPath } from 'url';
@@ -18,15 +15,13 @@ import { commitCommand } from '../src/commands/commit.js';
 import { commitAllCommand } from '../src/commands/commit-all.js';
 import { prCommand } from '../src/commands/pr.js';
 import { initCommand } from '../src/commands/init.js';
-// import { planIssueCommand } from '../src/commands/plan-issue.js';
-// import { generateCodeCommand } from '../src/commands/generate-code.js';
-import { writeAndTestCommand } from '../src/commands/write-and-test.js';
-import { autoDevCommand } from '../src/commands/auto-dev.js';
 
 // 讀取 package.json 獲取版本號
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
-const packageJson = JSON.parse(readFileSync(join(__dirname, '../package.json'), 'utf-8'));
+const packageJson = JSON.parse(
+  readFileSync(join(__dirname, '../package.json'), 'utf-8')
+);
 
 const program = new Command();
 
@@ -39,7 +34,7 @@ program
 program
   .command('init')
   .description('初始化配置檔案 (.ai-git-config.mjs)')
-  .action(async options => {
+  .action(async (options) => {
     try {
       await initCommand(options);
       process.exit(0);
@@ -56,7 +51,7 @@ program
   .option('-v, --verbose', '顯示詳細輸出')
   .option('--max-diff <number>', '最大 diff 長度')
   .option('--max-retries <number>', '最大重試次數')
-  .action(async options => {
+  .action(async (options) => {
     try {
       await commitCommand(options);
       process.exit(0);
@@ -73,7 +68,7 @@ program
   .option('-v, --verbose', '顯示詳細輸出')
   .option('--max-diff <number>', '最大 diff 長度')
   .option('--max-retries <number>', '最大重試次數')
-  .action(async options => {
+  .action(async (options) => {
     try {
       await commitAllCommand(options);
       process.exit(0);
@@ -93,7 +88,7 @@ program
   .option('--auto-labels', '自動添加 Labels (預設啟用)')
   .option('--include-impact', '在 PR 中包含影響範圍分析和注意事項 (預設關閉)')
   .option('--force-new', '強制創建新 PR，不更新現有 PR')
-  .action(async options => {
+  .action(async (options) => {
     try {
       await prCommand(options);
       process.exit(0);
@@ -102,25 +97,4 @@ program
     }
   });
 
-// Auto Dev 整合命令
-program
-  .command('auto-dev')
-  .description('一鍵自動化：從 GitHub Issue 到代碼生成、測試與提交')
-  .requiredOption('--issue <number>', 'GitHub Issue 編號')
-  .option('--file <path>', '目標檔案路徑（若無則自動推斷）')
-  .option('--context <description>', '額外說明或補充需求')
-  .option('--test-type <type>', '測試類型：auto、unit 或 component（預設 auto）', 'auto')
-  .option('--max-lines <number>', '最大行數限制（預設 500）', '500')
-  .option('--max-fixes <number>', '最大自動修復次數（預設 2）', '2')
-  .option('--no-confirm', '全自動模式，跳過所有確認')
-  .option('--model <model>', '指定 AI 模型')
-  .action(async options => {
-    try {
-      await autoDevCommand(options);
-      process.exit(0);
-    } catch (error) {
-      process.exit(1);
-    }
-  });
-
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-git-tools",
-  "version": "2.0.70",
+  "version": "2.0.71",
   "description": "AI-powered Git automation tools for commit messages and PR generation",
   "main": "src/index.js",
   "type": "module",
@@ -8,8 +8,7 @@
     "ai-git-tools": "./bin/cli.js"
   },
   "scripts": {
-    "test": "jest",
-    "test:watch": "jest --watch",
+    "test": "echo \"Error: no test specified\" && exit 1",
     "prepare": "chmod +x bin/cli.js",
     "lint": "eslint src/**/*.js",
     "format": "prettier --write \"src/**/*.js\" \"bin/**/*.js\"",
@@ -41,15 +40,13 @@
   ],
   "dependencies": {
     "@github/copilot-sdk": "0.1.30",
-    "chalk": "^5.3.0",
     "commander": "^12.0.0",
-    "inquirer": "^9.2.0",
-    "ora": "^8.0.1"
+    "chalk": "^5.3.0",
+    "ora": "^8.0.1",
+    "inquirer": "^9.2.0"
   },
   "devDependencies": {
-    "@jest/globals": "^29.7.0",
     "eslint": "^8.57.0",
-    "jest": "^29.7.0",
     "prettier": "^3.2.0"
   },
   "repository": {
@@ -59,12 +56,5 @@
   "bugs": {
     "url": "https://github.com/YisoTsao/ai-git-tools/issues"
   },
-  "homepage": "https://github.com/YisoTsao/ai-git-tools#readme",
-  "jest": {
-    "testEnvironment": "node",
-    "transform": {},
-    "moduleNameMapper": {
-      "^(\\.{1,2}/.+)\\.js$": "$1"
-    }
-  }
+  "homepage": "https://github.com/YisoTsao/ai-git-tools#readme"
 }

package/src/core/ai-client.js

@@ -9,7 +9,7 @@ export class AIClient {
   /**
    * 發送 prompt 並等待回應（帶重試機制和超時保護）
    */
-  static async sendAndWait(prompt, model = 'gpt-4.1', maxRetries = 3, timeout = 120000) {
+  static async sendAndWait(prompt, model = 'gpt-4.1', maxRetries = 3, timeout = 60000) {
     let lastError = null;
 
     for (let attempt = 1; attempt <= maxRetries; attempt++) {

package/src/pr-modules/ai/code-analyzer.js

@@ -2,51 +2,24 @@ import { CopilotClient, approveAll } from '@github/copilot-sdk';
 import { CONSTANTS, PROJECT_SKILLS_CONTEXT } from '../utils/constants.js';
 import { getSkillsSummaryForPrompt, log } from '../utils/helpers.js';
 
-const AI_TIMEOUT_MS = 120000; // 2 分鐘：子程序啟動 + AI 回應時間
-
 /**
  * AI 分析器 - 負責程式碼分析和 PR 內容生成
  */
 export class AIAnalyzer {
   constructor(config = {}) {
     this.model = config.model || 'gpt-4.1';
-    this._client = null; // 複用同一個 CopilotClient，避免重複啟動子程序
-  }
-
-  /**
-   * 取得（或建立）共用的 CopilotClient
-   */
-  async _getOrCreateClient() {
-    if (!this._client) {
-      this._client = new CopilotClient();
-    }
-    return this._client;
   }
 
   /**
-   * 建立新的 AI Session（複用已有的 client）
+   * 建立 AI 客戶端
    */
-  async _createSession() {
-    const client = await this._getOrCreateClient();
-    return client.createSession({
+  async createClient() {
+    const client = new CopilotClient();
+    const session = await client.createSession({ 
       model: this.model,
-      onPermissionRequest: approveAll,
+      onPermissionRequest: approveAll 
     });
-  }
-
-  /**
-   * 釋放 CopilotClient 子程序資源
-   */
-  async close() {
-    if (this._client) {
-      try {
-        await this._client.stop();
-      } catch (e) {
-        // 忽略關閉錯誤
-      } finally {
-        this._client = null;
-      }
-    }
+    return { client, session };
   }
 
   /**
@@ -56,13 +29,13 @@ export class AIAnalyzer {
     const skillsSummary = getSkillsSummaryForPrompt(PROJECT_SKILLS_CONTEXT);
     const prompt = this.buildPRPrompt(commits, diff, skillsSummary);
 
-    const session = await this._createSession();
+    const { client, session } = await this.createClient();
 
     try {
-      // 使用超時保護（2 分鐘：包含子程序啟動時間）
+      // 使用超時保護 (60 秒)
       const responsePromise = session.sendAndWait({ prompt });
       const timeoutPromise = new Promise((_, reject) => {
-        setTimeout(() => reject(new Error(`AI 請求超時 (${AI_TIMEOUT_MS / 1000} 秒)`)), AI_TIMEOUT_MS);
+        setTimeout(() => reject(new Error('AI 請求超時 (60 秒)')), 60000);
       });
 
       const response = await Promise.race([responsePromise, timeoutPromise]);
@@ -73,8 +46,14 @@ export class AIAnalyzer {
       }
 
       return this.parsePRContent(prContent);
+    } finally {
+      // 確保 client 一定會被關閉
+      try {
+        await client.stop();
+      } catch (e) {
+        // 忽略關閉錯誤
+      }
     }
-    // 注意：不在此處 client.stop()，交由 close() 統一清理以便複用
   }
 
   /**
@@ -84,15 +63,15 @@ export class AIAnalyzer {
     const skillsSummary = getSkillsSummaryForPrompt(PROJECT_SKILLS_CONTEXT);
     const prompt = this.buildAnalysisPrompt(changedFiles, diff, commits, skillsSummary);
 
-    const session = await this._createSession();
+    const { client, session } = await this.createClient();
 
     try {
       log.info('  正在使用 AI 深度分析程式碼變更...');
-
-      // 使用超時保護（2 分鐘：包含子程序啟動時間）
+      
+      // 使用超時保護 (60 秒)
       const responsePromise = session.sendAndWait({ prompt });
       const timeoutPromise = new Promise((_, reject) => {
-        setTimeout(() => reject(new Error(`AI 請求超時 (${AI_TIMEOUT_MS / 1000} 秒)`)), AI_TIMEOUT_MS);
+        setTimeout(() => reject(new Error('AI 請求超時 (60 秒)')), 60000);
       });
 
       const response = await Promise.race([responsePromise, timeoutPromise]);
@@ -124,8 +103,14 @@ export class AIAnalyzer {
     } catch (error) {
       log.warning(`  AI 分析失敗 (${error.message})，使用基礎分析...\n`);
       return this.getFallbackAnalysis(changedFiles);
+    } finally {
+      // 確保 client 一定會被關閉
+      try {
+        await client.stop();
+      } catch (e) {
+        // 忽略關閉錯誤
+      }
     }
-    // 注意：不在此處 client.stop()，交由 close() 統一清理以便複用
   }
 
   /**

package/src/pr-modules/core/workflow.js

@@ -32,75 +32,70 @@ export class PRWorkflow {
    * 執行完整工作流程
    */
   async execute() {
-    try {
-      // 0. 確認 gh CLI 已登入（預覽模式可跳過）
-      if (!this.config.preview) {
-        const auth = this.github.checkAuth();
-        if (!auth.authenticated) {
-          log.error('GitHub CLI 未登入，請先執行: gh auth login');
-          throw new Error('GitHub CLI 未登入');
-        }
+    // 0. 確認 gh CLI 已登入（預覽模式可跳過）
+    if (!this.config.preview) {
+      const auth = this.github.checkAuth();
+      if (!auth.authenticated) {
+        log.error('GitHub CLI 未登入，請先執行: gh auth login');
+        throw new Error('GitHub CLI 未登入');
       }
+    }
 
-      // 1. 驗證環境和分支
-      const { baseBranch, headBranch } = await this.detectAndValidateBranches();
+    // 1. 驗證環境和分支
+    const { baseBranch, headBranch } = await this.detectAndValidateBranches();
 
-      // 2. 檢查是否有變更
-      await this.validateChanges(baseBranch, headBranch);
+    // 2. 檢查是否有變更
+    await this.validateChanges(baseBranch, headBranch);
 
-      // 3. 推送到遠端（預覽模式跳過）
-      if (!this.config.preview) {
-        await this.pushToRemote(headBranch);
-      }
+    // 3. 推送到遠端（預覽模式跳過）
+    if (!this.config.preview) {
+      await this.pushToRemote(headBranch);
+    }
 
-      // 4. 收集變更資訊
-      const changeData = this.collectChangeData(baseBranch, headBranch);
+    // 4. 收集變更資訊
+    const changeData = this.collectChangeData(baseBranch, headBranch);
 
-      // 5. AI 分析和生成 PR 內容
-      const prContent = await this.generatePRContent(changeData);
+    // 5. AI 分析和生成 PR 內容
+    const prContent = await this.generatePRContent(changeData);
 
-      // 6. 顯示預覽
-      this.displayPreview(prContent, changeData.stats);
+    // 6. 顯示預覽
+    this.displayPreview(prContent, changeData.stats);
 
-      // 預覽模式：僅顯示不創建
-      if (this.config.preview) {
-        log.info('預覽模式：未創建 PR');
-        return;
-      }
+    // 預覽模式：僅顯示不創建
+    if (this.config.preview) {
+      log.info('預覽模式：未創建 PR');
+      return;
+    }
 
-      // 7. 選擇 Reviewers
-      const reviewers = await this.selectReviewers(changeData);
+    // 7. 選擇 Reviewers
+    const reviewers = await this.selectReviewers(changeData);
 
-      // 8. 確認創建
-      if (!this.config.noConfirm) {
-        const confirmed = await this.askConfirmation('是否創建此 Pull Request?');
-        if (!confirmed) {
-          log.info('已取消創建 PR');
-          return;
-        }
+    // 8. 確認創建
+    if (!this.config.noConfirm) {
+      const confirmed = await this.askConfirmation('是否創建此 Pull Request?');
+      if (!confirmed) {
+        log.info('已取消創建 PR');
+        return;
       }
+    }
 
-      // 9. 創建 PR
-      const prUrl = await this.createPR(prContent, baseBranch, headBranch, reviewers);
+    // 9. 創建 PR
+    const prUrl = await this.createPR(prContent, baseBranch, headBranch, reviewers);
 
-      // 10. 添加 Labels（如果啟用）
-      if (this.config.github.autoLabels === true && prUrl) {
-        try {
-          const prNumber = prUrl.split('/').pop();
-          await this.addLabels(prNumber, {
-            ...prContent,
-            stats: changeData.stats,
-          });
-        } catch (error) {
-          log.warning('無法自動添加 Labels: ' + error.message);
-        }
+    // 10. 添加 Labels（如果啟用）
+    if (this.config.github.autoLabels === true && prUrl) {
+      try {
+        const prNumber = prUrl.split('/').pop();
+        await this.addLabels(prNumber, {
+          ...prContent,
+          stats: changeData.stats,
+        });
+      } catch (error) {
+        log.warning('無法自動添加 Labels: ' + error.message);
       }
-
-      this.logger.success('完成！');
-    } finally {
-      // 確保 AI 子程序一定被釋放
-      await this.ai.close();
     }
+
+    this.logger.success('完成！');
   }
 
   /**

package/src/commands/dev-from-issue.js

@@ -1,176 +0,0 @@
-/**
- * dev-from-issue 命令
- * 讀取 GitHub Issue → 生成實現計畫 → 生成代碼
- */
-
-import { resolve, join } from 'path';
-import { writeFileSync } from 'fs';
-import inquirer from 'inquirer';
-import { IssueReader } from '../core/issue-reader.js';
-import { CodeGenerator } from '../core/code-generator.js';
-import { AIClient } from '../core/ai-client.js';
-import { Logger } from '../utils/logger.js';
-
-const STATE_FILE = '.ai-git-dev-state.json';
-
-export function saveDevState(issueNumber, filePath) {
-  const statePath = join(process.cwd(), STATE_FILE);
-  writeFileSync(statePath, JSON.stringify({ issueNumber: String(issueNumber), filePath }, null, 2), 'utf-8');
-}
-
-export async function devFromIssueCommand(options = {}) {
-  const logger = new Logger();
-
-  const issueNumber = options.issue;
-
-  if (!issueNumber) {
-    logger.error('請提供 Issue 編號（--issue <number>）');
-    throw new Error('缺少 Issue 編號');
-  }
-
-  logger.header(`dev-from-issue`);
-
-  // ============================================================
-  // 第一步：讀取 Issue
-  // ============================================================
-  logger.step(`正在讀取 Issue #${issueNumber}...`);
-  const issue = await IssueReader.readIssue(issueNumber);
-  logger.section(`Issue #${issue.number}：${issue.title}`);
-  console.log(`作者：${issue.author} | URL：${issue.url}`);
-  if (issue.labels.length) {
-    console.log(`標籤：${issue.labels.join(', ')}`);
-  }
-  console.log('');
-
-  // ============================================================
-  // 第二步：生成實現計畫
-  // ============================================================
-  logger.step('正在分析 Issue 並生成實現計畫...');
-  const plan = await AIClient.sendAndWait(buildPlanPrompt(issue), options.model);
-  logger.section('AI 實現計畫');
-  console.log(plan);
-  console.log('');
-
-  // ============================================================
-  // 第三步：決定目標檔案路徑
-  // ============================================================
-  let filePath = options.file;
-
-  if (!filePath) {
-    filePath = await inferTargetFilePath(issue, plan, options.model);
-    if (filePath) {
-      logger.info(`自動推斷目標檔案：${filePath}`);
-    }
-  }
-
-  if (!filePath) {
-    const { file } = await inquirer.prompt([{
-      type: 'input',
-      name: 'file',
-      message: '自動推斷失敗，請輸入要生成的檔案路徑（例如：src/components/MyComponent.tsx）：',
-      validate: (input) => input.trim().length > 0 ? true : '路徑不能為空',
-    }]);
-    filePath = file;
-  }
-
-  const absoluteFilePath = resolve(process.cwd(), filePath);
-
-  // ============================================================
-  // 第五步：生成代碼
-  // ============================================================
-  logger.step(`正在生成代碼：${filePath}`);
-  let result;
-  try {
-    result = await CodeGenerator.generateFile(issue, absoluteFilePath, {
-      maxLines: parseInt(options.maxLines || '500', 10),
-      language: /\.(ts|tsx)$/.test(filePath) ? 'ts' : 'js',
-      extraContext: options.context || '',
-      model: options.model,
-    });
-  } catch (error) {
-    logger.error(`代碼生成失敗：${error.message}`);
-    throw error;
-  }
-
-  saveDevState(issueNumber, filePath);
-
-  logger.success(`代碼已寫入：${result.filePath}（${result.linesCount} 行）`);
-  console.log('');
-  logger.section('✅ 開發完成');
-  console.log(`Issue：#${issue.number} ${issue.title}`);
-  console.log(`檔案 ：${filePath}`);
-}
-
-// ============================================================
-// 工具函數
-// ============================================================
-
-function buildPlanPrompt(issue) {
-  return `你是一位軟體架構師。請閱讀以下 GitHub Issue 並建立詳細的實現計畫。
-
-## Issue #${issue.number}
-標題：${issue.title}
-
-描述：
-${issue.body || '（無描述）'}
-
-${issue.labels.length ? `標籤：${issue.labels.join(', ')}` : ''}
-
-## 輸出要求
-請輸出包含以下內容的實現計畫：
-
-1. **摘要** - 一句話說明要做什麼
-2. **需要新增/修改的檔案** - 列出所有相關檔案路徑和各自的職責
-3. **實現步驟** - 有序的任務清單，說明每個步驟的目的
-4. **注意事項** - 潛在風險或需要留意的事項（若有）
-
-請使用繁體中文，格式清晰，簡潔有力。`.trim();
-}
-
-async function inferTargetFilePath(issue, plan, model) {
-  const planCandidates = extractFileCandidates(plan);
-
-  if (planCandidates.length === 1) {
-    return planCandidates[0];
-  }
-
-  if (planCandidates.length > 1) {
-    return planCandidates.find((c) => c.startsWith('src/')) || planCandidates[0];
-  }
-
-  const prompt = `請根據以下 GitHub Issue 與實作計畫，推斷「最主要的實作檔案路徑」。
-
-## 規則
-- 只回傳單一檔案路徑
-- 優先回傳 src/ 底下的實作檔，不要回傳測試檔、文件檔、設定檔
-- 副檔名限制為 .js、.ts、.jsx、.tsx、.mjs、.cjs
-- 不要包含程式碼區塊、不要加說明
-
-## Issue #${issue.number}
-標題：${issue.title}
-描述：
-${issue.body || '（無描述）'}
-
-## 實作計畫
-${plan}`.trim();
-
-  const inferred = (await AIClient.sendAndWait(prompt, model)).trim().split(/\s+/)[0];
-  return isValidTargetPath(inferred) ? inferred : null;
-}
-
-function extractFileCandidates(plan) {
-  const matches = plan.match(/([A-Za-z0-9_./-]+\.(?:js|ts|jsx|tsx|mjs|cjs))/g) || [];
-  return [...new Set(matches.filter(isValidTargetPath))].filter((candidate) => {
-    const normalized = candidate.toLowerCase();
-    return !normalized.includes('__tests__/')
-      && !normalized.includes('.test.')
-      && !normalized.includes('.spec.')
-      && !normalized.endsWith('.config.js');
-  });
-}
-
-function isValidTargetPath(value) {
-  return typeof value === 'string'
-    && /^[A-Za-z0-9_./-]+\.(js|ts|jsx|tsx|mjs|cjs)$/.test(value)
-    && !value.startsWith('/');
-}

package/src/core/code-generator.js

@@ -1,128 +0,0 @@
-/**
- * CodeGenerator 服務
- * 使用 AIClient 生成符合專案風格的代碼，並執行 ESLint 驗證後寫入檔案
- */
-
-import { writeFileSync, existsSync, mkdirSync } from 'fs';
-import { dirname } from 'path';
-import { execSync } from 'child_process';
-import { AIClient } from './ai-client.js';
-import { RepoContext } from './repo-context.js';
-
-export class CodeGenerator {
-  /**
-   * 生成指定檔案的代碼
-   * @param {object} issueContext - Issue 資料 { number, title, body, labels }
-   * @param {string} filePath - 要生成的目標檔案路徑（絕對路徑）
-   * @param {object} constraints - 限制條件
-   * @param {number} constraints.maxLines - 最大行數（預設 500）
-   * @param {string} constraints.language - 語言（預設 'js'）
-   * @param {string} constraints.extraContext - 額外的使用者描述
-   * @param {string} constraints.model - AI 模型（可選）
-   * @returns {Promise<{ filePath, linesCount }>}
-   */
-  static async generateFile(issueContext, filePath, constraints = {}) {
-    const { maxLines = 500, language = 'js', extraContext = '', model } = constraints;
-
-    // 防止覆蓋現有檔案
-    if (existsSync(filePath)) {
-      throw new Error(`檔案已存在，拒絕覆蓋：${filePath}\n請選擇一個新的目標路徑。`);
-    }
-
-    // 取得專案上下文
-    const conventions = RepoContext.getProjectConventions();
-    const examples = RepoContext.getSimilarFileExamples(filePath, 2);
-
-    // 建立 prompt
-    const prompt = CodeGenerator._buildPrompt({
-      issueContext,
-      filePath,
-      maxLines,
-      language,
-      extraContext,
-      conventions,
-      examples,
-    });
-
-    // 呼叫 AI
-    const rawCode = await AIClient.sendAndWait(prompt, model);
-    const code = CodeGenerator._cleanCode(rawCode);
-
-    // 行數驗證
-    const lines = code.split('\n').length;
-    if (lines > maxLines) {
-      throw new Error(`生成的代碼超過行數限制（${lines} 行 > ${maxLines} 行）`);
-    }
-
-    // 確保目錄存在
-    mkdirSync(dirname(filePath), { recursive: true });
-
-    // 寫入暫時檔案並 lint
-    writeFileSync(filePath, code, 'utf-8');
-    CodeGenerator._lintFile(filePath);
-
-    return { filePath, linesCount: lines };
-  }
-
-  /**
-   * 建立代碼生成 prompt
-   */
-  static _buildPrompt({ issueContext, filePath, maxLines, language, extraContext, conventions, examples }) {
-    return `你是一位 ${language.toUpperCase()} 專家。請依照以下需求生成代碼。
-
-## GitHub Issue
-標題：${issueContext.title}
-描述：
-${issueContext.body || '（無描述）'}
-${issueContext.labels?.length ? `標籤：${issueContext.labels.join(', ')}` : ''}
-
-## 目標檔案
-${filePath}
-
-## 專案約定
-${conventions}
-
-## 代碼範例（相似檔案）
-${examples}
-
-## 使用者補充說明
-${extraContext || '（無）'}
-
-## 生成規則
-- 最多 ${maxLines} 行
-- 使用 ESM (import/export) 語法
-- 包含必要的 JSDoc 註解
-- 僅輸出程式碼本身，不要 markdown 區塊（\`\`\`）
-- 不要輸出任何說明文字，直接輸出可執行的程式碼`.trim();
-  }
-
-  /**
-   * 移除 AI 回傳中的 markdown code fence
-   */
-  static _cleanCode(raw) {
-    return raw
-      .replace(/^```[\w]*\n?/gm, '')
-      .replace(/\n?```$/gm, '')
-      .trim();
-  }
-
-  /**
-   * 對指定檔案執行 ESLint（若存在 eslint 設定）
-   * 不強制中止——只在 lint 有 error 時拋出例外
-   */
-  static _lintFile(filePath) {
-    try {
-      execSync(`npx eslint --no-eslintrc --rule '{"no-undef": "warn"}' "${filePath}"`, {
-        encoding: 'utf-8',
-        stdio: 'pipe',
-      });
-    } catch (error) {
-      const output = error.stdout || error.stderr || '';
-      // 若 eslint 回傳 exit code 1 表示有 error
-      if (error.status === 1 && output.includes('error')) {
-        throw new Error(`ESLint 驗證失敗：\n${output}`);
-      }
-      // exit code 2 為 eslint 設定問題，忽略
-    }
-  }
-}

package/src/core/issue-reader.js

@@ -1,58 +0,0 @@
-/**
- * IssueReader 服務
- * 透過 gh CLI 從 GitHub 讀取 Issue 詳情
- */
-
-import { execSync } from 'child_process';
-
-export class IssueReader {
-  /**
-   * 讀取指定 Issue 的詳情
-   * @param {number|string} issueNumber - Issue 編號
-   * @returns {{ number, title, body, labels, author, url }}
-   */
-  static async readIssue(issueNumber) {
-    if (!issueNumber || isNaN(Number(issueNumber))) {
-      throw new Error(`無效的 Issue 編號：${issueNumber}`);
-    }
-
-    const json = IssueReader._fetchIssueJson(issueNumber);
-    return IssueReader._parseIssue(json);
-  }
-
-  /**
-   * 使用 gh CLI 抓取 Issue 的 JSON 資料
-   */
-  static _fetchIssueJson(issueNumber) {
-    try {
-      const raw = execSync(
-        `gh issue view ${issueNumber} --json number,title,body,labels,author,url`,
-        { encoding: 'utf-8', stdio: 'pipe' }
-      );
-      return JSON.parse(raw.trim());
-    } catch (error) {
-      if (error.message.includes('Could not resolve') || error.message.includes('not found')) {
-        throw new Error(`Issue #${issueNumber} 不存在或無法存取`);
-      }
-      if (error.message.includes('gh: command not found') || error.message.includes('not found: gh')) {
-        throw new Error('找不到 gh CLI，請先安裝：https://cli.github.com');
-      }
-      throw new Error(`讀取 Issue 失敗：${error.message}`);
-    }
-  }
-
-  /**
-   * 解析 gh CLI 回傳的 JSON 為標準結構
-   */
-  static _parseIssue(json) {
-    const labels = (json.labels || []).map((l) => (typeof l === 'string' ? l : l.name));
-    return {
-      number: json.number,
-      title: json.title || '',
-      body: json.body || '',
-      labels,
-      author: json.author?.login || json.author || '',
-      url: json.url || '',
-    };
-  }
-}

package/src/core/repo-context.js

@@ -1,114 +0,0 @@
-/**
- * RepoContext 服務
- * 掃描專案目錄結構，提供代碼生成所需的上下文
- */
-
-import { readdirSync, readFileSync, statSync, existsSync } from 'fs';
-import { join, extname, relative, dirname } from 'path';
-import { fileURLToPath } from 'url';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-const ROOT = join(__dirname, '..', '..');
-
-// 要排除的目錄
-const EXCLUDED_DIRS = new Set(['node_modules', '.git', 'dist', 'build', 'coverage', '.nyc_output']);
-// 支援的程式碼副檔名
-const CODE_EXTS = new Set(['.js', '.ts', '.mjs', '.cjs', '.jsx', '.tsx']);
-
-export class RepoContext {
-  /**
-   * 依據目標檔案路徑尋找相似的現有檔案片段
-   * @param {string} targetPath - 要生成的目標檔案路徑（相對或絕對）
-   * @param {number} maxExamples - 最多回傳幾個範例，預設 3
-   * @returns {string} 格式化的範例文字
-   */
-  static getSimilarFileExamples(targetPath, maxExamples = 3) {
-    const ext = extname(targetPath);
-    const allFiles = RepoContext._scanFiles(ROOT);
-    const codeFiles = allFiles.filter(
-      (f) => extname(f) === ext && !f.includes('.test.') && !f.includes('.spec.')
-    );
-
-    // 按路徑相似度排序，取前 N 個
-    const sorted = codeFiles
-      .filter((f) => f !== targetPath)
-      .slice(0, maxExamples);
-
-    if (sorted.length === 0) return '（無相似範例）';
-
-    return sorted
-      .map((f) => {
-        try {
-          const content = readFileSync(f, 'utf-8');
-          const lines = content.split('\n').slice(0, 40).join('\n');
-          const relPath = relative(ROOT, f);
-          return `// 範例檔案：${relPath}\n${lines}`;
-        } catch {
-          return null;
-        }
-      })
-      .filter(Boolean)
-      .join('\n\n---\n\n');
-  }
-
-  /**
-   * 取得專案主要約定（依據 package.json 及目錄結構判斷）
-   * @returns {string}
-   */
-  static getProjectConventions() {
-    const hints = [];
-
-    // 讀取 package.json
-    const pkgPath = join(ROOT, 'package.json');
-    if (existsSync(pkgPath)) {
-      try {
-        const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
-        hints.push(`模組系統：${pkg.type === 'module' ? 'ESM (import/export)' : 'CommonJS (require)'}`);
-        if (pkg.dependencies?.typescript || pkg.devDependencies?.typescript) {
-          hints.push('語言：TypeScript');
-        } else {
-          hints.push('語言：JavaScript');
-        }
-        const testDep = pkg.devDependencies?.jest || pkg.dependencies?.jest;
-        if (testDep) hints.push('測試框架：Jest');
-      } catch {
-        // 忽略解析錯誤
-      }
-    }
-
-    // 目錄結構提示
-    const srcExists = existsSync(join(ROOT, 'src'));
-    if (srcExists) hints.push('原始碼位於 src/ 目錄');
-
-    return hints.length > 0 ? hints.join('\n') : '（無法自動偵測專案約定）';
-  }
-
-  /**
-   * 遞迴掃描目錄，回傳所有程式碼檔案的絕對路徑
-   */
-  static _scanFiles(dir) {
-    const results = [];
-    let entries;
-    try {
-      entries = readdirSync(dir);
-    } catch {
-      return results;
-    }
-    for (const name of entries) {
-      if (EXCLUDED_DIRS.has(name)) continue;
-      const full = join(dir, name);
-      try {
-        const stat = statSync(full);
-        if (stat.isDirectory()) {
-          results.push(...RepoContext._scanFiles(full));
-        } else if (CODE_EXTS.has(extname(name))) {
-          results.push(full);
-        }
-      } catch {
-        // 忽略無法存取的路徑
-      }
-    }
-    return results;
-  }
-}