ai-git-tools 2.1.2 → 2.1.3

package/README.md

@@ -440,7 +440,7 @@ github: {
 
 ## 🔧 環境需求
 
-- **Node.js** >= 18.0.0
+- **Node.js** >= 20.19.0（或 >= 22.12.0）
 - **Git** 已安裝並設定
 - **GitHub CLI** (用於 PR 功能)
   \`\`\`bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-git-tools",
-  "version": "2.1.2",
+  "version": "2.1.3",
   "description": "AI-powered Git automation tools for commit messages and PR generation",
   "main": "src/index.js",
   "type": "module",
@@ -27,7 +27,7 @@
   "author": "Yiso Tsao <yiso05255@gmail.com>",
   "license": "MIT",
   "engines": {
-    "node": ">=18.0.0"
+    "node": "^20.19.0 || >=22.12.0"
   },
   "files": [
     "bin/",

package/src/commands/redmine-update.js

@@ -63,6 +63,19 @@ export function hasApplyFailures(results = []) {
   return results.some(result => result.applied === false && !result.skipped);
 }
 
+/**
+ * 確認 preview 至少產生一筆可套用草稿
+ * @param {object} draft
+ */
+export function validateGeneratedDraft(draft = {}) {
+  if (!Array.isArray(draft.drafts) || draft.drafts.length === 0) {
+    const details = draft.failures?.map(failure => `#${failure.issueId}: ${failure.error}`).join('；');
+    throw new Error(
+      `沒有成功產生任何 Issue 更新草稿${details ? `。失敗原因：${details}` : ''}`
+    );
+  }
+}
+
 /**
  * 執行 Redmine Issue preview 或 apply
  * @param {object} options
@@ -94,6 +107,7 @@ export async function redmineUpdateCommand(options = {}) {
     maxRetries: config.ai.maxRetries,
   });
 
+  validateGeneratedDraft(draft);
   console.log(renderPreview(draft.drafts));
   for (const failure of draft.failures) {
     console.log(`❌ Issue #${failure.issueId} 無法產生更新：${failure.error}`);

package/src/core/ai-client.js

@@ -6,6 +6,31 @@
 import { CopilotClient, approveAll } from '@github/copilot-sdk';
 
 export class AIClient {
+  /**
+   * 判斷 Node.js 是否符合 Copilot SDK 的版本需求
+   * @param {string} version
+   * @returns {boolean}
+   */
+  static isSupportedNodeVersion(version = process.versions.node) {
+    const match = String(version).match(/^(\d+)\.(\d+)\.(\d+)/);
+    if (!match) return false;
+
+    const major = Number(match[1]);
+    const minor = Number(match[2]);
+    return (major === 20 && minor >= 19) || (major >= 22 && (major > 22 || minor >= 12));
+  }
+
+  /**
+   * 確認 Node.js 符合 Copilot SDK 的版本需求
+   */
+  static assertSupportedNodeVersion() {
+    if (!AIClient.isSupportedNodeVersion()) {
+      throw new Error(
+        `目前 Node.js ${process.versions.node} 不符合 Copilot SDK 需求。請升級至 Node.js 20.19+ 或 22.12+。`
+      );
+    }
+  }
+
   /**
    * 檢測是否為 Copilot 授權相關的錯誤
    */
@@ -30,6 +55,7 @@ export class AIClient {
    * 發送 prompt 並等待回應（帶重試機制和超時保護）
    */
   static async sendAndWait(prompt, model = 'claude-haiku-4.5', maxRetries = 3, timeout = 150000) {
+    AIClient.assertSupportedNodeVersion();
     let lastError = null;
 
     for (let attempt = 1; attempt <= maxRetries; attempt++) {

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

@@ -1,4 +1,5 @@
 import { CopilotClient, approveAll } from '@github/copilot-sdk';
+import { AIClient } from '../../core/ai-client.js';
 import { CONSTANTS } from '../../utils/constants.js';
 import { log } from '../../utils/logger.js';
 import { isCopilotAuthError } from '../../utils/helpers.js';
@@ -26,6 +27,7 @@ export class AIAnalyzer {
    * 取得（或建立）共用的 CopilotClient
    */
   async _getOrCreateClient() {
+    AIClient.assertSupportedNodeVersion();
     if (!this._client) {
       this._client = new CopilotClient();
     }