ai-git-tools 2.0.68 → 2.0.70

package/src/commands/auto-dev.js

@@ -1,256 +0,0 @@
-/**
- * auto-dev 整合命令
- * 將 plan-issue、generate-code、write-and-test 串連起來
- * 支援全自動模式（--no-confirm）和分步互動模式
- */
-
-import { resolve } from 'path';
-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 { writeAndTestCommand, TEST_TYPE_CHOICES, normalizeTestTypeSelection } from './write-and-test.js';
-import { Logger } from '../utils/logger.js';
-
-export async function autoDevCommand(options = {}) {
-  const logger = new Logger();
-
-  const issueNumber = options.issue;
-  if (!issueNumber) {
-    logger.error('請提供 Issue 編號（--issue <number>）');
-    throw new Error('缺少 Issue 編號');
-  }
-
-  const noConfirm = options.noConfirm;
-  let filePath = options.file;
-
-  logger.header('auto-dev 整合工作流');
-  if (noConfirm) {
-    console.log('模式：全自動（跳過所有確認）');
-  } else {
-    console.log('模式：分步互動（每步完成後詢問）');
-  }
-  console.log('');
-
-  // ============================================================
-  // 第一步：讀取 Issue
-  // ============================================================
-  logger.step(`正在讀取 Issue #${issueNumber}...`);
-  const issue = await IssueReader.readIssue(issueNumber);
-  logger.success(`Issue：${issue.title}`);
-  console.log(`作者：${issue.author} | URL：${issue.url}`);
-  console.log('');
-
-  // ============================================================
-  // 第二步：生成計畫
-  // ============================================================
-  logger.step('正在分析 Issue 並生成實現計畫...');
-  const planPrompt = buildPlanPrompt(issue);
-  const plan = await AIClient.sendAndWait(planPrompt, options.model);
-  logger.section('AI 生成的實現計畫');
-  console.log(plan);
-  console.log('');
-
-  // ============================================================
-  // 第三步：詢問是否繼續（若非全自動）
-  // ============================================================
-  if (!noConfirm) {
-    const { proceed } = await inquirer.prompt([{
-      type: 'confirm',
-      name: 'proceed',
-      message: '計畫確認無誤，是否繼續進行代碼生成？',
-      default: true,
-    }]);
-
-    if (!proceed) {
-      logger.info('已取消。');
-      return;
-    }
-  }
-
-  // ============================================================
-  // 第四步：決定目標檔案路徑（優先自動推斷）
-  // ============================================================
-  if (!filePath) {
-    filePath = await inferTargetFilePath(issue, plan, options.model);
-    if (filePath) {
-      logger.info(`已自動推斷目標檔案：${filePath}`);
-    }
-  }
-
-  if (!filePath) {
-    if (noConfirm) {
-      logger.error('無法自動推斷目標檔案路徑，請改用 --file 明確指定。');
-      throw new Error('缺少可推斷的目標檔案路徑');
-    }
-
-    const { file } = await inquirer.prompt([{
-      type: 'input',
-      name: 'file',
-      message: '無法自動推斷，請輸入要生成的檔案路徑（例如：src/core/new-feature.js）：',
-      validate: (input) => input.trim().length > 0 ? true : '路徑不能為空',
-    }]);
-    filePath = file;
-  }
-
-  const absoluteFilePath = resolve(process.cwd(), filePath);
-  console.log('');
-
-  // ============================================================
-  // 第五步：生成代碼
-  // ============================================================
-  logger.step(`正在生成代碼：${filePath}`);
-  let codeResult;
-  try {
-    codeResult = await CodeGenerator.generateFile(issue, absoluteFilePath, {
-      maxLines: parseInt(options.maxLines || '500', 10),
-      language: getLanguageFromFilePath(filePath),
-      extraContext: options.context || '',
-      model: options.model,
-    });
-    logger.success(`代碼已生成：${codeResult.linesCount} 行`);
-  } catch (error) {
-    logger.error(`代碼生成失敗：${error.message}`);
-    throw error;
-  }
-
-  console.log('');
-
-  const selectedTestType = await resolveTestTypeForAutoDev({
-    noConfirm,
-    requestedTestType: options.testType,
-  });
-
-  console.log('');
-
-  // ============================================================
-  // 第六步：強制執行測試流程
-  // ============================================================
-  const testResult = await writeAndTestCommand({
-    file: filePath,
-    testType: selectedTestType,
-    maxFixes: options.maxFixes || '2',
-    model: options.model,
-    noConfirm: true,
-    skipCommit: true,
-  });
-
-  if (!testResult?.success) {
-    logger.error('測試流程未完成，自動化工作流中止。');
-    return;
-  }
-
-  console.log('');
-  logger.section('✅ 自動化工作流完成');
-  console.log(`Issue #${issue.number}：${issue.title}`);
-  console.log(`生成檔案：${filePath}`);
-  testResult.testFilePaths.forEach((testFilePath) => {
-    console.log(`測試檔案：${testFilePath.replace(process.cwd(), '.')}`);
-  });
-  console.log(`測試類型：${testResult.testTypes.join('、')}`);
-  console.log('狀態：已完成代碼與測試流程，未自動 commit');
-  console.log(`合計行數：${codeResult.linesCount + ' (程式碼)'}`);
-}
-
-/**
- * 建立計畫生成 prompt
- */
-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) {
-    const preferredCandidate = planCandidates.find((candidate) => candidate.startsWith('src/'));
-    if (preferredCandidate) {
-      return preferredCandidate;
-    }
-    return 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) || [];
-  const uniqueMatches = [...new Set(matches.filter(isValidTargetPath))];
-
-  return uniqueMatches.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('/');
-}
-
-function getLanguageFromFilePath(filePath) {
-  return /\.(ts|tsx)$/.test(filePath) ? 'ts' : 'js';
-}
-
-async function resolveTestTypeForAutoDev({ noConfirm, requestedTestType }) {
-  const defaultTestType = normalizeTestTypeSelection(requestedTestType || 'auto')[0] || 'auto';
-
-  if (noConfirm) {
-    return requestedTestType || 'auto';
-  }
-
-  const { testType } = await inquirer.prompt([{
-    type: 'list',
-    name: 'testType',
-    message: '請選擇這次要執行的測試方式：',
-    choices: TEST_TYPE_CHOICES,
-    default: defaultTestType === 'auto' ? 'both' : defaultTestType,
-  }]);
-
-  return testType;
-}

package/src/commands/generate-code.js

@@ -1,115 +0,0 @@
-/**
- * generate-code 命令
- * 讀取 GitHub Issue，依照指定路徑生成符合專案風格的代碼
- */
-
-import { readFileSync } from 'fs';
-import { resolve } from 'path';
-import inquirer from 'inquirer';
-import { IssueReader } from '../core/issue-reader.js';
-import { CodeGenerator } from '../core/code-generator.js';
-import { writeAndTestCommand, TEST_TYPE_CHOICES, normalizeTestTypeSelection } from './write-and-test.js';
-import { Logger } from '../utils/logger.js';
-
-export async function generateCodeCommand(options = {}) {
-  const logger = new Logger();
-
-  // 驗證必要參數
-  const issueNumber = options.issue;
-  const filePath = options.file;
-  const extraContext = options.context || '';
-  const maxLines = parseInt(options.maxLines || '500', 10);
-
-  if (!issueNumber) {
-    logger.error('請提供 Issue 編號（--issue <number>）');
-    throw new Error('缺少 Issue 編號');
-  }
-  if (!filePath) {
-    logger.error('請提供目標檔案路徑（--file <path>）');
-    throw new Error('缺少目標檔案路徑');
-  }
-
-  const absolutePath = resolve(process.cwd(), filePath);
-
-  logger.header(`generate-code`);
-  console.log(`Issue：#${issueNumber}`);
-  console.log(`目標檔案：${absolutePath}`);
-  console.log(`最大行數：${maxLines}`);
-  console.log('');
-
-  // 1. 讀取 Issue
-  logger.step(`正在讀取 Issue #${issueNumber}...`);
-  const issue = await IssueReader.readIssue(issueNumber);
-  logger.info(`Issue：${issue.title}`);
-
-  // 2. 詢問確認後再生成
-  if (!options.noConfirm) {
-    const { confirmed } = await inquirer.prompt([{
-      type: 'confirm',
-      name: 'confirmed',
-      message: `確認為檔案 ${filePath} 生成代碼？`,
-      default: true,
-    }]);
-
-    if (!confirmed) {
-      logger.info('已取消。');
-      return;
-    }
-  }
-
-  // 3. 生成代碼
-  logger.step('正在生成代碼中，請稍候...\n');
-
-  const result = await CodeGenerator.generateFile(issue, absolutePath, {
-    maxLines,
-    language: /\.(ts|tsx)$/.test(absolutePath) ? 'ts' : 'js',
-    extraContext,
-    model: options.model,
-  });
-
-  // 4. 顯示結果
-  logger.section(`生成完成`);
-  logger.success(`檔案已寫入：${result.filePath}`);
-  logger.info(`共 ${result.linesCount} 行`);
-
-  // 5. 預覽前 20 行
-  try {
-    const preview = readFileSync(result.filePath, 'utf-8').split('\n').slice(0, 20).join('\n');
-    console.log('\n--- 預覽（前 20 行）---');
-    console.log(preview);
-    console.log('---');
-  } catch {
-    // 忽略預覽讀取失敗
-  }
-
-  console.log('\n💡 下一步：執行 write-and-test 為此檔案生成並執行測試');
-  console.log(`   ai-git-tools write-and-test --file ${filePath}`);
-
-  if (!options.noConfirm) {
-    const { nextAction } = await inquirer.prompt([{
-      type: 'list',
-      name: 'nextAction',
-      message: '代碼已生成，接下來要如何處理測試？',
-      choices: [
-        ...TEST_TYPE_CHOICES,
-        {
-          name: '先不執行測試',
-          value: 'skip',
-        },
-      ],
-      default: 'both',
-    }]);
-
-    if (nextAction !== 'skip') {
-      await writeAndTestCommand({
-        file: filePath,
-        testType: normalizeTestTypeSelection(nextAction).join(','),
-        maxFixes: options.maxFixes || '2',
-        model: options.model,
-        noConfirm: true,
-      });
-    }
-  }
-
-  return result;
-}

package/src/commands/plan-issue.js

@@ -1,91 +0,0 @@
-/**
- * plan-issue 命令
- * 讀取 GitHub Issue，使用 AI 生成結構化的實現計畫
- */
-
-import inquirer from 'inquirer';
-import { IssueReader } from '../core/issue-reader.js';
-import { AIClient } from '../core/ai-client.js';
-import { Logger } from '../utils/logger.js';
-
-export async function planIssueCommand(options = {}) {
-  const logger = new Logger();
-
-  const issueNumber = options.number || options.issue;
-  if (!issueNumber) {
-    logger.error('請提供 Issue 編號（--number <number>）');
-    throw new Error('缺少 Issue 編號');
-  }
-
-  logger.header(`plan-issue #${issueNumber}`);
-
-  // 1. 讀取 Issue
-  logger.step(`正在讀取 Issue #${issueNumber}...`);
-  const issue = await IssueReader.readIssue(issueNumber);
-
-  logger.section(`Issue #${issue.number}：${issue.title}`);
-  if (options.verbose) {
-    console.log(`作者：${issue.author}`);
-    console.log(`標籤：${issue.labels.join(', ') || '（無）'}`);
-    console.log(`URL：${issue.url}`);
-    console.log(`\n描述：\n${issue.body || '（無描述）'}`);
-  }
-
-  // 2. 呼叫 AI 生成計畫
-  logger.step('正在分析 Issue 並生成實現計畫...\n');
-  const prompt = buildPlanPrompt(issue);
-  const plan = await AIClient.sendAndWait(prompt, options.model);
-
-  // 3. 顯示計畫
-  logger.section('AI 生成的實現計畫');
-  console.log(plan);
-  console.log('');
-
-  // 4. 詢問確認（除非 --no-confirm）
-  if (options.noConfirm) {
-    logger.success('自動模式：跳過確認，繼續進行代碼生成。');
-    return { issue, plan };
-  }
-
-  const { proceed } = await inquirer.prompt([{
-    type: 'confirm',
-    name: 'proceed',
-    message: '是否確認此計畫並繼續進行代碼生成？',
-    default: false,
-  }]);
-
-  if (proceed) {
-    logger.success('計畫已確認！可以使用 generate-code 命令開始生成代碼。');
-    console.log('');
-    console.log(`  ai-git-tools generate-code --issue ${issue.number} --file <目標檔案路徑> --context <描述>`);
-  } else {
-    logger.info('已取消。請根據上方計畫手動進行後續操作。');
-  }
-
-  return { issue, plan };
-}
-
-/**
- * 建立計畫生成 prompt
- */
-function buildPlanPrompt(issue) {
-  return `你是一位軟體架構師。請閱讀以下 GitHub Issue 並建立詳細的實現計畫。
-
-## Issue #${issue.number}
-標題：${issue.title}
-
-描述：
-${issue.body || '（無描述）'}
-
-${issue.labels.length ? `標籤：${issue.labels.join(', ')}` : ''}
-
-## 輸出要求
-請輸出包含以下內容的實現計畫：
-
-1. **摘要** - 一句話說明要做什麼
-2. **需要新增/修改的檔案** - 列出所有相關檔案路徑和各自的職責
-3. **實現步驟** - 有序的任務清單，說明每個步驟的目的
-4. **注意事項** - 潛在風險或需要留意的事項（若有）
-
-請使用繁體中文，格式清晰，簡潔有力。`.trim();
-}