ai-git-tools 2.0.73 → 2.0.75

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-git-tools",
-  "version": "2.0.73",
+  "version": "2.0.75",
   "description": "AI-powered Git automation tools for commit messages and PR generation",
   "main": "src/index.js",
   "type": "module",

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

@@ -2,6 +2,9 @@ import { CopilotClient, approveAll } from '@github/copilot-sdk';
 import { CONSTANTS, PROJECT_SKILLS_CONTEXT } from '../utils/constants.js';
 import { getSkillsSummaryForPrompt, log } from '../utils/helpers.js';
 
+// 讓 CopilotClient 啟動的 Node 子程序繼承此設定，靜音 SQLite ExperimentalWarning
+process.env.NODE_NO_WARNINGS = '1';
+
 // CopilotClient 子程序啟動 + AI 模型回應可能共需 60-120s，設為 150s 保留足夠緩衝
 const AI_TIMEOUT_MS = 150000;
 
@@ -35,6 +38,14 @@ export class AIAnalyzer {
     });
   }
 
+  /**
+   * 預熱 CopilotClient — 在 workflow 開始時盡早呼叫，
+   * 讓 subprocess 在 git 操作期間並行啟動，避免 session.idle timeout
+   */
+  async warmup() {
+    await this._getOrCreateClient();
+  }
+
   /**
    * 釋放 CopilotClient 子程序資源
    */
@@ -51,28 +62,47 @@ export class AIAnalyzer {
   }
 
   /**
-   * 生成 PR 內容
+   * 生成 PR 內容（失敗時自動重建 client 重試一次）
    */
   async generatePRContent(commits, diff) {
     const skillsSummary = getSkillsSummaryForPrompt(PROJECT_SKILLS_CONTEXT);
     const prompt = this.buildPRPrompt(commits, diff, skillsSummary);
 
-    const session = await this._createSession();
+    for (let attempt = 1; attempt <= 2; attempt++) {
+      try {
+        if (attempt === 2) {
+          log.info('  重試 AI 請求（重建 session）...\n');
+          await this.close(); // 釋放舊 client，下一次 _createSession 會建新的
+        }
 
-    // 使用超時保護（150 秒，含子程序啟動 + AI 回應）
-    const responsePromise = session.sendAndWait({ prompt });
-    const timeoutPromise = new Promise((_, reject) => {
-      setTimeout(() => reject(new Error(`AI 請求超時 (${AI_TIMEOUT_MS / 1000} 秒)`)), AI_TIMEOUT_MS);
-    });
+        const session = await this._createSession();
 
-    const response = await Promise.race([responsePromise, timeoutPromise]);
-    const prContent = response?.data.content?.trim() || '';
+        const responsePromise = session.sendAndWait({ prompt });
+        const timeoutPromise = new Promise((_, reject) => {
+          setTimeout(() => reject(new Error(`AI 請求超時 (${AI_TIMEOUT_MS / 1000} 秒)`)), AI_TIMEOUT_MS);
+        });
 
-    if (!prContent) {
-      throw new Error('AI 未能生成 PR 內容');
-    }
+        const response = await Promise.race([responsePromise, timeoutPromise]);
+        const prContent = response?.data.content?.trim() || '';
+
+        if (!prContent) {
+          throw new Error('AI 未能生成 PR 內容');
+        }
 
-    return this.parsePRContent(prContent);
+        return this.parsePRContent(prContent);
+      } catch (error) {
+        // SDK 內部 session.idle timeout（hardcoded 60s）→ 重試一次
+        const isSessionIdleTimeout =
+          error.message?.includes('session.idle') || error.message?.includes('Timeout after');
+        if (attempt === 1 && isSessionIdleTimeout) {
+          log.warning(`  AI session 超時，即將重試...\n`);
+          continue;
+        }
+        throw error;
+      }
+    }
+    // unreachable，但保留讓 linter 滿意
+    throw new Error('AI 未能生成 PR 內容');
     // 注意：不在此 stop() client，改由 close() 統一清理以便複用
   }
 
@@ -143,25 +173,13 @@ ${skillsSummary}
 > type 必須是以下之一：feat / fix / refactor / style / docs / test / chore / perf
 > **重要**：如果有新增任何功能、新增檔案、新增 API、新增組件，優先使用 **feat**
 
-## � 摘要
-[1-2 句話說明這個 PR 做了什麼、解決了什麼問題]
-
----
-
-## ✏️ 做了什麼 (What)
-- [具體變更項目 1]
-- [具體變更項目 2]
-- [具體變更項目 3]
+## 📝 變更摘要
+[簡述這個 PR 的主要目的和影響範圍，2-3 句話]
 
-## ❓ 為什麼 (Why)
-- [說明這個改動的背景或原因]
-- [使用者痛點或產品需求]
-
-## ⚙️ 怎麼做到的 (How)
-- [技術實作重點說明 1]
-- [技術實作重點說明 2]
-
----
+## 🎯 主要變更
+- [變更項目 1]
+- [變更項目 2]
+- [變更項目 3]
 
 ## 🔀 變更類型
 - [ ] ✨ 新功能 (feat)
@@ -185,19 +203,19 @@ ${skillsSummary}
 > 
 > **特別注意**: 如果 diff 中有「新增檔案」或「新增功能」，**務必勾選** ✨ 新功能 (feat)
 
-## 🎯 影響範圍
-- 影響模組：[列出受影響的頁面 / 模組 / API]
-- 無影響其他模組（或說明有影響的範圍）
+## 🧪 測試方法
+1. [具體的測試步驟 1]
+2. [具體的測試步驟 2]
+3. [具體的測試步驟 3]
 
----
+## 💥 Breaking Changes
+[如果有破壞性變更請詳細說明，沒有則填寫「無」]
 
-## 🧪 測試項目
-- [ ] [測試項目 1]
-- [ ] [測試項目 2]
-- [ ] [測試項目 3]
+## 📌 注意事項
+[需要特別注意的事項]
 
-## 📸 截圖（UI 變更必填）
-[放截圖，非 UI 變更可填 N/A]
+## 📸 截圖
+[如果是 UI 變更，提醒需要截圖]
 
 ---
 
@@ -210,26 +228,23 @@ ${skillsSummary}
 - [請 reviewer 特別關注的邏輯或設計決策 1]
 - [請 reviewer 特別關注的邏輯或設計決策 2]
 
-## 🔗 相關 Issue
-- Closes #[issue 編號]（沒有則填「無」）
-
 ---
 
 **規則**：
 1. PR 標題格式：type: 簡短描述（不超過 50 字）
 2. type 必須符合 Conventional Commits
-3. 摘要用 1-2 句話說明目的，不要流水帳
-4. Why 說明背景原因，How 說明技術手段，兩者不可混淆
-5. 全部使用繁體中文（台灣正體）
-6. 不要在開頭加引導語句，直接輸出 # [type]: [標題]
+3. 變更摘要用 2-3 句話概括整體影響
+4. 全部使用繁體中文（台灣正體）
+5. 不要在開頭加引導語句
+6. 直接開始輸出 # [type]: [標題]
 7. **變更類型判斷必須準確**：
    - 檢查 diff 中是否有 "new file mode" 或大量 "+++" 行（表示新增檔案）
    - 檢查 commit 訊息是否包含「新增」、「add」、「feat」等關鍵字
+   - 檢查主要變更列表，如果提到「新增 xxx」就必須勾選 ✨ 新功能 (feat)
    - 新增配置檔、新增組件、新增 API、新增功能都算 feat
    - 一個 PR 可以同時是多種類型（如：feat + refactor + chore）
-8. **Risk Level 判斷**：HIGH = 影響付款/登入/資料寫入核心流程；MEDIUM = 影響現有功能但有降級保護；LOW = 新增功能或純重構
+   8. **Risk Level 判斷**：HIGH = 影響付款/登入/資料寫入核心流程；MEDIUM = 影響現有功能但有降級保護；LOW = 新增功能或純重構
 9. **Reviewer 重點**：列出最值得仔細看的 1-3 個地方（核心演算法、架構決策、潛在邊界條件）
-10. **相關 Issue**：若 commit 訊息含 #issue 編號或 closes/fixes/resolves，自動帶入；否則填「無」
 
 ---
 

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

@@ -42,6 +42,9 @@ export class PRWorkflow {
         }
       }
 
+      // 0.5 提前預熱 AI client（異步非阻塞），讓 subprocess 在 git 操作期間並行啟動
+      this.ai.warmup().catch(() => {});
+
       // 1. 驗證環境和分支
       const { baseBranch, headBranch } = await this.detectAndValidateBranches();